Skema Aggrega Wasm Policy Socket
Referensi yang dihasilkan. Jangan diedit secara manual — hasilkan ulang dari JSON Schema yang dipublikasikan.
Id skema: https://aggrega.ai/schemas/wasm-policy-v1beta1.schema.json
Bentuk wire yang dikonsumsi plugin tata kelola yang dipasang pada peran putusan — PolicyInput pada peran ir-verdict, RenderPolicyInput pada peran render-verdict — dan yang dihasilkannya (PolicyOutput). Putusan dengan tingkat keparahan halt menghentikan build dengan diagnostik waktu build; putusan warn atau info dilaporkan dan build berlanjut. Graf input tahap IR adalah graf IR lengkap yang agnostik terhadap kapabilitas, dirujuk dari ir-v1beta1.schema.json alih-alih dideklarasikan ulang di sini, sehingga plugin kebijakan melihat detail node, edge, dan attachment yang sama dengan yang dilihat compiler; penulis plugin mengikuti versi skema IR. Input tahap render membawa file output yang dirender alih-alih 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
PolicyInputRenderPolicyInputPolicyOutput
Definisi
PolicyInput
Payload yang diserahkan analisis statis ke socket kebijakan: graf IR lengkap (bentuk yang sama dengan yang dikeluarkan Topology Builder) ditambah jalur routing yang telah dihitung sebelumnya, yang dienumerasi oleh analyzer bersamaan dengannya.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
graph | IRGraph | ya | Graf IR lengkap yang agnostik terhadap kapabilitas, bersumber tunggal dari ir-v1beta1.schema.json. Plugin kebijakan menalar atas detail node/edge/attachment yang lengkap, bukan proyeksi yang sempit. |
precalculated_paths | PrecalculatedPath[] | ya | Jalur routing yang telah dienumerasi sebelumnya oleh analyzer sehingga kebijakan dapat menalar keterjangkauan tanpa menelusuri ulang graf. |
sources | PolicySource[] | tidak | File definisi yang dibaca host pada waktu kompilasi dan diserahkan ke plugin apa adanya, sebagai daftar berurutan yang diurutkan berdasarkan path. Host membaca byte sebagai konten buram dan tidak mem-parse-nya. Tidak ada jika attachment 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.
PolicyOutput
Bentuk respons yang dikeluarkan plugin kebijakan: putusan yang terpicu selama evaluasi, satu diagnostik per putusan yang terpicu. Aturan yang mengizinkan tidak mengeluarkan apa pun, sehingga array results yang kosong berarti tidak ada putusan yang terpicu.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
results | Diagnostic[] | ya | Putusan yang terpicu, masing-masing satu diagnostik, dalam urutan plugin mengeluarkannya. Kosong jika tidak ada putusan yang terpicu. |
error | string | tidak | Pesan kegagalan yang diisi ketika guest berjalan tetapi tidak dapat menyelesaikan operasi; tidak ada jika berhasil. Ini berbeda dari diagnostik apa pun yang dibawa output: diagnostik melaporkan masalah yang ditemukan selama run yang tetap menghasilkan hasil, sedangkan error melaporkan bahwa operasi itu sendiri tidak selesai. Host menampilkan error yang ada sebagai pemanggilan plugin yang gagal. |
Properti tambahan tidak diizinkan.
RenderPolicyInput
Payload yang diterima plugin tata kelola yang dipasang pada peran render-verdict: file output yang dirender yang menjadi dasar penalaran kebijakan, sebagai pengganti graf IR.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
artifacts | RenderedArtifact[] | ya | File output yang dirender yang menjadi dasar penalaran kebijakan, sebagai daftar berurutan yang diurutkan berdasarkan path sehingga wire identik per byte di setiap eksekusi dengan input yang identik. |
sources | PolicySource[] | tidak | File definisi yang dibaca host pada waktu kompilasi dan diserahkan ke plugin apa adanya, sebagai daftar berurutan yang diurutkan berdasarkan path. Host membaca byte sebagai konten buram dan tidak mem-parse-nya. Tidak ada jika attachment 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.
RenderedArtifact
Satu file output yang dirender: path-nya dan konten yang dirender pada path tersebut.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
path | string | ya | Path output file yang dirender, relatif terhadap root render. |
content | string | ya | Konten yang dirender pada path ini. |
tree | any | tidak | Pohon terstruktur hasil parse dari artefak ini, ada jika host mem-parse konten sebelum menyerahkannya ke plugin — tampilan JSON kanonis dari format sumber yang tidak dibaca plugin secara native (misalnya artefak HCL yang di-parse ke JSON). Tingkat teratas dapat berupa object, array, atau skalar, sesuai dengan bentuk dokumen hasil parse itu sendiri. Tidak ada jika host tidak mem-parse artefak, dalam hal ini plugin membaca konten native secara langsung. Host meneruskan pohon secara buram, membawanya apa adanya tanpa menafsirkan kontennya. |
format | string | tidak | Format yang digunakan untuk merender artefak, ada jika provider yang menghasilkannya mendeklarasikannya. Tidak ada jika provider yang menghasilkannya tidak mendeklarasikan format. |
Properti tambahan tidak diizinkan.
PolicySource
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.
PrecalculatedPath
Satu jalur routing yang telah dienumerasi sebelumnya, yang diwujudkan oleh analyzer sehingga aturan kebijakan dapat menalar keterjangkauan tanpa menelusuri ulang graf.
| Properti | Jenis | Wajib | Deskripsi |
|---|---|---|---|
path_id | string | ya | Pengidentifikasi stabil untuk jalur ini; deterministik di setiap eksekusi dengan input yang identik. |
nodes | string[] | ya | Urutan ID node yang dilalui jalur, dari sumber ke terminal. |
attached_features | string[] | ya | Gabungan URI tipe Feature yang diurutkan secara alfabetis, yang terpasang pada node mana pun di sepanjang jalur. Semantik keanggotaan himpunan: sebuah Feature muncul sekali meskipun beberapa node membawanya. Kosong jika tidak ada node di sepanjang jalur yang membawa attachment Feature apa pun. |
Properti tambahan tidak diizinkan.