# Versioning

Crate and package versions follow SemVer once the project leaves alpha.

The C ABI has its own additive version, exposed at runtime via
`n4fmt_abi_version()` and as the compile-time constant
`N4FMT_ABI_VERSION` in `crates/nirs4all-formats-capi/src/lib.rs` (currently
`0.1.0`). Breaking ABI changes require a major ABI bump and migration
notes. The release pipeline ships the matching `nirs4all_formats.h` header
under `crates/nirs4all-formats-capi/include/`, regenerated by `cbindgen` on
every build of `nirs4all-formats-capi`.

The normalized record schema also carries a schema version so serialized
goldens and cached outputs can be migrated intentionally.