Ir al contenido
AggregaAggrega
Seleccionar idioma: Español
Esta página se tradujo automáticamente. Lee el original en inglés.

Esquema del grafo IR agnóstico respecto a las capacidades de Aggrega

Referencia generada. No la edites a mano — regenérala a partir del JSON Schema publicado.

ID del esquema: https://aggrega.ai/schemas/ir-v1beta1.schema.json

El grafo aplanado, completamente resuelto y unidimensional que emite el Topology Builder.

Tipo de nivel superior: object

Propiedades

PropiedadTipoObligatoriaDescripción
apiVersionconst “aggrega.ai/v1beta1”síConstante: "aggrega.ai/v1beta1"
kindconst “IR”síConstante: "IR"
metadataIRMetadatasíIdentidad del grafo: el Aggregate a partir del cual se construyó.
specIRSpecsíEl grafo en sí: sus nodos, sus aristas y las cargas útiles indexadas por nodo.

No se permiten propiedades adicionales.

Definiciones

Maintainer

PropiedadTipoObligatoriaDescripción
namestringsíEl nombre del mantenedor.
emailstringnoLa dirección de correo electrónico del mantenedor.
urlstringnoLa dirección web del mantenedor.

FieldProvenance

Origen de una hoja en la carga útil values o infra de una vinculación.

PropiedadTipoObligatoriaDescripción
originstringsíSi la hoja se escribió explícitamente o la aportó la pasada de expansión impulsada por anotaciones.
sidestringnoSuperficie de autoría en la que se declaró la anotación; ausente para las hojas explícitas.
annotation_keystringnoNombre de la anotación que aportó esta hoja; ausente para las hojas explícitas.
annotation_sourcestringnoUbicación en el código fuente de la declaración de la anotación como :; ausente para las hojas explícitas.
overridden_annotationFieldProvenancenoLa contribución de anotación que perdió esta hoja frente a una explícita: cuando una hoja explícita sobrescribió una hoja aportada por una anotación, la procedencia suprimida a la que sustituyó. Singular — nunca se conserva más que exactamente una contribución suprimida.

No se permiten propiedades adicionales.

AttachmentConnection

La conexión a la que pertenece una vinculación, para una vinculación escrita en una conexión que traza un componente en lugar de en el bloque de vinculaciones propio del componente: el socket a través del cual se cablea la conexión y el alias bajo el que está escrita. El par nombra una de las aristas del grafo — la arista cuyo origen es el nodo que lleva la vinculación y cuyo socket y alias son estos — de modo que un consumidor une la vinculación a esa arista y, a través de ella, al destino al que se presenta la vinculación.

PropiedadTipoObligatoriaDescripción
socketstringsíEl socket a través del cual se cablea la conexión: el socket de la arista a la que pertenece la vinculación.
aliasstringsíEl alias bajo el que está escrita la conexión: el alias de la arista a la que pertenece la vinculación.

No se permiten propiedades adicionales.

IRFeatureEntry

Una vinculación resuelta para un nodo, llevada en feature_values_mapping. Todas las familias de vinculaciones comparten esta forma — una Feature operativa, una Feature de credenciales, una Feature de identidad — de modo que ninguna familia obtiene una proyección con más pérdidas que otra. Lo que lleva el values de una vinculación de credenciales es elección del autor: una credencial por referencia lleva un puntero a un almacén de secretos, una por valor lleva el material en sí, y el compilador lleva literalmente la que se haya escrito sin resolver ninguna de las dos.

