Zum Inhalt springen
AggregaAggrega
Sprache wählen: Deutsch
Diese Seite wurde maschinell übersetzt. Das englische Original lesen.

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

  • MutatorInput
  • MutatorOutput

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.

EigenschaftTypErforderlichBeschreibung
compilation_contextCompilationContextjaMetadaten auf Release-Ebene, die der Mutator liest, wenn er entscheidet, welche Compliance-, FinOps- oder Governance-Regeln für den Build gelten.
graphMutatorGraphjaDie 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.
sourcesMutatorSource[]neinDefinitionsdateien, 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.
settingsobjectneinEin 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.

EigenschaftTypErforderlichBeschreibung
patchesany[]jaOpake JSON-Patch-Dokumente, die der Reihe nach auf den Topologiegraphen anzuwenden sind.
errorstringneinEine 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.

EigenschaftTypErforderlichBeschreibung
release_namestringjaDer metadata.name des Release.
environmentstringjaDas 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.

EigenschaftTypErforderlichBeschreibung
nodesMap von MutatorNodejaKnoten, 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.

EigenschaftTypErforderlichBeschreibung
componentstringjaDer Name der zugrunde liegenden Component, die der Knoten instanziiert.
resolved_versionstringjaDie exakte semantische Version der Component, die der Resolver für diesen Knoten festgelegt hat.
labelsMap von stringjaDie Duck-Typing- und Ontologie-Labels des Knotens.
valuesobjectneinDie 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.

EigenschaftTypErforderlichBeschreibung
pathstringjaDer Basisname der Quelldatei. Der Host liefert nur den Basisnamen, nie einen absoluten Host-Pfad, sodass das Übertragungsformat portabel und deterministisch ist.
contentstringjaDer Inhalt der Quelldatei, wörtlich als opake Zeichenkette getragen.

Zusätzliche Eigenschaften sind nicht zulässig.