Sentinel galat — referensi kanonis
Setiap penghentian fatal yang dikeluarkan kompilator menyebutkan sebuah kondisi, dan setiap kondisi membawa tiga pengenal, karena mengenali sebuah kondisi, mencatatnya, dan mengutipnya adalah tiga tugas yang berbeda. Sentinel adalah nilai Go yang dicocokkan oleh errors.Is, yang diperoleh dengan memanggil aksesor yang diekspor oleh paket yang mendeklarasikannya: pengenal yang dikenali oleh kode Go. Kode adalah string tempat kondisi tersebut didaftarkan: kode menamai kondisi itu sendiri dengan kata-kata, dan kode itulah yang tetap ketika paket-paket Go di sekitarnya berkembang — pengenal yang dicatat oleh sebuah program. Kode pendek adalah huruf E dan empat digit, cukup pendek untuk dibacakan, diketik dalam pencarian, atau ditempelkan ke dalam laporan: pengenal yang dikutip oleh seseorang. Satu kondisi, tiga pengenal — cocokkan sentinel untuk mengenali kondisi dari Go, baca kode ketika Anda perlu mencatat atau menjadikannya kunci, dan telusuri kode pendek pada tabel semua kondisi di bagian bawah halaman ini.
Diagnostik yang ditujukan kepada pengguna (pesan berawalan yang dikatalogkan dalam fatal-halts.md dan error-translation.md) membawa uraian yang ditujukan kepada pengembang; sentinel yang dibungkus adalah nilai yang dicocokkan oleh errors.Is dalam konsumen terprogram.
Halaman ini adalah tampilan katalog yang berkunci sentinel. Pemrogram yang menulis gerbang CI, integrasi IDE, atau kode orkestrasi build yang perlu membedakan jenis galat mencocokkan sentinel yang tercantum di sini dengan predikat standar errors.Is. Penulis yang men-debug build dengan membaca teks galat yang dikeluarkan biasanya memerlukan tampilan yang berkunci pesan — fatal-halts.md untuk galat yang menghentikan build, warnings.md untuk keluaran yang bersifat saran.
Setiap baris dalam tabel di bawah menyebutkan sebuah aksesor — fungsi tanpa argumen, yang diekspor dari paket yang disebutkan tabel, yang mengembalikan sentinel. Mengimpor paket tersebut dan memanggil aksesornya adalah permukaan integrasi yang didukung, itulah sebabnya tabel menuliskan masing-masing beserta tanda kurungnya — pemanggilan itulah yang menghasilkan nilai yang dapat dicocokkan oleh errors.Is, dan nama tanpa tanda kurung adalah sebuah fungsi, bukan galat:
import ( "errors"
"github.com/aggrega-ai/aggrega-cli/pkg/resolver")
if errors.Is(err, resolver.ErrParameterContractViolation()) { // handle parameter contract violations}Ketiga pengenal membawa stabilitasnya masing-masing secara terpisah, dan pemisahan itulah alasan sebuah kondisi memiliki ketiganya. Aksesor yang tercantum di bawah stabil di seluruh rilis patch; penggantian nama atau penghapusan diumumkan dalam entri changelog untuk rilis yang melakukannya, dan penambahan aksesor baru dalam sebuah paket bersifat aditif dan tidak merusak pencocok yang sudah ada. Sebuah kode bersifat tetap begitu kondisinya dipublikasikan, sehingga kode adalah pengenal yang dicatat di mana pun sebuah kondisi harus dinamai secara tahan lama: penggantian nama aksesor tidak memindahkan kode tempat kondisinya didaftarkan, dan kode yang telah Anda catat tetap berlaku melampaui refaktor permukaan Go. Kode pendek adalah yang paling tahan lama dari ketiganya: sebuah nomor diberikan sekali lalu bersifat tetap, dan nomor kondisi yang sudah dipensiunkan tetap pensiun alih-alih diberikan kepada kondisi lain, sehingga kode pendek yang dicatat dalam laporan lama tetap menamai kondisi yang dinamainya saat dicatat. Hal itu ditegakkan, bukan sekadar dimaksudkan — kondisi yang dideklarasikan dengan nomor yang sudah dipensiunkan ditolak sebelum kompilator membaca masukan apa pun, pada setiap eksekusi — dan setiap nomor yang dipensiunkan dipublikasikan di samping nomor yang aktif dalam tabel semua kondisi. Kolom kode di bawah memuat kode, dan kode itulah nilai yang dibaca oleh klien diagnostik terstruktur tanpa menautkan paket-paket ini. Kode dipublikasikan, bukan disimpulkan, karena kode tidak harus mengulang baris tempatnya berada — nama yang diekspor ulang melaporkan kode kondisi yang diteruskannya, dan kode sebuah aturan menamai aturan tersebut, bukan aksesornya. Kolom pesan adalah teks literal yang dirender oleh sentinel; diagnostik yang ditujukan kepada pengguna menempatkan kepala dalam kurung siku dan lokasi sumber di depan teks tersebut. Kepala itu membawa kode pendek kondisi, dengan kategori kemunculan di sampingnya jika kemunculan tersebut memilikinya, seperti dalam [DEVELOPER_ERROR E0007] — sehingga pembaca dapat menelusuri keduanya secara terpisah: kategori (DEVELOPER_ERROR / OPS_ERROR / CATALOG_ERROR / TRANSLATION_ERROR / FETCH_ERROR / POLICY_ERROR / TRUST_ERROR) dijelaskan dalam error-translation.md, dan kode pendek dapat ditelusuri dalam tabel semua kondisi di halaman ini. Jika sebuah plugin memunculkan kondisi tersebut, token kode dikualifikasi oleh plugin yang memunculkannya — [TRANSLATION_ERROR provider/example:1.0.0/E0007] — dan kode pendeknya adalah segmen terakhir; error-translation.md menjelaskan mengapa kualifikasi itu ada dan mengapa segmen terakhirlah yang harus ditelusuri.
Membaca kode suatu kondisi
Kode menamai kondisi dan tidak ada yang lain, dalam kebab-case — parameter-contract-violation, lockfile-drift. Kode tidak membawa prefiks: bukan paket yang mendeklarasikannya, bukan tahap yang memunculkannya, bukan pengelompokan dalam bentuk apa pun. Dengan demikian, kode tetap sama ketika kompiler direorganisasi di sekitarnya, dan kondisi yang dimunculkan di lebih dari satu titik dalam suatu kompilasi tetap memiliki satu nama. Nama setiap kondisi sudah berbeda dengan sendirinya, dan itulah yang membuat prefiks tidak diperlukan; dua kondisi tidak dapat didaftarkan dengan satu kode. Bacalah kode dari suatu error dengan CodeOf, dari github.com/aggrega-ai/aggrega-cli/pkg/errors, yang menelusuri rantai pembungkusan dengan cara yang sama seperti errors.Is, sehingga kode tetap bertahan berapa pun banyaknya frame yang membungkus error dalam perjalanannya kembali kepada Anda. Paket tersebut sendiri bernama errors, sehingga alias impor memisahkannya dari pustaka standar:
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 juga melaporkan apakah ada error dalam rantai yang membawa kode sama sekali; rantai yang tidak membawa kode adalah fakta tentang rantai tersebut, bukan suatu kegagalan. Jika Anda lebih suka mencocokkan antarmukanya sendiri, paket yang sama mengekspornya sebagai CodedError, dan errors.As menemukannya dalam penelusuran yang sama.
Kode berjalan satu arah. Kode adalah apa yang dilaporkan suatu kondisi, tidak pernah apa yang mengidentifikasinya bagi pencocok: menuliskan string tersebut ke dalam kode Anda sendiri hanya memberi Anda sebuah string, dan tidak ada jalan kembali dari string ke nilai yang dicocokkan oleh errors.Is. Cocokkan sentinel untuk mengenali suatu kondisi; baca kodenya untuk mencatatnya.
Kode yang dicetak aggrega di terminal adalah kode pendek, bukan kode ini. Diagnostik penghentian dibuka dengan kepala dalam kurung siku yang membawa kode pendek kondisi, dengan kategori kejadian di sampingnya jika kejadian tersebut memilikinya — [DEVELOPER_ERROR E0007], atau [TRANSLATION_ERROR provider/example:1.0.0/E0007] jika suatu plugin memunculkan kondisi tersebut dan kodenya dikualifikasi oleh plugin yang memunculkannya, atau [E0007] jika kegagalan tersebut tidak memiliki bidang perhatian untuk mengarahkan Anda — lalu lokasi sumber dan teks pesan yang dikatalogkan dalam fatal-halts.md. Kode deskriptif menamai kondisi dengan kata-kata dan terlalu lebar untuk posisi tersebut: pada kondisi terpanjang, kode itu akan memenuhi terminal yang sempit sebelum pesan dimulai, dan itulah satu-satunya alasan adanya pengenal kedua yang ringkas. Jadi, token yang menjadi pegangan ketika Anda hanya memiliki keluaran cetak adalah kode pendek, dan kode tersebut dapat dirujuk pada tabel setiap kondisi lebih lanjut di halaman ini: dari sebuah nomor yang dapat Anda bacakan lewat telepon, Anda sampai pada kondisi, aksesornya, dan teks pesannya. aggrega explain <code> melakukan perujukan tersebut di terminal — perintah ini menerima salah satu kode kondisi dan mencetak kondisi tersebut bersama entri yang mendokumentasikan perbaikan penulisannya, dan dijelaskan dalam aggrega explain. Tampilan berbasis pesan dalam fatal-halts.md tetap menjadi cara untuk bekerja dari kata-kata, bukan dari pengenal.
Tempat kode memang berjalan di luar Go adalah diagnostik terstruktur yang diterbitkan daemon compiler-as-service, sebagai bidang code tersendiri pada setiap entri, bukan sesuatu yang dilipat ke dalam teks pesan — sehingga ekstensi editor, atau klien lain dari protokol tersebut, bercabang berdasarkan apa yang dilaporkan suatu entri tanpa menautkan paket-paket ini dan tanpa mengurai prosa. Satu kunci tersebut membawa kode yang dapat dicocokkan mesin siapa pun yang menetapkannya, dan entri menyebutkan lapisan mana yang memunculkannya. Kode di sana memiliki tiga asal, dan asal ketiga adalah alasan mengapa kode yang dapat Anda cari di halaman ini bukan dengan sendirinya tanda bahwa ada yang gagal:
- Kode kondisi yang dinamai suatu kegagalan, yang dikatalogkan oleh halaman ini.
- Kode kelas dari suatu peringatan tentang output yang dirender —
unsupported-fieldadalah salah satunya, dan warnings.md menjelaskannya. Kode ini ditetapkan di mana pun peringatan tersebut dimunculkan, alih-alih didaftarkan sebagai kondisi, sehingga tidak memiliki baris di sini. - Kode terdaftar dari suatu peringatan tentang dokumen yang ditulis — nama yang berjarak satu suntingan dari nama yang dideklarasikan, parameter yang tidak dibaca apa pun. Temuan semacam itu menamai kondisi dalam bentuk yang sama seperti kegagalan, sehingga kodenya terdaftar dan memiliki baris di halaman ini, dan membaca baris tersebut memberi tahu Anda tentang apa temuan itu.
Jadi, kode yang sama yang akan Anda baca dari suatu penghentian juga dapat sampai kepada Anda dari build yang selesai, dibawa oleh temuan yang tidak mengubah apa pun pada hasilnya. Yang membedakan keduanya adalah hasil yang Anda terima dan lapisan yang dinamai entri — tidak pernah bentuk kode itu sendiri, dan tidak pernah apakah kode tersebut dapat dirujuk di sini. Bidang tersebut dihilangkan jika tidak ada yang menghasilkan entri tersebut yang menetapkan kode: kegagalan yang tidak menamai kondisi milik Aggrega sendiri, dan peringatan yang pemunculnya tidak menetapkan kode. aggrega serve mendokumentasikan bentuk entri, kunci yang menamai lapisan, dan kapan bidang tersebut ada.
Diagnostik terstruktur membawa kedua pengenal suatu kondisi, dan mengetahui mana yang mana adalah perbedaan antara pengenal yang dapat Anda tindak lanjuti dan yang tidak. Kunci code di atas ditujukan untuk program: menggunakan tanda hubung dan menamai kondisi dengan kata-kata, sehingga ekstensi yang bercabang berdasarkan kunci itu terbaca sesuai maknanya, dan kunci itu adalah nilai yang dilaporkan CodeOf di Go. Kunci shortCode di sampingnya ditujukan untuk manusia — huruf E dan empat digit, token yang sama yang dicetak diagnostik penghentian di kepala dalam kurung sikunya. Inilah yang Anda bacakan lewat telepon, ketik ke kotak pencarian, atau tempel ke dalam issue, dan inilah token yang menjadi kunci tabel setiap kondisi.
Tidak ada yang merupakan singkatan dari yang lain, dan tidak ada yang menjadi cadangan bagi yang lain. Cocokkan berdasarkan kode deskriptif; tunjukkan kode pendek kepada pembaca. Permukaan yang hanya menawarkan kode deskriptif akan memberi penulis pengenal yang ditujukan bagi pencocok, dan permukaan yang mencocokkan berdasarkan kode pendek akan mencocokkan berdasarkan nomor yang tidak mengatakan apa pun tentang kondisinya — itulah sebabnya keduanya dibawa, alih-alih memilih salah satunya.
Kunci ketiga, codeDescription, membawa tempat kondisi tersebut diterbitkan, sebagai referensi yang dapat dibuka untuk informasi lebih lanjut tentang diagnostik tersebut. Alamatnya merujuk ke tabel setiap kondisi di halaman ini, sehingga pembaca yang mengikutinya dari editor tiba dengan memegang kode pendek yang menjadi kunci tabel tersebut. Suatu entri membawa kode pendek dan referensi tersebut bersama-sama, atau tidak membawa keduanya: keduanya ada tepat ketika entri menamai kondisi terdaftar — yang memiliki baris di tabel tersebut — dan keduanya tidak ada ketika kode menamai kelas peringatan atau identitas aturan konvensi dari linter milik Anda sendiri yang tidak dideklarasikan Aggrega, karena tidak ada nomor untuk dikutip bagi hal-hal tersebut dan tidak ada apa pun di sini yang menjelaskannya.
Untuk arah sebaliknya — dari kode yang Anda pegang ke kondisi yang dinamainya — tabel-tabel di bawah ini adalah daftar yang diterbitkan. Setiap baris membawa kode di samping aksesor yang menghasilkan kondisi yang sama di Go, sehingga kode yang dibaca dari diagnostik terstruktur merujuk ke nama yang dapat Anda cocokkan dan ke teks yang dirender kondisi tersebut. Tabel-tabel tersebut mencakup kondisi yang aksesornya dapat Anda impor, dan ada dua jenis kode yang berada di luarnya: kode kelas, yang menamai kelas peringatan alih-alih kondisi sehingga tidak memiliki aksesor untuk diletakkan di sampingnya, dan kode yang kondisinya hanya dideklarasikan dalam paket yang tidak dapat Anda impor dan tidak diekspor ulang di mana pun, sehingga tidak ada nama yang dapat dicocokkan untuk diletakkan di sampingnya. Jenis kedua tersebut tetap menamai suatu kondisi, dan kondisi itu tetap memiliki kode pendek — tabel setiap kondisi, lebih lanjut di halaman ini, dikunci berdasarkan kode pendek alih-alih nama yang dapat diimpor, sehingga mencakup kondisi-kondisi tersebut juga.
Permukaan yang dapat dicocokkan, menurut paket yang mendeklarasikan
Setiap bagian di bawah ini adalah satu paket yang dapat Anda impor. Judulnya adalah path paket relatif terhadap path modul github.com/aggrega-ai/aggrega-cli, sehingga bagian berjudul pkg/resolver diimpor sebagai github.com/aggrega-ai/aggrega-cli/pkg/resolver.
Entri dikelompokkan menurut paket yang mendeklarasikan sentinel, karena paket itulah yang diimpor oleh pencocok. Di mana dalam build kondisi tersebut dimunculkan adalah pertanyaan terpisah, dan halaman ini sengaja tidak menjawabnya: satu sentinel sering dimunculkan dari beberapa tempat, dan beberapa sentinel hanya dimunculkan dari kode yang tidak diekspor oleh modul, sehingga tidak ada jawaban per entri yang akan benar untuk setiap baris. Tampilan yang berkunci pesan menjawab pertanyaan kapan-dalam-build dengan istilah yang dapat Anda amati — terutama fatal-halts.md.
Beberapa nama muncul di lebih dari satu paket. Nama-nama tersebut adalah ekspor ulang dari satu nilai bersama, bukan dua kondisi, sehingga mencocokkan nama mana pun akan berhasil; tabel menyatakannya di mana kedua nama dapat diimpor. Kedua baris membawa kode yang sama, yang merupakan fakta yang sama yang dinyatakan pada pengenal yang dipegang klien di luar Go: satu kondisi, satu kode, berapa pun banyaknya nama yang mencapainya.
pkg/catalog
| Sentinel | Kode | Pesan |
|---|---|---|
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()adalah nilai yang sama denganpkg/resolver.ErrManifestImplementsMismatch(), sehingga pencocokan terhadap nama mana pun akan berhasil.
pkg/closure
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
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()adalah nilai yang sama denganpkg/refcycle.ErrCycle(), sehingga pencocokan terhadap nama mana pun akan berhasil.
pkg/deprecation
| Sentinel | Kode | Pesan |
|---|---|---|
ErrDeprecatedEntity() | deprecated-entity | deprecation: build consumes a deprecated entity |
pkg/docscache
| Sentinel | Kode | Pesan |
|---|---|---|
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()adalah nilai yang sama denganpkg/oci.ErrFetchNotFound(), sehingga pencocokan terhadap nama mana pun akan berhasil.
pkg/egress
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
ErrNameWindowsCannotHold() | name-windows-cannot-hold | a name this operation writes holds a path segment Windows cannot hold as written |
pkg/pluginpath
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
ErrCycle() | reference-cycle | circular reference expansion |
pkg/registrytrust
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
ErrFetchIntegrity() | fetch-integrity | oci: content digest mismatch |
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrFetchIntegrity()adalah nilai yang sama denganpkg/oci.ErrFetchIntegrity(), sehingga pencocokan terhadap nama mana pun akan berhasil.ErrFetchNotFound()adalah nilai yang sama denganpkg/oci.ErrFetchNotFound(), sehingga pencocokan terhadap nama mana pun akan berhasil.
pkg/sourcekind
| Sentinel | Kode | Pesan |
|---|---|---|
ErrUnknownKind() | unknown-source-kind | no source adapter serves the source kind |
pkg/sourceresolver
| Sentinel | Kode | Pesan |
|---|---|---|
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()adalah nilai yang sama denganpkg/oci.ErrFetchIntegrity(), sehingga pencocokan terhadap nama mana pun akan berhasil.ErrFetchNetworkUnreachable()adalah nilai yang sama denganpkg/oci.ErrFetchNetworkUnreachable(), sehingga pencocokan terhadap nama mana pun akan berhasil.ErrFetchNotFound()adalah nilai yang sama denganpkg/oci.ErrFetchNotFound(), sehingga pencocokan terhadap nama mana pun akan berhasil.ErrFetchUnauthorized()adalah nilai yang sama denganpkg/oci.ErrFetchUnauthorized(), sehingga pencocokan terhadap nama mana pun akan berhasil.
pkg/sourceresolver/cacheslot
| Sentinel | Kode | Pesan |
|---|---|---|
ErrEmptyWorkspaceRoot() | empty-workspace-root | cacheslot: empty workspaceRoot |
pkg/sourceresolver/netrc
| Sentinel | Kode | Pesan |
|---|---|---|
ErrNetrcFileUnreadable() | netrc-file-unreadable | the netrc file could not be read |
ErrSourceURLCarriesCredential() | source-url-carries-credential | the source URL carries a credential |
pkg/types
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
ErrDanglingUsesTarget() | dangling-uses-target | uses edge target does not exist |
ErrReleaseEdgeRetarget() | release-edge-retarget | release edge retargets a developer-declared edge |
pkg/validator
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
ErrExtensionEval() | schema-extension-evaluation-failed | validator/jsonschema: x-aggrega extension evaluation failed |
ErrSchemaResolve() | schema-not-resolvable | validator/jsonschema: schema resolution failed |
pkg/validator/merger
| Sentinel | Kode | Pesan |
|---|---|---|
ErrMergeInvalid() | schema-merge-input-invalid | merger: invalid merge input |
pkg/workspaceconfig
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
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
| Sentinel | Kode | Pesan |
|---|---|---|
ErrPositionOutOfRange() | position-out-of-range | position out of range |
Sentinel yang membawa sentinel lain
ErrCacheMetadataInvalid (pkg/sourceresolver/metadata) melaporkan slot cache artefak sumber yang rusak. Sentinel ini dideklarasikan sebagai pembungkus di sekitar ErrFetchIntegrity(), bukan sebagai identitas tersendiri, sehingga tidak muncul dalam tabel di atas dan pencocokan terhadap ErrFetchIntegrity() juga berhasil untuknya. Karena sentinel ini membungkus sebuah sentinel alih-alih mendeklarasikannya, sentinel ini diekspor sebagai nilai, bukan sebagai fungsi: cocokkan sebagai ErrCacheMetadataInvalid, tanpa tanda kurung. Cocokkan pembungkusnya jika Anda menginginkan kondisi spesifik tersebut, dan sentinel yang dibungkus jika Anda menginginkan seluruh kelas integritas.
Sentinel yang dapat dijangkau dengan nama kedua dalam satu paket
Jika sebuah paket mengekspor dua accessor untuk satu kondisi — yang kedua dideklarasikan sebagai penerusan ke yang pertama — tabel di atas memuat accessor yang mendeklarasikan dan tidak mencantumkan nama penerusnya. Kedua nama diekspor dari paket yang sama, sehingga impor yang menjangkau salah satunya sudah menjangkau yang lain, dan baris kedua akan mencantumkan satu kondisi dua kali dengan nama yang tidak mencocokkan hal baru apa pun. Pencocokan dengan nama mana pun berhasil: penerusan mengembalikan nilai yang sama dengan yang dikembalikan oleh accessor yang mendeklarasikan.
Ini bukan kasus lintas paket. Sentinel yang diekspor ulang dari paket lain memiliki baris di tabel setiap paket, karena pencocok yang mengimpor salah satu paket tersebut tidak dapat menjangkau nama milik paket lainnya tanpa juga mengimpor paket itu; penerusan di dalam satu paket tidak memerlukan baris kedua, karena satu impor menjangkau kedua nama.
ErrDuplicateRecipeIdentity() di pkg/catalog adalah penerusan semacam itu: fungsi ini mengembalikan ErrDuplicateEntityIdentity(), yaitu nama yang dimuat oleh tabel untuk paket tersebut.
Kondisi tanpa sentinel yang dapat dicocokkan
Beberapa tahap kompilasi mendeklarasikan sentinel-nya dalam paket yang tidak diekspor oleh compiler, sehingga tidak ada yang dapat dirujuk oleh errors.Is dan tidak ada pencocok yang dapat ditulis terhadapnya. Kondisi-kondisi tersebut dijelaskan di sini alih-alih ditabulasikan, karena tabel di halaman ini merupakan janji bahwa kolom kirinya dapat didereferensikan.
Diagnostiknya sampai kepada Anda secara lengkap melalui teks error yang dikeluarkan dan melalui tampilan yang berkunci pesan — khususnya fatal-halts.md — yang merupakan cara yang didukung untuk mengenalinya:
- Konstruksi topologi (konstruksi graf dan perataan sub-aggregate) melaporkan sub-Aggregate yang tidak dapat dimuat, dengan menyebutkan URI Aggregate yang tidak dapat dijangkau; deklarasi
uses:yang bentuk strukturalnya tidak sesuai dengan skema; kedalaman penyarangan yang terlampaui; dan tabrakan ID node hasil perataan, yaitu ketika dua sub-Aggregates dikompilasi ke ID node yang sama dan satu nama instans harus diganti untuk membedakannya. - Finalisasi graf (penggabungan Feature di seluruh permukaan Aggregate dan Release) melaporkan tipe Feature yang dideklarasikan secara tidak konsisten di antara keduanya.
- Analisis statis (evaluasi selector dan pemeriksaan keamanan tipe lintas node) melaporkan pelanggaran
selector:; kegagalan resolusi katalog yang tidak dapat dilewatinya, dengan menyebutkan entitas yang tidak dapat dijangkau; dan penolakan kebijakan, yaitu ketika plugin yang dipasang pada peran putusan tata kelola menolak build yang telah dirakit. Penolakan kebijakan membawa kategoriPOLICY_ERROR, nama plugin yang menolak, dan pesan aturan yang diberikan oleh plugin tersebut. - Rendering (dispatch provider dan rendering per provider) melaporkan provider yang tidak dikenal.
- Pemuat host Wasm tertanam memancarkan sentinel pengamannya sendiri — pengaman penolakan manifest (sebuah plugin meminta kapabilitas akses runtime yang ditolak oleh firewall kemurnian AOT), pemulihan panic guest, dan trap keluar plugin yang deterministik. Kondisi ini muncul dalam diagnostik yang ditampilkan kepada pengguna saat menjalankan plugin (misalnya melalui
aggrega lint). Plugin authors yang menguji guest terhadap host menjangkau kondisi yang sama berdasarkan nama yang dapat diimpor melaluipkg/plugintest, yang tercantum di atas.
Untuk menahan pipeline khusus pada penolakan kebijakan, cocokkan prefiks kategori POLICY_ERROR dalam diagnostik alih-alih sentinel; kategori tersebut merupakan bagian terdokumentasi dari permukaan error, yang dijelaskan dalam error-translation.md.
Setiap kondisi, menurut kode pendek
Tabel di bawah menjalankan pencarian ke arah sebaliknya: kode pendek di kolom kiri, dan di sampingnya kondisi yang dinamai oleh kode tersebut serta teks yang dihasilkan kondisi itu. Tabel ini mencakup setiap kondisi yang dapat dilaporkan oleh aggrega, termasuk kondisi yang tidak dapat dicantumkan oleh bagian-bagian di atas.
Cakupan yang lebih luas itu adalah tujuan tabel ini, bukan kebetulan. Bagian-bagian di atas berkunci pada nama yang dapat Anda impor, sehingga kondisi yang hanya dideklarasikan dalam paket yang tidak dapat Anda impor — dan tidak diekspor ulang di mana pun yang dapat Anda impor — tidak memiliki apa pun untuk dimasukkan ke kolom kirinya. Tabel ini berkunci pada kode pendek, dan setiap kondisi memilikinya, sehingga tidak ada kondisi yang dapat dilaporkan berada di luarnya. Kode pendek yang Anda pegang dapat ditemukan di sini, baik kondisi di baliknya juga memiliki aksesor yang dapat Anda cocokkan maupun tidak.
Yang membuat sebuah kondisi layak masuk tabel ini adalah bahwa compiler benar-benar dapat melaporkannya. Baris-barisnya diturunkan dari kode, bukan disalin ke dalamnya: sebuah kondisi muncul di sini karena ada sesuatu di compiler yang memunculkannya, sehingga setiap kode di kolom kiri adalah kode yang dapat dicetak oleh aggrega. Itulah janji tabel ini, dan itulah yang memungkinkan Anda membaca sebuah baris sebagai pemeriksaan yang benar-benar dijalankan.
Pengecualian yang disengaja adalah kondisi yang dideklarasikan sebelum kode yang melaporkannya ada, agar kode dan susunan katanya ditetapkan sejak awal dan tidak pernah berubah bagi pembaca yang sudah mengutipnya. Kondisi seperti itu menyatakannya dalam catatan tepat di bawah tabel. Kondisi tersebut dicantumkan, bukan disembunyikan — kode yang Anda pegang harus selalu dapat ditemukan — dan catatan di sampingnya memberi tahu Anda dengan jelas bahwa belum ada build yang memunculkannya, serta apa yang harus ada sebelum ada build yang memunculkannya.
Nomor yang dipensiunkan juga dicantumkan, dalam kumpulan catatannya sendiri di bawah tabel, dan tetap tercantum secara permanen. Sesekali sebuah kondisi ditarik — digantikan oleh kondisi yang mencakup lebih luas, atau tidak pernah ada yang melaporkannya — dan sejak saat itu nomornya dipensiunkan: nomor itu tidak pernah diberikan ke kondisi lain, sehingga kode pendek yang Anda kutip dari laporan lama hanya dapat menamai apa yang dinamainya saat laporan itu ditulis. Janji itu bersifat mekanis, bukan editorial. Kondisi yang dideklarasikan dengan nomor yang dipensiunkan ditolak sebelum compiler membaca masukan apa pun, pada setiap eksekusi, sehingga tidak ada rilis yang dapat memuatnya — jenis penolakan yang sama dengan yang akan dihadapi nomor yang coba digunakan bersama oleh dua kondisi aktif, dengan susunan kata yang memungkinkan Anda mengetahui mana dari keduanya yang Anda alami. Catatan untuk kode yang dipensiunkan memberi tahu Anda, jika pemensiunannya mencatatnya, apa yang dinamai kode itu dan, jika kondisinya digantikan, kode mana yang kini melaporkan cakupan tersebut.
Tidak pernah menggunakan ulang nomor juga yang membuat urutannya memiliki celah permanen, dan catatan-catatan itulah yang membuat celah tersebut dapat dibaca. Nomor yang hilang, dengan sendirinya, bukan bukti apa pun: nomor itu mungkin dipensiunkan, dan mungkin juga belum pernah dicapai. Catatan-catatan itu adalah rekaman nomor mana yang dipensiunkan dan, jika tercatat, apa yang dinamai masing-masing, sehingga kode yang tidak ditemukan di baris maupun di catatan adalah kode yang tidak pernah diterbitkan oleh compiler ini.
Kode pendek sengaja dibuat buram: empat digit tidak mengatakan apa pun tentang sebuah kondisi dengan sendirinya, yang merupakan harga dari pengenal yang cukup pendek untuk dibacakan, diketik ke pencarian, atau ditempelkan ke laporan. Korespondensi di bawah inilah yang membuatnya dapat digunakan. Sebuah nomor diberikan satu kali, dari satu urutan menaik, dan tetap sejak saat itu; nomor itu tidak mengatakan apa pun tentang kondisi yang dinamainya. Jadi kode pendek adalah pengenal dan tidak lebih — nilainya bukan klasifikasi, dan baik kode itu maupun pengelompokan apa pun yang mungkin Anda perhatikan di tabel bukan petunjuk tentang di mana sebuah kondisi berada atau tentang apa kondisi itu.
Tabel ini tidak memiliki kolom kategori, dan itu bukan kelalaian: kategori adalah sifat dari kegagalan tertentu, bukan dari kondisi di baliknya. Sebagian kondisi termasuk dalam satu kategori secara konstruksi. Untuk yang lain, kategorinya mengikuti jenis entitas yang menjadi pokok kegagalan, sehingga satu kondisi seperti itu yang dilaporkan sekali terhadap sebuah Aggregate dan sekali terhadap sebuah Release memiliki kategori yang berbeda setiap kali — dan satu nilai yang ditulis di samping kondisi di sini akan salah untuk setiap kondisi jenis kedua tersebut.
Kategori-kategori diajarkan di error-translation.md — masing-masing, artinya, dan di mana perbaikannya berada. Kategori dan kode pendek menjawab pertanyaan yang berbeda tentang kegagalan yang sama: kategori mengidentifikasi permukaan tempat perbaikan itu berada, dan kode pendek mengidentifikasi kondisi mana yang menghentikan build. Keduanya tidak dapat diturunkan satu dari yang lain, itulah sebabnya masing-masing memiliki daftar terbitnya sendiri — dan mengapa kegagalan yang tidak memiliki permukaan penulisan untuk disebut tetap memiliki kode yang dapat Anda cari di sini.
| Kode | Kondisi | Pesan |
|---|---|---|
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 |
E0002dipensiunkan: tidak ada yang melaporkannya sekarang, dan nomor ini tidak pernah diberikan ke kondisi lain. Kode ini menamai pencarian katalog yang gagal saat kontrak statis graf diperiksa — kesalahan pada compiler, bukan pada dokumen yang ditulis — dan kondisi yang dimunculkan ketika sebuah build me-resolve tipe komponen yang tidak memiliki entri di katalog yang dibacanya kini melaporkan keadaan tersebut, dan kodenya adalahE0154.E0134dipensiunkan: tidak ada yang melaporkannya sekarang, dan nomor ini tidak pernah diberikan ke kondisi lain. Kode ini menamai entitas yang dapat dipublikasikan yang direktorinya tidak dinamai sesuai versi yang dideklarasikan entitas tersebut; publikasi tidak menilai nama direktori, dan kondisi yang dimunculkan ketika sebuah entitas berbagi direktori dengan entitas lain padahal jenisnya memiliki direktori sendiri adalahE0303.E0157dipensiunkan: tidak ada yang melaporkannya sekarang, dan nomor ini tidak pernah diberikan ke kondisi lain. Kode ini menamai kunci Aggregate — nama instans komponen, fitur, subsistem, atau modul bersarang — yang tidak cocok dengan pola nama yang ditulis. Setiap permukaan kunci tersebut dibatasi pada ejaan yang sama oleh skema Aggregate, yang menolak dokumen saat memvalidasi amplopnya dan melaporkan kunci yang bermasalah beserta baris dan kolomnya; kode kondisi tersebut adalahE0215.E0159dipensiunkan: tidak ada yang melaporkannya sekarang, dan nomor ini tidak pernah diberikan ke kondisi lain. Kode ini menamai referensi target yang segmen-segmennya yang dipisahkan titik tidak semuanya cocok dengan pola nama instans, dan tidak ada build yang melaporkannya sebelum kondisi tersebut ditarik.E0166dipensiunkan: tidak ada yang melaporkannya sekarang, dan nomor ini tidak pernah diberikan ke kondisi lain. Kode ini menamai file yang dirujuk olehparameters: { $import: … }milik sebuah Release ketika file itu tidak dapat dibaca atau byte-nya tidak dapat di-parse; file yang tidak menghasilkan dokumen adalah satu kondisi di mana pun path-nya ditulis, dan kodenya adalahE0175.E0203dipensiunkan: tidak ada yang melaporkannya sekarang, dan nomor ini tidak pernah diberikan ke kondisi lain. Kode ini menamai FeatureRecipe pada kapabilitasevalyang mendeklarasikan sumber, overlay values, workload, atau artefak; kapabilitas itu telah ditarik, dan kini tidak ada yang melaporkan keadaan ini.E0206dipensiunkan: tidak ada yang melaporkannya sekarang, dan nomor ini tidak pernah diberikan ke kondisi lain. Kode ini menamai Recipe pada kapabilitasevalyang mendeklarasikan sumber, workload, artefak, atau overlay values; kapabilitas itu telah ditarik, dan Recipe yang tidak mendeklarasikan satu pun dari itu ditolak pada setiap kapabilitas denganE0210.E0217dipensiunkan: tidak ada yang melaporkannya sekarang, dan nomor ini tidak pernah diberikan ke kondisi lain. Kode ini menamai kegagalan validasi skema yang tidak dapat dilaporkan terhadap field tertentu, dan tidak ada build yang melaporkannya sebelum kondisi tersebut ditarik.E0219dipensiunkan: tidak ada yang melaporkannya sekarang, dan nomor ini tidak pernah diberikan ke kondisi lain. Kode ini menamai rantaiextendsyang siklik, yang dilaporkan oleh penelusuran rantai yang terpisah dari langkah penggabungan dalam penggabungan skema; satu penelusuran rantai melaporkan setiap rantai siklik, dan kodenya adalahE0202.E0230dipensiunkan: tidak ada yang melaporkannya sekarang, dan nomor ini tidak pernah diberikan ke kondisi lain. Kondisi yang dinamai nomor ini telah ditarik, dan tidak ada build yang melaporkannya.E0231dipensiunkan: tidak ada yang melaporkannya sekarang, dan nomor ini tidak pernah diberikan ke kondisi lain. Kondisi yang dinamai nomor ini telah ditarik, dan tidak ada build yang melaporkannya.E0232dipensiunkan: tidak ada yang melaporkannya sekarang, dan nomor ini tidak pernah diberikan ke kondisi lain. Kondisi yang dinamai nomor ini telah ditarik, dan tidak ada build yang melaporkannya.E0233dipensiunkan: tidak ada yang melaporkannya sekarang, dan nomor ini tidak pernah diberikan ke kondisi lain. Kondisi yang dinamai nomor ini telah ditarik, dan tidak ada build yang melaporkannya.E0234sudah dipensiunkan: tidak ada lagi yang melaporkannya, dan nomor tersebut tidak pernah diberikan kepada kondisi lain. Nomor ini menamai sumber Recipe berupa string kosong, yang dilaporkan saat merender melalui provider compose; kini satu kondisi yang mencakup setiap provider melaporkan hal itu, dan kodenya adalahE0251.E0235sudah dipensiunkan: tidak ada lagi yang melaporkannya, dan nomor tersebut tidak pernah diberikan kepada kondisi lain. Kondisi yang dinamai nomor ini telah ditarik, dan tidak ada build yang melaporkannya.E0236sudah dipensiunkan: tidak ada lagi yang melaporkannya, dan nomor tersebut tidak pernah diberikan kepada kondisi lain. Kondisi yang dinamai nomor ini telah ditarik, dan tidak ada build yang melaporkannya.E0237sudah dipensiunkan: tidak ada lagi yang melaporkannya, dan nomor tersebut tidak pernah diberikan kepada kondisi lain. Kondisi yang dinamai nomor ini telah ditarik, dan tidak ada build yang melaporkannya.E0238sudah dipensiunkan: tidak ada lagi yang melaporkannya, dan nomor tersebut tidak pernah diberikan kepada kondisi lain. Kondisi yang dinamai nomor ini telah ditarik, dan tidak ada build yang melaporkannya.E0239sudah dipensiunkan: tidak ada lagi yang melaporkannya, dan nomor tersebut tidak pernah diberikan kepada kondisi lain. Kondisi yang dinamai nomor ini telah ditarik, dan tidak ada build yang melaporkannya.E0240sudah dipensiunkan: tidak ada lagi yang melaporkannya, dan nomor tersebut tidak pernah diberikan kepada kondisi lain. Kondisi yang dinamai nomor ini telah ditarik, dan tidak ada build yang melaporkannya.E0241sudah dipensiunkan: tidak ada lagi yang melaporkannya, dan nomor tersebut tidak pernah diberikan kepada kondisi lain. Kondisi yang dinamai nomor ini telah ditarik, dan tidak ada build yang melaporkannya.E0242sudah dipensiunkan: tidak ada lagi yang melaporkannya, dan nomor tersebut tidak pernah diberikan kepada kondisi lain. Nomor ini menamai sumber Recipe berupa string kosong, yang dilaporkan saat merender melalui provider Helm; kini satu kondisi yang mencakup setiap provider melaporkan hal itu, dan kodenya adalahE0251.E0243sudah dipensiunkan: tidak ada lagi yang melaporkannya, dan nomor tersebut tidak pernah diberikan kepada kondisi lain. Kondisi yang dinamai nomor ini telah ditarik, dan tidak ada build yang melaporkannya.E0244sudah dipensiunkan: tidak ada lagi yang melaporkannya, dan nomor tersebut tidak pernah diberikan kepada kondisi lain. Kondisi yang dinamai nomor ini telah ditarik, dan tidak ada build yang melaporkannya.E0245sudah dipensiunkan: tidak ada lagi yang melaporkannya, dan nomor tersebut tidak pernah diberikan kepada kondisi lain. Kondisi yang dinamai nomor ini telah ditarik, dan tidak ada build yang melaporkannya.E0249sudah dipensiunkan: tidak ada lagi yang melaporkannya, dan nomor tersebut tidak pernah diberikan kepada kondisi lain. Kondisi yang dinamai nomor ini telah ditarik, dan tidak ada build yang melaporkannya.E0258sudah dipensiunkan: tidak ada lagi yang melaporkannya, dan nomor tersebut tidak pernah diberikan kepada kondisi lain. Kondisi yang dinamai nomor ini telah ditarik, dan tidak ada build yang melaporkannya.E0322dipensiunkan: tidak ada yang melaporkannya sekarang, dan nomor ini tidak pernah diberikan ke kondisi lain. Kode ini menamai nilai yang dihitung oleh Feature yang dilampirkan ke boundary untuk lingkungan sebuah komponen di bawah kunci yang sudah dikirim oleh lampiran lain. Feature yang dilampirkan ke boundary mengirim ke komponen hanya melalui injectMapping milik FeatureRecipe-nya, dan pemetaan yang menulis kunci yang telah dikirim lampiran lain dilaporkan denganE0318.
Panduan pencocokan
Predikat errors.Is menelusuri rantai pembungkusan, sehingga pencocokan sentinel tetap berfungsi bahkan ketika error dibungkus beberapa kali dalam perjalanannya kembali kepada Anda. Cocokkan terhadap error yang dikembalikan oleh fungsi yang diekspor:
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}Tidak ada titik masuk yang diekspor yang menjalankan seluruh build, sehingga pencocokan errors.Is berlaku untuk kode yang memanggil paket-paket ini secara langsung. Untuk menjadikan build sebagai gerbang CI, jalankan aggrega build lalu baca status keluarnya dan diagnostiknya: teks pesannya dikatalogkan di fatal-halts.md, kategorinya di error-translation.md, dan kode pendek di bagian kepala dalam kurung sikunya dapat ditelusuri di tabel setiap kondisi pada halaman ini.
Kedua jalur gerbang ini ada karena ketiga pengenal menjangkau sejauh yang berbeda. Gerbang yang ditulis dalam Go menautkan paket-paket ini, mencocokkan sentinel, dan dapat membaca kode mana pun dari error apa pun yang dipegangnya. Gerbang yang ditulis di sekitar perintah memiliki status keluar dan teks yang dicetak — dan teks yang dicetak menyebutkan kondisinya, karena kode pendek berada di bagian kepala dalam kurung siku. Jadi gerbang semacam itu berpatokan pada kode pendek tersebut, bukan pada susunan kata pesan, dan tampilan berbasis pesan tetap menjadi cara untuk menelusuri balik dari susunan kata yang sudah dimilikinya. Cocokkan sentinel dari Go; berpatokan pada kode pendek di sekitar perintah; baca kode deskriptif dari diagnostik terstruktur jika klien menggunakan protokol tersebut.
Sentinel yang dideklarasikan di paket berbeda dengan nama pendek yang sama adalah kondisi yang berbeda, bukan dua ejaan dari satu kondisi: errors.Is membedakannya berdasarkan identitas, sehingga pencocokan terhadap yang satu tidak cocok dengan yang lain. Ekspor ulang yang disebutkan dalam tabel adalah pengecualiannya, dan disebutkan justru karena itulah kasus ketika dua nama memang cocok. Cocokkan terhadap nama di paket tempat tabel mencantumkannya, dan anggap nama pendek saja sebagai ambigu.
Untuk katalog diagnostik yang dilihat pengguna (pesan yang dilihat pengembang di terminal mereka ketika build berhenti), lihat fatal-halts.md. Untuk katalog peringatan advisori (keluaran warning:, lint: dan notice: yang tidak menghentikan build), lihat warnings.md. Untuk taksonomi prefiks kategori ([DEVELOPER_ERROR] / [OPS_ERROR] / [CATALOG_ERROR] / [TRANSLATION_ERROR] / [FETCH_ERROR] / [POLICY_ERROR] / [TRUST_ERROR]), lihat error-translation.md.