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

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

EigenschaftTypErforderlichBeschreibung
apiVersionconst “aggrega.ai/v1beta1”jaKonstante: "aggrega.ai/v1beta1"
kindconst “IR”jaKonstante: "IR"
metadataIRMetadatajaIdentität des Graphen: das Aggregate, aus dem er gebaut wurde.
specIRSpecjaDer Graph selbst: seine Knoten, seine Kanten und die nach Knoten geschlüsselten Payloads.

Zusätzliche Eigenschaften sind nicht zulässig.

Definitionen

Maintainer

EigenschaftTypErforderlichBeschreibung
namestringjaDer Name des Maintainers.
emailstringneinDie E-Mail-Adresse des Maintainers.
urlstringneinDie Webadresse des Maintainers.

FieldProvenance

Ursprung eines Blatts in der values- oder infra-Payload einer Anbindung.

EigenschaftTypErforderlichBeschreibung
originstringjaOb das Blatt explizit verfasst oder vom annotationsgesteuerten Erweiterungsdurchlauf beigetragen wurde.
sidestringneinAuthoring-Oberfläche, auf der die Annotation deklariert wurde; fehlt bei expliziten Blättern.
annotation_keystringneinName der Annotation, die dieses Blatt beigetragen hat; fehlt bei expliziten Blättern.
annotation_sourcestringneinQuellort der Annotationsdeklaration als :; fehlt bei expliziten Blättern.
overridden_annotationFieldProvenanceneinDer 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.

EigenschaftTypErforderlichBeschreibung
socketstringjaDer Socket, über den die Verbindung verdrahtet ist: der Socket der Kante, zu der die Anbindung gehört.
aliasstringjaDer 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.

EigenschaftTypErforderlichBeschreibung
typestringjaURI des Katalog-Features, das diese Anbindung anfordert.
resolved_versionstringjaDie exakte semantische Version, die während der Kompilierung aufgelöst wurde.
labelsMap von stringneinDie 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_annotationsMap von stringneinDie 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.
bindingstringneinBenennt 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.
valuesobjectneinPayload 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.
infraobjectneinPhysische Dimensionierung pro Instanz für diese Anbindung.
injectobjectneinAgnostisches Injektions-Routing. Ordnet lokale Variablen den provides-Schlüsseln des Ziels zu.
originstring (enum)neinUnterscheidet 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_keystringneinName der Annotation, die eine synthetische Anbindung ausgelöst hat. Fehlt, wenn origin explicit ist.
annotation_sourcestringneinQuellort der Annotationsdeklaration als :. Fehlt, wenn origin explicit ist.
values_provenanceMap von FieldProvenanceneinUrsprung pro Blatt für die values-Payload, geschlüsselt nach dem gepunkteten Blattpfad.
infra_provenanceMap von FieldProvenanceneinUrsprung pro Blatt für die infra-Payload, geschlüsselt nach dem gepunkteten Blattpfad.
sensitivebooleschneinIst 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_injectMap von Maps von stringneinDie 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_leavesstring[]neinDie 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. oder infra.. Die hier gelesene Payload ist diejenige, die die Anbindung letztlich trägt, sodass ein Blatt, das auf einem Wert steht, den das Feature-Schema als Standardwert deklariert, neben einem von einem Autor geschriebenen genannt wird — ein ausgefüllter Standardwert ist ein Datum, das die Payload trägt, und eine nur aus dem geschriebenen Block gelesene Markierung ließe es ungenannt. Dies ist die Einheit pro Blatt der Sensibilitätsmarkierung, und sie beantwortet eine Frage, die keines der beiden anderen Felder beantwortet — sensitive gibt eine Antwort für die gesamte Anbindung, sensitive_inject gibt eine pro Zustellschlüssel von inject, und keines der beiden nennt ein einzelnes Blatt. Ein Blatt erscheint dort, wo ein Pfad, den das Feature-Schema als sensibel deklariert, es abdeckt: Die Deklaration nennt dieses Blatt oder nennt ein Objekt, das es enthält, sodass ein Blatt unterhalb eines Objekts, das eine Deklaration abdeckt, von dieser Deklaration genannt wird. Der Abgleich läuft segmentweise über den gepunkteten Pfad, ohne dass etwas aus dem eigenen Text des Pfads gelesen oder ein Wert untersucht wird, sodass eine Deklaration bei 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.
connectionAttachmentConnectionneinDie 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.
realizationstringneinDas FeatureRecipe, das diese Anbindung realisiert, als :: dasjenige, das das Manifest an sie bindet — über den eigenen Namen der Anbindung, wo die Manifest-Namensebene diesen Namen zuordnet, andernfalls über ihren Feature-Typ —, also dasjenige, mit dem ein Build derselben Dokumente sie rendert. Bei einer an einer Verbindung geschriebenen Anbindung ist der Name, nach dem die Namensebene gelesen wird, ihr qualifizierter Name, der Alias der Verbindung und der Slot, durch einen Punkt verbunden. Der Wert ist das Paar, das aggrega inspect als Realisierung der Anbindung ausgibt, und, wo ein Ziel Herkunftsangaben auf das stempelt, was es rendert, der Wert aggrega.ai/recipe-uri auf den Dokumenten, die dieses FeatureRecipe rendert, sodass ein Verbraucher eine Anbindung mit dem verknüpft, was sie rendert, ohne zwischen Formen übersetzen zu müssen. Es nennt das FeatureRecipe nach Name und Version und nicht nach Fähigkeit. Das Feld verzeichnet, welches FeatureRecipe das Manifest bindet, gelesen aus dem Manifest und dem Katalog beim Aufbau des Graphen: Um es zu erzeugen, wird nichts abgerufen, und das FeatureRecipe wird erst gerendert, wenn der Build rendert. Fehlt, wenn das Manifest die Anbindung an kein FeatureRecipe bindet, das der Katalog vorhält.

