Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Brasil)
Esta página foi traduzida automaticamente. Leia o original em inglês.

Sentinelas de erro — referência canônica

Toda interrupção fatal que o compilador emite nomeia uma condição, e cada condição carrega 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 chamando 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á registrada: ele nomeia a própria condição em palavras, e é o que permanece fixo enquanto os pacotes Go ao redor dela evoluem — o identificador que um programa anota. O código curto é a letra E seguida de quatro dígitos, curto o bastante para ser lido em voz alta, digitado em uma busca ou colado em um relatório: o identificador que uma pessoa cita. Uma condição, três identificadores — faça a correspondência com a sentinela para reconhecer a condição a partir do Go, leia o código quando precisar anotá-la ou usá-la como chave, e resolva um código curto na tabela de todas as condições mais adiante nesta página.

O diagnóstico voltado ao usuário (a mensagem com prefixo catalogada em fatal-halts.md e error-translation.md) carrega o texto voltado ao desenvolvedor; a sentinela encapsulada é aquilo com que errors.Is faz a correspondência em consumidores programáticos.

Esta página é a visão do catálogo indexada por sentinela. Programadores que escrevem gates de CI, integrações de IDE ou código de orquestração de builds que precisa distinguir tipos de erro fazem a correspondência com as sentinelas listadas aqui usando o predicado padrão errors.Is. Autores que depuram um build lendo o texto de erro emitido geralmente querem as visões indexadas por mensagem — fatal-halts.md para erros que interrompem o build, 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 retorna 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 em vez de 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 carregam a sua estabilidade separadamente, 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; renomeações ou remoções são anunciadas na entrada do changelog da versão que as faz, e adicionar 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, então ele é o identificador a anotar sempre que uma condição precisar ser nomeada de forma duradoura: renomear uma função de acesso não muda o código sob o qual a sua condição foi registrada, e um código que você anotou 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 aposentada permanece aposentado em vez de ser atribuído a uma condição diferente, de modo que um código curto anotado em um relatório antigo ainda nomeia a condição que nomeava quando foi anotado. Isso é imposto, e não apenas pretendido — uma condição declarada sob um número aposentado é recusada antes que o compilador leia qualquer entrada, em toda execução — e cada número aposentado é publicado ao lado dos ativos na tabela de todas as condições. A coluna de código abaixo carrega o código, e ele é o valor que um cliente do diagnóstico estruturado lê sem vincular estes pacotes. Ele é publicado em vez de inferido, porque não precisa repetir a linha em que está — um nome reexportado informa o código da condição para a qual encaminha, e o código de uma regra nomeia a regra em vez da função de acesso. A coluna de mensagem é o texto literal que a sentinela produz; o diagnóstico voltado ao usuário coloca antes desse texto um cabeçalho entre colchetes e a localização na fonte. Esse cabeçalho carrega 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 são resolvidos na tabela de todas as condições nesta página. Quando um plugin levantou 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 o qualificador está ali e por que o segmento final é o que deve ser resolvido.

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. Ele não carrega 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 ao seu redor, e uma condição levantada em mais de um ponto de uma compilação continua tendo 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 registradas sob um mesmo código. Leia-o de um erro com CodeOf, de github.com/aggrega-ai/aggrega-cli/pkg/errors, que percorre a cadeia de encapsulamento do mesmo modo que errors.Is, de modo que o código sobrevive a quantos níveis tenham encapsulado o erro no caminho de volta até você. Esse pacote também se chama errors, então 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 também informa se algum erro da cadeia carregava um código; uma cadeia que não carrega nenhum é um fato sobre essa cadeia, e não uma falha. Se você preferir fazer a correspondência com a interface por conta própria, o mesmo pacote a exporta como CodedError, e errors.As a encontra no mesmo percurso.

Um código segue em um único sentido. Ele é o que uma condição informa, nunca o que a identifica para uma correspondência: escrever a string no seu próprio código dá a você uma string, e não há caminho de volta de uma string para o valor com o qual errors.Is faz a correspondência. Faça a correspondência com a sentinela para reconhecer uma condição; leia o código para anotar uma.

O código que aggrega imprime em um terminal é o curto, não este. Um diagnóstico de interrupção começa com um cabeçalho entre colchetes que carrega 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 um plugin levantou 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 a qual encaminhar você — 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 em palavras e é largo demais para essa posição: nas condições mais longas, ele encheria um terminal estreito antes de a mensagem começar, e é justamente por isso que existe um segundo identificador, compacto. Então o token a partir do qual trabalhar quando você só tem a saída impressa é o código curto, e ele é resolvido na tabela de todas as condições mais adiante nesta página: a partir de um número que você pode ler ao telefone, você chega à 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 junto com a entrada que documenta a correção de autoria, e é descrito em aggrega explain. As visões indexadas por mensagem em fatal-halts.md continuam sendo o caminho para partir da redação em vez de um identificador.

