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

Schéma du graphe IR agnostique vis-à-vis des capacités 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/ir-v1beta1.schema.json

Le graphe aplati, entièrement résolu et unidimensionnel qu’émet le Topology Builder.

Type de premier niveau : object

Propriétés

PropriétéTypeObligatoireDescription
apiVersionconst “aggrega.ai/v1beta1”ouiConstante : "aggrega.ai/v1beta1"
kindconst “IR”ouiConstante : "IR"
metadataIRMetadataouiIdentité du graphe : l’Aggregate à partir duquel il a été construit.
specIRSpecouiLe graphe lui-même : ses nœuds, ses arêtes et les charges utiles indexées par nœud.

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

Définitions

Maintainer

PropriétéTypeObligatoireDescription
namestringouiLe nom du mainteneur.
emailstringnonL’adresse e-mail du mainteneur.
urlstringnonL’adresse web du mainteneur.

FieldProvenance

Origine d’une feuille dans la charge utile values ou infra d’un rattachement.

PropriétéTypeObligatoireDescription
originstringouiIndique si la feuille a été rédigée explicitement ou apportée par la passe d’expansion pilotée par les annotations.
sidestringnonSurface de rédaction sur laquelle l’annotation a été déclarée ; absent pour les feuilles explicites.
annotation_keystringnonNom de l’annotation qui a apporté cette feuille ; absent pour les feuilles explicites.
annotation_sourcestringnonEmplacement source de la déclaration de l’annotation sous la forme : ; absent pour les feuilles explicites.
overridden_annotationFieldProvenancenonLa contribution d’annotation qui a perdu cette feuille au profit d’une feuille explicite : lorsqu’une feuille explicite a écrasé une feuille apportée par une annotation, la provenance supprimée qu’elle a remplacée. Singulier — on ne conserve jamais plus d’une seule contribution supprimée.

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

AttachmentConnection

La connexion à laquelle appartient un rattachement, pour un rattachement écrit sur une connexion que trace un composant plutôt que dans le bloc de rattachements propre au composant : le socket par lequel la connexion est câblée et l’alias sous lequel elle est écrite. La paire nomme l’une des arêtes du graphe — l’arête dont la source est le nœud qui porte le rattachement et dont le socket et l’alias sont ceux-ci — de sorte qu’un consommateur relie le rattachement à cette arête, et par elle à la cible à laquelle le rattachement est présenté.

PropriétéTypeObligatoireDescription
socketstringouiLe socket par lequel la connexion est câblée : le socket de l’arête à laquelle appartient le rattachement.
aliasstringouiL’alias sous lequel la connexion est écrite : l’alias de l’arête à laquelle appartient le rattachement.

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

IRFeatureEntry

Un rattachement résolu pour un nœud, porté dans feature_values_mapping. Toutes les familles de rattachements partagent cette forme — une Feature opérationnelle, une Feature d’identifiants, une Feature d’identité — de sorte qu’aucune famille n’obtient une projection avec plus de pertes qu’une autre. Ce que porte le values d’un rattachement d’identifiants est le choix de l’auteur : des identifiants par référence portent un pointeur vers un magasin de secrets, des identifiants par valeur portent le matériel lui-même, et le compilateur porte tel quel ce qui a été écrit, sans résoudre ni l’un ni l’autre.

