Sentinelles d’erreur — référence canonique
Chaque arrêt fatal émis par le compilateur nomme une condition, et chaque condition porte trois identifiants, parce que reconnaître une condition, la consigner et la citer sont trois tâches différentes. La sentinelle est la valeur Go avec laquelle errors.Is établit la correspondance, obtenue en appelant l’accesseur que le paquet déclarant exporte : l’identifiant que le code Go reconnaît. Le code est la chaîne sous laquelle la condition est enregistrée : il nomme la condition elle-même en mots, et c’est ce qui reste fixe à mesure que les paquets Go qui l’entourent évoluent — l’identifiant qu’un programme consigne. Le code court est la lettre E suivie de quatre chiffres, assez court pour être lu à voix haute, saisi dans une recherche ou collé dans un rapport : l’identifiant qu’une personne cite. Une condition, trois identifiants — faites correspondre la sentinelle pour reconnaître la condition depuis Go, lisez le code lorsque vous devez la consigner ou l’utiliser comme clé, et résolvez un code court dans le tableau de toutes les conditions plus bas sur cette page.
Le diagnostic destiné à l’utilisateur (le message préfixé catalogué dans fatal-halts.md et error-translation.md) porte le texte destiné au développeur ; la sentinelle enveloppée est ce avec quoi errors.Is établit la correspondance dans les consommateurs programmatiques.
Cette page est la vue du catalogue indexée par sentinelle. Les programmeurs qui écrivent des gates de CI, des intégrations d’IDE ou du code d’orchestration de build devant distinguer les types d’erreur établissent la correspondance avec les sentinelles listées ici à l’aide du prédicat standard errors.Is. Les auteurs qui déboguent un build en lisant le texte d’erreur émis veulent généralement les vues indexées par message — fatal-halts.md pour les erreurs qui arrêtent le build, warnings.md pour la sortie d’avertissement.
Chaque ligne des tableaux ci-dessous nomme un accesseur — une fonction sans argument, exportée par le paquet que le tableau nomme, qui renvoie la sentinelle. Importer ce paquet et appeler l’accesseur est la surface d’intégration prise en charge, c’est pourquoi les tableaux écrivent chacun avec ses parenthèses — c’est l’appel qui produit une valeur avec laquelle errors.Is peut établir la correspondance, et le nom sans elles est une fonction plutôt qu’une erreur :
import ( "errors"
"github.com/aggrega-ai/aggrega-cli/pkg/resolver")
if errors.Is(err, resolver.ErrParameterContractViolation()) { // handle parameter contract violations}Les trois identifiants portent leur stabilité séparément, et cette séparation est la raison pour laquelle une condition possède les trois. Les accesseurs listés ci-dessous sont stables d’une version de correctif à l’autre ; les renommages ou suppressions sont annoncés dans l’entrée du changelog de la version qui les effectue, et l’ajout d’un nouvel accesseur dans un paquet est additif et ne casse pas les correspondances existantes. Un code est fixé une fois sa condition publiée, c’est donc l’identifiant à consigner partout où une condition doit être nommée de façon durable : renommer un accesseur ne déplace pas le code sous lequel sa condition a été enregistrée, et un code que vous avez consigné survit à une refactorisation de la surface Go. Un code court est le plus durable des trois : un numéro est attribué une fois puis fixé, et le numéro d’une condition retirée reste retiré au lieu d’être attribué à une autre condition, de sorte qu’un code court consigné dans un ancien rapport nomme toujours la condition qu’il nommait lorsqu’il a été consigné. Cela est imposé et pas seulement voulu — une condition déclarée sous un numéro retiré est refusée avant que le compilateur ne lise la moindre entrée, à chaque exécution — et chaque numéro retiré est publié à côté des numéros actifs dans le tableau de toutes les conditions. La colonne du code ci-dessous porte le code, et c’est la valeur qu’un client du diagnostic structuré lit sans lier ces paquets. Il est publié plutôt que déduit, parce qu’il n’a pas à reprendre la ligne sur laquelle il se trouve — un nom réexporté rapporte le code de la condition vers laquelle il renvoie, et le code d’une règle nomme la règle plutôt que l’accesseur. La colonne du message est le texte littéral que la sentinelle produit ; le diagnostic destiné à l’utilisateur fait précéder ce texte d’un en-tête entre crochets et de l’emplacement dans la source. Cet en-tête porte le code court de la condition, avec à côté la catégorie de l’occurrence lorsque l’occurrence en a une, comme dans [DEVELOPER_ERROR E0007] — afin qu’un lecteur puisse résoudre l’un ou l’autre indépendamment : les catégories (DEVELOPER_ERROR / OPS_ERROR / CATALOG_ERROR / TRANSLATION_ERROR / FETCH_ERROR / POLICY_ERROR / TRUST_ERROR) sont expliquées dans error-translation.md, et les codes courts se résolvent dans le tableau de toutes les conditions sur cette page. Lorsqu’un plugin a levé la condition, le jeton du code est qualifié par le plugin qui l’a levée — [TRANSLATION_ERROR provider/example:1.0.0/E0007] — et le code court est le dernier segment ; error-translation.md explique pourquoi le qualificatif est présent et pourquoi le dernier segment est celui à résoudre.
Lire le code d’une condition
Un code nomme la condition et rien d’autre, en kebab-case — parameter-contract-violation, lockfile-drift. Il ne porte aucun préfixe : ni le paquet qui le déclare, ni l’étape qui le lève, ni un regroupement d’aucune sorte. Ainsi un code reste le même lorsque le compilateur est réorganisé autour de lui, et une condition levée à plus d’un endroit d’une compilation n’a toujours qu’un seul nom. Le nom de chaque condition est distinct à lui seul, ce qui rend le préfixe inutile, et deux conditions ne peuvent pas être enregistrées sous un même code. Lisez-le sur une erreur avec CodeOf, depuis github.com/aggrega-ai/aggrega-cli/pkg/errors, qui parcourt la chaîne d’enveloppement comme le fait errors.Is, de sorte que le code survit quel que soit le nombre de niveaux qui ont enveloppé l’erreur sur son chemin de retour jusqu’à vous. Ce paquet s’appelle lui-même errors, donc un alias d’importation le distingue de la bibliothèque standard :
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 indique aussi si une erreur de la chaîne portait un code ; une chaîne qui n’en porte aucun est un fait concernant cette chaîne plutôt qu’un échec. Si vous préférez établir vous-même la correspondance avec l’interface, le même paquet l’exporte sous le nom CodedError, et errors.As la trouve lors du même parcours.
Un code ne circule que dans un sens. C’est ce qu’une condition rapporte, jamais ce qui l’identifie pour une correspondance : écrire la chaîne dans votre propre code vous donne une chaîne, et il n’existe aucun chemin d’une chaîne vers la valeur avec laquelle errors.Is établit la correspondance. Faites correspondre la sentinelle pour reconnaître une condition ; lisez le code pour en consigner une.
Le code que aggrega affiche sur un terminal est le code court, pas celui-ci. Un diagnostic d’arrêt s’ouvre sur un en-tête entre crochets portant le code court de la condition, avec à côté la catégorie de l’occurrence lorsque l’occurrence en a une — [DEVELOPER_ERROR E0007], ou [TRANSLATION_ERROR provider/example:1.0.0/E0007] lorsqu’un plugin a levé la condition et que le code est qualifié par le plugin qui l’a levée, ou [E0007] lorsque l’échec n’a aucun domaine de responsabilité vers lequel vous orienter — puis l’emplacement dans la source et le texte du message catalogué dans fatal-halts.md. Le code descriptif nomme la condition en mots et est bien trop large pour cette position : pour les conditions les plus longues, il remplirait un terminal étroit avant même le début du message, et c’est toute la raison d’être d’un second identifiant compact. Le jeton à partir duquel travailler lorsque vous n’avez que la sortie affichée est donc le code court, et il se résout dans le tableau de toutes les conditions plus bas sur cette page : d’un numéro que vous pouvez lire au téléphone, vous parvenez à la condition, à son accesseur et au texte de son message. aggrega explain <code> effectue cette résolution dans le terminal — il accepte l’un ou l’autre des codes de la condition et affiche la condition avec l’entrée qui documente la correction à apporter lors de la rédaction, et il est décrit dans aggrega explain. Les vues indexées par message dans fatal-halts.md restent le moyen de partir de la formulation plutôt que d’un identifiant.
Là où un code sort bel et bien de Go, c’est dans le diagnostic structuré que publie le démon du compilateur en tant que service, sous la forme d’un champ code propre à chaque entrée plutôt que de quelque chose d’intégré au texte du message — de sorte qu’une extension d’éditeur, ou tout autre client de ce protocole, se branche sur ce qu’une entrée rapporte sans lier ces paquets et sans analyser de texte. Cette seule clé porte un code exploitable par une machine, quel que soit celui qui l’a attribué, et l’entrée indique quelle couche l’a levé. Un code y a trois origines, et la troisième est la raison pour laquelle un code que vous pouvez rechercher sur cette page n’est pas à lui seul le signe qu’un échec s’est produit :
- Le code de la condition qu’un échec nomme, qui est ce que cette page catalogue.
- Le code de classe d’un avertissement sur la sortie rendue —
unsupported-fielden est un, et warnings.md le décrit. Il est attribué là où l’avertissement a été levé plutôt qu’enregistré comme condition, il n’a donc aucune ligne ici. - Le code enregistré d’un avertissement sur les documents rédigés — un nom à une modification d’un nom déclaré, un paramètre que rien ne lit. Un tel constat nomme une condition sous la même forme qu’un échec, son code est donc enregistré et a une ligne sur cette page, et lire cette ligne vous indique de quoi traite le constat.
Le même code que vous liriez sur un arrêt peut donc aussi vous parvenir d’un build qui s’est terminé, porté par un constat qui n’a rien changé au résultat. Ce qui distingue les deux, c’est le résultat qui vous a été donné et la couche que l’entrée nomme — jamais la forme du code lui-même, et jamais le fait qu’il se résolve ici. Le champ est omis lorsque rien de ce qui a produit l’entrée n’a attribué de code : un échec qui ne nomme aucune condition propre à Aggrega, et un avertissement auquel celui qui l’a levé n’en a attribué aucun. aggrega serve documente la forme de l’entrée, la clé qui nomme la couche et les cas où le champ est présent.
Un diagnostic structuré porte les deux identifiants d’une condition, et savoir lequel est lequel fait la différence entre un identifiant sur lequel vous pouvez agir et un autre sur lequel vous ne le pouvez pas. La clé code ci-dessus est destinée à un programme : avec des traits d’union et nommant la condition en mots, de sorte qu’une extension qui se branche dessus se lit comme ce qu’elle signifie, et c’est la valeur que CodeOf rapporte en Go. La clé shortCode à côté est destinée à une personne — la lettre E suivie de quatre chiffres, le même jeton qu’un diagnostic d’arrêt affiche dans son en-tête entre crochets. C’est ce que vous lisez au téléphone, saisissez dans un champ de recherche ou collez dans un ticket, et c’est le jeton sur lequel le tableau de toutes les conditions est indexé.
Aucun n’est l’abréviation de l’autre, et aucun n’est une solution de repli pour l’autre. Établissez la correspondance sur le code descriptif ; montrez le code court à un lecteur. Une surface qui n’offrirait que le code descriptif remettrait à un auteur un identifiant destiné à une correspondance, et une surface qui établirait la correspondance sur le code court le ferait sur un numéro qui ne dit rien de la condition — c’est pourquoi les deux circulent plutôt que d’en choisir un.
Une troisième clé, codeDescription, indique où la condition est publiée, sous la forme d’une référence à ouvrir pour en savoir plus sur le diagnostic. Son adresse mène au tableau de toutes les conditions sur cette page, de sorte qu’un lecteur qui la suit depuis un éditeur arrive en ayant en main le code court sur lequel le tableau est indexé. Une entrée porte le code court et la référence ensemble, ou aucun des deux : les deux sont présents exactement lorsque l’entrée nomme une condition enregistrée — une condition ayant une ligne dans ce tableau — et les deux sont absents lorsque le code nomme une classe d’avertissement ou l’identité d’une règle de conventions d’un linter qui vous est propre et qu’Aggrega ne déclare pas, parce qu’il n’y a pour ceux-ci aucun numéro à citer et rien ici qui les décrive.
Dans l’autre sens — d’un code que vous avez en main vers la condition qu’il nomme — les tableaux ci-dessous sont la liste publiée. Chaque ligne porte le code à côté de l’accesseur qui produit la même condition en Go, de sorte qu’un code lu sur un diagnostic structuré se résout en un nom avec lequel vous pouvez établir la correspondance et en le texte que la condition produit. Les tableaux couvrent les conditions dont vous pouvez importer l’accesseur, et deux sortes de code restent en dehors : un code de classe, qui nomme une classe d’avertissement plutôt qu’une condition et n’a donc aucun accesseur à placer à côté, et un code dont la condition n’est déclarée que dans un paquet que vous ne pouvez pas importer et n’est réexportée nulle part, où il n’existe aucun nom permettant une correspondance à placer à côté. Cette seconde sorte nomme tout de même une condition, et cette condition a tout de même un code court — le tableau de toutes les conditions, plus bas sur cette page, est indexé sur le code court plutôt que sur un nom importable et couvre donc celles-ci aussi.
La surface de correspondance, par paquet déclarant
Chaque section ci-dessous est un paquet que vous pouvez importer. Son titre est le chemin du paquet relatif au chemin de module github.com/aggrega-ai/aggrega-cli, de sorte que la section intitulée pkg/resolver s’importe en tant que github.com/aggrega-ai/aggrega-cli/pkg/resolver.
Les entrées sont regroupées par le paquet qui déclare la sentinelle, parce que c’est le paquet qu’importe le code qui établit la correspondance. L’endroit d’un build où la condition est levée est une question distincte, et une question à laquelle cette page ne répond délibérément pas : une même sentinelle est souvent levée depuis plusieurs endroits, et plusieurs ne sont levées que depuis du code que le module n’exporte pas, si bien qu’aucune réponse par entrée ne serait vraie pour chaque ligne. Les vues indexées par message répondent à la question du moment dans le build en des termes que vous pouvez observer — fatal-halts.md avant tout.
Quelques noms apparaissent dans plus d’un paquet. Ce sont des réexportations d’une même valeur partagée plutôt que deux conditions, donc la correspondance avec l’un ou l’autre nom réussit ; les tableaux le précisent lorsque les deux noms sont importables. Les deux lignes portent le même code, ce qui est le même fait énoncé sur l’identifiant que détient un client en dehors de Go : une condition, un code, quel que soit le nombre de noms qui y mènent.
pkg/catalog
| Sentinelle | Code | Message |
|---|---|---|
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()est la même valeur quepkg/resolver.ErrManifestImplementsMismatch(), donc la correspondance avec l’un ou l’autre nom réussit.
pkg/closure
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
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()est la même valeur quepkg/refcycle.ErrCycle(), donc la correspondance avec l’un ou l’autre nom réussit.
pkg/deprecation
| Sentinelle | Code | Message |
|---|---|---|
ErrDeprecatedEntity() | deprecated-entity | deprecation: build consumes a deprecated entity |
pkg/docscache
| Sentinelle | Code | Message |
|---|---|---|
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()est la même valeur quepkg/oci.ErrFetchNotFound(), donc la correspondance avec l’un ou l’autre nom réussit.
pkg/egress
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
ErrNameWindowsCannotHold() | name-windows-cannot-hold | a name this operation writes holds a path segment Windows cannot hold as written |
pkg/pluginpath
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
ErrCycle() | reference-cycle | circular reference expansion |
pkg/registrytrust
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
ErrFetchIntegrity() | fetch-integrity | oci: content digest mismatch |
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrFetchIntegrity()est la même valeur quepkg/oci.ErrFetchIntegrity(), donc la correspondance avec l’un ou l’autre nom réussit.ErrFetchNotFound()est la même valeur quepkg/oci.ErrFetchNotFound(), donc la correspondance avec l’un ou l’autre nom réussit.
pkg/sourcekind
| Sentinelle | Code | Message |
|---|---|---|
ErrUnknownKind() | unknown-source-kind | no source adapter serves the source kind |
pkg/sourceresolver
| Sentinelle | Code | Message |
|---|---|---|
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()est la même valeur quepkg/oci.ErrFetchIntegrity(), donc la correspondance avec l’un ou l’autre nom réussit.ErrFetchNetworkUnreachable()est la même valeur quepkg/oci.ErrFetchNetworkUnreachable(), donc la correspondance avec l’un ou l’autre nom réussit.ErrFetchNotFound()est la même valeur quepkg/oci.ErrFetchNotFound(), donc la correspondance avec l’un ou l’autre nom réussit.ErrFetchUnauthorized()est la même valeur quepkg/oci.ErrFetchUnauthorized(), donc la correspondance avec l’un ou l’autre nom réussit.
pkg/sourceresolver/cacheslot
| Sentinelle | Code | Message |
|---|---|---|
ErrEmptyWorkspaceRoot() | empty-workspace-root | cacheslot: empty workspaceRoot |
pkg/sourceresolver/netrc
| Sentinelle | Code | Message |
|---|---|---|
ErrNetrcFileUnreadable() | netrc-file-unreadable | the netrc file could not be read |
ErrSourceURLCarriesCredential() | source-url-carries-credential | the source URL carries a credential |
pkg/types
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
ErrDanglingUsesTarget() | dangling-uses-target | uses edge target does not exist |
ErrReleaseEdgeRetarget() | release-edge-retarget | release edge retargets a developer-declared edge |
pkg/validator
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
ErrExtensionEval() | schema-extension-evaluation-failed | validator/jsonschema: x-aggrega extension evaluation failed |
ErrSchemaResolve() | schema-not-resolvable | validator/jsonschema: schema resolution failed |
pkg/validator/merger
| Sentinelle | Code | Message |
|---|---|---|
ErrMergeInvalid() | schema-merge-input-invalid | merger: invalid merge input |
pkg/workspaceconfig
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
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
| Sentinelle | Code | Message |
|---|---|---|
ErrPositionOutOfRange() | position-out-of-range | position out of range |
Sentinelles qui portent une autre sentinelle
ErrCacheMetadataInvalid (pkg/sourceresolver/metadata) signale un emplacement corrompu du cache des artefacts sources. Elle est déclarée comme une enveloppe autour de ErrFetchIntegrity() plutôt que comme une identité propre, elle n’apparaît donc pas dans les tableaux ci-dessus, et une correspondance avec ErrFetchIntegrity() réussit aussi pour elle. Comme elle enveloppe une sentinelle au lieu d’en déclarer une, elle est exportée comme une valeur plutôt que comme une fonction : établissez la correspondance avec elle en tant que ErrCacheMetadataInvalid, sans parenthèses. Établissez la correspondance avec l’enveloppe lorsque vous voulez cette condition précise, et avec la sentinelle enveloppée lorsque vous voulez toute la classe d’intégrité.
Sentinelles accessibles sous un second nom dans un même paquet
Lorsqu’un paquet exporte deux accesseurs pour une condition — le second déclaré comme un renvoi vers le premier —, les tableaux ci-dessus portent l’accesseur déclarant et omettent le nom de renvoi. Les deux noms sont exportés par le même paquet, donc une importation qui atteint l’un atteint déjà l’autre, et une seconde ligne listerait une condition deux fois sous un nom qui ne permet aucune correspondance nouvelle. La correspondance avec l’un ou l’autre nom réussit : le renvoi retourne la même valeur que l’accesseur déclarant.
Il ne s’agit pas du cas entre paquets. Une sentinelle réexportée depuis un autre paquet a une ligne dans le tableau de chaque paquet, parce que le code qui établit la correspondance en important l’un de ces paquets ne peut pas atteindre le nom de l’autre sans importer aussi ce paquet ; un renvoi à l’intérieur d’un seul paquet n’a pas besoin d’une seconde ligne, parce qu’une seule importation atteint les deux noms.
ErrDuplicateRecipeIdentity() dans pkg/catalog est un tel renvoi : il retourne ErrDuplicateEntityIdentity(), qui est le nom que porte le tableau de ce paquet.
Conditions sans sentinelle permettant une correspondance
Certaines étapes de compilation déclarent leurs sentinelles dans des paquets que le compilateur n’exporte pas, il n’y a donc rien que errors.Is puisse référencer et aucune correspondance ne peut être écrite contre elles. Elles sont décrites ici plutôt que mises en tableau, parce qu’un tableau sur cette page est la promesse que la colonne de gauche peut être déréférencée.
Leurs diagnostics vous parviennent intégralement par le texte d’erreur émis et par les vues indexées par message — fatal-halts.md en particulier —, qui sont le moyen pris en charge de les reconnaître :
- La construction de la topologie (construction du graphe et aplatissement des sous-agrégats) signale un sous-Aggregate qui n’a pas pu être chargé, en nommant l’URI de l’Aggregate inaccessible ; une déclaration
uses:dont la forme structurelle ne correspond pas au schéma ; un dépassement de la profondeur d’imbrication ; et une collision d’ID de nœud après aplatissement, où deux sous-Aggregates sont compilés vers le même ID de nœud et un nom d’instance doit être renommé pour lever l’ambiguïté. - La finalisation du graphe (fusion des Feature entre les surfaces de l’Aggregate et de la Release) signale un type de Feature déclaré de manière incohérente entre les deux.
- L’analyse statique (évaluation des sélecteurs et vérifications de sûreté de typage entre nœuds) signale une violation de
selector:; un échec de résolution dans le catalogue au-delà duquel elle ne peut pas aller, en nommant l’entité inaccessible ; et un rejet par une politique, où un plugin rattaché à un rôle de verdict de gouvernance a rejeté le build assemblé. Un rejet par une politique porte la catégoriePOLICY_ERROR, le nom du plugin qui a rejeté et le message de règle fourni par le plugin. - Le rendu (répartition entre fournisseurs et rendu par fournisseur) signale un fournisseur inconnu.
- Le chargeur hôte Wasm intégré émet ses propres sentinelles de garde-fou — un garde-fou de manifeste rejeté (un plugin a demandé une capacité d’accès à l’environnement d’exécution que le pare-feu de pureté AOT refuse), une récupération après une panique de l’invité, et une interruption déterministe à la sortie du plugin. Celles-ci apparaissent dans le diagnostic destiné à l’utilisateur lors de l’exécution d’un plugin (par exemple via
aggrega lint). Les auteurs de Plugin qui testent un invité face à l’hôte atteignent les mêmes conditions par un nom importable viapkg/plugintest, listé ci-dessus.
Pour conditionner un pipeline spécifiquement à un rejet par une politique, établissez la correspondance avec le préfixe de catégorie POLICY_ERROR dans le diagnostic plutôt qu’avec une sentinelle ; la catégorie est une partie documentée de la surface d’erreur, décrite dans error-translation.md.
Chaque condition, par code court
Le tableau ci-dessous effectue la recherche dans l’autre sens : un code court dans la colonne de gauche et, à côté, la condition que ce code nomme et le texte que cette condition produit. Il couvre chaque condition que aggrega peut signaler, y compris celles que les sections ci-dessus ne peuvent pas lister.
Cette couverture plus large est la raison d’être de ce tableau, et non un effet accidentel. Les sections ci-dessus sont indexées sur un nom que vous pouvez importer, donc une condition déclarée uniquement dans un paquet que vous ne pouvez pas importer — et qui n’est réexportée nulle part où vous pourriez l’importer non plus — n’a rien à mettre dans leur colonne de gauche. Ce tableau est indexé sur le code court, et chaque condition en a un, donc aucune condition signalable n’en est exclue. Un code court que vous avez en main se résout ici, que la condition qui se trouve derrière ait aussi ou non un accesseur avec lequel vous pouvez établir la correspondance.
Ce qui vaut une place dans ce tableau, c’est que le compilateur puisse réellement signaler la condition. Les lignes sont dérivées du code plutôt que transcrites dans celui-ci : une condition apparaît ici parce que quelque chose dans le compilateur la lève, donc chaque code de la colonne de gauche est un code que aggrega peut afficher. C’est la promesse que fait le tableau, et c’est ce qui vous permet de lire une ligne comme une vérification qui s’exécute réellement.
L’exception délibérée est une condition déclarée avant que le code qui la signale n’existe, afin que le code et la formulation soient fixés à l’avance et ne changent jamais sous les yeux d’un lecteur qui les a déjà cités. Une telle condition le dit dans une note placée directement sous le tableau. Elle est listée plutôt que cachée — un code que vous avez en main doit toujours se résoudre — et la note à côté vous dit clairement qu’aucun build ne la lève encore, et ce qui devrait exister avant qu’un build ne le fasse.
Un numéro retiré est également listé, dans son propre ensemble de notes sous le tableau, et il reste listé de façon permanente. Il arrive qu’une condition soit supprimée — elle est remplacée par une condition qui couvre davantage de terrain, ou rien ne l’a jamais signalée — et, à partir de ce moment, son numéro est retiré : il n’est jamais attribué à une autre condition, de sorte qu’un code court que vous citez d’après un ancien rapport ne peut jamais nommer que ce qu’il nommait lorsque le rapport a été écrit. Cette promesse est mécanique plutôt qu’éditoriale. Une condition déclarée sous un numéro retiré est refusée avant que le compilateur ne lise la moindre entrée, à chaque exécution, de sorte qu’aucune version ne peut en contenir une — la même classe de refus que rencontrerait un numéro que deux conditions actives tenteraient de partager, formulée pour que vous puissiez distinguer lequel des deux cas vous avez rencontré. La note d’un code retiré vous indique, lorsque le retrait l’a consigné, ce que le code nommait et, lorsque la condition a été remplacée, quel code signale désormais ce terrain.
Ne jamais réutiliser un numéro est aussi ce qui donne à la séquence ses lacunes permanentes, et les notes sont ce qui rend ces lacunes lisibles. Un numéro manquant n’est à lui seul la preuve de rien : il peut être retiré, et il peut tout aussi bien être un numéro que rien n’a encore atteint. Les notes consignent quels numéros sont retirés et, lorsque cela a été consigné, ce que chacun d’eux nommait, de sorte qu’un code qui ne se résout ni en une ligne ni en une note est un code que ce compilateur n’a jamais émis.
Un code court est délibérément opaque : quatre chiffres ne disent rien à eux seuls d’une condition, ce qui est le prix d’un identifiant assez court pour être lu à voix haute, saisi dans une recherche ou collé dans un rapport. La correspondance ci-dessous est ce qui le rend utilisable. Un numéro est attribué une fois, à partir d’une séquence croissante unique, et il est fixé dès lors ; il ne dit rien de la condition qu’il nomme. Un code court est donc un identifiant et rien de plus — sa valeur n’est pas une classification, et ni lui ni aucun regroupement que vous pourriez remarquer dans le tableau n’indique où une condition se situe ni de quoi elle traite.
Le tableau ne comporte aucune colonne de catégorie, et ce n’est pas un oubli : une catégorie est une propriété d’un échec particulier plutôt que de la condition qui se trouve derrière. Certaines conditions appartiennent à une catégorie par construction. Pour d’autres, la catégorie découle du type d’entité sur lequel porte l’échec, de sorte qu’une telle condition, signalée une fois pour un Aggregate et une fois pour une Release, porte chaque fois une catégorie différente — et une valeur unique écrite ici à côté de la condition serait fausse pour chaque condition de ce second type.
Les catégories sont expliquées dans error-translation.md — chacune, ce qu’elle signifie et où se trouve sa correction. Une catégorie et un code court répondent à des questions différentes sur le même échec : la catégorie identifie la surface à laquelle appartient la correction, et le code court identifie quelle condition a arrêté le build. Aucun des deux ne se déduit de l’autre, c’est pourquoi chacun a sa propre liste publiée — et pourquoi un échec sans surface de rédaction à nommer porte tout de même un code que vous pouvez rechercher ici.
| Code | Condition | Message |
|---|---|---|
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 retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. Il nommait une recherche dans le catalogue qui échoue pendant la vérification des contrats statiques du graphe — un défaut du compilateur plutôt que d’un document rédigé — et cet état est désormais signalé par la condition levée lorsqu’un build résout un type de composant pour lequel le catalogue qu’il lit ne contient alors aucune entrée, et son code estE0154.E0134est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. Il nommait une entité publiable dont le répertoire ne portait pas le nom de la version que l’entité déclare ; une publication ne juge pas le nom d’un répertoire, et la condition levée lorsqu’une entité partage son répertoire avec une autre entité alors que son type dispose d’un répertoire propre estE0303.E0157est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. Il nommait une clé d’Aggregate — un nom d’instance de composant, de fonctionnalité, de sous-système ou de module imbriqué — qui ne correspondait pas au motif des noms rédigés. Chacune de ces surfaces de clé est contrainte à cette même graphie par le schéma de l’Aggregate, qui refuse le document lors de la validation de son enveloppe et signale la clé fautive avec une ligne et une colonne ; le code de cette condition estE0215.E0159est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. Il nommait une référence de cible dont les segments séparés par des points ne correspondaient pas tous au motif des noms d’instance, et aucun build ne l’a signalé avant que la condition ne soit supprimée.E0166est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. Il nommait le fichier vers lequel pointe leparameters: { $import: … }d’une Release lorsque ce fichier ne pouvait pas être lu ou que ses octets ne pouvaient pas être analysés ; un fichier qui ne produit aucun document constitue une seule condition, quel que soit l’endroit où le chemin a été écrit, et son code estE0175.E0203est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. Il nommait une FeatureRecipe sur la capacitéevalqui déclarait une source, une surcouche values, une charge de travail ou des artefacts ; cette capacité a été supprimée, et plus rien ne signale cet état.E0206est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. Il nommait une Recipe sur la capacitéevalqui déclarait une source, une charge de travail, des artefacts ou une surcouche values ; cette capacité a été supprimée, et une Recipe ne déclarant aucun de ces éléments est refusée sur toutes les capacités sousE0210.E0217est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. Il nommait un échec de validation de schéma qui ne pouvait pas être signalé sur un champ particulier, et aucun build ne l’a signalé avant que la condition ne soit supprimée.E0219est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. Il nommait une chaîneextendscyclique, signalée par un parcours de chaîne distinct de l’étape de combinaison de la fusion des schémas ; un parcours de chaîne unique signale chaque chaîne cyclique, et le code correspondant estE0202.E0230est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. La condition que ce numéro nommait a été supprimée, et aucun build ne la signale.E0231est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. La condition que ce numéro nommait a été supprimée, et aucun build ne la signale.E0232est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. La condition que ce numéro nommait a été supprimée, et aucun build ne la signale.E0233est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. La condition que ce numéro nommait a été supprimée, et aucun build ne la signale.E0234est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. Il nommait une source de Recipe qui est une chaîne vide, signalée lors du rendu via le fournisseur compose ; une seule condition couvrant tous les fournisseurs signale désormais ce cas, et son code estE0251.E0235est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. La condition que ce numéro nommait a été supprimée, et aucun build ne la signale.E0236est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. La condition que ce numéro nommait a été supprimée, et aucun build ne la signale.E0237est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. La condition que ce numéro nommait a été supprimée, et aucun build ne la signale.E0238est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. La condition que ce numéro nommait a été supprimée, et aucun build ne la signale.E0239est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. La condition que ce numéro nommait a été supprimée, et aucun build ne la signale.E0240est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. La condition que ce numéro nommait a été supprimée, et aucun build ne la signale.E0241est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. La condition que ce numéro nommait a été supprimée, et aucun build ne la signale.E0242est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. Il nommait une source de Recipe qui est une chaîne vide, signalée lors du rendu via le fournisseur Helm ; une seule condition couvrant tous les fournisseurs signale désormais ce cas, et son code estE0251.E0243est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. La condition que ce numéro nommait a été supprimée, et aucun build ne la signale.E0244est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. La condition que ce numéro nommait a été supprimée, et aucun build ne la signale.E0245est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. La condition que ce numéro nommait a été supprimée, et aucun build ne la signale.E0249est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. La condition que ce numéro nommait a été supprimée, et aucun build ne la signale.E0258est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. La condition que ce numéro nommait a été supprimée, et aucun build ne la signale.E0322est retiré : plus rien ne le signale, et le numéro n’est jamais attribué à une autre condition. Il nommait une valeur qu’une Feature rattachée à une frontière calculait pour l’environnement d’un composant sous une clé qu’un autre rattachement avait déjà livrée. Une Feature rattachée à une frontière ne livre dans un composant qu’au travers de l’injectMapping de sa FeatureRecipe, et un mapping qui écrit une clé livrée par un autre rattachement est signalé sousE0318.
Conseils pour la correspondance
Le prédicat errors.Is parcourt la chaîne d’enveloppement, de sorte qu’une correspondance avec une sentinelle fonctionne même lorsque l’erreur est enveloppée plusieurs fois sur son chemin de retour jusqu’à vous. Établissez la correspondance avec l’erreur qu’a retournée une fonction exportée :
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}Il n’existe aucun point d’entrée exporté qui exécute un build entier, donc la correspondance avec errors.Is s’applique au code qui appelle directement ces paquets. Pour conditionner la CI à un build, exécutez aggrega build et lisez son statut de sortie et ses diagnostics : leur texte de message est catalogué dans fatal-halts.md, leur catégorie dans error-translation.md, et le code court dans leur en-tête entre crochets se résout dans le tableau de toutes les conditions sur cette page.
Les deux chemins de contrôle existent parce que les trois identifiants portent à des distances différentes. Un contrôle écrit en Go lie ces paquets, établit la correspondance avec des sentinelles et peut lire l’un ou l’autre code sur toute erreur qu’il détient. Un contrôle écrit autour de la commande dispose du statut de sortie et du texte affiché — et le texte affiché nomme la condition, parce que le code court se trouve dans l’en-tête entre crochets. Un tel contrôle se fonde donc sur ce code court plutôt que sur la formulation du message, et les vues indexées par message restent le moyen de remonter depuis une formulation qu’il possède déjà. Établissez la correspondance avec la sentinelle depuis Go ; fondez-vous sur le code court autour de la commande ; lisez le code descriptif sur le diagnostic structuré lorsqu’un client parle ce protocole.
Les sentinelles déclarées dans des paquets différents avec le même nom court sont des conditions distinctes, et non deux graphies d’une seule : errors.Is les distingue par identité, de sorte qu’une correspondance avec l’une ne correspond pas à l’autre. Les réexportations signalées dans les tableaux sont l’exception, et elles sont signalées précisément parce que c’est le cas où deux noms correspondent effectivement. Établissez la correspondance avec le nom dans le paquet sous lequel les tableaux le listent, et considérez un nom court seul comme ambigu.
Pour le catalogue des diagnostics destinés à l’utilisateur (les messages que les développeurs voient dans leur terminal lorsqu’un build s’arrête), consultez fatal-halts.md. Pour le catalogue des avertissements (la sortie non bloquante warning:, lint: et notice:), consultez warnings.md. Pour la taxonomie des préfixes de catégorie ([DEVELOPER_ERROR] / [OPS_ERROR] / [CATALOG_ERROR] / [TRANSLATION_ERROR] / [FETCH_ERROR] / [POLICY_ERROR] / [TRUST_ERROR]), consultez error-translation.md.