Status bahasa
Halaman ini adalah referensi kanonis tentang permukaan Aggrega mana yang dapat digunakan saat ini, mana yang sudah didokumentasikan tetapi belum ditindaklanjuti oleh kompiler, dan mana yang direncanakan untuk iterasi mendatang. Halaman ini melengkapi bab per domain dengan menampilkan status kesiapan seluruh bahasa di satu tempat.
Dua kelompok pembaca merujuk halaman ini. Penulis pemula memeriksa halaman ini sebelum menulis untuk permukaan yang belum dikenalnya, untuk memastikan bahwa permukaan tersebut saat ini menghasilkan output yang dirender. Pencari referensi memeriksa halaman ini ketika permukaan yang mereka gunakan berperilaku tidak terduga — misalnya, ketika YAML lolos validasi tetapi tidak ada output yang dihasilkan, halaman ini adalah tempat pertama untuk mencari status permukaan tersebut. Pembaca yang kembali juga merujuk halaman ini untuk mengenali permukaan yang telah berpindah label status sejak terakhir kali dibaca. Bab per domain dan referensi entitas menjelaskan bagaimana permukaan seharusnya bekerja; halaman ini menjelaskan apakah permukaan itu sudah bekerja.
Taksonomi status
Setiap permukaan bahasa di halaman ini memiliki salah satu dari empat label status:
-
tersedia. Skema menerima permukaan tersebut; kompiler memprosesnya; perilakunya sesuai dengan kontrak yang didokumentasikan. Penulis yang menggunakan permukaan
availablemendapatkan kontrak yang didokumentasikan. -
diterima tetapi inert. Skema menerima permukaan tersebut — penulisan untuknya lolos validasi — tetapi kompiler belum menindaklanjutinya. Menulis permukaan
accepted but inertmenghasilkan build yang valid secara sintaksis tanpa efek render apa pun untuk permukaan itu; kompiler dapat mengeluarkan peringatan yang menyebutkan permukaan inert tersebut (pola yang direkomendasikan), atau beberapa permukaan saat ini dilewati secara diam-diam tanpa peringatan. Entri per bagian di bawah menyebutkan perilaku spesifiknya. -
diterima tetapi diblokir. Skema menerima permukaan tersebut — penulisan untuknya lolos validasi — tetapi kompiler menghentikan build alih-alih merendernya. Menulis untuk permukaan
accepted but blockedgagal saat render dengan galat eksplisit yang menyebutkan apa yang harus ditulis sebagai gantinya. Pemblokiran dapat bersifat permanen, ketika apa yang ditulis merupakan ambiguitas yang tidak akan diselesaikan kompiler atas nama Anda, karena memilih satu tafsiran untuk Anda dapat menghasilkan sesuatu yang tidak Anda minta; atau pemblokiran dapat berlaku hanya sampai perilaku di balik permukaan itu dirilis. Yang dijanjikan label ini sama dalam kedua kasus: skema menerimanya, build menolaknya, dan galat memberi tahu Anda cara memperbaikinya. -
direncanakan. Permukaan tersebut didokumentasikan sesuai rancangannya, tetapi baik skema maupun kompiler belum menerimanya. Menulis untuk permukaan
plannedgagal pada validasi skema. Halaman ini menampilkan item yang direncanakan agar penulis dapat merencanakan dengan memperhitungkan ketiadaannya, alih-alih menemukan kekurangan itu saat build.
Label status dievaluasi terhadap kompiler saat ini. Permukaan yang sedang aktif dikembangkan dapat berpindah label; entri per bagian menjelaskan rencana transisinya jika sudah diketahui.
Jenis input Recipe
Sebuah Recipe menyusun outputnya dari tiga jenis input — dari sumber, tersintesis, dan artefak — yang dijelaskan di 16-recipe-input-composition.md. Status per jenis input:
-
source:+valuesMapping:(dari sumber) — tersedia. Kompiler meresolusi URIsource:, mengevaluasi templatvaluesMapping(inline,$import:berkas, atau$import:pustaka), dan menyerahkan hasilnya ke provider target untuk dirender. Digunakan oleh provider helm, helm-chart, compose, terraform, dan cloudformation. -
workload:(tersintesis) — tersedia. Recipe mendeklarasikanworkload:secara inline (skalar blok yang memuat YAML Workload) atau melalui$import:(path berkas). Kompiler mengurai Workload bertemplat, memvalidasinya terhadap skema Workload yang tertanam, dan meneruskannya ke penyintesis workload milik provider target. Digunakan oleh provider helm dan compose. Provider helm-chart secara eksplisit mengarahkan penulis ke provider helm untuk manifest K8s tersintesis. Recipe yang mendeklarasikanworkload:untuk provider yang tidak mengimplementasikan sintesis workload akan berhenti saat render denganCATALOG_ERROR. -
artifacts:(artefak) — tersedia. Bidang ini adalah map berisi entri bernama; setiap entri ditulis inline atau dimuat melalui$import:per entri. Entri dievaluasi setelah Workload diurai dan sumber diresolusi, sehingga konteks template lengkap — termasuk.workloaddan.source— tersedia bagi entri tersebut; entri mendapatkan provenans yang digabungkan kemetadata.labelsdanmetadata.annotationsuntuk dokumen yang membawa metadata (kunci yang tidak aman bagi charset — recipe-uri, boundary-path, sync-wave — sebagai anotasi, pembagian yang sama yang diterapkan provider helm), dan dikeluarkan sebagai berkas terpisah di samping output Recipe yang dirender dari sumber atau disintesis dari workload. Dispatch Provider — provider helm datar mengeluarkan berkas mandiri di bawah direktori yang dinamai menurut komponen yang mendeklarasikannya, di dalam direktori output boundary, karena kunci menamai berkas dan tidak menyatakan komponen mana yang menulisnya; provider compose merutekan keluarannya melalui penggabung di akhir Release; provider helm-chart mengevaluasi setiap entri dengan pembatas Aggrega[[ ]]sehingga sintaks{{ }}milik Helm di berkas yang sama bertahan hingga render hilir, lalu menempatkan setiap entri menurut bentuk penulisannya — entri yang dimuat dengan$import:diboundaries/<bp>/charts/<nodeID>/templates/<authored-key>(berkas sebuah bundle bersarang di bawah kunci itu), di samping templat milik chart dari sumber, dan entri berisi konten inline diboundaries/<bp>/charts/<nodeID>/<authored-key>, akar chart, tempat templat milik chart membacanya melalui.Files.Get/.Files.Glob; provider terraform menulis setiap entri apa adanya ke direktori milik komponen itu sendiri di bawah pohonmodules/milik boundary; provider cloudformation menggabungkan setiap entri, sebuah fragmen stack, ke dalam satu stack yang dirakit untuk direktori output tersebut. Tabrakan nama berkas antar-asal jenis input (output yang dirender dari sumber, disintesis dari workload, atau dikeluarkan sebagai artefak) ditangkap saat render oleh pendeteksi tabrakan lintas asal dan menghasilkan CATALOG_ERROR yang menyebutkan setiap kontributor.
Lihat entities/recipe.md untuk permukaan penulisan Recipe dan aturan komposisi jenis input; errors/fatal-halts.md untuk aturan bentuk Recipe; dan bagian Providers di bawah untuk matriks per provider.
Bahasa pemetaan
Recipes (dan FeatureRecipes) terikat pada satu bidang pemetaan untuk menerjemahkan konteks Aggrega ke dalam kamus nilai yang digunakan provider di bawahnya. Bidang valuesMapping: mendukung tiga mode penulisan yang dipilih berdasarkan bentuk konten:
valuesMapping:— Mode 1-3 tersedia. Mode 1: templat Go inline (skalar blok). Mode 2:$import:berkas (map yang hanya berisi$import:dengan path berkas lokal). Mode 3:$import:pustaka (map yang hanya berisi$import:dengan referensi identitas nama polos ke entri MappingLibrary,<Library>#/mappings/<entry>, opsional dengan batas bawah:<version>). Kompiler memilih berdasarkan bentuk konten — skalar blok ke Mode 1,$import:dengan path berkas ke Mode 2,$import:dengan referensi pustaka nama polos ke Mode 3. Ketiganya mengevaluasi templat Go yang telah diresolusi terhadap konteks template milik Recipe selama pemetaan nilai (pustaka helper Sprig telah didaftarkan sebelumnya); Mode 3 meresolusi entri terhadap katalog lokal ditambah pustaka apa pun yang disematkan di lockfile, dan referensi yang memuat host ditolak. Lihatentities/recipe.md“BidangvaluesMapping— tiga mode penulisan” untuk mekanisme dispatch dan contoh lengkapnya.
Lihat entities/recipe.md untuk permukaan penulisan Recipe dan desain bahasa pemetaan, serta entities/mappinglibrary.md untuk entitas pustaka yang mendasari Mode 3.
Sintaks inject
Blok inject: memiliki satu sintaks di setiap penempatan — di inject milik komponen sendiri, di koneksi uses, dan di lampiran.
-
Daftar entri per mekanisme (
[{in: ..., from: ...}],[{in: ..., value: ...}]) — tersedia. Setiap mekanisme pengiriman adalah sebuah daftar; setiap entri menamai pengenal lokalnya (nama variabel lingkungan, path berkas, flag argumen) denganin:dan membawa tepat satu darifrom:(referensi kunci provides) atauvalue:(string literal). Mekanisme yang ditulis sebagai map alih-alih daftar, atau entri yang membawa kedua kata kunci, menghentikan build di amplop dokumen Aggregate dengan menyebutkan path-nya. -
value:hanya diinjectmilik komponen sendiri. Literal semestinya berada diinjectmilik komponen sendiri, yang mengirimkannya. Pada koneksiuses,value:menghentikan build, seperti dijelaskan di Aninject:entry on a connection carries a literal (Entri pada koneksi membawa literal), dan diinjectmilik lampiran sendiri ia juga menghentikan build, seperti dijelaskan di Aninject:entry on an attached Feature carries a literal (Entri pada Feature yang dilampirkan membawa literal): keduanya hanya mengirimkan kunci yang diterbitkan entitas lain, yang disebut denganfrom:.
Lihat vocabulary/topology-triad.md untuk spesifikasi lengkap Injection Contract, termasuk semantik konteks dua keadaan, aturan tabrakan kunci, dan contoh lengkapnya.
Mesin templat
Mesin templat Go milik Aggrega mengevaluasi templat Recipe dan FeatureRecipe terhadap konteks template pada fase per situs yang didokumentasikan oleh Matriks ekspansi templat. Pustaka helper Sprig didaftarkan sebelumnya bersama helper milik Aggrega di setiap permukaan yang dievaluasi renderer, dengan satu pengecualian: meresolusi koordinat source: terstruktur hanya mendaftarkan helper milik Aggrega — optional dan capitalizedWords tersedia di sana sedangkan fungsi Sprig tidak, sehingga panggilan Sprig di bidang source:, atau di entri locals: pada entitas yang membawa source: terstruktur, berhenti saat penguraian. Lihat errors/fatal-halts.md, yang memberikan bagian tersendiri untuk permukaan tersebut. Evaluasi, penguraian, dan integrasi Sprig tersedia saat ini.
Perilaku kunci yang hilang — ditoleransi pada templat nilai; missingkey=error yang ketat pada templat path, pada asersi, dan pada koordinat source:. Templat nilai dievaluasi dengan opsi missingkey=zero milik Go, sehingga templat yang merujuk kunci yang tidak terikat (mis. .values.unset_field) tidak memunculkan galat dan pembacaan tersebut tidak merender apa pun. Idiom katalog seperti {{ .values.optional_field | default "fallback" }} tetap berfungsi di bawah kebijakan ini, karena nilai yang tidak diatur dihitung sebagai kosong bagi default. Templat path (directory: / subDirectory: pada boundary Release) dievaluasi dengan missingkey=error terhadap allowlist tertutup — kegagalan path yang diam-diam menghasilkan tata letak sistem berkas yang rusak yang baru ditemukan operator setelah build, dan keketatan ini menangkap galat lebih awal. Dua permukaan lain mengikuti kebijakan ketat yang sama, dengan alasan yang sama: render kosong di sana akan menghasilkan putusan yang salah atau pin yang salah alih-alih bidang yang dapat dibaca kembali oleh penulis. Keduanya adalah entri assertions: pada Component, Feature, Recipe, atau FeatureRecipe, serta bidang bertemplat dari blok source: terstruktur pada Recipe atau FeatureRecipe. errors/fatal-halts.md menjabarkan kebijakan setiap permukaan satu per satu dan memberikan bentuk yang peka keberadaan yang berfungsi di bawah kebijakan ketat.
Fallback yang peka keberadaan melalui optional. Ketika penulis Recipe perlu membedakan “kunci tidak ada” dari “kunci ada dengan nilai nol / kosong / false” — pembedaan yang tidak dapat dilakukan default milik Sprig — renderer menyediakan helper optional: {{ optional .infra "replicas" 1 }} mengembalikan infra.replicas yang ditulis (termasuk 0 yang ditulis) bila ada, dan beralih ke 1 hanya ketika kunci tidak ada. Lihat templates/sprig-functions.md untuk semantik lengkapnya.
Pelipatan nama melalui capitalizedWords. Ketika sebuah target hanya menerima huruf dan angka pada nama yang digunakannya untuk mengalamatkan sumber daya, {{ capitalizedWords .context.instance_id }} membaca id sebagai kata-kata yang dipisahkan oleh karakter apa pun di luar alfabet tersebut dan mengubah huruf pertama setiap kata menjadi kapital, sehingga payments-db menjadi PaymentsDb. Pelipatan ini membuang setiap pemisah, sehingga dua id yang hanya berbeda tanda bacanya menghasilkan satu nama yang sama; build yang akan mengeluarkan dua sumber daya dengan satu nama akan berhenti dan menyebutkan kedua id tersebut. Lihat templates/sprig-functions.md untuk semantik lengkapnya.
Penegakan kontrak parameter di lapisan deklarasi. Parameter wajib yang tidak disediakan Release menghasilkan galat eksplisit di lapisan kontrak parameter, hal pertama yang diperiksa resolusi, dengan provenans file:line yang menyebutkan parameter dan kontraknya. Pelanggaran tipe / batasan muncul dengan cara yang sama. Inilah penegakan kunci hilang yang sesungguhnya: tipe diperiksa di tempat maksud pengembang berada (deklarasi parameters: milik Aggregate), bukan pada saat evaluasi templat di hilir. Lihat entities/aggregate.md §“Kontrak parameter bertipe”.
Satu tata bahasa deklarasi untuk parameters: milik Aggregate. Setiap slot parameter ditulis sebagai objek kontrak bertipe (key: { type: <type>, default: <value>, ... }). Bentuk singkat skalar polos (key: <value>) ditolak di amplop dokumen Aggregate, dengan galat yang menyebutkan parameternya dan menyatakan bahwa yang diharapkan adalah sebuah objek. Kosakata kontrak bertipe membuat semantik type:, required:, dan batasan menjadi eksplisit di lapisan deklarasi; pemenuhan oleh Release tetap menggunakan nilai skalar sesuai tipe yang dideklarasikan kontrak.
Lihat templates/expansion-matrix.md untuk matriks evaluasi per situs templat dan 05-templates.md untuk ikhtisar templat.
Fase pipeline kompilasi
Pipeline kompilasi Aggrega didokumentasikan di ../architecture/10-compilation-pipeline.md. Status per fase:
- Resolusi, konstruksi topologi, finalisasi graf, analisis statis, dan perenderan — tersedia.
- Inject mapping (intersepsi pra-render
injectMapping) dan setiap subtahap perenderan dasar — publikasi locals, pemetaan nilai, sintesis workload, evaluasi artefak, render provider, perenderan feature, dan pembuatan sumber daya FeatureRecipe kredensial — tersedia. - Pipeline plugin (eksekusi Wasm
pipeline:) — tersedia. Pada Recipe atau FeatureRecipe yang mendeklarasikan langkahpipeline:yang tidak kosong, setiap langkah dieksekusi sesuai urutan yang dideklarasikan: kompiler menjalankan plugin Wasm yang dinamai langkah tersebut terhadap output yang dirender, menerapkan operasi JSON Patch yang dikembalikan ke dokumen yang dituju, dan mengeluarkan efek samping langkah tersebut. Langkah yang syaratwhen:-nya dirender sebagai falsy dilewati sebagai pass-through, sehingga kumpulan dokumen tidak berubah. Penulis yang menginginkan mutasi bergaya JSONPatch (injeksi sidecar Envoy, VolumeMount secret, dll.) mencapainya melalui permukaan ini.
Providers
Pustaka standar Aggrega menyertakan lima provider perenderan — helm, helm-chart, compose, terraform, dan cloudformation. Status per provider:
helm— tersedia. Mode dari sumber (perenderan chart Helm melalui SDK Helm) dan mode tersintesis (Workload → objek controller yang dipilih berdasarkanformmilik Workload — Deployment, StatefulSet, DaemonSet, Job, atau CronJob — ditambah Services dan PVC) keduanya sudah tersedia.helm-chart— tersedia. Mode dari sumber (komposisi umbrella chart) sudah tersedia. Jenis input tersintesis tidak berlaku untuk provider ini; penulis yang memerlukan sintesis manifest K8s menggunakan providerhelmdenganworkload:.compose— tersedia. Mode dari sumber (overlay fragmen compose) dan mode tersintesis (Workload → layanan compose + volume + jaringan) keduanya sudah tersedia. Outputdocker-compose.yamlper boundary dirakit melalui penyusun di tingkat Release.terraform— tersedia. Mode dari sumber dan artefak keduanya sudah tersedia; setiap boundary mendapat satu konfigurasi root,aggrega.modules.tf, yang mendeklarasikan setiap komponen sebagai blokmoduleyang berkas-berkasnya berada di direktorinya sendiri di bawahmodules/. Jenis input tersintesis tidak berlaku untuk provider ini.cloudformation— tersedia. Mode dari sumber dan artefak (fragmen stack) keduanya sudah tersedia; setiap komponen yang dirender ke satu direktori output dirakit menjadi satu templat stack, yang dikeluarkan sebagai JSON murni. Jenis input tersintesis tidak berlaku untuk provider ini.
Perenderan Provider dilayani oleh Plugin dengan pluginType: provider; lihat entities/plugin.md untuk permukaan penulisan Plugin perenderan provider dan 06-providers.md untuk halaman referensi per provider.
Ekspansi berbasis anotasi
Manifests membawa bagian binding features.annotations: yang memetakan kunci anotasi ke tipe Feature, ditambah tabel perutean yang dikelompokkan per pilar (maps.infra / maps.values) yang menyebutkan properti skema Feature mana yang boleh diisi oleh setiap binding. Didokumentasikan di entities/manifest.md dan providers/well-known-annotations.md; penempatan pipeline di ../architecture/10-compilation-pipeline.md; mekanisme saat pemuatan katalog dan saat inspeksi di ../architecture/13-catalog-and-registry.md §“Ekspansi Feature berbasis anotasi”.
- Binding
features.annotationsManifest — tersedia. Subtahap ekspansi anotasi dalam resolusi sudah tersedia dari awal hingga akhir. Subtahap ini menelusuri boundary Release (dari luar ke dalam) dan subsistem Aggregate (dari luar ke dalam), menghitung kumpulan anotasi efektif per komponen melalui kaskade + penimpaan dengan opt-out null untuk seluruh nilai dan per subkunci, mengurai setiap nilai anotasi sebagai skalar, map terstruktur, ataunulleksplisit, merutekan per subkunci melalui deklarasimapsmilik binding dengan penegakan sisi-terhadap-pilar (sisi Aggregate memicumaps.values; sisi Release memicumaps.infra), memvalidasi tipe setiap daun terhadapspec.schemamilik Feature target, dan menyuntikkan lampiran Feature sintetis yang ditandai graf IR denganorigin: annotation. Komposisi lintas sisi menggabungkan per pilar per bidang saat pembangunan IR dengan nilai eksplisit yang menang per bidang;aggrega inspectmenampilkan provenans dalam kurung untuk setiap daun. Validasi target binding saat pemuatan katalog, lint tumpang-tindih pilar skema, dan lint tumpang-tindih map binding menjaga jalur ini. Prefiks polosaggrega.ai/ditolak saat pemuatan Manifest bila digunakan sebagai kunci binding — prefiks tersebut dicadangkan untuk anotasi bawaan platform; binding menggunakanfeature.aggrega.ai/atau domain kustom.
Pencocokan versi
Recipes dan FeatureRecipes mendeklarasikan antarmuka Component atau Feature yang mereka implementasikan melalui kata kunci implements:. implements: tidak pernah memilih Recipe: pemetaan Manifest-lah yang memilih, dan instans yang tipenya tidak dicakup pemetaan mana pun berhenti dengan galat yang mencantumkan Recipes yang implements:-nya dapat mengimplementasikan tipe tersebut sebagai kandidat. Yang digerakkan implements: adalah pemeriksaan bahwa Recipe setiap entri pemetaan Manifest mengimplementasikan tipe yang dipetakan, atau basis yang di-extends oleh tipe tersebut. Tipe yang dipetakan adalah kunci entri dan, untuk kunci components.type, juga tipe setiap instans komponen yang dijangkau kunci itu pada versi yang tidak disebutkan kunci — setiap instans yang dijangkaunya, untuk kunci yang ditulis tanpa versi — pada versi yang digunakan build untuk mengompilasi instans tersebut: versi yang disebutkan instans, atau, untuk instans yang tidak menyebutkan versi, versi tertinggi Component tersebut yang dimiliki katalog. Status per bentuk:
- Persis (
core/api-server:1.0.0) — tersedia. Tipe yang dipetakan harus berversi tersebut. - Rentang yang kompatibel dengan versi mayor (
core/api-server:^1.0.0) — tersedia. Bentuk caret adalah batasan SemVer (>=1.0.0, <2.0.0untuk contoh ini); versi tipe yang dipetakan harus memenuhinya. - Tanpa versi (
core/api-server) — tersedia. Versi apa pun dari tipe tersebut memenuhinya.
Entri pemetaan yang implements: milik Recipe-nya tidak cocok dengan tipe yang dipetakan maupun basis mana pun darinya menghentikan build dengan OPS_ERROR yang menyebutkan entri, Recipe, dan nilai implements:-nya. Instans komponen yang dijangkau sebuah kunci pada versi lain, yang versinya tidak dipenuhi implements: milik Recipe, menghentikan build dengan OPS_ERROR yang sama, yang menyebutkan instans, tipenya — dan, untuk instans yang tidak menyebutkan versi, versi tempat instans itu dikompilasi — kunci, Recipe, dan nilai implements:-nya. Bentuk caret adalah permukaan penulisan kanonis untuk pencocokan yang kompatibel dengan versi mayor.
Lihat vocabulary/inheritance-and-interface.md untuk permukaan desain implements: dan entities/manifest.md untuk bentuk tingkat pemetaan per Manifest.
Amplop metadata
Amplop entitas katalog membawa metadata.labels, metadata.annotations, dan (pada Release) metadata.environment. Status per permukaan:
Ketersediaan metadata.labels dan metadata.annotations — pada tujuh jenis. Amplop entitas yang membawa bidang-bidang ini adalah Component (label wajib, dengan kunci wajib component.aggrega.ai/type, anotasi opsional), Feature (keduanya opsional), empat jenis pustaka SchemaLibrary, MappingLibrary, WorkloadLibrary, dan ArtifactLibrary (keduanya opsional), dan Aggregate (hanya label, opsional). Entitas lainnya — Recipe, FeatureRecipe, Manifest, Release, Plugin — tidak menerima metadata.labels atau metadata.annotations di tingkat amplop.
metadata.environment pada Release — wajib. Skema Release mencantumkan environment sebagai bidang metadata yang wajib; build mencap nilainya pada output yang dirender sebagai label aggrega.ai/environment. Lihat entities/release.md untuk lima kasus penggunaan praktis di bagian Environment Metadata (atribusi biaya OTel/FinOps, pemfilteran trace/log OTel, penargetan operator Kubernetes, diferensiasi produksi multi-region, penentuan cakupan kepatuhan).
Lihat 02-naming-conventions.md untuk disiplin penulisan huruf besar-kecil bidang yang berlaku pada kunci metadata, dan halaman referensi per entitas untuk bentuk amplop yang diterima setiap entitas saat ini.
Perintah CLI
CLI Aggrega mendaftarkan pipeline build ditambah introspeksi. Status per perintah:
aggrega build— tersedia. Membaca berkas Release, meresolusi Aggregate + Manifest, menjalankan pipeline kompilasi, dan menulis artefak yang dirender ke direktori output boundary. Bila lockfile ada, perintah ini memverifikasi dependensi terhadapnya; bila tidak ada, perintah ini berhenti dan meminta pull, atau mengisinya terlebih dahulu bila--auto-pullatauauto_pullmemintanya.aggrega inspect— tersedia. Memeriksa entitas katalog, berkas entitas, entitas yang dipublikasikan di registry, atau sebuah Release, dan melaporkan bentuknya yang telah diresolusi. Lihatcli/aggrega-inspect.md.aggrega pull— tersedia. Meresolusi semua dependensi sebuah Release dan menulis lockfile per Release yang menyematkan setiap entitas katalog dan artefak sumber ke sebuah versi dan digest konten, serta setiap input eksternal yang diminta oleh render Release ke sebuah digest konten; menyimpan konten yang diambil ke cache di bawah.aggrega/cache.--verifymemeriksa lockfile yang ada terhadap keadaan saat ini. Lihatcli/aggrega-pull.md.aggrega push— tersedia. Memublikasikan entitas katalog ke registry OCI;aggrega push --list-kindsmelaporkan jenis mana yang diterimanya. Lihatcli/aggrega-push.md.aggrega lint— tersedia. Menjalankan aturan disiplin publikasi dengan tingkat keparahanwarnpada seluruh katalog, closure dependensi sebuah Release, atau satu entitas; pada satu entitas,--pre-publishmenambahkan pemeriksaan kenaikan versi terhadap versi entitas yang saat ini dipublikasikan, dan ketidakcocokan menghentikan proses. Aturan-aturan ini disediakan sebagai plugin Wasm opsional. Lihatcli/aggrega-lint.md.aggrega serve— tersedia. Daemon compiler-as-service yang berjalan lama dan berkomunikasi dengan JSON-RPC 2.0 melalui stdin/stdout, untuk integrasi editor dan IDE. Lihatcli/aggrega-serve.mduntuk metode yang dilayaninya.aggrega version— tersedia. Mencetak versi CLI;-o jsonmengeluarkan objek versi yang dapat dibaca mesin.aggrega validate— tersedia. Memeriksa kebenaran di seluruh katalog, sebuah Release, atau satu entitas, dan melaporkan diagnostik tanpa merender artefak.aggrega search— tersedia. Mencari entitas yang dipublikasikan di indeks lokal registry yang dikonfigurasi; indeks dibangun dan diperbarui olehaggrega registry update.aggrega registry— tersedia. Mengelola registry dan kebijakan kepercayaan tanda tangannya;registry addmencatat sebuah registry, danregistry updatemembangun indeks lokal yang dikueri olehaggrega search.aggrega push-artifact— tersedia. Memublikasikan artefak data mandiri (seperti bundel dokumentasi) ke registry OCI, berdampingan denganpushyang memublikasikan entitas.aggrega sign— tersedia. Menandatangani satu atau beberapa artefak yang sudah dipublikasikan dan melampirkan tanda tangannya.aggrega deprecate— tersedia. Melampirkan penanda deprecation bertanda tangan ke artefak yang sudah dipublikasikan.aggrega logindanaggrega logout— tersedia. Melakukan autentikasi ke registry OCI dan menyimpan kredensial, atau menghapus kredensial yang tersimpan.aggrega auth— tersedia. Mengelola identitas penandatanganan lokal yang digunakan untuk menandatangani artefak.aggrega config— tersedia. Memeriksa dan mengelola konfigurasi workspace; subperintahnya menampilkan konfigurasi efektif hasil penggabungan beserta asal setiap pengaturan, menyiapkan konfigurasi yang berfungsi dengan sebuah registry dan kebijakan kepercayaan tanda tangannya, serta membekukan konfigurasi efektif yang penting bagi build ke dalam workspace agar build-nya identik tanpa bergantung pada konfigurasi global mesin.aggrega get-schema— tersedia. Mencetak JSON Schema untuk sebuah jenis entitas atau kontrak.aggrega plugin— tersedia. Memeriksa plugin Wasm yang dapat diresolusi CLI; subperintahnya mencantumkan plugin tersebut, menambah dan menghapus plugin yang dikonfigurasi, menyinkronkan catatan milik mesin dari sebuah plugin, dan menghasilkan tampilan katalognya.aggrega cache— tersedia. Memeriksa dan memelihara cache di disk; subperintahnya melaporkan status, memangkas, mengeluarkan entri, dan mengosongkan cache.aggrega mcp— tersedia. Menjalankan server Model Context Protocol melalui stdio, atau melalui HTTPS untuk klien di mesin lain, yang membuka introspeksi kompiler bagi integrasi asisten AI.aggrega completion— tersedia. Menghasilkan skrip pelengkapan otomatis shell untuk CLI.- Subperintah ekstensi CLI — tersedia. Plugin Wasm yang dipublikasikan sebagai guest
pluginType: clidiresolusi dan didaftarkan sebagai subperintahaggrega, sehingga ekstensi yang terpasang berjalan sebagaiaggrega <extension>berdampingan dengan perintah bawaan. aggrega import— tersedia. Mengubah sumber definisi agen deklaratif dari luar (Langflow, Flowise, n8n) menjadi draf berkas penulisan Aggregate dan Component, dengan keputusan penggunaan ulang katalog yang deterministik dan berskor keyakinan yang dicatat per node. Pemetaan khusus format disediakan oleh plugin importer yang diresolusi workspace untuk format sumber tersebut — plugin yang ada di katalognya, atau salah satu importer Langflow, Flowise, dan n8n milik kompiler, yang dibangun dan dipublikasikan bersama setiap rilis kompiler. Biner membawa entitas Plugin mereka tetapi tidak membawa modulnya, sehingga importer tersebut melayani formatnya di setiap workspace: impor pertama yang memerlukan importer yang belum dimiliki mesin akan mengambilnya dari registry default workspace, memverifikasinya, dan menyimpannya di cache konten untuk setiap impor berikutnya. Sebuah sumber diurai melalui parser yang disediakan katalog workspace untuk sintaksnya, atau, jika katalog tidak menyediakannya, melalui parser yang dibawa kompiler, sehingga workspace yang katalognya tidak memuat parser tetap dapat mengimpor melalui salah satunya.aggrega scaffold— tersedia. Menyusun draf dokumen awal untuk jenis entitas apa pun dari skema jenis tersebut — setiap bidang yang diwajibkannya, dengan placeholder di tempat yang memerlukan nilai — dan menuliskannya ke output standar; dengan--example, menulis salah satu contoh yang dapat dijalankan dari dokumentasi, yang dibaca dari bundel dokumentasi yang ditandatangani, ke direktori baru.aggrega explain— tersedia. Menjelaskan kondisi penghentian yang dinamai oleh kode pendek (sepertiE0007) atau kode deskriptif.aggrega edit-document— tersedia. Menerapkan satu suntingan terstruktur yang terbatas ke sebuah dokumen — menambahkan komponen, melampirkan Feature, menyambungkan koneksi, atau menetapkan satu nilai — dengan mempertahankan setiap byte yang tidak disentuhnya.aggrega pin— tersedia. Mencatat, dientity.lockdi samping Recipe atau FeatureRecipe, pin konten untuk setiap input yang dibaca entitas dari luar dokumennya sendiri.aggrega skills— tersedia. Memasang skill Aggrega ke asisten AI.
Lihat 07-cli.md untuk ikhtisar CLI dan indeks Referensi Bahasa untuk setiap halaman referensi per perintah.
Editor dan frontend lainnya
Setiap frontend menampilkan apa yang dikompilasi oleh binary aggrega; tidak ada yang membawa compiler sendiri. Status per permukaan:
- Kontrak graf IR — tersedia. Skema graf IR, kontrak yang menjadi acuan setiap frontend dalam membaca graf, disertakan sebagai bagian dari distribusi skema Aggrega; lihat referensi skema IR.
- Membaca graf dari perintah — tersedia.
aggrega buildmenerima--ir-graph, begitu pulaaggrega inspectyang diberi Release danaggrega validate --release; flag ini menulis graf hasil resolusi eksekusi tersebut ke stdout sebagai JSON, selain apa pun yang sudah dihasilkan perintah. Sesi daemon membaca graf yang sama diaggrega/irGraph, dan alatcli-inspect,cli-build, sertacli-validatemilik server MCP menerimanya sebagai argumenir_graph. - Graf topologi di Visual Studio Code — tersedia. Ekstensi Aggrega untuk Visual Studio Code menggambar graf IR dari Release yang dipilih sebagai graf interaktif dan melampirkan Features darinya, dengan meminta keduanya kepada daemon
aggrega serve. - Mode streaming headless CLI — direncanakan. Mode headless mengeluarkan graf IR sebagai JSON yang dipisahkan baris baru ke stdout untuk digunakan frontend seiring perubahan topologi. Yang tersedia saat ini adalah satu dokumen per pemanggilan, bukan stream: tidak ada perintah yang mengeluarkan rangkaian graf pada satu stdout seiring perubahan topologi.
Lihat ../architecture/15-editors-assistants-and-frontends.md untuk cara editor, asisten, dan daemon menjangkau compiler.
Arah desain
Taksonomi status di atas mengklasifikasikan keadaan per permukaan di seluruh bahasa; bagian ini mencatat status arah desain yang lebih luas yang didokumentasikan di bab-bab arsitektur.
Kepatuhan di seluruh lingkungan bukanlah arah yang direncanakan: menyatakan aturan tata kelola satu kali sehingga mengikat setiap build di workspace sudah tersedia saat ini melalui socket tata kelola. Plugin yang dipasang pada kunci plugins.governance di konfigurasi workspace mengevaluasi setiap build di workspace tersebut — peran putusan yang menolak graf atau artefak yang dirender yang melanggar aturan, dan peran transformasi yang menyediakan metadata turunan yang tidak pernah diketik pengembang. Lihat ../architecture/11-governance-and-compliance.md.
- Paritas antarmuka & implementasi otomatis — tersedia. Recipe yang ditulis untuk Component dasar melayani setiap Component yang memperluasnya, pada kedalaman rantai berapa pun, tanpa Architect perlu menulis Recipe duplikat. Component yang memperluas menulis
schema: inherited, sehingga tidak menambahkan kunci akar kevalues/infra/providesyang tidak dapat diproses Recipe milik dasar; Component yang mendeklarasikanextendsdengan skemanya sendiri ditolak di amplop dokumennya. Manifest tetap memetakan tipe yang memperluas dengan entrinya sendiri, dan pemeriksaan pemetaan menerimanya bilaimplementsmilik Recipe yang dipetakan menyebut tipe tersebut atau basis mana pun yang diperluasnya. Didokumentasikan di../architecture/02-ecosystem-philosophy.md. - Ghost Infrastructure Tracker — tersedia. Pengaman fase perenderan mengeluarkan peringatan ketika kunci yang dideklarasikan penulis mencapai sebuah node dan tidak ada templat yang dideklarasikan Recipe terikat yang membacanya, sehingga nilai yang dideklarasikan penulis dan diam-diam diabaikan oleh templat disebutkan alih-alih hilang. Ini adalah separuh fase perenderan dari desain pencocokan bentuk yang sama. Lihat
errors/warnings.md.
Bab-bab arsitektur menjelaskan permukaan desainnya; halaman ini melacak status implementasinya.