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

Centinelas de error — referencia canónica

Cada detención fatal que emite el compilador nombra una condición, y cada condición lleva tres identificadores, porque reconocer una condición, anotarla y citarla son tres tareas distintas. El centinela es el valor de Go con el que errors.Is hace coincidir, que se obtiene llamando al accesor que exporta el paquete que lo declara: el identificador que reconoce el código Go. El código es la cadena con la que está registrada la condición: nombra la propia condición con palabras, y es lo que permanece fijo mientras evolucionan los paquetes de Go que la rodean — el identificador que anota un programa. El código corto es la letra E seguida de cuatro dígitos, lo bastante corto para leerlo en voz alta, escribirlo en una búsqueda o pegarlo en un informe: el identificador que cita una persona. Una condición, tres identificadores — haz coincidir el centinela para reconocer la condición desde Go, lee el código cuando necesites anotarla o usarla como clave, y resuelve un código corto en la tabla de todas las condiciones más abajo en esta página.

El diagnóstico orientado al usuario (el mensaje con prefijo catalogado en fatal-halts.md y error-translation.md) lleva el texto orientado al desarrollador; el centinela envuelto es aquello con lo que errors.Is hace coincidir en los consumidores programáticos.

Esta página es la vista del catálogo indexada por centinela. Los programadores que escriben gates de CI, integraciones de IDE o código de orquestación de compilaciones que necesita distinguir tipos de error hacen coincidir con los centinelas que se enumeran aquí mediante el predicado estándar errors.Is. Los autores que depuran una compilación leyendo el texto de error emitido suelen querer las vistas indexadas por mensaje — fatal-halts.md para los errores que detienen la compilación, warnings.md para la salida de avisos.

Cada fila de las tablas siguientes nombra un accesor — una función sin argumentos, exportada desde el paquete que nombra la tabla, que devuelve el centinela. Importar ese paquete y llamar al accesor es la superficie de integración admitida, y por eso las tablas escriben cada uno con sus paréntesis — la llamada es lo que produce un valor con el que errors.Is puede hacer coincidir, y el nombre sin ellos es una función y no un error:

import (
"errors"
"github.com/aggrega-ai/aggrega-cli/pkg/resolver"
)
if errors.Is(err, resolver.ErrParameterContractViolation()) {
// handle parameter contract violations
}

Los tres identificadores llevan su estabilidad por separado, y esa separación es la razón por la que una condición tiene los tres. Los accesores que se enumeran abajo son estables entre versiones de parche; los cambios de nombre o las eliminaciones se anuncian en la entrada del changelog de la versión que los introduce, y añadir un nuevo accesor dentro de un paquete es aditivo y no rompe las coincidencias existentes. Un código queda fijo una vez publicada su condición, así que es el identificador que conviene anotar dondequiera que una condición deba nombrarse de forma duradera: cambiar el nombre de un accesor no mueve el código con el que se registró su condición, y un código que hayas anotado sobrevive a una refactorización de la superficie de Go. Un código corto es el más duradero de los tres: un número se asigna una vez y luego queda fijo, y el número de una condición retirada permanece retirado en lugar de asignarse a otra condición, de modo que un código corto anotado en un informe antiguo sigue nombrando la condición que nombraba cuando se anotó. Esto se hace cumplir y no es solo una intención — una condición declarada con un número retirado se rechaza antes de que el compilador lea ninguna entrada, en cada ejecución — y cada número retirado se publica junto a los vigentes en la tabla de todas las condiciones. La columna de código de abajo lleva el código, y es el valor que lee un cliente del diagnóstico estructurado sin enlazar estos paquetes. Se publica en lugar de deducirse, porque no tiene por qué repetir la fila en la que está — un nombre reexportado informa del código de la condición a la que remite, y el código de una regla nombra la regla y no el accesor. La columna de mensaje es el texto literal que produce el centinela; el diagnóstico orientado al usuario antepone a ese texto un encabezado entre corchetes y la ubicación en el código fuente. Ese encabezado lleva el código corto de la condición, con la categoría de la ocurrencia al lado cuando la ocurrencia tiene una, como en [DEVELOPER_ERROR E0007] — para que un lector pueda resolver cualquiera de los dos de forma independiente: las categorías (DEVELOPER_ERROR / OPS_ERROR / CATALOG_ERROR / TRANSLATION_ERROR / FETCH_ERROR / POLICY_ERROR / TRUST_ERROR) se explican en error-translation.md, y los códigos cortos se resuelven en la tabla de todas las condiciones de esta página. Cuando un plugin generó la condición, el token del código está calificado por el plugin que la generó — [TRANSLATION_ERROR provider/example:1.0.0/E0007] — y el código corto es el segmento final; error-translation.md explica por qué está el calificador y por qué el segmento final es el que hay que resolver.

Leer el código de una condición

Un código nombra la condición y nada más, en kebab-case — parameter-contract-violation, lockfile-drift. No lleva ningún prefijo: ni el paquete que lo declara, ni la etapa que lo genera, ni una agrupación de ningún tipo. Así, un código sigue siendo el mismo cuando el compilador se reorganiza a su alrededor, y una condición generada en más de un punto de una compilación sigue teniendo un solo nombre. El nombre de cada condición es distinto por sí mismo, que es lo que hace innecesario el prefijo, y dos condiciones no pueden registrarse con un mismo código. Léelo de un error con CodeOf, de github.com/aggrega-ai/aggrega-cli/pkg/errors, que recorre la cadena de envoltorios como lo hace errors.Is, de modo que el código sobrevive a cuantos niveles hayan envuelto el error en su camino de vuelta hasta ti. Ese paquete se llama a su vez errors, así que un alias de importación lo mantiene separado de la biblioteca estándar:

package release
import (
"log"
aggregaerrors "github.com/aggrega-ai/aggrega-cli/pkg/errors"
"github.com/aggrega-ai/aggrega-cli/pkg/resolver"
)
// Load reads a Release and reports the code of whatever condition halted it.
func Load(path string) error {
_, err := resolver.LoadRelease(path)
if err == nil {
return nil
}
if code, ok := aggregaerrors.CodeOf(err); ok {
// code names the condition in words, such as parameter-contract-violation.
log.Printf("%s halted: %s", path, code)
}
return err
}

CodeOf también informa de si algún error de la cadena llevaba un código; una cadena que no lleva ninguno es un hecho sobre esa cadena y no un fallo. Si prefieres hacer coincidir la interfaz por tu cuenta, el mismo paquete la exporta como CodedError, y errors.As la encuentra en el mismo recorrido.

Un código viaja en un solo sentido. Es lo que informa una condición, nunca lo que la identifica ante una comparación: escribir la cadena en tu propio código te da una cadena, y no hay ningún camino de vuelta desde una cadena hasta el valor con el que errors.Is hace coincidir. Haz coincidir el centinela para reconocer una condición; lee el código para anotar una.

El código que aggrega imprime en un terminal es el corto, no este. Un diagnóstico de detención empieza con un encabezado entre corchetes que lleva el código corto de la condición, con la categoría de la ocurrencia al lado cuando la ocurrencia tiene una — [DEVELOPER_ERROR E0007], o [TRANSLATION_ERROR provider/example:1.0.0/E0007] cuando un plugin generó la condición y el código está calificado por el plugin que la generó, o [E0007] cuando el fallo no tiene ningún ámbito de responsabilidad al que dirigirte — y después la ubicación en el código fuente y el texto del mensaje catalogado en fatal-halts.md. El código descriptivo nombra la condición con palabras y es demasiado ancho para esa posición: en las condiciones más largas llenaría un terminal estrecho antes de que empezara el mensaje, y esa es toda la razón de que exista un segundo identificador compacto. Así que el token del que partir cuando solo tienes la salida impresa es el código corto, y se resuelve en la tabla de todas las condiciones más abajo en esta página: desde un número que puedes leer por teléfono llegas a la condición, a su accesor y al texto de su mensaje. aggrega explain <code> hace esa resolución en el terminal — acepta cualquiera de los dos códigos de la condición e imprime la condición junto con la entrada que documenta la corrección de autoría, y se describe en aggrega explain. Las vistas indexadas por mensaje en fatal-halts.md siguen siendo la manera de partir de la redacción en lugar de un identificador.

Donde un código sí sale de Go es en el diagnóstico estructurado que publica el daemon del compilador como servicio, como un campo code propio en cada entrada en lugar de algo incorporado al texto del mensaje — de modo que una extensión del editor, o cualquier otro cliente de ese protocolo, se ramifica según lo que informa una entrada sin enlazar estos paquetes y sin analizar texto. Esa única clave lleva un código que una máquina puede comparar, lo haya asignado quien lo haya asignado, y la entrada indica qué capa lo generó. Allí un código tiene tres orígenes, y el tercero es la razón por la que un código que puedes consultar en esta página no es por sí solo una señal de que algo falló:

  • El código de la condición que nombra un fallo, que es lo que cataloga esta página.
  • El código de clase de un aviso sobre la salida renderizada — unsupported-field es uno, y warnings.md lo describe. Se asigna allí donde se generó el aviso en lugar de registrarse como condición, así que no tiene ninguna fila aquí.
  • El código registrado de un aviso sobre los documentos que escribiste — un nombre a una edición de distancia de uno declarado, un parámetro que nada lee. Un hallazgo así nombra una condición con la misma forma que un fallo, así que su código está registrado y tiene una fila en esta página, y leer esa fila te dice de qué trata el hallazgo.

Así que el mismo código que leerías en una detención también puede llegarte de una compilación que terminó, llevado por un hallazgo que no cambió nada del resultado. Lo que separa ambos casos es el resultado que recibiste y la capa que nombra la entrada — nunca la forma del propio código, y nunca si se resuelve aquí. El campo se omite donde nada de lo que produjo la entrada asignó un código: un fallo que no nombra ninguna condición propia de Aggrega, y un aviso al que quien lo generó no asignó ninguno. aggrega serve documenta la forma de la entrada, la clave que nombra la capa y cuándo está presente el campo.

Un diagnóstico estructurado lleva los dos identificadores de una condición, y saber cuál es cuál marca la diferencia entre un identificador sobre el que puedes actuar y uno sobre el que no puedes. La clave code de arriba es para un programa: con guiones y nombrando la condición con palabras, para que una extensión que se ramifica según ella se lea como lo que significa, y es el valor que CodeOf informa en Go. La clave shortCode a su lado es para una persona — la letra E seguida de cuatro dígitos, el mismo token que un diagnóstico de detención imprime en su encabezado entre corchetes. Es lo que lees por teléfono, escribes en un cuadro de búsqueda o pegas en una incidencia, y es el token por el que está indexada la tabla de todas las condiciones.

