コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

エラーセンチネル — 正規リファレンス

コンパイラが発するすべての致命的な停止は 1 つの条件を示し、各条件は 3 つの識別子を持ちます。条件を認識すること、記録すること、引用することは、それぞれ異なる作業だからです。センチネルは errors.Is が照合する Go の値で、宣言元パッケージがエクスポートするアクセサを呼び出して得られます。これは Go のコードが認識する識別子です。コードは条件が登録される文字列です。条件そのものを言葉で示し、周囲の Go パッケージが変化しても固定されたままです。これはプログラムが記録する識別子です。ショートコードは文字 E と 4 桁の数字で、読み上げたり、検索に入力したり、報告に貼り付けたりできるほど短いものです。これは人が引用する識別子です。1 つの条件に 3 つの識別子があります。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
}

3 つの識別子はそれぞれ別個に安定性を持ち、その分離こそが条件が 3 つすべてを持つ理由です。以下に挙げるアクセサはパッチリリース間で安定しています。名前の変更や削除は、それを行うリリースの変更履歴の項目で告知され、パッケージ内に新しいアクセサを追加することは追加的な変更であり、既存の照合処理を壊しません。コードは条件が公開された時点で固定されるため、条件を永続的に名指す必要がある場所で記録すべき識別子です。アクセサの名前を変更しても、その条件が登録されたコードは変わらず、記録したコードは Go の公開面のリファクタリング後も有効です。ショートコードは 3 つの中で最も永続的です。番号は一度割り当てられると固定され、廃止された条件の番号は別の条件に割り当てられることなく廃止されたままになるため、古い報告に記録されたショートコードは、記録された時点で示していた条件を今も示します。これは単なる意図ではなく強制されています。廃止された番号で宣言された条件は、毎回の実行で、コンパイラが入力を読む前に拒否されます。また、廃止されたすべての番号は すべての条件の表 に有効な番号と並べて公開されています。以下のコード列はコードを示し、構造化診断のクライアントがこれらのパッケージをリンクせずに読む値です。これは推測ではなく公開されたものです。コードは、それが置かれた行を繰り返すとは限らないからです。再エクスポートされた名前は転送先の条件のコードを報告し、ルールのコードはアクセサではなくルールを示します。メッセージ列はセンチネルが出力するリテラルテキストです。ユーザー向けの診断では、そのテキストの前に角括弧付きのヘッドとソース位置が置かれます。そのヘッドは条件のショートコードを持ち、発生にカテゴリがある場合はその横にカテゴリが付きます。例えば [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 に記載されています。

条件のコードの読み方

コードは条件だけを名指しし、それ以外のものは表しません。形式はケバブケースです(parameter-contract-violation、lockfile-drift)。コードには接頭辞がありません。宣言するパッケージも、発生させるステージも、いかなる種類のグループ分けも含みません。そのため、周囲でコンパイラが再編成されてもコードは変わらず、1 回のコンパイルの中で複数の箇所から発生する条件も名前は 1 つのままです。どの条件の名前もそれ自体で一意であり、それによって接頭辞が不要になっています。また、2 つの条件を 1 つのコードで登録することはできません。エラーからコードを読み取るには、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 に掲載されているメッセージテキストが続きます。説明的なコードは条件を言葉で名指しするため、この位置には長すぎます。最も長い条件では、メッセージが始まる前に狭いターミナルを埋めてしまいます。これこそが、2 つ目のコンパクトな識別子が存在する理由です。したがって、出力された内容しか手元にない場合に手がかりとすべきトークンは短いコードであり、それはこのページの下にあるすべての条件の表で解決できます。電話で読み上げられる番号から、条件、そのアクセサ、そのメッセージテキストにたどり着けます。aggrega explain <code> はこの解決をターミナル上で行います。条件のどちらのコードも受け付け、条件と、作成時の修正方法を記述したエントリをあわせて出力します。詳細は aggrega explain を参照してください。識別子ではなく文言から調べる場合は、引き続き fatal-halts.md のメッセージをキーとしたビューを使用します。

コードが Go の外へ伝わるのは、compiler-as-service デーモンが公開する構造化診断においてです。コードは各エントリに独立した code フィールドとして含まれ、メッセージテキストに埋め込まれることはありません。そのため、エディタ拡張やそのプロトコルの他のクライアントは、これらのパッケージをリンクせず、文章を解析することもなく、エントリが報告する内容に基づいて分岐できます。この 1 つのキーは、誰が割り当てたかにかかわらず機械で照合可能なコードを持ち、エントリはどのレイヤーがそれを発生させたかを示します。そこでのコードには 3 つの出所があり、3 つ目があるために、このページで調べられるコードはそれだけでは何かが失敗したことを示すものではありません。

  • 失敗が名指しする条件のコード。このページが掲載しているのはこれです。
  • レンダリングされた出力に関する勧告のクラスコード。unsupported-field がその一例で、warnings.md で説明しています。これは条件として登録されるのではなく、勧告が発生した場所で割り当てられるため、ここには行がありません。
  • 作成されたドキュメントに関する勧告の登録済みコード。例えば、宣言された名前から 1 文字違いの名前や、何も読み取らないパラメータです。このような指摘は失敗と同じ形式で条件を名指しするため、そのコードは登録されており、このページに行があります。その行を読めば、指摘が何についてのものかがわかります。

したがって、停止から読み取るのと同じコードが、完了したビルドから、結果に何の影響も与えなかった指摘によって届くこともあります。両者を区別するのは、得られた結果とエントリが名指しするレイヤーであり、コード自体の形式や、ここで解決できるかどうかでは決してありません。エントリを生成したものがコードを割り当てなかった場合、つまり Aggrega 自身の条件を名指ししない失敗や、発生元がコードを割り当てなかった勧告では、このフィールドは省略されます。エントリの形状、レイヤーを名指しするキー、フィールドが存在する条件については aggrega serve で説明しています。

構造化診断は条件の両方の識別子を持ちます。どちらがどちらかを知っていることが、対処に使える識別子とそうでない識別子の違いになります。 上記の code キーはプログラム向けです。ハイフンでつながれ、条件を言葉で名指しするため、それに基づいて分岐する拡張は意味どおりに読めます。また、これは Go で CodeOf が報告する値です。その横の shortCode キーは人向けです。文字 E と 4 桁の数字で、停止を伴う診断が角括弧付きのヘッドに出力するのと同じトークンです。電話で読み上げたり、検索ボックスに入力したり、issue に貼り付けたりするのはこちらであり、すべての条件の表のキーとなるトークンです。

どちらも他方の省略形ではなく、他方の代替でもありません。照合には説明的なコードを使い、読み手には短いコードを示してください。説明的なコードだけを提供する画面は、照合用の識別子を作成者に渡すことになり、短いコードで照合する画面は、条件について何も語らない番号で照合することになります。だからこそ、どちらか一方を選ぶのではなく、両方が伝えられます。

3 つ目のキーである codeDescription は、条件が公開されている場所を持ちます。これは診断について詳しく知るために開く参照です。そのアドレスはこのページのすべての条件の表に解決されるため、エディタからそれをたどった読み手は、表のキーとなる短いコードを手にした状態で到着します。エントリは短いコードと参照を両方とも持つか、どちらも持たないかのいずれかです。エントリが登録済みの条件(その表に行があるもの)を名指しする場合にのみ両方が存在し、コードが勧告のクラスや、Aggrega が宣言していない独自のリンターの慣例ルールの識別を名指しする場合は両方とも存在しません。それらには引用すべき番号がなく、ここにはそれらを説明するものがないためです。

逆方向、つまり手元のコードからそれが名指しする条件へたどる場合は、以下の表が公開された一覧です。 各行は、Go で同じ条件を返すアクセサの横にコードを示しているため、構造化診断から読み取ったコードは、照合可能な名前と、条件が出力するテキストに解決されます。表は、アクセサをインポートできる条件を対象としており、2 種類のコードは表の対象外です。1 つはクラスコードで、条件ではなく勧告のクラスを名指しするため、横に置くアクセサがありません。もう 1 つは、条件がインポートできないパッケージでのみ宣言され、どこにも再エクスポートされていないコードで、横に置く照合可能な名前がありません。この 2 つ目の種類も条件を名指ししており、その条件にも短いコードがあります。このページの下にあるすべての条件の表は、インポート可能な名前ではなく短いコードをキーとしているため、これらも対象に含みます。

照合可能な範囲(宣言するパッケージ別)

以下の各セクションは、インポート可能な 1 つのパッケージに対応します。見出しはモジュールパス github.com/aggrega-ai/aggrega-cli からの相対パッケージパスであり、pkg/resolver という見出しのセクションは github.com/aggrega-ai/aggrega-cli/pkg/resolver としてインポートします。

エントリは、センチネルを宣言するパッケージごとにまとめています。照合する側がインポートするのがそのパッケージだからです。ビルドのどこでその状態が発生するかは別の問題であり、このページはあえてそれに答えません。1 つのセンチネルが複数の箇所から発生することはよくあり、またモジュールがエクスポートしないコードからのみ発生するものもいくつかあるため、エントリごとの答えをすべての行について正しく示すことはできません。ビルドのどの時点かという問いには、メッセージをキーとしたビューが観察可能な形で答えます。とりわけ fatal-halts.md を参照してください。

いくつかの名前は複数のパッケージに現れます。これらは 2 つの状態ではなく 1 つの共有値の再エクスポートであるため、どちらの名前で照合しても成功します。両方の名前がインポート可能な場合は、表にその旨を記載しています。両方の行は同じコードを持ちます。これは、Go 以外のクライアントが保持する識別子の上で同じ事実を示したものです。つまり、どれだけの名前から到達しても、1 つの状態に 1 つのコードです。

pkg/catalog

センチネルコードメッセージ
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

センチネルコードメッセージ
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

センチネルコードメッセージ
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

センチネルコードメッセージ
ErrDeprecatedEntity()deprecated-entitydeprecation: build consumes a deprecated entity

pkg/docscache

センチネルコードメッセージ
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

センチネルコードメッセージ
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

センチネルコードメッセージ
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

センチネルコードメッセージ
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

センチネルコードメッセージ
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

センチネルコードメッセージ
ErrNameWindowsCannotHold()name-windows-cannot-holda name this operation writes holds a path segment Windows cannot hold as written

pkg/pluginpath

センチネルコードメッセージ
ErrPluginArtifactNotFound()plugin-artifact-not-foundplugin artifact not found on this machine
ErrPluginEntityNotFound()plugin-entity-not-foundplugin reference is not a Plugin entity

pkg/pluginstrust

センチネルコードメッセージ
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

センチネルコードメッセージ
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

センチネルコードメッセージ
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

センチネルコードメッセージ
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

センチネルコードメッセージ
ErrCycle()reference-cyclecircular reference expansion

pkg/registrytrust

センチネルコードメッセージ
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

センチネルコードメッセージ
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

センチネルコードメッセージ
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

センチネルコードメッセージ
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

センチネルコードメッセージ
ErrUnknownKind()unknown-source-kindno source adapter serves the source kind

pkg/sourceresolver

センチネルコードメッセージ
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

センチネルコードメッセージ
ErrEmptyWorkspaceRoot()empty-workspace-rootcacheslot: empty workspaceRoot

pkg/sourceresolver/netrc

センチネルコードメッセージ
ErrNetrcFileUnreadable()netrc-file-unreadablethe netrc file could not be read
ErrSourceURLCarriesCredential()source-url-carries-credentialthe source URL carries a credential

pkg/types

センチネルコードメッセージ
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

センチネルコードメッセージ
ErrDanglingUsesTarget()dangling-uses-targetuses edge target does not exist
ErrReleaseEdgeRetarget()release-edge-retargetrelease edge retargets a developer-declared edge

pkg/validator

センチネルコードメッセージ
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

センチネルコードメッセージ
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

センチネルコードメッセージ
ErrExtensionEval()schema-extension-evaluation-failedvalidator/jsonschema: x-aggrega extension evaluation failed
ErrSchemaResolve()schema-not-resolvablevalidator/jsonschema: schema resolution failed

pkg/validator/merger

センチネルコードメッセージ
ErrMergeInvalid()schema-merge-input-invalidmerger: invalid merge input

pkg/workspaceconfig

センチネルコードメッセージ
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

センチネルコードメッセージ
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

センチネルコードメッセージ
ErrPositionOutOfRange()position-out-of-rangeposition out of range

別のセンチネルを保持するセンチネル

ErrCacheMetadataInvalid(pkg/sourceresolver/metadata)は、破損したソースアーティファクトのキャッシュスロットを報告します。これは独自の識別子としてではなく ErrFetchIntegrity() のラッパーとして宣言されているため、上の表には現れず、ErrFetchIntegrity() に対するマッチもこれに対して成功します。センチネルを宣言するのではなくラップしているため、関数ではなく値としてエクスポートされています。括弧を付けずに ErrCacheMetadataInvalid としてマッチしてください。その特定の条件を対象にする場合はラッパーに、整合性クラス全体を対象にする場合はラップされたセンチネルにマッチしてください。

1 つのパッケージ内で 2 つ目の名前から到達できるセンチネル

パッケージが 1 つの条件に対して 2 つのアクセサーをエクスポートしている場合(2 つ目は 1 つ目へのフォワードとして宣言されています)、上記の表には宣言元のアクセサーを記載し、フォワードする側の名前は省略しています。両方の名前は同じパッケージからエクスポートされるため、どちらかに到達するインポートはもう一方にも到達します。2 つ目の行を設けると、新たに何もマッチしない名前で 1 つの条件を二重に記載することになります。どちらの名前でマッチしても成功します。フォワードは宣言元のアクセサーが返すのと同じ値を返します。

これはパッケージをまたぐケースとは異なります。別のパッケージから再エクスポートされたセンチネルは、各パッケージの表にそれぞれ行があります。これらのパッケージの 1 つをインポートするマッチャーは、もう一方のパッケージもインポートしない限り、その名前に到達できないためです。一方、単一パッケージ内のフォワードには 2 つ目の行は不要です。1 つのインポートで両方の名前に到達できるためです。

pkg/catalog の ErrDuplicateRecipeIdentity() はこのようなフォワードです。これは ErrDuplicateEntityIdentity() を返し、このパッケージの表にはこちらの名前が記載されています。

照合可能なセンチネルを持たない条件

一部のコンパイル段階は、コンパイラがエクスポートしないパッケージでセンチネルを宣言しているため、errors.Is が参照できるものがなく、それらに対するマッチャーは書けません。これらは表にせずここで説明します。このページの表は、左端の列が参照解決できることを約束するものだからです。

これらの診断は、出力されるエラーテキストと、メッセージをキーとするビュー(特に fatal-halts.md)を通じて完全に届きます。これがそれらを識別するためにサポートされている方法です。

  • トポロジー構築(グラフ構築とサブアグリゲートの平坦化)は、読み込めなかったサブ Aggregate(到達できない Aggregate の URI を示します)、構造的な形がスキーマに一致しない uses: 宣言、ネストの深さの超過、および平坦化後のノード ID の衝突を報告します。ノード ID の衝突とは、2 つのサブ Aggregates が同じノード ID にコンパイルされ、区別するためにどちらかのインスタンス名を変更する必要がある場合です。
  • グラフの確定(Aggregate と Release の両方にわたる Feature のマージ)は、両者の間で一貫しない形で宣言された Feature の型を報告します。
  • 静的解析(セレクターの評価とノード間の型安全性チェック)は、selector: の違反、先に進めないカタログ解決の失敗(到達できないエンティティを示します)、およびポリシーによる拒否を報告します。ポリシーによる拒否とは、ガバナンスの判定ロールに割り当てられたプラグインが、組み立てられたビルドを拒否した場合です。ポリシーによる拒否は、POLICY_ERROR カテゴリ、拒否したプラグインの名前、およびプラグインが提供したルールメッセージを含みます。
  • レンダリング(プロバイダーへのディスパッチとプロバイダーごとのレンダリング)は、不明なプロバイダーを報告します。
  • 組み込みの Wasm ホストローダーは、独自のガードレール用センチネルを発行します。manifest 拒否のガードレール(プラグインが AOT 純粋性ファイアウォールの拒否するランタイムアクセス機能を要求した場合)、ゲストのパニックからの回復、および決定的なプラグイン終了トラップです。これらは、プラグインを実行したとき(たとえば aggrega lint 経由)にユーザー向けの診断に現れます。ホストに対してゲストをテストする Plugin の作成者は、上に挙げた pkg/plugintest を通じて、インポート可能な名前で同じ条件に到達できます。

ポリシーによる拒否に限定してパイプラインを制御するには、センチネルではなく、診断の POLICY_ERROR カテゴリ接頭辞を照合します。このカテゴリはエラーサーフェスの文書化された一部であり、error-translation.md で説明しています。

すべての条件(ショートコード順)

以下の表は逆方向の参照を行います。左の列にショートコードがあり、その横に、そのコードが指す条件と、その条件が出力するテキストがあります。上のセクションで列挙できない条件も含め、aggrega が報告しうるすべての条件を網羅しています。

この広い網羅性は偶然ではなく、この表の目的そのものです。上のセクションはインポート可能な名前をキーとしているため、インポートできないパッケージでのみ宣言され、インポート可能などこからも再エクスポートされていない条件は、その左の列に置くものがありません。この表はショートコードをキーとしており、すべての条件がショートコードを持つため、報告されうる条件でこの表から外れるものはありません。手元のショートコードは、その背後の条件にマッチ可能なアクセサがあるかどうかにかかわらず、ここで解決できます。

この表に載る条件は、コンパイラが実際に報告できるものです。 行はコードに書き写されたものではなく、コードから導出されています。条件がここに現れるのはコンパイラ内の何かがそれを発生させるからであり、左の列のすべてのコードは aggrega が出力しうるものです。これがこの表の約束であり、各行を実際に実行されるチェックとして読めるのはそのためです。

意図的な例外は、報告するコードが存在する前に宣言された条件です。コードと文言があらかじめ固定され、すでに引用した読者のもとで変わることがないようにするためです。そのような条件は、表のすぐ下の注記でその旨を示します。隠されずに列挙されており(手元のコードは常に解決できるべきだからです)、その横の注記は、まだそれを発生させるビルドがないこと、そして発生させるには何が存在する必要があるかを明示しています。

廃止された番号も、表の下の専用の注記に列挙され、恒久的に列挙され続けます。 条件はときに取り下げられます。より広い範囲をカバーする条件に置き換えられた場合や、一度も報告されなかった場合です。その時点でその番号は廃止され、別の条件に割り当てられることはありません。そのため、古いレポートから引用したショートコードは、そのレポートが書かれた時点で指していたものしか指しません。この約束は編集上のものではなく機械的なものです。廃止された番号で宣言された条件は、毎回の実行でコンパイラが入力を読む前に拒否されるため、どのリリースもそれを含むことはできません。これは、有効な 2 つの条件が同じ番号を共有しようとした場合と同種の拒否であり、どちらに該当したかを判別できる文言になっています。廃止されたコードの注記には、廃止時に記録されている場合はそのコードが何を指していたか、そして条件が置き換えられた場合はどのコードが現在その範囲を報告するかが示されます。

番号を再利用しないことが、連番に恒久的な欠番を生む理由でもあり、注記によってその欠番を読み解けるようになっています。番号が欠けていること自体は何の証拠にもなりません。 廃止された番号である可能性もあれば、まだ到達していない番号である可能性も同様にあります。注記はどの番号が廃止されたか、そして記録がある場合はそれぞれ何を指していたかの記録であるため、行にも注記にも解決されないコードは、このコンパイラが一度も発行していないものです。

ショートコードは意図的に不透明です。4 桁の数字はそれ自体では条件について何も語りません。これは、読み上げたり、検索に入力したり、レポートに貼り付けたりできるほど短い識別子の代償です。以下の対応表がそれを使えるものにしています。番号は単一の昇順の連番から一度だけ割り当てられ、以後固定されます。番号はそれが指す条件について何も語りません。したがって、ショートコードは識別子以上のものではありません。その値は分類ではなく、値も、表に見られるかもしれないまとまりも、条件がどこにあるか、何に関するものかを示す手がかりにはなりません。

表にカテゴリ列はありませんが、これは欠落ではありません。カテゴリは、その背後にある条件ではなく、個々の失敗の性質だからです。 一部の条件は構造上 1 つのカテゴリに属します。それ以外の条件では、カテゴリは失敗の対象となるエンティティの種類から決まるため、そうした条件の 1 つが 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 スキーマによって同じ綴りに制約されており、スキーマはエンベロープの検証中にドキュメントを拒否し、問題のキーを行と列とともに報告します。その条件のコードは E0215 です。
  • E0159 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。これは、ドット区切りのセグメントの一部がインスタンス名のパターンに一致しないターゲット参照を指しており、条件が取り下げられる前にこれを報告したビルドはありませんでした。
  • E0166 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。これは、Release の parameters: { $import: … } が指すファイルを読み込めない、またはそのバイト列を解析できない場合を指していました。ドキュメントを生成しないファイルは、パスがどこに書かれていても 1 つの条件であり、そのコードは E0175 です。
  • E0203 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。これは、eval ケイパビリティ上でソース、values オーバーレイ、ワークロード、またはアーティファクトを宣言した FeatureRecipe を指していました。そのケイパビリティは取り下げられており、現在この状態を報告するものはありません。
  • E0206 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。これは、eval ケイパビリティ上でソース、ワークロード、アーティファクト、または values オーバーレイを宣言した Recipe を指していました。そのケイパビリティは取り下げられており、そのいずれも宣言しない Recipe はどのケイパビリティでも E0210 で拒否されます。
  • E0217 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。これは、特定のフィールドに対して報告できないスキーマ検証の失敗を指しており、条件が取り下げられる前にこれを報告したビルドはありませんでした。
  • E0219 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。これは循環する extends チェーンを指しており、スキーママージの結合ステップとは別のチェーン走査によって報告されていました。1 回のチェーン走査がすべての循環チェーンを報告し、そのコードは E0202 です。
  • E0230 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。この番号が指していた条件は取り下げられており、これを報告するビルドはありません。
  • E0231 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。この番号が指していた条件は取り下げられており、これを報告するビルドはありません。
  • E0232 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。この番号が指していた条件は取り下げられており、これを報告するビルドはありません。
  • E0233 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。この番号が指していた条件は取り下げられており、これを報告するビルドはありません。
  • E0234 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。これは、compose プロバイダーでのレンダリング中に報告される、空文字列である Recipe ソースを指していました。現在はすべてのプロバイダーを対象とする 1 つの条件がこれを報告し、そのコードは E0251 です。
  • E0235 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。この番号が指していた条件は撤回されており、これを報告するビルドはありません。
  • E0236 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。この番号が指していた条件は撤回されており、これを報告するビルドはありません。
  • E0237 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。この番号が指していた条件は撤回されており、これを報告するビルドはありません。
  • E0238 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。この番号が指していた条件は撤回されており、これを報告するビルドはありません。
  • E0239 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。この番号が指していた条件は撤回されており、これを報告するビルドはありません。
  • E0240 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。この番号が指していた条件は撤回されており、これを報告するビルドはありません。
  • E0241 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。この番号が指していた条件は撤回されており、これを報告するビルドはありません。
  • E0242 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。これは、Helm プロバイダーでのレンダリング中に報告される、空文字列である Recipe ソースを指していました。現在はすべてのプロバイダーを対象とする 1 つの条件がこれを報告し、そのコードは E0251 です。
  • E0243 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。この番号が指していた条件は撤回されており、これを報告するビルドはありません。
  • E0244 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。この番号が指していた条件は撤回されており、これを報告するビルドはありません。
  • E0245 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。この番号が指していた条件は撤回されており、これを報告するビルドはありません。
  • E0249 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。この番号が指していた条件は撤回されており、これを報告するビルドはありません。
  • E0258 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。この番号が指していた条件は撤回されており、これを報告するビルドはありません。
  • E0322 は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。これは、バウンダリーにアタッチされた Feature がコンポーネントの環境向けに、別のアタッチメントがすでに配信したキーの下で計算した値を指していました。バウンダリーにアタッチされた Feature は、その FeatureRecipe の injectMapping を通じてのみコンポーネントに配信し、別のアタッチメントが配信したキーを書き込むマッピングは 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 に一覧があり、角括弧で囲まれた先頭部分の短いコードは、このページのすべての条件の表で解決できます。

2 つのゲートの方法があるのは、3 つの識別子が届く範囲が異なるためです。Go で書かれたゲートはこれらのパッケージをリンクし、センチネルを照合し、保持している任意のエラーからどちらのコードも読み取れます。コマンドを取り巻く形で書かれたゲートが得られるのは終了ステータスと出力テキストです。そして出力テキストは条件を示します。短いコードが角括弧で囲まれた先頭部分にあるためです。したがって、そのようなゲートはメッセージの文言ではなくその短いコードをキーとし、メッセージをキーとするビューは、すでに手元にある文言からたどるための手段として引き続き使えます。Go からはセンチネルを照合し、コマンドの周囲では短いコードをキーとし、クライアントがそのプロトコルを扱う場合は構造化された診断から説明的なコードを読み取ってください。

異なるパッケージで同じ短い名前で宣言されたセンチネルは別個の条件であり、1 つの条件の 2 通りの綴りではありません。errors.Is はそれらを同一性によって区別するため、一方への照合は他方には一致しません。表で明記されている再エクスポートは例外であり、2 つの名前が実際に一致するケースであるからこそ明記されています。表が記載しているパッケージ内の名前に対して照合し、短い名前単独は曖昧なものとして扱ってください。

ユーザー向けの診断カタログ(ビルドが停止したときに開発者がターミナルで目にするメッセージ)については、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 を参照してください。