runner(Gitea Actions)에서 프론트 merge 단계가 이 PR 전에는 한 번도 초록이 아니었다. run 56·80·81에서 FE-GATE-005·013·020이 늘 빨갛다.
005·020: tests/unit/fixture-node-modules.test.ts가 runner의 GITEA_ACTIONS·GITHUB_ACTIONS 때문에 실패한다(시험이 바깥 env에 기댐).
013: job 컨테이너에 systemd·bubblewrap이 없어 test:system 사전 점검에서 멈춘다.
시간: 020이 merge의 절반 이상이다. 한 복사본에서 같은 시험 파일을 두 번 돌고, 경계 검사 하나가 fixture마다 eslint를 띄운다. 브라우저 job은 매번 브라우저·OS 의존성 약 900MB를 받는다. e2e fixture build는 브라우저 project마다 다시 돈다.
함께: PR에 push할 때마다 run이 쌓여 runner 1대를 낡은 head가 잡는다. coverage 대상 패턴이 checkout 경로에 따라 루트 파일까지 잡는다. 흔들리던 시험과 느린 시험이 있다.
이 PR은 위 실패를 고치고, worker를 늘리지 않고 중복을 없애 merge 시간을 줄인다.
e2e fixture build를 브라우저 project마다가 아니라 실행 하나에 한 번(global setup 공유 폴더, 처음 닿은 worker만 build)
expect timeout·worker 조정(규칙 밖), fixture spec을 한 브라우저만
뺀 대책: pnpm store 캐시(이득 약 20초, 계약의 job 단계 고정을 바꿔야 함), 009가 e2e의 a11y 결과 재사용(게이트마다 증거를 새로 만드는 계약과 부딪침), 느린 unit 시험 손보기(가장 큰 documentation-readiness 검사기 시간이 한 곳에 몰려 있지 않아 이득이 작음).
위험과 영향
FE-GATE-013은 컨테이너 안에서 root로 돈다. 「비특권 runner에서 bwrap userns」 조건 자체는 증명하지 않는다. runner가 rootless dind로 바뀌면 privileged 컨테이너를 못 띄워 깨진다.
concurrency: main push도 다음 main push가 오면 취소된다. main 단계 결과를 다른 곳에서 읽는 코드는 없다.
공유 fixture build: build를 기다리는 worker는 자기 hook timeout(180~300초) 안에서 기다린다. build한 worker가 죽으면 기다리는 쪽은 그 timeout으로 실패한다. 시험은 build 폴더에 쓰지 않는다(문서 docs/testing/taxonomy.md).
coverage 패턴: Windows 루트 escape는 tinyglobby와 같다고 보았지만 Windows에서 돌리지 않았다.
FE-GATE-008 firefox 흔들림(첫 goto 뒤 5초 안에 요소 없음): desktop에서 재현하지 못했다(firefox만 5회 × 3조건, 전체 e2e 6회 모두 통과). 공유 build가 그 실패와 겹치던 CPU 다툼을 줄이지만 원인으로 확정하지 못했다. runner 결과는 아래.
결정 p(FE-GATE-030): 선택 runtime을 바꾼 PR의 제거 회귀는 병합 뒤 main run에서 본다. main이 빨강이면 다음 PR이 고친다. 그런 PR은 scripts/verify.sh gate FE-GATE-030을 직접 돌린다. main job 이름이 main / self-tests and removal drills로 바뀐다.
25분 목표: 결정 p 뒤 run 169가 25.8분이다(표본 1개, 그날 밤 desktop 부하 20 안팎과 겹침). 미달이고 p50도 정하지 못했다. 남은 몫은 tests job의 005(3:44)·013(2:42)·020 scaffold 드릴(8:46)이다.
PR #24가 tests/e2e/old-tab-chunk-recovery.spec.ts를 고친다. 이 PR도 그 파일을 고쳐 병합 순서에 따라 충돌할 수 있다.
concurrency 실제 동작: 대기 중인 PR run이 새 push로 취소 — 144→145(22:17:43), 145→147(22:26:32), 147→149(22:45:59), 149→151(23:20:02). Chrome에서 다시 실행한 run 151 attempt 2도 대기 중에 다음 push(01:20:48)로 취소됐다. 156→169(02:03:29). 실행 중 취소(cancel-in-progress가 실제로 쓰이는 경우)는 확인하지 못했다: runner 대기열이 길어 이 PR의 run이 도는 동안 올릴 변경이 없었다.
desktop(flock /tmp/claude-gates/heavy.lock, CI env):
merge 단계(트리 871ab57d = 2a70591c, 부하 20.65): 14/14 rc=0, 합 1,275초(005 139, 008 197, 013 179 시스템 컨테이너, 020 630), 실행 뒤 추적 파일 변경 0. 같은 단계 W2-FE 트리(ba72b865, p5) 1,368초·008 실패.
main 단계(트리 176e1578 = e2daf8e0): FE-GATE-029 rc=0 35초, FE-GATE-030 rc=0 341초, 실행 뒤 추적 파일 변경 0. PR run은 main 단계를 돌지 않으므로 FE-GATE-030의 runner 확인은 병합 뒤 main push run이다.
고치기 전·후를 같은 세션에서 번갈아 3회: e2e 전체(taskset -c 0-5, worker 6) 172/150/141 → 123/141/113초, 6회 모두 183개 통과. risk-coverage 「historical」 시험 1,913/1,420/1,938 → 715/642/742ms. json-schema 생성 시험 89/1,075/98 → 36/48/35ms.
변이(RED): coverage 패턴 고정을 빼면 counter-semantics 검사가 additional: outside-src.ts로 실패. 지시문 규칙을 빼면 risk-coverage 시험 실패. 가짜 시계를 빼고 실제 30ms deadline + 40ms 멈춤이면 backoff 시험 둘이 매번 실패.
새 눈 리뷰(fe-testing 렌즈): High·Medium 0, Low 1(지시문, 0c3c9d33로 고침).
기준·목표·도달
항목
기준
목표
도달
runner PR merge job 합(p50, 3회 이상)
31.1·30.0분(run 138·140, 이 PR의 앞 커밋 트리)
25분
28.5분(run 151, 결정 p 전) → 25.8분(run 169, 결정 p 뒤, 표본 1개). 미달·미확정
## 무엇을, 왜
runner(Gitea Actions)에서 프론트 merge 단계가 이 PR 전에는 한 번도 초록이 아니었다. run 56·80·81에서 FE-GATE-005·013·020이 늘 빨갛다.
- 005·020: `tests/unit/fixture-node-modules.test.ts`가 runner의 `GITEA_ACTIONS`·`GITHUB_ACTIONS` 때문에 실패한다(시험이 바깥 env에 기댐).
- 013: job 컨테이너에 systemd·bubblewrap이 없어 `test:system` 사전 점검에서 멈춘다.
- 시간: 020이 merge의 절반 이상이다. 한 복사본에서 같은 시험 파일을 두 번 돌고, 경계 검사 하나가 fixture마다 eslint를 띄운다. 브라우저 job은 매번 브라우저·OS 의존성 약 900MB를 받는다. e2e fixture build는 브라우저 project마다 다시 돈다.
- 함께: PR에 push할 때마다 run이 쌓여 runner 1대를 낡은 head가 잡는다. coverage 대상 패턴이 checkout 경로에 따라 루트 파일까지 잡는다. 흔들리던 시험과 느린 시험이 있다.
이 PR은 위 실패를 고치고, worker를 늘리지 않고 중복을 없애 merge 시간을 줄인다.
## 고른 방법과 버린 대안
| 커밋 | 바꾼 것 | 버린 대안 |
|---|---|---|
| ddfcb6f6 fix(tests) | 「CI 아님」 설치를 `CI=false`로 흉내 낸다 | 벤더 변수 목록 지우기(pnpm 판마다 다름) |
| 79a225b6 fix(scripts) | `verify.sh parts`가 명령의 `args`를 넘긴다 | |
| 0d8e4f5a perf(scripts) | `check:browser-file-storage-boundaries`를 ESLint API 한 번으로(53초 → 3.3초) | |
| b4210753 perf(scripts) | 020 드릴이 한 복사본에서 같은 시험을 두 번 돌지 않는다. 경로 포함 관계를 시험으로 고정 | 005의 plain test:unit 빼기(ungated 목록을 늘려야 함) |
| 66138440 build(deps) | 안 쓰는 `dependency-cruiser` 제거, 의존성 562 → 542 | |
| 1d3eb901 ci(gates) | FE-GATE-013을 일회용 privileged systemd 컨테이너 안에서(`scripts/run-in-system-container.sh`, 계약 `hostEnvironment`) | 전용 VM runner, 호스트 AppArmor profile |
| 92abfd20 ci(gates) | browser job을 Playwright 1.62 공식 이미지(digest 고정)에서, 글꼴만 설치 | 자체 이미지(레지스트리 쓰기 토큰 필요) |
| 1f09c1cc perf(tests) | vitest setup이 DOM이 있는 파일에만 Testing Library를 불러온다 | vitest projects 분리 |
| 35b60a04 fix(tests) | 드릴 경로 시험이 recipe를 지운 사본에서도 통과 | |
| 2f5eb2b4 ci(workflow) | workflow `concurrency`: 같은 PR·브랜치의 새 push가 앞 run을 취소한다. 수동 실행은 ref·stage마다 group이 따로이고 돌고 있는 run을 취소하지 않는다 | 백엔드처럼 event·ref만으로 group(다른 stage 수동 실행끼리 취소됨) |
| 543518ad fix(coverage) | coverage include·exclude를 저장소 루트로 시작하는 패턴으로(vitest는 절대 경로 어디에서나 맞춘다). counter-semantics 검사가 `checkout (copy)-src/` 아래에서 돌아 막는다 | picomatch로 vitest 판정을 흉내 내는 시험(직접 의존성 아님) |
| 0bb1f0af perf(coverage) | 위험 커버리지 모듈 목록: `@babel/core` 파싱(2.8배), 기본 fs를 동기로(부하 아래 event loop 대기 제거) | 파일 병렬 처리(여러 파일이 잘못됐을 때 오류 순서가 바뀜) |
| 0c3c9d33 fix(coverage) | `"use strict"` 밖의 지시문을 문장으로 센다(V8과 같게, fixture로 고정) | |
| 198e9856 test(schemas) | 스키마 생성 시험이 fsync 없는 writer로 임시 폴더에 쓴다 | 시험 timeout 선언 |
| 37a85004 test(http) | deadline 분류 시험이 가짜 시계로 그 대기 지점에서 deadline을 낸다 | deadline 늘리기 |
| 8de1403b ci(gates) | 선택 runtime 제거 드릴 셋을 새 게이트 FE-GATE-030(main 단계)으로. FE-GATE-020은 샘플·scaffold 드릴만(소유자 결정 p, 2026-11-12) | 그대로 두고 25분 목표를 runner 실측으로 다시 정하기 |
| c6d7f43a perf(e2e) | e2e fixture build를 브라우저 project마다가 아니라 실행 하나에 한 번(global setup 공유 폴더, 처음 닿은 worker만 build) | expect timeout·worker 조정(규칙 밖), fixture spec을 한 브라우저만 |
뺀 대책: pnpm store 캐시(이득 약 20초, 계약의 job 단계 고정을 바꿔야 함), 009가 e2e의 a11y 결과 재사용(게이트마다 증거를 새로 만드는 계약과 부딪침), 느린 unit 시험 손보기(가장 큰 `documentation-readiness` 검사기 시간이 한 곳에 몰려 있지 않아 이득이 작음).
## 위험과 영향
- FE-GATE-013은 컨테이너 안에서 root로 돈다. 「비특권 runner에서 bwrap userns」 조건 자체는 증명하지 않는다. runner가 rootless dind로 바뀌면 privileged 컨테이너를 못 띄워 깨진다.
- concurrency: main push도 다음 main push가 오면 취소된다. main 단계 결과를 다른 곳에서 읽는 코드는 없다.
- 공유 fixture build: build를 기다리는 worker는 자기 hook timeout(180~300초) 안에서 기다린다. build한 worker가 죽으면 기다리는 쪽은 그 timeout으로 실패한다. 시험은 build 폴더에 쓰지 않는다(문서 `docs/testing/taxonomy.md`).
- coverage 패턴: Windows 루트 escape는 tinyglobby와 같다고 보았지만 Windows에서 돌리지 않았다.
- FE-GATE-008 firefox 흔들림(첫 goto 뒤 5초 안에 요소 없음): desktop에서 재현하지 못했다(firefox만 5회 × 3조건, 전체 e2e 6회 모두 통과). 공유 build가 그 실패와 겹치던 CPU 다툼을 줄이지만 원인으로 확정하지 못했다. runner 결과는 아래.
- 결정 p(FE-GATE-030): 선택 runtime을 바꾼 PR의 제거 회귀는 병합 뒤 main run에서 본다. main이 빨강이면 다음 PR이 고친다. 그런 PR은 `scripts/verify.sh gate FE-GATE-030`을 직접 돌린다. main job 이름이 `main / self-tests and removal drills`로 바뀐다.
- 25분 목표: 결정 p 뒤 run 169가 25.8분이다(표본 1개, 그날 밤 desktop 부하 20 안팎과 겹침). 미달이고 p50도 정하지 못했다. 남은 몫은 tests job의 005(3:44)·013(2:42)·020 scaffold 드릴(8:46)이다.
- PR #24가 `tests/e2e/old-tab-chunk-recovery.spec.ts`를 고친다. 이 PR도 그 파일을 고쳐 병합 순서에 따라 충돌할 수 있다.
## 검증
runner(Gitea Actions, merge job 셋은 capacity 1이라 차례로):
| run | head | static | tests | browser | 합 | 결과 |
|---|---|---|---|---|---|---|
| 113 | 27876ffc | 2:17 | 16:50 | 8:44 | — | 013·020 실패(뒤 커밋으로 고침) |
| 138 | f6e2560e | 1:49 | 22:18 | 6:54 | 31.1분 | 초록(처음) |
| 140 | ba72b865 | 2:07 | 20:56 | 6:56 | 30.0분 | 초록 |
| 151 | 2a70591c | 1:49 | 20:49 | 5:47 | 28.5분 | 초록 |
| 169 | e2daf8e0(결정 p 반영) | 1:58 | 17:06 | 6:38 | 25.8분 | 초록 |
concurrency 실제 동작: 대기 중인 PR run이 새 push로 취소 — 144→145(22:17:43), 145→147(22:26:32), 147→149(22:45:59), 149→151(23:20:02). Chrome에서 다시 실행한 run 151 attempt 2도 대기 중에 다음 push(01:20:48)로 취소됐다. 156→169(02:03:29). 실행 중 취소(`cancel-in-progress`가 실제로 쓰이는 경우)는 확인하지 못했다: runner 대기열이 길어 이 PR의 run이 도는 동안 올릴 변경이 없었다.
desktop(`flock /tmp/claude-gates/heavy.lock`, CI env):
- merge 단계(트리 871ab57d = 2a70591c, 부하 20.65): 14/14 rc=0, 합 1,275초(005 139, 008 197, 013 179 시스템 컨테이너, 020 630), 실행 뒤 추적 파일 변경 0. 같은 단계 W2-FE 트리(ba72b865, p5) 1,368초·008 실패.
- main 단계(트리 176e1578 = e2daf8e0): FE-GATE-029 rc=0 35초, FE-GATE-030 rc=0 341초, 실행 뒤 추적 파일 변경 0. PR run은 main 단계를 돌지 않으므로 FE-GATE-030의 runner 확인은 병합 뒤 main push run이다.
- 공유 fixture build 탐침(fixture spec 여섯 × 브라우저 셋, worker 6): key마다 build 1번·재사용 2번(vite build 27 → 9번), 92개 통과.
- 고치기 전·후를 같은 세션에서 번갈아 3회: e2e 전체(`taskset -c 0-5`, worker 6) 172/150/141 → 123/141/113초, 6회 모두 183개 통과. risk-coverage 「historical」 시험 1,913/1,420/1,938 → 715/642/742ms. json-schema 생성 시험 89/1,075/98 → 36/48/35ms.
- 변이(RED): coverage 패턴 고정을 빼면 counter-semantics 검사가 `additional: outside-src.ts`로 실패. 지시문 규칙을 빼면 risk-coverage 시험 실패. 가짜 시계를 빼고 실제 30ms deadline + 40ms 멈춤이면 backoff 시험 둘이 매번 실패.
- 새 눈 리뷰(fe-testing 렌즈): High·Medium 0, Low 1(지시문, 0c3c9d33로 고침).
## 기준·목표·도달
| 항목 | 기준 | 목표 | 도달 |
|---|---|---|---|
| runner PR merge job 합(p50, 3회 이상) | 31.1·30.0분(run 138·140, 이 PR의 앞 커밋 트리) | 25분 | 28.5분(run 151, 결정 p 전) → 25.8분(run 169, 결정 p 뒤, 표본 1개). 미달·미확정 |
| runner merge job 전부 초록 | 0회(run 56·80·81·113 실패) | 연속 3회 | 138·140·151·169 연속 4회 초록(FE-GATE-008 firefox 포함) |
| e2e 전체 벽시계(desktop runner 모양) | 150초(중앙값) | 줄이기 | 123초 |
| risk-coverage 「historical」 시험(runner unit/coverage) | 8.20/9.81초(run 113), 5.62/5.30초(run 138) | 4초 이하 | 1.69/3.62초(run 151) |
| json-schema 생성 시험(runner unit/coverage) | 0.86/0.09초(run 138) | 줄이기 | 0.47/0.03초(run 151) |
## 리뷰어가 볼 곳
- `scripts/run-in-system-container.sh`, `config/ci/system-container.Dockerfile`
- `tests/e2e/support/shared-fixture-builds.ts`(잠금·대기·실패 전달), `tests/e2e/support/fixture-builds.ts`, `tests/e2e/support/service-worker-builds.ts`
- `scripts/lib/coverage-scope.ts`, `scripts/lib/risk-coverage.ts`(파서·fs·지시문)
- `scripts/lib/feature-scaffold-drill.ts`, `scripts/test-sample-removal.ts`
- `.gitea/workflows/quality-gates.yml`은 생성 파일이다(`corepack pnpm generate:ci-workflow`).
## 관련
- design-docs `template-program/README.md` 1절(끝 상태), 5절 e·o(FE-GATE-013)·p(FE-GATE-030)
- 측정·계획: 공유 노트 `w2-fe-ci-perf.md`, `w2-fe2-takeover.md`
문제: fixture-node-modules 시험의 F-4는 「개발자 PC에서 설치한
node_modules를 CI=true인 fixture가 다시 설치한다」는 위험을 재현하려고
설치 env에서 CI만 지운다. pnpm은 CI 말고도 GITEA_ACTIONS·
GITHUB_ACTIONS 같은 벤더 변수로 CI를 알아챈다. 그래서 Gitea runner
job에서는 두 설치가 같은 설정이 되어 재설치가 일어나지 않고, 시험이
changed=false로 실패한다. FE-GATE-005와 복사본 안에서 같은 시험을 도는
FE-GATE-020이 runner에서만 빨갛다(run 56·80·81).
고른 방법: 설치 env에 CI=false를 준다. pnpm(ci-info)은 CI가
"false"이면 다른 변수를 보지 않는다. 벤더 변수 목록을 지우는 방법은
버렸다. 목록이 pnpm 버전마다 다르고 새 runner가 나오면 다시 깨진다.
위험·한계: pnpm이 CI=false를 무시하게 바뀌면 다시 실패한다. 그때는
runner에서 같은 모양으로 드러난다.
검증(desktop, 38c0dc7d):
- 수정 전, GITEA_ACTIONS=true GITHUB_ACTIONS=true CI=true: rc=1
- 수정 뒤, 같은 env: rc=0 / CI=true만: rc=0 / CI 없음: rc=0
문제: `scripts/verify.sh parts <ID>`는 게이트의 명령을 하나씩 돌리면서
config/ci/gates.json 명령의 `script`만 읽고 `args`를 버린다. 그래서
FE-GATE-009의 `review:a11y-manual -- --format-only`가 인자 없이 돌아
release 증거를 찾다가 rc=1이 되고, production 게이트의
`drill:runbook -- FE-RB-00N --release-root …` 여섯 개도 다른 명령이 된다.
ci:gate(run-ci-gate.ts)는 `pnpm <script> ...args`로 돌려 영향이 없다.
desktop 측정에서 parts만 009를 실패로 냈다.
고른 방법: 계약을 읽는 python이 필드를 \x1f로, args를 \x1e로 나눠
내보내고 bash가 배열로 받아 `corepack pnpm -s <script> ...args`로
돌린다. 탭 구분은 빈 expectedExitCode 칸이 이어지는 탭과 합쳐져
다음 칸이 밀리므로 쓰지 않았다.
위험·한계: args 안에 \x1e·\x1f가 들어가면 잘못 나뉜다. 지금 계약에는
없다.
검증(노트북): python3 -m unittest discover -s scripts/tests 통과.
새 시험은 args가 있는 게이트 7개 모두에서 수정 전 실패, 수정 뒤 통과.
문제: check:browser-file-storage-boundaries는 fixture마다
`pnpm exec eslint`를 새로 띄운다(파일 21개 + stdin 13번). 프로세스마다
flat config를 다시 읽어 desktop에서 53초가 걸리고, FE-GATE-010(66초)의
대부분이다. 같은 검사를 FE-GATE-020의 feature-scaffold 드릴이 복사본에서
한 번 더 돌아(62초) merge 1회에 약 2분을 쓴다.
고른 방법: ESLint Node API 인스턴스 하나로 같은 fixture를 같은 옵션으로
돈다. --no-ignore는 `ignore: false`, --max-warnings=0은 경고가 하나라도
있으면 실패, 파일이 없거나 설정을 못 읽으면 CLI처럼 2로 둔다. 실패
보고는 CLI 기본과 같은 stylish 형식이다. 같은 repo의 check-architecture.ts
·check-i18n.ts가 이미 API를 쓴다. 검사 대상·판정·통과 문구는 그대로다.
위험·한계: CLI가 아닌 API로 돌아 eslint CLI만의 동작(캐시, 색) 차이는
있다. 판정에는 쓰지 않는다.
검증(desktop, 38c0dc7d 위):
- 같은 트리: 전·후 모두 PASS, "34 direct or misplaced native access
cases rejected". 53초 → 3.3초.
- 변이(forbidden/direct-indexeddb.ts를 무해한 코드로): 전·후 모두 rc=1,
실패 목록 같음(2건). 변이(allowed fixture에 코드 추가) 두 개: 전·후
모두 rc=0.
- tsc -p tsconfig.node.json, eslint 이 파일: rc=0
문제: FE-GATE-020이 desktop merge 단계 27.4분 중 17.2분이다. 그 안에서
같은 시험 파일이 한 복사본에서 두 번 돈다.
- feature-scaffold 드릴은 merge 단계 명령을 차례로 돌며 test:runtime-schema
·test:unit·test:contract·test:component·test:integration을 돌고, 바로
FE-GATE-005의 test:coverage가 같은 경로를 다시 돈다(약 80초).
- feature-removal 확인은 test:all을 돈 뒤 test:coverage를 돈다. test:all의
경로는 tests/recipes 말고 모두 coverage 안에 있다(약 110초).
고른 방법:
- scaffold 드릴 제외 목록에 다섯 suite를 넣는다. 그 복사본의 merge 단계에
test:coverage가 있을 때만 뺀다. 없으면 plain으로 다시 돈다.
- feature-removal은 test:coverage 다음에 coverage 밖에 남는 suite
(REMOVAL_DRILL_SUITES_OUTSIDE_COVERAGE = test:recipes)만 돈다.
- tests/unit/removal-drill-test-paths.test.ts가 경로를 package.json에서
읽어 「뺀 suite의 경로 ⊆ coverage 경로」, 「test:all 경로 ⊆ coverage +
남긴 suite」, coverage가 없으면 다시 도는 것을 지킨다.
- 버린 대안: FE-GATE-005 자체의 plain test:unit·test:contract를 빼고
coverage 실행에서 junit을 나누기. 그 script가 어느 게이트에서도 안 돌게
되어 ungated 목록을 늘려야 한다(게이트 기준을 낮추는 일).
위험·한계: plain 실행만의 차이(coverage 계측 없음, worker 수 기본값,
tests/platform을 test:platform처럼 파일 차례로 도는 것)는 드릴에서 더
보지 않는다. merge 단계의 FE-GATE-005가 coverage로 같은 파일을 병렬로
돌고 있어 그 모양이 이미 게이트다. 선택 기능 제거 드릴 셋의 test:all은
그대로다(그 드릴은 coverage를 돌지 않는다).
검증(desktop, 38c0dc7d 위): removal-drill-test-paths·feature-scaffold-drill
·example-feature-rules·test-all-paths·fixture-node-modules 20개 통과,
check:types·eslint rc=0. 변이 두 개(남긴 suite 목록 비우기, test:unit에
tests/recipes 더하기)에서 각각 해당 시험이 실패.
문제: D-11(2026-11-05)로 dependency-cruiser 실행을 뺐다. CLI가
TypeScript 7을 못 읽어 check:architecture가 `.dependency-cruiser.json`을
규칙 파일로 직접 읽는다. 그런데 패키지는 devDependencies에 남아 job마다
설치된다. 코드·script·시험 어디서도 import하거나 실행하지 않는다
(`git grep dependency-cruiser`는 규칙 파일 이름과 기준선만 나온다).
잠금 파일 564개 snapshot 중 20개가 이 패키지 때문에만 들어온다.
고른 방법: `pnpm remove dependency-cruiser`로 package.json과 잠금 파일을
고치고, update:dependency-baseline으로 의존성 기준선을 다시 승인한다
(562 → 542개). 규칙 파일 `.dependency-cruiser.json`은 이름 그대로 둔다
(D-11).
위험·한계: 파생 프로젝트가 이 CLI를 따로 돌리고 있었다면 직접 다시
더해야 한다. 템플릿 문서는 이미 「CLI를 쓰지 않는다」고 적고 있다.
기준선 승인 기록의 owner는 이전 기록과 같은 이름으로 두었다. 리뷰에서
확인이 필요하다.
검증(desktop): pnpm remove rc=0, update:dependency-baseline
"Supply chain: LOCAL PASS (542 dependencies)". merge 단계 게이트는 이
브랜치 끝에서 돈다.
문제: FE-GATE-013의 test:system은 provider sandbox를 실제로 띄운다.
systemd user manager(systemd-run --user --scope)와 cgroup v2 위임,
bubblewrap(--unshare-net 등)이 필요하다. runner의 job 컨테이너는
entrypoint가 sleep이라 systemd가 없고 bwrap도 없어 사전 점검에서 실패한다
(run 56·80·81). desktop 호스트는 다 있지만 Ubuntu 24.04의
apparmor_restrict_unprivileged_userns=1이 비특권 bwrap을 막는다.
그래서 이 게이트는 runner와 desktop 어디서도 초록인 적이 없다.
고른 방법(소유자 결정 2026-11-11 5절 e: 조건이 되는 실행 환경을 찾는다):
- config/ci/system-container.Dockerfile: Ubuntu 24.04(digest 고정) +
systemd PID 1 + root linger + bubblewrap 등 hostRequirements의 도구.
- scripts/run-in-system-container.sh: 이미지(Dockerfile 해시 태그)가 없으면
만들고, privileged·자체 cgroup namespace로 띄워 systemd와 root user
manager를 기다린 뒤, 작업 트리·git 이력·호출한 쪽의 node와 corepack을
복사해 명령을 root로 돌리고 artifacts/를 되가져온 다음 지운다. root는
호스트의 userns 제한을 받지 않는다.
- gates.json 게이트 필드 hostEnvironment: "system-container"(FE-GATE-013).
생성기는 그 게이트의 run 줄에 래퍼를 붙이고, 실행 검사
(workflowGateExecutionFailures)는 계약이 정한 접두어로 돈 줄만 센다.
scripts/verify.sh gate·parts·stage도 같은 래퍼로 돌린다.
- CI에서는 runner의 Docker proxy로 안쪽 dind daemon을 쓴다(platform-core
gitea-runner README가 「남은 위험」으로 적은 길: proxy가 privileged
컨테이너를 막지 않는다).
- 버린 대안: 전용 VM runner(문서 조건을 그대로 만족하지만 platform-core
변경과 VM 자원·runner 등록이 필요), 호스트 AppArmor profile(호스트
userns 제한을 푸는 보안 설정 변경, 소유자 sudo).
위험·한계:
- root로 돌아 「비특권 runner에서 bwrap userns」 조건 자체는 증명하지
않는다. release 단계 provider job 둘은 아직 job 컨테이너에서 돈다(범위
밖, 같은 래퍼나 VM runner가 필요).
- runner가 rootless dind로 바뀌면 privileged 컨테이너를 못 띄워 깨진다.
- 래퍼 준비(이미지 확인·기동·복사)에 desktop에서 50~60초가 든다.
검증(desktop): 래퍼로 check-system-test-prerequisites → PASS(root),
tests/system/ci-runner/provider-process-group.test.ts 1개 통과.
python3 -m unittest scripts.tests.test_verify 통과, check:ci PASS(게이트 28),
ci-workflow-generation 시험 통과. 게이트 전체(test:system 116개 포함)는 이
브랜치 끝의 merge 단계에서 돈다.
문제: merge / browser tests job은 `playwright install --with-deps`로
매번 apt 276개(180MB)와 브라우저 넷(전체 Chrome 포함), 글꼴 220MB를
받는다. runner에서 job마다 198~242초, 약 900MB다(run 56·80·81).
run 54에서는 이 단계 중 desktop 루트가 90%까지 차 Gitea가 내려갔다.
고른 방법: browser-install 단계에 `image`를 두고, 생성기가 그 job의
container로 그린다. 값은 @playwright/test와 같은 버전의 Playwright 공식
이미지 digest(mcr.microsoft.com/playwright:v1.62.0-noble@sha256:baed…)다.
그 이미지에는 1.62의 브라우저와 OS 라이브러리가 들어 있다. 단계는 visual
골든의 글꼴만 apt로 설치한다(이미지에 패키지 목록이 없어 apt-get update
먼저). job env의 CI_RUNNER_IMAGE를 그 이미지로 적어, 빌드가 기록하는
runner 이미지가 실제와 맞는다.
- 계약: image는 Playwright 레지스트리의 noble 태그 + digest만 받고,
gate-sequence job에만 둔다(matrix의 비브라우저 lane까지 그 이미지로
돌지 않게). tests/unit/ci-browser-image.test.ts가 태그 버전 =
package.json @playwright/test 버전을 지킨다.
- release_gate(lab-performance)는 그대로 둔다(release 단계, 범위 밖).
- 버린 대안: runner 이미지 위에 브라우저를 구운 자체 이미지(레지스트리
쓰기 토큰과 빌드 경로가 필요), 브라우저 폴더 캐시(apt 의존성 100초가
남는다).
위험·한계: 이미지의 OS 라이브러리 판이 runner 이미지와 조금 다를 수
있어 visual 골든(maxDiffPixels 50)이 바뀔 수 있다. runner 실행으로 확인한다.
이미지(압축 947MB)를 runner의 dind가 한 번 받는다. Playwright를 올릴 때
이미지 digest도 같이 바꿔야 한다(위 시험이 막는다).
검증(desktop): generate:ci-workflow 뒤 check:ci PASS, ci-workflow-generation
·ci-browser-image 시험 통과(스냅샷 1개 갱신), check:types·eslint rc=0.
runner 실행은 PR에서.
문제: tests/setup.ts는 모든 시험 파일에 @testing-library/jest-dom과
@testing-library/react(그리고 react-dom)를 불러온다. tests/unit 215개
파일 중 DOM(jsdom)을 쓰는 것은 3개뿐인데, Node 환경 파일마다 이 import가
돈다. runner의 test:unit에서 setup이 누적 124~165초로, 시험 본문 다음으로
크다(run 80·81).
고른 방법: setup 파일이 `document`가 있을 때만 두 모듈을 불러오고
configure를 건다. afterEach 하나에서 cleanup → 실제 timer 복원 순서를
그대로 지킨다. 버린 대안: vitest projects로 node·jsdom 설정을 나누기.
같은 효과에 설정·명령 변경이 커서 뒤로 미뤘다.
위험·한계: Node 환경 파일에서 jest-dom matcher를 쓰면 이제 실패한다. 그런
파일은 없다(아래 검증의 unit·component 전부 통과로 확인).
검증: desktop 묶음(w2fe-p2) A·B 단계 — unit·component 전·후 각 2회.
문제: b4210753이 더한 removal-drill-test-paths 시험과 고친
feature-scaffold-drill 시험이 test:recipes가 있다고 가정한다. FE-GATE-020의
optional-recipe-removal 드릴은 recipe를 지운 사본에서 test:all을 돌고,
그 사본의 package.json에는 test:recipes가 없어 두 시험이 실패한다
(desktop merge 단계, 2d3e5889).
고른 방법: 드릴 코드(scripts/test-sample-removal.ts)처럼 사본의
package.json에 남은 suite만 「coverage 밖」으로 본다. scaffold 드릴 시험의
기대 목록에서는 test:recipes를 뺀다(그 드릴의 다른 기대처럼 사본에 늘
있는 명령만 둔다).
위험·한계: test:recipes가 없는 사본에서는 「coverage 밖 suite」 시험이
아무것도 보지 않는다. 그 사본은 그 경로 자체가 없다.
검증: desktop 묶음(w2fe-p4)의 test:optional-recipe-removal과 merge 단계.
문제: tests/system의 provider 기준 사본은 `.git`을 함께 복사하면서
`.claude` 폴더를 통째로 뺀다(노트북 checkout의 `.claude/worktrees/`를
피하려고). 2026-11-08 하네스가 `.claude/` 아래에 agents·rules·skills를
추적 파일로 더한 뒤로, 사본의 `git ls-files`가 그 파일을 말하는데 디스크에
없어 공급망 생성이 `ENOENT ... .claude/agents/arch-reviewer.md`로 멈춘다.
FE-GATE-013이 어디서도 끝까지 돈 적이 없어(runner는 사전 점검, desktop은
userns에서 멈춤) 드러나지 않았다. 시스템 컨테이너에서 처음 끝까지 돌자
provider 시험 18개가 이것으로 실패했다.
고른 방법: 빼는 것을 저장소 루트 기준 경로로 바꾸고 `.claude` 대신
`.claude/worktrees`만 뺀다. `.git`을 복사하지 않는 다른 빌드 사본
(e2e fixture-builds·service-worker-builds, run-output-root-build)은
그대로 둔다.
위험·한계: 다른 checkout을 품는 새 폴더가 생기면 이 목록에 더해야 한다.
검증: desktop 묶음(w2fe-p4)에서 scripts/verify.sh gate FE-GATE-013.
문제: 작업 매뉴얼·루트 지침·스킬이 「desktop의 FE-GATE-013은 호스트 제약
실패로 적고 merge 가능 여부는 소유자가 정한다(결정 대기 D8)」라고 적고
있다. 1d3eb901 뒤로 workflow와 scripts/verify.sh는 이 게이트를
scripts/run-in-system-container.sh 안에서 돌리고, 다른 게이트처럼 rc로
센다. CHANGELOG에는 이 브랜치의 변경이 없다.
고른 방법:
- gates.md 3절 문단을 「시스템 컨테이너 안에서 돈다」로 바꾸고, AGENTS.md
·improve.md·new-feature.md·operate.md·desktop-gates 스킬의 기록법
문구를 그 절을 가리키게 고친다.
- decisions.md: 소유자 결정(2026-11-11, design-docs template-program
README 5절 e)을 2.1절 행으로 더하고 열린 결정 대기 D8을 닫는다.
evidence.md의 근거 행을 새 규칙 이름과 runner 사건으로 고친다.
- docs/operations/ci-quality-gates.md, docs/testing/taxonomy.md,
README.md에 컨테이너 경로와 그 한계(root라 비특권 userns 조건은 증명하지
않음, privileged를 막는 runner에서는 깨짐)를 적는다.
- CHANGELOG 미출시 절에 이 브랜치의 변경을 적는다.
위험·한계: desktop·runner에서 FE-GATE-013이 실제로 초록인지는 이 브랜치
끝의 merge 단계 실행으로 확인한다.
검증: 노트북 scripts/verify.sh docs rc=0. desktop verify:documentation
PASS_SCOPED, 문서를 읽는 시험 넷(changelog-review-ids,
documentation-readiness, template-contract-documents,
deletable-history-documents) 29개 통과.
main(5250ff95)의 PR #17·#18·#20·#21·#22를 받는다. 충돌 정리:
- tests/setup.ts: main의 자식 프로세스 timeout 감시를 그대로 두고, Testing
Library는 DOM이 있는 파일에만 불러오는 이 브랜치의 방식을 남긴다.
- tests/system/ci-runner/ci-artifact-contract.test.ts: main이 같은 결함
(.claude 추적 파일 ENOENT)을 저장소 배치 등록부의 provider-fixture-skip
집합으로 이미 고쳤다. main 쪽을 받고 이 브랜치의 f90ffb6c 고침은 버린다.
CHANGELOG의 그 행도 지운다.
- 작업 매뉴얼·스킬(gates.md 3절, operate·improve·new-feature, evidence,
desktop-gates·fe-testing 스킬): 기본은 시스템 컨테이너 경로, main의 D8
판정(사전 점검의 userns 제한 하나뿐이고 뒤 명령 모두 rc=0이면 merge
판정에서 뺀다)은 컨테이너를 띄울 수 없는 호스트에 쓴다.
- 그 호스트에서 D8 절차를 그대로 돌릴 수 있게 scripts/verify.sh에
VERIFY_HOST_ENVIRONMENT=off(hostEnvironment 게이트를 이 호스트에서 바로
돈다)를 더하고 원격 실행에도 넘긴다. 시험 하나를 더한다.
- decisions.md는 main 그대로(D8이 2.2절에 있어 이 브랜치의 O-21 행은 겹친다).
검증(노트북): python3 -m unittest discover -s scripts/tests 73개 통과,
scripts/verify.sh docs rc=0. desktop merge 단계는 이 커밋에서 다시 돈다.
문제: runner가 하나(capacity 1)인데 PR에 push할 때마다 run이 하나씩
쌓인다. 낡은 head의 run이 runner를 25분씩 잡아 새 head와 백엔드 run이
뒤로 밀린다.
고른 방법: workflow에 concurrency를 둔다. group은
`frontend-quality-gates-<event>-<ref>-<stage>`다. PR run의 ref는
`refs/pull/<번호>/head`라 PR마다 group 하나, branch push는 branch마다
하나, release tag는 tag마다 하나다. cancel-in-progress는 수동 실행만
거짓이다. Gitea 1.27.0은 group과 cancel-in-progress를 서버에서 식으로
계산하고(`services/actions/concurrency.go`, `inputs` 포함), 같은 group의
앞 run을 대기 중이면 언제나, 실행 중이면 cancel-in-progress가 참일 때
취소한다.
- 수동 실행에 stage를 group에 넣고 취소를 끈 이유: 다음 수동 실행이
검증과 승격 사이의 release run을 끊지 않게 한다.
- 버린 대안: 백엔드처럼 event·ref만으로 group을 짓기. 프론트는 수동
실행 하나가 stage 여섯을 받아, 다른 stage의 수동 실행끼리 취소된다.
위험·한계: 실제 취소는 runner에서 push 두 번으로 확인해야 한다(다음
커밋들의 PR run으로 남긴다). 이 커밋 전에 만들어진 대기 run은 group이
없어 취소되지 않는다.
검증(desktop): generate:ci-workflow, ci-workflow-generation 시험 파일
전부 통과(스냅샷 갱신 포함), check:ci-workflow rc=0, check:types rc=0,
eslint rc=0. 로그 /tmp/claude-gates/w2fe2-gen1/, w2fe2-cov1/.
문제: vitest는 coverage include·exclude를 모듈의 절대 경로에 picomatch
`contains: true`로 맞춘다. 그래서 `src/**/*.{ts,tsx}`가 경로 어디에서나
맞는다. checkout이 이름이 `src`로 끝나는 폴더(`~/work/app-src/`)에
있으면 `vite.config.ts`·`scripts/**` 같은 루트 파일이 coverage에 들어가
risk-coverage가 저장소 목록 밖의 행으로 실패한다(tech-log 동기화 때
desktop에서 본 일). CI 경로에는 `src`가 없어 runner에서는 안 보였다.
고른 방법: `scripts/lib/coverage-scope.ts`의 `rootAnchoredGlobs`가
패턴 앞에 루트를 붙인다. 루트는 vitest의 glob 라이브러리(tinyglobby
0.2)가 cwd를 escape하는 식 그대로 escape해, 괄호 같은 glob 문자가 든
루트도 자기 자신에만 맞고 안 불린 파일 glob도 `src/...`로 풀린다.
`vitest.config.ts`와 `check:v8-coverage-counter-semantics`의 자식
설정이 이 함수를 쓴다.
- 막는 시험: counter-semantics 검사가 fixture를
`checkout (copy)-src/` 아래로 복사하고, fixture 시험이 `src/` 밖
모듈(`outside-src.ts`)도 불러온다. 고정이 빠지면 그 모듈이 행으로
들어와 행 집합 검사가 실패한다. 이 검사는 test:coverage 첫 단계에서
이미 자식 vitest를 띄우므로 프로세스가 늘지 않는다. 단위 시험은
repo 설정의 모든 패턴이 루트로 시작하는지와 escape를 본다.
- 버린 대안: picomatch로 vitest의 판정을 흉내 내는 단위 시험. 직접
의존성이 아니고, vitest가 옵션을 바꾸면 거짓 통과한다.
위험·한계: Windows 루트는 `/`로 바꾼 뒤 같은 식으로 escape한다.
올바른 Windows 경로에서는 tinyglobby의 Windows escape와 결과가 같다고
보았지만 Windows에서 돌려 보지는 않았다.
검증(desktop): coverage-scope·v8-coverage-counter-semantics 시험 통과,
check:v8-coverage-counter-semantics rc=0. 변이: 자식 설정을 예전
`["src/**/*.ts"]`로 되돌리면 같은 검사가 `additional: outside-src.ts`로
rc=1. check:types·eslint rc=0. 로그 /tmp/claude-gates/w2fe2-cov1/.
문제: `buildProductionModuleInventory`가 `src/` 모듈 375개를 하나씩
`@babel/eslint-parser`로 읽고, 파일마다 lstat→realpath→open→stat→
read→close 여섯 비동기 호출을 차례로 기다린다. runner에서 이 목록을
만드는 시험(「historical 14-file summary」)이 unit 8.2초·coverage
9.8초였다(run 113). check:risk-coverage도 같은 목록을 만든다.
고른 방법:
- 파서: @babel/core `parseSync`(babelrc·configFile 끔)로 Babel AST를
읽는다. eslint-parser는 같은 파서를 돈 뒤 트리와 토큰 전체를 ESTree로
바꾼다. 여기서 보는 최상위 문장의 type·declare·const·importKind·
declaration·body는 두 트리에서 같다. repo 모듈 375개 전부에서 두
파서의 문장 모양을 대조해 차이 0을 확인했다. 시간 845 → 305ms.
`scripts/check-architecture.ts`가 같은 방식을 이미 쓴다.
- fs: 기본 구현이 같은 호출을 같은 순서로 동기로 한다. 부하가 큰
기계에서는 호출마다 thread pool을 거쳐 event loop 차례를 기다리는
시간이 일보다 컸다. 주입하는 fs(경쟁 시험용)는 그대로 async다.
symlink·파일 바꿔치기 검사와 오류 순서는 바뀌지 않는다.
- 버린 대안: 파일을 병렬로 처리하기. 대기는 줄지만 여러 파일이
잘못됐을 때 어느 오류를 내는지가 달라진다. 시험 timeout 늘리기는
규칙 밖이다.
위험·한계: 목록을 만드는 동안 event loop를 잡는다(desktop 약 0.7초).
gate CLI와 시험만 부른다.
검증(desktop, 같은 세션에서 고치기 전·후를 번갈아 3회):
- 부하 11~12: 그 시험 1,913/1,420/1,938 → 715/642/742ms.
- coverage + CPU 소모 프로세스 12개(부하 6~16): 8,033/8,493/10,347 →
4,703/5,039/6,121ms.
- risk-coverage·risk-coverage-files 시험 47개 통과,
check:coverage:fixture는 전처럼 기준 미달로 rc=1, check:types·eslint
rc=0. 로그 /tmp/claude-gates/w2fe2-slow3·5·6/, w2fe2-parse1/.
문제: json-schema 시험 「generates deterministic … detects drift」가
임시 폴더에 스키마 넷을 쓸 때 파일과 폴더를 fsync한다. 이 시험의
대부분이 fsync이고, 디스크가 바쁘면 시간이 크게 뛴다(desktop
89~1,075ms, CPU를 제한한 coverage 측정에서 7.4초). 이 시험은 생성한
바이트와 drift 판정을 보고, 내구성은 validated-json-artifact 시험이
본다. 기본 timeout 10초 아래라 자기 timeout도 없다.
고른 방법: `generateArtifactSchemas`가 writer를 받는다(기본은 지금의
`writeValidatedJsonArtifact`). 시험은 같은 검증·원자적 rename writer를
`createValidatedJsonArtifactWriter`로 만들고 sync만 뺀다.
- 버린 대안: 시험에 timeout 선언. 시간을 줄이지 않고 흔들림을 덮는다.
위험·한계: 생성 명령과 check:artifact-schemas의 쓰기는 그대로다.
검증(desktop, 고치기 전·후 번갈아 3회, 부하 11~16): 89/1,075/98 →
36/48/35ms. coverage + CPU 소모 12개에서도 208~519 → 73~151ms. 시험
통과, check:artifact-schemas rc=0, check:types·eslint rc=0. 로그
/tmp/claude-gates/w2fe2-slow2·6/.
문제: 「times out at the <phase> wait when the deadline fires」가 실제
시계로 30ms deadline을 잡는다. 전송 실패(transport backoff)나 503
(retry backoff)을 처리하는 시점에 이미 30ms가 지났으면 실행기는
backoff할 시간이 없다고 보고 그 실패로 끝낸다(`remaining() > 0`이
거짓). 그래서 기대한 TIMEOUT 대신 NETWORK_FAILURE·503 결과가 나온다.
desktop 부하 31에서 한 번 떨어졌다(PR #19 W2-FE 기록 F).
고른 방법: deadline 경우만 가짜 시계(`vi.useFakeTimers`)로 돌고, 그
대기에 닿은 것을 확인한 뒤 30ms를 진행한다. 시험이 보려는 것(대기
중에 deadline이 나면 DEADLINE·TIMEOUT)을 그대로 보고 기계 속도에는
기대지 않는다. 두 backoff 단계는 답하기 전에 실제 시간 40ms를 멈춘다
(`Atomics.wait`). 실제 시계로 되돌리면 이 시험이 매번 실패한다.
- 버린 대안: deadline을 늘리기. 경쟁이 남고 규칙 밖이다.
- 버린 대안: `vi.waitFor`로 기다리기. 가짜 시계에서는 확인할 때마다
시계를 진행해 대기에 닿기 전에 deadline이 날 수 있다.
위험·한계: 실행기 동작은 바꾸지 않았다. deadline이 이미 지난 뒤
도착한 전송 실패를 NETWORK_FAILURE로 보고하는 것이 맞는지는 이
커밋이 정하지 않는다.
검증(desktop): 시험 파일 72개 3회 연속 통과. 변이: 가짜 시계를 빼고
실제 30ms deadline에 같은 40ms 멈춤을 두면 transport backoff·retry
backoff 둘이 매번 실패(나머지 넷 통과). eslint·check:types rc=0.
로그 /tmp/claude-gates/w2fe2-http1·2/.
문제: 0bb1f0af에서 모듈을 Babel AST로 읽게 바꾼 뒤, 파일 맨 위의
지시문(`"use client";`)을 세지 않는다. Babel은 지시문을
`program.directives`에 두고 `body`에 넣지 않는다(ESTree 변환은 body에
넣었다). V8 coverage는 `"use client"`를 문장 1개로 세고 `"use strict"`는
세지 않는다(desktop에서 실제 V8 실행으로 확인). 그래서 지시문과 타입만
있는 모듈이 counterless로 분류되고 coverage에는 문장이 잡혀, 파생
프로젝트에서 risk-coverage가 거짓으로 실패한다. 지금 `src/`에는
지시문이 없어 375개 대조에서 보이지 않았다. 새 눈 리뷰(fe-testing
렌즈)가 찾았다.
고른 방법: `"use strict"`가 아닌 지시문이 있으면 counter-bearing이다.
check:v8-coverage-counter-semantics의 fixture에 지시문 모듈 둘
(`use client`는 counter-bearing, `use strict`는 counterless)을 더해,
분류기가 기대는 V8 동작을 실제 실행으로 고정한다. risk-coverage 시험도
같은 두 모듈을 분류한다.
위험·한계: 예전 분류(ESTree)는 `"use strict"`만 있는 모듈을
counter-bearing으로 봤다. 이제 V8과 같이 counterless다.
검증(desktop): risk-coverage·risk-coverage-files·counter-semantics 시험
통과, check:v8-coverage-counter-semantics PASS(2 counter-bearing,
8 counterless), check:types·eslint rc=0. 변이: 지시문 규칙을 빼면
「matches the observed V8 counterless …」가 `directive-use-client.ts`를
counterless로 받아 실패. 로그 /tmp/claude-gates/w2fe2-dir1·2·4/.
Fixes: 0bb1f0afc0 ("perf(coverage): 위험 커버리지 모듈 목록을 Babel 파서와 동기 fs로 만든다")
문제: fixture spec 여섯(old-tab-chunk-recovery, generated-feature,
preload-use, boot-module-failure, service-worker-update·recovery)이
beforeAll에서 저장소를 복사해 vite build를 동기로 돈다. chromium·
firefox·webkit project가 그 hook을 따로 돌아, e2e 한 번에 같은 build를
세 번(약 9 build × 3) 만든다. 그 build는 옆 worker의 브라우저와 CPU를
다툰다. FE-GATE-008이 가끔 떨어진 firefox 시험(runner run 127,
desktop p5·fea-v8: `old-tab-chunk-recovery`·`app-shell`·`accessibility`의
첫 goto 뒤 요소 없음)은 이 build가 도는 구간과 겹쳤다. 다만 아래
6회 실행에서 고치기 전·후 모두 재현되지 않아, 이것이 원인이라고는
확정하지 못했다.
고른 방법: e2e 설정의 global setup이 run마다 공유 폴더를 만들고
(`SHARED_FIXTURE_BUILD_ROOT`), `prepareFixtureBuilds`와
`prepareServiceWorkerBuilds`가 key마다 처음 닿은 worker만 build한다.
나머지 worker는 그 결과를 기다려 쓴다(`mkdir` 잠금, 결과 JSON을
rename으로 공개, 실패는 `.failed`로 전한다). 같은 key를 다른 정의로
부르면 거절한다. build는 엔진과 무관하고 시험이 build 폴더에 쓰는
곳은 없다(edit는 build 전에만 돈다). global teardown이 폴더를 지운다.
- old-tab spec은 edit 안에서 정하던 기능 목록을 build 뒤에 root에서도
읽는다. 다른 project의 build를 쓴 worker는 edit를 돌지 않는다.
- 공유 폴더가 없으면(Vitest 시험, 다른 Playwright 설정) 예전처럼
호출마다 자기 사본을 만든다.
- 버린 대안: expect timeout 늘리기·worker 줄이기(규칙 밖), fixture
spec을 한 브라우저만 돌리기(브라우저별 계약이 줄어든다).
위험·한계: build를 기다리는 worker는 자기 hook timeout(180~300초)
안에서 기다린다. build한 worker가 죽으면 기다리는 쪽은 그 timeout으로
실패한다. 2026-11-01 리뷰의 R-1(두 helper 중복 정리)은 하지 않았다.
검증(desktop, `taskset -c 0-5` + worker 6으로 runner 모양, 같은 세션에서
고치기 전·후 번갈아 3회): e2e 전체 벽시계 172/150/141 → 123/141/113초
(중앙값 150 → 123초), 6회 모두 183개 통과. 공유 시험 6개 통과,
check:types·eslint rc=0. 로그 /tmp/claude-gates/w2fe2-e2eab/,
w2fe2-shared1/.
c6d7f43a가 바꾼 동작(브라우저 project마다가 아니라 e2e 실행 하나에
한 번 build, 공유 폴더가 없으면 예전처럼 부를 때마다 사본)을 시험
분류 문서에 적는다. spec을 새로 쓰는 사람이 beforeAll의 build가
공유된다는 것을 알아야 build 폴더에 쓰는 시험을 만들지 않는다.
문제: runner PR 1회(merge job 셋, capacity 1이라 차례로)가 28.5분이다
(run 151). tests job의 FE-GATE-020이 13분 13초로 가장 크고, 그 안의
선택 runtime 제거 드릴 셋(optional recipe, browser file/storage,
realtime)이 약 7분이다. worker를 늘리지 않는 대책을 다 넣어도 25분
목표에 닿지 않는다.
고른 방법(소유자 결정 p, 2026-11-12): 그 드릴 셋을 새 게이트
FE-GATE-030 `optional-removability`로 떼어 main 단계(`main_gate`,
FE-GATE-029 다음)에서 돌린다. 샘플 제거와 scaffold 드릴은 merge의
FE-GATE-020에 남는다. 짝 백엔드가 무거운 lane을 nightly로 옮긴 것과
같은 모양이다.
- 계약: 정규 게이트 ID를 001..030으로, MAIN_READY를 029·030으로,
main_gate job의 게이트를 029·030으로 바꾼다. 계약 보고서의 gateCount는
29(016은 은퇴).
- scaffold 드릴의 제외 목록에서 셋을 뺀다. 이제 merge 명령이 아니라서,
계약 검사가 「merge 밖 명령을 제외하면 숨긴다」고 거절했다.
- main job 이름을 `main / self-tests and removal drills`로 바꾼다.
- 시험: 020은 merge·merge_test에서 sample·scaffold만, 030은
main·main_gate에서 셋을 돈다고 단언한다. 승격 공식 시험에 030을 더한다.
- 문서: 결정 색인(decisions.md 2.2), 구조·시험·리뷰 기준·CI 문서,
fe-structure 스킬의 드릴 명령.
위험·한계: 선택 runtime을 바꾼 PR의 제거 회귀는 병합 뒤 main run에서
본다. main이 빨강이면 다음 PR이 고친다. 그런 PR은
`scripts/verify.sh gate FE-GATE-030`을 직접 돌려야 한다(structure.md
12절에 적음). 파생 프로젝트가 main job 이름을 필수 검사로 걸었으면
이름이 바뀐다.
검증(desktop): generate:ci-workflow, 생성 시험 스냅샷 갱신,
ci-workflow-generation·promotion-readiness·feature-scaffold-drill·
removal-drill-test-paths·example-feature-rules 등 483개 통과,
check:ci(29 gates) rc=0, check:ci:gating rc=0, verify:documentation
PASS_SCOPED, check:types·eslint rc=0. 로그 /tmp/claude-gates/w2fe2-o1b~g/.
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(Gitea Actions)에서 프론트 merge 단계가 이 PR 전에는 한 번도 초록이 아니었다. run 56·80·81에서 FE-GATE-005·013·020이 늘 빨갛다.
tests/unit/fixture-node-modules.test.ts가 runner의GITEA_ACTIONS·GITHUB_ACTIONS때문에 실패한다(시험이 바깥 env에 기댐).test:system사전 점검에서 멈춘다.이 PR은 위 실패를 고치고, worker를 늘리지 않고 중복을 없애 merge 시간을 줄인다.
고른 방법과 버린 대안
ddfcb6f6fix(tests)CI=false로 흉내 낸다79a225b6fix(scripts)verify.sh parts가 명령의args를 넘긴다0d8e4f5aperf(scripts)check:browser-file-storage-boundaries를 ESLint API 한 번으로(53초 → 3.3초)b4210753perf(scripts)66138440build(deps)dependency-cruiser제거, 의존성 562 → 5421d3eb901ci(gates)scripts/run-in-system-container.sh, 계약hostEnvironment)92abfd20ci(gates)1f09c1ccperf(tests)35b60a04fix(tests)2f5eb2b4ci(workflow)concurrency: 같은 PR·브랜치의 새 push가 앞 run을 취소한다. 수동 실행은 ref·stage마다 group이 따로이고 돌고 있는 run을 취소하지 않는다543518adfix(coverage)checkout (copy)-src/아래에서 돌아 막는다0bb1f0afperf(coverage)@babel/core파싱(2.8배), 기본 fs를 동기로(부하 아래 event loop 대기 제거)0c3c9d33fix(coverage)"use strict"밖의 지시문을 문장으로 센다(V8과 같게, fixture로 고정)198e9856test(schemas)37a85004test(http)8de1403bci(gates)c6d7f43aperf(e2e)뺀 대책: pnpm store 캐시(이득 약 20초, 계약의 job 단계 고정을 바꿔야 함), 009가 e2e의 a11y 결과 재사용(게이트마다 증거를 새로 만드는 계약과 부딪침), 느린 unit 시험 손보기(가장 큰
documentation-readiness검사기 시간이 한 곳에 몰려 있지 않아 이득이 작음).위험과 영향
docs/testing/taxonomy.md).scripts/verify.sh gate FE-GATE-030을 직접 돌린다. main job 이름이main / self-tests and removal drills로 바뀐다.tests/e2e/old-tab-chunk-recovery.spec.ts를 고친다. 이 PR도 그 파일을 고쳐 병합 순서에 따라 충돌할 수 있다.검증
runner(Gitea Actions, merge job 셋은 capacity 1이라 차례로):
27876ffcf6e2560eba72b8652a70591cconcurrency 실제 동작: 대기 중인 PR run이 새 push로 취소 — 144→145(22:17:43), 145→147(22:26:32), 147→149(22:45:59), 149→151(23:20:02). Chrome에서 다시 실행한 run 151 attempt 2도 대기 중에 다음 push(01:20:48)로 취소됐다. 156→169(02:03:29). 실행 중 취소(
cancel-in-progress가 실제로 쓰이는 경우)는 확인하지 못했다: runner 대기열이 길어 이 PR의 run이 도는 동안 올릴 변경이 없었다.desktop(
flock /tmp/claude-gates/heavy.lock, CI env):871ab57d=2a70591c, 부하 20.65): 14/14 rc=0, 합 1,275초(005 139, 008 197, 013 179 시스템 컨테이너, 020 630), 실행 뒤 추적 파일 변경 0. 같은 단계 W2-FE 트리(ba72b865, p5) 1,368초·008 실패.176e1578=e2daf8e0): FE-GATE-029 rc=0 35초, FE-GATE-030 rc=0 341초, 실행 뒤 추적 파일 변경 0. PR run은 main 단계를 돌지 않으므로 FE-GATE-030의 runner 확인은 병합 뒤 main push run이다.taskset -c 0-5, worker 6) 172/150/141 → 123/141/113초, 6회 모두 183개 통과. risk-coverage 「historical」 시험 1,913/1,420/1,938 → 715/642/742ms. json-schema 생성 시험 89/1,075/98 → 36/48/35ms.additional: outside-src.ts로 실패. 지시문 규칙을 빼면 risk-coverage 시험 실패. 가짜 시계를 빼고 실제 30ms deadline + 40ms 멈춤이면 backoff 시험 둘이 매번 실패.기준·목표·도달
리뷰어가 볼 곳
scripts/run-in-system-container.sh,config/ci/system-container.Dockerfiletests/e2e/support/shared-fixture-builds.ts(잠금·대기·실패 전달),tests/e2e/support/fixture-builds.ts,tests/e2e/support/service-worker-builds.tsscripts/lib/coverage-scope.ts,scripts/lib/risk-coverage.ts(파서·fs·지시문)scripts/lib/feature-scaffold-drill.ts,scripts/test-sample-removal.ts.gitea/workflows/quality-gates.yml은 생성 파일이다(corepack pnpm generate:ci-workflow).관련
template-program/README.md1절(끝 상태), 5절 e·o(FE-GATE-013)·p(FE-GATE-030)w2-fe-ci-perf.md,w2-fe2-takeover.md문제: vitest는 coverage include·exclude를 모듈의 절대 경로에 picomatch `contains: true`로 맞춘다. 그래서 `src/**/*.{ts,tsx}`가 경로 어디에서나 맞는다. checkout이 이름이 `src`로 끝나는 폴더(`~/work/app-src/`)에 있으면 `vite.config.ts`·`scripts/**` 같은 루트 파일이 coverage에 들어가 risk-coverage가 저장소 목록 밖의 행으로 실패한다(tech-log 동기화 때 desktop에서 본 일). CI 경로에는 `src`가 없어 runner에서는 안 보였다. 고른 방법: `scripts/lib/coverage-scope.ts`의 `rootAnchoredGlobs`가 패턴 앞에 루트를 붙인다. 루트는 vitest의 glob 라이브러리(tinyglobby 0.2)가 cwd를 escape하는 식 그대로 escape해, 괄호 같은 glob 문자가 든 루트도 자기 자신에만 맞고 안 불린 파일 glob도 `src/...`로 풀린다. `vitest.config.ts`와 `check:v8-coverage-counter-semantics`의 자식 설정이 이 함수를 쓴다. - 막는 시험: counter-semantics 검사가 fixture를 `checkout (copy)-src/` 아래로 복사하고, fixture 시험이 `src/` 밖 모듈(`outside-src.ts`)도 불러온다. 고정이 빠지면 그 모듈이 행으로 들어와 행 집합 검사가 실패한다. 이 검사는 test:coverage 첫 단계에서 이미 자식 vitest를 띄우므로 프로세스가 늘지 않는다. 단위 시험은 repo 설정의 모든 패턴이 루트로 시작하는지와 escape를 본다. - 버린 대안: picomatch로 vitest의 판정을 흉내 내는 단위 시험. 직접 의존성이 아니고, vitest가 옵션을 바꾸면 거짓 통과한다. 위험·한계: Windows 루트는 `/`로 바꾼 뒤 같은 식으로 escape한다. 올바른 Windows 경로에서는 tinyglobby의 Windows escape와 결과가 같다고 보았지만 Windows에서 돌려 보지는 않았다. 검증(desktop): coverage-scope·v8-coverage-counter-semantics 시험 통과, check:v8-coverage-counter-semantics rc=0. 변이: 자식 설정을 예전 `["src/**/*.ts"]`로 되돌리면 같은 검사가 `additional: outside-src.ts`로 rc=1. check:types·eslint rc=0. 로그 /tmp/claude-gates/w2fe2-cov1/.