Schema del socket Wasm del mutatore di Aggrega
Riferimento generato. Non modificarlo a mano — rigeneralo a partire dal JSON Schema pubblicato.
Id dello schema: https://aggrega.ai/schemas/wasm-mutator-v1beta1.schema.json
Le forme di trasmissione che un plugin di governance associato al ruolo label-transform consuma (MutatorInput) ed emette (MutatorOutput). Il ruolo viene eseguito alla costruzione della topologia, dopo che il grafo è stato costruito e prima che venga giudicato: il plugin restituisce documenti JSON Patch, e l’host li applica alle etichette dei nodi e a nient’altro, arrestando la build su una patch che raggiunge qualsiasi altra parte 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
MutatorInputMutatorOutput
Definizioni
MutatorInput
Il payload che l’host passa al plugin mutatore a ogni invocazione: il contesto di compilazione a livello di release più una proiezione del grafo della topologia che porta le etichette di ciascun nodo e i valori che la sua istanza dichiara.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
compilation_context | CompilationContext | sì | Metadati a livello di Release che il mutatore legge quando decide quali regole di conformità, FinOps o governance si applicano alla build. |
graph | MutatorGraph | sì | La proiezione del grafo della topologia esposta al plugin mutatore: il Component di ciascun nodo, la sua versione risolta, le sue etichette e i valori che la sua istanza dichiara. Intenzionalmente più ristretta del risultato completo della topologia: gli archi e i payload delle feature non sono esposti perché il compito del mutatore è l’etichettatura, non la rimodellazione della topologia. I valori sono lì per essere letti, così una configurazione dichiarata dallo sviluppatore può decidere un’etichetta; una patch raggiunge le etichette e nient’altro, quindi il plugin non può modificare i valori. |
sources | MutatorSource[] | no | File di definizione che l’host legge 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 alcuna 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.
MutatorOutput
La forma della risposta che il plugin mutatore emette: un elenco di documenti JSON Patch opachi che l’host applica al grafo della topologia. Le patch restano opache a livello dello schema, così l’host non deve duplicare il parser JSON Patch che il guest implementa già.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
patches | any[] | sì | Documenti JSON Patch opachi da applicare al grafo della topologia, in ordine. |
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. L’host presenta un errore presente come un’invocazione del plugin non riuscita. |
Non sono consentite proprietà aggiuntive.
CompilationContext
Metadati a livello di Release che il mutatore legge quando decide quali regole di conformità, FinOps o governance si applicano alla build.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
release_name | string | sì | Il metadata.name della Release. |
environment | string | sì | L’etichetta di ambiente sotto cui viene eseguita la Release (per esempio dev, staging, prod). |
Non sono consentite proprietà aggiuntive.
MutatorGraph
La proiezione del grafo della topologia esposta al plugin mutatore: il Component di ciascun nodo, la sua versione risolta, le sue etichette e i valori che la sua istanza dichiara. Intenzionalmente più ristretta del risultato completo della topologia: gli archi e i payload delle feature non sono esposti perché il compito del mutatore è l’etichettatura, non la rimodellazione della topologia. I valori sono lì per essere letti, così una configurazione dichiarata dallo sviluppatore può decidere un’etichetta; una patch raggiunge le etichette e nient’altro, quindi il plugin non può modificare i valori.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
nodes | mappa di MutatorNode | sì | Nodi indicizzati per ID assoluto del nodo. |
Non sono consentite proprietà aggiuntive.
MutatorNode
La proiezione per nodo rispetto a cui il plugin mutatore valuta le proprie regole: quale Component il nodo implementa, quale versione di quel Component è stata risolta, quali etichette porta il nodo e quali valori dichiara la sua istanza.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
component | string | sì | Il nome del Component sottostante che il nodo istanzia. |
resolved_version | string | sì | La versione semantica esatta del Component che il resolver ha fissato per questo nodo. |
labels | mappa di string | sì | Le etichette di duck-typing e di ontologia del nodo. |
values | object | no | I valori che l’istanza di componente del nodo dichiara nell’Aggregate, indicizzati come li ha scritti l’autore e nell’ordine dell’autore. Ogni template nell’Aggregate è già stato valutato rispetto ai suoi parametri, così un valore sollevato in un parametro arriva come il valore che la Release ha fornito, oppure come il valore predefinito del parametro. Qui ci sono solo i valori propri dell’istanza: un valore predefinito che lo schema del Component dichiara, e tutto ciò che una Recipe o una Feature apporta, non ci sono. Un valore che il Component dichiara sensibile arriva trattenuto, esattamente come lo riceve il verdetto di governance sull’intero grafo: al suo posto si trova lo stesso oggetto marcatore di valore trattenuto a chiave singola che quel verdetto porta, che nomina il motivo dichiarato, e un valore fratello che nessuna dichiarazione raggiunge arriva così come è scritto. Un plugin li legge per decidere quali etichette aggiungere; una patch non può raggiungerli. Assente quando l’istanza non dichiara alcun valore. |
Non sono consentite proprietà aggiuntive.
MutatorSource
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.