コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

Aggrega ケイパビリティ非依存グラフ (IR) スキーマ

自動生成されたリファレンスです。手動で編集しないでください。公開されている JSON Schema から再生成してください。

スキーマ ID: https://aggrega.ai/schemas/ir-v1beta1.schema.json

Topology Builder が出力する、平坦化され完全に解決された 1 次元のグラフです。

トップレベルの型: object

プロパティ

プロパティ種類必須説明
apiVersionconst “aggrega.ai/v1beta1”はい定数: "aggrega.ai/v1beta1"
kindconst “IR”はい定数: "IR"
metadataIRMetadataはいグラフの識別情報: グラフの構築元となった Aggregate です。
specIRSpecはいグラフ本体: そのノード、エッジ、およびノードをキーとするペイロードです。

追加のプロパティは許可されません。

定義

Maintainer

プロパティ種類必須説明
namestringはいメンテナーの名前です。
emailstringいいえメンテナーのメールアドレスです。
urlstringいいえメンテナーのウェブアドレスです。

FieldProvenance

アタッチメントの values または infra ペイロード内の 1 つのリーフの由来です。

プロパティ種類必須説明
originstringはいリーフが明示的に記述されたものか、アノテーション駆動の展開パスによって追加されたものかを示します。
sidestringいいえアノテーションが宣言された記述面です。明示的なリーフでは存在しません。
annotation_keystringいいえこのリーフを追加したアノテーション名です。明示的なリーフでは存在しません。
annotation_sourcestringいいえアノテーション宣言のソース位置で、: の形式です。明示的なリーフでは存在しません。
overridden_annotationFieldProvenanceいいえ明示的なリーフに対してこのリーフを失ったアノテーションの寄与です。明示的なリーフがアノテーションによって追加されたリーフを上書きした場合に、置き換えられた抑制済みの由来を示します。単数形です。保持される抑制済みの寄与は常に 1 つだけです。

追加のプロパティは許可されません。

AttachmentConnection

アタッチメントが属する接続です。コンポーネント自身のアタッチメントブロックではなく、コンポーネントが引く接続上に記述されたアタッチメントについて、接続が配線されるソケットと、接続が記述されるエイリアスを示します。この組はグラフのエッジの 1 つを指します。つまり、ソースがアタッチメントを持つノードであり、ソケットとエイリアスがこれらであるエッジです。コンシューマーはアタッチメントをそのエッジに結び付け、それを介してアタッチメントが提示されるターゲットに結び付けます。

プロパティ種類必須説明
socketstringはい接続が配線されるソケットです。アタッチメントが属するエッジのソケットです。
aliasstringはい接続が記述されるエイリアスです。アタッチメントが属するエッジのエイリアスです。

追加のプロパティは許可されません。

IRFeatureEntry

feature_values_mapping に格納される、ノードの解決済みアタッチメント 1 つです。運用の Feature、認証情報の Feature、ID の Feature のいずれのアタッチメントファミリーもこの形を共有するため、あるファミリーが他より情報の失われた射影を受けることはありません。認証情報アタッチメントの values に何を格納するかは作成者の選択です。参照による認証情報はシークレットストアへのポインターを、値による認証情報は秘密情報そのものを格納し、コンパイラはどちらも解決せず、記述されたものをそのまま運びます。

