Esquema del socket Wasm de políticas 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-policy-v1beta1.schema.json
Las formas de transmisión que un plugin de gobernanza vinculado en un rol de veredicto consume — PolicyInput en el rol ir-verdict, RenderPolicyInput en el rol render-verdict — y emite (PolicyOutput). Un veredicto de severidad halt detiene el build con un diagnóstico en tiempo de build; un veredicto warn o info se informa y el build continúa. El grafo de entrada de la fase IR es el grafo IR completo, agnóstico respecto a las capacidades, referenciado desde ir-v1beta1.schema.json en lugar de volver a declararse aquí, de modo que el plugin de política ve el mismo detalle de nodos, aristas y vinculaciones que el compilador; los autores de plugins siguen la versión del esquema IR. La entrada de la fase de renderizado lleva los archivos de salida renderizados en lugar 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
PolicyInputRenderPolicyInputPolicyOutput
Definiciones
PolicyInput
El payload que el análisis estático entrega al socket de política: el grafo IR completo (la misma forma que emite el Topology Builder) más las rutas de enrutamiento precalculadas que el analizador enumera junto a él.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
graph | IRGraph | sí | El grafo IR completo, agnóstico respecto a las capacidades, con fuente única en ir-v1beta1.schema.json. El plugin de política razona sobre el detalle completo de nodos, aristas y vinculaciones en lugar de sobre una proyección estrecha. |
precalculated_paths | PrecalculatedPath[] | sí | Rutas de enrutamiento que el analizador enumeró de antemano para que las políticas puedan razonar sobre la alcanzabilidad sin volver a recorrer el grafo. |
sources | PolicySource[] | no | Archivos de definición que el host lee en tiempo de compilación y entrega al plugin tal cual, 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 ningún origen. |
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.
PolicyOutput
La forma de respuesta que emite el plugin de política: los veredictos que se activaron durante la evaluación, un diagnóstico por cada veredicto activado. Una regla que permite no emite nada, por lo que un array results vacío significa que no se activó ningún veredicto.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
results | Diagnostic[] | sí | Los veredictos activados, un diagnóstico cada uno, en el orden en que el plugin los emite. Vacío cuando no se activó ningún veredicto. |
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. Es distinto de cualquier diagnóstico que lleve la salida: los diagnósticos informan de problemas encontrados durante una ejecución que aun así produjo un resultado, mientras que error informa de que la propia operación no se completó. El host presenta un error presente como una invocación de plugin fallida. |
No se permiten propiedades adicionales.
RenderPolicyInput
El payload que recibe un plugin de gobernanza vinculado en el rol render-verdict: los archivos de salida renderizados sobre los que razona la política, en lugar del grafo IR.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
artifacts | RenderedArtifact[] | sí | Los archivos de salida renderizados sobre los que razona la política, como una lista ordenada por ruta para que el formato de transmisión sea idéntico byte a byte entre ejecuciones con entrada idéntica. |
sources | PolicySource[] | no | Archivos de definición que el host lee en tiempo de compilación y entrega al plugin tal cual, 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 ningún origen. |
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.
RenderedArtifact
Un archivo de salida renderizado: su ruta y el contenido renderizado en esa ruta.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
path | string | sí | La ruta de salida del archivo renderizado, relativa a la raíz de renderizado. |
content | string | sí | El contenido renderizado en esta ruta. |
tree | any | no | El árbol estructurado analizado de este artefacto, presente cuando el host analizó el contenido antes de entregarlo al plugin — la vista JSON canónica de un formato de origen que el plugin no lee de forma nativa (un artefacto HCL analizado a JSON, por ejemplo). El nivel superior puede ser un objeto, un array o un escalar, según la forma propia del documento analizado. Ausente cuando el host no analizó el artefacto, en cuyo caso el plugin lee directamente el contenido nativo. El host hace pasar el árbol de forma opaca, llevándolo tal cual sin interpretar su contenido. |
format | string | no | El formato en el que se renderizó el artefacto, presente cuando el proveedor que lo produjo lo declaró. Ausente cuando el proveedor que lo produjo no declaró ningún formato. |
No se permiten propiedades adicionales.
PolicySource
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.
PrecalculatedPath
Una ruta de enrutamiento enumerada de antemano que el analizador materializa para que las reglas de política puedan razonar sobre la alcanzabilidad sin volver a recorrer el grafo.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
path_id | string | sí | Identificador estable de esta ruta; determinista entre ejecuciones con entrada idéntica. |
nodes | string[] | sí | Secuencia ordenada de los ID de nodo que recorre la ruta, desde el origen hasta el terminal. |
attached_features | string[] | sí | Unión, ordenada alfabéticamente, de los URI de tipo de Feature vinculados a cualquier nodo a lo largo de la ruta. Semántica de pertenencia a un conjunto: una Feature aparece una sola vez aunque varios nodos la lleven. Vacía cuando ningún nodo a lo largo de la ruta lleva ninguna vinculación de Feature. |
No se permiten propiedades adicionales.