Fehler-Sentinels — kanonische Referenz
Jeder fatale Abbruch, den der Compiler ausgibt, nennt eine Bedingung, und jede Bedingung trägt drei Bezeichner, weil das Erkennen einer Bedingung, ihr Festhalten und ihr Zitieren drei verschiedene Aufgaben sind. Der Sentinel ist der Go-Wert, mit dem errors.Is abgleicht, und Sie erhalten ihn durch den Aufruf der Zugriffsfunktion, die das deklarierende Paket exportiert: der Bezeichner, den Go-Code erkennt. Der Code ist der String, unter dem die Bedingung registriert ist: Er benennt die Bedingung selbst in Worten, und er bleibt unverändert, während sich die Go-Pakete um ihn herum weiterentwickeln — der Bezeichner, den ein Programm festhält. Der Kurzcode ist der Buchstabe E mit vier Ziffern, kurz genug, um ihn vorzulesen, in eine Suche einzutippen oder in einen Bericht einzufügen: der Bezeichner, den ein Mensch zitiert. Eine Bedingung, drei Bezeichner — gleichen Sie den Sentinel ab, um die Bedingung aus Go heraus zu erkennen, lesen Sie den Code, wenn Sie sie festhalten oder als Schlüssel verwenden müssen, und lösen Sie einen Kurzcode über die Tabelle aller Bedingungen weiter unten auf dieser Seite auf.
Die benutzerseitige Diagnose (die mit Präfix versehene Meldung, die in fatal-halts.md und error-translation.md katalogisiert ist) trägt den für Entwickler bestimmten Text; der eingehüllte Sentinel ist das, womit errors.Is in programmatischen Konsumenten abgleicht.
Diese Seite ist die nach Sentinels geordnete Sicht auf den Katalog. Programmierer, die CI-Gates, IDE-Integrationen oder Code zur Build-Orchestrierung schreiben, der Fehlerarten unterscheiden muss, gleichen mit dem Standardprädikat errors.Is gegen die hier aufgeführten Sentinels ab. Autoren, die einen Build anhand des ausgegebenen Fehlertexts debuggen, wollen meist die nach Meldungen geordneten Sichten — fatal-halts.md für Fehler, die den Build stoppen, warnings.md für Hinweisausgaben.
Jede Zeile der folgenden Tabellen nennt eine Zugriffsfunktion — eine Funktion ohne Argumente, exportiert aus dem Paket, das die Tabelle nennt, die den Sentinel zurückgibt. Dieses Paket zu importieren und die Zugriffsfunktion aufzurufen ist die unterstützte Integrationsoberfläche, weshalb die Tabellen jede mit ihren Klammern schreiben — der Aufruf liefert einen Wert, mit dem errors.Is abgleichen kann, und der Name ohne sie ist eine Funktion statt eines Fehlers:
import ( "errors"
"github.com/aggrega-ai/aggrega-cli/pkg/resolver")
if errors.Is(err, resolver.ErrParameterContractViolation()) { // handle parameter contract violations}Die drei Bezeichner tragen ihre Stabilität jeweils getrennt, und diese Trennung ist der Grund, warum eine Bedingung alle drei hat. Die unten aufgeführten Zugriffsfunktionen sind über Patch-Versionen hinweg stabil; Umbenennungen oder Entfernungen werden im Changelog-Eintrag der Version angekündigt, die sie vornimmt, und das Hinzufügen einer neuen Zugriffsfunktion innerhalb eines Pakets ist additiv und bricht keine bestehenden Abgleiche. Ein Code steht fest, sobald seine Bedingung veröffentlicht ist, daher ist er der Bezeichner, den Sie überall dort festhalten, wo eine Bedingung dauerhaft benannt werden muss: Das Umbenennen einer Zugriffsfunktion verschiebt nicht den Code, unter dem ihre Bedingung registriert wurde, und ein Code, den Sie festgehalten haben, überdauert ein Refactoring der Go-Oberfläche. Ein Kurzcode ist der dauerhafteste der drei: Eine Nummer wird einmal vergeben und steht dann fest, und die Nummer einer ausgemusterten Bedingung bleibt ausgemustert, statt an eine andere Bedingung vergeben zu werden, sodass ein in einem alten Bericht festgehaltener Kurzcode noch immer die Bedingung nennt, die er beim Festhalten nannte. Das wird durchgesetzt und ist nicht bloß beabsichtigt — eine Bedingung, die unter einer ausgemusterten Nummer deklariert ist, wird zurückgewiesen, bevor der Compiler irgendeine Eingabe liest, bei jedem Lauf —, und jede ausgemusterte Nummer wird neben den aktiven in der Tabelle aller Bedingungen veröffentlicht. Die Code-Spalte unten trägt den Code, und er ist der Wert, den ein Client der strukturierten Diagnose liest, ohne diese Pakete einzubinden. Er wird veröffentlicht statt abgeleitet, weil er die Zeile, in der er steht, nicht wiedergeben muss — ein reexportierter Name meldet den Code der Bedingung, an die er weiterleitet, und der Code einer Regel benennt die Regel statt der Zugriffsfunktion. Die Meldungsspalte ist der wörtliche Text, den der Sentinel ausgibt; die benutzerseitige Diagnose stellt diesem Text einen Kopf in eckigen Klammern und die Quellposition voran. Dieser Kopf trägt den Kurzcode der Bedingung, daneben die Kategorie des Auftretens, wo das Auftreten eine hat, wie in [DEVELOPER_ERROR E0007] — sodass ein Leser beide unabhängig voneinander auflösen kann: Die Kategorien (DEVELOPER_ERROR / OPS_ERROR / CATALOG_ERROR / TRANSLATION_ERROR / FETCH_ERROR / POLICY_ERROR / TRUST_ERROR) werden in error-translation.md erklärt, und die Kurzcodes werden in der Tabelle aller Bedingungen auf dieser Seite aufgelöst. Wo ein Plugin die Bedingung ausgelöst hat, wird das Code-Token durch das Plugin qualifiziert, das sie ausgelöst hat — [TRANSLATION_ERROR provider/example:1.0.0/E0007] —, und der Kurzcode ist das letzte Segment; error-translation.md erklärt, warum der Qualifizierer da ist und warum das letzte Segment das aufzulösende ist.
Den Code einer Bedingung lesen
Ein Code benennt die Bedingung und nichts anderes, in Kebab-Case — parameter-contract-violation, lockfile-drift. Er trägt kein Präfix: weder das Paket, das ihn deklariert, noch die Phase, die ihn auslöst, noch eine Gruppierung irgendeiner Art. So bleibt ein Code derselbe, wenn der Compiler um ihn herum umorganisiert wird, und eine Bedingung, die an mehr als einer Stelle einer Kompilierung ausgelöst wird, hat dennoch einen einzigen Namen. Der Name jeder Bedingung ist für sich genommen eindeutig, was das Präfix überflüssig macht, und zwei Bedingungen können nicht unter einem Code registriert werden. Lesen Sie ihn mit CodeOf aus github.com/aggrega-ai/aggrega-cli/pkg/errors aus einem Fehler aus; es durchläuft die Wrap-Kette so, wie errors.Is es tut, sodass der Code erhalten bleibt, wie viele Ebenen den Fehler auf seinem Weg zurück zu Ihnen auch eingehüllt haben. Dieses Paket heißt selbst errors, daher hält ein Import-Alias es von der Standardbibliothek getrennt:
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 meldet außerdem, ob überhaupt ein Fehler in der Kette einen Code trug; eine Kette, die keinen trägt, ist eine Tatsache über diese Kette und kein Fehlschlag. Wenn Sie die Schnittstelle lieber selbst abgleichen, exportiert dasselbe Paket sie als CodedError, und errors.As findet sie beim selben Durchlauf.
Ein Code wirkt nur in eine Richtung. Er ist das, was eine Bedingung meldet, nie das, was sie für einen Abgleich identifiziert: Wenn Sie den String in Ihren eigenen Code schreiben, erhalten Sie einen String, und es gibt keinen Weg von einem String zurück zu dem Wert, mit dem errors.Is abgleicht. Gleichen Sie den Sentinel ab, um eine Bedingung zu erkennen; lesen Sie den Code, um eine festzuhalten.
Der Code, den aggrega auf einem Terminal ausgibt, ist der kurze, nicht dieser. Eine abbrechende Diagnose beginnt mit einem Kopf in eckigen Klammern, der den Kurzcode der Bedingung trägt, daneben die Kategorie des Auftretens, wo das Auftreten eine hat — [DEVELOPER_ERROR E0007], oder [TRANSLATION_ERROR provider/example:1.0.0/E0007], wo ein Plugin die Bedingung ausgelöst hat und der Code durch das auslösende Plugin qualifiziert ist, oder [E0007], wo der Fehlschlag keinen Zuständigkeitsbereich hat, an den er Sie verweisen könnte —, dann die Quellposition und der Meldungstext, der in fatal-halts.md katalogisiert ist. Der beschreibende Code benennt die Bedingung in Worten und ist für diese Position viel zu breit: Bei den längsten Bedingungen würde er ein schmales Terminal füllen, bevor die Meldung beginnt, und genau deshalb gibt es einen zweiten, kompakten Bezeichner. Das Token, von dem Sie ausgehen, wenn Sie nur die ausgegebene Ausgabe haben, ist also der Kurzcode, und er wird über die Tabelle aller Bedingungen weiter unten auf dieser Seite aufgelöst: Von einer Nummer, die Sie am Telefon vorlesen können, gelangen Sie zur Bedingung, zu ihrer Zugriffsfunktion und zu ihrem Meldungstext. aggrega explain <code> erledigt diese Auflösung am Terminal — es nimmt jeden der beiden Codes der Bedingung entgegen und gibt die Bedingung zusammen mit dem Eintrag aus, der die Authoring-Korrektur dokumentiert, und ist in aggrega explain beschrieben. Die nach Meldungen geordneten Sichten in fatal-halts.md bleiben der Weg, vom Wortlaut statt von einem Bezeichner auszugehen.
Wo ein Code Go tatsächlich verlässt, ist die strukturierte Diagnose, die der Daemon des Compilers als Dienst veröffentlicht, als eigenes code-Feld an jedem Eintrag statt als etwas, das in den Meldungstext eingearbeitet ist — sodass eine Editor-Erweiterung oder jeder andere Client dieses Protokolls nach dem verzweigt, was ein Eintrag meldet, ohne diese Pakete einzubinden und ohne Text zu parsen. Dieser eine Schlüssel trägt einen maschinell abgleichbaren Code, wer auch immer ihn vergeben hat, und der Eintrag sagt, welche Schicht ihn ausgelöst hat. Ein Code hat dort drei Ursprünge, und der dritte ist der Grund, warum ein Code, den Sie auf dieser Seite nachschlagen können, für sich genommen kein Zeichen dafür ist, dass etwas fehlgeschlagen ist:
- Der Code der Bedingung, die ein Fehlschlag nennt, und genau das katalogisiert diese Seite.
- Der Klassencode eines Hinweises zur gerenderten Ausgabe —
unsupported-fieldist einer, und warnings.md beschreibt ihn. Er wird dort vergeben, wo der Hinweis ausgelöst wurde, statt als Bedingung registriert zu werden, daher hat er hier keine Zeile. - Der registrierte Code eines Hinweises zu den verfassten Dokumenten — ein Name, der eine Bearbeitung von einem deklarierten entfernt ist, ein Parameter, den nichts liest. Ein solcher Befund nennt eine Bedingung in derselben Form wie ein Fehlschlag, daher ist sein Code registriert und hat eine Zeile auf dieser Seite, und das Lesen dieser Zeile sagt Ihnen, worum es bei dem Befund geht.
Derselbe Code, den Sie an einem Abbruch ablesen würden, kann Sie also auch aus einem Build erreichen, der abgeschlossen wurde, getragen von einem Befund, der am Ergebnis nichts geändert hat. Was die beiden unterscheidet, ist das Ergebnis, das Sie erhalten haben, und die Schicht, die der Eintrag nennt — nie die Form des Codes selbst und nie, ob er sich hier auflöst. Das Feld fehlt dort, wo nichts von dem, was den Eintrag erzeugt hat, einen Code vergeben hat: bei einem Fehlschlag, der keine eigene Bedingung von Aggrega nennt, und bei einem Hinweis, dessen Auslöser keinen vergeben hat. aggrega serve dokumentiert die Form des Eintrags, den Schlüssel, der die Schicht nennt, und wann das Feld vorhanden ist.
Eine strukturierte Diagnose trägt beide Bezeichner einer Bedingung, und zu wissen, welcher welcher ist, macht den Unterschied zwischen einem Bezeichner, auf den Sie reagieren können, und einem, bei dem Sie es nicht können. Der code-Schlüssel oben ist für ein Programm: mit Bindestrichen und die Bedingung in Worten benennend, sodass sich eine Erweiterung, die danach verzweigt, so liest, wie sie gemeint ist, und er ist der Wert, den CodeOf in Go meldet. Der shortCode-Schlüssel daneben ist für einen Menschen — der Buchstabe E mit vier Ziffern, dasselbe Token, das eine abbrechende Diagnose in ihrem Kopf in eckigen Klammern ausgibt. Ihn lesen Sie am Telefon vor, tippen ihn in ein Suchfeld oder fügen ihn in ein Issue ein, und er ist das Token, nach dem die Tabelle aller Bedingungen geordnet ist.
Keiner ist die Kurzform des anderen, und keiner ist ein Ersatz für den anderen. Gleichen Sie mit dem beschreibenden Code ab; zeigen Sie einem Leser den kurzen. Eine Oberfläche, die nur den beschreibenden Code anböte, würde einem Autor einen Bezeichner in die Hand geben, der für einen Abgleich gedacht ist, und eine, die mit dem Kurzcode abgliche, würde mit einer Nummer abgleichen, die nichts über die Bedingung aussagt — weshalb beide mitgegeben werden, statt einen auszuwählen.
Ein dritter Schlüssel, codeDescription, gibt an, wo die Bedingung veröffentlicht ist, als Referenz, die Sie öffnen können, um mehr über die Diagnose zu erfahren. Seine Adresse führt zur Tabelle aller Bedingungen auf dieser Seite, sodass ein Leser, der ihr aus einem Editor folgt, mit dem Kurzcode in der Hand ankommt, nach dem die Tabelle geordnet ist. Ein Eintrag trägt den Kurzcode und die Referenz gemeinsam oder keinen von beiden: Beide sind genau dort vorhanden, wo der Eintrag eine registrierte Bedingung nennt — eine mit einer Zeile in dieser Tabelle —, und beide fehlen dort, wo der Code eine Klasse von Hinweisen oder die Identität einer Konventionsregel aus einem eigenen Linter nennt, die Aggrega nicht deklariert, weil es für diese keine Nummer zum Zitieren und hier nichts gibt, das sie beschreibt.
In die andere Richtung — von einem Code, den Sie in der Hand haben, zu der Bedingung, die er nennt — sind die folgenden Tabellen die veröffentlichte Liste. Jede Zeile trägt den Code neben der Zugriffsfunktion, die in Go dieselbe Bedingung liefert, sodass sich ein aus einer strukturierten Diagnose gelesener Code in einen Namen auflöst, mit dem Sie abgleichen können, und in den Text, den die Bedingung ausgibt. Die Tabellen decken die Bedingungen ab, deren Zugriffsfunktion Sie importieren können, und zwei Arten von Code liegen außerhalb davon: ein Klassencode, der eine Klasse von Hinweisen statt einer Bedingung nennt und daher keine Zugriffsfunktion hat, die man danebenstellen könnte, und ein Code, dessen Bedingung nur in einem Paket deklariert ist, das Sie nicht importieren können, und nirgends reexportiert wird, sodass es keinen abgleichbaren Namen gibt, den man danebenstellen könnte. Diese zweite Art nennt dennoch eine Bedingung, und diese Bedingung hat dennoch einen Kurzcode — die Tabelle aller Bedingungen weiter unten auf dieser Seite ist nach dem Kurzcode statt nach einem importierbaren Namen geordnet und deckt daher auch diese ab.
Die abgleichbare Oberfläche, nach deklarierendem Paket
Jeder Abschnitt unten ist ein Paket, das Sie importieren können. Seine Überschrift ist der Paketpfad relativ zum Modulpfad github.com/aggrega-ai/aggrega-cli, sodass der Abschnitt mit der Überschrift pkg/resolver als github.com/aggrega-ai/aggrega-cli/pkg/resolver importiert wird.
Die Einträge sind nach dem Paket gruppiert, das den Sentinel deklariert, weil das das Paket ist, das ein Abgleich importiert. Wo in einem Build die Bedingung ausgelöst wird, ist eine eigene Frage, und eine, die diese Seite bewusst nicht beantwortet: Ein einzelner Sentinel wird häufig an mehreren Stellen ausgelöst, und einige werden nur aus Code ausgelöst, den das Modul nicht exportiert, sodass keine Antwort pro Eintrag für jede Zeile zuträfe. Die nach Meldungen geordneten Sichten beantworten die Frage nach dem Wann im Build in Begriffen, die Sie beobachten können — vor allem fatal-halts.md.
Einige Namen kommen in mehr als einem Paket vor. Das sind Reexporte eines einzigen gemeinsamen Werts statt zweier Bedingungen, daher gelingt ein Abgleich mit jedem der beiden Namen; die Tabellen sagen das, wo beide Namen importierbar sind. Beide Zeilen tragen denselben Code, was dieselbe Tatsache ist, ausgedrückt am Bezeichner, den ein Client außerhalb von Go hält: eine Bedingung, ein Code, wie viele Namen sie auch erreichen.
pkg/catalog
| Sentinel | Code | Meldung |
|---|---|---|
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()ist derselbe Wert wiepkg/resolver.ErrManifestImplementsMismatch(), daher gelingt ein Abgleich mit jedem der beiden Namen.
pkg/closure
| Sentinel | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
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()ist derselbe Wert wiepkg/refcycle.ErrCycle(), daher gelingt ein Abgleich mit jedem der beiden Namen.
pkg/deprecation
| Sentinel | Code | Meldung |
|---|---|---|
ErrDeprecatedEntity() | deprecated-entity | deprecation: build consumes a deprecated entity |
pkg/docscache
| Sentinel | Code | Meldung |
|---|---|---|
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()ist derselbe Wert wiepkg/oci.ErrFetchNotFound(), daher gelingt ein Abgleich mit jedem der beiden Namen.
pkg/egress
| Sentinel | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
ErrNameWindowsCannotHold() | name-windows-cannot-hold | a name this operation writes holds a path segment Windows cannot hold as written |
pkg/pluginpath
| Sentinel | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
ErrCycle() | reference-cycle | circular reference expansion |
pkg/registrytrust
| Sentinel | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
ErrFetchIntegrity() | fetch-integrity | oci: content digest mismatch |
ErrFetchNotFound() | fetch-not-found | oci: artifact not found at remote source |
ErrFetchIntegrity()ist derselbe Wert wiepkg/oci.ErrFetchIntegrity(), daher gelingt ein Abgleich mit jedem der beiden Namen.ErrFetchNotFound()ist derselbe Wert wiepkg/oci.ErrFetchNotFound(), daher gelingt ein Abgleich mit jedem der beiden Namen.
pkg/sourcekind
| Sentinel | Code | Meldung |
|---|---|---|
ErrUnknownKind() | unknown-source-kind | no source adapter serves the source kind |
pkg/sourceresolver
| Sentinel | Code | Meldung |
|---|---|---|
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()ist derselbe Wert wiepkg/oci.ErrFetchIntegrity(), daher gelingt ein Abgleich mit jedem der beiden Namen.ErrFetchNetworkUnreachable()ist derselbe Wert wiepkg/oci.ErrFetchNetworkUnreachable(), daher gelingt ein Abgleich mit jedem der beiden Namen.ErrFetchNotFound()ist derselbe Wert wiepkg/oci.ErrFetchNotFound(), daher gelingt ein Abgleich mit jedem der beiden Namen.ErrFetchUnauthorized()ist derselbe Wert wiepkg/oci.ErrFetchUnauthorized(), daher gelingt ein Abgleich mit jedem der beiden Namen.
pkg/sourceresolver/cacheslot
| Sentinel | Code | Meldung |
|---|---|---|
ErrEmptyWorkspaceRoot() | empty-workspace-root | cacheslot: empty workspaceRoot |
pkg/sourceresolver/netrc
| Sentinel | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
ErrDanglingUsesTarget() | dangling-uses-target | uses edge target does not exist |
ErrReleaseEdgeRetarget() | release-edge-retarget | release edge retargets a developer-declared edge |
pkg/validator
| Sentinel | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
ErrMergeInvalid() | schema-merge-input-invalid | merger: invalid merge input |
pkg/workspaceconfig
| Sentinel | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
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 | Code | Meldung |
|---|---|---|
ErrPositionOutOfRange() | position-out-of-range | position out of range |
Sentinels, die einen anderen Sentinel tragen
ErrCacheMetadataInvalid (pkg/sourceresolver/metadata) meldet einen beschädigten Cache-Slot für Quellartefakte. Er ist als Wrapper um ErrFetchIntegrity() deklariert statt als eigene Identität, daher erscheint er nicht in den Tabellen oben, und ein Abgleich mit ErrFetchIntegrity() gelingt auch für ihn. Da er einen Sentinel einhüllt, statt einen zu deklarieren, wird er als Wert statt als Funktion exportiert: Gleichen Sie ihn als ErrCacheMetadataInvalid ab, ohne Klammern. Gleichen Sie mit dem Wrapper ab, wenn Sie genau diese Bedingung wollen, und mit dem eingehüllten Sentinel, wenn Sie die gesamte Integritätsklasse wollen.
Sentinels, die in einem Paket unter einem zweiten Namen erreichbar sind
Wo ein Paket zwei Zugriffsfunktionen für eine Bedingung exportiert — die zweite als Weiterleitung an die erste deklariert —, führen die Tabellen oben die deklarierende Zugriffsfunktion und lassen den weiterleitenden Namen weg. Beide Namen werden aus demselben Paket exportiert, sodass ein Import, der den einen erreicht, bereits auch den anderen erreicht, und eine zweite Zeile würde eine Bedingung doppelt aufführen, unter einem Namen, mit dem sich nichts Neues abgleichen lässt. Ein Abgleich mit jedem der beiden Namen gelingt: Die Weiterleitung gibt denselben Wert zurück wie die deklarierende Zugriffsfunktion.
Das ist nicht der paketübergreifende Fall. Ein Sentinel, der aus einem anderen Paket reexportiert wird, hat eine Zeile in der Tabelle jedes Pakets, weil ein Abgleich, der eines dieser Pakete importiert, den Namen des anderen nicht erreichen kann, ohne auch jenes Paket zu importieren; eine Weiterleitung innerhalb eines einzigen Pakets braucht keine zweite Zeile, weil ein einziger Import beide Namen erreicht.
ErrDuplicateRecipeIdentity() in pkg/catalog ist eine solche Weiterleitung: Sie gibt ErrDuplicateEntityIdentity() zurück, und das ist der Name, den die Tabelle für dieses Paket führt.
Bedingungen ohne abgleichbaren Sentinel
Einige Kompilierungsphasen deklarieren ihre Sentinels in Paketen, die der Compiler nicht exportiert, sodass es nichts gibt, worauf errors.Is verweisen könnte, und kein Abgleich gegen sie geschrieben werden kann. Sie werden hier beschrieben statt tabellarisch aufgeführt, weil eine Tabelle auf dieser Seite ein Versprechen ist, dass sich die linke Spalte dereferenzieren lässt.
Ihre Diagnosen erreichen Sie vollständig über den ausgegebenen Fehlertext und über die nach Meldungen geordneten Sichten — insbesondere fatal-halts.md —, und das ist der unterstützte Weg, sie zu erkennen:
- Die Topologie-Konstruktion (Graphkonstruktion und Abflachen von Sub-Aggregaten) meldet ein Sub-Aggregate, das nicht geladen werden konnte, und nennt dabei den URI des nicht erreichbaren Aggregate; eine
uses:-Deklaration, deren strukturelle Form nicht zum Schema passt; eine überschrittene Verschachtelungstiefe; und eine Kollision von Knoten-IDs nach dem Abflachen, bei der zwei Sub-Aggregates zur selben Knoten-ID kompiliert werden und ein Instanzname zur Unterscheidung umbenannt werden muss. - Die Graph-Finalisierung (Feature-Zusammenführung über die Oberflächen von Aggregate und Release hinweg) meldet einen Feature-Typ, der zwischen den beiden inkonsistent deklariert ist.
- Die statische Analyse (Selektorauswertung und knotenübergreifende Typsicherheitsprüfungen) meldet einen Verstoß gegen
selector:; einen Fehltreffer bei der Katalogauflösung, über den sie nicht hinauskommt, und nennt dabei die nicht erreichbare Entität; und eine Richtlinienablehnung, bei der ein Plugin, das an einer Governance-Verdikt-Rolle angebunden ist, den zusammengesetzten Build abgelehnt hat. Eine Richtlinienablehnung trägt die KategoriePOLICY_ERROR, den Namen des ablehnenden Plugins und die Regelmeldung, die das Plugin geliefert hat. - Das Rendering (Provider-Dispatch und Rendering pro Provider) meldet einen unbekannten Provider.
- Der eingebettete Wasm-Host-Loader gibt seine eigenen Guardrail-Sentinels aus — einen Guardrail bei abgelehntem Manifest (ein Plugin hat eine Fähigkeit zum Laufzeitzugriff angefordert, die die AOT-Reinheits-Firewall verweigert), eine Wiederherstellung nach einem Guest-Panic und einen deterministischen Plugin-Exit-Trap. Diese erscheinen in der benutzerseitigen Diagnose, wenn ein Plugin ausgeführt wird (zum Beispiel über
aggrega lint). Plugin-Autoren, die einen Guest gegen den Host testen, erreichen dieselben Bedingungen über importierbare Namen inpkg/plugintest, das oben aufgeführt ist.
Um eine Pipeline gezielt bei einer Richtlinienablehnung zu stoppen, gleichen Sie das Kategoriepräfix POLICY_ERROR in der Diagnose ab statt einen Sentinel; die Kategorie ist ein dokumentierter Teil der Fehleroberfläche und in error-translation.md beschrieben.
Jede Bedingung, nach Kurzcode
Die folgende Tabelle führt die Suche in umgekehrter Richtung aus: ein Kurzcode in der linken Spalte und daneben die Bedingung, die dieser Code nennt, und der Text, den diese Bedingung ausgibt. Sie deckt jede Bedingung ab, die aggrega melden kann, einschließlich derer, die die Abschnitte oben nicht aufführen können.
Diese breitere Abdeckung ist der Zweck dieser Tabelle und kein Zufallsprodukt. Die Abschnitte oben sind nach einem Namen geordnet, den Sie importieren können, sodass eine Bedingung, die nur in einem Paket deklariert ist, das Sie nicht importieren können — und auch nirgends reexportiert wird, wo Sie importieren könnten —, nichts für ihre linke Spalte hat. Diese Tabelle ist nach dem Kurzcode geordnet, und jede Bedingung hat einen, sodass keine meldbare Bedingung außerhalb von ihr liegt. Ein Kurzcode, den Sie in der Hand haben, wird hier aufgelöst, ob die Bedingung dahinter auch eine Zugriffsfunktion hat, mit der Sie abgleichen können, oder nicht.
Was einen Platz in dieser Tabelle verdient, ist, dass der Compiler die Bedingung tatsächlich melden kann. Die Zeilen werden aus dem Code abgeleitet, statt in ihn übertragen zu werden: Eine Bedingung erscheint hier, weil etwas im Compiler sie auslöst, sodass jeder Code in der linken Spalte einer ist, den aggrega ausgeben kann. Das ist das Versprechen der Tabelle, und es ist das, was Ihnen erlaubt, eine Zeile als Prüfung zu lesen, die wirklich läuft.
Die bewusste Ausnahme ist eine Bedingung, die deklariert wird, bevor der Code existiert, der sie meldet, damit Code und Wortlaut im Voraus feststehen und sich nie unter einem Leser ändern, der sie bereits zitiert hat. Eine solche Bedingung sagt das in einer Anmerkung direkt unter der Tabelle. Sie wird aufgeführt statt verborgen — ein Code, den Sie in der Hand haben, sollte sich immer auflösen —, und die Anmerkung daneben sagt Ihnen klar, dass noch kein Build sie auslöst und was existieren müsste, bevor einer es täte.
Auch eine ausgemusterte Nummer wird aufgeführt, in einer eigenen Reihe von Anmerkungen unter der Tabelle, und sie bleibt dauerhaft aufgeführt. Gelegentlich wird eine Bedingung zurückgezogen — sie wird durch eine ersetzt, die mehr abdeckt, oder nichts hat sie je gemeldet —, und von diesem Moment an ist ihre Nummer ausgemustert: Sie wird nie an eine andere Bedingung vergeben, sodass ein Kurzcode, den Sie aus einem alten Bericht zitieren, immer nur das nennen kann, was er nannte, als der Bericht geschrieben wurde. Dieses Versprechen ist mechanisch, nicht redaktionell. Eine Bedingung, die unter einer ausgemusterten Nummer deklariert ist, wird zurückgewiesen, bevor der Compiler irgendeine Eingabe liest, bei jedem Lauf, sodass keine Version eine enthalten kann — dieselbe Art von Zurückweisung, auf die eine Nummer träfe, die sich zwei aktive Bedingungen zu teilen versuchten, so formuliert, dass Sie erkennen können, welchen der beiden Fälle Sie getroffen haben. Die Anmerkung zu einem ausgemusterten Code sagt Ihnen, wo die Ausmusterung es festgehalten hat, was der Code nannte, und, wo die Bedingung ersetzt wurde, welcher Code diesen Bereich jetzt meldet.
Dass eine Nummer nie wiederverwendet wird, ist auch das, was der Folge ihre dauerhaften Lücken gibt, und die Anmerkungen machen diese Lücken lesbar. Eine fehlende Nummer ist für sich genommen kein Beleg für irgendetwas: Sie kann ausgemustert sein, und sie kann ebenso gut eine sein, die noch nichts erreicht hat. Die Anmerkungen halten fest, welche Nummern ausgemustert sind und, wo es festgehalten wurde, was jede von ihnen nannte, sodass ein Code, der sich weder zu einer Zeile noch zu einer Anmerkung auflöst, einer ist, den dieser Compiler nie vergeben hat.
Ein Kurzcode ist bewusst undurchsichtig: Vier Ziffern sagen für sich genommen nichts über eine Bedingung, und das ist der Preis für einen Bezeichner, der kurz genug ist, um ihn vorzulesen, in eine Suche einzutippen oder in einen Bericht einzufügen. Die Zuordnung unten ist das, was ihn brauchbar macht. Eine Nummer wird einmal vergeben, aus einer einzigen aufsteigenden Folge, und steht von da an fest; sie sagt nichts über die Bedingung, die sie nennt. Ein Kurzcode ist also ein Bezeichner und nichts weiter — sein Wert ist keine Klassifizierung, und weder er noch eine Gruppierung, die Ihnen in der Tabelle auffallen mag, ist ein Hinweis darauf, wo eine Bedingung angesiedelt ist oder worum es bei ihr geht.
Die Tabelle hat keine Kategoriespalte, und das ist kein Versäumnis: Eine Kategorie ist eine Eigenschaft eines bestimmten Fehlschlags und nicht der Bedingung dahinter. Einige Bedingungen gehören konstruktionsbedingt zu einer Kategorie. Bei anderen ergibt sich die Kategorie aus der Art der Entität, um die es bei dem Fehlschlag geht, sodass eine solche Bedingung, einmal für ein Aggregate und einmal für ein Release gemeldet, jedes Mal eine andere Kategorie trägt — und ein einzelner Wert, der hier neben die Bedingung geschrieben würde, wäre für jede Bedingung dieser zweiten Art falsch.
Wo die Kategorien erklärt werden, ist error-translation.md — jede einzelne, was sie bedeutet und wo die Korrektur für sie hingehört. Eine Kategorie und ein Kurzcode beantworten unterschiedliche Fragen zum selben Fehlschlag: Die Kategorie bezeichnet die Oberfläche, auf die die Korrektur gehört, und der Kurzcode bezeichnet, welche Bedingung den Build abgebrochen hat. Keines lässt sich aus dem anderen ableiten, weshalb jedes seine eigene veröffentlichte Liste hat — und weshalb ein Fehlschlag ohne eine Authoring-Oberfläche, die er nennen könnte, dennoch einen Code trägt, den Sie hier nachschlagen können.
| Code | Bedingung | Meldung |
|---|---|---|
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 |
E0002ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Er nannte eine Katalogsuche, die fehlschlägt, während die statischen Verträge des Graphen geprüft werden — ein Fehler im Compiler und nicht in einem verfassten Dokument —, und diesen Zustand meldet jetzt die Bedingung, die ausgelöst wird, wenn ein Build einen Komponententyp auflöst, für den der Katalog, den er liest, dann keinen Eintrag enthält, und ihr Code istE0154.E0134ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Er nannte eine veröffentlichbare Entität, deren Verzeichnis nicht nach der Version benannt war, die die Entität deklariert; eine Veröffentlichung beurteilt den Namen eines Verzeichnisses nicht, und die Bedingung, die ausgelöst wird, wenn sich eine Entität ihr Verzeichnis mit einer anderen Entität teilt, obwohl ihre Art ein eigenes Verzeichnis hat, istE0303.E0157ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Er nannte einen Aggregate-Schlüssel — den Instanznamen einer Komponente, eines Features, eines Subsystems oder eines verschachtelten Moduls —, der nicht zum Muster für verfasste Namen passte. Jede dieser Schlüsseloberflächen ist durch das Aggregate-Schema auf genau diese Schreibweise beschränkt, das das Dokument beim Validieren seiner Hülle zurückweist und den beanstandeten Schlüssel mit Zeile und Spalte meldet; der Code dieser Bedingung istE0215.E0159ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Er nannte eine Zielreferenz, deren durch Punkte getrennte Segmente nicht alle zum Instanznamen-Muster passten, und kein Build hat ihn gemeldet, bevor die Bedingung zurückgezogen wurde.E0166ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Er nannte die Datei, auf dieparameters: { $import: … }eines Release zeigt, wenn diese Datei nicht gelesen werden konnte oder sich ihre Bytes nicht parsen ließen; eine Datei, die kein Dokument liefert, ist eine einzige Bedingung, wo immer der Pfad geschrieben wurde, und ihr Code istE0175.E0203ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Er nannte ein FeatureRecipe mit der Fähigkeiteval, das eine Quelle, ein values-Overlay, eine Arbeitslast oder Artefakte deklarierte; diese Fähigkeit wurde zurückgezogen, und nichts meldet diesen Zustand mehr.E0206ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Er nannte ein Recipe mit der Fähigkeiteval, das eine Quelle, eine Arbeitslast, Artefakte oder ein values-Overlay deklarierte; diese Fähigkeit wurde zurückgezogen, und ein Recipe, das nichts davon deklariert, wird bei jeder Fähigkeit unterE0210zurückgewiesen.E0217ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Er nannte einen Fehlschlag der Schemavalidierung, der nicht für ein bestimmtes Feld gemeldet werden konnte, und kein Build hat ihn gemeldet, bevor die Bedingung zurückgezogen wurde.E0219ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Er nannte eine zyklischeextends-Kette, gemeldet von einem Kettendurchlauf, der vom Kombinationsschritt der Schema-Zusammenführung getrennt war; ein einziger Kettendurchlauf meldet jede zyklische Kette, und der Code dafür istE0202.E0230ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Die Bedingung, die diese Nummer nannte, wurde zurückgezogen, und kein Build meldet sie.E0231ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Die Bedingung, die diese Nummer nannte, wurde zurückgezogen, und kein Build meldet sie.E0232ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Die Bedingung, die diese Nummer nannte, wurde zurückgezogen, und kein Build meldet sie.E0233ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Die Bedingung, die diese Nummer nannte, wurde zurückgezogen, und kein Build meldet sie.E0234ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Er nannte eine Recipe-Quelle, die ein leerer String ist, gemeldet beim Rendern über den compose-Provider; das meldet jetzt eine einzige Bedingung, die jeden Provider abdeckt, und ihr Code istE0251.E0235ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Die Bedingung, die diese Nummer nannte, wurde zurückgezogen, und kein Build meldet sie.E0236ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Die Bedingung, die diese Nummer nannte, wurde zurückgezogen, und kein Build meldet sie.E0237ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Die Bedingung, die diese Nummer nannte, wurde zurückgezogen, und kein Build meldet sie.E0238ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Die Bedingung, die diese Nummer nannte, wurde zurückgezogen, und kein Build meldet sie.E0239ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Die Bedingung, die diese Nummer nannte, wurde zurückgezogen, und kein Build meldet sie.E0240ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Die Bedingung, die diese Nummer nannte, wurde zurückgezogen, und kein Build meldet sie.E0241ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Die Bedingung, die diese Nummer nannte, wurde zurückgezogen, und kein Build meldet sie.E0242ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Er nannte eine Recipe-Quelle, die ein leerer String ist, gemeldet beim Rendern über den Helm-Provider; das meldet jetzt eine einzige Bedingung, die jeden Provider abdeckt, und ihr Code istE0251.E0243ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Die Bedingung, die diese Nummer nannte, wurde zurückgezogen, und kein Build meldet sie.E0244ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Die Bedingung, die diese Nummer nannte, wurde zurückgezogen, und kein Build meldet sie.E0245ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Die Bedingung, die diese Nummer nannte, wurde zurückgezogen, und kein Build meldet sie.E0249ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Die Bedingung, die diese Nummer nannte, wurde zurückgezogen, und kein Build meldet sie.E0258ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Die Bedingung, die diese Nummer nannte, wurde zurückgezogen, und kein Build meldet sie.E0322ist ausgemustert: Nichts meldet ihn mehr, und die Nummer wird nie an eine andere Bedingung vergeben. Er nannte einen Wert, den ein an eine Boundary angebundenes Feature für die Umgebung einer Komponente unter einem Schlüssel berechnete, den eine andere Anbindung bereits zugestellt hatte. Ein an eine Boundary angebundenes Feature stellt in eine Komponente nur über das injectMapping seines FeatureRecipe zu, und ein Mapping, das einen Schlüssel schreibt, den eine andere Anbindung zugestellt hat, wird unterE0318gemeldet.
Hinweise zum Abgleich
Das Prädikat errors.Is durchläuft die Wrap-Kette, sodass ein Sentinel-Abgleich auch dann funktioniert, wenn der Fehler auf seinem Weg zurück zu Ihnen mehrfach eingehüllt wird. Gleichen Sie mit dem Fehler ab, den eine exportierte Funktion zurückgegeben hat:
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}Es gibt keinen exportierten Einstiegspunkt, der einen ganzen Build ausführt, daher gilt der Abgleich mit errors.Is für Code, der diese Pakete direkt aufruft. Um CI an einen Build zu knüpfen, führen Sie aggrega build aus und lesen dessen Exit-Status und Diagnosen: Ihr Meldungstext ist in fatal-halts.md katalogisiert, ihre Kategorie in error-translation.md, und der Kurzcode in ihrem Kopf in eckigen Klammern wird über die Tabelle aller Bedingungen auf dieser Seite aufgelöst.
Die zwei Wege zum Gaten gibt es, weil die drei Bezeichner unterschiedlich weit reichen. Ein in Go geschriebenes Gate bindet diese Pakete ein, gleicht Sentinels ab und kann jeden der beiden Codes von jedem Fehler ablesen, den es hält. Ein um den Befehl herum geschriebenes Gate hat den Exit-Status und den ausgegebenen Text — und der ausgegebene Text nennt die Bedingung, weil der Kurzcode im Kopf in eckigen Klammern steht. Ein solches Gate richtet sich also nach diesem Kurzcode statt nach dem Wortlaut der Meldung, und die nach Meldungen geordneten Sichten bleiben der Weg, von einem bereits vorliegenden Wortlaut zurückzugehen. Gleichen Sie den Sentinel aus Go ab; richten Sie sich um den Befehl herum nach dem Kurzcode; lesen Sie den beschreibenden Code aus der strukturierten Diagnose, wo ein Client dieses Protokoll spricht.
Sentinels, die in verschiedenen Paketen mit demselben Kurznamen deklariert sind, sind verschiedene Bedingungen, nicht zwei Schreibweisen einer einzigen: errors.Is unterscheidet sie anhand der Identität, sodass ein Abgleich mit dem einen nicht auf den anderen passt. Die in den Tabellen hervorgehobenen Reexporte sind die Ausnahme, und sie werden gerade deshalb hervorgehoben, weil sie der Fall sind, in dem zwei Namen tatsächlich übereinstimmen. Gleichen Sie mit dem Namen in dem Paket ab, unter dem die Tabellen ihn aufführen, und behandeln Sie einen Kurznamen für sich allein als mehrdeutig.
Für den Katalog der benutzerseitigen Diagnosen (die Meldungen, die Entwickler in ihrem Terminal sehen, wenn ein Build abbricht) siehe fatal-halts.md. Für den Katalog der Hinweise (die nicht abbrechende Ausgabe warning:, lint: und notice:) siehe warnings.md. Für die Taxonomie der Kategoriepräfixe ([DEVELOPER_ERROR] / [OPS_ERROR] / [CATALOG_ERROR] / [TRANSLATION_ERROR] / [FETCH_ERROR] / [POLICY_ERROR] / [TRUST_ERROR]) siehe error-translation.md.