プロパティ種類必須説明
typestringはいこのアタッチメントが要求する Catalog Feature の URI です。
resolved_versionstringはいコンパイル時に解決された正確なセマンティックバージョンです。
labelsstring のマップいいえアタッチされた Feature のカタログラベルで、カタログエンティティが宣言した順にそのまま格納されます。フィルタリング、正規化、プレフィックスの除去は一切行われないため、コンシューマーはカタログ作成者が書いたとおりの内容を読み取れます。コンパイラはこれらを一切読みません。Feature がラベルを宣言していない場合、およびその型がどのカタログエンティティにも解決されない場合は存在しません。
catalog_annotationsstring のマップいいえアタッチされた Feature のカタログアノテーション、すなわちこのアタッチメントが指す Feature エンティティの metadata.annotations です。そのエンティティが宣言した順にそのまま格納され、フィルタリング、正規化、プレフィックスの除去は一切行われないため、コンシューマーは作成者独自の名前空間のキーも含め、カタログ作成者が書いたとおりの内容を読み取れます。コンパイラはこれらを一切読みません。annotation_key および annotation_source とは別物です。これら 2 つは、このアタッチメントがそもそも存在する原因となったアノテーションの名前と位置を示します。つまり、これら 2 つはアタッチメントがどのように生じたかを報告し、このフィールドはアタッチメントが指すエンティティのメタデータを報告します。features: ブロックに記述されたアタッチメントは、これらのアノテーションを持ちますが、前者の 2 つはどちらも持ちません。Feature がアノテーションを宣言していない場合、およびその型がどのカタログエンティティにも解決されない場合は存在しません。
bindingstringいいえこのアタッチメントが埋めるアタッチメントスロットの名前、または宣言されたスロットを埋めない場合は “free” です。スロットは 2 つの場所のいずれかで宣言され、アタッチメントが記述された場所によってどちらかが決まります。ノード自身のアタッチメントブロックのアタッチメントは、ホストの Component が featuresSchema で宣言するスロットを埋め、接続上に記述されたアタッチメントは、接続のソケットがホストの Component 上のそのソケットの featuresSchema で宣言するスロットを埋めます。どちらの場合も対応付けは名前によります。Feature がコンポーネントのブロック上または接続上でスロットの名前でアタッチされたとき、アタッチメントはそのスロットを埋めます。したがって値は宣言されたスロット集合の正確なキーであり、アタッチメントのキーから読み取られたものではありません。ソケットのスロット集合は閉じています。ソケットが宣言していない名前で接続上に記述されたアタッチメントはビルドを停止させるため、接続を持つアタッチメントが free を報告することはありません。単なる真偽値ではなくスロット名を格納するのは、どのスロットが埋められたかが答えのより有用な半分だからです。ホストの Component の宣言済みスロット集合を解決できなかった場合は空であり、これは “free” とは異なります。free は、宣言されたスロットのいずれもこの名前を持たないという肯定的な判定です。
valuesobjectいいえアタッチメントの運用設定ペイロードです。認証情報の場合は、作成者が宣言した形式のいずれか、すなわちシークレットストアへのポインターまたは秘密情報そのものです。
infraobjectいいえこのアタッチメントのインスタンスごとの物理的なサイジングです。
injectobjectいいえ内容に依存しないインジェクションのルーティングです。ローカル変数をターゲットの provides キーに対応付けます。
originstring (enum)いいえfeatures: ブロックに記述されたアタッチメント (explicit) と、アノテーション駆動の展開パスによって生成された合成アタッチメント (annotation) を区別します。アタッチメントの value/infra リーフに両方が混在する場合は mixed です (その場合、リーフごとの詳細は provenance マップにあります)。使用できる値: "explicit", "annotation", "mixed"
annotation_keystringいいえ合成アタッチメントをトリガーしたアノテーション名です。origin が explicit の場合は存在しません。
annotation_sourcestringいいえアノテーション宣言のソース位置で、: の形式です。origin が explicit の場合は存在しません。
values_provenanceFieldProvenance のマップいいえvalues ペイロードのリーフごとの由来で、ドット区切りのリーフパスをキーとします。
infra_provenanceFieldProvenance のマップいいえinfra ペイロードのリーフごとの由来で、ドット区切りのリーフパスをキーとします。
sensitive真偽値いいえこのアタッチメントが、作成者が機密と宣言した情報を扱う場合に true です。つまり、アタッチされた Feature が values、infra、provides のいずれかの柱で機密のリーフを宣言しているか、アタッチメントが埋めるスロットが、運ぶ情報を機密と宣言している場合です。そのスロットとは、ホストの Component の同名のアタッチメントスロット、または接続上に記述されたアタッチメントの場合は接続のソケットが宣言する同名のスロットです。マージ後のアタッチメントに対するこれらの宣言から導出され、値の内容や名前から導出されることはありません。どちらの宣言もない場合は未設定です。
sensitive_injectstring のマップのマップいいえ参照先の provides キーをアタッチされた Feature が機密と宣言している inject の配信キーで、inject と同じ形をとります。メカニズム、次に配信キーで、値は参照先の provides キーです。inject のサブセットです。アタッチメントが配信メカニズムを宣言していない場合、または機密の provides キーを参照していない場合は存在しません。
sensitive_payload_leavesstring[]いいえこのアタッチメントの values および infra ペイロードが保持するリーフのうち、アタッチされた Feature が sensitive と宣言しているもので、それぞれデータが占めるピラー接頭辞付きのドット区切りパス(values. または infra.)として示されます。ここで読み取られるペイロードはアタッチメントが最終的に保持するものであるため、Feature のスキーマがデフォルトとして宣言した値にあるリーフも、作成者が記述したリーフと並んで示されます。補完されたデフォルトはペイロードが保持するデータであり、記述されたブロックだけから読み取ったマーキングではそれが示されないままになります。これはセンシティビティマーキングのリーフ単位であり、他の二つのどちらも答えない問いに答えます。sensitive はアタッチメント全体に対して一つの答えを、sensitive_inject は inject の配信キーごとに一つの答えを返し、どちらも個々のリーフを示しません。リーフは、Feature のスキーマが sensitive と宣言したパスがそれをカバーする場合に現れます。宣言がそのリーフを指すか、それを含むオブジェクトを指す場合であり、宣言がカバーするオブジェクトの下にあるリーフはその宣言によって示されます。照合はドット区切りパスに対してセグメント単位で行われ、パス自体のテキストからは何も読み取らず、値も検査しないため、db での宣言は db.password をカバーし、dbPassword という名前の兄弟リーフには及びません。アタッチメント単位の答えが個々のリーフに展開されることはありません。そうすると、読み取り可能なままのリーフについて誤った主張をすることになるためです。キーがないことは、このアタッチメントがその Feature が sensitive と宣言するリーフを一つも示さないことを表します。ペイロードがセンシティブでないことを主張するものではなく、示すべきリーフを持たないアタッチメントと、この軸をまったく報告しないプロデューサーとを区別するものでもありません。キーがないことを値を平文で表示または出力してよいという許可と解釈するゲストは、逆に読んでいます。リーフはペイロードが保持する順序で届き、values ピラーのものが infra ピラーのものより先になります。これは values および infra ペイロード自体が保持する順序と同じであり、同一入力の実行間でペイロードをバイト単位で同一にするものです。アタッチメントがその Feature が sensitive と宣言するリーフを保持しない場合は存在しません。
connectionAttachmentConnectionいいえこのアタッチメントが属する接続です。ノードの接続のいずれかに記述されたすべてのアタッチメントに存在し、ノード自身のアタッチメントブロックのすべてのアタッチメントには存在しません。接続に記述されたアタッチメントは、それ以外のあらゆる点でノードのアタッチメントの一つです。修飾名(接続のエイリアスとスロットをドットで連結したもの)をキーとし、バインディングとセンシティビティを接続のソケットが宣言するスロットから受け取ります。そのため、このフィールドが両者を区別するものであり、キーから読み取らせるのではなく、接続をデータとして保持します。コンシューマーはソケットとエイリアスによってこれをグラフのエッジに結合します。このアタッチメントを保持するノードをソースとし、ソケットとエイリアスがこれらであるエッジが、アタッチメントが提示される接続であり、そのエッジのターゲットが提示先です。Feature アタッチメントが引く接続のアタッチメントがこれを保持することはありません。そのような接続はアタッチメントを保持しないためです。
realizationstringいいえこのアタッチメントを実現する FeatureRecipe で、: の形式です。Manifest がこれにバインドするもの(Manifest の名前階層がアタッチメント自身の名前をマップしている場合はその名前によって、そうでない場合はその Feature タイプによって)であり、同じドキュメントのビルドがこれをレンダリングする際に使うものです。接続に記述されたアタッチメントの場合、名前階層が参照する名前はその修飾名、つまり接続のエイリアスとスロットをドットで連結したものです。この値は、aggrega inspect がアタッチメントの実現として出力するペアであり、ターゲットがレンダリングするものに来歴を刻印する場合は、その FeatureRecipe がレンダリングするドキュメント上の aggrega.ai/recipe-uri の値でもあります。そのため、コンシューマーは形式間の変換なしに、アタッチメントをそのレンダリング結果に結合できます。FeatureRecipe を名前とバージョンで示し、ケイパビリティでは示しません。このフィールドは、グラフの構築時に Manifest とカタログから読み取った、Manifest がバインドする FeatureRecipe を記録します。これを生成するために何かを取得することはなく、FeatureRecipe はビルドがレンダリングするときにのみレンダリングされます。Manifest がアタッチメントをカタログが保持するどの FeatureRecipe にもバインドしない場合は存在しません。

