semver

Scope: Semantic version meaning.
Audience: Contributors and reviewers.
Guarantees: Version semantics are explicit.
Non-Goals: Release tooling.
Why: This doc exists to record its single responsibility for review.

Overview

This doc defines semantic version meaning.
Version meaning aligns with Core.
Release history is tracked in ../CHANGELOG.md.

Contracts

MAJOR means semantic model change.
MINOR means new capability without meaning shift.
PATCH means bug fix only.

Invariants

Version changes align with Invariants.
Contract locks align with src/agentic_proteins/core/api_lock.py.
Checks align with tests/unit/test_core_api_lock.py.

Failure Modes

Meaning drift breaks Core.
Mismatched versions break ../CHANGELOG.md.
Untracked changes break Invariants.

Extension Points

Extensions follow Experimental.
Extension checks align with tests/unit/test_module_stability.py.
Extension docs align with Docs Style.

Exit Criteria

This doc is obsolete when versioning is generated.
The replacement is Docs Style.
Obsolete docs are removed.

Code refs: src/agentic_proteins/core/api_lock.py.