Ninguno es la forma abreviada del otro, y ninguno es un respaldo del otro. Haz coincidir según el código descriptivo; muestra a un lector el corto. Una superficie que ofreciera solo el código descriptivo le daría a un autor un identificador pensado para una comparación, y una que hiciera coincidir según el código corto lo haría con un número que no dice nada de la condición — y por eso viajan los dos en lugar de elegir uno.

Una tercera clave, codeDescription, indica dónde está publicada la condición, como una referencia que abrir para saber más sobre el diagnóstico. Su dirección lleva a la tabla de todas las condiciones de esta página, de modo que un lector que la sigue desde un editor llega con el código corto en la mano, el mismo por el que está indexada la tabla. Una entrada lleva el código corto y la referencia juntos, o ninguno de los dos: ambos están presentes exactamente donde la entrada nombra una condición registrada — una con una fila en esa tabla — y ambos faltan donde el código nombra una clase de aviso o la identidad de una regla de convenciones de un linter propio que Aggrega no declara, porque para esos no hay ningún número que citar ni nada aquí que los describa.

En el otro sentido — desde un código que tienes en la mano hasta la condición que nombra — las tablas siguientes son la lista publicada. Cada fila lleva el código junto al accesor que produce la misma condición en Go, de modo que un código leído de un diagnóstico estructurado se resuelve en un nombre con el que puedes hacer coincidir y en el texto que produce la condición. Las tablas cubren las condiciones cuyo accesor puedes importar, y dos tipos de código quedan fuera de ellas: un código de clase, que nombra una clase de aviso en lugar de una condición y por eso no tiene ningún accesor que poner a su lado, y un código cuya condición solo se declara en un paquete que no puedes importar y no se reexporta en ninguna parte, donde no hay ningún nombre comparable que poner a su lado. Ese segundo tipo sigue nombrando una condición, y esa condición sigue teniendo un código corto — la tabla de todas las condiciones, más abajo en esta página, está indexada por el código corto en lugar de por un nombre importable, así que también cubre esas.

La superficie comparable, por paquete que declara

Cada sección siguiente es un paquete que puedes importar. Su encabezado es la ruta del paquete relativa a la ruta del módulo github.com/aggrega-ai/aggrega-cli, de modo que la sección titulada pkg/resolver se importa como github.com/aggrega-ai/aggrega-cli/pkg/resolver.

Las entradas se agrupan por el paquete que declara el centinela, porque ese es el paquete que importa quien hace la comparación. En qué punto de una compilación se genera la condición es otra cuestión, y una que esta página deliberadamente no responde: un mismo centinela se genera a menudo desde varios lugares, y varios se generan solo desde código que el módulo no exporta, así que ninguna respuesta por entrada sería cierta para todas las filas. Las vistas indexadas por mensaje responden a la pregunta de cuándo en una compilación en términos que puedes observar — fatal-halts.md por encima de todo.

Algunos nombres aparecen en más de un paquete. Son reexportaciones de un único valor compartido y no dos condiciones, así que hacer coincidir con cualquiera de los dos nombres funciona; las tablas lo indican donde ambos nombres son importables. Ambas filas llevan el mismo código, que es el mismo hecho expresado en el identificador que tiene un cliente fuera de Go: una condición, un código, por muchos nombres que lleguen a ella.

pkg/catalog

CentinelaCódigoMensaje
ErrAllVersionsRetracted()all-versions-retractedevery published version this reference could select has been withdrawn
ErrAmbiguousImporterPlugin()ambiguous-importer-pluginformat is advertised by more than one importer plugin
ErrAmbiguousParserPlugin()ambiguous-parser-pluginformat is advertised by more than one parser plugin
ErrAmbiguousProviderPlugin()ambiguous-provider-plugincapability is served by more than one provider plugin; add a plugins.providers entry to select one
ErrAmbiguousTypeMapping()ambiguous-type-mappingmanifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous
ErrDuplicateEntityIdentity()duplicate-entity-identityduplicate entity identity within a single catalog directory
ErrImporterVersionUnsatisfiable()importer-version-unsatisfiableno importer plugin version satisfies the plugins.importer entry's version pin
ErrManifestImplementsMismatch()manifest-implements-mismatchmanifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type key
ErrNameMappingMatchedNothing()name-mapping-matched-nothinga Manifest name mapping's key names no component instance or attachment in this build, so the entry binds nothing
ErrNoImporterForFormat()no-importer-for-formatno importer plugin advertises the requested format
ErrNoParserForFormat()no-parser-for-formatno parser plugin advertises the requested format
ErrNoRecipeResolved()no-recipe-resolvedno recipe resolved for component/feature instance: add an explicit Manifest mapping for its type
ErrProviderBindingCapabilityUnserved()provider-binding-capability-unservedplugins.providers entry names a capability no provider-rendering plugin the build reads serves
ErrProviderBindingUnsatisfied()provider-binding-unsatisfiedplugins.providers entry names a plugin no provider-rendering plugin serving the capability matches
ErrProviderVersionUnsatisfiable()provider-version-unsatisfiableno provider-rendering plugin version satisfies the recipe's provider version pin
ErrQualifiedPluginReference()plugin-reference-must-not-be-registry-qualifiedwasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path
ErrUnknownCatalogDocumentKind()unknown-catalog-document-kindcatalog document declares a kind a catalog does not hold
ErrUnsatisfiableEntityVersion()unsatisfiable-entity-versionno catalog version satisfies the referenced version constraint
ErrUnscopedPluginReference()plugin-reference-must-be-scopedwasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location
ErrUnscopedRecipeReference()recipe-reference-must-be-scopedrecipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location
ErrUnusableSchemaImport()unusable-schema-importa schema `$import:` could not be applied
  • ErrManifestImplementsMismatch() es el mismo valor que pkg/resolver.ErrManifestImplementsMismatch(), así que hacer coincidir con cualquiera de los dos nombres funciona.

pkg/closure

CentinelaCódigoMensaje
ErrInvalidLibraryRef()invalid-library-refresolve: invalid library reference URI
ErrMVSConflict()version-selection-conflictresolve: minimal version selection conflict — incompatible library version requirements
ErrNoAggregateLoader()catalog-cannot-load-sub-aggregate-bodiesresolve: catalog lookup cannot load resolved sub-aggregate bodies
ErrNoRecipeLoader()catalog-cannot-load-recipe-bodiesresolve: catalog lookup cannot load resolved recipe and plugin bodies
ErrSourceTemplateAtLockTime()source-template-at-lock-timeresolve: source-template evaluation failure at lock time
ErrSourceTemplateParse()source-template-not-parsableresolve: source-template parse error
ErrSourceTemplateProvidesRef()source-template-provides-refresolve: source-template references .provides (invalid reverse reference)
ErrSubAggregateDepth()sub-aggregate-depthresolve: sub-aggregate inclusion depth exceeded
ErrUnresolvableURI()unresolvable-uriresolve: no entity in the catalog matches this URI

pkg/compactform

CentinelaCódigoMensaje
ErrAmbiguousDispatch()ambiguous-dispatchcompactform: ambiguous dispatch — $mode required
ErrCircularRef()reference-cyclecircular reference expansion
ErrConstraintTypeMismatch()constraint-type-mismatchcompactform: constraint not valid for declared type
ErrEscapeContentInvalid()escape-content-invalidcompactform: $jsonschema content invalid
ErrHostInLibraryRef()host-in-library-refcompactform: cross-document $ref carries a registry host; reference the library by identity
ErrReferenceUnresolvable()reference-unresolvablecompactform: $ref unresolvable
ErrUnknownKeyword()unknown-keywordcompactform: unknown keyword
ErrUnresolvedSchemaLibraryRef()unresolved-schema-library-refcompactform: cross-document $ref target not found
  • ErrCircularRef() es el mismo valor que pkg/refcycle.ErrCycle(), así que hacer coincidir con cualquiera de los dos nombres funciona.

pkg/deprecation

CentinelaCódigoMensaje
ErrDeprecatedEntity()deprecated-entitydeprecation: build consumes a deprecated entity

pkg/docscache

CentinelaCódigoMensaje
ErrFetchNotFound()fetch-not-foundoci: artifact not found at remote source
ErrNotDocsBundle()not-docs-bundledocscache: artifact is not a documentation bundle
ErrPageNotFound()page-not-founddocscache: page not found in documentation bundle
  • ErrFetchNotFound() es el mismo valor que pkg/oci.ErrFetchNotFound(), así que hacer coincidir con cualquiera de los dos nombres funciona.

pkg/egress

CentinelaCódigoMensaje
ErrNoAnswerInTime()no-answer-in-timeegress: the server did not answer in time
ErrOfflineEgress()offline-egressegress: network access refused because the workspace is offline; remediation: pass `--offline=false` to allow the network for this one run, or clear the top-level `offline` key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run `aggrega pull --release <release>` from a connected environment first to populate the cache

pkg/externalinputs

CentinelaCódigoMensaje
ErrAcquisitionDisabled()acquisition-disabledexternalinputs: acquisition is disabled for unpinned inputs
ErrDigestMismatch()digest-mismatchexternalinputs: fetched bytes mismatch the pinned digest
ErrSchemeNotAllowed()scheme-not-allowedexternalinputs: URL scheme is not allowed
ErrStoreCorrupt()store-corruptexternalinputs: store blob mismatches its pinned record

pkg/lockfile

CentinelaCódigoMensaje
ErrLockfileDrift()lockfile-driftlockfile: out of date; it no longer matches what its Release resolves to
ErrLockfileInvalid()lockfile-invalidlockfile: file failed schema validation
ErrSignatureNotRecorded()signature-not-recordedsigning: no verified signature is recorded for an artifact that requires one

pkg/oci

