Stability

From v1.0.0, apiary follows Semantic Versioning. Within the v1 series the annotation format, struct tags (and their constraint mapping), supported handler signatures, and CLI flags / config keys will not change in a breaking way.

Not covered by the guarantee: the exact byte layout of generated YAML/JSON (only its validity as an OpenAPI 3.1 document and the documented semantics), diagnostic wording, internal packages, and behavior for input that does not compile.

Deprecated features are announced in the changelog, keep working for the remainder of v1, and are removed no earlier than v2. See STABILITY.md for the full policy.