Onde um código de fato sai do 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 embutido no texto da mensagem — de modo que uma extensão do editor, ou qualquer outro cliente desse protocolo, se ramifica pelo que uma entrada informa sem vincular estes pacotes e sem analisar texto. Essa única chave carrega um código que uma máquina pode comparar, seja quem for que o atribuiu, e a entrada diz qual camada o levantou. Ali um código tem três origens, e a terceira é a razão pela qual um código que você 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 o descreve. Ele é atribuído onde quer que o aviso tenha sido levantado, em vez de registrado como condição, então não tem nenhuma linha aqui.
  • O código registrado de um aviso sobre os documentos que você escreveu — um nome a uma edição de distância de um declarado, um parâmetro que nada lê. Uma constatação dessas nomeia uma condição na mesma forma que uma falha, então o seu código é registrado e tem uma linha nesta página, e ler essa linha diz a você do que trata a constatação.

Então o mesmo código que você leria em uma interrupção também pode chegar a você de um build que terminou, carregado por uma constatação que não mudou nada no resultado. O que separa os dois é o resultado que você recebeu e a camada que a entrada nomeia — nunca a forma do próprio código, e nunca se ele é resolvido 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 carrega os dois identificadores de uma condição, e saber qual é qual faz a diferença entre um identificador sobre o qual você pode agir e outro sobre o qual não pode. A chave code acima é para um programa: com hífens e nomeando a condição em palavras, para que uma extensão que se ramifica por ela se leia pelo que significa, e é o valor que CodeOf informa em Go. A chave shortCode ao lado é para 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 colchetes. É o que você lê ao telefone, digita em uma caixa de busca ou cola em uma issue, e é o token pelo qual a tabela de todas as condições é indexada.

Nenhum é a forma abreviada do outro, e nenhum é um substituto do outro. Faça a correspondência pelo código descritivo; mostre o curto a um leitor. Uma superfície que oferecesse apenas o código descritivo entregaria a um autor um identificador feito para uma correspondência, e uma que fizesse a correspondência pelo código curto a faria com um número que não diz nada 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 é indexada. Uma entrada carrega 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 registrada — 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 seu 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 você tem em mãos para a condição que ele nomeia — as tabelas abaixo são a lista publicada. Cada linha carrega 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 é resolvido em um nome com o qual você pode fazer a correspondência e no texto que a condição produz. As tabelas cobrem as condições cuja função de acesso você pode importar, e dois tipos de código ficam fora delas: 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 em um pacote que você não pode importar e não é reexportada em lugar nenhum, onde não há nenhum nome comparável para colocar ao lado. Esse segundo tipo ainda nomeia uma condição, e essa condição ainda tem um código curto — a tabela de todas as condições, mais adiante nesta página, é indexada pelo código curto em vez de por um nome importável e por isso cobre esses também.

A superfície comparável, por pacote declarante

Cada seção abaixo é um pacote que você pode importar. O seu título é o caminho do pacote relativo ao caminho do módulo github.com/aggrega-ai/aggrega-cli, de modo que a seção intitulada pkg/resolver é importada como github.com/aggrega-ai/aggrega-cli/pkg/resolver.

As entradas são agrupadas pelo pacote que declara a sentinela, porque esse é o pacote que quem faz a correspondência importa. Em que ponto de um build a condição é levantada é uma questão à parte, e uma que esta página deliberadamente não responde: uma mesma sentinela é frequentemente levantada a partir de vários lugares, e várias são levantadas apenas a partir de código que o módulo não exporta, então nenhuma resposta por entrada seria verdadeira para todas as linhas. As visões indexadas por mensagem respondem à pergunta de quando em um build em termos que você pode observar — fatal-halts.md acima de tudo.

Alguns nomes aparecem em mais de um pacote. São reexportações de um único valor compartilhado, e não duas condições, então a correspondência com qualquer um dos dois nomes funciona; as tabelas dizem isso onde ambos os nomes são importáveis. As duas linhas carregam o mesmo código, que é o mesmo fato expresso no identificador que um cliente fora do Go tem: uma condição, um código, quantos nomes forem que cheguem a ela.

pkg/catalog

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

pkg/closure

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

pkg/compactform

