# 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 ` - [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 - [x] T51 Q-6.1-5 worker 실패 시 나머지 worker 즉시 abort — `resumable-upload-runtime.ts`, test: `resumable-upload-runtime.test.ts` - [x] T52 Q-6.1-6 해석 불가 checkpoint를 abort로 정리 — `indexeddb-checkpoint-store.ts`, runtime - [x] T53 Q-6.1-7 PRIMARY_REQUIRED + fit 정책 검증 (D-12) — `image-cdn/image-cdn-policy.ts` - [x] T54 Q-6.1-8 probe decode `imageOrientation: "none"` — `image-cdn/browser-image-probe.ts` - [x] T55 Q-6.1-9 presigned helper 통합, statusFailure 통일, 죽은 함수 삭제, Content-Length 엄격 파싱, runtime attempt kernel화 — `presigned/*`, runtime - [x] T56 Q-6.1-3b part 방어적 복사 중복 제거 — `presigned/presigned-upload-part-executor.ts`, executor - [x] T57 Q-6.1-10 runtime 파일 분리(검증·snapshot 래퍼), 동작 불변 — `resumable-upload/*`, INVENTORY - [x] T58 Q-6.1-11 vault register는 snapshot만 읽음 — `presigned/presigned-capability-vault.ts` ## 레인 B — browser-files / cache-storage / cross-context - [x] T59 Q-6.2-6 cache 조회 비용 절감 — `cache-storage/public-response-cache-adapter.ts` - [x] T60 Q-6.2-7 abort race를 kernel로 — `browser-files/download-delivery-adapter.ts`, `browser-file-vault.ts` - [x] T61 Q-6.2-8 native cancel 관찰 시 focus fallback 끔 — `browser-files/browser-file-picker.ts` - [x] T62 Q-6.2-9 host factory 실패 보고와 epoch 인코딩 — `cross-context-invalidation/browser-cross-context-host.ts` - [x] T63 Q-6.2-10 파일명 자르기 O(n), 중복 호출 제거 — `browser-files/file-policy.ts`, download adapter - [x] T64 Q-6.2-11 큰 파일 두 개에서 코덱·검증 모듈 분리, 동작 불변 — cache adapter, download adapter, INVENTORY - [x] T65 Q-6.2-12 정규식·정수 검사 중복 통합, 죽은 분기 삭제 — `object-url-lease.ts` 등 ## 레인 C — http / browser-rpc / query-cache / auth - [x] T66 Q-6.3-6 `terminalOutcomeFor` 통합, 백오프 중 scope fence 분류 — `http/http-execution-v3.ts` - [x] T67 Q-6.3-7 명령 effect 누적 합치기, MAYBE_APPLIED 재시도 금지 — `http-execution-v3.ts` - [x] T68 Q-6.3-8 namespace 무효화 병렬화 — `query-cache/tanstack-cache-coordinator.ts` - [x] T69 Q-6.3-9 RPC 명령 effect, 재시도 전 scope 확인, stream 정리 — `browser-rpc/browser-rpc-runtime.ts` - [x] T70 Q-6.3-11 V2 401 복구를 재시도 예산에서 분리, 롤백 seam 문서 정정 — `http/client.ts`, 관련 docs - [x] T71 Q-6.3-12 cursor pagination 직렬화·push, `validTransportFailure` 삭제, `W/"` ETag 거부 — query-cache, browser-rpc - [x] T72 Q-6.3-3b V2 5xx 비정상 바디 분류·재시도 — `http/client.ts`, `http/retry-policy.ts`(retryKinds만) ## 레인 D — realtime (+ kernel 헬퍼) - [x] T73 Q-6.4-5 chunk item 상한 초과 시 이어서 처리 — `sse/sse-parser.ts` - [x] T74 Q-6.4-6 dedupe FIFO, 해시 fingerprint, prune break — `stream-coordinator.ts`, `event-codec.ts` - [x] T75 Q-6.4-7 재시도 예산 초기화 조건 — `reconnect-coordinator.ts`, `reconnect-policy.ts` - [x] T76 Q-6.4-8 헬퍼 통합, Retry-After 파서·JSON 중복 키 스캐너를 kernel로(http `retry-policy.ts` 파싱부와 web-push `push-codec.ts` 중복 키 검사도 전환) — INVENTORY - [x] T77 Q-6.4-9 `endAttempt()` 추출, `_recovery` 파라미터 제거 — reconnect, websocket-connection - [x] T78 Q-6.4-10 probe 버퍼 상한을 현재 버퍼 기준으로 — `live-poll-handoff-coordinator.ts` - [x] T79 Q-6.4-11 사소 5건 — poll, sse-parser, event-codec, fetch-sse-connection, websocket-protocol ## 레인 E — storage - [x] T80 Q-6.5-6 openObject 사전 검증 축소, root digest는 스트림 끝에서 — `opfs/opfs-worker-client.ts`, worker runtime - [x] T81 Q-6.5-7 `indexeddb-records.ts`로 행 타입·검증·측정 통합, 동작 불변 — indexeddb runtime/maintenance/governance, INVENTORY - [x] T82 Q-6.5-8 삭제 후 revision 재시작을 port 주석과 문서로 명시 (D-13) - [x] T83 Q-6.5-9 보상 실패 시 원래 실패 코드 유지 — `opfs/opfs-byte-store-adapter.ts` - [x] T84 Q-6.5-10 kernel transaction/connection 구멍 2개 — `platform/indexeddb-transaction.ts`, `platform/indexeddb-connection.ts` ## 레인 F — service-worker / web-push - [x] T85 Q-6.6-6b fetch 가로채기를 same-origin GET + 해시 파일명까지 넓힘, 옛 chunk fallback 동작 — `service-worker-entry.ts`, lifecycle - [x] T86 Q-6.6-8 active와 같은 캐시 이름이면 실패해도 지우지 않음 — `service-worker-static-assets.ts` - [x] T87 Q-6.6-9 activate: 삭제 먼저, marker 실패 격리 — `service-worker-lifecycle.ts` - [x] T88 Q-6.6-10b 페이지 활성화 deadline 여유분 — `service-worker-page-controller.ts` - [x] T89 Q-6.6-11 클릭 실패 시 앱 루트, push drop 문서화 (D-14) — `web-push/inbound/*`, docs - [x] T90 Q-6.6-12 web-push codec primitive 통합(중복 키 스캔은 T76 담당), page controller의 document 주입 — `web-push/*`, `register-service-worker.ts`, INVENTORY ## 레인 G — contracts - [x] T91 Q-6.7-6 exact-key/스냅샷 단일화 + 배열 스냅샷, 우회 차단 — `exact-snapshot.ts` 외 5곳 - [x] T92 Q-6.7-7 인덱스·레지스트리 불변화 — query-invalidation, web-worker, offline-command, runtime-capabilities - [x] T93 Q-6.7-8 검증기 프로토콜과 MappingResult 기준 통일 (D-15) - [x] T94 Q-6.7-9 REST 인증 프로필 기준 원본 단일화(V2 resolve 포함) — rest-profiles, external-contract-runtime, `http/client.ts` 호출부 한 줄 - [x] T95 Q-6.7-10 배포 승인 사설 주소 판정 보강, 로컬 호스트 목록 단일화 — deployment-admission, browser-rpc, rest-profiles - [x] T96 Q-6.7-11 레지스트리 조회 `Object.hasOwn`, offline 전이 false — api-operations, storage-keys, offline-command - [x] T97 Q-6.7-12 release-tokens, contract-set, query-keys, dependency-cruiser 규칙 ## 레인 H — presentation - [x] T98 Q-6.8-9 디자인시스템 링크를 router Link로, Pagination 파라미터 보존 - [x] T99 Q-6.8-10 상태 화면 통합, 세션 액션 hook, 임시 로딩 reject 처리 - [x] T100 Q-6.8-11 Tooltip 접근성 - [x] T101 Q-6.8-12 Pagination windowing, landmark 중첩 제거 - [x] T102 Q-6.8-13a `none` 코덱이 모르는 쿼리 무시 (D-16) - [x] T103 Q-6.8-13b 폼 이중 제출 방지, 저장 직후 dirty guard 오탐 제거 - [x] T104 Q-6.8-13c fallback 문구 로케일, SearchField 포커스 - [x] T105 Q-6.8-13d theme.css 분리(빌드 CSS 바이트 동일) ## 레인 I — application / features / bootstrap / platform / telemetry adapter - [x] T106 Q-6.9-4 텔레메트리 전송 단일화 + fetch 타임아웃(6.3-10 포함) — `src/adapters/telemetry/*`, `platform/telemetry/*`, `bootstrap/runtime-adapters.ts` - [x] T107 Q-6.9-5 킬스위치를 feature input에 적용 — `features/installed-feature-adapters.ts`, runtime-adapters - [x] T108 Q-6.9-6 featureId 중복·불일치 throw — `features/feature-adapter-contribution.ts` - [x] T109 Q-6.9-7 execution context 정리 API — `platform/execution/execution-context.ts` - [x] T110 Q-6.9-8 정적 boot shell — `index.html`, `bootstrap/main.tsx` - [x] T111 Q-6.9-9 reload guard 통합 — `application/use-cases/decide-chunk-recovery.ts`, `platform/release/*` - [x] T112 Q-6.9-10 검증 통과 값만 safe 에러에 — `bootstrap/load-runtime-config.ts` - [x] T113 Q-6.9-11 텔레메트리 버퍼 eviction 정정 — `platform/telemetry/telemetry-buffer.ts` - [x] T114 Q-6.9-12 re-export 파일 삭제, CI 정책 scripts로 이동, 메시지 로케일 도출 ## 통합 - [x] T115 Q-B 번들 예산 통과(코드 축소, D-11) --- # 3차 라운드 (남은 문제 8건) - [ ] T116 R3-1 V2 408/425 재시도 + client Retry-After를 kernel로 — `http/client.ts`, `http/retry-policy.ts` - [ ] T117 R3-2 fetch transport Retry-After를 kernel로 + file-transfer 번들 여유 546B 이상 — browser-transfer - [ ] T118 R3-3 demo subject 제공, 외부 owner 문서 — `auth/external-session-adapter.ts`, docs - [ ] T119 R3-4 `idle` 비동기 상태 — `application/view-models/async-state.ts`, presentation - [ ] T120 R3-5 SSE 바이트 단위 파싱 — `realtime/sse/*` - [ ] T121 R3-6 실제 브라우저 Playwright 스펙 — `tests/e2e`, `tests/browser-capabilities` - [ ] T122 R3-7 WebKit 전체 실행 - [ ] T123 R3-8 push + Gitea PR