Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

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

PropertiJenisWajibDeskripsi
apiVersionconst “aggrega.ai/v1beta1”yaKonstanta: "aggrega.ai/v1beta1"
kindconst “IR”yaKonstanta: "IR"
metadataIRMetadatayaIdentitas graf: Aggregate yang menjadi dasar pembangunannya.
specIRSpecyaGraf itu sendiri: node, edge, dan payload yang dikunci per node.

Properti tambahan tidak diizinkan.

Definisi

Maintainer

PropertiJenisWajibDeskripsi
namestringyaNama pemelihara.
emailstringtidakAlamat email pemelihara.
urlstringtidakAlamat web pemelihara.

FieldProvenance

Asal satu leaf dalam payload values atau infra sebuah lampiran.

PropertiJenisWajibDeskripsi
originstringyaApakah leaf ditulis secara eksplisit atau disumbangkan oleh tahap ekspansi berbasis anotasi.
sidestringtidakPermukaan penulisan tempat anotasi dideklarasikan; tidak ada untuk leaf eksplisit.
annotation_keystringtidakNama anotasi yang menyumbangkan leaf ini; tidak ada untuk leaf eksplisit.
annotation_sourcestringtidakLokasi sumber deklarasi anotasi sebagai :; tidak ada untuk leaf eksplisit.
overridden_annotationFieldProvenancetidakKontribusi 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.

PropertiJenisWajibDeskripsi
socketstringyaSocket tempat koneksi disambungkan: socket dari edge tempat lampiran berada.
aliasstringyaAlias 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.

PropertiJenisWajibDeskripsi
typestringyaURI dari Feature Katalog yang diminta lampiran ini.
resolved_versionstringyaVersi semantik persis yang di-resolve selama kompilasi.
labelsmap of stringtidakLabel 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_annotationsmap of stringtidakAnotasi 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.
bindingstringtidakMenamai 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.
valuesobjecttidakPayload konfigurasi operasional untuk lampiran. Untuk kredensial, bentuk mana pun yang dideklarasikan penulis — penunjuk ke penyimpanan rahasia, atau materinya sendiri.
infraobjecttidakUkuran fisik per instans untuk lampiran ini.
injectobjecttidakPerutean injeksi yang agnostik. Memetakan variabel lokal ke kunci provides Target.
originstring (enum)tidakMembedakan 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_keystringtidakNama anotasi yang memicu lampiran sintetis. Tidak ada ketika origin adalah explicit.
annotation_sourcestringtidakLokasi sumber deklarasi anotasi sebagai :. Tidak ada ketika origin adalah explicit.
values_provenancemap dari FieldProvenancetidakAsal per leaf untuk payload values, dengan kunci berupa path leaf bertitik.
infra_provenancemap dari FieldProvenancetidakAsal per leaf untuk payload infra, dengan kunci berupa path leaf bertitik.
sensitivebooleantidakTrue 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_injectmap dari map dari stringtidakKunci 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_leavesstring[]tidakDaun-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. atau infra.. Payload yang dibaca di sini adalah payload yang pada akhirnya dibawa lampiran, sehingga daun yang berada pada nilai yang dinyatakan sebagai default oleh skema Feature disebut bersama daun yang ditulis oleh penulis — default yang terisi adalah datum yang dibawa payload, dan penandaan yang hanya dibaca dari blok tertulis akan membiarkannya tidak tersebut. Ini adalah unit per-daun dari penandaan sensitivitas, dan ini menjawab pertanyaan yang tidak dijawab oleh kedua lainnya — sensitive memberikan satu jawaban untuk seluruh lampiran, sensitive_inject memberikan satu jawaban per kunci pengiriman inject, dan keduanya tidak menyebut daun individual. Sebuah daun muncul jika path yang dinyatakan sensitif oleh skema Feature mencakupnya: deklarasi menyebut daun itu, atau menyebut objek yang memuatnya, sehingga daun di bawah objek yang dicakup deklarasi disebut oleh deklarasi tersebut. Pencocokan berjalan per segmen pada path bertitik, tanpa membaca apa pun dari teks path itu sendiri dan tanpa memeriksa nilai, sehingga deklarasi pada 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.
connectionAttachmentConnectiontidakKoneksi 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.
realizationstringtidakFeatureRecipe yang merealisasikan lampiran ini, sebagai :: yang di-bind oleh Manifest ke lampiran tersebut — berdasarkan nama lampiran itu sendiri jika tingkat nama Manifest memetakan nama tersebut, jika tidak berdasarkan jenis Feature-nya — yaitu yang digunakan oleh build dari dokumen yang sama untuk me-render-nya. Untuk lampiran yang ditulis pada koneksi, nama yang dibaca oleh tingkat nama adalah nama berkualifikasinya, yaitu alias koneksi dan slot yang digabungkan dengan titik. Nilainya adalah pasangan yang dicetak oleh aggrega inspect sebagai realisasi lampiran dan, jika target mencantumkan provenance pada apa yang di-render-nya, nilai aggrega.ai/recipe-uri pada dokumen yang di-render oleh FeatureRecipe tersebut, sehingga konsumen menggabungkan lampiran dengan apa yang di-render-nya tanpa menerjemahkan antarbentuk. Field ini menyebut FeatureRecipe berdasarkan nama dan versi, bukan berdasarkan kapabilitas. Field ini mencatat FeatureRecipe mana yang di-bind oleh Manifest, dibaca dari Manifest dan katalog saat graph dibangun: tidak ada yang diambil untuk menghasilkannya, dan FeatureRecipe hanya di-render saat build melakukan render. Tidak ada jika Manifest tidak mem-bind lampiran ke FeatureRecipe yang dimiliki katalog.

