Sentinelas de erro — referência canónica
Cada interrupção fatal que o compilador emite nomeia uma condição, e cada condição tem três identificadores, porque reconhecer uma condição, anotá-la e citá-la são três tarefas diferentes. A sentinela é o valor Go com o qual errors.Is faz a correspondência, obtido ao chamar a função de acesso que o pacote declarante exporta: o identificador que o código Go reconhece. O código é a string sob a qual a condição está registada: nomeia por palavras a própria condição, e é o que permanece fixo enquanto os pacotes Go à sua volta evoluem — o identificador que um programa anota. O código curto é a letra E seguida de quatro dígitos, suficientemente curto para ser lido em voz alta, escrito numa pesquisa ou colado num relatório: o identificador que uma pessoa cita. Uma condição, três identificadores — faz-se corresponder a sentinela para reconhecer a condição a partir de Go, lê-se o código quando é preciso anotá-la ou usá-la como chave, e resolve-se um código curto na tabela de todas as condições mais abaixo nesta página.
O diagnóstico destinado ao utilizador (a mensagem com prefixo catalogada em fatal-halts.md e error-translation.md) contém o texto destinado ao programador; a sentinela encapsulada é aquilo com que errors.Is faz a correspondência nos consumidores programáticos.
Esta página é a vista do catálogo indexada por sentinela. Os programadores que escrevem gates de CI, integrações de IDE ou código de orquestração de compilações que precisa de distinguir tipos de erro fazem a correspondência com as sentinelas aqui listadas através do predicado padrão errors.Is. Os autores que depuram uma compilação lendo o texto de erro emitido querem normalmente as vistas indexadas por mensagem — fatal-halts.md para os erros que interrompem a compilação, warnings.md para a saída de avisos.
Cada linha das tabelas abaixo nomeia uma função de acesso — uma função sem argumentos, exportada do pacote que a tabela nomeia, que devolve a sentinela. Importar esse pacote e chamar a função de acesso é a superfície de integração suportada, e é por isso que as tabelas escrevem cada uma com os seus parênteses — a chamada é o que produz um valor com o qual errors.Is consegue fazer a correspondência, e o nome sem eles é uma função e não um erro:
import ( "errors"
"github.com/aggrega-ai/aggrega-cli/pkg/resolver")
if errors.Is(err, resolver.ErrParameterContractViolation()) { // handle parameter contract violations}Os três identificadores têm a sua estabilidade em separado, e essa separação é a razão pela qual uma condição tem os três. As funções de acesso listadas abaixo são estáveis entre versões de patch; as mudanças de nome ou remoções são anunciadas na entrada do changelog da versão que as faz, e acrescentar uma nova função de acesso dentro de um pacote é aditivo e não quebra as correspondências existentes. Um código fica fixo assim que a sua condição é publicada, pelo que é o identificador a anotar sempre que uma condição tenha de ser nomeada de forma duradoura: mudar o nome de uma função de acesso não altera o código sob o qual a sua condição foi registada, e um código que se tenha anotado sobrevive a uma refatoração da superfície Go. Um código curto é o mais duradouro dos três: um número é atribuído uma vez e depois fica fixo, e o número de uma condição retirada permanece retirado em vez de ser atribuído a uma condição diferente, pelo que um código curto anotado num relatório antigo continua a nomear a condição que nomeava quando foi anotado. Isto é imposto, e não apenas pretendido — uma condição declarada sob um número retirado é recusada antes de o compilador ler qualquer entrada, em cada execução — e cada número retirado é publicado ao lado dos ativos na tabela de todas as condições. A coluna do código abaixo contém o código, e é o valor que um cliente do diagnóstico estruturado lê sem ligar estes pacotes. É publicado em vez de inferido, porque não tem de repetir a linha em que está — um nome reexportado comunica o código da condição para a qual reencaminha, e o código de uma regra nomeia a regra e não a função de acesso. A coluna da mensagem é o texto literal que a sentinela produz; o diagnóstico destinado ao utilizador antepõe a esse texto um cabeçalho entre parênteses retos e a localização na fonte. Esse cabeçalho contém o código curto da condição, com a categoria da ocorrência ao lado quando a ocorrência tem uma, como em [DEVELOPER_ERROR E0007] — para que um leitor possa resolver qualquer um dos dois de forma independente: as categorias (DEVELOPER_ERROR / OPS_ERROR / CATALOG_ERROR / TRANSLATION_ERROR / FETCH_ERROR / POLICY_ERROR / TRUST_ERROR) são explicadas em error-translation.md, e os códigos curtos resolvem-se na tabela de todas as condições nesta página. Quando foi um plugin a levantar a condição, o token do código é qualificado pelo plugin que a levantou — [TRANSLATION_ERROR provider/example:1.0.0/E0007] — e o código curto é o segmento final; error-translation.md explica por que razão o qualificador ali está e por que razão o segmento final é o que se deve resolver.
Ler o código de uma condição
Um código nomeia a condição e nada mais, em kebab-case — parameter-contract-violation, lockfile-drift. Não tem prefixo: nem o pacote que o declara, nem a etapa que o levanta, nem um agrupamento de qualquer tipo. Assim, um código continua o mesmo quando o compilador é reorganizado à sua volta, e uma condição levantada em mais de um ponto de uma compilação continua a ter um único nome. O nome de cada condição é distinto por si só, e é isso que torna o prefixo desnecessário, e duas condições não podem ser registadas sob um mesmo código. Lê-se a partir de um erro com CodeOf, de github.com/aggrega-ai/aggrega-cli/pkg/errors, que percorre a cadeia de encapsulamento tal como errors.Is faz, pelo que o código sobrevive a quantos níveis tenham encapsulado o erro no caminho de regresso até quem o lê. Esse pacote também se chama errors, pelo que um alias de importação o mantém separado da biblioteca padrão:
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 indica também se algum erro da cadeia tinha um código; uma cadeia que não tem nenhum é um facto sobre essa cadeia e não uma falha. Quando se prefere fazer a correspondência com a interface diretamente, o mesmo pacote exporta-a como CodedError, e errors.As encontra-a no mesmo percurso.
Um código segue num único sentido. É aquilo que uma condição comunica, nunca aquilo que a identifica para uma correspondência: escrever a string no próprio código dá uma string, e não há caminho de volta de uma string para o valor com o qual errors.Is faz a correspondência. Faz-se corresponder a sentinela para reconhecer uma condição; lê-se o código para anotar uma.
O código que aggrega imprime num terminal é o curto, não este. Um diagnóstico de interrupção começa com um cabeçalho entre parênteses retos que contém o código curto da condição, com a categoria da ocorrência ao lado quando a ocorrência tem uma — [DEVELOPER_ERROR E0007], ou [TRANSLATION_ERROR provider/example:1.0.0/E0007] quando foi um plugin a levantar a condição e o código é qualificado pelo plugin que a levantou, ou [E0007] quando a falha não tem nenhuma área de responsabilidade para onde encaminhar o leitor — e depois a localização na fonte e o texto da mensagem catalogado em fatal-halts.md. O código descritivo nomeia a condição por palavras e é demasiado largo para essa posição: nas condições mais longas, encheria um terminal estreito antes de a mensagem começar, e é precisamente por isso que existe um segundo identificador, compacto. Assim, o token a partir do qual trabalhar quando só se tem a saída impressa é o código curto, e resolve-se na tabela de todas as condições mais abaixo nesta página: a partir de um número que se pode ler ao telefone chega-se à condição, à sua função de acesso e ao texto da sua mensagem. aggrega explain <code> faz essa resolução no terminal — aceita qualquer um dos dois códigos da condição e imprime a condição juntamente com a entrada que documenta a correção de autoria, e está descrito em aggrega explain. As vistas indexadas por mensagem em fatal-halts.md continuam a ser a forma de partir da redação em vez de um identificador.
Onde um código sai de facto de Go é no diagnóstico estruturado que o daemon do compilador como serviço publica, como um campo code próprio em cada entrada em vez de algo incorporado no texto da mensagem — de modo que uma extensão do editor, ou qualquer outro cliente desse protocolo, se ramifica pelo que uma entrada comunica sem ligar estes pacotes e sem analisar texto. Essa única chave contém um código que uma máquina pode comparar, seja quem for que o atribuiu, e a entrada diz que camada o levantou. Aí um código tem três origens, e a terceira é a razão pela qual um código que se pode consultar nesta página não é, por si só, sinal de que algo falhou:
- O código da condição que uma falha nomeia, que é o que esta página cataloga.
- O código de classe de um aviso sobre a saída renderizada —
unsupported-fieldé um deles, e warnings.md descreve-o. É atribuído onde quer que o aviso tenha sido levantado, em vez de ser registado como condição, pelo que não tem nenhuma linha aqui. - O código registado de um aviso sobre os documentos escritos pelo autor — um nome a uma edição de distância de um declarado, um parâmetro que nada lê. Uma constatação destas nomeia uma condição na mesma forma que uma falha, pelo que o seu código é registado e tem uma linha nesta página, e ler essa linha indica de que trata a constatação.
Assim, o mesmo código que se leria numa interrupção também pode chegar de uma compilação que terminou, transportado por uma constatação que nada mudou no resultado. O que distingue os dois é o resultado recebido e a camada que a entrada nomeia — nunca a forma do próprio código, e nunca o facto de se resolver aqui. O campo é omitido onde nada do que produziu a entrada atribuiu um código: uma falha que não nomeia nenhuma condição própria do Aggrega, e um aviso ao qual quem o levantou não atribuiu nenhum. aggrega serve documenta a forma da entrada, a chave que nomeia a camada e quando o campo está presente.
Um diagnóstico estruturado contém os dois identificadores de uma condição, e saber qual é qual faz a diferença entre um identificador sobre o qual se pode agir e outro sobre o qual não se pode. A chave code acima destina-se a um programa: com hífenes e a nomear a condição por palavras, para que uma extensão que se ramifica por ela se leia pelo que significa, e é o valor que CodeOf comunica em Go. A chave shortCode ao lado destina-se a uma pessoa — a letra E seguida de quatro dígitos, o mesmo token que um diagnóstico de interrupção imprime no seu cabeçalho entre parênteses retos. É o que se lê ao telefone, se escreve numa caixa de pesquisa ou se cola numa issue, e é o token pelo qual a tabela de todas as condições está indexada.
Nenhum é a forma abreviada do outro, e nenhum é um substituto do outro. Faz-se a correspondência pelo código descritivo; mostra-se o curto a um leitor. Uma superfície que oferecesse apenas o código descritivo entregaria a um autor um identificador pensado para uma correspondência, e uma que fizesse a correspondência pelo código curto fá-la-ia com um número que nada diz sobre a condição — e é por isso que os dois seguem juntos, em vez de se escolher um.
Uma terceira chave, codeDescription, indica onde a condição está publicada, como uma referência a abrir para saber mais sobre o diagnóstico. O seu endereço leva à tabela de todas as condições nesta página, de modo que um leitor que o segue a partir de um editor chega com o código curto em mãos, aquele pelo qual a tabela está indexada. Uma entrada contém o código curto e a referência juntos, ou nenhum dos dois: ambos estão presentes exatamente onde a entrada nomeia uma condição registada — uma com uma linha nessa tabela — e ambos estão ausentes onde o código nomeia uma classe de aviso ou a identidade de uma regra de convenções de um linter próprio que o Aggrega não declara, porque para esses não há nenhum número a citar nem nada aqui que os descreva.
No sentido inverso — de um código que se tem em mãos para a condição que ele nomeia — as tabelas abaixo são a lista publicada. Cada linha contém o código ao lado da função de acesso que produz a mesma condição em Go, de modo que um código lido de um diagnóstico estruturado se resolve num nome com o qual se pode fazer a correspondência e no texto que a condição produz. As tabelas abrangem as condições cuja função de acesso se pode importar, e dois tipos de código ficam de fora: um código de classe, que nomeia uma classe de aviso em vez de uma condição e por isso não tem nenhuma função de acesso para colocar ao lado, e um código cuja condição é declarada apenas num pacote que não se pode importar e não é reexportada em parte nenhuma, onde não há nenhum nome comparável para colocar ao lado. Esse segundo tipo continua a nomear uma condição, e essa condição continua a ter um código curto — a tabela de todas as condições, mais abaixo nesta página, está indexada pelo código curto em vez de por um nome importável e por isso abrange também esses.
A superfície comparável, por pacote declarante
Cada secção abaixo é um pacote que se pode importar. O seu título é o caminho do pacote relativo ao caminho do módulo github.com/aggrega-ai/aggrega-cli, pelo que a secção intitulada pkg/resolver se importa como github.com/aggrega-ai/aggrega-cli/pkg/resolver.
As entradas estão agrupadas pelo pacote que declara a sentinela, porque é esse o pacote que quem faz a correspondência importa. Em que ponto de uma compilação a condição é levantada é uma questão à parte, e uma a que esta página deliberadamente não responde: uma mesma sentinela é frequentemente levantada a partir de vários sítios, e várias são levantadas apenas a partir de código que o módulo não exporta, pelo que nenhuma resposta por entrada seria verdadeira para todas as linhas. As vistas indexadas por mensagem respondem à pergunta sobre o quando numa compilação em termos que se podem observar — fatal-halts.md acima de tudo.
Alguns nomes aparecem em mais de um pacote. São reexportações de um único valor partilhado, e não duas condições, pelo que a correspondência com qualquer um dos dois nomes resulta; as tabelas indicam-no onde ambos os nomes são importáveis. As duas linhas contêm o mesmo código, que é o mesmo facto expresso no identificador que um cliente fora de Go detém: uma condição, um código, sejam quantos forem os nomes que chegam a ela.
pkg/catalog
| Sentinela | Código | Mensagem |
|---|---|---|
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()é o mesmo valor quepkg/resolver.ErrManifestImplementsMismatch(), pelo que a correspondência com qualquer um dos dois nomes resulta.
pkg/closure
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
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()é o mesmo valor quepkg/refcycle.ErrCycle(), pelo que a correspondência com qualquer um dos dois nomes resulta.
pkg/deprecation
| Sentinela | Código | Mensagem |
|---|---|---|
ErrDeprecatedEntity() | deprecated-entity | deprecation: build consumes a deprecated entity |
pkg/docscache
| Sentinela | Código | Mensagem |
|---|---|---|
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()é o mesmo valor quepkg/oci.ErrFetchNotFound(), pelo que a correspondência com qualquer um dos dois nomes resulta.
pkg/egress
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
ErrNameWindowsCannotHold() | name-windows-cannot-hold | a name this operation writes holds a path segment Windows cannot hold as written |
pkg/pluginpath
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
ErrCycle() | reference-cycle | circular reference expansion |
pkg/registrytrust
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
ErrFetchIntegrity() | fetch-integrity | oci: content digest mismatch |
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrFetchIntegrity()é o mesmo valor quepkg/oci.ErrFetchIntegrity(), pelo que a correspondência com qualquer um dos dois nomes resulta.ErrFetchNotFound()é o mesmo valor quepkg/oci.ErrFetchNotFound(), pelo que a correspondência com qualquer um dos dois nomes resulta.
pkg/sourcekind
| Sentinela | Código | Mensagem |
|---|---|---|
ErrUnknownKind() | unknown-source-kind | no source adapter serves the source kind |
pkg/sourceresolver
| Sentinela | Código | Mensagem |
|---|---|---|
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()é o mesmo valor quepkg/oci.ErrFetchIntegrity(), pelo que a correspondência com qualquer um dos dois nomes resulta.ErrFetchNetworkUnreachable()é o mesmo valor quepkg/oci.ErrFetchNetworkUnreachable(), pelo que a correspondência com qualquer um dos dois nomes resulta.ErrFetchNotFound()é o mesmo valor quepkg/oci.ErrFetchNotFound(), pelo que a correspondência com qualquer um dos dois nomes resulta.ErrFetchUnauthorized()é o mesmo valor quepkg/oci.ErrFetchUnauthorized(), pelo que a correspondência com qualquer um dos dois nomes resulta.
pkg/sourceresolver/cacheslot
| Sentinela | Código | Mensagem |
|---|---|---|
ErrEmptyWorkspaceRoot() | empty-workspace-root | cacheslot: empty workspaceRoot |
pkg/sourceresolver/netrc
| Sentinela | Código | Mensagem |
|---|---|---|
ErrNetrcFileUnreadable() | netrc-file-unreadable | the netrc file could not be read |
ErrSourceURLCarriesCredential() | source-url-carries-credential | the source URL carries a credential |
pkg/types
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
ErrDanglingUsesTarget() | dangling-uses-target | uses edge target does not exist |
ErrReleaseEdgeRetarget() | release-edge-retarget | release edge retargets a developer-declared edge |
pkg/validator
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
ErrExtensionEval() | schema-extension-evaluation-failed | validator/jsonschema: x-aggrega extension evaluation failed |
ErrSchemaResolve() | schema-not-resolvable | validator/jsonschema: schema resolution failed |
pkg/validator/merger
| Sentinela | Código | Mensagem |
|---|---|---|
ErrMergeInvalid() | schema-merge-input-invalid | merger: invalid merge input |
pkg/workspaceconfig
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
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
| Sentinela | Código | Mensagem |
|---|---|---|
ErrPositionOutOfRange() | position-out-of-range | position out of range |
Sentinelas que contêm outra sentinela
ErrCacheMetadataInvalid (pkg/sourceresolver/metadata) comunica um slot corrompido da cache de artefactos de origem. É declarada como um wrapper em torno de ErrFetchIntegrity() em vez de como uma identidade própria, pelo que não aparece nas tabelas acima e a correspondência com ErrFetchIntegrity() resulta também para ela. Como encapsula uma sentinela em vez de declarar uma, é exportada como um valor e não como uma função: faz-se a correspondência com ela como ErrCacheMetadataInvalid, sem parênteses. Faz-se a correspondência com o wrapper quando se pretende essa condição específica, e com a sentinela encapsulada quando se pretende toda a classe de integridade.
Sentinelas acessíveis por um segundo nome num mesmo pacote
Quando um pacote exporta duas funções de acesso para uma condição — a segunda declarada como um reencaminhamento para a primeira —, as tabelas acima contêm a função de acesso declarante e deixam de fora o nome que reencaminha. Ambos os nomes são exportados do mesmo pacote, pelo que uma importação que alcança um já alcança o outro, e uma segunda linha listaria uma condição duas vezes sob um nome com o qual não se faz nenhuma correspondência nova. A correspondência com qualquer um dos dois nomes resulta: o reencaminhamento devolve o mesmo valor que a função de acesso declarante devolve.
Este não é o caso entre pacotes. Uma sentinela reexportada de outro pacote tem uma linha na tabela de cada pacote, porque quem faz a correspondência importando um desses pacotes não consegue alcançar o nome do outro sem importar também esse pacote; um reencaminhamento dentro de um único pacote não precisa de uma segunda linha, porque uma única importação alcança ambos os nomes.
ErrDuplicateRecipeIdentity() em pkg/catalog é um reencaminhamento deste tipo: devolve ErrDuplicateEntityIdentity(), que é o nome que a tabela desse pacote contém.
Condições sem uma sentinela comparável
Algumas etapas da compilação declaram as suas sentinelas em pacotes que o compilador não exporta, pelo que não há nada que errors.Is possa referenciar e não se pode escrever nenhuma correspondência contra elas. São descritas aqui em vez de tabeladas, porque uma tabela nesta página é a promessa de que a coluna da esquerda pode ser desreferenciada.
Os seus diagnósticos chegam por inteiro através do texto de erro emitido e das vistas indexadas por mensagem — fatal-halts.md em particular —, que são a forma suportada de os reconhecer:
- A construção da topologia (construção do grafo e achatamento de subagregados) comunica um sub-Aggregate que não foi possível carregar, nomeando o URI do Aggregate inacessível; uma declaração
uses:cuja forma estrutural não corresponde ao esquema; a profundidade de aninhamento excedida; e uma colisão de ID de nó após o achatamento, em que dois sub-Aggregates são compilados para o mesmo ID de nó e um nome de instância tem de ser alterado para desambiguar. - A finalização do grafo (fusão de Feature entre as superfícies do Aggregate e da Release) comunica um tipo de Feature declarado de forma incoerente entre as duas.
- A análise estática (avaliação de seletores e verificações de segurança de tipos entre nós) comunica uma violação de
selector:; uma falha de resolução no catálogo que a impede de avançar, nomeando a entidade inacessível; e uma rejeição por política, em que um plugin anexado a um papel de veredicto de governação rejeitou a compilação montada. Uma rejeição por política contém a categoriaPOLICY_ERROR, o nome do plugin que rejeitou e a mensagem de regra fornecida pelo plugin. - A renderização (despacho para fornecedores e renderização por fornecedor) comunica um fornecedor desconhecido.
- O carregador host Wasm incorporado emite as suas próprias sentinelas de salvaguarda — uma salvaguarda de manifesto rejeitado (um plugin pediu uma capacidade de acesso ao runtime que a firewall de pureza AOT nega), uma recuperação de pânico do guest e uma trap determinística de saída do plugin. Estas surgem no diagnóstico destinado ao utilizador quando se executa um plugin (por exemplo, através de
aggrega lint). Os autores de Plugin que testam um guest contra o host alcançam as mesmas condições por nome importável através depkg/plugintest, listado acima.
Para condicionar um pipeline especificamente a uma rejeição por política, faz-se a correspondência com o prefixo de categoria POLICY_ERROR no diagnóstico em vez de com uma sentinela; a categoria é uma parte documentada da superfície de erros, descrita em error-translation.md.
Cada condição, por código curto
A tabela abaixo faz a pesquisa no sentido inverso: um código curto na coluna da esquerda e, ao lado, a condição que esse código nomeia e o texto que essa condição produz. Abrange todas as condições que aggrega pode comunicar, incluindo as que as secções acima não conseguem listar.
Essa cobertura mais ampla é o propósito desta tabela, e não um acaso. As secções acima estão indexadas por um nome que se pode importar, pelo que uma condição declarada apenas num pacote que não se pode importar — e que também não é reexportada em parte nenhuma que se possa importar — não tem nada para pôr na coluna da esquerda dessas secções. Esta tabela está indexada pelo código curto, e todas as condições têm um, pelo que nenhuma condição comunicável fica de fora. Um código curto que se tem em mãos resolve-se aqui, quer a condição por trás dele tenha também quer não uma função de acesso com a qual se possa fazer a correspondência.
O que vale a uma condição um lugar nesta tabela é o compilador poder de facto comunicá-la. As linhas são derivadas do código em vez de transcritas para ele: uma condição aparece aqui porque algo no compilador a levanta, pelo que cada código na coluna da esquerda é um que aggrega pode imprimir. Essa é a promessa que a tabela faz, e é o que permite ler uma linha como uma verificação que é realmente executada.
A exceção deliberada é uma condição declarada antes de existir o código que a comunica, para que o código e a redação fiquem fixados de antemão e nunca mudem sob um leitor que já os citou. Uma condição assim indica-o numa nota imediatamente abaixo da tabela. É listada em vez de escondida — um código que se tem em mãos deve resolver-se sempre — e a nota ao lado indica claramente que nenhuma compilação a levanta ainda, e o que teria de existir antes de alguma o fazer.
Um número retirado também é listado, no seu próprio conjunto de notas abaixo da tabela, e continua listado para sempre. Ocasionalmente, uma condição é suprimida — é substituída por uma que abrange mais terreno, ou nada a comunicou alguma vez — e, a partir desse momento, o seu número fica retirado: nunca é atribuído a uma condição diferente, pelo que um código curto citado de um relatório antigo só pode nomear aquilo que nomeava quando o relatório foi escrito. Essa promessa é mecânica, e não editorial. Uma condição declarada sob um número retirado é recusada antes de o compilador ler qualquer entrada, em cada execução, pelo que nenhuma versão pode conter uma — a mesma classe de recusa que encontraria um número que duas condições ativas tentassem partilhar, redigida de modo a que se possa distinguir qual dos dois casos se encontrou. A nota de um código retirado indica, onde a retirada o anotou, o que o código nomeava e, onde a condição foi substituída, que código comunica agora esse terreno.
Nunca reutilizar um número é também o que dá à sequência as suas lacunas permanentes, e as notas são o que torna essas lacunas legíveis. Um número em falta não é, por si só, prova de nada: pode estar retirado, e pode igualmente ser um que nada alcançou ainda. As notas deixam anotado que números estão retirados e, onde isso foi anotado, o que cada um deles nomeava, pelo que um código que não se resolve nem numa linha nem numa nota é um que este compilador nunca emitiu.
Um código curto é deliberadamente opaco: quatro dígitos nada dizem por si sós sobre uma condição, e esse é o preço de um identificador suficientemente curto para ser lido em voz alta, escrito numa pesquisa ou colado num relatório. A correspondência abaixo é o que o torna utilizável. Um número é atribuído uma vez, a partir de uma única sequência crescente, e fica fixo a partir daí; nada diz sobre a condição que nomeia. Assim, um código curto é um identificador e nada mais — o seu valor não é uma classificação, e nem ele nem qualquer agrupamento que se possa notar na tabela é um guia para onde uma condição se situa ou para aquilo de que trata.
A tabela não tem coluna de categoria, e isso não é uma omissão: uma categoria é uma propriedade de uma falha concreta e não da condição por trás dela. Algumas condições pertencem a uma categoria por construção. Para outras, a categoria decorre do tipo de entidade de que trata a falha, pelo que uma condição dessas comunicada uma vez em relação a um Aggregate e outra em relação a uma Release tem de cada vez uma categoria diferente — e um único valor escrito aqui ao lado da condição estaria errado para todas as condições desse segundo tipo.
Onde as categorias são explicadas é error-translation.md — cada uma, o que significa e onde fica a sua correção. Uma categoria e um código curto respondem a perguntas diferentes sobre a mesma falha: a categoria identifica a superfície a que a correção pertence, e o código curto identifica que condição interrompeu a compilação. Nenhum dos dois é dedutível do outro, e é por isso que cada um tem a sua própria lista publicada — e por isso uma falha sem nenhuma superfície de autoria a nomear continua a ter um código que se pode consultar aqui.
| Código | Condição | Mensagem |
|---|---|---|
E0001 | no-plugin-resolution-configured | cliplugin: no plugin resolver configured |
E0003 | malformed-attachment-requirement | malformed attachment requirement |
E0004 | overridden-annotation | annotation contribution overridden by an explicit value |
E0005 | policy-violation | policy violation |
E0006 | required-slot-unfilled | required attachment slot unfilled |
E0007 | selector-violation | selector violation |
E0008 | slot-selector-unsatisfied | attachment slot selector unsatisfied |
E0009 | pipeline-contract-violation | pipeline step typed-I/O contract violation |
E0010 | pipeline-step-failed | pipeline step failed |
E0011 | pipeline-target-absent | pipeline patch targets a document not present in the set |
E0012 | pipeline-target-opaque | pipeline patch targets an opaque (non-structured) unit |
E0013 | feature-type-mismatch | feature type mismatch between Aggregate and Release |
E0014 | inject-entry-ambiguous | inject entry carries both `value:` and `from:`; schema requires exactly one |
E0015 | uses-inject-forbidden | uses-edge inject dictates a delivery mechanism the socket does not permit |
E0016 | patch-test-operation-failed | jsonpatch: test operation failed |
E0017 | annotation-injection-rejected | annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys |
E0018 | policy-settings-invalid | policy attachment settings do not satisfy the plugin's declared settings schema |
E0019 | endpoint-requires-reference-form | endpoint requires form: reference |
E0020 | invalid-cron-schedule | schedule is not a valid cron expression |
E0021 | persistent-template-requires-stateful-form | persistentTemplate volume requires form: stateful |
E0022 | pipeline-patch-target-not-structured | pipeline PATCH target is not parseable structured YAML/JSON |
E0023 | reference-form-requires-endpoint | form: reference requires an endpoint |
E0024 | schedule-requires-scheduled-form | schedule requires form: scheduled |
E0025 | scheduled-form-requires-schedule | form: scheduled requires a schedule |
E0026 | artifact-content-mismatch | imported artifact content does not match the digest recorded for it in entity.lock |
E0027 | artifact-import-shape | artifacts $import: is not a bare-name artifact-library reference (<Library>#/artifacts/<entry>) |
E0028 | artifact-output-collision | artifacts output filename collision: two artifact outputs carry the same filename |
E0029 | artifact-pillar-not-declared | artifact template references a pillar the Recipe does not declare |
E0030 | artifact-library-entry-not-found | artifact-library import references a bundle not present in the ArtifactLibrary |
E0031 | artifact-library-not-found | artifact-library import references an ArtifactLibrary not present in the catalog |
E0032 | assembled-output-collision | assembled output collision: two contributors write the same output path |
E0033 | authored-assertion-failed | assertion failed |
E0034 | attachment-inject-key-collision | duplicate delivery key across attachment-inject and another inject source |
E0035 | boundary-assembly-not-provided | provider expected to assemble its dispatch group provides no boundary assembler |
E0036 | chart-name-mismatch | merged-path assembly has conflicting assembly-name annotation values |
E0037 | cross-provider-link-unsupported | cross-boundary link between endpoints rendered by different providers is not supported |
E0038 | derived-key-collision | derived name collision: one name is derived more than once in one key space |
E0039 | featurerecipe-template-invalid-field | FeatureRecipe template references a per-component-only field with executionScope: boundary |
E0040 | host-in-library-import | library $import: carries a registry host; reference the library by bare-name identity |
E0041 | instance-id-collision | multiple contributors share an instance ID at the same dispatch path |
E0042 | locals-forward-reference | locals entry references a sibling defined later in the same block |
E0043 | locals-unknown-reference | template references a key the locals block does not declare |
E0044 | mapping-entry-not-found | mapping-library import references an entry not present in the MappingLibrary |
E0045 | mapping-import-shape | valuesMapping $import: is not a bare-name mapping-library reference (<Library>#/mappings/<entry>) |
E0046 | mapping-library-not-found | mapping-library import references a MappingLibrary not present in the catalog |
E0047 | orphan-cross-boundary-link-placeholder | assembled output retains an unresolved cross-boundary link placeholder |
E0048 | path-collision | dispatch path produced multiple provider outputs |
E0049 | path-template-invalid-field | path template references a field not in the documented allowlist |
E0050 | pipeline-host-scope-unavailable | pipeline /host operation from a step with no host component |
E0051 | pipeline-patch-targets-unassembled-fragments | pipeline PATCH targets an assembler provider's pre-assembly fragments |
E0052 | pipeline-target-not-emitted | pipeline PATCH targets a document the node did not emit |
E0053 | plugin-provider-incompatible | pipeline plugin is not compatible with the rendering provider |
E0054 | provider-node-input-invalid | provider rejected node input |
E0055 | provides-contract-unfulfilled | Recipe or FeatureRecipe does not publish a provides key its abstract entity's schema.provides contract declares |
E0056 | provides-evaluation-failed | provides template evaluation failed |
E0057 | provides-self-containment | provides block references a root outside the self-contained set |
E0058 | render-nondeterministic | provider render is not deterministic |
E0059 | self-inject-key-collision | duplicate delivery key across self-inject and uses-inject |
E0060 | template-unknown-root | template references a root the render context does not define |
E0061 | unknown-provider | unknown provider |
E0062 | custom-mechanism-has-no-mapping | custom inject mechanism has no matching key in injectMapping output; add the mechanism's key to the Recipe injectMapping |
E0063 | workload-entry-not-found | workload-library import references an entry not present in the WorkloadLibrary |
E0064 | workload-import-shape | workload $import: is not a bare-name workload-library reference (<Library>#/workloads/<entry>) |
E0065 | workload-library-not-found | workload-library import references a WorkloadLibrary not present in the catalog |
E0066 | dangling-uses-target | uses edge target does not exist |
E0067 | active-toggle-not-a-boolean | active toggle did not resolve to a boolean |
E0068 | sub-aggregate-nesting-depth-exceeded | max sub-aggregate nesting depth exceeded |
E0069 | mutator-patch-rejected | mutator patch rejected |
E0070 | reexport-cycle | re-exported component alias forms a cycle |
E0071 | release-edge-retarget | release edge retargets a developer-declared edge |
E0072 | sub-aggregate-not-loadable | sub-aggregate load failed |
E0073 | sub-aggregate-name-collision | flattened node ID collision: rename one of the colliding instances so their flattened IDs differ |
E0074 | unbound-release-edge-config | release per-edge configuration has no edge to apply to |
E0075 | aggregate-not-in-canonical-form | aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem) |
E0076 | unplaced-sub-module | sub-module placed in no boundary: route it into a boundary under `aggregates`, or name its components there under `components` |
E0077 | uses-target-not-active | uses edge target was pruned because its active toggle resolved to false |
E0078 | wasm-nested-producer-consumption-denied | producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption call |
E0079 | wasm-command-set-mismatch | wasm: recorded command mirror does not match plugin describe() |
E0080 | wasm-contract-mismatch | wasm: entity contract claim does not match plugin describe() |
E0081 | wasm-diagnostic-severity-invalid | wasm: guest plugin returned a diagnostic whose severity the contract does not declare |
E0082 | wasm-guest-error | wasm: guest plugin reported an error |
E0083 | wasm-guest-panic | wasm: guest plugin panicked during call |
E0084 | wasm-host-function-set-mismatch | wasm: stamped host-function record does not match .wasm imports |
E0085 | wasm-manifest-rejected | wasm: plugin rejected by the sandbox |
E0086 | wasm-plugin-exited | wasm: plugin invoked proc_exit |
E0087 | wasm-plugin-type-mismatch | wasm: declared plugin type does not match plugin describe() |
E0088 | wasm-plugin-version-mismatch | wasm: entity metadata.version does not match plugin describe() |
E0089 | all-versions-retracted | every published version this reference could select has been withdrawn |
E0090 | ambiguous-importer-plugin | format is advertised by more than one importer plugin |
E0091 | ambiguous-parser-plugin | format is advertised by more than one parser plugin |
E0092 | ambiguous-provider-plugin | capability is served by more than one provider plugin; add a plugins.providers entry to select one |
E0093 | ambiguous-type-mapping | manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous |
E0094 | duplicate-entity-identity | duplicate entity identity within a single catalog directory |
E0095 | malformed-recipe-reference | malformed recipe reference in a Manifest mapping value |
E0096 | manifest-implements-mismatch | manifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type key |
E0097 | no-importer-for-format | no importer plugin advertises the requested format |
E0098 | no-parser-for-format | no parser plugin advertises the requested format |
E0099 | no-recipe-resolved | no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type |
E0100 | provider-binding-unsatisfied | plugins.providers entry names a plugin no provider-rendering plugin serving the capability matches |
E0101 | provider-version-unsatisfiable | no provider-rendering plugin version satisfies the recipe's provider version pin |
E0102 | plugin-reference-must-not-be-registry-qualified | wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path |
E0103 | unsatisfiable-entity-version | no catalog version satisfies the referenced version constraint |
E0104 | plugin-reference-must-be-scoped | wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location |
E0105 | recipe-reference-must-be-scoped | recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location |
E0106 | invalid-library-ref | resolve: invalid library reference URI |
E0107 | version-selection-conflict | resolve: minimal version selection conflict — incompatible library version requirements |
E0108 | catalog-cannot-load-sub-aggregate-bodies | resolve: catalog lookup cannot load resolved sub-aggregate bodies |
E0109 | catalog-cannot-load-recipe-bodies | resolve: catalog lookup cannot load resolved recipe and plugin bodies |
E0110 | source-template-at-lock-time | resolve: source-template evaluation failure at lock time |
E0111 | source-template-not-parsable | resolve: source-template parse error |
E0112 | source-template-provides-ref | resolve: source-template references .provides (invalid reverse reference) |
E0113 | sub-aggregate-depth | resolve: sub-aggregate inclusion depth exceeded |
E0114 | unresolvable-uri | resolve: no entity in the catalog matches this URI |
E0115 | ambiguous-dispatch | compactform: ambiguous dispatch — $mode required |
E0116 | constraint-type-mismatch | compactform: constraint not valid for declared type |
E0117 | escape-content-invalid | compactform: $jsonschema content invalid |
E0118 | host-in-library-ref | compactform: cross-document $ref carries a registry host; reference the library by identity |
E0119 | reference-unresolvable | compactform: $ref unresolvable |
E0120 | unknown-keyword | compactform: unknown keyword |
E0121 | unresolved-schema-library-ref | compactform: cross-document $ref target not found |
E0122 | deprecated-entity | deprecation: build consumes a deprecated entity |
E0123 | not-docs-bundle | docscache: artifact is not a documentation bundle |
E0124 | page-not-found | docscache: page not found in documentation bundle |
E0125 | offline-egress | egress: network access refused because the workspace is offline; remediation: pass `--offline=false` to allow the network for this one run, or clear the top-level `offline` key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run `aggrega pull --release <release>` from a connected environment first to populate the cache |
E0126 | acquisition-disabled | externalinputs: acquisition is disabled for unpinned inputs |
E0127 | digest-mismatch | externalinputs: fetched bytes mismatch the pinned digest |
E0128 | scheme-not-allowed | externalinputs: URL scheme is not allowed |
E0129 | store-corrupt | externalinputs: store blob mismatches its pinned record |
E0130 | lockfile-drift | lockfile: out of date; it no longer matches what its Release resolves to |
E0131 | lockfile-invalid | lockfile: file failed schema validation |
E0132 | ambiguous-content-layer | oci: manifest has multiple layers of the expected content media type |
E0133 | cached-manifest-integrity | oci: cached manifest digest mismatch |
E0135 | fetch-integrity | oci: content digest mismatch |
E0136 | fetch-network-unreachable | oci: network unreachable |
E0137 | fetch-not-found | oci: artifact not found at remote source |
E0138 | fetch-unauthorized | oci: authentication required or failed |
E0139 | immutable-tag-conflict | oci: tag already published with different content |
E0140 | no-content-layer | oci: manifest has no layer of the expected content media type |
E0141 | oci-location-collision | oci: distinct catalog identities map to the same OCI repository location |
E0142 | referrer-discovery-unavailable | oci: referrer discovery could not be completed |
E0143 | unknown-entity-kind | oci: unknown entity kind for mediatype dispatch |
E0144 | signature-bundle-digest-mismatch | cached signature bundle does not match its recorded digest |
E0145 | plugin-entity-not-found | plugin reference is not a Plugin entity |
E0146 | reference-cycle | circular reference expansion |
E0147 | malformed-trust-policy | registrytrust: advertised trust config is malformed |
E0148 | no-trust-advertised | registrytrust: registry advertises no trust config |
E0149 | attachment-slot-near-miss | attachment name is a near miss for a declared slot |
E0150 | attachment-slot-shape | attachment does not conform to its declared slot shape |
E0151 | duplicate-boundary-component | component declared in more than one boundary: declare each component in exactly one boundary |
E0152 | duplicate-triad-identity | duplicate Aggregate/Manifest identity (metadata.name) in the Release directory |
E0153 | feature-merge-conflict | feature merge conflict: reconcile the Aggregate and Release declarations for the feature |
E0154 | internal-catalog-view-disagreement | the compiler's own views of the catalog disagree |
E0155 | inject-key-collision | duplicate delivery key across inject sources |
E0156 | invalid-inject-key | invalid inject key: the from-key must name a provides key its source publishes |
E0158 | invalid-parameter-ref | invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template |
E0160 | manifest-cross-binding-pillar-collision | manifest annotation bindings collide on same Feature path+pillar |
E0161 | manifest-reserved-prefix | manifest annotation binding uses reserved prefix |
E0162 | missing-required-feature | missing required feature: attach a Feature of the required type to the component |
E0163 | missing-required-socket | required uses socket not populated |
E0164 | parameter-contract-violation | parameter contract violated |
E0165 | parameter-missing | required parameter not supplied |
E0167 | provides-key-not-declared | Recipe publishes a provides key its Component does not declare |
E0168 | schema-conformance | authored pillar does not conform to its declared schema |
E0169 | self-inject-forbidden | self-inject on component without spec.inject allowlist |
E0170 | triad-ref-unresolvable | aggregate/manifest reference unresolvable |
E0171 | unknown-uses-socket | unknown uses socket: name a socket the entity declares in its usesSchema — only a component's own uses block may name one the catalog did not declare |
E0172 | release-not-in-canonical-form | release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary) |
E0173 | unread-parameter | declared parameter is read by no reference in the Aggregate |
E0174 | uses-socket-near-miss | uses socket name is a near miss for a declared socket |
E0175 | document-not-loadable | file load failed: the file could not be read, or its bytes did not parse |
E0176 | keyless-signing-requires-network | signing: keyless signing requires a live identity provider, Fulcio, and Rekor |
E0177 | no-signature-found | signing: no signature found for an artifact that requires one |
E0178 | no-trusted-identities | signing: keyless verification requires at least one trusted identity |
E0179 | signature-invalid | signing: signature does not verify |
E0180 | signature-verification-failed | signing: signature bundle does not verify |
E0181 | signing-policy-requires-signature | signing: signing policy requires a signature for this artifact kind; refusing to push unsigned content |
E0182 | trust-root-not-loadable | signing: cannot load pinned trust root |
E0183 | unsigned-push-refused | signing: registry requires signatures; refusing to push unsigned content |
E0184 | unsupported-key | signing: unsupported held-key type |
E0185 | untrusted-identity | signing: signature identity is not trusted for this registry |
E0186 | unknown-source-kind | no source adapter serves the source kind |
E0187 | empty-workspace-root | cacheslot: empty workspaceRoot |
E0188 | artifact-entry-shape | artifacts entry: shape must be a string scalar or {$import: <local-path>} |
E0189 | artifact-library-entry-shape | artifactlibrary: entry must be a mapping of filename to a string body |
E0190 | forbidden-keyword | schemalibrary: forbidden JSON Schema keyword |
E0191 | mapping-entry-not-scalar | mappinglibrary: entry body must be a string scalar |
E0192 | document-nesting-depth-exceeded | a document nests too many levels deep |
E0193 | parameters-shape | parameters: shape must be an inline object or {$import: <local-path>} |
E0194 | template-not-found | schemalibrary: template not found |
E0195 | template-param-missing | schemalibrary: template parameter missing |
E0196 | template-param-type-mismatch | schemalibrary: template parameter type mismatch |
E0197 | values-mapping-shape | valuesmapping: shape must be a string scalar or {$import: <path-or-library-identity>} |
E0198 | well-known-annotation-scope | wellKnownAnnotations: a key is declared at a scope the provider's contract does not render |
E0199 | workload-entry-not-scalar | workloadlibrary: entry body must be a string scalar |
E0200 | workload-template-shape | workload: shape must be a string scalar or {$import: <path-or-library-identity>} |
E0201 | assertion-name-collision | assertion name declared twice across the extends chain |
E0202 | cyclic-extension | cyclic extends chain |
E0204 | feature-recipe-values-mapping-requires-source | FeatureRecipe: valuesMapping requires source |
E0205 | extends-merge-failed | inheritance merge failed |
E0207 | recipe-output-component-label-collision | recipe output-component-labels constraint: key is also declared in outputLabels |
E0208 | recipe-output-label-reserved-namespace | recipe output-labels constraint: key uses a reserved namespace |
E0209 | recipe-values-mapping-requires-source | Recipe: valuesMapping requires source |
E0210 | recipe-no-input-kind | Recipe: at least one input kind required |
E0211 | recipe-filename-collision-across-input-kinds | filename collision across input kinds: two input-kind blocks produced a file under one output name |
E0212 | slot-not-referenceable | workload attachment slot is not referenceable |
E0213 | workload-features-schema | workload featuresSchema cross-check failed |
E0214 | workload-not-valid | workload validation failed |
E0215 | entity-envelope-invalid | document envelope validation failed |
E0216 | schema-extension-evaluation-failed | validator/jsonschema: x-aggrega extension evaluation failed |
E0218 | schema-not-resolvable | validator/jsonschema: schema resolution failed |
E0220 | extends-chain-too-deep | extends chain exceeds maximum depth |
E0221 | schema-merge-input-invalid | merger: invalid merge input |
E0222 | ambiguous-registry-alias | registry alias matches more than one host |
E0223 | capability-on-cross-cutting-socket | a cross-cutting socket is bound by capability but attaches by uri |
E0224 | workspace-config-invalid | workspace configuration is invalid |
E0225 | duplicate-provider-target | capability is bound to more than one provider plugin |
E0226 | duplicate-registry-alias | registry alias is already used by another host |
E0227 | governance-role-invalid | a governance attachment declares no role or an unknown role |
E0228 | inert-field-on-provider-socket | a provider socket binding sets a field with no referent on that socket |
E0229 | position-out-of-range | position out of range |
E0246 | verdict-plugin-trust-mismatch | the digest recorded as trusted for this plugin does not match the digest its cached manifest reports |
E0247 | verdict-attachment-not-configured | a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role |
E0248 | wasm-output-shape | wasm: guest plugin returned an output that is not the shape the socket reads |
E0250 | nest-segment-not-one-directory | provider named a directory for each contributor's own sub-directory that is not a single directory name |
E0251 | recipe-source-is-empty | recipe source is an empty string, which names neither sourceless mode nor sourced mode |
E0252 | artifact-library-file-escapes-key | artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under |
E0253 | annotation-binding-target-unresolved | annotation binding does not resolve against its target Feature |
E0254 | annotation-subkey-not-conforming | annotation subkey does not conform to the target Feature's schema at the routed pillar |
E0255 | annotation-side-pillar-mismatch | annotation routes through a pillar its authoring side may not use |
E0256 | annotation-binding-pillar-overlap | annotation binding declares one path in both pillar lists |
E0257 | schema-contract-compile-failure | declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation |
E0259 | boundary-scope-attachment-not-declared-at-a-boundary | attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it |
E0260 | unplaced-component | component placed in no boundary: name it under a boundary's `components`, or place the sub-module that contributes it under `aggregates` |
E0261 | unresolved-boundary-component | boundary names a component the composition does not hold: correct the name, or remove the entry |
E0262 | unusable-component-identity | component identity cannot be the name its emitted resources are stamped with: rename the component |
E0263 | component-identity-target-refuses | the target will not accept a name derived from this component's authored identity: rename the component |
E0264 | provider-refused-every-component-identity | provider guest never accepted a component identity the compiler composed for it |
E0265 | unsupported-input-kind | provider does not support the node's input kind |
E0266 | unusable-schema-import | a schema `$import:` could not be applied |
E0267 | unknown-schema-pillar | a schema block declares a key that names no data pillar |
E0268 | pipeline-patch-unit-not-carved | reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokens |
E0269 | provider-render-duplicate-path | provider guest returned two output files under one path; a conforming guest returns each output path at most once |
E0270 | link-patch-file-not-emitted | link patch names an output file the dispatch group did not emit; a conforming link patch names a file the group's own render returned |
E0271 | pipeline-emit-file-absent | emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and content |
E0272 | pipeline-side-effect-kind-undefined | side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crd |
E0273 | rendered-name-unavailable | template reads the name the target gives the resources it renders for the node, and this node's provider reports no such name; a conforming template reads a value the node's own provider supplies |
E0274 | verdict-plugin-identity-changed | the plugin identity recorded as trusted no longer matches what this resolution reports |
E0275 | edit-refused-invalid-result | the edit was refused because the resulting document would not be valid, and nothing was written |
E0276 | schema-evolution | the version being published changes the published predecessor in a way the documented evolution rubric objects to |
E0277 | annotation-prefix | an annotation key on the entity uses a prefix the platform reserves |
E0278 | name-shape | the entity's name does not follow the documented name shape for its kind |
E0279 | dynamic-refs | a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot follow |
E0280 | id-overrides | a schema in the entity declares an identifier of its own, where the platform owns that schema's identity |
E0281 | category-matches-directory | the entity's category label does not match the category directory the entity is filed under |
E0282 | x-aggrega-discouragement | the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchema |
E0283 | plugin-default-limits | the Plugin entity declares no runtime resource cap of its own, so the platform defaults apply |
E0284 | secret-slot-declares-sensitive | an attachment slot admits only secret material and does not declare that it handles it |
E0285 | provides-declared-by-component | the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refused |
E0286 | publish-bump-below-classification | the version bump being published is smaller than the evolution check's classification of the change requires |
E0287 | import-halting-diagnostic | the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring files |
E0288 | plugin-cannot-express-input | a plugin has no expression for a construct this build declares |
E0289 | plugin-required-input-unresolved | a plugin could not resolve something it requires to exactly one value |
E0290 | plugin-output-name-collision | two things a plugin produced occupy one name in its output |
E0291 | plugin-value-not-representable | a plugin has no representation for a value it was given |
E0292 | plugin-failure-unclassified | a plugin reported a failure that none of the declared kinds names |
E0293 | wasm-guest-condition-undeclared | wasm: guest plugin named a condition the socket does not declare |
E0294 | subsystem-component-identity-collision | components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component's identity |
E0295 | library-reference-whitespace | library reference: a reference to a library entry carries no whitespace or line break |
E0296 | release-chain-composes-both-routing-keys | release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both |
E0297 | inherited-boundary-directory-is-literal | inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to |
E0298 | bundle-no-entity-document | oci: published bundle carries no entity document |
E0299 | bundle-ambiguous-entity-document | oci: published bundle carries more than one entity document |
E0300 | bundle-unreadable | oci: published bundle cannot be unpacked |
E0301 | published-artifact-not-an-entity | oci: published artifact is not an entity document |
E0302 | entity-not-pinned | an input the entity reads has no pin recorded for it in the entity.lock beside it |
E0303 | entity-shares-its-directory | the entity shares its directory with another entity, and an entity of its kind has a directory of its own |
E0304 | content-outside-entity-directory | a path names content outside the entity's own directory |
E0305 | local-source-content-mismatch | the files of the entity's local source do not match the pins recorded for them in entity.lock |
E0306 | plugin-artifact-not-found | plugin artifact not found on this machine |
E0307 | cache-location-outside-cache | a value a cache location is built from would place cached files outside the place it names in the cache |
E0308 | conflicting-features-reach-one-component | a Feature reaches a component alongside a Feature it declares a conflict with |
E0309 | symbolic-link-in-entity-files | a symbolic link sits among the files an entity carries |
E0310 | offline-registration-without-trust-policy | a registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with `aggrega registry add <host> --identity <identity>=<issuer>` or `--key <public-key-file>` |
E0311 | malformed-version-pin | reference carries a malformed version pin |
E0312 | colon-in-provider-binding-capability | a provider socket binding names a capability containing a colon, which no Recipe can select |
E0313 | provider-binding-capability-unserved | plugins.providers entry names a capability no provider-rendering plugin the build reads serves |
E0314 | plugin-built-from-uncommitted-changes | plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reports |
E0315 | connection-attachment-slot-undeclared | a connection carries an attachment under a name its socket declares no slot for |
E0316 | connection-attachment-written-off-its-connection | a Release attachment takes the name of an attachment one of a component's connections carries |
E0317 | release-connection-attachment-untyped | a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makes |
E0318 | attachment-inject-mapping-key-collision | duplicate delivery key across two attachments: an attachment's FeatureRecipe writes a delivery key another attachment already delivered |
E0319 | duplicate-connection-alias | connection alias is already used by another connection of the same component |
E0320 | write-leads-out-of-workspace | a path this operation writes or deletes leads through a link out of the directory it must stay inside |
E0321 | read-leads-out-of-workspace | a file this operation reads leads through a link out of the directory it must stay inside |
E0323 | caller-render-facts-not-declared | template reads its callers' render facts, but the FeatureRecipe does not set readsCallerRenderFacts |
E0324 | reference-leads-out-of-workspace | a reference a document makes to another file leads out of the directory it must stay inside |
E0325 | provider-render-fact-not-list | provider guest reported a render fact whose value is not a list; a conforming guest reports every render fact's value as a JSON array, even with one entry |
E0326 | pipeline-step-reads-caller-render-facts | pipeline step reads its callers' render facts, but a pipeline step does not read the components connecting to its host; it reads only the host's own render facts |
E0327 | index-of-absent-map-key | template indexes a map with a key the map does not hold |
E0328 | misnamed-slot-fill | attachment written under a name no slot declares fits a slot its component leaves empty |
E0329 | connection-credential-matches-target-key | a connection and the target it reaches do not name one key: they write different locators for it, or only one of them names one |
E0330 | mixed-signing-credentials | signing: the references named together need different signing credentials, so nothing was signed |
E0331 | signature-not-recorded | signing: no verified signature is recorded for an artifact that requires one |
E0332 | signature-for-another-artifact | signing: the recorded signature was made for a different artifact |
E0333 | recorded-signature-out-of-date | signing: a recorded signature is not the one a pull would record |
E0334 | omit-matched-nothing | an omits entry left out nothing the source rendered |
E0335 | unsupported-omits | provider does not support omits |
E0336 | omit-report-mismatch | a provider's omitted counts do not match the omits entries it was handed |
E0337 | importer-version-unsatisfiable | no importer plugin version satisfies the plugins.importer entry's version pin |
E0338 | duplicate-importer-attachment | importer is attached by more than one plugins.importer entry |
E0339 | ambiguous-import-format | more than one importer recognises the source |
E0340 | name-windows-cannot-hold | a name this operation writes holds a path segment Windows cannot hold as written |
E0341 | importer-declares-no-file-patterns | the importer serving the source's format declares no file patterns, so it reads one file and cannot read a directory |
E0342 | import-directory-matched-nothing | no file in the directory matches the file patterns the importer serving the source's format declares |
E0343 | import-source-name-collision | a file read from the directory and a file named in the importer's `with.sources` have the same name |
E0344 | windows-unusable-entry | an entry this publication carries cannot be used on Windows |
E0345 | duplicate-container-environment-variable | a container declares one environment variable twice |
E0346 | metrics-credential-annotation-matches-provides | a Component's annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance's metrics need a credential |
E0347 | target-render-facts-not-declared | template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFacts |
E0348 | pipeline-step-reads-target-render-facts | pipeline step reads the render facts of a component its host is wired to, but a pipeline step reads only the host's own render facts |
E0349 | import-target-unbound | no Recipe in the workspace's catalog binds to the capability the import's target names |
E0350 | unrecognised-import-format | no importer recognises the source |
E0351 | unsupported-boundary-artifacts | provider does not support boundary artifacts |
E0352 | boundary-directory-not-beneath-output-root | boundary output directory does not name a directory beneath the output root |
E0353 | boundary-feature-name-not-a-directory | boundary-level Feature instance name is not a directory name |
E0354 | cross-boundary-link-value-not-copied | a template does more than copy a value it reads off a cross-boundary link |
E0355 | inject-delivery-shape | inject delivery: shape must be a list of entries, each `in:` with exactly one of `from:` or `value:` |
E0356 | suspend-requires-scheduled-form | suspend requires form: scheduled |
E0357 | name-mapping-matched-nothing | a Manifest name mapping's key names no component instance or attachment in this build, so the entry binds nothing |
E0358 | uses-target-not-exported | uses edge target names a component its module does not export |
E0359 | source-adapter-not-registered | no source adapter is registered in this program for the source kind |
E0360 | netrc-file-unreadable | the netrc file could not be read |
E0361 | source-url-carries-credential | the source URL carries a credential |
E0362 | uses-inject-value | inject entry on a connection carries `value:`; a connection delivers the target's published keys, each named with `from:` |
E0363 | annotation-subkey-not-bound | annotation subkey is not routed by the annotation's binding |
E0364 | value-template-execution-failed | a value template failed while it ran |
E0365 | boundary-contribution-not-assembled | boundary-level Feature's output is routed to a dispatch path nothing assembles |
E0366 | inject-mapping-output-not-parsable | FeatureRecipe injectMapping output could not be read as a dictionary of deliveries |
E0367 | annotation-scalar-not-routable | a scalar annotation value does not route to exactly one path of its binding |
E0368 | inject-mapping-output-key-not-delivered | FeatureRecipe injectMapping output writes a key no delivery mechanism of the host reads |
E0369 | absent-path-read-and-iterated | template reads a path as a value and iterates it, and the data holds nothing at that path |
E0370 | duplicate-pipeline-step-id | a pipeline declares one step id twice |
E0371 | unknown-catalog-document-kind | catalog document declares a kind a catalog does not hold |
E0372 | attachment-inject-value | inject entry on an attachment carries `value:`; an attachment delivers the keys its FeatureRecipe publishes, each named with `from:`, and a literal belongs in the component's own inject block |
E0373 | retired-api-version | a document declares an API version this compiler no longer reads |
E0374 | retired-abi-version | a plugin declares a plugin ABI version this compiler no longer speaks |
E0375 | retired-media-type | oci: artifact carries a media type this compiler no longer reads |
E0376 | no-answer-in-time | egress: the server did not answer in time |
E0377 | repository-listing-too-long | registry: the repository listing did not end in time |
E0378 | registry-too-busy | oci: the registry kept asking to slow down |
E0002está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. Nomeava uma pesquisa no catálogo que falha enquanto os contratos estáticos do grafo são verificados — um defeito no compilador e não num documento escrito — e quem comunica agora esse estado é a condição levantada quando uma compilação resolve um tipo de componente para o qual o catálogo que lê não tem nesse momento nenhuma entrada, e o seu código éE0154.E0134está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. Nomeava uma entidade publicável cujo diretório não tinha o nome da versão que a entidade declara; uma publicação não julga o nome de um diretório, e a condição levantada quando uma entidade partilha o seu diretório com outra entidade quando o seu tipo tem um diretório próprio éE0303.E0157está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. Nomeava uma chave de Aggregate — um nome de instância de componente, funcionalidade, subsistema ou módulo aninhado — que não correspondia ao padrão de nomes escritos pelo autor. Cada uma dessas superfícies de chave está restringida a essa mesma grafia pelo esquema do Aggregate, que recusa o documento ao validar o seu envelope e comunica a chave infratora com linha e coluna; o código dessa condição éE0215.E0159está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. Nomeava uma referência de destino cujos segmentos separados por pontos não correspondiam todos ao padrão de nomes de instância, e nenhuma compilação o comunicou antes de a condição ser suprimida.E0166está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. Nomeava o ficheiro para o qual aponta oparameters: { $import: … }de uma Release quando esse ficheiro não podia ser lido ou os seus bytes não podiam ser analisados; um ficheiro que não produz nenhum documento é uma única condição onde quer que o caminho tenha sido escrito, e o seu código éE0175.E0203está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. Nomeava uma FeatureRecipe na capacidadeevalque declarava uma fonte, uma sobreposição de values, uma carga de trabalho ou artefactos; essa capacidade foi suprimida, e já nada comunica este estado.E0206está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. Nomeava uma Recipe na capacidadeevalque declarava uma fonte, uma carga de trabalho, artefactos ou uma sobreposição de values; essa capacidade foi suprimida, e uma Recipe que não declare nenhum desses elementos é recusada em qualquer capacidade sobE0210.E0217está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. Nomeava uma falha de validação de esquema que não podia ser comunicada em relação a um campo concreto, e nenhuma compilação o comunicou antes de a condição ser suprimida.E0219está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. Nomeava uma cadeiaextendscíclica, comunicada por um percurso da cadeia separado da etapa de combinação da fusão de esquemas; um único percurso da cadeia comunica todas as cadeias cíclicas, e o código correspondente éE0202.E0230está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. A condição que este número nomeava foi suprimida, e nenhuma compilação a comunica.E0231está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. A condição que este número nomeava foi suprimida, e nenhuma compilação a comunica.E0232está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. A condição que este número nomeava foi suprimida, e nenhuma compilação a comunica.E0233está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. A condição que este número nomeava foi suprimida, e nenhuma compilação a comunica.E0234está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. Nomeava uma fonte de Recipe que é uma string vazia, comunicada ao renderizar através do fornecedor compose; agora uma única condição que abrange todos os fornecedores comunica isso, e o seu código éE0251.E0235está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. A condição que este número nomeava foi suprimida, e nenhuma compilação a comunica.E0236está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. A condição que este número nomeava foi suprimida, e nenhuma compilação a comunica.E0237está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. A condição que este número nomeava foi suprimida, e nenhuma compilação a comunica.E0238está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. A condição que este número nomeava foi suprimida, e nenhuma compilação a comunica.E0239está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. A condição que este número nomeava foi suprimida, e nenhuma compilação a comunica.E0240está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. A condição que este número nomeava foi suprimida, e nenhuma compilação a comunica.E0241está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. A condição que este número nomeava foi suprimida, e nenhuma compilação a comunica.E0242está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. Nomeava uma fonte de Recipe que é uma string vazia, comunicada ao renderizar através do fornecedor Helm; agora uma única condição que abrange todos os fornecedores comunica isso, e o seu código éE0251.E0243está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. A condição que este número nomeava foi suprimida, e nenhuma compilação a comunica.E0244está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. A condição que este número nomeava foi suprimida, e nenhuma compilação a comunica.E0245está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. A condição que este número nomeava foi suprimida, e nenhuma compilação a comunica.E0249está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. A condição que este número nomeava foi suprimida, e nenhuma compilação a comunica.E0258está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. A condição que este número nomeava foi suprimida, e nenhuma compilação a comunica.E0322está retirado: já nada o comunica, e o número nunca é atribuído a uma condição diferente. Nomeava um valor que uma Feature anexada a uma fronteira calculava para o ambiente de um componente sob uma chave que outro anexo já tinha entregado. Uma Feature anexada a uma fronteira só entrega num componente através do injectMapping da sua FeatureRecipe, e um mapeamento que escreve uma chave entregue por outro anexo é comunicado sobE0318.
Orientações sobre a correspondência
O predicado errors.Is percorre a cadeia de encapsulamento, pelo que uma correspondência com uma sentinela funciona mesmo quando o erro é encapsulado várias vezes no caminho de regresso. Faz-se a correspondência com o erro que uma função exportada devolveu:
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}Não existe nenhum ponto de entrada exportado que execute uma compilação inteira, pelo que a correspondência com errors.Is se aplica ao código que chama estes pacotes diretamente. Para condicionar a CI a uma compilação, executa-se aggrega build e lê-se o seu estado de saída e os seus diagnósticos: o texto das mensagens está catalogado em fatal-halts.md, a categoria em error-translation.md, e o código curto no cabeçalho entre parênteses retos resolve-se na tabela de todas as condições nesta página.
Os dois caminhos de controlo existem porque os três identificadores chegam a distâncias diferentes. Um controlo escrito em Go liga estes pacotes, faz a correspondência com sentinelas e consegue ler qualquer um dos dois códigos de qualquer erro que tenha em mãos. Um controlo escrito em torno do comando tem o estado de saída e o texto impresso — e o texto impresso nomeia a condição, porque o código curto está no cabeçalho entre parênteses retos. Assim, um controlo desses baseia-se nesse código curto e não na redação da mensagem, e as vistas indexadas por mensagem continuam a ser a forma de recuar a partir de uma redação que já tem. Faz-se a correspondência com a sentinela a partir de Go; usa-se o código curto em torno do comando; lê-se o código descritivo do diagnóstico estruturado onde um cliente fala esse protocolo.
Sentinelas declaradas em pacotes diferentes com o mesmo nome curto são condições distintas, e não duas grafias de uma só: errors.Is distingue-as por identidade, pelo que uma correspondência com uma não corresponde à outra. As reexportações assinaladas nas tabelas são a exceção, e são assinaladas precisamente porque são o caso em que dois nomes correspondem de facto. Faz-se a correspondência com o nome no pacote sob o qual as tabelas o listam, e um nome curto por si só deve ser tratado como ambíguo.
Para o catálogo de diagnósticos destinados ao utilizador (as mensagens que os programadores veem no terminal quando uma compilação é interrompida), consulte-se fatal-halts.md. Para o catálogo de avisos (a saída não bloqueante warning:, lint: e notice:), consulte-se warnings.md. Para a taxonomia de prefixos de categoria ([DEVELOPER_ERROR] / [OPS_ERROR] / [CATALOG_ERROR] / [TRANSLATION_ERROR] / [FETCH_ERROR] / [POLICY_ERROR] / [TRUST_ERROR]), consulte-se error-translation.md.