跳转到内容
AggregaAggrega
选择语言: 简体中文
本页面由机器翻译。阅读英文原文。

错误哨兵值——权威参考

编译器发出的每个致命中止都会指明一个条件,每个条件带有三个标识符,因为识别条件、记录条件和引用条件是三项不同的工作。哨兵值是 errors.Is 匹配的 Go 值,通过调用声明包导出的访问器获得:它是 Go 代码用来识别条件的标识符。代码是条件注册时使用的字符串:它用文字为条件本身命名,并且在周围的 Go 包演进时保持不变——它是程序记录的标识符。短代码是字母 E 加四位数字,短到可以口头念出、输入搜索框或粘贴到报告中:它是人引用的标识符。一个条件,三个标识符——匹配哨兵值以在 Go 中识别条件,需要记录或以其为键时读取代码,并通过本页下方列出所有条件的表格解析短代码。

面向用户的诊断信息(即 fatal-halts.md 和 error-translation.md 中收录的带前缀消息)承载面向开发者的说明文字;被包装的哨兵值则是程序化使用方中 errors.Is 进行匹配的对象。

本页是该目录以哨兵值为键的视图。编写 CI 门禁、IDE 集成或需要区分错误类型的构建编排代码的程序员,使用标准的 errors.Is 谓词与此处列出的哨兵值进行匹配。通过阅读输出的错误文本来调试构建的作者,通常需要以消息为键的视图——构建中止错误见 fatal-halts.md,提示性输出见 warnings.md。

下表中的每一行都指明一个访问器——一个不带参数、从该表指明的包中导出、返回哨兵值的函数。导入该包并调用访问器是受支持的集成接口,因此表中每个访问器都带有括号——调用才能产生 errors.Is 可匹配的值,不带括号的名称是一个函数而不是错误:

import (
"errors"
"github.com/aggrega-ai/aggrega-cli/pkg/resolver"
)
if errors.Is(err, resolver.ErrParameterContractViolation()) {
// handle parameter contract violations
}

三个标识符各自承担稳定性,这种分离正是一个条件同时拥有三者的原因。下列访问器在补丁版本之间保持稳定;重命名或移除会在执行该变更的版本的变更日志条目中公布,而在包内新增访问器属于增量变更,不会破坏现有的匹配代码。代码在其条件发布后即固定不变,因此凡是需要持久地指明条件之处,都应记录代码:重命名访问器不会改变其条件注册时使用的代码,你记录下的代码在 Go 接口重构后依然有效。短代码是三者中最持久的:编号只分配一次随后固定,已退役条件的编号保持退役状态,而不会分配给其他条件,因此旧报告中记录的短代码仍然指向记录时所指的条件。这一点是强制执行的,而不只是一种意图——在已退役编号下声明的条件,会在每次运行时、在编译器读取任何输入之前被拒绝——并且每个已退役编号都与现行编号一起发布在所有条件的表格中。下面的代码列给出代码,它是结构化诊断的客户端无需链接这些包即可读取的值。它是发布出来的而非推断出来的,因为它不必重复所在行的内容——重新导出的名称报告其所转发条件的代码,规则的代码为规则而非访问器命名。消息列是哨兵值呈现的字面文本;面向用户的诊断会在该文本前加上带方括号的头部和源位置。该头部带有条件的短代码,若该次出现有类别,则在旁边附上类别,如 [DEVELOPER_ERROR E0007]——因此读者可以分别解析两者:类别(DEVELOPER_ERROR / OPS_ERROR / CATALOG_ERROR / TRANSLATION_ERROR / FETCH_ERROR / POLICY_ERROR / TRUST_ERROR)在 error-translation.md 中讲解,短代码则在本页所有条件的表格中解析。若条件由插件引发,代码标记会以引发它的插件加以限定——[TRANSLATION_ERROR provider/example:1.0.0/E0007]——短代码是最后一段;error-translation.md 说明了为何存在该限定符,以及为何应解析的是最后一段。

