frontend-quality-gates / merge / static checks (pull_request) Successful in 3m30s
frontend-quality-gates / merge / tests (pull_request) Failing after 14m48s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 9m28s
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 / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / checker self-tests (pull_request) Skipped
main 5250ff95 전체를 분야 렌즈 아홉(React, 구조·공통 계약, 시험·QA,
UX·디자인 시스템, 접근성, 성능·빌드, 보안, 가드레일·문서, 나머지
adapter)과 지난 발견 재판정 둘로 나눠 리뷰했다. 새 발견은 반박 검증을
거쳐 80건이다(High 0, P1 1: 1112/08-02 템플릿 시험의 고정 기능 ID).
지난 리뷰가 연 118행은 고쳐짐 33, 일부 35, 남음 46, 재발 2다.
리뷰 README 하나와 영역 기록 열다섯을 docs/reviews/2026-11-round9-*.md
파일 묶음으로 둔다. 영역 기록은 서브에이전트가 쓴 원문이고, 작업 폴더
절대 경로만 줄였다. 리뷰 중 코드는 고치지 않았다.
위험·한계: 실행 증거는 desktop에 CI env를 준 실행이다(실제 runner
미검증). 실험 X-GD02·X-GD02b와 수정 라운드는 README 16절에 이어 적는다.
결정이 필요한 12건(R9-D1~D12)은 권하는 안과 함께 7절에 있다.
검증: scripts/verify.sh docs(노트북) 통과. 게이트 실행 결과는 README
11.1절(merge 13/14 rc=0, FE-GATE-013은 호스트 제약 조건 충족,
documentation rc=0).
Refs: round9 확인 리뷰
34 KiB
34 KiB
round9 L3 — 시험(fe-testing·fe-qa) 전체 리뷰
round9 리뷰(2026-11-12, 대상 main
5250ff95)의 영역 기록이다. 서브에이전트가 쓴 원문을 그대로 옮겼다. 바꾼 것은 이 인용 블록과, 작업 폴더 절대 경로를(작업 폴더)로 줄인 것뿐이다. 발견 ID는 이 파일의 이름표(R-01 등)이고, 라운드 ID(1112/NN-MM)와의 대응은 README 15절이다.
대상: 5250ff95(tree 75cc3752, origin/main). 노트북 worktree에서 읽기만 했다. repo 파일은 고치지 않았다. desktop은 /tmp/claude-gates/r9fe-base/summary.txt만 읽었다.
0. 결론
- 판정: 고칠 것 있음. High 이상 0건. Medium 1건, Low 8건, 개선 제안 1묶음.
- 특별 확인 후보(W1의 preload 말): 템플릿에는 해당하지 않는다. 템플릿 fixture는 쓰이지 않은 preload를 세 엔진에서 직접 검사한다. WebKit 추정 경고는 문구 하나만 정확히 일치할 때 무시한다. 응답을 가로채는 CSP spec은
fulfillBuildScript를 쓴다. SW가 제어하는 문서는preloadunverifiable:service-worker:로 이름 붙여 실패시키고, 그 줄은 SW update spec에서만 허용한다. tech-log main(7a4e201a)에는preload-use.ts가 아예 없다. strict fixture도NO_COLOR만 무시한다. 그래서 W1의 말은 tech-log가 이 파일을 아직 옮기지 않은 상태(또는 tech-log의 다른 작업본)를 본 것으로 판단한다. 5절 첫 줄에 근거를 적었다. - 가장 큰 것: 감소된 움직임(reduced-motion) e2e가
body의animation-duration을 보는데, 허용 값에 초기값"0s"가 들어 있다. 그래서 규칙을 지워도 통과한다(T-01, Medium).
1. 범위
| 항목 | 내용 |
|---|---|
| 렌즈 | .claude/skills/fe-testing/SKILL.md(함정 12, 점검표), .claude/skills/fe-qa/SKILL.md(함정 10, 회귀 점검표). 더해서 시험 GWT(준비 조건·행동·기대 결과가 드러나는가). GWT 표기 규칙은 이 repo에 없다(docs/work/reference/testing.md 전체 확인). 그래서 렌즈와 testing.md가 요구하는 것을 어긴 것만 결함으로 봤고, 나머지는 개선 제안으로 건수와 대표 위치만 적었다 |
| 기준 문서 | docs/work/reference/testing.md 전체, docs/work/reference/defect-patterns.md 2절(T1~T10)과 G7·G9, docs/work/reference/review-criteria.md 2·3·5·8절, docs/work/reference/decisions.md, .claude/rules/tests.md, docs/testing/taxonomy.md |
| 바뀐 곳 먼저 | git diff --stat bbde570 5250ff95 -- tests vitest.config.ts 'playwright*.config.ts' config/testing config/ci/ungated-tests.json scripts/run-vitest.ts scripts/check-test-evidence.ts: 201파일, +5,615/−5,137. 참조 기능 시험 22파일 삭제(e3c8db48), 생성 기능 e2e 신설, 갤러리 시험을 Storybook으로 이동, 자식 프로세스 timeout 규칙(91962e24) |
| 전부 읽음 | tests/support/browser/preload-use.ts, strict-browser-test.ts, tests/e2e/preload-use.spec.ts, production-csp.spec.ts, service-worker-update.spec.ts, service-worker-recovery.spec.ts, boot-module-failure.spec.ts, old-tab-chunk-recovery.spec.ts, generated-feature.spec.ts, accessibility.spec.ts, scroll-restoration.spec.ts, typography.spec.ts, theme.spec.ts, tests/storybook/galleries.spec.ts, tests/visual/platform.visual.spec.ts, tests/browser-capabilities/chunk-load-error.spec.ts, tests/e2e/support/fixture-builds.ts, service-worker-builds.ts(1~120), vitest.config.ts, tests/setup.ts, tests/helpers/child-process-timeout.ts, tests/unit/child-process-timeout.test.ts, scripts/run-vitest.ts, scripts/check-test-evidence.ts, scripts/lib/no-skipped-tests-reporter.ts, scripts/lib/ungated-tests.ts, config/ci/ungated-tests.json, tests/unit/test-evidence-source-rules.test.ts, tests/mocks/server.ts, Playwright 설정 5개 중 e2e·capabilities·storybook |
| 부분 읽음 | tests/component/application-mutation-admission.test.tsx(diff), tests/integration/provider-guardian-transaction.test.ts(77c01b03 diff), tests/browser-capabilities/opfs-runtime.spec.ts(1cross-context-invalidation.spec.ts(155indexeddb-runtime.spec.ts(925image-cdn.spec.ts(100storage-manager.spec.ts, browser-files.spec.ts(450tests/unit/deletable-history-documents.test.ts(1a11y-report.test.ts(이름), runtime-adapters-auth-profile.test.ts(360scripts/scale/run-scale-profile.ts, scripts/scale/measure-feature-shape-growth.ts(280scripts/test-feature-scaffold.ts(60scripts/lib/build-environment.ts, src/adapters/http/backend-envelope.ts(170docs/web/http-contract.md 4절·docs/registries/error-codes.yaml |
| fe-testing 기준으로 본 것 | 층 배치(바뀐 파일), MSW strict(onUnhandledRequest: "error" 4곳, vi.fn() fetcher는 "보내지 않음" 단언용만), 흔들림(실제 시계 대기, 고정 대기), 거짓 통과(이른 return, 초기값 허용, 허용 패턴 범위), 검출력(변이 예측), 검사기의 음성 fixture, 게이트 연결(ungated 6건 사유, 스크립트 경로 대조 377파일), timeout 규칙 |
| fe-qa 기준으로 본 것 | 로딩 화면 대신 라우트 h1을 기다리는가, 템플릿 원래 상태 밖(생성 기능 빌드) 시험, 실패·결과 불명·재전송 흐름, 두 탭, 콘솔 오류 처리(strict fixture 우회 지점), MSW·대역 응답이 짝 백엔드와 같은가 |
| 게이트 실행 결과(읽기만) | summary.txt: tree가 HEAD와 같다. FE-GATE-001~012 rc=0(008 201 s, 009 32 s), FE-GATE-013 rc=1(D8 판정 대상, 이 렌즈 몫 아님), FE-GATE-020 진행 중. 게이트 로그는 PASS 한 줄뿐이고 snapshot/이 아직 없다 |
| 확인 못 한 것 | (1) e2e·capability의 엔진별 통과·skip 수: snapshot 없음. (2) OPFS 05-01 시험이 어느 엔진에서 이른 return 하는지: 실행해야 안다(E-02). (3) 참조 기능 시험 약 3,000줄이 지키던 플랫폼 동작이 모두 옮겨졌는지 전수 대조하지 않았다. 표본 9개(sign-out 판정, intent 비노출, 중복 제거, fan-out, retry 겹침 등)는 대응 시험이 있다. (4) FE-GATE-029(check:ci:gating)는 main 단계라 이번 실행에 없다(E-05). (5) tests/unit 대부분과 tests/component·tests/integration의 바뀌지 않은 파일은 표본만 봤다 |
2. 발견
T-01 감소된 움직임 e2e가 규칙을 지워도 통과한다
| 칸 | 내용 |
|---|---|
| 성격 | 확인된 결함(거짓 통과, 코드로 확정. 실행 확인은 E-01) |
| 관련 관점 | 10, 21, 5 |
| 심각도·우선순위 | Medium · P2. 이 정책을 지키는 시험은 이것 하나다. 라우트 수동 검토 문서가 이 시험을 자동 증거로 적는다. 지금 규칙은 있어서 사용자 피해는 없다 |
| 통제 | 규칙 「동작 줄이기 설정이면 꼭 필요하지 않은 움직임을 멈춘다」: 목표 M3 / 확인 M2(CSS 규칙은 있다, 자동 검사는 효과 없음) |
| 증거 | E1 |
| 근거 | tests/e2e/accessibility.spec.ts:130-137이 body의 getComputedStyle(body).animationDuration을 읽고 ["0s", "0.00001s", "1e-05s"] 안에 있으면 통과다. body에는 animation이 없다. 앱의 animation은 .ui-spinner 하나다(src/presentation/styles/theme/primitives.css:108-117, ui-spin … infinite). 규칙(src/presentation/styles/theme/responsive.css:86-95)이 없으면 body의 값은 초기값 "0s"이고, 이 값이 허용 목록에 있다. 다른 검사도 없다(git grep -i "reduced-motion|reducedMotion|prefers-reduced" -- tests scripts eslint.config.ts config .storybook: 이 시험 하나). docs/accessibility/route-reviews/APP_HOME.md:18은 "Automated … reduced-motion evidence is available"이라 적는다 |
| 발생 조건 | 누가 responsive.css의 미디어 블록을 지우거나 * 선택자를 좁히거나, 새 animation이 !important 규칙 밖에 생길 때 |
| 영향 | 전정 장애 사용자에게 움직임이 그대로 나가도 FE-GATE-008·009가 통과한다. 수동 검토(M7)는 아직 pending이라 뒤를 받치지 못한다 |
| 최소 개선 방향 | 움직이는 실제 요소를 본다. 같은 시험에서 스피너가 있는 화면(또는 페이지에 .ui-spinner를 하나 붙여)을 열고, 감소 설정 없을 때 animation-iteration-count가 infinite임을 먼저 단언한 뒤(전제), 감소 설정에서 1이고 duration이 0.01ms 이하임을 단언한다. 허용 목록에서 초기값 "0s"를 뺀다 |
| 완료 기준 | responsive.css:86-95를 지우는 변이에서 이 시험이 세 엔진 모두 실패한다. 변이 없이 세 엔진 통과 |
| RED 시험 아이디어 | 위 "전제 + 감소" 두 단언 시험. 지금 코드에서는 통과(규칙 있음), 변이를 넣으면 실패. 지금 시험은 변이에서도 통과(E-01로 확인) |
T-02 OPFS 05-01 브라우저 시험이 OPFS를 못 쓰면 단언 없이 통과하고, 증거는 "zero skipped"라 적는다
| 칸 | 내용 |
|---|---|
| 성격 | 구조적 위험(코드 모양은 확인) + 미검증(지금 그렇게 끝나는 엔진이 있는지) |
| 관련 관점 | 10, 21, 5 |
| 심각도·우선순위 | Low · P2. E-02에서 한 엔진이라도 이른 return이면 Medium · P1로 올린다(증거 검사가 틀린 답을 낸다, review-criteria.md 3절) |
| 통제 | 「skip은 quarantine으로만」: M3(check-test-evidence.ts)지만 return은 skip으로 세지 않아 이 자리에는 M1 |
| 증거 | E1 |
| 근거 | tests/browser-capabilities/opfs-runtime.spec.ts:352와 :470이 if (!(await installOpfsTab(page, scope))) return;이다. installOpfsTab은 지원 판정이 거절이면 false를 낸다(:252). 그때 두 시험(3 케이스)은 단언 0개로 passed가 된다. 같은 파일 첫 시험은 미지원이면 UNSUPPORTED를 단언한다(:186-191). 증거 검사는 junit의 <skipped>만 보고 "zero skipped"를 찍는다(scripts/verify-browser-capability-evidence.ts:61-62, :72). 1105 리뷰는 WebKit이 기본 정책에서 거절돼 spec이 일찍 끝난다고 적었고(docs/reviews/2026-11-05-maturity-review/05-adapters-storage-kernel.md:164), 1106 리뷰는 실행 시간으로 보아 돈 것 같다고 추론만 했다(docs/reviews/2026-11-06-maturity-review/11-tests-browser-release-scale.md:203). 두 라운드 연속 「확인 못 한 것」으로 넘어왔다 |
| 발생 조건 | OPFS 지원 판정(inspectBrowserOpfsSupport, src/adapters/storage/opfs/browser-opfs-runtime.ts:151-180)이 거절하는 엔진·버전 |
| 영향 | 그 엔진에서 "다른 탭 purge가 진행 중 put을 기다린다"(1103/05-01 수정)를 아무도 보지 않는데 증거는 세 엔진 통과로 남는다 |
| 최소 개선 방향 | 이른 return 대신, 지원해야 하는 엔진에서는 expect(await installOpfsTab(...)).toBe(true)로 단언한다. 지원하지 않는 엔진이 정말 있으면 test.skip(<엔진 조건>, 이유) + quarantine 주석으로 이름을 남긴다(그러면 증거 검사가 skip으로 센다) |
| 완료 기준 | 두 자리에 조용한 return이 없다. E-02 패치(그 자리에서 실패시키기)에서 세 엔진 결과가 기록되고, 미지원 엔진은 skip으로 증거에 나타난다 |
| RED 시험 아이디어 | E-02의 패치 그대로. 미지원 엔진이 있으면 지금 그 엔진에서 실패한다 |
T-03 check-test-evidence.ts의 규칙 셋에 혼자 도는 거절 fixture가 없다
| 칸 | 내용 |
|---|---|
| 성격 | 확인된 결함(검사기 자기 보호 없음, 결함 패턴 G9) |
| 관련 관점 | 21, 10 |
| 심각도·우선순위 | Low · P2. FE-GATE-008이 돌리는 시험 품질 검사의 일부가 꺼져도 아무 게이트도 모른다 |
| 통제 | M1(규칙은 있고, 규칙을 지키는 시험은 없음) |
| 증거 | E1 |
| 근거 | (1) 화면 전체 mask 규칙(scripts/check-test-evidence.ts:307-311): fixture tests/fixtures/test-evidence/forbidden/full-screen-mask.fixture가 있지만, 혼자 돌리는 시험이 없다. tests/unit/test-evidence-source-rules.test.ts:31-32 주석은 "Each forbidden fixture is checked alone"이라 적지만 시험은 셋(focused·expired·unowned, :34-50)뿐이다. 디렉터리 전체를 돌리는 FE-GATE-029 명령은 기대 진단이 공통 접두어 "Test evidence failed:"(config/ci/gates.json:118 행)라, 다른 fixture 셋이 계속 실패하면 통과한다. (2) strict fixture 우회 규칙(:391-399)과 (3) Playwright 설정의 forbidOnly 확인(:385-389)은 if (!fixtureMode && !scenarioOnly)(:368) 안에 있어 fixture 모드에서 아예 돌지 않는다. 이 두 문구를 찾는 시험도 없다(git grep -n "bypasses strict browser fixture|missing forbidOnly" -- tests: 0건) |
| 발생 조건 | 셋 중 한 규칙을 지우거나 정규식을 좁히는 변경 |
| 영향 | 화면 전체를 가린 시각 시험, strict fixture를 우회한 e2e spec이 FE-GATE-008을 통과한다 |
| 최소 개선 방향 | test-evidence-source-rules.test.ts에 mask fixture 하나만 돌리는 시험을 더한다. e2e 규칙 둘은 검사 대상 폴더·설정을 인자로 받게 하고(--e2e-root, --playwright-config), 우회 spec 하나와 forbidOnly 없는 설정 하나를 거절 fixture로 둔다 |
| 완료 기준 | 세 규칙 각각을 지우는 변이에서 시험이 하나씩 실패한다 |
| RED 시험 아이디어 | "rejects a screenshot mask over the whole UI": mask fixture 단독 실행이 rc=1과 screenshot mask may not cover the whole UI를 낸다. 지금은 시험이 없어서 E-03 변이(:309-311 삭제)가 살아남는다 |
T-04 strict fixture 강제가 tests/e2e의 문자열 포함 검사뿐이다
| 칸 | 내용 |
|---|---|
| 성격 | 구조적 위험(결함 패턴 G8) |
| 관련 관점 | 21, 23 |
| 심각도·우선순위 | Low · P3. 지금 우회하는 spec은 chunk-load-error.spec.ts 하나이고 이유가 있다 |
| 통제 | M3(e2e 폴더, 문자열) / M1(나머지 브라우저 폴더) |
| 증거 | E1 |
| 근거 | scripts/check-test-evidence.ts:391-399는 tests/e2e/*.spec.ts의 본문에 "support/browser/strict-browser-test" 글자가 있는지만 본다. 주석에 그 경로만 적어도 통과하고, 한 파일에서 맨 test를 섞어 써도 통과한다(tests/e2e/preload-use.spec.ts:4, :111, :122는 의도한 혼용). tests/browser-capabilities·tests/visual·tests/storybook은 검사하지 않는다. tests/browser-capabilities/chunk-load-error.spec.ts:1이 맨 @playwright/test를 쓴다(지난 리뷰가 이유를 받아들였다) |
| 발생 조건 | 새 capability·visual spec이 맨 test를 쓰거나, e2e spec이 주석에만 경로를 남길 때 |
| 영향 | 그 spec에서 콘솔 오류·pageerror·preload 검사가 조용히 빠진다(fe-qa 함정 9) |
| 최소 개선 방향 | ESLint no-restricted-imports로 tests/{e2e,browser-capabilities,visual,storybook}/**/*.spec.ts에서 @playwright/test의 값 test import를 막고, 의도한 파일 둘(preload-use.spec.ts, chunk-load-error.spec.ts)만 이유를 단 예외로 둔다. 문자열 검사는 지운다 |
| 완료 기준 | 맨 test를 쓰는 새 spec이 네 폴더 어디서든 lint에서 실패한다. 거절 fixture가 있다 |
| RED 시험 아이디어 | tests/fixtures/architecture 방식의 lint fixture: capability 폴더 spec 하나가 import { test } from "@playwright/test" → 지금은 아무 게이트도 실패하지 않음 |
T-05 두 번째 탭과 자기 context는 strict 검사 밖이다
| 칸 | 내용 |
|---|---|
| 성격 | 구조적 위험 |
| 관련 관점 | 10, 12 |
| 심각도·우선순위 | Low · P3 |
| 통제 | M2(첫 page만) |
| 증거 | E1 |
| 근거 | strict fixture는 fixture의 page 하나에만 listener와 preload 추적을 붙인다(tests/support/browser/strict-browser-test.ts:68-96). 앱을 여는 두 번째 탭 7곳은 콘솔 오류·pageerror·requestfailed를 아무도 보지 않는다: cross-context-invalidation.spec.ts:163, :226, opfs-runtime.spec.ts:341, :459, indexeddb-runtime.spec.ts:933, :985, :1190. tests/e2e/service-worker-recovery.spec.ts:94-150은 고장 단계 때문에 자기 context를 쓰고 회복된 load만 손으로 검사한다. 그 검사는 preload 검사가 없고, WebKit 문구 무시도 없어 fixture와 갈라진 사본이다(:135-150). 회복된 문서는 SW 제어가 없다고 단언하므로(:147-149) trackPreloadUse를 붙일 수 있다 |
| 발생 조건 | 두 탭 경쟁 시험에서 두 번째 탭이 오류를 내는 회귀(fe-qa 함정 8의 자리) |
| 영향 | 두 탭 시나리오의 회귀가 첫 탭의 단언만으로 통과한다 |
| 최소 개선 방향 | strict 검사 본문을 watchBrowserFailures(page) 함수로 빼서 fixture와 두 번째 탭이 같이 쓰게 한다(같은 판정 judge). SW recovery는 마지막 goto 전에 그 함수와 trackPreloadUse를 붙인다 |
| 완료 기준 | 두 번째 탭에서 console.error를 내는 변이에서 그 시험이 실패한다. 손으로 쓴 검사 사본이 없다 |
| RED 시험 아이디어 | cross-context-invalidation.spec.ts의 두 번째 탭에서 secondPage.evaluate(() => console.error("probe")) → 지금은 통과 |
T-06 old-tab 시험의 preload 허용 절반이 닿지 않는 문서를 가리키고, 주석이 fixture 동작과 다르다
| 칸 | 내용 |
|---|---|
| 성격 | 구조적 위험(허용이 일으킨 실패보다 넓다) |
| 관련 관점 | 10, 9 |
| 심각도·우선순위 | Low · P3 |
| 통제 | M2 |
| 증거 | E1 |
| 근거 | 허용 정규식이 "A 탭에서 A 플랫폼 화면과 함께 preload된 청크"를 preloadunused: 허용에 넣는다(tests/e2e/old-tab-chunk-recovery.spec.ts:181-188 주석, :195). 그러나 preload 검사는 끝에 열려 있는 문서만 본다(tests/support/browser/preload-use.ts:34-35, :217). A 탭은 reload로 B 문서가 된다(:241 loads === 1). 그래서 A 목록은 A 문서에 쓰일 일이 없고, B 문서에 같은 이름(공유 청크)으로 나타나는 "정말 안 쓴 preload"만 가릴 수 있다 |
| 발생 조건 | B 문서에서 공유 청크 preload가 실행되지 않는 회귀 |
| 영향 | 그 회귀를 이 시험이 놓친다. 지금 가린 실패는 없다(추론) |
| 최소 개선 방향 | A 목록을 지우고 B context routes 모듈 목록만 남긴다. 주석을 "B 탭의 것만"으로 고친다 |
| 완료 기준 | E-04에서 A 목록 없이 세 엔진 반복 통과 |
| RED 시험 아이디어 | 해당 없음(허용 축소). 축소 뒤 통과가 근거다 |
T-07 [w2-fe-2 파일] ungated-tests.json의 사유가 파일에 맞지 않는다 — 특히 순수 parser 시험
| 칸 | 내용 |
|---|---|
| 성격 | 확인된 결함(기준을 낮춘 예외의 사유가 사실과 다름). 0929부터 ID 없이 이월된 항목이고, 지금도 같다 |
| 관련 관점 | 21, 10, 26 |
| 심각도·우선순위 | Low · P3 |
| 통제 | M3(check:ci:gating이 목록에 없는 파일은 잡는다) / 사유 내용은 M0 |
| 증거 | E1 |
| 근거 | 6건 모두 같은 사유("baseline-regression이 기록한 CPU에서만 시간을 비교")다(config/ci/ungated-tests.json). 이 사유는 tier를 CI에서 안 도는 이유이지, 파일을 게이트에서 빼는 이유가 아니다. tests/scale/tsc-diagnostics-parser.test.ts(:25)는 문자열을 parse하는 순수 시험이다(tests/scale/tsc-diagnostics-parser.test.ts:8-45). 그 parser는 merge 게이트가 돌리는 측정이 쓴다(scripts/scale/measure-feature-shape-growth.ts:307, FE-GATE-020의 scripts/test-feature-scaffold.ts:76-80). 나머지 다섯도 개수·상한·가짜 시계를 단언한다(tests/scale/session/long-session.test.ts:75, :149-150, network-flap.test.ts:88, telemetry-storm.test.ts:79-84). 1103 리뷰의 변이 H57을 잡은 시험은 long-session.test.ts 하나였다(docs/reviews/2026-11-03-maturity-review/10-tests-fast-layers.md:138) |
| 발생 조건 | parser나 세션·telemetry 상한을 깨는 변경 |
| 영향 | merge 게이트 측정이 쓰는 parser의 오해석, 세션 정리 회귀를 merge에서 못 본다 |
| 최소 개선 방향 | tsc-diagnostics-parser.test.ts를 게이트 경로(예: tests/unit 또는 test:coverage 목록)로 옮기고 항목을 지운다(ungatedTestFailures가 남은 항목을 stale로 잡는다, scripts/lib/ungated-tests.ts:104-106). 나머지 다섯은 파일마다 실제 사유(실행 시간, 자식 프로세스 등)를 적거나 pr tier로 옮긴다. 결정이 필요하면 decisions.md 3절 형식으로 남긴다 |
| 완료 기준 | 남은 항목마다 그 파일에 맞는 사유가 있다. parser 시험이 merge 게이트에서 돈다 |
| RED 시험 아이디어 | parser의 M 단위 변환(collect-tsc-diagnostics.ts value * 1024)을 바꾸는 변이 → 지금 merge 게이트 어디서도 실패하지 않음. 옮긴 뒤 FE-GATE-005에서 실패 |
T-08 [w2-fe-2 관련: 시험 timeout] 새 timeout 규칙 밖에 손으로 정한 숫자 54곳과 옛 상수 4벌이 남았고, taxonomy가 옛 방식을 예로 든다
| 칸 | 내용 |
|---|---|
| 성격 | 확인된 결함(문서와 코드가 다름, 갈라진 사본) |
| 관련 관점 | 9, 23, 10 |
| 심각도·우선순위 | Low · P3 |
| 통제 | M3(기본 timeout + 자식 프로세스는 tests/setup.ts가 막음) / 숫자의 근거는 M1 |
| 증거 | E1 |
| 근거 | docs/work/reference/testing.md 2절은 "값은 desktop에서 잰 가장 긴 실행으로 정한다: childProcessTimeout(<ms>)"라 적는다. 91962e24 본문은 "시험마다 손으로 정한 숫자"를 근거가 없다고 버렸다. 그러나 기본값이 아니라서 가드에 걸리지 않는 손 숫자가 54곳 남았다(git grep -nE "\}, [0-9]{2,3}_000\);|\{ timeout: [0-9]{2,3}_000 \}" -- 'tests/**/*.test.ts' 'tests/**/*.test.tsx', 예: tests/unit/test-evidence-source-rules.test.ts:38, tests/system/ci-runner/ci-artifact-contract.test.ts 16곳). PROCESS_HEAVY_TIMEOUT_MS = 30_000이 네 파일에 따로 있다(tests/unit/risk-coverage.test.ts:34, tests/unit/security-followup-fixture.ts:26, tests/integration/provider-guardian-transaction.test.ts:28, tests/system/ci-runner/ci-artifact-contract.test.ts:65). docs/testing/taxonomy.md:104-106은 여전히 PROCESS_HEAVY_TIMEOUT_MS를 예로 든다 |
| 발생 조건 | 새 시험 작성자가 taxonomy를 따라 상수를 복사할 때 |
| 영향 | 같은 문제(부하 desktop의 자식 프로세스 시험)에 두 규칙이 있고, 한쪽은 근거가 남지 않는다 |
| 최소 개선 방향 | 54곳과 상수 4벌을 childProcessTimeout(<잰 ms>)로 바꾸거나, 이미 잰 값이면 그 값을 인자로 적는다. taxonomy 예시를 helper로 고친다 |
| 완료 기준 | 자식 프로세스 시험의 timeout이 모두 helper를 거친다. taxonomy와 testing.md가 같은 방법을 적는다 |
| RED 시험 아이디어 | 해당 없음(규칙 통일). 원하면 tests/setup.ts 가드를 "helper가 만든 값이 아닌 timeout"까지 넓히는 시험 |
T-09 생성 기능 e2e의 오류 응답이 "짝 백엔드의 Envelope"라는 주석과 다르다
| 칸 | 내용 |
|---|---|
| 성격 | 구조적 위험(대역이 실제 상대와 다름, 결함 패턴 T6). 지금은 판정이 status로만 정해져 결과가 같다 |
| 관련 관점 | 17, 10 |
| 심각도·우선순위 | Low · P3 |
| 통제 | M1 |
| 증거 | E1 |
| 근거 | 주석: "The API answers are the paired backend's Envelope"(tests/e2e/generated-feature.spec.ts:26-27). 429 답은 code: "RATE_LIMITED", category: "SYSTEM"(:62-68, :246)이다. 짝 백엔드는 RATE_LIMIT_EXCEEDED, category: RATE_LIMIT, Retry-After다(백엔드 docs/registries/error-codes.yaml:371-375, docs/web/runbook.md:8). 500 답은 INTERNAL_ERROR + SYSTEM(:284)인데 백엔드는 category: INTERNAL이다(error-codes.yaml:835-838). 프론트의 429 판정은 status로만 한다(src/contracts/errors.ts:326, src/adapters/http/http-execution-v3.ts:1300-1309). 쓰기 전 거절 표는 code로 본다(src/adapters/http/backend-envelope.ts:168-193) |
| 발생 조건 | 프론트가 429·500의 code나 category를 읽게 되는 변경(예: 429 code별 안내) |
| 영향 | 브라우저 흐름이 존재하지 않는 code로 통과한다 |
| 최소 개선 방향 | failure() 두 호출을 백엔드 표의 code·category로 바꾼다. 가능하면 config/contracts/의 짝 계약 사본에서 읽는다 |
| 완료 기준 | e2e의 오류 Envelope가 짝 백엔드 registry 행과 같다 |
| RED 시험 아이디어 | 해당 없음(대역 교정) |
T-10 @a11y 브라우저 시험을 merge가 두 번 돈다
| 칸 | 내용 |
|---|---|
| 성격 | 개선 제안(실행 비용). 1101/10-06(빠른 층, 결정 대기)과 같은 모양의 브라우저 층 자리 |
| 관련 관점 | 14, 20 |
| 심각도·우선순위 | Low · P3 |
| 통제 | 해당 없음 |
| 증거 | E1 + 이번 실행 시간(FE-GATE-009 32 s, desktop, summary.txt) |
| 근거 | FE-GATE-008의 test:e2e는 playwright test 전체다(package.json:43). FE-GATE-009의 test:a11y는 --grep @a11y를 다시 돈다(package.json:58). @a11y 시험은 tests/e2e/accessibility.spec.ts와 tests/e2e/generated-feature.spec.ts:351-370이다. 009는 webServer 빌드를 한 번 더 하고, 생성 기능 spec의 beforeAll 사본 빌드도 다시 돈다. docs/work/reference/testing.md 6절은 "merge 단계가 같은 파일을 두 번 돌리지 않는지 본다"고 적는다 |
| 최소 개선 방향 | test:e2e에 --grep-invert @a11y를 주고 접근성은 009 하나에서만 센다. 또는 두 번 도는 이유를 1101/10-06 결정에 같이 적는다 |
| 완료 기준 | 한 merge에서 @a11y 시험이 엔진마다 한 번 돈다 |
| RED 시험 아이디어 | 해당 없음 |
개선 제안 묶음 (GWT와 작은 것)
| 무엇 | 건수 | 대표 위치 |
|---|---|---|
| 이름이 본문에 없는 동작을 말한다 | 1 | tests/storybook/galleries.spec.ts:74 "duplicate toast" — 토스트를 한 번만 띄운다. 중복 처리는 tests/component/design-system-platform.test.tsx:216이 본다 |
| 한 시험이 독립된 행동 여럿을 섞어 실패 위치가 흐리다 | e2e·capability 7곳 이상 | tests/e2e/theme.spec.ts:4(axe 스캔 + 저장 유지), tests/storybook/galleries.spec.ts:74(메뉴·토스트·탭), tests/browser-capabilities/indexeddb-runtime.spec.ts:256, opfs-runtime.spec.ts:3, public-cache-storage.spec.ts:3, browser-files.spec.ts:14 |
| 이름에 여러 경우를 쉼표·and/or로 나열(한 시험에 여러 입력) | Vitest·Playwright 이름 137개(전체 it/test 약 2,820 + e2e 56 중, 휴리스틱) |
tests/unit/docs-system.test.ts:181, tests/unit/repository-layout.test.ts:59. it.each로 나누면 실패한 경우가 이름에 나온다 |
| 부재 단언을 고정 대기로 한다(신호 없음) | 5 | tests/e2e/app-shell.spec.ts:65(300 ms), tests/browser-capabilities/cross-context-invalidation.spec.ts:201, :270(100 ms), opfs-runtime.spec.ts:413, :512(250 ms). 부하에서 늦게 온 사건은 통과 쪽으로 빠진다. 뒤에 보낸 표지 메시지를 기다린 뒤 "앞 메시지가 없다"를 단언하는 식으로 바꾼다 |
| 콘솔 warning 무시가 부분 문자열이다 | 1 | tests/support/browser/strict-browser-test.ts:22 includes("NO_COLOR"). 출처 주석이 없다. WebKit 문구처럼 정확 일치로 좁히거나 출처를 적는다 |
3. 넘길 것
- → fe-a11y: T-01에서 "꼭 필요하지 않은 움직임"의 범위(스피너는 멈춰야 하나, 회전만 줄이나)와 M7 수동 기록 문구(
docs/accessibility/route-reviews/APP_HOME.md:18)가 맞는지. 시험 검출력은 이 렌즈 몫, 정책 내용은 그쪽 몫이다. - → fe-structure(또는 게이트 담당): T-04의 ESLint 규칙 범위와 예외 두 파일.
- → 총괄(게이트 결정): T-07의 남은 다섯 scale 파일을 pr tier로 옮길지, 사유만 고칠지. T-10은 1101/10-06 결정 대기에 같이 붙일지.
- → 백엔드 repo 세션(총괄 경유): 해당 없음. T-09는 백엔드 registry를 읽기만 했고 프론트 쪽 교정이다.
- → 결정 대기 D11(생성 기능 설치 상태의 브라우저 merge 게이트): 참조 기능 삭제(
e3c8db48) 뒤 템플릿에는session-required라우트가 없다. 그래서tests/e2e/accessibility.spec.ts:48-88의 보호 라우트 분기와notChecked기록은 템플릿 게이트에서 한 번도 돌지 않는다. 로직은tests/unit/a11y-report.test.ts:110-197이 fixture descriptor로 본다. D11이 정할 일이라 새 발견으로 세지 않았다.
4. 실험 요청
모두 desktop, 한 checkout에서 하나씩, 실험마다 작업 폴더를 되돌린다. 브라우저 실행은 실행마다 다른 TEST_RUN_ID.
| ID | 목적 | 변이 패치 | 명령 | env | 상한 | 기대(지금 코드가 맞다면) |
|---|---|---|---|---|---|---|
| E-01 | T-01 확인 | src/presentation/styles/theme/responsive.css에서 86~95줄(@media (prefers-reduced-motion: reduce) { … })을 지운다 |
scripts/verify.sh exec -- corepack pnpm exec playwright test tests/e2e/accessibility.spec.ts -g "reduced-motion" |
TEST_RUN_ID=r9-l3-e01 |
15분 | 세 엔진 모두 통과(= 거짓 통과 확인) |
| E-02 | T-02 확인 | tests/browser-capabilities/opfs-runtime.spec.ts:352와 :470의 if (!(await installOpfsTab(page, scope))) return;을 expect(await installOpfsTab(page, scope), "OPFS supported").toBe(true);로 바꾼다 |
scripts/verify.sh exec -- corepack pnpm exec playwright test --config playwright.capabilities.config.ts tests/browser-capabilities/opfs-runtime.spec.ts |
TEST_RUN_ID=r9-l3-e02 |
10분 | 실패하는 엔진이 있으면 그 엔진은 지금 단언 없이 통과 중이다. 엔진별 결과를 적는다 |
| E-03 | T-03 확인 | scripts/check-test-evidence.ts:307-311(wholeUiMask 블록)을 지운다 |
① scripts/verify.sh exec -- node scripts/run-vitest.ts run tests/unit/test-evidence-source-rules.test.ts ② scripts/verify.sh exec -- sh -c 'corepack pnpm check:test-evidence:fixture; echo rc=$?' |
없음 | 5분 | ① 4건 통과, ② rc=1이고 "Test evidence failed:" 출력(= FE-GATE-029 기대도 그대로 충족). 변이가 살아남는다 |
| E-04 | T-06 축소 확인 | tests/e2e/old-tab-chunk-recovery.spec.ts:195의 ...(await preloadedWith(builds.dist.a, pageSource(aManifest, PLATFORM))), 줄을 지운다 |
scripts/verify.sh exec -- corepack pnpm exec playwright test tests/e2e/old-tab-chunk-recovery.spec.ts --repeat-each=5 |
TEST_RUN_ID=r9-l3-e04 |
25분 | 세 엔진 15/15 통과 |
| E-05 | 게이트 연결 현재 상태 | 없음 | scripts/verify.sh script check:ci:gating |
없음 | 5분 | PASS(목록 밖 시험 0, stale 항목 0). 노트북에서 스크립트 경로 대조로는 377파일 모두 어떤 스크립트에 있다 |
5. 결함 아님으로 판정한 의심
- W1의 "preload-use.ts가 쓰이지 않는 preload를 검사하지 않고 WebKit 추정 경고만 받아들인다": 템플릿에는 사실이 아니다. 미실행 preload를
preloadunused:로 실패시킨다(tests/support/browser/preload-use.ts:190-202). WebKit 문구는 앵커가 있는 정규식 하나로만 무시한다(strict-browser-test.ts:16-24). 변이 시험(tests/e2e/preload-use.spec.ts:111-120,:247-260)과 문구 경계 시험(:262-296), 판정 시험(:302-310)이 있다. tech-log main에는 이 파일이 없다. - route를 직접 fulfill하는 시험이 preload 검사를 덮는가: 아니다. build script를 fulfill하는 것은
production-csp.spec.ts:30-41하나이고fulfillBuildScript를 쓴다. 생성 기능·접근성 spec은 API origin만 가로챈다. 지연 시험은route.fallback()으로 추적기에 넘긴다(preload-use.spec.ts:192-198).preloadunused허용을 쓰는 두 spec(boot 실패, old-tab)은 route가 아니라 빌드 서버 전환으로 실패를 만든다. - SW가 제어하는 문서에서 preload 검사가 빠진다: 빠지는 것은 맞다. 이름 붙여 실패(
preload-use.ts:198-199)하고 SW update spec만 허용한다(service-worker-update.spec.ts:50-52). 1105 리뷰가 결함 아님으로 판정했고, 결과 단언 시험이 더해졌다(:302-350, 1105/06-03 고쳐짐). - boot 실패 spec이 boot graph 전체를
preloadunused로 허용: 일으킨 실패(모듈 평가 중 throw)의 직접 효과이고 엔진마다 멈추는 위치가 달라 전체가 맞다(boot-module-failure.spec.ts:47-69). chunk-load-error.spec.ts의 맨 test: 일부러 404 import를 내는 분류 시험이고 지난 리뷰들이 이유를 받아들였다. 남는 위험은 T-04에 적었다.vi.fn()fetcher: 모두 "보내지 않았다"를 단언하는 감시용이다(tests/integration/fileserver-upload.test.ts:653-661,http-execution-v3-auth-profile.test.ts:110-136등). 네트워크 동작은 MSW strict 서버(tests/mocks/server.ts:9)로 본다.- e2e webServer가 CI 빌드 env를 물려받음(
playwright.config.ts:36-42): FE-GATE-008이 증거로 쓰는 job 자신의 빌드라 의도다. 사본 빌드는localBuildEnvironment()를 쓴다(tests/e2e/support/fixture-builds.ts:57). tests/setup.ts의 자식 프로세스 가드 [w2-fe-2 파일]: 기본 timeout 값을vitest.config.ts와 맞추는 시험이 있고(tests/unit/child-process-timeout.test.ts:20-22), 가드를 끄면 실패하는 시험이 있다(:13-18). hook 미검사는 주석과 커밋에 적힌 한계다.- 참조 기능 시험 삭제로 플랫폼 검사를 잃었는가(T10): 표본 9개 모두 대응 시험이 있다. sign-out 판정
tests/unit/runtime-adapters-auth-profile.test.ts:364-420, intent 비노출tests/unit/http-execution-v3.test.ts:426-441, 중복 제거·retry 겹침tests/platform/traffic/request-deduplication.test.ts, fan-outtests/platform/traffic/request-fanout.test.ts. 전수 대조는 1절 「확인 못 한 것」. - 위험 커버리지 행 삭제(
config/testing/risk-coverage.json): 지운 기능 파일의 행만 지웠다(e3c8db48). 기준을 낮춘 것이 아니다. - 새 mutation admission 시험(
tests/component/application-mutation-admission.test.tsx:619-942): 같은 키 유지, 거절 종류별 판정, 보내기 전 실패를 키 순서까지 단언한다. 행동이 여럿이지만 한 흐름(제출 → 재전송 → 다음 제출)의 전이를 보는 시험이라 GWT 결함이 아니다. - visual 시험이 기능 영역을 가림: 1103 결정 D3(기능 영역을 가리고 찍음)대로다.
- 0929/12-06(Vitest 폴더의
*.spec.ts를 게이트 안으로 셈)·0929/12-07(예외 목록에 담당 없음)·1101/10-05·10-06·10-08: 1106에서 「남김」 또는 결정 대기로 정해졌다. 지금 코드도 그대로다(scripts/lib/ungated-tests.ts:18,:94-95). 다시 세지 않았다.