diff --git a/docs/reviews/2026-11-03-maturity-review/README.md b/docs/reviews/2026-11-03-maturity-review/README.md index 5abf5619..8e5d39f5 100644 --- a/docs/reviews/2026-11-03-maturity-review/README.md +++ b/docs/reviews/2026-11-03-maturity-review/README.md @@ -280,7 +280,7 @@ ## 12. 발견 색인 -영역 문서에 36.3 양식으로 적힌 발견은 96건이다. 같은 결함 8건을 대표 항목에 합쳤다(10.3절). 리뷰 뒤 오케스트레이터가 4건(11-06, 12-09, 11-07, 16-09, 13절)을 더해 색인은 92건이다: High 2 · Medium 38 · Low 52, P1 16 · P2 38 · P3 38, 확인된 결함 59 · 구조적 위험 23 · 개선 제안 10. 조치 상태는 14.4절이다. 각 영역 문서 2절의 "지난 발견 재확인" 표에만 있는 이월 항목(0929/03-03 등)은 여기 세지 않았다. 2절 차단 항목에는 포함했다. 심각도 조정은 2.3절이다. +영역 문서에 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절이다. | ID | 심각도·우선순위 | 성격 | 내용 | 관련 관점 | 합친 것·조정 | |---|---|---|---|---|---| @@ -292,6 +292,7 @@ | [11-02](11-tests-browser-release-scale.md) | Medium·P1 | 확인된 결함 | CI merge job이 시각 테스트 글꼴 패키지를 설치하지 않아, 빈 러너에서는 FE-GATE-008이 코드와 무관하게 `visual-fonts` 단계에서 실패한다 (1101/11-02 남은 절반) | 21, 10, 19, 20, 16, 5 | | | [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 재실행에서 찾음) | | [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절(리뷰 뒤 추가) | @@ -434,6 +435,20 @@ | 완료 기준 | CI env로 깨끗한 clone에서 merge 단계 14개가 통과한다 | | 담당·기한·상태 | 오케스트레이터 · 2026-11-05 · 고침(`af312de`) | +### 11-08 CI=true가 테스트 안의 로컬 빌드까지 release 빌드로 검사되게 해, merge 게이트 셋이 workflow env에서 실패한다 + +조치 단계가 끝난 뒤 메인 세션이 깨끗한 clone(`c7c7887`)에서 workflow env 그대로(`CI=true`, `CI_RUNNER_IMAGE` digest 포함) 14개를 돌려 찾았다. 오케스트레이터의 X4(14.5절)는 `CI=true`와 `CI_RUNNER_IMAGE` 없이 돌아 이것을 놓쳤다. + +| 필드 | 내용 | +|---|---| +| 성격 | 확인된 결함 | +| 관련 관점 | 21, 10, 18, 19 | +| 근거 | `scripts/lib/build-environment.ts`의 `ciBuildEnvironmentFailures`는 `CI === "true"`이면 `VITE_COMMIT_SHA`(40·64자리 hex)·`SOURCE_DATE_EPOCH`·`CI_RUNNER_IMAGE`를 요구한다. ① vitest 안의 fixture 빌드(`tests/e2e/support/fixture-builds.ts` → `build-frontend.ts`)가 `CI=true`를 물려받는데, 11-07 수정(`af312de`)이 vitest에서 `VITE_COMMIT_SHA`를 지워 "missing required CI build environment: VITE_COMMIT_SHA"로 멈춘다(`service-worker-build-output` 7건 미실행). FE-GATE-005와 제거 드릴(FE-GATE-020)이 떨어진다. ② 시각 골든 build(`9bddfa5`)의 `VITE_COMMIT_SHA="local"`을 `CI=true`가 거절해 webServer가 뜨지 않는다(FE-GATE-008). 오케스트레이터가 `CI=true` env로 재현했다 | +| 발생 조건 | workflow(CI=true)에서 merge 게이트를 돌릴 때마다 | +| 영향 | merge 게이트 셋이 코드와 무관하게 빨갛다. 11-07을 고친 수정이 이 결함을 만들었다 | +| 심각도·우선순위 | Medium · P1 — 02-06과 같은 기준이다(2.3절) | +| 담당·기한·상태 | 오케스트레이터 · 2026-11-05 · 고침(`b693600`, 안내 `cd7e784`) | + ### 16-09 dev server가 고정된 contract set을 내주어, `create:feature`로 기능을 더한 직후 `pnpm dev`가 부팅하지 못한다 조치 단계의 매뉴얼 재실험(14.6절 X2 #3)에서 찾았다. @@ -493,7 +508,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, 16-09 | 고침 | CI 러너에서는 돌리지 않았다(14.5절은 깨끗한 clone + CI env) | +| 02-06, 11-06, 12-09, 11-07, 11-08, 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가 필요하다 | @@ -513,7 +528,7 @@ ### 14.5 검증 -메인 세션이 정한 방법(X4): 깨끗한 clone(`git clone --no-hardlinks`, `corepack pnpm install --frozen-lockfile --offline`)에서 CI와 같은 env(`VITE_COMMIT_SHA=<40자리>`, `VITE_BUILD_ID=gitea-1-1`, `RELEASE_ID`, `CHOKIDAR_USEPOLLING=1`)로 merge 단계 14개(FE-GATE-001~013, 020)를 `ci:gate`로 하나씩, 공유 잠금 아래에서 돌렸다. `ci:gate`는 첫 실패에서 멈추므로 고칠 때마다 다시 돌렸다. +메인 세션이 정한 방법(X4): 깨끗한 clone(`git clone --no-hardlinks`, `corepack pnpm install --frozen-lockfile --offline`)에서 CI와 비슷한 env(`VITE_COMMIT_SHA=<40자리>`, `VITE_BUILD_ID=gitea-1-1`, `RELEASE_ID`, `CHOKIDAR_USEPOLLING=1`)로 merge 단계 14개(FE-GATE-001~013, 020)를 `ci:gate`로 하나씩, 공유 잠금 아래에서 돌렸다. `ci:gate`는 첫 실패에서 멈추므로 고칠 때마다 다시 돌렸다. | 회차 | 커밋 | 실패 | 원인과 수정 | |---|---|---|---| @@ -523,15 +538,18 @@ | 4 | `0c9fcbd` | 008(webkit 1건), 020 | webkit "preloaded but not used" 경고 1건(부하 32.9, 다음 회차 통과). 새 dev manifest 테스트가 템플릿 상태에 기댄다 → `8b382aa` | | 5 | `8b382aa`(005·008·020만) | 020 | dev manifest 플러그인이 Vitest에서도 돌아 src/에 샘플 경로를 쓴다 → `db5728b` | | 6 | `db5728b`(005·020만) | 020(test:feature-scaffold) | 드릴이 생성 뒤 초기 JS 기록을 다시 쓰지 않는다(12-02 × 15-02) → `2e4595e` | - | 7 | `2e4595e` | 008(capability 1건) | dev manifest 미들웨어 뒤로 `requestfailed /release-manifest.json ERR_ABORTED`가 1~4건씩 났다. 미들웨어 있음/없음 번갈아 30건씩: 5·2 실패 / 0·0 실패. 미들웨어를 지우고 커밋 파일을 생성·제거 때 다시 쓰는 방식으로 바꿨다 → `799ab7f`(`0eba082`의 메모리 방식도 실패) | -| **최종** | **`799ab7f`** | **없음** | 14개 모두 통과. FE-GATE-008은 첫 실행에서 Firefox 다운로드 1건이 30초 시간 초과(부하 37.9)였고, 다시 두 번 돌려 두 번 다 통과했다(e2e 193, capability 66, storybook 1, visual 6). 같은 시간 초과는 플러그인 전 커밋 `5ca5340`에서도 났다(부하 26) | +| **최종(CI=true 없음)** | **`799ab7f`** | **없음** | 14개 모두 통과. FE-GATE-008은 첫 실행에서 Firefox 다운로드 1건이 30초 시간 초과(부하 37.9)였고, 다시 두 번 돌려 두 번 다 통과했다(e2e 193, capability 66, storybook 1, visual 6). 같은 시간 초과는 플러그인 전 커밋 `5ca5340`에서도 났다(부하 26) | +| 8 | `cd7e784`(CI=true) | 008(webkit 1건) | 001~007, 009~013, 020 rc=0. 008의 e2e에서 webkit production-csp "preloaded but not used" 경고 1건(부하 28.1, 4회차와 같은 증상). 008만 다시 돌리니 e2e는 통과하고 capability의 Firefox 다운로드 1건이 30초 시간 초과(부하 22). 코드는 고치지 않았다 | +| **최종(CI=true)** | **`cd7e784`** | **없음** | 14개 모두 통과. 008은 세 번째 실행에서 통과했다(e2e 193, capability 66, storybook 1, visual 6, 부하 32.6). 020: 참조 기능 제거 31 checks, 생성 기능 제거 17, feature scaffold 77, optional-recipe·browser-file-storage·realtime 제거 모두 PASS | -최종 커밋 `799ab7f`의 결과: FE-GATE-001~007, 009~013, 020 rc=0(020: 참조 기능 제거 31 checks, 생성 기능 제거 17, feature scaffold 77, optional-recipe·browser-file-storage·realtime 제거 모두 PASS). FE-GATE-008 rc=0(재실행 2회). +**위 1~7회차와 `799ab7f` 결과는 `CI=true`와 `CI_RUNNER_IMAGE` 없이 돌린 것이다.** workflow는 둘 다 준다. 그래서 11-08을 놓쳤고, 메인 세션이 `c7c7887`에서 workflow env 그대로 돌려 FE-GATE-005·008·020 실패를 찾았다. 8회차부터 `CI=true`와 `CI_RUNNER_IMAGE`(digest)를 더했다. + +최종 커밋 `799ab7f`의 결과(CI=true 없음): FE-GATE-001~007, 009~013, 020 rc=0(020: 참조 기능 제거 31 checks, 생성 기능 제거 17, feature scaffold 77, optional-recipe·browser-file-storage·realtime 제거 모두 PASS). FE-GATE-008 rc=0(재실행 2회). 생성 기능을 넣은 깨끗한 clone(`create:feature bulletin-feature --with-create --keyed`)에서 매뉴얼의 생성 뒤 단계대로 확인했다. `db5728b`: FE-GATE-012 통과(203,944 / 204,800 B, 26 / 32 파일, #4). `799ab7f`: 생성 명령이 `public/release-manifest.json`을 다시 쓰고(#3), dev server capability e2e 66건 통과(CI env), 초기 JS 기록 다시 쓰기 → FE-GATE-005 통과(#1·#2), `test:sample-removal -- --feature=bulletin-feature` 통과(17 checks, #2). **쓰기 기능 하나로 초기 JS 여유가 856 B다.** -실행하지 않은 것: 실제 Gitea 러너(`CI=true`, 러너 이미지), `test:system` 전체(이 세션의 게이트 목록 밖), 실제 짝 백엔드·nginx·Keycloak·Redis 연동. +실행하지 않은 것: 실제 Gitea 러너(8회차는 workflow env를 로컬에서 준 것이고, `CI_RUNNER_IMAGE`는 형식만 맞춘 가짜 digest다), `test:system` 전체(이 세션의 게이트 목록 밖), 실제 짝 백엔드·nginx·Keycloak·Redis 연동. ### 14.6 매뉴얼만으로 기능 추가 재실험 (X2) @@ -558,6 +576,8 @@ - 기능 라우트 첫 진입(약 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`)가 부하 26~38에서 30초 시간 초과로 가끔 떨어진다(조치 전 커밋에서도 남). +- 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이 한 번에 통과하지 않을 수 있다. 실제 러너의 부하에서 얼마나 나는지는 재지 않았다. - 매뉴얼만 보는 재실험(X2)을 고친 뒤 다시 돌리지 않았다. - 리뷰 기록 두 곳(`docs/reviews/2026-11-01-maturity-review/README.md:627`, 이 폴더 `03-adapters-http-state.md:332`)과 커밋 `12f3bb7` 본문에 "memento-web이 V2 행을 쓴다"는 틀린 문장이 남아 있다. 리뷰 기록은 고치지 않는다. CHANGELOG에서는 지웠다.