读取条件的代码

代码只命名条件本身,不含其他信息,采用 kebab-case 形式——parameter-contract-violation、lockfile-drift。它不带任何前缀:不带声明它的包,不带引发它的阶段,也不带任何形式的分组。因此,当编译器围绕它重组时,代码保持不变;一个在编译中多处引发的条件仍然只有一个名称。每个条件的名称本身就各不相同,因此无需前缀,而且两个条件不能注册在同一个代码下。使用 github.com/aggrega-ai/aggrega-cli/pkg/errors 中的 CodeOf 从错误中读取代码,它像 errors.Is 一样遍历包装链,因此无论错误在返回给你的途中被包装了多少层,代码都会保留。该包本身也名为 errors,因此需要用导入别名将其与标准库区分开:

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 还会报告链中是否有任何错误携带了代码;一条不携带任何代码的链只是关于该链的一个事实,而不是一次失败。如果你更愿意自己匹配该接口,同一个包将其导出为 CodedError,errors.As 会在同样的遍历中找到它。

代码只单向传递。 它是条件所报告的内容,而绝不是让匹配器识别条件的依据:把该字符串写进你自己的代码,得到的只是一个字符串,从字符串无法回到 errors.Is 所匹配的值。匹配哨兵值以识别条件;读取代码以记录条件。

aggrega 在终端上打印的代码是短代码,而不是这个代码。 一条中止诊断以一个方括号头部开头,其中携带条件的短代码,若该次出现有类别,则类别位于其旁——[DEVELOPER_ERROR E0007];若条件由插件引发、代码由引发它的插件限定,则为 [TRANSLATION_ERROR provider/example:1.0.0/E0007];若该失败没有可引导你去的关注方,则为 [E0007]——随后是源位置以及 fatal-halts.md 中收录的消息文本。描述性代码用文字命名条件,对于该位置而言过宽:对于最长的条件,它会在消息开始之前就占满一个窄终端,这正是第二个紧凑标识符存在的全部原因。因此,当你手头只有打印输出时,应以短代码为依据,它可在本页下方的所有条件的表格中解析:从一个可以在电话中读出的编号,你就能找到该条件、其访问器及其消息文本。aggrega explain <code> 在终端中完成这一解析——它接受条件的任一代码,打印该条件以及记录编写修复方法的条目,详见 aggrega explain。若要依据措辞而非标识符排查,仍可使用 fatal-halts.md 中以消息为键的视图。

代码确实会在 Go 之外传递的地方,是编译器即服务守护进程发布的结构化诊断,它作为每个条目中独立的 code 字段出现,而不是被并入消息文本——因此编辑器扩展或该协议的任何其他客户端,无需链接这些包、无需解析文本,即可根据条目所报告的内容进行分支。无论由谁分配,这一个键都携带一个可供机器匹配的代码,而条目会说明是哪一层引发了它。那里的代码有三种来源,其中第三种正是为什么一个能在本页查到的代码,其本身并不表示有任何东西失败:

  • 失败所指明的条件的代码,即本页所收录的内容。
  • 关于渲染输出的建议的类别代码——unsupported-field 就是其中之一,warnings.md 对其有描述。它在建议被引发的地方分配,而不是作为条件注册,因此在这里没有对应的行。
  • 关于所编写文档的建议的注册代码——一个与已声明名称只差一处编辑的名称、一个没有任何东西读取的参数。这类发现以与失败相同的形式指明条件,因此其代码是注册的,并且在本页有对应的行,读取该行即可了解该发现涉及什么。

因此,你会从中止中读到的同一个代码,也可能来自一次已完成的构建,由一个对结果没有任何改变的发现携带。区分二者的是你得到的结果以及条目所指明的层——绝不是代码本身的形式,也绝不是它能否在这里解析。若生成条目的任何环节都没有分配代码,则省略该字段:即未指明任何 Aggrega 自身条件的失败,以及其引发方未分配代码的建议。aggrega serve 记录了条目结构、指明层的键,以及该字段何时出现。

