Commit Graph
2 Commits
Author SHA1 Message Date
DongHyeonka a144b575e5 fix(contracts): FE-REG-ENV 런타임 행의 필수 여부·기본값을 스키마와 맞춘다
문제
FE-REG-ENV 런타임 행 13개 중 5개의 required·defaultValue가 실제 V2
runtime config 스키마(runtimeConfigV2ArtifactSchema)와 다르다.
- TELEMETRY_ENABLED: 행 기본값 false / 스키마 필수, 기본값 없음
- AUTH_MODE: 행 기본값 "external" / 스키마 기본값 없음
- RELEASE_MANIFEST_URL: 행 required true / 스키마 선택(기본값 있음)
- CAPABILITY_OVERRIDES: 행 기본값 null / 스키마 기본값 네 항목 DEFAULT
- FEATURE_OVERRIDES: 행 기본값 null / 스키마 기본값 {}
d0414c8의 테스트는 스키마 키마다 행이 있는지만 본다. 스키마에 없는 런타임
행도, 값이 다른 행도 통과한다. 이 레지스트리는 기준선 호환 검사 대상이라
틀린 값이 계약으로 굳는다. AUTH_MODE를 빼도 external이 된다고 읽으면
부팅이 스키마 오류로 멈춘다.

고른 방법
- env-registry-coverage에 두 방향을 더한다. 스키마가 읽지 않는 런타임 행은
  실패한다. 각 행의 required·defaultValue는 스키마 필드에 undefined를 넣은
  결과(실패 = 필수·기본값 없음, 성공 = 선택·그 값)와 같아야 한다. 차이는
  키·행 값·스키마 값을 한 줄로 보인다. 제품 키(PRODUCT_*)도 같은 검사를
  받는다.
- 5개 행을 스키마에 맞춘다. 두 override 기본값은 객체라 governance의
  defaultValue 타입에 object를 더했다.
- ENV_REGISTRY 주석에 두 칸의 뜻(null = 스키마가 기본값을 주지 않음)을
  적었다.

버린 대안
- 행의 required·defaultValue를 스키마에서 계산해 채우기: 손으로 맞출 일이
  사라지지만 env.ts가 zod 스키마를 import해야 한다. env.ts는 부팅 경로
  (getBuildConfig)에 있어 초기 청크에 zod 스키마가 끌려 들어간다.

위험·한계
- RELEASE_MANIFEST_URL required true→false는 breaking 칸 변경이고
  governance fieldTypes도 바뀌어 기준선을 다시 승인했다.
- 스키마 superRefine의 조건부 필수(TELEMETRY_ENABLED면 TELEMETRY_ENDPOINT)는
  행에 표현하지 않는다.

검증
- RED: 새 대조 테스트가 위 5개 행을 정확히 보고하며 실패했다.
- GREEN: env-registry-coverage 3건 통과. 변이: 스키마 REQUEST_TIMEOUT_MS
  기본값만 20,000으로 바꾸면 실패, 스키마 필드 없는 제품 행을 더하면 실패.
- check:registries(재승인 뒤 compatibility=none), run-vitest related
  (env.ts, governance) 18파일 154건, registry-governance·product-composition
  23건, check:types, eslint 통과.

Refs: docs/reviews/2026-11-03-maturity-review/13-build-release-supply-chain.md 13-04
Refs: docs/reviews/2026-11-03-maturity-review/07-contracts.md P-07-05
2026-11-04 20:27:35 +09:00
DongHyeonka d0414c85f9 fix(contracts): 런타임 설정 키마다 FE-REG-ENV 행을 요구한다 (1101/09-02)
문제: config.json V2 스키마의 키 중 RELEASE_ID와 BUILD_ID에는
FE-REG-ENV(ENV_REGISTRY) 행이 없다. 이를 잡는 검사도 없다. 그래서
제품이 PRODUCT_RUNTIME_CONFIG_FIELDS에만 키를 더하고 PRODUCT_ENV_REGISTRY
행을 빠뜨려도 check:registries가 그 키를 보지 못한다. ece944d를 검토하다
찾았다.

고른 방법:
- tests/unit/env-registry-coverage.test.ts를 더한다. runtimeConfigV2
  ArtifactSchema의 모든 최상위 키에 phase "runtime" 행이 있어야 한다.
  제품 필드는 withProductFields로 같은 shape에 들어가므로 같이 검사된다.
- RELEASE_ID, BUILD_ID 행을 public-metadata, 선택, 기본값 null로 더한다.
  빌드가 config.json에 쓰는 릴리스 신원이고, VITE_BUILD_ID와 같은 분류다.
버린 대안: check-registries.ts에서 검사하기. 그 검사기는
registry-governance.json에 적힌 레지스트리 export를 같은 규칙으로 읽는
일반 검사기다. 스키마와 레지스트리를 맞대는 규칙을 넣으면 FE-REG-ENV
하나만을 위한 분기가 생긴다. 테스트 하나로 같은 실패를 낸다.

위험·한계: V1 전용 키(API_CONTRACT_VERSION)는 검사하지 않는다. 그 행은
FE-REG-ENV 변경 증거로 지워졌고, V1 reader는 지울 예정이다. 행을 더한
것은 additive라 기준선을 고치지 않는다.

검증:
- RED: 새 테스트가 ["RELEASE_ID", "BUILD_ID"]를 보고하며 실패
- GREEN: 통과. env 관련 unit 4파일 43건 통과
- node scripts/check-registries.ts: 11 registries PASS, additive
- tsc app·test, eslint 통과
2026-11-03 20:25:01 +09:00