PropriétéTypeObligatoireDescription
typestringouiURI de la Feature du catalogue que demande ce rattachement.
resolved_versionstringouiLa version sémantique exacte résolue pendant la compilation.
labelsmap de stringnonLes labels de catalogue de la Feature rattachée, portés tels quels dans l’ordre où son entité de catalogue les déclare — jamais filtrés, normalisés ni dépouillés de leur préfixe, de sorte qu’un consommateur lit exactement ce qu’a écrit l’auteur du catalogue. Le compilateur n’en lit aucun. Absent lorsque la Feature ne déclare aucun label, et lorsque son type ne se résout en aucune entité de catalogue.
catalog_annotationsmap de stringnonLes annotations de catalogue de la Feature rattachée — les metadata.annotations de l’entité Feature que nomme ce rattachement — portées telles quelles dans l’ordre où cette entité les déclare, jamais filtrées, normalisées ni dépouillées de leur préfixe, de sorte qu’un consommateur lit exactement ce qu’a écrit l’auteur du catalogue, y compris les clés situées dans l’espace de noms propre de l’auteur. Le compilateur n’en lit aucune. Distinct de annotation_key et de annotation_source, qui nomment et localisent l’annotation qui a fait exister ce rattachement : ces deux champs rapportent comment le rattachement est né, celui-ci rapporte les métadonnées de l’entité qu’il nomme, et un rattachement écrit dans un bloc features: porte ces annotations sans porter aucun de ces deux champs. Absent lorsque la Feature ne déclare aucune annotation, et lorsque son type ne se résout en aucune entité de catalogue.
bindingstringnonNomme l’emplacement de rattachement qu’occupe ce rattachement, ou “free” lorsqu’il n’occupe aucun emplacement déclaré. Un emplacement est déclaré à l’un de deux endroits, et l’endroit où le rattachement a été écrit décide lequel : un rattachement du bloc de rattachements propre au nœud occupe un emplacement que le Component hôte déclare dans son featuresSchema, et un rattachement écrit sur une connexion occupe un emplacement que le socket de la connexion déclare dans le featuresSchema de ce socket sur le Component hôte. L’appariement se fait par nom dans les deux cas — un rattachement occupe un emplacement lorsque la Feature est rattachée sous le nom de l’emplacement, sur le bloc du composant ou sur la connexion — de sorte que la valeur est une clé exacte de l’ensemble des emplacements déclarés, jamais quelque chose lu dans la clé du rattachement. L’ensemble des emplacements d’un socket est fermé, puisqu’un rattachement écrit sur une connexion sous un nom que son socket ne déclare pas interrompt le build, de sorte qu’un rattachement qui porte une connexion ne rapporte jamais free. Le nom de l’emplacement est porté plutôt qu’un simple booléen parce que savoir quel emplacement a été occupé est la moitié la plus utile de la réponse. Vide lorsque l’ensemble des emplacements déclarés du Component hôte n’a pas pu être résolu, ce qui est distinct de “free” : free est le constat positif qu’aucun emplacement déclaré ne porte ce nom.
valuesobjectnonCharge utile de configuration opérationnelle du rattachement. Pour des identifiants, la forme qu’a déclarée l’auteur, quelle qu’elle soit — un pointeur vers un magasin de secrets, ou le matériel lui-même.
infraobjectnonDimensionnement physique par instance pour ce rattachement.
injectobjectnonRoutage d’injection agnostique. Associe les variables locales aux clés provides de la cible.
originstring (enum)nonDistingue les rattachements rédigés dans un bloc features: (explicit) des rattachements synthétiques produits par la passe d’expansion pilotée par les annotations (annotation), ou mixed lorsque les feuilles value/infra du rattachement portent un mélange des deux (le détail par feuille se trouve alors dans les maps de provenance). Valeurs autorisées : "explicit", "annotation", "mixed"
annotation_keystringnonNom de l’annotation qui a déclenché un rattachement synthétique. Absent lorsque origin vaut explicit.
annotation_sourcestringnonEmplacement source de la déclaration de l’annotation sous la forme :. Absent lorsque origin vaut explicit.
values_provenancemap de FieldProvenancenonOrigine par feuille de la charge utile values, indexée par chemin pointé de la feuille.
infra_provenancemap de FieldProvenancenonOrigine par feuille de la charge utile infra, indexée par chemin pointé de la feuille.
sensitivebooléennonVaut true lorsque ce rattachement manipule du matériel qu’un auteur a déclaré sensible — soit la Feature rattachée déclare une feuille sensible dans son pilier values, infra ou provides, soit l’emplacement qu’occupe le rattachement déclare sensible le matériel qu’il porte : l’emplacement de rattachement du même nom du Component hôte ou, pour un rattachement écrit sur une connexion, l’emplacement de ce nom que déclare le socket de la connexion. Dérivé de ces déclarations sur le rattachement fusionné, jamais du contenu d’une valeur ni d’un nom. Non défini lorsqu’aucune des deux déclarations n’est présente.
sensitive_injectmap de maps de stringnonLes clés de livraison de inject dont la clé provides référencée est déclarée sensible par la Feature rattachée, dans la forme propre de inject : mécanisme, puis clé de livraison, avec la clé provides référencée comme valeur. Un sous-ensemble de inject. Absent lorsque le rattachement ne déclare aucun mécanisme de livraison ou ne référence aucune clé provides sensible.
sensitive_payload_leavesstring[]nonLes feuilles que porte la charge utile values et infra de ce rattachement et que la Feature rattachée déclare sensibles, chacune sous la forme du chemin pointé préfixé par le pilier qu’occupe la donnée : values. ou infra.. La charge utile lue ici est celle que le rattachement finit par porter, de sorte qu’une feuille située à une valeur que le schéma de la Feature déclare comme valeur par défaut est nommée à côté d’une feuille écrite par un auteur — une valeur par défaut remplie est une donnée que porte la charge utile, et un marquage lu uniquement à partir du bloc écrit la laisserait sans nom. C’est l’unité par feuille du marquage de sensibilité, et elle répond à une question à laquelle aucun des deux autres champs ne répond — sensitive donne une seule réponse pour l’ensemble du rattachement, sensitive_inject en donne une par clé de livraison d’inject, et aucun des deux ne nomme une feuille individuelle. Une feuille apparaît là où un chemin que le schéma de la Feature déclare sensible la couvre : la déclaration nomme cette feuille, ou nomme un objet qui la contient, de sorte qu’une feuille située sous un objet couvert par une déclaration est nommée par cette déclaration. La correspondance s’effectue segment par segment sur le chemin pointé, sans rien lire du texte propre du chemin et sans inspecter aucune valeur, de sorte qu’une déclaration sur db couvre db.password et n’atteint pas une feuille sœur nommée dbPassword. La réponse par rattachement n’est jamais répartie sur les feuilles individuelles, ce qui affirmerait quelque chose de faux à propos d’une feuille laissée lisible. Une clé absente indique que ce rattachement ne nomme aucune feuille que sa Feature déclare sensible. Elle n’affirme pas que la charge utile n’est pas sensible, et elle ne distingue pas un rattachement qui n’a aucune feuille de ce type à nommer d’un producteur qui ne rapporte pas du tout cet axe — un guest qui lit une clé absente comme une permission d’afficher ou d’émettre une valeur en clair l’a lue à l’envers. Les feuilles arrivent dans l’ordre dans lequel la charge utile les contient, celles du pilier values avant celles du pilier infra — le même ordre que portent les charges utiles values et infra elles-mêmes, et ce qui rend la charge utile identique octet pour octet d’une exécution à l’autre pour une entrée identique. Absent lorsque le rattachement ne porte aucune feuille que sa Feature déclare sensible.
connectionAttachmentConnectionnonLa connexion à laquelle appartient ce rattachement : présente sur chaque rattachement écrit sur l’une des connexions du nœud, et absente sur chaque rattachement du bloc de rattachements propre au nœud. Un rattachement écrit sur une connexion est à tous les autres égards l’un des rattachements du nœud — indexé par son nom qualifié, l’alias de la connexion et l’emplacement joints par un point, et tenant sa liaison et sa sensibilité de l’emplacement que déclare le socket de la connexion — ce champ est donc ce qui distingue les deux, et il porte la connexion comme une donnée au lieu de la laisser à lire dans la clé. Un consommateur le joint aux arêtes du graphe par socket et alias : l’arête dont la source est le nœud portant ce rattachement et dont le socket et l’alias sont ceux-ci est la connexion sur laquelle le rattachement est présenté, et la cible de cette arête est ce à quoi il est présenté. Un rattachement d’une connexion que trace un rattachement de Feature n’en porte jamais, car une telle connexion ne porte aucun rattachement.
realizationstringnonLa FeatureRecipe qui réalise ce rattachement, sous la forme : : celle que le Manifest lui lie — par le nom propre du rattachement là où le niveau des noms du Manifest associe ce nom, sinon par son type de Feature — c’est-à-dire celle avec laquelle un build des mêmes documents en effectue le rendu. Pour un rattachement écrit sur une connexion, le nom par lequel le niveau des noms est lu est son nom qualifié, l’alias de la connexion et l’emplacement joints par un point. La valeur est la paire que aggrega inspect affiche comme réalisation du rattachement et, là où une cible appose la provenance sur ce dont elle effectue le rendu, la valeur aggrega.ai/recipe-uri sur les documents dont cette FeatureRecipe effectue le rendu, de sorte qu’un consommateur joint un rattachement à ce dont il effectue le rendu sans traduire d’une forme à l’autre. Elle nomme la FeatureRecipe par nom et version et non par capacité. Le champ enregistre quelle FeatureRecipe le Manifest lie, lue depuis le Manifest et le catalogue lors de la construction du graphe : rien n’est récupéré pour le produire, et la FeatureRecipe n’est rendue que lorsque le build effectue le rendu. Absent lorsque le Manifest ne lie le rattachement à aucune FeatureRecipe que contient le catalogue.

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

