Aggrega-Schema für den Wasm-Mutator-Socket
Generierte Referenz. Nicht von Hand bearbeiten — aus dem veröffentlichten JSON Schema neu generieren.
Schema-ID: https://aggrega.ai/schemas/wasm-mutator-v1beta1.schema.json
Die Übertragungsformen, die ein in der Rolle label-transform angebundenes Governance-Plugin konsumiert (MutatorInput) und ausgibt (MutatorOutput). Die Rolle läuft beim Aufbau der Topologie, nachdem der Graph erstellt und bevor er beurteilt wird: Das Plugin gibt JSON-Patch-Dokumente zurück, und der Host wendet sie auf Knoten-Labels und auf nichts anderes an und hält den Build bei einem Patch an, der einen anderen Teil des Graphen erreicht. Die Payload-Typen für Go, Rust und TypeScript werden aus diesem Schema in die Plugin-ABI-Pakete generiert, sodass die drei Sprachen dasselbe Übertragungsformat lesen und schreiben; ein Guest importiert sie aus diesen Paketen oder über sein Plugin-Kit, wo das Kit sie re-exportiert.
Eine der folgenden Formen
MutatorInputMutatorOutput
Definitionen
MutatorInput
Die Payload, die der Host dem Mutator-Plugin bei jedem Aufruf übergibt: Kompilierungskontext auf Release-Ebene sowie eine Projektion des Topologiegraphen, die die Labels jedes Knotens und die Werte trägt, die seine Instanz deklariert.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
compilation_context | CompilationContext | ja | Metadaten auf Release-Ebene, die der Mutator liest, wenn er entscheidet, welche Compliance-, FinOps- oder Governance-Regeln für den Build gelten. |
graph | MutatorGraph | ja | Die Projektion des Topologiegraphen, die dem Mutator-Plugin offengelegt wird: die Component jedes Knotens, seine aufgelöste Version, seine Labels und die Werte, die seine Instanz deklariert. Bewusst schmaler als das vollständige Topologieergebnis: Kanten und Feature-Payloads werden nicht offengelegt, weil die Aufgabe des Mutators das Labeln ist, nicht das Umformen der Topologie. Die Werte sind da, um gelesen zu werden, sodass eine Konfiguration, die der Entwickler deklariert hat, über ein Label entscheiden kann; ein Patch erreicht Labels und nichts anderes, sodass das Plugin die Werte nicht ändern kann. |
sources | MutatorSource[] | nein | Definitionsdateien, die der Host liest und wörtlich an das Plugin übergibt, als geordnete, nach Pfad sortierte Liste. Der Host liest die Bytes als opaken Inhalt und parst sie nicht. Fehlt, wenn die Anbindung keine Quellen deklariert. |
settings | object | nein | Ein Freiform-Einstellungsobjekt, das der Host wörtlich an das Plugin übergibt. Der Host parst seinen Inhalt nicht und handelt nicht danach. Fehlt, wenn die Anbindung keine Einstellungen deklariert. |
Zusätzliche Eigenschaften sind nicht zulässig.
MutatorOutput
Die Antwortform, die das Mutator-Plugin ausgibt: eine Liste opaker JSON-Patch-Dokumente, die der Host auf den Topologiegraphen anwendet. Patches bleiben auf der Schemaebene opak, sodass der Host den JSON-Patch-Parser, den der Guest bereits implementiert, nicht duplizieren muss.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
patches | any[] | ja | Opake JSON-Patch-Dokumente, die der Reihe nach auf den Topologiegraphen anzuwenden sind. |
error | string | nein | Eine Fehlermeldung, die gesetzt wird, wenn der Guest lief, die Operation aber nicht abschließen konnte; fehlt bei Erfolg. Der Host meldet einen vorhandenen Fehler als fehlgeschlagenen Plugin-Aufruf. |
Zusätzliche Eigenschaften sind nicht zulässig.
CompilationContext
Metadaten auf Release-Ebene, die der Mutator liest, wenn er entscheidet, welche Compliance-, FinOps- oder Governance-Regeln für den Build gelten.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
release_name | string | ja | Der metadata.name des Release. |
environment | string | ja | Das Umgebungs-Label, unter dem das Release läuft (z. B. dev, staging, prod). |
Zusätzliche Eigenschaften sind nicht zulässig.
MutatorGraph
Die Projektion des Topologiegraphen, die dem Mutator-Plugin offengelegt wird: die Component jedes Knotens, seine aufgelöste Version, seine Labels und die Werte, die seine Instanz deklariert. Bewusst schmaler als das vollständige Topologieergebnis: Kanten und Feature-Payloads werden nicht offengelegt, weil die Aufgabe des Mutators das Labeln ist, nicht das Umformen der Topologie. Die Werte sind da, um gelesen zu werden, sodass eine Konfiguration, die der Entwickler deklariert hat, über ein Label entscheiden kann; ein Patch erreicht Labels und nichts anderes, sodass das Plugin die Werte nicht ändern kann.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
nodes | Map von MutatorNode | ja | Knoten, indiziert nach absoluter Knoten-ID. |
Zusätzliche Eigenschaften sind nicht zulässig.
MutatorNode
Die Projektion pro Knoten, gegen die das Mutator-Plugin seine Regeln auswertet: welche Component der Knoten implementiert, welche Version dieser Component aufgelöst wurde, welche Labels der Knoten trägt und welche Werte seine Instanz deklariert.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
component | string | ja | Der Name der zugrunde liegenden Component, die der Knoten instanziiert. |
resolved_version | string | ja | Die exakte semantische Version der Component, die der Resolver für diesen Knoten festgelegt hat. |
labels | Map von string | ja | Die Duck-Typing- und Ontologie-Labels des Knotens. |
values | object | nein | Die Werte, die die Komponenteninstanz des Knotens im Aggregate deklariert, mit Schlüsseln, wie der Autor sie geschrieben hat, und in der Reihenfolge des Autors. Jedes Template im Aggregate wurde bereits gegen seine Parameter ausgewertet, sodass ein in einen Parameter gehobener Wert als der Wert ankommt, den das Release geliefert hat, oder als Standardwert des Parameters. Hier stehen nur die eigenen Werte der Instanz: Ein Standardwert, den das Schema der Component deklariert, und alles, was ein Recipe oder ein Feature beisteuert, stehen hier nicht. Ein Wert, den die Component als sensibel deklariert, kommt zurückgehalten an, genau so, wie das Governance-Urteil über den gesamten Graphen ihn erhält: An seiner Stelle steht dasselbe Markierungsobjekt für zurückgehaltene Werte mit einem einzigen Schlüssel, das dieses Urteil trägt und den deklarierten Grund nennt, und ein Geschwisterwert, den keine Deklaration erreicht, kommt wie geschrieben an. Ein Plugin liest sie, um zu entscheiden, welche Labels es hinzufügt; ein Patch kann sie nicht erreichen. Fehlt, wenn die Instanz keine Werte deklariert. |
Zusätzliche Eigenschaften sind nicht zulässig.
MutatorSource
Eine an das Plugin übergebene Definitionsdatei: ihr Basisnamenpfad und der Inhalt der Datei. Beides wird wörtlich getragen; der Host parst den Inhalt nicht.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
path | string | ja | Der Basisname der Quelldatei. Der Host liefert nur den Basisnamen, nie einen absoluten Host-Pfad, sodass das Übertragungsformat portabel und deterministisch ist. |
content | string | ja | Der Inhalt der Quelldatei, wörtlich als opake Zeichenkette getragen. |
Zusätzliche Eigenschaften sind nicht zulässig.