Skip to content

Versioning

Rules for changes in the first public release.

This is the first public release and the rules start here. v0.x carries no backward compatibility guarantees. Version is a capability signal, not a stability promise. Non-determinism semantics may evolve within v0.x. The git tag (e.g., v0.1.0) is the source of truth for versioning. Tagged builds must derive version exclusively from VCS metadata. MAJOR: any change that can alter replay equivalence, persisted schema, or public contracts. MINOR: additive, backward-compatible changes to public CLI, HTTP schema, or ontology values. PATCH: documentation fixes, refactors, or internal changes with identical behavior. Example PATCH: comment fixes or file moves with no API impact. Example MINOR: adding an optional response field or a new CLI flag that preserves defaults. Example MAJOR: changing determinism semantics, replay rules, or required fields.