IRFeatureEntry.inject

Routage d’injection agnostique. Associe les variables locales aux clés provides de la cible.

PropriétéTypeObligatoireDescription
envmap de stringnonLivraison par variables d’environnement : les clés sont les noms des variables locales du consommateur, les valeurs sont les clés provides de la cible.
filemap de stringnonLivraison par montage de fichiers : les clés sont les chemins de fichiers locaux du consommateur, les valeurs sont les clés provides de la cible.
argmap de stringnonLivraison par arguments de ligne de commande : les clés sont les préfixes de flags du consommateur, les valeurs sont les clés provides de la cible.

IRBoundaryFeature

Un rattachement de Feature au niveau de la frontière projeté dans l’IR : l’URI du type de Feature plus l’infra de la frontière par rapport à laquelle une FeatureRecipe de portée boundary effectue son rendu et résout sa source. Les rattachements au niveau de la frontière ne portent aucune charge utile values.

PropriétéTypeObligatoireDescription
typestringouiURI de la Feature du catalogue rattachée à cette frontière.
infraobjectnonDimensionnement physique du rattachement à une frontière ; l’infra par rapport à laquelle une FeatureRecipe de portée boundary évalue ses templates et sa source.
sensitive_payload_leavesstring[]nonLes feuilles que porte la charge utile infra de ce rattachement à une frontière et que la Feature rattachée déclare sensibles, chacune sous la forme du chemin pointé préfixé par le pilier qu’occupe la donnée. Seules des coordonnées infra. apparaissent ici, car un rattachement au niveau de la frontière ne porte aucune charge utile values. La charge utile lue ici est celle que le rattachement finit par porter, de sorte qu’une feuille située à une valeur que le schéma de la Feature déclare comme valeur par défaut est nommée à côté d’une feuille écrite par une frontière — une valeur par défaut remplie est une donnée que porte la charge utile, et un marquage lu uniquement à partir du bloc écrit la laisserait sans nom. Une feuille apparaît là où un chemin que le schéma de la Feature déclare sensible la couvre : la déclaration nomme cette feuille, ou nomme un objet qui la contient, de sorte qu’une feuille située sous un objet couvert par une déclaration est nommée par cette déclaration. La correspondance s’effectue segment par segment sur le chemin pointé, sans rien lire du texte propre du chemin et sans inspecter aucune valeur, de sorte qu’une déclaration sur db couvre db.password et n’atteint pas une feuille sœur nommée dbPassword. Une clé absente indique que ce rattachement ne nomme aucune feuille que sa Feature déclare sensible, ce qui inclut le cas où la Feature rattachée ne se résout en aucun schéma que ce lecteur a pu lire. Elle n’affirme pas que la charge utile infra n’est pas sensible, et elle ne distingue pas un rattachement qui n’a aucune feuille de ce type à nommer d’un producteur qui ne rapporte pas du tout cet axe. Un consommateur qui lit une clé absente comme une permission d’afficher ou d’émettre une valeur en clair l’a lue à l’envers. Les feuilles arrivent dans l’ordre dans lequel la charge utile les contient, qui est le même ordre que porte la charge utile infra elle-même et ce qui maintient le graphe identique octet pour octet d’une exécution à l’autre pour une entrée identique. Absent lorsque le rattachement ne porte aucune feuille que sa Feature déclare sensible.
realizationstringnonLa FeatureRecipe qui réalise ce rattachement à une frontière, sous la forme : : celle que le Manifest lui lie — par le nom propre du rattachement là où le niveau des noms du Manifest associe ce nom, sinon par son type de Feature — c’est-à-dire celle avec laquelle un build des mêmes documents en effectue le rendu. C’est le même champ, lu de la même manière, que la réalisation d’une entrée de rattachement sous feature_values_mapping. Absent lorsque le Manifest ne lie le rattachement à aucune FeatureRecipe que contient le catalogue.

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

