ci(gates): runner에서 merge 단계를 초록으로 만들고 시간을 줄인다 #19

Merged
donghyeon.kang merged 27 commits from donghyeon.kang/claude/w2-fe-ci-perf-dce080 AGit into main 2026-11-12 19:28:45 +00:00
Owner

무엇을, 왜

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
## 무엇을, 왜 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`
donghyeon.kang added 9 commits 2026-11-11 22:01:28 +00:00
문제: 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회.
chore(ledger): W2-FE CI 성능 작업의 예측을 적는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m17s
frontend-quality-gates / merge / tests (pull_request) Failing after 16m50s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 8m44s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
27876ffcba
donghyeon.kang added 4 commits 2026-11-12 10:57:27 +00:00
문제: 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.
docs: FE-GATE-013이 시스템 컨테이너에서 도는 것을 지침과 운영 문서에 적는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 1m49s
frontend-quality-gates / merge / tests (pull_request) Successful in 22m18s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 6m54s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
f6e2560e4d
문제: 작업 매뉴얼·루트 지침·스킬이 「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개 통과.
donghyeon.kang added 1 commit 2026-11-12 11:02:02 +00:00
chore(merge): FE-GATE-013 판정·시험 timeout PR들이 들어간 main을 받는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m7s
frontend-quality-gates / merge / tests (pull_request) Successful in 20m56s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 6m56s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
ba72b86595
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 단계는 이 커밋에서 다시 돈다.
donghyeon.kang added 2 commits 2026-11-12 13:03:19 +00:00
문제: 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/.
fix(coverage): coverage 대상 패턴을 저장소 루트에 고정한다
frontend-quality-gates / merge / static checks (pull_request) Canceled after 0s
frontend-quality-gates / merge / tests (pull_request) Canceled after 0s
frontend-quality-gates / merge / browser tests (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Canceled after 0s
frontend-quality-gates / external-vulnerability-provider (pull_request) Canceled after 0s
frontend-quality-gates / external-provenance-provider (pull_request) Canceled after 0s
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Canceled after 0s
frontend-quality-gates / deploy-promoted-release (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Canceled after 0s
frontend-quality-gates / main / checker self-tests (pull_request) Canceled after 0s
543518ad2a
문제: 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/.
donghyeon.kang added 2 commits 2026-11-12 13:17:42 +00:00
문제: `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/.
test(schemas): 스키마 생성 시험이 fsync 없는 writer로 임시 폴더에 쓴다
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Canceled after 0s
frontend-quality-gates / main / checker self-tests (pull_request) Canceled after 0s
frontend-quality-gates / merge / static checks (pull_request) Canceled after 0s
frontend-quality-gates / merge / tests (pull_request) Canceled after 0s
frontend-quality-gates / merge / browser tests (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Canceled after 0s
frontend-quality-gates / external-vulnerability-provider (pull_request) Canceled after 0s
frontend-quality-gates / external-provenance-provider (pull_request) Canceled after 0s
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Canceled after 0s
frontend-quality-gates / deploy-promoted-release (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Canceled after 0s
198e9856f6
문제: 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/.
donghyeon.kang added 3 commits 2026-11-12 13:26:30 +00:00
W2-FE 세션의 실측을 세션 기록에서 다시 세어 적는다(인계 절의 값은
20:40 기준이라 그 뒤 기록이 빠져 있었다). 이어받는 세션의 예측도
같이 적는다. 근거는 줄 안의 basis다.
문제: 「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/.
docs(changelog): PR #19 이어받은 커밋들을 미출시 절에 적는다
frontend-quality-gates / merge / static checks (pull_request) Canceled after 0s
frontend-quality-gates / merge / tests (pull_request) Canceled after 0s
frontend-quality-gates / merge / browser tests (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Canceled after 0s
frontend-quality-gates / external-vulnerability-provider (pull_request) Canceled after 0s
frontend-quality-gates / external-provenance-provider (pull_request) Canceled after 0s
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Canceled after 0s
frontend-quality-gates / deploy-promoted-release (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Canceled after 0s
frontend-quality-gates / main / checker self-tests (pull_request) Canceled after 0s
e2bf08e9ea
donghyeon.kang added 1 commit 2026-11-12 13:45:58 +00:00
fix(coverage): 위험 커버리지가 "use strict" 밖의 지시문을 문장으로 센다
frontend-quality-gates / merge / static checks (pull_request) Canceled after 0s
frontend-quality-gates / merge / tests (pull_request) Canceled after 0s
frontend-quality-gates / merge / browser tests (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Canceled after 0s
frontend-quality-gates / external-vulnerability-provider (pull_request) Canceled after 0s
frontend-quality-gates / external-provenance-provider (pull_request) Canceled after 0s
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Canceled after 0s
frontend-quality-gates / deploy-promoted-release (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Canceled after 0s
frontend-quality-gates / main / checker self-tests (pull_request) Canceled after 0s
0c3c9d3351
문제: 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로 만든다")
donghyeon.kang added 2 commits 2026-11-12 14:20:00 +00:00
문제: 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/.
docs(changelog): 지시문 분류와 공유 fixture build를 미출시 절에 적는다
frontend-quality-gates / merge / static checks (pull_request) Canceled after 0s
frontend-quality-gates / merge / tests (pull_request) Canceled after 0s
frontend-quality-gates / merge / browser tests (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Canceled after 0s
frontend-quality-gates / external-vulnerability-provider (pull_request) Canceled after 0s
frontend-quality-gates / external-provenance-provider (pull_request) Canceled after 0s
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Canceled after 0s
frontend-quality-gates / deploy-promoted-release (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Canceled after 0s
frontend-quality-gates / main / checker self-tests (pull_request) Canceled after 0s
2a70591c81
donghyeon.kang added 1 commit 2026-11-12 16:20:46 +00:00
docs(testing): e2e fixture build를 실행 하나에 한 번 만든다고 적는다
frontend-quality-gates / merge / static checks (pull_request) Canceled after 0s
frontend-quality-gates / merge / tests (pull_request) Canceled after 0s
frontend-quality-gates / merge / browser tests (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Canceled after 0s
frontend-quality-gates / external-vulnerability-provider (pull_request) Canceled after 0s
frontend-quality-gates / external-provenance-provider (pull_request) Canceled after 0s
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Canceled after 0s
frontend-quality-gates / deploy-promoted-release (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Canceled after 0s
frontend-quality-gates / main / checker self-tests (pull_request) Canceled after 0s
e4701b2152
c6d7f43a가 바꾼 동작(브라우저 project마다가 아니라 e2e 실행 하나에
한 번 build, 공유 폴더가 없으면 예전처럼 부를 때마다 사본)을 시험
분류 문서에 적는다. spec을 새로 쓰는 사람이 beforeAll의 build가
공유된다는 것을 알아야 build 폴더에 쓰는 시험을 만들지 않는다.
donghyeon.kang added 2 commits 2026-11-12 17:03:26 +00:00
문제: 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/.
docs(changelog): FE-GATE-030 신설과 main job 이름 변경을 미출시 절에 적는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 1m58s
frontend-quality-gates / merge / tests (pull_request) Successful in 17m6s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 6m38s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / self-tests and removal drills (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
e2daf8e012
donghyeon.kang marked the pull request as ready for review 2026-11-12 19:27:26 +00:00
donghyeon.kang merged commit c5f29344cd into main 2026-11-12 19:28:45 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-frontend-template#19