追加のプロパティは許可されません。

IRFeatureEntry.inject

内容に依存しないインジェクションのルーティングです。ローカル変数をターゲットの provides キーに対応付けます。

プロパティ種類必須説明
envstring のマップいいえ環境変数による配信です。キーはコンシューマーのローカル変数名、値はターゲットの provides キーです。
filestring のマップいいえファイルマウントによる配信です。キーはコンシューマーのローカルファイルパス、値はターゲットの provides キーです。
argstring のマップいいえコマンドライン引数による配信です。キーはコンシューマーのフラグプレフィックス、値はターゲットの provides キーです。

IRBoundaryFeature

IR に射影されたバウンダリレベルの Feature アタッチメントです。Feature タイプの URI と、バウンダリスコープの FeatureRecipe がレンダリングし、そのソースを解決する際の基準となるバウンダリの infra で構成されます。バウンダリレベルのアタッチメントは values ペイロードを保持しません。

プロパティ種類必須説明
typestringはいこのバウンダリにアタッチされたカタログ Feature の URI です。
infraobjectいいえバウンダリアタッチメントの物理的なサイジングです。バウンダリスコープの FeatureRecipe がテンプレートとソースを評価する際の基準となる infra です。
sensitive_payload_leavesstring[]いいえこのバウンダリアタッチメントの infra ペイロードが保持するリーフのうち、アタッチされた Feature が sensitive と宣言しているもので、それぞれデータが占めるピラー接頭辞付きのドット区切りパスとして示されます。バウンダリレベルのアタッチメントは values ペイロードを保持しないため、ここには infra. の座標のみが現れます。ここで読み取られるペイロードはアタッチメントが最終的に保持するものであるため、Feature のスキーマがデフォルトとして宣言した値にあるリーフも、バウンダリが記述したリーフと並んで示されます。補完されたデフォルトはペイロードが保持するデータであり、記述されたブロックだけから読み取ったマーキングではそれが示されないままになります。リーフは、Feature のスキーマが sensitive と宣言したパスがそれをカバーする場合に現れます。宣言がそのリーフを指すか、それを含むオブジェクトを指す場合であり、宣言がカバーするオブジェクトの下にあるリーフはその宣言によって示されます。照合はドット区切りパスに対してセグメント単位で行われ、パス自体のテキストからは何も読み取らず、値も検査しないため、db での宣言は db.password をカバーし、dbPassword という名前の兄弟リーフには及びません。キーがないことは、このアタッチメントがその Feature が sensitive と宣言するリーフを一つも示さないことを表し、これにはアタッチされた Feature がこのリーダーが読み取れるスキーマに解決されない場合も含まれます。infra ペイロードがセンシティブでないことを主張するものではなく、示すべきリーフを持たないアタッチメントと、この軸をまったく報告しないプロデューサーとを区別するものでもありません。キーがないことを値を平文で表示または出力してよいという許可と解釈するコンシューマーは、逆に読んでいます。リーフはペイロードが保持する順序で届きます。これは infra ペイロード自体が保持する順序と同じであり、同一入力の実行間でグラフをバイト単位で同一に保つものです。アタッチメントがその Feature が sensitive と宣言するリーフを保持しない場合は存在しません。
realizationstringいいえこのバウンダリアタッチメントを実現する FeatureRecipe で、: の形式です。Manifest がこれにバインドするもの(Manifest の名前階層がアタッチメント自身の名前をマップしている場合はその名前によって、そうでない場合はその Feature タイプによって)であり、同じドキュメントのビルドがこれをレンダリングする際に使うものです。feature_values_mapping の下にあるアタッチメントエントリの実現と同じフィールドであり、同じ方法で読み取られます。Manifest がアタッチメントをカタログが保持するどの FeatureRecipe にもバインドしない場合は存在しません。