SentinelaCódigoMensagem
ErrAmbiguousDispatch()ambiguous-dispatchcompactform: ambiguous dispatch — $mode required
ErrCircularRef()reference-cyclecircular reference expansion
ErrConstraintTypeMismatch()constraint-type-mismatchcompactform: constraint not valid for declared type
ErrEscapeContentInvalid()escape-content-invalidcompactform: $jsonschema content invalid
ErrHostInLibraryRef()host-in-library-refcompactform: cross-document $ref carries a registry host; reference the library by identity
ErrReferenceUnresolvable()reference-unresolvablecompactform: $ref unresolvable
ErrUnknownKeyword()unknown-keywordcompactform: unknown keyword
ErrUnresolvedSchemaLibraryRef()unresolved-schema-library-refcompactform: cross-document $ref target not found
  • ErrCircularRef() é o mesmo valor que pkg/refcycle.ErrCycle(), então a correspondência com qualquer um dos dois nomes funciona.

pkg/deprecation

SentinelaCódigoMensagem
ErrDeprecatedEntity()deprecated-entitydeprecation: build consumes a deprecated entity

pkg/docscache

SentinelaCódigoMensagem
ErrFetchNotFound()fetch-not-foundoci: artifact not found at remote source
ErrNotDocsBundle()not-docs-bundledocscache: artifact is not a documentation bundle
ErrPageNotFound()page-not-founddocscache: page not found in documentation bundle
  • ErrFetchNotFound() é o mesmo valor que pkg/oci.ErrFetchNotFound(), então a correspondência com qualquer um dos dois nomes funciona.

pkg/egress

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

pkg/externalinputs

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

pkg/lockfile

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

pkg/oci

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

pkg/pathscope

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

pkg/pluginpath

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

pkg/pluginstrust

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

pkg/plugintest

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

pkg/readscope

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

pkg/recipepin

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

pkg/refcycle

SentinelaCódigoMensagem
ErrCycle()reference-cyclecircular reference expansion

pkg/registrytrust

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

pkg/resolver

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

pkg/signing

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

pkg/sourcecache

SentinelaCódigoMensagem
ErrFetchIntegrity()fetch-integrityoci: content digest mismatch
ErrFetchNotFound()fetch-not-foundoci: artifact not found at remote source
  • ErrFetchIntegrity() é o mesmo valor que pkg/oci.ErrFetchIntegrity(), então a correspondência com qualquer um dos dois nomes funciona.
  • ErrFetchNotFound() é o mesmo valor que pkg/oci.ErrFetchNotFound(), então a correspondência com qualquer um dos dois nomes funciona.

pkg/sourcekind

SentinelaCódigoMensagem
ErrUnknownKind()unknown-source-kindno source adapter serves the source kind

pkg/sourceresolver

SentinelaCódigoMensagem
ErrFetchIntegrity()fetch-integrityoci: content digest mismatch
ErrFetchNetworkUnreachable()fetch-network-unreachableoci: network unreachable
ErrFetchNotFound()fetch-not-foundoci: artifact not found at remote source
ErrFetchUnauthorized()fetch-unauthorizedoci: authentication required or failed
ErrNoAdapterRegistered()source-adapter-not-registeredno source adapter is registered in this program for the source kind
  • ErrFetchIntegrity() é o mesmo valor que pkg/oci.ErrFetchIntegrity(), então a correspondência com qualquer um dos dois nomes funciona.
  • ErrFetchNetworkUnreachable() é o mesmo valor que pkg/oci.ErrFetchNetworkUnreachable(), então a correspondência com qualquer um dos dois nomes funciona.
  • ErrFetchNotFound() é o mesmo valor que pkg/oci.ErrFetchNotFound(), então a correspondência com qualquer um dos dois nomes funciona.
  • ErrFetchUnauthorized() é o mesmo valor que pkg/oci.ErrFetchUnauthorized(), então a correspondência com qualquer um dos dois nomes funciona.

pkg/sourceresolver/cacheslot

SentinelaCódigoMensagem
ErrEmptyWorkspaceRoot()empty-workspace-rootcacheslot: empty workspaceRoot

pkg/sourceresolver/netrc

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

pkg/types

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

pkg/usesedge

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

pkg/validator

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

pkg/validator/envelope

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

pkg/validator/jsonschema

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

pkg/validator/merger

SentinelaCódigoMensagem
ErrMergeInvalid()schema-merge-input-invalidmerger: invalid merge input

pkg/workspaceconfig

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

pkg/writescope

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

pkg/yamlpos

SentinelaCódigoMensagem
ErrPositionOutOfRange()position-out-of-rangeposition out of range

Sentinelas que carregam outra sentinela