结构化诊断同时携带条件的两个标识符,分清哪个是哪个,决定了你拿到的是可以据以行动的标识符,还是无法据以行动的标识符。 上面的 code 键供程序使用:以连字符连接、用文字命名条件,因此根据它进行分支的扩展读起来就是其含义,它也是 CodeOf 在 Go 中报告的值。其旁的 shortCode 键供人使用——字母 E 加四位数字,与中止诊断在其方括号头部中打印的标记相同。它是你在电话中读出、输入搜索框或粘贴进 issue 的内容,也是所有条件的表格所使用的键。

二者都不是对方的缩写,也都不是对方的后备。根据描述性代码进行匹配;向读者展示短代码。只提供描述性代码的界面,相当于把一个面向匹配器的标识符交给作者;而根据短代码进行匹配的界面,则是在匹配一个对条件毫无说明的编号——这就是为什么两者都会传递,而不是只选其一。

第三个键 codeDescription 携带条件的发布位置,作为一个可打开以进一步了解该诊断的引用。其地址解析到本页所有条件的表格,因此从编辑器跟随它的读者到达时,手中握着该表格所用的短代码。条目要么同时携带短代码和引用,要么两者都不携带:恰好在条目指明一个已注册条件——即在该表格中有对应行的条件——时两者都存在;当代码指明一类建议,或指明来自你自己的、Aggrega 未声明的 linter 中某条约定规则的标识时,两者都不存在,因为这些没有可引用的编号,这里也没有描述它们的内容。

反方向——从你手中的代码到它所指明的条件——下面的表格就是发布的列表。 每一行都在代码旁列出在 Go 中产生同一条件的访问器,因此从结构化诊断中读到的代码,可以解析为一个你可以匹配的名称,以及该条件所渲染的文本。这些表格涵盖访问器可以导入的条件,有两类代码不在其中:类别代码,它指明的是一类建议而非条件,因此没有可列于其旁的访问器;以及其条件仅在你无法导入的包中声明、且未在任何地方重新导出的代码,它没有可列于其旁的可匹配名称。第二类仍然指明一个条件,该条件仍然有短代码——本页下方所有条件的表格以短代码而非可导入名称为键,因此也涵盖了这些条件。

可匹配的接口面,按声明包分组

下面每一节对应一个可导入的包。节标题是相对于模块路径 github.com/aggrega-ai/aggrega-cli 的包路径,因此标题为 pkg/resolver 的一节以 github.com/aggrega-ai/aggrega-cli/pkg/resolver 导入。

条目按声明该 sentinel 的包分组,因为匹配方导入的正是这个包。条件在构建的哪个阶段触发是另一个问题,本页有意不作回答:单个 sentinel 经常从多处触发,还有一些只从模块未导出的代码中触发,因此任何逐条给出的答案都无法对每一行都成立。按消息索引的视图以可观察的方式回答了“在构建中何时触发”的问题,首先是 fatal-halts.md。

少数名称出现在多个包中。它们是同一个共享值的重新导出,而不是两个条件,因此匹配任一名称都会成功;当两个名称都可导入时,表格会注明这一点。两行带有相同的代码,这是在 Go 之外的客户端所持有的标识符上表述的同一事实:一个条件,一个代码,无论有多少名称指向它。

pkg/catalog

Sentinel代码消息
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() 与 pkg/resolver.ErrManifestImplementsMismatch() 是同一个值,因此匹配任一名称都会成功。

pkg/closure

Sentinel代码消息
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

Sentinel代码消息
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() 与 pkg/refcycle.ErrCycle() 是同一个值,因此匹配任一名称都会成功。

pkg/deprecation

Sentinel代码消息
ErrDeprecatedEntity()deprecated-entitydeprecation: build consumes a deprecated entity