PropiedadTipoObligatoriaDescripción
typestringsíURI de la Feature del catálogo que solicita esta vinculación.
resolved_versionstringsíLa versión semántica exacta resuelta durante la compilación.
labelsmapa de stringnoLas etiquetas de catálogo de la Feature vinculada, llevadas literalmente en el orden en que las declara su entidad de catálogo — nunca filtradas, normalizadas ni despojadas de prefijo, de modo que un consumidor lee exactamente lo que escribió el autor del catálogo. El compilador no lee ninguna. Ausente cuando la Feature no declara etiquetas, y cuando su tipo no se resuelve en ninguna entidad de catálogo.
catalog_annotationsmapa de stringnoLas anotaciones de catálogo de la Feature vinculada — las metadata.annotations de la entidad Feature que nombra esta vinculación — llevadas literalmente en el orden en que esa entidad las declara, nunca filtradas, normalizadas ni despojadas de prefijo, de modo que un consumidor lee exactamente lo que escribió el autor del catálogo, incluidas las claves del propio espacio de nombres del autor. El compilador no lee ninguna. Distinto de annotation_key y annotation_source, que nombran y ubican la anotación que hizo que esta vinculación existiera: esos dos informan de cómo surgió la vinculación, este informa de los metadatos de la entidad que nombra, y una vinculación escrita en un bloque features: lleva estas anotaciones sin llevar ninguno de esos dos. Ausente cuando la Feature no declara anotaciones, y cuando su tipo no se resuelve en ninguna entidad de catálogo.
bindingstringnoNombra la ranura de vinculación que ocupa esta vinculación, o “free” cuando no ocupa ninguna ranura declarada. Una ranura se declara en uno de dos lugares, y dónde se escribió la vinculación decide cuál: una vinculación del bloque de vinculaciones propio del nodo ocupa una ranura que el Component host declara en su featuresSchema, y una vinculación escrita en una conexión ocupa una ranura que el socket de la conexión declara en el featuresSchema de ese socket en el Component host. El emparejamiento es por nombre en ambos casos — una vinculación ocupa una ranura cuando la Feature se vincula bajo el nombre de la ranura, en el bloque del componente o en la conexión — así que el valor es una clave exacta del conjunto de ranuras declaradas, nunca algo leído de la clave de la vinculación. El conjunto de ranuras de un socket es cerrado, ya que una vinculación escrita en una conexión bajo un nombre que su socket no declara detiene la compilación, así que una vinculación que lleva una conexión nunca informa free. Se lleva el nombre de la ranura en lugar de un simple booleano porque qué ranura se ocupó es la mitad más útil de la respuesta. Vacío cuando el conjunto de ranuras declaradas del Component host no se pudo resolver, lo cual es distinto de “free”: free es la constatación positiva de que ninguna ranura declarada lleva este nombre.
valuesobjectnoCarga útil de configuración operativa de la vinculación. Para una credencial, la forma que haya declarado el autor — un puntero a un almacén de secretos, o el material en sí.
infraobjectnoDimensionamiento físico por instancia para esta vinculación.
injectobjectnoEnrutamiento de inyección agnóstico. Asigna variables locales a las claves provides del destino.
originstring (enum)noDistingue las vinculaciones escritas en un bloque features: (explicit) de las vinculaciones sintéticas producidas por la pasada de expansión impulsada por anotaciones (annotation), o mixed cuando las hojas value/infra de la vinculación llevan una mezcla de ambas (el detalle por hoja está entonces en los mapas de procedencia). Valores permitidos: "explicit", "annotation", "mixed"
annotation_keystringnoNombre de la anotación que desencadenó una vinculación sintética. Ausente cuando origin es explicit.
annotation_sourcestringnoUbicación en el código fuente de la declaración de la anotación como :. Ausente cuando origin es explicit.
values_provenancemapa de FieldProvenancenoOrigen por hoja de la carga útil values, indexado por la ruta con puntos de la hoja.
infra_provenancemapa de FieldProvenancenoOrigen por hoja de la carga útil infra, indexado por la ruta con puntos de la hoja.
sensitivebooleanonoEs true cuando esta vinculación maneja material que un autor declaró sensible — o bien la Feature vinculada declara una hoja sensible en su pilar values, infra o provides, o bien la ranura que ocupa la vinculación declara sensible el material que lleva: la ranura de vinculación del mismo nombre del Component host o, para una vinculación escrita en una conexión, la ranura de ese nombre que declara el socket de la conexión. Se deriva de esas declaraciones sobre la vinculación fusionada, nunca del contenido de un valor ni de un nombre. Sin establecer cuando no está presente ninguna de las dos declaraciones.
sensitive_injectmapa de mapas de stringnoLas claves de entrega de inject cuya clave provides referenciada declara sensible la Feature vinculada, en la forma propia de inject: mecanismo, luego clave de entrega, con la clave provides referenciada como valor. Un subconjunto de inject. Ausente cuando la vinculación no declara ningún mecanismo de entrega o no hace referencia a ninguna clave provides sensible.
sensitive_payload_leavesstring[]noLas hojas que lleva la carga útil values e infra de esta vinculación y que la Feature vinculada declara sensibles, cada una como la ruta con puntos prefijada por el pilar que ocupa el dato: values. o infra.. La carga útil leída aquí es la que la vinculación acaba llevando, de modo que una hoja situada en un valor que el esquema de la Feature declara como predeterminado se nombra junto a una que escribió un autor — un valor predeterminado rellenado es un dato que lleva la carga útil, y un marcado leído solo del bloque escrito lo dejaría sin nombrar. Esta es la unidad por hoja del marcado de sensibilidad, y responde a una pregunta que ninguno de los otros dos campos responde — sensitive da una sola respuesta para toda la vinculación, sensitive_inject da una por cada clave de entrega de inject, y ninguno de los dos nombra una hoja individual. Una hoja aparece donde la cubre una ruta que el esquema de la Feature declara sensible: la declaración nombra esa hoja, o nombra un objeto que la contiene, de modo que una hoja bajo un objeto que cubre una declaración queda nombrada por esa declaración. La coincidencia se evalúa segmento a segmento sobre la ruta con puntos, sin leer nada del propio texto de la ruta y sin inspeccionar ningún valor, de modo que una declaración en db cubre db.password y no alcanza a una hoja hermana llamada dbPassword. La respuesta por vinculación nunca se reparte entre hojas individuales, lo que afirmaría algo falso sobre una hoja que se dejó legible. Una clave ausente indica que esta vinculación no nombra ninguna hoja que su Feature declare sensible. No afirma que la carga útil no sea sensible, y no distingue una vinculación que no tiene ninguna hoja así que nombrar de un productor que no informa de este eje en absoluto — un guest que lee una clave ausente como permiso para mostrar o emitir un valor en claro la ha leído al revés. Las hojas llegan en el orden en que la carga útil las contiene, las del pilar values antes que las del pilar infra — el mismo orden que llevan las propias cargas útiles values e infra, y lo que hace que la carga útil sea idéntica byte a byte entre ejecuciones con una entrada idéntica. Ausente cuando la vinculación no lleva ninguna hoja que su Feature declare sensible.
connectionAttachmentConnectionnoLa conexión a la que pertenece esta vinculación: presente en cada vinculación escrita en una de las conexiones del nodo, y ausente en cada vinculación del bloque de vinculaciones propio del nodo. Una vinculación escrita en una conexión es, en todos los demás aspectos, una de las vinculaciones del nodo — indexada por su nombre calificado, el alias de la conexión y la ranura unidos por un punto, y que toma su enlace y su sensibilidad de la ranura que declara el socket de la conexión —, así que este campo es lo que distingue a las dos, y lleva la conexión como dato en lugar de dejar que se lea a partir de la clave. Un consumidor lo une a las aristas del grafo por socket y alias: la arista cuyo origen es el nodo que lleva esta vinculación y cuyo socket y alias son estos es la conexión en la que se presenta la vinculación, y el destino de esa arista es aquello a lo que se presenta. Una vinculación de una conexión que traza una vinculación de Feature nunca lleva uno, porque una conexión así no lleva vinculaciones.
realizationstringnoLa FeatureRecipe que realiza esta vinculación, como :: la que el Manifest le enlaza — por el nombre propio de la vinculación donde el nivel de nombres del Manifest asigna ese nombre, y si no, por su tipo de Feature —, que es aquella con la que una compilación de los mismos documentos la renderiza. Para una vinculación escrita en una conexión, el nombre por el que se lee el nivel de nombres es su nombre calificado, el alias de la conexión y la ranura unidos por un punto. El valor es el par que aggrega inspect imprime como realización de la vinculación y, donde un destino estampa la procedencia en lo que renderiza, el valor aggrega.ai/recipe-uri en los documentos que renderiza esa FeatureRecipe, de modo que un consumidor une una vinculación con lo que renderiza sin traducir entre formas. Nombra la FeatureRecipe por nombre y versión y no por capacidad. El campo registra qué FeatureRecipe enlaza el Manifest, leída del Manifest y del catálogo cuando se construye el grafo: no se obtiene nada para producirlo, y la FeatureRecipe solo se renderiza cuando la compilación renderiza. Ausente cuando el Manifest no enlaza la vinculación con ninguna FeatureRecipe que contenga el catálogo.