ErrCacheMetadataInvalid (pkg/sourceresolver/metadata) reporta um slot corrompido do cache de artefatos de origem. Ela é declarada como um wrapper em torno de ErrFetchIntegrity() em vez de como uma identidade própria, então não aparece nas tabelas acima e a correspondência com ErrFetchIntegrity() também funciona para ela. Como ela encapsula uma sentinela em vez de declarar uma, é exportada como um valor em vez de como uma função: faça a correspondência com ela como ErrCacheMetadataInvalid, sem parênteses. Faça a correspondência com o wrapper quando quiser essa condição específica, e com a sentinela encapsulada quando quiser toda a classe de integridade.

Sentinelas acessíveis por um segundo nome em um mesmo pacote

Quando um pacote exporta duas funções de acesso para uma condição — a segunda declarada como um encaminhamento para a primeira —, as tabelas acima trazem a função de acesso declarante e deixam de fora o nome que encaminha. Os dois nomes são exportados do mesmo pacote, então 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 funciona: o encaminhamento retorna o mesmo valor que a função de acesso declarante retorna.

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 aquele pacote; um encaminhamento dentro de um único pacote não precisa de uma segunda linha, porque uma única importação alcança os dois nomes.

ErrDuplicateRecipeIdentity() em pkg/catalog é um encaminhamento desse tipo: ele retorna ErrDuplicateEntityIdentity(), que é o nome que a tabela desse pacote traz.

Condições sem uma sentinela comparável

Algumas etapas da compilação declaram suas sentinelas em pacotes que o compilador não exporta, então não há nada que errors.Is possa referenciar e nenhuma correspondência pode ser escrita contra elas. 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 diagnósticos delas chegam a você por completo pelo texto de erro emitido e pelas visões indexadas por mensagem — fatal-halts.md em particular —, que são a forma suportada de reconhecê-las:

  • A construção da topologia (construção do grafo e achatamento de subagregados) reporta um sub-Aggregate que não pôde ser carregado, nomeando o URI do Aggregate inacessível; uma declaração uses: cuja forma estrutural não corresponde ao esquema; 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 precisa ser renomeado para desambiguar.
  • A finalização do grafo (mesclagem de Feature entre as superfícies do Aggregate e da Release) reporta um tipo de Feature declarado de forma inconsistente entre as duas.
  • A análise estática (avaliação de seletores e verificações de segurança de tipos entre nós) reporta uma violação de selector:; uma falha de resolução no catálogo da qual não consegue passar, nomeando a entidade inacessível; e uma rejeição por política, em que um plugin vinculado a um papel de veredito de governança rejeitou o build montado. Uma rejeição por política carrega a categoria POLICY_ERROR, o nome do plugin que rejeitou e a mensagem de regra fornecida pelo plugin.
  • A renderização (despacho para provedores e renderização por provedor) reporta um provedor desconhecido.
  • O carregador host Wasm embutido emite as suas próprias sentinelas de salvaguarda — uma salvaguarda de manifesto rejeitado (um plugin solicitou uma capacidade de acesso ao runtime que o firewall de pureza AOT nega), uma recuperação de pânico do guest e uma trap determinística de saída do plugin. Elas aparecem no diagnóstico voltado ao usuário ao executar um plugin (por exemplo, via aggrega lint). Autores de Plugin que testam um guest contra o host alcançam as mesmas condições por nome importável por meio de pkg/plugintest, listado acima.

Para condicionar um pipeline especificamente a uma rejeição por política, faça 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 consulta 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. Ela cobre todas as condições que aggrega pode reportar, incluindo as que as seções acima não conseguem listar.

Essa cobertura mais ampla é o objetivo desta tabela, e não um acaso dela. As seções acima são indexadas por um nome que você pode importar, então uma condição declarada apenas em um pacote que você não pode importar — e que também não é reexportada em nenhum lugar que você possa importar — não tem nada para pôr na coluna da esquerda delas. Esta tabela é indexada pelo código curto, e toda condição tem um, então nenhuma condição reportável fica fora dela. Um código curto que você tem em mãos é resolvido aqui, quer a condição por trás dele também tenha ou não uma função de acesso com a qual você possa fazer a correspondência.

O que dá a uma condição um lugar nesta tabela é o compilador poder de fato reportá-la. As linhas são derivadas do código em vez de transcritas nele: uma condição aparece aqui porque algo no compilador a levanta, então todo código na coluna da esquerda é um que aggrega pode imprimir. Essa é a promessa que a tabela faz, e é o que permite a você ler uma linha como uma verificação que realmente é executada.

