fix: main에서 실패하던 typecheck·unit·registry 게이트를 고친다 #6

Merged
donghyeon.kang merged 6 commits from fix/main-gates into main 2026-11-12 04:28:28 +00:00
6 Commits
Author SHA1 Message Date
DongHyeonka 953381a998 fix(ci): coverage 증거 검사가 summary의 branchesTrue를 받는다
FE-GATE-005의 증거 검사(scripts/lib/ci-artifact-validator.ts)는
coverage-summary.json 항목마다 lines·statements·functions·branches만
허용하는 .strict() schema를 쓴다. istanbul-lib-coverage 3.2.2는 summary에
branchesTrue를 넣으므로, 시험이 모두 통과해도 증거 단계에서 게이트가
"Unrecognized key: branchesTrue"로 실패한다. 같은 파일을 읽는
risk-coverage 검사는 이 키를 허용해 두 검사기가 갈라져 있었다.

템플릿 bca5fc27을 그대로 가져온다(git apply, 충돌 없음). 키 목록을
scripts/lib/coverage-summary-metrics.ts 한 곳에 두고 두 검사기가 같이 쓴다.
평가하는 네 지표와 보고기가 더할 수 있는 선택 지표(branchesTrue)를 나누고,
선택 지표도 counter 형식은 그대로 검사한다.

위험·한계: 다른 모르는 키는 여전히 거절한다(의도).

검증: 템플릿 커밋의 tests/unit/coverage-summary-artifact.test.ts를 같이
가져왔다. 결과는 이 브랜치 전체 게이트 실행에 적는다.
2026-11-12 13:10:47 +09:00
DongHyeonka f14ff71c9b fix(test): 낡은 검사 둘을 지금 코드에 맞춘다
앞 단계 시험이 실패해 가려져 있던 실패 둘이다. 둘 다 main에서도 같다.

- request-fanout(아키텍처 시험)이 collect-catalog.ts의 반복 안
  gateway.getCatalog()를 행마다 요청하는 N+1로 잡는다. 이것은 다음
  요청이 앞 응답의 nextCursor에 기대는 커서 페이지 넘기기라 묶을 수 없다.
  검사기가 정한 방식대로 그 줄에 `// fanout-reviewed: <이유>`를 단다.
- release-manifest 시험이 TechLog Studio 계약 버전을 3.0.0으로 기대한다.
  계약(contracts/studio/canonical-source.json)은 3.1.0이다. 시험은 일부러
  값을 글자 그대로 두는 설계라 그 값을 3.1.0으로 맞춘다.

검증: 두 시험 파일이 통과한다(고치기 전 각 1건 실패, main에서도 같음).
2026-11-12 12:50:28 +09:00
DongHyeonka a06cc8e4c4 fix(ci): 시험과 dev server가 CI의 빌드 식별값을 물려받지 않는다
CI workflow는 전체 env에 VITE_BUILD_ID=gitea-<run>-<attempt>와
VITE_COMMIT_SHA를 둔다. Vite는 이 값을 import.meta.env에 넣는다. 그래서
CI와 같은 env로 돌리면 앱을 local-build fixture release로 조립하는 시험
(runtime-application, boot-unexpected-failure,
runtime-composition-service-worker-telemetry)이 CONFIG_BUILD_MISMATCH로
실패한다. 로컬에서는 값이 없어 늘 통과한다.

템플릿 af312dee를 그대로 가져온다. vitest.config.ts가 두 값을 지우고,
dev server를 띄우는 Playwright 설정 둘은 webServer env로
VITE_BUILD_ID=local-build, VITE_COMMIT_SHA=local을 준다. build·preview를 쓰는
설정은 빌드가 같은 값으로 config.json을 만들므로 그대로 둔다.

위험·한계: vitest 안에서 CI 빌드 식별값을 검사하려는 시험은 값을 직접
넣어야 한다(지금은 없다). capability e2e(FE-GATE-008)는 돌리지 않았다.

검증: VITE_BUILD_ID를 준 채로 세 component 시험이 통과한다.
2026-11-12 12:50:28 +09:00
DongHyeonka 588ebca54f fix(registry): 9월 경로 변경을 registry에 등록하고 근거를 남긴다
check-registries가 이 repo에서 실패한다. 9월 커밋(67a54917 주제 변형
화면, b9e29369 UX 리뷰 H1)이 경로 계약을 바꿨지만 governance와 schema
registry는 그대로였다. 2026-09-29 템플릿 동기화의 baseline 승인도 「TechLog
경로 변경은 승인하지 않은 채 남긴다」고 적었다. 단위 시험
second-api-feature-registries가 이 실패를 그대로 드러냈다.