CatalogMetadata

La suite de métadonnées d’entreprise extraite explicitement de l’entité du catalogue, qui expose les données de cycle de vie et de propriété aux linters Wasm.

PropriétéTypeObligatoireDescription
maintainersMaintainer[]nonLes mainteneurs que l’entité du catalogue liste comme ses propriétaires.
licensestringnonL’identifiant de licence SPDX que l’entité du catalogue déclare pour le logiciel qu’elle décrit.
repositorystringnonL’URL du dépôt Git que l’entité du catalogue désigne comme contenant ses fichiers source.
homestringnonL’URL de la page d’accueil, du wiki ou de la documentation de l’entité du catalogue.
keywordsstring[]nonLes mots-clés descriptifs que déclare l’entité du catalogue.

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

IRNode

PropriétéTypeObligatoireDescription
descriptionstringnonDocumentation facultative rédigée par le développeur, décrivant le rôle de cette instance de composant dans l’application. Reprise depuis l’Aggregate pour le rendu et pour les diagnostics de lint.
labelsmap de stringouiLes labels de duck typing et d’ontologie de l’entité.
componentstringouiLe nom du Component sous-jacent.
resolved_versionstringouiLa version sémantique exacte du Component résolue lors de la compilation.
sync_waveintegernonLa vague de déploiement héritée du champ syncWave de la frontière qui le contient (0 par défaut ; valeurs négatives autorisées). Sur K8s et Helm, la vague est ce qui ordonne le déploiement : elle devient une annotation argocd.argoproj.io/sync-wave et, sur une ressource que le chart marque déjà comme hook Helm, elle devient aussi le helm.sh/hook-weight de ce hook. Sur compose, la valeur est à la fois enregistrée comme label de service et ordonne les services du fichier dans lequel elle est rendue, par des depends_on entre eux. Sur cloudformation, elle ordonne le provisionnement de la pile dans laquelle un groupe de dispatch s’assemble, chaque ressource d’une vague étant déclarée dépendante des ressources de la vague précédente : l’ordre dans lequel elles sont créées et, en sens inverse, l’ordre dans lequel elles sont supprimées, jamais la disponibilité, car un template de pile n’exprime aucune notion de ressource prête. Sur terraform, elle ordonne les blocs module de la configuration racine dans laquelle une frontière s’assemble, chaque module d’une vague étant déclaré dépendant des modules de la vague précédente : l’ordre dans lequel le moteur effectue ses actions, jamais la disponibilité, car une configuration n’exprime aucune notion de ressource prête. La valeur accompagne aussi la provenance de build du nœud.
boundary_pathstringnonLe chemin de la frontière de la Release dans laquelle ce nœud est placé : les noms des frontières de la plus externe vers l’intérieur, joints par / (par ex. ‘data/inner’ pour un composant placé dans une frontière inner déclarée à l’intérieur d’une frontière data). Un nom de frontière ne peut pas contenir /, de sorte que le chemin se décompose sans ambiguïté en ses frontières. Un nœud d’un Aggregate importé que la Release achemine dans une frontière porte le chemin de cette frontière. Permet aux plugins de rendu de générer des identifiants uniques tenant compte de la frontière.
subsystem_pathstringnonLe chemin du sous-système de l’Aggregate dans lequel le composant de ce nœud est déclaré : les noms des sous-systèmes du plus externe vers l’intérieur, joints par . (par ex. ‘backend.storage’ pour un composant déclaré dans un sous-système storage imbriqué dans un sous-système backend). Un nom de sous-système ne peut pas contenir ., de sorte que le chemin se décompose sans ambiguïté en ses sous-systèmes. Un composant d’un Aggregate qui déclare des components de premier niveau porte le default synthétisé, marqué par synthesized_subsystem. Le chemin est relatif à l’Aggregate qui déclare le composant : un nœud qu’apporte un Aggregate importé porte son chemin au sein de cet Aggregate, sans le nom sous lequel il est importé (par ex. ‘tier’ pour un composant du sous-système tier de l’Aggregate importé), de sorte que des nœuds de différents Aggregates peuvent partager un même chemin. L’ID du nœud, qui commence par le nom d’import, et source_file les distinguent.
synthesized_subsystembooléennonVaut true lorsque le sous-système de ce nœud a été synthétisé par le compilateur — le sous-système default créé pour un Aggregate qui déclare des components de premier niveau plutôt que des subsystems nommés. Provenance dérivée, jamais rédigée : elle distingue le default synthétisé d’un sous-système qu’un utilisateur a explicitement nommé default. Indépendant de synthesized_boundary (un nœud peut être synthétisé sur l’un ou l’autre axe, ou sur les deux). Absent (false) pour chaque sous-système rédigé.
synthesized_boundarybooléennonVaut true lorsque la frontière de ce nœud a été synthétisée par le compilateur — la frontière default créée pour une Release qui déclare des components de premier niveau plutôt que des boundaries nommées. Provenance dérivée, jamais rédigée : elle distingue le default synthétisé d’une frontière qu’un utilisateur a explicitement nommée default, et achemine les artefacts du nœud à plat dans dist/ au lieu de dist/boundaries/default/. Absent (false) pour chaque frontière rédigée.
catalog_metadataCatalogMetadatanonLa suite de métadonnées d’entreprise extraite explicitement de l’entité du catalogue, qui expose les données de cycle de vie et de propriété aux linters Wasm.
catalog_annotationsmap de stringnonCaractéristiques immuables et intrinsèques du composant, rédigées par l’architecte de plateforme dans le domaine 2.
release_annotationsmap de stringnonChaînes de topologie physique et réalités Ops qui descendent en cascade des frontières de la Release.
aggregate_annotationsmap de stringnonMétadonnées cognitives, intention du développeur et FinOps qui descendent en cascade des sous-systèmes de l’Aggregate.
self_injectobjectnonBloc self-inject au niveau du Component repris depuis l’Aggregate ; le routage d’injection agnostique que le nœud déclare pour lui-même. Opaque à ce niveau du schéma ; un plugin de policy qui le lit analyse les octets.
source_filestringnonChemin, relatif à l’espace de travail, du fichier de l’Aggregate dans lequel ce nœud a été rédigé. Les nœuds du niveau racine portent le chemin de l’Aggregate racine ; les nœuds des sous-agrégats portent le chemin de fichier de l’Aggregate importé. Le chemin est relatif à la racine de l’espace de travail (le répertoire contenant .aggrega-config.yaml), de sorte que le graphe est identique octet pour octet sur des machines dont les espaces de travail se trouvent à des chemins absolus différents. Les consommateurs qui filtrent les diagnostics par fichier résolvent le champ par rapport à la même racine de l’espace de travail avant la comparaison. Absent lorsque le graphe a été construit sans racine d’espace de travail.
usesobjectnonLe bloc uses du nœud exactement tel qu’il a été rédigé : chaque nom de socket correspond soit à une liste de noms d’instances cibles, soit à une map d’entrées de connexion indexée par alias, dans l’ordre dans lequel l’auteur les a déclarés. C’est le bloc tel qu’écrit, ce qui est un fait différent des connexions résolues dans edges : un socket que l’auteur a renseigné apparaît ici même là où il n’a produit aucune connexion, de sorte qu’un lecteur peut distinguer un socket que l’auteur a rempli d’un socket qui atteint une cible. Absent lorsque le nœud n’a rédigé aucun bloc uses. Opaque à ce niveau du schéma ; un plugin de policy qui le lit analyse les octets.
sensitive_payload_leavesstring[]nonLes feuilles que porte la charge utile values et infra de ce nœud et que son Component déclare sensibles, chacune sous la forme du chemin pointé préfixé par le pilier qu’occupe la donnée : values. ou infra.. Il nomme les données PROPRES du nœud — ce que values_mapping et infra_mapping portent pour ce nœud — et c’est un sujet différent du marquage sur une entrée de rattachement, qui nomme les données qu’un rattachement porte par rapport à la déclaration de sa Feature. Aucun des deux ne peut se déduire de l’autre : le Component d’un nœud et la Feature d’un rattachement déclarent des schémas différents, et un nœud qui ne rattache rien porte quand même des values. La charge utile lue ici est celle que portent ces deux mappages, de sorte qu’une feuille située à une valeur que le schéma du Component déclare comme valeur par défaut est nommée à côté d’une feuille écrite par un auteur — une valeur par défaut remplie est une donnée que porte le graphe, et un marquage lu uniquement à partir des blocs écrits la laisserait sans nom. Une feuille apparaît là où un chemin que le schéma du Component déclare sensible la couvre : la déclaration nomme cette feuille, ou nomme un objet qui la contient, de sorte qu’une feuille située sous un objet couvert par une déclaration est nommée par cette déclaration. La correspondance s’effectue segment par segment sur le chemin pointé, sans rien lire du texte propre du chemin et sans inspecter aucune valeur, de sorte qu’une déclaration sur db couvre db.password et n’atteint pas une feuille sœur nommée dbPassword. Une clé absente indique que ce nœud ne nomme aucune feuille que son Component déclare sensible, ce qui inclut le cas où le Component du nœud ne se résout en aucun schéma que ce lecteur a pu lire. Elle n’affirme pas que la charge utile du nœud n’est pas sensible, et elle ne distingue pas un nœud qui n’a aucune feuille de ce type à nommer d’un producteur qui ne rapporte pas du tout cet axe. Un consommateur qui lit une clé absente comme une permission d’afficher ou d’émettre une valeur en clair l’a lue à l’envers. Les feuilles arrivent dans l’ordre dans lequel la charge utile les contient, celles du pilier values avant celles du pilier infra, qui est le même ordre que portent ces charges utiles elles-mêmes et ce qui maintient le graphe identique octet pour octet d’une exécution à l’autre pour une entrée identique. Absent lorsque le nœud ne porte aucune feuille que son Component déclare sensible.

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