CentinelaCódigoMensaje
ErrAmbiguousContentLayer()ambiguous-content-layeroci: manifest has multiple layers of the expected content media type
ErrBundleAmbiguousEntityDocument()bundle-ambiguous-entity-documentoci: published bundle carries more than one entity document
ErrBundleNoEntityDocument()bundle-no-entity-documentoci: published bundle carries no entity document
ErrBundleUnreadable()bundle-unreadableoci: published bundle cannot be unpacked
ErrCacheLocationOutsideCache()cache-location-outside-cachea value a cache location is built from would place cached files outside the place it names in the cache
ErrCachedManifestIntegrity()cached-manifest-integrityoci: cached manifest digest mismatch
ErrFetchIntegrity()fetch-integrityoci: content digest mismatch
ErrFetchNetworkUnreachable()fetch-network-unreachableoci: network unreachable
ErrFetchNotFound()fetch-not-foundoci: artifact not found at remote source
ErrFetchUnauthorized()fetch-unauthorizedoci: authentication required or failed
ErrImmutableTagConflict()immutable-tag-conflictoci: tag already published with different content
ErrNoContentLayer()no-content-layeroci: manifest has no layer of the expected content media type
ErrOCILocationCollision()oci-location-collisionoci: distinct catalog identities map to the same OCI repository location
ErrPublishedArtifactNotAnEntity()published-artifact-not-an-entityoci: published artifact is not an entity document
ErrReferrerDiscoveryUnavailable()referrer-discovery-unavailableoci: referrer discovery could not be completed
ErrRegistryTooBusy()registry-too-busyoci: the registry kept asking to slow down
ErrRetiredMediaType()retired-media-typeoci: artifact carries a media type this compiler no longer reads
ErrSignatureBundleDigestMismatch()signature-bundle-digest-mismatchcached signature bundle does not match its recorded digest
ErrSignatureForAnotherArtifact()signature-for-another-artifactsigning: the recorded signature was made for a different artifact
ErrUnknownEntityKind()unknown-entity-kindoci: unknown entity kind for mediatype dispatch

pkg/pathscope

CentinelaCódigoMensaje
ErrNameWindowsCannotHold()name-windows-cannot-holda name this operation writes holds a path segment Windows cannot hold as written

pkg/pluginpath

CentinelaCódigoMensaje
ErrPluginArtifactNotFound()plugin-artifact-not-foundplugin artifact not found on this machine
ErrPluginEntityNotFound()plugin-entity-not-foundplugin reference is not a Plugin entity

pkg/pluginstrust

CentinelaCódigoMensaje
ErrVerdictAttachmentNotConfigured()verdict-attachment-not-configureda plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role

pkg/plugintest

CentinelaCódigoMensaje
ErrCommandsMismatch()wasm-command-set-mismatchwasm: recorded command mirror does not match plugin describe()
ErrContractMismatch()wasm-contract-mismatchwasm: entity contract claim does not match plugin describe()
ErrHostFunctionsMismatch()wasm-host-function-set-mismatchwasm: stamped host-function record does not match .wasm imports
ErrRejected()wasm-manifest-rejectedwasm: plugin rejected by the sandbox
ErrTypeMismatch()wasm-plugin-type-mismatchwasm: declared plugin type does not match plugin describe()

pkg/readscope

CentinelaCódigoMensaje
ErrReadLeadsOutOfWorkspace()read-leads-out-of-workspacea file this operation reads leads through a link out of the directory it must stay inside
ErrReferenceLeadsOutOfWorkspace()reference-leads-out-of-workspacea reference a document makes to another file leads out of the directory it must stay inside

pkg/recipepin

CentinelaCódigoMensaje
ErrEntityNotPinned()entity-not-pinnedan input the entity reads has no pin recorded for it in the entity.lock beside it
ErrLocalSourceContentMismatch()local-source-content-mismatchthe files of the entity's local source do not match the pins recorded for them in entity.lock

pkg/refcycle

CentinelaCódigoMensaje
ErrCycle()reference-cyclecircular reference expansion

pkg/registrytrust

CentinelaCódigoMensaje
ErrMalformedTrust()malformed-trust-policyregistrytrust: advertised trust config is malformed
ErrNoTrustAdvertised()no-trust-advertisedregistrytrust: registry advertises no trust config
ErrOfflineRegistrationWithoutTrustPolicy()offline-registration-without-trust-policya registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with `aggrega registry add <host> --identity <identity>=<issuer>` or `--key <public-key-file>`

pkg/resolver

CentinelaCódigoMensaje
ErrAnnotationBindingPillarOverlap()annotation-binding-pillar-overlapannotation binding declares one path in both pillar lists
ErrAnnotationBindingTargetUnresolved()annotation-binding-target-unresolvedannotation binding does not resolve against its target Feature
ErrAnnotationScalarNotRoutable()annotation-scalar-not-routablea scalar annotation value does not route to exactly one path of its binding
ErrAnnotationSidePillarMismatch()annotation-side-pillar-mismatchannotation routes through a pillar its authoring side may not use
ErrAnnotationSubkeyNotBound()annotation-subkey-not-boundannotation subkey is not routed by the annotation's binding
ErrAnnotationSubkeyNotConforming()annotation-subkey-not-conformingannotation subkey does not conform to the target Feature's schema at the routed pillar
ErrAttachmentInjectValue()attachment-inject-valueinject entry on an attachment carries `value:`; an attachment delivers the keys its FeatureRecipe publishes, each named with `from:`, and a literal belongs in the component's own inject block
ErrAttachmentSlotNearMiss()attachment-slot-near-missattachment name is a near miss for a declared slot
ErrAttachmentSlotShape()attachment-slot-shapeattachment does not conform to its declared slot shape
ErrConnectionAttachmentSlotUndeclared()connection-attachment-slot-undeclareda connection carries an attachment under a name its socket declares no slot for
ErrDuplicateBoundaryComponent()duplicate-boundary-componentcomponent declared in more than one boundary: declare each component in exactly one boundary
ErrDuplicateTriadIdentity()duplicate-triad-identityduplicate Aggregate/Manifest identity (metadata.name) in the Release directory
ErrFeatureMergeConflict()feature-merge-conflictfeature merge conflict: reconcile the Aggregate and Release declarations for the feature
ErrGuardEntityViewInconsistency()internal-catalog-view-disagreementthe compiler's own views of the catalog disagree
ErrInheritedBoundaryDirectoryIsLiteral()inherited-boundary-directory-is-literalinherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to
ErrInjectDeliveryShape()inject-delivery-shapeinject delivery: shape must be a list of entries, each `in:` with exactly one of `from:` or `value:`
ErrInjectEntryAmbiguous()inject-entry-ambiguousinject entry carries both `value:` and `from:`; schema requires exactly one
ErrInjectKeyCollision()inject-key-collisionduplicate delivery key across inject sources
ErrInvalidInjectKey()invalid-inject-keyinvalid inject key: the from-key must name a provides key its source publishes
ErrInvalidParameterRef()invalid-parameter-refinvalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template
ErrMalformedRecipeReference()malformed-recipe-referencemalformed recipe reference in a Manifest mapping value
ErrManifestCrossBindingPillarCollision()manifest-cross-binding-pillar-collisionmanifest annotation bindings collide on same Feature path+pillar
ErrManifestImplementsMismatch()manifest-implements-mismatchmanifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type key
ErrManifestReservedPrefix()manifest-reserved-prefixmanifest annotation binding uses reserved prefix
ErrMisnamedSlotFill()misnamed-slot-fillattachment written under a name no slot declares fits a slot its component leaves empty
ErrMissingRequiredFeature()missing-required-featuremissing required feature: attach a Feature of the required type to the component
ErrMissingRequiredSocket()missing-required-socketrequired uses socket not populated
ErrParameterContractViolation()parameter-contract-violationparameter contract violated
ErrParameterMissing()parameter-missingrequired parameter not supplied
ErrProvidesKeyNotDeclared()provides-key-not-declaredRecipe publishes a provides key its Component does not declare
ErrReleaseChainComposesBothRoutingKeys()release-chain-composes-both-routing-keysrelease extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both
ErrSchemaConformance()schema-conformanceauthored pillar does not conform to its declared schema
ErrSchemaContractCompileFailure()schema-contract-compile-failuredeclared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation
ErrSelfInjectForbidden()self-inject-forbiddenself-inject on component without spec.inject allowlist
ErrTriadRefUnresolvable()triad-ref-unresolvableaggregate/manifest reference unresolvable
ErrUnknownUsesSocket()unknown-uses-socketunknown uses socket: name a socket the entity declares in its usesSchema — only a component's own uses block may name one the catalog did not declare
ErrUnnormalizedRelease()release-not-in-canonical-formrelease reached resolve un-normalized (non-empty root components alongside a synthesized default boundary)
ErrUnreadParameter()unread-parameterdeclared parameter is read by no reference in the Aggregate
ErrUsesInjectValue()uses-inject-valueinject entry on a connection carries `value:`; a connection delivers the target's published keys, each named with `from:`
ErrUsesSocketNearMiss()uses-socket-near-missuses socket name is a near miss for a declared socket
ErrVerdictPluginTrustMismatch()verdict-plugin-trust-mismatchthe digest recorded as trusted for this plugin does not match the digest its cached manifest reports
ErrYAMLLoad()document-not-loadablefile load failed: the file could not be read, or its bytes did not parse

pkg/signing

CentinelaCódigoMensaje
ErrKeylessLive()keyless-signing-requires-networksigning: keyless signing requires a live identity provider, Fulcio, and Rekor
ErrMixedSigningCredentials()mixed-signing-credentialssigning: the references named together need different signing credentials, so nothing was signed
ErrNoSignatureFound()no-signature-foundsigning: no signature found for an artifact that requires one
ErrNoTrustedIdentities()no-trusted-identitiessigning: keyless verification requires at least one trusted identity
ErrSignatureInvalid()signature-invalidsigning: signature does not verify
ErrSignatureVerificationFailed()signature-verification-failedsigning: signature bundle does not verify
ErrSigningPolicyRequiresSignature()signing-policy-requires-signaturesigning: signing policy requires a signature for this artifact kind; refusing to push unsigned content
ErrTrustRootLoad()trust-root-not-loadablesigning: cannot load pinned trust root
ErrUnsignedPushRefused()unsigned-push-refusedsigning: registry requires signatures; refusing to push unsigned content
ErrUnsupportedKey()unsupported-keysigning: unsupported held-key type
ErrUntrustedIdentity()untrusted-identitysigning: signature identity is not trusted for this registry

pkg/sourcecache

CentinelaCódigoMensaje
ErrFetchIntegrity()fetch-integrityoci: content digest mismatch
ErrFetchNotFound()fetch-not-foundoci: artifact not found at remote source
  • ErrFetchIntegrity() es el mismo valor que pkg/oci.ErrFetchIntegrity(), así que hacer coincidir con cualquiera de los dos nombres funciona.
  • ErrFetchNotFound() es el mismo valor que pkg/oci.ErrFetchNotFound(), así que hacer coincidir con cualquiera de los dos nombres funciona.

pkg/sourcekind

CentinelaCódigoMensaje
ErrUnknownKind()unknown-source-kindno source adapter serves the source kind

pkg/sourceresolver

