Esquema del contexto de plantilla de Aggrega
Referencia generada. No la edites a mano — regenérala a partir del JSON Schema publicado.
ID del esquema: https://aggrega.ai/schemas/template-context-v1beta1.schema.json
La vista que el compilador ensambla y pasa a las plantillas de Recipe y FeatureRecipe mientras renderiza. Al renderizar una FeatureRecipe de vinculación, el compilador rellena además .attachment_name y .inject con el contexto de la vinculación, .context.render_facts con lo que el proveedor de su host informó sobre el renderizado del host y, en las plantillas que producen los recursos propios de la vinculación, .context.used_by con los componentes que usan su host. Para una FeatureRecipe con ámbito de límite (spec.executionScope: boundary), las plantillas que ejecuta una vez para el límite — entre ellas sus locals, provides, source, valuesMapping, artifacts y pasos de pipeline — encuentran ausentes los pilares .context, .workload, .attachment_name, .inject y .inject_raw y rellenado en su lugar un pilar .boundary.* — consulta el bloque del límite al final de las propiedades; su injectMapping se ejecuta una vez por cada componente al que llega la vinculación, en el contexto de ese componente, así que lee .context.* y .attachment_name, y allí .boundary no está definido. Esto NO se persiste en disco; existe solo en la memoria del compilador durante el renderizado. Este esquema documenta el contrato entre el compilador y los autores de plantillas de Ops.
Disponibilidad por etapa del renderizado base, en el orden en que se ejecutan las etapas:
- Evaluación de provides (preámbulo de locals, luego provides): solo pilares locales al nodo. Una entrada de locals lee las entradas que tiene encima en su propio bloque; una plantilla de provides lee todo el .locals resuelto del nodo. Autorreferencia prohibida (ninguna entrada de provides lee otra).
- Resolución de la fuente (publicación de locals + evaluación de source): todos los pilares; .source y .workload ausentes. Esos locals se publican aquí en .locals, y luego source: se evalúa con respecto a ellos.
- Asignación de valores (valuesMapping): todos los pilares + .source; .workload ausente.
- Síntesis del Workload (evaluación de workload): todos los pilares + .source; .workload en evaluación (ausente de la autorreferencia).
- Evaluación de artefactos (artifacts): todos los pilares + .source + .workload (contexto más completo).
Tipo de nivel superior: object
Propiedades
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
context | object | sí | El contexto de ejecución ensamblado por el compilador que proporciona datos de identidad, topología y entrega. |
values | object | sí | La carga útil cognitiva opaca de este nodo, ya validada por el validador de esquemas en la resolución. Se transmite sin cambios. |
infra | object | sí | La carga útil de dimensionamiento físico inyectada desde la Release para este nodo. Omite por completo al desarrollador. |
locals | mapa de string | sí | El estado privado propio de la Recipe (p. ej., primary_compute, volumes_path). Se evalúa en el preámbulo de locals — antes de los provides de ese nodo — y se publica en este pilar en la resolución de la fuente. Cada entrada es una plantilla Go evaluada con respecto a un contexto autónomo local al nodo que lleva las entradas del mismo bloque resueltas hasta el momento, de modo que una entrada PUEDE leer una hermana definida ENCIMA de ella y recibe el valor resuelto de esa hermana. El orden del autor forma parte del contrato siempre que una entrada lee otra: mover una definición debajo de quien la lee rompe la compilación. Una referencia ‘.locals. |
provides | mapa de string | no | El contrato de API pública de la Recipe. Se rellena a partir de la evaluación de provides. Disponible en el valuesMapping del renderizado base para la autorreferencia (p. ej., {{ .provides.host }}). NO disponible dentro de la propia plantilla de provides (el invariante de autocontención de provides). Los llamadores resuelven las claves de inject con respecto a estos valores. |
features | mapa de template_attachment | no | Cada vinculación en este nodo, indexada por el nombre de instancia que le dio el autor. Un solo pilar las lleva todas, sea lo que sea lo que produzcan — una Feature operativa, una Feature de credenciales, una Feature de identidad — porque lo que difiere entre vinculaciones es lo que producen, no cómo las lee una plantilla. Una Recipe las lee para adaptar su renderizado a las capacidades vinculadas y para consumir lo que publica una vinculación. Una vinculación escrita en una de las conexiones del nodo no está entre ellas: se lee bajo esa conexión, en .context.uses. |
metadata | object | no | Metadatos de la Release y de la compilación que proporcionan una identidad global para una nomenclatura determinista. Disponibles en todos los bloques de plantilla (valuesMapping, injectMapping, pipeline with). |
attachment_name | string | no | Solo se rellena al renderizar una FeatureRecipe de vinculación. Contiene el nombre de instancia de la vinculación — el slot que ocupa en el featuresSchema de la entidad propietaria, o el nombre libre que le dio el autor (p. ej., ‘admin_password’, ‘db_credentials’). Se usa para construir nombres de recursos deterministas que difieren por vinculación, compuestos después del nombre del componente host: ’{{ .context.rendered_name }}-{{ .attachment_name | replace ”_” ”-” }}’ donde el proveedor del host informa un nombre renderizado, como hace helm — el nombre del host escrito con los caracteres que permite un nombre de Kubernetes, con los guiones bajos del nombre de la vinculación convertidos en guiones — y ’{{ .context.instance_id }}-{{ .attachment_name }}’ donde el proveedor del host no informa ninguno. |
inject | object | no | Solo se rellena al renderizar una FeatureRecipe de vinculación que lleva un bloque inject escrito por el autor (p. ej., { env: [ { in: ‘OPENAI_API_KEY’, from: ‘api_token’ } ] }). Distinto de .context.inject, que es la tubería de entrega prehidratada del componente base procedente de las aristas uses. Se evalúa como null/ausente para vinculaciones sin inject escrito por el autor y para Recipes base. |
inject_raw | object o null | no | La intención inmutable y no mutada del desarrollador para el bloque inject. Cada mecanismo que nombra el bloque — env, file, arg o uno personalizado como ssm_param — está bajo su propio nombre y contiene las entradas exactamente como están escritas (in, con from o value), en el orden escrito, así que .inject_raw.ssm_param lee un mecanismo personalizado del mismo modo que .inject_raw.env lee uno básico. Se evalúa como null si el desarrollador omitió por completo el bloque inject. La usa Ops para comprobaciones lógicas (p. ej., {{ if not .inject_raw }}) para detectar la omisión antes de las mutaciones de la asignación de inject. Qué values o provides propios del componente entrega cada entrada se lee en .context.self_inject y no a partir del texto de las entradas. |
steps | mapa de object | no | Comunicación entre pasos de la pipeline. Solo disponible dentro de los bloques ‘with:’ de una pipeline Wasm. Cada clave es el ID de un paso de la pipeline, que contiene las salidas exportadas por ese paso. |
source | string o object o null | no | Contenido resuelto del campo source. En las plantillas de una Recipe: se rellena en la resolución de la fuente a partir del campo source: de la Recipe tras la evaluación de la plantilla Go, está disponible desde la asignación de valores en adelante (valuesMapping, workload, artifacts) y es null cuando la Recipe no tiene source:. En las plantillas de una FeatureRecipe: el propio campo source: de la FeatureRecipe tras la evaluación de la plantilla Go, evaluado antes de su valuesMapping y leído allí y en cada plantilla evaluada después (omits, workload, artifacts, pasos del pipeline), nunca el del componente host; null cuando la FeatureRecipe no tiene source:. El injectMapping de una FeatureRecipe se evalúa antes que su fuente y lee la del componente host. Forma de cadena = ruta URI; forma de objeto = fuente estructurada (p. ej., descriptor OCI con versión resuelta). |
workload | workload-v1beta1.schema.json o null | no | Especificación del Workload analizada para este nodo. Se rellena en la síntesis del workload a partir del campo workload: de la Recipe tras la evaluación de la plantilla Go + la validación JSON Schema del Workload (con respecto a workload-v1beta1.schema.json). Disponible desde la evaluación de artefactos en adelante (artifacts), para que los artefactos puedan hacer referencia a campos del workload sin duplicación (p. ej., un ServiceMonitor que lee .workload.services.metrics.ports.prom). Se evalúa como null cuando la Recipe no tiene un bloque workload:. Los intentos de una plantilla de desreferenciar .workload.* sobre un valor null fallan con un error claro en el momento de la evaluación de la plantilla. |
boundary | object | no | Contexto con ámbito de límite — rellenado solo al evaluar una plantilla que una FeatureRecipe cuyo spec.executionScope es ‘boundary’ ejecuta una vez para el límite. Las FeatureRecipes con ámbito de Component no reciben este pilar; sus context.instance_id, context.inject, context.uses y el pilar .workload llevan en su lugar datos por componente. Las plantillas de una FeatureRecipe con ámbito de límite que se ejecutan para el límite reciben .boundary.* en lugar de esos pilares por componente; su injectMapping se ejecuta en el contexto de cada componente al que llega la vinculación, lee esos pilares por componente y no recibe este. |
No se permiten propiedades adicionales.
template-context.context
El contexto de ejecución ensamblado por el compilador que proporciona datos de identidad, topología y entrega.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
instance_id | string | sí | El ID absoluto aplanado del nodo actual (p. ej., ‘backend’, o ‘data-layer-zdmain-db’ para el componente main-db de la instancia de módulo data-layer), escrito en el alfabeto que cumple todo nombre de componente escrito por un autor. Determinista y estable entre compilaciones para el mismo Aggregate. Es el nombre de los recursos construidos para este nodo para los que ningún proveedor deriva un nombre — un conjunto de artefactos colocado desde la Recipe, y un workload sintetizado por un proveedor que lo nombra según la identidad —, de modo que una dirección publicada para uno de ellos se construye a partir de este valor. |
rendered_name | string | no | El nombre que el proveedor enlazado a este nodo da a los recursos que renderiza para el nodo — para un origen que aportó el autor, el nombre con respecto al cual se renderizan las propias plantillas aportadas, como el nombre de release que lee un chart; para un workload que sintetiza, el nombre que da a los recursos de ese workload cuando deriva uno en lugar de escribir la identidad del nodo, como hace el proveedor helm con el mismo nombre de release. Léelo dondequiera que esta Recipe nombre un recurso que declaró un chart o un módulo aportado o que sintetizó un proveedor de ese tipo, ya sea en una entrada de provides, un valuesMapping, un workload, una entrada de artifacts o el with o el when de un paso de pipeline, porque el proveedor puede escribir ese nombre en un alfabeto más pobre que aquel en el que se escribe un nombre de componente escrito por un autor, y entonces ambos difieren. Vacío cuando el proveedor enlazado no deriva ningún nombre de ese tipo: los recursos de un conjunto de artefactos colocado, y de un workload sintetizado por un proveedor que lo nombra según la identidad, llevan la identidad del nodo, así que para ellos lee ’{{ .context.instance_id }}’, y una Recipe que escribió sus propios nombres de recursos ya los conoce. Leer esta clave donde el proveedor enlazado no informa ningún nombre detiene la compilación e indica qué escribir en su lugar. El rechazo cubre las plantillas que una Recipe escribe en línea; un valuesMapping, un workload o una entrada de artifacts aportados mediante ‘$import’ se resuelven solo cuando el renderizado los alcanza, de modo que una referencia dentro de uno de ellos se renderiza como un valor vacío en lugar de detener la compilación. En las plantillas de una FeatureRecipe enlazada a la vinculación de un componente, es el nombre del componente HOST tal como lo informa el propio proveedor del host — el valor que lee la propia Recipe del host, igual que instance_id es allí la identidad del host —, de modo que una vinculación lo usa para nombrar un recurso según su host y obtiene un nombre que la plataforma del host acepta. Donde el proveedor del host no informa ningún nombre, está vacío, y leerlo desde una plantilla en línea de la vinculación distinta de su injectMapping detiene la compilación; lee allí ’{{ .context.instance_id }}’ en su lugar. |
labels | mapa de string | no | Las etiquetas de duck-typing y de ontología del nodo actual, incluido cualquier cambio que un plugin de gobernanza vinculado en el rol label-transform haya hecho durante la construcción de la topología. |
annotations | object | no | Los tres contenedores de anotaciones en cascada del nodo actual, separados por origen. |
inject | object | sí | La tubería de entrega prehidratada e interceptada. Comienza como un mapa generado por el compilador que resuelve las claves inject del desarrollador a los valores provides del destino. Se modifica in situ mediante las fusiones profundas de injectMapping. Cuando la Recipe base se renderiza, contiene las cadenas físicas completamente resueltas. |
uses | mapa de enriched_edge | sí | El mapa enriquecido de aristas topológicas. Indexado por el alias del desarrollador (p. ej., ‘my_db’, ‘my_api’). Cada entrada es una vista ensamblada por el compilador de la identidad del nodo de destino, los provides resueltos, el mapeo de inyección y las anotaciones en cascada, y de las vinculaciones escritas en esa conexión — y, para una FeatureRecipe que declara readsTargetRenderFacts, de lo que informaron los renderizados del destino. NO es la arista IR en bruto — es una proyección enriquecida que construye el compilador específicamente para su uso en plantillas. Una plantilla que recorre este mapa ve las conexiones en orden de clave — ordenadas por alias —, no en el orden en que se escribieron. |
self_inject | object | sí | Cuáles de los values y provides propios del componente ya ha dotado el desarrollador de un nombre de entrega, leído del bloque inject: escrito en el propio componente — el bloque que .inject_raw contiene tal como está escrito y .context.inject contiene resuelto. Cada mecanismo que nombra el bloque (env, file, arg o uno personalizado como ssm_param) asigna cada nombre que escribió el desarrollador a la clave propia que entrega esa entrada, del mismo modo que .context.uses. |
used_by | inbound_edge[] | no | Los componentes que usan este: una entrada por cada conexión uses que otro componente establece hacia él, en el orden en que están escritos los componentes que se conectan y luego en el orden de las propias entradas uses de cada uno. Un componente que se conecta dos veces aparece dos veces. Solo lo lee una FeatureRecipe vinculada al componente, y solo en las plantillas que producen los propios recursos de la vinculación — su valuesMapping, workload y artifacts. Está ausente de las plantillas de la propia Recipe del componente, de un injectMapping y del with y el when de un paso de pipeline, porque la salida de cada uno de ellos puede acabar en la propia salida renderizada del componente, que sigue siendo la misma sea quien sea quien se conecte a él. Cada entrada es un elemento de lista en lugar de una clave, de modo que una plantilla que lo recorre encuentra a los llamantes en ese orden. |
render_facts | render_facts | no | Lo que el proveedor que renderizó este componente informó sobre la salida que emitió — los hechos de renderizado que informa —, indexado por nombre de hecho. Qué nombres informa un proveedor, y qué contiene cada entrada, es el contrato documentado propio de ese proveedor. Cada valor es una lista, incluso con una sola entrada, de modo que una plantilla siempre la recorre; cuando el renderizado del componente requirió más de una llamada al proveedor y varias de ellas informaron un mismo nombre, sus listas se unen en una sola en el orden en que se ejecutaron las llamadas. Presente en cada plantilla de una FeatureRecipe vinculada al componente — su valuesMapping, workload, artifacts y el with y el when de los pasos de pipeline — una vez que el componente se ha renderizado, y vacío donde su proveedor no informa nada, de modo que un nombre que nadie informó se lee como una lista vacía. Ausente de las plantillas de la propia Recipe del componente y de un injectMapping, que se ejecutan antes de que el componente se haya renderizado. |
No se permiten propiedades adicionales.
template-context.context.annotations
Los tres contenedores de anotaciones en cascada del nodo actual, separados por origen.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
release | mapa de string | no | Cadenas de topología física que descienden en cascada desde los límites de la Release. |
catalog | mapa de string | no | Rasgos intrínsecos inmutables escritos por el Platform Architect en el dominio 2. |
aggregate | mapa de string | no | Metadatos cognitivos que descienden en cascada desde los subsistemas del Aggregate. |
No se permiten propiedades adicionales.
template-context.context.inject
La tubería de entrega prehidratada e interceptada. Comienza como un mapa generado por el compilador que resuelve las claves inject del desarrollador a los valores provides del destino. Se modifica in situ mediante las fusiones profundas de injectMapping. Cuando la Recipe base se renderiza, contiene las cadenas físicas completamente resueltas.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
env | mapa de string | no | Entrega mediante variables de entorno. Las claves son los nombres de variables locales del desarrollador, los valores son las cadenas resueltas del destino. |
file | mapa de string | no | Entrega mediante montaje de archivos. Las claves son rutas de archivos locales, los valores son las cadenas resueltas del destino. |
arg | mapa de string | no | Entrega mediante argumentos de línea de comandos. Las claves son prefijos de flags, los valores son las cadenas resueltas del destino. |
all | mapa de string | no | Fusión plana precalculada de los mecanismos env + file + arg + personalizados. Se rellena tras la resolución de uses-inject y se recalcula tras el mapeo de inject. Las plantillas usan {{ toJson .context.inject.all }} para una serialización universal. |
template-context.context.self_inject
Cuáles de los values y provides propios del componente ya ha dotado el desarrollador de un nombre de entrega, leído del bloque inject: escrito en el propio componente — el bloque que .inject_raw contiene tal como está escrito y .context.inject contiene resuelto. Cada mecanismo que nombra el bloque (env, file, arg o uno personalizado como ssm_param) asigna cada nombre que escribió el desarrollador a la clave propia que entrega esa entrada, del mismo modo que .context.uses.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
env | mapa de string | no | Entrega mediante variables de entorno: las claves son los nombres de variable del desarrollador, los valores son la clave propia que entrega cada entrada. |
file | mapa de string | no | Entrega mediante montaje de archivos: las claves son las rutas de archivo del desarrollador, los valores son la clave propia que entrega cada entrada. |
arg | mapa de string | no | Entrega mediante argumentos de línea de comandos: las claves son los prefijos de flag del desarrollador, los valores son la clave propia que entrega cada entrada. |
template-context.metadata
Metadatos de la Release y de la compilación que proporcionan una identidad global para una nomenclatura determinista. Disponibles en todos los bloques de plantilla (valuesMapping, injectMapping, pipeline with).
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
release_name | string | no | El nombre de la Release que se está compilando (p. ej., ‘prod-billing’). Lo usa Ops para construir nombres de recursos en la nube únicos a nivel global (buckets de S3, roles de IAM). Se combina con .context.instance_id para garantizar la unicidad entre entornos. |
release_version | string | no | La versión semántica de la Release. |
environment | string | no | La cadena de entorno tomada de los metadatos de la Release (p. ej., ‘production’, ‘local’). |
aggregate_name | string | no | El nombre del Aggregate raíz que se está compilando. |
No se permiten propiedades adicionales.
template-context.inject
Solo se rellena al renderizar una FeatureRecipe de vinculación que lleva un bloque inject escrito por el autor (p. ej., { env: [ { in: ‘OPENAI_API_KEY’, from: ‘api_token’ } ] }). Distinto de .context.inject, que es la tubería de entrega prehidratada del componente base procedente de las aristas uses. Se evalúa como null/ausente para vinculaciones sin inject escrito por el autor y para Recipes base.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
env | mapa de string | no | Entrega mediante variables de entorno con ámbito de la vinculación. |
file | mapa de string | no | Entrega mediante montaje de archivos con ámbito de la vinculación. |
arg | mapa de string | no | Entrega mediante argumentos con ámbito de la vinculación. |
all | mapa de string | no | Fusión de conveniencia, generada por el compilador, de todos los paradigmas de inject de la vinculación. |
template-context.boundary
Contexto con ámbito de límite — rellenado solo al evaluar una plantilla que una FeatureRecipe cuyo spec.executionScope es ‘boundary’ ejecuta una vez para el límite. Las FeatureRecipes con ámbito de Component no reciben este pilar; sus context.instance_id, context.inject, context.uses y el pilar .workload llevan en su lugar datos por componente. Las plantillas de una FeatureRecipe con ámbito de límite que se ejecutan para el límite reciben .boundary.* en lugar de esos pilares por componente; su injectMapping se ejecuta en el contexto de cada componente al que llega la vinculación, lee esos pilares por componente y no recibe este.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
path | string | no | La ruta del límite de la Release al que está vinculada la FeatureRecipe: los nombres de los límites desde el más externo hacia dentro, unidos con ’/’ (p. ej., ‘bridge’, ‘bridge/frontend’). Nombra el límite, no el directorio en el que se escribe su salida, que fija el directory: del límite. |
assembly_path | string | no | El directorio, relativo al directorio de salida de la compilación, en el que se ensambla la propia salida de esta vinculación: el directory: y el subDirectory: evaluados de su límite, el directorio hacia el que la compilación encamina esa salida (p. ej., ‘bridge/compose’). Es igual al source_assembly_path o al target_assembly_path de un extremo de conexión exactamente cuando ese extremo se renderiza en el mismo archivo ensamblado, de modo que una FeatureRecipe los compara para distinguir una conexión dentro de su propio archivo de una en otro archivo. Datos opacos; el núcleo no los interpreta. |
boundary_name | string | no | El nombre del límite (la clave del mapa en release.spec.boundaries). |
components | object | no | Mapa de instance_id a una entrada por cada componente del subárbol del límite (recursivo, incluye los componentes de límites anidados). Cada entrada lleva el URI de tipo resuelto del componente, el ID de instancia y los valores proporcionados por la evaluación de provides por componente. |
internal_uses_edges | object[] | no | Aristas uses en las que el origen Y el destino están ambos en el subárbol de este límite. |
outgoing_cross_boundary_uses_edges | object[] | no | Aristas uses cuyo origen está en el subárbol de este límite y cuyo destino está fuera de él. |
incoming_cross_boundary_uses_edges | object[] | no | Aristas uses en las que el destino está en el subárbol y el origen fuera. Las usan los agregadores de tipo ingress que necesitan saber quién llama desde fuera. |
cross_boundary_uses_edges | object[] | no | Unión de conveniencia de las aristas salientes y entrantes que cruzan el límite. |
labels | mapa de string | no | Unión de las etiquetas de los componentes del subárbol, conservando el orden del autor. |
annotations | mapa de string | no | Las propias anotaciones del límite después de que se resuelve la cascada. |
feature_attachments | template_attachment[] | no | Las vinculaciones hechas directamente sobre este límite (para referencias entre vinculaciones dentro del ámbito del límite), en la misma forma de vinculación que lleva .features. |
No se permiten propiedades adicionales.
Definiciones
inbound_edge
Una conexión que otro componente establece hacia el componente para el que renderiza una FeatureRecipe vinculada: quién se conecta, a través de qué socket, qué publica el componente que se conecta, y el namespace y el límite en los que está colocado. Cada valor es una cadena que el compilador lleva sin interpretarla.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
component_id | string | sí | El ID de instancia aplanado del componente que se conecta (p. ej., ‘frontend’ o ‘data-layer.etl’) — el valor que una plantilla de ruta subDirectory lee como .component_id, escrito como .context.uses. |
socket | string | sí | La categoría de usesSchema a través de la cual el componente que se conecta traza esta conexión (p. ej., ‘databases’, ‘apis’). |
provides | mapa de string | sí | Los provides resueltos del componente que se conecta, restringidos a las claves que declara su Component — los mismos valores que un consumidor de ese componente lee en .context.uses. |
source_namespace | string | no | El namespace en el que está colocado el componente que se conecta: la anotación aggrega.ai/namespace que recibe su propio renderizado — las anotaciones de sus límites, con las anotaciones de su propia entrada en la Release aplicadas en último lugar, de modo que un componente cuya entrada establece o borra el namespace lleva su propio ajuste en lugar del de su límite. Es el valor que una FeatureRecipe con ámbito de límite lee como source_namespace en la entrada de la misma conexión en las listas de aristas uses de .boundary. Ausente cuando no se aplica ningún namespace al componente que se conecta; protégelo con if o with antes de imprimirlo. |
source_boundary_path | string | no | La ruta separada por barras del límite de la Release que contiene el componente que se conecta (p. ej., ‘edge’ o ‘aws-prod/payments’) — el valor que una FeatureRecipe con ámbito de límite lee como source_boundary_path en la entrada de la misma conexión en las listas de aristas uses de .boundary. |
render_facts | render_facts | no | Lo que los renderizados del componente que se conecta informaron sobre la salida que emitieron, indexado por nombre de hecho: los hechos que informaron sus propias llamadas al proveedor, luego los de cada Feature vinculada a él que se renderizó con él, en el orden en que se renderizaron, con las listas que un nombre recibe de varias de ellas unidas en una sola en ese orden. Cada valor es una lista, incluso con una sola entrada, de modo que una plantilla siempre la recorre. Presente solo para una FeatureRecipe que declara readsCallerRenderFacts — cuyas vinculaciones se renderizan una vez que todos los componentes se han renderizado, de modo que el renderizado de cada llamante está completo —, y entonces en cada entrada, vacío para un llamante cuyos proveedores no informan nada. Ausente para cualquier otra FeatureRecipe. |
No se permiten propiedades adicionales.
render_facts
Hechos de renderizado indexados por nombre: lo que los proveedores que renderizaron un componente informaron sobre la salida que emitieron. Qué nombres informa un proveedor, y qué contiene cada entrada, es el contrato documentado propio de ese proveedor; el compilador no sabe nada de ninguno de los dos más allá de que cada valor es una lista. Una lista conserva el orden de sus entradas. Una entrada de objeto se lleva con sus claves en el orden en que el proveedor las escribió, y una plantilla que la recorre las encuentra en orden de clave, como ocurre con todo mapa con claves de este contexto.
Objeto de forma libre; los valores son any[].
template_attachment
Una vinculación tal como la lee una plantilla: la vista por instancia de una Feature vinculada. Cada vinculación expone los mismos campos independientemente de lo que produzca, de modo que .features.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
type | string | no | El URI de Feature del catálogo de la Feature vinculada. |
resolved_version | string | no | La versión de la Feature vinculada tras la resolución del Manifest — la versión realmente enlazada para esta compilación, leída como .features. |
labels | mapa de string | no | Las etiquetas de catálogo de la Feature vinculada, llevadas literalmente en el orden en que la Feature las declara — no se filtra, renombra ni despoja de prefijo nada, de modo que una plantilla lee exactamente lo que escribió el autor de la Feature. Permite a una plantilla bifurcarse según lo que es la Feature vinculada en lugar de según su nombre o su URI. Refleja .context.uses.if o recorre el mapa antes de acceder a una etiqueta individual. |
values | object | no | El propio pilar de intención del desarrollador de la vinculación, llevado literalmente desde la declaración de la vinculación. |
infra | object | no | El propio pilar de dimensionamiento operativo de la vinculación, llevado literalmente desde la declaración de la vinculación. |
provides | mapa de string | no | El contrato público resuelto de la FeatureRecipe enlazada a esta vinculación — el nombre del recurso emitido, su clave, una identidad y cualquier clave producida adicional —, expuesto al consumidor como .features. |
No se permiten propiedades adicionales.
enriched_edge
Una única arista topológica enriquecida que ensambla el compilador. Contiene la identidad resuelta del destino, los provides y las anotaciones en cascada.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
target | string | sí | El ID absoluto aplanado del nodo de destino (p. ej., ‘data-layer.main-db’). |
socket | string | sí | La categoría de usesSchema a la que pertenece esta arista (p. ej., ‘databases’, ‘apis’). |
source | string | no | El ID absoluto aplanado del nodo de origen (consumidor). Se rellena para las vistas con ámbito de límite que indexan las salidas por consumidor según el nodo consumidor. |
source_namespace | string | no | Anotación aggrega.ai/namespace en bruto del extremo de origen (vacía cuando está ausente). Se rellena solo para las vistas con ámbito de límite, igual que source; la propia entrada .context.uses de un componente la lleva vacía. Datos opacos para la resolución de la identidad de red de un proveedor; el núcleo no los interpreta. |
source_boundary_path | string | no | Ruta del límite del extremo de origen: la ruta separada por barras del límite de la Release que lo contiene (p. ej., ‘bridge/frontend’). Se rellena solo para las vistas con ámbito de límite, igual que source; la propia entrada .context.uses de un componente la lleva vacía. |
source_assembly_path | string | no | Ruta de ensamblado del extremo de origen: el directorio, relativo al directorio de salida de la compilación, en el que se ensambla su salida, compuesto a partir del directory: y el subDirectory: evaluados de su límite (p. ej., ‘bridge/compose’). Dos extremos con la misma ruta de ensamblado se renderizan en un único archivo ensamblado, y un extremo cuya ruta de ensamblado es igual a .boundary.assembly_path se renderiza en el archivo en el que se ensambla la propia salida de la FeatureRecipe que la lee. Una FeatureRecipe con ámbito de límite que coloca extremos en redes puede leerla como la red del extremo de origen cuando no se aplica ningún aggrega.ai/namespace. Se rellena solo para las vistas con ámbito de límite, igual que source; la propia entrada .context.uses de un componente la lleva vacía. Datos opacos; el núcleo no los interpreta. |
target_namespace | string | no | Anotación aggrega.ai/namespace en bruto del extremo de destino (vacía cuando está ausente). Se rellena solo para las vistas con ámbito de límite, igual que source; la propia entrada .context.uses de un componente la lleva vacía. Datos opacos para la resolución de la identidad de red de un proveedor. |
target_boundary_path | string | no | Ruta del límite del extremo de destino: la ruta separada por barras del límite de la Release que lo contiene (p. ej., ‘bridge/backend’). Se rellena solo para las vistas con ámbito de límite, igual que source; la propia entrada .context.uses de un componente la lleva vacía. |
target_assembly_path | string | no | Ruta de ensamblado del extremo de destino: el directorio, relativo al directorio de salida de la compilación, en el que se ensambla su salida, compuesto a partir del directory: y el subDirectory: evaluados de su límite (p. ej., ‘bridge/compose’). Un extremo cuya ruta de ensamblado es igual a .boundary.assembly_path se renderiza en el archivo en el que se ensambla la propia salida de la FeatureRecipe que la lee. Una FeatureRecipe con ámbito de límite que coloca extremos en redes puede leerla como la red del extremo de destino cuando no se aplica ningún aggrega.ai/namespace. Se rellena solo para las vistas con ámbito de límite, igual que source; la propia entrada .context.uses de un componente la lleva vacía. Datos opacos; el núcleo no los interpreta. |
provides | mapa de string | sí | El diccionario provides completamente resuelto del nodo de destino. Se evalúa en la evaluación de provides, antes de la hidratación de inject. |
inject | object | sí | El mapeo inject original del desarrollador para esta arista (claves = nombres de variables locales, valores = claves provides del destino). Este es el mapeo EN BRUTO, no los valores resueltos. |
labels | mapa de string | no | Las etiquetas de duck-typing y de ontología del nodo de destino (tras los cambios hechos durante la construcción de la topología). |
annotations | object | no | Los tres contenedores de anotaciones en cascada del nodo de destino. |
component | string | no | El URI del tipo de componente del catálogo del nodo de destino (p. ej., ‘core/postgres’). |
resolved_version | string | no | El SemVer resuelto del nodo de destino. |
boundary_path | string | no | La jerarquía espacial física del nodo de destino tomada de la Release (p. ej., ‘aws-eks-cluster/backend-ns’). |
origin_feature | string | no | Si esta arista fue declarada de forma autónoma por una Feature (incluidas las Features de credenciales etiquetadas con feature.aggrega.ai/kind: secret), el nombre de instancia de la Feature. Null/ausente para las aristas declaradas por el desarrollador. |
origin_release | booleano | no | Es true cuando fue la Release la que cableó esta conexión en lugar de declararla el Aggregate. Ausente para una conexión que declara el Aggregate. |
values | object | no | La configuración del desarrollador por conexión escrita en la entrada uses del Aggregate para esta conexión, llevada literalmente. Ausente cuando la conexión no lleva ninguna. Solo llega al contexto del nodo consumidor, nunca al del destino. |
infra | object | no | La configuración operativa por conexión escrita en la entrada uses de la Release para esta conexión, llevada literalmente. Ausente cuando la conexión no lleva ninguna. Solo llega al contexto del nodo consumidor, nunca al del destino. |
features | mapa de template_attachment | no | Las vinculaciones escritas en esta conexión, indexadas por el nombre de slot que el socket de la conexión declara para cada una, cada una en la forma de vinculación que lleva .features: su tipo, versión resuelta, etiquetas, values, infra y los provides resueltos de la FeatureRecipe enlazada a ella. Una Recipe lee la credencial de una conexión como .context.uses. |
render_facts | render_facts | no | Lo que los renderizados del destino informaron sobre la salida que emitieron, indexado por nombre de hecho, en la forma que lleva la entrada de un llamante en .context.used_by: los hechos que informaron sus propias llamadas al proveedor, luego los de cada Feature vinculada a él que se renderizó con él, en el orden en que se renderizaron, con las listas que un nombre recibe de varias de ellas unidas en una sola en ese orden. Cada valor es una lista, incluso con una sola entrada, de modo que una plantilla siempre la recorre. Presente solo en .context.uses para una FeatureRecipe que declara readsTargetRenderFacts — cuyas vinculaciones se renderizan una vez que todos los componentes se han renderizado, de modo que el renderizado de cada destino está completo —, y entonces en cada entrada, vacío para un destino cuyos proveedores no informan nada. Ausente para cualquier otra FeatureRecipe, del with y el when de un paso de pipeline, de las plantillas de la propia Recipe del componente y de las listas de aristas que lee una FeatureRecipe con ámbito de límite. |
No se permiten propiedades adicionales.
enriched_edge.inject
El mapeo inject original del desarrollador para esta arista (claves = nombres de variables locales, valores = claves provides del destino). Este es el mapeo EN BRUTO, no los valores resueltos.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
env | mapa de string | no | Entrega mediante variables de entorno: las claves son los nombres de las variables locales del consumidor y los valores son las claves provides del destino. |
file | mapa de string | no | Entrega mediante montaje de archivos: las claves son las rutas de archivo locales del consumidor y los valores son las claves provides del destino. |
arg | mapa de string | no | Entrega 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. |
enriched_edge.annotations
Los tres contenedores de anotaciones en cascada del nodo de destino.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
release | mapa de string | no | Cadenas de topología física procedentes de los límites de la Release del nodo de destino. |
catalog | mapa de string | no | Rasgos inmutables procedentes de la entidad del catálogo del nodo de destino. |
aggregate | mapa de string | no | Metadatos cognitivos procedentes de los subsistemas del Aggregate del nodo de destino. |
No se permiten propiedades adicionales.