Lewati ke konten
AggregaAggrega
Pilih Bahasa: Bahasa Indonesia
Halaman ini diterjemahkan oleh mesin. Baca versi asli dalam bahasa Inggris.

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

  • PolicyInput
  • RenderPolicyInput
  • PolicyOutput

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.

PropertiJenisWajibDeskripsi
graphIRGraphyaGraf 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_pathsPrecalculatedPath[]yaJalur routing yang telah dienumerasi sebelumnya oleh analyzer sehingga kebijakan dapat menalar keterjangkauan tanpa menelusuri ulang graf.
sourcesPolicySource[]tidakFile 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.
settingsobjecttidakObjek 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.

PropertiJenisWajibDeskripsi
resultsDiagnostic[]yaPutusan yang terpicu, masing-masing satu diagnostik, dalam urutan plugin mengeluarkannya. Kosong jika tidak ada putusan yang terpicu.
errorstringtidakPesan 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.

PropertiJenisWajibDeskripsi
artifactsRenderedArtifact[]yaFile 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.
sourcesPolicySource[]tidakFile 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.
settingsobjecttidakObjek 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.

PropertiJenisWajibDeskripsi
pathstringyaPath output file yang dirender, relatif terhadap root render.
contentstringyaKonten yang dirender pada path ini.
treeanytidakPohon 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.
formatstringtidakFormat 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.

PropertiJenisWajibDeskripsi
pathstringyaNama dasar berkas sumber. Host hanya menyediakan nama dasar, tidak pernah path host absolut, sehingga wire bersifat portabel dan deterministik.
contentstringyaIsi 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.

PropertiJenisWajibDeskripsi
path_idstringyaPengidentifikasi stabil untuk jalur ini; deterministik di setiap eksekusi dengan input yang identik.
nodesstring[]yaUrutan ID node yang dilalui jalur, dari sumber ke terminal.
attached_featuresstring[]yaGabungan 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.