Skema Aggrega Workspace Config
Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.
Id skema: https://aggrega.ai/schemas/aggrega-config-v1beta1.schema.json
Berkas konfigurasi per-workspace yang digunakan oleh CLI aggrega. Berada di .aggrega-config.yaml. Blok workspace adalah penanda root: keberadaannya menandai root workspace, dan blok ini hanya memuat direktori katalog. Setiap kunci lainnya adalah pengaturan dan berada di tingkat atas, dalam kelas-kelas berikut — dari mana konten diambil, disematkan, dan di-cache (pemilihan registry, mode offline, perilaku auto-pull dan penyematan, lokasi serta batas ukuran cache artefak dan modul terkompilasi), bagaimana konten dipercaya (penandatanganan, dan perilaku verifikasi tanda tangan), seberapa ketat penulisan dinilai (pengatur lint per aturan, tingkat ketegasan deprekasi, dan petunjuk release penulisan), Plugins Wasm mana yang dipasang untuk seluruh workspace (governance, linter, importer, dan pengikatan provider-rendering per target), serta bagaimana CLI berjalan (konkurensi, serving, dan batas pengosongan parse-cache daemon). Properti di bawah ini adalah daftar yang lengkap dan otoritatif; ringkasan ini menyebutkan kelas-kelasnya, bukan kunci-kuncinya, sehingga penambahan kunci tidak dapat membuatnya keliru. Bentuk tingkat atas yang datar, tanpa amplop apiVersion/kind, berbeda dari konten katalog. Disiplin evolusi skema: menambahkan kunci tingkat atas baru merupakan kenaikan SemVer-MINOR (aditif); menghapus atau memindahkan kunci, atau memperketat batasan, merupakan perubahan yang merusak SemVer-MAJOR.
Jenis tingkat teratas: object
Properti
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
workspace | object | tidak | Penanda root workspace. Keberadaannya saja sudah menandai direktori sebagai root workspace; blok ini hanya memuat direktori katalog yang mendefinisikan root — milik workspace itu sendiri, dan direktori apa pun yang diberikan kepada sebuah Release sebagai miliknya sendiri. Setiap pengaturan yang tidak mendefinisikan root berada di tingkat teratas, bukan di sini. Tulis workspace: {} untuk menandai root tanpa direktori katalog yang di-vendor. |
default_registry | string | tidak | Registry OCI default tempat entitas dipublikasikan dan dependensi di-resolve ketika sebuah entitas tidak menyebutkan registry secara eksplisit: aggrega push memublikasikan ke sana dan aggrega pull mengambil dari sana. Default-nya hub.aggrega.ai. Tulis name dari sebuah entri di bawah registries, yang kemudian mewakili host entri tersebut; host itu sendiri; atau host yang diikuti / dan path repositori, seperti ghcr.io/acme atau harbor.example.com/platform. Nama dicocokkan terlebih dahulu: nilai yang merupakan name dari satu entri adalah host entri tersebut, bahkan jika nilai itu juga dieja seperti host, sehingga publikasi, penarikan, verifikasi tanda tangan, dan setiap pengaturan kepercayaan per registry menggunakan satu host tersebut; nilai yang menjadi nama dua entri ditolak karena ambigu, dan nama yang diikuti path ditolak, karena nama mewakili host sebuah entri dan bukan lokasi di bawahnya. Nilai lainnya harus berupa host, ditulis dengan ejaan yang digunakan untuk menyimpan kebijakan kepercayaannya: nama host huruf kecil yang mengandung titik (registry.example.com), localhost, satu nama yang diikuti port (registry:5000), alamat IPv4, atau alamat IPv6 dalam kurung siku ([::1]), masing-masing dengan :port opsional dan tanpa skema, kredensial, spasi, atau huruf kapital — secara opsional diikuti path repositori: satu segmen atau lebih yang terdiri dari huruf kecil dan angka, digabungkan dengan /, yang di dalam segmen dapat dipisahkan dengan ., _, __ atau tanda hubung, tanpa tag, digest, atau / di akhir. Path adalah tempat hal-hal dipublikasikan dan diambil: setiap entitas yang dipublikasikan melalui registry default dipublikasikan di bawah <host>/<path>/, dan setiap entitas yang di-resolve melaluinya diambil dari sana, sehingga apa yang dipublikasikan oleh satu pihak ditemukan oleh pihak lain. Path tidak pernah menjadi bagian dari cara sebuah registry dipercaya: entri registries yang kebijakannya berlaku, login, persyaratan penandatanganan, dan identitas tepercaya semuanya ditemukan berdasarkan host saja. Port 443 pada host yang dijangkau melalui HTTPS adalah port default host tersebut, dan menuliskannya ditolak, dengan menyebutkan ejaan yang harus ditulis tanpa port itu; localhost dan alamat loopback lainnya dijangkau melalui HTTP biasa, sehingga 443 adalah port biasa di sana dan tetap dipertahankan. Nilai kosong tidak menyebutkan registry default. Nilai ini dinilai saat konfigurasi dimuat, bukan oleh skema ini, karena entri yang dirujuk sebuah nama dapat dideklarasikan di file konfigurasi lain: nilai ini dibaca setelah setiap file konfigurasi dan variabel lingkungan AGGREGA_DEFAULT_REGISTRY, dan ditolak dengan kata-kata yang sama dari mana pun nilai itu ditetapkan, dengan menyebutkan file atau variabel tersebut. Flag --registry yang menyebutkan tujuan publikasi untuk satu pemanggilan dicocokkan dengan nama-nama entri dengan cara yang sama; nilai lain yang dibawanya dapat berupa referensi, dan host yang disebutkan referensi itu tunduk pada ejaan yang sama serta menjadi tempat publikasi berakhir, tanpa path repositori. Host dinilai berdasarkan ejaannya saja: apakah nama tersebut dapat di-resolve, atau apakah ada registry yang menjawab di sana, tidak diperiksa. Default: "hub.aggrega.ai" |
offline | boolean | tidak | Jika true, build tidak menghubungi registry apa pun; hanya artefak yang di-cache dan konten katalog yang di-vendor yang digunakan. Default-nya false. Default: false |
auto_pull | boolean | tidak | Jika false (default), aggrega build bersifat hanya-baca: perintah ini tidak pernah menulis pin sumber, dan lockfile per release yang hilang atau tidak lengkap menghentikan build secara tegas dengan diagnostik untuk menjalankan aggrega pull --release <release> terlebih dahulu. Jika true, aggrega build menjalankan langkah pull di dalam proses sebelum membangun — me-resolve dependensi Release ke dalam lockfile dan cache — sehingga build pertama terhadap sebuah Release tidak memerlukan langkah pull eksplisit. Opsi yang sama untuk satu build tersedia di baris perintah sebagai aggrega build --auto-pull; pull tetap menjadi satu-satunya penulis lockfile. offline: true tidak mematikan langkah pull: langkah itu berjalan atas apa yang sudah dimiliki mesin — cache dan direktori katalog lokal — tanpa menghubungi registry, dan referensi yang tidak dimiliki keduanya menghentikan build dengan penolakan dari pull itu sendiri yang menyebutkan referensi tersebut. Default: false |
pin_sources_at_pull | boolean | tidak | Jika false (default), pull tidak mencatat pin di samping entitas: atas sebuah Recipe atau FeatureRecipe di salah satu direktori katalog workspace ini yang dibangun oleh Release, pull berhenti ketika entity.lock di samping entitas tidak mencatat pin untuk setiap input yang dibaca entitas — source: jarak jauh yang koordinatnya ditulis lengkap, file yang diimpor oleh entri artifacts, atau setiap file dari source: lokal di samping entitas — dengan menyebutkan entitas, setiap input beserta kelasnya, dan aggrega pin sebagai langkah yang mencatatnya. Pinning adalah langkah penulis entitas, sehingga entitas yang belum di-pin oleh siapa pun belum siap dikonsumsi. Jika true, setiap pull di workspace ini menjalankan langkah tersebut sebagai gantinya, atas entitas yang sama, dengan menulis byte entity.lock yang sama dengan yang ditulis aggrega pin; dengan cara inilah workspace yang mengonsumsi entitas yang belum di-pin oleh pihak lain mencatat pin-nya sekali alih-alih berhenti. Build yang mengisi lockfile-nya sendiri adalah pull dan mengikuti pengaturan ini. aggrega pull --pin-sources melakukan pin untuk satu pemanggilan dan --pin-sources=false berhenti untuk satu pemanggilan, apa pun isi pengaturan ini. Entitas yang di-resolve dari cache, bukan dari direktori katalog, tidak memiliki tempat untuk menulis lock dan tidak pernah di-pin atau dihentikan oleh pull. Default: false |
pin_sources_at_push | boolean | tidak | Jika true, setiap aggrega push di workspace ini menjalankan langkah pin penulis entitas pada entitas yang dipublikasikannya sebelum membundelnya, sehingga entity.lock yang ditulis langkah tersebut di samping entitas menjadi bagian dari apa yang dipublikasikan; jika false (default), push tidak menjalankan langkah pin dan menolak Recipe atau FeatureRecipe yang entity.lock-nya tidak mencatat setiap pin yang akan dicatat langkah itu, dengan menyebutkan aggrega pin. Langkah ini menulis di samping entitas, sehingga hanya berjalan di tempat entitas memiliki lokasi yang dapat ditulisi, yang selalu dimiliki push: push memublikasikan entitas yang disebutkan oleh dokumennya. aggrega push --pin-sources melakukan pin untuk satu pemanggilan dan --pin-sources=false tidak, apa pun isi pengaturan ini. Langkahnya sama dengan yang dijalankan aggrega pin, dengan menulis byte yang sama. Default: false |
artifact_cache_dir | string | tidak | Direktori cache artefak/konten lokal (hasil pull registry, manifest OCI, fixture yang dikompilasi). Default-nya .aggrega/cache. Menurut konvensi, sebaiknya dimasukkan ke gitignore. Path ditafsirkan relatif terhadap root workspace, dari mana pun perintah dijalankan; nilai absolut ditolak saat konfigurasi dimuat, karena setiap pembaca pengaturan ini me-resolve-nya terhadap root tersebut dan path absolut akan menyebutkan lokasi yang tidak pernah mereka jangkau. Cache boleh berada di dalam direktori katalog — default-nya demikian, karena direktori katalog umumnya adalah root workspace — tetapi cache tidak boleh MENJADI direktori katalog: pemindaian katalog melewati cache, sehingga nilai yang menyebutkan direktori katalog mengeluarkan seluruh isi direktori itu dari pemindaian. Nilai yang menyebutkan root workspace itu sendiri (., atau ejaan apa pun yang tereduksi menjadi itu) ditolak saat konfigurasi dimuat, tepat karena alasan tersebut. Nilai yang menyebutkan direktori katalog lain tidak ditolak: nilai itu dimuat tanpa masalah lalu pemindaian tidak menemukan apa pun di direktori tersebut, sehingga memastikan cache berada di luar direktori yang tercantum di workspace.catalog_dirs menjadi tanggung jawab Anda. Berbeda dari parse_cache, yang membatasi cache parse dalam memori milik daemon, dan dari compiled_module_cache, yang membatasi penyimpanan modul terkompilasi untuk seluruh mesin. Default: ".aggrega/cache" |
skip_signature_verification | boolean | tidak | Penonaktifan verifikasi tanda tangan secara global dan terang-terangan. Jika true, verifikasi tanda tangan dinonaktifkan di semua registry, termasuk baseline wajib hub. Ditujukan untuk skenario darurat (break-glass) dan pengembangan; penonaktifan ini tidak pernah senyap — di mana pun pull seharusnya memeriksa tanda tangan, pull memperingatkan bahwa verifikasi dinonaktifkan secara global. Bawaannya false. Bawaan: false |
build | object | tidak | Pengatur tingkat keketatan saat build dan petunjuk penulisan. authoring_release memberi LSP petunjuk current Release untuk diagnostik inline; halt_on_deprecated_severity mengatur cara build bereaksi terhadap penggunaan entitas yang usang; yaml_indent menetapkan lebar indentasi setiap artefak YAML yang dirender. |
plugins | object | tidak | Lampiran Wasm plugin tingkat workspace. Setiap soket (governance, linter, importer) menerima array referensi plugin; build memanggil fungsi entri terdokumentasi setiap plugin sesuai kontrak soketnya. Daftar providers mengikat kapabilitas ke plugin perenderan provider yang melayaninya. |
lint | object | tidak | Pengaturan tingkat keketatan per aturan. |
parse_cache | object | tidak | Batas pengusiran cache parse daemon. Kedua batas berlaku bersamaan — loop pengusiran LRU berjalan setelah setiap penyisipan ke cache dan menghapus entri yang paling lama tidak digunakan hingga jumlah entri maupun total byte berada dalam batas. Nilai nol pada salah satunya berarti unbounded on that axis, berguna untuk skenario CI ketika cache hanya hidup selama satu pemanggilan. Berbeda dari artifact_cache_dir, yang merupakan cache konten di disk. |
compiled_module_cache | object | tidak | Batas ukuran cache modul terkompilasi di disk, yaitu penyimpanan kode mesin yang digunakan ulang oleh compiler sehingga sebuah Wasm plugin dikompilasi sekali per mesin, bukan sekali per build. Cache ini dibagi oleh semua workspace di mesin tersebut, sehingga kunci ini sebaiknya ditempatkan di file konfigurasi global jika Anda menginginkan satu nilai untuk seluruh mesin. Batas diterapkan sekali per pemanggilan, sebelum plugin apa pun dimuat, dengan menghapus entri utuh mulai dari yang paling lama dikompilasi hingga sisanya muat — tidak pernah saat build sedang mengompilasi. Menghapus entri hanya berakibat kompilasi ulang di kemudian hari, sehingga batas ini aman untuk diturunkan. aggrega cache status melaporkan ukuran penyimpanan saat ini, dan aggrega cache evict --max-size memangkasnya sesuai permintaan hingga batas yang diberikan di baris perintah. Berbeda dari artifact_cache_dir (konten registry yang ditarik) dan dari parse_cache (cache parse daemon di memori). |
concurrency | object | tidak | Pengaturan konkurensi pengiriman permintaan daemon. Daemon membaca permintaan dari satu aliran stdin dan menjalankan masing-masing melalui kumpulan worker yang menguras antrean permintaan terbatas; respons dikeluarkan sesuai urutan kedatangan permintaan, terlepas dari urutan penyelesaiannya. |
serve | object | tidak | Pengaturan perilaku daemon (aggrega serve) untuk compiler-sebagai-layanan yang digunakan oleh integrasi IDE. |
mcp | object | tidak | Pengaturan untuk server Model Context Protocol (aggrega mcp). transport memilih cara server dijangkau — melalui input dan output standar proses, atau melalui HTTP — dan dibaca apa pun pilihannya. announce_tools juga dibaca pada kedua transport, karena alat mana yang ditawarkan kepada klien merupakan properti server, bukan cara klien menjangkaunya. Setiap kunci lainnya mengonfigurasi listener yang dimulai oleh transport HTTP dan tidak digunakan selama server berkomunikasi melalui input dan output standar — termasuk listen, yang dibaca di sana hanya agar server dapat menyatakan, dalam satu baris di aliran error-nya, bahwa alamat tersebut tidak digunakan. Setiap kunci di bawah menyatakan termasuk yang mana. Berbeda dari serve, yang mengonfigurasi daemon backend editor. |
registries | RegistryConfig[] | tidak | Pengaturan per registry dan kebijakan kepercayaan tanda tangan, dengan kunci berupa host registry. Registry yang tidak tercantum di sini menggunakan nilai bawaan: tanda tangan yang ada diverifikasi dan tanda tangan yang tidak ada ditoleransi, kecuali untuk hub.aggrega.ai, yang baseline tertanamnya mewajibkan tanda tangan terverifikasi bahkan tanpa entri eksplisit. Entri eksplisit untuk sebuah host menimpa baseline host tersebut. Bawaan: [] |
signing | SigningConfig | tidak | Blok penandatanganan tingkat atas, berlaku untuk semua registry: URL layanan keyless, path kunci opsional untuk mode berkunci, dan sikap kepercayaan untuk semua registry (required dan kinds). Blok signing per registry menimpa nilai bawaan endpoint untuk host tersebut dan membawa sikap required/kinds yang sama dengan cakupan host tersebut — satu nama, satu tugas, cakupan ditentukan oleh penempatan. Kebijakan required/kinds tingkat atas tersusun secara monoton di sepanjang kaskade konfigurasi. Keamanan: blok ini tidak menyimpan materi rahasia — token identitas OIDC tidak pernah menjadi field konfigurasi (token diberikan saat runtime melalui flag atau lingkungan OIDC sekitar) dan key_path adalah path ke file kunci, tidak pernah byte kunci inline. |
Properti tambahan tidak diizinkan.
aggrega-config.workspace
Penanda root workspace. Keberadaannya saja sudah menandai direktori sebagai root workspace; blok ini hanya memuat direktori katalog yang mendefinisikan root — milik workspace itu sendiri, dan direktori apa pun yang diberikan kepada sebuah Release sebagai miliknya sendiri. Setiap pengaturan yang tidak mendefinisikan root berada di tingkat teratas, bukan di sini. Tulis workspace: {} untuk menandai root tanpa direktori katalog yang di-vendor.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
catalog_dirs | string[] | tidak | Direktori katalog opsional tempat workspace ini membaca entitas lokal, yang dikonsultasikan sebelum beralih ke registry. Setiap entri adalah path sistem berkas, yang di-resolve relatif terhadap berkas yang mendeklarasikannya. Daftar ini adalah tumpukan pencarian berurutan dengan prinsip yang pertama menang: direktori yang paling awal tercantum yang mendeklarasikan sebuah identitas menjadi pemiliknya, dan identitas yang sama di direktori berikutnya akan dibayangi. Direktori catalog di root workspace juga dibaca, setelah setiap entri yang tercantum dan hanya jika direktori itu ada — kecuali jika sebuah entri yang tercantum sudah memuatnya, dalam hal ini direktori itu dibaca sebagai bagian dari entri tersebut — sehingga mencantumkan sebuah direktori menambah apa yang sudah dibaca workspace, bukan menggantikannya. Menghilangkan kunci ini dan menuliskannya sebagai daftar kosong adalah dua pernyataan yang berbeda: jika dihilangkan, workspace tetap membaca catalog; jika ditulis sebagai [], workspace tidak membaca katalog lokal sama sekali, dan begitulah sebuah workspace menyatakan bahwa ia tidak memilikinya. Sebuah Release yang diberi direktori katalognya sendiri di bawah releases membaca direktori tersebut sebagai pengganti daftar ini. Berlingkup root: direktori katalog lokal milik root workspace ini, sehingga berada pada penanda root, bukan di tingkat teratas. |
catalog_dirs_append | string[] | tidak | Tambahan opsional yang hanya menambahkan ke daftar catalog_dirs yang berlaku. Pada setiap lapisan prioritas, entri di sini digabungkan ke daftar dasar yang telah di-resolve, sehingga konfigurasi workspace dan global dapat menyusun direktori katalog alih-alih saling membayangi. Interaksi pada lapisan yang sama: jika catalog_dirs dan catalog_dirs_append sama-sama ditentukan pada satu lapisan, nilai yang di-resolve pada lapisan itu adalah daftar dasar diikuti daftar tambahan. Default: [] |
releases | map dari ReleaseCatalogConfig | tidak | Direktori katalog opsional milik sebuah Release sendiri, untuk workspace yang menyimpan beberapa varian katalog berdampingan dan membangun setiap Release terhadap salah satunya. Setiap kunci adalah berkas Release, yang ditulis sebagai path relatif terhadap berkas yang mendeklarasikannya; setiap nilai membawa catalog_dirs dan catalog_dirs_append dengan makna yang sama seperti pada blok ini, dengan lingkup satu Release tersebut. Release yang disebut di sini membaca catalog_dirs miliknya sendiri sebagai pengganti daftar blok ini, diikuti catalog_dirs_append miliknya sendiri; entri yang menghilangkan catalog_dirs mempertahankan daftar blok ini dan menambahkan catalog_dirs_append miliknya setelahnya. Urutan pencarian, direktori catalog di root workspace, dan makna daftar kosong sama seperti untuk daftar blok ini sendiri, dan Release yang tidak disebut dalam map ini membaca daftar blok ini persis seperti sebelumnya. Release membaca direktori ini bagaimanapun ia dibangun — di terminal, dari editor melalui aggrega serve, atau melalui aggrega mcp — dan direktori --catalog tetap dicari lebih dahulu untuk satu pemanggilan. Entri yang menyebut berkas yang tidak ada ditolak saat konfigurasi dimuat, dengan menyebut entri dan berkasnya, sehingga mengganti nama sebuah Release tidak dapat diam-diam mengubah katalog yang menjadi dasar pembangunannya. Di seluruh berkas konfigurasi, entri setiap Release tersusun dengan cara yang sama seperti kunci-kunci blok ini sendiri: catalog_dirs dari berkas yang lebih dekat untuk Release itu menggantikan milik berkas yang lebih jauh, dan catalog_dirs_append dari setiap berkas untuk Release itu ditambahkan sesuai urutan kaskade. AGGREGA_CATALOG_DIRS menetapkan daftar blok ini dan tidak memengaruhi entri apa pun di sini. Operasi yang tidak menyangkut satu Release tertentu — lint atau validasi seluruh katalog, pencarian entitas berdasarkan nama, atau daftar entitas workspace pada editor — membaca daftar blok ini, bukan direktori-direktori ini. |
Properti tambahan tidak diizinkan.
aggrega-config.build
Pengatur tingkat keketatan saat build dan petunjuk penulisan. authoring_release memberi LSP petunjuk current Release untuk diagnostik inline; halt_on_deprecated_severity mengatur cara build bereaksi terhadap penggunaan entitas yang usang; yaml_indent menetapkan lebar indentasi setiap artefak YAML yang dirender.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
authoring_release | string | tidak | Path ke berkas YAML Release yang diperlakukan LSP sebagai konteks current Release untuk diagnostik inline. Opsional. |
yaml_indent | integer | tidak | Lebar indentasi (dalam spasi) untuk setiap artefak YAML yang dirender — berkas docker-compose, templat dan values chart Helm, serta manifest Kubernetes. Default-nya 2, lebar konvensional untuk format-format tersebut. Minimum: 2. Maksimum: 9. Default: 2 |
halt_on_deprecated_severity | string (enum) | tidak | Tingkat keparahan, dalam himpunan berurutan warning < error < retracted, yang pada tingkat itu atau di atasnya sebuah penanda deprekasi yang tercatat menghentikan build. Pengaturan ini mengatur kedua tempat penanda dicatat: lockfile, untuk semua yang direproduksi build secara byte demi byte, dan catatan kepercayaan plugin di sampingnya, untuk plugin yang dipasang dalam peran yang mengembalikan putusan terima-atau-tolak — pemasangan plugins.governance pada ir-verdict atau render-verdict, dan setiap pemasangan plugins.linter. Satu pengaturan, satu aturan, kedua penyimpanan. Tidak ditetapkan secara default, dan tidak ditetapkan berarti tidak ada penanda tercatat yang menghentikan build: penanda dicatat terhadap versi yang sudah Anda pin, sehingga build yang pernah berhasil tetap berhasil. Pemberitahuan dan resolusi adalah dua sumbu terpisah dan keduanya bukan pengaturan ini. Setiap permukaan yang membaca salah satu catatan melaporkan setiap referensi deprekasi yang di-pin-nya dan setiap plugin tepercaya yang membawa penanda — pada setiap tingkat keparahan — dengan menyebut namanya, tingkat keparahannya, dan pesannya: aggrega build, aggrega validate --release, aggrega lint --release, daemon untuk editor, serta alat build, describe, dan validate yang AI-native. Jadi, menaikkan ambang ini tidak pernah mengurangi apa yang diberitahukan kepada Anda. Pengaturan ini hanya mengatur build: pengaturan ini menghentikan aggrega build (dan alat build AI-native, yang merupakan operasi yang sama), sementara permukaan pelaporan menyebut penanda tersebut dan terus berjalan. Hanya penanda retracted yang memengaruhi versi mana yang menjadi hasil resolusi sebuah referensi, dan hal itu terjadi saat aggrega pull memilih versi, bukan saat build. Nilai yang diizinkan: "warning", "error", "retracted" |
Properti tambahan tidak diizinkan.
aggrega-config.plugins
Lampiran Wasm plugin tingkat workspace. Setiap soket (governance, linter, importer) menerima array referensi plugin; build memanggil fungsi entri terdokumentasi setiap plugin sesuai kontrak soketnya. Daftar providers mengikat kapabilitas ke plugin perenderan provider yang melayaninya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
governance | PluginRef[] | tidak | Plugin soket governance. Setiap entri menyebutkan role pipeline tempat plugin dilampirkan (annotation-transform, label-transform, ir-verdict, atau render-verdict); role tersebut menetapkan apa yang boleh dikeluarkan plugin sekaligus fungsi entri bawaannya (annotation-transform → transform_annotations; label-transform → mutate; ir-verdict → verdict_ir; render-verdict → verdict_render). Bawaan: [] |
governance_append | PluginRef[] | tidak | Tambahan khusus-append pada daftar governance efektif. Entri di sini digabungkan ke daftar dasar yang telah diresolusi pada setiap lapisan prioritas, sehingga konfigurasi workspace dan global dapat menyusun lampiran governance alih-alih saling membayangi. Bawaan: [] |
linter | PluginRef[] | tidak | Plugin soket linter. Fungsi entri bawaan: lint_rules. Ekspor plugin linter wajib diawali dengan lint_, sehingga function: pada salah satu entri ini menyebutkan ekspor dengan awalan tersebut. Bawaan: [] |
linter_append | PluginRef[] | tidak | Tambahan khusus-append pada daftar linter efektif. Semantik susun-tanpa-membayangi yang sama dengan governance_append. Bawaan: [] |
importer | FixedEntryPluginRef[] | tidak | Plugin soket importer. Soket memanggil fungsi entri import; lampiran tidak menyebutkannya. Bawaan: [] |
importer_append | FixedEntryPluginRef[] | tidak | Tambahan khusus-append pada daftar importer efektif. Semantik susun-tanpa-membayangi yang sama dengan governance_append. Bawaan: [] |
providers | FixedEntryPluginRef[] | tidak | Pemilihan provider per kapabilitas. Setiap entri mengikat satu kapabilitas provider (nama kapabilitas polos yang diikat sebuah Recipe melalui spec.capability, mis. helm atau compose) ke identitas polos plugin perender provider yang melayaninya (identitas entitas Plugin, yaitu metadata.pluginType dan metadata.name yang digabungkan dengan garis miring, mis. provider/helm), dengan :version di akhir yang opsional dalam tiga bentuk yang sama seperti pin versi (polos, persis :1.0.0, atau rentang kompatibel-mayor :^1.0.0). Ini adalah permukaan disambiguasi dan penimpaan untuk katalog terfederasi tempat lebih dari satu plugin provider melayani kapabilitas yang sama: pengikatan memilih plugin milik penerbit mana yang merender kapabilitas tersebut. Jika suatu kapabilitas dilayani oleh tepat satu plugin provider, tidak diperlukan entri. Tepat satu entri per kapabilitas diizinkan di seluruh daftar yang tersusun; kapabilitas duplikat menghentikan resolusi secara tegas. Resolusi terjadi saat pull: pull mencatat pengikatan yang diresolusi ke dalam lockfile per Release, dan build membaca lockfile — perubahan di sini setelah pull tidak diadopsi hingga pull berikutnya, sehingga keluaran build tidak berubah olehnya (keluaran deterministik). Setiap build dan setiap validasi sebuah Release juga memeriksa setiap entri di sini, baik ada maupun tidak Recipe yang meminta kapabilitasnya: entri yang menyebutkan plugin yang dimiliki build tetapi tidak melayani kapabilitas entri tersebut akan menghentikan proses, dengan menyebutkan apa yang dilayani plugin itu serta ejaan yang berjarak satu suntingan bila ada; entri yang menyebutkan kapabilitas tanpa plugin, ketika tidak ada plugin provider yang dibaca build yang melayani kapabilitas itu, dilaporkan sebagai peringatan alih-alih menghentikan proses, karena plugin yang melayaninya mungkin hanya dibaca oleh Release lain; dan entri untuk kapabilitas yang dilayani suatu plugin tetapi tidak pernah diminta oleh Release ini sah dan tidak dilaporkan apa pun, karena entri ditulis untuk seluruh workspace sedangkan build adalah untuk satu Release. capability yang mengandung titik dua ditolak saat konfigurasi dimuat: spec.capability sebuah Recipe dibaca sebagai kapabilitas hingga titik dua terakhirnya dan pin versi sesudahnya, sehingga tidak ada Recipe yang dapat mencapai entri seperti itu. Entri yang hilang untuk kapabilitas yang dilayani secara tidak ambigu bukanlah kesalahan; entri yang hilang untuk kapabilitas yang dilayani secara ambigu menghentikan pull secara tegas, dengan mencantumkan plugin kandidat. Koeksistensi versi tetap terjaga: pengikatan memilih repositori plugin per kapabilitas, dan pin versi spec.capability milik setiap Recipe memilih versi di dalam repositori tersebut, sehingga dua Recipes yang mem-pin versi berbeda dari satu provider tetap dapat berdampingan. Bawaan: [] |
providers_append | FixedEntryPluginRef[] | tidak | Tambahan khusus-append pada daftar providers efektif. Entri di sini digabungkan ke daftar dasar yang telah diresolusi pada setiap lapisan prioritas, sehingga konfigurasi workspace dan global dapat menyusun pengikatan provider alih-alih saling membayangi. Semantik susun-tanpa-membayangi yang sama dengan governance_append. Aturan satu-entri-per-kapabilitas berlaku pada daftar yang tersusun, sehingga entri tambahan yang menyebutkan kapabilitas yang sudah diikat oleh lapisan lebih rendah menghentikan resolusi secara tegas. Bawaan: [] |
cli | CLIPluginRef[] | tidak | Plugin ekstensi CLI yang dipasang sebagai perintah aggrega tingkat atas. Setiap entri mem-pin satu plugin CLI berdasarkan referensi artefaknya yang telah diresolusi dan di-pin versinya, serta digest konten byte guest yang menjadi hasil resolusi referensi tersebut saat pemasangan. Berbeda dengan empat daftar soket lintas-bidang, yang daftar dasarnya diganti seluruhnya di sepanjang kaskade konfigurasi, daftar CLI tersusun: plugin CLI dalam konfigurasi global mendaftarkan perintahnya di setiap workspace, plugin dalam konfigurasi workspace hanya terdaftar di proyek itu, dan keduanya terdaftar bersama — sehingga daftar ini tidak memerlukan pendamping _append. Nama perintah dan bantuan yang disumbangkan setiap plugin berasal dari deskripsi diri plugin itu sendiri, dibaca dari cache describe di disk yang dikunci oleh digest (memuat guest menjadi cadangan saat cache kosong); daftar hanya membawa pin. Saat perintah dipanggil, byte yang diresolusi di-hash ulang dan dibandingkan dengan digest; ketidakcocokan menghentikan perintah secara tegas dan menginstruksikan pin ulang, sehingga plugin yang byte-nya berubah sejak di-pin tidak pernah berjalan tanpa diketahui. Bawaan: [] |
Properti tambahan tidak diizinkan.
aggrega-config.lint
Pengaturan tingkat keketatan per aturan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
publishing_discipline | object | tidak | Gerbang tingkat workspace untuk kumpulan aturan publishing-linter. Flag allow_* melonggarkan masing-masing pemeriksaan discouragement. Imutabilitas artefak tidak dapat dikonfigurasi di sini: aggrega push menolak menimpa versi yang telah diterbitkan tanpa syarat. |
Properti tambahan tidak diizinkan.
aggrega-config.lint.publishing_discipline
Gerbang tingkat workspace untuk kumpulan aturan publishing-linter. Flag allow_* melonggarkan masing-masing pemeriksaan discouragement. Imutabilitas artefak tidak dapat dikonfigurasi di sini: aggrega push menolak menimpa versi yang telah diterbitkan tanpa syarat.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
allow_dynamic_refs | boolean | tidak | Jika true, publishing-linter menerima konstruksi JSON Schema $dynamicRef / $dynamicAnchor dalam konten katalog. Default false; konstruksi ini tidak dianjurkan karena membuat komposisi skema saat kompilasi menjadi non-lokal. Default: false |
allow_id_overrides | boolean | tidak | Jika true, publishing-linter menerima override $id pada subskema di dalam konten skema sebuah entitas. Default false; override $id melanggar konvensi satu-pengenal-kanonis-per-skema yang diandalkan oleh resolver dan validator JSON Schema. Default: false |
allow_direct_x_aggrega_extensions | boolean | tidak | Jika true, pemeriksaan discouragement saat build menerima kata kunci x-aggrega-selector dan x-aggrega-inject yang ditulis langsung dalam konten skema. Default false; jalur penulisan yang direkomendasikan adalah usesSchema (untuk soket dependensi) atau featuresSchema (untuk pengikatan kredensial), yang kemudian disusun oleh kompiler menjadi kata kunci tersebut. Default: false |
allow_aggrega_ai_prefix | boolean | tidak | Jika true, publishing-linter menerima kunci anotasi yang menggunakan namespace cadangan aggrega.ai/ dan feature.aggrega.ai/ di luar konteks kanonisnya. Aturan prefiks cadangan mengawasi metadata.annotations entitas katalog: prefiks aggrega.ai/ polos bersifat bawaan platform (kunci anotasi yang sudah dikenal dikecualikan terlepas dari flag ini); prefiks feature.aggrega.ai/ kanonis hanya pada kind Feature. Default false. Operator menyetel ini ketika perangkat enterprise memang perlu menggunakan prefiks cadangan; flag ini melonggarkan kedua prefiks sekaligus. Default: false |
allow_nonstandard_names | boolean | tidak | Jika true, publishing-linter menerima nama entitas katalog yang tidak mengikuti konvensi penamaan yang didokumentasikan proyek. Default false; penamaan yang konsisten sangat penting bagi resolver, pemilihan label, dan kenyamanan peninjau. Default: false |
allow_category_mismatches | boolean | tidak | Jika true, publishing-linter menonaktifkan aturan category-matches-directory. Konvensi katalog standar mengharuskan Components di bawah core/false |
allow_undeclared_recipe_provides | boolean | tidak | Jika true, publishing-linter menonaktifkan aturan provides-declared-by-component. Aturan itu melaporkan setiap kunci yang dipublikasikan sebuah Recipe dalam spec.provides yang tidak dideklarasikan oleh Component yang dinamai spec.implements-nya dalam pilar provides dari spec.schema-nya. Keduanya adalah permukaan yang terpisah: apa yang dipublikasikan Recipe adalah nilai yang diterima konsumen, sedangkan apa yang dideklarasikan Component adalah kontrak keluaran yang menjadi acuan pemeriksaan referensi inject from: — sehingga kunci yang dipublikasikan tanpa dideklarasikan membuat referensi semacam itu berhenti. Recipe yang memublikasikan lebih dari yang dideklarasikan Component-nya selain itu tetap diterima saat build, itulah sebabnya temuan ini bersifat anjuran, bukan penolakan publikasi. Default false. Default: false |
allow_connection_credential_mismatches | boolean | tidak | Jika true, publishing-linter menonaktifkan aturan connection-credential-matches-target-key, yang dijalankan aggrega lint --release atas Release yang dinamainya: Release tersebut, Aggregate yang di-deploy-nya, dan Components yang digunakan instans Aggregate itu. Untuk setiap koneksi yang targetnya mendeklarasikan kunci yang diwajibkannya dari pemanggil, aturan ini membandingkan apa yang dirujuk kedua ujung: kredensial yang disajikan koneksi dan kunci yang dipegang target di slotnya sendiri. Aturan ini melaporkan dua ujung yang menamai secret berbeda, dan kunci yang dideklarasikan di satu ujung saja, dan tidak pernah mengutip keduanya. Tidak ada ujung yang dapat melihat lampiran ujung lainnya, sehingga keduanya hanya selaras melalui disiplin penulisan — biasanya satu parameter yang mengisi keduanya — dan build menerimanya dalam kedua keadaan, itulah sebabnya temuan ini bersifat anjuran. Workspace yang kedua ujungnya sengaja berbeda memilih keluar di sini. Default false. Default: false |
Properti tambahan tidak diizinkan.
aggrega-config.parse_cache
Batas pengusiran cache parse daemon. Kedua batas berlaku bersamaan — loop pengusiran LRU berjalan setelah setiap penyisipan ke cache dan menghapus entri yang paling lama tidak digunakan hingga jumlah entri maupun total byte berada dalam batas. Nilai nol pada salah satunya berarti unbounded on that axis, berguna untuk skenario CI ketika cache hanya hidup selama satu pemanggilan. Berbeda dari artifact_cache_dir, yang merupakan cache konten di disk.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
max_entries | integer | tidak | Batas jumlah hasil parse yang di-cache. Default 1000. 0 menonaktifkan sumbu jumlah entri (tidak ada eviction yang dipicu oleh jumlah entri). Minimum: 0. Default: 1000 |
max_bytes | integer | tidak | Batas ukuran kumulatif, dalam byte, dari dokumen yang ditampung cache. Default 100000000 (100 MB). 0 menonaktifkan sumbu byte (tidak ada eviction yang dipicu oleh total byte). Minimum: 0. Default: 100000000 |
Properti tambahan tidak diizinkan.
aggrega-config.compiled_module_cache
Batas ukuran cache modul terkompilasi di disk, yaitu penyimpanan kode mesin yang digunakan ulang oleh compiler sehingga sebuah Wasm plugin dikompilasi sekali per mesin, bukan sekali per build. Cache ini dibagi oleh semua workspace di mesin tersebut, sehingga kunci ini sebaiknya ditempatkan di file konfigurasi global jika Anda menginginkan satu nilai untuk seluruh mesin. Batas diterapkan sekali per pemanggilan, sebelum plugin apa pun dimuat, dengan menghapus entri utuh mulai dari yang paling lama dikompilasi hingga sisanya muat — tidak pernah saat build sedang mengompilasi. Menghapus entri hanya berakibat kompilasi ulang di kemudian hari, sehingga batas ini aman untuk diturunkan. aggrega cache status melaporkan ukuran penyimpanan saat ini, dan aggrega cache evict --max-size memangkasnya sesuai permintaan hingga batas yang diberikan di baris perintah. Berbeda dari artifact_cache_dir (konten registry yang ditarik) dan dari parse_cache (cache parse daemon di memori).
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
max_bytes | integer | tidak | Batas byte yang ditampung cache modul terkompilasi di disk. Default 53687091200 (50 GiB), sebuah plafon yang mencegah pertumbuhan tanpa batas, bukan anggaran yang dimaksudkan untuk terasa — satu plugin terkompilasi mencapai ratusan megabyte, sehingga mesin yang membangun banyak versi plugin menumpuk gigabyte. Setel di atas apa yang dikompilasi satu build: batas diterapkan sebelum build mengompilasi apa pun, sehingga batas di bawah working set satu build membuat setiap build membuang dan mengompilasi ulang modul yang sama, dan penyimpanan tidak lagi menghemat apa pun. Karena batas diterapkan terlebih dahulu lalu build menulis apa yang dikompilasinya, penyimpanan dapat berada di atas batas di antara build; penyimpanan dipangkas lagi di awal build berikutnya. 0 menonaktifkan batas (penyimpanan tumbuh tanpa batas dan tidak ada yang dihapus secara otomatis). Karena penyimpanan adalah satu direktori yang dibagi semua workspace, batas ini tidak berlaku per proyek meskipun file milik proyek memuatnya: nilainya di-resolve dengan cara yang sama seperti kunci lainnya, dengan file yang lebih dekat yang menang, tetapi penyimpanan tetap hanya memiliki satu ukuran. Batas yang berlaku adalah batas dari build terbaru, sehingga dua proyek yang membatasinya secara berbeda sama-sama berlaku secara bergantian, dan batas rendah di satu proyek membuang kode mesin yang dikompilasi proyek lain. Menyetelnya sekali di file konfigurasi global itulah yang memberi seluruh mesin satu jawaban. aggrega config show --origin menyebutkan file asal nilai efektif setiap setelan. Minimum: 0. Default: 53687091200 |
Properti tambahan tidak diizinkan.
aggrega-config.concurrency
Pengaturan konkurensi pengiriman permintaan daemon. Daemon membaca permintaan dari satu aliran stdin dan menjalankan masing-masing melalui kumpulan worker yang menguras antrean permintaan terbatas; respons dikeluarkan sesuai urutan kedatangan permintaan, terlepas dari urutan penyelesaiannya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
pool_size | integer | tidak | Jumlah worker yang melayani antrean permintaan. Default 4, yang memproses hingga empat permintaan secara bersamaan; atur ke 1 untuk menjalankan permintaan secara berurutan sesuai urutan kedatangan. Nilai di bawah 1 dinaikkan menjadi 1 saat daemon dimulai. Minimum: 1. Default: 4 |
Properti tambahan tidak diizinkan.
aggrega-config.serve
Pengaturan perilaku daemon (aggrega serve) untuk compiler-sebagai-layanan yang digunakan oleh integrasi IDE.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
build_on_inspect | boolean | tidak | Apakah daemon menjalankan tahap perenderan artefak saat menginspeksi graf IR, sehingga peringatan yang dimunculkan aggrega build saat merender juga tampil sebagai masalah di editor. Pengaturan ini tidak menambahkan satu pun pemeriksaan yang menghentikan build. Tidak ada yang ditulis ke disk dalam kedua kasus — tidak ada artefak hasil render, tidak ada direktori keluaran, tidak ada lockfile — dan tahap perenderan tidak pernah mengubah graf, sehingga ketika inspeksi menjawab dengan graf, graf tersebut sama dalam kedua kasus. Default false, sesuai dengan aggrega inspect: perintah terminal tidak mencapai tahap perenderan saat menginspeksi graf, sehingga perintah itu juga tidak memunculkan peringatan semacam itu, dan inspeksi editor yang tidak memunculkannya menampilkan hal yang sama dengan terminal. Atur ke true untuk meminta lapisan tambahan tersebut dari editor. Default: false |
lint_on_validate | boolean | tidak | Apakah daemon menjalankan pemeriksaan konvensi publikasi saat memvalidasi entitas katalog, sehingga temuan yang dilaporkan aggrega lint pada entitas tersebut juga tampil sebagai masalah di editor. Temuan ini bersifat anjuran: dokumen yang memicunya tetap valid, dan Release-nya tetap ter-resolve dan ter-render. Hanya pemeriksaan yang membaca konten lokal yang dijalankan — tidak ada registry yang dikonsultasikan, tidak ada yang diambil, dan tidak ada yang ditulis — dan pemeriksaan dievaluasi terhadap buffer yang dipegang editor, bukan berkas di disk, sehingga nama yang Anda perbaiki berhenti dilaporkan sebelum Anda menyimpan. Default false: sesi editor melaporkan apakah dokumen benar, dan tidak menyatakan apa pun tentang apakah entitas dapat dipublikasikan, sampai Anda meminta lapisan kedua tersebut. Atur ke true untuk memintanya. Terlepas dari kunci ini, editor selalu dapat meminta pemeriksaan tersebut secara langsung, yang juga merupakan cara perbandingan pra-publikasi terhadap versi yang sebelumnya dipublikasikan dicapai. Default: false |
Properti tambahan tidak diizinkan.
aggrega-config.mcp
Pengaturan untuk server Model Context Protocol (aggrega mcp). transport memilih cara server dijangkau — melalui input dan output standar proses, atau melalui HTTP — dan dibaca apa pun pilihannya. announce_tools juga dibaca pada kedua transport, karena alat mana yang ditawarkan kepada klien merupakan properti server, bukan cara klien menjangkaunya. Setiap kunci lainnya mengonfigurasi listener yang dimulai oleh transport HTTP dan tidak digunakan selama server berkomunikasi melalui input dan output standar — termasuk listen, yang dibaca di sana hanya agar server dapat menyatakan, dalam satu baris di aliran error-nya, bahwa alamat tersebut tidak digunakan. Setiap kunci di bawah menyatakan termasuk yang mana. Berbeda dari serve, yang mengonfigurasi daemon backend editor.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
transport | string (enum) | tidak | Cara server dijangkau: stdio menjalankan protokol melalui input dan output standar proses, yang merupakan cara klien yang meluncurkan perintah sebagai subproses menjangkaunya; http menyajikannya melalui HTTP pada alamat yang disebutkan listen, dan melalui HTTPS jika tls menyebutkan sertifikat dan kunci. aggrega mcp --transport stdio|http menimpa kunci ini untuk satu pemanggilan. Default stdio, sehingga workspace yang tidak pernah menyebutkan transport dilayani melalui input dan output standar apa pun isi blok ini — listener hanya dimulai jika http dipilih, di sini atau di baris perintah. Nilai lain apa pun ditolak saat konfigurasi dimuat. Atur http dalam konfigurasi server yang dijangkau pemanggil melalui jaringan, dan biarkan tidak diatur jika klien meluncurkan server itu sendiri: dengan stdio dipilih, alamat di listen tidak digunakan, dan server menyatakannya dalam satu baris pada aliran error-nya. Nilai yang diizinkan: "stdio", "http" Default: "stdio" |
listen | string | tidak | Alamat yang di-bind listener saat transport HTTP dipilih. Kunci ini menyebutkan tempat mendengarkan dan tidak memilih apa pun: transport dipilih oleh transport, dan dengan stdio dipilih kunci ini tidak digunakan. Dua bentuk diterima: host:port untuk alamat TCP, dan unix: diikuti path sistem berkas untuk socket domain Unix. aggrega mcp --listen <address> menimpa kunci ini untuk satu pemanggilan. Default kosong, dan transport HTTP memerlukan alamat dari salah satunya: tanpa keduanya, peluncuran yang memilihnya ditolak sebelum apa pun di-bind. Alamat plaintext — yang dijangkau tanpa sertifikat dan kunci di bawah tls — hanya diterima pada loopback (127.0.0.1, ::1, atau localhost yang ter-resolve ke salah satunya) atau pada socket Unix, yaitu bentuk yang digunakan server ketika proxy di depannya menghentikan TLS; alamat lain apa pun ditolak sebelum apa pun di-bind, dengan menyebutkan mcp.tls.cert_file dan mcp.tls.key_file. Kedua bentuk yang sama adalah satu-satunya yang diterima, dengan atau tanpa sertifikat, jika authorization.trusted_proxy diatur, karena header hanya dapat dipercaya sebagai kredensial jika tidak ada pihak selain proxy yang dapat mengaturnya. Default: "" |
tls | object | tidak | Sertifikat dan kunci untuk menghentikan TLS di dalam proses penyaji. Atur keduanya untuk menyajikan HTTPS langsung dari listener yang disebutkan listen. Biarkan keduanya tidak diatur untuk menyajikan plaintext, yang membatasi listen pada loopback atau socket Unix — bentuk yang sebaiknya digunakan ketika proxy di depannya memegang sertifikat. Kedua kunci adalah path ke berkas di disk; tidak satu pun memuat materi kunci secara inline. |
allowed_origins | string[] | tidak | Origin yang diterima pada header Origin permintaan. Permintaan yang header Origin-nya menyebutkan origin yang tidak ada dalam daftar ini ditolak dengan 403; permintaan yang menyebutkan origin yang terdaftar, atau yang sama sekali tidak membawa header Origin, dilayani. Setiap entri dibandingkan dengan header secara persis, sehingga masing-masing ditulis sebagaimana browser mengirim origin: skema huruf kecil, ://, host huruf kecil — nama, alamat IPv4, atau alamat IPv6 dalam kurung siku — dan : dengan port jika bukan port default skema, tanpa apa pun setelahnya. Misalnya https://app.example.com atau http://localhost:3000. Entri dalam bentuk lain tidak akan pernah sama dengan yang dikirim browser, sehingga ditolak saat berkas konfigurasi dimuat, dengan menyebutkan berkas dan entrinya: entri dengan / di akhir atau dengan path (https://app.example.com/), entri tanpa skema (app.example.com), dan entri yang mengandung huruf kapital atau spasi. Default kosong, sehingga tidak ada origin yang diterima dan hanya pemanggil yang tidak mengirim header Origin yang dilayani. Oleh karena itu, klien berbasis browser memerlukan origin-nya terdaftar di sini; klien yang bukan browser tidak mengirim header tersebut dan tidak memerlukan entri. Setiap entri cocok dengan pola ^[a-z][a-z0-9+.-]*://(?:[a-z0-9._-]+|\[[0-9a-f:.]+\])(?::[0-9]{1,5})?$. Default: [] |
limits | object | tidak | Batas yang diterapkan listener HTTP pada lalu lintas yang diterimanya, sehingga satu pemanggil tidak dapat menghabiskan sumber daya proses penyaji. Batas ini membatasi seberapa besar satu permintaan, berapa banyak permintaan yang berjalan sekaligus, dan seberapa cepat satu pemanggil dapat mengirim. Tidak satu pun dapat dinonaktifkan. |
authorization | object | tidak | Apa yang dinyatakan server ini tentang bearer token yang diajukan pemanggilnya: server otorisasi mana yang menerbitkannya, alamat yang dipublikasikan server ini untuk dirinya sendiri sebagai sumber daya tujuan token tersebut diterbitkan, secara opsional sebuah file tempat kunci verifikasi server tersebut dibaca, dan secara opsional header yang ditetapkan proxy di depan ketika proxy tersebut yang memvalidasi token. issuer dan resource wajib diisi setiap kali transport HTTP dipilih, dan tanpa keduanya listener ditolak sebelum apa pun di-bind; server yang berkomunikasi melalui input dan output standar tidak membaca satu pun dari keduanya. Keduanya dipublikasikan dalam dokumen metadata protected-resource OAuth yang dilayani listener, yaitu satu-satunya jawaban yang diterima pemanggil HTTP tanpa diminta kredensial, karena klien membacanya untuk mengetahui tempat memperoleh token. Blok ini tidak menyimpan materi rahasia: token diajukan oleh pemanggil pada permintaan yang dibuatnya dan tidak pernah menjadi kolom konfigurasi, dan jwks_file menunjuk kunci verifikasi publik, bukan sesuatu yang menandatangani. |
deny_reach | string (enum)[] | tidak | Jenis jangkauan yang tidak dibawa server ini, apa pun isi token pemanggil. Setiap operasi menyatakan seberapa jauh efeknya menjangkau — none untuk operasi yang membaca atau merender dan tidak meninggalkan apa pun, workspace untuk operasi yang menulis di dalam workspace yang dilayani proses ini, registry untuk operasi yang memublikasikan, menandatangani, atau menarik kembali, dan machine untuk operasi yang mengubah apa yang digunakan bersama oleh setiap workspace di host — dan menyebutkan suatu jenis di sini menarik setiap tool dari jenis tersebut dari server ini. Tool yang ditarik tidak ada dalam daftar tool dan dalam jawaban describe-capabilities, bagi setiap pemanggil, dan tetap memanggilnya akan ditolak dengan menyebutkan pengaturan ini, karena tidak ada scope yang dapat mengizinkannya. Bawaannya kosong, sehingga server membawa apa pun yang diizinkan scope pemanggilnya. Ini adalah batas yang ditetapkan server pada dirinya sendiri, di atas batas per pemanggil yang ditetapkan scope: server yang hanya melayani pembacaan menyebutkan ketiga jenis penulisan di sini sehingga tidak dapat memublikasikan bahkan untuk pemanggil yang tokennya membawa setiap scope. Menyebutkan machine diterima dan tidak mengubah apa pun — tidak ada tool dari jenis tersebut yang ditawarkan melalui HTTP sama sekali, yang merupakan sifat transport, bukan pengaturan. Dibaca saat listener dimulai: nilai di luar keempatnya ditolak saat konfigurasi dimuat, dan mengubahnya memerlukan restart. Sama sekali tidak dibaca saat server berkomunikasi melalui input dan output standar, di mana pemanggilnya adalah orang yang meluncurkan proses. Nilai yang diizinkan untuk setiap entri: "none", "workspace", "registry", "machine". Bawaan: [] |
announce_tools | string[] | tidak | Tool yang diumumkan server ini, dinamai persis seperti yang dilaporkan daftar tool. Hilangkan kunci ini maka setiap tool yang dibawa server ini diumumkan, sesuai harapan klien yang mengikuti protokol: klien mengambil seluruh daftar tool dan memutuskan sendiri seberapa banyak yang ditampilkan kepada model. Tulis sebuah daftar maka tepat tool-tool itulah yang diumumkan — tool yang tidak dicantumkan tidak ada dalam daftar tool, tidak ada dalam jawaban describe-capabilities, dan ditolak saat dipanggil berdasarkan nama, dengan menyebutkan pengaturan ini. Tulis daftar kosong maka tidak ada yang diumumkan. Tetapkan kunci ini jika klien di ujung lain membatasi jumlah tool yang akan didaftarkannya — sebagian klien menerapkan batas itu untuk semua server yang terhubung dengannya sekaligus — dan sebutkan tool yang dibutuhkan klien tersebut. Kunci ini hanya mempersempit apa yang diumumkan, tidak lebih: kunci ini tidak dapat memperluas deny_reach, yang menarik suatu kemampuan sepenuhnya, maupun scope yang dibawa token pemanggil. Tool yang disebutkan di sini dari jenis yang ditarik deny_reach tetap tidak ada dalam daftar tool dan ditolak saat dipanggil, dengan menyebutkan pengaturan tersebut; tool yang disebutkan di sini tetapi tidak diizinkan oleh scope pemanggil tetap dicantumkan, dan pemanggilannya ditolak dengan menyebutkan scope yang akan mengizinkannya. Setiap nama harus merupakan nama yang dibawa binary ini: nama yang tidak cocok dengan tool mana pun ditolak saat server dimulai, karena siapa pun yang meminta permukaan yang lebih sempit akan dilayani permukaan yang berbeda tanpa pemberitahuan apa pun. Nama dalam keluarga cli-, yang menjalankan perintah aggrega dalam proses terpisah, diterima pada kedua transport dan tidak mengumumkan apa pun melalui HTTP, di mana tool semacam itu tidak ditawarkan kepada pemanggil mana pun. Dibaca pada kedua transport saat server dimulai, sehingga himpunan yang diumumkan tetap selama masa hidup proses dan mengubahnya memerlukan restart. |
health | object | tidak | Tempat supervisor menanyakan apakah proses ini hidup dan apakah siap menjawab panggilan. Kedua pemeriksaan dijawab pada alamatnya sendiri dan tidak pernah pada alamat yang disebutkan listen: setiap permintaan ke endpoint membawa bearer token, sehingga probe yang dijawab di sana akan memberi apa pun yang dapat menjangkau endpoint pembacaan proses tanpa autentikasi beserta cara gratis untuk membuatnya bekerja. Endpoint menjawab /healthz dan /readyz dengan 404 yang sama yang diberikannya untuk setiap path yang tidak dilayaninya, baik dengan token maupun tanpa token. |
Properti tambahan tidak diizinkan.
aggrega-config.mcp.tls
Sertifikat dan kunci untuk menghentikan TLS di dalam proses penyaji. Atur keduanya untuk menyajikan HTTPS langsung dari listener yang disebutkan listen. Biarkan keduanya tidak diatur untuk menyajikan plaintext, yang membatasi listen pada loopback atau socket Unix — bentuk yang sebaiknya digunakan ketika proxy di depannya memegang sertifikat. Kedua kunci adalah path ke berkas di disk; tidak satu pun memuat materi kunci secara inline.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
cert_file | string | tidak | Path ke rantai sertifikat PEM yang disajikan listener, dibaca saat proses dimulai. Ditetapkan bersama key_file. Bawaannya kosong, sehingga listener melayani plaintext dan listen dibatasi pada loopback atau socket Unix. Bawaan: "" |
key_file | string | tidak | Path ke kunci privat PEM untuk sertifikat dalam cert_file, dibaca saat proses dimulai. Ditetapkan bersamanya. Berupa path ke file, tidak pernah materi kunci inline. Bawaannya kosong, sehingga listener melayani plaintext dan listen dibatasi pada loopback atau socket Unix. Bawaan: "" |
Properti tambahan tidak diizinkan.
aggrega-config.mcp.limits
Batas yang diterapkan listener HTTP pada lalu lintas yang diterimanya, sehingga satu pemanggil tidak dapat menghabiskan sumber daya proses penyaji. Batas ini membatasi seberapa besar satu permintaan, berapa banyak permintaan yang berjalan sekaligus, dan seberapa cepat satu pemanggil dapat mengirim. Tidak satu pun dapat dinonaktifkan.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
max_body_bytes | integer | tidak | Body permintaan terbesar yang diterima listener, dalam byte. Permintaan yang body-nya melebihi batas ini ditolak dengan 413, dan body tidak dibaca melewati batas tersebut. Bawaannya 4194304 (4 MiB), jauh di atas panggilan tool yang membawa seluruh dokumen authoring dan jauh di bawah ukuran yang memungkinkan satu pemanggil menguasai bagian signifikan dari memori proses. Nilai minimumnya 1, sehingga tidak ada nilai yang menonaktifkan batas ini; naikkan jika pemanggil memang mengirim dokumen yang lebih besar. Minimum: 1. Bawaan: 4194304 |
max_concurrent_requests | integer | tidak | Jumlah permintaan yang dijalankan listener sekaligus. Permintaan yang tiba saat sejumlah itu sedang berjalan ditolak dengan 503 alih-alih dimasukkan ke antrean, sehingga pemanggil diminta mencoba lagi alih-alih menunggu di belakang pekerjaan yang tidak dapat dilihatnya. Bawaannya 16, yang memberi ruang bagi beberapa panggilan tool bersamaan sambil menjaga host kecil tetap responsif; naikkan pada host yang lebih besar. Nilai minimumnya 1, sehingga tidak ada nilai yang menonaktifkan batas ini. Minimum: 1. Bawaan: 16 |
requests_per_minute | integer | tidak | Jumlah permintaan yang dapat dikirim satu pemanggil dalam satu menit. Jumlah ini dihitung per pemanggil, bukan per server — terhadap subjek yang disebutkan token pemanggil, atau terhadap identitas yang dinyatakan proxy tepercaya — sehingga satu pemanggil yang sibuk tidak dapat menghabiskan jatah pemanggil lain. Pemanggil dapat mengirim sejumlah ini sekaligus; jatah kemudian terisi kembali secara stabil, satu permintaan tambahan setiap 60 / requests_per_minute detik, dan permintaan yang tiba saat jatah habis ditolak dengan 429. Bawaannya 120, yaitu dua per detik secara berkelanjutan: jauh di atas yang dikirim asisten yang menjalankan workspace, dan tetap menjadi batas bagi klien yang terjebak dalam loop. Nilai minimumnya 1, sehingga tidak ada nilai yang menonaktifkan batas ini. Minimum: 1. Bawaan: 120 |
Properti tambahan tidak diizinkan.
aggrega-config.mcp.authorization
Apa yang dinyatakan server ini tentang bearer token yang diajukan pemanggilnya: server otorisasi mana yang menerbitkannya, alamat yang dipublikasikan server ini untuk dirinya sendiri sebagai sumber daya tujuan token tersebut diterbitkan, secara opsional sebuah file tempat kunci verifikasi server tersebut dibaca, dan secara opsional header yang ditetapkan proxy di depan ketika proxy tersebut yang memvalidasi token. issuer dan resource wajib diisi setiap kali transport HTTP dipilih, dan tanpa keduanya listener ditolak sebelum apa pun di-bind; server yang berkomunikasi melalui input dan output standar tidak membaca satu pun dari keduanya. Keduanya dipublikasikan dalam dokumen metadata protected-resource OAuth yang dilayani listener, yaitu satu-satunya jawaban yang diterima pemanggil HTTP tanpa diminta kredensial, karena klien membacanya untuk mengetahui tempat memperoleh token. Blok ini tidak menyimpan materi rahasia: token diajukan oleh pemanggil pada permintaan yang dibuatnya dan tidak pernah menjadi kolom konfigurasi, dan jwks_file menunjuk kunci verifikasi publik, bukan sesuatu yang menandatangani.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
issuer | string | tidak | Alamat server otorisasi yang menerbitkan token yang diterima listener ini, ditulis sebagaimana server tersebut menyatakan pengenal penerbitnya sendiri — misalnya https://login.example.com. Alamat ini dipublikasikan dalam daftar authorization_servers pada dokumen metadata protected-resource, yang merupakan cara klien mengetahui tempat memperoleh token untuk listener ini. Default kosong, yang bukan nilai yang dapat digunakan: listener ditolak sebelum apa pun di-bind kecuali nilai ini memuat alamat lengkap, termasuk skema dan host. Alamat ini berupa alamat https kecuali server otorisasi berjalan di mesin ini: http biasa hanya diterima untuk host loopback, seperti localhost, 127.0.0.1 atau ::1, dan issuer http biasa pada host lain mana pun ditolak sebelum apa pun di-bind, dengan menyebut kunci ini dan meminta alamat https. Hal itu berlaku baik kunci dibaca dari issuer, dari jwks_file, maupun ketika trusted_proxy di depan memeriksa token, karena setiap klien diarahkan ke issuer untuk memperoleh tokennya. Default: "" |
resource | string | tidak | Alamat yang dipublikasikan server ini untuk dirinya sendiri, sebagaimana pemanggil menjangkaunya — misalnya https://mcp.example.com/mcp. Tulis alamat yang benar-benar digunakan pemanggil, termasuk host yang ditampilkan proxy di depan, karena ini adalah pengenal yang diserahkan klien kepada server otorisasi ketika meminta token untuk server ini, dan alamat ini dipublikasikan tanpa perubahan sebagai field resource pada dokumen metadata protected-resource. Lokasi penyajian dokumen tersebut diturunkan darinya, dengan menyisipkan /.well-known/oauth-protected-resource di antara host dan path: server yang dipublikasikan sebagai https://mcp.example.com/mcp menyajikannya di https://mcp.example.com/.well-known/oauth-protected-resource/mcp, dan juga di path well-known tersebut tanpa apa pun sesudahnya, yang merupakan tempat kedua yang diperiksa klien. Token hanya diterima jika alamat ini termasuk di antara audiens yang disebutkannya. Default kosong, yang bukan nilai yang dapat digunakan: listener ditolak sebelum apa pun di-bind kecuali nilai ini memuat alamat lengkap, termasuk skema dan host. Default: "" |
jwks_file | string | tidak | Path ke file yang memuat JSON Web Key Set yang digunakan untuk memverifikasi token yang diterima server ini, dibaca saat proses dimulai. Default kosong, yang merupakan kasus umum: kunci dibaca dari server otorisasi itu sendiri, dengan menanyakan kepada issuer di mana kunci tersebut dipublikasikan lalu mengambilnya dari alamat yang disebutkannya, dan kunci dibaca ulang sekali ketika token datang dengan tanda tangan dari pengenal kunci yang tidak ada dalam set yang dipegang. Atur nilai ini jika workspace offline; dalam hal itu listener ditolak sebelum apa pun di-bind tanpanya, karena workspace offline tidak membuat permintaan jaringan dan tidak ada cara lain untuk memperoleh kunci; file tersebut kemudian memuat satu-satunya kunci yang diterima, dan server otorisasi tidak pernah dihubungi. File ini memuat kunci verifikasi publik dan tidak pernah memuat apa pun yang menandatangani. Path relatif diselesaikan terhadap direktori file config yang mendeklarasikannya. Default: "" |
trusted_proxy | object | tidak | Membaca identitas pemanggil dari header yang diatur oleh proxy di depan, alih-alih memvalidasi bearer token di sini. Atur ini hanya jika kedua hal berikut terpenuhi: proxy di depan memvalidasi token sendiri, dan tidak ada apa pun selain proxy tersebut yang dapat menjangkau listener: jika ini diatur, listen harus berupa loopback atau Unix socket, dan alamat lain mana pun ditolak sebelum apa pun di-bind, dengan menyebut kedua pengaturan. Sebuah header hanya dapat dipercaya sejauh kumpulan pemanggil yang dapat mengaturnya, dan pada alamat yang dijangkau jaringan, setiap pemanggil dapat mengatur header apa pun yang diinginkannya, sehingga listener dalam mode ini pada alamat semacam itu akan memungkinkan setiap pemanggil mengaku sebagai siapa saja. Jika ini diatur, tidak ada token yang dibaca sama sekali — tidak dari header Authorization, tidak dari tempat lain, dan tidak ada set kunci yang diambil — identitas pemanggil adalah nilai principal_header, permintaan yang tidak membawa header tersebut dijawab 401, dan kedua header yang disebutkan di sini adalah satu-satunya yang dibaca. Hilangkan ini, yang merupakan default, maka server ini memvalidasi bearer token sendiri. |
Properti tambahan tidak diizinkan.
aggrega-config.mcp.authorization.trusted_proxy
Membaca identitas pemanggil dari header yang diatur oleh proxy di depan, alih-alih memvalidasi bearer token di sini. Atur ini hanya jika kedua hal berikut terpenuhi: proxy di depan memvalidasi token sendiri, dan tidak ada apa pun selain proxy tersebut yang dapat menjangkau listener: jika ini diatur, listen harus berupa loopback atau Unix socket, dan alamat lain mana pun ditolak sebelum apa pun di-bind, dengan menyebut kedua pengaturan. Sebuah header hanya dapat dipercaya sejauh kumpulan pemanggil yang dapat mengaturnya, dan pada alamat yang dijangkau jaringan, setiap pemanggil dapat mengatur header apa pun yang diinginkannya, sehingga listener dalam mode ini pada alamat semacam itu akan memungkinkan setiap pemanggil mengaku sebagai siapa saja. Jika ini diatur, tidak ada token yang dibaca sama sekali — tidak dari header Authorization, tidak dari tempat lain, dan tidak ada set kunci yang diambil — identitas pemanggil adalah nilai principal_header, permintaan yang tidak membawa header tersebut dijawab 401, dan kedua header yang disebutkan di sini adalah satu-satunya yang dibaca. Hilangkan ini, yang merupakan default, maka server ini memvalidasi bearer token sendiri.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
principal_header | string | ya | Header tempat proxy di depan menaruh identitas pemanggil — misalnya X-Forwarded-User. Nilai ini ditulis sebagai nama header HTTP: huruf, angka dan tanda hubung, serta karakter lain yang boleh ada dalam nama header (!#$%&'*+.^_|~ dan backtick), tanpa spasi, titik dua atau pemisah lain. Nama dalam bentuk lain ditolak saat file konfigurasi dimuat, dengan menyebut file dan kuncinya, karena tidak ada permintaan yang dapat membawa header semacam itu. Nama kosong juga ditolak: nama kosong akan membuat server ini memeriksa token sendiri padahal blok ini menyatakan bahwa proxy di depan yang melakukannya. Untuk menonaktifkan mode ini, hilangkan trusted_proxy. Nilai header diambil persis seperti tertulis dan tidak dibandingkan dengan apa pun, sama seperti subjek token yang divalidasi sendiri oleh server ini dicatat dan tidak dibandingkan dengan apa pun. Nilai ini adalah seluruh kredensial dalam mode ini, sehingga wajib diisi setiap kali trusted_proxy diatur, dan permintaan yang datang tanpanya dijawab 401. Pola: ^[!#$%&'*+.^_`|~0-9A-Za-z-]+$. |
scopes_header | string | tidak | Header tempat proxy di depan menaruh scope yang diberikan kepada pemanggil, dipisahkan dengan spasi — misalnya X-Forwarded-Scopes. Nilai ini ditulis sebagai nama header HTTP, dalam bentuk yang sama dengan principal_header, atau dibiarkan kosong. Nama dalam bentuk lain ditolak saat file konfigurasi dimuat, dengan menyebut file dan kuncinya, karena tidak ada permintaan yang dapat membawa header semacam itu dan tidak ada pemanggil yang akan pernah diberi scope. Default kosong, yang tidak menyatakan scope apa pun untuk pemanggil mana pun. Apa pun namanya, tidak ada header selain header ini dan principal_header yang dibaca. Pola: ^[!#$%&'*+.^_`|~0-9A-Za-z-]*$. Default: "" |
Properti tambahan tidak diizinkan.
aggrega-config.mcp.health
Tempat supervisor menanyakan apakah proses ini hidup dan apakah siap menjawab panggilan. Kedua pemeriksaan dijawab pada alamatnya sendiri dan tidak pernah pada alamat yang disebutkan listen: setiap permintaan ke endpoint membawa bearer token, sehingga probe yang dijawab di sana akan memberi apa pun yang dapat menjangkau endpoint pembacaan proses tanpa autentikasi beserta cara gratis untuk membuatnya bekerja. Endpoint menjawab /healthz dan /readyz dengan 404 yang sama yang diberikannya untuk setiap path yang tidak dilayaninya, baik dengan token maupun tanpa token.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
listen | string | tidak | Alamat tempat pemeriksaan liveness dan readiness dijawab, dalam dua bentuk yang sama dengan yang diterima listen: host:port, atau unix: diikuti path sistem berkas. Bawaannya kosong, sehingga tidak ada listener kedua yang dijalankan dan kedua pemeriksaan tidak dijawab di mana pun. Jika alamat ditetapkan, GET /healthz dijawab 200 sejak proses berjalan, dan GET /readyz dijawab 503 hingga workspace selesai di-resolve dan endpoint telah melakukan bind, lalu 200 sejak saat itu — itulah perbedaan yang dibutuhkan supervisor, karena proses yang sudah berjalan belum tentu proses yang dapat menjawab panggilan. Setiap jawaban berupa kode status dengan body kosong, tidak ada token yang diminta dan tidak ada header yang dibaca; path lain apa pun pada alamat ini dijawab 404, dan metode lain apa pun pada kedua path ini dijawab 405. Tidak seperti listen, alamat ini tidak dibatasi pada loopback atau socket Unix dan tidak ada alamat yang ditolak untuknya: arahkan ke salah satunya, karena memang untuk itulah ia dibuat, dan perhatikan bahwa apa pun yang dapat menjangkau alamat yang Anda pilih dapat membaca kedua jawaban tersebut. Bawaan: "" |
Properti tambahan tidak diizinkan.
Definisi
ReleaseCatalogConfig
Direktori katalog milik satu Release: dua kunci yang sama dengan yang dibawa blok workspace, dengan cakupan Release tersebut.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
catalog_dirs | string[] | tidak | Direktori katalog tempat Release ini membaca entitas lokal sebagai pengganti catalog_dirs milik workspace, masing-masing diselesaikan relatif terhadap file yang mendeklarasikannya. Tumpukan pencarian berurutan yang sama dengan prinsip entri pertama menang seperti daftar milik workspace, dengan direktori catalog di root workspace dibaca setelahnya apabila direktori tersebut ada dan tidak ada entri dalam daftar yang sudah memuatnya. Jika dihilangkan, Release mempertahankan daftar milik workspace; jika ditulis sebagai [], Release tidak membaca katalog lokal sama sekali. |
catalog_dirs_append | string[] | tidak | Direktori katalog yang ditambahkan setelah daftar Release ini — catalog_dirs miliknya sendiri apabila entri menuliskannya, atau milik workspace jika tidak — masing-masing diselesaikan relatif terhadap file yang mendeklarasikannya. Default: [] |
Properti tambahan tidak diizinkan.
RegistryConfig
Pengaturan dan kebijakan kepercayaan tanda tangan dengan cakupan satu host registry OCI.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
host | string | ya | Host registry tempat pengaturan ini berlaku (mis. hub.aggrega.ai). Dicocokkan dengan host registry dari target push/pull, sehingga ditulis dalam ejaan yang digunakan pencocokan tersebut: nama host huruf kecil yang memuat titik, localhost, satu nama diikuti port (registry:5000), alamat IPv4, atau alamat IPv6 dalam kurung siku, masing-masing dengan :port opsional — tanpa skema, path, kredensial, spasi, atau huruf kapital. Port 443 pada host yang dijangkau melalui HTTPS adalah port default host tersebut, dan menuliskannya ditolak saat konfigurasi dimuat, dengan menyebutkan host yang harus ditulis tanpanya, karena entri yang dieja demikian tidak akan pernah menjadi entri yang ditemukan; localhost dan alamat loopback lainnya dijangkau melalui HTTP biasa, sehingga 443 adalah port biasa di sana dan dipertahankan. aggrega registry add dan aggrega config init --registry menyimpan entri di bawah host yang disebutkan argumennya dan menolak host yang tidak dieja dengan cara ini. Host dinilai hanya dari ejaannya: apakah nama tersebut dapat diselesaikan, atau apakah ada registry yang menjawab di sana, tidak diperiksa. Pola: ^(?:(?:(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z](?:[a-z0-9-]{0,61}[a-z0-9])?|localhost|(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])(?:\.(?:25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])){3}|\[(?:(?:[0-9a-f]{1,4}:){7}[0-9a-f]{1,4}|(?:[0-9a-f]{1,4}:){1,7}:|(?:[0-9a-f]{1,4}:){1,6}:[0-9a-f]{1,4}|(?:[0-9a-f]{1,4}:){1,5}(?::[0-9a-f]{1,4}){1,2}|(?:[0-9a-f]{1,4}:){1,4}(?::[0-9a-f]{1,4}){1,3}|(?:[0-9a-f]{1,4}:){1,3}(?::[0-9a-f]{1,4}){1,4}|(?:[0-9a-f]{1,4}:){1,2}(?::[0-9a-f]{1,4}){1,5}|[0-9a-f]{1,4}:(?::[0-9a-f]{1,4}){1,6}|:(?:(?::[0-9a-f]{1,4}){1,7}|:))\])(?::(?:[1-9][0-9]{0,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?|[a-z](?:[a-z0-9-]{0,61}[a-z0-9])?:(?:[1-9][0-9]{0,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))$. |
name | string | tidak | Alias ramah opsional untuk registry ini. Host adalah identitasnya; name adalah pemilih praktis yang diselesaikan ke host entri ini di mana pun sebuah registry disebutkan (misalnya --registry, atau default_registry). Alias harus unik di seluruh entri. |
trusted_identities | TrustedIdentity[] | tidak | Himpunan OR identitas penandatanganan keyless yang diterima untuk artefak yang di-pull dari registry ini. Tanda tangan terverifikasi apabila sertifikatnya cocok dengan salah satu entri. Digunakan oleh jalur verifikasi keyless. Default: [] |
trusted_deprecation_identities | TrustedIdentity[] | tidak | Himpunan OR identitas keyless yang juga diterima untuk menandatangani penanda deprecation retroaktif bagi artefak yang di-pull dari registry ini. Penanda deprecation diterima apabila tanda tangannya cocok dengan penanda tangan artefak asli ATAU salah satu entri di sini — sehingga pemilik registry atau tim keamanan dapat menarik artefak yang tidak lagi dapat dijangkau penerbit aslinya, tanpa harus dipercaya untuk menandatangani artefak itu sendiri. Hanya digunakan oleh jalur penemuan deprecation; tidak pernah memperluas himpunan kepercayaan untuk tanda tangan artefak. Default: [] |
public_key | string | tidak | Kunci publik yang kompatibel dengan cosign dan dipatok untuk registry mode berkunci, ditulis inline sebagai blok PEM: teks dari baris -----BEGIN PUBLIC KEY----- (atau -----BEGIN RSA PUBLIC KEY-----) hingga baris -----END yang sesuai, sebagaimana aggrega registry add --key menyalinnya dari file kunci. Jika diatur, tanda tangan dari registry ini diverifikasi secara offline terhadap kunci ini, bukan terhadap identitas keyless. Nilai yang tidak memuat baris -----BEGIN … PUBLIC KEY----- ditolak saat file konfigurasi dimuat, dengan menyebutkan file dan entrinya, demikian pula kunci privat yang tertempel di sini secara keliru. Baris tersebut dapat berada di mana saja dalam nilai, karena kunci dibaca dari blok PEM yang dibawa nilai dan teks apa pun sebelum blok tersebut diabaikan. Hanya baris itu yang diperiksa di sini: apakah blok memuat kunci yang dapat didekode baru diketahui saat tanda tangan dari registry ini diverifikasi terhadapnya. Nilai ini dideklarasikan sensitif (x-aggrega-sensitive), sehingga nilai yang ditolak — terutama kunci privat yang terpilih secara keliru — tidak pernah dikutip: penolakan menyebutkan file, entri, dan batasan yang tidak dipenuhi nilai — pola di atas, atau jenis string — dan menampilkan <redacted> di tempat nilai seharusnya berada. Kunci publik yang berhasil dimuat dibaca dan ditampilkan sebagaimana ditulis. Pola: -----BEGIN [A-Z ]*PUBLIC KEY-----. |
trusted_root | string | tidak | Path opsional ke bundel trust root Sigstore yang dipatok untuk verifikasi keyless di lingkungan air-gapped. Jika diatur, jangkar kepercayaan keyless dimuat dari file ini tanpa jaringan; jika kosong, trust root public-good diambil dan di-cache. |
advisory | boolean | tidak | Jika true, kegagalan verifikasi tanda tangan untuk registry ini diturunkan menjadi peringatan alih-alih menghentikan pull. Verifikasi tetap dijalankan dan kegagalannya dilaporkan; pull tetap berlanjut. Default-nya false. Default: false |
skip_signature_verification | boolean | tidak | Opt-out darurat (break-glass) per host dari verifikasi tanda tangan — sakelar skip_signature_verification yang sama dengan sakelar global, dengan cakupan host ini berdasarkan penempatannya. Sakelar ini tidak mengalahkan kebijakan signing.required tingkat atas: tanda tangan yang diwajibkan organisasi tetap diverifikasi pada host ini terlepas dari sakelar ini; hanya sakelar global yang dapat menonaktifkannya. Mengatur sakelar ini bersama signing.required per registry pada host yang sama diizinkan, dan menggabungkan tanda tangan yang wajib saat push dengan verifikasi yang dilewati saat pull: skip menang di sisi verifikasi, karena sikap wajib per host (tidak seperti sikap tingkat atas) tidak kebal terhadap skip per host. Default-nya false. Default: false |
signing | SigningConfig | tidak | Blok penandatanganan registry ini: URL layanan keyless, path kunci berkunci opsional, dan sikap kepercayaan per host. Kolom endpoint menimpa blok signing global untuk push ke host ini; flag CLI menimpa keduanya. required dan kinds dibaca dari penempatan — di bawah entri registry, keduanya membatasi satu sikap kepercayaan tersebut ke host ini (menerbitkan artefak dalam cakupan yang tidak ditandatangani ditolak, dan mengonsumsi artefak yang tidak ditandatangani ditolak), konsep yang sama dengan yang dibawa blok signing tingkat atas untuk semua registry. |
Properti tambahan tidak diizinkan.
SigningConfig
Sebuah blok penandatanganan: URL layanan keyless, penunjuk opsional ke file kunci mode keyed, dan sikap kepercayaan (required dan kinds). Jika ditempatkan di tingkat teratas, blok ini berlaku untuk semua registri; jika ditempatkan di bawah entri registries[], blok ini berlaku untuk host tersebut — setiap bidang membaca cakupannya dari penempatannya. required adalah satu sikap kepercayaan yang mencakup kedua arah (push dalam cakupan yang tidak ditandatangani ditolak dan pull dalam cakupan yang tidak ditandatangani ditolak). Keamanan: blok ini tidak menyimpan materi rahasia — token identitas OIDC tidak pernah menjadi bidang konfigurasi (berumur pendek, diberikan saat runtime), dan key_path adalah path ke file kunci, tidak pernah byte kunci inline. Hal ini mencerminkan asimetri sisi verifikasi: public_key inline diizinkan di sana, tetapi sisi penandatanganan hanya membawa path kunci. Server aggrega mcp yang dijangkau melalui HTTP tidak merujuk key_path pada penempatan mana pun, sehingga penandatanganan keyed tidak dapat dijangkau melalui listener semacam itu: panggilan yang dijawabnya hanya ditandatangani dengan token identitas yang dibawa oleh panggilan tersebut.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
fulcio_url | string | tidak | URL otoritas sertifikat Fulcio untuk penandatanganan keyless. Jika tidak diatur, instans Fulcio public-good digunakan. Nilainya ditulis sebagai URL https absolut: https://, sebuah host, serta port dan path opsional, tanpa spasi — misalnya https://fulcio.sigstore.dev. Nilai dalam bentuk lain, seperti nilai tanpa skema (fulcio.example.com) atau yang diawali http://, ditolak saat file konfigurasi dimuat, dengan menyebutkan file dan kuncinya. File diperiksa sebelum hal lain diterapkan di atasnya, sehingga endpoint yang sama yang diberikan oleh AGGREGA_SIGNING_FULCIO_URL, oleh flag --fulcio-url, atau dalam permintaan publikasi dari editor atau asisten tidak diwajibkan mengikuti bentuk ini. Pola: ^https://[^\s/?#]+(?:[/?#]\S*)?$. |
rekor_url | string | tidak | URL log transparansi Rekor untuk penandatanganan keyless. Jika tidak diatur, instans Rekor public-good digunakan. Nilainya ditulis sebagai URL https absolut: https://, sebuah host, serta port dan path opsional, tanpa spasi — misalnya https://rekor.sigstore.dev. Nilai dalam bentuk lain, seperti nilai tanpa skema (rekor.example.com) atau yang diawali http://, ditolak saat file konfigurasi dimuat, dengan menyebutkan file dan kuncinya. File diperiksa sebelum hal lain diterapkan di atasnya, sehingga endpoint yang sama yang diberikan oleh AGGREGA_SIGNING_REKOR_URL, oleh flag --rekor-url, atau dalam permintaan publikasi dari editor atau asisten tidak diwajibkan mengikuti bentuk ini. Pola: ^https://[^\s/?#]+(?:[/?#]\S*)?$. |
timestamp_url | string | tidak | URL otoritas stempel waktu RFC3161 untuk penandatanganan keyless. Tidak ada nilai default: jika tidak diatur, tidak ada otoritas stempel waktu yang dihubungi, dan waktu tepercaya tanda tangan keyless berasal dari entri log transparansinya. Nilainya ditulis sebagai URL https absolut: https://, sebuah host, serta port dan path opsional, tanpa spasi — misalnya https://tsa.example.com/api/v1/timestamp. Nilai dalam bentuk lain, seperti nilai tanpa skema (tsa.example.com) atau yang diawali http://, ditolak saat file konfigurasi dimuat, dengan menyebutkan file dan kuncinya. File diperiksa sebelum hal lain diterapkan di atasnya, sehingga endpoint yang sama yang diberikan oleh AGGREGA_SIGNING_TIMESTAMP_URL, oleh flag --timestamp-url, atau dalam permintaan publikasi dari editor atau asisten tidak diwajibkan mengikuti bentuk ini. Pola: ^https://[^\s/?#]+(?:[/?#]\S*)?$. |
key_path | string | tidak | Path ke file PEM kunci privat ECDSA P-256 yang disimpan untuk penandatanganan keyed secara offline. Path ke sebuah file, tidak pernah materi kunci inline. Jika tidak diatur, jalur keyless digunakan. Server aggrega mcp yang dijangkau melalui HTTP tidak pernah merujuk kunci ini, di mana pun kunci itu diatur — di blok signing tingkat teratas, di blok milik entri registri, atau oleh AGGREGA_SIGNING_KEY_PATH: panggilan yang dijawab listener semacam itu hanya ditandatangani dengan token identitas yang dibawa oleh panggilan itu sendiri, atau ditolak. Server yang dijangkau melalui input dan output standar menandatangani dengan kunci ini seperti halnya terminal. |
required | boolean | tidak | Satu sikap kepercayaan untuk cakupan blok ini: jika true, publikasi jenis artefak dalam cakupan memerlukan tanda tangan (push dalam cakupan yang tidak ditandatangani ditolak), dan konsumsinya memerlukan tanda tangan (pull dalam cakupan yang tidak ditandatangani ditolak). Cakupan dibaca dari penempatan — pada blok signing tingkat teratas, cakupannya meliputi setiap registri; di bawah blok signing milik entri registries[], cakupannya meliputi satu host tersebut. Satu nama, satu tugas, kedua cakupan. Kebijakan tingkat teratas disusun secara monoton di sepanjang kaskade konfigurasi — lapisan mana pun yang mengaturnya ke true membuatnya efektif true, dan tidak ada lapisan dengan prioritas lebih rendah yang dapat mematikannya kembali — sehingga kebijakan ini tidak dapat dihapus melalui suntingan konfigurasi biasa. Default-nya false. Default: false |
kinds | string[] | tidak | Membatasi cakupan required pada jenis artefak tertentu. Kosong atau satu entri all berarti setiap jenis yang dapat ditandatangani; selain itu, sikap tersebut berlaku tepat pada jenis yang tercantum, dicocokkan dengan nilai kind: entitas (mis. Component, Feature, Recipe, FeatureRecipe, SchemaLibrary, MappingLibrary, Aggregate, Plugin). Pada blok signing tingkat teratas, nilai ini disusun sebagai gabungan di sepanjang kaskade — sebuah lapisan dapat memperluas cakupan tetapi tidak pernah mempersempitnya. Cakupan dibaca dari penempatan, sama seperti required. Default: [] |
Properti tambahan tidak diizinkan.
TrustedIdentity
Satu identitas penandatanganan keyless yang dapat diterima: subjek sertifikat (identitas OIDC) yang dipasangkan dengan penerbit OIDC yang menjaminnya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
identity | string | tidak | Subject alternative name sertifikat yang persis — identitas OIDC yang terikat ke dalam sertifikat penandatanganan berumur pendek (mis. email maintainer atau URI workflow CI). |
identity_regexp | string | tidak | Ekspresi reguler yang dicocokkan dengan subjek sertifikat, digunakan sebagai pengganti identity yang persis (mis. untuk menerima workflow apa pun di bawah suatu organisasi). |
issuer | string | ya | URL penerbit OIDC yang menerbitkan token identitas (mis. https://accounts.google.com atau https://token.actions.githubusercontent.com). |
Properti tambahan tidak diizinkan.
PluginRef
Referensi ke plugin Wasm yang dilampirkan pada soket yang fungsi entrinya dapat dinamai oleh lampiran — daftar governance dan linter. Soket yang titik entrinya tetap menggunakan FixedEntryPluginRef, yang membawa bidang yang sama tanpa function. uri dan capability bersama-sama memilih plugin: uri saja adalah lampiran langsung (plugin pada identitas tersebut dilampirkan apa adanya — jalur soket lintas-bidang, karena plugin-nya tidak mendeklarasikan kapabilitas yang dilayani); capability saja me-resolve plugin yang melayani kapabilitas tersebut (nama kapabilitas polos yang diikat oleh sebuah Recipe melalui spec.capability, misalnya helm); keduanya bersama-sama menghilangkan ambiguitas — capability menamai apa yang di-resolve dan uri memilih plugin penerbit mana yang melayaninya, berdasarkan identitas polos plugin tersebut, dalam katalog terfederasi tempat lebih dari satu plugin melayani kapabilitas tersebut. function menimpa fungsi entri bawaan soket; jika dihilangkan, nilai bawaan yang didokumentasikan untuk soket berlaku — pada entri governance, nilai bawaan itu ditentukan oleh role. role menamai peran lampiran governance dan hanya dibaca pada entri governance. with membawa input opsional saat pelampiran yang dibaca plugin.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
uri | string | tidak | Pengenal plugin: identitas polos sebuah entitas Plugin — jalur <pluginType>/<name>, misalnya governance/redact atau provider/helm — jalur sistem berkas lokal, atau alias registry. Opsional: sebuah entri dapat memilih plugin melalui capability sebagai gantinya. Akhiran opsional :version mengunci versi dalam tiga bentuk yang sama dengan penguncian versi mana pun (polos, persis :1.0.0, atau rentang kompatibel-mayor :^1.0.0). |
role | string (enum) | tidak | Peran pipeline tempat lampiran governance diikat, hanya dibaca pada entri governance: annotation-transform menyuntikkan anotasi ke komponen yang telah di-resolve sebelum ekspansi anotasi, sehingga injeksi yang terikat menjadi lampiran Feature; label-transform menandai otomatis label node graf topologi saat konstruksi topologi; ir-verdict menghasilkan putusan terima/tolak atas graf IR saat analisis statis; render-verdict menghasilkan putusan atas artefak yang di-render saat rendering. Peran — bukan jenis yang dideklarasikan plugin — menentukan apa yang boleh dikeluarkan plugin: keluaran peran putusan hanya dapat dibaca sebagai putusan, tidak pernah diterapkan sebagai perubahan; keluaran peran transformasi dibatasi oleh host pada facet-nya (anotasi atau label). Peran ini juga memilih fungsi entri bawaan (annotation-transform → transform_annotations; label-transform → mutate; ir-verdict → verdict_ir; render-verdict → verdict_render). Nilai yang diizinkan: "annotation-transform", "label-transform", "ir-verdict", "render-verdict" |
capability | string | tidak | Kapabilitas provider yang dipilihkan plugin-nya oleh entri ini — nama kapabilitas polos yang diikat oleh sebuah Recipe melalui spec.capability (misalnya helm, compose). Opsional: sebuah entri dapat melampirkan plugin secara langsung melalui uri sebagai gantinya. Pengikatan provider menggunakan ini untuk memilih plugin penerbit mana yang melayani sebuah kapabilitas dalam katalog terfederasi; soket lintas-bidang membiarkannya kosong dan melampirkan melalui uri. |
function | string | tidak | Penimpaan opsional untuk fungsi entri bawaan soket. Jika dihilangkan, nilai bawaan yang didokumentasikan untuk soket berlaku (governance annotation-transform → transform_annotations, governance label-transform → mutate, governance ir-verdict → verdict_ir, governance render-verdict → verdict_render, linter → lint_rules). Penimpaan dapat menamai ekspor apa pun yang dideklarasikan plugin, dan ekspor yang dinamainya harus mengembalikan bentuk keluaran yang dibaca soket tersebut: build berhenti ketika keluaran itu membawa bidang tingkat atas yang tidak dideklarasikan bentuk tersebut, dengan menyebutkan ekspor yang dipanggil dan bidang yang tidak terduga. Pemeriksaan ini membaca nama bidang tingkat atas mana yang ada, bukan mana yang tidak ada atau apa yang bersarang di bawahnya, sehingga ini bukan validasi penuh atas keluaran. |
with | PluginRefWith | tidak | Input opsional saat pelampiran yang dibaca plugin. Kedua anggota bersifat opsional dan agnostik terhadap soket, sehingga soket mana pun dapat menggunakan kembali permukaan ini. |
Properti tambahan tidak diizinkan.
FixedEntryPluginRef
Referensi ke plugin Wasm yang dilampirkan pada soket yang titik entrinya tetap, bukan dinamai oleh lampiran — daftar importer dan pengikatan providers. Referensi ini membawa bidang yang sama dengan PluginRef tanpa function: soket importer memanggil satu fungsi entri yang dinamai kontrak soketnya, dan sebuah provider menjalankan sekumpulan tetap ekspor berkunci fase, bukan satu entri yang dapat dipilih, sehingga pada kedua daftar itu tidak ada entri yang dapat dinamai oleh function dan kunci tersebut tidak diterima di sana. uri dan capability bersama-sama memilih plugin: uri saja adalah lampiran langsung (plugin pada identitas tersebut dilampirkan apa adanya — jalur soket importer, karena plugin-nya tidak mendeklarasikan kapabilitas yang dilayani); capability saja me-resolve plugin yang melayani kapabilitas tersebut (nama kapabilitas polos yang diikat oleh sebuah Recipe melalui spec.capability, misalnya helm); keduanya bersama-sama menghilangkan ambiguitas — capability menamai apa yang di-resolve dan uri memilih plugin penerbit mana yang melayaninya, berdasarkan identitas polos plugin tersebut, dalam katalog terfederasi tempat lebih dari satu plugin melayani kapabilitas tersebut. role diterima di sini tetapi tidak dibaca pada kedua daftar yang dilayani bentuk ini: peran lampiran governance yang dinamainya dibaca pada entri governance, yang menggunakan PluginRef, sehingga peran yang ditetapkan pada salah satu entri ini tidak berpengaruh. with membawa input opsional saat pelampiran yang dibaca plugin; pengikatan provider mengambil konfigurasi render-nya dari Recipe sebagai gantinya, sehingga with: pada pengikatan tersebut ditolak saat dimuat.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
uri | string | tidak | Pengenal plugin: identitas polos sebuah entitas Plugin — jalur <pluginType>/<name>, misalnya governance/redact atau provider/helm — jalur sistem berkas lokal, atau alias registry. Opsional: sebuah entri dapat memilih plugin melalui capability sebagai gantinya. Akhiran opsional :version mengunci versi dalam tiga bentuk yang sama dengan penguncian versi mana pun (polos, persis :1.0.0, atau rentang kompatibel-mayor :^1.0.0). |
role | string (enum) | tidak | Peran lampiran governance. Tidak satu pun daftar yang menggunakan bentuk ini membacanya — peran dibaca pada entri governance, dan entri tersebut menggunakan PluginRef — sehingga peran yang ditetapkan di sini diterima dan tidak berpengaruh. Nilai yang diizinkan adalah empat peran governance, dan makna masing-masing dijelaskan pada PluginRef. Nilai yang diizinkan: "annotation-transform", "label-transform", "ir-verdict", "render-verdict" |
capability | string | tidak | Kapabilitas provider yang dipilihkan plugin-nya oleh entri ini — nama kapabilitas polos yang diikat oleh sebuah Recipe melalui spec.capability (misalnya helm, compose). Opsional: sebuah entri dapat melampirkan plugin secara langsung melalui uri sebagai gantinya. Pengikatan provider menggunakan ini untuk memilih plugin penerbit mana yang melayani sebuah kapabilitas dalam katalog terfederasi; soket lintas-bidang membiarkannya kosong dan melampirkan melalui uri. |
with | PluginRefWith | tidak | Input opsional saat pelampiran yang dibaca plugin. Kedua anggota bersifat opsional dan agnostik terhadap soket, sehingga soket mana pun dapat menggunakan kembali permukaan ini. |
Properti tambahan tidak diizinkan.
CLIPluginRef
Plugin ekstensi CLI yang disematkan versinya dan dipasang sebagai perintah aggrega tingkat atas: referensi artefak yang telah diresolusi dan disematkan versinya yang diresolusi dan dijalankan oleh perintah tersebut, serta digest konten dari byte guest yang menjadi hasil resolusi referensi itu pada saat pemasangan. Bersama-sama keduanya menyematkan secara tepat byte mana yang dieksekusi perintah; digest tersebut juga menjadi kunci cache describe yang menyediakan nama dan bantuan perintah tanpa memuat guest.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
uri | string | ya | Referensi artefak yang telah diresolusi dan disematkan versinya yang diresolusi dan dijalankan oleh perintah, misalnya oci://hub.aggrega.ai/plugin/cli/<name>:1.2.0, disematkan saat pemasangan. |
digest | string | ya | Digest konten dari byte guest .wasm yang menjadi hasil resolusi referensi saat pemasangan, ditulis sebagai sha256: diikuti 64 digit heksadesimal huruf kecil dari SHA-256 byte tersebut — ejaan yang dicatat oleh aggrega plugin add cli, dan ejaan yang digunakan untuk membandingkan byte hasil resolusi. Digest dalam ejaan lain apa pun — heksadesimal polos tanpa awalan sha256:, huruf kapital, atau panjang yang berbeda — tidak akan pernah sama dengannya, sehingga ditolak saat file konfigurasi dimuat, dengan menyebutkan file dan entrinya. Digest ini menyematkan byte persis yang dijalankan perintah — resolusi berikutnya yang hash byte-nya berbeda akan menghentikan perintah — dan merupakan kunci ke cache describe yang merender bantuan perintah tanpa memuat guest. Pola: ^sha256:[0-9a-f]{64}$. |
Properti tambahan tidak diizinkan.
PluginRefWith
Input opsional pada saat pemasangan yang dibaca oleh plugin. Kedua anggota bersifat opsional dan permukaannya bersifat umum, sehingga socket mana pun dapat menggunakannya kembali.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
sources | string[] | tidak | Path file definisi yang dibaca host pada saat kompilasi dan diserahkan kepada plugin. Setiap entri adalah path sistem file yang diresolusi relatif terhadap direktori file konfigurasi yang mendeklarasikannya. |
settings | object | tidak | Objek pengaturan bentuk bebas yang diserahkan kepada plugin apa adanya. Host tidak menafsirkan bentuknya; plugin menentukan kunci yang dibacanya. |
Properti tambahan tidak diizinkan.