IREdge

PropriétéTypeObligatoireDescription
sourcestringouiL’ID du nœud consommateur, où commence la connexion.
targetstringouiL’ID du nœud qu’atteint la connexion.
socketstringnonLa catégorie de usesSchema à laquelle appartient cette arête (par ex. ‘databases’, ‘tools’).
aliasstringnonL’alias défini par le développeur pour cette connexion (par ex. ‘primary_db’).
socket_declarationstring (enum)ouiD’où provient le socket : declared lorsque l’entité du catalogue qui possède le socket le liste dans usesSchema (le Component consommateur, ou la Feature d’origine pour une arête écrite par une Feature), ad-hoc lorsque l’auteur de l’Aggregate a nommé un socket que le catalogue n’a pas déclaré. C’est un troisième axe, indépendant de la paternité de l’arête : il indique d’où provient le socket, et non qui a tracé l’arête, de sorte qu’une arête écrite par une Release vers un socket déclaré et une arête écrite par un Aggregate vers un socket ad hoc diffèrent sur les deux axes indépendamment. Un socket déclaré porte son entrée usesSchema, y compris le sélecteur qui restreint les cibles que l’arête peut atteindre ; un socket ad hoc n’a aucune entrée de catalogue et donc aucun sélecteur, de sorte que ce que l’arête peut porter est borné par les seuls provides déclarés de la cible. Toujours présent, de sorte qu’un consommateur n’a jamais à lire une valeur absente comme declared, et qu’une politique peut exiger que chaque arête soit déclarée. Distinct du marqueur de liaison d’un rattachement, qui répond à la même forme de question à propos d’un sujet différent. Valeurs autorisées : "declared", "ad-hoc"
origin_featurestringnonSi cette arête a été déclarée de manière autonome par une Feature (y compris les Features d’identifiants portant le label feature.aggrega.ai/kind: secret), ceci identifie l’URI du type de Feature. Permet aux plugins Wasm d’isoler leur propre topologie.
origin_feature_instancestringnonLe nom d’instance par rattachement de la Feature qui a déclaré cette arête. Localise par instance les provides résolus d’une FeatureRecipe de portée boundary, en distinguant deux rattachements du même type de Feature sur une même frontière.
origin_releasebooléennonVaut true lorsque cette arête a été créée par une Release qui câble un socket déclaré mais non lié à un composant existant. Marque la PATERNITÉ de l’arête, et non la configuration : une arête déclarée par le développeur pour laquelle une Release a seulement fourni l’infra reste d’origine Aggregate (origin_release non défini ; l’infra de sa Release apparaît dans la map infra de l’arête). origin_feature défini => origine Feature ; origin_release true => origine Release ; aucun des deux => origine Aggregate.
valuesobjectnonValeurs de développeur par connexion résolues pour cette arête (issues de l’arête de l’Aggregate), validées lors de la résolution par rapport au valueSchema déclaré par le socket source (le socket du composant consommateur, qui est la source de l’arête) et projetées dans le contexte de rendu du nœud consommateur en .context.uses..values. Les clés que l’auteur a omises sont remplies à partir des valeurs par défaut déclarées du socket ; une valeur rédigée l’emporte.
infraobjectnonInfra par connexion résolue pour cette arête, fournie par une entrée d’arête de la Release, validée lors de la résolution par rapport à l’infraSchema déclaré par le socket source (le socket du composant consommateur, qui est la source de l’arête) et projetée en .context.uses..infra. Les clés que l’auteur a omises sont remplies à partir des valeurs par défaut déclarées du socket ; une valeur rédigée l’emporte.
injectobjectnonRoutage d’injection agnostique. Associe les variables locales aux clés provides de la cible.
sensitive_payload_leavesstring[]nonLes feuilles que portent les values et l’infra de cette arête et que le socket par rapport auquel elles sont écrites déclare sensibles, chacune sous la forme du chemin pointé préfixé par le pilier qu’occupe la donnée : values. ou infra.. La déclaration lue est le contrat par connexion du composant CONSOMMATEUR — la source de l’arête — sous le socket dans lequel cette arête est câblée : son valueSchema régit values et son infraSchema régit infra, ce qui est le même contrat par rapport auquel les deux charges utiles sont validées. Les déclarations de la cible n’interviennent pas : ce que la cible publie est une donnée différente de la configuration que le consommateur écrit pour la connexion. C’est le même champ, lu de la même manière, que le marquage sur un nœud, et un sujet différent de celui-ci : le marquage d’un nœud nomme les données propres du nœud par rapport au schéma de son Component, et celui-ci nomme la configuration de la connexion par rapport au contrat du socket, de sorte qu’aucun des deux ne peut se déduire de l’autre. Les charges utiles lues ici sont celles que porte cette arête, de sorte qu’une feuille située à une valeur que le contrat du socket déclare comme valeur par défaut est nommée à côté d’une feuille écrite par un auteur. Une feuille apparaît là où un chemin que le contrat déclare sensible la couvre : la déclaration nomme cette feuille, ou nomme un objet qui la contient. La correspondance s’effectue segment par segment sur le chemin pointé, sans rien lire du texte propre du chemin et sans inspecter aucune valeur, de sorte qu’une déclaration sur db couvre db.password et n’atteint pas une feuille sœur nommée db_password. Une surface qui retient du graphe les valeurs déclarées sensibles retient ces feuilles dans les values et l’infra de cette arête, ainsi que dans l’entrée uses du nœud consommateur pour la même connexion, qui porte les valeurs telles que l’auteur les a écrites. Une clé absente indique que cette arête ne nomme aucune feuille que le contrat de son socket déclare sensible, ce qui inclut le cas où le socket ne déclare aucun contrat que ce lecteur a pu lire. Elle n’affirme pas que la configuration n’est pas sensible, et un consommateur qui lit une clé absente comme une permission d’afficher ou d’émettre une valeur en clair l’a lue à l’envers. Les feuilles arrivent dans l’ordre dans lequel les charges utiles les contiennent, celles du pilier values avant celles du pilier infra, ce qui maintient le graphe identique octet pour octet d’une exécution à l’autre pour une entrée identique. Absent lorsque l’arête ne porte aucune feuille que le contrat de son socket déclare sensible.

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

