Sentinele błędów — dokumentacja kanoniczna
Każde krytyczne zatrzymanie zgłaszane przez kompilator wskazuje warunek, a każdy warunek ma trzy identyfikatory, ponieważ rozpoznanie warunku, jego zapisanie i jego przytoczenie to trzy różne zadania. Sentinel to wartość Go, do której dopasowuje errors.Is, uzyskiwana przez wywołanie akcesora eksportowanego przez pakiet deklarujący: identyfikator rozpoznawany przez kod Go. Kod to ciąg znaków, pod którym warunek jest zarejestrowany: nazywa sam warunek słowami i pozostaje niezmienny, gdy otaczające go pakiety Go ewoluują — to identyfikator zapisywany przez program. Krótki kod to litera E i cztery cyfry, wystarczająco krótki, by go odczytać na głos, wpisać w wyszukiwarkę lub wkleić do zgłoszenia: identyfikator przytaczany przez człowieka. Jeden warunek, trzy identyfikatory — sentinel należy dopasowywać, aby rozpoznać warunek z poziomu Go, kod odczytywać, gdy trzeba go zapisać lub użyć jako klucza, a krótki kod rozwiązywać za pomocą tabeli wszystkich warunków znajdującej się niżej na tej stronie.
Diagnostyka przeznaczona dla użytkownika (komunikat z prefiksem skatalogowany w fatal-halts.md i error-translation.md) zawiera opis przeznaczony dla programisty; opakowany sentinel jest tym, do czego dopasowuje errors.Is w programowych konsumentach.
Ta strona to widok katalogu według sentineli. Programiści piszący bramki CI, integracje z IDE lub kod orkiestracji kompilacji, który musi rozróżniać rodzaje błędów, dopasowują do wymienionych tu sentineli za pomocą standardowego predykatu errors.Is. Autorzy debugujący kompilację na podstawie zgłoszonego tekstu błędu zwykle potrzebują widoków według komunikatów — fatal-halts.md dla błędów zatrzymujących kompilację, warnings.md dla komunikatów doradczych.
Każdy wiersz poniższych tabel wskazuje akcesor — bezargumentową funkcję eksportowaną z pakietu wskazanego w tabeli, która zwraca sentinel. Zaimportowanie tego pakietu i wywołanie akcesora to wspierana powierzchnia integracji, dlatego tabele zapisują każdy akcesor z nawiasami — to wywołanie daje wartość, do której może dopasować errors.Is, a sama nazwa bez nawiasów jest funkcją, a nie błędem:
import ( "errors"
"github.com/aggrega-ai/aggrega-cli/pkg/resolver")
if errors.Is(err, resolver.ErrParameterContractViolation()) { // handle parameter contract violations}Każdy z trzech identyfikatorów ma własną stabilność i to rozdzielenie jest powodem, dla którego warunek ma wszystkie trzy. Wymienione niżej akcesory są stabilne między wydaniami poprawkowymi; zmiany nazw lub usunięcia są ogłaszane we wpisie dziennika zmian dla wydania, które je wprowadza, a dodanie nowego akcesora w pakiecie jest zmianą addytywną i nie psuje istniejących dopasowań. Kod jest ustalony z chwilą opublikowania warunku, więc to identyfikator, który należy zapisywać wszędzie tam, gdzie warunek trzeba nazwać trwale: zmiana nazwy akcesora nie zmienia kodu, pod którym zarejestrowano jego warunek, a zapisany kod przetrwa refaktoryzację powierzchni Go. Krótki kod jest najtrwalszy z trzech: numer jest przydzielany raz i potem się nie zmienia, a numer wycofanego warunku pozostaje wycofany i nie trafia do innego warunku, więc krótki kod zapisany w starym zgłoszeniu nadal wskazuje warunek, który wskazywał w chwili zapisu. Jest to egzekwowane, a nie tylko zamierzone — warunek zadeklarowany pod wycofanym numerem jest odrzucany, zanim kompilator odczyta jakiekolwiek dane wejściowe, przy każdym uruchomieniu — a każdy wycofany numer jest publikowany obok aktywnych w tabeli wszystkich warunków. Kolumna kodu poniżej zawiera kod i jest to wartość, którą klient ustrukturyzowanej diagnostyki odczytuje bez linkowania tych pakietów. Jest publikowana, a nie wywnioskowana, ponieważ nie musi powtarzać wiersza, w którym się znajduje — ponownie wyeksportowana nazwa zgłasza kod warunku, do którego przekierowuje, a kod reguły nazywa regułę, a nie akcesor. Kolumna komunikatu to dosłowny tekst renderowany przez sentinel; diagnostyka dla użytkownika poprzedza ten tekst nagłówkiem w nawiasach kwadratowych i lokalizacją w źródle. Ten nagłówek zawiera krótki kod warunku, a obok niego kategorię wystąpienia, jeśli wystąpienie ją ma, jak w [DEVELOPER_ERROR E0007] — dzięki temu czytelnik może rozwiązać każde z nich niezależnie: kategorie (DEVELOPER_ERROR / OPS_ERROR / CATALOG_ERROR / TRANSLATION_ERROR / FETCH_ERROR / POLICY_ERROR / TRUST_ERROR) są omówione w error-translation.md, a krótkie kody rozwiązuje się w tabeli wszystkich warunków na tej stronie. Jeśli warunek zgłosiła wtyczka, token kodu jest kwalifikowany wtyczką, która go zgłosiła — [TRANSLATION_ERROR provider/example:1.0.0/E0007] — a krótki kod jest ostatnim segmentem; error-translation.md wyjaśnia, po co jest ten kwalifikator i dlaczego rozwiązywać należy właśnie ostatni segment.
Odczytywanie kodu warunku
Kod nazywa warunek i nic poza nim, w notacji kebab-case — parameter-contract-violation, lockfile-drift. Nie ma żadnego prefiksu: ani pakietu, który go deklaruje, ani etapu, który go zgłasza, ani żadnego grupowania. Dzięki temu kod pozostaje taki sam, gdy kompilator zostaje wokół niego przeorganizowany, a warunek zgłaszany w więcej niż jednym miejscu kompilacji nadal ma jedną nazwę. Nazwa każdego warunku jest unikalna sama w sobie, dlatego prefiks jest zbędny, a dwóch warunków nie można zarejestrować pod jednym kodem. Kod odczytuje się z błędu za pomocą CodeOf z github.com/aggrega-ai/aggrega-cli/pkg/errors, która przechodzi łańcuch opakowań tak samo jak errors.Is, więc kod przetrwa niezależnie od tego, ile ramek opakowało błąd w drodze powrotnej. Ten pakiet sam nazywa się errors, więc alias importu odróżnia go od biblioteki standardowej:
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 informuje też, czy jakikolwiek błąd w łańcuchu w ogóle niósł kod; łańcuch bez kodu to fakt dotyczący tego łańcucha, a nie niepowodzenie. Jeśli woli się samodzielnie dopasować interfejs, ten sam pakiet eksportuje go jako CodedError, a errors.As znajduje go w tym samym przejściu.
Kod podróżuje w jedną stronę. Jest tym, co warunek zgłasza, nigdy tym, co identyfikuje go dla mechanizmu dopasowującego: wpisanie tego ciągu we własnym kodzie daje jedynie ciąg znaków, a z ciągu nie ma drogi powrotnej do wartości, którą dopasowuje errors.Is. Aby rozpoznać warunek, należy dopasować sentinel; aby go zapisać, należy odczytać kod.
Kod, który aggrega wypisuje w terminalu, to kod krótki, a nie ten. Diagnostyka zatrzymująca zaczyna się od nagłówka w nawiasach kwadratowych z krótkim kodem warunku, obok którego stoi kategoria wystąpienia, jeśli wystąpienie ją ma — [DEVELOPER_ERROR E0007] lub [TRANSLATION_ERROR provider/example:1.0.0/E0007], gdy warunek zgłosił plugin i kod jest kwalifikowany przez plugin, który go zgłosił, albo [E0007], gdy niepowodzenie nie ma obszaru, do którego można by skierować czytelnika — a następnie od lokalizacji w źródle i tekstu komunikatu skatalogowanego w fatal-halts.md. Kod opisowy nazywa warunek słowami i jest zdecydowanie za szeroki na to miejsce: przy najdłuższych warunkach wypełniłby wąski terminal, zanim zacząłby się komunikat, i to jest jedyny powód istnienia drugiego, zwięzłego identyfikatora. Dlatego mając tylko wydrukowane wyjście, należy wyjść od krótkiego kodu, który rozwiązuje się w tabeli wszystkich warunków w dalszej części tej strony: od numeru, który można podyktować przez telefon, dochodzi się do warunku, jego akcesora i tekstu komunikatu. aggrega explain <code> wykonuje to rozwiązanie w terminalu — przyjmuje dowolny z kodów warunku i wypisuje warunek wraz z wpisem dokumentującym poprawkę po stronie autora; opisano to w aggrega explain. Widoki według komunikatów w fatal-halts.md pozostają sposobem pracy na podstawie treści komunikatu, a nie identyfikatora.
Poza Go kod pojawia się w ustrukturyzowanej diagnostyce publikowanej przez demona kompilatora działającego jako usługa, jako osobne pole code w każdym wpisie, a nie coś wplecionego w tekst komunikatu — dzięki temu rozszerzenie edytora lub dowolny inny klient tego protokołu rozgałęzia się według tego, co zgłasza wpis, bez linkowania tych pakietów i bez parsowania prozy. Ten jeden klucz niesie kod dopasowywalny maszynowo niezależnie od tego, kto go nadał, a wpis podaje, która warstwa go zgłosiła. Kod ma tam trzy źródła, a trzecie jest powodem, dla którego kod, który można odnaleźć na tej stronie, nie jest sam w sobie oznaką, że cokolwiek się nie powiodło:
- Kod warunku nazwanego przez niepowodzenie, czyli to, co katalogowane jest na tej stronie.
- Kod klasy ostrzeżenia dotyczącego wyrenderowanego wyjścia — jednym z nich jest
unsupported-field, opisany w warnings.md. Jest nadawany tam, gdzie zgłoszono ostrzeżenie, a nie rejestrowany jako warunek, więc nie ma tu wiersza. - Zarejestrowany kod ostrzeżenia dotyczącego napisanych dokumentów — nazwa różniąca się jedną edycją od zadeklarowanej, parametr, którego nic nie odczytuje. Takie znalezisko nazywa warunek w tej samej formie co niepowodzenie, więc jego kod jest zarejestrowany i ma wiersz na tej stronie, a odczytanie tego wiersza mówi, czego dotyczy znalezisko.
Ten sam kod, który można odczytać z zatrzymania, może więc dotrzeć również z kompilacji, która się zakończyła, niesiony przez znalezisko, które nic nie zmieniło w wyniku. Te dwa przypadki odróżnia otrzymany wynik i warstwa wskazana we wpisie — nigdy sama forma kodu i nigdy to, czy rozwiązuje się on tutaj. Pole jest pomijane, gdy nic, co wytworzyło wpis, nie nadało kodu: w przypadku niepowodzenia, które nie nazywa żadnego własnego warunku Aggrega, oraz ostrzeżenia, któremu zgłaszający nie nadał kodu. aggrega serve dokumentuje kształt wpisu, klucz nazywający warstwę i to, kiedy pole jest obecne.
Ustrukturyzowana diagnostyka niesie oba identyfikatory warunku, a wiedza, który jest który, odróżnia identyfikator, na podstawie którego można działać, od takiego, na podstawie którego nie można. Powyższy klucz code jest przeznaczony dla programu: zapisany z łącznikami i nazywający warunek słowami, tak aby rozszerzenie rozgałęziające się według niego czytało się zgodnie ze znaczeniem; jest to wartość, którą w Go zgłasza CodeOf. Klucz shortCode obok niego jest przeznaczony dla człowieka — litera E i cztery cyfry, ten sam token, który diagnostyka zatrzymująca wypisuje w nagłówku w nawiasach kwadratowych. To go dyktuje się przez telefon, wpisuje w pole wyszukiwania lub wkleja do zgłoszenia, i według tego tokenu uporządkowana jest tabela wszystkich warunków.
Żaden z nich nie jest skrótem drugiego ani zamiennikiem drugiego. Dopasowywać należy według kodu opisowego; czytelnikowi pokazywać kod krótki. Interfejs oferujący tylko kod opisowy dawałby autorowi identyfikator przeznaczony dla mechanizmu dopasowującego, a taki, który dopasowywałby według kodu krótkiego, dopasowywałby według numeru, który nic nie mówi o warunku — dlatego przekazywane są oba, zamiast wybierać jeden.
Trzeci klucz, codeDescription, niesie miejsce publikacji warunku, jako odnośnik do otwarcia w celu uzyskania dalszych informacji o diagnostyce. Jego adres prowadzi do tabeli wszystkich warunków na tej stronie, więc czytelnik, który podąża za nim z edytora, trafia tam z krótkim kodem, według którego uporządkowana jest tabela. Wpis niesie krótki kod i odnośnik razem albo żadnego z nich: oba są obecne dokładnie wtedy, gdy wpis nazywa zarejestrowany warunek — taki, który ma wiersz w tej tabeli — i oba są nieobecne, gdy kod nazywa klasę ostrzeżenia lub tożsamość reguły konwencji z własnego lintera, której Aggrega nie deklaruje, ponieważ dla nich nie ma numeru do przytoczenia ani niczego tutaj, co by je opisywało.
W przeciwnym kierunku — od posiadanego kodu do warunku, który on nazywa — opublikowaną listą są poniższe tabele. Każdy wiersz zawiera kod obok akcesora, który w Go daje ten sam warunek, więc kod odczytany z ustrukturyzowanej diagnostyki rozwiązuje się do nazwy, którą można dopasować, i do tekstu, który warunek wyświetla. Tabele obejmują warunki, których akcesor można zaimportować, a poza nimi pozostają dwa rodzaje kodów: kod klasy, który nazywa klasę ostrzeżenia, a nie warunek, i dlatego nie ma akcesora, który można by postawić obok niego, oraz kod, którego warunek jest zadeklarowany tylko w pakiecie niemożliwym do zaimportowania i nigdzie nie jest reeksportowany, przez co nie ma dopasowywalnej nazwy, którą można by postawić obok niego. Ten drugi rodzaj nadal nazywa warunek, a ten warunek nadal ma krótki kod — tabela wszystkich warunków w dalszej części tej strony jest uporządkowana według krótkiego kodu zamiast według nazwy możliwej do zaimportowania, więc obejmuje również je.
Powierzchnia dopasowywania według pakietu deklarującego
Każda z poniższych sekcji odpowiada jednemu pakietowi, który można zaimportować. Jej nagłówek to ścieżka pakietu względem ścieżki modułu github.com/aggrega-ai/aggrega-cli, więc sekcję z nagłówkiem pkg/resolver importuje się jako github.com/aggrega-ai/aggrega-cli/pkg/resolver.
Wpisy są pogrupowane według pakietu, który deklaruje sentinel, ponieważ to ten pakiet importuje kod dopasowujący. To, w którym miejscu kompilacji warunek jest zgłaszany, jest osobną kwestią, na którą ta strona celowo nie odpowiada: pojedynczy sentinel jest często zgłaszany z kilku miejsc, a kilka z nich jest zgłaszanych wyłącznie z kodu, którego moduł nie eksportuje, więc żadna odpowiedź dla pojedynczego wpisu nie byłaby prawdziwa dla każdego wiersza. Widoki uporządkowane według komunikatów odpowiadają na pytanie o moment w kompilacji w kategoriach, które można zaobserwować — przede wszystkim fatal-halts.md.
Kilka nazw występuje w więcej niż jednym pakiecie. Są to ponowne eksporty jednej wspólnej wartości, a nie dwa warunki, więc dopasowanie dowolnej z tych nazw się powiedzie; tabele zaznaczają to tam, gdzie obie nazwy można zaimportować. Oba wiersze mają ten sam kod, co jest tym samym faktem wyrażonym za pomocą identyfikatora, którym dysponuje klient spoza Go: jeden warunek, jeden kod, niezależnie od liczby nazw, które do niego prowadzą.
pkg/catalog
| Sentinel | Kod | Komunikat |
|---|---|---|
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()to ta sama wartość copkg/resolver.ErrManifestImplementsMismatch(), więc dopasowanie do dowolnej z tych nazw się powiedzie.
pkg/closure
| Sentinel | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
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()to ta sama wartość copkg/refcycle.ErrCycle(), więc dopasowanie do dowolnej z tych nazw się powiedzie.
pkg/deprecation
| Sentinel | Kod | Komunikat |
|---|---|---|
ErrDeprecatedEntity() | deprecated-entity | deprecation: build consumes a deprecated entity |
pkg/docscache
| Sentinel | Kod | Komunikat |
|---|---|---|
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()to ta sama wartość copkg/oci.ErrFetchNotFound(), więc dopasowanie do dowolnej z tych nazw się powiedzie.
pkg/egress
| Sentinel | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
ErrNameWindowsCannotHold() | name-windows-cannot-hold | a name this operation writes holds a path segment Windows cannot hold as written |
pkg/pluginpath
| Sentinel | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
ErrCycle() | reference-cycle | circular reference expansion |
pkg/registrytrust
| Sentinel | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
ErrFetchIntegrity() | fetch-integrity | oci: content digest mismatch |
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrFetchIntegrity()to ta sama wartość copkg/oci.ErrFetchIntegrity(), więc dopasowanie do dowolnej z tych nazw się powiedzie.ErrFetchNotFound()to ta sama wartość copkg/oci.ErrFetchNotFound(), więc dopasowanie do dowolnej z tych nazw się powiedzie.
pkg/sourcekind
| Sentinel | Kod | Komunikat |
|---|---|---|
ErrUnknownKind() | unknown-source-kind | no source adapter serves the source kind |
pkg/sourceresolver
| Sentinel | Kod | Komunikat |
|---|---|---|
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()to ta sama wartość copkg/oci.ErrFetchIntegrity(), więc dopasowanie do dowolnej z tych nazw się powiedzie.ErrFetchNetworkUnreachable()to ta sama wartość copkg/oci.ErrFetchNetworkUnreachable(), więc dopasowanie do dowolnej z tych nazw się powiedzie.ErrFetchNotFound()to ta sama wartość copkg/oci.ErrFetchNotFound(), więc dopasowanie do dowolnej z tych nazw się powiedzie.ErrFetchUnauthorized()to ta sama wartość copkg/oci.ErrFetchUnauthorized(), więc dopasowanie do dowolnej z tych nazw się powiedzie.
pkg/sourceresolver/cacheslot
| Sentinel | Kod | Komunikat |
|---|---|---|
ErrEmptyWorkspaceRoot() | empty-workspace-root | cacheslot: empty workspaceRoot |
pkg/sourceresolver/netrc
| Sentinel | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
ErrDanglingUsesTarget() | dangling-uses-target | uses edge target does not exist |
ErrReleaseEdgeRetarget() | release-edge-retarget | release edge retargets a developer-declared edge |
pkg/validator
| Sentinel | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
ErrMergeInvalid() | schema-merge-input-invalid | merger: invalid merge input |
pkg/workspaceconfig
| Sentinel | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
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 | Kod | Komunikat |
|---|---|---|
ErrPositionOutOfRange() | position-out-of-range | position out of range |
Sentinele przenoszące inny sentinel
ErrCacheMetadataInvalid (pkg/sourceresolver/metadata) zgłasza uszkodzony slot pamięci podręcznej artefaktów źródłowych. Jest zadeklarowany jako opakowanie wokół ErrFetchIntegrity(), a nie jako odrębna tożsamość, dlatego nie występuje w powyższych tabelach, a dopasowanie do ErrFetchIntegrity() powiedzie się również dla niego. Ponieważ opakowuje sentinel, zamiast go deklarować, jest eksportowany jako wartość, a nie jako funkcja: należy go dopasowywać jako ErrCacheMetadataInvalid, bez nawiasów. Opakowanie należy dopasowywać, gdy potrzebny jest ten konkretny warunek, a opakowany sentinel — gdy potrzebna jest cała klasa błędów integralności.
Sentinele dostępne pod drugą nazwą w jednym pakiecie
Gdy pakiet eksportuje dwa akcesory dla jednego warunku — przy czym drugi jest zadeklarowany jako przekierowanie do pierwszego — powyższe tabele zawierają akcesor deklarujący i pomijają nazwę przekierowującą. Obie nazwy są eksportowane z tego samego pakietu, więc import, który sięga jednej z nich, sięga już także drugiej, a drugi wiersz wymieniałby jeden warunek dwukrotnie pod nazwą, która nie dopasowuje niczego nowego. Dopasowanie dowolnej z tych nazw się powiedzie: przekierowanie zwraca tę samą wartość, którą zwraca akcesor deklarujący.
Nie jest to przypadek międzypakietowy. Sentinel ponownie eksportowany z innego pakietu ma wiersz w tabeli każdego z pakietów, ponieważ kod dopasowujący, który importuje jeden z tych pakietów, nie może sięgnąć nazwy z drugiego bez zaimportowania również tamtego pakietu; przekierowanie wewnątrz jednego pakietu nie wymaga drugiego wiersza, ponieważ jeden import sięga obu nazw.
ErrDuplicateRecipeIdentity() w pkg/catalog jest właśnie takim przekierowaniem: zwraca ErrDuplicateEntityIdentity(), czyli nazwę, którą zawiera tabela dla tego pakietu.
Warunki bez dopasowywalnego sentinela
Niektóre etapy kompilacji deklarują swoje sentinele w pakietach, których kompilator nie eksportuje, więc nie ma niczego, do czego mógłby odwołać się errors.Is, i nie da się napisać dla nich żadnego dopasowania. Opisano je tutaj, a nie w tabeli, ponieważ tabela na tej stronie jest obietnicą, że lewą kolumnę można wyłuskać.
Ich komunikaty diagnostyczne docierają w pełni poprzez emitowany tekst błędu oraz poprzez widoki indeksowane komunikatem — w szczególności fatal-halts.md — co jest obsługiwanym sposobem ich rozpoznawania:
- Budowa topologii (budowa grafu i spłaszczanie podagregatów) zgłasza pod-Aggregate, którego nie udało się wczytać, podając nieosiągalny URI encji Aggregate; deklarację
uses:, której struktura nie odpowiada schematowi; przekroczenie głębokości zagnieżdżenia; oraz kolizję identyfikatorów węzłów po spłaszczeniu, gdy dwa pod-Aggregates kompilują się do tego samego identyfikatora węzła i jedną nazwę instancji trzeba zmienić, aby je rozróżnić. - Finalizacja grafu (scalanie encji Feature między powierzchniami Aggregate i Release) zgłasza typ encji Feature zadeklarowany niespójnie między nimi.
- Analiza statyczna (ewaluacja selektorów i kontrole bezpieczeństwa typów między węzłami) zgłasza naruszenie
selector:; nietrafione rozwiązanie w katalogu, poza które nie może przejść, podając nieosiągalną encję; oraz odrzucenie przez politykę, gdy plugin podpięty w roli werdyktu zarządczego odrzucił złożoną kompilację. Odrzucenie przez politykę niesie kategorięPOLICY_ERROR, nazwę odrzucającego pluginu oraz komunikat reguły dostarczony przez plugin. - Renderowanie (rozdział do dostawców i renderowanie per dostawca) zgłasza nieznanego dostawcę.
- Wbudowany loader hosta Wasm emituje własne sentinele zabezpieczeń: zabezpieczenie odrzucenia manifestu (plugin zażądał możliwości dostępu w czasie wykonania, której odmawia zapora czystości AOT), odtworzenie po panice gościa oraz deterministyczną pułapkę wyjścia pluginu. Pojawiają się one w diagnostyce widocznej dla użytkownika podczas uruchamiania pluginu (na przykład przez
aggrega lint). Autorzy encji Plugin testujący gościa względem hosta docierają do tych samych warunków po nazwie możliwej do zaimportowania przezpkg/plugintest, wymieniony powyżej.
Aby uzależnić potok właśnie od odrzucenia przez politykę, należy dopasowywać prefiks kategorii POLICY_ERROR w komunikacie diagnostycznym, a nie sentinel; kategoria jest udokumentowaną częścią powierzchni błędów, opisaną w error-translation.md.
Każdy warunek według krótkiego kodu
Poniższa tabela prowadzi wyszukiwanie w odwrotną stronę: w lewej kolumnie jest krótki kod, a obok niego warunek, który ten kod oznacza, oraz tekst, jaki ten warunek wyświetla. Obejmuje ona każdy warunek, który może zgłosić aggrega, w tym te, których powyższe sekcje nie mogą wymienić.
Ten szerszy zakres jest celem tej tabeli, a nie jej przypadkową cechą. Powyższe sekcje są uporządkowane według nazwy, którą można zaimportować, więc warunek zadeklarowany wyłącznie w pakiecie, którego nie można zaimportować — i nieeksportowany ponownie nigdzie, skąd można by go zaimportować — nie ma czego umieścić w ich lewej kolumnie. Ta tabela jest uporządkowana według krótkiego kodu, a każdy warunek go ma, więc żaden zgłaszalny warunek nie wypada poza nią. Posiadany krótki kod znajduje tu swoje rozwiązanie niezależnie od tego, czy warunek za nim ma również akcesor, który można dopasować.
O miejscu w tej tabeli decyduje to, że kompilator rzeczywiście może zgłosić dany warunek. Wiersze są wyprowadzane z kodu, a nie do niego przepisywane: warunek pojawia się tutaj, ponieważ coś w kompilatorze go zgłasza, więc każdy kod w lewej kolumnie to kod, który może wypisać aggrega. Taką obietnicę składa tabela i to właśnie pozwala czytać wiersz jako kontrolę, która naprawdę jest wykonywana.
Celowym wyjątkiem jest warunek zadeklarowany, zanim powstanie kod, który go zgłasza, tak aby kod i treść były ustalone z góry i nigdy nie zmieniły się czytelnikowi, który już je zacytował. Taki warunek informuje o tym w notatce bezpośrednio pod tabelą. Jest wymieniony, a nie ukryty — posiadany kod powinien zawsze dać się odnaleźć — a notatka przy nim jasno informuje, że żadna kompilacja jeszcze go nie zgłasza, oraz co musiałoby powstać, zanim jakaś to zrobi.
Wycofany numer również jest wymieniony, we własnym zestawie notatek pod tabelą, i pozostaje wymieniony na stałe. Warunek bywa czasem wycofywany — zastępuje go warunek o szerszym zakresie albo nic go nigdy nie zgłaszało — i od tej chwili jego numer jest wycofany: nigdy nie zostaje przydzielony innemu warunkowi, więc krótki kod zacytowany ze starego raportu może oznaczać wyłącznie to, co oznaczał w chwili sporządzenia raportu. Ta obietnica jest mechaniczna, a nie redakcyjna. Warunek zadeklarowany pod wycofanym numerem jest odrzucany, zanim kompilator odczyta jakiekolwiek dane wejściowe, przy każdym uruchomieniu, więc żadne wydanie nie może go zawierać — to ten sam rodzaj odmowy, jaki spotkałby numer, który próbowałyby współdzielić dwa aktywne warunki, sformułowany tak, by można było rozpoznać, który z tych dwóch przypadków wystąpił. Notatka dla wycofanego kodu informuje, co oznaczał, jeśli zapisano to przy wycofaniu, a jeśli warunek został zastąpiony — jaki kod zgłasza teraz ten zakres.
Niewykorzystywanie numerów ponownie powoduje też trwałe luki w sekwencji, a notatki sprawiają, że te luki można odczytać. Brakujący numer sam w sobie niczego nie dowodzi: może być wycofany, ale równie dobrze może to być numer, do którego jeszcze nic nie dotarło. Notatki stanowią zapis tego, które numery są wycofane i — tam, gdzie to zapisano — co każdy z nich oznaczał, więc kod, któremu nie odpowiada ani wiersz, ani notatka, to kod, którego ten kompilator nigdy nie wydał.
Krótki kod jest celowo nieprzejrzysty: cztery cyfry same w sobie nic nie mówią o warunku, co jest ceną identyfikatora na tyle krótkiego, by można go było przeczytać na głos, wpisać w wyszukiwarkę lub wkleić do raportu. Użyteczny czyni go dopiero poniższe zestawienie. Numer jest przydzielany raz, z jednej rosnącej sekwencji, i od tej pory pozostaje niezmienny; nic nie mówi o warunku, który oznacza. Krótki kod jest więc identyfikatorem i niczym więcej — jego wartość nie jest klasyfikacją, a ani on, ani żadne grupowanie, które można zauważyć w tabeli, nie wskazuje, gdzie warunek się znajduje ani czego dotyczy.
Tabela nie ma kolumny kategorii i nie jest to przeoczenie: kategoria jest właściwością konkretnego błędu, a nie stojącego za nim warunku. Niektóre warunki z założenia należą do jednej kategorii. W przypadku innych kategoria wynika z rodzaju encji, której dotyczy błąd, więc taki warunek zgłoszony raz dla encji Aggregate, a raz dla encji Release, za każdym razem ma inną kategorię — a pojedyncza wartość wpisana tu obok warunku byłaby błędna dla każdego warunku tego drugiego rodzaju.
Kategorie są omówione w error-translation.md — każda z nich, jej znaczenie i miejsce, w którym należy wprowadzić poprawkę. Kategoria i krótki kod odpowiadają na różne pytania o ten sam błąd: kategoria wskazuje powierzchnię, na której należy wprowadzić poprawkę, a krótki kod wskazuje, który warunek zatrzymał kompilację. Żadnego nie da się wyprowadzić z drugiego, dlatego każde ma własną opublikowaną listę — i dlatego błąd, dla którego nie da się wskazać powierzchni autorskiej, wciąż ma kod, który można tu sprawdzić.
| Kod | Warunek | Komunikat |
|---|---|---|
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 |
E0002jest wycofany: nic go teraz nie zgłasza, a numer nigdy nie zostaje przydzielony innemu warunkowi. Oznaczał nieudane wyszukiwanie w katalogu podczas sprawdzania statycznych kontraktów grafu — błąd kompilatora, a nie dokumentu autorskiego — a ten stan zgłasza teraz warunek zgłaszany, gdy kompilacja rozwiązuje typ komponentu, dla którego odczytywany katalog nie ma wpisu; jego kod toE0154.E0134jest wycofany: nic go teraz nie zgłasza, a numer nigdy nie zostaje przydzielony innemu warunkowi. Oznaczał publikowalną encję, której katalog nie był nazwany od wersji deklarowanej przez encję; publikacja nie ocenia nazwy katalogu, a warunek zgłaszany, gdy encja dzieli katalog z inną encją, choć jej rodzaj ma własny katalog, toE0303.E0157jest wycofany: nic go teraz nie zgłasza, a numer nigdy nie zostaje przydzielony innemu warunkowi. Oznaczał klucz encji Aggregate — nazwę instancji komponentu, funkcji, podsystemu lub zagnieżdżonego modułu — niezgodny ze wzorcem nazw autorskich. Każda z tych powierzchni kluczy jest ograniczona do tej samej pisowni przez schemat encji Aggregate, który odrzuca dokument podczas walidacji jego koperty i zgłasza błędny klucz z numerem wiersza i kolumny; kod tego warunku toE0215.E0159jest wycofany: nic go teraz nie zgłasza, a numer nigdy nie zostaje przydzielony innemu warunkowi. Oznaczał odwołanie do celu, którego segmenty rozdzielone kropkami nie wszystkie były zgodne ze wzorcem nazwy instancji, i żadna kompilacja go nie zgłosiła przed wycofaniem warunku.E0166jest wycofany: nic go teraz nie zgłasza, a numer nigdy nie zostaje przydzielony innemu warunkowi. Oznaczał plik wskazywany przezparameters: { $import: … }encji Release, gdy nie można było go odczytać lub jego zawartości nie dało się sparsować; plik, z którego nie powstaje żaden dokument, to jeden warunek niezależnie od miejsca zapisania ścieżki, a jego kod toE0175.E0203jest wycofany: nic go teraz nie zgłasza, a numer nigdy nie zostaje przydzielony innemu warunkowi. Oznaczał encję FeatureRecipe na możliwościeval, która deklarowała źródło, nakładkę values, obciążenie lub artefakty; ta możliwość została wycofana i nic teraz nie zgłasza tego stanu.E0206jest wycofany: nic go teraz nie zgłasza, a numer nigdy nie zostaje przydzielony innemu warunkowi. Oznaczał encję Recipe na możliwościeval, która deklarowała źródło, obciążenie, artefakty lub nakładkę values; ta możliwość została wycofana, a encja Recipe niedeklarująca żadnego z nich jest odrzucana na każdej możliwości pod kodemE0210.E0217jest wycofany: nic go teraz nie zgłasza, a numer nigdy nie zostaje przydzielony innemu warunkowi. Oznaczał błąd walidacji schematu, którego nie można było zgłosić dla konkretnego pola, i żadna kompilacja go nie zgłosiła przed wycofaniem warunku.E0219jest wycofany: nic go teraz nie zgłasza, a numer nigdy nie zostaje przydzielony innemu warunkowi. Oznaczał cykliczny łańcuchextends, zgłaszany przez przejście łańcucha odrębne od kroku łączenia przy scalaniu schematów; każdy cykliczny łańcuch zgłasza pojedyncze przejście łańcucha, a jego kod toE0202.E0230jest wycofany: nic go teraz nie zgłasza, a numer nigdy nie zostaje przydzielony innemu warunkowi. Warunek oznaczany tym numerem został wycofany i żadna kompilacja go nie zgłasza.E0231jest wycofany: nic go teraz nie zgłasza, a numer nigdy nie zostaje przydzielony innemu warunkowi. Warunek oznaczany tym numerem został wycofany i żadna kompilacja go nie zgłasza.E0232jest wycofany: nic go teraz nie zgłasza, a numer nigdy nie zostaje przydzielony innemu warunkowi. Warunek oznaczany tym numerem został wycofany i żadna kompilacja go nie zgłasza.E0233jest wycofany: nic go teraz nie zgłasza, a numer nigdy nie zostaje przydzielony innemu warunkowi. Warunek oznaczany tym numerem został wycofany i żadna kompilacja go nie zgłasza.- Kod
E0234został wycofany: nic go już nie zgłasza, a numer nigdy nie zostanie przydzielony innemu warunkowi. Oznaczał źródło encji Recipe będące pustym ciągiem znaków, zgłaszane podczas renderowania przez dostawcę compose; obecnie zgłasza to jeden warunek obejmujący wszystkich dostawców, a jego kod toE0251. - Kod
E0235został wycofany: nic go już nie zgłasza, a numer nigdy nie zostanie przydzielony innemu warunkowi. Warunek oznaczany tym numerem został wycofany i żadna kompilacja go nie zgłasza. - Kod
E0236został wycofany: nic go już nie zgłasza, a numer nigdy nie zostanie przydzielony innemu warunkowi. Warunek oznaczany tym numerem został wycofany i żadna kompilacja go nie zgłasza. - Kod
E0237został wycofany: nic go już nie zgłasza, a numer nigdy nie zostanie przydzielony innemu warunkowi. Warunek oznaczany tym numerem został wycofany i żadna kompilacja go nie zgłasza. - Kod
E0238został wycofany: nic go już nie zgłasza, a numer nigdy nie zostanie przydzielony innemu warunkowi. Warunek oznaczany tym numerem został wycofany i żadna kompilacja go nie zgłasza. - Kod
E0239został wycofany: nic go już nie zgłasza, a numer nigdy nie zostanie przydzielony innemu warunkowi. Warunek oznaczany tym numerem został wycofany i żadna kompilacja go nie zgłasza. - Kod
E0240został wycofany: nic go już nie zgłasza, a numer nigdy nie zostanie przydzielony innemu warunkowi. Warunek oznaczany tym numerem został wycofany i żadna kompilacja go nie zgłasza. - Kod
E0241został wycofany: nic go już nie zgłasza, a numer nigdy nie zostanie przydzielony innemu warunkowi. Warunek oznaczany tym numerem został wycofany i żadna kompilacja go nie zgłasza. - Kod
E0242został wycofany: nic go już nie zgłasza, a numer nigdy nie zostanie przydzielony innemu warunkowi. Oznaczał źródło encji Recipe będące pustym ciągiem znaków, zgłaszane podczas renderowania przez dostawcę Helm; obecnie zgłasza to jeden warunek obejmujący wszystkich dostawców, a jego kod toE0251. - Kod
E0243został wycofany: nic go już nie zgłasza, a numer nigdy nie zostanie przydzielony innemu warunkowi. Warunek oznaczany tym numerem został wycofany i żadna kompilacja go nie zgłasza. - Kod
E0244został wycofany: nic go już nie zgłasza, a numer nigdy nie zostanie przydzielony innemu warunkowi. Warunek oznaczany tym numerem został wycofany i żadna kompilacja go nie zgłasza. - Kod
E0245został wycofany: nic go już nie zgłasza, a numer nigdy nie zostanie przydzielony innemu warunkowi. Warunek oznaczany tym numerem został wycofany i żadna kompilacja go nie zgłasza. - Kod
E0249został wycofany: nic go już nie zgłasza, a numer nigdy nie zostanie przydzielony innemu warunkowi. Warunek oznaczany tym numerem został wycofany i żadna kompilacja go nie zgłasza. - Kod
E0258został wycofany: nic go już nie zgłasza, a numer nigdy nie zostanie przydzielony innemu warunkowi. Warunek oznaczany tym numerem został wycofany i żadna kompilacja go nie zgłasza. E0322jest wycofany: nic go teraz nie zgłasza, a numer nigdy nie zostaje przydzielony innemu warunkowi. Oznaczał wartość, którą encja Feature dołączona do granicy obliczała dla środowiska komponentu pod kluczem dostarczonym już przez inne dołączenie. Encja Feature dołączona do granicy dostarcza do komponentu wyłącznie przez injectMapping swojej encji FeatureRecipe, a mapowanie zapisujące klucz dostarczony przez inne dołączenie jest zgłaszane podE0318.
Wskazówki dotyczące dopasowywania
Predykat errors.Is przechodzi przez łańcuch opakowań, więc dopasowanie do sentinela działa nawet wtedy, gdy błąd zostaje opakowany kilka razy w drodze powrotnej do wywołującego. Należy dopasowywać do błędu zwróconego przez funkcję eksportowaną:
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}Nie istnieje eksportowany punkt wejścia uruchamiający całą kompilację, dlatego dopasowywanie za pomocą errors.Is dotyczy kodu, który wywołuje te pakiety bezpośrednio. Aby uzależnić CI od wyniku kompilacji, należy uruchomić aggrega build i odczytać jego kod wyjścia oraz diagnostykę: ich treść komunikatów jest skatalogowana w fatal-halts.md, ich kategoria w error-translation.md, a krótki kod w ich nagłówku w nawiasach kwadratowych można odnaleźć w tabeli wszystkich warunków na tej stronie.
Dwie ścieżki bramkowania istnieją, ponieważ trzy identyfikatory sięgają na różne odległości. Bramka napisana w Go linkuje te pakiety, dopasowuje sentinele i może odczytać każdy z kodów z dowolnego błędu, który przechowuje. Bramka zbudowana wokół polecenia ma do dyspozycji kod wyjścia i wypisany tekst — a wypisany tekst wskazuje warunek, ponieważ krótki kod znajduje się w nagłówku w nawiasach kwadratowych. Dlatego taka bramka opiera się na tym krótkim kodzie, a nie na brzmieniu komunikatu, a widoki indeksowane komunikatami pozostają sposobem na dojście do warunku od brzmienia, które już się ma. Z poziomu Go należy dopasowywać sentinel; wokół polecenia należy opierać się na krótkim kodzie; kod opisowy należy odczytywać ze strukturalnej diagnostyki tam, gdzie klient obsługuje ten protokół.
Sentinele zadeklarowane w różnych pakietach pod tą samą krótką nazwą są odrębnymi warunkami, a nie dwoma zapisami jednego: errors.Is rozróżnia je po tożsamości, więc dopasowanie do jednego nie pasuje do drugiego. Wyjątkiem są reeksporty wskazane w tabelach, a wskazano je właśnie dlatego, że to przypadek, w którym dwie nazwy faktycznie do siebie pasują. Należy dopasowywać do nazwy w pakiecie, pod którym tabele ją wymieniają, a samą krótką nazwę traktować jako niejednoznaczną.
Katalog diagnostyki przeznaczonej dla użytkownika (komunikaty, które programiści widzą w terminalu, gdy kompilacja zostaje zatrzymana) opisano w fatal-halts.md. Katalog ostrzeżeń doradczych (niezatrzymujące wyjście warning:, lint: i notice:) opisano w warnings.md. Taksonomię prefiksów kategorii ([DEVELOPER_ERROR] / [OPS_ERROR] / [CATALOG_ERROR] / [TRANSLATION_ERROR] / [FETCH_ERROR] / [POLICY_ERROR] / [TRUST_ERROR]) opisano w error-translation.md.