No se permiten propiedades adicionales.

IRFeatureEntry.inject

Enrutamiento de inyección agnóstico. Asigna variables locales a las claves provides del destino.

PropiedadTipoObligatoriaDescripción
envmapa de stringnoEntrega mediante variables de entorno: las claves son los nombres de las variables locales del consumidor y los valores son las claves provides del destino.
filemapa de stringnoEntrega mediante montaje de archivos: las claves son las rutas de archivo locales del consumidor y los valores son las claves provides del destino.
argmapa de stringnoEntrega mediante argumentos de línea de comandos: las claves son los prefijos de flags del consumidor y los valores son las claves provides del destino.

IRBoundaryFeature

Una vinculación de Feature a nivel de límite proyectada en la IR: el URI del tipo de Feature más la infra del límite con respecto a la cual una FeatureRecipe con ámbito boundary renderiza y resuelve su fuente. Las vinculaciones a nivel de límite no llevan ninguna carga útil values.

PropiedadTipoObligatoriaDescripción
typestringsíURI de la Feature del catálogo vinculada en este límite.
infraobjectnoDimensionamiento físico para la vinculación a un límite; la infra con respecto a la cual una FeatureRecipe con ámbito boundary evalúa sus plantillas y su fuente.
sensitive_payload_leavesstring[]noLas hojas que lleva la carga útil infra de esta vinculación a un límite y que la Feature vinculada declara sensibles, cada una como la ruta con puntos prefijada por el pilar que ocupa el dato. Aquí solo aparecen coordenadas infra., porque una vinculación a nivel de límite no lleva ninguna carga útil values. La carga útil leída aquí es la que la vinculación acaba llevando, de modo que una hoja situada en un valor que el esquema de la Feature declara como predeterminado se nombra junto a una que escribió un límite — un valor predeterminado rellenado es un dato que lleva la carga útil, y un marcado leído solo del bloque escrito lo dejaría sin nombrar. Una hoja aparece donde la cubre una ruta que el esquema de la Feature declara sensible: la declaración nombra esa hoja, o nombra un objeto que la contiene, de modo que una hoja bajo un objeto que cubre una declaración queda nombrada por esa declaración. La coincidencia se evalúa segmento a segmento sobre la ruta con puntos, sin leer nada del propio texto de la ruta y sin inspeccionar ningún valor, de modo que una declaración en db cubre db.password y no alcanza a una hoja hermana llamada dbPassword. Una clave ausente indica que esta vinculación no nombra ninguna hoja que su Feature declare sensible, lo que incluye el caso en que la Feature vinculada no se resuelve en ningún esquema que este lector pudiera leer. No afirma que la carga útil infra no sea sensible, y no distingue una vinculación que no tiene ninguna hoja así que nombrar de un productor que no informa de este eje en absoluto. Un consumidor que lee una clave ausente como permiso para mostrar o emitir un valor en claro la ha leído al revés. Las hojas llegan en el orden en que la carga útil las contiene, que es el mismo orden que lleva la propia carga útil infra y lo que mantiene el grafo idéntico byte a byte entre ejecuciones con una entrada idéntica. Ausente cuando la vinculación no lleva ninguna hoja que su Feature declare sensible.
realizationstringnoLa FeatureRecipe que realiza esta vinculación a un límite, como :: la que el Manifest le enlaza — por el nombre propio de la vinculación donde el nivel de nombres del Manifest asigna ese nombre, y si no, por su tipo de Feature —, que es aquella con la que una compilación de los mismos documentos la renderiza. Es el mismo campo, leído de la misma manera, que la realización de una entrada de vinculación bajo feature_values_mapping. Ausente cuando el Manifest no enlaza la vinculación con ninguna FeatureRecipe que contenga el catálogo.