pkg/docscache

Sentinel代码消息
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() 与 pkg/oci.ErrFetchNotFound() 是同一个值,因此匹配任一名称都会成功。

pkg/egress

Sentinel代码消息
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

Sentinel代码消息
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

Sentinel代码消息
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

Sentinel代码消息
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

Sentinel代码消息
ErrNameWindowsCannotHold()name-windows-cannot-holda name this operation writes holds a path segment Windows cannot hold as written

pkg/pluginpath

Sentinel代码消息
ErrPluginArtifactNotFound()plugin-artifact-not-foundplugin artifact not found on this machine
ErrPluginEntityNotFound()plugin-entity-not-foundplugin reference is not a Plugin entity

pkg/pluginstrust

Sentinel代码消息
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

Sentinel代码消息
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

Sentinel代码消息
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

Sentinel代码消息
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

Sentinel代码消息
ErrCycle()reference-cyclecircular reference expansion

pkg/registrytrust

Sentinel代码消息
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

Sentinel代码消息
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

Sentinel代码消息
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

Sentinel代码消息
ErrFetchIntegrity()fetch-integrityoci: content digest mismatch
ErrFetchNotFound()fetch-not-foundoci: artifact not found at remote source
  • ErrFetchIntegrity() 与 pkg/oci.ErrFetchIntegrity() 是同一个值,因此匹配任一名称都会成功。
  • ErrFetchNotFound() 与 pkg/oci.ErrFetchNotFound() 是同一个值,因此匹配任一名称都会成功。

pkg/sourcekind

Sentinel代码消息
ErrUnknownKind()unknown-source-kindno source adapter serves the source kind

pkg/sourceresolver

Sentinel代码消息
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() 与 pkg/oci.ErrFetchIntegrity() 是同一个值,因此匹配任一名称都会成功。
  • ErrFetchNetworkUnreachable() 与 pkg/oci.ErrFetchNetworkUnreachable() 是同一个值,因此匹配任一名称都会成功。
  • ErrFetchNotFound() 与 pkg/oci.ErrFetchNotFound() 是同一个值,因此匹配任一名称都会成功。
  • ErrFetchUnauthorized() 与 pkg/oci.ErrFetchUnauthorized() 是同一个值,因此匹配任一名称都会成功。

pkg/sourceresolver/cacheslot

Sentinel代码消息
ErrEmptyWorkspaceRoot()empty-workspace-rootcacheslot: empty workspaceRoot

pkg/sourceresolver/netrc

Sentinel代码消息
ErrNetrcFileUnreadable()netrc-file-unreadablethe netrc file could not be read
ErrSourceURLCarriesCredential()source-url-carries-credentialthe source URL carries a credential

pkg/types

Sentinel代码消息
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

Sentinel代码消息
ErrDanglingUsesTarget()dangling-uses-targetuses edge target does not exist
ErrReleaseEdgeRetarget()release-edge-retargetrelease edge retargets a developer-declared edge

pkg/validator

Sentinel代码消息
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

Sentinel代码消息
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

Sentinel代码消息
ErrExtensionEval()schema-extension-evaluation-failedvalidator/jsonschema: x-aggrega extension evaluation failed
ErrSchemaResolve()schema-not-resolvablevalidator/jsonschema: schema resolution failed

pkg/validator/merger

Sentinel代码消息
ErrMergeInvalid()schema-merge-input-invalidmerger: invalid merge input

pkg/workspaceconfig

Sentinel代码消息
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

Sentinel代码消息
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

Sentinel代码消息
ErrPositionOutOfRange()position-out-of-rangeposition out of range

携带另一个 sentinel 的 sentinel