Properti tambahan tidak diizinkan.

IRFeatureEntry.inject

Perutean injeksi yang agnostik. Memetakan variabel lokal ke kunci provides Target.

PropertiJenisWajibDeskripsi
envmap of stringtidakPengiriman melalui variabel lingkungan: kunci adalah nama variabel lokal konsumen, nilai adalah kunci provides milik target.
filemap of stringtidakPengiriman melalui mount file: kunci adalah path file lokal konsumen, nilai adalah kunci provides milik target.
argmap of stringtidakPengiriman 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.

PropertiJenisWajibDeskripsi
typestringyaURI dari Feature Katalog yang dilampirkan pada boundary ini.
infraobjecttidakUkuran fisik untuk lampiran boundary; infra yang digunakan oleh FeatureRecipe lingkup boundary untuk mengevaluasi template dan sumbernya.
sensitive_payload_leavesstring[]tidakDaun-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. yang muncul di sini, karena lampiran tingkat boundary tidak membawa payload values. Payload yang dibaca di sini adalah payload yang pada akhirnya dibawa lampiran, sehingga daun yang berada pada nilai yang dinyatakan sebagai default oleh skema Feature disebut bersama daun yang ditulis oleh boundary — default yang terisi adalah datum yang dibawa payload, dan penandaan yang hanya dibaca dari blok tertulis akan membiarkannya tidak tersebut. Sebuah daun muncul jika path yang dinyatakan sensitif oleh skema Feature mencakupnya: deklarasi menyebut daun itu, atau menyebut objek yang memuatnya, sehingga daun di bawah objek yang dicakup deklarasi disebut oleh deklarasi tersebut. Pencocokan berjalan per segmen pada path bertitik, tanpa membaca apa pun dari teks path itu sendiri dan tanpa memeriksa nilai, sehingga deklarasi pada 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.
realizationstringtidakFeatureRecipe yang merealisasikan lampiran boundary ini, sebagai :: yang di-bind oleh Manifest ke lampiran tersebut — berdasarkan nama lampiran itu sendiri jika tingkat nama Manifest memetakan nama tersebut, jika tidak berdasarkan jenis Feature-nya — yaitu yang digunakan oleh build dari dokumen yang sama untuk me-render-nya. Ini adalah field yang sama, dibaca dengan cara yang sama, seperti realisasi entri lampiran di bawah feature_values_mapping. Tidak ada jika Manifest tidak mem-bind lampiran ke FeatureRecipe yang dimiliki katalog.

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.

