Esquema do socket Wasm de mutador do Aggrega
Referência gerada. Não edite à mão — gere novamente a partir do JSON Schema publicado.
ID do esquema: https://aggrega.ai/schemas/wasm-mutator-v1beta1.schema.json
As formas de transmissão que um plugin de governança vinculado ao papel label-transform consome (MutatorInput) e emite (MutatorOutput). O papel é executado na construção da topologia, depois que o grafo é construído e antes de ele ser julgado: o plugin retorna documentos JSON Patch, e o host os aplica aos rótulos dos nós e a nada mais, interrompendo o build diante de um patch que alcance qualquer outra parte do grafo. Os tipos de payload de Go, Rust e TypeScript são gerados a partir deste esquema nos pacotes da ABI de plugins, de modo que as três linguagens leem e escrevem o mesmo formato de transmissão; um guest os importa desses pacotes, ou por meio do seu kit de plugins quando o kit os reexporta.
Uma das seguintes formas
MutatorInputMutatorOutput
Definições
MutatorInput
O payload que o host entrega ao plugin mutador a cada invocação: o contexto de compilação no nível da release mais uma projeção do grafo de topologia que carrega os rótulos de cada nó e os valores que a sua instância declara.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
compilation_context | CompilationContext | sim | Metadados no nível da Release que o mutador lê ao decidir quais regras de conformidade, FinOps ou governança se aplicam ao build. |
graph | MutatorGraph | sim | A projeção do grafo de topologia exposta ao plugin mutador: o Component de cada nó, a sua versão resolvida, os seus rótulos e os valores que a sua instância declara. Intencionalmente mais estreita que o resultado completo da topologia: as arestas e os payloads de features não são expostos porque a tarefa do mutador é a rotulagem, não a remodelagem da topologia. Os valores estão ali para ser lidos, de modo que uma configuração que o desenvolvedor declarou pode decidir um rótulo; um patch alcança os rótulos e nada mais, por isso o plugin não pode alterar os valores. |
sources | MutatorSource[] | não | Arquivos de definição que o host lê e entrega literalmente ao plugin, como uma lista ordenada por caminho. O host lê os bytes como conteúdo opaco e não os analisa. Ausente quando a vinculação não declara origens. |
settings | object | não | Um objeto de configurações de formato livre que o host entrega literalmente ao plugin. O host não analisa o seu conteúdo nem age com base nele. Ausente quando a vinculação não declara configurações. |
Não são permitidas propriedades adicionais.
MutatorOutput
A forma de resposta que o plugin mutador emite: uma lista de documentos JSON Patch opacos que o host aplica ao grafo de topologia. Os patches permanecem opacos na camada do esquema para que o host não precise duplicar o analisador de JSON Patch que o guest já implementa.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
patches | any[] | sim | Documentos JSON Patch opacos a aplicar ao grafo de topologia, em ordem. |
error | string | não | Uma mensagem de falha definida quando o guest foi executado, mas não conseguiu concluir a operação; ausente em caso de sucesso. O host apresenta um erro presente como uma invocação de plugin com falha. |
Não são permitidas propriedades adicionais.
CompilationContext
Metadados no nível da Release que o mutador lê ao decidir quais regras de conformidade, FinOps ou governança se aplicam ao build.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
release_name | string | sim | O metadata.name da Release. |
environment | string | sim | O rótulo de ambiente sob o qual a Release é executada (por exemplo, dev, staging, prod). |
Não são permitidas propriedades adicionais.
MutatorGraph
A projeção do grafo de topologia exposta ao plugin mutador: o Component de cada nó, a sua versão resolvida, os seus rótulos e os valores que a sua instância declara. Intencionalmente mais estreita que o resultado completo da topologia: as arestas e os payloads de features não são expostos porque a tarefa do mutador é a rotulagem, não a remodelagem da topologia. Os valores estão ali para ser lidos, de modo que uma configuração que o desenvolvedor declarou pode decidir um rótulo; um patch alcança os rótulos e nada mais, por isso o plugin não pode alterar os valores.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
nodes | mapa de MutatorNode | sim | Nós indexados por ID absoluto do nó. |
Não são permitidas propriedades adicionais.
MutatorNode
A projeção por nó com base na qual o plugin mutador avalia as suas regras: qual Component o nó implementa, qual versão desse Component foi resolvida, quais rótulos o nó carrega e quais valores a sua instância declara.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
component | string | sim | O nome do Component subjacente que o nó instancia. |
resolved_version | string | sim | A versão semântica exata do Component que o resolvedor fixou para este nó. |
labels | mapa de string | sim | Os rótulos de duck-typing e de ontologia do nó. |
values | object | não | Os valores que a instância de componente do nó declara no Aggregate, indexados como o autor os escreveu e na ordem do autor. Todo template no Aggregate já foi avaliado com base nos seus parâmetros, de modo que um valor elevado a um parâmetro chega como o valor que a Release forneceu, ou como o valor padrão do parâmetro. Aqui estão apenas os valores próprios da instância: um valor padrão que o esquema do Component declara, e tudo o que uma Recipe ou uma Feature contribui, não estão. Um valor que o Component declara sensível chega retido, exatamente como o veredito de governança sobre todo o grafo o recebe: no seu lugar fica o mesmo objeto marcador de valor retido de chave única que esse veredito carrega, nomeando o motivo declarado, e um valor irmão que nenhuma declaração alcança chega como está escrito. Um plugin os lê para decidir quais rótulos adicionar; um patch não pode alcançá-los. Ausente quando a instância não declara nenhum valor. |
Não são permitidas propriedades adicionais.
MutatorSource
Um arquivo de definição entregue ao plugin: o seu caminho de nome base e o conteúdo do arquivo. Ambos são carregados literalmente; o host não analisa o conteúdo.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
path | string | sim | O nome base do arquivo de origem. O host fornece apenas o nome base, nunca um caminho absoluto do host, de modo que o formato de transmissão é portável e determinístico. |
content | string | sim | O conteúdo do arquivo de origem, carregado literalmente como uma string opaca. |
Não são permitidas propriedades adicionais.