ErrCacheMetadataInvalid(pkg/sourceresolver/metadata)报告一个已损坏的源制品缓存槽。它被声明为 ErrFetchIntegrity() 的包装,而不是自身独立的标识,因此它不出现在上面的表格中,并且针对 ErrFetchIntegrity() 的匹配对它同样成功。由于它包装了一个 sentinel 而不是声明一个 sentinel,它以值而不是函数的形式导出:按 ErrCacheMetadataInvalid 匹配它,不带括号。需要该特定条件时匹配这个包装,需要整个完整性类别时匹配被包装的 sentinel。

在同一个包中可通过第二个名称访问的哨兵错误

当一个包为同一个条件导出两个访问器(第二个声明为对第一个的转发)时,上面的表格列出声明它的访问器,而不列出转发名称。两个名称都从同一个包导出,因此能访问其中任一名称的导入也已经能访问另一个;再加一行只会把同一个条件以一个不会匹配到任何新内容的名称重复列出。匹配任一名称都会成功:转发返回的值与声明它的访问器返回的值相同。

这与跨包的情况不同。从另一个包重新导出的哨兵错误在每个包的表格中各占一行,因为导入其中一个包的匹配代码若不同时导入另一个包,就无法访问另一个包中的名称;而单个包内的转发不需要第二行,因为一次导入即可访问两个名称。

pkg/catalog 中的 ErrDuplicateRecipeIdentity() 就是这样一个转发:它返回 ErrDuplicateEntityIdentity(),后者是该包表格中列出的名称。

没有可匹配 sentinel 的条件

某些编译阶段在编译器未导出的包中声明其 sentinel,因此 errors.Is 没有可引用的对象,也无法针对它们编写匹配器。这里对它们进行描述而非列表,因为本页中的表格承诺其左侧列可以被解引用。

它们的诊断信息会通过输出的错误文本以及按消息索引的视图(尤其是 fatal-halts.md)完整地呈现给你,这是识别它们的受支持方式:

  • 拓扑构建(图构建与 sub-aggregate 展平)会报告:无法加载的 sub-Aggregate,并指明无法访问的 Aggregate URI;结构形态与 schema 不符的 uses: 声明;超出嵌套深度;以及展平后的节点 ID 冲突,即两个 sub-Aggregates 编译为同一节点 ID,必须重命名其中一个实例名以消除歧义。
  • 图最终化(跨 Aggregate 与 Release 两个层面合并 Feature)会报告在两者之间声明不一致的 Feature 类型。
  • 静态分析(选择器求值与跨节点类型安全检查)会报告:selector: 违规;无法越过的目录解析缺失,并指明不可达的实体;以及策略拒绝,即挂载在治理裁决角色上的插件拒绝了组装好的构建。策略拒绝带有 POLICY_ERROR 类别、执行拒绝的插件名称,以及该插件提供的规则消息。
  • 渲染(provider 分派与按 provider 渲染)会报告未知的 provider。
  • 嵌入式 Wasm 宿主加载器会发出它自己的防护 sentinel:manifest 被拒绝防护(插件请求了 AOT 纯度防火墙所拒绝的运行时访问能力)、guest panic 恢复,以及确定性的插件退出陷阱。运行插件时(例如通过 aggrega lint),这些情况会出现在面向用户的诊断中。Plugin 作者在宿主上测试 guest 时,可以通过上文列出的 pkg/plugintest 以可导入的名称访问相同的情况。

若要专门针对策略拒绝来控制流水线,应匹配诊断信息中的 POLICY_ERROR 类别前缀,而非 sentinel;该类别是错误接口中有文档说明的部分,详见 error-translation.md。

按短代码列出的所有条件

下表按相反方向进行查找:左列是短代码,旁边是该代码所指的条件以及该条件输出的文本。它涵盖 aggrega 可能报告的所有条件,包括上文各节无法列出的条件。

这种更广的覆盖范围正是此表的目的,而非偶然。上文各节以你可以导入的名称为键,因此一个仅在你无法导入的包中声明、且也未在任何你可导入之处重新导出的条件,在它们的左列中无可填写。此表以短代码为键,而每个条件都有短代码,因此任何可报告的条件都不会落在表外。你手中的短代码在此都能解析,无论其背后的条件是否还有可供匹配的访问器。