PropertiJenisWajibDeskripsi
maintainersMaintainer[]tidakPara pemelihara yang dicantumkan entitas Catalog sebagai pemiliknya.
licensestringtidakPengidentifikasi lisensi SPDX yang dideklarasikan entitas Catalog untuk perangkat lunak yang dideskripsikannya.
repositorystringtidakURL repositori Git yang disebut entitas Catalog sebagai tempat file sumbernya.
homestringtidakURL halaman beranda, wiki, atau dokumentasi entitas Catalog.
keywordsstring[]tidakKata kunci deskriptif yang dideklarasikan entitas Catalog.

Properti tambahan tidak diizinkan.

IRNode

PropertiJenisWajibDeskripsi
descriptionstringtidakDokumentasi opsional yang ditulis pengembang yang menjelaskan peran instans komponen ini dalam aplikasi. Diteruskan dari Aggregate untuk rendering dan untuk diagnostik lint.
labelsmap of stringyaLabel duck-typing dan ontologi entitas.
componentstringyaNama Component yang mendasarinya.
resolved_versionstringyaSemantic Version yang tepat dari Component yang di-resolve selama kompilasi.
sync_waveintegertidakGelombang 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_pathstringtidakPath 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_pathstringtidakPath 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_subsystembooleantidakTrue 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_boundarybooleantidakTrue 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_metadataCatalogMetadatatidakEnterprise Metadata Suite yang diekstrak secara eksplisit dari entitas Katalog, yang mengekspos data siklus hidup dan kepemilikan ke linter Wasm.
catalog_annotationsmap of stringtidakKarakteristik komponen yang immutable dan intrinsik, ditulis oleh Platform Architect di Domain 2.
release_annotationsmap of stringtidakString topologi fisik dan realitas Ops yang mengalir dari boundary dalam Release.
aggregate_annotationsmap of stringtidakMetadata kognitif, maksud developer, dan FinOps yang mengalir dari subsistem dalam Aggregate.
self_injectobjecttidakBlok 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_filestringtidakPath 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.
usesobjecttidakBlok 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_leavesstring[]tidakLeaf 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. atau infra.. Field ini menamai data MILIK node itu sendiri — apa yang dibawa values_mapping dan infra_mapping untuk node ini — dan merupakan subjek yang berbeda dari penandaan pada entri attachment, yang menamai data yang dibawa attachment terhadap deklarasi Feature-nya. Keduanya tidak dapat diperoleh dari satu sama lain: Component suatu node dan Feature suatu attachment mendeklarasikan skema berbeda, dan node yang tidak melampirkan apa pun tetap membawa values. Payload yang dibaca di sini adalah yang dibawa kedua mapping tersebut, sehingga leaf yang berada pada nilai yang dideklarasikan skema Component sebagai default dinamai bersama leaf yang ditulis penulis — default yang terisi adalah datum yang dibawa graph, dan penandaan yang hanya dibaca dari blok yang ditulis akan membiarkannya tanpa nama. Sebuah leaf muncul ketika suatu path yang dideklarasikan sensitif oleh skema Component mencakupnya: deklarasi tersebut menamai leaf itu, atau menamai objek yang memuatnya, sehingga leaf di bawah objek yang dicakup suatu deklarasi dinamai oleh deklarasi tersebut. Pencocokan dilakukan per segmen atas dotted path, tanpa membaca apa pun dari teks path itu sendiri dan tanpa memeriksa nilai, sehingga deklarasi pada 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

