Files
clean-architecture-frontend…/config/contracts
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
..