Schéma du socket Wasm de mutateur d’Aggrega
Référence générée. Ne pas modifier à la main — régénérer à partir du JSON Schema publié.
Identifiant du schéma : https://aggrega.ai/schemas/wasm-mutator-v1beta1.schema.json
Les formes de transmission qu’un plugin de gouvernance rattaché au rôle label-transform consomme (MutatorInput) et émet (MutatorOutput). Le rôle s’exécute lors de la construction de la topologie, après la construction du graphe et avant son évaluation : le plugin renvoie des documents JSON Patch, et l’hôte les applique aux labels des nœuds et à rien d’autre, en arrêtant le build sur un patch qui atteint toute autre partie du graphe. Les types de payload Go, Rust et TypeScript sont générés à partir de ce schéma dans les paquets de l’ABI des plugins, de sorte que les trois langages lisent et écrivent le même format de transmission ; un invité les importe depuis ces paquets, ou via son kit de plugin lorsque le kit les réexporte.
L’une des formes suivantes
MutatorInputMutatorOutput
Définitions
MutatorInput
Le payload que l’hôte remet au plugin mutateur à chaque invocation : le contexte de compilation au niveau de la release plus une projection du graphe de topologie portant les labels de chaque nœud et les valeurs que déclare son instance.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
compilation_context | CompilationContext | oui | Métadonnées au niveau de la Release que le mutateur lit lorsqu’il décide quelles règles de conformité, de FinOps ou de gouvernance s’appliquent au build. |
graph | MutatorGraph | oui | La projection du graphe de topologie exposée au plugin mutateur : le Component de chaque nœud, sa version résolue, ses labels et les valeurs que déclare son instance. Volontairement plus étroite que le résultat complet de la topologie : les arêtes et les payloads de features ne sont pas exposés, car le rôle du mutateur est l’étiquetage, et non le remodelage de la topologie. Les valeurs sont là pour être lues, de sorte qu’une configuration déclarée par le développeur peut décider d’un label ; un patch atteint les labels et rien d’autre, si bien que le plugin ne peut pas modifier les valeurs. |
sources | MutatorSource[] | non | Fichiers de définition que l’hôte lit et transmet tels quels au plugin, sous forme de liste ordonnée triée par chemin. L’hôte lit les octets comme un contenu opaque et ne les analyse pas. Absent lorsque le rattachement ne déclare aucune source. |
settings | object | non | Un objet de réglages libre que l’hôte transmet tel quel au plugin. L’hôte n’analyse pas son contenu et n’agit pas en fonction de celui-ci. Absent lorsque le rattachement ne déclare aucun réglage. |
Les propriétés supplémentaires ne sont pas autorisées.
MutatorOutput
La forme de réponse qu’émet le plugin mutateur : une liste de documents JSON Patch opaques que l’hôte applique au graphe de topologie. Les patchs restent opaques au niveau du schéma, de sorte que l’hôte n’a pas à dupliquer le parseur JSON Patch que l’invité implémente déjà.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
patches | any[] | oui | Documents JSON Patch opaques à appliquer au graphe de topologie, dans l’ordre. |
error | string | non | Un message d’échec défini lorsque l’invité s’est exécuté mais n’a pas pu terminer l’opération ; absent en cas de succès. L’hôte présente une erreur présente comme une invocation de plugin échouée. |
Les propriétés supplémentaires ne sont pas autorisées.
CompilationContext
Métadonnées au niveau de la Release que le mutateur lit lorsqu’il décide quelles règles de conformité, de FinOps ou de gouvernance s’appliquent au build.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
release_name | string | oui | Le metadata.name de la Release. |
environment | string | oui | Le label d’environnement sous lequel s’exécute la Release (par exemple dev, staging, prod). |
Les propriétés supplémentaires ne sont pas autorisées.
MutatorGraph
La projection du graphe de topologie exposée au plugin mutateur : le Component de chaque nœud, sa version résolue, ses labels et les valeurs que déclare son instance. Volontairement plus étroite que le résultat complet de la topologie : les arêtes et les payloads de features ne sont pas exposés, car le rôle du mutateur est l’étiquetage, et non le remodelage de la topologie. Les valeurs sont là pour être lues, de sorte qu’une configuration déclarée par le développeur peut décider d’un label ; un patch atteint les labels et rien d’autre, si bien que le plugin ne peut pas modifier les valeurs.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
nodes | map de MutatorNode | oui | Nœuds indexés par ID absolu de nœud. |
Les propriétés supplémentaires ne sont pas autorisées.
MutatorNode
La projection par nœud sur laquelle le plugin mutateur évalue ses règles : quel Component le nœud implémente, quelle version de ce Component a été résolue, quels labels le nœud porte et quelles valeurs déclare son instance.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
component | string | oui | Le nom du Component sous-jacent que le nœud instancie. |
resolved_version | string | oui | La version sémantique exacte du Component que le résolveur a épinglée pour ce nœud. |
labels | map de string | oui | Les labels de duck-typing et d’ontologie du nœud. |
values | object | non | Les valeurs que l’instance de composant du nœud déclare dans l’Aggregate, indexées telles que l’auteur les a écrites et dans l’ordre de l’auteur. Chaque template de l’Aggregate a déjà été évalué par rapport à ses paramètres, de sorte qu’une valeur remontée dans un paramètre arrive sous la forme de la valeur que la Release a fournie, ou de la valeur par défaut du paramètre. Seules les valeurs propres de l’instance figurent ici : une valeur par défaut que déclare le schéma du Component, et tout ce qu’apporte une Recipe ou une Feature, n’y figurent pas. Une valeur que le Component déclare sensible arrive masquée, exactement comme la reçoit le verdict de gouvernance sur l’ensemble du graphe : à sa place se trouve le même objet marqueur de valeur masquée à clé unique que porte ce verdict, nommant la raison déclarée, et une valeur sœur qu’aucune déclaration n’atteint arrive telle qu’elle est écrite. Un plugin les lit pour décider quels labels ajouter ; un patch ne peut pas les atteindre. Absent lorsque l’instance ne déclare aucune valeur. |
Les propriétés supplémentaires ne sont pas autorisées.
MutatorSource
Un fichier de définition transmis au plugin : son chemin de nom de base et le contenu du fichier. Les deux sont portés tels quels ; l’hôte n’analyse pas le contenu.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
path | string | oui | Le nom de base du fichier source. L’hôte ne fournit que le nom de base, jamais un chemin absolu de l’hôte, de sorte que le format de transmission est portable et déterministe. |
content | string | oui | Le contenu du fichier source, porté tel quel sous forme de chaîne opaque. |
Les propriétés supplémentaires ne sont pas autorisées.