CentinelaCódigoMensaje
ErrFetchIntegrity()fetch-integrityoci: content digest mismatch
ErrFetchNetworkUnreachable()fetch-network-unreachableoci: network unreachable
ErrFetchNotFound()fetch-not-foundoci: artifact not found at remote source
ErrFetchUnauthorized()fetch-unauthorizedoci: authentication required or failed
ErrNoAdapterRegistered()source-adapter-not-registeredno source adapter is registered in this program for the source kind
  • ErrFetchIntegrity() es el mismo valor que pkg/oci.ErrFetchIntegrity(), así que hacer coincidir con cualquiera de los dos nombres funciona.
  • ErrFetchNetworkUnreachable() es el mismo valor que pkg/oci.ErrFetchNetworkUnreachable(), así que hacer coincidir con cualquiera de los dos nombres funciona.
  • ErrFetchNotFound() es el mismo valor que pkg/oci.ErrFetchNotFound(), así que hacer coincidir con cualquiera de los dos nombres funciona.
  • ErrFetchUnauthorized() es el mismo valor que pkg/oci.ErrFetchUnauthorized(), así que hacer coincidir con cualquiera de los dos nombres funciona.

pkg/sourceresolver/cacheslot

CentinelaCódigoMensaje
ErrEmptyWorkspaceRoot()empty-workspace-rootcacheslot: empty workspaceRoot

pkg/sourceresolver/netrc

CentinelaCódigoMensaje
ErrNetrcFileUnreadable()netrc-file-unreadablethe netrc file could not be read
ErrSourceURLCarriesCredential()source-url-carries-credentialthe source URL carries a credential

pkg/types

CentinelaCódigoMensaje
ErrArtifactEntryShape()artifact-entry-shapeartifacts entry: shape must be a string scalar or {$import: <local-path>}
ErrArtifactLibraryEntryShape()artifact-library-entry-shapeartifactlibrary: entry must be a mapping of filename to a string body
ErrForbiddenKeyword()forbidden-keywordschemalibrary: forbidden JSON Schema keyword
ErrLibraryReferenceWhitespace()library-reference-whitespacelibrary reference: a reference to a library entry carries no whitespace or line break
ErrMalformedVersionPin()malformed-version-pinreference carries a malformed version pin
ErrMappingEntryNotScalar()mapping-entry-not-scalarmappinglibrary: entry body must be a string scalar
ErrOrderedMapDecodeDepthExceeded()document-nesting-depth-exceededa document nests too many levels deep
ErrParametersShape()parameters-shapeparameters: shape must be an inline object or {$import: <local-path>}
ErrTemplateNotFound()template-not-foundschemalibrary: template not found
ErrTemplateParamMissing()template-param-missingschemalibrary: template parameter missing
ErrTemplateParamTypeMismatch()template-param-type-mismatchschemalibrary: template parameter type mismatch
ErrValuesMappingShape()values-mapping-shapevaluesmapping: shape must be a string scalar or {$import: <path-or-library-identity>}
ErrWellKnownAnnotationScope()well-known-annotation-scopewellKnownAnnotations: a key is declared at a scope the provider's contract does not render
ErrWorkloadEntryNotScalar()workload-entry-not-scalarworkloadlibrary: entry body must be a string scalar
ErrWorkloadTemplateShape()workload-template-shapeworkload: shape must be a string scalar or {$import: <path-or-library-identity>}

pkg/usesedge

CentinelaCódigoMensaje
ErrDanglingUsesTarget()dangling-uses-targetuses edge target does not exist
ErrReleaseEdgeRetarget()release-edge-retargetrelease edge retargets a developer-declared edge

pkg/validator

CentinelaCódigoMensaje
ErrAssertionNameCollision()assertion-name-collisionassertion name declared twice across the extends chain
ErrCyclicExtension()cyclic-extensioncyclic extends chain
ErrDuplicateContainerEnvironmentVariable()duplicate-container-environment-variablea container declares one environment variable twice
ErrEmptySource()recipe-source-is-emptyrecipe source is an empty string, which names neither sourceless mode nor sourced mode
ErrExtendsChainTooDeep()extends-chain-too-deepextends chain exceeds maximum depth
ErrFeatureRecipeValuesMappingRequiresSource()feature-recipe-values-mapping-requires-sourceFeatureRecipe: valuesMapping requires source
ErrInheritanceMerge()extends-merge-failedinheritance merge failed
ErrRecipeFilenameCollisionAcrossInputKinds()recipe-filename-collision-across-input-kindsfilename collision across input kinds: two input-kind blocks produced a file under one output name
ErrRecipeNoInputKind()recipe-no-input-kindRecipe: at least one input kind required
ErrRecipeOutputComponentLabelCollision()recipe-output-component-label-collisionrecipe output-component-labels constraint: key is also declared in outputLabels
ErrRecipeOutputLabelReservedNamespace()recipe-output-label-reserved-namespacerecipe output-labels constraint: key uses a reserved namespace
ErrRecipeValuesMappingRequiresSource()recipe-values-mapping-requires-sourceRecipe: valuesMapping requires source
ErrSlotNotReferenceable()slot-not-referenceableworkload attachment slot is not referenceable
ErrUnknownSchemaPillar()unknown-schema-pillara schema block declares a key that names no data pillar
ErrWorkloadFeaturesSchema()workload-features-schemaworkload featuresSchema cross-check failed
ErrWorkloadValidation()workload-not-validworkload validation failed

pkg/validator/envelope

CentinelaCódigoMensaje
ErrDuplicatePipelineStepID()duplicate-pipeline-step-ida pipeline declares one step id twice
ErrEntityEnvelope()entity-envelope-invaliddocument envelope validation failed
ErrRetiredABIVersion()retired-abi-versiona plugin declares a plugin ABI version this compiler no longer speaks
ErrRetiredAPIVersion()retired-api-versiona document declares an API version this compiler no longer reads

pkg/validator/jsonschema

CentinelaCódigoMensaje
ErrExtensionEval()schema-extension-evaluation-failedvalidator/jsonschema: x-aggrega extension evaluation failed
ErrSchemaResolve()schema-not-resolvablevalidator/jsonschema: schema resolution failed

pkg/validator/merger

CentinelaCódigoMensaje
ErrMergeInvalid()schema-merge-input-invalidmerger: invalid merge input

pkg/workspaceconfig

CentinelaCódigoMensaje
ErrAmbiguousRegistryAlias()ambiguous-registry-aliasregistry alias matches more than one host
ErrCapabilityOnCrossCuttingSocket()capability-on-cross-cutting-socketa cross-cutting socket is bound by capability but attaches by uri
ErrColonInProviderBindingCapability()colon-in-provider-binding-capabilitya provider socket binding names a capability containing a colon, which no Recipe can select
ErrConfigInvalid()workspace-config-invalidworkspace configuration is invalid
ErrDuplicateImporterAttachment()duplicate-importer-attachmentimporter is attached by more than one plugins.importer entry
ErrDuplicateProviderTarget()duplicate-provider-targetcapability is bound to more than one provider plugin
ErrDuplicateRegistryAlias()duplicate-registry-aliasregistry alias is already used by another host
ErrGovernanceRoleInvalid()governance-role-invalida governance attachment declares no role or an unknown role
ErrInertFieldOnProviderSocket()inert-field-on-provider-socketa provider socket binding sets a field with no referent on that socket

pkg/writescope

CentinelaCódigoMensaje
ErrWriteLeadsOutOfWorkspace()write-leads-out-of-workspacea path this operation writes or deletes leads through a link out of the directory it must stay inside

pkg/yamlpos

CentinelaCódigoMensaje
ErrPositionOutOfRange()position-out-of-rangeposition out of range

Centinelas que llevan otro centinela

ErrCacheMetadataInvalid (pkg/sourceresolver/metadata) notifica una ranura corrupta de la caché de artefactos fuente. Se declara como un envoltorio de ErrFetchIntegrity() en lugar de como una identidad propia, así que no aparece en las tablas anteriores y hacer coincidir con ErrFetchIntegrity() también funciona para él. Como envuelve un centinela en lugar de declarar uno, se exporta como un valor y no como una función: hazlo coincidir como ErrCacheMetadataInvalid, sin paréntesis. Haz coincidir con el envoltorio cuando quieras esa condición concreta, y con el centinela envuelto cuando quieras toda la clase de integridad.

Centinelas accesibles con un segundo nombre en un mismo paquete

Cuando un paquete exporta dos accesores para una condición — el segundo declarado como un reenvío al primero —, las tablas anteriores llevan el accesor que la declara y omiten el nombre que reenvía. Ambos nombres se exportan desde el mismo paquete, así que una importación que alcanza uno ya alcanza el otro, y una segunda fila listaría una condición dos veces con un nombre con el que no se hace coincidir nada nuevo. Hacer coincidir con cualquiera de los dos nombres funciona: el reenvío devuelve el mismo valor que devuelve el accesor que la declara.

Este no es el caso entre paquetes. Un centinela reexportado desde otro paquete tiene una fila en la tabla de cada paquete, porque quien hace la comparación importando uno de esos paquetes no puede alcanzar el nombre del otro sin importar también ese paquete; un reenvío dentro de un único paquete no necesita una segunda fila, porque una sola importación alcanza ambos nombres.

ErrDuplicateRecipeIdentity() en pkg/catalog es uno de esos reenvíos: devuelve ErrDuplicateEntityIdentity(), que es el nombre que lleva la tabla de ese paquete.

Condiciones sin un centinela comparable

Algunas etapas de la compilación declaran sus centinelas en paquetes que el compilador no exporta, así que no hay nada a lo que errors.Is pueda hacer referencia y no se puede escribir ninguna comparación contra ellos. Se describen aquí en lugar de tabularse, porque una tabla en esta página es la promesa de que la columna de la izquierda se puede desreferenciar.

Sus diagnósticos te llegan completos a través del texto de error emitido y de las vistas indexadas por mensaje — fatal-halts.md en particular —, que son la forma admitida de reconocerlos:

  • La construcción de la topología (construcción del grafo y aplanamiento de subagregados) notifica un sub-Aggregate que no se pudo cargar, nombrando la URI del Aggregate inalcanzable; una declaración uses: cuya forma estructural no coincide con el esquema; la superación de la profundidad de anidamiento; y una colisión de ID de nodo tras el aplanamiento, en la que dos sub-Aggregates se compilan en el mismo ID de nodo y hay que renombrar un nombre de instancia para desambiguar.
  • La finalización del grafo (fusión de Feature entre las superficies del Aggregate y de la Release) notifica un tipo de Feature declarado de forma incoherente entre ambas.
  • El análisis estático (evaluación de selectores y comprobaciones de seguridad de tipos entre nodos) notifica una infracción de selector:; un fallo de resolución en el catálogo que no le permite continuar, nombrando la entidad inalcanzable; y un rechazo por política, en el que un plugin vinculado a un rol de veredicto de gobernanza rechazó la compilación ensamblada. Un rechazo por política lleva la categoría POLICY_ERROR, el nombre del plugin que rechazó y el mensaje de regla que proporcionó el plugin.
  • El renderizado (distribución a los proveedores y renderizado por proveedor) notifica un proveedor desconocido.
  • El cargador host de Wasm integrado emite sus propios centinelas de salvaguarda — una salvaguarda de manifiesto rechazado (un plugin solicitó una capacidad de acceso en tiempo de ejecución que el cortafuegos de pureza AOT deniega), una recuperación de un pánico del invitado y una trampa determinista de salida del plugin. Estos aparecen en el diagnóstico orientado al usuario al ejecutar un plugin (por ejemplo, mediante aggrega lint). Los autores de Plugin que prueban un invitado contra el host alcanzan las mismas condiciones por nombre importable a través de pkg/plugintest, que se lista más arriba.

