Schema del grafo IR agnostico rispetto alle capacità di Aggrega
Riferimento generato. Non modificarlo a mano — rigeneralo a partire dal JSON Schema pubblicato.
Id dello schema: https://aggrega.ai/schemas/ir-v1beta1.schema.json
Il grafo appiattito, completamente risolto e unidimensionale emesso dal Topology Builder.
Tipo di primo livello: object
Proprietà
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | sì | Costante: "aggrega.ai/v1beta1" |
kind | const “IR” | sì | Costante: "IR" |
metadata | IRMetadata | sì | Identità del grafo: l’Aggregate da cui è stato costruito. |
spec | IRSpec | sì | Il grafo stesso: i suoi nodi, i suoi archi e i payload indicizzati per nodo. |
Non sono consentite proprietà aggiuntive.
Definizioni
Maintainer
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
name | string | sì | Il nome del maintainer. |
email | string | no | L’indirizzo email del maintainer. |
url | string | no | L’indirizzo web del maintainer. |
FieldProvenance
Origine di una foglia nel payload values o infra di un’associazione.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
origin | string | sì | Se la foglia è stata scritta esplicitamente dall’autore o fornita dal passaggio di espansione guidato dalle annotazioni. |
side | string | no | Superficie di authoring su cui è stata dichiarata l’annotazione; assente per le foglie esplicite. |
annotation_key | string | no | Nome dell’annotazione che ha fornito questa foglia; assente per le foglie esplicite. |
annotation_source | string | no | Posizione nel sorgente della dichiarazione dell’annotazione come |
overridden_annotation | FieldProvenance | no | Il contributo dell’annotazione che ha perso questa foglia a favore di una esplicita: quando una foglia esplicita ha sovrascritto una foglia fornita da un’annotazione, la provenienza soppressa che ha sostituito. Singolare — non viene mai conservato più di un solo contributo soppresso. |
Non sono consentite proprietà aggiuntive.
AttachmentConnection
La connessione a cui appartiene un’associazione, per un’associazione scritta su una connessione che un componente traccia anziché nel blocco di associazioni proprio del componente: il socket attraverso cui la connessione è cablata e l’alias sotto cui è scritta. La coppia nomina uno degli archi del grafo — l’arco la cui sorgente è il nodo che porta l’associazione e il cui socket e alias sono questi — così un consumatore collega l’associazione a quell’arco e, attraverso di esso, alla destinazione a cui l’associazione viene presentata.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
socket | string | sì | Il socket attraverso cui la connessione è cablata: il socket dell’arco a cui appartiene l’associazione. |
alias | string | sì | L’alias sotto cui è scritta la connessione: l’alias dell’arco a cui appartiene l’associazione. |
Non sono consentite proprietà aggiuntive.
IRFeatureEntry
Un’associazione risolta per un nodo, portata in feature_values_mapping. Ogni famiglia di associazioni condivide questa forma — una Feature operativa, una Feature di credenziali, una Feature di identità — così nessuna famiglia riceve una proiezione con più perdite di un’altra. Ciò che porta il values di un’associazione di credenziali è una scelta dell’autore: una credenziale per riferimento porta un puntatore a un archivio di segreti, una per valore porta il materiale stesso, e il compilatore porta testualmente quella che è stata scritta senza risolvere né l’una né l’altra.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
type | string | sì | URI della Feature del catalogo che questa associazione richiede. |
resolved_version | string | sì | La versione semantica esatta risolta durante la compilazione. |
labels | mappa di string | no | Le etichette di catalogo della Feature associata, portate testualmente nell’ordine in cui le dichiara la sua entità di catalogo — mai filtrate, normalizzate o private del prefisso, così un consumatore legge esattamente ciò che ha scritto l’autore del catalogo. Il compilatore non ne legge nessuna. Assente quando la Feature non dichiara etichette, e quando il suo tipo non si risolve in alcuna entità di catalogo. |
catalog_annotations | mappa di string | no | Le annotazioni di catalogo della Feature associata — le metadata.annotations dell’entità Feature che questa associazione nomina — portate testualmente nell’ordine in cui quell’entità le dichiara, mai filtrate, normalizzate o private del prefisso, così un consumatore legge esattamente ciò che ha scritto l’autore del catalogo, comprese le chiavi nel namespace proprio dell’autore. Il compilatore non ne legge nessuna. Distinte da annotation_key e annotation_source, che nominano e localizzano l’annotazione che ha fatto esistere questa associazione: quei due riportano come è nata l’associazione, questo riporta i metadati dell’entità che nomina, e un’associazione scritta in un blocco features: porta queste annotazioni senza portare nessuno di quei due. Assente quando la Feature non dichiara annotazioni, e quando il suo tipo non si risolve in alcuna entità di catalogo. |
binding | string | no | Nomina lo slot di associazione che questa associazione occupa, oppure “free” quando non occupa alcuno slot dichiarato. Uno slot è dichiarato in uno di due punti, e dove è stata scritta l’associazione decide quale: un’associazione del blocco di associazioni proprio del nodo occupa uno slot che il Component host dichiara nel suo featuresSchema, e un’associazione scritta su una connessione occupa uno slot che il socket della connessione dichiara nel featuresSchema di quel socket sul Component host. In entrambi i casi l’abbinamento avviene per nome — un’associazione occupa uno slot quando la Feature è associata sotto il nome dello slot, nel blocco del componente o sulla connessione — quindi il valore è una chiave esatta dell’insieme degli slot dichiarati, mai qualcosa letto dalla chiave dell’associazione. L’insieme degli slot di un socket è chiuso, poiché un’associazione scritta su una connessione sotto un nome che il suo socket non dichiara arresta la build, quindi un’associazione che porta una connessione non riporta mai free. Viene portato il nome dello slot anziché un semplice booleano perché quale slot è stato occupato è la metà più utile della risposta. Vuoto quando l’insieme degli slot dichiarati del Component host non ha potuto essere risolto, il che è distinto da “free”: free è la constatazione positiva che nessuno slot dichiarato porta questo nome. |
values | object | no | Payload di configurazione operativa per l’associazione. Per una credenziale, qualunque forma l’autore abbia dichiarato — un puntatore a un archivio di segreti, o il materiale stesso. |
infra | object | no | Dimensionamento fisico per istanza per questa associazione. |
inject | object | no | Instradamento agnostico dell’iniezione. Mappa le variabili locali sulle chiavi provides della destinazione. |
origin | string (enum) | no | Distingue le associazioni scritte in un blocco features: (explicit) dalle associazioni sintetiche prodotte dal passaggio di espansione guidato dalle annotazioni (annotation), oppure mixed quando le foglie value/infra dell’associazione portano una combinazione di entrambe (il dettaglio per foglia si trova allora nelle mappe di provenienza). Valori consentiti: "explicit", "annotation", "mixed" |
annotation_key | string | no | Nome dell’annotazione che ha attivato un’associazione sintetica. Assente quando origin è explicit. |
annotation_source | string | no | Posizione nel sorgente della dichiarazione dell’annotazione come |
values_provenance | mappa di FieldProvenance | no | Origine per foglia per il payload values, indicizzata per percorso puntato della foglia. |
infra_provenance | mappa di FieldProvenance | no | Origine per foglia per il payload infra, indicizzata per percorso puntato della foglia. |
sensitive | booleana | no | Vale true quando questa associazione gestisce materiale che un autore ha dichiarato sensibile — o la Feature associata dichiara una foglia sensibile nel suo pilastro values, infra o provides, oppure lo slot che l’associazione occupa dichiara sensibile il materiale che porta: lo slot di associazione con lo stesso nome del Component host oppure, per un’associazione scritta su una connessione, lo slot con quel nome che il socket della connessione dichiara. Derivato da quelle dichiarazioni sull’associazione unita, mai dal contenuto di un valore o da un nome. Non impostato quando nessuna delle due dichiarazioni è presente. |
sensitive_inject | mappa di mappe di string | no | Le chiavi di consegna di inject la cui chiave provides referenziata è dichiarata sensibile dalla Feature associata, nella forma propria di inject: meccanismo, poi chiave di consegna, con la chiave provides referenziata come valore. Un sottoinsieme di inject. Assente quando l’associazione non dichiara alcun meccanismo di consegna o non fa riferimento ad alcuna chiave provides sensibile. |
sensitive_payload_leaves | string[] | no | Le foglie che il payload values e infra di questa associazione porta e che la Feature associata dichiara sensibili, ciascuna come il percorso puntato con prefisso del pilastro occupato dal dato: values.db copre db.password e non raggiunge una foglia sorella chiamata dbPassword. La risposta per associazione non viene mai distribuita sulle singole foglie, il che affermerebbe qualcosa di falso su una foglia lasciata leggibile. Una chiave assente afferma che questa associazione non nomina alcuna foglia che la sua Feature dichiara sensibile. Non afferma che il payload non sia sensibile, e non distingue un’associazione che non ha una tale foglia da nominare da un produttore che non riporta affatto questo asse — un guest che legge una chiave assente come permesso di mostrare o emettere un valore in chiaro l’ha letta al contrario. Le foglie arrivano nell’ordine in cui il payload le contiene, quelle del pilastro values prima di quelle del pilastro infra — lo stesso ordine che portano i payload values e infra stessi, ed è ciò che rende il payload identico byte per byte tra esecuzioni con input identico. Assente quando l’associazione non porta alcuna foglia che la sua Feature dichiara sensibile. |
connection | AttachmentConnection | no | La connessione a cui appartiene questa associazione: presente su ogni associazione scritta su una delle connessioni del nodo, e assente su ogni associazione del blocco di associazioni proprio del nodo. Un’associazione scritta su una connessione è, sotto ogni altro aspetto, una delle associazioni del nodo — indicizzata dal suo nome qualificato, cioè l’alias della connessione e lo slot uniti da un punto, e che prende il suo legame e la sua sensibilità dallo slot che il socket della connessione dichiara — quindi questo campo è ciò che distingue le due, e porta la connessione come dato anziché lasciarla da leggere dalla chiave. Un consumatore lo unisce agli archi del grafo tramite socket e alias: l’arco la cui sorgente è il nodo che porta questa associazione e il cui socket e alias sono questi è la connessione su cui l’associazione viene presentata, e la destinazione di quell’arco è ciò a cui viene presentata. Un’associazione di una connessione tracciata da un’associazione di Feature non ne porta mai uno, perché una tale connessione non porta associazioni. |
realization | string | no | La FeatureRecipe che realizza questa associazione, come |
Non sono consentite proprietà aggiuntive.
IRFeatureEntry.inject
Instradamento agnostico dell’iniezione. Mappa le variabili locali sulle chiavi provides della destinazione.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
env | mappa di string | no | Consegna tramite variabili d’ambiente: le chiavi sono i nomi delle variabili locali del consumatore, i valori sono le chiavi provides della destinazione. |
file | mappa di string | no | Consegna tramite montaggio di file: le chiavi sono i percorsi dei file locali del consumatore, i valori sono le chiavi provides della destinazione. |
arg | mappa di string | no | Consegna tramite argomenti della riga di comando: le chiavi sono i prefissi dei flag del consumatore, i valori sono le chiavi provides della destinazione. |
IRBoundaryFeature
Un’associazione di Feature a livello di confine proiettata nell’IR: l’URI del tipo di Feature più l’infra del confine rispetto alla quale una FeatureRecipe con ambito boundary esegue il rendering e risolve la propria sorgente. Le associazioni a livello di confine non portano alcun payload values.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
type | string | sì | URI della Feature del catalogo associata a questo confine. |
infra | object | no | Dimensionamento fisico per l’associazione al confine; l’infra rispetto alla quale una FeatureRecipe con ambito boundary valuta i propri template e la propria sorgente. |
sensitive_payload_leaves | string[] | no | Le foglie che il payload infra di questa associazione al confine porta e che la Feature associata dichiara sensibili, ciascuna come il percorso puntato con prefisso del pilastro occupato dal dato. Qui compaiono solo coordinate infra.db copre db.password e non raggiunge una foglia sorella chiamata dbPassword. Una chiave assente afferma che questa associazione non nomina alcuna foglia che la sua Feature dichiara sensibile, il che include il caso in cui la Feature associata non si risolve in alcuno schema che questo lettore possa leggere. Non afferma che il payload infra non sia sensibile, e non distingue un’associazione che non ha una tale foglia da nominare da un produttore che non riporta affatto questo asse. Un consumatore che legge una chiave assente come permesso di mostrare o emettere un valore in chiaro l’ha letta al contrario. Le foglie arrivano nell’ordine in cui il payload le contiene, che è lo stesso ordine che porta il payload infra stesso ed è ciò che mantiene il grafo identico byte per byte tra esecuzioni con input identico. Assente quando l’associazione non porta alcuna foglia che la sua Feature dichiara sensibile. |
realization | string | no | La FeatureRecipe che realizza questa associazione al confine, come |
Non sono consentite proprietà aggiuntive.
CatalogMetadata
La suite di metadati aziendali estratta esplicitamente dall’entità di catalogo, che espone i dati sul ciclo di vita e sulla proprietà ai linter Wasm.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
maintainers | Maintainer[] | no | I maintainer che l’entità di catalogo elenca come suoi proprietari. |
license | string | no | L’identificatore di licenza SPDX che l’entità di catalogo dichiara per il software che descrive. |
repository | string | no | L’URL del repository Git che l’entità di catalogo indica come contenitore dei propri file sorgente. |
home | string | no | L’URL della home page, del wiki o della documentazione dell’entità di catalogo. |
keywords | string[] | no | Le parole chiave descrittive che l’entità di catalogo dichiara. |
Non sono consentite proprietà aggiuntive.
IRNode
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
description | string | no | Documentazione facoltativa scritta dallo sviluppatore che descrive il ruolo di questa istanza di componente nell’applicazione. Riportata dall’Aggregate per il rendering e per le diagnostiche di lint. |
labels | mappa di string | sì | Le etichette di duck typing e di ontologia dell’entità. |
component | string | sì | Il nome del Component sottostante. |
resolved_version | string | sì | La versione semantica esatta del Component risolta durante la compilazione. |
sync_wave | integer | no | L’ondata di distribuzione ereditata dal campo syncWave del confine che lo contiene (predefinito 0; valori negativi consentiti). Su K8s e Helm l’ondata è ciò che ordina la distribuzione: diventa un’annotazione argocd.argoproj.io/sync-wave e, su una risorsa che il chart già contrassegna come hook di Helm, diventa anche l’helm.sh/hook-weight di quell’hook. Su compose il valore viene sia registrato come etichetta del servizio sia usato per ordinare i servizi del file in cui viene renderizzato, tramite depends_on tra di essi. Su cloudformation ordina il provisioning dello stack in cui si assembla un gruppo di smistamento, poiché ogni risorsa di un’ondata viene dichiarata dipendente dalle risorse dell’ondata precedente: l’ordine in cui vengono create e, all’inverso, l’ordine in cui vengono eliminate, mai la prontezza, perché un template di stack non esprime alcuna nozione di risorsa pronta. Su terraform ordina i blocchi module della configurazione radice in cui si assembla un confine, poiché ogni modulo di un’ondata viene dichiarato dipendente dai moduli dell’ondata precedente: l’ordine in cui il motore esegue le proprie azioni, mai la prontezza, perché una configurazione non esprime alcuna nozione di risorsa pronta. Il valore viaggia anche con la provenienza di build del nodo. |
boundary_path | string | no | Il percorso del confine della Release in cui questo nodo è collocato: i nomi dei confini dal più esterno verso l’interno, uniti con / (ad es. ‘data/inner’ per un componente collocato in un confine inner dichiarato all’interno di un confine data). Il nome di un confine non può contenere /, quindi il percorso si scompone di nuovo nei suoi confini senza ambiguità. Un nodo di un Aggregate importato che la Release instrada in un confine porta il percorso di quel confine. Consente ai plugin di rendering di generare identificatori univoci consapevoli del confine. |
subsystem_path | string | no | Il percorso del sottosistema dell’Aggregate in cui è dichiarato il componente di questo nodo: i nomi dei sottosistemi dal più esterno verso l’interno, uniti con . (ad es. ‘backend.storage’ per un componente dichiarato in un sottosistema storage annidato all’interno di un sottosistema backend). Il nome di un sottosistema non può contenere ., quindi il percorso si scompone di nuovo nei suoi sottosistemi senza ambiguità. Un componente di un Aggregate che dichiara components di primo livello porta il default sintetizzato, contrassegnato da synthesized_subsystem. Il percorso è relativo all’Aggregate che dichiara il componente: un nodo che un Aggregate importato contribuisce porta il proprio percorso all’interno di quell’Aggregate, senza il nome con cui è importato (ad es. ‘tier’ per un componente nel sottosistema tier dell’Aggregate importato), così nodi di Aggregates diversi possono condividere un unico percorso. L’ID del nodo, che inizia con il nome di importazione, e source_file li distinguono. |
synthesized_subsystem | booleana | no | Vale true quando il sottosistema di questo nodo è stato sintetizzato dal compilatore — il sottosistema default creato per un Aggregate che dichiara components di primo livello anziché subsystems con nome. Provenienza derivata, mai scritta dall’autore: distingue il default sintetizzato da un sottosistema che un utente ha esplicitamente chiamato default. Indipendente da synthesized_boundary (un nodo può essere sintetizzato su uno dei due assi o su entrambi). Assente (false) per ogni sottosistema scritto dall’autore. |
synthesized_boundary | booleana | no | Vale true quando il confine di questo nodo è stato sintetizzato dal compilatore — il confine default creato per una Release che dichiara components di primo livello anziché boundaries con nome. Provenienza derivata, mai scritta dall’autore: distingue il default sintetizzato da un confine che un utente ha esplicitamente chiamato default, e instrada gli artefatti del nodo in dist/ in forma piatta anziché in dist/boundaries/default/. Assente (false) per ogni confine scritto dall’autore. |
catalog_metadata | CatalogMetadata | no | La suite di metadati aziendali estratta esplicitamente dall’entità di catalogo, che espone i dati sul ciclo di vita e sulla proprietà ai linter Wasm. |
catalog_annotations | mappa di string | no | Caratteristiche immutabili e intrinseche del componente, scritte dall’architetto di piattaforma nel dominio 2. |
release_annotations | mappa di string | no | Stringhe di topologia fisica e realtà di Ops che discendono a cascata dai confini nella Release. |
aggregate_annotations | mappa di string | no | Metadati cognitivi, intento dello sviluppatore e FinOps che discendono a cascata dai sottosistemi nell’Aggregate. |
self_inject | object | no | Blocco di self-inject a livello di Component riportato dall’Aggregate; l’instradamento agnostico dell’iniezione che il nodo dichiara per sé stesso. Opaco a questo livello dello schema; un plugin di policy che lo legge analizza i byte. |
source_file | string | no | Percorso, relativo al workspace, del file dell’Aggregate in cui questo nodo è stato scritto. I nodi del livello radice portano il percorso dell’Aggregate radice; i nodi dei sotto-aggregati portano il percorso del file dell’Aggregate importato. Il percorso è relativo alla radice del workspace (la directory che contiene .aggrega-config.yaml), quindi il grafo è identico byte per byte su macchine i cui workspace si trovano in percorsi assoluti diversi. I consumatori che filtrano le diagnostiche per file risolvono il campo rispetto alla stessa radice del workspace prima del confronto. Assente quando il grafo è stato costruito senza una radice del workspace. |
uses | object | no | Il blocco uses del nodo esattamente come scritto: ogni nome di socket corrisponde a un elenco di nomi di istanze di destinazione oppure a una mappa di voci di connessione indicizzata per alias, nell’ordine in cui l’autore le ha dichiarate. È il blocco così come è scritto, che è un fatto diverso dalle connessioni risolte in edges: un socket che l’autore ha popolato compare qui anche dove non ha prodotto alcuna connessione, così un lettore può distinguere un socket che l’autore ha riempito da un socket che raggiunge una destinazione. Assente quando il nodo non ha scritto alcun blocco uses. Opaco a questo livello dello schema; un plugin di policy che lo legge analizza i byte. |
sensitive_payload_leaves | string[] | no | Le foglie che il payload values e infra di questo nodo porta e che il suo Component dichiara sensibili, ciascuna come il percorso puntato con prefisso del pilastro occupato dal dato: values.db copre db.password e non raggiunge una foglia sorella chiamata dbPassword. Una chiave assente afferma che questo nodo non nomina alcuna foglia che il suo Component dichiara sensibile, il che include il caso in cui il Component del nodo non si risolve in alcuno schema che questo lettore possa leggere. Non afferma che il payload del nodo non sia sensibile, e non distingue un nodo che non ha una tale foglia da nominare da un produttore che non riporta affatto questo asse. Un consumatore che legge una chiave assente come permesso di mostrare o emettere un valore in chiaro l’ha letta al contrario. Le foglie arrivano nell’ordine in cui il payload le contiene, quelle del pilastro values prima di quelle del pilastro infra, che è lo stesso ordine che portano quei payload stessi ed è ciò che mantiene il grafo identico byte per byte tra esecuzioni con input identico. Assente quando il nodo non porta alcuna foglia che il suo Component dichiara sensibile. |
Non sono consentite proprietà aggiuntive.
IREdge
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
source | string | sì | L’ID del nodo consumatore, dove inizia la connessione. |
target | string | sì | L’ID del nodo raggiunto dalla connessione. |
socket | string | no | La categoria di usesSchema a cui appartiene questo arco (ad es. ‘databases’, ‘tools’). |
alias | string | no | L’alias definito dallo sviluppatore per questa connessione (ad es. ‘primary_db’). |
socket_declaration | string (enum) | sì | Da dove proviene il socket: declared quando l’entità di catalogo che possiede il socket lo elenca in usesSchema (il Component consumatore, oppure la Feature di origine per un arco scritto da una Feature), ad-hoc quando l’autore dell’Aggregate ha nominato un socket che il catalogo non ha dichiarato. È un terzo asse, indipendente dalla paternità dell’arco: dice da dove proviene il socket, non chi ha tracciato l’arco, quindi un arco scritto da una Release in un socket dichiarato e un arco scritto da un Aggregate in un socket ad hoc differiscono sui due assi in modo indipendente. Un socket dichiarato porta la sua voce di usesSchema, compreso il selettore che vincola quali destinazioni l’arco può raggiungere; un socket ad hoc non ha alcuna voce di catalogo e quindi nessun selettore, perciò ciò che l’arco può portare è delimitato soltanto dai provides dichiarati della destinazione. Sempre presente, così un consumatore non deve mai leggere un valore assente come declared, e una policy può richiedere che ogni arco sia dichiarato. Distinto dal marcatore di legame di un’associazione, che risponde alla stessa forma di domanda su un soggetto diverso. Valori consentiti: "declared", "ad-hoc" |
origin_feature | string | no | Se questo arco è stato dichiarato autonomamente da una Feature (comprese le Features di credenziali etichettate feature.aggrega.ai/kind: secret), identifica l’URI del tipo di Feature. Consente ai plugin Wasm di isolare la propria topologia. |
origin_feature_instance | string | no | Il nome d’istanza per associazione della Feature che ha dichiarato questo arco. Individua per istanza i provides risolti di una FeatureRecipe con ambito boundary, distinguendo due associazioni dello stesso tipo di Feature su un unico confine. |
origin_release | booleana | no | Vale true quando questo arco è stato creato da una Release che collega un socket dichiarato ma non vincolato a un componente esistente. Contrassegna la PATERNITÀ dell’arco, non la configurazione: un arco dichiarato dallo sviluppatore per cui una Release ha soltanto fornito infra resta di origine Aggregate (origin_release non impostato; l’infra della sua Release compare nella mappa infra dell’arco). origin_feature impostato => origine Feature; origin_release true => origine Release; nessuno dei due => origine Aggregate. |
values | object | no | Valori dello sviluppatore per connessione risolti per questo arco (dall’arco dell’Aggregate), validati in fase di risoluzione rispetto al valueSchema dichiarato dal socket sorgente (il socket sul componente consumatore, che è la sorgente dell’arco) e proiettati nel contesto di rendering del nodo consumatore in .context.uses. |
infra | object | no | Infra per connessione risolta per questo arco, fornita da una voce di arco della Release, validata in fase di risoluzione rispetto all’infraSchema dichiarato dal socket sorgente (il socket sul componente consumatore, che è la sorgente dell’arco) e proiettata in .context.uses. |
inject | object | no | Instradamento agnostico dell’iniezione. Mappa le variabili locali sulle chiavi provides della destinazione. |
sensitive_payload_leaves | string[] | no | Le foglie che i values e l’infra di questo arco portano e che il socket rispetto al quale sono scritti dichiara sensibili, ciascuna come il percorso puntato con prefisso del pilastro occupato dal dato: values.db copre db.password e non raggiunge una foglia sorella chiamata db_password. Una superficie che trattiene dal grafo i valori dichiarati sensibili trattiene queste foglie nei values e nell’infra di questo arco, e nella voce uses del nodo consumatore per la stessa connessione, che porta i valori così come l’autore li ha scritti. Una chiave assente afferma che questo arco non nomina alcuna foglia che il contratto del suo socket dichiara sensibile, il che include il caso in cui il socket non dichiara alcun contratto che questo lettore possa leggere. Non afferma che la configurazione non sia sensibile, e un consumatore che legge una chiave assente come permesso di mostrare o emettere un valore in chiaro l’ha letta al contrario. Le foglie arrivano nell’ordine in cui i payload le contengono, quelle del pilastro values prima di quelle del pilastro infra, ed è ciò che mantiene il grafo identico byte per byte tra esecuzioni con input identico. Assente quando l’arco non porta alcuna foglia che il contratto del suo socket dichiara sensibile. |
Non sono consentite proprietà aggiuntive.
IREdge.inject
Instradamento agnostico dell’iniezione. Mappa le variabili locali sulle chiavi provides della destinazione.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
env | mappa di string | no | Consegna tramite variabili d’ambiente: le chiavi sono i nomi delle variabili locali del consumatore, i valori sono le chiavi provides della destinazione. |
file | mappa di string | no | Consegna tramite montaggio di file: le chiavi sono i percorsi dei file locali del consumatore, i valori sono le chiavi provides della destinazione. |
arg | mappa di string | no | Consegna tramite argomenti della riga di comando: le chiavi sono i prefissi dei flag del consumatore, i valori sono le chiavi provides della destinazione. |
IRMetadata
Identità del grafo: l’Aggregate da cui è stato costruito.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
aggregate_name | string | sì | Il metadata.name dell’Aggregate. |
Non sono consentite proprietà aggiuntive.
IRProvenance
Metadati di tracciabilità per la diagnostica e l’audit.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
schema_version | string | sì | La versione dello schema IR a cui il grafo è conforme — aggrega.ai/v1beta1, lo stesso valore che porta l’apiVersion del grafo. |
compiler_version | string | sì | Timbro di conformità obbligatorio. Identifica, tramite la sua versione, il binario aggrega che ha costruito questo grafo. |
aggregate_version | string | sì | La versione semantica esatta dell’intento dell’Aggregate radice usato durante la compilazione. |
manifest_version | string | sì | La versione semantica esatta del file di lock del Manifest usato durante la compilazione. |
release_version | string | sì | La versione semantica esatta del file di instradamento della Release usato durante la compilazione. |
Le proprietà aggiuntive sono consentite.
IRSpec
Il grafo stesso: i suoi nodi, i suoi archi e i payload indicizzati per nodo.
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
nodes | mappa di IRNode | sì | Dizionario di tutti i nodi del grafo, indicizzati per il loro ID assoluto. Puramente topologico. Chiavi: una o più lettere, cifre, trattini bassi, punti o trattini. Pattern: ^[a-zA-Z0-9_.-]+$. |
edges | IREdge[] | sì | Percorsi di rete logici espliciti e dipendenze tra i nodi. |
values_mapping | object | sì | L’unica fonte di verità per i payload cognitivi opachi trasmessi senza modifiche, mappati per ID del nodo. |
infra_mapping | object | sì | Il payload di dimensionamento fisico iniettato dalla Release, mappato per ID del nodo. |
feature_values_mapping | mappa di mappa di IRFeatureEntry | sì | Mappa normalizzata dagli ID dei nodi alle configurazioni di Feature associate. Un unico contenitore porta ogni associazione su un nodo, qualunque cosa produca — Features operative, Features di credenziali, Features di identità — indicizzata dal nome d’istanza che l’autore ha dato a ciascuna associazione. Un’associazione scritta su una delle connessioni del nodo è indicizzata dal suo nome qualificato, cioè l’alias della connessione e lo slot uniti da un punto, e nomina la propria connessione nel proprio campo connection. Chiavi: una o più lettere, cifre, trattini bassi, punti o trattini. Pattern: ^[a-zA-Z0-9_.-]+$. |
boundary_features | mappa di mappa di IRBoundaryFeature | no | Le associazioni di Feature di ciascun confine, indicizzate per percorso del confine e poi per nome d’istanza. Presente solo quando il grafo ha associazioni di Feature a livello di confine. Chiavi: una o più lettere, cifre, trattini bassi, punti, barre o trattini. Pattern: ^[a-zA-Z0-9_./-]+$. |
provenance | IRProvenance | sì | Metadati di tracciabilità per la diagnostica e l’audit. |
Non sono consentite proprietà aggiuntive.
IRGraph
| Proprietà | Tipo | Obbligatoria | Descrizione |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | sì | Costante: "aggrega.ai/v1beta1" |
kind | const “IR” | sì | Costante: "IR" |
metadata | IRMetadata | sì | Identità del grafo: l’Aggregate da cui è stato costruito. |
spec | IRSpec | sì | Il grafo stesso: i suoi nodi, i suoi archi e i payload indicizzati per nodo. |
Non sono consentite proprietà aggiuntive.