メインコンテンツへスキップ
Symphony API Contract Vector（SACV）は、プラットフォーム全体のバージョン管理された API コントラクトを管理します。そのエンジンは個別にインストール可能な C++ プロセスで、範囲が限定された OpenAPI 3.2.0 JSON の検証、決定的な互換性差分、使い捨てのインベントリを実行します。エンドポイントのセマンティクスはドメインを所有するベクトルまたはモジュールに残り、SACV はコントラクトの形状と互換性を管理します。

操作

  • inspect と check: OpenAPI 3.2.0 JSON ドキュメントが範囲限定プロファイルに準拠していることを検証します。
  • diff: コントラクトのバージョン間で決定的な互換性差分を計算します。
  • propose: 新規または変更されたコントラクトについて、呼び出し元が宣言したレジストリ提案を受け付けます。
  • project: レビュアーや下流ツール向けに使い捨てのインベントリを出力します。

SACV が管理するもの

SACV が制約するもの:
  • コントラクトの形状（SACV プロファイルを伴う OpenAPI 3.2.0）
  • バージョン間の互換性の分類
  • 受け入れられたコントラクトのレジストリメンバーシップ
SACV が行わないこと:
  • エンドポイントのセマンティクスを所有すること（それは各ベクトルまたはモジュールが保持します）
  • SDK の生成、成果物の公開、トークンの発行
  • ライブなネットワークサーフェスの存在を示唆すること（将来のプライベート API に言及しても、それが作成されるわけではありません）
SACV は読み取り、クエリ、検証、提案のみを行います。プログラムによる正規の apply は、SKV エンジン全体で無効になっています。

関連するサーフェス

SKV の概要

包括的なフレームワークと Contract Quad モデル。

SODV

SACV に登録されたコントラクトの公式な公開を管理します。

SAV

宣言されたコンポーネント間のコンポジションと互換性を評価します。

qxctl ベクトルコマンド

qxctl sacv ... を実行して inspect、check、diff、propose を行います。
最終更新日 2026年10月10日