A exceção deliberada é uma condição declarada antes que exista o código que a reporta, 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 diz isso em uma nota logo abaixo da tabela. Ela é listada em vez de escondida — um código que você tem em mãos deve sempre ser resolvido — e a nota ao lado diz a você claramente que nenhum build a levanta ainda, e o que precisaria existir antes que algum o fizesse.

Um número aposentado também é listado, em seu próprio conjunto de notas abaixo da tabela, e continua listado para sempre. De vez em quando uma condição é suprimida — é substituída por uma que cobre mais terreno, ou nada nunca a reportou — e, a partir desse momento, o seu número fica aposentado: ele nunca é atribuído a uma condição diferente, de modo que um código curto que você cita de um relatório antigo só pode nomear o que nomeava quando o relatório foi escrito. Essa promessa é mecânica, e não editorial. Uma condição declarada sob um número aposentado é recusada antes que o compilador leia qualquer entrada, em toda execução, então nenhuma versão pode conter uma — a mesma classe de recusa que encontraria um número que duas condições ativas tentassem compartilhar, redigida para que você possa saber em qual dos dois casos esbarrou. A nota de um código aposentado diz a você, onde a aposentadoria o anotou, o que o código nomeava e, onde a condição foi substituída, qual código reporta esse terreno agora.

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 ausente não é, por si só, evidência de nada: ele pode estar aposentado, e pode igualmente ser um que nada alcançou ainda. As notas deixam anotado quais números estão aposentados e, onde isso foi anotado, o que cada um deles nomeava, então um código que não se resolve nem em uma linha nem em uma nota é um que este compilador nunca emitiu.

Um código curto é deliberadamente opaco: quatro dígitos não dizem nada sobre uma condição por si sós, e esse é o preço de um identificador curto o bastante para ser lido em voz alta, digitado em uma busca ou colado em um 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 de então; ele não diz nada sobre a condição que nomeia. Então um código curto é um identificador e nada mais — o seu valor não é uma classificação, e nem ele nem qualquer agrupamento que você possa notar na tabela é um guia para onde uma condição está ou do que ela trata.

A tabela não tem coluna de categoria, e isso não é uma omissão: uma categoria é uma propriedade de uma falha específica, 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, então uma condição dessas reportada uma vez contra um Aggregate e uma vez contra uma Release carrega uma categoria diferente a cada vez — 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 ensinadas é 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 à qual a correção pertence, e o código curto identifica qual condição interrompeu o build. Nenhum dos dois pode ser derivado do outro, e é por isso que cada um tem a sua própria lista publicada — e por isso uma falha sem uma superfície de autoria a nomear ainda carrega um código que você pode consultar aqui.

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

Orientações sobre a correspondência

O predicado errors.Is percorre a cadeia de encapsulamento, então uma correspondência com uma sentinela funciona mesmo quando o erro é encapsulado várias vezes no caminho de volta até você. Faça a correspondência com o erro que uma função exportada retornou:

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 há nenhum ponto de entrada exportado que execute um build inteiro, então a correspondência com errors.Is se aplica ao código que chama estes pacotes diretamente. Para condicionar a CI a um build, execute aggrega build e leia o seu status 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 colchetes é resolvido na tabela de todas as condições nesta página.

Os dois caminhos de controle existem porque os três identificadores alcançam distâncias diferentes. Um controle escrito em Go vincula 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 controle escrito em torno do comando tem o status de saída e o texto impresso — e o texto impresso nomeia a condição, porque o código curto fica no cabeçalho entre colchetes. Então esse controle se baseia nesse código curto em vez de na redação da mensagem, e as visões indexadas por mensagem continuam sendo o caminho para voltar a partir de uma redação que ele já tem. Faça a correspondência com a sentinela a partir do Go; baseie-se no código curto em torno do comando; leia 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 as distingue por identidade, então a correspondência com uma não corresponde à outra. As reexportações destacadas nas tabelas são a exceção, e são destacadas justamente porque são o caso em que dois nomes de fato correspondem. Faça a correspondência com o nome no pacote sob o qual as tabelas o listam, e trate um nome curto sozinho como ambíguo.

Para o catálogo de diagnósticos voltados ao usuário (as mensagens que os desenvolvedores veem no terminal quando um build é interrompido), veja fatal-halts.md. Para o catálogo de avisos (a saída não bloqueante warning:, lint: e notice:), veja warnings.md. Para a taxonomia de prefixos de categoria ([DEVELOPER_ERROR] / [OPS_ERROR] / [CATALOG_ERROR] / [TRANSLATION_ERROR] / [FETCH_ERROR] / [POLICY_ERROR] / [TRUST_ERROR]), veja error-translation.md.