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-fieldes 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
| Centinela | Código | Mensaje |
|---|---|---|
ErrAllVersionsRetracted() | all-versions-retracted | every published version this reference could select has been withdrawn |
ErrAmbiguousImporterPlugin() | ambiguous-importer-plugin | format is advertised by more than one importer plugin |
ErrAmbiguousParserPlugin() | ambiguous-parser-plugin | format is advertised by more than one parser plugin |
ErrAmbiguousProviderPlugin() | ambiguous-provider-plugin | capability is served by more than one provider plugin; add a plugins.providers entry to select one |
ErrAmbiguousTypeMapping() | ambiguous-type-mapping | manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous |
ErrDuplicateEntityIdentity() | duplicate-entity-identity | duplicate entity identity within a single catalog directory |
ErrImporterVersionUnsatisfiable() | importer-version-unsatisfiable | no importer plugin version satisfies the plugins.importer entry's version pin |
ErrManifestImplementsMismatch() | manifest-implements-mismatch | manifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type key |
ErrNameMappingMatchedNothing() | name-mapping-matched-nothing | a Manifest name mapping's key names no component instance or attachment in this build, so the entry binds nothing |
ErrNoImporterForFormat() | no-importer-for-format | no importer plugin advertises the requested format |
ErrNoParserForFormat() | no-parser-for-format | no parser plugin advertises the requested format |
ErrNoRecipeResolved() | no-recipe-resolved | no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type |
ErrProviderBindingCapabilityUnserved() | provider-binding-capability-unserved | plugins.providers entry names a capability no provider-rendering plugin the build reads serves |
ErrProviderBindingUnsatisfied() | provider-binding-unsatisfied | plugins.providers entry names a plugin no provider-rendering plugin serving the capability matches |
ErrProviderVersionUnsatisfiable() | provider-version-unsatisfiable | no provider-rendering plugin version satisfies the recipe's provider version pin |
ErrQualifiedPluginReference() | plugin-reference-must-not-be-registry-qualified | wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path |
ErrUnknownCatalogDocumentKind() | unknown-catalog-document-kind | catalog document declares a kind a catalog does not hold |
ErrUnsatisfiableEntityVersion() | unsatisfiable-entity-version | no catalog version satisfies the referenced version constraint |
ErrUnscopedPluginReference() | plugin-reference-must-be-scoped | wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location |
ErrUnscopedRecipeReference() | recipe-reference-must-be-scoped | recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location |
ErrUnusableSchemaImport() | unusable-schema-import | a schema `$import:` could not be applied |
ErrManifestImplementsMismatch()es el mismo valor quepkg/resolver.ErrManifestImplementsMismatch(), así que hacer coincidir con cualquiera de los dos nombres funciona.
pkg/closure
| Centinela | Código | Mensaje |
|---|---|---|
ErrInvalidLibraryRef() | invalid-library-ref | resolve: invalid library reference URI |
ErrMVSConflict() | version-selection-conflict | resolve: minimal version selection conflict — incompatible library version requirements |
ErrNoAggregateLoader() | catalog-cannot-load-sub-aggregate-bodies | resolve: catalog lookup cannot load resolved sub-aggregate bodies |
ErrNoRecipeLoader() | catalog-cannot-load-recipe-bodies | resolve: catalog lookup cannot load resolved recipe and plugin bodies |
ErrSourceTemplateAtLockTime() | source-template-at-lock-time | resolve: source-template evaluation failure at lock time |
ErrSourceTemplateParse() | source-template-not-parsable | resolve: source-template parse error |
ErrSourceTemplateProvidesRef() | source-template-provides-ref | resolve: source-template references .provides (invalid reverse reference) |
ErrSubAggregateDepth() | sub-aggregate-depth | resolve: sub-aggregate inclusion depth exceeded |
ErrUnresolvableURI() | unresolvable-uri | resolve: no entity in the catalog matches this URI |
pkg/compactform
| Centinela | Código | Mensaje |
|---|---|---|
ErrAmbiguousDispatch() | ambiguous-dispatch | compactform: ambiguous dispatch — $mode required |
ErrCircularRef() | reference-cycle | circular reference expansion |
ErrConstraintTypeMismatch() | constraint-type-mismatch | compactform: constraint not valid for declared type |
ErrEscapeContentInvalid() | escape-content-invalid | compactform: $jsonschema content invalid |
ErrHostInLibraryRef() | host-in-library-ref | compactform: cross-document $ref carries a registry host; reference the library by identity |
ErrReferenceUnresolvable() | reference-unresolvable | compactform: $ref unresolvable |
ErrUnknownKeyword() | unknown-keyword | compactform: unknown keyword |
ErrUnresolvedSchemaLibraryRef() | unresolved-schema-library-ref | compactform: cross-document $ref target not found |
ErrCircularRef()es el mismo valor quepkg/refcycle.ErrCycle(), así que hacer coincidir con cualquiera de los dos nombres funciona.
pkg/deprecation
| Centinela | Código | Mensaje |
|---|---|---|
ErrDeprecatedEntity() | deprecated-entity | deprecation: build consumes a deprecated entity |
pkg/docscache
| Centinela | Código | Mensaje |
|---|---|---|
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrNotDocsBundle() | not-docs-bundle | docscache: artifact is not a documentation bundle |
ErrPageNotFound() | page-not-found | docscache: page not found in documentation bundle |
ErrFetchNotFound()es el mismo valor quepkg/oci.ErrFetchNotFound(), así que hacer coincidir con cualquiera de los dos nombres funciona.
pkg/egress
| Centinela | Código | Mensaje |
|---|---|---|
ErrNoAnswerInTime() | no-answer-in-time | egress: the server did not answer in time |
ErrOfflineEgress() | offline-egress | egress: 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
| Centinela | Código | Mensaje |
|---|---|---|
ErrAcquisitionDisabled() | acquisition-disabled | externalinputs: acquisition is disabled for unpinned inputs |
ErrDigestMismatch() | digest-mismatch | externalinputs: fetched bytes mismatch the pinned digest |
ErrSchemeNotAllowed() | scheme-not-allowed | externalinputs: URL scheme is not allowed |
ErrStoreCorrupt() | store-corrupt | externalinputs: store blob mismatches its pinned record |
pkg/lockfile
| Centinela | Código | Mensaje |
|---|---|---|
ErrLockfileDrift() | lockfile-drift | lockfile: out of date; it no longer matches what its Release resolves to |
ErrLockfileInvalid() | lockfile-invalid | lockfile: file failed schema validation |
ErrSignatureNotRecorded() | signature-not-recorded | signing: no verified signature is recorded for an artifact that requires one |
pkg/oci
| Centinela | Código | Mensaje |
|---|---|---|
ErrAmbiguousContentLayer() | ambiguous-content-layer | oci: manifest has multiple layers of the expected content media type |
ErrBundleAmbiguousEntityDocument() | bundle-ambiguous-entity-document | oci: published bundle carries more than one entity document |
ErrBundleNoEntityDocument() | bundle-no-entity-document | oci: published bundle carries no entity document |
ErrBundleUnreadable() | bundle-unreadable | oci: published bundle cannot be unpacked |
ErrCacheLocationOutsideCache() | cache-location-outside-cache | a value a cache location is built from would place cached files outside the place it names in the cache |
ErrCachedManifestIntegrity() | cached-manifest-integrity | oci: cached manifest digest mismatch |
ErrFetchIntegrity() | fetch-integrity | oci: content digest mismatch |
ErrFetchNetworkUnreachable() | fetch-network-unreachable | oci: network unreachable |
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrFetchUnauthorized() | fetch-unauthorized | oci: authentication required or failed |
ErrImmutableTagConflict() | immutable-tag-conflict | oci: tag already published with different content |
ErrNoContentLayer() | no-content-layer | oci: manifest has no layer of the expected content media type |
ErrOCILocationCollision() | oci-location-collision | oci: distinct catalog identities map to the same OCI repository location |
ErrPublishedArtifactNotAnEntity() | published-artifact-not-an-entity | oci: published artifact is not an entity document |
ErrReferrerDiscoveryUnavailable() | referrer-discovery-unavailable | oci: referrer discovery could not be completed |
ErrRegistryTooBusy() | registry-too-busy | oci: the registry kept asking to slow down |
ErrRetiredMediaType() | retired-media-type | oci: artifact carries a media type this compiler no longer reads |
ErrSignatureBundleDigestMismatch() | signature-bundle-digest-mismatch | cached signature bundle does not match its recorded digest |
ErrSignatureForAnotherArtifact() | signature-for-another-artifact | signing: the recorded signature was made for a different artifact |
ErrUnknownEntityKind() | unknown-entity-kind | oci: unknown entity kind for mediatype dispatch |
pkg/pathscope
| Centinela | Código | Mensaje |
|---|---|---|
ErrNameWindowsCannotHold() | name-windows-cannot-hold | a name this operation writes holds a path segment Windows cannot hold as written |
pkg/pluginpath
| Centinela | Código | Mensaje |
|---|---|---|
ErrPluginArtifactNotFound() | plugin-artifact-not-found | plugin artifact not found on this machine |
ErrPluginEntityNotFound() | plugin-entity-not-found | plugin reference is not a Plugin entity |
pkg/pluginstrust
| Centinela | Código | Mensaje |
|---|---|---|
ErrVerdictAttachmentNotConfigured() | verdict-attachment-not-configured | a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role |
pkg/plugintest
| Centinela | Código | Mensaje |
|---|---|---|
ErrCommandsMismatch() | wasm-command-set-mismatch | wasm: recorded command mirror does not match plugin describe() |
ErrContractMismatch() | wasm-contract-mismatch | wasm: entity contract claim does not match plugin describe() |
ErrHostFunctionsMismatch() | wasm-host-function-set-mismatch | wasm: stamped host-function record does not match .wasm imports |
ErrRejected() | wasm-manifest-rejected | wasm: plugin rejected by the sandbox |
ErrTypeMismatch() | wasm-plugin-type-mismatch | wasm: declared plugin type does not match plugin describe() |
pkg/readscope
| Centinela | Código | Mensaje |
|---|---|---|
ErrReadLeadsOutOfWorkspace() | read-leads-out-of-workspace | a file this operation reads leads through a link out of the directory it must stay inside |
ErrReferenceLeadsOutOfWorkspace() | reference-leads-out-of-workspace | a reference a document makes to another file leads out of the directory it must stay inside |
pkg/recipepin
| Centinela | Código | Mensaje |
|---|---|---|
ErrEntityNotPinned() | entity-not-pinned | an input the entity reads has no pin recorded for it in the entity.lock beside it |
ErrLocalSourceContentMismatch() | local-source-content-mismatch | the files of the entity's local source do not match the pins recorded for them in entity.lock |
pkg/refcycle
| Centinela | Código | Mensaje |
|---|---|---|
ErrCycle() | reference-cycle | circular reference expansion |
pkg/registrytrust
| Centinela | Código | Mensaje |
|---|---|---|
ErrMalformedTrust() | malformed-trust-policy | registrytrust: advertised trust config is malformed |
ErrNoTrustAdvertised() | no-trust-advertised | registrytrust: registry advertises no trust config |
ErrOfflineRegistrationWithoutTrustPolicy() | offline-registration-without-trust-policy | a 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
| Centinela | Código | Mensaje |
|---|---|---|
ErrAnnotationBindingPillarOverlap() | annotation-binding-pillar-overlap | annotation binding declares one path in both pillar lists |
ErrAnnotationBindingTargetUnresolved() | annotation-binding-target-unresolved | annotation binding does not resolve against its target Feature |
ErrAnnotationScalarNotRoutable() | annotation-scalar-not-routable | a scalar annotation value does not route to exactly one path of its binding |
ErrAnnotationSidePillarMismatch() | annotation-side-pillar-mismatch | annotation routes through a pillar its authoring side may not use |
ErrAnnotationSubkeyNotBound() | annotation-subkey-not-bound | annotation subkey is not routed by the annotation's binding |
ErrAnnotationSubkeyNotConforming() | annotation-subkey-not-conforming | annotation subkey does not conform to the target Feature's schema at the routed pillar |
ErrAttachmentInjectValue() | attachment-inject-value | inject 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-miss | attachment name is a near miss for a declared slot |
ErrAttachmentSlotShape() | attachment-slot-shape | attachment does not conform to its declared slot shape |
ErrConnectionAttachmentSlotUndeclared() | connection-attachment-slot-undeclared | a connection carries an attachment under a name its socket declares no slot for |
ErrDuplicateBoundaryComponent() | duplicate-boundary-component | component declared in more than one boundary: declare each component in exactly one boundary |
ErrDuplicateTriadIdentity() | duplicate-triad-identity | duplicate Aggregate/Manifest identity (metadata.name) in the Release directory |
ErrFeatureMergeConflict() | feature-merge-conflict | feature merge conflict: reconcile the Aggregate and Release declarations for the feature |
ErrGuardEntityViewInconsistency() | internal-catalog-view-disagreement | the compiler's own views of the catalog disagree |
ErrInheritedBoundaryDirectoryIsLiteral() | inherited-boundary-directory-is-literal | inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to |
ErrInjectDeliveryShape() | inject-delivery-shape | inject delivery: shape must be a list of entries, each `in:` with exactly one of `from:` or `value:` |
ErrInjectEntryAmbiguous() | inject-entry-ambiguous | inject entry carries both `value:` and `from:`; schema requires exactly one |
ErrInjectKeyCollision() | inject-key-collision | duplicate delivery key across inject sources |
ErrInvalidInjectKey() | invalid-inject-key | invalid inject key: the from-key must name a provides key its source publishes |
ErrInvalidParameterRef() | invalid-parameter-ref | invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template |
ErrMalformedRecipeReference() | malformed-recipe-reference | malformed recipe reference in a Manifest mapping value |
ErrManifestCrossBindingPillarCollision() | manifest-cross-binding-pillar-collision | manifest annotation bindings collide on same Feature path+pillar |
ErrManifestImplementsMismatch() | manifest-implements-mismatch | manifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type key |
ErrManifestReservedPrefix() | manifest-reserved-prefix | manifest annotation binding uses reserved prefix |
ErrMisnamedSlotFill() | misnamed-slot-fill | attachment written under a name no slot declares fits a slot its component leaves empty |
ErrMissingRequiredFeature() | missing-required-feature | missing required feature: attach a Feature of the required type to the component |
ErrMissingRequiredSocket() | missing-required-socket | required uses socket not populated |
ErrParameterContractViolation() | parameter-contract-violation | parameter contract violated |
ErrParameterMissing() | parameter-missing | required parameter not supplied |
ErrProvidesKeyNotDeclared() | provides-key-not-declared | Recipe publishes a provides key its Component does not declare |
ErrReleaseChainComposesBothRoutingKeys() | release-chain-composes-both-routing-keys | release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both |
ErrSchemaConformance() | schema-conformance | authored pillar does not conform to its declared schema |
ErrSchemaContractCompileFailure() | schema-contract-compile-failure | declared 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-forbidden | self-inject on component without spec.inject allowlist |
ErrTriadRefUnresolvable() | triad-ref-unresolvable | aggregate/manifest reference unresolvable |
ErrUnknownUsesSocket() | unknown-uses-socket | unknown 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-form | release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary) |
ErrUnreadParameter() | unread-parameter | declared parameter is read by no reference in the Aggregate |
ErrUsesInjectValue() | uses-inject-value | inject entry on a connection carries `value:`; a connection delivers the target's published keys, each named with `from:` |
ErrUsesSocketNearMiss() | uses-socket-near-miss | uses socket name is a near miss for a declared socket |
ErrVerdictPluginTrustMismatch() | verdict-plugin-trust-mismatch | the digest recorded as trusted for this plugin does not match the digest its cached manifest reports |
ErrYAMLLoad() | document-not-loadable | file load failed: the file could not be read, or its bytes did not parse |
pkg/signing
| Centinela | Código | Mensaje |
|---|---|---|
ErrKeylessLive() | keyless-signing-requires-network | signing: keyless signing requires a live identity provider, Fulcio, and Rekor |
ErrMixedSigningCredentials() | mixed-signing-credentials | signing: the references named together need different signing credentials, so nothing was signed |
ErrNoSignatureFound() | no-signature-found | signing: no signature found for an artifact that requires one |
ErrNoTrustedIdentities() | no-trusted-identities | signing: keyless verification requires at least one trusted identity |
ErrSignatureInvalid() | signature-invalid | signing: signature does not verify |
ErrSignatureVerificationFailed() | signature-verification-failed | signing: signature bundle does not verify |
ErrSigningPolicyRequiresSignature() | signing-policy-requires-signature | signing: signing policy requires a signature for this artifact kind; refusing to push unsigned content |
ErrTrustRootLoad() | trust-root-not-loadable | signing: cannot load pinned trust root |
ErrUnsignedPushRefused() | unsigned-push-refused | signing: registry requires signatures; refusing to push unsigned content |
ErrUnsupportedKey() | unsupported-key | signing: unsupported held-key type |
ErrUntrustedIdentity() | untrusted-identity | signing: signature identity is not trusted for this registry |
pkg/sourcecache
| Centinela | Código | Mensaje |
|---|---|---|
ErrFetchIntegrity() | fetch-integrity | oci: content digest mismatch |
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrFetchIntegrity()es el mismo valor quepkg/oci.ErrFetchIntegrity(), así que hacer coincidir con cualquiera de los dos nombres funciona.ErrFetchNotFound()es el mismo valor quepkg/oci.ErrFetchNotFound(), así que hacer coincidir con cualquiera de los dos nombres funciona.
pkg/sourcekind
| Centinela | Código | Mensaje |
|---|---|---|
ErrUnknownKind() | unknown-source-kind | no source adapter serves the source kind |
pkg/sourceresolver
| Centinela | Código | Mensaje |
|---|---|---|
ErrFetchIntegrity() | fetch-integrity | oci: content digest mismatch |
ErrFetchNetworkUnreachable() | fetch-network-unreachable | oci: network unreachable |
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrFetchUnauthorized() | fetch-unauthorized | oci: authentication required or failed |
ErrNoAdapterRegistered() | source-adapter-not-registered | no source adapter is registered in this program for the source kind |
ErrFetchIntegrity()es el mismo valor quepkg/oci.ErrFetchIntegrity(), así que hacer coincidir con cualquiera de los dos nombres funciona.ErrFetchNetworkUnreachable()es el mismo valor quepkg/oci.ErrFetchNetworkUnreachable(), así que hacer coincidir con cualquiera de los dos nombres funciona.ErrFetchNotFound()es el mismo valor quepkg/oci.ErrFetchNotFound(), así que hacer coincidir con cualquiera de los dos nombres funciona.ErrFetchUnauthorized()es el mismo valor quepkg/oci.ErrFetchUnauthorized(), así que hacer coincidir con cualquiera de los dos nombres funciona.
pkg/sourceresolver/cacheslot
| Centinela | Código | Mensaje |
|---|---|---|
ErrEmptyWorkspaceRoot() | empty-workspace-root | cacheslot: empty workspaceRoot |
pkg/sourceresolver/netrc
| Centinela | Código | Mensaje |
|---|---|---|
ErrNetrcFileUnreadable() | netrc-file-unreadable | the netrc file could not be read |
ErrSourceURLCarriesCredential() | source-url-carries-credential | the source URL carries a credential |
pkg/types
| Centinela | Código | Mensaje |
|---|---|---|
ErrArtifactEntryShape() | artifact-entry-shape | artifacts entry: shape must be a string scalar or {$import: <local-path>} |
ErrArtifactLibraryEntryShape() | artifact-library-entry-shape | artifactlibrary: entry must be a mapping of filename to a string body |
ErrForbiddenKeyword() | forbidden-keyword | schemalibrary: forbidden JSON Schema keyword |
ErrLibraryReferenceWhitespace() | library-reference-whitespace | library reference: a reference to a library entry carries no whitespace or line break |
ErrMalformedVersionPin() | malformed-version-pin | reference carries a malformed version pin |
ErrMappingEntryNotScalar() | mapping-entry-not-scalar | mappinglibrary: entry body must be a string scalar |
ErrOrderedMapDecodeDepthExceeded() | document-nesting-depth-exceeded | a document nests too many levels deep |
ErrParametersShape() | parameters-shape | parameters: shape must be an inline object or {$import: <local-path>} |
ErrTemplateNotFound() | template-not-found | schemalibrary: template not found |
ErrTemplateParamMissing() | template-param-missing | schemalibrary: template parameter missing |
ErrTemplateParamTypeMismatch() | template-param-type-mismatch | schemalibrary: template parameter type mismatch |
ErrValuesMappingShape() | values-mapping-shape | valuesmapping: shape must be a string scalar or {$import: <path-or-library-identity>} |
ErrWellKnownAnnotationScope() | well-known-annotation-scope | wellKnownAnnotations: a key is declared at a scope the provider's contract does not render |
ErrWorkloadEntryNotScalar() | workload-entry-not-scalar | workloadlibrary: entry body must be a string scalar |
ErrWorkloadTemplateShape() | workload-template-shape | workload: shape must be a string scalar or {$import: <path-or-library-identity>} |
pkg/usesedge
| Centinela | Código | Mensaje |
|---|---|---|
ErrDanglingUsesTarget() | dangling-uses-target | uses edge target does not exist |
ErrReleaseEdgeRetarget() | release-edge-retarget | release edge retargets a developer-declared edge |
pkg/validator
| Centinela | Código | Mensaje |
|---|---|---|
ErrAssertionNameCollision() | assertion-name-collision | assertion name declared twice across the extends chain |
ErrCyclicExtension() | cyclic-extension | cyclic extends chain |
ErrDuplicateContainerEnvironmentVariable() | duplicate-container-environment-variable | a container declares one environment variable twice |
ErrEmptySource() | recipe-source-is-empty | recipe source is an empty string, which names neither sourceless mode nor sourced mode |
ErrExtendsChainTooDeep() | extends-chain-too-deep | extends chain exceeds maximum depth |
ErrFeatureRecipeValuesMappingRequiresSource() | feature-recipe-values-mapping-requires-source | FeatureRecipe: valuesMapping requires source |
ErrInheritanceMerge() | extends-merge-failed | inheritance merge failed |
ErrRecipeFilenameCollisionAcrossInputKinds() | recipe-filename-collision-across-input-kinds | filename collision across input kinds: two input-kind blocks produced a file under one output name |
ErrRecipeNoInputKind() | recipe-no-input-kind | Recipe: at least one input kind required |
ErrRecipeOutputComponentLabelCollision() | recipe-output-component-label-collision | recipe output-component-labels constraint: key is also declared in outputLabels |
ErrRecipeOutputLabelReservedNamespace() | recipe-output-label-reserved-namespace | recipe output-labels constraint: key uses a reserved namespace |
ErrRecipeValuesMappingRequiresSource() | recipe-values-mapping-requires-source | Recipe: valuesMapping requires source |
ErrSlotNotReferenceable() | slot-not-referenceable | workload attachment slot is not referenceable |
ErrUnknownSchemaPillar() | unknown-schema-pillar | a schema block declares a key that names no data pillar |
ErrWorkloadFeaturesSchema() | workload-features-schema | workload featuresSchema cross-check failed |
ErrWorkloadValidation() | workload-not-valid | workload validation failed |
pkg/validator/envelope
| Centinela | Código | Mensaje |
|---|---|---|
ErrDuplicatePipelineStepID() | duplicate-pipeline-step-id | a pipeline declares one step id twice |
ErrEntityEnvelope() | entity-envelope-invalid | document envelope validation failed |
ErrRetiredABIVersion() | retired-abi-version | a plugin declares a plugin ABI version this compiler no longer speaks |
ErrRetiredAPIVersion() | retired-api-version | a document declares an API version this compiler no longer reads |
pkg/validator/jsonschema
| Centinela | Código | Mensaje |
|---|---|---|
ErrExtensionEval() | schema-extension-evaluation-failed | validator/jsonschema: x-aggrega extension evaluation failed |
ErrSchemaResolve() | schema-not-resolvable | validator/jsonschema: schema resolution failed |
pkg/validator/merger
| Centinela | Código | Mensaje |
|---|---|---|
ErrMergeInvalid() | schema-merge-input-invalid | merger: invalid merge input |
pkg/workspaceconfig
| Centinela | Código | Mensaje |
|---|---|---|
ErrAmbiguousRegistryAlias() | ambiguous-registry-alias | registry alias matches more than one host |
ErrCapabilityOnCrossCuttingSocket() | capability-on-cross-cutting-socket | a cross-cutting socket is bound by capability but attaches by uri |
ErrColonInProviderBindingCapability() | colon-in-provider-binding-capability | a provider socket binding names a capability containing a colon, which no Recipe can select |
ErrConfigInvalid() | workspace-config-invalid | workspace configuration is invalid |
ErrDuplicateImporterAttachment() | duplicate-importer-attachment | importer is attached by more than one plugins.importer entry |
ErrDuplicateProviderTarget() | duplicate-provider-target | capability is bound to more than one provider plugin |
ErrDuplicateRegistryAlias() | duplicate-registry-alias | registry alias is already used by another host |
ErrGovernanceRoleInvalid() | governance-role-invalid | a governance attachment declares no role or an unknown role |
ErrInertFieldOnProviderSocket() | inert-field-on-provider-socket | a provider socket binding sets a field with no referent on that socket |
pkg/writescope
| Centinela | Código | Mensaje |
|---|---|---|
ErrWriteLeadsOutOfWorkspace() | write-leads-out-of-workspace | a path this operation writes or deletes leads through a link out of the directory it must stay inside |
pkg/yamlpos
| Centinela | Código | Mensaje |
|---|---|---|
ErrPositionOutOfRange() | position-out-of-range | position 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íaPOLICY_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 depkg/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ódigo | Condición | Mensaje |
|---|---|---|
E0001 | no-plugin-resolution-configured | cliplugin: no plugin resolver configured |
E0003 | malformed-attachment-requirement | malformed attachment requirement |
E0004 | overridden-annotation | annotation contribution overridden by an explicit value |
E0005 | policy-violation | policy violation |
E0006 | required-slot-unfilled | required attachment slot unfilled |
E0007 | selector-violation | selector violation |
E0008 | slot-selector-unsatisfied | attachment slot selector unsatisfied |
E0009 | pipeline-contract-violation | pipeline step typed-I/O contract violation |
E0010 | pipeline-step-failed | pipeline step failed |
E0011 | pipeline-target-absent | pipeline patch targets a document not present in the set |
E0012 | pipeline-target-opaque | pipeline patch targets an opaque (non-structured) unit |
E0013 | feature-type-mismatch | feature type mismatch between Aggregate and Release |
E0014 | inject-entry-ambiguous | inject entry carries both `value:` and `from:`; schema requires exactly one |
E0015 | uses-inject-forbidden | uses-edge inject dictates a delivery mechanism the socket does not permit |
E0016 | patch-test-operation-failed | jsonpatch: test operation failed |
E0017 | annotation-injection-rejected | annotation-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 |
E0018 | policy-settings-invalid | policy attachment settings do not satisfy the plugin's declared settings schema |
E0019 | endpoint-requires-reference-form | endpoint requires form: reference |
E0020 | invalid-cron-schedule | schedule is not a valid cron expression |
E0021 | persistent-template-requires-stateful-form | persistentTemplate volume requires form: stateful |
E0022 | pipeline-patch-target-not-structured | pipeline PATCH target is not parseable structured YAML/JSON |
E0023 | reference-form-requires-endpoint | form: reference requires an endpoint |
E0024 | schedule-requires-scheduled-form | schedule requires form: scheduled |
E0025 | scheduled-form-requires-schedule | form: scheduled requires a schedule |
E0026 | artifact-content-mismatch | imported artifact content does not match the digest recorded for it in entity.lock |
E0027 | artifact-import-shape | artifacts $import: is not a bare-name artifact-library reference (<Library>#/artifacts/<entry>) |
E0028 | artifact-output-collision | artifacts output filename collision: two artifact outputs carry the same filename |
E0029 | artifact-pillar-not-declared | artifact template references a pillar the Recipe does not declare |
E0030 | artifact-library-entry-not-found | artifact-library import references a bundle not present in the ArtifactLibrary |
E0031 | artifact-library-not-found | artifact-library import references an ArtifactLibrary not present in the catalog |
E0032 | assembled-output-collision | assembled output collision: two contributors write the same output path |
E0033 | authored-assertion-failed | assertion failed |
E0034 | attachment-inject-key-collision | duplicate delivery key across attachment-inject and another inject source |
E0035 | boundary-assembly-not-provided | provider expected to assemble its dispatch group provides no boundary assembler |
E0036 | chart-name-mismatch | merged-path assembly has conflicting assembly-name annotation values |
E0037 | cross-provider-link-unsupported | cross-boundary link between endpoints rendered by different providers is not supported |
E0038 | derived-key-collision | derived name collision: one name is derived more than once in one key space |
E0039 | featurerecipe-template-invalid-field | FeatureRecipe template references a per-component-only field with executionScope: boundary |
E0040 | host-in-library-import | library $import: carries a registry host; reference the library by bare-name identity |
E0041 | instance-id-collision | multiple contributors share an instance ID at the same dispatch path |
E0042 | locals-forward-reference | locals entry references a sibling defined later in the same block |
E0043 | locals-unknown-reference | template references a key the locals block does not declare |
E0044 | mapping-entry-not-found | mapping-library import references an entry not present in the MappingLibrary |
E0045 | mapping-import-shape | valuesMapping $import: is not a bare-name mapping-library reference (<Library>#/mappings/<entry>) |
E0046 | mapping-library-not-found | mapping-library import references a MappingLibrary not present in the catalog |
E0047 | orphan-cross-boundary-link-placeholder | assembled output retains an unresolved cross-boundary link placeholder |
E0048 | path-collision | dispatch path produced multiple provider outputs |
E0049 | path-template-invalid-field | path template references a field not in the documented allowlist |
E0050 | pipeline-host-scope-unavailable | pipeline /host operation from a step with no host component |
E0051 | pipeline-patch-targets-unassembled-fragments | pipeline PATCH targets an assembler provider's pre-assembly fragments |
E0052 | pipeline-target-not-emitted | pipeline PATCH targets a document the node did not emit |
E0053 | plugin-provider-incompatible | pipeline plugin is not compatible with the rendering provider |
E0054 | provider-node-input-invalid | provider rejected node input |
E0055 | provides-contract-unfulfilled | Recipe or FeatureRecipe does not publish a provides key its abstract entity's schema.provides contract declares |
E0056 | provides-evaluation-failed | provides template evaluation failed |
E0057 | provides-self-containment | provides block references a root outside the self-contained set |
E0058 | render-nondeterministic | provider render is not deterministic |
E0059 | self-inject-key-collision | duplicate delivery key across self-inject and uses-inject |
E0060 | template-unknown-root | template references a root the render context does not define |
E0061 | unknown-provider | unknown provider |
E0062 | custom-mechanism-has-no-mapping | custom inject mechanism has no matching key in injectMapping output; add the mechanism's key to the Recipe injectMapping |
E0063 | workload-entry-not-found | workload-library import references an entry not present in the WorkloadLibrary |
E0064 | workload-import-shape | workload $import: is not a bare-name workload-library reference (<Library>#/workloads/<entry>) |
E0065 | workload-library-not-found | workload-library import references a WorkloadLibrary not present in the catalog |
E0066 | dangling-uses-target | uses edge target does not exist |
E0067 | active-toggle-not-a-boolean | active toggle did not resolve to a boolean |
E0068 | sub-aggregate-nesting-depth-exceeded | max sub-aggregate nesting depth exceeded |
E0069 | mutator-patch-rejected | mutator patch rejected |
E0070 | reexport-cycle | re-exported component alias forms a cycle |
E0071 | release-edge-retarget | release edge retargets a developer-declared edge |
E0072 | sub-aggregate-not-loadable | sub-aggregate load failed |
E0073 | sub-aggregate-name-collision | flattened node ID collision: rename one of the colliding instances so their flattened IDs differ |
E0074 | unbound-release-edge-config | release per-edge configuration has no edge to apply to |
E0075 | aggregate-not-in-canonical-form | aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem) |
E0076 | unplaced-sub-module | sub-module placed in no boundary: route it into a boundary under `aggregates`, or name its components there under `components` |
E0077 | uses-target-not-active | uses edge target was pruned because its active toggle resolved to false |
E0078 | wasm-nested-producer-consumption-denied | producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption call |
E0079 | wasm-command-set-mismatch | wasm: recorded command mirror does not match plugin describe() |
E0080 | wasm-contract-mismatch | wasm: entity contract claim does not match plugin describe() |
E0081 | wasm-diagnostic-severity-invalid | wasm: guest plugin returned a diagnostic whose severity the contract does not declare |
E0082 | wasm-guest-error | wasm: guest plugin reported an error |
E0083 | wasm-guest-panic | wasm: guest plugin panicked during call |
E0084 | wasm-host-function-set-mismatch | wasm: stamped host-function record does not match .wasm imports |
E0085 | wasm-manifest-rejected | wasm: plugin rejected by the sandbox |
E0086 | wasm-plugin-exited | wasm: plugin invoked proc_exit |
E0087 | wasm-plugin-type-mismatch | wasm: declared plugin type does not match plugin describe() |
E0088 | wasm-plugin-version-mismatch | wasm: entity metadata.version does not match plugin describe() |
E0089 | all-versions-retracted | every published version this reference could select has been withdrawn |
E0090 | ambiguous-importer-plugin | format is advertised by more than one importer plugin |
E0091 | ambiguous-parser-plugin | format is advertised by more than one parser plugin |
E0092 | ambiguous-provider-plugin | capability is served by more than one provider plugin; add a plugins.providers entry to select one |
E0093 | ambiguous-type-mapping | manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous |
E0094 | duplicate-entity-identity | duplicate entity identity within a single catalog directory |
E0095 | malformed-recipe-reference | malformed recipe reference in a Manifest mapping value |
E0096 | manifest-implements-mismatch | manifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type key |
E0097 | no-importer-for-format | no importer plugin advertises the requested format |
E0098 | no-parser-for-format | no parser plugin advertises the requested format |
E0099 | no-recipe-resolved | no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type |
E0100 | provider-binding-unsatisfied | plugins.providers entry names a plugin no provider-rendering plugin serving the capability matches |
E0101 | provider-version-unsatisfiable | no provider-rendering plugin version satisfies the recipe's provider version pin |
E0102 | plugin-reference-must-not-be-registry-qualified | wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path |
E0103 | unsatisfiable-entity-version | no catalog version satisfies the referenced version constraint |
E0104 | plugin-reference-must-be-scoped | wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location |
E0105 | recipe-reference-must-be-scoped | recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location |
E0106 | invalid-library-ref | resolve: invalid library reference URI |
E0107 | version-selection-conflict | resolve: minimal version selection conflict — incompatible library version requirements |
E0108 | catalog-cannot-load-sub-aggregate-bodies | resolve: catalog lookup cannot load resolved sub-aggregate bodies |
E0109 | catalog-cannot-load-recipe-bodies | resolve: catalog lookup cannot load resolved recipe and plugin bodies |
E0110 | source-template-at-lock-time | resolve: source-template evaluation failure at lock time |
E0111 | source-template-not-parsable | resolve: source-template parse error |
E0112 | source-template-provides-ref | resolve: source-template references .provides (invalid reverse reference) |
E0113 | sub-aggregate-depth | resolve: sub-aggregate inclusion depth exceeded |
E0114 | unresolvable-uri | resolve: no entity in the catalog matches this URI |
E0115 | ambiguous-dispatch | compactform: ambiguous dispatch — $mode required |
E0116 | constraint-type-mismatch | compactform: constraint not valid for declared type |
E0117 | escape-content-invalid | compactform: $jsonschema content invalid |
E0118 | host-in-library-ref | compactform: cross-document $ref carries a registry host; reference the library by identity |
E0119 | reference-unresolvable | compactform: $ref unresolvable |
E0120 | unknown-keyword | compactform: unknown keyword |
E0121 | unresolved-schema-library-ref | compactform: cross-document $ref target not found |
E0122 | deprecated-entity | deprecation: build consumes a deprecated entity |
E0123 | not-docs-bundle | docscache: artifact is not a documentation bundle |
E0124 | page-not-found | docscache: page not found in documentation bundle |
E0125 | offline-egress | egress: 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 |
E0126 | acquisition-disabled | externalinputs: acquisition is disabled for unpinned inputs |
E0127 | digest-mismatch | externalinputs: fetched bytes mismatch the pinned digest |
E0128 | scheme-not-allowed | externalinputs: URL scheme is not allowed |
E0129 | store-corrupt | externalinputs: store blob mismatches its pinned record |
E0130 | lockfile-drift | lockfile: out of date; it no longer matches what its Release resolves to |
E0131 | lockfile-invalid | lockfile: file failed schema validation |
E0132 | ambiguous-content-layer | oci: manifest has multiple layers of the expected content media type |
E0133 | cached-manifest-integrity | oci: cached manifest digest mismatch |
E0135 | fetch-integrity | oci: content digest mismatch |
E0136 | fetch-network-unreachable | oci: network unreachable |
E0137 | fetch-not-found | oci: artifact not found at remote source |
E0138 | fetch-unauthorized | oci: authentication required or failed |
E0139 | immutable-tag-conflict | oci: tag already published with different content |
E0140 | no-content-layer | oci: manifest has no layer of the expected content media type |
E0141 | oci-location-collision | oci: distinct catalog identities map to the same OCI repository location |
E0142 | referrer-discovery-unavailable | oci: referrer discovery could not be completed |
E0143 | unknown-entity-kind | oci: unknown entity kind for mediatype dispatch |
E0144 | signature-bundle-digest-mismatch | cached signature bundle does not match its recorded digest |
E0145 | plugin-entity-not-found | plugin reference is not a Plugin entity |
E0146 | reference-cycle | circular reference expansion |
E0147 | malformed-trust-policy | registrytrust: advertised trust config is malformed |
E0148 | no-trust-advertised | registrytrust: registry advertises no trust config |
E0149 | attachment-slot-near-miss | attachment name is a near miss for a declared slot |
E0150 | attachment-slot-shape | attachment does not conform to its declared slot shape |
E0151 | duplicate-boundary-component | component declared in more than one boundary: declare each component in exactly one boundary |
E0152 | duplicate-triad-identity | duplicate Aggregate/Manifest identity (metadata.name) in the Release directory |
E0153 | feature-merge-conflict | feature merge conflict: reconcile the Aggregate and Release declarations for the feature |
E0154 | internal-catalog-view-disagreement | the compiler's own views of the catalog disagree |
E0155 | inject-key-collision | duplicate delivery key across inject sources |
E0156 | invalid-inject-key | invalid inject key: the from-key must name a provides key its source publishes |
E0158 | invalid-parameter-ref | invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template |
E0160 | manifest-cross-binding-pillar-collision | manifest annotation bindings collide on same Feature path+pillar |
E0161 | manifest-reserved-prefix | manifest annotation binding uses reserved prefix |
E0162 | missing-required-feature | missing required feature: attach a Feature of the required type to the component |
E0163 | missing-required-socket | required uses socket not populated |
E0164 | parameter-contract-violation | parameter contract violated |
E0165 | parameter-missing | required parameter not supplied |
E0167 | provides-key-not-declared | Recipe publishes a provides key its Component does not declare |
E0168 | schema-conformance | authored pillar does not conform to its declared schema |
E0169 | self-inject-forbidden | self-inject on component without spec.inject allowlist |
E0170 | triad-ref-unresolvable | aggregate/manifest reference unresolvable |
E0171 | unknown-uses-socket | unknown 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 |
E0172 | release-not-in-canonical-form | release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary) |
E0173 | unread-parameter | declared parameter is read by no reference in the Aggregate |
E0174 | uses-socket-near-miss | uses socket name is a near miss for a declared socket |
E0175 | document-not-loadable | file load failed: the file could not be read, or its bytes did not parse |
E0176 | keyless-signing-requires-network | signing: keyless signing requires a live identity provider, Fulcio, and Rekor |
E0177 | no-signature-found | signing: no signature found for an artifact that requires one |
E0178 | no-trusted-identities | signing: keyless verification requires at least one trusted identity |
E0179 | signature-invalid | signing: signature does not verify |
E0180 | signature-verification-failed | signing: signature bundle does not verify |
E0181 | signing-policy-requires-signature | signing: signing policy requires a signature for this artifact kind; refusing to push unsigned content |
E0182 | trust-root-not-loadable | signing: cannot load pinned trust root |
E0183 | unsigned-push-refused | signing: registry requires signatures; refusing to push unsigned content |
E0184 | unsupported-key | signing: unsupported held-key type |
E0185 | untrusted-identity | signing: signature identity is not trusted for this registry |
E0186 | unknown-source-kind | no source adapter serves the source kind |
E0187 | empty-workspace-root | cacheslot: empty workspaceRoot |
E0188 | artifact-entry-shape | artifacts entry: shape must be a string scalar or {$import: <local-path>} |
E0189 | artifact-library-entry-shape | artifactlibrary: entry must be a mapping of filename to a string body |
E0190 | forbidden-keyword | schemalibrary: forbidden JSON Schema keyword |
E0191 | mapping-entry-not-scalar | mappinglibrary: entry body must be a string scalar |
E0192 | document-nesting-depth-exceeded | a document nests too many levels deep |
E0193 | parameters-shape | parameters: shape must be an inline object or {$import: <local-path>} |
E0194 | template-not-found | schemalibrary: template not found |
E0195 | template-param-missing | schemalibrary: template parameter missing |
E0196 | template-param-type-mismatch | schemalibrary: template parameter type mismatch |
E0197 | values-mapping-shape | valuesmapping: shape must be a string scalar or {$import: <path-or-library-identity>} |
E0198 | well-known-annotation-scope | wellKnownAnnotations: a key is declared at a scope the provider's contract does not render |
E0199 | workload-entry-not-scalar | workloadlibrary: entry body must be a string scalar |
E0200 | workload-template-shape | workload: shape must be a string scalar or {$import: <path-or-library-identity>} |
E0201 | assertion-name-collision | assertion name declared twice across the extends chain |
E0202 | cyclic-extension | cyclic extends chain |
E0204 | feature-recipe-values-mapping-requires-source | FeatureRecipe: valuesMapping requires source |
E0205 | extends-merge-failed | inheritance merge failed |
E0207 | recipe-output-component-label-collision | recipe output-component-labels constraint: key is also declared in outputLabels |
E0208 | recipe-output-label-reserved-namespace | recipe output-labels constraint: key uses a reserved namespace |
E0209 | recipe-values-mapping-requires-source | Recipe: valuesMapping requires source |
E0210 | recipe-no-input-kind | Recipe: at least one input kind required |
E0211 | recipe-filename-collision-across-input-kinds | filename collision across input kinds: two input-kind blocks produced a file under one output name |
E0212 | slot-not-referenceable | workload attachment slot is not referenceable |
E0213 | workload-features-schema | workload featuresSchema cross-check failed |
E0214 | workload-not-valid | workload validation failed |
E0215 | entity-envelope-invalid | document envelope validation failed |
E0216 | schema-extension-evaluation-failed | validator/jsonschema: x-aggrega extension evaluation failed |
E0218 | schema-not-resolvable | validator/jsonschema: schema resolution failed |
E0220 | extends-chain-too-deep | extends chain exceeds maximum depth |
E0221 | schema-merge-input-invalid | merger: invalid merge input |
E0222 | ambiguous-registry-alias | registry alias matches more than one host |
E0223 | capability-on-cross-cutting-socket | a cross-cutting socket is bound by capability but attaches by uri |
E0224 | workspace-config-invalid | workspace configuration is invalid |
E0225 | duplicate-provider-target | capability is bound to more than one provider plugin |
E0226 | duplicate-registry-alias | registry alias is already used by another host |
E0227 | governance-role-invalid | a governance attachment declares no role or an unknown role |
E0228 | inert-field-on-provider-socket | a provider socket binding sets a field with no referent on that socket |
E0229 | position-out-of-range | position out of range |
E0246 | verdict-plugin-trust-mismatch | the digest recorded as trusted for this plugin does not match the digest its cached manifest reports |
E0247 | verdict-attachment-not-configured | a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role |
E0248 | wasm-output-shape | wasm: guest plugin returned an output that is not the shape the socket reads |
E0250 | nest-segment-not-one-directory | provider named a directory for each contributor's own sub-directory that is not a single directory name |
E0251 | recipe-source-is-empty | recipe source is an empty string, which names neither sourceless mode nor sourced mode |
E0252 | artifact-library-file-escapes-key | artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under |
E0253 | annotation-binding-target-unresolved | annotation binding does not resolve against its target Feature |
E0254 | annotation-subkey-not-conforming | annotation subkey does not conform to the target Feature's schema at the routed pillar |
E0255 | annotation-side-pillar-mismatch | annotation routes through a pillar its authoring side may not use |
E0256 | annotation-binding-pillar-overlap | annotation binding declares one path in both pillar lists |
E0257 | schema-contract-compile-failure | declared 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 |
E0259 | boundary-scope-attachment-not-declared-at-a-boundary | attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it |
E0260 | unplaced-component | component placed in no boundary: name it under a boundary's `components`, or place the sub-module that contributes it under `aggregates` |
E0261 | unresolved-boundary-component | boundary names a component the composition does not hold: correct the name, or remove the entry |
E0262 | unusable-component-identity | component identity cannot be the name its emitted resources are stamped with: rename the component |
E0263 | component-identity-target-refuses | the target will not accept a name derived from this component's authored identity: rename the component |
E0264 | provider-refused-every-component-identity | provider guest never accepted a component identity the compiler composed for it |
E0265 | unsupported-input-kind | provider does not support the node's input kind |
E0266 | unusable-schema-import | a schema `$import:` could not be applied |
E0267 | unknown-schema-pillar | a schema block declares a key that names no data pillar |
E0268 | pipeline-patch-unit-not-carved | reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokens |
E0269 | provider-render-duplicate-path | provider guest returned two output files under one path; a conforming guest returns each output path at most once |
E0270 | link-patch-file-not-emitted | link patch names an output file the dispatch group did not emit; a conforming link patch names a file the group's own render returned |
E0271 | pipeline-emit-file-absent | emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and content |
E0272 | pipeline-side-effect-kind-undefined | side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crd |
E0273 | rendered-name-unavailable | template 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 |
E0274 | verdict-plugin-identity-changed | the plugin identity recorded as trusted no longer matches what this resolution reports |
E0275 | edit-refused-invalid-result | the edit was refused because the resulting document would not be valid, and nothing was written |
E0276 | schema-evolution | the version being published changes the published predecessor in a way the documented evolution rubric objects to |
E0277 | annotation-prefix | an annotation key on the entity uses a prefix the platform reserves |
E0278 | name-shape | the entity's name does not follow the documented name shape for its kind |
E0279 | dynamic-refs | a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot follow |
E0280 | id-overrides | a schema in the entity declares an identifier of its own, where the platform owns that schema's identity |
E0281 | category-matches-directory | the entity's category label does not match the category directory the entity is filed under |
E0282 | x-aggrega-discouragement | the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchema |
E0283 | plugin-default-limits | the Plugin entity declares no runtime resource cap of its own, so the platform defaults apply |
E0284 | secret-slot-declares-sensitive | an attachment slot admits only secret material and does not declare that it handles it |
E0285 | provides-declared-by-component | the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refused |
E0286 | publish-bump-below-classification | the version bump being published is smaller than the evolution check's classification of the change requires |
E0287 | import-halting-diagnostic | the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring files |
E0288 | plugin-cannot-express-input | a plugin has no expression for a construct this build declares |
E0289 | plugin-required-input-unresolved | a plugin could not resolve something it requires to exactly one value |
E0290 | plugin-output-name-collision | two things a plugin produced occupy one name in its output |
E0291 | plugin-value-not-representable | a plugin has no representation for a value it was given |
E0292 | plugin-failure-unclassified | a plugin reported a failure that none of the declared kinds names |
E0293 | wasm-guest-condition-undeclared | wasm: guest plugin named a condition the socket does not declare |
E0294 | subsystem-component-identity-collision | components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component's identity |
E0295 | library-reference-whitespace | library reference: a reference to a library entry carries no whitespace or line break |
E0296 | release-chain-composes-both-routing-keys | release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both |
E0297 | inherited-boundary-directory-is-literal | inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to |
E0298 | bundle-no-entity-document | oci: published bundle carries no entity document |
E0299 | bundle-ambiguous-entity-document | oci: published bundle carries more than one entity document |
E0300 | bundle-unreadable | oci: published bundle cannot be unpacked |
E0301 | published-artifact-not-an-entity | oci: published artifact is not an entity document |
E0302 | entity-not-pinned | an input the entity reads has no pin recorded for it in the entity.lock beside it |
E0303 | entity-shares-its-directory | the entity shares its directory with another entity, and an entity of its kind has a directory of its own |
E0304 | content-outside-entity-directory | a path names content outside the entity's own directory |
E0305 | local-source-content-mismatch | the files of the entity's local source do not match the pins recorded for them in entity.lock |
E0306 | plugin-artifact-not-found | plugin artifact not found on this machine |
E0307 | cache-location-outside-cache | a value a cache location is built from would place cached files outside the place it names in the cache |
E0308 | conflicting-features-reach-one-component | a Feature reaches a component alongside a Feature it declares a conflict with |
E0309 | symbolic-link-in-entity-files | a symbolic link sits among the files an entity carries |
E0310 | offline-registration-without-trust-policy | a 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>` |
E0311 | malformed-version-pin | reference carries a malformed version pin |
E0312 | colon-in-provider-binding-capability | a provider socket binding names a capability containing a colon, which no Recipe can select |
E0313 | provider-binding-capability-unserved | plugins.providers entry names a capability no provider-rendering plugin the build reads serves |
E0314 | plugin-built-from-uncommitted-changes | plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reports |
E0315 | connection-attachment-slot-undeclared | a connection carries an attachment under a name its socket declares no slot for |
E0316 | connection-attachment-written-off-its-connection | a Release attachment takes the name of an attachment one of a component's connections carries |
E0317 | release-connection-attachment-untyped | a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makes |
E0318 | attachment-inject-mapping-key-collision | duplicate delivery key across two attachments: an attachment's FeatureRecipe writes a delivery key another attachment already delivered |
E0319 | duplicate-connection-alias | connection alias is already used by another connection of the same component |
E0320 | write-leads-out-of-workspace | a path this operation writes or deletes leads through a link out of the directory it must stay inside |
E0321 | read-leads-out-of-workspace | a file this operation reads leads through a link out of the directory it must stay inside |
E0323 | caller-render-facts-not-declared | template reads its callers' render facts, but the FeatureRecipe does not set readsCallerRenderFacts |
E0324 | reference-leads-out-of-workspace | a reference a document makes to another file leads out of the directory it must stay inside |
E0325 | provider-render-fact-not-list | provider 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 |
E0326 | pipeline-step-reads-caller-render-facts | pipeline 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 |
E0327 | index-of-absent-map-key | template indexes a map with a key the map does not hold |
E0328 | misnamed-slot-fill | attachment written under a name no slot declares fits a slot its component leaves empty |
E0329 | connection-credential-matches-target-key | a connection and the target it reaches do not name one key: they write different locators for it, or only one of them names one |
E0330 | mixed-signing-credentials | signing: the references named together need different signing credentials, so nothing was signed |
E0331 | signature-not-recorded | signing: no verified signature is recorded for an artifact that requires one |
E0332 | signature-for-another-artifact | signing: the recorded signature was made for a different artifact |
E0333 | recorded-signature-out-of-date | signing: a recorded signature is not the one a pull would record |
E0334 | omit-matched-nothing | an omits entry left out nothing the source rendered |
E0335 | unsupported-omits | provider does not support omits |
E0336 | omit-report-mismatch | a provider's omitted counts do not match the omits entries it was handed |
E0337 | importer-version-unsatisfiable | no importer plugin version satisfies the plugins.importer entry's version pin |
E0338 | duplicate-importer-attachment | importer is attached by more than one plugins.importer entry |
E0339 | ambiguous-import-format | more than one importer recognises the source |
E0340 | name-windows-cannot-hold | a name this operation writes holds a path segment Windows cannot hold as written |
E0341 | importer-declares-no-file-patterns | the importer serving the source's format declares no file patterns, so it reads one file and cannot read a directory |
E0342 | import-directory-matched-nothing | no file in the directory matches the file patterns the importer serving the source's format declares |
E0343 | import-source-name-collision | a file read from the directory and a file named in the importer's `with.sources` have the same name |
E0344 | windows-unusable-entry | an entry this publication carries cannot be used on Windows |
E0345 | duplicate-container-environment-variable | a container declares one environment variable twice |
E0346 | metrics-credential-annotation-matches-provides | a Component's annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance's metrics need a credential |
E0347 | target-render-facts-not-declared | template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFacts |
E0348 | pipeline-step-reads-target-render-facts | pipeline 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 |
E0349 | import-target-unbound | no Recipe in the workspace's catalog binds to the capability the import's target names |
E0350 | unrecognised-import-format | no importer recognises the source |
E0351 | unsupported-boundary-artifacts | provider does not support boundary artifacts |
E0352 | boundary-directory-not-beneath-output-root | boundary output directory does not name a directory beneath the output root |
E0353 | boundary-feature-name-not-a-directory | boundary-level Feature instance name is not a directory name |
E0354 | cross-boundary-link-value-not-copied | a template does more than copy a value it reads off a cross-boundary link |
E0355 | inject-delivery-shape | inject delivery: shape must be a list of entries, each `in:` with exactly one of `from:` or `value:` |
E0356 | suspend-requires-scheduled-form | suspend requires form: scheduled |
E0357 | name-mapping-matched-nothing | a Manifest name mapping's key names no component instance or attachment in this build, so the entry binds nothing |
E0358 | uses-target-not-exported | uses edge target names a component its module does not export |
E0359 | source-adapter-not-registered | no source adapter is registered in this program for the source kind |
E0360 | netrc-file-unreadable | the netrc file could not be read |
E0361 | source-url-carries-credential | the source URL carries a credential |
E0362 | uses-inject-value | inject entry on a connection carries `value:`; a connection delivers the target's published keys, each named with `from:` |
E0363 | annotation-subkey-not-bound | annotation subkey is not routed by the annotation's binding |
E0364 | value-template-execution-failed | a value template failed while it ran |
E0365 | boundary-contribution-not-assembled | boundary-level Feature's output is routed to a dispatch path nothing assembles |
E0366 | inject-mapping-output-not-parsable | FeatureRecipe injectMapping output could not be read as a dictionary of deliveries |
E0367 | annotation-scalar-not-routable | a scalar annotation value does not route to exactly one path of its binding |
E0368 | inject-mapping-output-key-not-delivered | FeatureRecipe injectMapping output writes a key no delivery mechanism of the host reads |
E0369 | absent-path-read-and-iterated | template reads a path as a value and iterates it, and the data holds nothing at that path |
E0370 | duplicate-pipeline-step-id | a pipeline declares one step id twice |
E0371 | unknown-catalog-document-kind | catalog document declares a kind a catalog does not hold |
E0372 | attachment-inject-value | inject 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 |
E0373 | retired-api-version | a document declares an API version this compiler no longer reads |
E0374 | retired-abi-version | a plugin declares a plugin ABI version this compiler no longer speaks |
E0375 | retired-media-type | oci: artifact carries a media type this compiler no longer reads |
E0376 | no-answer-in-time | egress: the server did not answer in time |
E0377 | repository-listing-too-long | registry: the repository listing did not end in time |
E0378 | registry-too-busy | oci: the registry kept asking to slow down |
E0002está 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 esE0154.E0134está 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 esE0303.E0157está 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 esE0215.E0159está 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.E0166está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. Nombraba el archivo al que apunta elparameters: { $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 esE0175.E0203está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. Nombraba una FeatureRecipe sobre la capacidadevalque declaraba una fuente, una superposición de values, una carga de trabajo o artefactos; esa capacidad se suprimió, y ya nada notifica este estado.E0206está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. Nombraba una Recipe sobre la capacidadevalque 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 conE0210.E0217está 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.E0219está retirado: ya nada lo notifica, y el número nunca se asigna a una condición distinta. Nombraba una cadenaextendscí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 esE0202.E0230está 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.E0231está 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.E0232está 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.E0233está 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.E0234está 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 esE0251.E0235está 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.E0236está 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.E0237está 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.E0238está 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.E0239está 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.E0240está 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.E0241está 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.E0242está 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 esE0251.E0243está 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.E0244está 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.E0245está 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.E0249está 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.E0258está 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.E0322está 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 conE0318.
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.