No se permiten propiedades adicionales.

CatalogMetadata

La suite de metadatos empresariales extraída explícitamente de la entidad del catálogo, que expone los datos de ciclo de vida y de propiedad a los linters de Wasm.

PropiedadTipoObligatoriaDescripción
maintainersMaintainer[]noLos mantenedores que la entidad del catálogo enumera como sus propietarios.
licensestringnoEl identificador de licencia SPDX que la entidad del catálogo declara para el software que describe.
repositorystringnoLa URL del repositorio Git que la entidad del catálogo indica como el que contiene sus archivos fuente.
homestringnoLa URL de la página de inicio, la wiki o la documentación de la entidad del catálogo.
keywordsstring[]noLas palabras clave descriptivas que declara la entidad del catálogo.

No se permiten propiedades adicionales.

IRNode

PropiedadTipoObligatoriaDescripción
descriptionstringnoDocumentación opcional escrita por el desarrollador que describe el papel de esta instancia de componente en la aplicación. Se traslada desde el Aggregate para el renderizado y para los diagnósticos de lint.
labelsmapa de stringsíLas etiquetas de duck typing y de ontología de la entidad.
componentstringsíEl nombre del Component subyacente.
resolved_versionstringsíLa versión semántica exacta del Component resuelta durante la compilación.
sync_waveintegernoLa oleada de despliegue heredada del campo syncWave del límite que lo contiene (0 de forma predeterminada; se permiten valores negativos). En K8s y Helm, la oleada es lo que ordena el despliegue: se convierte en una anotación argocd.argoproj.io/sync-wave y, en un recurso que el chart ya marca como hook de Helm, también se convierte en el helm.sh/hook-weight de ese hook. En compose, el valor se registra como etiqueta del servicio y además ordena los servicios del archivo en el que se renderiza, mediante depends_on entre ellos. En cloudformation ordena el aprovisionamiento de la pila en la que se ensambla un grupo de despacho, ya que cada recurso de una oleada se declara dependiente de los recursos de la oleada anterior: el orden en que se crean y, a la inversa, el orden en que se eliminan, nunca la disponibilidad, porque una plantilla de pila no expresa ninguna noción de que un recurso esté listo. En terraform ordena los bloques module de la configuración raíz en la que se ensambla un límite, ya que cada módulo de una oleada se declara dependiente de los módulos de la oleada anterior: el orden en que el motor realiza sus acciones, nunca la disponibilidad, porque una configuración no expresa ninguna noción de que un recurso esté listo. El valor también viaja con la procedencia de compilación del nodo.
boundary_pathstringnoLa ruta del límite de la Release en el que se coloca este nodo: los nombres de los límites desde el más externo hacia dentro, unidos con / (p. ej., ‘data/inner’ para un componente colocado en un límite inner declarado dentro de un límite data). Un nombre de límite no puede contener /, así que la ruta se descompone de nuevo en sus límites sin ambigüedad. Un nodo de un Aggregate importado que la Release encamina a un límite lleva la ruta de ese límite. Permite a los plugins de renderizado generar identificadores únicos que tienen en cuenta el límite.
subsystem_pathstringnoLa ruta del subsistema del Aggregate en el que se declara el componente de este nodo: los nombres de los subsistemas desde el más externo hacia dentro, unidos con . (p. ej., ‘backend.storage’ para un componente declarado en un subsistema storage anidado dentro de un subsistema backend). Un nombre de subsistema no puede contener ., así que la ruta se descompone de nuevo en sus subsistemas sin ambigüedad. Un componente de un Aggregate que declara components de nivel superior lleva el default sintetizado, marcado por synthesized_subsystem. La ruta es relativa al Aggregate que declara el componente: un nodo que aporta un Aggregate importado lleva su ruta dentro de ese Aggregate, sin el nombre con el que se importa (p. ej., ‘tier’ para un componente en el subsistema tier del Aggregate importado), de modo que nodos de distintos Aggregates pueden compartir una misma ruta. El ID del nodo, que empieza por el nombre de importación, y source_file los distinguen.
synthesized_subsystembooleanonoEs true cuando el subsistema de este nodo fue sintetizado por el compilador — el subsistema default creado para un Aggregate que declara components de nivel superior en lugar de subsystems con nombre. Procedencia derivada, nunca escrita por el autor: distingue el default sintetizado de un subsistema que un usuario llamó explícitamente default. Independiente de synthesized_boundary (un nodo puede estar sintetizado en cualquiera de los dos ejes o en ambos). Ausente (false) para cada subsistema escrito por el autor.
synthesized_boundarybooleanonoEs true cuando el límite de este nodo fue sintetizado por el compilador — el límite default creado para una Release que declara components de nivel superior en lugar de boundaries con nombre. Procedencia derivada, nunca escrita por el autor: distingue el default sintetizado de un límite que un usuario llamó explícitamente default, y encamina los artefactos del nodo a dist/ de forma plana en lugar de a dist/boundaries/default/. Ausente (false) para cada límite escrito por el autor.
catalog_metadataCatalogMetadatanoLa suite de metadatos empresariales extraída explícitamente de la entidad del catálogo, que expone los datos de ciclo de vida y de propiedad a los linters de Wasm.
catalog_annotationsmapa de stringnoCaracterísticas inmutables e intrínsecas del componente, escritas por el arquitecto de plataforma en el dominio 2.
release_annotationsmapa de stringnoCadenas de topología física y realidades de Ops que descienden en cascada desde los límites de la Release.
aggregate_annotationsmapa de stringnoMetadatos cognitivos, intención del desarrollador y FinOps que descienden en cascada desde los subsistemas del Aggregate.
self_injectobjectnoBloque de self-inject a nivel de Component trasladado desde el Aggregate; el enrutamiento de inyección agnóstico que el nodo declara para sí mismo. Opaco en esta capa del esquema; un plugin de políticas que lo lee analiza los bytes.
source_filestringnoRuta, relativa al espacio de trabajo, del archivo del Aggregate en el que se escribió este nodo. Los nodos del nivel raíz llevan la ruta del Aggregate raíz; los nodos de subagregados llevan la ruta de archivo del Aggregate importado. La ruta es relativa a la raíz del espacio de trabajo (el directorio que contiene .aggrega-config.yaml), de modo que el grafo es idéntico byte a byte en máquinas cuyos espacios de trabajo se encuentran en rutas absolutas distintas. Los consumidores que filtran los diagnósticos por archivo resuelven el campo con respecto a la misma raíz del espacio de trabajo antes de la comparación. Ausente cuando el grafo se construyó sin una raíz del espacio de trabajo.
usesobjectnoEl bloque uses del nodo exactamente como se escribió: cada nombre de socket se asigna a una lista de nombres de instancias de destino o a un mapa de entradas de conexión indexado por alias, en el orden en que el autor los declaró. Es el bloque tal como está escrito, que es un hecho distinto de las conexiones resueltas en edges: un socket que el autor rellenó aparece aquí incluso donde no produjo ninguna conexión, de modo que un lector puede distinguir un socket que el autor llenó de un socket que alcanza un destino. Ausente cuando el nodo no escribió ningún bloque uses. Opaco en esta capa del esquema; un plugin de políticas que lo lee analiza los bytes.
sensitive_payload_leavesstring[]noLas hojas que lleva la carga útil values e infra de este nodo y que su Component declara sensibles, cada una como la ruta con puntos prefijada por el pilar que ocupa el dato: values. o infra.. Nombra los datos PROPIOS del nodo — lo que values_mapping e infra_mapping llevan para este nodo — y es un asunto distinto del marcado en una entrada de vinculación, que nombra los datos que una vinculación lleva con respecto a la declaración de su Feature. Ninguno se puede recuperar a partir del otro: el Component de un nodo y la Feature de una vinculación declaran esquemas distintos, y un nodo que no vincula nada sigue llevando values. La carga útil leída aquí es la que llevan esos dos mapeos, de modo que una hoja situada en un valor que el esquema del Component declara como predeterminado se nombra junto a una que escribió un autor — un valor predeterminado rellenado es un dato que lleva el grafo, y un marcado leído solo de los bloques escritos lo dejaría sin nombrar. Una hoja aparece donde la cubre una ruta que el esquema del Component declara sensible: la declaración nombra esa hoja, o nombra un objeto que la contiene, de modo que una hoja bajo un objeto que cubre una declaración queda nombrada por esa declaración. La coincidencia se evalúa segmento a segmento sobre la ruta con puntos, sin leer nada del propio texto de la ruta y sin inspeccionar ningún valor, de modo que una declaración en db cubre db.password y no alcanza a una hoja hermana llamada dbPassword. Una clave ausente indica que este nodo no nombra ninguna hoja que su Component declare sensible, lo que incluye el caso en que el Component del nodo no se resuelve en ningún esquema que este lector pudiera leer. No afirma que la carga útil del nodo no sea sensible, y no distingue un nodo que no tiene ninguna hoja así que nombrar de un productor que no informa de este eje en absoluto. Un consumidor que lee una clave ausente como permiso para mostrar o emitir un valor en claro la ha leído al revés. Las hojas llegan en el orden en que la carga útil las contiene, las del pilar values antes que las del pilar infra, que es el mismo orden que llevan esas propias cargas útiles y lo que mantiene el grafo idéntico byte a byte entre ejecuciones con una entrada idéntica. Ausente cuando el nodo no lleva ninguna hoja que su Component declare sensible.

