Aggrega ケイパビリティ非依存グラフ (IR) スキーマ
自動生成されたリファレンスです。手動で編集しないでください。公開されている JSON Schema から再生成してください。
スキーマ ID: https://aggrega.ai/schemas/ir-v1beta1.schema.json
Topology Builder が出力する、平坦化され完全に解決された 1 次元のグラフです。
トップレベルの型: object
プロパティ
| プロパティ | 種類 | 必須 | 説明 |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | はい | 定数: "aggrega.ai/v1beta1" |
kind | const “IR” | はい | 定数: "IR" |
metadata | IRMetadata | はい | グラフの識別情報: グラフの構築元となった Aggregate です。 |
spec | IRSpec | はい | グラフ本体: そのノード、エッジ、およびノードをキーとするペイロードです。 |
追加のプロパティは許可されません。
定義
Maintainer
| プロパティ | 種類 | 必須 | 説明 |
|---|---|---|---|
name | string | はい | メンテナーの名前です。 |
email | string | いいえ | メンテナーのメールアドレスです。 |
url | string | いいえ | メンテナーのウェブアドレスです。 |
FieldProvenance
アタッチメントの values または infra ペイロード内の 1 つのリーフの由来です。
| プロパティ | 種類 | 必須 | 説明 |
|---|---|---|---|
origin | string | はい | リーフが明示的に記述されたものか、アノテーション駆動の展開パスによって追加されたものかを示します。 |
side | string | いいえ | アノテーションが宣言された記述面です。明示的なリーフでは存在しません。 |
annotation_key | string | いいえ | このリーフを追加したアノテーション名です。明示的なリーフでは存在しません。 |
annotation_source | string | いいえ | アノテーション宣言のソース位置で、 |
overridden_annotation | FieldProvenance | いいえ | 明示的なリーフに対してこのリーフを失ったアノテーションの寄与です。明示的なリーフがアノテーションによって追加されたリーフを上書きした場合に、置き換えられた抑制済みの由来を示します。単数形です。保持される抑制済みの寄与は常に 1 つだけです。 |
追加のプロパティは許可されません。
AttachmentConnection
アタッチメントが属する接続です。コンポーネント自身のアタッチメントブロックではなく、コンポーネントが引く接続上に記述されたアタッチメントについて、接続が配線されるソケットと、接続が記述されるエイリアスを示します。この組はグラフのエッジの 1 つを指します。つまり、ソースがアタッチメントを持つノードであり、ソケットとエイリアスがこれらであるエッジです。コンシューマーはアタッチメントをそのエッジに結び付け、それを介してアタッチメントが提示されるターゲットに結び付けます。
| プロパティ | 種類 | 必須 | 説明 |
|---|---|---|---|
socket | string | はい | 接続が配線されるソケットです。アタッチメントが属するエッジのソケットです。 |
alias | string | はい | 接続が記述されるエイリアスです。アタッチメントが属するエッジのエイリアスです。 |
追加のプロパティは許可されません。
IRFeatureEntry
feature_values_mapping に格納される、ノードの解決済みアタッチメント 1 つです。運用の Feature、認証情報の Feature、ID の Feature のいずれのアタッチメントファミリーもこの形を共有するため、あるファミリーが他より情報の失われた射影を受けることはありません。認証情報アタッチメントの values に何を格納するかは作成者の選択です。参照による認証情報はシークレットストアへのポインターを、値による認証情報は秘密情報そのものを格納し、コンパイラはどちらも解決せず、記述されたものをそのまま運びます。
| プロパティ | 種類 | 必須 | 説明 |
|---|---|---|---|
type | string | はい | このアタッチメントが要求する Catalog Feature の URI です。 |
resolved_version | string | はい | コンパイル時に解決された正確なセマンティックバージョンです。 |
labels | string のマップ | いいえ | アタッチされた Feature のカタログラベルで、カタログエンティティが宣言した順にそのまま格納されます。フィルタリング、正規化、プレフィックスの除去は一切行われないため、コンシューマーはカタログ作成者が書いたとおりの内容を読み取れます。コンパイラはこれらを一切読みません。Feature がラベルを宣言していない場合、およびその型がどのカタログエンティティにも解決されない場合は存在しません。 |
catalog_annotations | string のマップ | いいえ | アタッチされた Feature のカタログアノテーション、すなわちこのアタッチメントが指す Feature エンティティの metadata.annotations です。そのエンティティが宣言した順にそのまま格納され、フィルタリング、正規化、プレフィックスの除去は一切行われないため、コンシューマーは作成者独自の名前空間のキーも含め、カタログ作成者が書いたとおりの内容を読み取れます。コンパイラはこれらを一切読みません。annotation_key および annotation_source とは別物です。これら 2 つは、このアタッチメントがそもそも存在する原因となったアノテーションの名前と位置を示します。つまり、これら 2 つはアタッチメントがどのように生じたかを報告し、このフィールドはアタッチメントが指すエンティティのメタデータを報告します。features: ブロックに記述されたアタッチメントは、これらのアノテーションを持ちますが、前者の 2 つはどちらも持ちません。Feature がアノテーションを宣言していない場合、およびその型がどのカタログエンティティにも解決されない場合は存在しません。 |
binding | string | いいえ | このアタッチメントが埋めるアタッチメントスロットの名前、または宣言されたスロットを埋めない場合は “free” です。スロットは 2 つの場所のいずれかで宣言され、アタッチメントが記述された場所によってどちらかが決まります。ノード自身のアタッチメントブロックのアタッチメントは、ホストの Component が featuresSchema で宣言するスロットを埋め、接続上に記述されたアタッチメントは、接続のソケットがホストの Component 上のそのソケットの featuresSchema で宣言するスロットを埋めます。どちらの場合も対応付けは名前によります。Feature がコンポーネントのブロック上または接続上でスロットの名前でアタッチされたとき、アタッチメントはそのスロットを埋めます。したがって値は宣言されたスロット集合の正確なキーであり、アタッチメントのキーから読み取られたものではありません。ソケットのスロット集合は閉じています。ソケットが宣言していない名前で接続上に記述されたアタッチメントはビルドを停止させるため、接続を持つアタッチメントが free を報告することはありません。単なる真偽値ではなくスロット名を格納するのは、どのスロットが埋められたかが答えのより有用な半分だからです。ホストの Component の宣言済みスロット集合を解決できなかった場合は空であり、これは “free” とは異なります。free は、宣言されたスロットのいずれもこの名前を持たないという肯定的な判定です。 |
values | object | いいえ | アタッチメントの運用設定ペイロードです。認証情報の場合は、作成者が宣言した形式のいずれか、すなわちシークレットストアへのポインターまたは秘密情報そのものです。 |
infra | object | いいえ | このアタッチメントのインスタンスごとの物理的なサイジングです。 |
inject | object | いいえ | 内容に依存しないインジェクションのルーティングです。ローカル変数をターゲットの provides キーに対応付けます。 |
origin | string (enum) | いいえ | features: ブロックに記述されたアタッチメント (explicit) と、アノテーション駆動の展開パスによって生成された合成アタッチメント (annotation) を区別します。アタッチメントの value/infra リーフに両方が混在する場合は mixed です (その場合、リーフごとの詳細は provenance マップにあります)。使用できる値: "explicit", "annotation", "mixed" |
annotation_key | string | いいえ | 合成アタッチメントをトリガーしたアノテーション名です。origin が explicit の場合は存在しません。 |
annotation_source | string | いいえ | アノテーション宣言のソース位置で、 |
values_provenance | FieldProvenance のマップ | いいえ | values ペイロードのリーフごとの由来で、ドット区切りのリーフパスをキーとします。 |
infra_provenance | FieldProvenance のマップ | いいえ | infra ペイロードのリーフごとの由来で、ドット区切りのリーフパスをキーとします。 |
sensitive | 真偽値 | いいえ | このアタッチメントが、作成者が機密と宣言した情報を扱う場合に true です。つまり、アタッチされた Feature が values、infra、provides のいずれかの柱で機密のリーフを宣言しているか、アタッチメントが埋めるスロットが、運ぶ情報を機密と宣言している場合です。そのスロットとは、ホストの Component の同名のアタッチメントスロット、または接続上に記述されたアタッチメントの場合は接続のソケットが宣言する同名のスロットです。マージ後のアタッチメントに対するこれらの宣言から導出され、値の内容や名前から導出されることはありません。どちらの宣言もない場合は未設定です。 |
sensitive_inject | string のマップのマップ | いいえ | 参照先の provides キーをアタッチされた Feature が機密と宣言している inject の配信キーで、inject と同じ形をとります。メカニズム、次に配信キーで、値は参照先の provides キーです。inject のサブセットです。アタッチメントが配信メカニズムを宣言していない場合、または機密の provides キーを参照していない場合は存在しません。 |
sensitive_payload_leaves | string[] | いいえ | このアタッチメントの values および infra ペイロードが保持するリーフのうち、アタッチされた Feature が sensitive と宣言しているもので、それぞれデータが占めるピラー接頭辞付きのドット区切りパス(values.db での宣言は db.password をカバーし、dbPassword という名前の兄弟リーフには及びません。アタッチメント単位の答えが個々のリーフに展開されることはありません。そうすると、読み取り可能なままのリーフについて誤った主張をすることになるためです。キーがないことは、このアタッチメントがその Feature が sensitive と宣言するリーフを一つも示さないことを表します。ペイロードがセンシティブでないことを主張するものではなく、示すべきリーフを持たないアタッチメントと、この軸をまったく報告しないプロデューサーとを区別するものでもありません。キーがないことを値を平文で表示または出力してよいという許可と解釈するゲストは、逆に読んでいます。リーフはペイロードが保持する順序で届き、values ピラーのものが infra ピラーのものより先になります。これは values および infra ペイロード自体が保持する順序と同じであり、同一入力の実行間でペイロードをバイト単位で同一にするものです。アタッチメントがその Feature が sensitive と宣言するリーフを保持しない場合は存在しません。 |
connection | AttachmentConnection | いいえ | このアタッチメントが属する接続です。ノードの接続のいずれかに記述されたすべてのアタッチメントに存在し、ノード自身のアタッチメントブロックのすべてのアタッチメントには存在しません。接続に記述されたアタッチメントは、それ以外のあらゆる点でノードのアタッチメントの一つです。修飾名(接続のエイリアスとスロットをドットで連結したもの)をキーとし、バインディングとセンシティビティを接続のソケットが宣言するスロットから受け取ります。そのため、このフィールドが両者を区別するものであり、キーから読み取らせるのではなく、接続をデータとして保持します。コンシューマーはソケットとエイリアスによってこれをグラフのエッジに結合します。このアタッチメントを保持するノードをソースとし、ソケットとエイリアスがこれらであるエッジが、アタッチメントが提示される接続であり、そのエッジのターゲットが提示先です。Feature アタッチメントが引く接続のアタッチメントがこれを保持することはありません。そのような接続はアタッチメントを保持しないためです。 |
realization | string | いいえ | このアタッチメントを実現する FeatureRecipe で、 |
追加のプロパティは許可されません。
IRFeatureEntry.inject
内容に依存しないインジェクションのルーティングです。ローカル変数をターゲットの provides キーに対応付けます。
| プロパティ | 種類 | 必須 | 説明 |
|---|---|---|---|
env | string のマップ | いいえ | 環境変数による配信です。キーはコンシューマーのローカル変数名、値はターゲットの provides キーです。 |
file | string のマップ | いいえ | ファイルマウントによる配信です。キーはコンシューマーのローカルファイルパス、値はターゲットの provides キーです。 |
arg | string のマップ | いいえ | コマンドライン引数による配信です。キーはコンシューマーのフラグプレフィックス、値はターゲットの provides キーです。 |
IRBoundaryFeature
IR に射影されたバウンダリレベルの Feature アタッチメントです。Feature タイプの URI と、バウンダリスコープの FeatureRecipe がレンダリングし、そのソースを解決する際の基準となるバウンダリの infra で構成されます。バウンダリレベルのアタッチメントは values ペイロードを保持しません。
| プロパティ | 種類 | 必須 | 説明 |
|---|---|---|---|
type | string | はい | このバウンダリにアタッチされたカタログ Feature の URI です。 |
infra | object | いいえ | バウンダリアタッチメントの物理的なサイジングです。バウンダリスコープの FeatureRecipe がテンプレートとソースを評価する際の基準となる infra です。 |
sensitive_payload_leaves | string[] | いいえ | このバウンダリアタッチメントの infra ペイロードが保持するリーフのうち、アタッチされた Feature が sensitive と宣言しているもので、それぞれデータが占めるピラー接頭辞付きのドット区切りパスとして示されます。バウンダリレベルのアタッチメントは values ペイロードを保持しないため、ここには infra.db での宣言は db.password をカバーし、dbPassword という名前の兄弟リーフには及びません。キーがないことは、このアタッチメントがその Feature が sensitive と宣言するリーフを一つも示さないことを表し、これにはアタッチされた Feature がこのリーダーが読み取れるスキーマに解決されない場合も含まれます。infra ペイロードがセンシティブでないことを主張するものではなく、示すべきリーフを持たないアタッチメントと、この軸をまったく報告しないプロデューサーとを区別するものでもありません。キーがないことを値を平文で表示または出力してよいという許可と解釈するコンシューマーは、逆に読んでいます。リーフはペイロードが保持する順序で届きます。これは infra ペイロード自体が保持する順序と同じであり、同一入力の実行間でグラフをバイト単位で同一に保つものです。アタッチメントがその Feature が sensitive と宣言するリーフを保持しない場合は存在しません。 |
realization | string | いいえ | このバウンダリアタッチメントを実現する FeatureRecipe で、 |
追加のプロパティは許可されません。
CatalogMetadata
カタログエンティティから明示的に抽出されたエンタープライズメタデータスイートで、ライフサイクルと所有権のデータを Wasm リンターに公開します。
| プロパティ | 種類 | 必須 | 説明 |
|---|---|---|---|
maintainers | Maintainer[] | いいえ | カタログエンティティが自身の所有者として列挙するメンテナーです。 |
license | string | いいえ | カタログエンティティが、記述するソフトウェアについて宣言する SPDX ライセンス識別子です。 |
repository | string | いいえ | カタログエンティティがソースファイルの格納先として示す Git リポジトリの URL です。 |
home | string | いいえ | カタログエンティティのホームページ、wiki、またはドキュメントの URL です。 |
keywords | string[] | いいえ | カタログエンティティが宣言する説明用のキーワードです。 |
追加のプロパティは許可されません。
IRNode
| プロパティ | 種類 | 必須 | 説明 |
|---|---|---|---|
description | string | いいえ | このコンポーネントインスタンスのアプリケーション内での役割を説明する、開発者が記述する任意のドキュメントです。レンダリングと lint 診断のために Aggregate から受け渡されます。 |
labels | string のマップ | はい | エンティティのダックタイピングおよびオントロジーのラベルです。 |
component | string | はい | 基になる Component の名前です。 |
resolved_version | string | はい | コンパイル時に解決された Component の正確なセマンティックバージョンです。 |
sync_wave | integer | いいえ | それを含む境界の syncWave フィールドから継承されるデプロイのウェーブです (既定値は 0。負の値も可)。K8s と Helm では、ウェーブがデプロイの順序を決めます。ウェーブは argocd.argoproj.io/sync-wave アノテーションになり、チャートがすでに Helm フックとしてマークしているリソースでは、そのフックの helm.sh/hook-weight にもなります。compose では、この値はサービスラベルとして記録されるとともに、レンダリング先のファイルのサービスを、それらの間の depends_on によって順序付けます。cloudformation では、ディスパッチグループが組み立てるスタックのプロビジョニングを順序付けます。各ウェーブのすべてのリソースは、直前のウェーブのリソースに依存すると宣言されます。これは作成される順序と、その逆の削除される順序であり、準備完了を表すものではありません。スタックテンプレートにはリソースの準備完了という概念がないためです。terraform では、境界が組み立てるルート設定のモジュールブロックを順序付けます。各ウェーブのすべてのモジュールは、直前のウェーブのモジュールに依存すると宣言されます。これはエンジンがアクションを実行する順序であり、準備完了を表すものではありません。設定にはリソースの準備完了という概念がないためです。この値はノードのビルドの来歴にも含まれます。 |
boundary_path | string | いいえ | このノードが配置される Release の境界のパスです。最も外側の境界から内側へ向かう境界名を / で連結したものです (例: 境界 data の中で宣言された境界 inner に配置されたコンポーネントでは ‘data/inner’)。境界名には / を含められないため、パスは曖昧さなく各境界に分割できます。Release が境界へルーティングする、インポートされた Aggregate のノードは、その境界のパスを持ちます。レンダリングプラグインが境界を考慮した一意の識別子を生成できるようにします。 |
subsystem_path | string | いいえ | このノードのコンポーネントが宣言されている 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_metadata | CatalogMetadata | いいえ | カタログエンティティから明示的に抽出されたエンタープライズメタデータスイートで、ライフサイクルと所有権のデータを Wasm リンターに公開します。 |
catalog_annotations | string のマップ | いいえ | ドメイン 2 でプラットフォームアーキテクトが記述する、不変で本質的なコンポーネントの特性です。 |
release_annotations | string のマップ | いいえ | Release 内の境界からカスケードされる、物理トポロジーの文字列と運用上の実情です。 |
aggregate_annotations | string のマップ | いいえ | Aggregate 内のサブシステムからカスケードされる、コグニティブメタデータ、開発者の意図、および FinOps です。 |
self_inject | object | いいえ | Aggregate から引き継がれる Component レベルのセルフインジェクトブロックで、ノードが自身のために宣言する、依存しないインジェクションルーティングです。このスキーマ層では不透明であり、これを読むポリシープラグインがバイト列を解析します。 |
source_file | string | いいえ | このノードが記述された Aggregate ファイルの、ワークスペースからの相対パスです。ルート階層のノードはルート Aggregate のパスを持ち、サブアグリゲートのノードはインポートされた Aggregate のファイルパスを持ちます。パスはワークスペースルート (.aggrega-config.yaml を含むディレクトリ) からの相対パスであるため、ワークスペースが異なる絶対パスにあるマシン間でもグラフはバイト単位で同一になります。ファイルごとに診断をフィルタリングするコンシューマーは、比較の前に同じワークスペースルートを基準にこのフィールドを解決します。ワークスペースルートなしでグラフがビルドされた場合は存在しません。 |
uses | object | いいえ | 記述されたとおりのノードの uses ブロックです。各ソケット名は、ターゲットインスタンス名のリスト、またはエイリアスをキーとする接続エントリのマップのいずれかに対応し、作成者が宣言した順序で並びます。これは記述されたとおりのブロックであり、edges 内の解決済みの接続とは異なる事実です。作成者が値を入れたソケットは、接続を生まなかった場合でもここに現れるため、読み手は作成者が埋めたソケットと、ターゲットに到達するソケットを区別できます。ノードが uses ブロックを記述していない場合は存在しません。このスキーマ層では不透明であり、これを読むポリシープラグインがバイト列を解析します。 |
sensitive_payload_leaves | string[] | いいえ | このノードの values および infra ペイロードが持つリーフのうち、その Component が機密と宣言するもので、それぞれデータが占める、ピラーを接頭辞とするドット区切りのパス values.db での宣言は db.password を覆い、dbPassword という名前の兄弟リーフには及びません。キーが存在しないことは、このノードがその Component が機密と宣言するリーフを示さないことを表し、ノードの Component がこのリーダーが読めるスキーマに解決されない場合も含みます。ノードのペイロードが機密でないことを示すものではなく、示すべきそのようなリーフを持たないノードと、この軸をまったく報告しないプロデューサーを区別するものでもありません。キーが存在しないことを、値を平文で表示または出力してよいという許可と解釈するコンシューマーは、意味を逆に読んでいます。リーフはペイロードが保持する順序で、values ピラーのものが infra ピラーのものより先に並びます。これはそれらのペイロード自体が持つ順序と同じであり、同一の入力に対する実行間でグラフをバイト単位で同一に保つものです。ノードがその Component が機密と宣言するリーフを持たない場合は存在しません。 |
追加のプロパティは許可されません。
IREdge
| プロパティ | 種類 | 必須 | 説明 |
|---|---|---|---|
source | string | はい | 接続の起点となる、消費側ノードの ID です。 |
target | string | はい | 接続の到達先ノードの ID です。 |
socket | string | いいえ | このエッジが属する usesSchema のカテゴリ(例: ‘databases’、‘tools’)。 |
alias | string | いいえ | この接続に対して開発者が定義したエイリアス(例: ‘primary_db’)。 |
socket_declaration | string (enum) | はい | ソケットの由来です。ソケットを所有するカタログエンティティ(消費側の Component、または Feature が記述したエッジでは起点の Feature)がそのソケットを usesSchema に列挙している場合は declared、カタログが宣言していないソケットを Aggregate の作成者が指定した場合は ad-hoc になります。これはエッジの作成者とは独立した第三の軸です。誰がエッジを引いたかではなくソケットの由来を表すため、宣言済みソケットへの Release 作成のエッジと、ad-hoc ソケットへの Aggregate 作成のエッジは、2 つの軸でそれぞれ独立に異なります。宣言済みソケットは usesSchema のエントリを持ち、そこにはエッジが到達できるターゲットを制約するセレクタも含まれます。ad-hoc ソケットにはカタログのエントリがなく、したがってセレクタもないため、エッジが運べるものはターゲットが宣言した provides だけで制限されます。常に存在するため、コンシューマが値の欠落を declared と解釈する必要はなく、ポリシーはすべてのエッジが declared であることを要求できます。アタッチメントのバインディングマーカーとは別物です。そちらは同じ形の問いに別の対象について答えます。許可される値: "declared"、"ad-hoc" |
origin_feature | string | いいえ | このエッジが Feature(feature.aggrega.ai/kind: secret のラベルが付いた認証情報の Features を含む)によって自律的に宣言された場合、その Feature の型 URI を示します。Wasm プラグインが自身のトポロジーを分離できるようにします。 |
origin_feature_instance | string | いいえ | このエッジを宣言した 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 由来です。 |
values | object | いいえ | このエッジについて解決された接続ごとの開発者の値(Aggregate のエッジに由来)です。解決時にソースソケット(消費側コンポーネント上のソケットで、エッジのソース)が宣言する valueSchema に対して検証され、消費側ノードのレンダリングコンテキストの .context.uses. |
infra | object | いいえ | このエッジについて解決された接続ごとの infra で、Release のエッジエントリによって供給されます。解決時にソースソケット(消費側コンポーネント上のソケットで、エッジのソース)が宣言する infraSchema に対して検証され、.context.uses. |
inject | object | いいえ | 内容に依存しないインジェクションのルーティングです。ローカル変数をターゲットの provides キーに対応付けます。 |
sensitive_payload_leaves | string[] | いいえ | このエッジの values と infra が保持するリーフのうち、それらが記述される対象のソケットが sensitive と宣言しているもので、それぞれデータが占めるピラー接頭辞付きのドット区切りパス(values.db での宣言は db.password をカバーし、db_password という名前の兄弟リーフには及びません。宣言された sensitive な値をグラフから伏せるサーフェスは、このエッジの values と infra にあるこれらのリーフを伏せ、同じ接続についての消費側ノードの uses エントリーでも伏せます。このエントリーは作成者が記述したとおりに値を保持しているためです。キーがないことは、このエッジがそのソケットの契約が sensitive と宣言するリーフを一つも示さないことを表し、ソケットがこの読み取り側が読める契約を宣言していない場合も含みます。設定がセンシティブでないことを主張するものではなく、キーがないことを値を平文で表示または出力してよいという許可と解釈するコンシューマーは、逆に読んでいます。リーフはペイロードが保持する順序で届き、values ピラーのものが infra ピラーのものより先になります。これが同一入力の実行間でグラフをバイト単位で同一に保つものです。エッジがそのソケットの契約が sensitive と宣言するリーフを保持しない場合は存在しません。 |
追加のプロパティは許可されません。
IREdge.inject
内容に依存しないインジェクションのルーティングです。ローカル変数をターゲットの provides キーに対応付けます。
| プロパティ | 種類 | 必須 | 説明 |
|---|---|---|---|
env | string のマップ | いいえ | 環境変数による配信です。キーはコンシューマーのローカル変数名、値はターゲットの provides キーです。 |
file | string のマップ | いいえ | ファイルマウントによる配信です。キーはコンシューマーのローカルファイルパス、値はターゲットの provides キーです。 |
arg | string のマップ | いいえ | コマンドライン引数による配信です。キーはコンシューマーのフラグプレフィックス、値はターゲットの provides キーです。 |
IRMetadata
グラフの識別情報: グラフの構築元となった Aggregate です。
| プロパティ | 種類 | 必須 | 説明 |
|---|---|---|---|
aggregate_name | string | はい | Aggregate の metadata.name です。 |
追加のプロパティは許可されません。
IRProvenance
診断と監査のためのトレーサビリティメタデータです。
| プロパティ | 種類 | 必須 | 説明 |
|---|---|---|---|
schema_version | string | はい | グラフが準拠する IR スキーマのバージョンです。aggrega.ai/v1beta1 で、グラフの apiVersion が持つ値と同じです。 |
compiler_version | string | はい | 必須のコンプライアンススタンプです。このグラフをビルドした aggrega バイナリを、そのバージョンによって識別します。 |
aggregate_version | string | はい | コンパイル時に使用されたルート Aggregate のインテントの正確なセマンティックバージョンです。 |
manifest_version | string | はい | コンパイル時に使用された Manifest ロックファイルの正確なセマンティックバージョンです。 |
release_version | string | はい | コンパイル時に使用された Release ルーティングファイルの正確なセマンティックバージョンです。 |
追加のプロパティは許可されます。
IRSpec
グラフ本体: そのノード、エッジ、およびノードをキーとするペイロードです。
| プロパティ | 種類 | 必須 | 説明 |
|---|---|---|---|
nodes | IRNode のマップ | はい | グラフ内のすべてのノードの辞書で、絶対 ID をキーとします。純粋にトポロジー的です。キー: 1 文字以上の英字、数字、アンダースコア、ドット、ハイフン。パターン: ^[a-zA-Z0-9_.-]+$。 |
edges | IREdge[] | はい | ノード間の明示的な論理ネットワークパスと依存関係です。 |
values_mapping | object | はい | 不透明なパススルーのコグニティブペイロードの唯一の情報源で、ノード ID でマッピングされます。 |
infra_mapping | object | はい | Release から注入される物理的なサイジングペイロードで、ノード ID でマッピングされます。 |
feature_values_mapping | IRFeatureEntry のマップのマップ | はい | ノード ID から、そのノードにアタッチされた Feature 設定への正規化されたマップです。1 つのバケットが、何を生成するかにかかわらずノード上のすべてのアタッチメント(運用の Features、認証情報の Features、アイデンティティの Features)を保持し、作成者が各アタッチメントに付けたインスタンス名をキーとします。ノードの接続の 1 つに記述されたアタッチメントは、接続のエイリアスとスロットをドットで結合した修飾名をキーとし、自身の connection フィールドでその接続を指定します。キー: 1 文字以上の英字、数字、アンダースコア、ドット、ハイフン。パターン: ^[a-zA-Z0-9_.-]+$。 |
boundary_features | IRBoundaryFeature のマップのマップ | いいえ | 各境界の Feature アタッチメントで、境界パス、次にインスタンス名をキーとします。グラフに境界レベルの Feature アタッチメントがある場合にのみ存在します。キー: 1 文字以上の英字、数字、アンダースコア、ドット、スラッシュ、ハイフン。パターン: ^[a-zA-Z0-9_./-]+$。 |
provenance | IRProvenance | はい | 診断と監査のためのトレーサビリティメタデータです。 |
追加のプロパティは許可されません。
IRGraph
| プロパティ | 種類 | 必須 | 説明 |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | はい | 定数: "aggrega.ai/v1beta1" |
kind | const “IR” | はい | 定数: "IR" |
metadata | IRMetadata | はい | グラフの識別情報: グラフの構築元となった Aggregate です。 |
spec | IRSpec | はい | グラフ本体: そのノード、エッジ、およびノードをキーとするペイロードです。 |
追加のプロパティは許可されません。