追加のプロパティは許可されません。

CatalogMetadata

カタログエンティティから明示的に抽出されたエンタープライズメタデータスイートで、ライフサイクルと所有権のデータを Wasm リンターに公開します。

プロパティ種類必須説明
maintainersMaintainer[]いいえカタログエンティティが自身の所有者として列挙するメンテナーです。
licensestringいいえカタログエンティティが、記述するソフトウェアについて宣言する SPDX ライセンス識別子です。
repositorystringいいえカタログエンティティがソースファイルの格納先として示す Git リポジトリの URL です。
homestringいいえカタログエンティティのホームページ、wiki、またはドキュメントの URL です。
keywordsstring[]いいえカタログエンティティが宣言する説明用のキーワードです。

追加のプロパティは許可されません。

IRNode

プロパティ種類必須説明
descriptionstringいいえこのコンポーネントインスタンスのアプリケーション内での役割を説明する、開発者が記述する任意のドキュメントです。レンダリングと lint 診断のために Aggregate から受け渡されます。
labelsstring のマップはいエンティティのダックタイピングおよびオントロジーのラベルです。
componentstringはい基になる Component の名前です。
resolved_versionstringはいコンパイル時に解決された Component の正確なセマンティックバージョンです。
sync_waveintegerいいえそれを含む境界の syncWave フィールドから継承されるデプロイのウェーブです (既定値は 0。負の値も可)。K8s と Helm では、ウェーブがデプロイの順序を決めます。ウェーブは argocd.argoproj.io/sync-wave アノテーションになり、チャートがすでに Helm フックとしてマークしているリソースでは、そのフックの helm.sh/hook-weight にもなります。compose では、この値はサービスラベルとして記録されるとともに、レンダリング先のファイルのサービスを、それらの間の depends_on によって順序付けます。cloudformation では、ディスパッチグループが組み立てるスタックのプロビジョニングを順序付けます。各ウェーブのすべてのリソースは、直前のウェーブのリソースに依存すると宣言されます。これは作成される順序と、その逆の削除される順序であり、準備完了を表すものではありません。スタックテンプレートにはリソースの準備完了という概念がないためです。terraform では、境界が組み立てるルート設定のモジュールブロックを順序付けます。各ウェーブのすべてのモジュールは、直前のウェーブのモジュールに依存すると宣言されます。これはエンジンがアクションを実行する順序であり、準備完了を表すものではありません。設定にはリソースの準備完了という概念がないためです。この値はノードのビルドの来歴にも含まれます。
boundary_pathstringいいえこのノードが配置される Release の境界のパスです。最も外側の境界から内側へ向かう境界名を / で連結したものです (例: 境界 data の中で宣言された境界 inner に配置されたコンポーネントでは ‘data/inner’)。境界名には / を含められないため、パスは曖昧さなく各境界に分割できます。Release が境界へルーティングする、インポートされた Aggregate のノードは、その境界のパスを持ちます。レンダリングプラグインが境界を考慮した一意の識別子を生成できるようにします。
subsystem_pathstringいいえこのノードのコンポーネントが宣言されている Aggregate のサブシステムのパスです。最も外側のサブシステムから内側へ向かうサブシステム名を . で連結したものです (例: サブシステム backend の中にネストされたサブシステム storage で宣言されたコンポーネントでは ‘backend.storage’)。サブシステム名には . を含められないため、パスは曖昧さなく各サブシステムに分割できます。トップレベルの components を宣言する Aggregate のコンポーネントは、合成された default を持ち、synthesized_subsystem でマークされます。パスはそのコンポーネントを宣言する Aggregate からの相対パスです。インポートされた Aggregate が提供するノードは、インポート時の名前を含まない、その Aggregate 内でのパスを持ちます (例: インポートされた Aggregate のサブシステム tier 内のコンポーネントでは ‘tier’)。そのため、異なる Aggregates のノードが同じパスを共有することがあります。インポート名で始まるノードの ID と source_file によって、それらを区別できます。
synthesized_subsystem真偽値いいえこのノードのサブシステムがコンパイラによって合成された場合に true になります。これは、名前付きの subsystems ではなくトップレベルの components を宣言する Aggregate のために作成される default サブシステムです。記述されるものではなく導出される来歴であり、合成された default と、ユーザーが明示的に default と名付けたサブシステムを区別します。synthesized_boundary とは独立しています (ノードはどちらか一方の軸、または両方の軸で合成されることがあります)。記述されたすべてのサブシステムでは存在しません (false)。
synthesized_boundary真偽値いいえこのノードの境界がコンパイラによって合成された場合に true になります。これは、名前付きの boundaries ではなくトップレベルの components を宣言する Release のために作成される default 境界です。記述されるものではなく導出される来歴であり、合成された default と、ユーザーが明示的に default と名付けた境界を区別し、ノードの成果物を dist/boundaries/default/ ではなく dist/ 直下に出力します。記述されたすべての境界では存在しません (false)。
catalog_metadataCatalogMetadataいいえカタログエンティティから明示的に抽出されたエンタープライズメタデータスイートで、ライフサイクルと所有権のデータを Wasm リンターに公開します。
catalog_annotationsstring のマップいいえドメイン 2 でプラットフォームアーキテクトが記述する、不変で本質的なコンポーネントの特性です。
release_annotationsstring のマップいいえRelease 内の境界からカスケードされる、物理トポロジーの文字列と運用上の実情です。
aggregate_annotationsstring のマップいいえAggregate 内のサブシステムからカスケードされる、コグニティブメタデータ、開発者の意図、および FinOps です。
self_injectobjectいいえAggregate から引き継がれる Component レベルのセルフインジェクトブロックで、ノードが自身のために宣言する、依存しないインジェクションルーティングです。このスキーマ層では不透明であり、これを読むポリシープラグインがバイト列を解析します。
source_filestringいいえこのノードが記述された Aggregate ファイルの、ワークスペースからの相対パスです。ルート階層のノードはルート Aggregate のパスを持ち、サブアグリゲートのノードはインポートされた Aggregate のファイルパスを持ちます。パスはワークスペースルート (.aggrega-config.yaml を含むディレクトリ) からの相対パスであるため、ワークスペースが異なる絶対パスにあるマシン間でもグラフはバイト単位で同一になります。ファイルごとに診断をフィルタリングするコンシューマーは、比較の前に同じワークスペースルートを基準にこのフィールドを解決します。ワークスペースルートなしでグラフがビルドされた場合は存在しません。
usesobjectいいえ記述されたとおりのノードの uses ブロックです。各ソケット名は、ターゲットインスタンス名のリスト、またはエイリアスをキーとする接続エントリのマップのいずれかに対応し、作成者が宣言した順序で並びます。これは記述されたとおりのブロックであり、edges 内の解決済みの接続とは異なる事実です。作成者が値を入れたソケットは、接続を生まなかった場合でもここに現れるため、読み手は作成者が埋めたソケットと、ターゲットに到達するソケットを区別できます。ノードが uses ブロックを記述していない場合は存在しません。このスキーマ層では不透明であり、これを読むポリシープラグインがバイト列を解析します。
sensitive_payload_leavesstring[]いいえこのノードの values および infra ペイロードが持つリーフのうち、その Component が機密と宣言するもので、それぞれデータが占める、ピラーを接頭辞とするドット区切りのパス values. または infra. として示されます。これはノード自身のデータ (values_mapping と infra_mapping がこのノードについて持つもの) を示し、アタッチメントエントリのマーキングとは対象が異なります。後者は、アタッチメントがその Feature の宣言に照らして持つデータを示します。どちらも他方から復元することはできません。ノードの Component とアタッチメントの Feature は異なるスキーマを宣言し、何もアタッチしないノードも values を持つためです。ここで読まれるペイロードはこれら 2 つのマッピングが持つものであるため、Component のスキーマが既定値として宣言する値にあるリーフも、作成者が記述したリーフと並んで示されます。埋められた既定値はグラフが持つデータであり、記述されたブロックだけから読み取るマーキングではそれが示されないままになります。リーフは、Component のスキーマが機密と宣言するパスがそれを覆う場合に現れます。宣言がそのリーフを示すか、それを含むオブジェクトを示す場合であり、宣言が覆うオブジェクトの下にあるリーフはその宣言によって示されます。照合はドット区切りのパスに対してセグメント単位で行われ、パス自体のテキストからは何も読み取らず、値も検査しません。そのため、db での宣言は db.password を覆い、dbPassword という名前の兄弟リーフには及びません。キーが存在しないことは、このノードがその Component が機密と宣言するリーフを示さないことを表し、ノードの Component がこのリーダーが読めるスキーマに解決されない場合も含みます。ノードのペイロードが機密でないことを示すものではなく、示すべきそのようなリーフを持たないノードと、この軸をまったく報告しないプロデューサーを区別するものでもありません。キーが存在しないことを、値を平文で表示または出力してよいという許可と解釈するコンシューマーは、意味を逆に読んでいます。リーフはペイロードが保持する順序で、values ピラーのものが infra ピラーのものより先に並びます。これはそれらのペイロード自体が持つ順序と同じであり、同一の入力に対する実行間でグラフをバイト単位で同一に保つものです。ノードがその Component が機密と宣言するリーフを持たない場合は存在しません。