一个条件能列入此表,是因为编译器确实能够报告它。 表中各行由代码推导而来,而非抄录进代码:某个条件出现在此,是因为编译器中有某处会引发它,因此左列中的每个代码都是 aggrega 可能打印的代码。这就是此表作出的承诺,也正因如此,你可以把每一行当作一项确实会运行的检查来阅读。

有意为之的例外是在报告它的代码存在之前就已声明的条件,以便代码和措辞事先固定,不会在已引用它们的读者面前发生变化。这样的条件会在表格正下方以注释说明。它被列出而非隐藏——你手中的代码应当总能解析——旁边的注释会明确告诉你目前尚无构建引发它,以及需要具备什么才会引发。

已停用的编号也会列出,位于表格下方单独的一组注释中,并永久保留。 条件偶尔会被撤销——被覆盖范围更广的条件取代,或者从未有任何东西报告过它——从那一刻起,其编号即被停用:它永远不会分配给其他条件,因此你从旧报告中引用的短代码只能指代报告写成时它所指的内容。这一承诺是机制性的,而非编辑性的。在已停用编号下声明的条件会在编译器读取任何输入之前、在每次运行时被拒绝,因此任何 release 都不可能携带这样的条件——这与两个现行条件试图共用一个编号时所遇到的拒绝属于同一类,其措辞让你能分辨遇到的是哪一种。已停用代码的注释会告诉你(在停用时有记录的情况下)该代码曾指代什么,以及在该条件被取代的情况下,现在由哪个代码报告这一范围。

从不重用编号,也使编号序列留下了永久的空缺,而注释让这些空缺变得可读。缺失的编号本身并不能证明任何事: 它可能已停用,也同样可能是尚未被用到的编号。注释记录了哪些编号已停用,以及(在有记录的情况下)各自曾指代什么,因此一个既不对应任何行也不对应任何注释的代码,是本编译器从未发出过的代码。

短代码有意设计为不透明:四位数字本身不说明条件的任何信息,这是标识符足够短、便于念出、输入搜索或粘贴到报告中所付出的代价。下面的对应关系使其变得可用。编号从单一的递增序列中只分配一次,此后固定不变;它不说明所指条件的任何信息。因此短代码只是一个标识符,仅此而已——它的值不是一种分类,它本身以及你在表中可能注意到的任何分组,都不能指示条件位于何处或与什么相关。

此表没有类别列,这并非遗漏:类别是某次具体失败的属性,而非其背后条件的属性。 有些条件在构造上就属于某一类别。对于其他条件,类别取决于失败所涉及的实体种类,因此同一个这样的条件,一次针对 Aggregate 报告、一次针对 Release 报告时,每次携带的类别都不同——若在此处为条件写上单一的值,对第二类的每个条件都会是错的。

类别的讲解位于 error-translation.md——每个类别、其含义以及修复方法所在之处。类别和短代码回答的是关于同一次失败的不同问题:类别指出修复应落在哪个层面,短代码指出是哪个条件中止了构建。两者都无法从对方推导出来,因此各有一份公开的列表——这也是为什么一个没有可指明的编写层面的失败,仍然带有一个你可以在此查找的代码。

