Files
clean-architecture-frontend…/config/contracts/registry-baseline.json
T
DongHyeonka 70d0ac1ca2 chore(registry): 레지스트리 기준선을 재승인하고 옮긴 source 경로를 바로잡는다
문제
registry-baseline.json의 FE-REG-API·FE-REG-SCHEMA source가 15-01(298201f,
기능 실행부 분리) 뒤에도 src/features/installed-feature-contracts.ts를
가리킨다. 두 레지스트리는 지금 src/features/loaded-feature-runtimes.ts에
있다. 기준선 diff는 contract와 rows만 비교하고 source는 보지 않아서 아무
검사도 이를 잡지 못했다. 또 0929/07-03(FE-REG-ROUTE contract 변경)과
1101/16-03(FE-REG-API authProfileId 3건)이 증거와 diff로만 남아 있다.

고른 방법
- 기준선을 한 번 재승인했다. update:registry-baseline의 node 하위 명령을
  직접 실행했다(pnpm은 쓰지 않음):
    node scripts/generate-product-feature-index.ts
    node scripts/check-registries.ts --no-baseline \
      --artifact artifacts/quality/registry-current-snapshot.json
    REGISTRY_BASELINE_OWNER=DongHyeonka REGISTRY_BASELINE_REASON=...
      node scripts/update-registry-baseline.ts
  owner는 DongHyeonka, reason은 "2026-11-03 사용자가 결정을 위임함:
  0929/07-03, 1101/16-03, 15-01 source 경로. 승인 뒤 쌓인
  0925/08-13·1101/05-01(증거로 유지), VITE_BUILD_ID 기본값·
  service-worker.start.failed 행(증거 불필요)도 함께 흡수"다. 사용자가 이
  결정을 오케스트레이터에게 위임했고, 재승인은 A8만 한다.
- 새 기준선은 지금 스냅샷이라 source 경로가 실제 파일로 바뀌었다. 같은
  재승인이 이전 승인(2026-09-25) 뒤 쌓인 변경을 모두 흡수한다:
  FE-REG-ROUTE allowedValues 축소와 fieldPatterns 추가(0929/07-03),
  authProfileId 3건(1101/16-03), REFERENCE_RESOURCE_DETAIL.path(0925/08-13),
  CACHE_INVALIDATION_PULSE backend·valueCodec과 STORAGE backend 허용값
  external(1101/05-01), VITE_BUILD_ID defaultValue(13-15),
  service-worker.start.failed 텔레메트리 행(0925/06-05).
- update:registry-baseline이 0929/07-01 (3)대로 증거 5건을 지웠다(위
  08-13 1건, 05-01 2건, 07-03 2건). 증거 파일은 빈 목록이다. 지운 행은
  git 이력에 있다.
- 재발 방지 테스트: 기준선의 source가 governance path와 다르면
  registry-governance.test.ts가 레지스트리 id를 나열하며 실패한다.

버린 대안
- source만 손으로 고치기: 승인 digest가 깨진다. 재승인 없이 기준선을
  바꾸는 길을 만든다.
- 07-03·16-03 커밋마다 재승인: 지시는 한 번의 재승인이다. 그 사이 각
  커밋은 증거(07-03)나 behavior-change(16-03)로 게이트를 통과했다.
- 기준선 diff가 source도 비교하게 하기: 파일을 옮기는 것은 공개 계약
  변경이 아닌데 breaking 분류가 필요해진다. 테스트로 재승인만 요구한다.

위험·한계
- 레지스트리 파일을 옮기면 이제 테스트가 재승인을 요구한다. 재승인은 그
  시점까지의 변경을 모두 흡수하므로, 옮기기 전에 남은 breaking 변경이
  있으면 그 커밋 본문에 적어야 한다.
- 다운스트림은 이 기준선을 템플릿 이력으로 받는다. 자기 기준선을 다시
  찍는 절차는 0929/07-04 범위다.

검증
- RED(재승인 전): 새 테스트 "names each registry's governed source in the
  approved baseline"가 "expected [ 'FE-REG-API', 'FE-REG-SCHEMA' ] to deeply
  equal []"로 실패.
- GREEN: 같은 테스트 통과. check-registries "11 registries PASS;
  compatibility=none". 승인 digest 3c3702b55ad8849f399833206ea4515808eda6ab6d1fd5c49e90f8579e644170.
- 회귀: tests/{unit,integration,features,contract,runtime-schema}
  207 파일 2,367건 통과(pnpm·프로세스를 띄우는 6개 제외), 그중 제외했던
  deployment-admission은 따로 22/22. compatibility fixtures 11 PASS.
  verify-documentation-readiness PASS_SCOPED. tsc test rc=0, 바꾼 테스트
  eslint rc=0.
- 미실행: check:architecture, test:sample-removal(pnpm 필요).

Refs: docs/reviews/2026-09-29-maturity-review/07-contracts.md
Refs: docs/reviews/2026-11-01-maturity-review/16-structure-patterns.md
2026-11-03 00:55:33 +09:00

1598 lines
47 KiB
JSON

