Skema Aggrega Capability-Agnostic Graph (IR)
Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.
ID skema: https://aggrega.ai/schemas/ir-v1beta1.schema.json
Graf 1 dimensi yang telah diratakan dan sepenuhnya di-resolve, yang dihasilkan oleh Topology Builder.
Jenis tingkat teratas: object
Properti
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | ya | Konstanta: "aggrega.ai/v1beta1" |
kind | const “IR” | ya | Konstanta: "IR" |
metadata | IRMetadata | ya | Identitas graf: Aggregate yang menjadi dasar pembangunannya. |
spec | IRSpec | ya | Graf itu sendiri: node, edge, dan payload yang dikunci per node. |
Properti tambahan tidak diizinkan.
Definisi
Maintainer
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
name | string | ya | Nama pemelihara. |
email | string | tidak | Alamat email pemelihara. |
url | string | tidak | Alamat web pemelihara. |
FieldProvenance
Asal satu leaf dalam payload values atau infra sebuah lampiran.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
origin | string | ya | Apakah leaf ditulis secara eksplisit atau disumbangkan oleh tahap ekspansi berbasis anotasi. |
side | string | tidak | Permukaan penulisan tempat anotasi dideklarasikan; tidak ada untuk leaf eksplisit. |
annotation_key | string | tidak | Nama anotasi yang menyumbangkan leaf ini; tidak ada untuk leaf eksplisit. |
annotation_source | string | tidak | Lokasi sumber deklarasi anotasi sebagai |
overridden_annotation | FieldProvenance | tidak | Kontribusi anotasi yang kalah oleh leaf eksplisit pada leaf ini: ketika sebuah leaf eksplisit menimpa leaf yang disumbangkan anotasi, provenance tertekan yang digantikannya. Tunggal — tepat satu kontribusi tertekan yang pernah disimpan. |
Properti tambahan tidak diizinkan.
AttachmentConnection
Koneksi tempat sebuah lampiran berada, untuk lampiran yang ditulis pada koneksi yang ditarik sebuah komponen alih-alih pada blok lampiran milik komponen itu sendiri: socket tempat koneksi disambungkan dan alias tempat koneksi ditulis. Pasangan ini menamai salah satu edge graf — edge yang sumbernya adalah node yang membawa lampiran dan yang socket serta aliasnya adalah keduanya — sehingga konsumen menggabungkan lampiran ke edge tersebut, dan melaluinya ke target tempat lampiran disajikan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
socket | string | ya | Socket tempat koneksi disambungkan: socket dari edge tempat lampiran berada. |
alias | string | ya | Alias tempat koneksi ditulis: alias dari edge tempat lampiran berada. |
Properti tambahan tidak diizinkan.
IRFeatureEntry
Satu lampiran yang telah di-resolve untuk sebuah node, dibawa dalam feature_values_mapping. Setiap keluarga lampiran berbagi bentuk ini — Feature operasional, Feature kredensial, Feature identitas — sehingga tidak ada keluarga yang mendapatkan proyeksi yang lebih banyak kehilangan informasi daripada yang lain. Apa yang dibawa values dari lampiran kredensial adalah pilihan penulis: kredensial berdasarkan referensi membawa penunjuk ke penyimpanan rahasia, kredensial berdasarkan nilai membawa materinya sendiri, dan kompiler membawa mana pun yang ditulis apa adanya tanpa me-resolve keduanya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
type | string | ya | URI dari Feature Katalog yang diminta lampiran ini. |
resolved_version | string | ya | Versi semantik persis yang di-resolve selama kompilasi. |
labels | map of string | tidak | Label katalog dari Feature yang dilampirkan, dibawa apa adanya dalam urutan yang dideklarasikan entitas katalognya — tidak pernah difilter, dinormalisasi, atau dihapus prefiksnya, sehingga konsumen membaca persis apa yang ditulis penulis katalog. Kompiler tidak membaca satu pun darinya. Tidak ada ketika Feature tidak mendeklarasikan label, dan ketika jenisnya tidak me-resolve ke entitas katalog mana pun. |
catalog_annotations | map of string | tidak | Anotasi katalog dari Feature yang dilampirkan — metadata.annotations dari entitas Feature yang dinamai lampiran ini — dibawa apa adanya dalam urutan yang dideklarasikan entitas tersebut, tidak pernah difilter, dinormalisasi, atau dihapus prefiksnya, sehingga konsumen membaca persis apa yang ditulis penulis katalog, termasuk kunci dalam namespace milik penulis sendiri. Kompiler tidak membaca satu pun darinya. Berbeda dari annotation_key dan annotation_source, yang menamai dan menunjukkan lokasi anotasi yang menyebabkan lampiran ini ada: keduanya melaporkan bagaimana lampiran terbentuk, sedangkan yang ini melaporkan metadata entitas yang dinamainya, dan lampiran yang ditulis dalam blok features: membawa anotasi ini tanpa membawa kedua field tersebut. Tidak ada ketika Feature tidak mendeklarasikan anotasi, dan ketika jenisnya tidak me-resolve ke entitas katalog mana pun. |
binding | string | tidak | Menamai slot lampiran yang diisi lampiran ini, atau “free” ketika lampiran tidak mengisi slot yang dideklarasikan. Slot dideklarasikan di salah satu dari dua tempat, dan tempat lampiran ditulis menentukan yang mana: lampiran dari blok lampiran milik node mengisi slot yang dideklarasikan Component host dalam featuresSchema-nya, dan lampiran yang ditulis pada koneksi mengisi slot yang dideklarasikan socket koneksi dalam featuresSchema socket tersebut pada Component host. Pemasangan dilakukan berdasarkan nama pada keduanya — lampiran mengisi slot ketika Feature dilampirkan di bawah nama slot, pada blok komponen atau pada koneksi — sehingga nilainya adalah kunci persis dari himpunan slot yang dideklarasikan, tidak pernah sesuatu yang dibaca dari kunci lampiran. Himpunan slot sebuah socket bersifat tertutup, karena lampiran yang ditulis pada koneksi di bawah nama yang tidak dideklarasikan socket-nya menghentikan build, sehingga lampiran yang membawa koneksi tidak pernah melaporkan free. Nama slot dibawa alih-alih boolean semata karena slot mana yang diisi adalah separuh jawaban yang lebih berguna. Kosong ketika himpunan slot yang dideklarasikan Component host tidak dapat di-resolve, yang berbeda dari “free”: free adalah temuan positif bahwa tidak ada slot yang dideklarasikan yang membawa nama ini. |
values | object | tidak | Payload konfigurasi operasional untuk lampiran. Untuk kredensial, bentuk mana pun yang dideklarasikan penulis — penunjuk ke penyimpanan rahasia, atau materinya sendiri. |
infra | object | tidak | Ukuran fisik per instans untuk lampiran ini. |
inject | object | tidak | Perutean injeksi yang agnostik. Memetakan variabel lokal ke kunci provides Target. |
origin | string (enum) | tidak | Membedakan lampiran yang ditulis dalam blok features: (explicit) dari lampiran sintetis yang dihasilkan oleh tahap ekspansi berbasis anotasi (annotation), atau mixed ketika leaf value/infra lampiran membawa campuran keduanya (detail per leaf kemudian berada di peta provenance). Nilai yang diizinkan: "explicit", "annotation", "mixed" |
annotation_key | string | tidak | Nama anotasi yang memicu lampiran sintetis. Tidak ada ketika origin adalah explicit. |
annotation_source | string | tidak | Lokasi sumber deklarasi anotasi sebagai |
values_provenance | map dari FieldProvenance | tidak | Asal per leaf untuk payload values, dengan kunci berupa path leaf bertitik. |
infra_provenance | map dari FieldProvenance | tidak | Asal per leaf untuk payload infra, dengan kunci berupa path leaf bertitik. |
sensitive | boolean | tidak | True ketika lampiran ini menangani materi yang dideklarasikan sensitif oleh penulis — baik Feature yang dilampirkan mendeklarasikan leaf sensitif dalam pilar values, infra, atau provides-nya, maupun slot yang diisi lampiran mendeklarasikan materi yang dibawanya sebagai sensitif: slot lampiran Component host dengan nama yang sama, atau, untuk lampiran yang ditulis pada koneksi, slot dengan nama tersebut yang dideklarasikan socket koneksi. Diturunkan dari deklarasi tersebut atas lampiran yang telah digabungkan, tidak pernah dari konten suatu nilai atau sebuah nama. Tidak diatur ketika tidak ada deklarasi yang hadir. |
sensitive_inject | map dari map dari string | tidak | Kunci pengiriman dari inject yang kunci provides rujukannya dideklarasikan sensitif oleh Feature yang dilampirkan, dalam bentuk inject itu sendiri: mekanisme, lalu kunci pengiriman, dengan kunci provides yang dirujuk sebagai nilainya. Subset dari inject. Tidak ada ketika lampiran tidak mendeklarasikan mekanisme pengiriman atau tidak merujuk kunci provides yang sensitif. |
sensitive_payload_leaves | string[] | tidak | Daun-daun yang dibawa oleh payload values dan infra lampiran ini yang dinyatakan sensitif oleh Feature yang dilampirkan, masing-masing sebagai path bertitik berawalan pilar yang ditempati datum tersebut: values.db mencakup db.password dan tidak menjangkau daun saudara bernama dbPassword. Jawaban per lampiran tidak pernah disebarkan ke daun individual, karena hal itu akan menyatakan sesuatu yang salah tentang daun yang dibiarkan dapat dibaca. Kunci yang tidak ada menyatakan bahwa lampiran ini tidak menyebut daun yang dinyatakan sensitif oleh Feature-nya. Hal ini tidak menyatakan bahwa payload tidak sensitif, dan tidak membedakan lampiran yang tidak memiliki daun semacam itu untuk disebut dari produsen yang sama sekali tidak melaporkan sumbu ini — guest yang membaca kunci yang tidak ada sebagai izin untuk menampilkan atau mengeluarkan nilai secara terbuka telah membacanya terbalik. Daun-daun datang dalam urutan payload menyimpannya, daun pilar values sebelum daun pilar infra — urutan yang sama dengan yang dibawa oleh payload values dan infra itu sendiri, dan yang membuat payload identik byte demi byte di setiap eksekusi dengan input yang identik. Tidak ada jika lampiran tidak membawa daun yang dinyatakan sensitif oleh Feature-nya. |
connection | AttachmentConnection | tidak | Koneksi tempat lampiran ini berada: ada pada setiap lampiran yang ditulis pada salah satu koneksi node, dan tidak ada pada setiap lampiran dari blok lampiran milik node itu sendiri. Lampiran yang ditulis pada koneksi adalah salah satu lampiran node dalam segala hal lainnya — dikunci dengan nama berkualifikasinya, yaitu alias koneksi dan slot yang digabungkan dengan titik, serta mengambil binding dan sensitivitasnya dari slot yang dideklarasikan oleh socket koneksi — sehingga field inilah yang membedakan keduanya, dan field ini membawa koneksi sebagai data alih-alih membiarkannya dibaca dari kunci. Konsumen menggabungkannya dengan edge graph berdasarkan socket dan alias: edge yang sumbernya adalah node yang membawa lampiran ini dan yang socket serta aliasnya adalah nilai-nilai ini merupakan koneksi tempat lampiran disajikan, dan target edge tersebut adalah pihak yang menerima sajian itu. Lampiran dari koneksi yang ditarik oleh lampiran Feature tidak pernah membawanya, karena koneksi semacam itu tidak membawa lampiran. |
realization | string | tidak | FeatureRecipe yang merealisasikan lampiran ini, sebagai |
Properti tambahan tidak diizinkan.
IRFeatureEntry.inject
Perutean injeksi yang agnostik. Memetakan variabel lokal ke kunci provides Target.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
env | map of string | tidak | Pengiriman melalui variabel lingkungan: kunci adalah nama variabel lokal konsumen, nilai adalah kunci provides milik target. |
file | map of string | tidak | Pengiriman melalui mount file: kunci adalah path file lokal konsumen, nilai adalah kunci provides milik target. |
arg | map of string | tidak | Pengiriman melalui argumen baris perintah: kunci adalah prefiks flag konsumen, nilai adalah kunci provides milik target. |
IRBoundaryFeature
Lampiran Feature tingkat boundary yang diproyeksikan ke dalam IR: URI jenis Feature ditambah infra boundary yang digunakan oleh FeatureRecipe lingkup boundary untuk me-render dan me-resolve sumbernya. Lampiran tingkat boundary tidak membawa payload values.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
type | string | ya | URI dari Feature Katalog yang dilampirkan pada boundary ini. |
infra | object | tidak | Ukuran fisik untuk lampiran boundary; infra yang digunakan oleh FeatureRecipe lingkup boundary untuk mengevaluasi template dan sumbernya. |
sensitive_payload_leaves | string[] | tidak | Daun-daun yang dibawa oleh payload infra lampiran boundary ini yang dinyatakan sensitif oleh Feature yang dilampirkan, masing-masing sebagai path bertitik berawalan pilar yang ditempati datum tersebut. Hanya koordinat infra.db mencakup db.password dan tidak menjangkau daun saudara bernama dbPassword. Kunci yang tidak ada menyatakan bahwa lampiran ini tidak menyebut daun yang dinyatakan sensitif oleh Feature-nya, termasuk kasus ketika Feature yang dilampirkan tidak me-resolve ke skema yang dapat dibaca oleh pembaca ini. Hal ini tidak menyatakan bahwa payload infra tidak sensitif, dan tidak membedakan lampiran yang tidak memiliki daun semacam itu untuk disebut dari produsen yang sama sekali tidak melaporkan sumbu ini. Konsumen yang membaca kunci yang tidak ada sebagai izin untuk menampilkan atau mengeluarkan nilai secara terbuka telah membacanya terbalik. Daun-daun datang dalam urutan payload menyimpannya, yaitu urutan yang sama dengan yang dibawa payload infra itu sendiri dan yang menjaga graph tetap identik byte demi byte di setiap eksekusi dengan input yang identik. Tidak ada jika lampiran tidak membawa daun yang dinyatakan sensitif oleh Feature-nya. |
realization | string | tidak | FeatureRecipe yang merealisasikan lampiran boundary ini, sebagai |
Properti tambahan tidak diizinkan.
CatalogMetadata
Enterprise Metadata Suite yang diekstrak secara eksplisit dari entitas Katalog, yang mengekspos data siklus hidup dan kepemilikan ke linter Wasm.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
maintainers | Maintainer[] | tidak | Para pemelihara yang dicantumkan entitas Catalog sebagai pemiliknya. |
license | string | tidak | Pengidentifikasi lisensi SPDX yang dideklarasikan entitas Catalog untuk perangkat lunak yang dideskripsikannya. |
repository | string | tidak | URL repositori Git yang disebut entitas Catalog sebagai tempat file sumbernya. |
home | string | tidak | URL halaman beranda, wiki, atau dokumentasi entitas Catalog. |
keywords | string[] | tidak | Kata kunci deskriptif yang dideklarasikan entitas Catalog. |
Properti tambahan tidak diizinkan.
IRNode
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
description | string | tidak | Dokumentasi opsional yang ditulis pengembang yang menjelaskan peran instans komponen ini dalam aplikasi. Diteruskan dari Aggregate untuk rendering dan untuk diagnostik lint. |
labels | map of string | ya | Label duck-typing dan ontologi entitas. |
component | string | ya | Nama Component yang mendasarinya. |
resolved_version | string | ya | Semantic Version yang tepat dari Component yang di-resolve selama kompilasi. |
sync_wave | integer | tidak | Gelombang deployment yang diwarisi dari field syncWave milik boundary yang memuatnya (default 0; nilai negatif diizinkan). Pada K8s dan Helm, gelombang inilah yang mengurutkan deployment: gelombang tersebut menjadi anotasi argocd.argoproj.io/sync-wave, dan pada resource yang sudah ditandai chart sebagai hook Helm, gelombang tersebut juga menjadi helm.sh/hook-weight milik hook itu. Pada compose, nilai ini dicatat sebagai label layanan sekaligus mengurutkan layanan-layanan dalam file tempat nilai tersebut di-render, melalui depends_on di antara layanan tersebut. Pada cloudformation, nilai ini mengurutkan provisioning stack tempat suatu grup dispatch dirakit, dengan setiap resource dalam satu gelombang dideklarasikan bergantung pada resource dari gelombang sebelumnya: urutan pembuatannya dan, secara terbalik, urutan penghapusannya, tidak pernah kesiapan, karena templat stack tidak mengungkapkan konsep resource yang siap. Pada terraform, nilai ini mengurutkan blok modul dari konfigurasi root tempat suatu boundary dirakit, dengan setiap modul dalam satu gelombang dideklarasikan bergantung pada modul dari gelombang sebelumnya: urutan engine menjalankan tindakannya, tidak pernah kesiapan, karena konfigurasi tidak mengungkapkan konsep resource yang siap. Nilai ini juga menyertai provenance build node. |
boundary_path | string | tidak | Path boundary Release tempat node ini ditempatkan: nama-nama boundary dari boundary terluar ke dalam, digabungkan dengan / (misalnya, ‘data/inner’ untuk komponen yang ditempatkan dalam boundary inner yang dideklarasikan di dalam boundary data). Nama boundary tidak dapat memuat /, sehingga path dapat dipecah kembali menjadi boundary-boundary-nya tanpa ambiguitas. Node dari Aggregate yang diimpor dan dirutekan Release ke suatu boundary membawa path boundary tersebut. Memungkinkan plugin rendering menghasilkan identifier unik yang sadar boundary. |
subsystem_path | string | tidak | Path subsistem Aggregate tempat komponen node ini dideklarasikan: nama-nama subsistem dari subsistem terluar ke dalam, digabungkan dengan . (misalnya, ‘backend.storage’ untuk komponen yang dideklarasikan dalam subsistem storage yang bersarang di dalam subsistem backend). Nama subsistem tidak dapat memuat ., sehingga path dapat dipecah kembali menjadi subsistem-subsistemnya tanpa ambiguitas. Komponen dari Aggregate yang mendeklarasikan components tingkat atas membawa default yang disintesis, ditandai oleh synthesized_subsystem. Path ini relatif terhadap Aggregate yang mendeklarasikan komponen tersebut: node yang disumbangkan oleh Aggregate yang diimpor membawa path-nya di dalam Aggregate tersebut, tanpa nama yang digunakan untuk mengimpornya (misalnya, ‘tier’ untuk komponen dalam subsistem tier milik Aggregate yang diimpor), sehingga node dari Aggregates yang berbeda dapat berbagi satu path. ID node, yang diawali dengan nama impor, dan source_file membedakannya. |
synthesized_subsystem | boolean | tidak | True ketika subsistem node ini disintesis oleh compiler — subsistem default yang dibuat untuk Aggregate yang mendeklarasikan components tingkat atas alih-alih subsystems bernama. Provenance turunan, tidak pernah ditulis: field ini membedakan default yang disintesis dari subsistem yang secara eksplisit dinamai default oleh pengguna. Independen dari synthesized_boundary (sebuah node dapat disintesis pada salah satu sumbu atau keduanya). Tidak ada (false) untuk setiap subsistem yang ditulis. |
synthesized_boundary | boolean | tidak | True ketika boundary node ini disintesis oleh compiler — boundary default yang dibuat untuk Release yang mendeklarasikan components tingkat atas alih-alih boundaries bernama. Provenance turunan, tidak pernah ditulis: field ini membedakan default yang disintesis dari boundary yang secara eksplisit dinamai default oleh pengguna, dan merutekan artefak node ke dist/ secara datar alih-alih ke dist/boundaries/default/. Tidak ada (false) untuk setiap boundary yang ditulis. |
catalog_metadata | CatalogMetadata | tidak | Enterprise Metadata Suite yang diekstrak secara eksplisit dari entitas Katalog, yang mengekspos data siklus hidup dan kepemilikan ke linter Wasm. |
catalog_annotations | map of string | tidak | Karakteristik komponen yang immutable dan intrinsik, ditulis oleh Platform Architect di Domain 2. |
release_annotations | map of string | tidak | String topologi fisik dan realitas Ops yang mengalir dari boundary dalam Release. |
aggregate_annotations | map of string | tidak | Metadata kognitif, maksud developer, dan FinOps yang mengalir dari subsistem dalam Aggregate. |
self_inject | object | tidak | Blok self-inject tingkat Component yang dibawa dari Aggregate; perutean injeksi agnostik yang dideklarasikan node untuk dirinya sendiri. Bersifat opak pada lapisan skema ini; plugin kebijakan yang membacanya mengurai byte-nya. |
source_file | string | tidak | Path relatif terhadap workspace dari file Aggregate tempat node ini ditulis. Node tingkat root membawa path Aggregate root; node sub-aggregate membawa path file Aggregate yang diimpor. Path ini relatif terhadap root workspace (direktori yang memuat .aggrega-config.yaml), sehingga graf identik byte demi byte di mesin yang workspace-nya berada di path absolut berbeda. Konsumen yang memfilter diagnostik per file me-resolve field ini terhadap root workspace yang sama sebelum perbandingan. Tidak ada ketika graf dibangun tanpa root workspace. |
uses | object | tidak | Blok uses node persis seperti yang ditulis: setiap nama socket dipetakan ke daftar nama instance target atau ke map entri koneksi yang dikunci dengan alias, dalam urutan yang dideklarasikan penulis. Ini adalah blok sebagaimana ditulis, yang merupakan fakta berbeda dari koneksi yang telah di-resolve dalam edges: socket yang diisi penulis muncul di sini meskipun tidak menghasilkan koneksi, sehingga pembaca dapat membedakan socket yang diisi penulis dari socket yang mencapai target. Tidak ada ketika node tidak menulis blok uses. Opaque pada lapisan skema ini; plugin kebijakan yang membacanya mem-parsing byte-nya. |
sensitive_payload_leaves | string[] | tidak | Leaf yang dibawa payload values dan infra node ini yang dideklarasikan sensitif oleh Component-nya, masing-masing sebagai dotted path berawalan pilar yang ditempati datum tersebut: values.db mencakup db.password dan tidak menjangkau leaf saudara bernama dbPassword. Key yang tidak ada menyatakan bahwa node ini tidak menamai leaf yang dideklarasikan sensitif oleh Component-nya, termasuk kasus ketika Component node tersebut di-resolve ke skema yang tidak dapat dibaca pembaca ini. Hal ini tidak menyatakan bahwa payload node tidak sensitif, dan tidak membedakan node yang tidak memiliki leaf semacam itu untuk dinamai dari produsen yang sama sekali tidak melaporkan sumbu ini. Konsumen yang membaca key yang tidak ada sebagai izin untuk menampilkan atau mengeluarkan nilai secara terbuka telah membacanya secara terbalik. Leaf tiba dalam urutan yang dimiliki payload, leaf pilar values sebelum leaf pilar infra, yaitu urutan yang sama yang dibawa payload itu sendiri dan yang menjaga graph tetap identik byte demi byte di setiap eksekusi dengan input identik. Tidak ada ketika node tidak membawa leaf yang dideklarasikan sensitif oleh Component-nya. |
Properti tambahan tidak diizinkan.
IREdge
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
source | string | ya | ID node yang mengonsumsi, tempat koneksi dimulai. |
target | string | ya | ID node yang dicapai oleh koneksi. |
socket | string | tidak | Kategori usesSchema tempat edge ini berada (mis., ‘databases’, ‘tools’). |
alias | string | tidak | Alias yang ditentukan pengembang untuk koneksi ini (mis., ‘primary_db’). |
socket_declaration | string (enum) | ya | Asal socket: declared ketika entitas katalog yang memiliki socket mencantumkannya dalam usesSchema (Component yang mengonsumsi, atau Feature asal untuk edge yang ditulis oleh Feature), ad-hoc ketika penulis Aggregate menamai socket yang tidak dideklarasikan katalog. Ini adalah sumbu ketiga, independen dari kepenulisan edge: sumbu ini menyatakan asal socket, bukan siapa yang menggambar edge, sehingga edge yang ditulis Release ke socket yang dideklarasikan dan edge yang ditulis Aggregate ke socket ad-hoc berbeda pada kedua sumbu secara independen. Socket yang dideklarasikan membawa entri usesSchema-nya, termasuk selector yang membatasi target mana yang dapat dicapai edge; socket ad-hoc tidak memiliki entri katalog sehingga tidak memiliki selector, maka apa yang dapat dibawa edge hanya dibatasi oleh provides yang dideklarasikan target. Selalu ada, sehingga konsumen tidak pernah perlu membaca nilai yang tidak ada sebagai declared, dan sebuah kebijakan dapat mewajibkan setiap edge dideklarasikan. Berbeda dari penanda binding pada attachment, yang menjawab bentuk pertanyaan yang sama tentang subjek yang berbeda. Nilai yang diizinkan: "declared", "ad-hoc" |
origin_feature | string | tidak | Jika edge ini dideklarasikan secara otonom oleh sebuah Feature (termasuk Features kredensial berlabel feature.aggrega.ai/kind: secret), ini mengidentifikasi URI jenis Feature tersebut. Memungkinkan Plugins Wasm mengisolasi topologinya sendiri. |
origin_feature_instance | string | tidak | Nama instans per-attachment dari Feature yang mendeklarasikan edge ini. Menemukan provides yang telah di-resolve dari FeatureRecipe dengan cakupan boundary berdasarkan instans, sehingga membedakan dua attachment dari jenis Feature yang sama pada satu boundary. |
origin_release | boolean | tidak | True ketika edge ini dibuat oleh sebuah Release yang menghubungkan socket yang dideklarasikan tetapi belum terikat ke komponen yang sudah ada. Menandai KEPENULISAN edge, bukan konfigurasi: edge yang dideklarasikan pengembang dan hanya diberi infra oleh Release tetap berasal dari Aggregate (origin_release tidak diatur; infra Release-nya muncul dalam map infra edge tersebut). origin_feature diatur => berasal dari Feature; origin_release true => berasal dari Release; tidak keduanya => berasal dari Aggregate. |
values | object | tidak | Nilai pengembang per-koneksi yang telah di-resolve untuk edge ini (dari edge Aggregate), divalidasi saat resolusi terhadap valueSchema yang dideklarasikan oleh socket sumber (socket pada komponen yang mengonsumsi, yang merupakan sumber edge) dan diproyeksikan ke konteks render node yang mengonsumsi di .context.uses. |
infra | object | tidak | Infra per-koneksi yang telah di-resolve untuk edge ini, disediakan oleh entri edge Release, divalidasi saat resolusi terhadap infraSchema yang dideklarasikan oleh socket sumber (socket pada komponen yang mengonsumsi, yang merupakan sumber edge) dan diproyeksikan di .context.uses. |
inject | object | tidak | Perutean injeksi yang agnostik. Memetakan variabel lokal ke kunci provides Target. |
sensitive_payload_leaves | string[] | tidak | Daun-daun yang dibawa oleh values dan infra edge ini yang dinyatakan sensitif oleh soket yang menjadi acuan penulisannya, masing-masing sebagai path bertitik berawalan pilar yang ditempati datum tersebut: values.db mencakup db.password dan tidak menjangkau daun saudara bernama db_password. Permukaan yang menahan nilai yang dinyatakan sensitif dari graf menahan daun-daun ini dalam values dan infra edge ini, serta dalam entri uses milik node yang mengonsumsi untuk koneksi yang sama, yang membawa nilai-nilai tersebut sebagaimana ditulis oleh penulis. Kunci yang tidak ada menyatakan bahwa edge ini tidak menyebut daun yang dinyatakan sensitif oleh kontrak soketnya, termasuk kasus ketika soket tidak mendeklarasikan kontrak yang dapat dibaca di sini. Hal ini tidak menyatakan bahwa konfigurasi tersebut tidak sensitif, dan konsumen yang membaca kunci yang tidak ada sebagai izin untuk menampilkan atau mengeluarkan nilai secara terbuka telah membacanya terbalik. Daun-daun datang dalam urutan payload menyimpannya, daun pilar values sebelum daun pilar infra, dan hal inilah yang menjaga graf tetap identik byte demi byte di setiap eksekusi dengan input yang identik. Tidak ada jika edge tidak membawa daun yang dinyatakan sensitif oleh kontrak soketnya. |
Properti tambahan tidak diizinkan.
IREdge.inject
Perutean injeksi yang agnostik. Memetakan variabel lokal ke kunci provides Target.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
env | map of string | tidak | Pengiriman melalui variabel lingkungan: kunci adalah nama variabel lokal konsumen, nilai adalah kunci provides milik target. |
file | map of string | tidak | Pengiriman melalui mount file: kunci adalah path file lokal konsumen, nilai adalah kunci provides milik target. |
arg | map of string | tidak | Pengiriman melalui argumen baris perintah: kunci adalah prefiks flag konsumen, nilai adalah kunci provides milik target. |
IRMetadata
Identitas graf: Aggregate yang menjadi dasar pembangunannya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
aggregate_name | string | ya | metadata.name milik Aggregate. |
Properti tambahan tidak diizinkan.
IRProvenance
Metadata keterlacakan untuk diagnostik dan audit.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
schema_version | string | ya | Versi skema IR yang dipatuhi graf — aggrega.ai/v1beta1, nilai yang sama dengan yang dibawa apiVersion graf. |
compiler_version | string | ya | Stempel kepatuhan wajib. Mengidentifikasi, melalui versinya, biner aggrega yang membangun graf ini. |
aggregate_version | string | ya | Versi semantik yang tepat dari intent Aggregate root yang digunakan selama kompilasi. |
manifest_version | string | ya | Versi semantik yang tepat dari lockfile Manifest yang digunakan selama kompilasi. |
release_version | string | ya | Versi semantik yang tepat dari file routing Release yang digunakan selama kompilasi. |
Properti tambahan diizinkan.
IRSpec
Graf itu sendiri: node, edge, dan payload yang dikunci per node.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
nodes | map of IRNode | ya | Kamus semua node dalam graf, dengan kunci berupa ID absolutnya. Murni topologis. Kunci: satu atau lebih huruf, angka, garis bawah, titik, atau tanda hubung. Pola: ^[a-zA-Z0-9_.-]+$. |
edges | IREdge[] | ya | Jalur jaringan logis dan dependensi eksplisit antar-node. |
values_mapping | object | ya | Satu-satunya sumber kebenaran untuk payload kognitif pass-through yang opak, dipetakan berdasarkan ID node. |
infra_mapping | object | ya | Payload ukuran fisik yang diinjeksikan dari Release, dipetakan berdasarkan ID node. |
feature_values_mapping | map of map of IRFeatureEntry | ya | Map ternormalisasi dari ID Node ke konfigurasi Feature yang dilampirkan padanya. Satu bucket membawa setiap attachment pada sebuah node apa pun yang dihasilkannya — Features operasional, Features kredensial, Features identitas — dengan kunci berupa nama instans yang diberikan penulis untuk setiap attachment. Attachment yang ditulis pada salah satu koneksi node memiliki kunci berupa nama terkualifikasinya, yaitu alias koneksi dan slot yang digabung dengan titik, dan menamai koneksinya dalam field connection miliknya sendiri. Kunci: satu atau lebih huruf, angka, garis bawah, titik, atau tanda hubung. Pola: ^[a-zA-Z0-9_.-]+$. |
boundary_features | map of map of IRBoundaryFeature | tidak | Attachment Feature setiap boundary, dengan kunci berupa path boundary lalu nama instans. Hanya ada ketika graf memiliki attachment Feature tingkat boundary. Kunci: satu atau lebih huruf, angka, garis bawah, titik, garis miring, atau tanda hubung. Pola: ^[a-zA-Z0-9_./-]+$. |
provenance | IRProvenance | ya | Metadata keterlacakan untuk diagnostik dan audit. |
Properti tambahan tidak diizinkan.
IRGraph
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | ya | Konstanta: "aggrega.ai/v1beta1" |
kind | const “IR” | ya | Konstanta: "IR" |
metadata | IRMetadata | ya | Identitas graf: Aggregate yang menjadi dasar pembangunannya. |
spec | IRSpec | ya | Graf itu sendiri: node, edge, dan payload yang dikunci per node. |
Properti tambahan tidak diizinkan.