From d0414c85f9f56d62ab49f2e6d192028095692d5f Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Tue, 3 Nov 2026 20:24:48 +0900 Subject: [PATCH] =?UTF-8?q?fix(contracts):=20=EB=9F=B0=ED=83=80=EC=9E=84?= =?UTF-8?q?=20=EC=84=A4=EC=A0=95=20=ED=82=A4=EB=A7=88=EB=8B=A4=20FE-REG-EN?= =?UTF-8?q?V=20=ED=96=89=EC=9D=84=20=EC=9A=94=EA=B5=AC=ED=95=9C=EB=8B=A4?= =?UTF-8?q?=20(1101/09-02)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 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 통과 --- src/contracts/env.ts | 5 +++++ tests/unit/env-registry-coverage.test.ts | 19 +++++++++++++++++++ 2 files changed, 24 insertions(+) create mode 100644 tests/unit/env-registry-coverage.test.ts diff --git a/src/contracts/env.ts b/src/contracts/env.ts index 9c86dc71..48c874be 100644 --- a/src/contracts/env.ts +++ b/src/contracts/env.ts @@ -58,6 +58,11 @@ export const ENV_REGISTRY = Object.freeze(withProductRows({ AUTH_MODE: runtime("public", true, "external"), CONFIG_SCHEMA_VERSION: runtime("public", true, null), RELEASE_MANIFEST_URL: runtime("public", true, "/release-manifest.json"), + // F-6. The release identity the build writes into config.json. It must match + // the deployed HTML and release manifest, or boot stops with + // CONFIG_BUILD_MISMATCH (scripts/check-release-admission.ts). + RELEASE_ID: runtime("public-metadata", false, null), + BUILD_ID: runtime("public-metadata", false, null), // §3.5: overrides may only disable an installed capability, never enable one. CAPABILITY_OVERRIDES: runtime("public", false, null), // §3.5: likewise for features — subtractive, keyed by installed feature id. diff --git a/tests/unit/env-registry-coverage.test.ts b/tests/unit/env-registry-coverage.test.ts new file mode 100644 index 00000000..f28118d0 --- /dev/null +++ b/tests/unit/env-registry-coverage.test.ts @@ -0,0 +1,19 @@ +import { describe, expect, it } from "vitest"; + +import { ENV_REGISTRY } from "../../src/contracts/env.ts"; +import { runtimeConfigV2ArtifactSchema } from "../../src/contracts/release-artifacts.ts"; + +// 09-02. A key the deployed config.json may carry needs an FE-REG-ENV row, so +// check:registries sees it. A product key added to +// PRODUCT_RUNTIME_CONFIG_FIELDS without a PRODUCT_ENV_REGISTRY row fails here. +describe("FE-REG-ENV coverage", () => { + it("has a runtime row for every V2 runtime config key", () => { + const missing = Object.keys(runtimeConfigV2ArtifactSchema.shape).filter( + (key) => + !Object.hasOwn(ENV_REGISTRY, key) || + ENV_REGISTRY[key as keyof typeof ENV_REGISTRY].phase !== "runtime", + ); + + expect(missing).toEqual([]); + }); +});