Esquema do grafo IR agnóstico em relação às capacidades do Aggrega
Referência gerada. Não edite à mão — gere novamente a partir do JSON Schema publicado.
ID do esquema: https://aggrega.ai/schemas/ir-v1beta1.schema.json
O grafo achatado, totalmente resolvido e unidimensional emitido pelo Topology Builder.
Tipo de nível superior: object
Propriedades
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | sim | Constante: "aggrega.ai/v1beta1" |
kind | const “IR” | sim | Constante: "IR" |
metadata | IRMetadata | sim | Identidade do grafo: o Aggregate a partir do qual ele foi construído. |
spec | IRSpec | sim | O próprio grafo: seus nós, suas arestas e os payloads indexados por nó. |
Não são permitidas propriedades adicionais.
Definições
Maintainer
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
name | string | sim | O nome do mantenedor. |
email | string | não | O endereço de e-mail do mantenedor. |
url | string | não | O endereço web do mantenedor. |
FieldProvenance
Origem de uma folha no payload values ou infra de uma vinculação.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
origin | string | sim | Se a folha foi escrita explicitamente ou contribuída pela etapa de expansão orientada por anotações. |
side | string | não | Superfície de autoria na qual a anotação foi declarada; ausente para folhas explícitas. |
annotation_key | string | não | Nome da anotação que contribuiu com esta folha; ausente para folhas explícitas. |
annotation_source | string | não | Localização na fonte da declaração da anotação como |
overridden_annotation | FieldProvenance | não | A contribuição de anotação que perdeu esta folha para uma explícita: quando uma folha explícita sobrescreveu uma folha contribuída por uma anotação, a procedência suprimida que ela substituiu. Singular — nunca se retém mais do que exatamente uma contribuição suprimida. |
Não são permitidas propriedades adicionais.
AttachmentConnection
A conexão à qual uma vinculação pertence, para uma vinculação escrita em uma conexão que um componente traça em vez de no bloco de vinculações do próprio componente: o socket pelo qual a conexão é cabeada e o alias sob o qual ela é escrita. O par nomeia uma das arestas do grafo — a aresta cuja origem é o nó que traz a vinculação e cujo socket e alias são estes — de modo que um consumidor junta a vinculação a essa aresta e, por meio dela, ao destino ao qual a vinculação é apresentada.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
socket | string | sim | O socket pelo qual a conexão é cabeada: o socket da aresta à qual a vinculação pertence. |
alias | string | sim | O alias sob o qual a conexão é escrita: o alias da aresta à qual a vinculação pertence. |
Não são permitidas propriedades adicionais.
IRFeatureEntry
Uma vinculação resolvida para um nó, trazida em feature_values_mapping. Toda família de vinculações compartilha este formato — uma Feature operacional, uma Feature de credenciais, uma Feature de identidade — de modo que nenhuma família recebe uma projeção com mais perdas do que outra. O que o values de uma vinculação de credenciais traz é escolha do autor: uma credencial por referência traz um ponteiro para um armazenamento de segredos, uma por valor traz o próprio material, e o compilador traz literalmente a que foi escrita, sem resolver nenhuma das duas.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
type | string | sim | URI da Feature do catálogo que esta vinculação solicita. |
resolved_version | string | sim | A versão semântica exata resolvida durante a compilação. |
labels | mapa de string | não | Os rótulos de catálogo da Feature vinculada, trazidos literalmente na ordem em que a sua entidade de catálogo os declara — nunca filtrados, normalizados ou despojados de prefixo, de modo que um consumidor lê exatamente o que o autor do catálogo escreveu. O compilador não lê nenhum deles. Ausente quando a Feature não declara rótulos, e quando o seu tipo não se resolve em nenhuma entidade de catálogo. |
catalog_annotations | mapa de string | não | As anotações de catálogo da Feature vinculada — as metadata.annotations da entidade Feature que esta vinculação nomeia — trazidas literalmente na ordem em que essa entidade as declara, nunca filtradas, normalizadas ou despojadas de prefixo, de modo que um consumidor lê exatamente o que o autor do catálogo escreveu, incluindo chaves no próprio namespace do autor. O compilador não lê nenhuma delas. Distinto de annotation_key e annotation_source, que nomeiam e localizam a anotação que fez esta vinculação existir: esses dois informam como a vinculação surgiu, este informa os metadados da entidade que ela nomeia, e uma vinculação escrita em um bloco features: traz estas anotações sem trazer nenhum daqueles dois. Ausente quando a Feature não declara anotações, e quando o seu tipo não se resolve em nenhuma entidade de catálogo. |
binding | string | não | Nomeia o slot de vinculação que esta vinculação ocupa, ou “free” quando ela não ocupa nenhum slot declarado. Um slot é declarado em um de dois lugares, e onde a vinculação foi escrita decide qual: uma vinculação do bloco de vinculações do próprio nó ocupa um slot que o Component host declara no seu featuresSchema, e uma vinculação escrita em uma conexão ocupa um slot que o socket da conexão declara no featuresSchema desse socket no Component host. O pareamento é por nome em ambos os casos — uma vinculação ocupa um slot quando a Feature é vinculada sob o nome do slot, no bloco do componente ou na conexão — então o valor é uma chave exata do conjunto de slots declarados, nunca algo lido da chave da vinculação. O conjunto de slots de um socket é fechado, já que uma vinculação escrita em uma conexão sob um nome que o seu socket não declara interrompe o build, então uma vinculação que traz uma conexão nunca informa free. O nome do slot é trazido em vez de um simples booleano porque qual slot foi ocupado é a metade mais útil da resposta. Vazio quando o conjunto de slots declarados do Component host não pôde ser resolvido, o que é distinto de “free”: free é a constatação positiva de que nenhum slot declarado traz este nome. |
values | object | não | Payload de configuração operacional da vinculação. Para uma credencial, qualquer que seja a forma que o autor declarou — um ponteiro para um armazenamento de segredos, ou o próprio material. |
infra | object | não | Dimensionamento físico por instância para esta vinculação. |
inject | object | não | Roteamento de injeção agnóstico. Mapeia variáveis locais para as chaves provides do destino. |
origin | string (enum) | não | Distingue vinculações escritas em um bloco features: (explicit) de vinculações sintéticas produzidas pela etapa de expansão orientada por anotações (annotation), ou mixed quando as folhas value/infra da vinculação trazem uma mistura de ambas (o detalhe por folha fica então nos mapas de procedência). Valores permitidos: "explicit", "annotation", "mixed" |
annotation_key | string | não | Nome da anotação que disparou uma vinculação sintética. Ausente quando origin é explicit. |
annotation_source | string | não | Localização na fonte da declaração da anotação como |
values_provenance | mapa de FieldProvenance | não | Origem por folha do payload values, indexada pelo caminho pontilhado da folha. |
infra_provenance | mapa de FieldProvenance | não | Origem por folha do payload infra, indexada pelo caminho pontilhado da folha. |
sensitive | booleano | não | É true quando esta vinculação lida com material que um autor declarou sensível — ou a Feature vinculada declara uma folha sensível no seu pilar values, infra ou provides, ou o slot que a vinculação ocupa declara sensível o material que ela traz: o slot de vinculação de mesmo nome do Component host ou, para uma vinculação escrita em uma conexão, o slot com esse nome que o socket da conexão declara. Derivado dessas declarações sobre a vinculação mesclada, nunca do conteúdo de um valor ou de um nome. Não definido quando nenhuma das duas declarações está presente. |
sensitive_inject | mapa de mapas de string | não | As chaves de entrega de inject cuja chave provides referenciada a Feature vinculada declara sensível, no formato próprio de inject: mecanismo, depois chave de entrega, com a chave provides referenciada como valor. Um subconjunto de inject. Ausente quando a vinculação não declara nenhum mecanismo de entrega ou não referencia nenhuma chave provides sensível. |
sensitive_payload_leaves | string[] | não | As folhas que o payload values e infra desta vinculação carrega e que a Feature vinculada declara sensíveis, cada uma como o caminho pontilhado prefixado pelo pilar que o dado ocupa: values.db cobre db.password e não alcança uma folha irmã chamada dbPassword. A resposta por vinculação nunca é distribuída entre folhas individuais, o que afirmaria algo falso sobre uma folha deixada legível. Uma chave ausente afirma que esta vinculação não nomeia nenhuma folha que sua Feature declara sensível. Ela não afirma que o payload não é sensível, e não distingue uma vinculação que não tem uma folha assim para nomear de um produtor que não informa esse eixo de forma alguma — um guest que lê uma chave ausente como permissão para exibir ou emitir um valor em texto claro a leu ao contrário. As folhas chegam na ordem em que o payload as contém, as do pilar values antes das do pilar infra — a mesma ordem que os próprios payloads values e infra carregam, e o que torna o payload idêntico byte a byte entre execuções com entrada idêntica. Ausente quando a vinculação não carrega nenhuma folha que sua Feature declara sensível. |
connection | AttachmentConnection | não | A conexão à qual esta vinculação pertence: presente em toda vinculação escrita em uma das conexões do nó, e ausente em toda vinculação do bloco de vinculações próprio do nó. Uma vinculação escrita em uma conexão é, em todos os outros aspectos, uma das vinculações do nó — indexada por seu nome qualificado, o alias da conexão e o slot unidos por um ponto, e tomando sua associação e sua sensibilidade do slot que o socket da conexão declara —, então este campo é o que distingue as duas, e ele carrega a conexão como dado em vez de deixá-la para ser lida a partir da chave. Um consumidor o une às arestas do grafo por socket e alias: a aresta cuja origem é o nó que carrega esta vinculação e cujo socket e alias são estes é a conexão na qual a vinculação é apresentada, e o destino dessa aresta é aquilo a que ela é apresentada. Uma vinculação de uma conexão que uma vinculação de Feature traça nunca carrega um, porque uma conexão assim não carrega vinculações. |
realization | string | não | A FeatureRecipe que realiza esta vinculação, como |
Não são permitidas propriedades adicionais.
IRFeatureEntry.inject
Roteamento de injeção agnóstico. Mapeia variáveis locais para as chaves provides do destino.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
env | mapa de string | não | Entrega por variáveis de ambiente: as chaves são os nomes das variáveis locais do consumidor, e os valores são as chaves provides do destino. |
file | mapa de string | não | Entrega por montagem de arquivos: as chaves são os caminhos de arquivo locais do consumidor, e os valores são as chaves provides do destino. |
arg | mapa de string | não | Entrega por argumentos de linha de comando: as chaves são os prefixos de flag do consumidor, e os valores são as chaves provides do destino. |
IRBoundaryFeature
Uma vinculação de Feature no nível da fronteira projetada na IR: o URI do tipo de Feature mais a infra da fronteira em relação à qual uma FeatureRecipe com escopo boundary renderiza e resolve sua fonte. Vinculações no nível da fronteira não carregam nenhum payload values.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
type | string | sim | URI da Feature do catálogo vinculada nesta fronteira. |
infra | object | não | Dimensionamento físico para a vinculação a uma fronteira; a infra em relação à qual uma FeatureRecipe com escopo boundary avalia seus templates e sua fonte. |
sensitive_payload_leaves | string[] | não | As folhas que o payload infra desta vinculação a uma fronteira carrega e que a Feature vinculada declara sensíveis, cada uma como o caminho pontilhado prefixado pelo pilar que o dado ocupa. Somente coordenadas infra.db cobre db.password e não alcança uma folha irmã chamada dbPassword. Uma chave ausente afirma que esta vinculação não nomeia nenhuma folha que sua Feature declara sensível, o que inclui o caso em que a Feature vinculada não se resolve em nenhum esquema que este leitor pudesse ler. Ela não afirma que o payload infra não é sensível, e não distingue uma vinculação que não tem uma folha assim para nomear de um produtor que não informa esse eixo de forma alguma. Um consumidor que lê uma chave ausente como permissão para exibir ou emitir um valor em texto claro a leu ao contrário. As folhas chegam na ordem em que o payload as contém, que é a mesma ordem que o próprio payload infra carrega e o que mantém o grafo idêntico byte a byte entre execuções com entrada idêntica. Ausente quando a vinculação não carrega nenhuma folha que sua Feature declara sensível. |
realization | string | não | A FeatureRecipe que realiza esta vinculação a uma fronteira, como |
Não são permitidas propriedades adicionais.
CatalogMetadata
A suíte de metadados corporativos extraída explicitamente da entidade do catálogo, que expõe dados de ciclo de vida e de propriedade aos linters Wasm.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
maintainers | Maintainer[] | não | Os mantenedores que a entidade do catálogo lista como seus proprietários. |
license | string | não | O identificador de licença SPDX que a entidade do catálogo declara para o software que descreve. |
repository | string | não | A URL do repositório Git que a entidade do catálogo indica como aquele que contém seus arquivos-fonte. |
home | string | não | A URL da página inicial, da wiki ou da documentação da entidade do catálogo. |
keywords | string[] | não | As palavras-chave descritivas que a entidade do catálogo declara. |
Não são permitidas propriedades adicionais.
IRNode
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
description | string | não | Documentação opcional escrita pelo desenvolvedor que descreve o papel desta instância de componente na aplicação. Trazida do Aggregate para a renderização e para os diagnósticos de lint. |
labels | mapa de string | sim | Os rótulos de duck typing e de ontologia da entidade. |
component | string | sim | O nome do Component subjacente. |
resolved_version | string | sim | A versão semântica exata do Component resolvida durante a compilação. |
sync_wave | integer | não | A onda de implantação herdada do campo syncWave da fronteira que o contém (padrão 0; valores negativos permitidos). Em K8s e Helm, a onda é o que ordena a implantação: ela se torna uma anotação argocd.argoproj.io/sync-wave e, em um recurso que o chart já marca como hook do Helm, também se torna o helm.sh/hook-weight desse hook. Em compose, o valor é registrado como rótulo do serviço e também ordena os serviços do arquivo no qual é renderizado, por meio de depends_on entre eles. Em cloudformation, ele ordena o provisionamento da stack na qual um grupo de despacho se monta, com cada recurso de uma onda declarado como dependente dos recursos da onda anterior: a ordem em que são criados e, ao contrário, a ordem em que são excluídos, nunca a prontidão, porque um template de stack não expressa nenhuma noção de um recurso estar pronto. Em terraform, ele ordena os blocos module da configuração raiz na qual uma fronteira se monta, com cada módulo de uma onda declarado como dependente dos módulos da onda anterior: a ordem em que o mecanismo executa suas ações, nunca a prontidão, porque uma configuração não expressa nenhuma noção de um recurso estar pronto. O valor também acompanha a procedência de build do nó. |
boundary_path | string | não | O caminho da fronteira da Release na qual este nó está colocado: os nomes das fronteiras da mais externa para dentro, unidos com / (p. ex., ‘data/inner’ para um componente colocado em uma fronteira inner declarada dentro de uma fronteira data). Um nome de fronteira não pode conter /, de modo que o caminho se decompõe de volta em suas fronteiras sem ambiguidade. Um nó de um Aggregate importado que a Release encaminha para uma fronteira carrega o caminho dessa fronteira. Permite que plugins de renderização gerem identificadores únicos que levam em conta a fronteira. |
subsystem_path | string | não | O caminho do subsistema do Aggregate no qual o componente deste nó é declarado: os nomes dos subsistemas do mais externo para dentro, unidos com . (p. ex., ‘backend.storage’ para um componente declarado em um subsistema storage aninhado dentro de um subsistema backend). Um nome de subsistema não pode conter ., de modo que o caminho se decompõe de volta em seus subsistemas sem ambiguidade. Um componente de um Aggregate que declara components de nível superior carrega o default sintetizado, marcado por synthesized_subsystem. O caminho é relativo ao Aggregate que declara o componente: um nó com que um Aggregate importado contribui carrega seu caminho dentro desse Aggregate, sem o nome sob o qual ele é importado (p. ex., ‘tier’ para um componente no subsistema tier do Aggregate importado), de modo que nós de Aggregates diferentes podem compartilhar um mesmo caminho. O ID do nó, que começa com o nome de importação, e source_file os distinguem. |
synthesized_subsystem | booleano | não | É true quando o subsistema deste nó foi sintetizado pelo compilador — o subsistema default criado para um Aggregate que declara components de nível superior em vez de subsystems nomeados. Procedência derivada, nunca escrita pelo autor: distingue o default sintetizado de um subsistema que um usuário nomeou explicitamente como default. Independente de synthesized_boundary (um nó pode ser sintetizado em qualquer um dos eixos ou em ambos). Ausente (false) para todo subsistema escrito pelo autor. |
synthesized_boundary | booleano | não | É true quando a fronteira deste nó foi sintetizada pelo compilador — a fronteira default criada para uma Release que declara components de nível superior em vez de boundaries nomeadas. Procedência derivada, nunca escrita pelo autor: distingue o default sintetizado de uma fronteira que um usuário nomeou explicitamente como default, e encaminha os artefatos do nó para dist/ de forma plana em vez de dist/boundaries/default/. Ausente (false) para toda fronteira escrita pelo autor. |
catalog_metadata | CatalogMetadata | não | A suíte de metadados corporativos extraída explicitamente da entidade do catálogo, que expõe dados de ciclo de vida e de propriedade aos linters Wasm. |
catalog_annotations | mapa de string | não | Características imutáveis e intrínsecas do componente, escritas pelo arquiteto de plataforma no domínio 2. |
release_annotations | mapa de string | não | Strings de topologia física e realidades de Ops que descem em cascata a partir das fronteiras na Release. |
aggregate_annotations | mapa de string | não | Metadados cognitivos, intenção do desenvolvedor e FinOps que descem em cascata a partir dos subsistemas no Aggregate. |
self_inject | object | não | Bloco de self-inject no nível do Component trazido do Aggregate; o roteamento de injeção agnóstico que o nó declara para si mesmo. Opaco nesta camada do esquema; um plugin de política que o lê analisa os bytes. |
source_file | string | não | Caminho, relativo ao espaço de trabalho, do arquivo do Aggregate no qual este nó foi escrito. Os nós do nível raiz carregam o caminho do Aggregate raiz; os nós de subagregados carregam o caminho de arquivo do Aggregate importado. O caminho é relativo à raiz do espaço de trabalho (o diretório que contém .aggrega-config.yaml), de modo que o grafo é idêntico byte a byte em máquinas cujos espaços de trabalho ficam em caminhos absolutos diferentes. Os consumidores que filtram diagnósticos por arquivo resolvem o campo em relação à mesma raiz do espaço de trabalho antes da comparação. Ausente quando o grafo foi construído sem uma raiz do espaço de trabalho. |
uses | object | não | O bloco uses do nó exatamente como escrito: cada nome de socket corresponde a uma lista de nomes de instâncias de destino ou a um mapa de entradas de conexão indexado por alias, na ordem em que o autor os declarou. Este é o bloco como escrito, que é um fato diferente das conexões resolvidas em edges: um socket que o autor populou aparece aqui mesmo onde não produziu nenhuma conexão, de modo que um leitor consegue distinguir um socket que o autor preencheu de um socket que alcança um destino. Ausente quando o nó não escreveu nenhum bloco uses. Opaco nesta camada do esquema; um plugin de política que o lê analisa os bytes. |
sensitive_payload_leaves | string[] | não | As folhas que o payload values e infra deste nó carrega e que seu Component declara sensíveis, cada uma como o caminho pontilhado prefixado pelo pilar que o dado ocupa: values.db cobre db.password e não alcança uma folha irmã chamada dbPassword. Uma chave ausente afirma que este nó não nomeia nenhuma folha que seu Component declara sensível, o que inclui o caso em que o Component do nó não se resolve em nenhum esquema que este leitor pudesse ler. Ela não afirma que o payload do nó não é sensível, e não distingue um nó que não tem uma folha assim para nomear de um produtor que não informa esse eixo de forma alguma. Um consumidor que lê uma chave ausente como permissão para exibir ou emitir um valor em texto claro a leu ao contrário. As folhas chegam na ordem em que o payload as contém, as do pilar values antes das do pilar infra, que é a mesma ordem que esses próprios payloads carregam e o que mantém o grafo idêntico byte a byte entre execuções com entrada idêntica. Ausente quando o nó não carrega nenhuma folha que seu Component declara sensível. |
Não são permitidas propriedades adicionais.
IREdge
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
source | string | sim | O ID do nó consumidor, onde a conexão começa. |
target | string | sim | O ID do nó que a conexão alcança. |
socket | string | não | A categoria de usesSchema à qual esta aresta pertence (p. ex., ‘databases’, ‘tools’). |
alias | string | não | O alias definido pelo desenvolvedor para esta conexão (p. ex., ‘primary_db’). |
socket_declaration | string (enum) | sim | De onde o socket veio: declared quando a entidade do catálogo que possui o socket o lista em usesSchema (o Component consumidor, ou a Feature de origem para uma aresta escrita por uma Feature), ad-hoc quando o autor do Aggregate nomeou um socket que o catálogo não declarou. Este é um terceiro eixo, independente da autoria da aresta: ele diz de onde o socket veio, não quem traçou a aresta, de modo que uma aresta escrita por uma Release em um socket declarado e uma aresta escrita por um Aggregate em um socket ad hoc diferem nos dois eixos de forma independente. Um socket declarado carrega sua entrada de usesSchema, incluindo o seletor que restringe quais destinos a aresta pode alcançar; um socket ad hoc não tem entrada de catálogo e, portanto, nenhum seletor, de modo que o que a aresta pode carregar é limitado apenas pelos provides declarados do destino. Sempre presente, de modo que um consumidor nunca precisa ler um valor ausente como declared, e uma política pode exigir que toda aresta seja declarada. Distinto do marcador de associação de uma vinculação, que responde à mesma forma de pergunta sobre um assunto diferente. Valores permitidos: "declared", "ad-hoc" |
origin_feature | string | não | Se esta aresta foi declarada de forma autônoma por uma Feature (incluindo Features de credenciais rotuladas com feature.aggrega.ai/kind: secret), isto identifica o URI do tipo de Feature. Permite que plugins Wasm isolem sua própria topologia. |
origin_feature_instance | string | não | O nome de instância por vinculação da Feature que declarou esta aresta. Localiza por instância os provides resolvidos de uma FeatureRecipe com escopo boundary, distinguindo duas vinculações do mesmo tipo de Feature em uma mesma fronteira. |
origin_release | booleano | não | É true quando esta aresta foi criada por uma Release que conecta um socket declarado, mas não associado, a um componente existente. Marca a AUTORIA da aresta, não a configuração: uma aresta declarada pelo desenvolvedor para a qual uma Release apenas forneceu infra permanece com origem Aggregate (origin_release não definido; a infra da sua Release aparece no mapa infra da aresta). origin_feature definido => origem Feature; origin_release true => origem Release; nenhum dos dois => origem Aggregate. |
values | object | não | Valores do desenvolvedor por conexão resolvidos para esta aresta (a partir da aresta do Aggregate), validados na resolução em relação ao valueSchema declarado pelo socket de origem (o socket no componente consumidor, que é a origem da aresta) e projetados no contexto de renderização do nó consumidor em .context.uses. |
infra | object | não | Infra por conexão resolvida para esta aresta, fornecida por uma entrada de aresta de uma Release, validada na resolução em relação ao infraSchema declarado pelo socket de origem (o socket no componente consumidor, que é a origem da aresta) e projetada em .context.uses. |
inject | object | não | Roteamento de injeção agnóstico. Mapeia variáveis locais para as chaves provides do destino. |
sensitive_payload_leaves | string[] | não | As folhas que os values e a infra desta aresta carregam e que o socket em relação ao qual eles são escritos declara sensíveis, cada uma como o caminho pontilhado prefixado pelo pilar que o dado ocupa: values.db cobre db.password e não alcança uma folha irmã chamada db_password. Uma superfície que retém do grafo os valores declarados sensíveis retém estas folhas nos values e na infra desta aresta, e na entrada uses do nó consumidor para a mesma conexão, que carrega os valores como o autor os escreveu. Uma chave ausente afirma que esta aresta não nomeia nenhuma folha que o contrato do seu socket declara sensível, o que inclui o caso em que o socket não declara nenhum contrato que este leitor pudesse ler. Ela não afirma que a configuração não é sensível, e um consumidor que lê uma chave ausente como permissão para exibir ou emitir um valor em texto claro a leu ao contrário. As folhas chegam na ordem em que os payloads as contêm, as do pilar values antes das do pilar infra, que é o que mantém o grafo idêntico byte a byte entre execuções com entrada idêntica. Ausente quando a aresta não carrega nenhuma folha que o contrato do seu socket declara sensível. |
Não são permitidas propriedades adicionais.
IREdge.inject
Roteamento de injeção agnóstico. Mapeia variáveis locais para as chaves provides do destino.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
env | mapa de string | não | Entrega por variáveis de ambiente: as chaves são os nomes das variáveis locais do consumidor, e os valores são as chaves provides do destino. |
file | mapa de string | não | Entrega por montagem de arquivos: as chaves são os caminhos de arquivo locais do consumidor, e os valores são as chaves provides do destino. |
arg | mapa de string | não | Entrega por argumentos de linha de comando: as chaves são os prefixos de flag do consumidor, e os valores são as chaves provides do destino. |
IRMetadata
Identidade do grafo: o Aggregate a partir do qual ele foi construído.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
aggregate_name | string | sim | O metadata.name do Aggregate. |
Não são permitidas propriedades adicionais.
IRProvenance
Metadados de rastreabilidade para diagnóstico e auditoria.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
schema_version | string | sim | A versão do esquema IR com a qual o grafo está em conformidade — aggrega.ai/v1beta1, o mesmo valor que a apiVersion do grafo carrega. |
compiler_version | string | sim | Carimbo de conformidade obrigatório. Identifica, pela sua versão, o binário aggrega que construiu este grafo. |
aggregate_version | string | sim | A versão semântica exata da intenção do Aggregate raiz usada durante a compilação. |
manifest_version | string | sim | A versão semântica exata do arquivo de bloqueio do Manifest usado durante a compilação. |
release_version | string | sim | A versão semântica exata do arquivo de roteamento da Release usado durante a compilação. |
Propriedades adicionais são permitidas.
IRSpec
O próprio grafo: seus nós, suas arestas e os payloads indexados por nó.
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
nodes | mapa de IRNode | sim | Dicionário de todos os nós do grafo, indexados pelo seu ID absoluto. Puramente topológico. Chaves: uma ou mais letras, dígitos, sublinhados, pontos ou hifens. Padrão: ^[a-zA-Z0-9_.-]+$. |
edges | IREdge[] | sim | Caminhos de rede lógicos explícitos e dependências entre nós. |
values_mapping | object | sim | A única fonte da verdade para os payloads cognitivos opacos repassados sem alteração, mapeados por ID do nó. |
infra_mapping | object | sim | O payload de dimensionamento físico injetado a partir da Release, mapeado por ID do nó. |
feature_values_mapping | mapa de mapa de IRFeatureEntry | sim | Mapa normalizado dos IDs de nó para as suas configurações de Feature vinculadas. Um único contêiner carrega toda vinculação em um nó, seja o que for que ela produza — Features operacionais, Features de credenciais, Features de identidade —, indexada pelo nome de instância que o autor deu a cada vinculação. Uma vinculação escrita em uma das conexões do nó é indexada pelo seu nome qualificado, o alias da conexão e o slot unidos por um ponto, e nomeia sua conexão em seu próprio campo connection. Chaves: uma ou mais letras, dígitos, sublinhados, pontos ou hifens. Padrão: ^[a-zA-Z0-9_.-]+$. |
boundary_features | mapa de mapa de IRBoundaryFeature | não | As vinculações de Feature de cada fronteira, indexadas pelo caminho da fronteira e depois pelo nome de instância. Presente apenas quando o grafo tem vinculações de Feature no nível da fronteira. Chaves: uma ou mais letras, dígitos, sublinhados, pontos, barras ou hifens. Padrão: ^[a-zA-Z0-9_./-]+$. |
provenance | IRProvenance | sim | Metadados de rastreabilidade para diagnóstico e auditoria. |
Não são permitidas propriedades adicionais.
IRGraph
| Propriedade | Tipo | Obrigatória | Descrição |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | sim | Constante: "aggrega.ai/v1beta1" |
kind | const “IR” | sim | Constante: "IR" |
metadata | IRMetadata | sim | Identidade do grafo: o Aggregate a partir do qual ele foi construído. |
spec | IRSpec | sim | O próprio grafo: seus nós, suas arestas e os payloads indexados por nó. |
Não são permitidas propriedades adicionais.