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é | Type | Obligatoire | Description |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | oui | Constante : "aggrega.ai/v1beta1" |
kind | const “IR” | oui | Constante : "IR" |
metadata | IRMetadata | oui | Identité du graphe : l’Aggregate à partir duquel il a été construit. |
spec | IRSpec | oui | Le 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é | Type | Obligatoire | Description |
|---|---|---|---|
name | string | oui | Le nom du mainteneur. |
email | string | non | L’adresse e-mail du mainteneur. |
url | string | non | L’adresse web du mainteneur. |
FieldProvenance
Origine d’une feuille dans la charge utile values ou infra d’un rattachement.
| Propriété | Type | Obligatoire | Description |
|---|---|---|---|
origin | string | oui | Indique si la feuille a été rédigée explicitement ou apportée par la passe d’expansion pilotée par les annotations. |
side | string | non | Surface de rédaction sur laquelle l’annotation a été déclarée ; absent pour les feuilles explicites. |
annotation_key | string | non | Nom de l’annotation qui a apporté cette feuille ; absent pour les feuilles explicites. |
annotation_source | string | non | Emplacement source de la déclaration de l’annotation sous la forme |
overridden_annotation | FieldProvenance | non | La 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é | Type | Obligatoire | Description |
|---|---|---|---|
socket | string | oui | Le socket par lequel la connexion est câblée : le socket de l’arête à laquelle appartient le rattachement. |
alias | string | oui | L’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é | Type | Obligatoire | Description |
|---|---|---|---|
type | string | oui | URI de la Feature du catalogue que demande ce rattachement. |
resolved_version | string | oui | La version sémantique exacte résolue pendant la compilation. |
labels | map de string | non | Les 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_annotations | map de string | non | Les 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. |
binding | string | non | Nomme 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. |
values | object | non | Charge 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. |
infra | object | non | Dimensionnement physique par instance pour ce rattachement. |
inject | object | non | Routage d’injection agnostique. Associe les variables locales aux clés provides de la cible. |
origin | string (enum) | non | Distingue 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_key | string | non | Nom de l’annotation qui a déclenché un rattachement synthétique. Absent lorsque origin vaut explicit. |
annotation_source | string | non | Emplacement source de la déclaration de l’annotation sous la forme |
values_provenance | map de FieldProvenance | non | Origine par feuille de la charge utile values, indexée par chemin pointé de la feuille. |
infra_provenance | map de FieldProvenance | non | Origine par feuille de la charge utile infra, indexée par chemin pointé de la feuille. |
sensitive | booléen | non | Vaut 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_inject | map de maps de string | non | Les 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_leaves | string[] | non | Les 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.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. |
connection | AttachmentConnection | non | La 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. |
realization | string | non | La FeatureRecipe qui réalise ce rattachement, sous la forme |
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é | Type | Obligatoire | Description |
|---|---|---|---|
env | map de string | non | Livraison 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. |
file | map de string | non | Livraison 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. |
arg | map de string | non | Livraison 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é | Type | Obligatoire | Description |
|---|---|---|---|
type | string | oui | URI de la Feature du catalogue rattachée à cette frontière. |
infra | object | non | Dimensionnement 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_leaves | string[] | non | Les 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.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. |
realization | string | non | La FeatureRecipe qui réalise ce rattachement à une frontière, sous la forme |
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é | Type | Obligatoire | Description |
|---|---|---|---|
maintainers | Maintainer[] | non | Les mainteneurs que l’entité du catalogue liste comme ses propriétaires. |
license | string | non | L’identifiant de licence SPDX que l’entité du catalogue déclare pour le logiciel qu’elle décrit. |
repository | string | non | L’URL du dépôt Git que l’entité du catalogue désigne comme contenant ses fichiers source. |
home | string | non | L’URL de la page d’accueil, du wiki ou de la documentation de l’entité du catalogue. |
keywords | string[] | non | Les 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é | Type | Obligatoire | Description |
|---|---|---|---|
description | string | non | Documentation 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. |
labels | map de string | oui | Les labels de duck typing et d’ontologie de l’entité. |
component | string | oui | Le nom du Component sous-jacent. |
resolved_version | string | oui | La version sémantique exacte du Component résolue lors de la compilation. |
sync_wave | integer | non | La 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_path | string | non | Le 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_path | string | non | Le 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_subsystem | booléen | non | Vaut 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_boundary | booléen | non | Vaut 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_metadata | CatalogMetadata | non | 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. |
catalog_annotations | map de string | non | Caractéristiques immuables et intrinsèques du composant, rédigées par l’architecte de plateforme dans le domaine 2. |
release_annotations | map de string | non | Chaînes de topologie physique et réalités Ops qui descendent en cascade des frontières de la Release. |
aggregate_annotations | map de string | non | Métadonnées cognitives, intention du développeur et FinOps qui descendent en cascade des sous-systèmes de l’Aggregate. |
self_inject | object | non | Bloc 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_file | string | non | Chemin, 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. |
uses | object | non | Le 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_leaves | string[] | non | Les 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.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é | Type | Obligatoire | Description |
|---|---|---|---|
source | string | oui | L’ID du nœud consommateur, où commence la connexion. |
target | string | oui | L’ID du nœud qu’atteint la connexion. |
socket | string | non | La catégorie de usesSchema à laquelle appartient cette arête (par ex. ‘databases’, ‘tools’). |
alias | string | non | L’alias défini par le développeur pour cette connexion (par ex. ‘primary_db’). |
socket_declaration | string (enum) | oui | D’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_feature | string | non | Si 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_instance | string | non | Le 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_release | booléen | non | Vaut 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. |
values | object | non | Valeurs 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. |
infra | object | non | Infra 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. |
inject | object | non | Routage d’injection agnostique. Associe les variables locales aux clés provides de la cible. |
sensitive_payload_leaves | string[] | non | Les 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.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é | Type | Obligatoire | Description |
|---|---|---|---|
env | map de string | non | Livraison 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. |
file | map de string | non | Livraison 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. |
arg | map de string | non | Livraison 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é | Type | Obligatoire | Description |
|---|---|---|---|
aggregate_name | string | oui | Le 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é | Type | Obligatoire | Description |
|---|---|---|---|
schema_version | string | oui | La version du schéma IR à laquelle le graphe se conforme — aggrega.ai/v1beta1, la même valeur que porte l’apiVersion du graphe. |
compiler_version | string | oui | Tampon de conformité obligatoire. Identifie, par sa version, le binaire aggrega qui a construit ce graphe. |
aggregate_version | string | oui | La version sémantique exacte de l’intention de l’Aggregate racine utilisée lors de la compilation. |
manifest_version | string | oui | La version sémantique exacte du fichier de verrouillage du Manifest utilisé lors de la compilation. |
release_version | string | oui | La 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é | Type | Obligatoire | Description |
|---|---|---|---|
nodes | map de IRNode | oui | Dictionnaire 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_.-]+$. |
edges | IREdge[] | oui | Chemins réseau logiques explicites et dépendances entre les nœuds. |
values_mapping | object | oui | La source unique de vérité pour les charges utiles cognitives opaques transmises telles quelles, associées par ID de nœud. |
infra_mapping | object | oui | La charge utile de dimensionnement physique injectée depuis la Release, associée par ID de nœud. |
feature_values_mapping | map de map de IRFeatureEntry | oui | Map 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_features | map de map de IRBoundaryFeature | non | Les 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_./-]+$. |
provenance | IRProvenance | oui | Mé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é | Type | Obligatoire | Description |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | oui | Constante : "aggrega.ai/v1beta1" |
kind | const “IR” | oui | Constante : "IR" |
metadata | IRMetadata | oui | Identité du graphe : l’Aggregate à partir duquel il a été construit. |
spec | IRSpec | oui | Le 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.