Aggrega-Schema für den gegenüber Fähigkeiten agnostischen IR-Graphen
Generierte Referenz. Nicht von Hand bearbeiten — aus dem veröffentlichten JSON Schema neu generieren.
Schema-ID: https://aggrega.ai/schemas/ir-v1beta1.schema.json
Der abgeflachte, vollständig aufgelöste eindimensionale Graph, den der Topology Builder ausgibt.
Typ der obersten Ebene: object
Eigenschaften
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | ja | Konstante: "aggrega.ai/v1beta1" |
kind | const “IR” | ja | Konstante: "IR" |
metadata | IRMetadata | ja | Identität des Graphen: das Aggregate, aus dem er gebaut wurde. |
spec | IRSpec | ja | Der Graph selbst: seine Knoten, seine Kanten und die nach Knoten geschlüsselten Payloads. |
Zusätzliche Eigenschaften sind nicht zulässig.
Definitionen
Maintainer
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
name | string | ja | Der Name des Maintainers. |
email | string | nein | Die E-Mail-Adresse des Maintainers. |
url | string | nein | Die Webadresse des Maintainers. |
FieldProvenance
Ursprung eines Blatts in der values- oder infra-Payload einer Anbindung.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
origin | string | ja | Ob das Blatt explizit verfasst oder vom annotationsgesteuerten Erweiterungsdurchlauf beigetragen wurde. |
side | string | nein | Authoring-Oberfläche, auf der die Annotation deklariert wurde; fehlt bei expliziten Blättern. |
annotation_key | string | nein | Name der Annotation, die dieses Blatt beigetragen hat; fehlt bei expliziten Blättern. |
annotation_source | string | nein | Quellort der Annotationsdeklaration als |
overridden_annotation | FieldProvenance | nein | Der Annotationsbeitrag, der dieses Blatt an ein explizites verloren hat: Wenn ein explizites Blatt ein von einer Annotation beigetragenes Blatt überschrieben hat, die unterdrückte Herkunft, die es ersetzt hat. Singular — es wird nie mehr als genau ein unterdrückter Beitrag aufbewahrt. |
Zusätzliche Eigenschaften sind nicht zulässig.
AttachmentConnection
Die Verbindung, zu der eine Anbindung gehört, für eine Anbindung, die auf einer Verbindung geschrieben ist, die eine Komponente zieht, statt im eigenen Anbindungsblock der Komponente: der Socket, über den die Verbindung verdrahtet ist, und der Alias, unter dem sie geschrieben ist. Das Paar benennt eine der Kanten des Graphen — die Kante, deren Quelle der Knoten ist, der die Anbindung trägt, und deren Socket und Alias diese sind —, sodass ein Verbraucher die Anbindung mit dieser Kante verknüpft und über sie mit dem Ziel, dem die Anbindung präsentiert wird.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
socket | string | ja | Der Socket, über den die Verbindung verdrahtet ist: der Socket der Kante, zu der die Anbindung gehört. |
alias | string | ja | Der Alias, unter dem die Verbindung geschrieben ist: der Alias der Kante, zu der die Anbindung gehört. |
Zusätzliche Eigenschaften sind nicht zulässig.
IRFeatureEntry
Eine aufgelöste Anbindung für einen Knoten, getragen in feature_values_mapping. Jede Anbindungsfamilie teilt diese Form — ein operatives Feature, ein Zugangsdaten-Feature, ein Identitäts-Feature —, sodass keine Familie eine verlustreichere Projektion erhält als eine andere. Was die values einer Zugangsdaten-Anbindung tragen, ist die Wahl des Autors: Zugangsdaten per Referenz tragen einen Zeiger in einen Secret-Store, solche per Wert tragen das Material selbst, und der Compiler trägt unverändert, was geschrieben wurde, ohne eines von beiden aufzulösen.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
type | string | ja | URI des Katalog-Features, das diese Anbindung anfordert. |
resolved_version | string | ja | Die exakte semantische Version, die während der Kompilierung aufgelöst wurde. |
labels | Map von string | nein | Die Katalog-Labels des angebundenen Features, unverändert in der Reihenfolge getragen, in der seine Katalogentität sie deklariert — nie gefiltert, normalisiert oder vom Präfix befreit, sodass ein Verbraucher genau liest, was der Katalogautor geschrieben hat. Der Compiler liest keines davon. Fehlt, wenn das Feature keine Labels deklariert, und wenn sein Typ zu keiner Katalogentität aufgelöst wird. |
catalog_annotations | Map von string | nein | Die Katalog-Annotationen des angebundenen Features — die metadata.annotations der Feature-Entität, die diese Anbindung nennt —, unverändert in der Reihenfolge getragen, in der diese Entität sie deklariert, nie gefiltert, normalisiert oder vom Präfix befreit, sodass ein Verbraucher genau liest, was der Katalogautor geschrieben hat, einschließlich Schlüsseln im eigenen Namespace des Autors. Der Compiler liest keine davon. Zu unterscheiden von annotation_key und annotation_source, die die Annotation nennen und verorten, durch die diese Anbindung überhaupt erst entstanden ist: Diese beiden melden, wie die Anbindung zustande kam, dieses Feld meldet die Metadaten der Entität, die sie nennt, und eine in einem features:-Block geschriebene Anbindung trägt diese Annotationen, ohne eines jener beiden zu tragen. Fehlt, wenn das Feature keine Annotationen deklariert, und wenn sein Typ zu keiner Katalogentität aufgelöst wird. |
binding | string | nein | Benennt den Anbindungs-Slot, den diese Anbindung belegt, oder “free”, wenn sie keinen deklarierten Slot belegt. Ein Slot wird an einer von zwei Stellen deklariert, und wo die Anbindung geschrieben wurde, entscheidet, an welcher: Eine Anbindung des eigenen Anbindungsblocks des Knotens belegt einen Slot, den die Host-Component in ihrem featuresSchema deklariert, und eine auf einer Verbindung geschriebene Anbindung belegt einen Slot, den der Socket der Verbindung im featuresSchema dieses Sockets an der Host-Component deklariert. Die Zuordnung erfolgt in beiden Fällen über den Namen — eine Anbindung belegt einen Slot, wenn das Feature unter dem Namen des Slots angebunden wird, am Block der Komponente oder an der Verbindung —, daher ist der Wert ein exakter Schlüssel aus der deklarierten Slot-Menge, nie etwas, das aus dem Schlüssel der Anbindung gelesen wird. Die Slot-Menge eines Sockets ist geschlossen, da eine Anbindung, die auf einer Verbindung unter einem Namen geschrieben ist, den ihr Socket nicht deklariert, den Build abbricht, daher meldet eine Anbindung, die eine Verbindung trägt, nie free. Der Slot-Name wird statt eines bloßen booleschen Werts getragen, weil die Frage, welcher Slot belegt wurde, die nützlichere Hälfte der Antwort ist. Leer, wenn die deklarierte Slot-Menge der Host-Component nicht aufgelöst werden konnte, was sich von “free” unterscheidet: free ist der positive Befund, dass kein deklarierter Slot diesen Namen trägt. |
values | object | nein | Payload der operativen Konfiguration für die Anbindung. Bei Zugangsdaten die Form, die der Autor deklariert hat — ein Zeiger in einen Secret-Store oder das Material selbst. |
infra | object | nein | Physische Dimensionierung pro Instanz für diese Anbindung. |
inject | object | nein | Agnostisches Injektions-Routing. Ordnet lokale Variablen den provides-Schlüsseln des Ziels zu. |
origin | string (enum) | nein | Unterscheidet in einem features:-Block verfasste Anbindungen (explicit) von synthetischen Anbindungen, die der annotationsgesteuerte Erweiterungsdurchlauf erzeugt (annotation), oder mixed, wenn die value/infra-Blätter der Anbindung eine Mischung aus beiden tragen (das Detail pro Blatt steht dann in den Herkunfts-Maps). Zulässige Werte: "explicit", "annotation", "mixed" |
annotation_key | string | nein | Name der Annotation, die eine synthetische Anbindung ausgelöst hat. Fehlt, wenn origin explicit ist. |
annotation_source | string | nein | Quellort der Annotationsdeklaration als |
values_provenance | Map von FieldProvenance | nein | Ursprung pro Blatt für die values-Payload, geschlüsselt nach dem gepunkteten Blattpfad. |
infra_provenance | Map von FieldProvenance | nein | Ursprung pro Blatt für die infra-Payload, geschlüsselt nach dem gepunkteten Blattpfad. |
sensitive | boolesch | nein | Ist true, wenn diese Anbindung Material behandelt, das ein Autor als sensibel deklariert hat — entweder deklariert das angebundene Feature ein sensibles Blatt in seiner Säule values, infra oder provides, oder der Slot, den die Anbindung belegt, deklariert das Material, das sie trägt, als sensibel: der gleichnamige Anbindungs-Slot der Host-Component oder, bei einer auf einer Verbindung geschriebenen Anbindung, der Slot dieses Namens, den der Socket der Verbindung deklariert. Aus diesen Deklarationen über die zusammengeführte Anbindung abgeleitet, nie aus dem Inhalt eines Werts oder einem Namen. Nicht gesetzt, wenn keine der beiden Deklarationen vorhanden ist. |
sensitive_inject | Map von Maps von string | nein | Die Zustellschlüssel von inject, deren referenzierten provides-Schlüssel das angebundene Feature als sensibel deklariert, in der eigenen Form von inject: Mechanismus, dann Zustellschlüssel, mit dem referenzierten provides-Schlüssel als Wert. Eine Teilmenge von inject. Fehlt, wenn die Anbindung keinen Zustellmechanismus deklariert oder keinen sensiblen provides-Schlüssel referenziert. |
sensitive_payload_leaves | string[] | nein | Die Blätter, die die values- und infra-Payload dieser Anbindung trägt und die das angebundene Feature als sensibel deklariert, jeweils als der mit dem Säulenpräfix versehene gepunktete Pfad, den das Datum einnimmt: values.db db.password abdeckt und ein Geschwisterblatt namens dbPassword nicht erreicht. Die Antwort pro Anbindung wird nie auf einzelne Blätter verteilt, was über ein lesbar gelassenes Blatt etwas Falsches behaupten würde. Ein fehlender Schlüssel besagt, dass diese Anbindung kein Blatt nennt, das ihr Feature als sensibel deklariert. Er behauptet nicht, dass die Payload nicht sensibel ist, und er unterscheidet nicht zwischen einer Anbindung, die kein solches Blatt zu nennen hat, und einem Erzeuger, der diese Achse überhaupt nicht meldet — ein Guest, der einen fehlenden Schlüssel als Erlaubnis liest, einen Wert im Klartext anzuzeigen oder auszugeben, hat ihn verkehrt herum gelesen. Die Blätter kommen in der Reihenfolge an, in der die Payload sie enthält, die der values-Säule vor denen der infra-Säule — dieselbe Reihenfolge, die die values- und infra-Payloads selbst tragen, und das, was die Payload über Läufe mit identischer Eingabe hinweg byteidentisch macht. Fehlt, wenn die Anbindung kein Blatt trägt, das ihr Feature als sensibel deklariert. |
connection | AttachmentConnection | nein | Die Verbindung, zu der diese Anbindung gehört: vorhanden bei jeder Anbindung, die an einer der Verbindungen des Knotens geschrieben ist, und fehlend bei jeder Anbindung des eigenen Anbindungsblocks des Knotens. Eine an einer Verbindung geschriebene Anbindung ist in jeder anderen Hinsicht eine der Anbindungen des Knotens — geschlüsselt nach ihrem qualifizierten Namen, dem Alias der Verbindung und dem Slot, durch einen Punkt verbunden, und mit ihrer Bindung und ihrer Sensibilität aus dem Slot, den der Socket der Verbindung deklariert —, daher ist dieses Feld das, was die beiden unterscheidet, und es trägt die Verbindung als Daten, statt sie aus dem Schlüssel herauslesen zu lassen. Ein Verbraucher verknüpft es über Socket und Alias mit den Kanten des Graphen: Die Kante, deren Quelle der Knoten ist, der diese Anbindung trägt, und deren Socket und Alias diese sind, ist die Verbindung, an der die Anbindung präsentiert wird, und das Ziel dieser Kante ist das, dem sie präsentiert wird. Eine Anbindung einer Verbindung, die eine Feature-Anbindung zieht, trägt nie eines, weil eine solche Verbindung keine Anbindungen trägt. |
realization | string | nein | Das FeatureRecipe, das diese Anbindung realisiert, als |
Zusätzliche Eigenschaften sind nicht zulässig.
IRFeatureEntry.inject
Agnostisches Injektions-Routing. Ordnet lokale Variablen den provides-Schlüsseln des Ziels zu.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
env | Map von string | nein | Zustellung über Umgebungsvariablen: Die Schlüssel sind die Namen der lokalen Variablen des Verbrauchers, die Werte sind die provides-Schlüssel des Ziels. |
file | Map von string | nein | Zustellung über Dateieinhängung: Die Schlüssel sind die lokalen Dateipfade des Verbrauchers, die Werte sind die provides-Schlüssel des Ziels. |
arg | Map von string | nein | Zustellung über Befehlszeilenargumente: Die Schlüssel sind die Flag-Präfixe des Verbrauchers, die Werte sind die provides-Schlüssel des Ziels. |
IRBoundaryFeature
Eine Feature-Anbindung auf Boundary-Ebene, in die IR projiziert: der Feature-Typ-URI plus die infra der Boundary, gegen die ein FeatureRecipe mit Geltungsbereich boundary rendert und seine Quelle auflöst. Anbindungen auf Boundary-Ebene tragen keine values-Payload.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
type | string | ja | URI des Katalog-Feature, das an dieser Boundary angebunden ist. |
infra | object | nein | Physische Dimensionierung für die Boundary-Anbindung; die infra, gegen die ein FeatureRecipe mit Geltungsbereich boundary seine Templates und seine Quelle auswertet. |
sensitive_payload_leaves | string[] | nein | Die Blätter, die die infra-Payload dieser Boundary-Anbindung trägt und die das angebundene Feature als sensibel deklariert, jeweils als der mit dem Säulenpräfix versehene gepunktete Pfad, den das Datum einnimmt. Hier erscheinen nur Koordinaten infra.db db.password abdeckt und ein Geschwisterblatt namens dbPassword nicht erreicht. Ein fehlender Schlüssel besagt, dass diese Anbindung kein Blatt nennt, das ihr Feature als sensibel deklariert, was den Fall einschließt, in dem sich das angebundene Feature zu keinem Schema auflöst, das dieser Leser lesen konnte. Er behauptet nicht, dass die infra-Payload nicht sensibel ist, und er unterscheidet nicht zwischen einer Anbindung, die kein solches Blatt zu nennen hat, und einem Erzeuger, der diese Achse überhaupt nicht meldet. Ein Verbraucher, der einen fehlenden Schlüssel als Erlaubnis liest, einen Wert im Klartext anzuzeigen oder auszugeben, hat ihn verkehrt herum gelesen. Die Blätter kommen in der Reihenfolge an, in der die Payload sie enthält, was dieselbe Reihenfolge ist, die die infra-Payload selbst trägt, und das, was den Graphen über Läufe mit identischer Eingabe hinweg byteidentisch hält. Fehlt, wenn die Anbindung kein Blatt trägt, das ihr Feature als sensibel deklariert. |
realization | string | nein | Das FeatureRecipe, das diese Boundary-Anbindung realisiert, als |
Zusätzliche Eigenschaften sind nicht zulässig.
CatalogMetadata
Die Unternehmens-Metadaten-Suite, explizit aus der Katalogentität extrahiert, die Lebenszyklus- und Eigentümerdaten für Wasm-Linter bereitstellt.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
maintainers | Maintainer[] | nein | Die Maintainer, die die Katalogentität als ihre Eigentümer aufführt. |
license | string | nein | Die SPDX-Lizenzkennung, die die Katalogentität für die Software deklariert, die sie beschreibt. |
repository | string | nein | Die URL des Git-Repositorys, das die Katalogentität als Ort ihrer Quelldateien nennt. |
home | string | nein | Die URL der Homepage, des Wikis oder der Dokumentation der Katalogentität. |
keywords | string[] | nein | Die beschreibenden Schlüsselwörter, die die Katalogentität deklariert. |
Zusätzliche Eigenschaften sind nicht zulässig.
IRNode
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
description | string | nein | Optionale, vom Entwickler verfasste Dokumentation, die die Rolle dieser Komponenteninstanz in der Anwendung beschreibt. Aus dem Aggregate für das Rendering und für Lint-Diagnosen übernommen. |
labels | Map von string | ja | Die Duck-Typing- und Ontologie-Labels der Entität. |
component | string | ja | Der Name der zugrunde liegenden Component. |
resolved_version | string | ja | Die exakte semantische Version der Component, die während der Kompilierung aufgelöst wurde. |
sync_wave | integer | nein | Die Bereitstellungswelle, geerbt aus dem Feld syncWave der umgebenden Boundary (Standardwert 0; negative Werte zulässig). Bei K8s und Helm ist die Welle das, was die Bereitstellung ordnet: Sie wird zu einer Annotation argocd.argoproj.io/sync-wave, und bei einer Ressource, die der Chart bereits als Helm-Hook markiert, wird sie außerdem zum helm.sh/hook-weight dieses Hooks. Bei compose wird der Wert sowohl als Service-Label verzeichnet, als auch ordnet er die Services der Datei, in die er gerendert wird, über depends_on zwischen ihnen. Bei cloudformation ordnet er die Provisionierung des Stacks, zu dem sich eine Dispatch-Gruppe zusammensetzt, indem jede Ressource einer Welle als abhängig von den Ressourcen der vorherigen Welle deklariert wird: die Reihenfolge, in der sie erstellt werden, und, umgekehrt, die Reihenfolge, in der sie gelöscht werden, nie die Bereitschaft, weil ein Stack-Template keinen Begriff davon ausdrückt, dass eine Ressource bereit ist. Bei terraform ordnet er die module-Blöcke der Root-Konfiguration, zu der sich eine Boundary zusammensetzt, indem jedes Modul einer Welle als abhängig von den Modulen der vorherigen Welle deklariert wird: die Reihenfolge, in der die Engine ihre Aktionen ausführt, nie die Bereitschaft, weil eine Konfiguration keinen Begriff davon ausdrückt, dass eine Ressource bereit ist. Der Wert reist außerdem mit der Build-Herkunft des Knotens. |
boundary_path | string | nein | Der Pfad der Release-Boundary, in der dieser Knoten platziert ist: die Boundary-Namen von der äußersten Boundary nach innen, verbunden mit / (z. B. ‘data/inner’ für eine Komponente, die in einer Boundary inner platziert ist, die innerhalb einer Boundary data deklariert ist). Ein Boundary-Name kann kein / enthalten, daher lässt sich der Pfad eindeutig wieder in seine Boundaries zerlegen. Ein Knoten eines importierten Aggregate, den das Release in eine Boundary leitet, trägt den Pfad dieser Boundary. Ermöglicht es Rendering-Plugins, Boundary-bewusste eindeutige Bezeichner zu erzeugen. |
subsystem_path | string | nein | Der Pfad des Aggregate-Subsystems, in dem die Komponente dieses Knotens deklariert ist: die Subsystem-Namen vom äußersten Subsystem nach innen, verbunden mit . (z. B. ‘backend.storage’ für eine Komponente, die in einem Subsystem storage deklariert ist, das innerhalb eines Subsystems backend verschachtelt ist). Ein Subsystem-Name kann kein . enthalten, daher lässt sich der Pfad eindeutig wieder in seine Subsysteme zerlegen. Eine Komponente eines Aggregate, das components auf oberster Ebene deklariert, trägt das synthetisierte default, gekennzeichnet durch synthesized_subsystem. Der Pfad ist relativ zu dem Aggregate, das die Komponente deklariert: Ein Knoten, den ein importiertes Aggregate beisteuert, trägt seinen Pfad innerhalb dieses Aggregate, ohne den Namen, unter dem es importiert wird (z. B. ‘tier’ für eine Komponente im Subsystem tier des importierten Aggregate), sodass Knoten aus verschiedenen Aggregates einen Pfad teilen können. Die ID des Knotens, die mit dem Importnamen beginnt, und source_file unterscheiden sie. |
synthesized_subsystem | boolesch | nein | Ist true, wenn das Subsystem dieses Knotens vom Compiler synthetisiert wurde — das Subsystem default, das für ein Aggregate erzeugt wird, das components auf oberster Ebene statt benannter subsystems deklariert. Abgeleitete Herkunft, nie verfasst: Sie unterscheidet das synthetisierte default von einem Subsystem, das ein Benutzer ausdrücklich default genannt hat. Unabhängig von synthesized_boundary (ein Knoten kann auf einer der beiden Achsen oder auf beiden synthetisiert sein). Fehlt (false) bei jedem verfassten Subsystem. |
synthesized_boundary | boolesch | nein | Ist true, wenn die Boundary dieses Knotens vom Compiler synthetisiert wurde — die Boundary default, die für ein Release erzeugt wird, das components auf oberster Ebene statt benannter boundaries deklariert. Abgeleitete Herkunft, nie verfasst: Sie unterscheidet das synthetisierte default von einer Boundary, die ein Benutzer ausdrücklich default genannt hat, und leitet die Artefakte des Knotens flach nach dist/ statt nach dist/boundaries/default/. Fehlt (false) bei jeder verfassten Boundary. |
catalog_metadata | CatalogMetadata | nein | Die Unternehmens-Metadaten-Suite, explizit aus der Katalogentität extrahiert, die Lebenszyklus- und Eigentümerdaten für Wasm-Linter bereitstellt. |
catalog_annotations | Map von string | nein | Unveränderliche, intrinsische Komponenteneigenschaften, verfasst vom Plattformarchitekten in Domäne 2. |
release_annotations | Map von string | nein | Physische Topologie-Strings und Ops-Realitäten, die aus den Boundaries im Release kaskadieren. |
aggregate_annotations | Map von string | nein | Kognitive Metadaten, Entwicklerabsicht und FinOps, die aus den Subsystemen im Aggregate kaskadieren. |
self_inject | object | nein | Self-inject-Block auf Component-Ebene, aus dem Aggregate übernommen; das agnostische Injektions-Routing, das der Knoten für sich selbst deklariert. Auf dieser Schemaebene opak; ein Policy-Plugin, das ihn liest, parst die Bytes. |
source_file | string | nein | Workspace-relativer Pfad der Aggregate-Datei, in der dieser Knoten verfasst wurde. Knoten der Wurzelebene tragen den Pfad des Wurzel-Aggregate; Knoten von Unteraggregaten tragen den Dateipfad des importierten Aggregate. Der Pfad ist relativ zur Workspace-Wurzel (dem Verzeichnis, das .aggrega-config.yaml enthält), sodass der Graph auf Maschinen, deren Workspaces unter unterschiedlichen absoluten Pfaden liegen, byteidentisch ist. Verbraucher, die Diagnosen pro Datei filtern, lösen das Feld vor dem Vergleich gegen dieselbe Workspace-Wurzel auf. Fehlt, wenn der Graph ohne Workspace-Wurzel erstellt wurde. |
uses | object | nein | Der uses-Block des Knotens genau wie verfasst: Jeder Socket-Name wird entweder einer Liste von Namen von Zielinstanzen oder einer nach Alias geschlüsselten Map von Verbindungseinträgen zugeordnet, in der Reihenfolge, in der der Autor sie deklariert hat. Dies ist der Block wie geschrieben, was eine andere Tatsache ist als die aufgelösten Verbindungen in edges: Ein Socket, den der Autor befüllt hat, erscheint hier auch dort, wo er keine Verbindung erzeugt hat, sodass ein Leser einen Socket, den der Autor ausgefüllt hat, von einem Socket unterscheiden kann, der ein Ziel erreicht. Fehlt, wenn der Knoten keinen uses-Block verfasst hat. Auf dieser Schemaebene opak; ein Policy-Plugin, das ihn liest, parst die Bytes. |
sensitive_payload_leaves | string[] | nein | Die Blätter, die die values- und infra-Payload dieses Knotens trägt und die seine Component als sensibel deklariert, jeweils als der mit dem Säulenpräfix versehene gepunktete Pfad, den das Datum einnimmt: values.db db.password abdeckt und ein Geschwisterblatt namens dbPassword nicht erreicht. Ein fehlender Schlüssel besagt, dass dieser Knoten kein Blatt nennt, das seine Component als sensibel deklariert, was den Fall einschließt, in dem sich die Component des Knotens zu keinem Schema auflöst, das dieser Leser lesen konnte. Er behauptet nicht, dass die Payload des Knotens nicht sensibel ist, und er unterscheidet nicht zwischen einem Knoten, der kein solches Blatt zu nennen hat, und einem Erzeuger, der diese Achse überhaupt nicht meldet. Ein Verbraucher, der einen fehlenden Schlüssel als Erlaubnis liest, einen Wert im Klartext anzuzeigen oder auszugeben, hat ihn verkehrt herum gelesen. Die Blätter kommen in der Reihenfolge an, in der die Payload sie enthält, die der values-Säule vor denen der infra-Säule, was dieselbe Reihenfolge ist, die diese Payloads selbst tragen, und das, was den Graphen über Läufe mit identischer Eingabe hinweg byteidentisch hält. Fehlt, wenn der Knoten kein Blatt trägt, das seine Component als sensibel deklariert. |
Zusätzliche Eigenschaften sind nicht zulässig.
IREdge
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
source | string | ja | Die ID des verbrauchenden Knotens, an dem die Verbindung beginnt. |
target | string | ja | Die ID des Knotens, den die Verbindung erreicht. |
socket | string | nein | Die usesSchema-Kategorie, zu der diese Kante gehört (z. B. ‘databases’, ‘tools’). |
alias | string | nein | Der vom Entwickler definierte Alias für diese Verbindung (z. B. ‘primary_db’). |
socket_declaration | string (enum) | ja | Woher der Socket stammt: declared, wenn die Katalogentität, der der Socket gehört, ihn in usesSchema aufführt (die verbrauchende Component oder, bei einer von einem Feature verfassten Kante, das ursprüngliche Feature), ad-hoc, wenn der Autor des Aggregate einen Socket benannt hat, den der Katalog nicht deklariert hat. Dies ist eine dritte Achse, unabhängig von der Urheberschaft der Kante: Sie sagt, woher der Socket stammt, nicht, wer die Kante gezogen hat, sodass sich eine von einem Release verfasste Kante in einen deklarierten Socket und eine von einem Aggregate verfasste Kante in einen Ad-hoc-Socket auf den beiden Achsen unabhängig voneinander unterscheiden. Ein deklarierter Socket trägt seinen usesSchema-Eintrag, einschließlich des Selektors, der einschränkt, welche Ziele die Kante erreichen darf; ein Ad-hoc-Socket hat keinen Katalogeintrag und daher keinen Selektor, sodass das, was die Kante tragen darf, allein durch die deklarierten provides des Ziels begrenzt ist. Immer vorhanden, sodass ein Verbraucher einen fehlenden Wert nie als declared lesen muss und eine Richtlinie verlangen kann, dass jede Kante deklariert ist. Zu unterscheiden von der Bindungsmarkierung einer Anbindung, die dieselbe Art von Frage zu einem anderen Gegenstand beantwortet. Zulässige Werte: "declared", "ad-hoc" |
origin_feature | string | nein | Wenn diese Kante autonom von einem Feature deklariert wurde (einschließlich Zugangsdaten-Features mit dem Label feature.aggrega.ai/kind: secret), identifiziert dies den URI des Feature-Typs. Ermöglicht es Wasm-Plugins, ihre eigene Topologie zu isolieren. |
origin_feature_instance | string | nein | Der Instanzname pro Anbindung des Feature, das diese Kante deklariert hat. Lokalisiert die aufgelösten provides eines FeatureRecipe mit Geltungsbereich boundary nach Instanz und unterscheidet so zwei Anbindungen desselben Feature-Typs an einer Boundary. |
origin_release | boolesch | nein | Ist true, wenn diese Kante von einem Release erzeugt wurde, das einen deklarierten, aber nicht gebundenen Socket mit einer bestehenden Komponente verdrahtet. Kennzeichnet die URHEBERSCHAFT der Kante, nicht die Konfiguration: Eine vom Entwickler deklarierte Kante, für die ein Release lediglich infra geliefert hat, behält den Aggregate-Ursprung (origin_release nicht gesetzt; ihre Release-infra erscheint in der infra-Map der Kante). origin_feature gesetzt => Feature-Ursprung; origin_release true => Release-Ursprung; keines von beiden => Aggregate-Ursprung. |
values | object | nein | Aufgelöste Entwicklerwerte pro Verbindung für diese Kante (aus der Aggregate-Kante), bei der Auflösung gegen das valueSchema validiert, das der Quell-Socket deklariert (der Socket an der verbrauchenden Komponente, die die Quelle der Kante ist), und in den Render-Kontext des verbrauchenden Knotens unter .context.uses. |
infra | object | nein | Aufgelöste infra pro Verbindung für diese Kante, geliefert von einem Kanteneintrag eines Release, bei der Auflösung gegen das infraSchema validiert, das der Quell-Socket deklariert (der Socket an der verbrauchenden Komponente, die die Quelle der Kante ist), und unter .context.uses. |
inject | object | nein | Agnostisches Injektions-Routing. Ordnet lokale Variablen den provides-Schlüsseln des Ziels zu. |
sensitive_payload_leaves | string[] | nein | Die Blätter, die die values und die infra dieser Kante tragen und die der Socket, gegen den sie geschrieben sind, als sensibel deklariert, jeweils als der mit dem Säulenpräfix versehene gepunktete Pfad, den das Datum einnimmt: values.db db.password abdeckt und ein Geschwisterblatt namens db_password nicht erreicht. Eine Oberfläche, die als sensibel deklarierte Werte aus dem Graphen zurückhält, hält diese Blätter in den values und der infra dieser Kante zurück, und im uses-Eintrag des verbrauchenden Knotens für dieselbe Verbindung, der die Werte so trägt, wie der Autor sie geschrieben hat. Ein fehlender Schlüssel besagt, dass diese Kante kein Blatt nennt, das der Vertrag ihres Sockets als sensibel deklariert, was den Fall einschließt, in dem der Socket keinen Vertrag deklariert, den dieser Leser lesen konnte. Er behauptet nicht, dass die Konfiguration nicht sensibel ist, und ein Verbraucher, der einen fehlenden Schlüssel als Erlaubnis liest, einen Wert im Klartext anzuzeigen oder auszugeben, hat ihn verkehrt herum gelesen. Die Blätter kommen in der Reihenfolge an, in der die Payloads sie enthalten, die der values-Säule vor denen der infra-Säule, was den Graphen über Läufe mit identischer Eingabe hinweg byteidentisch hält. Fehlt, wenn die Kante kein Blatt trägt, das der Vertrag ihres Sockets als sensibel deklariert. |
Zusätzliche Eigenschaften sind nicht zulässig.
IREdge.inject
Agnostisches Injektions-Routing. Ordnet lokale Variablen den provides-Schlüsseln des Ziels zu.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
env | Map von string | nein | Zustellung über Umgebungsvariablen: Die Schlüssel sind die Namen der lokalen Variablen des Verbrauchers, die Werte sind die provides-Schlüssel des Ziels. |
file | Map von string | nein | Zustellung über Dateieinhängung: Die Schlüssel sind die lokalen Dateipfade des Verbrauchers, die Werte sind die provides-Schlüssel des Ziels. |
arg | Map von string | nein | Zustellung über Befehlszeilenargumente: Die Schlüssel sind die Flag-Präfixe des Verbrauchers, die Werte sind die provides-Schlüssel des Ziels. |
IRMetadata
Identität des Graphen: das Aggregate, aus dem er gebaut wurde.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
aggregate_name | string | ja | Der metadata.name des Aggregate. |
Zusätzliche Eigenschaften sind nicht zulässig.
IRProvenance
Rückverfolgbarkeitsmetadaten für Diagnose und Audit.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
schema_version | string | ja | Die Version des IR-Schemas, der der Graph entspricht — aggrega.ai/v1beta1, derselbe Wert, den die apiVersion des Graphen trägt. |
compiler_version | string | ja | Verpflichtender Konformitätsstempel. Identifiziert anhand seiner Version das aggrega-Binary, das diesen Graphen gebaut hat. |
aggregate_version | string | ja | Die exakte semantische Version der Absicht des Wurzel-Aggregate, die während der Kompilierung verwendet wurde. |
manifest_version | string | ja | Die exakte semantische Version des Manifest-Lockfiles, das während der Kompilierung verwendet wurde. |
release_version | string | ja | Die exakte semantische Version der Release-Routing-Datei, die während der Kompilierung verwendet wurde. |
Zusätzliche Eigenschaften sind zulässig.
IRSpec
Der Graph selbst: seine Knoten, seine Kanten und die nach Knoten geschlüsselten Payloads.
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
nodes | Map von IRNode | ja | Wörterbuch aller Knoten im Graphen, geschlüsselt nach ihrer absoluten ID. Rein topologisch. Schlüssel: ein oder mehrere Buchstaben, Ziffern, Unterstriche, Punkte oder Bindestriche. Muster: ^[a-zA-Z0-9_.-]+$. |
edges | IREdge[] | ja | Explizite logische Netzwerkpfade und Abhängigkeiten zwischen Knoten. |
values_mapping | object | ja | Die einzige Quelle der Wahrheit für opake, unverändert durchgereichte kognitive Payloads, nach Knoten-ID zugeordnet. |
infra_mapping | object | ja | Die Payload der physischen Dimensionierung, aus dem Release injiziert, nach Knoten-ID zugeordnet. |
feature_values_mapping | Map von Map von IRFeatureEntry | ja | Normalisierte Map von Knoten-IDs auf ihre angebundenen Feature-Konfigurationen. Ein einziger Behälter trägt jede Anbindung an einem Knoten, was immer sie erzeugt — operative Features, Zugangsdaten-Features, Identitäts-Features —, geschlüsselt nach dem Instanznamen, den der Autor jeder Anbindung gegeben hat. Eine an einer der Verbindungen des Knotens geschriebene Anbindung ist nach ihrem qualifizierten Namen geschlüsselt, dem Alias der Verbindung und dem Slot, durch einen Punkt verbunden, und nennt ihre Verbindung in ihrem eigenen Feld connection. Schlüssel: ein oder mehrere Buchstaben, Ziffern, Unterstriche, Punkte oder Bindestriche. Muster: ^[a-zA-Z0-9_.-]+$. |
boundary_features | Map von Map von IRBoundaryFeature | nein | Die Feature-Anbindungen jeder Boundary, geschlüsselt nach Boundary-Pfad und dann nach Instanzname. Nur vorhanden, wenn der Graph Feature-Anbindungen auf Boundary-Ebene hat. Schlüssel: ein oder mehrere Buchstaben, Ziffern, Unterstriche, Punkte, Schrägstriche oder Bindestriche. Muster: ^[a-zA-Z0-9_./-]+$. |
provenance | IRProvenance | ja | Rückverfolgbarkeitsmetadaten für Diagnose und Audit. |
Zusätzliche Eigenschaften sind nicht zulässig.
IRGraph
| Eigenschaft | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | ja | Konstante: "aggrega.ai/v1beta1" |
kind | const “IR” | ja | Konstante: "IR" |
metadata | IRMetadata | ja | Identität des Graphen: das Aggregate, aus dem er gebaut wurde. |
spec | IRSpec | ja | Der Graph selbst: seine Knoten, seine Kanten und die nach Knoten geschlüsselten Payloads. |
Zusätzliche Eigenschaften sind nicht zulässig.