- schema registry에 TechLogTopicVariantParams(route-params,
  REJECT_UNKNOWN)를 더한다. 코덱(tech-log-route-codecs.ts)은 이미 있다.
- governance의 FE-REG-ROUTE 허용 값에 TechLogTopicVariantParams,
  TechLogStudioDocumentsSearch, TechLogStudioPublicationsSearch를 더한다.
- breaking 변경 여섯에 근거를 남긴다: 출시 화면이 주 내비에서 빠짐
  (navigationLabel·navigationOrder), Studio 문서·게시 목록이 검색·필터·
  쪽수를 주소에서 읽음(searchSchema·searchCodec).

baseline은 다시 만들지 않는다. 이 repo는 지금까지 breaking 변경마다 근거를
더하고 baseline은 템플릿 동기화 때만 승인했다(c5c8b942 등).

위험·한계: 근거의 내용은 이미 운영에 나간 변경을 사후에 적은 것이다.

검증: node scripts/check-registries.ts가 "11 registries PASS;
compatibility=breaking"을 낸다(고치기 전 11건 실패).
2026-11-12 12:50:28 +09:00
DongHyeonka ed47b562bc perf(build): react-dom을 자기 청크로 빼 빌드 id만 바뀐 배포의 캐시 손실을 줄인다
빌드 id는 부트 실패 화면이 보여 주므로 render-boot-failure 청크에
들어간다(getBuildConfig). react-dom과 scheduler가 같은 청크에 있어서
빌드 id만 다른 두 빌드에서 그 190,478 B 청크의 이름이 바뀌었다. 해시
자산은 오래 캐시되는데, 재방문 사용자는 코드가 같아도 배포마다 이만큼
다시 받았다. 단위 시험 build-environment-bundle이 이 청크가 바뀐다고
실패했다.

템플릿 af6d0a9f(1103/15-06)와 같은 방식이다. manualChunks에서 react-dom·
scheduler를 react-dom 청크로 뺀다. 시험은 템플릿 새 판처럼 디자인 시스템
청크를 이름 대신 내용(ui-button--pending)으로 찾아 고정됐는지 보고,
react-dom 청크가 고정이며 render-boot-failure가 아닌지 본다. 이전 시험은
빌드 id를 일부러 담는 render-boot-failure를 공용 청크로 잘못 골랐다.

위험·한계: 정규식은 pnpm의 node_modules 배치를 가정한다. 배치가 바뀌어
그룹이 비면 시험이 실패한다. boot(약 320 KB)는 빌드 id로 설정을 대조하므로
계속 이름이 바뀐다(템플릿과 같음).

검증: 빌드 id만 다른 두 빌드에서 이름이 바뀐 청크는 boot·index·
render-boot-failure 셋이고, render-boot-failure는 12,138 B로 줄었다.
react-dom 청크와 디자인 시스템 청크는 두 빌드에서 이름이 같다.
2026-11-12 12:50:28 +09:00
DongHyeonka 731612c04d fix(typecheck): route-runtime 음성 fixture가 이 제품의 경로로 진단을 낸다
FE-GATE-003의 route-runtime 음성 fixture는 템플릿 그대로
`{ APP_HOME: true } satisfies Record<RouteId, boolean>`이다. 이 제품에는
APP_HOME 경로가 없어서, 기대한 「빠진 경로」 진단(TS2740) 대신 「모르는
속성」(TS2353)이 나와 UNEXPECTED_DIAGNOSTIC로 떨어진다.

템플릿 e47a0ab2와 같은 방식으로 고친다. 정확히 한 경로만 뺀
`Omit<Record<RouteId, boolean>, "TECH_LOG_HOME">`을 대입하고, 기대 진단을
TS2741로 바꾼다. 빠진 키가 하나면 경로 수와 상관없이 TS2741이다(TS2739·
TS2740은 빠진 목록의 길이에 따라 갈린다). 뺄 경로는 이 제품에 있는
TECH_LOG_HOME이다.

검증: tsc -p tests/fixtures/typecheck/tsconfig.route-runtime.json이
TS2741(missingRuntime)과 TS2353(ORPHAN_ROUTE, 두 번째 음성 경우)을 낸다.
2026-11-12 12:50:28 +09:00