fix(round9): 그룹 C 검사기 진단과 시험의 빈틈을 고친다 #55

Open
donghyeon.kang wants to merge 12 commits from donghyeon.kang/r9-c-checkers-tests AGit into main
Owner

무엇을, 왜

round9 리뷰 그룹 C1(검사기 진단)·C2(시험)의 발견을 고친다. 검사기가 본 단계와 다른 방법으로 확인하거나, 실패 이유를 말하지 않거나, 시험이 단언 없이 통과하던 자리다. 커밋은 발견마다 하나다(03-03·03-04는 같은 검사기의 같은 hunk라 하나). 커밋마다 Refs:에 ID를 적었다.

  • test:system 사전 점검이 provider와 같은 호출을 한다: prlimit·systemd-run 실행 가능, user manager 버전(254 이상), provider scope와 같은 속성·cgroup 강제 확인으로 /bin/true 한 번(1112/08-03).
  • verify:documentation이 scripts/verify.sh exec -- …·script <이름>·python3 … 명령 안의 경로와 script 이름도 대조한다(1112/08-06).
  • fanout 검사 실패 줄이 두 탈출 방법(createCursorPaginationRuntime, // fanout-reviewed:)을 적고, 결과 줄이 주석으로 넘긴 호출의 수와 위치를 적는다. 주석 달린 커서 루프 허용 fixture(0929/12-01).
  • drill이 --provider-evidence <파일>을 받아, 같은 runbook·release·7일 안의 증거면 로컬에서 못 본 항목만 바꾼다. 모든 항목이 답을 얻고 FAIL이 없을 때만 PASS(0929/11-02).
  • build manifest와 release 검사 둘이 route 청크를 청크 이름이 아니라 페이지 소스 파일로 찾고(findRouteChunk, scripts/lib/build-manifest-outputs.ts), 못 찾으면 규칙을 적는다(0929/13-03). 새 파일을 두지 않은 것은 release 후보 archive의 검증기 소스 목록(config/ci/gates.json member 집합)을 바꾸지 않기 위해서다.
  • RUN_OUTPUT_ROOT가 다른 폴더면 checkout 빌드를 읽는 스크립트 넷이 스스로 거절한다(1106/12-02 남은 것).
  • live hosting probe가 /로 끝나는 하위 경로 기준 URL을 받고 surface를 그 아래에서 요청한다. 후보가 그 경로로 빌드됐는지 양방향으로 본다(0929/13-06).
  • OPFS 다른 탭 시험 둘의 조용한 return을 없앤다. 지원 엔진은 설치 성공을, Playwright WebKit은 지원 판정 거절을 단언한다(1112/03-02).
  • check-test-evidence의 mask 규칙과 forbidOnly 규칙에 혼자 도는 거절 시험을 둔다. strict fixture 사용은 ESLint no-restricted-imports로 네 브라우저 폴더에서 본다(1112/03-03, 1112/03-04).
  • strict 검사를 watchBrowserFailures로 빼 fixture가 같은 context의 다른 탭도 보고, SW recovery의 손 사본을 지운다(1112/03-05).
  • RPC 스트림 시험 셋이 실제 1초를 자지 않는다(1101/10-07).
  • SW e2e 빌드 helper가 fixture-builds.ts의 buildEditedCopies 하나를 쓴다(0929/11-07).

고른 방법과 버린 대안

  • 0929/11-02: (a) provider 증거 입력을 골랐다. (b) production·field 단계를 "provider 연결 전 기본 꺼짐"으로 바꾸는 안은 job 그래프(config/ci/**)를 바꾸는 일이라 하지 않았다.
  • 0929/13-03: 청크 이름 규약을 문서로만 적는 안 대신, 소스 파일로 찾게 했다. 세 사용처가 한 함수를 쓴다.
  • 1112/03-02: 미지원 엔진을 quarantine skip으로 두는 안은 버렸다. capability 증거 검사(scripts/verify-browser-capability-evidence.ts)가 skipped 노드를 거절해 증거 규칙(게이트 기준)을 낮춰야 하고, docs/operations/ci-quality-gates.md도 미지원 엔진은 skip하지 않고 명시적 UNSUPPORTED를 검증한다고 적는다.
  • 1112/03-04: 문자열 검사를 넓히는 안 대신 ESLint 구문 규칙으로 옮겼다(결함 패턴 G8의 통제).
  • 1112/03-05: 둘째 탭은 탭이 열릴 때 listener를 동기로 붙인다. preload 검사는 첫 page만 한다(늦게 붙인 route는 앞선 요청을 놓친다). SW recovery는 preload 검사를 하지 않는다: 같은 origin을 두 번 연 context라 WebKit이 회복된 load의 script를 캐시에서 주어 추적기의 route를 지나치고, 모든 preload가 미사용으로 읽혔다(desktop 실행에서 16건).

정한 기본값

  • provider drill 증거의 유효 기간 7일, 시계 앞섬 허용 5분(PROVIDER_EVIDENCE_MAX_AGE_MS, scripts/drill-runbook.ts). 근거: drill 판정은 지금의 provider 상태를 말해야 하므로, 오래된 관찰은 받지 않는다. 7일은 잰 값이 아니라 정한 기본값이다. 배포가 잦은 제품은 줄일 수 있다.
  • 증거 파일 꼴 providerDrillEvidenceSchema(scripts/contracts/release-artifacts.ts). 항목 이름은 drill의 UNVERIFIED 줄이 적는 이름이다.
  • 사전 점검의 scope 탐침은 provider scope와 같은 인자에 RuntimeMax 5초, 점검 timeout 15초.
  • HOSTING_BASE_URL은 /로 끝나는 경로를 받는다(query·fragment 거절).
  • 브라우저 spec의 plain test 예외는 tests/e2e/preload-use.spec.ts, tests/browser-capabilities/chunk-load-error.spec.ts 둘.

위험과 영향

  • 다운스트림이 따라 할 일(CHANGELOG 후보):
    • 새 브라우저 spec은 tests/support/browser/strict-browser-test.ts의 test만 import한다. @playwright/test의 test를 쓰던 spec은 lint에서 실패한다.
    • 같은 context에서 연 둘째 탭의 console·pageerror·requestfailed가 이제 시험 실패다. 일부러 낸 실패는 allowedBrowserFailure로 허용한다.
    • provider를 연결한 제품은 production drill 명령에 --provider-evidence <파일>을 넘겨야 그 단계가 닫힌다.
    • 하위 경로로 배포하면 HOSTING_BASE_URL에 그 경로(https://…/app/)를 준다.
    • test:system 사전 점검이 user manager·systemd-run을 실제로 써 본다. user manager가 없는 runner는 이제 사전 점검에서 실패한다(전에는 provider 시험에서 실패).
  • drill 증거에는 서명이 없다. production job에 증거 파일을 둘 수 있는 쪽이 PASS를 만들 수 있다. 신뢰 수준은 --release-root 입력과 같다. 서명이 필요하면 다른 provider 증거처럼 Ed25519로 묶는 후속이 필요하다(보안 렌즈 넘김).
  • w2-fe-2 PR #47과 겹치는 파일: tests/support/browser/strict-browser-test.ts(그쪽은 import 줄, 이쪽은 본문), tests/e2e/preload-use.spec.ts(그쪽은 import 줄, 이쪽은 끝의 describe 하나). 먼저 병합되는 쪽 뒤에 총괄이 갱신한다.
  • w2-fe-2에 넘김: production 게이트 drill 명령에 --provider-evidence를 넘길 자리(config/ci/**).
  • 그룹 A 경로 한 줄: tests/visual/scrollbar-gutter.visual.spec.ts의 디코더 탭 getContext("2d", { willReadFrequently: true })(둘째 탭 감시가 Chromium 경고를 잡아서).
  • 범위 밖에서 본 것(고치지 않음): documentationReviewArtifactSchema의 passed 판정식(scripts/contracts/release-artifacts.ts:1603-1624)에 documents system 검사가 없어, 그 검사만 실패하면 verify:documentation이 실패 이름 대신 ZodError로 멈춘다.

검증

기준: main 950ea11a 위 12커밋, head 1b5a8c6f.

  • desktop scripts/verify.sh merge(CI env, 로그 /tmp/claude-gates/r9c-pr1-merge3/, 시작 부하 21.58): FE-GATE-001~013·020 14개 모두 rc=0(005 273s, 008 320s, 013 320s — 시스템 컨테이너 안, 020 443s).
  • 앞 회차와 고친 것: 1회차(r9c-pr1-merge, ee95573f 기준) 005·020은 tests/unit/security-followup.test.ts(보관 검증기 소스 목록에 새 import 없음), 008은 scrollbar-gutter.visual.spec.ts의 디코더 탭 Chromium Canvas2D 경고(둘째 탭 감시가 새로 잡음 → willReadFrequently). 2회차는 목록에 새 파일을 더한 탓에 CI 계약 「immutable candidate archive member set drift」로 전 게이트가 시작 전에 멈춤 → findRouteChunk를 이미 목록에 있는 파일로 옮김. 3회차 GREEN.
  • 같은 1회차에서 desktop scripts/verify.sh gate FE-GATE-029 rc=0(35s), scripts/verify.sh script verify:documentation rc=0. 그 뒤 바뀐 것은 검사기·문서가 아니다(route 청크 함수 위치, 시각 시험 한 줄, 목록 되돌림).
  • main 950ea11a와 합친 트리(#47 Firefox 프로필): 노트북 감싸개 ~/.claude/bin/laptop-gate — check:types rc=0 7s, lint rc=0 12s, browser-spec-imports·test-evidence-source-rules 12건 rc=0, 최대 부하 3.68, 로그 ~/laptop-gate-logs/r9c-pr1-merged-*. 지금 main 7e5a0bb8(#48)과 git merge-tree 충돌 없음.
  • RED·GREEN(desktop scripts/verify.sh exec): C1 시험 7파일 134건 GREEN, 고친 코드를 기준 커밋으로 되돌리면 새 시험이 실패(r9c-c1-rg2). 변이 — mask 블록 삭제·forbidOnly 호출 삭제·ESLint 규칙 삭제에서 해당 시험 1·1·5건 실패(r9c-pr1b). RPC 세 시험 고치기 전 1.027·1.059·1.056s → 고친 뒤 100 ms 아래. 둘째 탭 시험은 옛 fixture에서 세 엔진 모두 실패. OPFS spec 세 엔진 12건 통과, 이른 return을 단언으로만 바꾼 판에서는 WebKit 세 케이스 실패(r9c-pr1c).
  • 확인 못 한 것: runner merge job 셋(이 PR run에서 본다). 새 눈 확인 리뷰(고친 뒤 1회)는 아직이다 — r9-fe 마지막 확인 리뷰나 다음 세션이 한다.

리뷰어가 볼 곳

  • scripts/check-system-test-prerequisites.ts, scripts/lib/provider-cgroup.ts: 시스템 컨테이너 안 root에서 user bus 환경(XDG_RUNTIME_DIR, DBUS_SESSION_BUS_ADDRESS)을 provider와 같이 쓴다.
  • scripts/drill-runbook.ts judgeProviderEvidence·applyProviderEvidence, record schema의 providerEvidence.
  • tests/support/browser/strict-browser-test.ts의 page fixture(다른 탭 감시).
  • eslint.config.ts의 browser spec 항목.

관련

  • 리뷰: docs/reviews/2026-11-round9-03-testing-qa.md(T-02~T-05), docs/reviews/2026-11-round9-08-guardrails-docs.md(GD-03, GD-06), docs/reviews/2026-11-round9-11-prior-findings-b.md 3절.
  • 새 눈 리뷰 1회(fe-testing·fe-qa 렌즈): Low 3건(기본 import 미차단, forbidOnly 기본 목록 변이 생존, base-path 한쪽 판정) 모두 고침.

발견 ID 표

ID 판정 커밋
1112/08-03 고침 eb7d89c7
1112/08-06 고침 aebb7c8c
0929/12-01 고침 923b29be
0929/11-02 고침 47a59572
0929/13-03 고침 86b4a328
1106/12-02 고침 e657d00f
0929/13-06 고침 7922592c
1112/03-02 고침 1d7462b3
1112/03-03 고침 34a7627d
1112/03-04 고침 34a7627d
1112/03-05 고침 1b5a8c6f
1101/10-07 고침 f5e4e80e
0929/11-07 고침 dec8a9db
## 무엇을, 왜 round9 리뷰 그룹 C1(검사기 진단)·C2(시험)의 발견을 고친다. 검사기가 본 단계와 다른 방법으로 확인하거나, 실패 이유를 말하지 않거나, 시험이 단언 없이 통과하던 자리다. 커밋은 발견마다 하나다(03-03·03-04는 같은 검사기의 같은 hunk라 하나). 커밋마다 `Refs:`에 ID를 적었다. - `test:system` 사전 점검이 provider와 같은 호출을 한다: `prlimit`·`systemd-run` 실행 가능, user manager 버전(254 이상), provider scope와 같은 속성·cgroup 강제 확인으로 `/bin/true` 한 번(1112/08-03). - `verify:documentation`이 `scripts/verify.sh exec -- …`·`script <이름>`·`python3 …` 명령 안의 경로와 script 이름도 대조한다(1112/08-06). - fanout 검사 실패 줄이 두 탈출 방법(`createCursorPaginationRuntime`, `// fanout-reviewed:`)을 적고, 결과 줄이 주석으로 넘긴 호출의 수와 위치를 적는다. 주석 달린 커서 루프 허용 fixture(0929/12-01). - drill이 `--provider-evidence <파일>`을 받아, 같은 runbook·release·7일 안의 증거면 로컬에서 못 본 항목만 바꾼다. 모든 항목이 답을 얻고 FAIL이 없을 때만 PASS(0929/11-02). - build manifest와 release 검사 둘이 route 청크를 청크 이름이 아니라 페이지 소스 파일로 찾고(`findRouteChunk`, `scripts/lib/build-manifest-outputs.ts`), 못 찾으면 규칙을 적는다(0929/13-03). 새 파일을 두지 않은 것은 release 후보 archive의 검증기 소스 목록(`config/ci/gates.json` member 집합)을 바꾸지 않기 위해서다. - `RUN_OUTPUT_ROOT`가 다른 폴더면 checkout 빌드를 읽는 스크립트 넷이 스스로 거절한다(1106/12-02 남은 것). - live hosting probe가 `/`로 끝나는 하위 경로 기준 URL을 받고 surface를 그 아래에서 요청한다. 후보가 그 경로로 빌드됐는지 양방향으로 본다(0929/13-06). - OPFS 다른 탭 시험 둘의 조용한 `return`을 없앤다. 지원 엔진은 설치 성공을, Playwright WebKit은 지원 판정 거절을 단언한다(1112/03-02). - `check-test-evidence`의 mask 규칙과 forbidOnly 규칙에 혼자 도는 거절 시험을 둔다. strict fixture 사용은 ESLint `no-restricted-imports`로 네 브라우저 폴더에서 본다(1112/03-03, 1112/03-04). - strict 검사를 `watchBrowserFailures`로 빼 fixture가 같은 context의 다른 탭도 보고, SW recovery의 손 사본을 지운다(1112/03-05). - RPC 스트림 시험 셋이 실제 1초를 자지 않는다(1101/10-07). - SW e2e 빌드 helper가 `fixture-builds.ts`의 `buildEditedCopies` 하나를 쓴다(0929/11-07). ## 고른 방법과 버린 대안 - 0929/11-02: (a) provider 증거 입력을 골랐다. (b) production·field 단계를 "provider 연결 전 기본 꺼짐"으로 바꾸는 안은 job 그래프(`config/ci/**`)를 바꾸는 일이라 하지 않았다. - 0929/13-03: 청크 이름 규약을 문서로만 적는 안 대신, 소스 파일로 찾게 했다. 세 사용처가 한 함수를 쓴다. - 1112/03-02: 미지원 엔진을 quarantine skip으로 두는 안은 버렸다. capability 증거 검사(`scripts/verify-browser-capability-evidence.ts`)가 skipped 노드를 거절해 증거 규칙(게이트 기준)을 낮춰야 하고, `docs/operations/ci-quality-gates.md`도 미지원 엔진은 skip하지 않고 명시적 UNSUPPORTED를 검증한다고 적는다. - 1112/03-04: 문자열 검사를 넓히는 안 대신 ESLint 구문 규칙으로 옮겼다(결함 패턴 G8의 통제). - 1112/03-05: 둘째 탭은 탭이 열릴 때 listener를 동기로 붙인다. preload 검사는 첫 page만 한다(늦게 붙인 route는 앞선 요청을 놓친다). SW recovery는 preload 검사를 하지 않는다: 같은 origin을 두 번 연 context라 WebKit이 회복된 load의 script를 캐시에서 주어 추적기의 route를 지나치고, 모든 preload가 미사용으로 읽혔다(desktop 실행에서 16건). ## 정한 기본값 - provider drill 증거의 유효 기간 7일, 시계 앞섬 허용 5분(`PROVIDER_EVIDENCE_MAX_AGE_MS`, `scripts/drill-runbook.ts`). 근거: drill 판정은 지금의 provider 상태를 말해야 하므로, 오래된 관찰은 받지 않는다. 7일은 잰 값이 아니라 정한 기본값이다. 배포가 잦은 제품은 줄일 수 있다. - 증거 파일 꼴 `providerDrillEvidenceSchema`(`scripts/contracts/release-artifacts.ts`). 항목 이름은 drill의 UNVERIFIED 줄이 적는 이름이다. - 사전 점검의 scope 탐침은 provider scope와 같은 인자에 RuntimeMax 5초, 점검 timeout 15초. - `HOSTING_BASE_URL`은 `/`로 끝나는 경로를 받는다(query·fragment 거절). - 브라우저 spec의 plain `test` 예외는 `tests/e2e/preload-use.spec.ts`, `tests/browser-capabilities/chunk-load-error.spec.ts` 둘. ## 위험과 영향 - 다운스트림이 따라 할 일(CHANGELOG 후보): - 새 브라우저 spec은 `tests/support/browser/strict-browser-test.ts`의 `test`만 import한다. `@playwright/test`의 `test`를 쓰던 spec은 lint에서 실패한다. - 같은 context에서 연 둘째 탭의 console·pageerror·requestfailed가 이제 시험 실패다. 일부러 낸 실패는 `allowedBrowserFailure`로 허용한다. - provider를 연결한 제품은 production drill 명령에 `--provider-evidence <파일>`을 넘겨야 그 단계가 닫힌다. - 하위 경로로 배포하면 `HOSTING_BASE_URL`에 그 경로(`https://…/app/`)를 준다. - `test:system` 사전 점검이 user manager·systemd-run을 실제로 써 본다. user manager가 없는 runner는 이제 사전 점검에서 실패한다(전에는 provider 시험에서 실패). - drill 증거에는 서명이 없다. production job에 증거 파일을 둘 수 있는 쪽이 PASS를 만들 수 있다. 신뢰 수준은 `--release-root` 입력과 같다. 서명이 필요하면 다른 provider 증거처럼 Ed25519로 묶는 후속이 필요하다(보안 렌즈 넘김). - w2-fe-2 PR #47과 겹치는 파일: `tests/support/browser/strict-browser-test.ts`(그쪽은 import 줄, 이쪽은 본문), `tests/e2e/preload-use.spec.ts`(그쪽은 import 줄, 이쪽은 끝의 describe 하나). 먼저 병합되는 쪽 뒤에 총괄이 갱신한다. - w2-fe-2에 넘김: production 게이트 drill 명령에 `--provider-evidence`를 넘길 자리(`config/ci/**`). - 그룹 A 경로 한 줄: `tests/visual/scrollbar-gutter.visual.spec.ts`의 디코더 탭 `getContext("2d", { willReadFrequently: true })`(둘째 탭 감시가 Chromium 경고를 잡아서). - 범위 밖에서 본 것(고치지 않음): `documentationReviewArtifactSchema`의 passed 판정식(`scripts/contracts/release-artifacts.ts:1603-1624`)에 documents system 검사가 없어, 그 검사만 실패하면 `verify:documentation`이 실패 이름 대신 ZodError로 멈춘다. ## 검증 기준: main `950ea11a` 위 12커밋, head `1b5a8c6f`. - desktop `scripts/verify.sh merge`(CI env, 로그 `/tmp/claude-gates/r9c-pr1-merge3/`, 시작 부하 21.58): FE-GATE-001~013·020 14개 모두 rc=0(005 273s, 008 320s, 013 320s — 시스템 컨테이너 안, 020 443s). - 앞 회차와 고친 것: 1회차(`r9c-pr1-merge`, ee95573f 기준) 005·020은 `tests/unit/security-followup.test.ts`(보관 검증기 소스 목록에 새 import 없음), 008은 `scrollbar-gutter.visual.spec.ts`의 디코더 탭 Chromium Canvas2D 경고(둘째 탭 감시가 새로 잡음 → `willReadFrequently`). 2회차는 목록에 새 파일을 더한 탓에 CI 계약 「immutable candidate archive member set drift」로 전 게이트가 시작 전에 멈춤 → `findRouteChunk`를 이미 목록에 있는 파일로 옮김. 3회차 GREEN. - 같은 1회차에서 desktop `scripts/verify.sh gate FE-GATE-029` rc=0(35s), `scripts/verify.sh script verify:documentation` rc=0. 그 뒤 바뀐 것은 검사기·문서가 아니다(route 청크 함수 위치, 시각 시험 한 줄, 목록 되돌림). - main `950ea11a`와 합친 트리(#47 Firefox 프로필): 노트북 감싸개 `~/.claude/bin/laptop-gate` — `check:types` rc=0 7s, `lint` rc=0 12s, `browser-spec-imports`·`test-evidence-source-rules` 12건 rc=0, 최대 부하 3.68, 로그 `~/laptop-gate-logs/r9c-pr1-merged-*`. 지금 main `7e5a0bb8`(#48)과 `git merge-tree` 충돌 없음. - RED·GREEN(desktop `scripts/verify.sh exec`): C1 시험 7파일 134건 GREEN, 고친 코드를 기준 커밋으로 되돌리면 새 시험이 실패(`r9c-c1-rg2`). 변이 — mask 블록 삭제·forbidOnly 호출 삭제·ESLint 규칙 삭제에서 해당 시험 1·1·5건 실패(`r9c-pr1b`). RPC 세 시험 고치기 전 1.027·1.059·1.056s → 고친 뒤 100 ms 아래. 둘째 탭 시험은 옛 fixture에서 세 엔진 모두 실패. OPFS spec 세 엔진 12건 통과, 이른 return을 단언으로만 바꾼 판에서는 WebKit 세 케이스 실패(`r9c-pr1c`). - 확인 못 한 것: runner merge job 셋(이 PR run에서 본다). 새 눈 확인 리뷰(고친 뒤 1회)는 아직이다 — r9-fe 마지막 확인 리뷰나 다음 세션이 한다. ## 리뷰어가 볼 곳 - `scripts/check-system-test-prerequisites.ts`, `scripts/lib/provider-cgroup.ts`: 시스템 컨테이너 안 root에서 user bus 환경(`XDG_RUNTIME_DIR`, `DBUS_SESSION_BUS_ADDRESS`)을 provider와 같이 쓴다. - `scripts/drill-runbook.ts` `judgeProviderEvidence`·`applyProviderEvidence`, record schema의 `providerEvidence`. - `tests/support/browser/strict-browser-test.ts`의 `page` fixture(다른 탭 감시). - `eslint.config.ts`의 browser spec 항목. ## 관련 - 리뷰: `docs/reviews/2026-11-round9-03-testing-qa.md`(T-02~T-05), `docs/reviews/2026-11-round9-08-guardrails-docs.md`(GD-03, GD-06), `docs/reviews/2026-11-round9-11-prior-findings-b.md` 3절. - 새 눈 리뷰 1회(fe-testing·fe-qa 렌즈): Low 3건(기본 import 미차단, forbidOnly 기본 목록 변이 생존, base-path 한쪽 판정) 모두 고침. ## 발견 ID 표 | ID | 판정 | 커밋 | |---|---|---| | 1112/08-03 | 고침 | eb7d89c7 | | 1112/08-06 | 고침 | aebb7c8c | | 0929/12-01 | 고침 | 923b29be | | 0929/11-02 | 고침 | 47a59572 | | 0929/13-03 | 고침 | 86b4a328 | | 1106/12-02 | 고침 | e657d00f | | 0929/13-06 | 고침 | 7922592c | | 1112/03-02 | 고침 | 1d7462b3 | | 1112/03-03 | 고침 | 34a7627d | | 1112/03-04 | 고침 | 34a7627d | | 1112/03-05 | 고침 | 1b5a8c6f | | 1101/10-07 | 고침 | f5e4e80e | | 0929/11-07 | 고침 | dec8a9db |
donghyeon.kang added 12 commits 2026-11-13 16:19:24 +00:00
문제: `test:system` 사전 점검은 system manager bus(`systemctl
show-environment`)와 실행 파일 셋만 보고 PASS를 냈다. provider 본 단계는
`/usr/bin/prlimit`·`/usr/bin/systemd-run`을 쓰고, user manager 버전(254
이상)을 묻고, `systemd-run --user --scope`로 cgroup 한도를 강제한다. 그래서
user bus가 없거나 버전이 낮거나 controller가 위임되지 않은 호스트는 PASS
뒤 provider 시험마다 `provider cgroup unavailable: ...`로 떨어졌다.

고친 것: 점검이 prlimit·systemd-run 실행 가능 여부를 보고, provider와
같은 인자(`USER_MANAGER_VERSION_ARGUMENTS`)로 user manager 버전을 묻고,
provider scope와 같은 속성·같은 cgroup 강제 확인으로 `/bin/true`를 한 번
띄운다. scope 인자와 최소 버전은 `scripts/lib/provider-cgroup.ts` 한
곳에 두고 provider와 점검이 같이 쓴다. system bus 점검은 provider가 쓰지
않아 user manager 점검으로 바꿨다. 위임 controller 값은 scope 안의 강제
확인(memory.max·pids.max·cpu.max)이 실제로 읽어 보므로 UNVERIFIED로 남길
몫이 없다.

위험·한계: 점검이 user scope 하나를 띄웠다 지운다(`--collect`, 5초
상한). 시스템 컨테이너 안(root)에서도 provider와 같은 호출이라 같은
결과를 낸다고 보고, FE-GATE-013으로 확인한다.

검증: desktop `scripts/verify.sh exec`로
`node scripts/run-vitest.ts run tests/unit/system-test-prerequisites.test.ts`
등 7파일 134건 통과. 점검 코드를 기준 커밋으로 되돌리면 새 시험 6건이
실패한다(RED).

Refs: 1112/08-03
문제: `verify:documentation`은 명령 머리가 corepack·pnpm·node 같은 낱말일
때만 인자 경로를 보았다. 이 repo 문서의 명령 대부분은
`scripts/verify.sh exec -- node <경로>`, `scripts/verify.sh script <이름>`,
`python3 scripts/…` 꼴이라, 그 안의 낡은 경로·없는 script 이름이 검사를
통과했다.

고친 것: `python3`를 명령 머리에 더하고, `scripts/verify.sh`는 그 자신을
경로로 보며 `exec --` 뒤를 다시 명령으로 읽고 `script` 뒤 낱말을 package
script 이름으로 대조한다. 자리표시자(`<이름>`)와 `--` 뒤 인자는 보지
않는다.

위험·한계: 살아 있는 문서 전부가 지금 이 검사를 통과하는지는 desktop
`verify:documentation`으로 확인한다.

검증: desktop `node scripts/run-vitest.ts run
tests/unit/documentation-readiness.test.ts` 24건 통과(새 시험 포함). 검사기를
기준 커밋으로 되돌리면 새 시험이 실패한다.

Refs: 1112/08-06
문제: fanout 검사의 실패 줄은 `FAIL <file>:<line> <call> inside
<context>`뿐이라, 제품 팀은 메시지만 보고 커서 runtime이나 검토 주석이라는
두 방법을 알 수 없었다. `// fanout-reviewed:` 주석으로 넘긴 호출 수도
출력하지 않았고, 허용 fixture는 bulk 읽기 하나였다(0929 결정 (가)를 하지
않았다).

고친 것: 실패 줄이 기능 `adapters/`의 `createCursorPaginationRuntime`과
같은 줄의 `// fanout-reviewed: <이유>`를 함께 적는다. 결과 줄과 fixture
줄이 검토된 예외의 수와 위치·이유를 적는다. 허용 fixture에 주석 달린 커서
루프를 더하고, fixture 실행은 그것이 예외로 세어져야 통과한다. 머리 주석과
`docs/operations/ci-quality-gates.md`에 미탐 범위를 적었다.

위험·한계: 휴리스틱 자체(receiver 이름)는 그대로다(1105의 재설계 (나)는
하지 않았다).

검증: desktop `node scripts/run-vitest.ts run
tests/architecture/request-fanout.test.ts` 통과. 검사기를 기준 커밋으로
되돌리면 새 시험 셋이 실패한다.

Refs: 0929/12-01
문제: provider 확인이 필요한 drill(FE-RB-002~005)은 입력이 runbook ID와
`--release-root`뿐이라 어떤 입력으로도 PASS가 될 수 없었다. 문서는
"provider 증거가 없으면 production 단계는 닫히지 않는다"고 했지만 증거를
넘길 길이 없었다.

고친 것: `--provider-evidence <파일>`을 받는다. 파일 꼴은
`providerDrillEvidenceSchema`(runbook ID, release ID, 관찰 시각, provider
run ID, 항목마다 PASS/FAIL과 근거)다. 같은 runbook·같은 release이고, 관찰이
7일 안이며 5분 넘게 앞서지 않고, 로컬 drill이 UNVERIFIED로 남긴 항목만
답한 증거만 받는다. 받은 증거는 그 항목의 UNVERIFIED만 바꾸고 로컬의
PASS·FAIL은 그대로 둔다. `provider verification` 항목도 증거가 답해야
한다. 받지 않은 증거는 이유와 함께 record의 `providerEvidence`에 남고,
record schema는 그 경우 PASS를 거절한다.

버린 대안: production·field 단계를 "provider 연결 전 기본 꺼짐"으로
문서화하는 (b)는 job 그래프(`config/ci/**`)를 바꾸는 일이라 하지 않았다.

위험·한계: 템플릿의 production 게이트 명령은 아직 이 인자를 넘기지
않는다. 증거 파일을 만들고 넘기는 자리는 provider를 연결한 제품 몫이다.
유효 기간 7일은 정한 기본값이다.

검증: desktop `node scripts/run-vitest.ts run tests/unit/runbook-drill.test.ts`
통과(유효 증거 PASS, FAIL 증거, 빠진 항목, 다른 release·runbook, 만료,
미래 시각, 로컬이 본 항목, 다른 꼴 거절, PASS를 주장하는 거절 record).

Refs: 0929/11-02
문제: build manifest 작성과 release 검사 둘은 route 청크를 Vite manifest
`entry.name === moduleId`로 찾았다. 청크 이름이 선언 없이 계약이 되어,
vite.config.ts가 route 청크에 이름을 붙이면(tech-log 방식) 빌드가 이유 없는
`Missing built route chunk: <routeId>`로 멈췄다.

고친 것: `scripts/lib/build-manifest-outputs.ts`의 `findRouteChunk` 하나가 dynamic
entry 중 소스 파일(manifest 키 또는 `src`) 이름이 route runtime의
`moduleId`인 것을 찾는다. 셋(build manifest, verify-release, local release
evidence)이 그것을 쓴다. 새 파일을 두지 않은 것은 release 후보
archive의 검증기 소스 목록(`config/ci/gates.json` member 집합)을 바꾸지
않기 위해서다. 못 찾으면 규칙("moduleId는 그 라우트가 import하는
페이지 파일 이름")을, 둘이면 두 소스 경로를 적는다.

위험·한계: moduleId가 페이지 파일 이름이라는 규약은 그대로다(생성기와
`route-runtime.tsx`가 이미 그렇게 쓴다).

검증: desktop `node scripts/run-vitest.ts run tests/unit/route-chunks.test.ts`
통과(다른 청크 이름, 없음, 중복, 계약 없음, 세 사용처).

Refs: 0929/13-03
문제: `RUN_OUTPUT_ROOT`가 다른 폴더를 가리키면 빌드는 그 아래에 쓰는데,
`verify-reproducible-build.ts`, `check-optional-recipes.ts`,
`check-app-build-input.ts --require-bundle`, `create-release-candidate.ts`는
checkout의 `dist/`·`artifacts/`를 읽고 스스로 거절하지 않았다. 게이트
안에서는 앞 단계가 거절해 거짓 PASS가 없었지만, 단독 실행은
`verify:reproducible-build`가 이전 빌드를 두 번 재서 `passed: true`를 쓸 수
있었다.

고친 것: 넷이 시작할 때 `checkoutBuildReadFailure`(check-bundle.ts와 같다)를
부르고 변수 이름·값을 적으며 exit 1. `check-optional-recipes.ts`는
`--dist-root`를 받았으면 그 폴더를 읽으므로 묻지 않는다.

검증: desktop `node scripts/run-vitest.ts run tests/unit/run-isolation.test.ts`
통과. 넷을 `RUN_OUTPUT_ROOT=.tmp/run-output-refusal`로 띄워 rc=1과 메시지를
본다(가장 긴 실행 499 ms). 기준 커밋에서는 넷 다 실패한다(RED).

Refs: 1106/12-02
문제: `HOSTING_BASE_URL`의 경로가 `/`가 아니면 probe가 거절해, 하위 경로
(`VITE_ROUTER_BASE_PATH=/app/`)로 배포한 release는 live 확인을 쓸 수
없었다. surface 경로(`/config.json`)도 늘 origin 루트로 풀었다.

고친 것: 기준 URL은 `/`로 끝나는 경로면 받는다(query·fragment는 거절).
`config/hosting/cache-policy.json`의 surface 경로는 기준 URL 아래로 푼다
(`surfaceUrl`). 진입 script는 index.html이 적은 그대로 요청한다. 후보의
진입 script가 기준 경로 아래에 있는지(`deployment base-path`)도 보아, 다른
경로로 빌드한 후보를 잘못된 기준 URL로 재면 실패한다.

검증: desktop `node scripts/run-vitest.ts run tests/unit/hosting-probe.test.ts`
46건 통과(`/app/` 기준 요청 경로, 경로 불일치 실패, URL 분류). 기준
커밋에서는 새 시험이 실패한다.

Refs: 0929/13-06
문제: RPC 스트림 시험 셋("cancels the physical stream exactly once after a
timeout", "refuses a second stream while the first has not confirmed
closure", "admits a second stream once waitClosed fulfils")은 시계를 넘기지
않아, 닫힘 확인이 없을 때의 1초 정리 상한을 runtime 기본 시계로 실제로
기다렸다(junit 1.03~1.06초). 같은 파일의 `cappedClock`은 다른 시험 넷에만
넘겼다.

고친 것: `cappedClock`(모든 대기를 30 ms로 자름)을 파일 위로 올리고 셋에도
넘긴다. 작업 마감 25 ms는 그 아래라 단언 뜻이 바뀌지 않는다.

검증: desktop junit에서 셋 모두 100 ms 아래. 고치기 전 파일은 같은 실행에서
1.027·1.059·1.056초.

Refs: 1101/10-07
문제: `tests/e2e/support/service-worker-builds.ts`가 checkout 복사, node
modules 연결, 빌드 실행(`run`), 한 번 치환(`replaceOnce`)을
`fixture-builds.ts`와 따로 가졌다. 한쪽을 고친 변경(로컬 빌드 env
1103/11-08, 복사 제외 목록 1105/12-04)을 두 번 해야 했다.

고친 것: `fixture-builds.ts`에 `buildEditedCopies` 하나를 두고(복사 →
`prepare` 한 번 → 빌드마다 `edit`·빌드·`dist-<name>`·`collect`),
`prepareFixtureBuilds`와 `prepareServiceWorkerBuilds`가 그것을 쓴다.
`replaceOnce`는 `editOnce`를 가리킨다. 준비 중 실패한 사본은 전처럼
`sharedFixtureBuild`가 지운다.

검증: desktop `tests/unit/e2e-build-helpers.test.ts` 통과, SW update·recovery
e2e와 fixture 빌드 e2e는 FE-GATE-008에서 본다.

Refs: 0929/11-07
문제: `check-test-evidence.ts`의 세 규칙에 혼자 도는 거절 시험이 없었다.
화면 전체 mask 규칙은 fixture만 있고 시험이 없었고, FE-GATE-029의 디렉터리
실행은 공통 접두어만 기대해 다른 fixture가 실패하면 통과했다. Playwright
설정의 forbidOnly 확인과 strict fixture 우회 확인은 전체 실행에서만 돌아
fixture로 시험할 수 없었다. strict fixture 확인은 `tests/e2e/*.spec.ts`
본문에 경로 글자가 있는지만 보아, 주석에만 적어도 통과했고 다른 브라우저
폴더 셋은 보지 않았다(1112/03-04).

고친 것:
- mask fixture 하나만 돌리는 시험을 더한다.
- forbidOnly 규칙이 시나리오 검사 밖의 모든 실행에서 돌고, 읽은 설정 목록을
  보고의 `facts.playwrightConfigs`에 남긴다. `--playwright-config <파일>`로
  다른 설정을 줄 수 있다. 거절 fixture(forbidOnly 없는 설정)와, 플래그가
  없으면 저장소 설정 전부를 읽는지 보는 시험을 더한다.
- strict fixture 확인은 ESLint `no-restricted-imports`로 옮긴다.
  `tests/{e2e,browser-capabilities,visual,storybook}/**/*.spec.ts`가
  `@playwright/test`의 `test`(이름·기본 import)나 strict fixture가 넓히는
  base test를 import하면 오류다. 일부러 plain test를 쓰는 둘
  (`preload-use.spec.ts`, `chunk-load-error.spec.ts`)만 예외다. 문자열 검사는
  지운다. 네 폴더 각각의 lint fixture를 시험이 lint한다.

위험·한계: w2-fe-2 PR #47이 두 예외 spec의 import를
`tests/support/browser/browser-test.ts`로 바꾼다. 그 경로의 `test`도 이
규칙이 막으므로 예외 둘은 그대로 필요하다.

검증: desktop 변이 셋 — mask 블록 삭제, forbidOnly 호출 삭제, ESLint 규칙
삭제 — 에서 각각 해당 시험이 실패하고(1·1·5건), 고친 코드에서 51건 통과.
`corepack pnpm lint` rc=0.

Refs: 1112/03-03, 1112/03-04
문제: OPFS 05-01 브라우저 시험 둘(다른 탭 purge가 진행 중 put을 기다림,
다른 탭 reconcile이 진행 중 put을 건너뜀)은 OPFS runtime을 설치하지 못하면
`return`으로 끝나 단언 0개로 통과했고, capability 증거는 "zero skipped"를
적었다. desktop 실행에서 Playwright의 WebKit이 바로 그 경우였다(세 케이스가
지원 판정 거절로 끝남). 같은 파일 첫 시험은 그 엔진에서 UNSUPPORTED를
단언한다.

고친 것: WebKit에서는 지원 판정이 거절함을 단언하고 끝낸다. 다른 엔진은
설치 성공을 단언한다. 그래서 chromium·firefox가 지원을 잃거나 WebKit이 지원을
얻으면 시험이 실패해 알린다.

버린 대안: 미지원 엔진을 quarantine skip으로 두는 안은 capability 증거
검사(`scripts/verify-browser-capability-evidence.ts`)가 skipped 노드를
거절해, 증거 규칙(게이트 기준)을 낮춰야 해서 하지 않았다. 문서
(`docs/operations/ci-quality-gates.md`)도 미지원 엔진은 skip하지 않고 명시적
UNSUPPORTED를 검증한다고 적는다.

검증: desktop `playwright test --config playwright.capabilities.config.ts
tests/browser-capabilities/opfs-runtime.spec.ts` 세 엔진 12건 통과. 이른
return을 단언으로 바꾸기만 한 판(실험 E-02)에서는 WebKit 세 케이스가
실패했다.

Refs: 1112/03-02
test(browser): strict 검사를 공용 watcher로 빼 같은 context의 다른 탭도 본다
frontend-quality-gates / merge / static checks (pull_request) Successful in 1m13s
frontend-quality-gates / merge / tests (pull_request) Failing after 11m34s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 5m32s
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
1b5a8c6f54
문제: strict fixture는 fixture의 `page` 하나에만 콘솔·pageerror·
requestfailed listener를 붙였다. 다른 탭을 여는 capability 시험 7곳
(cross-context invalidation, OPFS, IndexedDB)의 두 번째 탭은 아무도 보지
않았다. SW recovery 시험은 자기 context를 쓰며 fixture와 다른 손 사본
(WebKit 문구 무시 없음)으로 검사했다.

고친 것: 검사 본문을 `watchBrowserFailures(page, { preloads })`로 뺀다.
fixture는 자기 page(preload 검사 포함)와, 같은 context에서 열리는 모든 탭에
같은 함수를 붙인다(탭이 열릴 때 동기로 붙여 spec이 이동하기 전이다). SW
recovery는 회복된 load 전에 같은 함수를 붙인다. 손 사본은 지운다.
fixture의 기록을 읽는 `preload-use.spec.ts`에 둘째 탭의 console.error가
기록되는지 보는 시험을 더한다.

위험·한계: 둘째 탭의 preload 사용은 보지 않는다(첫 page만). SW recovery도
preload를 보지 않는다. 그 context는 같은 origin을 두 번 열어, WebKit이 회복된
load의 script를 캐시에서 주며 추적기의 route를 지나쳐 모든 preload가
미사용으로 읽혔다(16건).

검증: desktop — 옛 fixture에서 둘째 탭 시험이 세 엔진 모두 실패(RED),
고친 fixture에서 preload-use·SW recovery 통과, capability 세 spec은
FE-GATE-008에서 본다.

Refs: 1112/03-05
Some required checks failed
frontend-quality-gates / merge / static checks (pull_request) Successful in 1m13s
Required
Details
frontend-quality-gates / merge / tests (pull_request) Failing after 11m34s
Required
Details
frontend-quality-gates / merge / browser tests (pull_request) Successful in 5m32s
Required
Details
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
Some required checks were not successful.
You are not authorized to merge this pull request.
This branch is out-of-date with the base branch
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin refs/pull/55/head:donghyeon.kang/r9-c-checkers-tests
git checkout donghyeon.kang/r9-c-checkers-tests
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#55