Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

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

PropriedadeTipoObrigatóriaDescrição
apiVersionconst “aggrega.ai/v1beta1”simConstante: "aggrega.ai/v1beta1"
kindconst “IR”simConstante: "IR"
metadataIRMetadatasimIdentidade do grafo: o Aggregate a partir do qual ele foi construído.
specIRSpecsimO próprio grafo: seus nós, suas arestas e os payloads indexados por nó.

Não são permitidas propriedades adicionais.

Definições

Maintainer

PropriedadeTipoObrigatóriaDescrição
namestringsimO nome do mantenedor.
emailstringnãoO endereço de e-mail do mantenedor.
urlstringnãoO endereço web do mantenedor.

FieldProvenance

Origem de uma folha no payload values ou infra de uma vinculação.

PropriedadeTipoObrigatóriaDescrição
originstringsimSe a folha foi escrita explicitamente ou contribuída pela etapa de expansão orientada por anotações.
sidestringnãoSuperfície de autoria na qual a anotação foi declarada; ausente para folhas explícitas.
annotation_keystringnãoNome da anotação que contribuiu com esta folha; ausente para folhas explícitas.
annotation_sourcestringnãoLocalização na fonte da declaração da anotação como :; ausente para folhas explícitas.
overridden_annotationFieldProvenancenãoA 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.

PropriedadeTipoObrigatóriaDescrição
socketstringsimO socket pelo qual a conexão é cabeada: o socket da aresta à qual a vinculação pertence.
aliasstringsimO 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.

PropriedadeTipoObrigatóriaDescrição
typestringsimURI da Feature do catálogo que esta vinculação solicita.
resolved_versionstringsimA versão semântica exata resolvida durante a compilação.
labelsmapa de stringnãoOs 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_annotationsmapa de stringnãoAs 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.
bindingstringnãoNomeia 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.
valuesobjectnãoPayload 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.
infraobjectnãoDimensionamento físico por instância para esta vinculação.
injectobjectnãoRoteamento de injeção agnóstico. Mapeia variáveis locais para as chaves provides do destino.
originstring (enum)nãoDistingue 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_keystringnãoNome da anotação que disparou uma vinculação sintética. Ausente quando origin é explicit.
annotation_sourcestringnãoLocalização na fonte da declaração da anotação como :. Ausente quando origin é explicit.
values_provenancemapa de FieldProvenancenãoOrigem por folha do payload values, indexada pelo caminho pontilhado da folha.
infra_provenancemapa de FieldProvenancenãoOrigem por folha do payload infra, indexada pelo caminho pontilhado da folha.
sensitivebooleanonã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_injectmapa de mapas de stringnãoAs 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_leavesstring[]nãoAs 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. ou infra.. O payload lido aqui é o que a vinculação acaba carregando, de modo que uma folha situada em um valor que o esquema da Feature declara como padrão é nomeada ao lado de uma que um autor escreveu — um padrão preenchido é um dado que o payload carrega, e uma marcação lida apenas do bloco escrito o deixaria sem nome. Esta é a unidade por folha da marcação de sensibilidade, e ela responde a uma pergunta que nenhum dos outros dois campos responde — sensitive dá uma única resposta para a vinculação inteira, sensitive_inject dá uma por chave de entrega de inject, e nenhum dos dois nomeia uma folha individual. Uma folha aparece onde um caminho que o esquema da Feature declara sensível a cobre: a declaração nomeia essa folha, ou nomeia um objeto que a contém, de modo que uma folha sob um objeto que uma declaração cobre é nomeada por essa declaração. A correspondência é feita segmento a segmento sobre o caminho pontilhado, sem ler nada do próprio texto do caminho e sem inspecionar nenhum valor, de modo que uma declaração em 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.
connectionAttachmentConnectionnãoA 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.
realizationstringnãoA FeatureRecipe que realiza esta vinculação, como :: aquela que o Manifest associa a ela — pelo nome próprio da vinculação onde o nível de nomes do Manifest mapeia esse nome, caso contrário pelo seu tipo de Feature —, que é aquela com a qual um build dos mesmos documentos a renderiza. Para uma vinculação escrita em uma conexão, o nome pelo qual o nível de nomes é lido é seu nome qualificado, o alias da conexão e o slot unidos por um ponto. O valor é o par que aggrega inspect imprime como a realização da vinculação e, onde um destino carimba a procedência no que renderiza, o valor aggrega.ai/recipe-uri nos documentos que essa FeatureRecipe renderiza, de modo que um consumidor une uma vinculação ao que ela renderiza sem traduzir entre formas. Ela nomeia a FeatureRecipe por nome e versão e não por capacidade. O campo registra qual FeatureRecipe o Manifest associa, lida do Manifest e do catálogo quando o grafo é construído: nada é buscado para produzi-lo, e a FeatureRecipe só é renderizada quando o build renderiza. Ausente quando o Manifest não associa a vinculação a nenhuma FeatureRecipe que o catálogo contenha.

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.