代码条件消息
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 已停用:现在不再有任何东西报告它,该编号也永远不会分配给其他条件。它曾指代在检查图的静态契约时失败的目录查找——这是编译器的故障,而非编写的文档中的故障——而当构建解析的组件类型在其当时读取的目录中没有条目时所引发的条件,现在负责报告这一状态,其代码为 E0154。
  • E0134 已停用:现在不再有任何东西报告它,该编号也永远不会分配给其他条件。它曾指代一个可发布实体,其目录未以该实体声明的版本命名;发布不检查目录名称,而当某实体的种类拥有独立目录、该实体却与另一实体共用目录时所引发的条件是 E0303。
  • E0157 已停用:现在不再有任何东西报告它,该编号也永远不会分配给其他条件。它曾指代不符合编写名称模式的 Aggregate 键——组件、功能、子系统或嵌套模块的实例名称。所有这些键的层面都由 Aggregate schema 约束为同样的拼写,该 schema 会在验证文档外壳时拒绝该文档,并报告出错的键及其行号和列号;该条件的代码为 E0215。
  • E0159 已停用:现在不再有任何东西报告它,该编号也永远不会分配给其他条件。它曾指代一个目标引用,其以点分隔的各段并非全部符合实例名称模式;在该条件被撤销之前,没有任何构建报告过它。
  • E0166 已停用:现在不再有任何东西报告它,该编号也永远不会分配给其他条件。它曾指代 Release 的 parameters: { $import: … } 所指向的文件无法读取或其字节无法解析的情况;无论路径写在何处,不产生文档的文件都属于同一个条件,其代码为 E0175。
  • E0203 已停用:现在不再有任何东西报告它,该编号也永远不会分配给其他条件。它曾指代一个使用 eval 能力、却声明了源、values 覆盖层、workload 或 artifacts 的 FeatureRecipe;该能力已被撤销,现在也没有任何东西报告这种状态。
  • E0206 已停用:现在不再有任何东西报告它,该编号也永远不会分配给其他条件。它曾指代一个使用 eval 能力、却声明了源、workload、artifacts 或 values 覆盖层的 Recipe;该能力已被撤销,而一个未声明其中任何一项的 Recipe 在任何能力上都会以 E0210 被拒绝。
  • E0217 已停用:现在不再有任何东西报告它,该编号也永远不会分配给其他条件。它曾指代无法针对某个特定字段报告的 schema 验证失败;在该条件被撤销之前,没有任何构建报告过它。
  • E0219 已停用:现在不再有任何东西报告它,该编号也永远不会分配给其他条件。它曾指代循环的 extends 链,由独立于 schema 合并组合步骤的链遍历报告;单次链遍历会报告所有循环链,其代码为 E0202。
  • E0230 已停用:现在不再有任何东西报告它,该编号也永远不会分配给其他条件。该编号所指的条件已被撤销,没有任何构建报告它。
  • E0231 已停用:现在不再有任何东西报告它,该编号也永远不会分配给其他条件。该编号所指的条件已被撤销,没有任何构建报告它。
  • E0232 已停用:现在不再有任何东西报告它,该编号也永远不会分配给其他条件。该编号所指的条件已被撤销,没有任何构建报告它。
  • E0233 已停用:现在不再有任何东西报告它,该编号也永远不会分配给其他条件。该编号所指的条件已被撤销,没有任何构建报告它。
  • E0234 已停用:现在没有任何内容报告它,且该编号永远不会分配给其他条件。它指的是通过 compose provider 渲染时报告的、为空字符串的 Recipe 源;现在由一个涵盖所有 provider 的条件报告该情况,其代码为 E0251。
  • E0235 已停用:现在没有任何内容报告它,且该编号永远不会分配给其他条件。此编号所指的条件已被撤销,没有任何构建会报告它。
  • E0236 已停用:现在没有任何内容报告它,且该编号永远不会分配给其他条件。此编号所指的条件已被撤销,没有任何构建会报告它。
  • E0237 已停用:现在没有任何内容报告它,且该编号永远不会分配给其他条件。此编号所指的条件已被撤销,没有任何构建会报告它。
  • E0238 已停用:现在没有任何内容报告它,且该编号永远不会分配给其他条件。此编号所指的条件已被撤销,没有任何构建会报告它。
  • E0239 已停用:现在没有任何内容报告它,且该编号永远不会分配给其他条件。此编号所指的条件已被撤销,没有任何构建会报告它。
  • E0240 已停用:现在没有任何内容报告它,且该编号永远不会分配给其他条件。此编号所指的条件已被撤销,没有任何构建会报告它。
  • E0241 已停用:现在没有任何内容报告它,且该编号永远不会分配给其他条件。此编号所指的条件已被撤销,没有任何构建会报告它。
  • E0242 已停用:现在没有任何内容报告它,且该编号永远不会分配给其他条件。它指的是通过 Helm provider 渲染时报告的、为空字符串的 Recipe 源;现在由一个涵盖所有 provider 的条件报告该情况,其代码为 E0251。
  • E0243 已停用:现在没有任何内容报告它,且该编号永远不会分配给其他条件。此编号所指的条件已被撤销,没有任何构建会报告它。
  • E0244 已停用:现在没有任何内容报告它,且该编号永远不会分配给其他条件。此编号所指的条件已被撤销,没有任何构建会报告它。
  • E0245 已停用:现在没有任何内容报告它,且该编号永远不会分配给其他条件。此编号所指的条件已被撤销,没有任何构建会报告它。
  • E0249 已停用:现在没有任何内容报告它,且该编号永远不会分配给其他条件。此编号所指的条件已被撤销,没有任何构建会报告它。
  • E0258 已停用:现在没有任何内容报告它,且该编号永远不会分配给其他条件。此编号所指的条件已被撤销,没有任何构建会报告它。
  • E0322 已停用:现在不再有任何东西报告它,该编号也永远不会分配给其他条件。它曾指代挂载在边界上的 Feature 为某个 component 的环境计算、而所在键已由另一个挂载交付的值。挂载在边界上的 Feature 只能通过其 FeatureRecipe 的 injectMapping 向 component 交付,而写入另一个挂载已交付的键的映射会以 E0318 报告。

