Compatibility Matrix

This matrix defines compatibility between producer and consumer surfaces.

Version Semantics

• This page is the contract-level source for version compatibility.
• Evergreen operational docs should not carry release tags in titles.
• Internal rollout labels belong in changelog and plan documents, not evergreen compatibility copy.

Version Matrix

Gait CLI	PackSpec	gait pack verify behavior	Legacy runpack verify via pack verify
current 1.x release line	1.0.0	verifies PackSpec v1 (run, job, call) with additive verifier hardening and context-aware diff metadata where applicable	supported

Stability Guarantees

Within major 1.x of PackSpec:

• additive fields are allowed
• unknown fields must be ignored by compatible readers
• required fields are not removed/renamed

Breaking changes require:

• major schema version bump
• explicit migration guidance
• compatibility-window policy documented in release notes

Producer Guidance

If you are emitting PackSpec outside Gait runtime:

• implement RFC 8785 canonicalization for digest/signature inputs
• keep zip output deterministic
• validate outputs with gait pack verify in CI, and treat wrong-key signature failures as hard verification failures even in standard mode when a verify key is supplied

Reference kit: docs/contracts/pack_producer_kit.md