Skip to main content
The Symphony API Contract Vector (SACV) governs versioned API contracts across the platform. Its engine is an independently installable C++ process that performs bounded OpenAPI 3.2.0 JSON validation, deterministic compatibility diffs, and disposable inventories. Endpoint semantics remain with the domain-owning vector or module; SACV governs contract shape and compatibility.

​
Operations

  • Inspect and check: validate that an OpenAPI 3.2.0 JSON document conforms to the bounded profile.
  • Diff: compute deterministic compatibility diffs between contract versions.
  • Propose: accept caller-declared registry proposals for new or changed contracts.
  • Project: emit disposable inventories for reviewers and downstream tools.

​
What SACV governs

SACV bounds:
  • The contract shape (OpenAPI 3.2.0 with the SACV profile)
  • Compatibility classification between versions
  • Registry membership for accepted contracts
It does not:
  • Own endpoint semantics (each vector or module keeps those)
  • Generate SDKs, publish artifacts, or issue tokens
  • Imply a live network surface exists (mention of a future private API does not create one)
SACV is read, query, validate, and propose only. Programmatic canonical apply is disabled across the SKV engines.

SKV overview

The umbrella framework and Contract Quad model.

SODV

Governs any official publication of a SACV-registered contract.

SAV

Evaluates composition and compatibility across declared components.

qxctl vector commands

Run qxctl sacv ... to inspect, check, diff, and propose.
Last modified on September 24, 2026