제목: fix: main의 typecheck·unit 게이트 실패를 고친다
브랜치: tech-log-frontend fix/main-gates, head 953381a9(main 27e342dd 위)
무엇을, 왜
main에서 FE-GATE-003(typecheck)과 FE-GATE-005(unit)가 실패한다. 앞 단계가 실패하면 게이트가 멈춰서, 그 뒤에 가려져 있던 실패도 이번에 함께 드러났다(FE-GATE-004 포함). 원인은 여섯 가지이고, 커밋 하나에 원인 하나씩 고쳤다. 넷은 템플릿이 이미 고친 것을 가져왔다.
커밋
실패
원인
고친 방법
731612c0
003 route-runtime 음성 fixture
템플릿 fixture가 이 제품에 없는 APP_HOME을 써서, 기대한 TS2740 대신 TS2353이 났다
템플릿 e47a0ab2 방식. 한 경로(TECH_LOG_HOME)만 뺀 Omit을 쓰고 기대 진단을 TS2741로 바꿨다
ed47b562
005 build-environment-bundle
react-dom·scheduler(190,478 B 청크)가 빌드 id가 든 render-boot-failure에 있어서, 배포할 때마다 이름이 바뀌었다(재방문 사용자가 다시 받음)
템플릿 af6d0a9f 방식. react-dom 전용 청크를 두고, 시험이 디자인 시스템을 내용으로 찾게 했다
9월 경로 변경(주제 변형 화면, Studio 목록 검색, 출시 화면 내비)이 registry에 승인되지 않은 채였다
schema 등록, governance 허용 값 셋, breaking change 근거 여섯
a06cc8e4
005 coverage 안의 component 셋
CI의 VITE_BUILD_ID가 시험에 들어가 CONFIG_BUILD_MISMATCH가 났다
템플릿 af312dee. vitest가 두 값을 지우고, dev server용 Playwright 설정은 로컬 값을 준다
f14ff71c
005 request-fanout, 004 release-manifest
커서 페이지 넘기기를 N+1로 잡았다. Studio 계약 기대값이 3.0.0으로 낡았다
정해진 // fanout-reviewed: 표시. 기대값 3.1.0
953381a9
005 증거 검사
coverage summary의 branchesTrue를 schema가 거부했다
템플릿 bca5fc27을 그대로 적용했다(충돌 없음)
고른 방법과 버린 대안
버린 대안: bundle 시험을 「boot 경로 청크는 바뀌어도 된다」로 넓히기. 처음에 그렇게 고쳤다가, react-dom 190 KB가 그 청크에 있다는 것을 확인하고 버렸다. 시험의 실패가 진짜 결함(배포마다 캐시를 잃음)을 가리키고 있었다.
버린 대안: registry baseline을 다시 만들기. 이 repo는 breaking 변경마다 근거를 더하고, baseline은 템플릿 동기화 때만 승인해 왔다.
템플릿 커밋을 가져온 곳은 커밋 본문에 원래 SHA를 적었다. 다음 템플릿 동기화 때 충돌을 줄이려는 것이다.
위험과 영향
운영 동작이 바뀌는 것은 빌드 청크 구성 하나다. 다음 배포에서 react-dom 청크가 새로 생기고, 그 뒤로는 빌드 id만 바뀌어도 이름이 유지된다.
registry 근거는 이미 운영에 나간 변경을 사후에 적은 것이다.
capability e2e(FE-GATE-008)와 브라우저 게이트는 돌리지 않았다.
검증
desktop 호스트 node 24.14.0, CI env(CI=true, VITE_BUILD_ID 설정), heavy lock 아래에서 돌렸다.
ref
001
002
003
004
005
011
이 브랜치 953381a9(새 clone)
0
0
0
0
0
0
고치기 전 main(3b4c13e2, 같은 조건)
0
0
1
돌리지 않음
1
0
고치기 전 main에서 004에 해당하는 release-manifest 시험 파일을 따로 돌리면 실패한다(27e342dd). request-fanout도 같다.
템플릿 main 6b4f703c: 003=0, 005=0, check-registries PASS. 이번에 고친 문제는 템플릿에 없다. 필요한 수정이 이미 들어 있다.
빌드 id만 다른 두 빌드에서 이름이 바뀌는 청크는 boot·index·render-boot-failure 셋이다. render-boot-failure는 190,478 B에서 12,138 B로 줄었다. react-dom 청크와 디자인 시스템 청크는 이름이 같다.
unit 176 / contract 3 / coverage 347개 파일, 3,609건이 통과한다.
참고: clone 폴더 이름이 …src로 끝나면 coverage 대상 패턴 src/**가 절대 경로의 일부에 맞아 루트 파일까지 들어가고, risk-coverage가 실패한다. 제 시험 환경에서 생긴 일이고 CI 경로에는 해당하지 않는다.
로그: desktop /tmp/claude-gates/w1-infra/final-fe/(이 브랜치), /tmp/claude-gates/w1-infra/tpl2/(템플릿), /tmp/claude-gates/w1-infra/pr45/(고치기 전 main).
관련
템플릿 커밋 e47a0ab2, af6d0a9f, af312dee, bca5fc27
제목: fix: main의 typecheck·unit 게이트 실패를 고친다
브랜치: tech-log-frontend `fix/main-gates`, head `953381a9`(main `27e342dd` 위)
## 무엇을, 왜
main에서 FE-GATE-003(typecheck)과 FE-GATE-005(unit)가 실패한다. 앞 단계가 실패하면 게이트가 멈춰서, 그 뒤에 가려져 있던 실패도 이번에 함께 드러났다(FE-GATE-004 포함). 원인은 여섯 가지이고, 커밋 하나에 원인 하나씩 고쳤다. 넷은 템플릿이 이미 고친 것을 가져왔다.
| 커밋 | 실패 | 원인 | 고친 방법 |
| --- | --- | --- | --- |
| `731612c0` | 003 route-runtime 음성 fixture | 템플릿 fixture가 이 제품에 없는 `APP_HOME`을 써서, 기대한 TS2740 대신 TS2353이 났다 | 템플릿 `e47a0ab2` 방식. 한 경로(`TECH_LOG_HOME`)만 뺀 Omit을 쓰고 기대 진단을 TS2741로 바꿨다 |
| `ed47b562` | 005 `build-environment-bundle` | react-dom·scheduler(190,478 B 청크)가 빌드 id가 든 `render-boot-failure`에 있어서, 배포할 때마다 이름이 바뀌었다(재방문 사용자가 다시 받음) | 템플릿 `af6d0a9f` 방식. react-dom 전용 청크를 두고, 시험이 디자인 시스템을 내용으로 찾게 했다 |
| `588ebca5` | 005 `second-api-feature-registries`, `check-registries` | 9월 경로 변경(주제 변형 화면, Studio 목록 검색, 출시 화면 내비)이 registry에 승인되지 않은 채였다 | schema 등록, governance 허용 값 셋, breaking change 근거 여섯 |
| `a06cc8e4` | 005 coverage 안의 component 셋 | CI의 `VITE_BUILD_ID`가 시험에 들어가 `CONFIG_BUILD_MISMATCH`가 났다 | 템플릿 `af312dee`. vitest가 두 값을 지우고, dev server용 Playwright 설정은 로컬 값을 준다 |
| `f14ff71c` | 005 `request-fanout`, 004 `release-manifest` | 커서 페이지 넘기기를 N+1로 잡았다. Studio 계약 기대값이 3.0.0으로 낡았다 | 정해진 `// fanout-reviewed:` 표시. 기대값 3.1.0 |
| `953381a9` | 005 증거 검사 | coverage summary의 `branchesTrue`를 schema가 거부했다 | 템플릿 `bca5fc27`을 그대로 적용했다(충돌 없음) |
## 고른 방법과 버린 대안
- 버린 대안: bundle 시험을 「boot 경로 청크는 바뀌어도 된다」로 넓히기. 처음에 그렇게 고쳤다가, react-dom 190 KB가 그 청크에 있다는 것을 확인하고 버렸다. 시험의 실패가 진짜 결함(배포마다 캐시를 잃음)을 가리키고 있었다.
- 버린 대안: registry baseline을 다시 만들기. 이 repo는 breaking 변경마다 근거를 더하고, baseline은 템플릿 동기화 때만 승인해 왔다.
- 템플릿 커밋을 가져온 곳은 커밋 본문에 원래 SHA를 적었다. 다음 템플릿 동기화 때 충돌을 줄이려는 것이다.
## 위험과 영향
- 운영 동작이 바뀌는 것은 빌드 청크 구성 하나다. 다음 배포에서 react-dom 청크가 새로 생기고, 그 뒤로는 빌드 id만 바뀌어도 이름이 유지된다.
- registry 근거는 이미 운영에 나간 변경을 사후에 적은 것이다.
- capability e2e(FE-GATE-008)와 브라우저 게이트는 돌리지 않았다.
## 검증
desktop 호스트 node 24.14.0, CI env(`CI=true`, `VITE_BUILD_ID` 설정), heavy lock 아래에서 돌렸다.
| ref | 001 | 002 | 003 | 004 | 005 | 011 |
| --- | --- | --- | --- | --- | --- | --- |
| 이 브랜치 `953381a9`(새 clone) | 0 | 0 | 0 | 0 | 0 | 0 |
| 고치기 전 main(`3b4c13e2`, 같은 조건) | 0 | 0 | 1 | 돌리지 않음 | 1 | 0 |
- 고치기 전 main에서 004에 해당하는 `release-manifest` 시험 파일을 따로 돌리면 실패한다(`27e342dd`). `request-fanout`도 같다.
- 템플릿 main `6b4f703c`: 003=0, 005=0, `check-registries` PASS. 이번에 고친 문제는 템플릿에 없다. 필요한 수정이 이미 들어 있다.
- 빌드 id만 다른 두 빌드에서 이름이 바뀌는 청크는 boot·index·render-boot-failure 셋이다. render-boot-failure는 190,478 B에서 12,138 B로 줄었다. react-dom 청크와 디자인 시스템 청크는 이름이 같다.
- unit 176 / contract 3 / coverage 347개 파일, 3,609건이 통과한다.
- 참고: clone 폴더 이름이 `…src`로 끝나면 coverage 대상 패턴 `src/**`가 절대 경로의 일부에 맞아 루트 파일까지 들어가고, risk-coverage가 실패한다. 제 시험 환경에서 생긴 일이고 CI 경로에는 해당하지 않는다.
- 로그: desktop `/tmp/claude-gates/w1-infra/final-fe/`(이 브랜치), `/tmp/claude-gates/w1-infra/tpl2/`(템플릿), `/tmp/claude-gates/w1-infra/pr45/`(고치기 전 main).
## 관련
- 템플릿 커밋 `e47a0ab2`, `af6d0a9f`, `af312dee`, `bca5fc27`
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, 두 번째 음성 경우)을 낸다.
빌드 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 청크와 디자인 시스템 청크는 두 빌드에서 이름이 같다.
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건 실패).
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 시험이 통과한다.
앞 단계 시험이 실패해 가려져 있던 실패 둘이다. 둘 다 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에서도 같음).
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를 같이
가져왔다. 결과는 이 브랜치 전체 게이트 실행에 적는다.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
제목: fix: main의 typecheck·unit 게이트 실패를 고친다
브랜치: tech-log-frontend
fix/main-gates, head953381a9(main27e342dd위)무엇을, 왜
main에서 FE-GATE-003(typecheck)과 FE-GATE-005(unit)가 실패한다. 앞 단계가 실패하면 게이트가 멈춰서, 그 뒤에 가려져 있던 실패도 이번에 함께 드러났다(FE-GATE-004 포함). 원인은 여섯 가지이고, 커밋 하나에 원인 하나씩 고쳤다. 넷은 템플릿이 이미 고친 것을 가져왔다.
731612c0APP_HOME을 써서, 기대한 TS2740 대신 TS2353이 났다e47a0ab2방식. 한 경로(TECH_LOG_HOME)만 뺀 Omit을 쓰고 기대 진단을 TS2741로 바꿨다ed47b562build-environment-bundlerender-boot-failure에 있어서, 배포할 때마다 이름이 바뀌었다(재방문 사용자가 다시 받음)af6d0a9f방식. react-dom 전용 청크를 두고, 시험이 디자인 시스템을 내용으로 찾게 했다588ebca5second-api-feature-registries,check-registriesa06cc8e4VITE_BUILD_ID가 시험에 들어가CONFIG_BUILD_MISMATCH가 났다af312dee. vitest가 두 값을 지우고, dev server용 Playwright 설정은 로컬 값을 준다f14ff71crequest-fanout, 004release-manifest// fanout-reviewed:표시. 기대값 3.1.0953381a9branchesTrue를 schema가 거부했다bca5fc27을 그대로 적용했다(충돌 없음)고른 방법과 버린 대안
위험과 영향
검증
desktop 호스트 node 24.14.0, CI env(
CI=true,VITE_BUILD_ID설정), heavy lock 아래에서 돌렸다.953381a9(새 clone)3b4c13e2, 같은 조건)고치기 전 main에서 004에 해당하는
release-manifest시험 파일을 따로 돌리면 실패한다(27e342dd).request-fanout도 같다.템플릿 main
6b4f703c: 003=0, 005=0,check-registriesPASS. 이번에 고친 문제는 템플릿에 없다. 필요한 수정이 이미 들어 있다.빌드 id만 다른 두 빌드에서 이름이 바뀌는 청크는 boot·index·render-boot-failure 셋이다. render-boot-failure는 190,478 B에서 12,138 B로 줄었다. react-dom 청크와 디자인 시스템 청크는 이름이 같다.
unit 176 / contract 3 / coverage 347개 파일, 3,609건이 통과한다.
참고: clone 폴더 이름이
…src로 끝나면 coverage 대상 패턴src/**가 절대 경로의 일부에 맞아 루트 파일까지 들어가고, risk-coverage가 실패한다. 제 시험 환경에서 생긴 일이고 CI 경로에는 해당하지 않는다.로그: desktop
/tmp/claude-gates/w1-infra/final-fe/(이 브랜치),/tmp/claude-gates/w1-infra/tpl2/(템플릿),/tmp/claude-gates/w1-infra/pr45/(고치기 전 main).관련
e47a0ab2,af6d0a9f,af312dee,bca5fc27FE-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, 두 번째 음성 경우)을 낸다.