docs(review): 11-10(클릭 도중 움직이는 capability test 버튼)을 기록한다

문제: 메인 세션이 desktop(ee7e195, 부하 0.96)에서 FE-GATE-008의 firefox
capability 실패를 다시 찾았다. 14.7절은 같은 실패(browser-files 다운로드
test)를 부하 탓 flake로 적어 두었는데 틀렸다.

방법:
- 13절에 11-10(Medium·P1, 관점 10·21, 고침 ee37dd86)을 더했다. 근거는
  진단 event 기록 6건(mouseup이 홈 화면 내용), 위치 기록 3건(scrollY
  그대로, body·button 12 px 아래로), ×30 재현 3/60 두 번이다.
- 색인·발견 수(95건)·14.4 행을 맞췄다.
- 14.7절의 Firefox 줄을 지우고 정정을 적었다. "FE-GATE-008이 한 번에
  통과하지 않을 수 있다"는 줄도 지웠다.

검증: desktop에서 changelog-review-ids test와 verify:documentation(scoped).
This commit is contained in:
DongHyeonka
2026-11-05 09:51:48 +09:00
parent 9d5eb5cfc6
commit 8c5e047576
@@ -280,7 +280,7 @@
## 12. 발견 색인
영역 문서에 36.3 양식으로 적힌 발견은 96건이다. 같은 결함 8건을 대표 항목에 합쳤다(10.3절). 리뷰 뒤 오케스트레이터가 6건(11-06, 12-09, 11-07, 11-08, 11-09, 16-09, 13절)을 더해 색인은 94건이다: High 2 · Medium 40 · Low 52, P1 18 · P2 38 · P3 38, 확인된 결함 61 · 구조적 위험 23 · 개선 제안 10. 조치 상태는 14.4절이다. 각 영역 문서 2절의 "지난 발견 재확인" 표에만 있는 이월 항목(0929/03-03 등)은 여기 세지 않았다. 2절 차단 항목에는 포함했다. 심각도 조정은 2.3절이다.
영역 문서에 36.3 양식으로 적힌 발견은 96건이다. 같은 결함 8건을 대표 항목에 합쳤다(10.3절). 리뷰 뒤 오케스트레이터가 7건(11-06, 12-09, 11-07, 11-08, 11-09, 11-10, 16-09, 13절)을 더해 색인은 95건이다: High 2 · Medium 41 · Low 52, P1 19 · P2 38 · P3 38, 확인된 결함 62 · 구조적 위험 23 · 개선 제안 10. 조치 상태는 14.4절이다. 각 영역 문서 2절의 "지난 발견 재확인" 표에만 있는 이월 항목(0929/03-03 등)은 여기 세지 않았다. 2절 차단 항목에는 포함했다. 심각도 조정은 2.3절이다.
| ID | 심각도·우선순위 | 성격 | 내용 | 관련 관점 | 합친 것·조정 |
|---|---|---|---|---|---|
@@ -294,6 +294,7 @@
| [11-07](#13-리뷰-뒤-추가-발견-2026-11-04) | Medium·P1 | 확인된 결함 | CI의 빌드 식별값이 vitest와 dev server로 새어 FE-GATE-005·006·007·008·020이 실제 CI에서 항상 실패한다 | 21, 10, 18, 19 | 13절(조치 중 X4에서 찾음) |
| [11-08](#13-리뷰-뒤-추가-발견-2026-11-04) | Medium·P1 | 확인된 결함 | CI=true가 테스트 안의 로컬 빌드까지 release 빌드로 검사되게 해 FE-GATE-005·008·020이 workflow env에서 실패한다 | 21, 10, 18, 19 | 13절(메인 세션의 CI=true 재실행에서 찾음) |
| [11-09](#13-리뷰-뒤-추가-발견-2026-11-04) | Medium·P1 | 확인된 결함 | 브라우저 테스트가 WebKit의 load 3초 뒤 preload 추정에 기대어, 곧 쓰일 preload로 FE-GATE-008이 가끔 떨어지고 정말 안 쓴 preload는 놓친다 | 10, 21 | 13절(메인 세션의 desktop 실행에서 찾음) |
| [11-10](#13-리뷰-뒤-추가-발견-2026-11-04) | Medium·P1 | 확인된 결함 | capability 파일·다운로드 test가 그리는 중인 앱 뒤에 버튼을 붙여, 클릭 도중 버튼이 움직이면 firefox에서 FE-GATE-008이 30초 시간 초과로 떨어진다 | 10, 21 | 13절(메인 세션의 desktop 실행에서 찾음) |
| [16-09](#13-리뷰-뒤-추가-발견-2026-11-04) | Medium·P1 | 확인된 결함 | dev server가 고정된 contract set을 내주어 기능 추가 직후 `pnpm dev`가 부팅하지 못한다 | 20, 3, 21, 10 | 13절(조치 중 X2에서 찾음) |
| [12-01](12-guardrails-ci.md) | Medium·P1 | 확인된 결함 | `create:feature`로 기능 하나를 더하면 merge 게이트 `test:visual`이 실패하고, 통과시키려면 템플릿 소유 골든 PNG 3장을 다시 찍어야 한다 | 10, 25, 3, 21, 20, 26 | 조정 High·P1 → Medium·P1 |
| [12-09](#13-리뷰-뒤-추가-발견-2026-11-04) | Medium·P1 | 확인된 결함 | coverage 증거 검사가 istanbul summary의 `branchesTrue`를 거절해 FE-GATE-005가 항상 실패한다 | 21, 10, 16, 23 | 13절(리뷰 뒤 추가) |
@@ -465,6 +466,21 @@
| 조치 | 제품은 바꾸지 않았다. fixture가 WebKit의 그 문구만 무시하고, 세 엔진에서 같은 방법으로 preload 사용을 검사한다. 방법: build script에 평가 표시를 붙이고, preload됐는데 평가되지 않은 script를 `preloadunused:`로 실패시킨다. 볼 수 없는 것은 `preloadunverifiable:`로 실패시킨다(`tests/support/browser/preload-use.ts`). 일부러 실패를 일으키는 spec 셋은 그 실패가 남기는 preload만 허용한다. 버린 대안: lazy import의 의존성 preload를 끄기(lazy 라우트 첫 진입 +1~2 RTT, test에 맞춰 제품을 바꿈) |
| 담당·기한·상태 | 오케스트레이터 · 2026-11-05 · 고침(`aad005cb`) |
### 11-10 capability 파일·다운로드 test가 그리는 중인 앱 뒤에 버튼을 붙여, 클릭 도중 버튼이 움직이면 firefox에서 FE-GATE-008이 30초 시간 초과로 떨어진다
X4 1회차, 8회차, 메인 세션의 desktop 실행(`ee7e195`, 부하 0.96)에서 났다. 14.7절은 이것을 부하 탓 flake로 적어 두었는데 틀렸다.
| 필드 | 내용 |
|---|---|
| 성격 | 확인된 결함 |
| 관련 관점 | 10, 21 |
| 근거 | `tests/browser-capabilities/browser-files.spec.ts`의 두 test는 `goto("/")` 직후 label·input·button을 `<body>` 끝, 앱 root 뒤에 붙이고 그 button을 누른다. 실패 6건의 event 기록(진단 branch): pointerdown·mousedown은 button이었다. 30~45 ms 뒤 pointerup·mouseup은 홈 화면 내용이었고, click은 공통 조상이었다. button handler가 돌지 않아 file picker도 download도 없었다. 위치까지 적은 3건: scrollY 24로 같았다. body 높이 744 → 756 px, button top 696 → 708 px. 앱이 클릭 도중 12 px 자랐다. 재현: firefox capability suite ×30에서 두 test 60건 중 3건 실패(두 번). mousedown 때 앱 root를 400 px 늘리면 세 엔진 6/6 실패 |
| 발생 조건 | 앱이 아직 그리는 중에 test가 클릭할 때. dev server가 느린 suite 실행 중에 자주 걸린다. 부하와는 상관없다 |
| 영향 | merge 게이트 FE-GATE-008이 코드와 무관하게 가끔 빨갛다(1회 판정인 CI에서 merge를 막는다) |
| 심각도·우선순위 | Medium · P1 — merge 게이트를 막는 결함이라 02-06과 같은 기준이다(2.3절) |
| 조치 | 두 test가 붙이는 control을 `position: fixed` 층에 둔다. 버린 대안: 앱이 다 그려질 때까지 기다리기(그 신호가 없다), `dispatchEvent`·`force` click(신뢰된 입력이 아니라 picker가 열리지 않는다) |
| 담당·기한·상태 | 오케스트레이터 · 2026-11-05 · 고침(`ee37dd86`) |
### 16-09 dev server가 고정된 contract set을 내주어, `create:feature`로 기능을 더한 직후 `pnpm dev`가 부팅하지 못한다
조치 단계의 매뉴얼 재실험(14.6절 X2 #3)에서 찾았다.
@@ -524,7 +540,7 @@
| 01-01 (High) | 고침 | 실제 백엔드로 올려 보지 않았다. 백엔드 `POST /v1/files`는 `Idempotency-Key`를 읽지 않아 결과 불명 뒤 같은 키 재전송에도 파일이 둘 생길 수 있다(백엔드 결정) |
| 03-01 (= 08-01, High) | 고침 | 선언하지 않은 업무 code는 지금처럼 결과 불명이다 |
| 0929/03-03 (High) | 고침 | — |
| 02-06, 11-06, 12-09, 11-07, 11-08, 11-09, 16-09 | 고침 | CI 러너에서는 돌리지 않았다(14.5절은 깨끗한 clone + CI env) |
| 02-06, 11-06, 12-09, 11-07, 11-08, 11-09, 11-10, 16-09 | 고침 | CI 러너에서는 돌리지 않았다(14.5절은 깨끗한 clone + CI env) |
| 12-01, 15-01, 11-01(= 12-03), 16-03, 11-02 | 고침 | 16-03: 상세 라우트는 실패 상태로 검사하고 annotation만 남긴다 |
| 13-01, 13-02, 13-05, 12-07, 15-02~15-07 | 고침 | 실제 nginx·러너 미실행. HTTP/1.1·비압축 호스트는 이제 FE-GATE-019 FAIL(동작 변화) |
| 13-03 | 일부 | **결정 대기**: 운영 high advisory 2건(zod GHSA-mrhx, react-router GHSA-qwww). zod 4.6.x는 초기 JS를 약 7 KB 늘려 예산을 넘고, 두 갱신 모두 `dependency-change-evidence.json`에 owner와 다른 reviewer가 필요하다 |
@@ -594,8 +610,7 @@
- 기능 라우트 첫 진입(약 430 ms)을 재는 게이트가 없다(새 관찰).
- dev manifest 미들웨어가 capability e2e를 불안정하게 만든 원인(첫 manifest 요청이 200 헤더 뒤 끊기고 곧 두 번째 요청이 성공)을 끝까지 좁히지 못했다. 미들웨어를 지워 피했다.
- 초기 JS 측정용 빌드 입력 목록(`BUILD_INPUTS`)이 `scripts/scale/measure-feature-shape-growth.ts`와 `tests/unit/product-feature-selection-build.test.ts`에 두 벌 있다.
- Firefox 다운로드 capability 테스트(`browser-files.spec.ts:211`)가 부하 22~38에서 30초 시간 초과로 가끔 떨어진다(조치 전 커밋에서도 남). 클릭은 끝났는데 download 이벤트가 오지 않는다. 그 테스트만 따로 30회씩 두 번(부하 35~48) 돌리면 60/60 통과해, 전체 capability suite 안에서만 난다. 테스트가 `deliver` 직후 `runtime.dispose()`로 Blob URL을 회수하는 경쟁을 의심해 dispose를 다운로드 뒤로 옮긴 변형도 돌렸으나 똑같이 60/60이라 원인으로 확인되지 않았다. 테스트는 그대로 두었고 원인을 찾지 못했다.
- ~~Firefox 다운로드 capability 테스트(`browser-files.spec.ts:211`)가 부하 22~38에서 30초 시간 초과로 가끔 떨어진다~~ — **정정: 부하 탓도, Blob URL 회수 경쟁도 아니었다.** 같은 파일의 파일 선택 test도 같은 식으로 떨어졌다. 두 test가 앱 뒤에 붙인 버튼이, 앱이 그리는 도중 12 px 밀려 클릭이 버튼에 닿지 않았다. 고침: 11-10(`ee37dd86`).
- ~~webkit `production-csp.spec.ts:52`가 부하 28~33에서 "preloaded but not used" 콘솔 경고 1건으로 가끔 떨어진다(4회차, 8회차)~~ — **정정: 부하 탓이 아니었다.** WebKit이 load 3초 뒤 한 번 하는 추정이었다. 화면이 load 뒤 약 2.5초에 열려 여러 단계 lazy 청크를 preload하면 걸리고, 부하 0.68에서도 났다(`i18n.spec.ts:60`). 고침: 11-09(`aad005cb`). fixture가 그 문구만 무시하고 preload 사용을 직접 검사한다.
- 위 Firefox 건 때문에 FE-GATE-008이 한 번에 통과하지 않을 수 있다. 실제 러너의 부하에서 얼마나 나는지는 재지 않았다.
- 매뉴얼만 보는 재실험(X2)을 고친 뒤 다시 돌리지 않았다.
- 리뷰 기록 두 곳(`docs/reviews/2026-11-01-maturity-review/README.md:627`, 이 폴더 `03-adapters-http-state.md:332`)과 커밋 `12f3bb7` 본문에 "memento-web이 V2 행을 쓴다"는 틀린 문장이 남아 있다. 리뷰 기록은 고치지 않는다. CHANGELOG에서는 지웠다.