Zusätzliche Eigenschaften sind nicht zulässig.

IRFeatureEntry.inject

Agnostisches Injektions-Routing. Ordnet lokale Variablen den provides-Schlüsseln des Ziels zu.

EigenschaftTypErforderlichBeschreibung
envMap von stringneinZustellung über Umgebungsvariablen: Die Schlüssel sind die Namen der lokalen Variablen des Verbrauchers, die Werte sind die provides-Schlüssel des Ziels.
fileMap von stringneinZustellung über Dateieinhängung: Die Schlüssel sind die lokalen Dateipfade des Verbrauchers, die Werte sind die provides-Schlüssel des Ziels.
argMap von stringneinZustellung ü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.

EigenschaftTypErforderlichBeschreibung
typestringjaURI des Katalog-Feature, das an dieser Boundary angebunden ist.
infraobjectneinPhysische Dimensionierung für die Boundary-Anbindung; die infra, gegen die ein FeatureRecipe mit Geltungsbereich boundary seine Templates und seine Quelle auswertet.
sensitive_payload_leavesstring[]neinDie 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., weil eine Anbindung auf Boundary-Ebene keine values-Payload trägt. Die hier gelesene Payload ist diejenige, die die Anbindung letztlich trägt, sodass ein Blatt, das auf einem Wert steht, den das Feature-Schema als Standardwert deklariert, neben einem von einer Boundary geschriebenen genannt wird — ein ausgefüllter Standardwert ist ein Datum, das die Payload trägt, und eine nur aus dem geschriebenen Block gelesene Markierung ließe es ungenannt. Ein Blatt erscheint dort, wo ein Pfad, den das Feature-Schema als sensibel deklariert, es abdeckt: Die Deklaration nennt dieses Blatt oder nennt ein Objekt, das es enthält, sodass ein Blatt unterhalb eines Objekts, das eine Deklaration abdeckt, von dieser Deklaration genannt wird. Der Abgleich läuft segmentweise über den gepunkteten Pfad, ohne dass etwas aus dem eigenen Text des Pfads gelesen oder ein Wert untersucht wird, sodass eine Deklaration bei 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.
realizationstringneinDas FeatureRecipe, das diese Boundary-Anbindung realisiert, als :: dasjenige, das das Manifest an sie bindet — über den eigenen Namen der Anbindung, wo die Manifest-Namensebene diesen Namen zuordnet, andernfalls über ihren Feature-Typ —, also dasjenige, mit dem ein Build derselben Dokumente sie rendert. Es ist dasselbe Feld, auf dieselbe Weise gelesen, wie die Realisierung eines Anbindungseintrags unter feature_values_mapping. Fehlt, wenn das Manifest die Anbindung an kein FeatureRecipe bindet, das der Katalog vorhält.

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.