追加のプロパティは許可されません。

IREdge

プロパティ種類必須説明
sourcestringはい接続の起点となる、消費側ノードの ID です。
targetstringはい接続の到達先ノードの ID です。
socketstringいいえこのエッジが属する usesSchema のカテゴリ(例: ‘databases’、‘tools’)。
aliasstringいいえこの接続に対して開発者が定義したエイリアス(例: ‘primary_db’)。
socket_declarationstring (enum)はいソケットの由来です。ソケットを所有するカタログエンティティ(消費側の Component、または Feature が記述したエッジでは起点の Feature)がそのソケットを usesSchema に列挙している場合は declared、カタログが宣言していないソケットを Aggregate の作成者が指定した場合は ad-hoc になります。これはエッジの作成者とは独立した第三の軸です。誰がエッジを引いたかではなくソケットの由来を表すため、宣言済みソケットへの Release 作成のエッジと、ad-hoc ソケットへの Aggregate 作成のエッジは、2 つの軸でそれぞれ独立に異なります。宣言済みソケットは usesSchema のエントリを持ち、そこにはエッジが到達できるターゲットを制約するセレクタも含まれます。ad-hoc ソケットにはカタログのエントリがなく、したがってセレクタもないため、エッジが運べるものはターゲットが宣言した provides だけで制限されます。常に存在するため、コンシューマが値の欠落を declared と解釈する必要はなく、ポリシーはすべてのエッジが declared であることを要求できます。アタッチメントのバインディングマーカーとは別物です。そちらは同じ形の問いに別の対象について答えます。許可される値: "declared"、"ad-hoc"
origin_featurestringいいえこのエッジが Feature(feature.aggrega.ai/kind: secret のラベルが付いた認証情報の Features を含む)によって自律的に宣言された場合、その Feature の型 URI を示します。Wasm プラグインが自身のトポロジーを分離できるようにします。
origin_feature_instancestringいいえこのエッジを宣言した Feature のアタッチメントごとのインスタンス名です。境界スコープの FeatureRecipe の解決済み provides をインスタンス単位で特定し、1 つの境界上にある同じ Feature 型の 2 つのアタッチメントを区別します。
origin_release真偽値いいえ宣言済みだが未バインドのソケットを Release が既存のコンポーネントに配線してこのエッジを作成した場合に true です。設定ではなくエッジの作成者を示します。開発者が宣言したエッジに Release が infra を供給しただけの場合は Aggregate 由来のままです(origin_release は未設定で、その Release の infra はエッジの infra マップに現れます)。origin_feature が設定 => Feature 由来、origin_release が true => Release 由来、どちらでもない => Aggregate 由来です。
valuesobjectいいえこのエッジについて解決された接続ごとの開発者の値(Aggregate のエッジに由来)です。解決時にソースソケット(消費側コンポーネント上のソケットで、エッジのソース)が宣言する valueSchema に対して検証され、消費側ノードのレンダリングコンテキストの .context.uses..values に投影されます。作成者が省略したキーはソケットが宣言したデフォルトで埋められ、作成者が記述した値が優先されます。
infraobjectいいえこのエッジについて解決された接続ごとの infra で、Release のエッジエントリによって供給されます。解決時にソースソケット(消費側コンポーネント上のソケットで、エッジのソース)が宣言する infraSchema に対して検証され、.context.uses..infra に投影されます。作成者が省略したキーはソケットが宣言したデフォルトで埋められ、作成者が記述した値が優先されます。
injectobjectいいえ内容に依存しないインジェクションのルーティングです。ローカル変数をターゲットの provides キーに対応付けます。
sensitive_payload_leavesstring[]いいえこのエッジの values と infra が保持するリーフのうち、それらが記述される対象のソケットが sensitive と宣言しているもので、それぞれデータが占めるピラー接頭辞付きのドット区切りパス(values. または infra.)として示されます。読み取られる宣言は、消費する側のコンポーネント(エッジのソース)上の、このエッジが接続されるソケットの下にある接続ごとの契約です。その valueSchema が values を、infraSchema が infra を規定し、これは両方のペイロードが検証される契約と同じものです。ターゲットの宣言は関与しません。ターゲットが公開するものは、コンシューマーがその接続のために記述する設定とは別のデータです。これはノード上のマーキングと同じフィールドで、同じ方法で読み取られますが、対象が異なります。ノードのマーキングはノード自身のデータをその Component のスキーマに照らして示し、こちらは接続の設定をソケットの契約に照らして示すため、どちらも他方から復元することはできません。ここで読み取られるペイロードはこのエッジが保持するものであるため、ソケットの契約がデフォルトとして宣言した値にあるリーフも、作成者が記述したリーフと並んで示されます。リーフは、契約が sensitive と宣言したパスがそれをカバーする場合に現れます。宣言がそのリーフを指すか、それを含むオブジェクトを指す場合です。照合はドット区切りパスに対してセグメント単位で行われ、パス自体のテキストからは何も読み取らず、値も検査しないため、db での宣言は db.password をカバーし、db_password という名前の兄弟リーフには及びません。宣言された sensitive な値をグラフから伏せるサーフェスは、このエッジの values と infra にあるこれらのリーフを伏せ、同じ接続についての消費側ノードの uses エントリーでも伏せます。このエントリーは作成者が記述したとおりに値を保持しているためです。キーがないことは、このエッジがそのソケットの契約が sensitive と宣言するリーフを一つも示さないことを表し、ソケットがこの読み取り側が読める契約を宣言していない場合も含みます。設定がセンシティブでないことを主張するものではなく、キーがないことを値を平文で表示または出力してよいという許可と解釈するコンシューマーは、逆に読んでいます。リーフはペイロードが保持する順序で届き、values ピラーのものが infra ピラーのものより先になります。これが同一入力の実行間でグラフをバイト単位で同一に保つものです。エッジがそのソケットの契約が sensitive と宣言するリーフを保持しない場合は存在しません。

