Schema del socket Wasm di policy di Aggrega
Riferimento generato. Non modificarlo a mano — rigeneralo a partire dal JSON Schema pubblicato.
Id dello schema: https://aggrega.ai/schemas/wasm-policy-v1beta1.schema.json
Le forme di trasmissione che un plugin di governance associato con un ruolo di verdetto consuma — PolicyInput nel ruolo ir-verdict, RenderPolicyInput nel ruolo render-verdict — ed emette (PolicyOutput). Un verdetto di gravità halt arresta la build con una diagnostica in fase di build; un verdetto warn o info viene riportato e la build prosegue. Il grafo di input della fase IR è il grafo IR completo, agnostico rispetto alle capacità, referenziato da ir-v1beta1.schema.json anziché ridichiarato qui, così il plugin di policy vede lo stesso dettaglio di nodi, archi e associazioni che vede il compilatore; gli autori di plugin seguono la versione dello schema IR. L’input della fase di rendering porta i file di output renderizzati al posto del grafo. I tipi di payload Go, Rust e TypeScript sono generati da questo schema nei pacchetti dell’ABI dei plugin, così i tre linguaggi leggono e scrivono lo stesso formato di trasmissione; un guest li importa da quei pacchetti, oppure tramite il suo kit per plugin dove il kit li riesporta.
Una delle forme seguenti
PolicyInputRenderPolicyInputPolicyOutput
Definizioni
PolicyInput
Il payload che l’analisi statica passa al socket di policy: il grafo IR completo (la stessa forma che emette il Topology Builder) più i percorsi di instradamento precalcolati che l’analizzatore enumera accanto a esso.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
graph | IRGraph | sì | Il grafo IR completo, agnostico rispetto alle capacità, con un’unica fonte in ir-v1beta1.schema.json. Il plugin di policy ragiona sul dettaglio completo di nodi, archi e associazioni anziché su una proiezione ristretta. |
precalculated_paths | PrecalculatedPath[] | sì | Percorsi di instradamento che l’analizzatore ha enumerato in anticipo, così le policy possono ragionare sulla raggiungibilità senza ripercorrere il grafo. |
sources | PolicySource[] | no | File di definizione che l’host legge in fase di compilazione e passa al plugin alla lettera, come elenco ordinato per percorso. L’host legge i byte come contenuto opaco e non li analizza. Assente quando l’associazione non dichiara alcun sorgente. |
settings | object | no | Un oggetto di impostazioni in forma libera che l’host passa al plugin alla lettera. L’host non ne analizza il contenuto né agisce su di esso. Assente quando l’associazione non dichiara alcuna impostazione. |
Non sono consentite proprietà aggiuntive.
PolicyOutput
La forma di risposta che il plugin di policy emette: i verdetti scattati durante la valutazione, una diagnostica per ogni verdetto scattato. Una regola che consente non emette nulla, quindi un array results vuoto significa che non è scattato alcun verdetto.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
results | Diagnostic[] | sì | I verdetti scattati, una diagnostica ciascuno, nell’ordine in cui il plugin li emette. Vuoto quando non è scattato alcun verdetto. |
error | string | no | Un messaggio di errore impostato quando il guest è stato eseguito ma non ha potuto completare l’operazione; assente in caso di successo. È distinto da qualsiasi diagnostica portata dall’output: le diagnostiche riportano problemi trovati durante un’esecuzione che ha comunque prodotto un risultato, mentre error riporta che l’operazione stessa non è stata completata. L’host presenta un errore presente come un’invocazione del plugin non riuscita. |
Non sono consentite proprietà aggiuntive.
RenderPolicyInput
Il payload che riceve un plugin di governance associato con il ruolo render-verdict: i file di output renderizzati su cui ragiona la policy, al posto del grafo IR.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
artifacts | RenderedArtifact[] | sì | I file di output renderizzati su cui ragiona la policy, come elenco ordinato per percorso, così il formato di trasmissione è identico byte per byte tra esecuzioni con input identico. |
sources | PolicySource[] | no | File di definizione che l’host legge in fase di compilazione e passa al plugin alla lettera, come elenco ordinato per percorso. L’host legge i byte come contenuto opaco e non li analizza. Assente quando l’associazione non dichiara alcun sorgente. |
settings | object | no | Un oggetto di impostazioni in forma libera che l’host passa al plugin alla lettera. L’host non ne analizza il contenuto né agisce su di esso. Assente quando l’associazione non dichiara alcuna impostazione. |
Non sono consentite proprietà aggiuntive.
RenderedArtifact
Un file di output renderizzato: il suo percorso e il contenuto renderizzato in quel percorso.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
path | string | sì | Il percorso di output del file renderizzato, relativo alla radice di rendering. |
content | string | sì | Il contenuto renderizzato in questo percorso. |
tree | any | no | L’albero strutturato analizzato di questo artefatto, presente quando l’host ha analizzato il contenuto prima di passarlo al plugin — la vista JSON canonica di un formato sorgente che il plugin non legge nativamente (un artefatto HCL analizzato in JSON, per esempio). Il livello superiore può essere un oggetto, un array o uno scalare, in corrispondenza della forma propria del documento analizzato. Assente quando l’host non ha analizzato l’artefatto, nel qual caso il plugin legge direttamente il contenuto nativo. L’host fa passare l’albero in modo opaco, portandolo alla lettera senza interpretarne il contenuto. |
format | string | no | Il formato in cui l’artefatto è stato renderizzato, presente quando il provider che lo ha prodotto lo ha dichiarato. Assente quando il provider che lo ha prodotto non ha dichiarato alcun formato. |
Non sono consentite proprietà aggiuntive.
PolicySource
Un file di definizione passato al plugin: il suo percorso con il nome base e il contenuto del file. Entrambi sono portati alla lettera; l’host non analizza il contenuto.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
path | string | sì | Il nome base del file sorgente. L’host fornisce solo il nome base, mai un percorso assoluto dell’host, così il formato di trasmissione è portabile e deterministico. |
content | string | sì | Il contenuto del file sorgente, portato alla lettera come stringa opaca. |
Non sono consentite proprietà aggiuntive.
PrecalculatedPath
Un percorso di instradamento enumerato in anticipo che l’analizzatore materializza, così le regole di policy possono ragionare sulla raggiungibilità senza ripercorrere il grafo.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
path_id | string | sì | Identificatore stabile di questo percorso; deterministico tra esecuzioni con input identico. |
nodes | string[] | sì | Sequenza ordinata degli ID dei nodi che il percorso attraversa, dall’origine al terminale. |
attached_features | string[] | sì | Unione ordinata alfabeticamente degli URI di tipo di Feature associati a qualsiasi nodo lungo il percorso. Semantica di appartenenza a un insieme: una Feature compare una sola volta anche se più nodi la portano. Vuota quando nessun nodo lungo il percorso porta alcuna associazione di Feature. |
Non sono consentite proprietà aggiuntive.