docs(review): 11-09(WebKit preload 추정에 기댄 브라우저 테스트)를 기록한다

문제: 메인 세션이 desktop(부하 0.68)에서 8a3b16a의 FE-GATE-008 webkit
실패(i18n.spec.ts:60)를 찾았다. 14.7절은 같은 경고(production-csp.spec.ts:52)를
부하 탓 flake로 적어 두었는데 틀렸다.

방법:
- 13절에 11-09(Medium·P1, 관점 10·21, 고침 aad005cb)를 더했다. 근거는 실패
  trace의 시각, 재현 3/10·0/10·2/2, 이전 fixture가 정말 안 쓴 preload를
  놓친 probe다.
- 색인·발견 수(94건)·14.4 행을 맞췄다.
- 14.7절의 webkit flake 줄을 지우고 정정을 적었다. FE-GATE-008이 한 번에
  통과하지 않을 수 있는 이유는 이제 Firefox 다운로드 건 하나다.

검증: desktop에서 changelog-review-ids test와 verify:documentation.
This commit is contained in:
DongHyeonka
2026-11-05 08:14:53 +09:00
parent 8b70a5a992
commit 37c63e8370
@@ -280,7 +280,7 @@
## 12. 발견 색인
영역 문서에 36.3 양식으로 적힌 발견은 96건이다. 같은 결함 8건을 대표 항목에 합쳤다(10.3절). 리뷰 뒤 오케스트레이터가 5건(11-06, 12-09, 11-07, 11-08, 16-09, 13절)을 더해 색인은 93건이다: High 2 · Medium 39 · Low 52, P1 17 · P2 38 · P3 38, 확인된 결함 60 · 구조적 위험 23 · 개선 제안 10. 조치 상태는 14.4절이다. 각 영역 문서 2절의 "지난 발견 재확인" 표에만 있는 이월 항목(0929/03-03 등)은 여기 세지 않았다. 2절 차단 항목에는 포함했다. 심각도 조정은 2.3절이다.
영역 문서에 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절이다.
| ID | 심각도·우선순위 | 성격 | 내용 | 관련 관점 | 합친 것·조정 |
|---|---|---|---|---|---|
@@ -293,6 +293,7 @@
| [11-06](#13-리뷰-뒤-추가-발견-2026-11-04) | Medium·P1 | 확인된 결함 | compact smoke e2e가 build id를 고정해 실제 CI 값에서 FE-GATE-008이 항상 실패한다 | 21, 10, 18, 19 | 13절(리뷰 뒤 추가) |
| [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 실행에서 찾음) |
| [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절(리뷰 뒤 추가) |
@@ -449,6 +450,21 @@
| 심각도·우선순위 | Medium · P1 — 02-06과 같은 기준이다(2.3절) |
| 담당·기한·상태 | 오케스트레이터 · 2026-11-05 · 고침(`b693600`, 안내 `cd7e784`) |
### 11-09 브라우저 테스트가 WebKit의 load 3초 뒤 preload 추정에 기대어, 곧 쓰일 preload로 FE-GATE-008이 가끔 떨어지고 정말 안 쓴 preload는 놓친다
메인 세션이 desktop(부하 0.68)에서 `8a3b16a`를 workflow env로 돌려 찾았다(webkit `i18n.spec.ts:60`). 14.5절 4·8회차의 webkit `production-csp.spec.ts:52` 실패도 같은 원인이다. 그때는 부하 탓으로 적었는데, 그 판단은 틀렸다(14.7절).
| 필드 | 내용 |
|---|---|
| 성격 | 확인된 결함 |
| 관련 관점 | 10, 21 |
| 근거 | strict fixture(`tests/support/browser/strict-browser-test.ts`)는 console warning을 모두 실패로 센다. WebKit은 load 3초 뒤 한 번, 아직 아무 요청도 쓰지 않은 preload에 "was preloaded using link preload but not used within a few seconds"를 낸다. 플랫폼 구성 화면은 들어갈 때 기능 실행부를 모두 불러오고(`platform-overview-page.tsx:651`, 15-01), Vite는 그 청크와 정적 의존 청크를 한꺼번에 modulepreload한다(`feature-runtime` → `reference-feature-contract-contribution` → `reference-schemas`). 실패한 trace: load ≈ 13.39 s, 클릭 15.30 s, preload 15.93 s(load + 2.54 s), 경고 16.40 s(load + 3.0 s). reference-schemas는 link로 한 번만 받았고 표는 그려졌다. 쓰인 preload다. 재현: desktop 반복 10회 중 3회. 혼자 돌리면 0/10(preload가 load + 1.2 s). 부모 청크 응답을 3.5초 늦추면 2/2. 반대로 정말 안 쓰는 modulepreload는 이전 fixture가 세 엔진 모두 통과시켰다(probe, `aad005cb` 본문) |
| 발생 조건 | 화면이 load 뒤 약 2.5~3초에 열려 여러 단계 lazy 청크를 preload할 때. 병렬 worker로 test가 느려지면 자주 걸린다. 부하와는 상관없다 |
| 영향 | merge 게이트 FE-GATE-008이 코드와 무관하게 가끔 빨갛다. 정말 안 쓰는 preload(낭비된 다운로드)는 test가 잡지 못한다 |
| 심각도·우선순위 | Medium · P1 — merge 게이트를 막는 결함이라 02-06과 같은 기준이다(2.3절) |
| 조치 | 제품은 바꾸지 않았다. 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`) |
### 16-09 dev server가 고정된 contract set을 내주어, `create:feature`로 기능을 더한 직후 `pnpm dev`가 부팅하지 못한다
조치 단계의 매뉴얼 재실험(14.6절 X2 #3)에서 찾았다.
@@ -508,7 +524,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, 16-09 | 고침 | CI 러너에서는 돌리지 않았다(14.5절은 깨끗한 clone + CI env) |
| 02-06, 11-06, 12-09, 11-07, 11-08, 11-09, 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가 필요하다 |
@@ -577,7 +593,7 @@
- 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이라 원인으로 확인되지 않았다. 테스트는 그대로 두었고 원인을 찾지 못했다.
- webkit `production-csp.spec.ts:52`가 부하 28~33에서 "preloaded but not used" 콘솔 경고 1건으로 가끔 떨어진다(4회차, 8회차). 다음 실행에서는 통과했다.
- 위 두 건 때문에 FE-GATE-008이 한 번에 통과하지 않을 수 있다. 실제 러너의 부하에서 얼마나 나는지는 재지 않았다.
- ~~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에서는 지웠다.