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