Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

Schéma du socket Wasm de politique 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-policy-v1beta1.schema.json

Les formes de transmission qu’un plugin de gouvernance rattaché dans un rôle de verdict consomme — PolicyInput dans le rôle ir-verdict, RenderPolicyInput dans le rôle render-verdict — et émet (PolicyOutput). Un verdict de sévérité halt arrête le build avec un diagnostic au moment du build ; un verdict warn ou info est signalé et le build se poursuit. Le graphe d’entrée de la phase IR est le graphe IR complet, agnostique vis-à-vis des capacités, référencé depuis ir-v1beta1.schema.json plutôt que redéclaré ici, de sorte que le plugin de politique voit le même détail de nœuds, d’arêtes et de rattachements que le compilateur ; les auteurs de plugins suivent la version du schéma IR. L’entrée de la phase de rendu porte les fichiers de sortie rendus au lieu 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

  • PolicyInput
  • RenderPolicyInput
  • PolicyOutput

Définitions

PolicyInput

Le payload que l’analyse statique remet au socket de politique : le graphe IR complet (la même forme que celle qu’émet le Topology Builder) ainsi que les chemins de routage précalculés que l’analyseur énumère à côté.

PropriétéTypeObligatoireDescription
graphIRGraphouiLe graphe IR complet, agnostique vis-à-vis des capacités, issu d’une source unique dans ir-v1beta1.schema.json. Le plugin de politique raisonne sur le détail complet des nœuds, des arêtes et des rattachements plutôt que sur une projection étroite.
precalculated_pathsPrecalculatedPath[]ouiChemins de routage que l’analyseur a énumérés à l’avance afin que les politiques puissent raisonner sur l’atteignabilité sans reparcourir le graphe.
sourcesPolicySource[]nonFichiers de définition que l’hôte lit au moment de la compilation et remet 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.
settingsobjectnonUn 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.

PolicyOutput

La forme de réponse qu’émet le plugin de politique : les verdicts déclenchés pendant l’évaluation, un diagnostic par verdict déclenché. Une règle qui autorise n’émet rien, de sorte qu’un tableau results vide signifie qu’aucun verdict n’a été déclenché.

PropriétéTypeObligatoireDescription
resultsDiagnostic[]ouiLes verdicts déclenchés, un diagnostic chacun, dans l’ordre dans lequel le plugin les émet. Vide lorsqu’aucun verdict n’a été déclenché.
errorstringnonUn 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. Il est distinct des éventuels diagnostics que porte la sortie : les diagnostics signalent des problèmes trouvés pendant une exécution qui a malgré tout produit un résultat, tandis que error signale que l’opération elle-même ne s’est pas terminée. 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.

RenderPolicyInput

Le payload que reçoit un plugin de gouvernance rattaché dans le rôle render-verdict : les fichiers de sortie rendus sur lesquels raisonne la politique, à la place du graphe IR.

PropriétéTypeObligatoireDescription
artifactsRenderedArtifact[]ouiLes fichiers de sortie rendus sur lesquels raisonne la politique, sous forme de liste ordonnée triée par chemin afin que le format de transmission soit identique à l’octet près d’une exécution à l’autre pour une entrée identique.
sourcesPolicySource[]nonFichiers de définition que l’hôte lit au moment de la compilation et remet 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.
settingsobjectnonUn 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.

RenderedArtifact

Un fichier de sortie rendu : son chemin et le contenu rendu à ce chemin.

PropriétéTypeObligatoireDescription
pathstringouiLe chemin de sortie du fichier rendu, relatif à la racine de rendu.
contentstringouiLe contenu rendu à ce chemin.
treeanynonL’arbre structuré analysé de cet artefact, présent lorsque l’hôte a analysé le contenu avant de le remettre au plugin — la vue JSON canonique d’un format source que le plugin ne lit pas nativement (un artefact HCL analysé en JSON, par exemple). Le niveau supérieur peut être un objet, un tableau ou un scalaire, selon la forme propre du document analysé. Absent lorsque l’hôte n’a pas analysé l’artefact, auquel cas le plugin lit directement le contenu natif. L’hôte transmet l’arbre de manière opaque, en le portant tel quel sans interpréter son contenu.
formatstringnonLe format dans lequel l’artefact a été rendu, présent lorsque le fournisseur producteur l’a déclaré. Absent lorsque le fournisseur producteur n’a déclaré aucun format.

Les propriétés supplémentaires ne sont pas autorisées.

PolicySource

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éTypeObligatoireDescription
pathstringouiLe 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.
contentstringouiLe contenu du fichier source, porté tel quel sous forme de chaîne opaque.

Les propriétés supplémentaires ne sont pas autorisées.

PrecalculatedPath

Un chemin de routage énuméré à l’avance que l’analyseur matérialise afin que les règles de politique puissent raisonner sur l’atteignabilité sans reparcourir le graphe.

PropriétéTypeObligatoireDescription
path_idstringouiIdentifiant stable de ce chemin ; déterministe d’une exécution à l’autre pour une entrée identique.
nodesstring[]ouiSéquence ordonnée des ID de nœuds que le chemin traverse, de la source au terminal.
attached_featuresstring[]ouiUnion, triée par ordre alphabétique, des URI de type de Feature rattachés à n’importe quel nœud le long du chemin. Sémantique d’appartenance à un ensemble : une Feature apparaît une seule fois même si plusieurs nœuds la portent. Vide lorsqu’aucun nœud le long du chemin ne porte de rattachement de Feature.

Les propriétés supplémentaires ne sont pas autorisées.