오류 센티널 — 정식 참조
컴파일러가 내보내는 모든 치명적 중단은 하나의 조건을 지명하며, 각 조건은 세 가지 식별자를 가집니다. 조건을 인식하는 일, 기록하는 일, 인용하는 일이 서로 다른 세 가지 작업이기 때문입니다. 센티널은 errors.Is가 일치시키는 Go 값으로, 선언 패키지가 내보내는 접근자를 호출해 얻습니다. 즉 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. 코드에는 접두사가 없습니다. 코드를 선언하는 패키지도, 코드를 발생시키는 단계도, 어떤 종류의 그룹도 붙지 않습니다. 따라서 컴파일러가 코드 주변에서 재구성되어도 코드는 그대로 유지되며, 한 번의 컴파일에서 여러 지점에서 발생하는 조건도 여전히 하나의 이름을 가집니다. 모든 조건의 이름은 그 자체로 고유하므로 접두사가 필요 없으며, 두 조건을 하나의 코드로 등록할 수는 없습니다. 오류에서 코드를 읽으려면 github.com/aggrega-ai/aggrega-cli/pkg/errors의 CodeOf를 사용합니다. 이 함수는 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 바깥으로 전달되는 곳은 compiler-as-service 데몬이 게시하는 구조화된 진단입니다. 코드는 메시지 텍스트에 섞이지 않고 각 항목의 독립된 code 필드로 담깁니다. 따라서 에디터 확장이나 해당 프로토콜의 다른 클라이언트는 이 패키지들을 링크하거나 문장을 파싱하지 않고도 항목이 보고하는 내용에 따라 분기할 수 있습니다. 이 하나의 키는 누가 할당했든 기계가 매칭할 수 있는 코드를 담으며, 항목은 어느 계층이 이를 발생시켰는지 알려 줍니다. 그곳의 코드에는 세 가지 출처가 있으며, 세 번째 출처 때문에 이 페이지에서 찾을 수 있는 코드라고 해서 그것만으로 무언가 실패했다는 신호는 아닙니다.
- 실패가 명명하는 조건의 코드. 이 페이지가 정리하는 것이 이것입니다.
- 렌더링된 출력에 관한 권고의 클래스 코드.
unsupported-field가 그 예이며, warnings.md에서 설명합니다. 이 코드는 조건으로 등록되지 않고 권고가 발생한 곳에서 할당되므로, 여기에는 해당 행이 없습니다. - 작성된 문서에 관한 권고의 등록된 코드. 선언된 이름에서 한 번의 편집만큼 다른 이름, 아무것도 읽지 않는 매개변수 등이 이에 해당합니다. 이러한 발견 사항은 실패와 같은 형태로 조건을 명명하므로 그 코드는 등록되어 있고 이 페이지에 행이 있으며, 그 행을 읽으면 발견 사항이 무엇에 관한 것인지 알 수 있습니다.
따라서 중단에서 읽을 수 있는 것과 같은 코드가, 결과를 전혀 바꾸지 않은 발견 사항에 담겨 완료된 빌드에서 전달될 수도 있습니다. 둘을 구분하는 것은 주어진 결과와 항목이 명명하는 계층이며, 코드 자체의 형태나 여기에서 확인되는지 여부로는 결코 구분되지 않습니다. 항목을 생성한 어떤 것도 코드를 할당하지 않은 경우, 즉 Aggrega 자체의 조건을 명명하지 않는 실패와 발생시킨 쪽이 코드를 할당하지 않은 권고에서는 이 필드가 생략됩니다. aggrega serve에 항목의 형태, 계층을 명명하는 키, 필드가 존재하는 경우가 설명되어 있습니다.
구조화된 진단은 조건의 두 식별자를 모두 담으며, 어느 것이 어느 것인지 아는 것이 활용할 수 있는 식별자와 활용할 수 없는 식별자의 차이입니다. 위의 code 키는 프로그램을 위한 것입니다. 하이픈으로 연결되어 조건을 단어로 명명하므로 이를 기준으로 분기하는 확장은 의미 그대로 읽히며, Go에서 CodeOf가 보고하는 값입니다. 그 옆의 shortCode 키는 사람을 위한 것입니다. 문자 E와 네 자리 숫자로, 중단 진단이 대괄호 머리에 출력하는 것과 같은 토큰입니다. 전화로 읽어 주거나, 검색창에 입력하거나, 이슈에 붙여 넣는 것이 이것이며, 모든 조건의 표의 키가 되는 토큰입니다.
어느 쪽도 다른 쪽의 줄임말이 아니며, 어느 쪽도 다른 쪽의 대체 수단이 아닙니다. 매칭은 서술적 코드로 하고, 읽는 사람에게는 짧은 코드를 보여 줍니다. 서술적 코드만 제공하는 화면은 매처를 위한 식별자를 작성자에게 건네는 셈이며, 짧은 코드로 매칭하는 화면은 조건에 대해 아무것도 말해 주지 않는 번호로 매칭하는 셈입니다. 그래서 하나를 고르지 않고 둘 다 전달합니다.
세 번째 키인 codeDescription은 조건이 게시된 위치를 담으며, 진단에 대해 더 알아보기 위해 열 수 있는 참조입니다. 그 주소는 이 페이지의 모든 조건의 표로 연결되므로, 에디터에서 이를 따라온 독자는 표의 키인 짧은 코드를 가진 채 도착합니다. 항목은 짧은 코드와 참조를 함께 담거나, 둘 다 담지 않습니다. 항목이 등록된 조건, 즉 그 표에 행이 있는 조건을 명명하는 경우에만 둘 다 존재하며, 코드가 권고의 클래스를 명명하거나 Aggrega가 선언하지 않은 자체 린터의 관례 규칙 식별자를 명명하는 경우에는 둘 다 없습니다. 그런 것에는 인용할 번호도, 여기에서 설명하는 내용도 없기 때문입니다.
반대 방향, 즉 가지고 있는 코드에서 그것이 명명하는 조건으로 가려면 아래의 표가 게시된 목록입니다. 각 행은 Go에서 같은 조건을 반환하는 접근자 옆에 코드를 담으므로, 구조화된 진단에서 읽은 코드는 매칭할 수 있는 이름과 조건이 렌더링하는 텍스트로 확인됩니다. 표는 접근자를 import할 수 있는 조건을 다루며, 두 종류의 코드는 표 밖에 있습니다. 하나는 조건이 아니라 권고의 클래스를 명명하므로 옆에 둘 접근자가 없는 클래스 코드이고, 다른 하나는 조건이 import할 수 없는 패키지에서만 선언되고 어디에서도 재export되지 않아 옆에 둘 매칭 가능한 이름이 없는 코드입니다. 두 번째 종류도 여전히 조건을 명명하며 그 조건에도 짧은 코드가 있습니다. 이 페이지 아래쪽의 모든 조건의 표는 import 가능한 이름이 아니라 짧은 코드를 키로 하므로 이러한 조건도 다룹니다.
선언 패키지별 매칭 가능한 표면
아래의 각 절은 가져올 수 있는 패키지 하나에 해당합니다. 절의 제목은 모듈 경로 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()에 대한 매칭도 이 센티널에 대해 성공합니다. 센티널을 선언하는 대신 감싸기 때문에 함수가 아니라 값으로 export됩니다. 괄호 없이 ErrCacheMetadataInvalid로 매칭합니다. 해당 특정 조건을 원할 때는 래퍼를, 무결성 부류 전체를 원할 때는 감싸진 센티널을 매칭합니다.
한 패키지 안에서 두 번째 이름으로 접근할 수 있는 센티널
패키지가 하나의 조건에 대해 두 개의 접근자를 내보내는 경우(두 번째 접근자는 첫 번째 접근자로의 전달로 선언됨), 위의 표는 선언하는 접근자를 싣고 전달하는 이름은 제외합니다. 두 이름은 모두 같은 패키지에서 내보내지므로 어느 한쪽에 도달하는 import는 이미 다른 쪽에도 도달하며, 두 번째 행을 두면 새로운 것과 전혀 일치하지 않는 이름으로 하나의 조건을 두 번 나열하게 됩니다. 어느 이름으로 매칭해도 성공합니다. 전달은 선언하는 접근자가 반환하는 것과 같은 값을 반환하기 때문입니다.
이는 패키지 간의 경우와 다릅니다. 다른 패키지에서 다시 내보낸 센티널은 각 패키지의 표에 행을 가집니다. 그 패키지 중 하나를 import하는 매처는 다른 패키지도 import하지 않으면 다른 쪽의 이름에 도달할 수 없기 때문입니다. 반면 단일 패키지 안의 전달은 두 번째 행이 필요하지 않습니다. import 하나로 두 이름 모두에 도달하기 때문입니다.
pkg/catalog의 ErrDuplicateRecipeIdentity()가 이러한 전달입니다. 이 접근자는 ErrDuplicateEntityIdentity()를 반환하며, 해당 패키지의 표에 실린 이름이 바로 이것입니다.
매칭 가능한 sentinel이 없는 조건
일부 컴파일 단계는 컴파일러가 내보내지 않는 패키지에 sentinel을 선언하므로, errors.Is가 참조할 대상이 없고 이에 대한 매처를 작성할 수 없습니다. 이 페이지의 표는 왼쪽 열을 역참조할 수 있다는 약속이므로, 이러한 조건은 표로 정리하지 않고 여기에서 설명합니다.
이러한 조건의 진단은 출력되는 오류 텍스트와 메시지 기반 보기(특히 fatal-halts.md)를 통해 모두 전달되며, 이것이 이러한 조건을 식별하는 지원되는 방법입니다.
- 토폴로지 구성(그래프 구성 및 하위 aggregate 평탄화)은 로드할 수 없는 하위 Aggregate(도달할 수 없는 Aggregate URI를 명시), 구조적 형태가 스키마와 일치하지 않는
uses:선언, 중첩 깊이 초과, 그리고 평탄화된 노드 ID 충돌을 보고합니다. 노드 ID 충돌은 두 하위 Aggregates가 같은 노드 ID로 컴파일되는 경우로, 구분하려면 인스턴스 이름 하나를 변경해야 합니다. - 그래프 최종화(Aggregate와 Release 표면에 걸친 Feature 병합)는 두 표면 사이에서 일관되지 않게 선언된 Feature 유형을 보고합니다.
- 정적 분석(셀렉터 평가 및 노드 간 타입 안전성 검사)은
selector:위반, 더 진행할 수 없는 카탈로그 확인 실패(도달할 수 없는 엔터티를 명시), 그리고 거버넌스 판정 역할에 연결된 플러그인이 조립된 빌드를 거부한 정책 거부를 보고합니다. 정책 거부에는POLICY_ERROR범주, 거부한 플러그인의 이름, 플러그인이 제공한 규칙 메시지가 포함됩니다. - 렌더링(provider 디스패치 및 provider별 렌더링)은 알 수 없는 provider를 보고합니다.
- 내장 Wasm 호스트 로더는 자체 가드레일 센티널을 내보냅니다. 매니페스트 거부 가드레일(플러그인이 AOT 순수성 방화벽이 거부하는 런타임 접근 기능을 요청한 경우), 게스트 패닉 복구, 그리고 결정적인 플러그인 종료 트랩입니다. 이들은 플러그인을 실행할 때(예:
aggrega lint를 통해) 사용자에게 표시되는 진단에 나타납니다. 호스트를 대상으로 게스트를 테스트하는 Plugin 작성자는 위에 나열된pkg/plugintest를 통해 가져올 수 있는 이름으로 동일한 조건에 접근합니다.
정책 거부에 대해서만 파이프라인을 제어하려면 sentinel 대신 진단의 POLICY_ERROR 범주 접두사를 매칭하십시오. 범주는 오류 표면의 문서화된 일부이며, error-translation.md에 설명되어 있습니다.
모든 조건, 짧은 코드별
아래 표는 조회를 반대 방향으로 수행합니다. 왼쪽 열에 짧은 코드가 있고, 그 옆에 해당 코드가 가리키는 조건과 그 조건이 출력하는 텍스트가 있습니다. 위 섹션들이 나열할 수 없는 조건을 포함하여, aggrega가 보고할 수 있는 모든 조건을 다룹니다.
이 넓은 범위는 우연이 아니라 이 표의 목적입니다. 위 섹션들은 import할 수 있는 이름을 키로 삼으므로, import할 수 없는 패키지에만 선언되고 import할 수 있는 어디에서도 다시 export되지 않는 조건은 왼쪽 열에 넣을 것이 없습니다. 이 표는 짧은 코드를 키로 삼으며 모든 조건에는 짧은 코드가 있으므로, 보고 가능한 조건 중 이 표에서 빠지는 것은 없습니다. 가지고 있는 짧은 코드는 그 뒤의 조건에 매칭할 수 있는 접근자가 있든 없든 여기에서 확인됩니다.
이 표에 실리는 기준은 컴파일러가 실제로 그 조건을 보고할 수 있는지입니다. 행은 코드에 옮겨 적은 것이 아니라 코드에서 도출됩니다. 조건이 여기에 나타나는 것은 컴파일러의 무언가가 그 조건을 발생시키기 때문이므로, 왼쪽 열의 모든 코드는 aggrega가 출력할 수 있는 코드입니다. 이것이 이 표가 하는 약속이며, 각 행을 실제로 실행되는 검사로 읽을 수 있게 해 줍니다.
의도된 예외는 이를 보고하는 코드가 존재하기 전에 선언된 조건입니다. 코드와 문구가 미리 확정되어 이미 인용한 독자에게서 바뀌는 일이 없도록 하기 위함입니다. 그러한 조건은 표 바로 아래의 주석에서 그 사실을 밝힙니다. 이는 숨겨지지 않고 나열되며(가지고 있는 코드는 항상 확인될 수 있어야 합니다), 그 옆의 주석은 아직 어떤 빌드도 이를 발생시키지 않는다는 점과, 발생시키려면 무엇이 존재해야 하는지를 분명히 알려 줍니다.
폐기된 번호도 표 아래의 별도 주석 모음에 나열되며, 영구히 나열된 채로 남습니다. 조건은 가끔 철회됩니다. 더 넓은 범위를 다루는 조건으로 대체되거나, 어떤 것도 그 조건을 보고한 적이 없는 경우입니다. 그 순간부터 해당 번호는 폐기됩니다. 폐기된 번호는 다른 조건에 절대 부여되지 않으므로, 오래된 보고서에서 인용한 짧은 코드는 그 보고서가 작성될 때 가리키던 것만을 가리킬 수 있습니다. 이 약속은 편집상의 것이 아니라 기계적인 것입니다. 폐기된 번호로 선언된 조건은 매 실행마다 컴파일러가 입력을 읽기 전에 거부되므로, 어떤 release도 그런 조건을 포함할 수 없습니다. 이는 살아 있는 두 조건이 한 번호를 공유하려 할 때 받는 것과 같은 종류의 거부이며, 둘 중 어느 쪽에 해당하는지 구별할 수 있도록 문구가 작성되어 있습니다. 폐기된 코드의 주석은 폐기 시 기록된 경우 그 코드가 무엇을 가리켰는지, 그리고 조건이 대체된 경우 이제 어떤 코드가 그 범위를 보고하는지 알려 줍니다.
번호를 재사용하지 않기 때문에 번호 순서에는 영구적인 빈칸이 생기며, 주석은 그 빈칸을 읽을 수 있게 해 줍니다. 빠진 번호는 그 자체로는 아무것도 입증하지 않습니다. 폐기된 번호일 수도 있고, 아직 아무것도 도달하지 않은 번호일 수도 있습니다. 주석은 어떤 번호가 폐기되었고, 기록된 경우 각각 무엇을 가리켰는지에 대한 기록이므로, 행에도 주석에도 해당하지 않는 코드는 이 컴파일러가 발행한 적이 없는 코드입니다.
짧은 코드는 의도적으로 불투명합니다. 네 자리 숫자는 그 자체로 조건에 대해 아무것도 말하지 않으며, 이는 소리 내어 읽거나, 검색창에 입력하거나, 보고서에 붙여 넣을 만큼 짧은 식별자의 대가입니다. 아래의 대응표가 이를 쓸모 있게 만듭니다. 번호는 하나의 오름차순 순서에서 한 번 부여되며 그 이후로 고정됩니다. 번호는 그것이 가리키는 조건에 대해 아무것도 말하지 않습니다. 따라서 짧은 코드는 식별자일 뿐 그 이상이 아닙니다. 그 값은 분류가 아니며, 코드도, 표에서 눈에 띌 수 있는 어떤 묶음도 조건이 어디에 있는지 또는 무엇에 관한 것인지에 대한 안내가 아닙니다.
표에는 카테고리 열이 없으며, 이는 누락이 아닙니다. 카테고리는 그 뒤의 조건이 아니라 특정 실패의 속성이기 때문입니다. 일부 조건은 구조상 하나의 카테고리에 속합니다. 다른 조건의 경우 카테고리는 실패가 관련된 엔터티의 종류에 따라 정해지므로, 그러한 조건 하나가 한 번은 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는 폐기되었습니다. 이제 이를 보고하는 것은 없으며, 이 번호는 다른 조건에 절대 부여되지 않습니다. 이 번호는 그래프의 정적 계약을 검사하는 동안 실패하는 카탈로그 조회, 즉 작성된 문서가 아니라 컴파일러의 결함을 가리켰습니다. 이제 그 상태는 빌드가 읽는 카탈로그에 그 시점에 항목이 없는 component 타입을 빌드가 해석할 때 발생하는 조건이 보고하며, 그 코드는E0154입니다.E0134는 폐기되었습니다. 이제 이를 보고하는 것은 없으며, 이 번호는 다른 조건에 절대 부여되지 않습니다. 이 번호는 디렉터리 이름이 엔터티가 선언한 버전을 따르지 않은 게시 가능 엔터티를 가리켰습니다. 게시는 디렉터리 이름을 판단하지 않으며, 자신의 종류에 전용 디렉터리가 있는데 엔터티가 다른 엔터티와 디렉터리를 공유할 때 발생하는 조건은E0303입니다.E0157은 폐기되었습니다. 이제 이를 보고하는 것은 없으며, 이 번호는 다른 조건에 절대 부여되지 않습니다. 이 번호는 작성된 이름 패턴과 일치하지 않는 Aggregate 키(component, feature, subsystem 또는 중첩 모듈 인스턴스 이름)를 가리켰습니다. 이러한 키 표면은 모두 Aggregate 스키마에 의해 같은 철자로 제한되며, 스키마는 문서의 엔벌로프를 검증하는 동안 문서를 거부하고 문제가 된 키를 줄과 열과 함께 보고합니다. 그 조건의 코드는E0215입니다.E0159는 폐기되었습니다. 이제 이를 보고하는 것은 없으며, 이 번호는 다른 조건에 절대 부여되지 않습니다. 이 번호는 점으로 구분된 세그먼트가 모두 인스턴스 이름 패턴과 일치하지는 않는 대상 참조를 가리켰으며, 조건이 철회되기 전까지 어떤 빌드도 이를 보고하지 않았습니다.E0166은 폐기되었습니다. 이제 이를 보고하는 것은 없으며, 이 번호는 다른 조건에 절대 부여되지 않습니다. 이 번호는 Release의parameters: { $import: … }가 가리키는 파일을 읽을 수 없거나 그 바이트가 파싱되지 않는 경우를 가리켰습니다. 문서를 산출하지 않는 파일은 경로가 어디에 작성되었든 하나의 조건이며, 그 코드는E0175입니다.E0203은 폐기되었습니다. 이제 이를 보고하는 것은 없으며, 이 번호는 다른 조건에 절대 부여되지 않습니다. 이 번호는eval기능에서 소스, values 오버레이, 워크로드 또는 아티팩트를 선언한 FeatureRecipe를 가리켰습니다. 그 기능은 철회되었으며, 이제 이 상태를 보고하는 것은 없습니다.E0206은 폐기되었습니다. 이제 이를 보고하는 것은 없으며, 이 번호는 다른 조건에 절대 부여되지 않습니다. 이 번호는eval기능에서 소스, 워크로드, 아티팩트 또는 values 오버레이를 선언한 Recipe를 가리켰습니다. 그 기능은 철회되었으며, 그중 아무것도 선언하지 않은 Recipe는 모든 기능에서E0210으로 거부됩니다.E0217은 폐기되었습니다. 이제 이를 보고하는 것은 없으며, 이 번호는 다른 조건에 절대 부여되지 않습니다. 이 번호는 특정 필드에 대해 보고할 수 없는 스키마 검증 실패를 가리켰으며, 조건이 철회되기 전까지 어떤 빌드도 이를 보고하지 않았습니다.E0219는 폐기되었습니다. 이제 이를 보고하는 것은 없으며, 이 번호는 다른 조건에 절대 부여되지 않습니다. 이 번호는 스키마 병합의 결합 단계와 별도인 체인 탐색이 보고하던 순환extends체인을 가리켰습니다. 단일 체인 탐색이 모든 순환 체인을 보고하며, 그 코드는E0202입니다.E0230은 폐기되었습니다. 이제 이를 보고하는 것은 없으며, 이 번호는 다른 조건에 절대 부여되지 않습니다. 이 번호가 가리키던 조건은 철회되었으며, 어떤 빌드도 이를 보고하지 않습니다.E0231은 폐기되었습니다. 이제 이를 보고하는 것은 없으며, 이 번호는 다른 조건에 절대 부여되지 않습니다. 이 번호가 가리키던 조건은 철회되었으며, 어떤 빌드도 이를 보고하지 않습니다.E0232는 폐기되었습니다. 이제 이를 보고하는 것은 없으며, 이 번호는 다른 조건에 절대 부여되지 않습니다. 이 번호가 가리키던 조건은 철회되었으며, 어떤 빌드도 이를 보고하지 않습니다.E0233은 폐기되었습니다. 이제 이를 보고하는 것은 없으며, 이 번호는 다른 조건에 절대 부여되지 않습니다. 이 번호가 가리키던 조건은 철회되었으며, 어떤 빌드도 이를 보고하지 않습니다.E0234는 폐기되었습니다. 이제 이 코드를 보고하는 것은 없으며, 이 번호는 다른 조건에 부여되지 않습니다. 이 번호는 compose provider를 통해 렌더링하는 중에 보고되는, 빈 문자열인 Recipe 소스를 가리켰습니다. 이제는 모든 provider를 포괄하는 하나의 조건이 이를 보고하며, 그 코드는E0251입니다.E0235는 폐기되었습니다. 이제 이 코드를 보고하는 것은 없으며, 이 번호는 다른 조건에 부여되지 않습니다. 이 번호가 가리키던 조건은 철회되었으며, 어떤 빌드도 이를 보고하지 않습니다.E0236는 폐기되었습니다. 이제 이 코드를 보고하는 것은 없으며, 이 번호는 다른 조건에 부여되지 않습니다. 이 번호가 가리키던 조건은 철회되었으며, 어떤 빌드도 이를 보고하지 않습니다.E0237는 폐기되었습니다. 이제 이 코드를 보고하는 것은 없으며, 이 번호는 다른 조건에 부여되지 않습니다. 이 번호가 가리키던 조건은 철회되었으며, 어떤 빌드도 이를 보고하지 않습니다.E0238는 폐기되었습니다. 이제 이 코드를 보고하는 것은 없으며, 이 번호는 다른 조건에 부여되지 않습니다. 이 번호가 가리키던 조건은 철회되었으며, 어떤 빌드도 이를 보고하지 않습니다.E0239는 폐기되었습니다. 이제 이 코드를 보고하는 것은 없으며, 이 번호는 다른 조건에 부여되지 않습니다. 이 번호가 가리키던 조건은 철회되었으며, 어떤 빌드도 이를 보고하지 않습니다.E0240는 폐기되었습니다. 이제 이 코드를 보고하는 것은 없으며, 이 번호는 다른 조건에 부여되지 않습니다. 이 번호가 가리키던 조건은 철회되었으며, 어떤 빌드도 이를 보고하지 않습니다.E0241는 폐기되었습니다. 이제 이 코드를 보고하는 것은 없으며, 이 번호는 다른 조건에 부여되지 않습니다. 이 번호가 가리키던 조건은 철회되었으며, 어떤 빌드도 이를 보고하지 않습니다.E0242는 폐기되었습니다. 이제 이 코드를 보고하는 것은 없으며, 이 번호는 다른 조건에 부여되지 않습니다. 이 번호는 Helm provider를 통해 렌더링하는 중에 보고되는, 빈 문자열인 Recipe 소스를 가리켰습니다. 이제는 모든 provider를 포괄하는 하나의 조건이 이를 보고하며, 그 코드는E0251입니다.E0243는 폐기되었습니다. 이제 이 코드를 보고하는 것은 없으며, 이 번호는 다른 조건에 부여되지 않습니다. 이 번호가 가리키던 조건은 철회되었으며, 어떤 빌드도 이를 보고하지 않습니다.E0244는 폐기되었습니다. 이제 이 코드를 보고하는 것은 없으며, 이 번호는 다른 조건에 부여되지 않습니다. 이 번호가 가리키던 조건은 철회되었으며, 어떤 빌드도 이를 보고하지 않습니다.E0245는 폐기되었습니다. 이제 이 코드를 보고하는 것은 없으며, 이 번호는 다른 조건에 부여되지 않습니다. 이 번호가 가리키던 조건은 철회되었으며, 어떤 빌드도 이를 보고하지 않습니다.E0249는 폐기되었습니다. 이제 이 코드를 보고하는 것은 없으며, 이 번호는 다른 조건에 부여되지 않습니다. 이 번호가 가리키던 조건은 철회되었으며, 어떤 빌드도 이를 보고하지 않습니다.E0258는 폐기되었습니다. 이제 이 코드를 보고하는 것은 없으며, 이 번호는 다른 조건에 부여되지 않습니다. 이 번호가 가리키던 조건은 철회되었으며, 어떤 빌드도 이를 보고하지 않습니다.E0322는 폐기되었습니다. 이제 이를 보고하는 것은 없으며, 이 번호는 다른 조건에 절대 부여되지 않습니다. 이 번호는 경계에 연결된 Feature가 컴포넌트의 환경을 위해, 다른 연결이 이미 전달한 키에 계산한 값을 가리켰습니다. 경계에 연결된 Feature는 자신의 FeatureRecipe의 injectMapping을 통해서만 컴포넌트에 전달하며, 다른 연결이 전달한 키를 쓰는 매핑은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를 참조하십시오.