Compatibility

This documentation release is 1.0.0 and is built against Chat OpenAPI 1.0.0. The supported API range is >=1.0.0 <2.0.0.

The machine-readable compatibility.json records the docs version, OpenAPI version, supported semantic-version range, and SHA-256 digest of the exact generated chat-v1.json bundled into this artifact. The build fails when either copy drifts from the code-generated repository contract.

Within API major version 1, additions must pass the repository’s additive compatibility gate. Clients must still reject unknown closed-enum values or schemas where the contract says to fail closed. A future breaking API requires a new major contract, explicit migration guidance, and a documentation compatibility update.

The strict JSONL CLI contract and deterministic bootstrap-template contract are both version 1.0.0. Their versions are pinned in compatibility.json; consumers must not infer compatibility across a future major-version change.