EigenschaftTypErforderlichBeschreibung
maintainersMaintainer[]neinDie Maintainer, die die Katalogentität als ihre Eigentümer aufführt.
licensestringneinDie SPDX-Lizenzkennung, die die Katalogentität für die Software deklariert, die sie beschreibt.
repositorystringneinDie URL des Git-Repositorys, das die Katalogentität als Ort ihrer Quelldateien nennt.
homestringneinDie URL der Homepage, des Wikis oder der Dokumentation der Katalogentität.
keywordsstring[]neinDie beschreibenden Schlüsselwörter, die die Katalogentität deklariert.

Zusätzliche Eigenschaften sind nicht zulässig.

IRNode

EigenschaftTypErforderlichBeschreibung
descriptionstringneinOptionale, 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.
labelsMap von stringjaDie Duck-Typing- und Ontologie-Labels der Entität.
componentstringjaDer Name der zugrunde liegenden Component.
resolved_versionstringjaDie exakte semantische Version der Component, die während der Kompilierung aufgelöst wurde.
sync_waveintegerneinDie 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_pathstringneinDer 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_pathstringneinDer 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_subsystembooleschneinIst 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_boundarybooleschneinIst 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_metadataCatalogMetadataneinDie Unternehmens-Metadaten-Suite, explizit aus der Katalogentität extrahiert, die Lebenszyklus- und Eigentümerdaten für Wasm-Linter bereitstellt.
catalog_annotationsMap von stringneinUnveränderliche, intrinsische Komponenteneigenschaften, verfasst vom Plattformarchitekten in Domäne 2.
release_annotationsMap von stringneinPhysische Topologie-Strings und Ops-Realitäten, die aus den Boundaries im Release kaskadieren.
aggregate_annotationsMap von stringneinKognitive Metadaten, Entwicklerabsicht und FinOps, die aus den Subsystemen im Aggregate kaskadieren.
self_injectobjectneinSelf-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_filestringneinWorkspace-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.
usesobjectneinDer 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_leavesstring[]neinDie 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. oder infra.. Es nennt die EIGENEN Daten des Knotens — was values_mapping und infra_mapping für diesen Knoten tragen — und ist ein anderer Gegenstand als die Markierung an einem Anbindungseintrag, die Daten nennt, die eine Anbindung gegen die Deklaration trägt, die ihr Feature trifft. Keines ist aus dem anderen ableitbar: Die Component eines Knotens und das Feature einer Anbindung deklarieren unterschiedliche Schemas, und ein Knoten, der nichts anbindet, trägt trotzdem values. Die hier gelesene Payload ist diejenige, die diese beiden Mappings tragen, sodass ein Blatt, das auf einem Wert steht, den das Component-Schema als Standardwert deklariert, neben einem von einem Autor geschriebenen genannt wird — ein ausgefüllter Standardwert ist ein Datum, das der Graph trägt, und eine nur aus den geschriebenen Blöcken gelesene Markierung ließe es ungenannt. Ein Blatt erscheint dort, wo ein Pfad, den das Component-Schema als sensibel deklariert, es abdeckt: Die Deklaration nennt dieses Blatt oder nennt ein Objekt, das es enthält, sodass ein Blatt unterhalb eines Objekts, das eine Deklaration abdeckt, von dieser Deklaration genannt wird. Der Abgleich läuft segmentweise über den gepunkteten Pfad, ohne dass etwas aus dem eigenen Text des Pfads gelesen oder ein Wert untersucht wird, sodass eine Deklaration bei 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

