fix(round9): 그룹 C 검사기 진단과 시험의 빈틈을 고친다 #55
Open
donghyeon.kang
wants to merge 12 commits from
donghyeon.kang/r9-c-checkers-tests AGit into main
pull from: donghyeon.kang/r9-c-checkers-tests
merge into: :main
:main
:fix/r9-structure-locale
:fix/r9-adapter-carryover
:test/shared-build-lock-order
:ci/dependency-cache-same-filesystem
:ci/release-tag-for-a11y-review
:ci/merge-dependency-cache
:fix/test-timeouts-measured
:fix/feature-residue-word-boundary
:fix/provider-wait-stderr
:fix/provider-job-host-requirements
:fix/ungated-vitest-spec
:fix/a11y-evidence-routes
:fix/verify-parts-diagnostics
:claude/w2-fe-ci-perf-dce080
:fix/child-process-test-timeouts
:chore/layout-rules-r2-r5
:claude/fe-b-docs-korean-645f55
:chore/ci-merge-jobs
:chore/layout-3-merge
:claude/fe-c-harness-0ae061
:chore/layout-2-sample-removal
:chore/layout-1-cleanup
:docs/review-guide-pointer
:fix/maturity-review-2026-11-06
:fix/maturity-review-2026-11-05-b
:docs/improvement-manual
:fix/maturity-review-2026-11-05
:fix/session-subject-required
:fix/ui-design-audit-2026-11-01
:fix/maturity-review-2026-09-25
:lane/D
:lane/B
:fix/src-review-round3
:refactor/domain-scalable
:develop
:feature-frontend-optional-adapter-recipes
:feature-frontend-supply-chain-verification
:feature-frontend-test-registry-evidence-hardening
:frontend-test-registry-evidence-hardening
:feature-frontend-diagnostics-telemetry-runtime
:feature-frontend-i18n-message-formatting-contract
:feature-frontend-design-system-platform
:feature-frontend-form-page-platform
:feature-frontend-reference-feature-vertical-slice
:feature-frontend-routing-release-recovery-runtime
:feature-frontend-http-query-contract-execution
:feature-frontend-application-boundary-runtime
:feature-frontend-typescript-tooling-foundation
:feature-frontend-platform-capability-review
:feature-frontend-performance-route-contract
:feature-frontend-starter-experience-quality-contract
:feature-frontend-responsive-theme-contract
:feature-frontend-ui-primitives-gallery-contract
:feature-frontend-app-shell-navigation-contract
:feature-frontend-runtime-composition-contract
:feature-frontend-ci-quality-gates-contract
:feature-web-vitals-performance-budget-contract
:feature-frontend-release-cache-rollback-contract
:feature-accessibility-baseline-contract
:feature-frontend-project-bootstrap-toolchain-contract
:feature-frontend-operational-runbook-contract
:feature-frontend-contract-compatibility-governance
:feature-frontend-contract-registry-governance
:feature-frontend-browser-security-boundary-contract
:feature-frontend-build-bundle-supply-chain-contract
:feature-tailwind-design-token-styling-contract
:feature-sample-feature-slice-contract-fixture
:feature-frontend-render-recovery-boundary-contract
:feature-routing-navigation-guard-contract
:feature-boundary-mapper-viewmodel-contract
:feature-async-ui-state-contract
:feature-frontend-observability-logging-trace-contract
:feature-frontend-storage-registry-contract
:feature-server-state-caching-contract
:feature-frontend-auth-session-integration-contract
:feature-frontend-error-classification-boundary-contract
:feature-runtime-schema-validation-contract
:feature-api-client-response-envelope-contract
:feature-frontend-env-runtime-config-contract
:feature-frontend-architecture-enforcement-lint-contract
:feature-frontend-test-taxonomy-contract
:feature-frontend-clean-architecture-layering-contract
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
donghyeon.kang (동현 강)
Clear assignees
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: donghyeon.kang/clean-architecture-frontend-template#55
Reference in New Issue
Block a user
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.
무엇을, 왜
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).createCursorPaginationRuntime,// fanout-reviewed:)을 적고, 결과 줄이 주석으로 넘긴 호출의 수와 위치를 적는다. 주석 달린 커서 루프 허용 fixture(0929/12-01).--provider-evidence <파일>을 받아, 같은 runbook·release·7일 안의 증거면 로컬에서 못 본 항목만 바꾼다. 모든 항목이 답을 얻고 FAIL이 없을 때만 PASS(0929/11-02).findRouteChunk,scripts/lib/build-manifest-outputs.ts), 못 찾으면 규칙을 적는다(0929/13-03). 새 파일을 두지 않은 것은 release 후보 archive의 검증기 소스 목록(config/ci/gates.jsonmember 집합)을 바꾸지 않기 위해서다.RUN_OUTPUT_ROOT가 다른 폴더면 checkout 빌드를 읽는 스크립트 넷이 스스로 거절한다(1106/12-02 남은 것)./로 끝나는 하위 경로 기준 URL을 받고 surface를 그 아래에서 요청한다. 후보가 그 경로로 빌드됐는지 양방향으로 본다(0929/13-06).return을 없앤다. 지원 엔진은 설치 성공을, Playwright WebKit은 지원 판정 거절을 단언한다(1112/03-02).check-test-evidence의 mask 규칙과 forbidOnly 규칙에 혼자 도는 거절 시험을 둔다. strict fixture 사용은 ESLintno-restricted-imports로 네 브라우저 폴더에서 본다(1112/03-03, 1112/03-04).watchBrowserFailures로 빼 fixture가 같은 context의 다른 탭도 보고, SW recovery의 손 사본을 지운다(1112/03-05).fixture-builds.ts의buildEditedCopies하나를 쓴다(0929/11-07).고른 방법과 버린 대안
config/ci/**)를 바꾸는 일이라 하지 않았다.scripts/verify-browser-capability-evidence.ts)가 skipped 노드를 거절해 증거 규칙(게이트 기준)을 낮춰야 하고,docs/operations/ci-quality-gates.md도 미지원 엔진은 skip하지 않고 명시적 UNSUPPORTED를 검증한다고 적는다.정한 기본값
PROVIDER_EVIDENCE_MAX_AGE_MS,scripts/drill-runbook.ts). 근거: drill 판정은 지금의 provider 상태를 말해야 하므로, 오래된 관찰은 받지 않는다. 7일은 잰 값이 아니라 정한 기본값이다. 배포가 잦은 제품은 줄일 수 있다.providerDrillEvidenceSchema(scripts/contracts/release-artifacts.ts). 항목 이름은 drill의 UNVERIFIED 줄이 적는 이름이다.HOSTING_BASE_URL은/로 끝나는 경로를 받는다(query·fragment 거절).test예외는tests/e2e/preload-use.spec.ts,tests/browser-capabilities/chunk-load-error.spec.ts둘.위험과 영향
tests/support/browser/strict-browser-test.ts의test만 import한다.@playwright/test의test를 쓰던 spec은 lint에서 실패한다.allowedBrowserFailure로 허용한다.--provider-evidence <파일>을 넘겨야 그 단계가 닫힌다.HOSTING_BASE_URL에 그 경로(https://…/app/)를 준다.test:system사전 점검이 user manager·systemd-run을 실제로 써 본다. user manager가 없는 runner는 이제 사전 점검에서 실패한다(전에는 provider 시험에서 실패).--release-root입력과 같다. 서명이 필요하면 다른 provider 증거처럼 Ed25519로 묶는 후속이 필요하다(보안 렌즈 넘김).tests/support/browser/strict-browser-test.ts(그쪽은 import 줄, 이쪽은 본문),tests/e2e/preload-use.spec.ts(그쪽은 import 줄, 이쪽은 끝의 describe 하나). 먼저 병합되는 쪽 뒤에 총괄이 갱신한다.--provider-evidence를 넘길 자리(config/ci/**).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커밋, head1b5a8c6f.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).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.scripts/verify.sh gate FE-GATE-029rc=0(35s),scripts/verify.sh script verify:documentationrc=0. 그 뒤 바뀐 것은 검사기·문서가 아니다(route 청크 함수 위치, 시각 시험 한 줄, 목록 되돌림).950ea11a와 합친 트리(#47 Firefox 프로필): 노트북 감싸개~/.claude/bin/laptop-gate—check:typesrc=0 7s,lintrc=0 12s,browser-spec-imports·test-evidence-source-rules12건 rc=0, 최대 부하 3.68, 로그~/laptop-gate-logs/r9c-pr1-merged-*. 지금 main7e5a0bb8(#48)과git merge-tree충돌 없음.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).리뷰어가 볼 곳
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.tsjudgeProviderEvidence·applyProviderEvidence, record schema의providerEvidence.tests/support/browser/strict-browser-test.ts의pagefixture(다른 탭 감시).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.md3절.발견 ID 표
eb7d89c7aebb7c8c923b29be47a5957286b4a328e657d00f7922592c1d7462b334a7627d34a7627d1b5a8c6ff5e4e80edec8a9db문제: 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문제: 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문제: `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문제: 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-05View command line instructions
Checkout
From your project repository, check out a new branch and test the changes.