{
"schemaVersion": 2,
"registries": [
{
"registryId": "FE-REG-ROUTE",
"owner": "feature-frontend-routing-release-recovery-runtime",
"source": "src/features/installed-feature-contracts.ts",
"rowCount": 10,
"contract": {
"requiredFields": [
"routeId",
"path",
"paramsSchema",
"searchSchema",
"access",
"loadingSurface",
"errorSurface",
"chunkId",
"title",
"navigationLabel",
"navigationOrder"
],
"fieldTypes": {
"routeId": "string",
"path": "string",
"paramsSchema": "string|null",
"searchSchema": "string|null",
"access": "string",
"loadingSurface": "string",
"errorSurface": "string",
"chunkId": "string",
"title": "string",
"navigationLabel": "string|null",
"navigationOrder": "integer|null"
},
"uniqueFields": [
"routeId",
"path",
"chunkId"
],
"allowedValues": {
"access": [
"public",
"session-required"
],
"errorSurface": [
"route-boundary",
"feature-boundary",
"not-found"
]
},
"references": [
{
"field": "routeId",
"registryId": "FE-REG-ROUTE-RUNTIME",
"targetField": "routeId"
},
{
"field": "paramsSchema",
"registryId": "FE-REG-SCHEMA",
"targetField": "schemaId"
},
{
"field": "searchSchema",
"registryId": "FE-REG-SCHEMA",
"targetField": "schemaId"
}
],
"keyField": "routeId",
"breakingFields": [
"routeId",
"path",
"paramsSchema",
"searchSchema",
"access",
"chunkId"
],
"fieldPatterns": {
"loadingSurface": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
}
},
"rows": {
"APP_HOME": {
"access": "public",
"chunkId": "route-home",
"errorSurface": "route-boundary",
"loadingSurface": "app-shell",
"navigationLabel": "시작",
"navigationOrder": 10,
"paramsSchema": null,
"path": "/",
"routeId": "APP_HOME",
"searchSchema": null,
"title": "시작"
},
"EXAMPLES_AUTH": {
"access": "public",
"chunkId": "route-examples-auth",
"errorSurface": "route-boundary",
"loadingSurface": "example-page",
"navigationLabel": "인증 연동",
"navigationOrder": 40,
"paramsSchema": null,
"path": "/examples/auth",
"routeId": "EXAMPLES_AUTH",
"searchSchema": null,
"title": "인증 연동"
},
"EXAMPLES_PLATFORM": {
"access": "public",
"chunkId": "route-examples-platform",
"errorSurface": "route-boundary",
"loadingSurface": "example-page",
"navigationLabel": "플랫폼 구성",
"navigationOrder": 15,
"paramsSchema": null,
"path": "/examples/platform",
"routeId": "EXAMPLES_PLATFORM",
"searchSchema": null,
"title": "플랫폼 구성"
},
"EXAMPLES_STATES": {
"access": "public",
"chunkId": "route-examples-states",
"errorSurface": "route-boundary",
"loadingSurface": "example-page",
"navigationLabel": "화면 상태",
"navigationOrder": 30,
"paramsSchema": null,
"path": "/examples/states",
"routeId": "EXAMPLES_STATES",
"searchSchema": null,
"title": "화면 상태"
},
"EXAMPLES_UI": {
"access": "public",
"chunkId": "route-examples-ui",
"errorSurface": "route-boundary",
"loadingSurface": "example-page",
"navigationLabel": "UI 구성요소",
"navigationOrder": 20,
"paramsSchema": null,
"path": "/examples/ui",
"routeId": "EXAMPLES_UI",
"searchSchema": null,
"title": "UI 구성요소"
},
"NOT_FOUND": {
"access": "public",
"chunkId": "route-not-found",
"errorSurface": "not-found",
"loadingSurface": "none",
"navigationLabel": null,
"navigationOrder": null,
"paramsSchema": "NotFoundSplat",
"path": "*",
"routeId": "NOT_FOUND",
"searchSchema": null,
"title": "페이지를 찾을 수 없음"
},
"REFERENCE_RESOURCE_DETAIL": {
"access": "session-required",
"chunkId": "route-reference-resource-detail",
"errorSurface": "feature-boundary",
"loadingSurface": "reference-resource-detail",
"navigationLabel": null,
"navigationOrder": null,
"paramsSchema": "ReferenceResourceParams",
"path": "/examples/reference-resources/items/:resourceId",
"routeId": "REFERENCE_RESOURCE_DETAIL",
"searchSchema": null,
"title": "Reference detail"
},
"REFERENCE_RESOURCE_FORM": {
"access": "session-required",
"chunkId": "route-reference-resource-form",
"errorSurface": "feature-boundary",
"loadingSurface": "reference-resource-form",
"navigationLabel": null,
"navigationOrder": null,
"paramsSchema": null,
"path": "/examples/reference-resources/new",
"routeId": "REFERENCE_RESOURCE_FORM",
"searchSchema": null,
"title": "Reference form"
},
"REFERENCE_RESOURCE_LIST": {
"access": "session-required",
"chunkId": "route-reference-resources",
"errorSurface": "feature-boundary",
"loadingSurface": "reference-resource-list",
"navigationLabel": "Reference feature",
"navigationOrder": 50,
"paramsSchema": null,
"path": "/examples/reference-resources",
"routeId": "REFERENCE_RESOURCE_LIST",
"searchSchema": "ReferenceResourceListQuery",
"title": "Reference feature"
},
"REFERENCE_RESOURCE_STATUS": {
"access": "session-required",
"chunkId": "route-reference-resource-status",
"errorSurface": "feature-boundary",
"loadingSurface": "reference-resource-status",
"navigationLabel": null,
"navigationOrder": null,
"paramsSchema": null,
"path": "/examples/reference-resources/status",
"routeId": "REFERENCE_RESOURCE_STATUS",
"searchSchema": null,
"title": "Reference status"
}
}
},
{
"registryId": "FE-REG-ROUTE-RUNTIME",
"owner": "feature-frontend-routing-release-recovery-runtime",
"source": "src/features/installed-feature-contracts.ts",
"rowCount": 10,
"contract": {
"requiredFields": [
"routeId",
"moduleId",
"paramsCodec",
"searchCodec"
],
"fieldTypes": {
"routeId": "string",
"moduleId": "string",
"paramsCodec": "string",
"searchCodec": "string"
},
"uniqueFields": [
"routeId",
"moduleId"
],
"allowedValues": {},
"references": [
{
"field": "routeId",
"registryId": "FE-REG-ROUTE",
"targetField": "routeId"
},
{
"field": "paramsCodec",
"registryId": "FE-REG-SCHEMA",
"targetField": "schemaId"
},
{
"field": "searchCodec",
"registryId": "FE-REG-SCHEMA",
"targetField": "schemaId"
}
],
"keyField": "routeId",
"breakingFields": [
"routeId",
"moduleId",
"paramsCodec",
"searchCodec"
]
},
"rows": {
"APP_HOME": {
"moduleId": "home-page",
"paramsCodec": "none",
"routeId": "APP_HOME",
"searchCodec": "none"
},
"EXAMPLES_AUTH": {
"moduleId": "auth-example-page",
"paramsCodec": "none",
"routeId": "EXAMPLES_AUTH",
"searchCodec": "none"
},
"EXAMPLES_PLATFORM": {
"moduleId": "platform-overview-page",
"paramsCodec": "none",
"routeId": "EXAMPLES_PLATFORM",
"searchCodec": "none"
},
"EXAMPLES_STATES": {
"moduleId": "state-gallery-page",
"paramsCodec": "none",
"routeId": "EXAMPLES_STATES",
"searchCodec": "none"
},
"EXAMPLES_UI": {
"moduleId": "ui-gallery-page",
"paramsCodec": "none",
"routeId": "EXAMPLES_UI",
"searchCodec": "none"
},
"NOT_FOUND": {
"moduleId": "not-found-page",
"paramsCodec": "NotFoundSplat",
"routeId": "NOT_FOUND",
"searchCodec": "none"
},
"REFERENCE_RESOURCE_DETAIL": {
"moduleId": "reference-resource-detail-page",
"paramsCodec": "ReferenceResourceParams",
"routeId": "REFERENCE_RESOURCE_DETAIL",
"searchCodec": "none"
},
"REFERENCE_RESOURCE_FORM": {
"moduleId": "reference-resource-form-page",
"paramsCodec": "none",
"routeId": "REFERENCE_RESOURCE_FORM",
"searchCodec": "none"
},
"REFERENCE_RESOURCE_LIST": {
"moduleId": "reference-resource-page",
"paramsCodec": "none",
"routeId": "REFERENCE_RESOURCE_LIST",
"searchCodec": "ReferenceResourceListQuery"
},
"REFERENCE_RESOURCE_STATUS": {
"moduleId": "reference-resource-status-page",
"paramsCodec": "none",
"routeId": "REFERENCE_RESOURCE_STATUS",
"searchCodec": "none"
}
}
},
{
"registryId": "FE-REG-API",
"owner": "feature-frontend-api-client-response-envelope-contract",
"source": "src/features/loaded-feature-runtimes.ts",
"rowCount": 3,
"contract": {
"requiredFields": [
"method",
"path",
"operationId",
"auth",
"timeoutMs",
"idempotency",
"retry",
"requestSource",
"requestSchema",
"responseSchema",
"owner"
],
"fieldTypes": {
"method": "string",
"path": "string",
"operationId": "string",
"auth": "string",
"timeoutMs": "integer|null",
"idempotency": "string",
"retry": "string",
"requestSource": "string",
"requestSchema": "string",
"responseSchema": "string",
"owner": "string"
},
"uniqueFields": [
"operationId"
],
"allowedValues": {
"method": [
"GET",
"POST",
"PUT",
"PATCH",
"DELETE"
],
"auth": [
"none",
"external-session"
],
"idempotency": [
"safe",
"keyed",
"none"
],
"retry": [
"runtime",
"never"
],
"requestSource": [
"none",
"search",
"body"
]
},
"references": [
{
"field": "requestSchema",
"registryId": "FE-REG-SCHEMA",
"targetField": "schemaId"
},
{
"field": "responseSchema",
"registryId": "FE-REG-SCHEMA",
"targetField": "schemaId"
}
],
"keyField": "operationId",
"breakingFields": [
"method",
"path",
"operationId",
"auth",
"idempotency",
"requestSource",
"requestSchema",
"responseSchema"
]
},
"rows": {
"CREATE_REFERENCE_RESOURCE": {
"auth": "external-session",
"authProfileId": "EXTERNAL_BEARER",
"contractVersion": 2,
"csrfProfileId": "NO_CSRF_BEARER",
"idempotency": "keyed",
"idempotencyKeyPolicy": "REQUIRED",
"mapperId": "ReferenceResourceMapper",
"maxEncodedSearchBytes": 0,
"maxResponseBytes": 32768,
"method": "POST",
"operationId": "CREATE_REFERENCE_RESOURCE",
"owner": "feature-frontend-reference-feature-vertical-slice",
"path": "/api/reference-resources",
"pathParameterNames": [],
"pathSchema": "NoRequest",
"protocol": "REST",
"providerId": "PRIMARY_API",
"replayPolicy": "KEYED_COMMAND",
"requestSchema": "CreateReferenceResourceCommand",
"requestSource": "body",
"responseMediaTypes": [
"application/json"
],
"responseSchema": "ReferenceResourcePayload",
"retry": "runtime",
"semantics": "COMMAND",
"successStatuses": [
200,
201
],
"timeoutMs": null
},
"GET_REFERENCE_RESOURCE": {
"auth": "external-session",
"authProfileId": "EXTERNAL_BEARER",
"contractVersion": 2,
"csrfProfileId": "NO_CSRF_BEARER",
"idempotency": "safe",
"idempotencyKeyPolicy": "NONE",
"mapperId": "ReferenceResourceMapper",
"maxEncodedSearchBytes": 0,
"maxResponseBytes": 32768,
"method": "GET",
"operationId": "GET_REFERENCE_RESOURCE",
"owner": "feature-frontend-reference-feature-vertical-slice",
"path": "/api/reference-resources/{resourceId}",
"pathParameterNames": [
"resourceId"
],
"pathSchema": "ReferenceResourceParams",
"protocol": "REST",
"providerId": "PRIMARY_API",
"replayPolicy": "SAFE",
"requestSchema": "NoRequest",
"requestSource": "none",
"responseMediaTypes": [
"application/json"
],
"responseSchema": "ReferenceResourcePayload",
"retry": "runtime",
"semantics": "QUERY",
"successStatuses": [
200
],
"timeoutMs": null
},
"LIST_REFERENCE_RESOURCES": {
"auth": "external-session",
"authProfileId": "EXTERNAL_BEARER",
"contractVersion": 2,
"csrfProfileId": "NO_CSRF_BEARER",
"idempotency": "safe",
"idempotencyKeyPolicy": "NONE",
"mapperId": "ReferenceResourceListMapper",
"maxEncodedSearchBytes": 4096,
"maxResponseBytes": 262144,
"method": "GET",
"operationId": "LIST_REFERENCE_RESOURCES",
"owner": "feature-frontend-reference-feature-vertical-slice",
"path": "/api/reference-resources",
"pathParameterNames": [],
"pathSchema": "NoRequest",
"protocol": "REST",
"providerId": "PRIMARY_API",
"replayPolicy": "SAFE",
"requestSchema": "ReferenceResourceListQuery",
"requestSource": "search",
"responseMediaTypes": [
"application/json"
],
"responseSchema": "ReferenceResourceListPayload",
"retry": "runtime",
"semantics": "QUERY",
"successStatuses": [
200
],
"timeoutMs": null
}
}
},
{
"registryId": "FE-REG-SCHEMA",
"owner": "feature-frontend-contract-schema-registry",
"source": "src/features/loaded-feature-runtimes.ts",
"rowCount": 8,
"contract": {
"requiredFields": [
"schemaId",
"boundary",
"owner",
"runtime"
],
"fieldTypes": {
"schemaId": "string",
"boundary": "string",
"owner": "string",
"runtime": "string"
},
"uniqueFields": [
"schemaId"
],
"allowedValues": {
"boundary": [
"route-params",
"route-search",
"route-search-api-request",
"api-request",
"api-response"
],
"runtime": [
"zod"
]
},
"references": [],
"keyField": "schemaId",
"breakingFields": [
"schemaId",
"boundary",
"runtime"
]
},
"rows": {
"CreateReferenceResourceCommand": {
"boundary": "api-request",
"direction": "REQUEST",
"owner": "feature-frontend-reference-feature-vertical-slice",
"runtime": "zod",
"schemaId": "CreateReferenceResourceCommand",
"schemaVersion": 1,
"unknownFieldPolicy": "REJECT_UNKNOWN"
},
"none": {
"boundary": "route-params",
"owner": "feature-frontend-routing-release-recovery-runtime",
"runtime": "zod",
"schemaId": "none"
},
"NoRequest": {
"boundary": "api-request",
"direction": "REQUEST",
"owner": "feature-frontend-reference-feature-vertical-slice",
"runtime": "zod",
"schemaId": "NoRequest",
"schemaVersion": 1,
"unknownFieldPolicy": "REJECT_UNKNOWN"
},
"NotFoundSplat": {
"boundary": "route-params",
"owner": "feature-frontend-routing-release-recovery-runtime",
"runtime": "zod",
"schemaId": "NotFoundSplat"
},
"ReferenceResourceListPayload": {
"boundary": "api-response",
"direction": "RESPONSE",
"owner": "feature-frontend-reference-feature-vertical-slice",
"runtime": "zod",
"schemaId": "ReferenceResourceListPayload",
"schemaVersion": 1,
"unknownFieldPolicy": "STRIP_UNKNOWN"
},
"ReferenceResourceListQuery": {
"boundary": "route-search-api-request",
"direction": "REQUEST",
"owner": "feature-frontend-reference-feature-vertical-slice",
"runtime": "zod",
"schemaId": "ReferenceResourceListQuery",
"schemaVersion": 1,
"unknownFieldPolicy": "REJECT_UNKNOWN"
},
"ReferenceResourceParams": {
"boundary": "route-params",
"direction": "REQUEST",
"owner": "feature-frontend-reference-feature-vertical-slice",
"runtime": "zod",
"schemaId": "ReferenceResourceParams",
"schemaVersion": 1,
"unknownFieldPolicy": "REJECT_UNKNOWN"
},
"ReferenceResourcePayload": {
"boundary": "api-response",
"direction": "RESPONSE",
"owner": "feature-frontend-reference-feature-vertical-slice",
"runtime": "zod",
"schemaId": "ReferenceResourcePayload",
"schemaVersion": 1,
"unknownFieldPolicy": "STRIP_UNKNOWN"
}
}
},
{
"registryId": "FE-REG-ENV",
"owner": "feature-frontend-env-runtime-config-contract",
"source": "src/contracts/env.ts",
"rowCount": 16,
"contract": {
"requiredFields": [
"phase",
"classification",
"required",
"defaultValue"
],
"fieldTypes": {
"phase": "string",
"classification": "string",
"required": "boolean",
"defaultValue": "string|integer|boolean|null"
},
"uniqueFields": [],
"allowedValues": {
"phase": [
"build",
"runtime"
],
"classification": [
"public",
"public-sensitive",
"public-metadata",
"compile-time"
]
},
"references": [],
"keyField": null,
"breakingFields": [
"phase",
"classification",
"required"
]
},
"rows": {
"API_BASE_URL": {
"classification": "public-sensitive",
"defaultValue": null,
"phase": "runtime",
"required": true
},
"APP_ENV": {
"classification": "public",
"defaultValue": null,
"phase": "runtime",
"required": true
},
"AUTH_MODE": {
"classification": "public",
"defaultValue": "external",
"phase": "runtime",
"required": true
},
"CAPABILITY_OVERRIDES": {
"classification": "public",
"defaultValue": null,
"phase": "runtime",
"required": false
},
"CONFIG_SCHEMA_VERSION": {
"classification": "public",
"defaultValue": null,
"phase": "runtime",
"required": true
},
"FEATURE_OVERRIDES": {
"classification": "public",
"defaultValue": null,
"phase": "runtime",
"required": false
},
"MAX_RETRY_ATTEMPTS": {
"classification": "public",
"defaultValue": 2,
"phase": "runtime",
"required": false
},
"RELEASE_MANIFEST_URL": {
"classification": "public",
"defaultValue": "/release-manifest.json",
"phase": "runtime",
"required": true
},
"REQUEST_TIMEOUT_MS": {
"classification": "public",
"defaultValue": 10000,
"phase": "runtime",
"required": false
},
"TELEMETRY_ENABLED": {
"classification": "public",
"defaultValue": false,
"phase": "runtime",
"required": true
},
"TELEMETRY_ENDPOINT": {
"classification": "public-sensitive",
"defaultValue": null,
"phase": "runtime",
"required": false
},
"VITE_BUILD_ID": {
"classification": "public-metadata",
"defaultValue": "local-build",
"phase": "build",
"required": true
},
"VITE_COMMIT_SHA": {
"classification": "public-metadata",
"defaultValue": "local",
"phase": "build",
"required": false
},
"VITE_PRODUCT_FEATURES": {
"classification": "compile-time",
"defaultValue": null,
"phase": "build",
"required": false
},
"VITE_ROUTER_BASE_PATH": {
"classification": "compile-time",
"defaultValue": "/",
"phase": "build",
"required": true
},
"VITE_RUNTIME_CONFIG_URL": {
"classification": "compile-time",
"defaultValue": "/config.json",
"phase": "build",
"required": true
}
}
},
{
"registryId": "FE-REG-STORAGE",
"owner": "feature-frontend-storage-registry-contract",
"source": "src/contracts/storage-keys.ts",
"rowCount": 7,
"contract": {
"requiredFields": [
"logicalName",
"physicalKey",
"backend",
"classification",
"schemaVersion",
"valueCodec",
"ttl",
"migration",
"quotaFallback"
],
"fieldTypes": {
"logicalName": "string",
"physicalKey": "string",
"backend": "string",
"classification": "string",
"schemaVersion": "integer",
"valueCodec": "string",
"ttl": "integer|string|null",
"migration": "string",
"quotaFallback": "string"
},
"uniqueFields": [
"logicalName",
"physicalKey"
],
"allowedValues": {
"backend": [
"memory",
"sessionStorage",
"localStorage",
"disabled",
"forbidden",
"external"
],
"classification": [
"public-preference",
"opaque-cache",
"sensitive-forbidden"
],
"valueCodec": [
"color-scheme-v1",
"opaque-string-v1",
"none"
],
"migration": [
"discard"
],
"quotaFallback": [
"memory",
"no-persist",
"feature-disable"
]
},
"references": [],
"keyField": "logicalName",
"breakingFields": [
"logicalName",
"physicalKey",
"backend",
"classification",
"schemaVersion",
"valueCodec",
"migration"
]
},
"rows": {
"AUTH_TOKEN": {
"backend": "forbidden",
"classification": "sensitive-forbidden",
"logicalName": "AUTH_TOKEN",
"migration": "discard",
"name": "auth-token",
"physicalKey": "ca-frontend:auth:v1:auth-token",
"quotaFallback": "feature-disable",
"schemaVersion": 1,
"scope": "auth",
"ttl": null,
"valueCodec": "none"
},
"CACHE_INVALIDATION_PULSE": {
"backend": "external",
"classification": "opaque-cache",
"logicalName": "CACHE_INVALIDATION_PULSE",
"migration": "discard",
"name": "pulse",
"physicalKey": "ca-frontend:cache-invalidation:v1:pulse",
"quotaFallback": "no-persist",
"schemaVersion": 1,
"scope": "cache-invalidation",
"ttl": null,
"valueCodec": "none"
},
"CHUNK_RELOAD_GUARD": {
"backend": "sessionStorage",
"classification": "opaque-cache",
"logicalName": "CHUNK_RELOAD_GUARD",
"migration": "discard",
"name": "chunk-reload-guard",
"physicalKey": "ca-frontend:release:v1:chunk-reload-guard",
"quotaFallback": "no-persist",
"schemaVersion": 1,
"scope": "release",
"ttl": "session",
"valueCodec": "opaque-string-v1"
},
"COLOR_SCHEME": {
"backend": "localStorage",
"classification": "public-preference",
"logicalName": "COLOR_SCHEME",
"migration": "discard",
"name": "color-scheme",
"physicalKey": "ca-frontend:preference:v1:color-scheme",
"quotaFallback": "memory",
"schemaVersion": 1,
"scope": "preference",
"ttl": null,
"valueCodec": "color-scheme-v1"
},
"LOCALE": {
"backend": "localStorage",
"classification": "public-preference",
"logicalName": "LOCALE",
"migration": "discard",
"name": "locale",
"physicalKey": "ca-frontend:preference:v1:locale",
"quotaFallback": "memory",
"schemaVersion": 1,
"scope": "preference",
"ttl": null,
"valueCodec": "opaque-string-v1"
},
"QUERY_PERSISTENCE": {
"backend": "disabled",
"classification": "sensitive-forbidden",
"logicalName": "QUERY_PERSISTENCE",
"migration": "discard",
"name": "query-persistence",
"physicalKey": "ca-frontend:cache:v1:query-persistence",
"quotaFallback": "feature-disable",
"schemaVersion": 1,
"scope": "cache",
"ttl": null,
"valueCodec": "none"
},
"RELEASE_MISMATCH_RECOVERY": {
"backend": "sessionStorage",
"classification": "opaque-cache",
"logicalName": "RELEASE_MISMATCH_RECOVERY",
"migration": "discard",
"name": "boot-mismatch-recovery",
"physicalKey": "ca-frontend:release:v1:boot-mismatch-recovery",
"quotaFallback": "no-persist",
"schemaVersion": 1,
"scope": "release",
"ttl": "session",
"valueCodec": "opaque-string-v1"
}
}
},
{
"registryId": "FE-REG-ERROR",
"owner": "feature-frontend-error-classification-boundary-contract",
"source": "src/contracts/errors.ts",
"rowCount": 38,
"contract": {
"requiredFields": [
"kind",
"defaultRetryable",
"userMessageKey",
"action"
],
"fieldTypes": {
"kind": "string",
"defaultRetryable": "boolean",
"userMessageKey": "string",
"action": "string"
},
"uniqueFields": [
"kind"
],
"allowedValues": {
"action": [
"retry",
"reauth",
"navigate",
"reload-once",
"contact-support",
"none"
]
},
"references": [],
"keyField": "kind",
"breakingFields": [
"kind",
"userMessageKey",
"action"
]
},
"rows": {
"API_CONTRACT_MISMATCH": {
"action": "contact-support",
"defaultRetryable": false,
"kind": "API_CONTRACT_MISMATCH",
"userMessageKey": "error.api_contract_mismatch"
},
"ASSET_MISMATCH": {
"action": "reload-once",
"defaultRetryable": false,
"kind": "ASSET_MISMATCH",
"userMessageKey": "error.asset_mismatch"
},
"AUTH_INTEGRATION_FAILURE": {
"action": "contact-support",
"defaultRetryable": false,
"kind": "AUTH_INTEGRATION_FAILURE",
"userMessageKey": "error.auth_integration_failure"
},
"AUTH_REQUIRED": {
"action": "reauth",
"defaultRetryable": false,
"kind": "AUTH_REQUIRED",
"userMessageKey": "error.auth_required"
},
"BOOT_CONFIG_FAILURE": {
"action": "contact-support",
"defaultRetryable": false,
"kind": "BOOT_CONFIG_FAILURE",
"userMessageKey": "error.boot_config_failure"
},
"BUILD_MISMATCH": {
"action": "reload-once",
"defaultRetryable": false,
"kind": "BUILD_MISMATCH",
"userMessageKey": "error.build_mismatch"
},
"CHUNK_LOAD_FAILURE": {
"action": "reload-once",
"defaultRetryable": false,
"kind": "CHUNK_LOAD_FAILURE",
"userMessageKey": "error.chunk_load_failure"
},
"CONFIG_MISMATCH": {
"action": "contact-support",
"defaultRetryable": false,
"kind": "CONFIG_MISMATCH",
"userMessageKey": "error.config_mismatch"
},
"CONFLICT": {
"action": "retry",
"defaultRetryable": false,
"kind": "CONFLICT",
"userMessageKey": "error.conflict"
},
"CONTENT_TYPE_MISMATCH": {
"action": "contact-support",
"defaultRetryable": false,
"kind": "CONTENT_TYPE_MISMATCH",
"userMessageKey": "error.content_type_mismatch"
},
"DEPLOY_MISMATCH": {
"action": "reload-once",
"defaultRetryable": false,
"kind": "DEPLOY_MISMATCH",
"userMessageKey": "error.deploy_mismatch"
},
"DUPLICATE_IN_FLIGHT": {
"action": "none",
"defaultRetryable": false,
"kind": "DUPLICATE_IN_FLIGHT",
"userMessageKey": "error.duplicate_in_flight"
},
"ENVELOPE_MISMATCH": {
"action": "contact-support",
"defaultRetryable": false,
"kind": "ENVELOPE_MISMATCH",
"userMessageKey": "error.envelope_mismatch"
},
"FORBIDDEN": {
"action": "navigate",
"defaultRetryable": false,
"kind": "FORBIDDEN",
"userMessageKey": "error.forbidden"
},
"IDENTITY_INTERN_LIMIT_EXCEEDED": {
"action": "retry",
"defaultRetryable": false,
"kind": "IDENTITY_INTERN_LIMIT_EXCEEDED",
"userMessageKey": "error.identity_intern_limit_exceeded"
},
"MALFORMED_JSON": {
"action": "contact-support",
"defaultRetryable": false,
"kind": "MALFORMED_JSON",
"userMessageKey": "error.malformed_json"
},
"MAPPING_CONTRACT_VIOLATION": {
"action": "contact-support",
"defaultRetryable": false,
"kind": "MAPPING_CONTRACT_VIOLATION",
"userMessageKey": "error.mapping_contract_violation"
},
"NETWORK_UNREACHABLE": {
"action": "retry",
"defaultRetryable": true,
"kind": "NETWORK_UNREACHABLE",
"userMessageKey": "error.network_unreachable"
},
"NOT_FOUND": {
"action": "navigate",
"defaultRetryable": false,
"kind": "NOT_FOUND",
"userMessageKey": "error.not_found"
},
"PAGINATION_CONTRACT_VIOLATION": {
"action": "contact-support",
"defaultRetryable": false,
"kind": "PAGINATION_CONTRACT_VIOLATION",
"userMessageKey": "error.pagination_contract_violation"
},
"QUERY_CACHE_FAILURE": {
"action": "retry",
"defaultRetryable": false,
"kind": "QUERY_CACHE_FAILURE",
"userMessageKey": "error.query_cache_failure"
},
"RATE_LIMITED": {
"action": "retry",
"defaultRetryable": true,
"kind": "RATE_LIMITED",
"userMessageKey": "error.rate_limited"
},
"RELEASE_MANIFEST_FAILURE": {
"action": "contact-support",
"defaultRetryable": false,
"kind": "RELEASE_MANIFEST_FAILURE",
"userMessageKey": "error.release_manifest_failure"
},
"RELEASE_MISMATCH": {
"action": "reload-once",
"defaultRetryable": false,
"kind": "RELEASE_MISMATCH",
"userMessageKey": "error.release_mismatch"
},
"RENDER_FAILURE": {
"action": "reload-once",
"defaultRetryable": false,
"kind": "RENDER_FAILURE",
"userMessageKey": "error.render_failure"
},
"REQUEST_ABORTED": {
"action": "none",
"defaultRetryable": false,
"kind": "REQUEST_ABORTED",
"userMessageKey": "error.request_aborted"
},
"REQUEST_TIMEOUT": {
"action": "retry",
"defaultRetryable": true,
"kind": "REQUEST_TIMEOUT",
"userMessageKey": "error.request_timeout"
},
"RESPONSE_BODY_LIMIT": {
"action": "contact-support",
"defaultRetryable": false,
"kind": "RESPONSE_BODY_LIMIT",
"userMessageKey": "error.response_body_limit"
},
"RESULT_LIMIT_EXCEEDED": {
"action": "contact-support",
"defaultRetryable": false,
"kind": "RESULT_LIMIT_EXCEEDED",
"userMessageKey": "error.result_limit_exceeded"
},
"SCHEMA_MISMATCH": {
"action": "contact-support",
"defaultRetryable": false,
"kind": "SCHEMA_MISMATCH",
"userMessageKey": "error.schema_mismatch"
},
"SCOPE_GENERATION_CHANGED": {
"action": "none",
"defaultRetryable": false,
"kind": "SCOPE_GENERATION_CHANGED",
"userMessageKey": "error.scope_generation_changed"
},
"SERVER_FAILURE": {
"action": "retry",
"defaultRetryable": true,
"kind": "SERVER_FAILURE",
"userMessageKey": "error.server_failure"
},
"STORAGE_QUOTA_EXCEEDED": {
"action": "none",
"defaultRetryable": false,
"kind": "STORAGE_QUOTA_EXCEEDED",
"userMessageKey": "error.storage_quota_exceeded"
},
"STORAGE_UNAVAILABLE": {
"action": "none",
"defaultRetryable": false,
"kind": "STORAGE_UNAVAILABLE",
"userMessageKey": "error.storage_unavailable"
},
"TELEMETRY_FAILURE": {
"action": "none",
"defaultRetryable": false,
"kind": "TELEMETRY_FAILURE",
"userMessageKey": "error.telemetry_failure"
},
"UNKNOWN_CLIENT_FAILURE": {
"action": "contact-support",
"defaultRetryable": false,
"kind": "UNKNOWN_CLIENT_FAILURE",
"userMessageKey": "error.unknown_client_failure"
},
"UNKNOWN_FAILURE": {
"action": "contact-support",
"defaultRetryable": false,
"kind": "UNKNOWN_FAILURE",
"userMessageKey": "error.unknown_failure"
},
"VALIDATION_REJECTED": {
"action": "none",
"defaultRetryable": false,
"kind": "VALIDATION_REJECTED",
"userMessageKey": "error.validation_rejected"
}
}
},
{
"registryId": "FE-REG-QUERY-INVALIDATION",
"owner": "feature-frontend-server-state-caching-contract",
"source": "src/features/installed-feature-contracts.ts",
"rowCount": 1,
"contract": {
"requiredFields": [
"topicId",
"namespace.namespaceId",
"namespace.namespaceVersion"
],
"fieldTypes": {
"topicId": "string",
"namespace.namespaceId": "string",
"namespace.namespaceVersion": "integer"
},
"uniqueFields": [],
"allowedValues": {},
"references": [],
"keyField": null,
"breakingFields": [
"topics",
"namespaces",
"edges"
],
"rowsPath": "edges",
"rowKeyFields": [
"topicId",
"namespace.namespaceId",
"namespace.namespaceVersion"
],
"uniqueFieldSets": [
[
"topicId",
"namespace.namespaceId",
"namespace.namespaceVersion"
]
],
"snapshotProjection": {
"singletonRowKey": "invalidation-graph",
"canonicalArrayKeyFields": {
"topics": [
"$value"
],
"namespaces": [
"namespaceId",
"namespaceVersion"
],
"edges": [
"topicId",
"namespace.namespaceId",
"namespace.namespaceVersion"
]
}
}
},
"rows": {
"invalidation-graph": {
"edges": [
{
"namespace": {
"namespaceId": "reference-resource",
"namespaceVersion": 1
},
"topicId": "qinv.01k10f7m3w9p6r2c8v5n4x"
}
],
"namespaces": [
{
"namespaceId": "reference-resource",
"namespaceVersion": 1
}
],
"topics": [
"qinv.01k10f7m3w9p6r2c8v5n4x"
]
}
}
},
{
"registryId": "FE-REG-QUERY-INVALIDATION-TOPIC-VERSION",
"owner": "feature-frontend-server-state-caching-contract",
"source": "src/features/installed-feature-contracts.ts",
"rowCount": 1,
"contract": {
"requiredFields": [
"topicId",
"topicVersion"
],
"fieldTypes": {
"topicId": "string",
"topicVersion": "integer"
},
"uniqueFields": [
"topicId"
],
"allowedValues": {},
"references": [],
"keyField": null,
"breakingFields": [
"topicId",
"topicVersion"
],
"rowKeyFields": [
"topicId"
]
},
"rows": {
"[\"qinv.01k10f7m3w9p6r2c8v5n4x\"]": {
"topicId": "qinv.01k10f7m3w9p6r2c8v5n4x",
"topicVersion": 1
}
}
},
{
"registryId": "FE-REG-TELEMETRY",
"owner": "feature-frontend-diagnostics-telemetry-runtime",
"source": "src/contracts/telemetry.ts",
"rowCount": 6,
"contract": {
"requiredFields": [
"eventName",
"trigger",
"requiredAttributes",
"optionalAttributes",
"forbiddenAttributes",
"sampling",
"delivery"
],
"fieldTypes": {
"eventName": "string",
"trigger": "string",
"requiredAttributes": "array",
"optionalAttributes": "array",
"forbiddenAttributes": "array",
"sampling": "string",
"delivery": "string"
},
"uniqueFields": [
"eventName"
],
"allowedValues": {
"delivery": [
"best-effort"
]
},
"references": [],
"keyField": "eventName",
"breakingFields": [
"eventName",
"requiredAttributes",
"forbiddenAttributes",
"delivery"
]
},
"rows": {
"api.request.failed": {
"delivery": "best-effort",
"eventName": "api.request.failed",
"forbiddenAttributes": [
"access_token",
"authorization_header",
"cookie",
"email",
"query_string",
"raw_url",
"raw_user_id",
"refresh_token",
"request_body",
"response_body",
"stack_in_user_message",
"storage_value",
"user_name"
],
"optionalAttributes": [
"duration_bucket",
"operation_id"
],
"requiredAttributes": [
"attempt_count_bucket",
"error_kind",
"http_status_group",
"route_id"
],
"sampling": "all",
"trigger": "terminal API failure"
},
"app.boot.failed": {
"delivery": "best-effort",
"eventName": "app.boot.failed",
"forbiddenAttributes": [
"access_token",
"authorization_header",
"cookie",
"email",
"query_string",
"raw_url",
"raw_user_id",
"refresh_token",
"request_body",
"response_body",
"stack_in_user_message",
"storage_value",
"user_name"
],
"optionalAttributes": [],
"requiredAttributes": [
"build_id",
"config_schema_version",
"error_kind"
],
"sampling": "all",
"trigger": "boot validation failure"
},
"release.mismatch.detected": {
"delivery": "best-effort",
"eventName": "release.mismatch.detected",
"forbiddenAttributes": [
"access_token",
"authorization_header",
"cookie",
"email",
"query_string",
"raw_url",
"raw_user_id",
"refresh_token",
"request_body",
"response_body",
"stack_in_user_message",
"storage_value",
"user_name"
],
"optionalAttributes": [],
"requiredAttributes": [
"active_release_id",
"build_id",
"mismatch_kind"
],
"sampling": "all",
"trigger": "release tuple mismatch"
},
"service-worker.start.failed": {
"delivery": "best-effort",
"eventName": "service-worker.start.failed",
"forbiddenAttributes": [
"access_token",
"authorization_header",
"cookie",
"email",
"query_string",
"raw_url",
"raw_user_id",
"refresh_token",
"request_body",
"response_body",
"stack_in_user_message",
"storage_value",
"user_name"
],
"optionalAttributes": [],
"requiredAttributes": [
"build_id",
"error_kind"
],
"sampling": "all",
"trigger": "Service Worker start ended FAILED or INCOMPATIBLE"
},
"telemetry.delivery.dropped": {
"delivery": "best-effort",
"eventName": "telemetry.delivery.dropped",
"forbiddenAttributes": [
"access_token",
"authorization_header",
"cookie",
"email",
"query_string",
"raw_url",
"raw_user_id",
"refresh_token",
"request_body",
"response_body",
"stack_in_user_message",
"storage_value",
"user_name"
],
"optionalAttributes": [],
"requiredAttributes": [
"queue_size_bucket",
"reason"
],
"sampling": "internal-counter",
"trigger": "queue or sink failure"
},
"ui.render.failed": {
"delivery": "best-effort",
"eventName": "ui.render.failed",
"forbiddenAttributes": [
"access_token",
"authorization_header",
"cookie",
"email",
"query_string",
"raw_url",
"raw_user_id",
"refresh_token",
"request_body",
"response_body",
"stack_in_user_message",
"storage_value",
"user_name"
],
"optionalAttributes": [],
"requiredAttributes": [
"build_id",
"component_boundary",
"route_id"
],
"sampling": "all",
"trigger": "React boundary catch"
}
}
},
{
"registryId": "FE-REG-RELEASE",
"owner": "feature-frontend-release-cache-rollback-contract",
"source": "src/contracts/release-tokens.ts",
"rowCount": 9,
"contract": {
"requiredFields": [
"token",
"source",
"compatibilityRole"
],
"fieldTypes": {
"token": "string",
"source": "string",
"compatibilityRole": "string"
},
"uniqueFields": [
"token"
],
"allowedValues": {},
"references": [],
"keyField": "token",
"breakingFields": [
"token",
"source",
"compatibilityRole"
]
},
"rows": {
"apiContractVersion": {
"compatibilityRole": "legacy V1 scalar; superseded by contractSetDigest",
"source": "frontend/backend agreement",
"token": "apiContractVersion"
},
"appVersion": {
"compatibilityRole": "human release label",
"source": "manifest",
"token": "appVersion"
},
"assetManifestHash": {
"compatibilityRole": "chunk integrity and mismatch detection",
"source": "build output",
"token": "assetManifestHash"
},
"buildId": {
"compatibilityRole": "asset and HTML coherence",
"source": "CI build",
"token": "buildId"
},
"builtAt": {
"compatibilityRole": "diagnostics only; never cache identity",
"source": "CI",
"token": "builtAt"
},
"commitSha": {
"compatibilityRole": "source traceability",
"source": "VCS",
"token": "commitSha"
},
"configSchemaVersion": {
"compatibilityRole": "boot compatibility",
"source": "runtime config schema",
"token": "configSchemaVersion"
},
"contractSetDigest": {
"compatibilityRole": "release coherence for multi-package contracts",
"source": "compiled external contract package set",
"token": "contractSetDigest"
},
"releaseId": {
"compatibilityRole": "rollback target",
"source": "deploy system",
"token": "releaseId"
}
}
}
]
}