エラーセンチネル — 正規リファレンス
コンパイラが発するすべての致命的な停止は 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-retracted | every published version this reference could select has been withdrawn |
ErrAmbiguousImporterPlugin() | ambiguous-importer-plugin | format is advertised by more than one importer plugin |
ErrAmbiguousParserPlugin() | ambiguous-parser-plugin | format is advertised by more than one parser plugin |
ErrAmbiguousProviderPlugin() | ambiguous-provider-plugin | capability is served by more than one provider plugin; add a plugins.providers entry to select one |
ErrAmbiguousTypeMapping() | ambiguous-type-mapping | manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous |
ErrDuplicateEntityIdentity() | duplicate-entity-identity | duplicate entity identity within a single catalog directory |
ErrImporterVersionUnsatisfiable() | importer-version-unsatisfiable | no importer plugin version satisfies the plugins.importer entry's version pin |
ErrManifestImplementsMismatch() | manifest-implements-mismatch | manifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type key |
ErrNameMappingMatchedNothing() | name-mapping-matched-nothing | a Manifest name mapping's key names no component instance or attachment in this build, so the entry binds nothing |
ErrNoImporterForFormat() | no-importer-for-format | no importer plugin advertises the requested format |
ErrNoParserForFormat() | no-parser-for-format | no parser plugin advertises the requested format |
ErrNoRecipeResolved() | no-recipe-resolved | no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type |
ErrProviderBindingCapabilityUnserved() | provider-binding-capability-unserved | plugins.providers entry names a capability no provider-rendering plugin the build reads serves |
ErrProviderBindingUnsatisfied() | provider-binding-unsatisfied | plugins.providers entry names a plugin no provider-rendering plugin serving the capability matches |
ErrProviderVersionUnsatisfiable() | provider-version-unsatisfiable | no provider-rendering plugin version satisfies the recipe's provider version pin |
ErrQualifiedPluginReference() | plugin-reference-must-not-be-registry-qualified | wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path |
ErrUnknownCatalogDocumentKind() | unknown-catalog-document-kind | catalog document declares a kind a catalog does not hold |
ErrUnsatisfiableEntityVersion() | unsatisfiable-entity-version | no catalog version satisfies the referenced version constraint |
ErrUnscopedPluginReference() | plugin-reference-must-be-scoped | wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location |
ErrUnscopedRecipeReference() | recipe-reference-must-be-scoped | recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location |
ErrUnusableSchemaImport() | unusable-schema-import | a schema `$import:` could not be applied |
ErrManifestImplementsMismatch()はpkg/resolver.ErrManifestImplementsMismatch()と同じ値であるため、どちらの名前で照合しても成功します。
pkg/closure
| センチネル | コード | メッセージ |
|---|---|---|
ErrInvalidLibraryRef() | invalid-library-ref | resolve: invalid library reference URI |
ErrMVSConflict() | version-selection-conflict | resolve: minimal version selection conflict — incompatible library version requirements |
ErrNoAggregateLoader() | catalog-cannot-load-sub-aggregate-bodies | resolve: catalog lookup cannot load resolved sub-aggregate bodies |
ErrNoRecipeLoader() | catalog-cannot-load-recipe-bodies | resolve: catalog lookup cannot load resolved recipe and plugin bodies |
ErrSourceTemplateAtLockTime() | source-template-at-lock-time | resolve: source-template evaluation failure at lock time |
ErrSourceTemplateParse() | source-template-not-parsable | resolve: source-template parse error |
ErrSourceTemplateProvidesRef() | source-template-provides-ref | resolve: source-template references .provides (invalid reverse reference) |
ErrSubAggregateDepth() | sub-aggregate-depth | resolve: sub-aggregate inclusion depth exceeded |
ErrUnresolvableURI() | unresolvable-uri | resolve: no entity in the catalog matches this URI |
pkg/compactform
| センチネル | コード | メッセージ |
|---|---|---|
ErrAmbiguousDispatch() | ambiguous-dispatch | compactform: ambiguous dispatch — $mode required |
ErrCircularRef() | reference-cycle | circular reference expansion |
ErrConstraintTypeMismatch() | constraint-type-mismatch | compactform: constraint not valid for declared type |
ErrEscapeContentInvalid() | escape-content-invalid | compactform: $jsonschema content invalid |
ErrHostInLibraryRef() | host-in-library-ref | compactform: cross-document $ref carries a registry host; reference the library by identity |
ErrReferenceUnresolvable() | reference-unresolvable | compactform: $ref unresolvable |
ErrUnknownKeyword() | unknown-keyword | compactform: unknown keyword |
ErrUnresolvedSchemaLibraryRef() | unresolved-schema-library-ref | compactform: cross-document $ref target not found |
ErrCircularRef()はpkg/refcycle.ErrCycle()と同じ値であるため、どちらの名前で照合しても成功します。
pkg/deprecation
| センチネル | コード | メッセージ |
|---|---|---|
ErrDeprecatedEntity() | deprecated-entity | deprecation: build consumes a deprecated entity |
pkg/docscache
| センチネル | コード | メッセージ |
|---|---|---|
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrNotDocsBundle() | not-docs-bundle | docscache: artifact is not a documentation bundle |
ErrPageNotFound() | page-not-found | docscache: page not found in documentation bundle |
ErrFetchNotFound()はpkg/oci.ErrFetchNotFound()と同じ値であるため、どちらの名前で照合しても成功します。
pkg/egress
| センチネル | コード | メッセージ |
|---|---|---|
ErrNoAnswerInTime() | no-answer-in-time | egress: the server did not answer in time |
ErrOfflineEgress() | offline-egress | egress: network access refused because the workspace is offline; remediation: pass `--offline=false` to allow the network for this one run, or clear the top-level `offline` key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run `aggrega pull --release <release>` from a connected environment first to populate the cache |
pkg/externalinputs
| センチネル | コード | メッセージ |
|---|---|---|
ErrAcquisitionDisabled() | acquisition-disabled | externalinputs: acquisition is disabled for unpinned inputs |
ErrDigestMismatch() | digest-mismatch | externalinputs: fetched bytes mismatch the pinned digest |
ErrSchemeNotAllowed() | scheme-not-allowed | externalinputs: URL scheme is not allowed |
ErrStoreCorrupt() | store-corrupt | externalinputs: store blob mismatches its pinned record |
pkg/lockfile
| センチネル | コード | メッセージ |
|---|---|---|
ErrLockfileDrift() | lockfile-drift | lockfile: out of date; it no longer matches what its Release resolves to |
ErrLockfileInvalid() | lockfile-invalid | lockfile: file failed schema validation |
ErrSignatureNotRecorded() | signature-not-recorded | signing: no verified signature is recorded for an artifact that requires one |
pkg/oci
| センチネル | コード | メッセージ |
|---|---|---|
ErrAmbiguousContentLayer() | ambiguous-content-layer | oci: manifest has multiple layers of the expected content media type |
ErrBundleAmbiguousEntityDocument() | bundle-ambiguous-entity-document | oci: published bundle carries more than one entity document |
ErrBundleNoEntityDocument() | bundle-no-entity-document | oci: published bundle carries no entity document |
ErrBundleUnreadable() | bundle-unreadable | oci: published bundle cannot be unpacked |
ErrCacheLocationOutsideCache() | cache-location-outside-cache | a value a cache location is built from would place cached files outside the place it names in the cache |
ErrCachedManifestIntegrity() | cached-manifest-integrity | oci: cached manifest digest mismatch |
ErrFetchIntegrity() | fetch-integrity | oci: content digest mismatch |
ErrFetchNetworkUnreachable() | fetch-network-unreachable | oci: network unreachable |
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrFetchUnauthorized() | fetch-unauthorized | oci: authentication required or failed |
ErrImmutableTagConflict() | immutable-tag-conflict | oci: tag already published with different content |
ErrNoContentLayer() | no-content-layer | oci: manifest has no layer of the expected content media type |
ErrOCILocationCollision() | oci-location-collision | oci: distinct catalog identities map to the same OCI repository location |
ErrPublishedArtifactNotAnEntity() | published-artifact-not-an-entity | oci: published artifact is not an entity document |
ErrReferrerDiscoveryUnavailable() | referrer-discovery-unavailable | oci: referrer discovery could not be completed |
ErrRegistryTooBusy() | registry-too-busy | oci: the registry kept asking to slow down |
ErrRetiredMediaType() | retired-media-type | oci: artifact carries a media type this compiler no longer reads |
ErrSignatureBundleDigestMismatch() | signature-bundle-digest-mismatch | cached signature bundle does not match its recorded digest |
ErrSignatureForAnotherArtifact() | signature-for-another-artifact | signing: the recorded signature was made for a different artifact |
ErrUnknownEntityKind() | unknown-entity-kind | oci: unknown entity kind for mediatype dispatch |
pkg/pathscope
| センチネル | コード | メッセージ |
|---|---|---|
ErrNameWindowsCannotHold() | name-windows-cannot-hold | a name this operation writes holds a path segment Windows cannot hold as written |
pkg/pluginpath
| センチネル | コード | メッセージ |
|---|---|---|
ErrPluginArtifactNotFound() | plugin-artifact-not-found | plugin artifact not found on this machine |
ErrPluginEntityNotFound() | plugin-entity-not-found | plugin reference is not a Plugin entity |
pkg/pluginstrust
| センチネル | コード | メッセージ |
|---|---|---|
ErrVerdictAttachmentNotConfigured() | verdict-attachment-not-configured | a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role |
pkg/plugintest
| センチネル | コード | メッセージ |
|---|---|---|
ErrCommandsMismatch() | wasm-command-set-mismatch | wasm: recorded command mirror does not match plugin describe() |
ErrContractMismatch() | wasm-contract-mismatch | wasm: entity contract claim does not match plugin describe() |
ErrHostFunctionsMismatch() | wasm-host-function-set-mismatch | wasm: stamped host-function record does not match .wasm imports |
ErrRejected() | wasm-manifest-rejected | wasm: plugin rejected by the sandbox |
ErrTypeMismatch() | wasm-plugin-type-mismatch | wasm: declared plugin type does not match plugin describe() |
pkg/readscope
| センチネル | コード | メッセージ |
|---|---|---|
ErrReadLeadsOutOfWorkspace() | read-leads-out-of-workspace | a file this operation reads leads through a link out of the directory it must stay inside |
ErrReferenceLeadsOutOfWorkspace() | reference-leads-out-of-workspace | a reference a document makes to another file leads out of the directory it must stay inside |
pkg/recipepin
| センチネル | コード | メッセージ |
|---|---|---|
ErrEntityNotPinned() | entity-not-pinned | an input the entity reads has no pin recorded for it in the entity.lock beside it |
ErrLocalSourceContentMismatch() | local-source-content-mismatch | the files of the entity's local source do not match the pins recorded for them in entity.lock |
pkg/refcycle
| センチネル | コード | メッセージ |
|---|---|---|
ErrCycle() | reference-cycle | circular reference expansion |
pkg/registrytrust
| センチネル | コード | メッセージ |
|---|---|---|
ErrMalformedTrust() | malformed-trust-policy | registrytrust: advertised trust config is malformed |
ErrNoTrustAdvertised() | no-trust-advertised | registrytrust: registry advertises no trust config |
ErrOfflineRegistrationWithoutTrustPolicy() | offline-registration-without-trust-policy | a registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with `aggrega registry add <host> --identity <identity>=<issuer>` or `--key <public-key-file>` |
pkg/resolver
| センチネル | コード | メッセージ |
|---|---|---|
ErrAnnotationBindingPillarOverlap() | annotation-binding-pillar-overlap | annotation binding declares one path in both pillar lists |
ErrAnnotationBindingTargetUnresolved() | annotation-binding-target-unresolved | annotation binding does not resolve against its target Feature |
ErrAnnotationScalarNotRoutable() | annotation-scalar-not-routable | a scalar annotation value does not route to exactly one path of its binding |
ErrAnnotationSidePillarMismatch() | annotation-side-pillar-mismatch | annotation routes through a pillar its authoring side may not use |
ErrAnnotationSubkeyNotBound() | annotation-subkey-not-bound | annotation subkey is not routed by the annotation's binding |
ErrAnnotationSubkeyNotConforming() | annotation-subkey-not-conforming | annotation subkey does not conform to the target Feature's schema at the routed pillar |
ErrAttachmentInjectValue() | attachment-inject-value | inject entry on an attachment carries `value:`; an attachment delivers the keys its FeatureRecipe publishes, each named with `from:`, and a literal belongs in the component's own inject block |
ErrAttachmentSlotNearMiss() | attachment-slot-near-miss | attachment name is a near miss for a declared slot |
ErrAttachmentSlotShape() | attachment-slot-shape | attachment does not conform to its declared slot shape |
ErrConnectionAttachmentSlotUndeclared() | connection-attachment-slot-undeclared | a connection carries an attachment under a name its socket declares no slot for |
ErrDuplicateBoundaryComponent() | duplicate-boundary-component | component declared in more than one boundary: declare each component in exactly one boundary |
ErrDuplicateTriadIdentity() | duplicate-triad-identity | duplicate Aggregate/Manifest identity (metadata.name) in the Release directory |
ErrFeatureMergeConflict() | feature-merge-conflict | feature merge conflict: reconcile the Aggregate and Release declarations for the feature |
ErrGuardEntityViewInconsistency() | internal-catalog-view-disagreement | the compiler's own views of the catalog disagree |
ErrInheritedBoundaryDirectoryIsLiteral() | inherited-boundary-directory-is-literal | inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to |
ErrInjectDeliveryShape() | inject-delivery-shape | inject delivery: shape must be a list of entries, each `in:` with exactly one of `from:` or `value:` |
ErrInjectEntryAmbiguous() | inject-entry-ambiguous | inject entry carries both `value:` and `from:`; schema requires exactly one |
ErrInjectKeyCollision() | inject-key-collision | duplicate delivery key across inject sources |
ErrInvalidInjectKey() | invalid-inject-key | invalid inject key: the from-key must name a provides key its source publishes |
ErrInvalidParameterRef() | invalid-parameter-ref | invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template |
ErrMalformedRecipeReference() | malformed-recipe-reference | malformed recipe reference in a Manifest mapping value |
ErrManifestCrossBindingPillarCollision() | manifest-cross-binding-pillar-collision | manifest annotation bindings collide on same Feature path+pillar |
ErrManifestImplementsMismatch() | manifest-implements-mismatch | manifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type key |
ErrManifestReservedPrefix() | manifest-reserved-prefix | manifest annotation binding uses reserved prefix |
ErrMisnamedSlotFill() | misnamed-slot-fill | attachment written under a name no slot declares fits a slot its component leaves empty |
ErrMissingRequiredFeature() | missing-required-feature | missing required feature: attach a Feature of the required type to the component |
ErrMissingRequiredSocket() | missing-required-socket | required uses socket not populated |
ErrParameterContractViolation() | parameter-contract-violation | parameter contract violated |
ErrParameterMissing() | parameter-missing | required parameter not supplied |
ErrProvidesKeyNotDeclared() | provides-key-not-declared | Recipe publishes a provides key its Component does not declare |
ErrReleaseChainComposesBothRoutingKeys() | release-chain-composes-both-routing-keys | release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both |
ErrSchemaConformance() | schema-conformance | authored pillar does not conform to its declared schema |
ErrSchemaContractCompileFailure() | schema-contract-compile-failure | declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation |
ErrSelfInjectForbidden() | self-inject-forbidden | self-inject on component without spec.inject allowlist |
ErrTriadRefUnresolvable() | triad-ref-unresolvable | aggregate/manifest reference unresolvable |
ErrUnknownUsesSocket() | unknown-uses-socket | unknown uses socket: name a socket the entity declares in its usesSchema — only a component's own uses block may name one the catalog did not declare |
ErrUnnormalizedRelease() | release-not-in-canonical-form | release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary) |
ErrUnreadParameter() | unread-parameter | declared parameter is read by no reference in the Aggregate |
ErrUsesInjectValue() | uses-inject-value | inject entry on a connection carries `value:`; a connection delivers the target's published keys, each named with `from:` |
ErrUsesSocketNearMiss() | uses-socket-near-miss | uses socket name is a near miss for a declared socket |
ErrVerdictPluginTrustMismatch() | verdict-plugin-trust-mismatch | the digest recorded as trusted for this plugin does not match the digest its cached manifest reports |
ErrYAMLLoad() | document-not-loadable | file load failed: the file could not be read, or its bytes did not parse |
pkg/signing
| センチネル | コード | メッセージ |
|---|---|---|
ErrKeylessLive() | keyless-signing-requires-network | signing: keyless signing requires a live identity provider, Fulcio, and Rekor |
ErrMixedSigningCredentials() | mixed-signing-credentials | signing: the references named together need different signing credentials, so nothing was signed |
ErrNoSignatureFound() | no-signature-found | signing: no signature found for an artifact that requires one |
ErrNoTrustedIdentities() | no-trusted-identities | signing: keyless verification requires at least one trusted identity |
ErrSignatureInvalid() | signature-invalid | signing: signature does not verify |
ErrSignatureVerificationFailed() | signature-verification-failed | signing: signature bundle does not verify |
ErrSigningPolicyRequiresSignature() | signing-policy-requires-signature | signing: signing policy requires a signature for this artifact kind; refusing to push unsigned content |
ErrTrustRootLoad() | trust-root-not-loadable | signing: cannot load pinned trust root |
ErrUnsignedPushRefused() | unsigned-push-refused | signing: registry requires signatures; refusing to push unsigned content |
ErrUnsupportedKey() | unsupported-key | signing: unsupported held-key type |
ErrUntrustedIdentity() | untrusted-identity | signing: signature identity is not trusted for this registry |
pkg/sourcecache
| センチネル | コード | メッセージ |
|---|---|---|
ErrFetchIntegrity() | fetch-integrity | oci: content digest mismatch |
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrFetchIntegrity()はpkg/oci.ErrFetchIntegrity()と同じ値であるため、どちらの名前で照合しても成功します。ErrFetchNotFound()はpkg/oci.ErrFetchNotFound()と同じ値であるため、どちらの名前で照合しても成功します。
pkg/sourcekind
| センチネル | コード | メッセージ |
|---|---|---|
ErrUnknownKind() | unknown-source-kind | no source adapter serves the source kind |
pkg/sourceresolver
| センチネル | コード | メッセージ |
|---|---|---|
ErrFetchIntegrity() | fetch-integrity | oci: content digest mismatch |
ErrFetchNetworkUnreachable() | fetch-network-unreachable | oci: network unreachable |
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrFetchUnauthorized() | fetch-unauthorized | oci: authentication required or failed |
ErrNoAdapterRegistered() | source-adapter-not-registered | no source adapter is registered in this program for the source kind |
ErrFetchIntegrity()はpkg/oci.ErrFetchIntegrity()と同じ値であるため、どちらの名前で照合しても成功します。ErrFetchNetworkUnreachable()はpkg/oci.ErrFetchNetworkUnreachable()と同じ値であるため、どちらの名前で照合しても成功します。ErrFetchNotFound()はpkg/oci.ErrFetchNotFound()と同じ値であるため、どちらの名前で照合しても成功します。ErrFetchUnauthorized()はpkg/oci.ErrFetchUnauthorized()と同じ値であるため、どちらの名前で照合しても成功します。
pkg/sourceresolver/cacheslot
| センチネル | コード | メッセージ |
|---|---|---|
ErrEmptyWorkspaceRoot() | empty-workspace-root | cacheslot: empty workspaceRoot |
pkg/sourceresolver/netrc
| センチネル | コード | メッセージ |
|---|---|---|
ErrNetrcFileUnreadable() | netrc-file-unreadable | the netrc file could not be read |
ErrSourceURLCarriesCredential() | source-url-carries-credential | the source URL carries a credential |
pkg/types
| センチネル | コード | メッセージ |
|---|---|---|
ErrArtifactEntryShape() | artifact-entry-shape | artifacts entry: shape must be a string scalar or {$import: <local-path>} |
ErrArtifactLibraryEntryShape() | artifact-library-entry-shape | artifactlibrary: entry must be a mapping of filename to a string body |
ErrForbiddenKeyword() | forbidden-keyword | schemalibrary: forbidden JSON Schema keyword |
ErrLibraryReferenceWhitespace() | library-reference-whitespace | library reference: a reference to a library entry carries no whitespace or line break |
ErrMalformedVersionPin() | malformed-version-pin | reference carries a malformed version pin |
ErrMappingEntryNotScalar() | mapping-entry-not-scalar | mappinglibrary: entry body must be a string scalar |
ErrOrderedMapDecodeDepthExceeded() | document-nesting-depth-exceeded | a document nests too many levels deep |
ErrParametersShape() | parameters-shape | parameters: shape must be an inline object or {$import: <local-path>} |
ErrTemplateNotFound() | template-not-found | schemalibrary: template not found |
ErrTemplateParamMissing() | template-param-missing | schemalibrary: template parameter missing |
ErrTemplateParamTypeMismatch() | template-param-type-mismatch | schemalibrary: template parameter type mismatch |
ErrValuesMappingShape() | values-mapping-shape | valuesmapping: shape must be a string scalar or {$import: <path-or-library-identity>} |
ErrWellKnownAnnotationScope() | well-known-annotation-scope | wellKnownAnnotations: a key is declared at a scope the provider's contract does not render |
ErrWorkloadEntryNotScalar() | workload-entry-not-scalar | workloadlibrary: entry body must be a string scalar |
ErrWorkloadTemplateShape() | workload-template-shape | workload: shape must be a string scalar or {$import: <path-or-library-identity>} |
pkg/usesedge
| センチネル | コード | メッセージ |
|---|---|---|
ErrDanglingUsesTarget() | dangling-uses-target | uses edge target does not exist |
ErrReleaseEdgeRetarget() | release-edge-retarget | release edge retargets a developer-declared edge |
pkg/validator
| センチネル | コード | メッセージ |
|---|---|---|
ErrAssertionNameCollision() | assertion-name-collision | assertion name declared twice across the extends chain |
ErrCyclicExtension() | cyclic-extension | cyclic extends chain |
ErrDuplicateContainerEnvironmentVariable() | duplicate-container-environment-variable | a container declares one environment variable twice |
ErrEmptySource() | recipe-source-is-empty | recipe source is an empty string, which names neither sourceless mode nor sourced mode |
ErrExtendsChainTooDeep() | extends-chain-too-deep | extends chain exceeds maximum depth |
ErrFeatureRecipeValuesMappingRequiresSource() | feature-recipe-values-mapping-requires-source | FeatureRecipe: valuesMapping requires source |
ErrInheritanceMerge() | extends-merge-failed | inheritance merge failed |
ErrRecipeFilenameCollisionAcrossInputKinds() | recipe-filename-collision-across-input-kinds | filename collision across input kinds: two input-kind blocks produced a file under one output name |
ErrRecipeNoInputKind() | recipe-no-input-kind | Recipe: at least one input kind required |
ErrRecipeOutputComponentLabelCollision() | recipe-output-component-label-collision | recipe output-component-labels constraint: key is also declared in outputLabels |
ErrRecipeOutputLabelReservedNamespace() | recipe-output-label-reserved-namespace | recipe output-labels constraint: key uses a reserved namespace |
ErrRecipeValuesMappingRequiresSource() | recipe-values-mapping-requires-source | Recipe: valuesMapping requires source |
ErrSlotNotReferenceable() | slot-not-referenceable | workload attachment slot is not referenceable |
ErrUnknownSchemaPillar() | unknown-schema-pillar | a schema block declares a key that names no data pillar |
ErrWorkloadFeaturesSchema() | workload-features-schema | workload featuresSchema cross-check failed |
ErrWorkloadValidation() | workload-not-valid | workload validation failed |
pkg/validator/envelope
| センチネル | コード | メッセージ |
|---|---|---|
ErrDuplicatePipelineStepID() | duplicate-pipeline-step-id | a pipeline declares one step id twice |
ErrEntityEnvelope() | entity-envelope-invalid | document envelope validation failed |
ErrRetiredABIVersion() | retired-abi-version | a plugin declares a plugin ABI version this compiler no longer speaks |
ErrRetiredAPIVersion() | retired-api-version | a document declares an API version this compiler no longer reads |
pkg/validator/jsonschema
| センチネル | コード | メッセージ |
|---|---|---|
ErrExtensionEval() | schema-extension-evaluation-failed | validator/jsonschema: x-aggrega extension evaluation failed |
ErrSchemaResolve() | schema-not-resolvable | validator/jsonschema: schema resolution failed |
pkg/validator/merger
| センチネル | コード | メッセージ |
|---|---|---|
ErrMergeInvalid() | schema-merge-input-invalid | merger: invalid merge input |
pkg/workspaceconfig
| センチネル | コード | メッセージ |
|---|---|---|
ErrAmbiguousRegistryAlias() | ambiguous-registry-alias | registry alias matches more than one host |
ErrCapabilityOnCrossCuttingSocket() | capability-on-cross-cutting-socket | a cross-cutting socket is bound by capability but attaches by uri |
ErrColonInProviderBindingCapability() | colon-in-provider-binding-capability | a provider socket binding names a capability containing a colon, which no Recipe can select |
ErrConfigInvalid() | workspace-config-invalid | workspace configuration is invalid |
ErrDuplicateImporterAttachment() | duplicate-importer-attachment | importer is attached by more than one plugins.importer entry |
ErrDuplicateProviderTarget() | duplicate-provider-target | capability is bound to more than one provider plugin |
ErrDuplicateRegistryAlias() | duplicate-registry-alias | registry alias is already used by another host |
ErrGovernanceRoleInvalid() | governance-role-invalid | a governance attachment declares no role or an unknown role |
ErrInertFieldOnProviderSocket() | inert-field-on-provider-socket | a provider socket binding sets a field with no referent on that socket |
pkg/writescope
| センチネル | コード | メッセージ |
|---|---|---|
ErrWriteLeadsOutOfWorkspace() | write-leads-out-of-workspace | a path this operation writes or deletes leads through a link out of the directory it must stay inside |
pkg/yamlpos
| センチネル | コード | メッセージ |
|---|---|---|
ErrPositionOutOfRange() | position-out-of-range | position 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 です。 各カテゴリ、その意味、そして修正箇所がそこに記載されています。カテゴリとショートコードは同じ失敗について異なる問いに答えます。カテゴリは修正すべき対象のサーフェスを特定し、ショートコードはどの条件がビルドを停止させたかを特定します。どちらも他方から導出できないため、それぞれに公開されたリストがあり、名指しすべきオーサリングサーフェスがない失敗でも、ここで調べられるコードを持っています。
| コード | 条件 | メッセージ |
|---|---|---|
E0001 | no-plugin-resolution-configured | cliplugin: no plugin resolver configured |
E0003 | malformed-attachment-requirement | malformed attachment requirement |
E0004 | overridden-annotation | annotation contribution overridden by an explicit value |
E0005 | policy-violation | policy violation |
E0006 | required-slot-unfilled | required attachment slot unfilled |
E0007 | selector-violation | selector violation |
E0008 | slot-selector-unsatisfied | attachment slot selector unsatisfied |
E0009 | pipeline-contract-violation | pipeline step typed-I/O contract violation |
E0010 | pipeline-step-failed | pipeline step failed |
E0011 | pipeline-target-absent | pipeline patch targets a document not present in the set |
E0012 | pipeline-target-opaque | pipeline patch targets an opaque (non-structured) unit |
E0013 | feature-type-mismatch | feature type mismatch between Aggregate and Release |
E0014 | inject-entry-ambiguous | inject entry carries both `value:` and `from:`; schema requires exactly one |
E0015 | uses-inject-forbidden | uses-edge inject dictates a delivery mechanism the socket does not permit |
E0016 | patch-test-operation-failed | jsonpatch: test operation failed |
E0017 | annotation-injection-rejected | annotation-transform plugin output was rejected: an injection targets a component coordinate the host did not supply, or carries a value that is not a string or an object of subkeys |
E0018 | policy-settings-invalid | policy attachment settings do not satisfy the plugin's declared settings schema |
E0019 | endpoint-requires-reference-form | endpoint requires form: reference |
E0020 | invalid-cron-schedule | schedule is not a valid cron expression |
E0021 | persistent-template-requires-stateful-form | persistentTemplate volume requires form: stateful |
E0022 | pipeline-patch-target-not-structured | pipeline PATCH target is not parseable structured YAML/JSON |
E0023 | reference-form-requires-endpoint | form: reference requires an endpoint |
E0024 | schedule-requires-scheduled-form | schedule requires form: scheduled |
E0025 | scheduled-form-requires-schedule | form: scheduled requires a schedule |
E0026 | artifact-content-mismatch | imported artifact content does not match the digest recorded for it in entity.lock |
E0027 | artifact-import-shape | artifacts $import: is not a bare-name artifact-library reference (<Library>#/artifacts/<entry>) |
E0028 | artifact-output-collision | artifacts output filename collision: two artifact outputs carry the same filename |
E0029 | artifact-pillar-not-declared | artifact template references a pillar the Recipe does not declare |
E0030 | artifact-library-entry-not-found | artifact-library import references a bundle not present in the ArtifactLibrary |
E0031 | artifact-library-not-found | artifact-library import references an ArtifactLibrary not present in the catalog |
E0032 | assembled-output-collision | assembled output collision: two contributors write the same output path |
E0033 | authored-assertion-failed | assertion failed |
E0034 | attachment-inject-key-collision | duplicate delivery key across attachment-inject and another inject source |
E0035 | boundary-assembly-not-provided | provider expected to assemble its dispatch group provides no boundary assembler |
E0036 | chart-name-mismatch | merged-path assembly has conflicting assembly-name annotation values |
E0037 | cross-provider-link-unsupported | cross-boundary link between endpoints rendered by different providers is not supported |
E0038 | derived-key-collision | derived name collision: one name is derived more than once in one key space |
E0039 | featurerecipe-template-invalid-field | FeatureRecipe template references a per-component-only field with executionScope: boundary |
E0040 | host-in-library-import | library $import: carries a registry host; reference the library by bare-name identity |
E0041 | instance-id-collision | multiple contributors share an instance ID at the same dispatch path |
E0042 | locals-forward-reference | locals entry references a sibling defined later in the same block |
E0043 | locals-unknown-reference | template references a key the locals block does not declare |
E0044 | mapping-entry-not-found | mapping-library import references an entry not present in the MappingLibrary |
E0045 | mapping-import-shape | valuesMapping $import: is not a bare-name mapping-library reference (<Library>#/mappings/<entry>) |
E0046 | mapping-library-not-found | mapping-library import references a MappingLibrary not present in the catalog |
E0047 | orphan-cross-boundary-link-placeholder | assembled output retains an unresolved cross-boundary link placeholder |
E0048 | path-collision | dispatch path produced multiple provider outputs |
E0049 | path-template-invalid-field | path template references a field not in the documented allowlist |
E0050 | pipeline-host-scope-unavailable | pipeline /host operation from a step with no host component |
E0051 | pipeline-patch-targets-unassembled-fragments | pipeline PATCH targets an assembler provider's pre-assembly fragments |
E0052 | pipeline-target-not-emitted | pipeline PATCH targets a document the node did not emit |
E0053 | plugin-provider-incompatible | pipeline plugin is not compatible with the rendering provider |
E0054 | provider-node-input-invalid | provider rejected node input |
E0055 | provides-contract-unfulfilled | Recipe or FeatureRecipe does not publish a provides key its abstract entity's schema.provides contract declares |
E0056 | provides-evaluation-failed | provides template evaluation failed |
E0057 | provides-self-containment | provides block references a root outside the self-contained set |
E0058 | render-nondeterministic | provider render is not deterministic |
E0059 | self-inject-key-collision | duplicate delivery key across self-inject and uses-inject |
E0060 | template-unknown-root | template references a root the render context does not define |
E0061 | unknown-provider | unknown provider |
E0062 | custom-mechanism-has-no-mapping | custom inject mechanism has no matching key in injectMapping output; add the mechanism's key to the Recipe injectMapping |
E0063 | workload-entry-not-found | workload-library import references an entry not present in the WorkloadLibrary |
E0064 | workload-import-shape | workload $import: is not a bare-name workload-library reference (<Library>#/workloads/<entry>) |
E0065 | workload-library-not-found | workload-library import references a WorkloadLibrary not present in the catalog |
E0066 | dangling-uses-target | uses edge target does not exist |
E0067 | active-toggle-not-a-boolean | active toggle did not resolve to a boolean |
E0068 | sub-aggregate-nesting-depth-exceeded | max sub-aggregate nesting depth exceeded |
E0069 | mutator-patch-rejected | mutator patch rejected |
E0070 | reexport-cycle | re-exported component alias forms a cycle |
E0071 | release-edge-retarget | release edge retargets a developer-declared edge |
E0072 | sub-aggregate-not-loadable | sub-aggregate load failed |
E0073 | sub-aggregate-name-collision | flattened node ID collision: rename one of the colliding instances so their flattened IDs differ |
E0074 | unbound-release-edge-config | release per-edge configuration has no edge to apply to |
E0075 | aggregate-not-in-canonical-form | aggregate reached topology un-normalized (non-empty root components alongside a synthesized default subsystem) |
E0076 | unplaced-sub-module | sub-module placed in no boundary: route it into a boundary under `aggregates`, or name its components there under `components` |
E0077 | uses-target-not-active | uses edge target was pruned because its active toggle resolved to false |
E0078 | wasm-nested-producer-consumption-denied | producer-consumption re-entry denied: a producer reached through the host may not issue a further producer-consumption call |
E0079 | wasm-command-set-mismatch | wasm: recorded command mirror does not match plugin describe() |
E0080 | wasm-contract-mismatch | wasm: entity contract claim does not match plugin describe() |
E0081 | wasm-diagnostic-severity-invalid | wasm: guest plugin returned a diagnostic whose severity the contract does not declare |
E0082 | wasm-guest-error | wasm: guest plugin reported an error |
E0083 | wasm-guest-panic | wasm: guest plugin panicked during call |
E0084 | wasm-host-function-set-mismatch | wasm: stamped host-function record does not match .wasm imports |
E0085 | wasm-manifest-rejected | wasm: plugin rejected by the sandbox |
E0086 | wasm-plugin-exited | wasm: plugin invoked proc_exit |
E0087 | wasm-plugin-type-mismatch | wasm: declared plugin type does not match plugin describe() |
E0088 | wasm-plugin-version-mismatch | wasm: entity metadata.version does not match plugin describe() |
E0089 | all-versions-retracted | every published version this reference could select has been withdrawn |
E0090 | ambiguous-importer-plugin | format is advertised by more than one importer plugin |
E0091 | ambiguous-parser-plugin | format is advertised by more than one parser plugin |
E0092 | ambiguous-provider-plugin | capability is served by more than one provider plugin; add a plugins.providers entry to select one |
E0093 | ambiguous-type-mapping | manifest maps multiple version-distinct keys to the same base type; the type-to-recipe lookup is ambiguous |
E0094 | duplicate-entity-identity | duplicate entity identity within a single catalog directory |
E0095 | malformed-recipe-reference | malformed recipe reference in a Manifest mapping value |
E0096 | manifest-implements-mismatch | manifest mapping entry's recipe spec.implements does not match the mapped component-type / feature-type key |
E0097 | no-importer-for-format | no importer plugin advertises the requested format |
E0098 | no-parser-for-format | no parser plugin advertises the requested format |
E0099 | no-recipe-resolved | no recipe resolved for component/feature instance: add an explicit Manifest mapping for its type |
E0100 | provider-binding-unsatisfied | plugins.providers entry names a plugin no provider-rendering plugin serving the capability matches |
E0101 | provider-version-unsatisfiable | no provider-rendering plugin version satisfies the recipe's provider version pin |
E0102 | plugin-reference-must-not-be-registry-qualified | wasm plugin reference must be the plugin coordinate identity (<pluginType>/<name>:<version>), not a registry-qualified or artifact path |
E0103 | unsatisfiable-entity-version | no catalog version satisfies the referenced version constraint |
E0104 | plugin-reference-must-be-scoped | wasm plugin reference must carry a pluginType scope (<pluginType>/<name>); an empty scope cannot bind to an OCI location |
E0105 | recipe-reference-must-be-scoped | recipe reference must be provider-scoped (<provider>/<name>); an empty provider cannot bind to an OCI location |
E0106 | invalid-library-ref | resolve: invalid library reference URI |
E0107 | version-selection-conflict | resolve: minimal version selection conflict — incompatible library version requirements |
E0108 | catalog-cannot-load-sub-aggregate-bodies | resolve: catalog lookup cannot load resolved sub-aggregate bodies |
E0109 | catalog-cannot-load-recipe-bodies | resolve: catalog lookup cannot load resolved recipe and plugin bodies |
E0110 | source-template-at-lock-time | resolve: source-template evaluation failure at lock time |
E0111 | source-template-not-parsable | resolve: source-template parse error |
E0112 | source-template-provides-ref | resolve: source-template references .provides (invalid reverse reference) |
E0113 | sub-aggregate-depth | resolve: sub-aggregate inclusion depth exceeded |
E0114 | unresolvable-uri | resolve: no entity in the catalog matches this URI |
E0115 | ambiguous-dispatch | compactform: ambiguous dispatch — $mode required |
E0116 | constraint-type-mismatch | compactform: constraint not valid for declared type |
E0117 | escape-content-invalid | compactform: $jsonschema content invalid |
E0118 | host-in-library-ref | compactform: cross-document $ref carries a registry host; reference the library by identity |
E0119 | reference-unresolvable | compactform: $ref unresolvable |
E0120 | unknown-keyword | compactform: unknown keyword |
E0121 | unresolved-schema-library-ref | compactform: cross-document $ref target not found |
E0122 | deprecated-entity | deprecation: build consumes a deprecated entity |
E0123 | not-docs-bundle | docscache: artifact is not a documentation bundle |
E0124 | page-not-found | docscache: page not found in documentation bundle |
E0125 | offline-egress | egress: network access refused because the workspace is offline; remediation: pass `--offline=false` to allow the network for this one run, or clear the top-level `offline` key in the configuration file (or AGGREGA_OFFLINE) to allow it from now on; where the work is a build that needs content the machine does not have, run `aggrega pull --release <release>` from a connected environment first to populate the cache |
E0126 | acquisition-disabled | externalinputs: acquisition is disabled for unpinned inputs |
E0127 | digest-mismatch | externalinputs: fetched bytes mismatch the pinned digest |
E0128 | scheme-not-allowed | externalinputs: URL scheme is not allowed |
E0129 | store-corrupt | externalinputs: store blob mismatches its pinned record |
E0130 | lockfile-drift | lockfile: out of date; it no longer matches what its Release resolves to |
E0131 | lockfile-invalid | lockfile: file failed schema validation |
E0132 | ambiguous-content-layer | oci: manifest has multiple layers of the expected content media type |
E0133 | cached-manifest-integrity | oci: cached manifest digest mismatch |
E0135 | fetch-integrity | oci: content digest mismatch |
E0136 | fetch-network-unreachable | oci: network unreachable |
E0137 | fetch-not-found | oci: artifact not found at remote source |
E0138 | fetch-unauthorized | oci: authentication required or failed |
E0139 | immutable-tag-conflict | oci: tag already published with different content |
E0140 | no-content-layer | oci: manifest has no layer of the expected content media type |
E0141 | oci-location-collision | oci: distinct catalog identities map to the same OCI repository location |
E0142 | referrer-discovery-unavailable | oci: referrer discovery could not be completed |
E0143 | unknown-entity-kind | oci: unknown entity kind for mediatype dispatch |
E0144 | signature-bundle-digest-mismatch | cached signature bundle does not match its recorded digest |
E0145 | plugin-entity-not-found | plugin reference is not a Plugin entity |
E0146 | reference-cycle | circular reference expansion |
E0147 | malformed-trust-policy | registrytrust: advertised trust config is malformed |
E0148 | no-trust-advertised | registrytrust: registry advertises no trust config |
E0149 | attachment-slot-near-miss | attachment name is a near miss for a declared slot |
E0150 | attachment-slot-shape | attachment does not conform to its declared slot shape |
E0151 | duplicate-boundary-component | component declared in more than one boundary: declare each component in exactly one boundary |
E0152 | duplicate-triad-identity | duplicate Aggregate/Manifest identity (metadata.name) in the Release directory |
E0153 | feature-merge-conflict | feature merge conflict: reconcile the Aggregate and Release declarations for the feature |
E0154 | internal-catalog-view-disagreement | the compiler's own views of the catalog disagree |
E0155 | inject-key-collision | duplicate delivery key across inject sources |
E0156 | invalid-inject-key | invalid inject key: the from-key must name a provides key its source publishes |
E0158 | invalid-parameter-ref | invalid parameter reference: check the {{ .parameters.* }} expression names a declared parameter and parses as a Go template |
E0160 | manifest-cross-binding-pillar-collision | manifest annotation bindings collide on same Feature path+pillar |
E0161 | manifest-reserved-prefix | manifest annotation binding uses reserved prefix |
E0162 | missing-required-feature | missing required feature: attach a Feature of the required type to the component |
E0163 | missing-required-socket | required uses socket not populated |
E0164 | parameter-contract-violation | parameter contract violated |
E0165 | parameter-missing | required parameter not supplied |
E0167 | provides-key-not-declared | Recipe publishes a provides key its Component does not declare |
E0168 | schema-conformance | authored pillar does not conform to its declared schema |
E0169 | self-inject-forbidden | self-inject on component without spec.inject allowlist |
E0170 | triad-ref-unresolvable | aggregate/manifest reference unresolvable |
E0171 | unknown-uses-socket | unknown uses socket: name a socket the entity declares in its usesSchema — only a component's own uses block may name one the catalog did not declare |
E0172 | release-not-in-canonical-form | release reached resolve un-normalized (non-empty root components alongside a synthesized default boundary) |
E0173 | unread-parameter | declared parameter is read by no reference in the Aggregate |
E0174 | uses-socket-near-miss | uses socket name is a near miss for a declared socket |
E0175 | document-not-loadable | file load failed: the file could not be read, or its bytes did not parse |
E0176 | keyless-signing-requires-network | signing: keyless signing requires a live identity provider, Fulcio, and Rekor |
E0177 | no-signature-found | signing: no signature found for an artifact that requires one |
E0178 | no-trusted-identities | signing: keyless verification requires at least one trusted identity |
E0179 | signature-invalid | signing: signature does not verify |
E0180 | signature-verification-failed | signing: signature bundle does not verify |
E0181 | signing-policy-requires-signature | signing: signing policy requires a signature for this artifact kind; refusing to push unsigned content |
E0182 | trust-root-not-loadable | signing: cannot load pinned trust root |
E0183 | unsigned-push-refused | signing: registry requires signatures; refusing to push unsigned content |
E0184 | unsupported-key | signing: unsupported held-key type |
E0185 | untrusted-identity | signing: signature identity is not trusted for this registry |
E0186 | unknown-source-kind | no source adapter serves the source kind |
E0187 | empty-workspace-root | cacheslot: empty workspaceRoot |
E0188 | artifact-entry-shape | artifacts entry: shape must be a string scalar or {$import: <local-path>} |
E0189 | artifact-library-entry-shape | artifactlibrary: entry must be a mapping of filename to a string body |
E0190 | forbidden-keyword | schemalibrary: forbidden JSON Schema keyword |
E0191 | mapping-entry-not-scalar | mappinglibrary: entry body must be a string scalar |
E0192 | document-nesting-depth-exceeded | a document nests too many levels deep |
E0193 | parameters-shape | parameters: shape must be an inline object or {$import: <local-path>} |
E0194 | template-not-found | schemalibrary: template not found |
E0195 | template-param-missing | schemalibrary: template parameter missing |
E0196 | template-param-type-mismatch | schemalibrary: template parameter type mismatch |
E0197 | values-mapping-shape | valuesmapping: shape must be a string scalar or {$import: <path-or-library-identity>} |
E0198 | well-known-annotation-scope | wellKnownAnnotations: a key is declared at a scope the provider's contract does not render |
E0199 | workload-entry-not-scalar | workloadlibrary: entry body must be a string scalar |
E0200 | workload-template-shape | workload: shape must be a string scalar or {$import: <path-or-library-identity>} |
E0201 | assertion-name-collision | assertion name declared twice across the extends chain |
E0202 | cyclic-extension | cyclic extends chain |
E0204 | feature-recipe-values-mapping-requires-source | FeatureRecipe: valuesMapping requires source |
E0205 | extends-merge-failed | inheritance merge failed |
E0207 | recipe-output-component-label-collision | recipe output-component-labels constraint: key is also declared in outputLabels |
E0208 | recipe-output-label-reserved-namespace | recipe output-labels constraint: key uses a reserved namespace |
E0209 | recipe-values-mapping-requires-source | Recipe: valuesMapping requires source |
E0210 | recipe-no-input-kind | Recipe: at least one input kind required |
E0211 | recipe-filename-collision-across-input-kinds | filename collision across input kinds: two input-kind blocks produced a file under one output name |
E0212 | slot-not-referenceable | workload attachment slot is not referenceable |
E0213 | workload-features-schema | workload featuresSchema cross-check failed |
E0214 | workload-not-valid | workload validation failed |
E0215 | entity-envelope-invalid | document envelope validation failed |
E0216 | schema-extension-evaluation-failed | validator/jsonschema: x-aggrega extension evaluation failed |
E0218 | schema-not-resolvable | validator/jsonschema: schema resolution failed |
E0220 | extends-chain-too-deep | extends chain exceeds maximum depth |
E0221 | schema-merge-input-invalid | merger: invalid merge input |
E0222 | ambiguous-registry-alias | registry alias matches more than one host |
E0223 | capability-on-cross-cutting-socket | a cross-cutting socket is bound by capability but attaches by uri |
E0224 | workspace-config-invalid | workspace configuration is invalid |
E0225 | duplicate-provider-target | capability is bound to more than one provider plugin |
E0226 | duplicate-registry-alias | registry alias is already used by another host |
E0227 | governance-role-invalid | a governance attachment declares no role or an unknown role |
E0228 | inert-field-on-provider-socket | a provider socket binding sets a field with no referent on that socket |
E0229 | position-out-of-range | position out of range |
E0246 | verdict-plugin-trust-mismatch | the digest recorded as trusted for this plugin does not match the digest its cached manifest reports |
E0247 | verdict-attachment-not-configured | a plugin recorded as trusted for an accept-or-reject verdict is no longer attached at any verdict role |
E0248 | wasm-output-shape | wasm: guest plugin returned an output that is not the shape the socket reads |
E0250 | nest-segment-not-one-directory | provider named a directory for each contributor's own sub-directory that is not a single directory name |
E0251 | recipe-source-is-empty | recipe source is an empty string, which names neither sourceless mode nor sourced mode |
E0252 | artifact-library-file-escapes-key | artifact-library bundle file name does not name a file of its own beneath the artifacts key its output is nested under |
E0253 | annotation-binding-target-unresolved | annotation binding does not resolve against its target Feature |
E0254 | annotation-subkey-not-conforming | annotation subkey does not conform to the target Feature's schema at the routed pillar |
E0255 | annotation-side-pillar-mismatch | annotation routes through a pillar its authoring side may not use |
E0256 | annotation-binding-pillar-overlap | annotation binding declares one path in both pillar lists |
E0257 | schema-contract-compile-failure | declared schema contract could not be compiled into a usable schema, so nothing was validated against it: correct the contract where it is declared, or remove it if the configuration it covers needs no validation |
E0259 | boundary-scope-attachment-not-declared-at-a-boundary | attachment binds a FeatureRecipe with executionScope: boundary and no boundary holding the component declares it |
E0260 | unplaced-component | component placed in no boundary: name it under a boundary's `components`, or place the sub-module that contributes it under `aggregates` |
E0261 | unresolved-boundary-component | boundary names a component the composition does not hold: correct the name, or remove the entry |
E0262 | unusable-component-identity | component identity cannot be the name its emitted resources are stamped with: rename the component |
E0263 | component-identity-target-refuses | the target will not accept a name derived from this component's authored identity: rename the component |
E0264 | provider-refused-every-component-identity | provider guest never accepted a component identity the compiler composed for it |
E0265 | unsupported-input-kind | provider does not support the node's input kind |
E0266 | unusable-schema-import | a schema `$import:` could not be applied |
E0267 | unknown-schema-pillar | a schema block declares a key that names no data pillar |
E0268 | pipeline-patch-unit-not-carved | reassemble names a patched unit token the carve did not produce; a conforming codec carves and reassembles a file under the same tokens |
E0269 | provider-render-duplicate-path | provider guest returned two output files under one path; a conforming guest returns each output path at most once |
E0270 | link-patch-file-not-emitted | link patch names an output file the dispatch group did not emit; a conforming link patch names a file the group's own render returned |
E0271 | pipeline-emit-file-absent | emit_file side effect carries no file; a conforming emit_file side effect carries a file with its path and content |
E0272 | pipeline-side-effect-kind-undefined | side effect declares a kind the plugin contract does not define; a conforming side effect declares emit_file or emit_crd |
E0273 | rendered-name-unavailable | template reads the name the target gives the resources it renders for the node, and this node's provider reports no such name; a conforming template reads a value the node's own provider supplies |
E0274 | verdict-plugin-identity-changed | the plugin identity recorded as trusted no longer matches what this resolution reports |
E0275 | edit-refused-invalid-result | the edit was refused because the resulting document would not be valid, and nothing was written |
E0276 | schema-evolution | the version being published changes the published predecessor in a way the documented evolution rubric objects to |
E0277 | annotation-prefix | an annotation key on the entity uses a prefix the platform reserves |
E0278 | name-shape | the entity's name does not follow the documented name shape for its kind |
E0279 | dynamic-refs | a schema in the entity uses a dynamic reference construct that cross-document reference resolution cannot follow |
E0280 | id-overrides | a schema in the entity declares an identifier of its own, where the platform owns that schema's identity |
E0281 | category-matches-directory | the entity's category label does not match the category directory the entity is filed under |
E0282 | x-aggrega-discouragement | the entity writes an Aggrega schema extension directly into schema content instead of declaring it under usesSchema or featuresSchema |
E0283 | plugin-default-limits | the Plugin entity declares no runtime resource cap of its own, so the platform defaults apply |
E0284 | secret-slot-declares-sensitive | an attachment slot admits only secret material and does not declare that it handles it |
E0285 | provides-declared-by-component | the Recipe publishes a provides key the Component it implements does not declare, so a consumer wiring that key is refused |
E0286 | publish-bump-below-classification | the version bump being published is smaller than the evolution check's classification of the change requires |
E0287 | import-halting-diagnostic | the importer reported a diagnostic that stops the import, so the source was not fully turned into draft authoring files |
E0288 | plugin-cannot-express-input | a plugin has no expression for a construct this build declares |
E0289 | plugin-required-input-unresolved | a plugin could not resolve something it requires to exactly one value |
E0290 | plugin-output-name-collision | two things a plugin produced occupy one name in its output |
E0291 | plugin-value-not-representable | a plugin has no representation for a value it was given |
E0292 | plugin-failure-unclassified | a plugin reported a failure that none of the declared kinds names |
E0293 | wasm-guest-condition-undeclared | wasm: guest plugin named a condition the socket does not declare |
E0294 | subsystem-component-identity-collision | components in different subsystems take the same identity: rename one of them, since a subsystem contributes nothing to a component's identity |
E0295 | library-reference-whitespace | library reference: a reference to a library entry carries no whitespace or line break |
E0296 | release-chain-composes-both-routing-keys | release extends chain composes both named boundaries and top-level components: declare one routing shape across the chain, never both |
E0297 | inherited-boundary-directory-is-literal | inherited boundary directory carries no template variable, so it resolves to the path the extended Release writes to |
E0298 | bundle-no-entity-document | oci: published bundle carries no entity document |
E0299 | bundle-ambiguous-entity-document | oci: published bundle carries more than one entity document |
E0300 | bundle-unreadable | oci: published bundle cannot be unpacked |
E0301 | published-artifact-not-an-entity | oci: published artifact is not an entity document |
E0302 | entity-not-pinned | an input the entity reads has no pin recorded for it in the entity.lock beside it |
E0303 | entity-shares-its-directory | the entity shares its directory with another entity, and an entity of its kind has a directory of its own |
E0304 | content-outside-entity-directory | a path names content outside the entity's own directory |
E0305 | local-source-content-mismatch | the files of the entity's local source do not match the pins recorded for them in entity.lock |
E0306 | plugin-artifact-not-found | plugin artifact not found on this machine |
E0307 | cache-location-outside-cache | a value a cache location is built from would place cached files outside the place it names in the cache |
E0308 | conflicting-features-reach-one-component | a Feature reaches a component alongside a Feature it declares a conflict with |
E0309 | symbolic-link-in-entity-files | a symbolic link sits among the files an entity carries |
E0310 | offline-registration-without-trust-policy | a registry other than the official hub is not registered offline without a trust policy supplied by hand, because the policy it advertises cannot be fetched; register it once while online, or pin its trust by hand with `aggrega registry add <host> --identity <identity>=<issuer>` or `--key <public-key-file>` |
E0311 | malformed-version-pin | reference carries a malformed version pin |
E0312 | colon-in-provider-binding-capability | a provider socket binding names a capability containing a colon, which no Recipe can select |
E0313 | provider-binding-capability-unserved | plugins.providers entry names a capability no provider-rendering plugin the build reads serves |
E0314 | plugin-built-from-uncommitted-changes | plugin was built from a working tree with uncommitted changes, so no commit reproduces the version it reports |
E0315 | connection-attachment-slot-undeclared | a connection carries an attachment under a name its socket declares no slot for |
E0316 | connection-attachment-written-off-its-connection | a Release attachment takes the name of an attachment one of a component's connections carries |
E0317 | release-connection-attachment-untyped | a Release connection attachment names no Feature type, and the type is required for an attachment only the Release makes |
E0318 | attachment-inject-mapping-key-collision | duplicate delivery key across two attachments: an attachment's FeatureRecipe writes a delivery key another attachment already delivered |
E0319 | duplicate-connection-alias | connection alias is already used by another connection of the same component |
E0320 | write-leads-out-of-workspace | a path this operation writes or deletes leads through a link out of the directory it must stay inside |
E0321 | read-leads-out-of-workspace | a file this operation reads leads through a link out of the directory it must stay inside |
E0323 | caller-render-facts-not-declared | template reads its callers' render facts, but the FeatureRecipe does not set readsCallerRenderFacts |
E0324 | reference-leads-out-of-workspace | a reference a document makes to another file leads out of the directory it must stay inside |
E0325 | provider-render-fact-not-list | provider guest reported a render fact whose value is not a list; a conforming guest reports every render fact's value as a JSON array, even with one entry |
E0326 | pipeline-step-reads-caller-render-facts | pipeline step reads its callers' render facts, but a pipeline step does not read the components connecting to its host; it reads only the host's own render facts |
E0327 | index-of-absent-map-key | template indexes a map with a key the map does not hold |
E0328 | misnamed-slot-fill | attachment written under a name no slot declares fits a slot its component leaves empty |
E0329 | connection-credential-matches-target-key | a connection and the target it reaches do not name one key: they write different locators for it, or only one of them names one |
E0330 | mixed-signing-credentials | signing: the references named together need different signing credentials, so nothing was signed |
E0331 | signature-not-recorded | signing: no verified signature is recorded for an artifact that requires one |
E0332 | signature-for-another-artifact | signing: the recorded signature was made for a different artifact |
E0333 | recorded-signature-out-of-date | signing: a recorded signature is not the one a pull would record |
E0334 | omit-matched-nothing | an omits entry left out nothing the source rendered |
E0335 | unsupported-omits | provider does not support omits |
E0336 | omit-report-mismatch | a provider's omitted counts do not match the omits entries it was handed |
E0337 | importer-version-unsatisfiable | no importer plugin version satisfies the plugins.importer entry's version pin |
E0338 | duplicate-importer-attachment | importer is attached by more than one plugins.importer entry |
E0339 | ambiguous-import-format | more than one importer recognises the source |
E0340 | name-windows-cannot-hold | a name this operation writes holds a path segment Windows cannot hold as written |
E0341 | importer-declares-no-file-patterns | the importer serving the source's format declares no file patterns, so it reads one file and cannot read a directory |
E0342 | import-directory-matched-nothing | no file in the directory matches the file patterns the importer serving the source's format declares |
E0343 | import-source-name-collision | a file read from the directory and a file named in the importer's `with.sources` have the same name |
E0344 | windows-unusable-entry | an entry this publication carries cannot be used on Windows |
E0345 | duplicate-container-environment-variable | a container declares one environment variable twice |
E0346 | metrics-credential-annotation-matches-provides | a Component's annotation stating how its metrics authenticate disagrees with whether it declares the provides key saying an instance's metrics need a credential |
E0347 | target-render-facts-not-declared | template reads the render facts of a component its host is wired to, but the FeatureRecipe does not set readsTargetRenderFacts |
E0348 | pipeline-step-reads-target-render-facts | pipeline step reads the render facts of a component its host is wired to, but a pipeline step reads only the host's own render facts |
E0349 | import-target-unbound | no Recipe in the workspace's catalog binds to the capability the import's target names |
E0350 | unrecognised-import-format | no importer recognises the source |
E0351 | unsupported-boundary-artifacts | provider does not support boundary artifacts |
E0352 | boundary-directory-not-beneath-output-root | boundary output directory does not name a directory beneath the output root |
E0353 | boundary-feature-name-not-a-directory | boundary-level Feature instance name is not a directory name |
E0354 | cross-boundary-link-value-not-copied | a template does more than copy a value it reads off a cross-boundary link |
E0355 | inject-delivery-shape | inject delivery: shape must be a list of entries, each `in:` with exactly one of `from:` or `value:` |
E0356 | suspend-requires-scheduled-form | suspend requires form: scheduled |
E0357 | name-mapping-matched-nothing | a Manifest name mapping's key names no component instance or attachment in this build, so the entry binds nothing |
E0358 | uses-target-not-exported | uses edge target names a component its module does not export |
E0359 | source-adapter-not-registered | no source adapter is registered in this program for the source kind |
E0360 | netrc-file-unreadable | the netrc file could not be read |
E0361 | source-url-carries-credential | the source URL carries a credential |
E0362 | uses-inject-value | inject entry on a connection carries `value:`; a connection delivers the target's published keys, each named with `from:` |
E0363 | annotation-subkey-not-bound | annotation subkey is not routed by the annotation's binding |
E0364 | value-template-execution-failed | a value template failed while it ran |
E0365 | boundary-contribution-not-assembled | boundary-level Feature's output is routed to a dispatch path nothing assembles |
E0366 | inject-mapping-output-not-parsable | FeatureRecipe injectMapping output could not be read as a dictionary of deliveries |
E0367 | annotation-scalar-not-routable | a scalar annotation value does not route to exactly one path of its binding |
E0368 | inject-mapping-output-key-not-delivered | FeatureRecipe injectMapping output writes a key no delivery mechanism of the host reads |
E0369 | absent-path-read-and-iterated | template reads a path as a value and iterates it, and the data holds nothing at that path |
E0370 | duplicate-pipeline-step-id | a pipeline declares one step id twice |
E0371 | unknown-catalog-document-kind | catalog document declares a kind a catalog does not hold |
E0372 | attachment-inject-value | inject entry on an attachment carries `value:`; an attachment delivers the keys its FeatureRecipe publishes, each named with `from:`, and a literal belongs in the component's own inject block |
E0373 | retired-api-version | a document declares an API version this compiler no longer reads |
E0374 | retired-abi-version | a plugin declares a plugin ABI version this compiler no longer speaks |
E0375 | retired-media-type | oci: artifact carries a media type this compiler no longer reads |
E0376 | no-answer-in-time | egress: the server did not answer in time |
E0377 | repository-listing-too-long | registry: the repository listing did not end in time |
E0378 | registry-too-busy | oci: the registry kept asking to slow down |
E0002は廃止されています。現在これを報告するものはなく、この番号が別の条件に割り当てられることはありません。これは、グラフの静的コントラクトのチェック中に失敗するカタログ参照(作成されたドキュメントではなくコンパイラ側の不具合)を指していました。現在は、ビルドが解決するコンポーネント型について、その時点で読み込んでいるカタログにエントリがない場合に発生する条件がその状態を報告し、そのコードは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 を参照してください。