No se permiten propiedades adicionales.

IREdge

PropiedadTipoObligatoriaDescripción
sourcestringsíEl ID del nodo consumidor, donde empieza la conexión.
targetstringsíEl ID del nodo al que llega la conexión.
socketstringnoLa categoría de usesSchema a la que pertenece esta arista (p. ej., ‘databases’, ‘tools’).
aliasstringnoEl alias definido por el desarrollador para esta conexión (p. ej., ‘primary_db’).
socket_declarationstring (enum)síDe dónde procede el socket: declared cuando la entidad del catálogo a la que pertenece el socket lo enumera en usesSchema (el Component consumidor, o la Feature de origen para una arista escrita por una Feature), ad-hoc cuando el autor del Aggregate nombró un socket que el catálogo no declaró. Es un tercer eje, independiente de la autoría de la arista: dice de dónde procede el socket, no quién trazó la arista, de modo que una arista escrita por una Release hacia un socket declarado y una arista escrita por un Aggregate hacia un socket ad hoc difieren en los dos ejes de forma independiente. Un socket declarado lleva su entrada de usesSchema, incluido el selector que restringe a qué destinos puede llegar la arista; un socket ad hoc no tiene entrada de catálogo y, por tanto, ningún selector, así que lo que la arista puede llevar está acotado únicamente por los provides declarados del destino. Siempre presente, de modo que un consumidor nunca tiene que leer un valor ausente como declared, y una política puede exigir que toda arista esté declarada. Distinto del marcador de enlace de una vinculación, que responde a la misma forma de pregunta sobre un asunto distinto. Valores permitidos: "declared", "ad-hoc"
origin_featurestringnoSi esta arista fue declarada de forma autónoma por una Feature (incluidas las Features de credenciales etiquetadas con feature.aggrega.ai/kind: secret), identifica el URI del tipo de Feature. Permite a los plugins de Wasm aislar su propia topología.
origin_feature_instancestringnoEl nombre de instancia por vinculación de la Feature que declaró esta arista. Localiza por instancia los provides resueltos de una FeatureRecipe con ámbito boundary, distinguiendo dos vinculaciones del mismo tipo de Feature en un mismo límite.
origin_releasebooleanonoEs true cuando esta arista fue creada por una Release que conecta un socket declarado pero no enlazado con un componente existente. Marca la AUTORÍA de la arista, no la configuración: una arista declarada por el desarrollador para la que una Release solo aportó infra sigue siendo de origen Aggregate (origin_release sin establecer; la infra de su Release aparece en el mapa infra de la arista). origin_feature establecido => origen Feature; origin_release true => origen Release; ninguno de los dos => origen Aggregate.
valuesobjectnoValores del desarrollador por conexión resueltos para esta arista (procedentes de la arista del Aggregate), validados en la resolución con respecto al valueSchema declarado por el socket de origen (el socket del componente consumidor, que es el origen de la arista) y proyectados en el contexto de renderizado del nodo consumidor en .context.uses..values. Las claves que el autor omitió se rellenan a partir de los valores predeterminados declarados del socket; un valor escrito por el autor prevalece.
infraobjectnoInfra por conexión resuelta para esta arista, aportada por una entrada de arista de una Release, validada en la resolución con respecto al infraSchema declarado por el socket de origen (el socket del componente consumidor, que es el origen de la arista) y proyectada en .context.uses..infra. Las claves que el autor omitió se rellenan a partir de los valores predeterminados declarados del socket; un valor escrito por el autor prevalece.
injectobjectnoEnrutamiento de inyección agnóstico. Asigna variables locales a las claves provides del destino.
sensitive_payload_leavesstring[]noLas hojas que llevan los values y la infra de esta arista y que el socket con respecto al cual están escritos declara sensibles, cada una como la ruta con puntos prefijada por el pilar que ocupa el dato: values. o infra.. La declaración que se lee es el contrato por conexión del componente CONSUMIDOR — el origen de la arista — bajo el socket al que está conectada esta arista: su valueSchema rige values y su infraSchema rige infra, que es el mismo contrato con respecto al cual se validan ambas cargas útiles. Las declaraciones del destino no intervienen: lo que publica el destino es un dato distinto de la configuración que el consumidor escribe para la conexión. Es el mismo campo, leído de la misma manera, que el marcado de un nodo, y un asunto distinto de él: el marcado de un nodo nombra los datos propios del nodo con respecto al esquema de su Component, y este nombra la configuración de la conexión con respecto al contrato del socket, así que ninguno se puede recuperar a partir del otro. Las cargas útiles leídas aquí son las que lleva esta arista, de modo que una hoja situada en un valor que el contrato del socket declara como predeterminado se nombra junto a una que escribió un autor. Una hoja aparece donde la cubre una ruta que el contrato declara sensible: la declaración nombra esa hoja, o nombra un objeto que la contiene. La coincidencia se evalúa segmento a segmento sobre la ruta con puntos, sin leer nada del propio texto de la ruta y sin inspeccionar ningún valor, de modo que una declaración en db cubre db.password y no alcanza a una hoja hermana llamada db_password. Una superficie que retiene del grafo los valores declarados sensibles retiene estas hojas en los values y la infra de esta arista, y en la entrada uses del nodo consumidor para la misma conexión, que lleva los valores tal como los escribió el autor. Una clave ausente indica que esta arista no nombra ninguna hoja que el contrato de su socket declare sensible, lo que incluye el caso en que el socket no declara ningún contrato que este lector pudiera leer. No afirma que la configuración no sea sensible, y un consumidor que lee una clave ausente como permiso para mostrar o emitir un valor en claro la ha leído al revés. Las hojas llegan en el orden en que las cargas útiles las contienen, las del pilar values antes que las del pilar infra, que es lo que mantiene el grafo idéntico byte a byte entre ejecuciones con una entrada idéntica. Ausente cuando la arista no lleva ninguna hoja que el contrato de su socket declare sensible.