Para condicionar un pipeline específicamente a un rechazo por política, haz coincidir el prefijo de categoría POLICY_ERROR en el diagnóstico en lugar de un centinela; la categoría es una parte documentada de la superficie de errores, descrita en error-translation.md.

Cada condición, por código corto

La tabla siguiente hace la búsqueda en sentido contrario: un código corto en la columna de la izquierda y, a su lado, la condición que nombra ese código y el texto que produce esa condición. Cubre todas las condiciones que aggrega puede notificar, incluidas las que las secciones anteriores no pueden listar.

Esa cobertura más amplia es el propósito de esta tabla y no un accidente. Las secciones anteriores están indexadas por un nombre que puedes importar, así que una condición declarada solo en un paquete que no puedes importar — y que tampoco se reexporta en ningún lugar que puedas importar — no tiene nada que poner en su columna de la izquierda. Esta tabla está indexada por el código corto, y toda condición tiene uno, así que ninguna condición notificable queda fuera de ella. Un código corto que tienes en la mano se resuelve aquí, tenga o no la condición que hay detrás también un accesor con el que puedas hacer coincidir.

Lo que da a una condición un lugar en esta tabla es que el compilador pueda notificarla realmente. Las filas se derivan del código en lugar de transcribirse en él: una condición aparece aquí porque algo en el compilador la genera, así que todo código de la columna de la izquierda es uno que aggrega puede imprimir. Esa es la promesa que hace la tabla, y es lo que te permite leer una fila como una comprobación que se ejecuta de verdad.

La excepción deliberada es una condición declarada antes de que exista el código que la notifica, para que el código y la redacción queden fijados de antemano y nunca cambien bajo un lector que ya los ha citado. Una condición así lo indica en una nota justo debajo de la tabla. Se lista en lugar de ocultarse — un código que tienes en la mano siempre debería resolverse — y la nota a su lado te dice claramente que ninguna compilación la genera todavía, y qué tendría que existir antes de que alguna lo hiciera.

También se lista un número retirado, en su propio conjunto de notas debajo de la tabla, y sigue listado para siempre. De vez en cuando se suprime una condición — se sustituye por otra que abarca más terreno, o nada la notificó nunca — y desde ese momento su número queda retirado: nunca se asigna a una condición distinta, de modo que un código corto que citas de un informe antiguo solo puede nombrar lo que nombraba cuando se escribió el informe. Esa promesa es mecánica, no editorial. Una condición declarada con un número retirado se rechaza antes de que el compilador lea ninguna entrada, en cada ejecución, así que ninguna versión puede contener una — la misma clase de rechazo con la que se encontraría un número que dos condiciones vigentes intentaran compartir, redactado para que puedas saber con cuál de los dos casos te has topado. La nota de un código retirado te dice, donde el retiro lo anotó, qué nombraba el código y, donde la condición se sustituyó, qué código notifica ahora ese terreno.

No reutilizar nunca un número es también lo que da a la secuencia sus huecos permanentes, y las notas son lo que hace legibles esos huecos. Un número que falta no es por sí solo prueba de nada: puede estar retirado, e igualmente puede ser uno al que nada ha llegado todavía. Las notas dejan constancia de qué números están retirados y, donde se anotó, qué nombraba cada uno, así que un código que no se resuelve ni en una fila ni en una nota es uno que este compilador nunca ha emitido.

Un código corto es deliberadamente opaco: cuatro dígitos no dicen nada por sí solos sobre una condición, y ese es el precio de un identificador lo bastante corto para leerlo en voz alta, escribirlo en una búsqueda o pegarlo en un informe. La correspondencia de abajo es lo que lo hace utilizable. Un número se asigna una vez, a partir de una única secuencia ascendente, y queda fijo desde entonces; no dice nada de la condición que nombra. Así que un código corto es un identificador y nada más — su valor no es una clasificación, y ni él ni ninguna agrupación que puedas notar en la tabla es una guía de dónde reside una condición ni de qué trata.

La tabla no tiene ninguna columna de categoría, y no es un descuido: una categoría es una propiedad de un fallo concreto y no de la condición que hay detrás. Algunas condiciones pertenecen a una categoría por construcción. Para otras, la categoría se deriva del tipo de entidad del que trata el fallo, así que una condición de ese tipo notificada una vez sobre un Aggregate y otra vez sobre una Release lleva una categoría distinta cada vez — y un único valor escrito aquí junto a la condición sería incorrecto para todas las condiciones de ese segundo tipo.

Donde se explican las categorías es error-translation.md — cada una, qué significa y dónde se hace su corrección. Una categoría y un código corto responden a preguntas distintas sobre el mismo fallo: la categoría identifica la superficie a la que pertenece la corrección, y el código corto identifica qué condición detuvo la compilación. Ninguno se puede deducir del otro, por eso cada uno tiene su propia lista publicada — y por eso un fallo sin una superficie de autoría que nombrar sigue llevando un código que puedes consultar aquí.