EigenschaftTypErforderlichBeschreibung
sourcestringjaDie ID des verbrauchenden Knotens, an dem die Verbindung beginnt.
targetstringjaDie ID des Knotens, den die Verbindung erreicht.
socketstringneinDie usesSchema-Kategorie, zu der diese Kante gehört (z. B. ‘databases’, ‘tools’).
aliasstringneinDer vom Entwickler definierte Alias für diese Verbindung (z. B. ‘primary_db’).
socket_declarationstring (enum)jaWoher 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_featurestringneinWenn 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_instancestringneinDer 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_releasebooleschneinIst 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.
valuesobjectneinAufgelö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..values projiziert. Schlüssel, die der Autor ausgelassen hat, werden aus den deklarierten Standardwerten des Sockets gefüllt; ein verfasster Wert hat Vorrang.
infraobjectneinAufgelö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..infra projiziert. Schlüssel, die der Autor ausgelassen hat, werden aus den deklarierten Standardwerten des Sockets gefüllt; ein verfasster Wert hat Vorrang.
injectobjectneinAgnostisches Injektions-Routing. Ordnet lokale Variablen den provides-Schlüsseln des Ziels zu.
sensitive_payload_leavesstring[]neinDie 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. oder infra.. Die gelesene Deklaration ist der Vertrag pro Verbindung an der VERBRAUCHENDEN Komponente — der Quelle der Kante — unter dem Socket, in den diese Kante verdrahtet ist: Sein valueSchema regelt values und sein infraSchema regelt infra, was derselbe Vertrag ist, gegen den beide Payloads validiert werden. Die Deklarationen des Ziels sind unbeteiligt: Was das Ziel veröffentlicht, ist ein anderes Datum als die Konfiguration, die der Verbraucher für die Verbindung schreibt. Es ist dasselbe Feld, auf dieselbe Weise gelesen, wie die Markierung an einem Knoten, und ein anderer Gegenstand als sie: Die Markierung eines Knotens nennt die eigenen Daten des Knotens gegen das Schema seiner Component, und diese nennt die Konfiguration der Verbindung gegen den Vertrag des Sockets, sodass keines aus dem anderen ableitbar ist. Die hier gelesenen Payloads sind diejenigen, die diese Kante trägt, sodass ein Blatt, das auf einem Wert steht, den der Vertrag des Sockets als Standardwert deklariert, neben einem von einem Autor geschriebenen genannt wird. Ein Blatt erscheint dort, wo ein Pfad, den der Vertrag als sensibel deklariert, es abdeckt: Die Deklaration nennt dieses Blatt oder nennt ein Objekt, das es enthält. Der Abgleich läuft segmentweise über den gepunkteten Pfad, ohne dass etwas aus dem eigenen Text des Pfads gelesen oder ein Wert untersucht wird, sodass eine Deklaration bei 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.

EigenschaftTypErforderlichBeschreibung
envMap von stringneinZustellung über Umgebungsvariablen: Die Schlüssel sind die Namen der lokalen Variablen des Verbrauchers, die Werte sind die provides-Schlüssel des Ziels.
fileMap von stringneinZustellung über Dateieinhängung: Die Schlüssel sind die lokalen Dateipfade des Verbrauchers, die Werte sind die provides-Schlüssel des Ziels.
argMap von stringneinZustellung ü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.

EigenschaftTypErforderlichBeschreibung
aggregate_namestringjaDer metadata.name des Aggregate.

Zusätzliche Eigenschaften sind nicht zulässig.

IRProvenance

Rückverfolgbarkeitsmetadaten für Diagnose und Audit.

EigenschaftTypErforderlichBeschreibung
schema_versionstringjaDie Version des IR-Schemas, der der Graph entspricht — aggrega.ai/v1beta1, derselbe Wert, den die apiVersion des Graphen trägt.
compiler_versionstringjaVerpflichtender Konformitätsstempel. Identifiziert anhand seiner Version das aggrega-Binary, das diesen Graphen gebaut hat.
aggregate_versionstringjaDie exakte semantische Version der Absicht des Wurzel-Aggregate, die während der Kompilierung verwendet wurde.
manifest_versionstringjaDie exakte semantische Version des Manifest-Lockfiles, das während der Kompilierung verwendet wurde.
release_versionstringjaDie 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.

EigenschaftTypErforderlichBeschreibung
nodesMap von IRNodejaWö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_.-]+$.
edgesIREdge[]jaExplizite logische Netzwerkpfade und Abhängigkeiten zwischen Knoten.
values_mappingobjectjaDie einzige Quelle der Wahrheit für opake, unverändert durchgereichte kognitive Payloads, nach Knoten-ID zugeordnet.
infra_mappingobjectjaDie Payload der physischen Dimensionierung, aus dem Release injiziert, nach Knoten-ID zugeordnet.
feature_values_mappingMap von Map von IRFeatureEntryjaNormalisierte 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_featuresMap von Map von IRBoundaryFeatureneinDie 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_./-]+$.
provenanceIRProvenancejaRückverfolgbarkeitsmetadaten für Diagnose und Audit.

Zusätzliche Eigenschaften sind nicht zulässig.

IRGraph

EigenschaftTypErforderlichBeschreibung
apiVersionconst “aggrega.ai/v1beta1”jaKonstante: "aggrega.ai/v1beta1"
kindconst “IR”jaKonstante: "IR"
metadataIRMetadatajaIdentität des Graphen: das Aggregate, aus dem er gebaut wurde.
specIRSpecjaDer Graph selbst: seine Knoten, seine Kanten und die nach Knoten geschlüsselten Payloads.

Zusätzliche Eigenschaften sind nicht zulässig.