No se permiten propiedades adicionales.

IREdge.inject

Enrutamiento de inyección agnóstico. Asigna variables locales a las claves provides del destino.

PropiedadTipoObligatoriaDescripción
envmapa de stringnoEntrega mediante variables de entorno: las claves son los nombres de las variables locales del consumidor y los valores son las claves provides del destino.
filemapa de stringnoEntrega mediante montaje de archivos: las claves son las rutas de archivo locales del consumidor y los valores son las claves provides del destino.
argmapa de stringnoEntrega mediante argumentos de línea de comandos: las claves son los prefijos de flags del consumidor y los valores son las claves provides del destino.

IRMetadata

Identidad del grafo: el Aggregate a partir del cual se construyó.

PropiedadTipoObligatoriaDescripción
aggregate_namestringsíEl metadata.name del Aggregate.

No se permiten propiedades adicionales.

IRProvenance

Metadatos de trazabilidad para el diagnóstico y la auditoría.

PropiedadTipoObligatoriaDescripción
schema_versionstringsíLa versión del esquema IR a la que se ajusta el grafo — aggrega.ai/v1beta1, el mismo valor que lleva la apiVersion del grafo.
compiler_versionstringsíSello de cumplimiento obligatorio. Identifica, por su versión, el binario aggrega que construyó este grafo.
aggregate_versionstringsíLa versión semántica exacta de la intención del Aggregate raíz usada durante la compilación.
manifest_versionstringsíLa versión semántica exacta del archivo de bloqueo del Manifest usado durante la compilación.
release_versionstringsíLa versión semántica exacta del archivo de enrutamiento de la Release usado durante la compilación.