匹配指南

errors.Is 谓词会遍历包装链,因此即使错误在返回给你的途中被包装了多次,哨兵匹配仍然有效。请针对导出函数返回的错误进行匹配:

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
}

没有可运行整个构建的导出入口点,因此 errors.Is 匹配适用于直接调用这些包的代码。若要根据构建结果控制 CI,请运行 aggrega build,并读取其退出状态和诊断信息:诊断的消息文本收录在 fatal-halts.md 中,其类别收录在 error-translation.md 中,而其方括号开头中的短代码可在本页的所有条件的表格中查到。

之所以存在两种控制路径,是因为这三种标识符能触及的范围不同。用 Go 编写的控制逻辑会链接这些包、匹配哨兵,并能从它持有的任何错误中读取任一代码。围绕命令编写的控制逻辑只有退出状态和打印的文本——而打印的文本会指明条件,因为短代码位于方括号开头中。因此这类控制逻辑应以该短代码为依据,而不是以消息措辞为依据;以消息为索引的视图仍是从已有措辞反查的途径。在 Go 中匹配哨兵;围绕命令时以短代码为依据;在客户端支持该协议时,从结构化诊断中读取描述性代码。

在不同包中声明、短名称相同的哨兵是不同的条件,而不是同一条件的两种写法:errors.Is 按身份区分它们,因此与其中一个匹配并不会与另一个匹配。表格中特别指出的重新导出是例外,之所以特别指出,正是因为这是两个名称确实匹配的情况。请针对表格所列包中的名称进行匹配,并将单独的短名称视为有歧义。

面向用户的诊断目录(构建中止时开发者在终端中看到的消息),请参见 fatal-halts.md。建议性警告目录(不会中止的 warning:、lint: 和 notice: 输出),请参见 warnings.md。类别前缀分类([DEVELOPER_ERROR] / [OPS_ERROR] / [CATALOG_ERROR] / [TRANSLATION_ERROR] / [FETCH_ERROR] / [POLICY_ERROR] / [TRUST_ERROR]),请参见 error-translation.md。