Aggrega Wasm Policy Socket şeması
Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.
Şema kimliği: https://aggrega.ai/schemas/wasm-policy-v1beta1.schema.json
Bir karar rolüne bağlanan bir yönetişim eklentisinin tükettiği (ir-verdict rolünde PolicyInput, render-verdict rolünde RenderPolicyInput) ve ürettiği (PolicyOutput) iletim biçimleri. halt önem derecesindeki bir karar, derleme zamanı tanılamasıyla derlemeyi durdurur; warn ya da info kararı bildirilir ve derleme devam eder. IR aşamasının girdi grafı, yeteneklerden bağımsız tam IR grafıdır ve burada yeniden bildirilmek yerine ir-v1beta1.schema.json’dan başvurulur; böylece policy eklentisi derleyicinin gördüğü düğüm, kenar ve ek ayrıntısının aynısını görür; eklenti yazarları IR şeması sürümünü takip eder. Render aşaması girdisi graf yerine render edilmiş çıktı dosyalarını taşır. Go, Rust ve TypeScript yük türleri bu şemadan plugin-ABI paketlerine üretilir; böylece üç dil tek bir iletim biçimini okur ve yazar; bir konuk bunları bu paketlerden ya da kit bunları yeniden dışa aktarıyorsa eklenti kiti üzerinden içe aktarır.
Aşağıdaki biçimlerden biri
PolicyInputRenderPolicyInputPolicyOutput
Tanımlar
PolicyInput
Statik analizin policy soketine verdiği yük: tam IR grafı (Topology Builder’ın ürettiği biçimin aynısı) ve analizcinin bunun yanında sıraladığı önceden hesaplanmış yönlendirme yolları.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
graph | IRGraph | evet | Yeteneklerden bağımsız, tek kaynağı ir-v1beta1.schema.json olan tam IR grafı. Policy eklentisi dar bir izdüşüm yerine eksiksiz düğüm/kenar/ek ayrıntısı üzerinde akıl yürütür. |
precalculated_paths | PrecalculatedPath[] | evet | Policy’lerin grafı yeniden dolaşmadan erişilebilirlik hakkında akıl yürütebilmesi için analizcinin önceden sıraladığı yönlendirme yolları. |
sources | PolicySource[] | hayır | Ana makinenin derleme zamanında okuyup eklentiye olduğu gibi verdiği, yola göre sıralanmış sıralı bir liste olarak tanım dosyaları. Ana makine baytları opak içerik olarak okur ve ayrıştırmaz. Ek hiçbir kaynak bildirmediğinde bulunmaz. |
settings | object | hayır | Ana makinenin eklentiye olduğu gibi verdiği serbest biçimli bir ayarlar nesnesi. Ana makine içeriğini ayrıştırmaz ve ona göre işlem yapmaz. Ek hiçbir ayar bildirmediğinde bulunmaz. |
Ek özelliklere izin verilmez.
PolicyOutput
Policy eklentisinin ürettiği yanıt biçimi: değerlendirme sırasında tetiklenen kararlar, tetiklenen her karar için bir tanılama. İzin veren bir kural hiçbir şey üretmez; bu nedenle boş bir results dizisi hiçbir kararın tetiklenmediği anlamına gelir.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
results | Diagnostic[] | evet | Eklentinin ürettiği sırayla, her biri için bir tanılama olacak şekilde tetiklenen kararlar. Hiçbir karar tetiklenmediğinde boştur. |
error | string | hayır | Konuk çalıştığı hâlde işlemi tamamlayamadığında ayarlanan bir hata mesajı; başarı durumunda bulunmaz. Çıktının taşıdığı tanılamalardan farklıdır: tanılamalar yine de bir sonuç üreten bir çalıştırma sırasında bulunan sorunları bildirirken error, işlemin kendisinin tamamlanmadığını bildirir. Ana makine, mevcut bir error’u başarısız bir eklenti çağrısı olarak yansıtır. |
Ek özelliklere izin verilmez.
RenderPolicyInput
render-verdict rolüne bağlanan bir yönetişim eklentisinin aldığı yük: IR grafı yerine, policy’nin üzerinde akıl yürüttüğü render edilmiş çıktı dosyaları.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
artifacts | RenderedArtifact[] | evet | Policy’nin üzerinde akıl yürüttüğü render edilmiş çıktı dosyaları; aynı girdinin çalıştırmaları arasında iletimin bayt bayt aynı olması için yola göre sıralanmış sıralı bir liste olarak. |
sources | PolicySource[] | hayır | Ana makinenin derleme zamanında okuyup eklentiye olduğu gibi verdiği, yola göre sıralanmış sıralı bir liste olarak tanım dosyaları. Ana makine baytları opak içerik olarak okur ve ayrıştırmaz. Ek hiçbir kaynak bildirmediğinde bulunmaz. |
settings | object | hayır | Ana makinenin eklentiye olduğu gibi verdiği serbest biçimli bir ayarlar nesnesi. Ana makine içeriğini ayrıştırmaz ve ona göre işlem yapmaz. Ek hiçbir ayar bildirmediğinde bulunmaz. |
Ek özelliklere izin verilmez.
RenderedArtifact
Render edilmiş tek bir çıktı dosyası: yolu ve o yoldaki render edilmiş içerik.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
path | string | evet | Render edilmiş dosyanın, render köküne göreli çıktı yolu. |
content | string | evet | Bu yoldaki render edilmiş içerik. |
tree | herhangi | hayır | Bu yapıtın ayrıştırılmış yapılandırılmış ağacı; ana makine içeriği eklentiye vermeden önce ayrıştırdığında bulunur — eklentinin doğal olarak okumadığı bir kaynak biçiminin kanonik JSON görünümü (örneğin JSON’a ayrıştırılmış bir HCL yapıtı). Üst düzey, ayrıştırılmış belgenin kendi biçimine uygun olarak bir nesne, bir dizi veya bir skaler olabilir. Ana makine yapıtı ayrıştırmadığında bulunmaz; bu durumda eklenti doğal içeriği doğrudan okur. Ana makine ağacı opak biçimde iletir; içeriğini yorumlamadan olduğu gibi taşır. |
format | string | hayır | Yapıtın render edildiği biçim; üreten provider bunu bildirdiğinde bulunur. Üreten provider hiçbir biçim bildirmediğinde bulunmaz. |
Ek özelliklere izin verilmez.
PolicySource
Eklentiye verilen tek bir tanım dosyası: temel ad yolu ve dosyanın içeriği. İkisi de olduğu gibi taşınır; ana makine içeriği ayrıştırmaz.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
path | string | evet | Kaynak dosyanın temel adı. Ana makine hiçbir zaman mutlak bir ana makine yolu değil, yalnızca temel adı sağlar; böylece iletim taşınabilir ve belirlenimci olur. |
content | string | evet | Kaynak dosyanın opak bir string olarak olduğu gibi taşınan içeriği. |
Ek özelliklere izin verilmez.
PrecalculatedPath
Policy kurallarının grafı yeniden dolaşmadan erişilebilirlik hakkında akıl yürütebilmesi için analizcinin somutlaştırdığı, önceden sıralanmış tek bir yönlendirme yolu.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
path_id | string | evet | Bu yol için kararlı tanımlayıcı; aynı girdinin çalıştırmaları arasında belirlenimcidir. |
nodes | string[] | evet | Yolun kaynaktan uç noktaya kadar geçtiği düğüm kimliklerinin sıralı dizisi. |
attached_features | string[] | evet | Yol boyunca herhangi bir düğüme eklenmiş Feature tür URI’lerinin alfabetik olarak sıralanmış birleşimi. Küme üyeliği semantiği: bir Feature, birden çok düğüm taşısa bile bir kez görünür. Yol boyunca hiçbir düğüm herhangi bir Feature eki taşımadığında boştur. |
Ek özelliklere izin verilmez.