Skema Aggrega Developer Intent (Aggregate)
Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.
Id skema: https://aggrega.ai/schemas/aggregate-v1beta1.schema.json
Arsitektur AI yang rekursif dan terparameterisasi. Berfungsi sebagai akar sebuah build sekaligus modul yang dapat digunakan ulang.
Lihat referensi penulisan Aggregate untuk panduan prosa tentang penulisan entitas Aggregate; halaman ini mendokumentasikan skema struktural yang dijelaskan oleh referensi tersebut.
Jenis tingkat teratas: object
Properti
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | ya | Konstanta: "aggrega.ai/v1beta1" |
kind | const “Aggregate” | ya | Konstanta: "Aggregate" |
metadata | object | ya | |
defs | string[] | tidak | Blok opsional untuk anchor YAML standar (& dan *) agar Aggregate tetap DRY sambil mempertahankan kamus datar O(1) bagi compiler. Mencerminkan blok yang setara pada Manifest. |
spec | object | ya | Permukaan Developer Intent: kontrak parameter global, impor aggregate bersarang, API publik komponen yang diekspor, pengelompokan subsistem, dan instans komponen yang membentuk modul. |
Properti tambahan tidak diizinkan.
aggregate.metadata
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
name | string | ya | Panjang minimal 1 karakter. |
version | string | ya | Semantic Versioning ketat dari modul aggregate. Pola: ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$. |
description | string | tidak | |
maintainers | object[] | tidak | Daftar pemelihara yang memiliki entitas ini. |
license | string | tidak | Pengidentifikasi SPDX untuk lisensi perangkat lunak yang dideskripsikan entitas ini, seperti MIT atau AGPL-3.0. Pengidentifikasi ini mencatat ketentuan perangkat lunak tersebut, bukan ketentuan berkas ini. |
repository | string | tidak | URL ke repositori Git tempat berkas sumber berada. |
home | string | tidak | URL halaman beranda, wiki, atau dokumentasi entitas ini. |
keywords | string[] | tidak | Daftar kata kunci deskriptif untuk kemudahan penemuan di UI. |
labels | map of string | tidak | Label duck-typing tingkat modul untuk penemuan katalog, evaluasi kebijakan, dan pemfilteran Studio/IDE. Label ini mendeskripsikan identitas Aggregate sebagai modul yang dapat digunakan ulang (misalnya, aggregate.aggrega.ai/tier: infrastructure, aggregate.aggrega.ai/compliance: pci-dss). Label ini TIDAK diturunkan ke node komponen anak — label komponen hanya berasal dari entitas katalog Component di Domain 2. |
Properti tambahan tidak diizinkan.
aggregate.metadata.maintainers[]
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
name | string | ya | |
email | string | tidak | |
url | string | tidak |
Properti tambahan tidak diizinkan.
aggregate.spec
Permukaan Developer Intent: kontrak parameter global, impor aggregate bersarang, API publik komponen yang diekspor, pengelompokan subsistem, dan instans komponen yang membentuk modul.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
parameters | map of object | tidak | Kontrak lingkungan global. Setiap entri adalah objek kontrak bertipe yang menulis subset kosakata bentuk ringkas (type, description, default, enum, min/max, minLength/maxLength, pattern, format, validate, validateMessage, required, items, valuesType, properties). Struktur bersarang dinyatakan melalui sub-bidang properties: dalam bentuk bertipe. Pemenuhan Release dapat ditulis secara inline (parameters: {…}) atau melalui impor file dari satu sumber (parameters: {$import: |
aggregates | map of object | tidak | Aggregate bersarang yang berperan sebagai modul yang diimpor. Kunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$. |
exportedComponents | map of string | tidak | Antarmuka API publik. Memetakan nama publik yang diekspos ke ID komponen internal. Aggregates induk yang mengimpor modul ini mereferensikan komponen melalui nama publik tersebut. |
subsystems | map of subsystem | tidak | Pengelompokan logis bernama atas komponen-komponen sebuah Aggregate ke dalam subsistem. Saling eksklusif dengan components tingkat atas — mendeklarasikan keduanya akan ditolak. Subsistem yang dinamai default oleh penulis adalah subsistem biasa yang dideklarasikan, berbeda dari default sintetis yang dibuat compiler untuk Aggregate yang hanya berisi components. Kunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$. |
components | map of component_instance | tidak | Map komponen atomik logis yang membentuk Aggregate ini, ditulis langsung di tingkat atas. Components tingkat atas dan subsystems saling eksklusif — mendeklarasikan keduanya akan ditolak. Ketika komponen ditulis di sini (tanpa subsystems), compiler melipatnya ke dalam subsistem default sintetis saat pemuatan, dan IR menandai subsistem tersebut sebagai sintetis. Kunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$. |
Properti tambahan tidak diizinkan.
Definisi
inject_delivery
Satu mekanisme pengiriman, ditulis sebagai array entri. Setiap entri memuat ‘in’ (pengenal lokal — nama variabel env, path file, flag arg, atau kunci khusus mekanisme kustom) ditambah tepat satu dari ‘from’ (kunci provides yang akan di-resolve) atau ‘value’ (string literal, opsional berisi ekspresi template Go yang dievaluasi saat resolusi self-inject). ‘from’ di-resolve terhadap provides milik target dalam konteks uses[].inject, terhadap provides yang dipublikasikan FeatureRecipe milik lampiran dalam konteks features.
Jenis: object[]
inject_block
Perutean injeksi yang agnostik. Memetakan variabel lokal ke kunci provides target (uses[].inject), ke kunci provides yang dipublikasikan FeatureRecipe milik sebuah lampiran (features.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
env | inject_delivery | tidak | Satu mekanisme pengiriman, ditulis sebagai array entri. Setiap entri memuat ‘in’ (pengenal lokal — nama variabel env, path file, flag arg, atau kunci khusus mekanisme kustom) ditambah tepat satu dari ‘from’ (kunci provides yang akan di-resolve) atau ‘value’ (string literal, opsional berisi ekspresi template Go yang dievaluasi saat resolusi self-inject). ‘from’ di-resolve terhadap provides milik target dalam konteks uses[].inject, terhadap provides yang dipublikasikan FeatureRecipe milik lampiran dalam konteks features. |
file | inject_delivery | tidak | Satu mekanisme pengiriman, ditulis sebagai array entri. Setiap entri memuat ‘in’ (pengenal lokal — nama variabel env, path file, flag arg, atau kunci khusus mekanisme kustom) ditambah tepat satu dari ‘from’ (kunci provides yang akan di-resolve) atau ‘value’ (string literal, opsional berisi ekspresi template Go yang dievaluasi saat resolusi self-inject). ‘from’ di-resolve terhadap provides milik target dalam konteks uses[].inject, terhadap provides yang dipublikasikan FeatureRecipe milik lampiran dalam konteks features. |
arg | inject_delivery | tidak | Satu mekanisme pengiriman, ditulis sebagai array entri. Setiap entri memuat ‘in’ (pengenal lokal — nama variabel env, path file, flag arg, atau kunci khusus mekanisme kustom) ditambah tepat satu dari ‘from’ (kunci provides yang akan di-resolve) atau ‘value’ (string literal, opsional berisi ekspresi template Go yang dievaluasi saat resolusi self-inject). ‘from’ di-resolve terhadap provides milik target dalam konteks uses[].inject, terhadap provides yang dipublikasikan FeatureRecipe milik lampiran dalam konteks features. |
component_uses_block
Koneksi yang ditarik sebuah komponen ke komponen-komponen yang menjadi dependensinya, dengan socket sebagai kunci. Setiap socket mencantumkan targetnya, atau menamai setiap koneksi dengan sebuah alias. Koneksi yang dinamai dengan alias dapat memuat nilai per koneksi dari pengembang dan lampiran yang mengisi slot yang dideklarasikan socket tersebut.
Kunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$.
Nilainya adalah string[] or map of object.
Kunci lain tidak diizinkan.
feature_uses_block
Koneksi yang ditarik oleh Feature yang dilampirkan, dengan kunci berupa socket yang dideklarasikan Feature dalam usesSchema-nya. Setiap socket mencantumkan targetnya, atau menamai setiap koneksi dengan sebuah alias. Koneksi yang ditarik sebuah Feature tidak memuat lampirannya sendiri: kredensial yang dibutuhkannya mengisi slot yang dideklarasikan Feature dalam featuresSchema miliknya sendiri dan dilampirkan di samping Feature tersebut.
Kunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$.
Nilainya adalah string[] or map of object.
Kunci lain tidak diizinkan.
connection_attachment
Satu lampiran yang dimuat sebuah koneksi: Feature yang mengisi slot yang dideklarasikan socket koneksi tersebut, beserta konfigurasi dari pengembang untuknya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
type | string | ya | URI antarmuka Feature yang diminta lampiran ini (mis. core/referenced-secret:1.0.0). |
description | string | tidak | Dokumentasi opsional yang menjelaskan mengapa koneksi ini memuat lampiran tersebut. |
values | object | tidak | Konfigurasi yang diberikan pengembang untuk Feature, divalidasi oleh deklarasi skemanya. |
Properti tambahan tidak diizinkan.
subsystem
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
description | string | tidak | Dokumentasi opsional yang menjelaskan tujuan subsistem ini dan pengelompokan logis yang diwakilinya. |
annotations | map dari string atau object atau null | tidak | Anotasi yang ditulis pengembang pada subsistem ini. Nilainya berupa string, objek terstruktur (map dari subkunci ke nilai, digabungkan per subkunci dengan nilai terstruktur yang diwarisi), atau null; null eksplisit pada kunci yang diwarisi dari subsistem induk menghapus binding yang diwarisi dari subsistem ini (opt-out Feature berbasis anotasi). Anotasi yang dideklarasikan di sini diwarisi oleh subsistem bersarang dan oleh komponen yang dimuatnya; tingkat yang lebih dekat menang per kunci. Diteruskan ke bawah ke bucket .context.annotations.aggregate pada setiap node IR turunan. |
features | map of object | tidak | Fitur lintas bagian yang dilampirkan ke semua komponen dalam subsistem ini. Skemanya sama dengan fitur tingkat komponen (type, values, uses, inject). Diratakan ke dalam setiap komponen saat finalisasi graf, ditempatkan setelah fitur tingkat komponen dalam urutan eksekusi. Kunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$. |
subsystems | map of subsystem | tidak | Kunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$. |
components | map of component_instance | tidak | Kunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$. |
Properti tambahan tidak diizinkan.
component_instance
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
type | string | ya | Component abstrak yang diminta, sebagai referensi: metadata.name-nya ditambah :version opsional (misalnya core/api-server:1.0.0), tidak pernah berupa path file. Di-resolve melalui Model Resolusi Entitas Tiga Tingkat (direktori katalog workspace → cache → registry): Component yang ditulis secara lokal ditempatkan di bawah catalog/ di akar workspace atau di direktori yang tercantum di workspace.catalog_dirs, dan type yang ditulis sebagai path file relatif menghentikan build sebagai entitas yang tidak dimiliki katalog mana pun. |
active | boolean atau string | tidak | Apakah komponen ini ada dalam topologi hasil kompilasi. Berupa boolean, atau template string atas .parameters yang harus di-resolve menjadi boolean. Jika di-resolve menjadi false, komponen dipangkas dari topologi, berlanjut ke edge uses dan attachment-nya. Dengan menurunkan nilai dari sebuah parameter, sebuah Release dapat mengaktifkan atau menonaktifkan keberadaan komponen dengan memenuhi parameter tersebut. Bernilai default true jika dihilangkan. Default: true |
description | string | tidak | Dokumentasi opsional yang menjelaskan peran instans komponen ini dalam aplikasi. Dibawa hingga ke graf IR. |
annotations | map dari string atau object atau null | tidak | Anotasi yang ditulis pengembang pada komponen ini. Nilainya berupa string, objek terstruktur (map dari subkunci ke nilai, digabungkan per subkunci dengan nilai terstruktur yang diwarisi), atau null; null eksplisit pada kunci yang diwarisi dari subsistem induk menghapus binding yang diwarisi dari komponen ini (opt-out Feature berbasis anotasi). Anotasi tingkat Component menimpa anotasi tingkat subsistem yang diwarisi per kunci; komponen saudara dalam subsistem yang sama mempertahankan peta anotasinya masing-masing secara independen. |
values | object | tidak | Properti kognitif opak yang diteruskan ke Component, divalidasi oleh skemanya. |
uses | component_uses_block | tidak | Koneksi yang ditarik sebuah komponen ke komponen-komponen yang menjadi dependensinya, dengan socket sebagai kunci. Setiap socket mencantumkan targetnya, atau menamai setiap koneksi dengan sebuah alias. Koneksi yang dinamai dengan alias dapat memuat nilai per koneksi dari pengembang dan lampiran yang mengisi slot yang dideklarasikan socket tersebut. |
inject | inject_block | tidak | Self-inject tingkat komponen. Menyuntikkan nilai milik komponen itu sendiri (melalui ‘value:’) atau kunci provides miliknya sendiri (melalui ‘from:’) langsung ke pipa pengiriman (.context.inject). Hanya diizinkan jika entitas katalog Component mendeklarasikan ‘spec.inject’ dengan mekanisme yang sesuai. Kunci inject yang bertabrakan dengan kunci yang dideklarasikan di uses[].inject menghentikan build sebagai kunci pengiriman duplikat lintas sumber inject. |
features | map of object | tidak | Features yang dilampirkan ke komponen ini, dengan kunci berupa nama instans yang diberikan penulis untuk setiap attachment. Inilah satu-satunya permukaan attachment: Feature operasional, Feature kredensial (yang berlabel feature.aggrega.ai/kind: secret) dan Feature identitas semuanya dilampirkan di sini, dengan kata kunci dan bentuk yang sama. Yang membedakannya adalah apa yang dihasilkan attachment tersebut, bukan cara mendeklarasikannya. Attachment yang nama instansnya cocok dengan slot yang dideklarasikan Component di featuresSchema mengisi slot tersebut; nama instans lainnya merupakan attachment bebas. Kunci: satu atau lebih huruf, angka, garis bawah, atau tanda hubung. Titik tidak diizinkan. Pola: ^[a-zA-Z0-9_-]+$. |
Properti tambahan tidak diizinkan.