PropertiJenisWajibDeskripsi
sourcestringyaID node yang mengonsumsi, tempat koneksi dimulai.
targetstringyaID node yang dicapai oleh koneksi.
socketstringtidakKategori usesSchema tempat edge ini berada (mis., ‘databases’, ‘tools’).
aliasstringtidakAlias yang ditentukan pengembang untuk koneksi ini (mis., ‘primary_db’).
socket_declarationstring (enum)yaAsal 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_featurestringtidakJika 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_instancestringtidakNama 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_releasebooleantidakTrue 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.
valuesobjecttidakNilai 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..values. Kunci yang dihilangkan penulis diisi dari default yang dideklarasikan socket; nilai yang ditulis penulis yang berlaku.
infraobjecttidakInfra 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..infra. Kunci yang dihilangkan penulis diisi dari default yang dideklarasikan socket; nilai yang ditulis penulis yang berlaku.
injectobjecttidakPerutean injeksi yang agnostik. Memetakan variabel lokal ke kunci provides Target.
sensitive_payload_leavesstring[]tidakDaun-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. atau infra.. Deklarasi yang dibaca adalah kontrak per koneksi pada komponen yang MENGONSUMSI — sumber edge — di bawah soket tempat edge ini dihubungkan: valueSchema-nya mengatur values dan infraSchema-nya mengatur infra, yang merupakan kontrak yang sama dengan yang digunakan untuk memvalidasi kedua payload. Deklarasi target tidak berperan: apa yang diterbitkan target adalah datum yang berbeda dari konfigurasi yang ditulis konsumen untuk koneksi tersebut. Ini adalah field yang sama, dibaca dengan cara yang sama, seperti penandaan pada node, dengan subjek yang berbeda darinya: penandaan node menyebut data milik node itu sendiri terhadap skema Component-nya, sedangkan penandaan ini menyebut konfigurasi koneksi terhadap kontrak soket, sehingga keduanya tidak dapat dipulihkan dari yang lain. Payload yang dibaca di sini adalah payload yang dibawa edge ini, sehingga daun yang berada pada nilai yang dinyatakan sebagai default oleh kontrak soket disebut bersama daun yang ditulis oleh penulis. Sebuah daun muncul jika path yang dinyatakan sensitif oleh kontrak mencakupnya: deklarasi menyebut daun itu, atau menyebut objek yang memuatnya. Pencocokan berjalan per segmen pada path bertitik, tanpa membaca apa pun dari teks path itu sendiri dan tanpa memeriksa nilai, sehingga deklarasi pada 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.

PropertiJenisWajibDeskripsi
envmap of stringtidakPengiriman melalui variabel lingkungan: kunci adalah nama variabel lokal konsumen, nilai adalah kunci provides milik target.
filemap of stringtidakPengiriman melalui mount file: kunci adalah path file lokal konsumen, nilai adalah kunci provides milik target.
argmap of stringtidakPengiriman melalui argumen baris perintah: kunci adalah prefiks flag konsumen, nilai adalah kunci provides milik target.

IRMetadata

Identitas graf: Aggregate yang menjadi dasar pembangunannya.

PropertiJenisWajibDeskripsi
aggregate_namestringyametadata.name milik Aggregate.

Properti tambahan tidak diizinkan.

IRProvenance

Metadata keterlacakan untuk diagnostik dan audit.

PropertiJenisWajibDeskripsi
schema_versionstringyaVersi skema IR yang dipatuhi graf — aggrega.ai/v1beta1, nilai yang sama dengan yang dibawa apiVersion graf.
compiler_versionstringyaStempel kepatuhan wajib. Mengidentifikasi, melalui versinya, biner aggrega yang membangun graf ini.
aggregate_versionstringyaVersi semantik yang tepat dari intent Aggregate root yang digunakan selama kompilasi.
manifest_versionstringyaVersi semantik yang tepat dari lockfile Manifest yang digunakan selama kompilasi.
release_versionstringyaVersi 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.

PropertiJenisWajibDeskripsi
nodesmap of IRNodeyaKamus 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_.-]+$.
edgesIREdge[]yaJalur jaringan logis dan dependensi eksplisit antar-node.
values_mappingobjectyaSatu-satunya sumber kebenaran untuk payload kognitif pass-through yang opak, dipetakan berdasarkan ID node.
infra_mappingobjectyaPayload ukuran fisik yang diinjeksikan dari Release, dipetakan berdasarkan ID node.
feature_values_mappingmap of map of IRFeatureEntryyaMap 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_featuresmap of map of IRBoundaryFeaturetidakAttachment 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_./-]+$.
provenanceIRProvenanceyaMetadata keterlacakan untuk diagnostik dan audit.

Properti tambahan tidak diizinkan.

IRGraph

PropertiJenisWajibDeskripsi
apiVersionconst “aggrega.ai/v1beta1”yaKonstanta: "aggrega.ai/v1beta1"
kindconst “IR”yaKonstanta: "IR"
metadataIRMetadatayaIdentitas graf: Aggregate yang menjadi dasar pembangunannya.
specIRSpecyaGraf itu sendiri: node, edge, dan payload yang dikunci per node.

Properti tambahan tidak diizinkan.