CódigoCondiciónMensaje
E0001no-plugin-resolution-configuredcliplugin: no plugin resolver configured
E0003malformed-attachment-requirementmalformed attachment requirement
E0004overridden-annotationannotation contribution overridden by an explicit value
E0005policy-violationpolicy violation
E0006required-slot-unfilledrequired attachment slot unfilled
E0007selector-violationselector violation
E0008slot-selector-unsatisfiedattachment slot selector unsatisfied
E0009pipeline-contract-violationpipeline step typed-I/O contract violation
E0010pipeline-step-failedpipeline step failed
E0011pipeline-target-absentpipeline patch targets a document not present in the set
E0012pipeline-target-opaquepipeline patch targets an opaque (non-structured) unit
E0013feature-type-mismatchfeature type mismatch between Aggregate and Release
E0014inject-entry-ambiguousinject entry carries both `value:` and `from:`; schema requires exactly one
E0015uses-inject-forbiddenuses-edge inject dictates a delivery mechanism the socket does not permit
E0016patch-test-operation-failedjsonpatch: test operation failed
E0017annotation-injection-rejectedannotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys
E0018policy-settings-invalidpolicy attachment settings do not satisfy the plugin's declared settings schema
E0019endpoint-requires-reference-formendpoint requires form: reference
E0020invalid-cron-scheduleschedule is not a valid cron expression
E0021persistent-template-requires-stateful-formpersistentTemplate volume requires form: stateful
E0022pipeline-patch-target-not-structuredpipeline PATCH target is not parseable structured YAML/JSON
E0023reference-form-requires-endpointform: reference requires an endpoint
E0024schedule-requires-scheduled-formschedule requires form: scheduled
E0025scheduled-form-requires-scheduleform: scheduled requires a schedule
E0026artifact-content-mismatchimported artifact content does not match the digest recorded for it in entity.lock
E0027artifact-import-shapeartifacts $import: is not a bare-name artifact-library reference (<Library>#/artifacts/<entry>)
E0028artifact-output-collisionartifacts output filename collision: two artifact outputs carry the same filename
E0029artifact-pillar-not-declaredartifact template references a pillar the Recipe does not declare
E0030artifact-library-entry-not-foundartifact-library import references a bundle not present in the ArtifactLibrary
E0031artifact-library-not-foundartifact-library import references an ArtifactLibrary not present in the catalog
E0032assembled-output-collisionassembled output collision: two contributors write the same output path
E0033authored-assertion-failedassertion failed
E0034attachment-inject-key-collisionduplicate delivery key across attachment-inject and another inject source
E0035boundary-assembly-not-providedprovider expected to assemble its dispatch group provides no boundary assembler
E0036chart-name-mismatchmerged-path assembly has conflicting assembly-name annotation values
E0037cross-provider-link-unsupportedcross-boundary link between endpoints rendered by different providers is not supported
E0038derived-key-collisionderived name collision: one name is derived more than once in one key space
E0039featurerecipe-template-invalid-fieldFeatureRecipe template references a per-component-only field with executionScope: boundary
E0040host-in-library-importlibrary $import: carries a registry host; reference the library by bare-name identity
E0041instance-id-collisionmultiple contributors share an instance ID at the same dispatch path
E0042locals-forward-referencelocals entry references a sibling defined later in the same block
E0043locals-unknown-referencetemplate references a key the locals block does not declare
E0044mapping-entry-not-foundmapping-library import references an entry not present in the MappingLibrary
E0045mapping-import-shapevaluesMapping $import: is not a bare-name mapping-library reference (<Library>#/mappings/<entry>)
E0046mapping-library-not-foundmapping-library import references a MappingLibrary not present in the catalog
E0047orphan-cross-boundary-link-placeholderassembled output retains an unresolved cross-boundary link placeholder
E0048path-collisiondispatch path produced multiple provider outputs
E0049path-template-invalid-fieldpath template references a field not in the documented allowlist
E0050pipeline-host-scope-unavailablepipeline /host operation from a step with no host component
E0051pipeline-patch-targets-unassembled-fragmentspipeline PATCH targets an assembler provider's pre-assembly fragments
E0052pipeline-target-not-emittedpipeline PATCH targets a document the node did not emit
E0053plugin-provider-incompatiblepipeline plugin is not compatible with the rendering provider
E0054provider-node-input-invalidprovider rejected node input
E0055provides-contract-unfulfilledRecipe or FeatureRecipe does not publish a provides key its abstract entity's schema.provides contract declares
E0056provides-evaluation-failedprovides template evaluation failed
E0057provides-self-containmentprovides block references a root outside the self-contained set
E0058render-nondeterministicprovider render is not deterministic
E0059self-inject-key-collisionduplicate delivery key across self-inject and uses-inject
E0060template-unknown-roottemplate references a root the render context does not define
E0061unknown-providerunknown provider
E0062custom-mechanism-has-no-mappingcustom inject mechanism has no matching key in injectMapping output; add the mechanism's key to the Recipe injectMapping
E0063workload-entry-not-foundworkload-library import references an entry not present in the WorkloadLibrary
E0064workload-import-shapeworkload $import: is not a bare-name workload-library reference (<Library>#/workloads/<entry>)
E0065workload-library-not-foundworkload-library import references a WorkloadLibrary not present in the catalog
E0066dangling-uses-targetuses edge target does not exist
E0067active-toggle-not-a-booleanactive toggle did not resolve to a boolean
E0068sub-aggregate-nesting-depth-exceededmax sub-aggregate nesting depth exceeded
E0069mutator-patch-rejectedmutator patch rejected
E0070reexport-cyclere-exported component alias forms a cycle
E0071release-edge-retargetrelease edge retargets a developer-declared edge
E0072sub-aggregate-not-loadablesub-aggregate load failed
E0073sub-aggregate-name-collisionflattened node ID collision: rename one of the colliding instances so their flattened IDs differ
E0074unbound-release-edge-configrelease per-edge configuration has no edge to apply to
E0075aggregate-not-in-canonical-formaggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem)
E0076unplaced-sub-modulesub-module placed in no boundary: route it into a boundary under `aggregates`, or name its components there under `components`
E0077uses-target-not-activeuses edge target was pruned because its active toggle resolved to false
E0078wasm-nested-producer-consumption-deniedproducer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption call
E0079wasm-command-set-mismatchwasm: recorded command mirror does not match plugin describe()
E0080wasm-contract-mismatchwasm: entity contract claim does not match plugin describe()
E0081wasm-diagnostic-severity-invalidwasm: guest plugin returned a diagnostic whose severity the contract does not declare
E0082wasm-guest-errorwasm: guest plugin reported an error
E0083wasm-guest-panicwasm: guest plugin panicked during call
E0084wasm-host-function-set-mismatchwasm: stamped host-function record does not match .wasm imports
E0085wasm-manifest-rejectedwasm: plugin rejected by the sandbox
E0086wasm-plugin-exitedwasm: plugin invoked proc_exit
E0087wasm-plugin-type-mismatchwasm: declared plugin type does not match plugin describe()
E0088wasm-plugin-version-mismatchwasm: entity metadata.version does not match plugin describe()
E0089all-versions-retractedevery published version this reference could select has been withdrawn
E0090ambiguous-importer-pluginformat is advertised by more than one importer plugin
E0091ambiguous-parser-pluginformat is advertised by more than one parser plugin
E0092ambiguous-provider-plugincapability is served by more than one provider plugin; add a plugins.providers entry to select one
E0093ambiguous-type-mappingmanifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous
E0094duplicate-entity-identityduplicate entity identity within a single catalog directory
E0095malformed-recipe-referencemalformed recipe reference in a Manifest mapping value
E0096manifest-implements-mismatchmanifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type key
E0097no-importer-for-formatno importer plugin advertises the requested format
E0098no-parser-for-formatno parser plugin advertises the requested format
E0099no-recipe-resolvedno recipe resolved for component/feature instance: add an explicit Manifest mapping for its type
E0100provider-binding-unsatisfiedplugins.providers entry names a plugin no provider-rendering plugin serving the capability matches
E0101provider-version-unsatisfiableno provider-rendering plugin version satisfies the recipe's provider version pin
E0102plugin-reference-must-not-be-registry-qualifiedwasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path
E0103unsatisfiable-entity-versionno catalog version satisfies the referenced version constraint
E0104plugin-reference-must-be-scopedwasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location
E0105recipe-reference-must-be-scopedrecipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location
E0106invalid-library-refresolve: invalid library reference URI
E0107version-selection-conflictresolve: minimal version selection conflict — incompatible library version requirements
E0108catalog-cannot-load-sub-aggregate-bodiesresolve: catalog lookup cannot load resolved sub-aggregate bodies
E0109catalog-cannot-load-recipe-bodiesresolve: catalog lookup cannot load resolved recipe and plugin bodies
E0110source-template-at-lock-timeresolve: source-template evaluation failure at lock time
E0111source-template-not-parsableresolve: source-template parse error
E0112source-template-provides-refresolve: source-template references .provides (invalid reverse reference)
E0113sub-aggregate-depthresolve: sub-aggregate inclusion depth exceeded
E0114unresolvable-uriresolve: no entity in the catalog matches this URI
E0115ambiguous-dispatchcompactform: ambiguous dispatch — $mode required
E0116constraint-type-mismatchcompactform: constraint not valid for declared type
E0117escape-content-invalidcompactform: $jsonschema content invalid
E0118host-in-library-refcompactform: cross-document $ref carries a registry host; reference the library by identity
E0119reference-unresolvablecompactform: $ref unresolvable
E0120unknown-keywordcompactform: unknown keyword
E0121unresolved-schema-library-refcompactform: cross-document $ref target not found
E0122deprecated-entitydeprecation: build consumes a deprecated entity
E0123not-docs-bundledocscache: artifact is not a documentation bundle
E0124page-not-founddocscache: page not found in documentation bundle
E0125offline-egressegress: network access refused because the workspace is offline; remediation: pass `--offline=false` to allow the network for this one run, or clear the top-level `offline` key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run `aggrega pull --release <release>` from a connected environment first to populate the cache
E0126acquisition-disabledexternalinputs: acquisition is disabled for unpinned inputs
E0127digest-mismatchexternalinputs: fetched bytes mismatch the pinned digest
E0128scheme-not-allowedexternalinputs: URL scheme is not allowed
E0129store-corruptexternalinputs: store blob mismatches its pinned record
E0130lockfile-driftlockfile: out of date; it no longer matches what its Release resolves to
E0131lockfile-invalidlockfile: file failed schema validation
E0132ambiguous-content-layeroci: manifest has multiple layers of the expected content media type
E0133cached-manifest-integrityoci: cached manifest digest mismatch
E0135fetch-integrityoci: content digest mismatch
E0136fetch-network-unreachableoci: network unreachable
E0137fetch-not-foundoci: artifact not found at remote source
E0138fetch-unauthorizedoci: authentication required or failed
E0139immutable-tag-conflictoci: tag already published with different content
E0140no-content-layeroci: manifest has no layer of the expected content media type
E0141oci-location-collisionoci: distinct catalog identities map to the same OCI repository location
E0142referrer-discovery-unavailableoci: referrer discovery could not be completed
E0143unknown-entity-kindoci: unknown entity kind for mediatype dispatch
E0144signature-bundle-digest-mismatchcached signature bundle does not match its recorded digest
E0145plugin-entity-not-foundplugin reference is not a Plugin entity
E0146reference-cyclecircular reference expansion
E0147malformed-trust-policyregistrytrust: advertised trust config is malformed
E0148no-trust-advertisedregistrytrust: registry advertises no trust config
E0149attachment-slot-near-missattachment name is a near miss for a declared slot
E0150attachment-slot-shapeattachment does not conform to its declared slot shape
E0151duplicate-boundary-componentcomponent declared in more than one boundary: declare each component in exactly one boundary
E0152duplicate-triad-identityduplicate Aggregate/Manifest identity (metadata.name) in the Release directory
E0153feature-merge-conflictfeature merge conflict: reconcile the Aggregate and Release declarations for the feature
E0154internal-catalog-view-disagreementthe compiler's own views of the catalog disagree
E0155inject-key-collisionduplicate delivery key across inject sources
E0156invalid-inject-keyinvalid inject key: the from-key must name a provides key its source publishes
E0158invalid-parameter-refinvalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template
E0160manifest-cross-binding-pillar-collisionmanifest annotation bindings collide on same Feature path+pillar
E0161manifest-reserved-prefixmanifest annotation binding uses reserved prefix
E0162missing-required-featuremissing required feature: attach a Feature of the required type to the component
E0163missing-required-socketrequired uses socket not populated
E0164parameter-contract-violationparameter contract violated
E0165parameter-missingrequired parameter not supplied
E0167provides-key-not-declaredRecipe publishes a provides key its Component does not declare
E0168schema-conformanceauthored pillar does not conform to its declared schema
E0169self-inject-forbiddenself-inject on component without spec.inject allowlist
E0170triad-ref-unresolvableaggregate/manifest reference unresolvable
E0171unknown-uses-socketunknown uses socket: name a socket the entity declares in its usesSchema — only a component's own uses block may name one the catalog did not declare
E0172release-not-in-canonical-formrelease reached resolve un-normalized (non-empty root components alongside a synthesized default boundary)
E0173unread-parameterdeclared parameter is read by no reference in the Aggregate
E0174uses-socket-near-missuses socket name is a near miss for a declared socket
E0175document-not-loadablefile load failed: the file could not be read, or its bytes did not parse
E0176keyless-signing-requires-networksigning: keyless signing requires a live identity provider, Fulcio, and Rekor
E0177no-signature-foundsigning: no signature found for an artifact that requires one
E0178no-trusted-identitiessigning: keyless verification requires at least one trusted identity
E0179signature-invalidsigning: signature does not verify
E0180signature-verification-failedsigning: signature bundle does not verify
E0181signing-policy-requires-signaturesigning: signing policy requires a signature for this artifact kind; refusing to push unsigned content
E0182trust-root-not-loadablesigning: cannot load pinned trust root
E0183unsigned-push-refusedsigning: registry requires signatures; refusing to push unsigned content
E0184unsupported-keysigning: unsupported held-key type
E0185untrusted-identitysigning: signature identity is not trusted for this registry
E0186unknown-source-kindno source adapter serves the source kind
E0187empty-workspace-rootcacheslot: empty workspaceRoot
E0188artifact-entry-shapeartifacts entry: shape must be a string scalar or {$import: <local-path>}
E0189artifact-library-entry-shapeartifactlibrary: entry must be a mapping of filename to a string body
E0190forbidden-keywordschemalibrary: forbidden JSON Schema keyword
E0191mapping-entry-not-scalarmappinglibrary: entry body must be a string scalar
E0192document-nesting-depth-exceededa document nests too many levels deep
E0193parameters-shapeparameters: shape must be an inline object or {$import: <local-path>}
E0194template-not-foundschemalibrary: template not found
E0195template-param-missingschemalibrary: template parameter missing
E0196template-param-type-mismatchschemalibrary: template parameter type mismatch
E0197values-mapping-shapevaluesmapping: shape must be a string scalar or {$import: <path-or-library-identity>}
E0198well-known-annotation-scopewellKnownAnnotations: a key is declared at a scope the provider's contract does not render
E0199workload-entry-not-scalarworkloadlibrary: entry body must be a string scalar
E0200workload-template-shapeworkload: shape must be a string scalar or {$import: <path-or-library-identity>}
E0201assertion-name-collisionassertion name declared twice across the extends chain
E0202cyclic-extensioncyclic extends chain
E0204feature-recipe-values-mapping-requires-sourceFeatureRecipe: valuesMapping requires source
E0205extends-merge-failedinheritance merge failed
E0207recipe-output-component-label-collisionrecipe output-component-labels constraint: key is also declared in outputLabels
E0208recipe-output-label-reserved-namespacerecipe output-labels constraint: key uses a reserved namespace
E0209recipe-values-mapping-requires-sourceRecipe: valuesMapping requires source
E0210recipe-no-input-kindRecipe: at least one input kind required
E0211recipe-filename-collision-across-input-kindsfilename collision across input kinds: two input-kind blocks produced a file under one output name
E0212slot-not-referenceableworkload attachment slot is not referenceable
E0213workload-features-schemaworkload featuresSchema cross-check failed
E0214workload-not-validworkload validation failed
E0215entity-envelope-invaliddocument envelope validation failed
E0216schema-extension-evaluation-failedvalidator/jsonschema: x-aggrega extension evaluation failed
E0218schema-not-resolvablevalidator/jsonschema: schema resolution failed
E0220extends-chain-too-deepextends chain exceeds maximum depth
E0221schema-merge-input-invalidmerger: invalid merge input
E0222ambiguous-registry-aliasregistry alias matches more than one host
E0223capability-on-cross-cutting-socketa cross-cutting socket is bound by capability but attaches by uri
E0224workspace-config-invalidworkspace configuration is invalid
E0225duplicate-provider-targetcapability is bound to more than one provider plugin
E0226duplicate-registry-aliasregistry alias is already used by another host
E0227governance-role-invalida governance attachment declares no role or an unknown role
E0228inert-field-on-provider-socketa provider socket binding sets a field with no referent on that socket
E0229position-out-of-rangeposition out of range
E0246verdict-plugin-trust-mismatchthe digest recorded as trusted for this plugin does not match the digest its cached manifest reports
E0247verdict-attachment-not-configureda plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role
E0248wasm-output-shapewasm: guest plugin returned an output that is not the shape the socket reads
E0250nest-segment-not-one-directoryprovider named a directory for each contributor's own sub-directory that is not a single directory name
E0251recipe-source-is-emptyrecipe source is an empty string, which names neither sourceless mode nor sourced mode
E0252artifact-library-file-escapes-keyartifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under
E0253annotation-binding-target-unresolvedannotation binding does not resolve against its target Feature
E0254annotation-subkey-not-conformingannotation subkey does not conform to the target Feature's schema at the routed pillar
E0255annotation-side-pillar-mismatchannotation routes through a pillar its authoring side may not use
E0256annotation-binding-pillar-overlapannotation binding declares one path in both pillar lists
E0257schema-contract-compile-failuredeclared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation
E0259boundary-scope-attachment-not-declared-at-a-boundaryattachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it
E0260unplaced-componentcomponent placed in no boundary: name it under a boundary's `components`, or place the sub-module that contributes it under `aggregates`
E0261unresolved-boundary-componentboundary names a component the composition does not hold: correct the name, or remove the entry
E0262unusable-component-identitycomponent identity cannot be the name its emitted resources are stamped with: rename the component
E0263component-identity-target-refusesthe target will not accept a name derived from this component's authored identity: rename the component
E0264provider-refused-every-component-identityprovider guest never accepted a component identity the compiler composed for it
E0265unsupported-input-kindprovider does not support the node's input kind
E0266unusable-schema-importa schema `$import:` could not be applied
E0267unknown-schema-pillara schema block declares a key that names no data pillar
E0268pipeline-patch-unit-not-carvedreassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokens
E0269provider-render-duplicate-pathprovider guest returned two output files under one path; a conforming guest returns each output path at most once
E0270link-patch-file-not-emittedlink patch names an output file the dispatch group did not emit; a conforming link patch names a file the group's own render returned
E0271pipeline-emit-file-absentemit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and content
E0272pipeline-side-effect-kind-undefinedside effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crd
E0273rendered-name-unavailabletemplate reads the name the target gives the resources it renders for the node, and this node's provider reports no such name; a conforming template reads a value the node's own provider supplies
E0274verdict-plugin-identity-changedthe plugin identity recorded as trusted no longer matches what this resolution reports
E0275edit-refused-invalid-resultthe edit was refused because the resulting document would not be valid, and nothing was written
E0276schema-evolutionthe version being published changes the published predecessor in a way the documented evolution rubric objects to
E0277annotation-prefixan annotation key on the entity uses a prefix the platform reserves
E0278name-shapethe entity's name does not follow the documented name shape for its kind
E0279dynamic-refsa schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot follow
E0280id-overridesa schema in the entity declares an identifier of its own, where the platform owns that schema's identity
E0281category-matches-directorythe entity's category label does not match the category directory the entity is filed under
E0282x-aggrega-discouragementthe entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchema
E0283plugin-default-limitsthe Plugin entity declares no runtime resource cap of its own, so the platform defaults apply
E0284secret-slot-declares-sensitivean attachment slot admits only secret material and does not declare that it handles it
E0285provides-declared-by-componentthe Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refused
E0286publish-bump-below-classificationthe version bump being published is smaller than the evolution check's classification of the change requires
E0287import-halting-diagnosticthe importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring files
E0288plugin-cannot-express-inputa plugin has no expression for a construct this build declares
E0289plugin-required-input-unresolveda plugin could not resolve something it requires to exactly one value
E0290plugin-output-name-collisiontwo things a plugin produced occupy one name in its output
E0291plugin-value-not-representablea plugin has no representation for a value it was given
E0292plugin-failure-unclassifieda plugin reported a failure that none of the declared kinds names
E0293wasm-guest-condition-undeclaredwasm: guest plugin named a condition the socket does not declare
E0294subsystem-component-identity-collisioncomponents in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component's identity
E0295library-reference-whitespacelibrary reference: a reference to a library entry carries no whitespace or line break
E0296release-chain-composes-both-routing-keysrelease extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both
E0297inherited-boundary-directory-is-literalinherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to
E0298bundle-no-entity-documentoci: published bundle carries no entity document
E0299bundle-ambiguous-entity-documentoci: published bundle carries more than one entity document
E0300bundle-unreadableoci: published bundle cannot be unpacked
E0301published-artifact-not-an-entityoci: published artifact is not an entity document
E0302entity-not-pinnedan input the entity reads has no pin recorded for it in the entity.lock beside it
E0303entity-shares-its-directorythe entity shares its directory with another entity, and an entity of its kind has a directory of its own
E0304content-outside-entity-directorya path names content outside the entity's own directory
E0305local-source-content-mismatchthe files of the entity's local source do not match the pins recorded for them in entity.lock
E0306plugin-artifact-not-foundplugin artifact not found on this machine
E0307cache-location-outside-cachea value a cache location is built from would place cached files outside the place it names in the cache
E0308conflicting-features-reach-one-componenta Feature reaches a component alongside a Feature it declares a conflict with
E0309symbolic-link-in-entity-filesa symbolic link sits among the files an entity carries
E0310offline-registration-without-trust-policya registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with `aggrega registry add <host> --identity <identity>=<issuer>` or `--key <public-key-file>`
E0311malformed-version-pinreference carries a malformed version pin
E0312colon-in-provider-binding-capabilitya provider socket binding names a capability containing a colon, which no Recipe can select
E0313provider-binding-capability-unservedplugins.providers entry names a capability no provider-rendering plugin the build reads serves
E0314plugin-built-from-uncommitted-changesplugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reports
E0315connection-attachment-slot-undeclareda connection carries an attachment under a name its socket declares no slot for
E0316connection-attachment-written-off-its-connectiona Release attachment takes the name of an attachment one of a component's connections carries
E0317release-connection-attachment-untypeda Release connection attachment names no Feature type, and the type is required for an attachment only the Release makes
E0318attachment-inject-mapping-key-collisionduplicate delivery key across two attachments: an attachment's FeatureRecipe writes a delivery key another attachment already delivered
E0319duplicate-connection-aliasconnection alias is already used by another connection of the same component
E0320write-leads-out-of-workspacea path this operation writes or deletes leads through a link out of the directory it must stay inside
E0321read-leads-out-of-workspacea file this operation reads leads through a link out of the directory it must stay inside
E0323caller-render-facts-not-declaredtemplate reads its callers' render facts, but the FeatureRecipe does not set readsCallerRenderFacts
E0324reference-leads-out-of-workspacea reference a document makes to another file leads out of the directory it must stay inside
E0325provider-render-fact-not-listprovider guest reported a render fact whose value is not a list; a conforming guest reports every render fact's value as a JSON array, even with one entry
E0326pipeline-step-reads-caller-render-factspipeline step reads its callers' render facts, but a pipeline step does not read the components connecting to its host; it reads only the host's own render facts
E0327index-of-absent-map-keytemplate indexes a map with a key the map does not hold
E0328misnamed-slot-fillattachment written under a name no slot declares fits a slot its component leaves empty
E0329connection-credential-matches-target-keya connection and the target it reaches do not name one key: they write different locators for it, or only one of them names one
E0330mixed-signing-credentialssigning: the references named together need different signing credentials, so nothing was signed
E0331signature-not-recordedsigning: no verified signature is recorded for an artifact that requires one
E0332signature-for-another-artifactsigning: the recorded signature was made for a different artifact
E0333recorded-signature-out-of-datesigning: a recorded signature is not the one a pull would record
E0334omit-matched-nothingan omits entry left out nothing the source rendered
E0335unsupported-omitsprovider does not support omits
E0336omit-report-mismatcha provider's omitted counts do not match the omits entries it was handed
E0337importer-version-unsatisfiableno importer plugin version satisfies the plugins.importer entry's version pin
E0338duplicate-importer-attachmentimporter is attached by more than one plugins.importer entry
E0339ambiguous-import-formatmore than one importer recognises the source
E0340name-windows-cannot-holda name this operation writes holds a path segment Windows cannot hold as written
E0341importer-declares-no-file-patternsthe importer serving the source's format declares no file patterns, so it reads one file and cannot read a directory
E0342import-directory-matched-nothingno file in the directory matches the file patterns the importer serving the source's format declares
E0343import-source-name-collisiona file read from the directory and a file named in the importer's `with.sources` have the same name
E0344windows-unusable-entryan entry this publication carries cannot be used on Windows
E0345duplicate-container-environment-variablea container declares one environment variable twice
E0346metrics-credential-annotation-matches-providesa Component's annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance's metrics need a credential
E0347target-render-facts-not-declaredtemplate reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFacts
E0348pipeline-step-reads-target-render-factspipeline step reads the render facts of a component its host is wired to, but a pipeline step reads only the host's own render facts
E0349import-target-unboundno Recipe in the workspace's catalog binds to the capability the import's target names
E0350unrecognised-import-formatno importer recognises the source
E0351unsupported-boundary-artifactsprovider does not support boundary artifacts
E0352boundary-directory-not-beneath-output-rootboundary output directory does not name a directory beneath the output root
E0353boundary-feature-name-not-a-directoryboundary-level Feature instance name is not a directory name
E0354cross-boundary-link-value-not-copieda template does more than copy a value it reads off a cross-boundary link
E0355inject-delivery-shapeinject delivery: shape must be a list of entries, each `in:` with exactly one of `from:` or `value:`
E0356suspend-requires-scheduled-formsuspend requires form: scheduled
E0357name-mapping-matched-nothinga Manifest name mapping's key names no component instance or attachment in this build, so the entry binds nothing
E0358uses-target-not-exporteduses edge target names a component its module does not export
E0359source-adapter-not-registeredno source adapter is registered in this program for the source kind
E0360netrc-file-unreadablethe netrc file could not be read
E0361source-url-carries-credentialthe source URL carries a credential
E0362uses-inject-valueinject entry on a connection carries `value:`; a connection delivers the target's published keys, each named with `from:`
E0363annotation-subkey-not-boundannotation subkey is not routed by the annotation's binding
E0364value-template-execution-faileda value template failed while it ran
E0365boundary-contribution-not-assembledboundary-level Feature's output is routed to a dispatch path nothing assembles
E0366inject-mapping-output-not-parsableFeatureRecipe injectMapping output could not be read as a dictionary of deliveries
E0367annotation-scalar-not-routablea scalar annotation value does not route to exactly one path of its binding
E0368inject-mapping-output-key-not-deliveredFeatureRecipe injectMapping output writes a key no delivery mechanism of the host reads
E0369absent-path-read-and-iteratedtemplate reads a path as a value and iterates it, and the data holds nothing at that path
E0370duplicate-pipeline-step-ida pipeline declares one step id twice
E0371unknown-catalog-document-kindcatalog document declares a kind a catalog does not hold
E0372attachment-inject-valueinject entry on an attachment carries `value:`; an attachment delivers the keys its FeatureRecipe publishes, each named with `from:`, and a literal belongs in the component's own inject block
E0373retired-api-versiona document declares an API version this compiler no longer reads
E0374retired-abi-versiona plugin declares a plugin ABI version this compiler no longer speaks
E0375retired-media-typeoci: artifact carries a media type this compiler no longer reads
E0376no-answer-in-timeegress: the server did not answer in time
E0377repository-listing-too-longregistry: the repository listing did not end in time
E0378registry-too-busyoci: the registry kept asking to slow down
  • E0002 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. Nombraba una búsqueda en el catálogo que falla mientras se comprueban los contratos estáticos del grafo — un defecto del compilador y no de un documento escrito — y ese estado lo notifica ahora la condición que se genera cuando una compilación resuelve un tipo de componente para el que el catálogo que lee no tiene en ese momento ninguna entrada, y su código es E0154.
  • E0134 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. Nombraba una entidad publicable cuyo directorio no llevaba el nombre de la versión que declara la entidad; una publicación no juzga el nombre de un directorio, y la condición que se genera cuando una entidad comparte su directorio con otra entidad allí donde su tipo tiene un directorio propio es E0303.
  • E0157 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. Nombraba una clave de Aggregate — un nombre de instancia de componente, funcionalidad, subsistema o módulo anidado — que no coincidía con el patrón de nombres escritos por el autor. Cada una de esas superficies de clave está restringida a esa misma grafía por el esquema del Aggregate, que rechaza el documento al validar su envoltorio y notifica la clave infractora con línea y columna; el código de esa condición es E0215.
  • E0159 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. Nombraba una referencia de destino cuyos segmentos separados por puntos no coincidían todos con el patrón de nombres de instancia, y ninguna compilación lo notificó antes de que la condición se suprimiera.
  • E0166 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. Nombraba el archivo al que apunta el parameters: { $import: … } de una Release cuando ese archivo no se podía leer o sus bytes no se podían analizar; un archivo que no produce ningún documento es una sola condición dondequiera que se haya escrito la ruta, y su código es E0175.
  • E0203 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. Nombraba una FeatureRecipe sobre la capacidad eval que declaraba una fuente, una superposición de values, una carga de trabajo o artefactos; esa capacidad se suprimió, y ya nada notifica este estado.
  • E0206 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. Nombraba una Recipe sobre la capacidad eval que declaraba una fuente, una carga de trabajo, artefactos o una superposición de values; esa capacidad se suprimió, y una Recipe que no declara ninguno de ellos se rechaza en cualquier capacidad con E0210.
  • E0217 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. Nombraba un fallo de validación de esquema que no se podía notificar sobre un campo concreto, y ninguna compilación lo notificó antes de que la condición se suprimiera.
  • E0219 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. Nombraba una cadena extends cíclica, notificada por un recorrido de la cadena separado del paso de combinación de la fusión de esquemas; un único recorrido de la cadena notifica todas las cadenas cíclicas, y el código correspondiente es E0202.
  • E0230 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. La condición que nombraba este número se suprimió, y ninguna compilación la notifica.
  • E0231 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. La condición que nombraba este número se suprimió, y ninguna compilación la notifica.
  • E0232 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. La condición que nombraba este número se suprimió, y ninguna compilación la notifica.
  • E0233 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. La condición que nombraba este número se suprimió, y ninguna compilación la notifica.
  • E0234 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. Nombraba una fuente de Recipe que es una cadena vacía, notificada al renderizar a través del proveedor compose; ahora lo notifica una sola condición que cubre todos los proveedores, y su código es E0251.
  • E0235 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. La condición que nombraba este número se suprimió, y ninguna compilación la notifica.
  • E0236 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. La condición que nombraba este número se suprimió, y ninguna compilación la notifica.
  • E0237 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. La condición que nombraba este número se suprimió, y ninguna compilación la notifica.
  • E0238 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. La condición que nombraba este número se suprimió, y ninguna compilación la notifica.
  • E0239 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. La condición que nombraba este número se suprimió, y ninguna compilación la notifica.
  • E0240 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. La condición que nombraba este número se suprimió, y ninguna compilación la notifica.
  • E0241 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. La condición que nombraba este número se suprimió, y ninguna compilación la notifica.
  • E0242 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. Nombraba una fuente de Recipe que es una cadena vacía, notificada al renderizar a través del proveedor Helm; ahora lo notifica una sola condición que cubre todos los proveedores, y su código es E0251.
  • E0243 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. La condición que nombraba este número se suprimió, y ninguna compilación la notifica.
  • E0244 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. La condición que nombraba este número se suprimió, y ninguna compilación la notifica.
  • E0245 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. La condición que nombraba este número se suprimió, y ninguna compilación la notifica.
  • E0249 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. La condición que nombraba este número se suprimió, y ninguna compilación la notifica.
  • E0258 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. La condición que nombraba este número se suprimió, y ninguna compilación la notifica.
  • E0322 está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. Nombraba un valor que una Feature vinculada a un límite calculaba para el entorno de un componente con una clave que otra vinculación ya había entregado. Una Feature vinculada a un límite solo entrega en un componente a través del injectMapping de su FeatureRecipe, y un mapeo que escribe una clave que entregó otra vinculación se notifica con E0318.

Guía para hacer coincidir

El predicado errors.Is recorre la cadena de envoltorios, así que hacer coincidir con un centinela funciona incluso cuando el error se envuelve varias veces en su camino de vuelta hasta ti. Haz coincidir con el error que devolvió una función exportada:

package release
import (
"errors"
"fmt"
"github.com/aggrega-ai/aggrega-cli/pkg/resolver"
"github.com/aggrega-ai/aggrega-cli/pkg/validator/envelope"
)
// Load reads a Release and reports the distinct failures a caller handles
// differently.
func Load(path string) error {
_, err := resolver.LoadRelease(path)
switch {
case errors.Is(err, envelope.ErrEntityEnvelope()):
return fmt.Errorf("%s is not a Release: %w", path, err)
case errors.Is(err, resolver.ErrYAMLLoad()):
return fmt.Errorf("%s could not be read as YAML: %w", path, err)
case err != nil:
return err
}
return nil
}

No hay ningún punto de entrada exportado que ejecute una compilación completa, así que hacer coincidir con errors.Is se aplica al código que llama directamente a estos paquetes. Para condicionar la CI a una compilación, ejecuta aggrega build y lee su estado de salida y sus diagnósticos: el texto de sus mensajes está catalogado en fatal-halts.md, su categoría en error-translation.md, y el código corto de su encabezado entre corchetes se resuelve en la tabla de todas las condiciones de esta página.

Las dos vías de control existen porque los tres identificadores llegan a distancias distintas. Un control escrito en Go enlaza estos paquetes, hace coincidir centinelas y puede leer cualquiera de los dos códigos de cualquier error que tenga. Un control escrito alrededor del comando tiene el estado de salida y el texto impreso — y el texto impreso nombra la condición, porque el código corto está en el encabezado entre corchetes. Así que un control de ese tipo se basa en ese código corto y no en la redacción del mensaje, y las vistas indexadas por mensaje siguen siendo la forma de remontarse desde una redacción que ya tiene. Haz coincidir el centinela desde Go; básate en el código corto alrededor del comando; lee el código descriptivo del diagnóstico estructurado donde un cliente hable ese protocolo.

Los centinelas declarados en paquetes distintos con el mismo nombre corto son condiciones distintas, no dos grafías de una sola: errors.Is los distingue por identidad, así que hacer coincidir con uno no coincide con el otro. Las reexportaciones señaladas en las tablas son la excepción, y se señalan precisamente porque son el caso en que dos nombres sí coinciden. Haz coincidir con el nombre en el paquete bajo el que lo listan las tablas, y trata un nombre corto por sí solo como ambiguo.

Para el catálogo de diagnósticos orientados al usuario (los mensajes que los desarrolladores ven en su terminal cuando se detiene una compilación), consulta fatal-halts.md. Para el catálogo de avisos (la salida no bloqueante warning:, lint: y notice:), consulta warnings.md. Para la taxonomía de prefijos de categoría ([DEVELOPER_ERROR] / [OPS_ERROR] / [CATALOG_ERROR] / [TRANSLATION_ERROR] / [FETCH_ERROR] / [POLICY_ERROR] / [TRUST_ERROR]), consulta error-translation.md.