Skema Aggrega Wasm Mutator Socket
Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.
ID skema: https://aggrega.ai/schemas/wasm-mutator-v1beta1.schema.json
Bentuk wire yang dikonsumsi (MutatorInput) dan dihasilkan (MutatorOutput) oleh plugin tata kelola yang dipasang pada peran label-transform. Peran ini berjalan saat konstruksi topologi, setelah graf dibangun dan sebelum graf dinilai: plugin mengembalikan dokumen JSON Patch, dan host menerapkannya pada label node dan tidak pada hal lain, serta menghentikan build pada patch yang menjangkau bagian lain mana pun dari graf. Tipe payload Go, Rust, dan TypeScript dihasilkan dari skema ini ke dalam paket plugin-ABI, sehingga ketiga bahasa membaca dan menulis satu wire yang sama; guest mengimpornya dari paket tersebut, atau melalui kit plugin-nya jika kit tersebut mengekspor ulang tipe-tipe itu.
Salah satu dari bentuk berikut
MutatorInputMutatorOutput
Definisi
MutatorInput
Payload yang diserahkan host kepada plugin mutator pada setiap pemanggilan: konteks kompilasi tingkat rilis ditambah proyeksi graf topologi yang membawa label setiap node dan nilai yang dideklarasikan instance-nya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
compilation_context | CompilationContext | ya | Metadata tingkat Release yang dibaca oleh mutator saat menentukan aturan kepatuhan, FinOps, atau tata kelola mana yang berlaku untuk build. |
graph | MutatorGraph | ya | Proyeksi graf topologi yang diekspos ke plugin mutator: Component setiap node, versinya yang telah di-resolve, labelnya, dan nilai yang dideklarasikan instance-nya. Sengaja dibuat lebih sempit daripada hasil topologi lengkap: edge dan payload fitur tidak diekspos karena tugas mutator adalah pelabelan, bukan pembentukan ulang topologi. Nilai-nilai tersebut ada untuk dibaca, sehingga konfigurasi yang dideklarasikan developer dapat menentukan label; patch hanya menjangkau label dan tidak yang lain, sehingga plugin tidak dapat mengubah nilai tersebut. |
sources | MutatorSource[] | tidak | Berkas definisi yang dibaca host dan diserahkan kepada plugin apa adanya, sebagai daftar berurutan yang diurutkan menurut path. Host membaca byte tersebut sebagai konten buram dan tidak mem-parse-nya. Tidak ada jika lampiran tidak mendeklarasikan sumber. |
settings | object | tidak | Objek pengaturan bebas yang diserahkan host kepada plugin apa adanya. Host tidak mem-parse atau menindaklanjuti isinya. Tidak ada jika lampiran tidak mendeklarasikan pengaturan. |
Properti tambahan tidak diizinkan.
MutatorOutput
Bentuk respons yang dihasilkan plugin mutator: daftar dokumen JSON Patch opak yang diterapkan host pada graf topologi. Patch tetap opak di lapisan skema sehingga host tidak perlu menduplikasi parser JSON Patch yang sudah diimplementasikan oleh guest.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
patches | any[] | ya | Dokumen JSON Patch opak yang diterapkan pada graf topologi, secara berurutan. |
error | string | tidak | Pesan kegagalan yang ditetapkan ketika guest berjalan tetapi tidak dapat menyelesaikan operasinya; tidak ada jika berhasil. Host menampilkan error yang ada sebagai pemanggilan plugin yang gagal. |
Properti tambahan tidak diizinkan.
CompilationContext
Metadata tingkat Release yang dibaca oleh mutator saat menentukan aturan kepatuhan, FinOps, atau tata kelola mana yang berlaku untuk build.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
release_name | string | ya | metadata.name dari Release. |
environment | string | ya | Label lingkungan tempat Release berjalan (misalnya, dev, staging, prod). |
Properti tambahan tidak diizinkan.
MutatorGraph
Proyeksi graf topologi yang diekspos ke plugin mutator: Component setiap node, versinya yang telah di-resolve, labelnya, dan nilai yang dideklarasikan instance-nya. Sengaja dibuat lebih sempit daripada hasil topologi lengkap: edge dan payload fitur tidak diekspos karena tugas mutator adalah pelabelan, bukan pembentukan ulang topologi. Nilai-nilai tersebut ada untuk dibaca, sehingga konfigurasi yang dideklarasikan developer dapat menentukan label; patch hanya menjangkau label dan tidak yang lain, sehingga plugin tidak dapat mengubah nilai tersebut.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
nodes | map of MutatorNode | ya | Node dengan kunci berupa ID node absolut. |
Properti tambahan tidak diizinkan.
MutatorNode
Proyeksi per node yang menjadi dasar plugin mutator mengevaluasi aturannya: Component mana yang diimplementasikan node, versi Component tersebut yang di-resolve, label apa saja yang dimiliki node, dan nilai apa saja yang dideklarasikan instance-nya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
component | string | ya | Nama Component dasar yang diinstansiasi oleh node. |
resolved_version | string | ya | Semantic Version yang persis dari Component yang dipatok resolver untuk node ini. |
labels | map of string | ya | Label duck-typing dan ontologi milik node. |
values | object | tidak | Nilai yang dideklarasikan instance komponen node dalam Aggregate, dengan kunci sebagaimana ditulis penulis dan dalam urutan penulis. Setiap template dalam Aggregate telah dievaluasi terhadap parameternya, sehingga nilai yang diangkat menjadi parameter tiba sebagai nilai yang diberikan Release, atau sebagai default parameter tersebut. Hanya nilai milik instance itu sendiri yang ada di sini: default yang dideklarasikan skema Component, dan apa pun yang dikontribusikan Recipe atau Feature, tidak termasuk. Nilai yang dideklarasikan sensitif oleh Component tiba dalam keadaan ditahan, persis seperti putusan tata kelola atas seluruh graf menerimanya: di tempatnya terdapat objek penanda penahanan berkunci tunggal yang sama dengan yang dibawa putusan tersebut, yang menyebutkan alasan yang dideklarasikan, sedangkan nilai sejajar yang tidak dijangkau deklarasi apa pun tiba sebagaimana ditulis. Plugin membacanya untuk memutuskan label mana yang ditambahkan; patch tidak dapat menjangkaunya. Tidak ada jika instance tidak mendeklarasikan nilai. |
Properti tambahan tidak diizinkan.
MutatorSource
Satu berkas definisi yang diserahkan kepada plugin: path nama dasarnya dan isi berkas. Keduanya dibawa apa adanya; host tidak mem-parse isinya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
path | string | ya | Nama dasar berkas sumber. Host hanya menyediakan nama dasar, tidak pernah path host absolut, sehingga wire bersifat portabel dan deterministik. |
content | string | ya | Isi berkas sumber, dibawa apa adanya sebagai string buram. |
Properti tambahan tidak diizinkan.