runner가 하나라 프론트 PR 17개(#23~#39)의 run을 하나씩 돌리면 약 7시간이 걸린다(run 하나 약 26분). 그래서 이번만(소유자 승인, 2026-11-13) 17개 PR의 head를 main(c5f29344) 위에 차례로 합쳐, 이 PR 하나로 검사하고 병합한다. 각 PR은 이 브랜치에 merge 커밋 하나씩으로 들어 있다(「merge: PR #N을 합친 검사 브랜치에 넣는다」). 이 PR이 병합되면 각 PR은 「#40으로 병합됨」 댓글을 달고 닫는다. 그 뒤로는 원래대로 PR마다 runner가 돈다.
충돌은 #39 하나였고 총괄이 풀었다. tests/unit/manual-code-blocks.test.ts·tests/unit/template-feature-removal-documents.test.ts의 import 줄이 겹쳤다. 앞 PR(#26)은 template-probe-features.ts import를, #39는 child-process-timeout.ts import를 더했다. 두 import를 모두 남겼다(merge 커밋 57421222).
고른 방법과 버린 대안
고른 것: 합친 트리를 한 번 검사하고 이 PR을 병합한다.
버린 것:
16·17개 run을 그대로 기다리기(약 7시간).
개별 PR을 순서대로 병합하기. #39는 앞 PR과 충돌해 Gitea에서 바로 병합되지 않는다.
위험과 영향
이 run이 빨강이면 어느 PR 탓인지 바로 알 수 없다. 그때는 실패한 게이트와 바뀐 파일로 PR을 좁히고, desktop에서 그 PR만 다시 돌린다.
#39(시험 timeout을 실측값으로만 주고 손 숫자를 거절)가 다른 PR의 새 시험에도 적용된다. 그 PR들의 손 숫자 timeout이 여기서 처음 걸릴 수 있다.
검증
이 PR의 runner merge job 셋이 검증이다. 병합 뒤 main push run이 main 단계(FE-GATE-029·030 포함)를 본다.
## 무엇을, 왜
runner가 하나라 프론트 PR 17개(#23~#39)의 run을 하나씩 돌리면 약 7시간이 걸린다(run 하나 약 26분). 그래서 이번만(소유자 승인, 2026-11-13) 17개 PR의 head를 main(`c5f29344`) 위에 차례로 합쳐, 이 PR 하나로 검사하고 병합한다. 각 PR은 이 브랜치에 merge 커밋 하나씩으로 들어 있다(「merge: PR #N을 합친 검사 브랜치에 넣는다」). 이 PR이 병합되면 각 PR은 「#40으로 병합됨」 댓글을 달고 닫는다. 그 뒤로는 원래대로 PR마다 runner가 돈다.
합친 순서와 head: #23 `37c6e9bc`, #24 `2f0730e7`, #25 `8c1bab29`, #26 `ed8c6204`, #27 `70b1be29`, #28 `78938e8f`, #29 `50d623c4`, #30 `fb1ca6af`, #31 `e941c3df`, #32 `2a4d46fa`, #33 `7fa825e5`, #34 `f1074370`, #35 `d838be54`, #36 `9ebd0856`, #37 `088e1282`, #38 `03744e19`, #39 `ceaf316f`.
충돌은 #39 하나였고 총괄이 풀었다. `tests/unit/manual-code-blocks.test.ts`·`tests/unit/template-feature-removal-documents.test.ts`의 import 줄이 겹쳤다. 앞 PR(#26)은 `template-probe-features.ts` import를, #39는 `child-process-timeout.ts` import를 더했다. 두 import를 모두 남겼다(merge 커밋 `57421222`).
## 고른 방법과 버린 대안
- 고른 것: 합친 트리를 한 번 검사하고 이 PR을 병합한다.
- 버린 것:
- 16·17개 run을 그대로 기다리기(약 7시간).
- 개별 PR을 순서대로 병합하기. #39는 앞 PR과 충돌해 Gitea에서 바로 병합되지 않는다.
## 위험과 영향
- 이 run이 빨강이면 어느 PR 탓인지 바로 알 수 없다. 그때는 실패한 게이트와 바뀐 파일로 PR을 좁히고, desktop에서 그 PR만 다시 돌린다.
- #39(시험 timeout을 실측값으로만 주고 손 숫자를 거절)가 다른 PR의 새 시험에도 적용된다. 그 PR들의 손 숫자 timeout이 여기서 처음 걸릴 수 있다.
## 검증
이 PR의 runner merge job 셋이 검증이다. 병합 뒤 main push run이 main 단계(FE-GATE-029·030 포함)를 본다.
템플릿 시험과 드릴이 저장소 사본에 고정 ID로 기능을 만든다. 매뉴얼
코드 조각 시험은 매뉴얼 예시 invoice-feature를(FE-GATE-005), 생성 기능
e2e·청크 복구·부팅 실패 spec은 order-feature를(FE-GATE-008), scaffold
드릴은 scaffold-feature를(FE-GATE-020) 쓴다. 사본에는 제품 기능이 들어
있고 create:feature는 같은 ID나 같은 접두어를 거부한다. 그래서 매뉴얼
1단계 예시대로 invoice-feature를 만든 제품은 기능 코드와 상관없이 merge
게이트에서 막힌다.
고른 방법: 사본에 만드는 기능 ID를 모두 이미 정한 예약 접두어
typecheck-probe-로 옮기고 scripts/lib/template-probe-features.ts 한 곳에
둔다. 매뉴얼 조각은 invoice-feature 기준 그대로 두고, 시험이 조각과
검사 파일의 이름(INVOICE_, Invoice, invoice-, invoice)을 예약 기능의
이름으로 바꿔 넣는다(renameFeatureText). 생성 기능 e2e는 메시지 키와
계약 이름을 ID에서 만든다. 버린 대안: 사본에서 제품의 같은 이름
기능을 먼저 지우기(등록·조립 파일까지 지워야 해 사본이 제품과 달라진다),
create:feature가 흔한 이름을 거부하기(제품 이름을 막는다).
위험·한계: 이름 바꾸기는 낱말 단위 치환이라 조각의 영어 문장 속
invoice도 바뀐다(조각과 검사가 함께 바뀌어 결과는 같다). 제품이
typecheck-probe-로 시작하는 기능을 만들면 다시 부딪친다. 매뉴얼과
create-feature 참조에 쓰지 말라고 적었고 생성 명령이 막지는 않는다.
measure-feature-shape-growth의 s000-feature 꼴 ID는 그대로 뒀다.
검증: desktop에서 RED(이 커밋의 시험을 기준 커밋에 얹음)와 GREEN,
제품 상태(invoice-feature·order-feature를 만든 사본)의 FE-GATE-005·008
재현은 PR 본문에 적는다.
Refs: 1112/08-02
main 5250ff95 전체를 분야 렌즈 아홉(React, 구조·공통 계약, 시험·QA,
UX·디자인 시스템, 접근성, 성능·빌드, 보안, 가드레일·문서, 나머지
adapter)과 지난 발견 재판정 둘로 나눠 리뷰했다. 새 발견은 반박 검증을
거쳐 80건이다(High 0, P1 1: 1112/08-02 템플릿 시험의 고정 기능 ID).
지난 리뷰가 연 118행은 고쳐짐 33, 일부 35, 남음 46, 재발 2다.
리뷰 README 하나와 영역 기록 열다섯을 docs/reviews/2026-11-round9-*.md
파일 묶음으로 둔다. 영역 기록은 서브에이전트가 쓴 원문이고, 작업 폴더
절대 경로만 줄였다. 리뷰 중 코드는 고치지 않았다.
위험·한계: 실행 증거는 desktop에 CI env를 준 실행이다(실제 runner
미검증). 실험 X-GD02·X-GD02b와 수정 라운드는 README 16절에 이어 적는다.
결정이 필요한 12건(R9-D1~D12)은 권하는 안과 함께 7절에 있다.
검증: scripts/verify.sh docs(노트북) 통과. 게이트 실행 결과는 README
11.1절(merge 13/14 rc=0, FE-GATE-013은 호스트 제약 조건 충족,
documentation rc=0).
Refs: round9 확인 리뷰
편집 훅 N5는 CLAUDE.md, src/**/AGENTS.md·CLAUDE.md, .claude/ 아래
문서를 노트북 검사(check-work-docs.py)로 끝나는 파일로 센다. 그러나
desktop 게이트 verify:documentation도 그 문서들을 읽는다(경로·명령·
script·FE-GATE ID). 그래서 지침 문서만 고친 턴은 desktop 실행 없이
끝나고, 루트 AGENTS.md와 experts.md도 노트북 검사만 안내한다.
고른 방법: LAPTOP_ONLY에서 문서(.md)를 빼고 .claude/의 문서 밖 파일
(설정·훅 상태)만 남긴다. AGENTS.md 검증 줄과 experts.md 경로표에
desktop verify:documentation을 더한다. 버린 대안: 훅은 두고 문서만
고치기(턴 끝 알림이 계속 빠진다).
위험·한계: 지침 문서만 고친 턴도 이제 desktop 실행 전까지 한 번
막힌다. 막지는 않고 이유를 알린다(N5 동작 그대로).
검증: python3 -m unittest discover -s scripts/tests 72개 통과(노트북).
새 시험 test_living_instruction_documents_need_the_desktop은 고치기 전
코드에서 다섯 경로 모두 실패했다.
Refs: 1112/08-04
pnpm-workspace.yaml의 minimumReleaseAgeExclude 넷(@playwright/test,
playwright, playwright-core 1.62.0, eslint 10.8.0)은 2026-07-25에 그 버전이
최소 공개 경과 기간보다 어릴 때 더했다. 주석이 적은 제거 조건("설정한
최소 경과 기간보다 오래되면 지운다")을 몇 달 전에 넘겼다. 남은 예외는
같은 버전의 다른 출처가 생겨도 지연 검사를 건너뛰게 한다.
고른 방법: 넷과 그 주석을 지운다. 버전 고정(package.json exact pin)은
그대로다. 버린 대안: 주석만 고치기(예외가 할 일이 없다).
위험·한계: 이 버전들을 다시 받을 때 pnpm이 지연 검사를 한다. 이미 하루
넘게 지난 버전이라 설치는 바뀌지 않는다.
검증: FE-GATE-001(verify:lockfile)과 tests/unit/pnpm-install-policy.test.ts,
desktop의 frozen-lockfile 오프라인 설치(PR 본문). RED 없음 — 설정 정리라
동작이 바뀌지 않는다.
Refs: 1112/07-02
config/hosting/security-headers.json의 Content-Security-Policy는 hosting
fixture가 복사하고 verify-hosting-headers가 둘을 대조한다. 그러나 정책이
무엇을 허용하는지 보는 검사는 없다. script-src에 'unsafe-inline'을 넣은
선언도 모든 게이트를 지난다.
고른 방법: scripts/lib/csp-policy.ts의 cspPolicyProblems가 code 지시어
(default-src, script-src*, style-src*, object-src)의 'unsafe-inline'·
'unsafe-eval'·*와 script 계열의 scheme 통째 허용(https:)을 거절하고,
script-src·default-src가 없는 정책도 거절한다. check:browser-security
(FE-GATE-013)가 선언 파일에 부른다. 버린 대안: fixture를 선언에서 만들기
(대조 검사가 이미 같은 값을 지킨다. 허용 내용은 여전히 안 본다).
위험·한계: 제품이 인라인 스크립트가 필요한 CSP로 바꾸면 이 검사가
막는다. 그때는 nonce·hash로 바꾼다. connect-src의 https:는 보지 않는다
(스크립트 실행이 아니다).
검증: tests/unit/csp-policy.test.ts가 고치기 전에는 모듈이 없어 실패하고
고친 뒤 통과한다(desktop, PR 본문). check:browser-security는
`parts FE-GATE-013` 뒤 명령으로 돈다.
Refs: 0929/13-04
생성 기능 e2e는 짝 백엔드의 Envelope을 흉내 낸다고 적지만 실패 응답이
다르다. 429에 RATE_LIMITED와 category SYSTEM을, 500에 category SYSTEM을
보낸다. 짝 백엔드는 RATE_LIMIT_EXCEEDED(RATE_LIMIT, 429, retryable)와
INTERNAL_ERROR(INTERNAL, 500)를 보낸다(OperationalError.java). 지금은 판정이
status만 보아 결과가 같지만, code나 category를 읽게 바뀌면 시험이 실제와
다른 답으로 통과한다.
고른 방법: failure()가 category를 받고 두 응답을 백엔드 행 값으로 보낸다.
위험·한계: 짝 백엔드 행이 바뀌면 손으로 다시 맞춘다(pin 대조 밖).
검증: tests/e2e/generated-feature.spec.ts 세 엔진(desktop, PR 본문).
RED 없음 — 시험 자료만 실제 값으로 바꾼다.
Refs: 1112/03-09
오래된 탭 시험은 A 탭의 플랫폼 화면과 함께 preload된 청크도
preloadunused 허용에 넣는다. 그러나 strict fixture의 preload 검사는 끝에
열린 문서만 읽고, A 탭은 그때 reload로 B 문서가 된다. 그래서 A 목록은 A
문서에 쓰일 일이 없고, B 문서에 같은 이름으로 나타나는 정말 쓰이지 않은
preload를 가릴 수만 있다.
고른 방법: A 목록을 지우고 B context routes 모듈의 청크만 허용한다.
주석을 fixture 동작(끝에 열린 문서만)에 맞춘다.
위험·한계: B 빌드가 A와 같은 이름의 공유 청크를 preload하고 쓰지 않으면
이제 실패한다. 그것이 이 시험이 잡아야 할 것이다.
검증: 이 spec을 세 엔진에서 세 번씩 돌린다(desktop, PR 본문). RED 없음 —
허용을 좁히는 변경이라 지금 통과가 그대로여야 한다.
Refs: 1112/03-06
`corepack pnpm ci:gate <ID>`가 실패하면 콘솔에는 `FE-GATE-013 security: FAIL`
한 줄만 나온다. 어느 명령이 실패했는지, 원인이 남은 로그가 어디인지
말하지 않는다. 그래서 verify.sh의 게이트 로그도 그 세 줄뿐이고, 원인을
보려면 artifacts/quality/gates/ 아래 로그를 따로 찾아야 한다. 규칙
(.claude/rules/gates-and-budgets.md)은 실패 메시지가 넘은 항목·잰 값·
고칠 파일을 말하라고 한다.
고른 방법: scripts/lib/ci-gate-failure.ts의 formatGateFailure가 FAIL 줄,
실패한 명령(없으면 명령 밖 검사라고), 로그 경로, 로그 끝 20줄을 만든다.
run-ci-gate.ts가 기대에 어긋난 명령을 기억해 넘긴다. 버린 대안: 명령의
출력을 그대로 흘리기(PASS일 때도 콘솔이 길어진다).
위험·한계: 끝 20줄에 원인이 없을 수 있다. 로그 경로가 있으니 거기서 본다.
검증: tests/unit/ci-gate-failure.test.ts 셋이 고치기 전에는 모듈이 없어
실패하고 고친 뒤 통과한다. desktop의 FE-GATE-013(호스트 제약으로 실패)이
새 출력을 낸다(PR 본문).
Refs: 1112/08-13
isRefusedOnEveryAttempt는 failure.code를 읽는데, 그 값은 기능의 mapProblem이
정한다(1112/01-06). 그래서 둘이 틀린다.
- 기능이 백엔드 400 VALIDATION_FAILED를 자기 code로 바꾸면 모든 시도가 받는
거절인데도 결과 불명이 풀리지 않는다.
- 기능이 시각·데이터베이스를 읽는 자기 거절(400)을 VALIDATION_FAILED로 바꾸면
첫 요청이 반영됐을 수 있는데도 결과 불명이 풀린다.
AppFailure에 backendCode를 더한다(선택 칸, 추가만). HTTP 바인딩이 ENVELOPE_V1
operation의 PROBLEM에서 백엔드 error.code를 그대로 싣고, 판정은 이 칸과
status만 읽는다. Envelope가 없는 operation의 실패에는 싣지 않아 결과 불명이
풀리지 않는다(안전한 쪽). 버린 대안: 판정 표를 기능 code에 맞춰 늘리기(기능이
code를 바꿀 때마다 표가 어긋난다).
위험·한계: createFailure로 실패를 직접 만들어 재전송 거절을 흉내 내던 코드는
backendCode를 함께 줘야 결과 불명이 풀린다. 템플릿 안에서는 코디네이터 시험
넷뿐이고 고쳤다. 다운스트림 시험이 같은 방식이면 CHANGELOG [계약]에 적는다.
mapProblem이 예외를 던져 MAPPING_CONTRACT_VIOLATION이 된 실패에는 싣지 않는다.
Refs: 1112/01-06, 1106/03-01
2026-11-07~08의 정리(문서 이동, 참조 기능 삭제, CI 재편) 뒤 살아 있는
문서가 지금 코드와 다른 말을 한다.
- 현재 계약 문서 둘과 스타터 문서가 기록(docs/design/)을 정본으로
가리킨다. 정본을 frontend-application-foundation.md·src/bootstrap/,
패턴 표·계층 규칙으로 바꾸고 설계서는 배경으로 둔다(1112/02-06).
- 실시간 대응표 둘(짝 백엔드 출구, poll attempt 결과)이 기록에만 있었다.
optional-adapter-recipes.md로 옮기고 코드 주석·매뉴얼 03·설계서 머리
블록이 옮긴 곳을 가리킨다(1112/09-02).
- 실행 격리 변수 목록을 설계 기록이 아니라 scripts/lib/run-isolation.ts로
가리킨다(1112/08-17).
- 계약 소유 절 이름(「판단 규칙」), pin 대조 시험의 게이트(005·007),
drift 검사 범위(1112/02-07). INVENTORY 머리의 손 숫자와 지킬 수 없는
꼬리 문장(1112/02-08).
- 검증 안내: 검사기를 바꾸면 FE-GATE-029, 문서면 desktop
verify:documentation(1112/08-05, 08-04). FE-GATE-012는 merge 단계다
(08-16). N6이 알리는 파일을 좁혀 적는다(08-10). 한 파일 시험은
verify.sh exec(08-11). 문서 검사 범위의 손 사본을 정본 한 곳으로(08-07).
- create:feature 참조의 Next: 3과 되돌리기(08-08), 손으로 옮긴 숫자
(08-19), 라운드 없는 리뷰 ID 17곳에 0925를 붙인다(08-15).
- secret scan 범위 설명(1112/07-03), lab이 기능 라우트를 읽는 문장
(1103/16-06), README 동기화 기준점·제품 소유 파일·선택 기능 결함 몫
(0929/14-02, 14-03, 13-10), 커밋을 다시 지은 모든 통합의 해시 대조
(1106/14-02).
고른 방법: 문장을 코드에 맞춘다. 표는 옮기고 숫자는 정본을 가리킨다.
버린 대안: 기록 문서 본문 고치기(기록은 머리 블록만 고친다).
위험·한계: 문서 검사 범위 목록을 지운 ci-quality-gates.md는 이제
docs/README.md 5절과 gates.md 7절을 읽어야 한다. 매뉴얼 02 7절 업로드
예의 declare module 문제(1112/09-01)는 고치는 방향이 check:architecture
규칙과 부딪쳐 결정 대기로 남긴다.
검증: scripts/verify.sh docs(노트북) 통과. desktop verify:documentation과
FE-GATE-005(문서를 읽는 시험)는 PR 본문에 적는다.
Refs: 1112/02-06, 1112/02-07, 1112/02-08, 1112/07-03, 1112/08-04,
1112/08-05, 1112/08-07, 1112/08-08, 1112/08-10, 1112/08-11, 1112/08-15,
1112/08-16, 1112/08-17, 1112/08-19, 1112/09-02, 1103/16-06, 0929/14-02,
0929/14-03, 0929/13-10, 1106/14-02
편집 훅 N5는 desktop에서만 확인되는 파일을 고친 뒤 desktop 실행이 없으면
턴 끝에 한 번 알린다. 그런데 명령 안에 `scripts/verify.sh` 글자만 있어도
뒤 낱말을 단계로 보고 실행으로 셌다. `sed -n 1,80p scripts/verify.sh && ls`,
`grep … scripts/verify.sh config/ci/gates.json`, `git log -- scripts/verify.sh
docs/work`, `scripts/verify.sh merge --dry-run`, 로그를 읽기만 하는
`ssh desktop 'cat …log | grep vitest'`가 모두 알림을 지웠다. README는 "돌린
명령"만 센다고 적는다.
고른 방법: 명령줄을 ;·&&·||·|·( 로 나눠 한 명령씩 본다. 앞의 VAR=값과
timeout·nohup 같은 감싸는 낱말을 건너뛴 첫 낱말이 verify.sh이고, 다음
낱말이 단계 이름 꼴이며 docs·hooks가 아니고, --dry-run·--on here가 없을
때만 센다. ssh는 원격 명령이 읽기 명령(cat·grep·tail 등)뿐이면 세지 않는다.
버린 대안: config/ci/gates.json의 stage id를 읽어 대조하기(시험 repo와 다른
checkout에서도 같은 목록을 읽어야 한다. exec·gate·script도 단계 자리에 온다).
위험·한계: 처음 보는 감싸는 낱말(예: `flock <파일> scripts/verify.sh`)은
실행으로 세지 않아 알림이 한 번 더 뜬다. 막지는 않는다.
검증: python3 -m unittest discover -s scripts/tests 74개 통과(노트북). 새 시험
다섯 경우가 고치기 전 코드에서 실패했다.
Refs: 1112/08-09
앞 커밋 뒤 확인 리뷰가 셋을 찾았다.
- 같은 지시어가 두 번이면 검사는 뒤 값을, 브라우저는 앞 값을 쓴다(CSP3).
키워드도 대소문자를 가려 비교한다. 그래서 `script-src 'self' 'unsafe-inline';
script-src 'self'`와 `'Unsafe-Inline'`이 통과한다.
- 0929/13-04 완료 기준 「CSP를 바꿀 때 한 파일만 고친다」가 안 됐다. hosting
fixture가 선언한 보안 header 일곱을 표면 넷에 그대로 복사한다.
- check:browser-security가 검사를 부르는 연결을 지키는 시험이 없다.
고른 방법: 지시어는 첫 것만, 이름과 키워드는 소문자로 읽는다. 선언 문서를
읽는 declaredCspProblems를 두고 check:browser-security가 그것을 부른다.
check:security:fixtures(FE-GATE-029)가 거절 fixture(대소문자를 바꾼
'unsafe-inline'이 앞 script-src에 있음)를 거절하고 선언을 받는지 본다. hosting
fixture에서 보안 header를 지우고, verify-hosting-headers의 fixture 모드는
보안 header가 필요한 표면에 선언을 답으로 채운다. fixture가 적은 값은 그대로
host의 답으로 비교한다. 버린 대안: fixture를 선언에서 생성하는 스크립트(생성물이
하나 더 생기고 대조할 것은 같다).
위험·한계: fixture 모드의 보안 header 비교는 선언끼리의 비교가 된다. 전에도
fixture 모드는 UNVERIFIED였다(live 모드만 host를 본다).
검증: csp-policy.test.ts 새 시험(브라우저처럼 읽기 다섯, 뒤 지시어 무시,
declaredCspProblems 넷)과 hosting-probe.test.ts 새 시험 둘(선언만 바꾼 뒤
fixture 통과, fixture가 적은 header는 비교)을 고치기 전 코드에서 RED로 보고
desktop에서 GREEN·FE-GATE-029를 돌린다(PR 본문).
Refs: 0929/13-04
앞 커밋의 시험은 출력 문구를 만드는 순수 함수(formatGateFailure)만 본다.
run-ci-gate.ts에서 실패한 명령을 기억하는 줄(failedCommand = commandLine)을
지워도 그 시험은 통과한다(확인 리뷰, fe-testing 함정 1).
고른 방법: tests/system/ci-runner의 임시 root 방식 그대로, FE-GATE-004의 명령
하나를 일부러 실패하는 script로 바꾼 계약으로 run-ci-gate.ts를 돌린다. stderr가
게이트, 실패한 명령, 로그 경로, 원인 줄을 말하는지 본다. timeout은 같은 방식의
그 시험에서 잰 값을 쓴다.
검증: 실패한 명령을 기억하는 줄을 지운 변이에서 새 시험이 실패하고 원래
코드에서 통과한다(desktop, PR 본문).
Refs: 1112/08-13
접근성 자동 검사 셋이 지키는 것에 닿지 않는다.
- reduced-motion e2e가 body의 animationDuration으로 브라우저 기본값
0s도 받아들인다. responsive.css의 reduced-motion 규칙을 지워도
통과한다(1112/05-08).
- 예제 화면을 Storybook 갤러리로 옮기면서 화면 전체 axe 검사가 빠졌다.
기능이 없는 템플릿에서 빈·오류·로그인·권한 표면이 axe를 받지
않는다(05-04).
- 제품이 WCAG 2.2 AA를 약속하는데 스캔 태그는 2.1까지다. 같은 태그 목록이
네 곳에 손으로 적혀 있다(05-05 일부).
- 셸 compact drawer는 modal이고 모든 셸 route에 있는데, 라우트 수동 기록
셋과 checklist 예시가 M4를 "modal 없음"으로 채운다(05-07).
고른 방법: reduced-motion 시험은 규칙이 없을 때의 값(0s)과 규칙의 값
(0.01ms)을 함께 본다. 갤러리 두 story를 light·dark에서 화면 전체 axe로
본다. 태그는 tests/support/browser/axe-tags.ts 하나에 두고 wcag22aa를
더한다. 라우트 기록의 M4를 pending으로 바꾸고 checklist에 셸 drawer를
적는다. 수동 기록 양식에 2.4.11·2.5.8 칸을 더하는 일(05-05의 나머지)은 양식과 생성
출력이 바뀌는 일이라 이 커밋에 넣지 않았다. R9-D9(권하는 안으로 정함
(2026-11-12, 총괄))에 따라 따로 한다.
위험·한계: wcag22aa는 axe의 target-size 규칙만 더한다. 포커스 가림(2.4.11)
같은 기준은 여전히 수동이다.
검증: reduced-motion 시험이 규칙을 지운 변이에서 실패하고 원래 코드에서
통과한다. 갤러리 axe 넷과 FE-GATE-009는 desktop에서 돈다(PR 본문).
Refs: 1112/05-04, 1112/05-05, 1112/05-07, 1112/05-08
결정 색인(docs/work/reference/decisions.md)에 빠진 것이 셋이다.
- 2026-11-07 소유자가 승인한 「검사기 자기 시험과 check:ci:gating을 main
단계 FE-GATE-029로, CI 계약 기준선 파일 삭제」는 커밋 f6b2b96c 본문과
ci-quality-gates.md 머리에만 있다(1112/08-14).
- 지난 리뷰가 결정 대기로 남긴 15행(1105/06-02, 1103/03-01, 0929/02-02,
1101/02-02, 0929/02-06, 0929/04-02, 0929/04-03, 1103/14-02, 1103/16-06,
0929/14-06, 1101/10-05, 1101/10-06, 1101/10-08, 0929/12-07, 1105/15-04)이
3.1절 표에 없다. 그 문서 3절 규칙으로는 결정 대기가 아니라 미완이다
(1112/10-02).
- round9가 낸 결정 R9-D1~D12는 2026-11-12 총괄이 권하는 안으로 정했다
(소유자 상시 지시 「중간 확인 없이 권하는 안으로」). 새 결정 대기
R9-D13이 있다.
고른 방법: 2.2절에 FE-GATE-029 단계 결정과 R9-D1~D12를 「권하는 안으로
정함(2026-11-12, 총괄)」으로 한 행씩 둔다. 3.1절에 R9-D13과 지난 15행을
더한다. D1에는 R9-D10으로 「갱신한다」로 정했다고 적는다. 선택지 원문은
옮기지 않고 출처를 단다.
위험·한계: 지난 15행은 결정이 아직 없다. 색인에 올렸을 뿐 고치지 않았다.
검증: scripts/verify.sh docs(노트북) 통과. desktop verify:documentation은
PR 본문에 적는다.
Refs: 1112/08-14, 1112/10-02
앞 두 커밋 뒤 확인 리뷰가 퇴행 하나와 빠진 곳 하나를 찾았다.
- 실행 판정을 다시 쓰면서 ssh 뒤 `-`로 시작하는 낱말만 뺐다. 값을 받는 옵션
(`ssh -o BatchMode=yes desktop …`, `ssh -p 22 desktop …`)은 그 값을 호스트로
읽어 desktop 실행으로 세지 않는다. `bash scripts/verify.sh merge`도 첫 낱말이
verify.sh가 아니라 세지 않는다. origin/main 판은 셋 다 셌다.
- 노트북 파일에서 문서를 뺀 것이 `.claude/`뿐이다. `scripts/hooks/README.md`와
`docs/ledger/README.md`도 desktop `verify:documentation`이 읽는다.
고른 방법: ssh 뒤 옵션은 값을 받는 것(-o -p -i -l -J -F 등)이면 다음 낱말까지
건너뛰고 남은 첫 낱말을 호스트로 본다. bash·sh를 감싸는 낱말에 더한다.
scripts/hooks/·scripts/tests/·docs/ledger/ 패턴에서도 `.md`를 뺀다. README
문장을 같이 고친다.
검증: python3 -m unittest discover -s scripts/tests 74개 통과(노트북). 새 경우
다섯(bash, ssh -o, ssh -p, 두 README)이 고치기 전 코드에서 실패했다.
Refs: 1112/08-04, 1112/08-09
useApplicationQuery가 "데이터가 있고 마지막 조회가 실패했다"는 파생 값을
effect로 state에 복사한다. 다시 시도가 그 값을 지운 뒤 refetch해도, 조회
중에 effect가 다시 돌아 true로 되돌린다. 그래서 낡은 데이터의 다시 시도가
진행 중에도 지난 실패(stale-degraded)를 보인다(1112/01-05).
query·mutation 실패 진단은 원인을 버린다. cache의 onError가 모든 실패를
cache.operation.failed로 남기는데, ApplicationQueryError에 kind가 없어
safeErrorKind가 이름(APPLICATION_QUERY_ERROR)을 쓴다. 404, 필드 거절,
abort가 한 가지로 남는다. 예상 밖 throw는 정의 이름 대신 고정 문자열
(APPLICATION_QUERY, APPLICATION_MUTATION)을 쓴다(1112/01-04).
고른 방법: staleFailure를 query.isError && hasData && !isFetching으로 렌더
중에 계산하고 state와 effect를 지운다. 다시 시도 중은 refreshing이다.
ApplicationQueryError가 failure.kind를 kind로 싣는다. 예상 밖 throw는 query
정의 ID와 mutation 정의 ID를 쓰고, 정의가 없는 legacy mutation만 옛 이름을
둔다. 버린 대안: cache onError가 ApplicationQueryError를 아예 세지 않기
(서버 실패를 cache 진단에서 잃는다).
위험·한계: 낡은 데이터의 배경 재조회 중에도 stale 대신 refreshing을
보인다. 진단 error_kind 값이 바뀌어 그 값을 읽는 대시보드가 있으면
바꿔야 한다(템플릿 안에는 없다).
검증: tests/component/application-query-bridge.test.tsx의 새 시험 셋이
고치기 전 코드에서 실패하고 고친 뒤 통과한다(desktop, PR 본문).
Refs: 1112/01-04, 1112/01-05
생성 기능의 입력(create<Base>FeatureInput)은 실패한 읽기를 telemetry
warning(<base>.list.failed 등)으로 보낸다. 그런데 abort 판정이
REQUEST_ABORTED 하나뿐이다. 로그아웃·계정 전환의 scope fence로 끝난
요청은 SCOPE_GENERATION_CHANGED로 오므로 실패로 보고된다. 테스트 전략
7.1절은 abort를 telemetry 실패로 세지 않는다고 적는다.
고른 방법: abort 판정을 src/contracts/errors.ts의 isAbortFailure 하나로
두고(REQUEST_ABORTED, SCOPE_GENERATION_CHANGED), 생성 입력이 그것을
부른다. 생성 입력 시험에 fence 경우를 더한다. 버린 대안: 생성 템플릿에
kind 둘을 적기(판정이 기능마다 사본이 된다).
생성 기능 API가 isAbortFailure를 가져오면서 기능 모양 측정의 초기
JavaScript가 바뀌었다(context 하나당 4 B → 21 B, 허용치 16 B를 넘어 기록 시험이
실패했다). 생성 코드를 바꾼 변경과 같은 커밋에서 측정 스크립트(--initial-baseline
--write)로 기록을 다시 썼다.
위험·한계: 이미 생성한 기능은 바뀌지 않는다. CHANGELOG에 그 두 줄을
옮기는 안내를 적는다. isAbortFailure는 contracts의 새 export다(추가만).
검증: tests/unit/abort-failure.test.ts, create-feature.test.ts의 새
시험이 고치기 전 코드에서 실패하고 고친 뒤 통과한다. 생성 기능 안의 새
시험은 FE-GATE-020 scaffold 드릴이 돈다(PR 본문).
Refs: 1112/01-03
문제: `scripts/verify.sh parts <ID>`는 expect=fail 명령(검사기의 음성
fixture)을 종료 코드만으로 판정한다. `ci:gate`(run-ci-gate.ts의
classifyGateStepResult)는 정해진 종료 코드와 정해진 진단 문구
(`expectedDiagnosticId`)가 둘 다 있어야 통과시킨다. 그래서 검사기가
깨져 엉뚱한 원인으로 exit 1(TypeError 등)을 내도 parts는 그 음성
fixture를 통과로 센다. 문서가 검사기를 고친 뒤 `parts FE-GATE-029`를
돌리라고 하는 바로 그 경로다. args를 버리던 앞 절반은 79a225b6(#19)이
고쳤다.
고른 방법: 계약에서 `expectedDiagnosticId`를 함께 읽고, expect=fail
명령의 출력을 따로 잡아(`STEP_CAPTURE`) 진단 문구가 있는지 본다.
판정은 classifyGateStepResult와 같은 규칙(종료 코드가 같고, 출력에
문구가 들어 있음)이다. 어긋나면 무엇이 어긋났는지 한 줄을 stderr에
낸다.
위험·한계: 문구가 빈 음성 fixture는 예전처럼 종료 코드만 본다(ci:gate도
빈 문구는 늘 맞는다). 시스템 컨테이너 접두어가 붙은 게이트는 래퍼
출력까지 함께 잡는다.
검증: scripts/tests/test_verify.py에 가짜 corepack 시험을 더했다. 음성
fixture가 맞는 종료 코드에 엉뚱한 문구를 내면 parts FE-GATE-029가
rc=1이어야 하는데, 고치기 전 rc=0으로 실패했다(RED). 고친 뒤 9개 시험
통과. desktop 실제 검사기로 `scripts/verify.sh parts FE-GATE-029`
rc=0(음성 fixture 9개가 등록된 문구를 냄), 로그
/tmp/claude-gates/w2fe2-gd01/. `scripts/verify.sh docs` OK.
Refs: 1112/08-01 (GD-01)
문제: FE-GATE-028(release 단계 수동 접근성 검토)의 증거 목록은 손으로
쓴 라우트 기록 목록이다. 검토는 레지스트리의 모든 라우트(APP_HOME,
EXAMPLES_PLATFORM, NOT_FOUND)를 보는데 목록에는 APP_HOME·NOT_FOUND만
있어, EXAMPLES_PLATFORM의 서명 기록 원문이 release 증거로 남지 않는다.
고른 방법: 그 기록을 source-controlled artifact로 더해 증거에 넣는다.
CI 계약 시험이 증거의 route-review 경로와 플랫폼 라우트
(`PLATFORM_ROUTE_REGISTRY`)의 기록이 같은지 본다.
- 플랫폼 라우트만 대조하는 이유: 기능 라우트는 create:feature가 기록을
만들지만 이 계약은 고치지 않는다. 레지스트리 전체와 대조하면 생성 기능을
더한 scaffold 드릴 사본(FE-GATE-020)이 늘 실패한다.
위험·한계: 파생 프로젝트의 기능 라우트 기록은 여전히 증거 목록에 저절로
들어가지 않는다. 막으려면 검토 명령이 기록을 묶은 증거 하나를 만드는
설계가 필요하고, 그 명령(`scripts/verify-a11y-manual.ts`)은 지금 다른
수정(1112/05-01)이 고치는 중이라 이 커밋에서 손대지 않았다.
검증(desktop): 새 시험이 고치기 전 EXAMPLES_PLATFORM 하나가 빠져
실패(RED), 고친 뒤 ci-workflow-generation·manual-a11y-evidence 448개
통과, generate:ci-workflow 변화 없음, check:ci·check:types·eslint rc=0.
로그 /tmp/claude-gates/w2fe2-a18red·a18green/.
Refs: 1112/05-18 (A11Y-18)
문제: 제거 드릴(`test:sample-removal -- --feature=<id>`)의 잔여물 검사는
`src`의 경로와 본문을 대소문자 무시 부분 문자열로 찾는다. 그래서 합법
ID `product-feature`를 지우면 템플릿 파일 열 개(`product-features.ts`,
`product-features-port.ts`와 그것을 가져오는 파일들)와 템플릿 시험 이름
여섯(`product-feature-switch.test.tsx` 등)이 잔여물로 잡혀 드릴이
실패한다. 매뉴얼 예시 ID `invoice-feature`는 걸리지 않아 남아 있었다.
고른 방법: spec 본문에 이미 쓰는 규칙에 맞춘다. 본문은 이름 단위
(대소문자 구분, 앞뒤에 `[A-Za-z0-9_-]` 없음), 경로는 세그먼트가 이름과
같거나 그 첫 `.` 앞부분이 같을 때만 센다. `src/.generated/`는 기능 목록에서
다시 만드는 파생물이라 뺀다.
- 버린 대안: 「파일 이름이 ID로 시작」. 템플릿의 `product-feature-*` 시험
이름이 그대로 걸린다.
위험·한계: 한 단어 ID(`search` 등)는 템플릿 본문에 보통 낱말로 있어 여전히
잡힐 수 있다. 본문 규칙으로는 자료와 참조를 가릴 수 없다(spec은 한 단어
이름을 아예 보지 않는다).
검증(desktop): 구현을 main으로 되돌린 상태에서 새 시험 2개 실패(RED),
고친 뒤 feature-residue·feature-removal-argument 11개 통과, eslint·
check:types rc=0. 로그 /tmp/claude-gates/w2fe2-res1/.
Refs: 1105/16-04
문제: `check:ci:gating`(FE-GATE-029)은 `*.test.*`와 `*.spec.*`를 모두 모은 뒤
게이트 명령이 닿는 경로 접두어만 본다. 그래서 `tests/unit/x.spec.ts`는
「게이트 안」으로 세지만 vitest.config.ts는 `*.test.{ts,tsx}`만 모아 아무
게이트도 그 파일을 돌리지 않는다.
고른 방법: 경로마다 그 경로를 돌리는 runner를 함께 적는다
(`gatedTestTargets`: Vitest 경로와 Playwright `testDir`). Vitest 경로는
`*.test.*`만, Playwright `testDir`는 기본 testMatch처럼 `*.spec.*`와
`*.test.*`를 게이트 안으로 본다. 판정(`ungatedTestFailures`)은 이 목록을
받고, 문자열만 주면 Vitest 경로로 본다. `gatedTestPaths`(경로만)는 다른
호출자를 위해 그대로 둔다.
위험·한계: Playwright 설정이 testMatch를 좁혀도 그 testDir의 두 꼴을 모두
게이트 안으로 본다(예전과 같다).
검증(desktop): 새 시험이 판정 규칙을 빼는 변이에서 실패(RED), 고친 뒤
ungated-tests·ungated-scripts·test-all-paths·removal-drill-test-paths 29개
통과, 실제 `check:ci:gating` PASS, `tests/unit/probe.spec.ts`를 두면 그
파일 이름으로 rc=1, eslint·check:types rc=0. 로그
/tmp/claude-gates/w2fe2-ung3/.
Refs: 0929/12-06
문제: release의 provider job 둘(vulnerability·provenance)은 FE-GATE-013과
같은 provider sandbox(systemd-run scope, bwrap --unshare-pid/ipc/uts/net)를
돈다. 그런데 생성 workflow의 runner 요구 주석은 게이트의
hostRequirements에서 나와 merge_test에만 붙고, provider job에는 없다.
provider 감독 스크립트의 시작 점검도 실행 파일이 있는지만 봐서, 비특권
user namespace를 막는 runner에서는 나중에 bwrap 원문 오류로 끝난다.
고른 방법:
- 계약 job에 선택 칸 `hostRequirements`를 두고 provider job 둘에
FE-GATE-013과 같은 요구를 적는다. 계약이 provider job의 요구가
FE-GATE-013과 같은지 보고(갈라지면 거절), provider 밖 job은 이 칸을 못
쓴다. 생성기가 그 job의 runs-on 옆에 주석을 쓴다.
- `check-system-test-prerequisites.ts`에서 namespace 점검만 함수로 내보내고
(`findProviderSandboxNamespaceFailure`), `run-and-validate-provider.ts`가
provider를 띄우기 전에 부른다. 실패하면 test:system 사전 점검과 같은
문구(제한 이름, bwrap stderr, host 설정, 고치는 법)로 멈춘다.
- 버린 대안: 생성기가 hostEnvironment 게이트의 요구를 provider job에
저절로 붙이기. 연결이 계약에 보이지 않는다.
위험·한계: provider job은 release 단계라 PR run에서 돌지 않는다. 새
점검은 desktop FE-GATE-013의 provider 시스템 시험(감독 스크립트를 실제로
띄움)으로 본다. 「provider 없이 배포할 때」 문서 절은 소유자 결정이라
이 커밋에 없다.
검증(desktop): 구현을 main으로 되돌리고 새 시험만 둔 상태에서 4개 실패
(RED), 고친 뒤 system-test-prerequisites·ci-workflow-generation 445개 통과,
generate:ci-workflow·스냅샷 갱신, check:ci·check:types·eslint rc=0,
verify:documentation PASS_SCOPED. desktop `scripts/verify.sh gate FE-GATE-013`
rc=0 226초(시스템 컨테이너, system 시험 115개 통과 — provider 감독
스크립트를 실제로 띄워 새 점검을 거친다). 로그 /tmp/claude-gates/w2fe2-prov1/,
w2fe2-prov013/.
Refs: 1101/13-03
문제: 제품 기능 제거 드릴(`test:sample-removal -- --feature=<id>`)은
Playwright spec을 돌리지 않는다. 잔여 검사는 spec 본문에서 하이픈 든
기능 이름만 찾아서, 기능을 URL로만 여는 spec(`page.goto("/invoices")`)은
드릴을 통과하고 그 제품의 FE-GATE-008에서야 깨졌다.
고친 것: 드릴이 지우기 전에 그 기능의 route 경로를 받아 둔다(기능이
넘겨받은 플랫폼 경로는 뺀다). `productFeatureResidue`가 그 경로를 받아,
첫 매개변수 앞까지의 경로로 시작하고 문자열 끝이나 `/`·`?`·`#`가
이어지는 문자열이 있는 spec을 잔여물로 센다. `/`뿐인 경로는 찾지 않는다.
버린 대안: 드릴 안에서 FE-GATE-008을 돌리기. 사본 빌드와 세 엔진 실행이
드릴 시간을 몇 분 늘리고, 지운 기능을 가리키는 spec은 이름·경로로 먼저
찾을 수 있다.
위험·한계: 한 단어 ID만 쓰는 spec, URL을 조각으로 만드는 spec은 여전히
못 찾는다(머리 주석에 적음). vitest 시험 본문은 찾지 않는다(test:all이
돈다). 템플릿 자기 spec은 생성 기능 경로 `/product`로 찾아도 0건이다.
검증(desktop): 새 시험 셋 중 경로 시험이 고치기 전 lib에서 실패(RED 1),
고친 뒤 12개 통과. check:types·eslint rc=0. 로그
/tmp/claude-gates/w2fe2-res907/.
Refs: 0925 FOLLOW-UP 09-07
문제: 앞 커밋으로 `src` 검사는 이름 단위가 됐지만, 빌드한 `dist`는 여전히
기능 ID를 대소문자 무시 부분 문자열로 찾았다. desktop에서
`create:feature product-feature` 뒤 그 기능을 지우는 드릴을 돌리면 `src`
검사는 통과하고 `built-fixture-id-residue`가 템플릿 자기 청크
`platform-overview-page-*.js`(`data-product-feature` 속성)로 실패했다.
고친 것: 이름 단위 규칙을 `featureNamePattern`으로 꺼내 `src` 본문과
빌드 결과에 같이 쓴다.
위험·한계: 빌드 결과에서도 대소문자를 가린다. 기능 ID와 폴더는 소문자
kebab이라 놓치는 경우는 없다고 본다.
검증(desktop): feature-residue·feature-removal-argument 15개 통과,
check:types·eslint rc=0(로그 /tmp/claude-gates/w2fe2-res3/). 고치기 전
드릴 실패는 /tmp/claude-gates/w2fe2-resx3/.
Refs: 1105/16-04
문제: 시스템 시험의 대기 함수(`waitForFileContent`, `waitForExistingPath`)가
시간 초과로 실패하면 파일 이름만 말한다. 그때 provider 감독 스크립트가 왜
멈췄는지(stderr)는 실행 객체에만 있고 메시지에 없어, 실패 원인을 보려면
시험을 다시 돌려야 한다.
고른 방법: `startProviderSupervisor`가 지금까지의 stderr를 내는
`output()`을 함께 돌려주고, 두 대기 함수가 실행 객체를 받아 시간 초과
메시지 끝에 붙인다(끝 4,000자). 대기 횟수와 간격은 그대로다.
위험·한계: 시간 초과 경로만 바뀐다. 통과하는 실행의 동작은 같다.
검증(desktop): check:types·eslint rc=0. 시스템 컨테이너에서 「kills and
collects an active provider when its guardian dies」는 그대로 통과하고, 기대
내용을 일부러 틀리게 바꾼 변이에서는 시간 초과 메시지가
`supervisor stderr:`를 담고 실패했다(로그 /tmp/claude-gates/w2fe2-waitx/).
`scripts/verify.sh gate FE-GATE-013` rc=0 235초, status-after 0줄(로그
/tmp/claude-gates/w2fe2-wait013/).
Refs: 1105/12-01
문제: 새 눈 리뷰(정적 읽기)가 앞 두 커밋에서 넷을 찾았다.
- 같은 context의 첫 기능은 context 경로(`/invoice`)를, 뒤 기능은 그 아래
경로(`/invoice/line`)를 받는다. 첫 기능을 지우면 context가 남는데도
형제 기능 spec의 `"/invoice/line"`이 잔여물로 잡혔다.
- 선택 정적 세그먼트(`/invoice/edit?`)는 접두어가 `/invoice/edit?`가 되어
아무 URL도 맞지 않았다.
- `` `/invoice${query}` ``와 Playwright `testDir` 안의 page object
(`tests/e2e/support/*.ts`)는 찾지 않았다.
- `src` 검색이 대소문자를 가리게 되면서, 한 단어 ID(`invoices`)의 옛
부분 문자열 검색이 잡던 route ID 잔여(`route.INVOICES_LIST.title`)를
놓쳤다.
고친 것: 드릴이 지우기 전에 지울 route 경로, 남는 route 경로(플랫폼 포함),
지울 route ID(넘겨받은 플랫폼 ID 제외)를 함께 넘긴다. URL 문자열은 맞는
접두어 중 가장 긴 것이 지운 route일 때만 센다(남는 route와 접두어가 같으면
세지 않는다). 접두어는 선택 세그먼트 앞에서 끊고, `${`도 이어짐으로 본다.
`playwright*.config.ts`의 `testDir` 안 파일 중 vitest 시험이 아닌 것도
본다. route ID는 `src` 본문에서 이름 단위로 찾는다.
버린 대안: react-router `matchRoutes`로 모든 문자열을 route 표에 맞추기.
드릴 lib가 앱 라우터에 묶이고, 고정 접두어 비교로 같은 판정을 낸다.
위험·한계: 지운 route와 남는 route의 고정 접두어가 같으면(`/invoice/:id`를
지우고 `/invoice`가 남음) `/invoice/7`을 세지 않는다. 조각으로 만든 URL은
여전히 못 찾는다.
검증(desktop): feature-residue·feature-removal-argument 19개 통과,
check:types·eslint rc=0(로그 /tmp/claude-gates/w2fe2-res4/). 변이 다섯
(남는 route 비교, 선택 세그먼트, `${`, testDir 파일, route ID 검색을 하나씩
끔)마다 해당 시험 하나가 실패했다(로그 /tmp/claude-gates/w2fe2-resmut/).
Refs: 0925 FOLLOW-UP 09-07, 1105/16-04
donghyeon.kang
changed title from chore(ci): 프론트 PR #23~#38을 합친 트리를 한 번에 검사한다(병합하지 않음) to chore(ci): 프론트 PR #23~#39를 합친 트리를 한 번에 검사한다(병합하지 않음)2026-11-12 22:16:55 +00:00
donghyeon.kang
changed title from chore(ci): 프론트 PR #23~#39를 합친 트리를 한 번에 검사한다(병합하지 않음) to chore(ci): 프론트 PR #23~#38을 합친 트리를 한 번에 검사한다(병합하지 않음)2026-11-12 22:17:06 +00:00
문제: 자식 프로세스 시험의 timeout은 `childProcessTimeout(<잰 ms>)`로
정한다(docs/work/reference/testing.md 2절). 그런데 기본값이 아니라서
`tests/setup.ts` 검사에 걸리지 않는 손 숫자가 남았다. 리뷰가 센 54곳 중
둘(`browser-soak.contract.test.ts`의 `evaluateSoak` 인자)은 timeout이 아니고,
AST로 다시 세면 80곳이다: 시험·describe·hook에 쓴 숫자, `VERIFY_TIMEOUT`·
`PROCESS_HEAVY_TIMEOUT_MS`(파일 넷에 따로)·`PROVIDER_BASE_FIXTURE_TIMEOUT_MS`
같은 상수, `PROCESS_WATCHDOG_MS * 3` 같은 식. taxonomy는 옛 상수를 예로
들었다. 실측으로 보면 손 숫자 하나가 모자랐다: system 시험의 provider 묶음
30초는 desktop 여섯 번 중 두 번 넘겼다.
고친 것:
- 80곳을 desktop에서 잰 가장 긴 실행으로 `childProcessTimeout(<ms>)`에
넘긴다. coverage 묶음(maxWorkers=4)·test:unit 각 9회, integration 3회,
scale(traffic·session·composition·global-local) 3회, 시스템 컨테이너의
tests/system 6회, JSON reporter로 받았다. hook은 파일 시간에서 시험 합을
뺀 값이다. 시간 초과로 끝난 실행은 그 시간을 하한으로 넣었다.
- 상수 사본은 지운다. 한 파일 안에서 여럿이 쓰는 값만
`const X = childProcessTimeout(...)`로 둔다(`VERIFY_TIMEOUT`). guardian
시험의 lease는 시험 timeout이 아니라 `childProcessTimeout(0)`(helper의 최소
30초)로 둔다.
- `tests/unit/test-timeout-declarations.test.ts`가 tests/의 Vitest 파일을
Babel로 읽어 시험·describe·hook의 timeout 인자가 helper 호출(또는 그것을
담은 파일 상수)이 아니면 파일과 줄로 실패한다. 프로세스 안에서 도는 긴
시험(scale tier)도 같은 helper를 쓴다.
- taxonomy 예시, testing.md 2절, `.claude/rules/tests.md` 9번, helper 머리
주석을 같은 방법으로 맞춘다.
버린 대안:
- `tests/setup.ts` 검사를 「helper가 만든 값이 아닌 timeout」까지 넓히기.
helper 값은 30초 단위 숫자라 손으로 쓴 60_000과 가릴 수 없고, hook과
프로세스 안 시험은 보지 못한다.
- 프로세스 안 시험은 손 숫자 그대로 두기. 근거 없는 숫자가 남고 검사가
예외를 가져야 한다.
위험·한계:
- 값이 커진 곳이 있다(15배 규칙): `manual-code-blocks` 300초 → 900초,
provider 묶음 30초 → 480초 등. hang을 늦게 잡는다. 줄어든 곳도 있다
(scale traffic 60초 → 30초 등, 잰 값의 15배 안).
- 측정은 desktop 부하 6~35에서 했다. runner가 더 느리면 다시 잰다.
- 검사 시험은 Vitest 파일 전부를 파싱해 coverage 묶음에서 최대 13.5초
걸렸고, 그 값으로 자기 timeout을 준다. 이름 있는 함수를 콜백으로 넘긴
시험(`it("x", run, 30_000)`)은 못 찾는다.
- 다운스트림: 손 숫자 timeout이 있는 제품 시험은 test:unit에서 이 검사에
걸린다. 메시지가 helper를 알린다.
검증(desktop):
- RED: 검사 시험이 고치기 전 80곳을 파일·줄로 내고 실패. GREEN: 검사·
child-process-timeout 6개 통과. check:types·eslint(바뀐 34파일) rc=0,
verify:documentation PASS_SCOPED, 노트북 `scripts/verify.sh docs` OK.
- 측정 원자료: /tmp/claude-gates/w2fe2-t08m, -t08m2, -t08m3.
- 게이트 결과는 PR 본문에 적는다.
Refs: 1112/03-08
donghyeon.kang
changed title from chore(ci): 프론트 PR #23~#38을 합친 트리를 한 번에 검사한다(병합하지 않음) to chore(ci): 프론트 PR #23~#39를 합친 트리를 한 번에 검사하고 병합한다2026-11-12 22:31:09 +00:00
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.
무엇을, 왜
runner가 하나라 프론트 PR 17개(#23~#39)의 run을 하나씩 돌리면 약 7시간이 걸린다(run 하나 약 26분). 그래서 이번만(소유자 승인, 2026-11-13) 17개 PR의 head를 main(
c5f29344) 위에 차례로 합쳐, 이 PR 하나로 검사하고 병합한다. 각 PR은 이 브랜치에 merge 커밋 하나씩으로 들어 있다(「merge: PR #N을 합친 검사 브랜치에 넣는다」). 이 PR이 병합되면 각 PR은 「#40으로 병합됨」 댓글을 달고 닫는다. 그 뒤로는 원래대로 PR마다 runner가 돈다.합친 순서와 head: #23
37c6e9bc, #242f0730e7, #258c1bab29, #26ed8c6204, #2770b1be29, #2878938e8f, #2950d623c4, #30fb1ca6af, #31e941c3df, #322a4d46fa, #337fa825e5, #34f1074370, #35d838be54, #369ebd0856, #37088e1282, #3803744e19, #39ceaf316f.충돌은 #39 하나였고 총괄이 풀었다.
tests/unit/manual-code-blocks.test.ts·tests/unit/template-feature-removal-documents.test.ts의 import 줄이 겹쳤다. 앞 PR(#26)은template-probe-features.tsimport를, #39는child-process-timeout.tsimport를 더했다. 두 import를 모두 남겼다(merge 커밋57421222).고른 방법과 버린 대안
위험과 영향
검증
이 PR의 runner merge job 셋이 검증이다. 병합 뒤 main push run이 main 단계(FE-GATE-029·030 포함)를 본다.
pnpm-workspace.yaml의 minimumReleaseAgeExclude 넷(@playwright/test, playwright, playwright-core 1.62.0, eslint 10.8.0)은 2026-07-25에 그 버전이 최소 공개 경과 기간보다 어릴 때 더했다. 주석이 적은 제거 조건("설정한 최소 경과 기간보다 오래되면 지운다")을 몇 달 전에 넘겼다. 남은 예외는 같은 버전의 다른 출처가 생겨도 지연 검사를 건너뛰게 한다. 고른 방법: 넷과 그 주석을 지운다. 버전 고정(package.json exact pin)은 그대로다. 버린 대안: 주석만 고치기(예외가 할 일이 없다). 위험·한계: 이 버전들을 다시 받을 때 pnpm이 지연 검사를 한다. 이미 하루 넘게 지난 버전이라 설치는 바뀌지 않는다. 검증: FE-GATE-001(verify:lockfile)과 tests/unit/pnpm-install-policy.test.ts, desktop의 frozen-lockfile 오프라인 설치(PR 본문). RED 없음 — 설정 정리라 동작이 바뀌지 않는다. Refs: 1112/07-02문제: `check:ci:gating`(FE-GATE-029)은 `*.test.*`와 `*.spec.*`를 모두 모은 뒤 게이트 명령이 닿는 경로 접두어만 본다. 그래서 `tests/unit/x.spec.ts`는 「게이트 안」으로 세지만 vitest.config.ts는 `*.test.{ts,tsx}`만 모아 아무 게이트도 그 파일을 돌리지 않는다. 고른 방법: 경로마다 그 경로를 돌리는 runner를 함께 적는다 (`gatedTestTargets`: Vitest 경로와 Playwright `testDir`). Vitest 경로는 `*.test.*`만, Playwright `testDir`는 기본 testMatch처럼 `*.spec.*`와 `*.test.*`를 게이트 안으로 본다. 판정(`ungatedTestFailures`)은 이 목록을 받고, 문자열만 주면 Vitest 경로로 본다. `gatedTestPaths`(경로만)는 다른 호출자를 위해 그대로 둔다. 위험·한계: Playwright 설정이 testMatch를 좁혀도 그 testDir의 두 꼴을 모두 게이트 안으로 본다(예전과 같다). 검증(desktop): 새 시험이 판정 규칙을 빼는 변이에서 실패(RED), 고친 뒤 ungated-tests·ungated-scripts·test-all-paths·removal-drill-test-paths 29개 통과, 실제 `check:ci:gating` PASS, `tests/unit/probe.spec.ts`를 두면 그 파일 이름으로 rc=1, eslint·check:types rc=0. 로그 /tmp/claude-gates/w2fe2-ung3/. Refs: 0929/12-06문제: 제품 기능 제거 드릴(`test:sample-removal -- --feature=<id>`)은 Playwright spec을 돌리지 않는다. 잔여 검사는 spec 본문에서 하이픈 든 기능 이름만 찾아서, 기능을 URL로만 여는 spec(`page.goto("/invoices")`)은 드릴을 통과하고 그 제품의 FE-GATE-008에서야 깨졌다. 고친 것: 드릴이 지우기 전에 그 기능의 route 경로를 받아 둔다(기능이 넘겨받은 플랫폼 경로는 뺀다). `productFeatureResidue`가 그 경로를 받아, 첫 매개변수 앞까지의 경로로 시작하고 문자열 끝이나 `/`·`?`·`#`가 이어지는 문자열이 있는 spec을 잔여물로 센다. `/`뿐인 경로는 찾지 않는다. 버린 대안: 드릴 안에서 FE-GATE-008을 돌리기. 사본 빌드와 세 엔진 실행이 드릴 시간을 몇 분 늘리고, 지운 기능을 가리키는 spec은 이름·경로로 먼저 찾을 수 있다. 위험·한계: 한 단어 ID만 쓰는 spec, URL을 조각으로 만드는 spec은 여전히 못 찾는다(머리 주석에 적음). vitest 시험 본문은 찾지 않는다(test:all이 돈다). 템플릿 자기 spec은 생성 기능 경로 `/product`로 찾아도 0건이다. 검증(desktop): 새 시험 셋 중 경로 시험이 고치기 전 lib에서 실패(RED 1), 고친 뒤 12개 통과. check:types·eslint rc=0. 로그 /tmp/claude-gates/w2fe2-res907/. Refs: 0925 FOLLOW-UP 09-07문제: 새 눈 리뷰(정적 읽기)가 앞 두 커밋에서 넷을 찾았다. - 같은 context의 첫 기능은 context 경로(`/invoice`)를, 뒤 기능은 그 아래 경로(`/invoice/line`)를 받는다. 첫 기능을 지우면 context가 남는데도 형제 기능 spec의 `"/invoice/line"`이 잔여물로 잡혔다. - 선택 정적 세그먼트(`/invoice/edit?`)는 접두어가 `/invoice/edit?`가 되어 아무 URL도 맞지 않았다. - `` `/invoice${query}` ``와 Playwright `testDir` 안의 page object (`tests/e2e/support/*.ts`)는 찾지 않았다. - `src` 검색이 대소문자를 가리게 되면서, 한 단어 ID(`invoices`)의 옛 부분 문자열 검색이 잡던 route ID 잔여(`route.INVOICES_LIST.title`)를 놓쳤다. 고친 것: 드릴이 지우기 전에 지울 route 경로, 남는 route 경로(플랫폼 포함), 지울 route ID(넘겨받은 플랫폼 ID 제외)를 함께 넘긴다. URL 문자열은 맞는 접두어 중 가장 긴 것이 지운 route일 때만 센다(남는 route와 접두어가 같으면 세지 않는다). 접두어는 선택 세그먼트 앞에서 끊고, `${`도 이어짐으로 본다. `playwright*.config.ts`의 `testDir` 안 파일 중 vitest 시험이 아닌 것도 본다. route ID는 `src` 본문에서 이름 단위로 찾는다. 버린 대안: react-router `matchRoutes`로 모든 문자열을 route 표에 맞추기. 드릴 lib가 앱 라우터에 묶이고, 고정 접두어 비교로 같은 판정을 낸다. 위험·한계: 지운 route와 남는 route의 고정 접두어가 같으면(`/invoice/:id`를 지우고 `/invoice`가 남음) `/invoice/7`을 세지 않는다. 조각으로 만든 URL은 여전히 못 찾는다. 검증(desktop): feature-residue·feature-removal-argument 19개 통과, check:types·eslint rc=0(로그 /tmp/claude-gates/w2fe2-res4/). 변이 다섯 (남는 route 비교, 선택 세그먼트, `${`, testDir 파일, route ID 검색을 하나씩 끔)마다 해당 시험 하나가 실패했다(로그 /tmp/claude-gates/w2fe2-resmut/). Refs: 0925 FOLLOW-UP 09-07, 1105/16-04chore(ci): 프론트 PR #23~#38을 합친 트리를 한 번에 검사한다(병합하지 않음)to chore(ci): 프론트 PR #23~#39를 합친 트리를 한 번에 검사한다(병합하지 않음)chore(ci): 프론트 PR #23~#39를 합친 트리를 한 번에 검사한다(병합하지 않음)to chore(ci): 프론트 PR #23~#38을 합친 트리를 한 번에 검사한다(병합하지 않음)문제: 자식 프로세스 시험의 timeout은 `childProcessTimeout(<잰 ms>)`로 정한다(docs/work/reference/testing.md 2절). 그런데 기본값이 아니라서 `tests/setup.ts` 검사에 걸리지 않는 손 숫자가 남았다. 리뷰가 센 54곳 중 둘(`browser-soak.contract.test.ts`의 `evaluateSoak` 인자)은 timeout이 아니고, AST로 다시 세면 80곳이다: 시험·describe·hook에 쓴 숫자, `VERIFY_TIMEOUT`· `PROCESS_HEAVY_TIMEOUT_MS`(파일 넷에 따로)·`PROVIDER_BASE_FIXTURE_TIMEOUT_MS` 같은 상수, `PROCESS_WATCHDOG_MS * 3` 같은 식. taxonomy는 옛 상수를 예로 들었다. 실측으로 보면 손 숫자 하나가 모자랐다: system 시험의 provider 묶음 30초는 desktop 여섯 번 중 두 번 넘겼다. 고친 것: - 80곳을 desktop에서 잰 가장 긴 실행으로 `childProcessTimeout(<ms>)`에 넘긴다. coverage 묶음(maxWorkers=4)·test:unit 각 9회, integration 3회, scale(traffic·session·composition·global-local) 3회, 시스템 컨테이너의 tests/system 6회, JSON reporter로 받았다. hook은 파일 시간에서 시험 합을 뺀 값이다. 시간 초과로 끝난 실행은 그 시간을 하한으로 넣었다. - 상수 사본은 지운다. 한 파일 안에서 여럿이 쓰는 값만 `const X = childProcessTimeout(...)`로 둔다(`VERIFY_TIMEOUT`). guardian 시험의 lease는 시험 timeout이 아니라 `childProcessTimeout(0)`(helper의 최소 30초)로 둔다. - `tests/unit/test-timeout-declarations.test.ts`가 tests/의 Vitest 파일을 Babel로 읽어 시험·describe·hook의 timeout 인자가 helper 호출(또는 그것을 담은 파일 상수)이 아니면 파일과 줄로 실패한다. 프로세스 안에서 도는 긴 시험(scale tier)도 같은 helper를 쓴다. - taxonomy 예시, testing.md 2절, `.claude/rules/tests.md` 9번, helper 머리 주석을 같은 방법으로 맞춘다. 버린 대안: - `tests/setup.ts` 검사를 「helper가 만든 값이 아닌 timeout」까지 넓히기. helper 값은 30초 단위 숫자라 손으로 쓴 60_000과 가릴 수 없고, hook과 프로세스 안 시험은 보지 못한다. - 프로세스 안 시험은 손 숫자 그대로 두기. 근거 없는 숫자가 남고 검사가 예외를 가져야 한다. 위험·한계: - 값이 커진 곳이 있다(15배 규칙): `manual-code-blocks` 300초 → 900초, provider 묶음 30초 → 480초 등. hang을 늦게 잡는다. 줄어든 곳도 있다 (scale traffic 60초 → 30초 등, 잰 값의 15배 안). - 측정은 desktop 부하 6~35에서 했다. runner가 더 느리면 다시 잰다. - 검사 시험은 Vitest 파일 전부를 파싱해 coverage 묶음에서 최대 13.5초 걸렸고, 그 값으로 자기 timeout을 준다. 이름 있는 함수를 콜백으로 넘긴 시험(`it("x", run, 30_000)`)은 못 찾는다. - 다운스트림: 손 숫자 timeout이 있는 제품 시험은 test:unit에서 이 검사에 걸린다. 메시지가 helper를 알린다. 검증(desktop): - RED: 검사 시험이 고치기 전 80곳을 파일·줄로 내고 실패. GREEN: 검사· child-process-timeout 6개 통과. check:types·eslint(바뀐 34파일) rc=0, verify:documentation PASS_SCOPED, 노트북 `scripts/verify.sh docs` OK. - 측정 원자료: /tmp/claude-gates/w2fe2-t08m, -t08m2, -t08m3. - 게이트 결과는 PR 본문에 적는다. Refs: 1112/03-08chore(ci): 프론트 PR #23~#38을 합친 트리를 한 번에 검사한다(병합하지 않음)to chore(ci): 프론트 PR #23~#39를 합친 트리를 한 번에 검사하고 병합한다