PropriedadeTipoObrigatóriaDescrição
envmapa de stringnãoEntrega 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.
filemapa de stringnãoEntrega 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.
argmapa de stringnãoEntrega 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.

PropriedadeTipoObrigatóriaDescrição
typestringsimURI da Feature do catálogo vinculada nesta fronteira.
infraobjectnãoDimensionamento 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_leavesstring[]nãoAs 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. aparecem aqui, porque uma vinculação no nível da fronteira não carrega nenhum payload values. O payload lido aqui é o que a vinculação acaba carregando, de modo que uma folha situada em um valor que o esquema da Feature declara como padrão é nomeada ao lado de uma que uma fronteira escreveu — um padrão preenchido é um dado que o payload carrega, e uma marcação lida apenas do bloco escrito o deixaria sem nome. Uma folha aparece onde um caminho que o esquema da Feature declara sensível a cobre: a declaração nomeia essa folha, ou nomeia um objeto que a contém, de modo que uma folha sob um objeto que uma declaração cobre é nomeada por essa declaração. A correspondência é feita segmento a segmento sobre o caminho pontilhado, sem ler nada do próprio texto do caminho e sem inspecionar nenhum valor, de modo que uma declaração em 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.
realizationstringnãoA FeatureRecipe que realiza esta vinculação a uma fronteira, como :: aquela que o Manifest associa a ela — pelo nome próprio da vinculação onde o nível de nomes do Manifest mapeia esse nome, caso contrário pelo seu tipo de Feature —, que é aquela com a qual um build dos mesmos documentos a renderiza. É o mesmo campo, lido da mesma maneira, que a realização de uma entrada de vinculação sob feature_values_mapping. Ausente quando o Manifest não associa a vinculação a nenhuma FeatureRecipe que o catálogo contenha.

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.

PropriedadeTipoObrigatóriaDescrição
maintainersMaintainer[]nãoOs mantenedores que a entidade do catálogo lista como seus proprietários.
licensestringnãoO identificador de licença SPDX que a entidade do catálogo declara para o software que descreve.
repositorystringnãoA URL do repositório Git que a entidade do catálogo indica como aquele que contém seus arquivos-fonte.
homestringnãoA URL da página inicial, da wiki ou da documentação da entidade do catálogo.
keywordsstring[]nãoAs palavras-chave descritivas que a entidade do catálogo declara.

Não são permitidas propriedades adicionais.

IRNode

PropriedadeTipoObrigatóriaDescrição
descriptionstringnãoDocumentaçã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.
labelsmapa de stringsimOs rótulos de duck typing e de ontologia da entidade.
componentstringsimO nome do Component subjacente.
resolved_versionstringsimA versão semântica exata do Component resolvida durante a compilação.
sync_waveintegernãoA 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_pathstringnãoO 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_pathstringnãoO 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_subsystembooleanonã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_boundarybooleanonã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_metadataCatalogMetadatanãoA 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_annotationsmapa de stringnãoCaracterísticas imutáveis e intrínsecas do componente, escritas pelo arquiteto de plataforma no domínio 2.
release_annotationsmapa de stringnãoStrings de topologia física e realidades de Ops que descem em cascata a partir das fronteiras na Release.
aggregate_annotationsmapa de stringnãoMetadados cognitivos, intenção do desenvolvedor e FinOps que descem em cascata a partir dos subsistemas no Aggregate.
self_injectobjectnãoBloco 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_filestringnãoCaminho, 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.
usesobjectnãoO 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_leavesstring[]nãoAs 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. ou infra.. Ele nomeia os dados PRÓPRIOS do nó — o que values_mapping e infra_mapping carregam para este nó — e é um assunto diferente da marcação em uma entrada de vinculação, que nomeia dados que uma vinculação carrega em relação à declaração de sua Feature. Nenhum dos dois pode ser recuperado a partir do outro: o Component de um nó e a Feature de uma vinculação declaram esquemas diferentes, e um nó que não vincula nada ainda assim carrega values. O payload lido aqui é o que esses dois mapeamentos carregam, de modo que uma folha situada em um valor que o esquema do Component declara como padrão é nomeada ao lado de uma que um autor escreveu — um padrão preenchido é um dado que o grafo carrega, e uma marcação lida apenas dos blocos escritos o deixaria sem nome. Uma folha aparece onde um caminho que o esquema do Component declara sensível a cobre: a declaração nomeia essa folha, ou nomeia um objeto que a contém, de modo que uma folha sob um objeto que uma declaração cobre é nomeada por essa declaração. A correspondência é feita segmento a segmento sobre o caminho pontilhado, sem ler nada do próprio texto do caminho e sem inspecionar nenhum valor, de modo que uma declaração em 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