IREdge.inject

Routage d’injection agnostique. Associe les variables locales aux clés provides de la cible.

PropriétéTypeObligatoireDescription
envmap de stringnonLivraison par variables d’environnement : les clés sont les noms des variables locales du consommateur, les valeurs sont les clés provides de la cible.
filemap de stringnonLivraison par montage de fichiers : les clés sont les chemins de fichiers locaux du consommateur, les valeurs sont les clés provides de la cible.
argmap de stringnonLivraison par arguments de ligne de commande : les clés sont les préfixes de flags du consommateur, les valeurs sont les clés provides de la cible.

IRMetadata

Identité du graphe : l’Aggregate à partir duquel il a été construit.

PropriétéTypeObligatoireDescription
aggregate_namestringouiLe metadata.name de l’Aggregate.

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

IRProvenance

Métadonnées de traçabilité pour le diagnostic et l’audit.

PropriétéTypeObligatoireDescription
schema_versionstringouiLa version du schéma IR à laquelle le graphe se conforme — aggrega.ai/v1beta1, la même valeur que porte l’apiVersion du graphe.
compiler_versionstringouiTampon de conformité obligatoire. Identifie, par sa version, le binaire aggrega qui a construit ce graphe.
aggregate_versionstringouiLa version sémantique exacte de l’intention de l’Aggregate racine utilisée lors de la compilation.
manifest_versionstringouiLa version sémantique exacte du fichier de verrouillage du Manifest utilisé lors de la compilation.
release_versionstringouiLa version sémantique exacte du fichier de routage de la Release utilisé lors de la compilation.

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

