Files
clean-architecture-frontend…/tasks/todo.md
T
DongHyeonkaandClaude Opus 5.5 b95314245d docs: plan round 2 of the src review fixes
Add Q-requirements for every recommended/minor review finding plus the
round-1 follow-ups (SW fetch scope, bundle budget), decisions D-11..D-16,
and tasks T51-T115 across the same nine lanes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 13:00:41 +09:00

429 lines
29 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Tasks: src 리뷰 긴급·필수 항목 수정
각 작업의 문제 설명은 `docs/reviews/2026-09-24-src-full-review.md` 해당 섹션을 본다. 요구사항은 `SPEC.md`, 실행 방식은 `tasks/plan.md`에 있다.
## 모든 작업에 공통인 검증
- [x] RED: 재현 테스트가 수정 전에 실패한다
- [x] GREEN: 해당 테스트 파일 통과 — `node scripts/run-vitest.ts run <test file>`
- [x] 게이트 통과 — `corepack pnpm check:architecture && corepack pnpm check:types:app && corepack pnpm check:types:test && corepack pnpm lint && corepack pnpm test:unit && corepack pnpm test:component`
- [x] adapter 파일을 추가하거나 이동했으면 `docs/reviews/adapters/INVENTORY.md`를 갱신하고 `corepack pnpm check:adapter-inventory` 통과
- [x] 커밋 1개, 메시지에 R-ID 포함, 해당 작업 파일만 스테이징
---
## Phase 0
### T01 — R-0 깨끗한 체크아웃에서 게이트 동작 (리뷰 6.0)
- 완료 조건:
- [x] `rm -rf src/.generated` 뒤 `dev`(기동까지), `build`, `check:architecture`, `check:types:app`, `test:unit`, `test:component`, `verify:documentation`이 통과한다
- [x] CI(`config/ci/gates.json` → 생성 workflow)도 생성 단계를 거친다. `check:ci-contract` 등 관련 검사가 통과한다
- 테스트: 스크립트 레벨 검증(위 명령). 필요하면 `tests/scripts/generate-product-feature-index.test.ts`에 보강
- 파일: `package.json`, `scripts/*`(진입점), `config/ci/gates.json`, 생성 workflow
- 의존: 없음 · 크기: M
---
## 레인 A — browser-transfer
### T02 — R-1.1 dispose 재시도 가능 (6.1-1)
- 완료 조건: [x] deadline 초과 뒤 작업이 끝나면 두 번째 `dispose()`가 성공하고 `lifecycle()==="CLOSED"`, checkpoint store가 닫힌다
- 테스트: `tests/unit/resumable-upload-runtime-teardown.test.ts`
- 파일: `src/adapters/browser-transfer/resumable-upload/resumable-upload-runtime.ts`
- 의존: T01 · 크기: S
### T03 — R-1.4 크기 초과는 LIMIT_EXCEEDED (6.1-4)
- 완료 조건: [x] `maxFileBytes`/`maxPartCount` 초과 upload가 `LIMIT_EXCEEDED`를 반환한다
- 테스트: `tests/unit/resumable-upload-runtime.test.ts`
- 파일: `resumable-upload-runtime.ts`
- 의존: T01 · 크기: S
### T04 — R-1.2 opaque ID 문법 단일화 (6.1-2)
- 완료 조건: [x] `-`/`_`로 시작하는 43자 base64url ID가 session, part 발급, download 발급까지 통과한다 [x] 정규식 정의는 한 곳
- 테스트: `tests/unit/presigned-transfer*.test.ts` 또는 `resumable-upload-*` 중 해당 파일
- 파일: `resumable-upload/checkpoint-schema.ts`, `presigned/presigned-capability-http-provider.ts`, `presigned/presigned-transfer-executor.ts`
- 의존: T01 · 크기: S
### T05 — R-1.3 동시성 정책 정합 (6.1-3, D-2)
- 완료 조건: [x] 정책 검증이 `partSize×maxConcurrency×copyFactor > maxInFlightBytes`를 거절한다 [x] 기본 정책이 검증을 통과한다 [x] createSession이 실제 worker 수를 요청한다
- 테스트: `tests/unit/resumable-upload-runtime.test.ts`(기본 정책 사용 케이스)
- 파일: `resumable-upload/runtime-policy.ts`, `resumable-upload-runtime.ts`, 필요 시 `docs/architecture/presigned-transfer-and-image-cdn.md`
- 의존: T01 · 크기: S
## 레인 B — browser-files / cache-storage / cross-context
### T06 — R-2.1 BOUNDED_OBJECT_URL open 실패 시 Result 반환 (6.2-1)
- 완료 조건: [x] presigned source + BOUNDED_OBJECT_URL에서 open 중 abort하면 `deliver()`가 `{ok:false, ABORTED}`로 resolve된다 [x] 늦게 온 lease가 닫힌다
- 테스트: `tests/unit/browser-file-download.test.ts`
- 파일: `src/adapters/browser-files/download-delivery-adapter.ts`
- 의존: T01 · 크기: S
### T07 — R-2.2 watermark를 TTL과 분리 (6.2-2)
- 완료 조건: [x] 같은 source의 seq 1 → 61초 뒤 seq 2가 `NEXT`로 전달된다 [x] watermark 메모리는 `sourceCapacity`로만 제한된다
- 테스트: `tests/unit/cross-tab-invalidation.test.ts`
- 파일: `src/adapters/cross-context-invalidation/browser-cross-context-invalidation.ts`
- 의존: T01 · 크기: S
### T08 — R-2.3 발행 실패 뒤에도 수신 유지, 수신 불가면 DEGRADED (6.2-3, D-4)
- 완료 조건: [x] postMessage가 한 번 실패한 탭이 다른 탭의 broadcast를 계속 받는다 [x] BroadcastChannel을 만들 수 없는 탭의 status가 DEGRADED다
- 테스트: `tests/unit/cross-tab-invalidation.test.ts`(발행 탭은 정상, 수신 탭이 실패하는 구성)
- 파일: `browser-cross-context-invalidation.ts`, 필요 시 status 타입(`src/application/ports/…`)
- 의존: T07 · 크기: S
### T09 — R-2.4 picker 함수 bind 제거 (6.2-4)
- 완료 조건: [x] `this`가 options이면 throw하는 fake picker를 주입해도 picker와 save가 동작한다
- 테스트: `tests/unit/browser-file-picker.test.ts`, `tests/unit/browser-file-download.test.ts`
- 파일: `src/adapters/browser-files/browser-file-picker.ts`, `download-delivery-adapter.ts`
- 의존: T06 · 크기: S
### T10 — R-2.5 cache 정책의 Vary/content-type (6.2-5)
- 완료 조건: [x] 기본 정책으로 `Vary: Accept-Encoding` 응답을 stage하고 activate할 수 있다 [x] `content-type`이 없는 정책은 `assertPublicCachePolicy`가 거부한다
- 테스트: `tests/unit/public-response-cache.test.ts`
- 파일: `src/adapters/cache-storage/public-response-cache-adapter.ts`, `public-cache-policy.ts`
- 의존: T01 · 크기: S
## 레인 C — http / query-cache / auth
### T11 — R-3.1 경로 값 `.`/`..` 거부 (6.3-1)
- 완료 조건: [x] V3 bridge가 `PATH_VALUE_INVALID`, V2 request-builder가 `PATH_PARAMETER_INVALID`를 반환한다(`"."`, `".."` 각각)
- 테스트: `tests/unit/http-contract-bridge*.test.ts`(없으면 신규), V2 request-builder 테스트
- 파일: `src/adapters/http/http-contract-bridge.ts`, `src/adapters/http/request-builder.ts`
- 의존: T01 · 크기: S
### T12 — R-3.2a scope fence는 상태가 바뀔 때만 (6.3-2) [고위험]
- 완료 조건: [x] 같은 (상태, 주체) 알림은 fence·abort·cache clear를 일으키지 않는다 [x] 상태나 주체가 바뀌면 여전히 fence된다
- 테스트: server-state-scope 런타임 테스트(`tests/unit/…server-state-scope…`)
- 파일: `src/adapters/query-cache/server-state-scope-runtime.ts`
- 의존: T01 · 크기: S
### T13 — R-3.2b 요청 전 미인증과 서버 401 구분, demo 동일 값 무알림 (6.3-2) [고위험]
- 완료 조건: [x] V3 요청 전 자격증명 없음은 `onUnauthenticated`를 호출하지 않는다 [x] 서버 401은 호출한다 [x] demo `setState`는 같은 값이면 listener를 부르지 않는다
- 테스트: `tests/unit/http-execution-v3*.test.ts`, `tests/unit/runtime-adapters.test.ts` 또는 auth 어댑터 테스트
- 파일: `src/adapters/http/http-execution-v3.ts`, `src/adapters/auth/external-session-adapter.ts`, `src/bootstrap/runtime-adapters.ts`
- 의존: T12 · 크기: M
### T14 — R-3.3 5xx 비정상 바디와 요청 쪽 위반 분류 (6.3-3)
- 완료 조건: [x] HTML/빈 바디 502/503/504가 status를 담은 서버 장애(재시도 가능)로 끝난다 [x] 바인딩 결과가 `contact-support`가 아니다 [x] `FINAL_REQUEST_INVARIANT_FAILED`/`MISSING_IDEMPOTENCY_KEY`가 `ENVELOPE_MISMATCH`로 매핑되지 않는다
- 테스트: `tests/unit/http-execution-v3.test.ts`, feature-http-binding 테스트
- 파일: `http-execution-v3.ts`, `src/adapters/http/feature-http-binding.ts`
- 의존: T13 · 크기: M
### T15 — R-3.4 자격증명 헤더 ByteString 검증 (6.3-4) [고위험]
- 완료 조건: [x] NUL, 비 Latin-1, 제어문자가 든 값이 전송 전에 `CREDENTIAL_HEADER_VALUE_INVALID`가 된다(NETWORK_FAILURE 아님) [x] 대소문자만 다른 중복 헤더가 거부된다 [x] 정상 Bearer 토큰은 통과한다
- 테스트: bridge/V3 테스트, auth 어댑터 테스트
- 파일: `http-contract-bridge.ts`, `http-execution-v3.ts`, `external-session-adapter.ts`
- 의존: T14 · 크기: M
### T16 — R-3.5 매퍼 예외를 Result로 (6.3-5)
- 완료 조건: [x] `mapSuccess`/`mapProblem`이 throw하면 `MAPPING_CONTRACT_VIOLATION` Result가 반환되고 effect가 보존된다
- 테스트: feature-http-binding 테스트
- 파일: `feature-http-binding.ts`
- 의존: T14 · 크기: S
## 레인 D — realtime
### T17 — R-4.2 hint 없는 retryable 실패도 재연결 (6.4-2)
- 완료 조건: [x] WS `NETWORK_LOST`/`RESTART`, SSE 502/504(hint 없음)가 재연결된다 [x] polling도 같다 [x] `retryable:false`는 여전히 종료된다
- 테스트: `tests/unit/realtime/realtime-reconnect-coordinator.test.ts` + WS↔reconnect 연결 테스트 신규
- 파일: `src/adapters/realtime/reconnect-coordinator.ts`, `polling/bounded-poll-coordinator.ts`
- 의존: T01 · 크기: S
### T18 — R-4.1 DRAINING 중 recovery 차단 (6.4-1)
- 완료 조건: [x] quiescence를 기다리는 동안 effect가 DRAINING이 되면 recovery가 authority를 호출하지 않고 실패한다
- 테스트: `tests/unit/realtime/stream-coordinator.test.ts`
- 파일: `src/adapters/realtime/stream-coordinator.ts`
- 의존: T01 · 크기: S
### T19 — R-4.3 barrier NONE recovery는 계속 진행 (6.4-3)
- 완료 조건: [x] SNAPSHOT_ONLY + barrier NONE 스트림에서 gap → recovery 뒤 연결이 유지되고 PROTOCOL_MISMATCH가 나지 않는다
- 테스트: consumer + coordinator 실제 조합 테스트(mock 없이)
- 파일: `src/adapters/realtime/event-consumer.ts`, 필요 시 `stream-coordinator.ts`
- 의존: T18 · 크기: M
### T20 — R-4.4 SSE 파서 성능 (6.4-4)
- 완료 조건: [x] 기존 파서 테스트가 모두 통과한다(CRLF, 분할 chunk, BOM 등) [x] 250KB chunk 벤치에서 10배 이상 빨라진다(수동 측정값을 커밋 메시지에 기록)
- 테스트: `tests/unit/realtime/sse-parser*.test.ts` + 대형 chunk 정확성 케이스
- 파일: `src/adapters/realtime/sse/sse-parser.ts`
- 의존: T01 · 크기: S
## 레인 E — storage
### T21 — R-5.1 orphan 후보 커서 (6.5-1) [고위험]
- 완료 조건: [x] 참조 중 청크 150개 뒤에 있는 orphan이 reconcile로 지워진다 [x] 참조 중 청크는 지워지지 않는다
- 테스트: `tests/unit/opfs-worker-runtime.test.ts`, `tests/unit/opfs-byte-store.test.ts`
- 파일: `src/adapters/storage/opfs/opfs-worker-runtime.ts`, `opfs-worker-protocol.ts`, `opfs-worker-client.ts`, `opfs-byte-store-adapter.ts`
- 의존: T01 · 크기: M
### T22 — R-5.2 dedup 재사용 청크의 grace 보호 (6.5-2) [고위험]
- 완료 조건: [x] 같은 digest를 다시 쓰면 청크의 mtime이 갱신되어 `listOrphanCandidates`에 나오지 않는다
- 테스트: `tests/unit/opfs-worker-runtime.test.ts`
- 파일: `opfs-worker-runtime.ts`
- 의존: T21 · 크기: S
### T23 — R-5.3 lock 대기를 RPC 타임아웃에서 분리 (6.5-3, D-3)
- 완료 조건: [x] 긴 put이 lock을 잡고 있어도 뒤에 온 put/remove가 60초에 실패하지 않고 lock을 얻은 뒤 진행된다 [x] lock 대기는 정책값 상한으로 끝난다
- 테스트: 배타 lease를 쓰는 worker/client 테스트 신규
- 파일: `opfs-worker-client.ts`, `opfs-worker-runtime.ts`, `opfs-policy.ts`
- 의존: T22 · 크기: M
### T24 — R-5.4 파티션 purge가 손상 행을 넘어 끝까지 (6.5-4) [고위험]
- 완료 조건: [x] 손상 record/sidecar/budget이 섞인 파티션에서 LOGOUT/ACCOUNT_DELETION purge가 COMPLETE된다 [x] 다른 파티션의 행은 남는다 [x] 손상은 observe로 보고된다
- 테스트: `tests/unit/indexeddb-runtime.test.ts`
- 파일: `src/adapters/storage/indexeddb/indexeddb-runtime.ts`
- 의존: T01 · 크기: M
### T25 — R-5.5 prepared-object 검증 단일화 (6.5-5) [고위험]
- 완료 조건: [x] 4MiB 청크로 저장한 객체를 정책 `chunkSizeBytes=8MiB`인 런타임에서 open, reconcile할 수 있다 [x] 검증 함수 정의는 한 곳
- 테스트: `tests/unit/opfs-worker-runtime.test.ts`, `tests/unit/indexeddb-opfs-journal.test.ts`
- 파일: 신규 공용 모듈(`src/adapters/storage/opfs/…`), `opfs-worker-runtime.ts`, `indexeddb-opfs-journal.ts`, `opfs-worker-client.ts`, INVENTORY
- 의존: T23 · 크기: M
## 레인 F — service-worker / web-push
### T26 — R-6.1 확정 이후 메시지 처리 (6.6-1)
- 완료 조건: [x] ACCEPTED 도착 시 `registration.waiting===null`, `active===worker`여도 활성화가 성공한다 [x] 관련 없는 메시지(SYNC_WAKE_OBSERVED 등)가 활성화를 실패시키지 않는다
- 테스트: page-controller 테스트
- 파일: `src/adapters/service-worker/service-worker-page-controller.ts`
- 의존: T01 · 크기: S
### T27 — R-6.2 drain 짝 맞추기 수정 (6.6-2)
- 완료 조건: [x] 빌드 N 탭과 N+1 탭이 함께 있어도 활성화가 drain을 끝내고 완료된다
- 테스트: lifecycle 테스트 + page-controller 테스트
- 파일: `service-worker-lifecycle.ts`, `service-worker-page-controller.ts`
- 의존: T26 · 크기: S
### T28 — R-6.3a reloadRequired/updateWaiting 구독 (6.6-3)
- 완료 조건: [x] host 계약에 구독 API가 추가되고, 다른 탭의 `ACTIVATED_RELOAD_REQUIRED`와 주기 update의 waiting이 구독자에게 전달된다
- 테스트: page-controller 테스트
- 파일: `service-worker-page-controller.ts`, `src/contracts/service-worker.ts`, 관련 host 타입
- 의존: T27 · 크기: M
### T29 — R-6.3b previous 캐시 fallback (6.6-3, D-7)
- 완료 조건: [x] current 캐시에 없는 hashed asset을 previous 캐시에서 제공한다 [x] hashed가 아닌 URL에는 적용되지 않는다
- 테스트: lifecycle/runtime 테스트
- 파일: `service-worker-lifecycle.ts`, 필요 시 `service-worker-static-assets.ts`
- 의존: T28 · 크기: S
### T30 — R-6.4 설치 중 워커를 ACTIVE로 보고하지 않음 (6.6-4)
- 완료 조건: [x] `installing`만 있는 등록에서 `start()`가 ACTIVE가 아닌 상태를 반환한다 [x] 설치가 끝나면 올바른 상태로 수렴한다
- 테스트: page-controller 테스트(`installing` fixture 추가)
- 파일: `service-worker-page-controller.ts`
- 의존: T27 · 크기: S
### T31 — R-6.5 MIME 동의어와 content-encoding (6.6-5)
- 완료 조건: [x] `application/javascript` 응답과 `content-encoding: gzip` + 압축 크기 Content-Length 응답이 설치된다 [x] 바이트와 sha256 검증은 유지된다
- 테스트: static-assets 테스트
- 파일: `service-worker-static-assets.ts`
- 의존: T01 · 크기: S
### T32 — R-6.6 fetch 가로채기 범위 (6.6-6)
- 완료 조건: [x] navigate, 비 GET, manifest 밖 URL에서는 `respondWith`가 호출되지 않는다 [x] manifest asset은 캐시에서 제공된다
- 테스트: service-worker entry/runtime 테스트
- 파일: `service-worker-entry.ts`, 필요 시 runtime의 `manifestUrls` 노출
- 의존: T29 · 크기: S
### T33 — R-6.7 ABSENT 재등록 조건 (6.6-7) [고위험]
- 완료 조건: [x] fence REVOKED/UNASSOCIATED + native 구독 잔존 + 서버 ABSENT → 재등록하지 않고 native를 해제한다 [x] local ACTIVE(크래시 복구)면 재등록한다
- 테스트: `tests/unit/web-push-subscription-adapter.test.ts`
- 파일: `src/adapters/web-push/push-subscription-adapter.ts`
- 의존: T01 · 크기: S
## 레인 G — contracts
### T34 — R-7.1 멱등 키 문법 (6.7-1)
- 완료 조건: [x] 앞뒤 공백, 비 ASCII, 257자 키가 거부된다 [x] UUID 등 정상 키는 통과한다 [x] 기존 고정 테스트(`legacy-and-optional-network-remediation.test.ts:136`)를 고친다
- 테스트: 위 테스트 + mutation-intent 테스트
- 파일: `src/contracts/mutation-intent.ts`
- 의존: T01 · 크기: S
### T35 — R-7.2 FEATURE_OVERRIDES 키는 금지어 검사 제외 (6.7-2)
- 완료 조건: [x] `{"FEATURE_OVERRIDES":{"cookie-consent":"DISABLED"}}`로 부팅 설정 로드가 성공한다 [x] 최상위나 다른 중첩의 금지 이름은 여전히 거부된다
- 테스트: runtime-config 테스트
- 파일: `src/contracts/env.ts`
- 의존: T01 · 크기: S
### T36 — R-7.3 매니페스트 URL 검증 (6.7-3)
- 완료 조건: [x] `"/\t/evil.example/m.json"`, 개행 포함, `/a/%2e%2e/b`가 거부된다 [x] 정상 경로는 통과한다
- 테스트: `tests/runtime-schema/runtime-config.test.ts`
- 파일: `src/contracts/release-artifacts.ts`
- 의존: T01 · 크기: S
### T37 — R-7.4 REST V2 COMMAND 메서드 규칙 (6.7-4) [고위험]
- 완료 조건: [x] `{semantics:"COMMAND", method:"GET"}`와 모르는 `semantics`/`replayPolicy` 값이 거부된다 [x] 설치된 기존 operation은 모두 통과한다
- 테스트: api-operations 테스트
- 파일: `src/contracts/api-operations.ts`
- 의존: T01 · 크기: S
### T38 — R-7.5 operationId 문법 단일화 (6.7-5)
- 완료 조건: [x] `getUser` 같은 V3 operationId의 `api.request.failed` 이벤트가 검증을 통과해 드롭되지 않는다 [x] 정의는 contracts 한 곳 [x] diagnostics도 같은 규칙
- 테스트: telemetry/diagnostics 계약 테스트
- 파일: `src/contracts/telemetry.ts`, `diagnostics.ts`, `external-contract-runtime.ts`, 공용 정의 위치
- 의존: T01 · 크기: M
## 레인 H — presentation
### T39 — R-8.1 청크 복구 상태 라우트별 초기화 (6.8-1)
- 완료 조건: [x] 라우트 A에서 청크 실패 → 라우트 B로 이동하면 B가 정상 렌더된다 [x] 실패 화면에 한 번 새로고침 버튼이 있다
- 테스트: `tests/component/chunk-recovery-boundary.test.tsx` 또는 라우터 컴포넌트 테스트
- 파일: `src/presentation/routes/app-router.tsx`, `src/presentation/boundaries/chunk-recovery-boundary.tsx`
- 의존: T01 · 크기: S
### T40 — R-8.2 WebKit/Vite 청크 실패 인식 (6.8-2)
- 완료 조건: [x] 두 메시지가 `isChunkLoadFailure`에서 true다 [x] `vite:preloadError`가 복구 경로로 이어진다
- 테스트: chunk-recovery 테스트
- 파일: `chunk-recovery-boundary.tsx`, 필요 시 `src/bootstrap/main.tsx`
- 의존: T39 · 크기: S
### T41 — R-8.8 enabled:false는 로딩 아님 (6.8-8)
- 완료 조건: [x] disabled 쿼리의 `isInitialLoading`이 false다 [x] 실제 첫 로딩은 여전히 true다
- 테스트: `tests/component/application-query*.test.tsx`
- 파일: `src/presentation/adapters/query/application-query.ts`
- 의존: T01 · 크기: XS
### T42 — R-8.4 로케일 변경 시 포커스·스크롤·재보고 없음 (6.8-4)
- 완료 조건: [x] 언어를 바꾸면 제목만 갱신되고 focus, scrollTo, reportRouteChanged가 호출되지 않는다
- 테스트: 라우터 컴포넌트 테스트
- 파일: `app-router.tsx`
- 의존: T39 · 크기: S
### T43 — R-8.5 모든 분기에서 RouteLifecycle (6.8-5)
- 완료 조건: [x] 인증필요, 잘못된 주소, 비활성 기능 화면에서 title, main focus, route 텔레메트리가 동작한다
- 테스트: 라우터 컴포넌트 테스트
- 파일: `app-router.tsx`
- 의존: T42 · 크기: S
### T44 — R-8.6 드로어 이동 시 포커스 (6.8-6)
- 완료 조건: [x] 드로어 링크로 이동하면 activeElement가 새 페이지 h1 또는 main이다 [x] Escape로 닫으면 여전히 메뉴 버튼으로 돌아간다
- 테스트: app-shell 컴포넌트 테스트
- 파일: `src/presentation/layouts/app-shell.tsx`, 필요 시 `design-system/primitives/core.tsx`
- 의존: T43 · 크기: S
### T45 — R-8.3a 로케일 저장 (6.8-3, D-5)
- 완료 조건: [x] 로케일 선택이 preferences에 저장되고 새 mount 때 저장값으로 시작한다
- 테스트: `tests/component/locale-platform.test.tsx`
- 파일: `src/presentation/i18n/locale-provider.tsx`, `src/application/ports/in/application-api.ts`, `src/application/create-application.ts`, preferences 저장 경로
- 의존: T42 · 크기: M
### T46 — R-8.3b provider를 scope fence 밖으로, router dispose (6.8-3)
- 완료 조건: [x] scope가 FENCED → READY가 되어도 LocaleProvider/ThemeProvider 상태가 유지된다 [x] AppRouter unmount 시 `router.dispose()`가 호출된다
- 테스트: 컴포넌트 테스트(세션 전환)
- 파일: `app-router.tsx`, `src/presentation/adapters/query/server-state-scope-provider.tsx`, provider 조립 위치(bootstrap/runtime-application 등)
- 의존: T45 · 크기: M
### T47 — R-8.7 context 게이트웨이 key와 청크 복구 (6.8-7)
- 완료 조건: [x] context가 바뀌면 이전 routes로 매칭하지 않는다(NOT_FOUND 텔레메트리 없음) [x] routes 모듈 로드의 청크 실패가 `recoverChunk`를 거친다
- 테스트: 라우터 컴포넌트 테스트(가짜 context 2개)
- 파일: `app-router.tsx`
- 의존: T46 · 크기: S
## 레인 I — bootstrap / platform
### T48 — R-9.1 부트 reload 세션당 1회 (6.9-1)
- 완료 조건: [x] 키가 A→B→A로 바뀌어도 TTL 안에서는 두 번째부터 `show-failure`다 [x] 기존 연속 reload 기대 테스트를 고친다
- 테스트: `tests/unit/release-mismatch-recovery.test.ts`, `tests/release/mixed-replica.test.ts`
- 파일: `src/platform/release/release-mismatch-recovery.ts`
- 의존: T01 · 크기: S
### T49 — R-9.2 중복 발생 횟수 전달 (6.9-2, D-6)
- 완료 조건: [x] 기본 스케줄(queueMicrotask)에서 같은 이벤트 1000회 → 수집기가 받는 occurrences 합계가 1000이다
- 테스트: `tests/platform/telemetry/telemetry-pipeline.test.ts`(자동 flush 켠 케이스 추가, 기존 기대값 정리)
- 파일: `src/platform/telemetry/telemetry-pipeline.ts`
- 의존: T01 · 크기: M
### T50 — R-9.3 리댁션 보강 (6.9-3) [고위험]
- 완료 조건: [x] 중간의 `Authorization: Bearer …`, URL `?access_token=…`, 이메일, `pwd`/`pass`/`auth`/`otp`/`pin` 키가 가려진다 [x] 정상 enum/id 값은 가려지지 않는다
- 테스트: redact-telemetry 테스트
- 파일: `src/platform/telemetry/redact-telemetry.ts`
- 의존: T01 · 크기: S
---
# 2차 라운드 (권장·사소 + 1차 후속)
요구사항은 `SPEC.md` "2차 라운드" 절에 있다(Q-ID = 리뷰 섹션). 공통 검증은 위와 같다. 동작을 바꾸지 않는 정리 작업은 기존 테스트가 안전망이고, 테스트가 없으면 characterization 테스트를 먼저 추가한다.
## 레인 A — browser-transfer
- [ ] T51 Q-6.1-5 worker 실패 시 나머지 worker 즉시 abort — `resumable-upload-runtime.ts`, test: `resumable-upload-runtime.test.ts`
- [ ] T52 Q-6.1-6 해석 불가 checkpoint를 abort로 정리 — `indexeddb-checkpoint-store.ts`, runtime
- [ ] T53 Q-6.1-7 PRIMARY_REQUIRED + fit 정책 검증 (D-12) — `image-cdn/image-cdn-policy.ts`
- [ ] T54 Q-6.1-8 probe decode `imageOrientation: "none"` — `image-cdn/browser-image-probe.ts`
- [ ] T55 Q-6.1-9 presigned helper 통합, statusFailure 통일, 죽은 함수 삭제, Content-Length 엄격 파싱, runtime attempt kernel화 — `presigned/*`, runtime
- [ ] T56 Q-6.1-3b part 방어적 복사 중복 제거 — `presigned/presigned-upload-part-executor.ts`, executor
- [ ] T57 Q-6.1-10 runtime 파일 분리(검증·snapshot 래퍼), 동작 불변 — `resumable-upload/*`, INVENTORY
- [ ] T58 Q-6.1-11 vault register는 snapshot만 읽음 — `presigned/presigned-capability-vault.ts`
## 레인 B — browser-files / cache-storage / cross-context
- [ ] T59 Q-6.2-6 cache 조회 비용 절감 — `cache-storage/public-response-cache-adapter.ts`
- [ ] T60 Q-6.2-7 abort race를 kernel로 — `browser-files/download-delivery-adapter.ts`, `browser-file-vault.ts`
- [ ] T61 Q-6.2-8 native cancel 관찰 시 focus fallback 끔 — `browser-files/browser-file-picker.ts`
- [ ] T62 Q-6.2-9 host factory 실패 보고와 epoch 인코딩 — `cross-context-invalidation/browser-cross-context-host.ts`
- [ ] T63 Q-6.2-10 파일명 자르기 O(n), 중복 호출 제거 — `browser-files/file-policy.ts`, download adapter
- [ ] T64 Q-6.2-11 큰 파일 두 개에서 코덱·검증 모듈 분리, 동작 불변 — cache adapter, download adapter, INVENTORY
- [ ] T65 Q-6.2-12 정규식·정수 검사 중복 통합, 죽은 분기 삭제 — `object-url-lease.ts` 등
## 레인 C — http / browser-rpc / query-cache / auth
- [ ] T66 Q-6.3-6 `terminalOutcomeFor` 통합, 백오프 중 scope fence 분류 — `http/http-execution-v3.ts`
- [ ] T67 Q-6.3-7 명령 effect 누적 합치기, MAYBE_APPLIED 재시도 금지 — `http-execution-v3.ts`
- [ ] T68 Q-6.3-8 namespace 무효화 병렬화 — `query-cache/tanstack-cache-coordinator.ts`
- [ ] T69 Q-6.3-9 RPC 명령 effect, 재시도 전 scope 확인, stream 정리 — `browser-rpc/browser-rpc-runtime.ts`
- [ ] T70 Q-6.3-11 V2 401 복구를 재시도 예산에서 분리, 롤백 seam 문서 정정 — `http/client.ts`, 관련 docs
- [ ] T71 Q-6.3-12 cursor pagination 직렬화·push, `validTransportFailure` 삭제, `W/"` ETag 거부 — query-cache, browser-rpc
- [ ] T72 Q-6.3-3b V2 5xx 비정상 바디 분류·재시도 — `http/client.ts`, `http/retry-policy.ts`(retryKinds만)
## 레인 D — realtime (+ kernel 헬퍼)
- [ ] T73 Q-6.4-5 chunk item 상한 초과 시 이어서 처리 — `sse/sse-parser.ts`
- [ ] T74 Q-6.4-6 dedupe FIFO, 해시 fingerprint, prune break — `stream-coordinator.ts`, `event-codec.ts`
- [ ] T75 Q-6.4-7 재시도 예산 초기화 조건 — `reconnect-coordinator.ts`, `reconnect-policy.ts`
- [ ] T76 Q-6.4-8 헬퍼 통합, Retry-After 파서·JSON 중복 키 스캐너를 kernel로(http `retry-policy.ts` 파싱부와 web-push `push-codec.ts` 중복 키 검사도 전환) — INVENTORY
- [ ] T77 Q-6.4-9 `endAttempt()` 추출, `_recovery` 파라미터 제거 — reconnect, websocket-connection
- [ ] T78 Q-6.4-10 probe 버퍼 상한을 현재 버퍼 기준으로 — `live-poll-handoff-coordinator.ts`
- [ ] T79 Q-6.4-11 사소 5건 — poll, sse-parser, event-codec, fetch-sse-connection, websocket-protocol
## 레인 E — storage
- [ ] T80 Q-6.5-6 openObject 사전 검증 축소, root digest는 스트림 끝에서 — `opfs/opfs-worker-client.ts`, worker runtime
- [ ] T81 Q-6.5-7 `indexeddb-records.ts`로 행 타입·검증·측정 통합, 동작 불변 — indexeddb runtime/maintenance/governance, INVENTORY
- [ ] T82 Q-6.5-8 삭제 후 revision 재시작을 port 주석과 문서로 명시 (D-13)
- [ ] T83 Q-6.5-9 보상 실패 시 원래 실패 코드 유지 — `opfs/opfs-byte-store-adapter.ts`
- [ ] T84 Q-6.5-10 kernel transaction/connection 구멍 2개 — `platform/indexeddb-transaction.ts`, `platform/indexeddb-connection.ts`
## 레인 F — service-worker / web-push
- [ ] T85 Q-6.6-6b fetch 가로채기를 same-origin GET + 해시 파일명까지 넓힘, 옛 chunk fallback 동작 — `service-worker-entry.ts`, lifecycle
- [ ] T86 Q-6.6-8 active와 같은 캐시 이름이면 실패해도 지우지 않음 — `service-worker-static-assets.ts`
- [ ] T87 Q-6.6-9 activate: 삭제 먼저, marker 실패 격리 — `service-worker-lifecycle.ts`
- [ ] T88 Q-6.6-10b 페이지 활성화 deadline 여유분 — `service-worker-page-controller.ts`
- [ ] T89 Q-6.6-11 클릭 실패 시 앱 루트, push drop 문서화 (D-14) — `web-push/inbound/*`, docs
- [ ] T90 Q-6.6-12 web-push codec primitive 통합(중복 키 스캔은 T76 담당), page controller의 document 주입 — `web-push/*`, `register-service-worker.ts`, INVENTORY
## 레인 G — contracts
- [ ] T91 Q-6.7-6 exact-key/스냅샷 단일화 + 배열 스냅샷, 우회 차단 — `exact-snapshot.ts` 외 5곳
- [ ] T92 Q-6.7-7 인덱스·레지스트리 불변화 — query-invalidation, web-worker, offline-command, runtime-capabilities
- [ ] T93 Q-6.7-8 검증기 프로토콜과 MappingResult 기준 통일 (D-15)
- [ ] T94 Q-6.7-9 REST 인증 프로필 기준 원본 단일화(V2 resolve 포함) — rest-profiles, external-contract-runtime, `http/client.ts` 호출부 한 줄
- [ ] T95 Q-6.7-10 배포 승인 사설 주소 판정 보강, 로컬 호스트 목록 단일화 — deployment-admission, browser-rpc, rest-profiles
- [ ] T96 Q-6.7-11 레지스트리 조회 `Object.hasOwn`, offline 전이 false — api-operations, storage-keys, offline-command
- [ ] T97 Q-6.7-12 release-tokens, contract-set, query-keys, dependency-cruiser 규칙
## 레인 H — presentation
- [ ] T98 Q-6.8-9 디자인시스템 링크를 router Link로, Pagination 파라미터 보존
- [ ] T99 Q-6.8-10 상태 화면 통합, 세션 액션 hook, 임시 로딩 reject 처리
- [ ] T100 Q-6.8-11 Tooltip 접근성
- [ ] T101 Q-6.8-12 Pagination windowing, landmark 중첩 제거
- [ ] T102 Q-6.8-13a `none` 코덱이 모르는 쿼리 무시 (D-16)
- [ ] T103 Q-6.8-13b 폼 이중 제출 방지, 저장 직후 dirty guard 오탐 제거
- [ ] T104 Q-6.8-13c fallback 문구 로케일, SearchField 포커스
- [ ] T105 Q-6.8-13d theme.css 분리(빌드 CSS 바이트 동일)
## 레인 I — application / features / bootstrap / platform / telemetry adapter
- [ ] T106 Q-6.9-4 텔레메트리 전송 단일화 + fetch 타임아웃(6.3-10 포함) — `src/adapters/telemetry/*`, `platform/telemetry/*`, `bootstrap/runtime-adapters.ts`
- [ ] T107 Q-6.9-5 킬스위치를 feature input에 적용 — `features/installed-feature-adapters.ts`, runtime-adapters
- [ ] T108 Q-6.9-6 featureId 중복·불일치 throw — `features/feature-adapter-contribution.ts`
- [ ] T109 Q-6.9-7 execution context 정리 API — `platform/execution/execution-context.ts`
- [ ] T110 Q-6.9-8 정적 boot shell — `index.html`, `bootstrap/main.tsx`
- [ ] T111 Q-6.9-9 reload guard 통합 — `application/use-cases/decide-chunk-recovery.ts`, `platform/release/*`
- [ ] T112 Q-6.9-10 검증 통과 값만 safe 에러에 — `bootstrap/load-runtime-config.ts`
- [ ] T113 Q-6.9-11 텔레메트리 버퍼 eviction 정정 — `platform/telemetry/telemetry-buffer.ts`
- [ ] T114 Q-6.9-12 re-export 파일 삭제, CI 정책 scripts로 이동, 메시지 로케일 도출
## 통합
- [ ] T115 Q-B 번들 예산 통과(코드 축소, D-11)