追加のプロパティは許可されません。

IREdge.inject

内容に依存しないインジェクションのルーティングです。ローカル変数をターゲットの provides キーに対応付けます。

プロパティ種類必須説明
envstring のマップいいえ環境変数による配信です。キーはコンシューマーのローカル変数名、値はターゲットの provides キーです。
filestring のマップいいえファイルマウントによる配信です。キーはコンシューマーのローカルファイルパス、値はターゲットの provides キーです。
argstring のマップいいえコマンドライン引数による配信です。キーはコンシューマーのフラグプレフィックス、値はターゲットの provides キーです。

IRMetadata

グラフの識別情報: グラフの構築元となった Aggregate です。

プロパティ種類必須説明
aggregate_namestringはいAggregate の metadata.name です。

追加のプロパティは許可されません。

IRProvenance

診断と監査のためのトレーサビリティメタデータです。

プロパティ種類必須説明
schema_versionstringはいグラフが準拠する IR スキーマのバージョンです。aggrega.ai/v1beta1 で、グラフの apiVersion が持つ値と同じです。
compiler_versionstringはい必須のコンプライアンススタンプです。このグラフをビルドした aggrega バイナリを、そのバージョンによって識別します。
aggregate_versionstringはいコンパイル時に使用されたルート Aggregate のインテントの正確なセマンティックバージョンです。
manifest_versionstringはいコンパイル時に使用された Manifest ロックファイルの正確なセマンティックバージョンです。
release_versionstringはいコンパイル時に使用された Release ルーティングファイルの正確なセマンティックバージョンです。