IRSpec

Le graphe lui-même : ses nœuds, ses arêtes et les charges utiles indexées par nœud.

PropriétéTypeObligatoireDescription
nodesmap de IRNodeouiDictionnaire de tous les nœuds du graphe, indexés par leur ID absolu. Purement topologique. Clés : une ou plusieurs lettres, chiffres, traits de soulignement, points ou traits d’union. Motif : ^[a-zA-Z0-9_.-]+$.
edgesIREdge[]ouiChemins réseau logiques explicites et dépendances entre les nœuds.
values_mappingobjectouiLa source unique de vérité pour les charges utiles cognitives opaques transmises telles quelles, associées par ID de nœud.
infra_mappingobjectouiLa charge utile de dimensionnement physique injectée depuis la Release, associée par ID de nœud.
feature_values_mappingmap de map de IRFeatureEntryouiMap normalisée des ID de nœuds vers leurs configurations de Feature rattachées. Un seul compartiment porte chaque rattachement d’un nœud, quoi qu’il produise — Features opérationnelles, Features d’identifiants, Features d’identité — indexé par le nom d’instance que l’auteur a donné à chaque rattachement. Un rattachement écrit sur l’une des connexions du nœud est indexé par son nom qualifié, l’alias de la connexion et l’emplacement joints par un point, et nomme sa connexion dans son propre champ connection. Clés : une ou plusieurs lettres, chiffres, traits de soulignement, points ou traits d’union. Motif : ^[a-zA-Z0-9_.-]+$.
boundary_featuresmap de map de IRBoundaryFeaturenonLes rattachements de Feature de chaque frontière, indexés par chemin de frontière puis par nom d’instance. Présent uniquement lorsque le graphe a des rattachements de Feature au niveau de la frontière. Clés : une ou plusieurs lettres, chiffres, traits de soulignement, points, barres obliques ou traits d’union. Motif : ^[a-zA-Z0-9_./-]+$.
provenanceIRProvenanceouiMétadonnées de traçabilité pour le diagnostic et l’audit.

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

IRGraph

PropriétéTypeObligatoireDescription
apiVersionconst “aggrega.ai/v1beta1”ouiConstante : "aggrega.ai/v1beta1"
kindconst “IR”ouiConstante : "IR"
metadataIRMetadataouiIdentité du graphe : l’Aggregate à partir duquel il a été construit.
specIRSpecouiLe graphe lui-même : ses nœuds, ses arêtes et les charges utiles indexées par nœud.

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