バンドル
テナントの統制された定義 — オントロジー型、ポリシー、Action Fabric のアクション、エージェントのメタデータ — を1つの contents バンドルにまとめ、キー単位でバージョン管理します。
Solution Packs
ガバナンス付きソリューションを一度作れば、どこへでも展開できる。
Solution Pack は、オントロジー、ポリシー、Action Fabric のアクション、エージェントを、バージョン管理された署名付きで検証可能な1つのアーティファクトにまとめます。あるテナントからエクスポートし、レジストリへ公開し、別のテナントへは入口でハッシュと署名を検証したうえでインポートします。
canonicalize → sha256 contentHash → HMAC 署名 · verifyPack(hashOk + signatureOk)
packs/transfer
packs ▸ canonicalize → sha256 contentHash → HMAC 署名
総仕上げ
1つのガバナンス付きソリューションを、あらゆる環境へ持ち運ぶ。
エンタープライズAIの難所は、エージェントを1つ作ることではありません。ガバナンス付きのソリューションを、そのままの形で次のテナント、次のリージョン、あるいはエアギャップされたネットワークへ再展開することです。Solution Packs は、そのソリューションを第一級のアーティファクトにします。まとめて、署名して、ガバナンスをゼロから作り直すことなく再展開できます。
署名
キー順に安定ソートされた JSON へ正規化し、sha256 の contentHash を算出したうえで HMAC 署名します。本番環境では署名シークレットが設定されていなければ署名を拒否します。
配布
stable または beta チャネルで共有レジストリに公開します — 来歴は公開元テナントとともに記録され、インストール先は常に呼び出し元自身のテナントです。
検証
インポート時は1行でも書き込む前に hashOk と signatureOk を再検証します。contents が改ざんされていればフェイルクローズし、部分適用は行われません。
パックの中身
4つのガバナンス付きセクションを、1つの署名済みバンドルに。
パックは、中身のバンドルと、その完全性のエンベロープで構成されます。バンドルが定義を運び、エンベロープがそれを可搬かつ証明可能にします。
ontologyTypes
- オブジェクト型のキー、名称、説明
- プロパティスキーマ（restricted を含む）
- 型ごとの allowedActions
policies
- name、whenExpr 条件
- effect（allow / deny / require approval）
- priority & enabled フラグ
actions
- Action Fabric のキー、名称、説明
- riskTier（オーバーサイトを決定）
- enabled フラグ
agents
- name、type、requiredModule
- skillCodes、status
- 参照用に記録——インポート時に自動生成はされません
完全性と署名
パックを証明可能にする計算。
- 01
canonicalize
contents をキー順に安定ソートされた JSON にシリアライズし、バイト列を決定的にします — 同じ定義は常に同じハッシュ値になります。
- 02
hashContents → contentHash
正規化されたバイト列に対して sha256 を計算します。どのフィールドの変更でも — ポリシーの優先度1つ、プロパティ1つでも — ハッシュが変わります。
- 03
signHash → signature
デプロイの署名シークレット(CORTEX_PACK_SIGNING_SECRET)で contentHash を HMAC-SHA256 します。verifyPack は hashOk と signatureOk を検証し、バンドルが改ざんされていれば hashOk が、シークレットが誤っていれば signatureOk が崩れます。
保存された contents を改ざんすると verifyPack は hashOk:false を返し、適用しようとしても 409 が返ります。この検証はオフラインで行われ、外部への通信は発生しません。
安全なインポート
何かが書き込まれる前に、変更点を正確に確認する。
パックのインポートは、検証を先に行う2段階のフローです。importPreview は稼働中の定義に対するセクション単位の差分を返し、importApply は署名を再検証したうえで冪等にアップサートします——対象は自テナントのみです。
- importPreview — verifyPack の結果と、セクション単位の差分（added / changed / unchanged）
- importApply は先に検証。無効なパックは 409 を返し、部分的な書き込みは行われません
- オントロジー型、ポリシー、アクションを冪等にアップサート。再実行しても安全
- 対象は常に呼び出し元自身のテナント。テナント間の移送はアーティファクト経由で行われ、テナントをまたぐ直接書き込みは起きません
import/preview
valid: true
ontologyTypes+1 追加~0 変更0 変更なし
policies+4 追加~2 変更0 変更なし
actions+3 追加~1 変更0 変更なし
importApply は先に検証 ▸ 無効なら 409 · 自テナントにのみアップサート
audit/verify
ok: true
verifyChain ▸ 連鎖する SHA-256 · 署名付きレシート
レジストリと認定
パックを公開・インストールするための共有レジストリ。
検証済みのパックをチャネルへ公開すれば、どの管理者も一覧から自テナントへインストールできます——署名の検証を経たうえで。テナント間の配布が成り立つのは、HMAC 署名がデプロイメントの署名シークレットを用いてコンテンツハッシュに対して行われるためで、あるテナントが公開したエントリは、別のテナントでも問題なく検証・インストールできます。
- チャネルは stable と beta — 各チャネルで最新バージョンを保持
- publish はレジストリへコピーする前にハッシュと署名を再検証（検証できないパックは拒否）
- install は署名を検証したうえで呼び出し元のテナントに適用。テナント分離は常に維持されます
- 認定プログラム：署名済みでバージョン固定されたパックには、測定済みの評価カバレッジを伴う Certified バッジが付きます
提供中のパック
認定済みパックが1つ提供中——参照ブループリントが2つ。
US Individual Tax パックは本日、署名済み・認定済みのバンドルとして提供中です。ハッシュと署名で検証し、自社テナントにインポートできます。Insurance Claims と KYC/AML は参照ブループリントです——オントロジー、ポリシー、アクション、エージェントは完全に仕様化されていますが、署名済みでインストール可能なパックはロードマップ上にあります。