追加のプロパティは許可されます。

IRSpec

グラフ本体: そのノード、エッジ、およびノードをキーとするペイロードです。

プロパティ種類必須説明
nodesIRNode のマップはいグラフ内のすべてのノードの辞書で、絶対 ID をキーとします。純粋にトポロジー的です。キー: 1 文字以上の英字、数字、アンダースコア、ドット、ハイフン。パターン: ^[a-zA-Z0-9_.-]+$。
edgesIREdge[]はいノード間の明示的な論理ネットワークパスと依存関係です。
values_mappingobjectはい不透明なパススルーのコグニティブペイロードの唯一の情報源で、ノード ID でマッピングされます。
infra_mappingobjectはいRelease から注入される物理的なサイジングペイロードで、ノード ID でマッピングされます。
feature_values_mappingIRFeatureEntry のマップのマップはいノード ID から、そのノードにアタッチされた Feature 設定への正規化されたマップです。1 つのバケットが、何を生成するかにかかわらずノード上のすべてのアタッチメント(運用の Features、認証情報の Features、アイデンティティの Features)を保持し、作成者が各アタッチメントに付けたインスタンス名をキーとします。ノードの接続の 1 つに記述されたアタッチメントは、接続のエイリアスとスロットをドットで結合した修飾名をキーとし、自身の connection フィールドでその接続を指定します。キー: 1 文字以上の英字、数字、アンダースコア、ドット、ハイフン。パターン: ^[a-zA-Z0-9_.-]+$。
boundary_featuresIRBoundaryFeature のマップのマップいいえ各境界の Feature アタッチメントで、境界パス、次にインスタンス名をキーとします。グラフに境界レベルの Feature アタッチメントがある場合にのみ存在します。キー: 1 文字以上の英字、数字、アンダースコア、ドット、スラッシュ、ハイフン。パターン: ^[a-zA-Z0-9_./-]+$。
provenanceIRProvenanceはい診断と監査のためのトレーサビリティメタデータです。

追加のプロパティは許可されません。

IRGraph

プロパティ種類必須説明
apiVersionconst “aggrega.ai/v1beta1”はい定数: "aggrega.ai/v1beta1"
kindconst “IR”はい定数: "IR"
metadataIRMetadataはいグラフの識別情報: グラフの構築元となった Aggregate です。
specIRSpecはいグラフ本体: そのノード、エッジ、およびノードをキーとするペイロードです。

追加のプロパティは許可されません。