Esquema del socket Wasm de mutador de Aggrega
Referencia generada. No la edites a mano — regenérala a partir del JSON Schema publicado.
ID del esquema: https://aggrega.ai/schemas/wasm-mutator-v1beta1.schema.json
Las formas de transmisión que consume (MutatorInput) y emite (MutatorOutput) un plugin de gobernanza vinculado al rol label-transform. El rol se ejecuta en la construcción de la topología, después de construir el grafo y antes de juzgarlo: el plugin devuelve documentos JSON Patch, y el host los aplica a las etiquetas de los nodos y a nada más, deteniendo el build ante un parche que alcance cualquier otra parte del grafo. Los tipos de payload de Go, Rust y TypeScript se generan a partir de este esquema en los paquetes de la ABI de plugins, de modo que los tres lenguajes leen y escriben el mismo formato de transmisión; un guest los importa desde esos paquetes, o a través de su kit de plugins cuando el kit los reexporta.
Una de las siguientes formas
MutatorInputMutatorOutput
Definiciones
MutatorInput
El payload que el host entrega al plugin mutador en cada invocación: el contexto de compilación a nivel de release más una proyección del grafo de topología que lleva las etiquetas de cada nodo y los valores que declara su instancia.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
compilation_context | CompilationContext | sí | Metadatos a nivel de Release que lee el mutador al decidir qué reglas de cumplimiento, FinOps o gobernanza se aplican al build. |
graph | MutatorGraph | sí | La proyección del grafo de topología expuesta al plugin mutador: el Component de cada nodo, su versión resuelta, sus etiquetas y los valores que declara su instancia. Intencionadamente más estrecha que el resultado completo de la topología: las aristas y los payloads de features no se exponen porque la tarea del mutador es etiquetar, no remodelar la topología. Los valores están ahí para leerse, de modo que una configuración que declaró el desarrollador puede decidir una etiqueta; un parche alcanza las etiquetas y nada más, por lo que el plugin no puede cambiar los valores. |
sources | MutatorSource[] | no | Archivos de definición que el host lee y entrega literalmente al plugin, como una lista ordenada por ruta. El host lee los bytes como contenido opaco y no los analiza. Ausente cuando la vinculación no declara fuentes. |
settings | object | no | Un objeto de ajustes de forma libre que el host entrega literalmente al plugin. El host no analiza su contenido ni actúa según él. Ausente cuando la vinculación no declara ajustes. |
No se permiten propiedades adicionales.
MutatorOutput
La forma de respuesta que emite el plugin mutador: una lista de documentos JSON Patch opacos que el host aplica al grafo de topología. Los parches se mantienen opacos en la capa del esquema para que el host no tenga que duplicar el analizador de JSON Patch que el guest ya implementa.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
patches | any[] | sí | Documentos JSON Patch opacos que se aplican al grafo de topología, en orden. |
error | string | no | Un mensaje de error que se establece cuando el guest se ejecutó pero no pudo completar la operación; ausente en caso de éxito. El host presenta un error presente como una invocación de plugin fallida. |
No se permiten propiedades adicionales.
CompilationContext
Metadatos a nivel de Release que lee el mutador al decidir qué reglas de cumplimiento, FinOps o gobernanza se aplican al build.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
release_name | string | sí | El metadata.name de la Release. |
environment | string | sí | La etiqueta de entorno bajo la que se ejecuta la Release (p. ej., dev, staging, prod). |
No se permiten propiedades adicionales.
MutatorGraph
La proyección del grafo de topología expuesta al plugin mutador: el Component de cada nodo, su versión resuelta, sus etiquetas y los valores que declara su instancia. Intencionadamente más estrecha que el resultado completo de la topología: las aristas y los payloads de features no se exponen porque la tarea del mutador es etiquetar, no remodelar la topología. Los valores están ahí para leerse, de modo que una configuración que declaró el desarrollador puede decidir una etiqueta; un parche alcanza las etiquetas y nada más, por lo que el plugin no puede cambiar los valores.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
nodes | mapa de MutatorNode | sí | Nodos indexados por ID absoluto de nodo. |
No se permiten propiedades adicionales.
MutatorNode
La proyección por nodo con la que el plugin mutador evalúa sus reglas: qué Component implementa el nodo, qué versión de ese Component se resolvió, qué etiquetas lleva el nodo y qué valores declara su instancia.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
component | string | sí | El nombre del Component subyacente que instancia el nodo. |
resolved_version | string | sí | La versión semántica exacta del Component que el resolvedor fijó para este nodo. |
labels | mapa de string | sí | Las etiquetas de duck-typing y de ontología del nodo. |
values | object | no | Los valores que la instancia de componente del nodo declara en el Aggregate, indexados tal como los escribió el autor y en el orden del autor. Cada plantilla del Aggregate ya se ha evaluado con sus parámetros, de modo que un valor elevado a un parámetro llega como el valor que proporcionó la Release, o como el valor predeterminado del parámetro. Aquí solo están los valores propios de la instancia: un valor predeterminado que declara el esquema del Component, y todo lo que aporta una Recipe o una Feature, no están. Un valor que el Component declara sensible llega retenido, exactamente como lo recibe el veredicto de gobernanza sobre todo el grafo: en su lugar está el mismo objeto marcador de valor retenido de una sola clave que lleva ese veredicto, que nombra el motivo declarado, y un valor hermano al que no llega ninguna declaración llega tal como está escrito. Un plugin los lee para decidir qué etiquetas añadir; un parche no puede alcanzarlos. Ausente cuando la instancia no declara ningún valor. |
No se permiten propiedades adicionales.
MutatorSource
Un archivo de definición entregado al plugin: su ruta de nombre base y el contenido del archivo. Ambos se llevan literalmente; el host no analiza el contenido.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
path | string | sí | El nombre base del archivo de origen. El host proporciona solo el nombre base, nunca una ruta absoluta del host, de modo que el formato de transmisión es portable y determinista. |
content | string | sí | El contenido del archivo de origen, llevado literalmente como una cadena opaca. |
No se permiten propiedades adicionales.