Versioning & Stability

Versioning and Stability Contract

Ruleset versioning

Once a ruleset version is published, its interpretive behavior is immutable. Any change in interpretation requires a new version.

Lens versioning

Lenses are versioned in the same way as rulesets. Upgrades require explicit opt-in.

Backward compatibility

Existing analysis runs remain replayable and unchanged. New interpretations only change when you select a newer lens or ruleset version.

Replay stability

Replay returns the same boundary maps and assumption records for a given signature (artifact hash + lens + ruleset).

Diff stability

Diffs are deterministic for a pair of analysis runs under the same lens/ruleset.

Runtime versioning

Runtime versions are documented, but interpretation semantics are bound to lens and ruleset versions, not runtime builds.