PropriedadeTipoObrigatóriaDescrição
sourcestringsimO ID do nó consumidor, onde a conexão começa.
targetstringsimO ID do nó que a conexão alcança.
socketstringnãoA categoria de usesSchema à qual esta aresta pertence (p. ex., ‘databases’, ‘tools’).
aliasstringnãoO alias definido pelo desenvolvedor para esta conexão (p. ex., ‘primary_db’).
socket_declarationstring (enum)simDe 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_featurestringnãoSe 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_instancestringnãoO 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_releasebooleanonã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.
valuesobjectnãoValores 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..values. As chaves que o autor omitiu são preenchidas a partir dos padrões declarados do socket; um valor escrito pelo autor prevalece.
infraobjectnãoInfra 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..infra. As chaves que o autor omitiu são preenchidas a partir dos padrões declarados do socket; um valor escrito pelo autor prevalece.
injectobjectnãoRoteamento de injeção agnóstico. Mapeia variáveis locais para as chaves provides do destino.
sensitive_payload_leavesstring[]nãoAs 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. ou infra.. A declaração lida é o contrato por conexão no componente CONSUMIDOR — a origem da aresta — sob o socket ao qual esta aresta está conectada: seu valueSchema rege values e seu infraSchema rege infra, que é o mesmo contrato em relação ao qual ambos os payloads são validados. As declarações do destino não entram em jogo: o que o destino publica é um dado diferente da configuração que o consumidor escreve para a conexão. É o mesmo campo, lido da mesma maneira, que a marcação em um nó, e um assunto diferente dela: a marcação de um nó nomeia os dados próprios do nó em relação ao esquema do seu Component, e esta nomeia a configuração da conexão em relação ao contrato do socket, de modo que nenhuma das duas pode ser recuperada a partir da outra. Os payloads lidos aqui são os que esta aresta carrega, de modo que uma folha situada em um valor que o contrato do socket declara como padrão é nomeada ao lado de uma que um autor escreveu. Uma folha aparece onde um caminho que o contrato declara sensível a cobre: a declaração nomeia essa folha, ou nomeia um objeto que a contém. A correspondência é feita segmento a segmento sobre o caminho pontilhado, sem ler nada do próprio texto do caminho e sem inspecionar nenhum valor, de modo que uma declaração em 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.

PropriedadeTipoObrigatóriaDescrição
envmapa de stringnãoEntrega 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.
filemapa de stringnãoEntrega 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.
argmapa de stringnãoEntrega 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.

PropriedadeTipoObrigatóriaDescrição
aggregate_namestringsimO metadata.name do Aggregate.

Não são permitidas propriedades adicionais.

IRProvenance

Metadados de rastreabilidade para diagnóstico e auditoria.

PropriedadeTipoObrigatóriaDescrição
schema_versionstringsimA 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_versionstringsimCarimbo de conformidade obrigatório. Identifica, pela sua versão, o binário aggrega que construiu este grafo.
aggregate_versionstringsimA versão semântica exata da intenção do Aggregate raiz usada durante a compilação.
manifest_versionstringsimA versão semântica exata do arquivo de bloqueio do Manifest usado durante a compilação.
release_versionstringsimA 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ó.

PropriedadeTipoObrigatóriaDescrição
nodesmapa de IRNodesimDicioná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_.-]+$.
edgesIREdge[]simCaminhos de rede lógicos explícitos e dependências entre nós.
values_mappingobjectsimA única fonte da verdade para os payloads cognitivos opacos repassados sem alteração, mapeados por ID do nó.
infra_mappingobjectsimO payload de dimensionamento físico injetado a partir da Release, mapeado por ID do nó.
feature_values_mappingmapa de mapa de IRFeatureEntrysimMapa 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_featuresmapa de mapa de IRBoundaryFeaturenãoAs 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_./-]+$.
provenanceIRProvenancesimMetadados de rastreabilidade para diagnóstico e auditoria.

Não são permitidas propriedades adicionais.

IRGraph

PropriedadeTipoObrigatóriaDescrição
apiVersionconst “aggrega.ai/v1beta1”simConstante: "aggrega.ai/v1beta1"
kindconst “IR”simConstante: "IR"
metadataIRMetadatasimIdentidade do grafo: o Aggregate a partir do qual ele foi construído.
specIRSpecsimO próprio grafo: seus nós, suas arestas e os payloads indexados por nó.

Não são permitidas propriedades adicionais.