Research / architecture

Current research

CA-A1 — contract versioning

Type: architecture Updated: 2026-10-05 Scale: cross-jurisdictional Path: ../architecture/CONTRACT-VERSIONING.md

architectureversioningcontracts

Contract versioning

CA-A1 architecture record. Updated: 2026-10-05. Versioning policy for CA-OBJ-* shapes and CA-CONTRACT-* seams. A later contract release must never silently change the meaning of previously recorded events.

Version identifiers

Change classes

ClassDefinitionExample
Backward-compatiblenew optional fields; new enum values appended; relaxed constraintsadding reminder_policy to a campaign
Breakingremoved/renamed fields; narrowed constraints; changed semantics of an existing fieldchanging result shape for a decision method

Breaking changes produce a new major version of the object/contract. Old versions remain defined — historical records keep interpreting under their original version.

Adapter compatibility at seams

Historical-record interpretation

Deprecation

Sources