Se permiten propiedades adicionales.

IRSpec

El grafo en sí: sus nodos, sus aristas y las cargas útiles indexadas por nodo.

PropiedadTipoObligatoriaDescripción
nodesmapa de IRNodesíDiccionario de todos los nodos del grafo, indexados por su ID absoluto. Puramente topológico. Claves: una o más letras, dígitos, guiones bajos, puntos o guiones. Patrón: ^[a-zA-Z0-9_.-]+$.
edgesIREdge[]síRutas de red lógicas explícitas y dependencias entre nodos.
values_mappingobjectsíLa única fuente de verdad para las cargas útiles cognitivas opacas que se transmiten sin cambios, asignadas por ID de nodo.
infra_mappingobjectsíLa carga útil de dimensionamiento físico inyectada desde la Release, asignada por ID de nodo.
feature_values_mappingmapa de mapa de IRFeatureEntrysíMapa normalizado de los ID de nodo a sus configuraciones de Feature vinculadas. Un único contenedor lleva cada vinculación de un nodo, sea lo que sea lo que produzca — Features operativas, Features de credenciales, Features de identidad —, indexada por el nombre de instancia que el autor dio a cada vinculación. Una vinculación escrita en una de las conexiones del nodo se indexa por su nombre calificado, el alias de la conexión y la ranura unidos por un punto, y nombra su conexión en su propio campo connection. Claves: una o más letras, dígitos, guiones bajos, puntos o guiones. Patrón: ^[a-zA-Z0-9_.-]+$.
boundary_featuresmapa de mapa de IRBoundaryFeaturenoLas vinculaciones de Feature de cada límite, indexadas por ruta del límite y luego por nombre de instancia. Presente solo cuando el grafo tiene vinculaciones de Feature a nivel de límite. Claves: una o más letras, dígitos, guiones bajos, puntos, barras o guiones. Patrón: ^[a-zA-Z0-9_./-]+$.
provenanceIRProvenancesíMetadatos de trazabilidad para el diagnóstico y la auditoría.

No se permiten propiedades adicionales.

IRGraph

PropiedadTipoObligatoriaDescripción
apiVersionconst “aggrega.ai/v1beta1”síConstante: "aggrega.ai/v1beta1"
kindconst “IR”síConstante: "IR"
metadataIRMetadatasíIdentidad del grafo: el Aggregate a partir del cual se construyó.
specIRSpecsíEl grafo en sí: sus nodos, sus aristas y las cargas útiles indexadas por nodo.

No se permiten propiedades adicionales.