All packages (crates, PyPI, npm, RubyGems, NuGet, Maven Central, Go, Swift) share one lockstep
version number, following Semantic Versioning. 3.2.1 of the Python
package and 3.2.1 of the Node package speak the same record contract and have the same features.
CI checks that every manifest agrees on the version before a release.
| Bump | When |
|---|---|
| Major | Anything in the cross-language contract changes (record shape, level weights, field names, the llm block, the content policy, hash-chain format), or a public API is removed or changes meaning. A contract change is always a major bump, even if no code in one binding changed |
| Minor | New backward-compatible features: a transport, a plugin, an adapter, a CLI command, a new optional field |
| Patch | Bug fixes and documentation, with no change in the contract |
Stable within a major version:
schema_version, the six levels, the llm block and the meta field names in the contract.logquill command and its flags.logquill verify, the SQLite log schema.Not covered:
text formatter and dev view (use JSON or logfmt for machines).semconv) and may move it in a minor release; the bump is announced in the changelog.schema_version is a 1.x record and is read as "1.0". Readers keep accepting older versions
within the same major line.schema_version.Release candidates (X.Y.Z-rc.N) are not picked up by default; install them explicitly. They carry no stability promise.
A feature to be removed is marked deprecated in a minor release, with a changelog entry and a replacement named, and is removed no earlier than the next major release.
See Support for which versions receive fixes.