Channels & Versioning

How Spec4AI manages updates without breaking your local build.

Channels

stable

Stable Channel

Default for production use. Versions in this channel are manually promoted after passing extended integration tests. They are guaranteed not to introduce breaking schema changes within a major version.

canary

Canary Channel

Bleeding edge updates. Contains the latest features and bug fixes but may include experimental changes. Use for testing or non-critical features.

Semantic Versioning

All specs follow MAJOR.MINOR.PATCH. When you run sai install spec@stable, the CLI resolves the latest compatible version. A spec.lock file is created in your project to pin the exact hash, ensuring subsequent builds are identical.