Сентинели помилок — канонічний довідник
Кожна фатальна зупинка, яку видає компілятор, називає умову, і кожна умова має три ідентифікатори, бо розпізнати умову, зафіксувати її та процитувати — три різні завдання. Сентинел — це значення 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. Зіставляйте сентинел, щоб розпізнати умову; зчитуйте код, щоб її записати.
Код, який aggrega друкує в терміналі, — короткий, а не цей. Діагностика зупинки починається із заголовка у квадратних дужках, що містить короткий код умови, а поруч — категорію випадку, якщо вона є: [DEVELOPER_ERROR E0007], або [TRANSLATION_ERROR provider/example:1.0.0/E0007], коли умову породив плагін і код уточнено плагіном, що її породив, або [E0007], коли збій не має сфери відповідальності, до якої вас скерувати, — а далі розташування в джерелі та текст повідомлення, каталогізований у fatal-halts.md. Описовий код називає умову словами і задовгий для цієї позиції: для найдовших умов він заповнив би вузький термінал ще до початку повідомлення, і саме тому існує другий, компактний ідентифікатор. Тож коли у вас є лише надрукований вивід, працюйте з коротким кодом, який розв’язується за таблицею всіх умов нижче на цій сторінці: від номера, який можна продиктувати телефоном, ви доходите до умови, її функції доступу та тексту повідомлення. aggrega explain <code> виконує це розв’язання в терміналі — команда приймає будь-який із двох кодів умови й друкує умову разом із записом, що документує виправлення для авторів; її описано в aggrega explain. Подання за повідомленнями у fatal-halts.md лишаються способом працювати від формулювання, а не від ідентифікатора.
Поза Go код потрапляє у структуровану діагностику, яку публікує демон компілятора-як-сервісу, як окреме поле code у кожному записі, а не як щось вбудоване в текст повідомлення, — тож розширення редактора чи будь-який інший клієнт цього протоколу розгалужується за тим, що повідомляє запис, не підключаючи цих пакетів і не розбираючи прозу. Цей один ключ містить машинно зіставний код, хоч би хто його призначив, а запис указує, який шар його породив. Код там має три джерела, і третє — причина, чому код, який можна знайти на цій сторінці, не є сам по собі ознакою того, що щось зазнало збою:
- Код умови, яку називає збій, — саме їх каталогізує ця сторінка.
- Код класу попередження про відрендерений вихід —
unsupported-fieldє одним із них, і його описано у warnings.md. Його призначають там, де виникло попередження, а не реєструють як умову, тож рядка тут він не має. - Зареєстрований код попередження про авторські документи — назва, що на одну правку відрізняється від оголошеної, параметр, який ніщо не читає. Така знахідка називає умову в тій самій формі, що й збій, тож її код зареєстровано і він має рядок на цій сторінці, а прочитавши цей рядок, ви дізнаєтеся, про що знахідка.
Тож той самий код, який ви зчитали б із зупинки, може надійти й зі збірки, що завершилася, разом зі знахідкою, яка ніяк не змінила результату. Розрізняє їх отриманий вами результат і шар, який називає запис, — ніколи не форма самого коду і ніколи не те, чи розв’язується він тут. Поле відсутнє, коли ніщо, що створило запис, не призначило коду: збій, що не називає жодної власної умови Aggrega, і попередження, джерело якого коду не призначило. aggrega serve документує форму запису, ключ, що називає шар, і умови присутності поля.
Структурована діагностика містить обидва ідентифікатори умови, і розуміння, котрий є котрим, відрізняє ідентифікатор, з яким можна діяти, від того, з яким не можна. Ключ code вище призначено для програми: через дефіс і з назвою умови словами, тож розширення, що розгалужується за ним, читається так, як воно означає, і це значення, яке повідомляє CodeOf у Go. Ключ shortCode поруч призначено для людини — літера E і чотири цифри, той самий токен, який діагностика зупинки друкує в заголовку у квадратних дужках. Його диктують телефоном, вводять у пошук або вставляють у звіт про проблему, і саме за ним упорядковано таблицю всіх умов.
Жоден не є скороченням іншого, і жоден не є запасним варіантом для іншого. Зіставляйте за описовим кодом; показуйте читачеві короткий. Інтерфейс, що пропонував би лише описовий код, давав би авторові ідентифікатор, призначений для зіставлення, а той, що зіставляв би за коротким кодом, зіставляв би за номером, який нічого не каже про умову, — тому передаються обидва, а не обирається один.
Третій ключ, codeDescription, указує, де опубліковано умову, як посилання, яке можна відкрити, щоб дізнатися більше про діагностику. Його адреса веде до таблиці всіх умов на цій сторінці, тож читач, який переходить за ним із редактора, приходить із коротким кодом, за яким упорядковано таблицю. Запис містить короткий код і посилання разом або не містить жодного: обидва присутні саме тоді, коли запис називає зареєстровану умову — таку, що має рядок у цій таблиці, — і обидва відсутні, коли код називає клас попередження або ідентичність правила домовленостей із вашого власного лінтера, яке Aggrega не оголошує, бо для них немає номера і тут немає нічого, що їх описує.
У зворотному напрямку — від коду, який у вас є, до умови, яку він називає, — опублікованим списком є таблиці нижче. Кожен рядок містить код поруч із функцією доступу, яка дає ту саму умову в Go, тож код, зчитаний зі структурованої діагностики, розв’язується в назву, яку можна зіставити, і в текст, який виводить умова. Таблиці охоплюють умови, функцію доступу яких можна імпортувати, а два види кодів лишаються поза ними: код класу, що називає клас попередження, а не умову, і тому не має функції доступу, яку можна поставити поруч, і код, умову якого оголошено лише в пакеті, який не можна імпортувати, і ніде не реекспортовано, тож немає зіставної назви, яку можна поставити поруч. Другий вид усе одно називає умову, і ця умова все одно має короткий код — таблиця всіх умов нижче на цій сторінці впорядкована за коротким кодом, а не за імпортованою назвою, і тому охоплює й їх.
Поверхня для зіставлення за пакетом оголошення
Кожен розділ нижче — це один пакет, який можна імпортувати. Його заголовок — це шлях пакета відносно шляху модуля 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(), і саме це ім’я наведено в таблиці для цього пакета.
Умови без сентинела, з яким можна зіставити
Деякі етапи компіляції оголошують свої сентинели в пакетах, які компілятор не експортує, тож errors.Is немає на що посилатися і жоден матчер не можна написати для них. Їх описано тут, а не зведено в таблицю, бо таблиця на цій сторінці — це обіцянка, що значення в лівому стовпці можна розіменувати.
Їхня діагностика доходить до вас повністю через виведений текст помилки та через подання, впорядковані за повідомленнями, — зокрема fatal-halts.md, — і це підтримуваний спосіб їх розпізнати:
- Побудова топології (побудова графа та сплощення вкладених агрегатів) повідомляє про вкладений Aggregate, який не вдалося завантажити, називаючи недосяжний URI Aggregate; про оголошення
uses:, структурна форма якого не відповідає схемі; про перевищення глибини вкладення; та про колізію ідентифікаторів вузлів після сплощення, коли два вкладені Aggregates компілюються в той самий ідентифікатор вузла і одне ім’я екземпляра треба перейменувати, щоб усунути неоднозначність. - Фіналізація графа (злиття Features між поверхнями Aggregate та Release) повідомляє про тип Feature, оголошений неузгоджено між ними.
- Статичний аналіз (обчислення селекторів і перевірки типобезпеки між вузлами) повідомляє про порушення
selector:; про невдалий пошук у каталозі, після якого він не може продовжити, називаючи недосяжну сутність; та про відхилення політикою, коли плагін, приєднаний у ролі вердикту керування, відхилив зібрану збірку. Відхилення політикою має категоріюPOLICY_ERROR, ім’я плагіна, що відхилив збірку, і повідомлення правила, яке надав плагін. - Рендеринг (диспетчеризація провайдерів і рендеринг для кожного провайдера) повідомляє про невідомого провайдера.
- Вбудований завантажувач хоста Wasm видає власні захисні sentinel-значення — захисне обмеження відхилення маніфесту (плагін запросив можливість доступу до середовища виконання, яку забороняє бар’єр AOT-чистоти), відновлення після паніки гостьового модуля та детерміновану пастку виходу плагіна. Вони з’являються в діагностиці для користувача під час запуску плагіна (наприклад, через
aggrega lint). Автори Plugins, які тестують гостьовий модуль на хості, отримують ті самі умови за іменами, що імпортуються, черезpkg/plugintest, наведений вище.
Щоб зупиняти конвеєр саме на відхиленні політикою, зіставляйте префікс категорії POLICY_ERROR у діагностиці, а не сентинел; категорія — задокументована частина поверхні помилок, описана в 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 проходить ланцюжок обгорток, тому зіставлення з сентинелом працює навіть тоді, коли помилку обгорнуто кілька разів на шляху назад до вас. Зіставляйте з помилкою, яку повернула експортована функція:
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, компонується з цими пакетами, зіставляє сентинели й може прочитати будь-який із кодів з будь-якої помилки, яку вона має. Перевірка, побудована навколо команди, має код завершення та надрукований текст — а надрукований текст називає умову, бо короткий код стоїть у заголовку в квадратних дужках. Тож така перевірка орієнтується на цей короткий код, а не на формулювання повідомлення, а подання за повідомленнями лишаються способом відновити умову за вже наявним формулюванням. Зіставляйте сентинел із Go; орієнтуйтеся на короткий код навколо команди; читайте описовий код зі структурованої діагностики там, де клієнт підтримує цей протокол.
Сентинели, оголошені в різних пакетах з однаковою короткою назвою, — це різні умови, а не два написання однієї: 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.