Sentinelle di errore — riferimento canonico
Ogni arresto fatale emesso dal compilatore nomina una condizione, e ogni condizione porta tre identificatori, perché riconoscere una condizione, registrarla e citarla sono tre compiti diversi. La sentinella è il valore Go con cui errors.Is trova la corrispondenza, ottenuto chiamando la funzione di accesso che il pacchetto dichiarante esporta: l’identificatore che il codice Go riconosce. Il codice è la stringa con cui la condizione è registrata: nomina a parole la condizione stessa, ed è ciò che resta fisso mentre i pacchetti Go attorno a essa evolvono — l’identificatore che un programma registra. Il codice breve è la lettera E seguita da quattro cifre, abbastanza breve da leggerlo ad alta voce, digitarlo in una ricerca o incollarlo in una segnalazione: l’identificatore che una persona cita. Una condizione, tre identificatori — fai corrispondere la sentinella per riconoscere la condizione da Go, leggi il codice quando devi registrarla o usarla come chiave, e risolvi un codice breve nella tabella di ogni condizione più avanti in questa pagina.
La diagnostica rivolta all’utente (il messaggio con prefisso catalogato in fatal-halts.md e error-translation.md) porta la prosa rivolta allo sviluppatore; la sentinella incapsulata è ciò con cui errors.Is confronta l’errore nei consumatori programmatici.
Questa pagina è la vista del catalogo indicizzata per sentinella. I programmatori che scrivono gate di CI, integrazioni IDE o codice di orchestrazione dei build che deve distinguere i tipi di errore fanno la corrispondenza con le sentinelle elencate qui tramite il predicato standard errors.Is. Gli autori che eseguono il debug di un build leggendo il testo dell’errore emesso di solito vogliono le viste indicizzate per messaggio — fatal-halts.md per gli errori che arrestano il build, warnings.md per l’output di avviso.
Ogni riga delle tabelle seguenti nomina una funzione di accesso — una funzione senza argomenti, esportata dal pacchetto che la tabella nomina, che restituisce la sentinella. Importare quel pacchetto e chiamare la funzione di accesso è la superficie di integrazione supportata, ed è per questo che le tabelle scrivono ciascuna con le sue parentesi — la chiamata è ciò che produce un valore con cui errors.Is può trovare la corrispondenza, e il nome senza di esse è una funzione anziché un errore:
import ( "errors"
"github.com/aggrega-ai/aggrega-cli/pkg/resolver")
if errors.Is(err, resolver.ErrParameterContractViolation()) { // handle parameter contract violations}I tre identificatori portano ciascuno la propria stabilità, e questa separazione è il motivo per cui una condizione li ha tutti e tre. Le funzioni di accesso elencate di seguito sono stabili tra le versioni di patch; le ridenominazioni o le rimozioni sono annunciate nella voce del changelog della versione che le introduce, e aggiungere una nuova funzione di accesso all’interno di un pacchetto è un’aggiunta e non rompe le corrispondenze esistenti. Un codice è fisso una volta pubblicata la sua condizione, quindi è l’identificatore da registrare ovunque una condizione debba essere nominata in modo duraturo: rinominare una funzione di accesso non sposta il codice con cui la sua condizione è stata registrata, e un codice che hai registrato sopravvive a un refactoring della superficie Go. Un codice breve è il più duraturo dei tre: un numero viene assegnato una volta e poi resta fisso, e il numero di una condizione ritirata resta ritirato anziché essere assegnato a una condizione diversa, quindi un codice breve registrato in una vecchia segnalazione nomina ancora la condizione che nominava quando è stato registrato. Questo è imposto e non soltanto inteso — una condizione dichiarata con un numero ritirato viene rifiutata prima che il compilatore legga qualsiasi input, a ogni esecuzione — e ogni numero ritirato è pubblicato accanto a quelli attivi nella tabella di ogni condizione. La colonna del codice qui sotto porta il codice, ed è il valore che un client della diagnostica strutturata legge senza collegare questi pacchetti. È pubblicato anziché dedotto, perché non deve necessariamente ripetere la riga su cui si trova — un nome riesportato riporta il codice della condizione a cui inoltra, e il codice di una regola nomina la regola anziché la funzione di accesso. La colonna del messaggio è il testo letterale che la sentinella produce; la diagnostica rivolta all’utente antepone a quel testo un’intestazione tra parentesi quadre e la posizione nel sorgente. Quell’intestazione porta il codice breve della condizione, con accanto la categoria dell’occorrenza dove l’occorrenza ne ha una, come in [DEVELOPER_ERROR E0007] — così un lettore può risolvere l’uno o l’altra in modo indipendente: le categorie (DEVELOPER_ERROR / OPS_ERROR / CATALOG_ERROR / TRANSLATION_ERROR / FETCH_ERROR / POLICY_ERROR / TRUST_ERROR) sono spiegate in error-translation.md, e i codici brevi si risolvono nella tabella di ogni condizione in questa pagina. Dove è stato un plugin a sollevare la condizione, il token del codice è qualificato dal plugin che l’ha sollevata — [TRANSLATION_ERROR provider/example:1.0.0/E0007] — e il codice breve è il segmento finale; error-translation.md spiega perché c’è il qualificatore e perché il segmento finale è quello da risolvere.
Leggere il codice di una condizione
Un codice nomina la condizione e nient’altro, in kebab-case — parameter-contract-violation, lockfile-drift. Non porta alcun prefisso: né il pacchetto che lo dichiara, né la fase che lo solleva, né un raggruppamento di alcun tipo. Così un codice resta lo stesso quando il compilatore viene riorganizzato attorno a esso, e una condizione sollevata in più di un punto di una compilazione ha comunque un solo nome. Il nome di ogni condizione è distinto di per sé, ed è questo che rende superfluo il prefisso, e due condizioni non possono essere registrate con un solo codice. Leggilo da un errore con CodeOf, da github.com/aggrega-ai/aggrega-cli/pkg/errors, che percorre la catena di incapsulamento come fa errors.Is, così il codice sopravvive a quanti che siano i livelli che hanno incapsulato l’errore lungo il suo percorso di ritorno fino a te. Quel pacchetto si chiama a sua volta errors, quindi un alias di importazione lo tiene separato dalla libreria 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 riporta anche se un errore della catena portava un codice; una catena che non ne porta nessuno è un fatto relativo a quella catena anziché un fallimento. Dove preferisci fare da te la corrispondenza con l’interfaccia, lo stesso pacchetto la esporta come CodedError, e errors.As la trova nello stesso percorso.
Un codice viaggia in una sola direzione. È ciò che una condizione riporta, mai ciò che la identifica per chi fa la corrispondenza: scrivere la stringa nel tuo codice sorgente ti dà una stringa, e non c’è alcun percorso che riporti da una stringa al valore con cui errors.Is trova la corrispondenza. Fai corrispondere la sentinella per riconoscere una condizione; leggi il codice per registrarne una.
Il codice che aggrega stampa su un terminale è quello breve, non questo. Una diagnostica di arresto si apre con un’intestazione tra parentesi quadre che porta il codice breve della condizione, con accanto la categoria dell’occorrenza dove l’occorrenza ne ha una — [DEVELOPER_ERROR E0007], oppure [TRANSLATION_ERROR provider/example:1.0.0/E0007] dove è stato un plugin a sollevare la condizione e il codice è qualificato dal plugin che l’ha sollevata, oppure [E0007] dove il fallimento non ha alcuna competenza verso cui indirizzarti — e poi la posizione nel sorgente e il testo del messaggio catalogato in fatal-halts.md. Il codice descrittivo nomina la condizione a parole ed è troppo largo per quella posizione: sulle condizioni più lunghe riempirebbe un terminale stretto prima ancora che iniziasse il messaggio, ed è proprio questo il motivo per cui esiste un secondo identificatore compatto. Quindi il token da cui partire quando hai solo l’output stampato è il codice breve, e si risolve nella tabella di ogni condizione più avanti in questa pagina: da un numero che puoi leggere al telefono arrivi alla condizione, alla sua funzione di accesso e al testo del suo messaggio. aggrega explain <code> esegue questa risoluzione al terminale — accetta l’uno o l’altro dei codici della condizione e stampa la condizione insieme alla voce che documenta la correzione di authoring, ed è descritto in aggrega explain. Le viste indicizzate per messaggio in fatal-halts.md restano il modo di partire dalla formulazione anziché da un identificatore.
Il punto in cui un codice viaggia davvero al di fuori di Go è la diagnostica strutturata che pubblica il daemon del compilatore come servizio, come un campo code a sé stante su ogni voce anziché qualcosa incorporato nel testo del messaggio — così un’estensione dell’editor, o qualsiasi altro client di quel protocollo, si dirama in base a ciò che una voce riporta senza collegare questi pacchetti e senza analizzare la prosa. Quell’unica chiave porta un codice confrontabile da una macchina, chiunque lo abbia assegnato, e la voce dice quale livello lo ha sollevato. Lì un codice ha tre origini, e la terza è il motivo per cui un codice che puoi cercare in questa pagina non è di per sé un segno che qualcosa sia fallito:
- Il codice della condizione che un fallimento nomina, che è ciò che questa pagina cataloga.
- Il codice di classe di un avviso sull’output renderizzato —
unsupported-fieldè uno di questi, e warnings.md lo descrive. Viene assegnato ovunque l’avviso sia stato sollevato anziché essere registrato come condizione, quindi qui non ha alcuna riga. - Il codice registrato di un avviso sui documenti che hai scritto — un nome a una modifica di distanza da uno dichiarato, un parametro che nulla legge. Un rilievo del genere nomina una condizione nella stessa forma di un fallimento, quindi il suo codice è registrato e ha una riga in questa pagina, e leggere quella riga ti dice di che cosa tratta il rilievo.
Quindi lo stesso codice che leggeresti da un arresto può raggiungerti anche da un build che si è concluso, portato da un rilievo che non ha cambiato nulla dell’esito. Ciò che distingue i due è l’esito che hai ricevuto e il livello che la voce nomina — mai la forma del codice stesso, e mai il fatto che si risolva qui. Il campo è omesso dove nulla di ciò che ha prodotto la voce ha assegnato un codice: un fallimento che non nomina alcuna condizione propria di Aggrega, e un avviso a cui chi lo ha sollevato non ne ha assegnato nessuno. aggrega serve documenta la forma della voce, la chiave che nomina il livello e quando il campo è presente.
Una diagnostica strutturata porta entrambi gli identificatori di una condizione, e sapere quale è quale fa la differenza tra un identificatore su cui puoi agire e uno su cui non puoi. La chiave code sopra è per un programma: con trattini e con il nome della condizione a parole, così un’estensione che si dirama su di essa si legge per ciò che significa, ed è il valore che CodeOf riporta in Go. La chiave shortCode accanto è per una persona — la lettera E seguita da quattro cifre, lo stesso token che una diagnostica di arresto stampa nella sua intestazione tra parentesi quadre. È ciò che leggi al telefono, digiti in una casella di ricerca o incolli in una issue, ed è il token su cui è indicizzata la tabella di ogni condizione.
Nessuno dei due è l’abbreviazione dell’altro, e nessuno dei due è un ripiego per l’altro. Fai la corrispondenza sul codice descrittivo; mostra a un lettore quello breve. Una superficie che offrisse solo il codice descrittivo consegnerebbe a un autore un identificatore pensato per chi fa la corrispondenza, e una che facesse la corrispondenza sul codice breve la farebbe su un numero che non dice nulla della condizione — ed è per questo che viaggiano entrambi anziché sceglierne uno.
Una terza chiave, codeDescription, indica dove è pubblicata la condizione, come riferimento da aprire per saperne di più sulla diagnostica. Il suo indirizzo si risolve nella tabella di ogni condizione in questa pagina, così un lettore che lo segue da un editor arriva con in mano il codice breve su cui la tabella è indicizzata. Una voce porta il codice breve e il riferimento insieme, oppure nessuno dei due: entrambi sono presenti esattamente dove la voce nomina una condizione registrata — una con una riga in quella tabella — ed entrambi sono assenti dove il codice nomina una classe di avviso o l’identità di una regola delle convenzioni di un tuo linter che Aggrega non dichiara, perché per quelli non c’è alcun numero da citare e nulla qui che li descriva.
Nell’altra direzione — da un codice che hai in mano alla condizione che nomina — le tabelle seguenti sono l’elenco pubblicato. Ogni riga porta il codice accanto alla funzione di accesso che produce la stessa condizione in Go, così un codice letto da una diagnostica strutturata si risolve in un nome con cui puoi fare la corrispondenza e nel testo che la condizione produce. Le tabelle coprono le condizioni la cui funzione di accesso puoi importare, e due tipi di codice restano al di fuori: un codice di classe, che nomina una classe di avviso anziché una condizione e quindi non ha alcuna funzione di accesso da mettergli accanto, e un codice la cui condizione è dichiarata solo in un pacchetto che non puoi importare e non è riesportata da nessuna parte, dove non c’è alcun nome confrontabile da mettergli accanto. Quel secondo tipo nomina comunque una condizione, e quella condizione ha comunque un codice breve — la tabella di ogni condizione, più avanti in questa pagina, è indicizzata sul codice breve anziché su un nome importabile e quindi copre anche quelli.
La superficie confrontabile, per pacchetto dichiarante
Ogni sezione seguente è un pacchetto che puoi importare. La sua intestazione è il percorso del pacchetto relativo al percorso del modulo github.com/aggrega-ai/aggrega-cli, quindi la sezione intitolata pkg/resolver si importa come github.com/aggrega-ai/aggrega-cli/pkg/resolver.
Le voci sono raggruppate per il pacchetto che dichiara la sentinella, perché è quello il pacchetto che chi fa la corrispondenza importa. In quale punto di un build venga sollevata la condizione è una questione separata, e una a cui questa pagina deliberatamente non risponde: una singola sentinella viene spesso sollevata da più punti, e diverse vengono sollevate solo da codice che il modulo non esporta, quindi nessuna risposta per singola voce sarebbe vera per ogni riga. Le viste indicizzate per messaggio rispondono alla domanda sul quando in un build in termini che puoi osservare — fatal-halts.md prima di tutte.
Alcuni nomi compaiono in più di un pacchetto. Sono riesportazioni di un unico valore condiviso anziché due condizioni, quindi la corrispondenza con l’uno o l’altro nome riesce; le tabelle lo indicano dove entrambi i nomi sono importabili. Entrambe le righe portano lo stesso codice, che è lo stesso fatto enunciato sull’identificatore che detiene un client al di fuori di Go: una condizione, un codice, per quanti nomi la raggiungano.
pkg/catalog
| Sentinella | Codice | Messaggio |
|---|---|---|
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()è lo stesso valore dipkg/resolver.ErrManifestImplementsMismatch(), quindi la corrispondenza con l’uno o l’altro nome riesce.
pkg/closure
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
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()è lo stesso valore dipkg/refcycle.ErrCycle(), quindi la corrispondenza con l’uno o l’altro nome riesce.
pkg/deprecation
| Sentinella | Codice | Messaggio |
|---|---|---|
ErrDeprecatedEntity() | deprecated-entity | deprecation: build consumes a deprecated entity |
pkg/docscache
| Sentinella | Codice | Messaggio |
|---|---|---|
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()è lo stesso valore dipkg/oci.ErrFetchNotFound(), quindi la corrispondenza con l’uno o l’altro nome riesce.
pkg/egress
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
ErrNameWindowsCannotHold() | name-windows-cannot-hold | a name this operation writes holds a path segment Windows cannot hold as written |
pkg/pluginpath
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
ErrCycle() | reference-cycle | circular reference expansion |
pkg/registrytrust
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
ErrFetchIntegrity() | fetch-integrity | oci: content digest mismatch |
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrFetchIntegrity()è lo stesso valore dipkg/oci.ErrFetchIntegrity(), quindi la corrispondenza con l’uno o l’altro nome riesce.ErrFetchNotFound()è lo stesso valore dipkg/oci.ErrFetchNotFound(), quindi la corrispondenza con l’uno o l’altro nome riesce.
pkg/sourcekind
| Sentinella | Codice | Messaggio |
|---|---|---|
ErrUnknownKind() | unknown-source-kind | no source adapter serves the source kind |
pkg/sourceresolver
| Sentinella | Codice | Messaggio |
|---|---|---|
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()è lo stesso valore dipkg/oci.ErrFetchIntegrity(), quindi la corrispondenza con l’uno o l’altro nome riesce.ErrFetchNetworkUnreachable()è lo stesso valore dipkg/oci.ErrFetchNetworkUnreachable(), quindi la corrispondenza con l’uno o l’altro nome riesce.ErrFetchNotFound()è lo stesso valore dipkg/oci.ErrFetchNotFound(), quindi la corrispondenza con l’uno o l’altro nome riesce.ErrFetchUnauthorized()è lo stesso valore dipkg/oci.ErrFetchUnauthorized(), quindi la corrispondenza con l’uno o l’altro nome riesce.
pkg/sourceresolver/cacheslot
| Sentinella | Codice | Messaggio |
|---|---|---|
ErrEmptyWorkspaceRoot() | empty-workspace-root | cacheslot: empty workspaceRoot |
pkg/sourceresolver/netrc
| Sentinella | Codice | Messaggio |
|---|---|---|
ErrNetrcFileUnreadable() | netrc-file-unreadable | the netrc file could not be read |
ErrSourceURLCarriesCredential() | source-url-carries-credential | the source URL carries a credential |
pkg/types
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
ErrDanglingUsesTarget() | dangling-uses-target | uses edge target does not exist |
ErrReleaseEdgeRetarget() | release-edge-retarget | release edge retargets a developer-declared edge |
pkg/validator
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
ErrExtensionEval() | schema-extension-evaluation-failed | validator/jsonschema: x-aggrega extension evaluation failed |
ErrSchemaResolve() | schema-not-resolvable | validator/jsonschema: schema resolution failed |
pkg/validator/merger
| Sentinella | Codice | Messaggio |
|---|---|---|
ErrMergeInvalid() | schema-merge-input-invalid | merger: invalid merge input |
pkg/workspaceconfig
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
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
| Sentinella | Codice | Messaggio |
|---|---|---|
ErrPositionOutOfRange() | position-out-of-range | position out of range |
Sentinelle che portano un’altra sentinella
ErrCacheMetadataInvalid (pkg/sourceresolver/metadata) segnala uno slot della cache degli artefatti sorgente corrotto. È dichiarata come un wrapper attorno a ErrFetchIntegrity() anziché come un’identità propria, quindi non compare nelle tabelle precedenti e una corrispondenza con ErrFetchIntegrity() riesce anche per essa. Poiché incapsula una sentinella anziché dichiararne una, è esportata come valore anziché come funzione: fai la corrispondenza con essa come ErrCacheMetadataInvalid, senza parentesi. Fai la corrispondenza con il wrapper quando vuoi quella condizione specifica, e con la sentinella incapsulata quando vuoi l’intera classe di integrità.
Sentinelle raggiungibili con un secondo nome in uno stesso pacchetto
Dove un pacchetto esporta due funzioni di accesso per una condizione — la seconda dichiarata come inoltro verso la prima — le tabelle precedenti riportano la funzione di accesso dichiarante e lasciano fuori il nome di inoltro. Entrambi i nomi sono esportati dallo stesso pacchetto, quindi un’importazione che raggiunge l’uno raggiunge già l’altro, e una seconda riga elencherebbe una condizione due volte sotto un nome con cui non si trova alcuna corrispondenza nuova. La corrispondenza con l’uno o l’altro nome riesce: l’inoltro restituisce lo stesso valore che restituisce la funzione di accesso dichiarante.
Questo non è il caso tra pacchetti diversi. Una sentinella riesportata da un altro pacchetto ha una riga nella tabella di ciascun pacchetto, perché chi fa la corrispondenza importando uno di quei pacchetti non può raggiungere il nome dell’altro senza importare anche quel pacchetto; un inoltro all’interno di un singolo pacchetto non ha bisogno di una seconda riga, perché un’unica importazione raggiunge entrambi i nomi.
ErrDuplicateRecipeIdentity() in pkg/catalog è un inoltro di questo tipo: restituisce ErrDuplicateEntityIdentity(), che è il nome riportato dalla tabella di quel pacchetto.
Condizioni senza una sentinella confrontabile
Alcune fasi della compilazione dichiarano le proprie sentinelle in pacchetti che il compilatore non esporta, quindi non c’è nulla a cui errors.Is possa fare riferimento e non si può scrivere alcuna corrispondenza su di esse. Sono descritte qui anziché messe in tabella, perché una tabella in questa pagina è la promessa che la colonna di sinistra può essere dereferenziata.
La loro diagnostica ti raggiunge per intero attraverso il testo dell’errore emesso e attraverso le viste indicizzate per messaggio — fatal-halts.md in particolare — che sono il modo supportato per riconoscerle:
- La costruzione della topologia (costruzione del grafo e appiattimento dei sotto-aggregati) segnala un sotto-Aggregate che non è stato possibile caricare, nominando l’URI dell’Aggregate irraggiungibile; una dichiarazione
uses:la cui forma strutturale non corrisponde allo schema; il superamento della profondità di annidamento; e una collisione di ID di nodo dopo l’appiattimento, in cui due sotto-Aggregates vengono compilati nello stesso ID di nodo e un nome di istanza deve essere rinominato per disambiguare. - La finalizzazione del grafo (fusione delle Feature tra le superfici dell’Aggregate e della Release) segnala un tipo di Feature dichiarato in modo incoerente tra le due.
- L’analisi statica (valutazione dei selettori e controlli di sicurezza dei tipi tra nodi) segnala una violazione di
selector:; una mancata risoluzione nel catalogo oltre la quale non può procedere, nominando l’entità irraggiungibile; e un rifiuto della policy, in cui un plugin associato a un ruolo di verdetto di governance ha rifiutato il build assemblato. Un rifiuto della policy porta la categoriaPOLICY_ERROR, il nome del plugin che ha rifiutato e il messaggio della regola fornito dal plugin. - Il rendering (smistamento ai provider e rendering per singolo provider) segnala un provider sconosciuto.
- Il loader host Wasm incorporato emette le proprie sentinelle di guardrail — un guardrail di manifest rifiutato (un plugin ha richiesto una capacità di accesso al runtime che il firewall della purezza AOT nega), un recupero da un panic del guest e una trap deterministica di uscita del plugin. Queste emergono nella diagnostica rivolta all’utente quando si esegue un plugin (per esempio tramite
aggrega lint). Gli autori di Plugin che testano un guest rispetto all’host raggiungono le stesse condizioni tramite nome importabile attraversopkg/plugintest, elencato sopra.
Per bloccare una pipeline specificamente in base a un rifiuto della policy, fai la corrispondenza con il prefisso di categoria POLICY_ERROR nella diagnostica anziché con una sentinella; la categoria è una parte documentata della superficie degli errori, descritta in error-translation.md.
Ogni condizione, per codice breve
La tabella seguente esegue la ricerca nella direzione opposta: un codice breve nella colonna di sinistra e, accanto, la condizione che quel codice nomina e il testo che quella condizione produce. Copre ogni condizione che aggrega può riportare, comprese quelle che le sezioni precedenti non possono elencare.
Questa copertura più ampia è lo scopo di questa tabella, non un suo effetto casuale. Le sezioni precedenti sono indicizzate su un nome che puoi importare, quindi una condizione dichiarata solo in un pacchetto che non puoi importare — e non riesportata nemmeno da nessuna parte che tu possa importare — non ha nulla da mettere nella loro colonna di sinistra. Questa tabella è indicizzata sul codice breve, e ogni condizione ne ha uno, quindi nessuna condizione riportabile resta al di fuori. Un codice breve che hai in mano si risolve qui, che la condizione dietro di esso abbia o no anche una funzione di accesso con cui puoi fare la corrispondenza.
Ciò che fa guadagnare un posto in questa tabella è che il compilatore possa effettivamente riportare la condizione. Le righe sono derivate dal codice anziché trascritte in esso: una condizione compare qui perché qualcosa nel compilatore la solleva, quindi ogni codice nella colonna di sinistra è uno che aggrega può stampare. Questa è la promessa che la tabella fa, ed è ciò che ti permette di leggere una riga come un controllo che viene davvero eseguito.
L’eccezione deliberata è una condizione dichiarata prima che esista il codice che la riporta, così che il codice e la formulazione siano fissati in anticipo e non cambino mai sotto un lettore che li ha già citati. Una condizione del genere lo dice in una nota direttamente sotto la tabella. È elencata anziché nascosta — un codice che hai in mano deve sempre risolversi — e la nota accanto ti dice chiaramente che nessun build la solleva ancora, e che cosa dovrebbe esistere prima che uno lo faccia.
Anche un numero ritirato è elencato, in un proprio gruppo di note sotto la tabella, e resta elencato in modo permanente. Di tanto in tanto una condizione viene soppressa — è sostituita da una che copre più casi, oppure nulla l’ha mai riportata — e da quel momento il suo numero è ritirato: non viene mai assegnato a una condizione diversa, quindi un codice breve che citi da una vecchia segnalazione può nominare soltanto ciò che nominava quando la segnalazione è stata scritta. Questa promessa è meccanica, non editoriale. Una condizione dichiarata con un numero ritirato viene rifiutata prima che il compilatore legga qualsiasi input, a ogni esecuzione, quindi nessuna versione può contenerne una — la stessa classe di rifiuto che incontrerebbe un numero che due condizioni attive tentassero di condividere, formulata in modo che tu possa capire in quale dei due casi sei incappato. La nota di un codice ritirato ti dice, dove il ritiro lo ha registrato, che cosa nominava il codice e, dove la condizione è stata sostituita, quale codice riporta ora quell’ambito.
Non riutilizzare mai un numero è anche ciò che dà alla sequenza le sue lacune permanenti, e le note sono ciò che rende leggibili quelle lacune. Un numero mancante non è di per sé prova di nulla: può essere ritirato, e può altrettanto essere uno che nulla ha ancora raggiunto. Le note registrano quali numeri sono ritirati e, dove è stato registrato, che cosa nominava ciascuno di essi, quindi un codice che non si risolve né in una riga né in una nota è uno che questo compilatore non ha mai emesso.
Un codice breve è deliberatamente opaco: quattro cifre di per sé non dicono nulla di una condizione, ed è il prezzo di un identificatore abbastanza breve da leggerlo ad alta voce, digitarlo in una ricerca o incollarlo in una segnalazione. La corrispondenza qui sotto è ciò che lo rende utilizzabile. Un numero viene assegnato una volta, da un’unica sequenza crescente, ed è fisso da quel momento in poi; non dice nulla della condizione che nomina. Quindi un codice breve è un identificatore e nient’altro — il suo valore non è una classificazione, e né esso né alcun raggruppamento che potresti notare nella tabella è una guida a dove si trova una condizione o a che cosa riguarda.
La tabella non ha alcuna colonna della categoria, e non è un’omissione: una categoria è una proprietà di un particolare fallimento anziché della condizione che vi sta dietro. Alcune condizioni appartengono a una categoria per costruzione. Per altre la categoria deriva dal tipo di entità di cui tratta il fallimento, quindi una condizione del genere riportata una volta per un Aggregate e una volta per una Release porta ogni volta una categoria diversa — e un singolo valore scritto qui accanto alla condizione sarebbe sbagliato per ogni condizione di questo secondo tipo.
Le categorie sono spiegate in error-translation.md — ciascuna, che cosa significa e dove si trova la sua correzione. Una categoria e un codice breve rispondono a domande diverse sullo stesso fallimento: la categoria identifica la superficie a cui appartiene la correzione, e il codice breve identifica quale condizione ha arrestato il build. Nessuno dei due è deducibile dall’altro, ed è per questo che ciascuno ha il proprio elenco pubblicato — e per questo un fallimento senza una superficie di authoring da nominare porta comunque un codice che puoi cercare qui.
| Codice | Condizione | Messaggio |
|---|---|---|
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 |
E0002è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. Nominava una ricerca nel catalogo che fallisce mentre vengono controllati i contratti statici del grafo — un difetto del compilatore anziché di un documento scritto — e ora quello stato è riportato dalla condizione sollevata quando un build risolve un tipo di componente per cui il catalogo che legge non contiene in quel momento alcuna voce, e il suo codice èE0154.E0134è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. Nominava un’entità pubblicabile la cui directory non portava il nome della versione che l’entità dichiara; una pubblicazione non giudica il nome di una directory, e la condizione sollevata quando un’entità condivide la propria directory con un’altra entità laddove il suo tipo ha una directory propria èE0303.E0157è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. Nominava una chiave dell’Aggregate — un nome di istanza di componente, di funzionalità, di sottosistema o di modulo annidato — che non corrispondeva al pattern dei nomi scritti dall’autore. Ognuna di quelle superfici di chiave è vincolata a quella stessa grafia dallo schema dell’Aggregate, che rifiuta il documento durante la validazione del suo involucro e riporta la chiave incriminata con riga e colonna; il codice di quella condizione èE0215.E0159è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. Nominava un riferimento di destinazione i cui segmenti separati da punti non corrispondevano tutti al pattern dei nomi di istanza, e nessun build lo ha riportato prima che la condizione fosse soppressa.E0166è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. Nominava il file a cui punta ilparameters: { $import: … }di una Release quando quel file non poteva essere letto o i suoi byte non erano analizzabili; un file che non produce alcun documento è un’unica condizione ovunque sia stato scritto il percorso, e il suo codice èE0175.E0203è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. Nominava una FeatureRecipe sulla capacitàevalche dichiarava una sorgente, un overlay di values, un carico di lavoro o degli artefatti; quella capacità è stata soppressa, e ora nulla riporta questo stato.E0206è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. Nominava una Recipe sulla capacitàevalche dichiarava una sorgente, un carico di lavoro, degli artefatti o un overlay di values; quella capacità è stata soppressa, e una Recipe che non dichiara nessuno di questi elementi viene rifiutata su ogni capacità conE0210.E0217è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. Nominava un fallimento della validazione dello schema che non poteva essere riportato su un campo specifico, e nessun build lo ha riportato prima che la condizione fosse soppressa.E0219è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. Nominava una catenaextendsciclica, riportata da un percorso della catena separato dal passo di combinazione della fusione degli schemi; un unico percorso della catena riporta ogni catena ciclica, e il codice corrispondente èE0202.E0230è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. La condizione che questo numero nominava è stata soppressa, e nessun build la riporta.E0231è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. La condizione che questo numero nominava è stata soppressa, e nessun build la riporta.E0232è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. La condizione che questo numero nominava è stata soppressa, e nessun build la riporta.E0233è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. La condizione che questo numero nominava è stata soppressa, e nessun build la riporta.E0234è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. Nominava una sorgente di Recipe che è una stringa vuota, riportata durante il rendering tramite il provider compose; ora lo riporta un’unica condizione che copre ogni provider, e il suo codice èE0251.E0235è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. La condizione che questo numero nominava è stata soppressa, e nessun build la riporta.E0236è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. La condizione che questo numero nominava è stata soppressa, e nessun build la riporta.E0237è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. La condizione che questo numero nominava è stata soppressa, e nessun build la riporta.E0238è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. La condizione che questo numero nominava è stata soppressa, e nessun build la riporta.E0239è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. La condizione che questo numero nominava è stata soppressa, e nessun build la riporta.E0240è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. La condizione che questo numero nominava è stata soppressa, e nessun build la riporta.E0241è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. La condizione che questo numero nominava è stata soppressa, e nessun build la riporta.E0242è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. Nominava una sorgente di Recipe che è una stringa vuota, riportata durante il rendering tramite il provider Helm; ora lo riporta un’unica condizione che copre ogni provider, e il suo codice èE0251.E0243è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. La condizione che questo numero nominava è stata soppressa, e nessun build la riporta.E0244è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. La condizione che questo numero nominava è stata soppressa, e nessun build la riporta.E0245è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. La condizione che questo numero nominava è stata soppressa, e nessun build la riporta.E0249è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. La condizione che questo numero nominava è stata soppressa, e nessun build la riporta.E0258è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. La condizione che questo numero nominava è stata soppressa, e nessun build la riporta.E0322è ritirato: ora nulla lo riporta, e il numero non viene mai assegnato a una condizione diversa. Nominava un valore che una Feature associata a un confine calcolava per l’ambiente di un componente sotto una chiave che un’altra associazione aveva già consegnato. Una Feature associata a un confine consegna in un componente solo attraverso l’injectMapping della sua FeatureRecipe, e una mappatura che scrive una chiave consegnata da un’altra associazione è riportata conE0318.
Indicazioni sulla corrispondenza
Il predicato errors.Is percorre la catena di incapsulamento, quindi una corrispondenza con una sentinella funziona anche quando l’errore viene incapsulato più volte lungo il suo percorso di ritorno fino a te. Fai la corrispondenza con l’errore restituito da una funzione esportata:
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}Non esiste alcun punto di ingresso esportato che esegua un intero build, quindi la corrispondenza con errors.Is si applica al codice che chiama direttamente questi pacchetti. Per bloccare la CI in base a un build, esegui aggrega build e leggi il suo stato di uscita e la sua diagnostica: il testo dei messaggi è catalogato in fatal-halts.md, la categoria in error-translation.md, e il codice breve nella loro intestazione tra parentesi quadre si risolve nella tabella di ogni condizione in questa pagina.
I due percorsi di gate esistono perché i tre identificatori arrivano a distanze diverse. Un gate scritto in Go collega questi pacchetti, fa la corrispondenza con le sentinelle e può leggere l’uno o l’altro codice da qualsiasi errore abbia in mano. Un gate scritto attorno al comando ha lo stato di uscita e il testo stampato — e il testo stampato nomina la condizione, perché il codice breve si trova nell’intestazione tra parentesi quadre. Quindi un gate del genere si basa su quel codice breve anziché sulla formulazione del messaggio, e le viste indicizzate per messaggio restano il modo per risalire dalla formulazione che ha già. Fai la corrispondenza con la sentinella da Go; basati sul codice breve attorno al comando; leggi il codice descrittivo dalla diagnostica strutturata dove un client parla quel protocollo.
Le sentinelle dichiarate in pacchetti diversi con lo stesso nome breve sono condizioni distinte, non due grafie di una sola: errors.Is le distingue per identità, quindi una corrispondenza con una non corrisponde all’altra. Le riesportazioni segnalate nelle tabelle sono l’eccezione, e sono segnalate proprio perché sono il caso in cui due nomi corrispondono davvero. Fai la corrispondenza con il nome nel pacchetto sotto cui le tabelle lo elencano, e considera ambiguo un nome breve preso da solo.
Per il catalogo della diagnostica rivolta all’utente (i messaggi che gli sviluppatori vedono nel terminale quando un build si arresta), vedi fatal-halts.md. Per il catalogo degli avvisi (l’output non bloccante warning:, lint: e notice:), vedi warnings.md. Per la tassonomia dei prefissi di categoria ([DEVELOPER_ERROR] / [OPS_ERROR] / [CATALOG_ERROR] / [TRANSLATION_ERROR] / [FETCH_ERROR] / [POLICY_ERROR] / [TRUST_ERROR]), vedi error-translation.md.