Files
clean-architecture-frontend…/tasks/todo.md
T

30 KiB
Raw Blame History

Tasks: src 리뷰 긴급·필수 항목 수정

각 작업의 문제 설명은 docs/reviews/2026-09-24-src-full-review.md 해당 섹션을 본다. 요구사항은 SPEC.md, 실행 방식은 tasks/plan.md에 있다.

모든 작업에 공통인 검증

  • RED: 재현 테스트가 수정 전에 실패한다
  • GREEN: 해당 테스트 파일 통과 — node scripts/run-vitest.ts run <test file>
  • 게이트 통과 — 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
  • adapter 파일을 추가하거나 이동했으면 docs/reviews/adapters/INVENTORY.md를 갱신하고 corepack pnpm check:adapter-inventory 통과
  • 커밋 1개, 메시지에 R-ID 포함, 해당 작업 파일만 스테이징

Phase 0

T01 — R-0 깨끗한 체크아웃에서 게이트 동작 (리뷰 6.0)

  • 완료 조건:
    • rm -rf src/.generated 뒤 dev(기동까지), build, check:architecture, check:types:app, test:unit, test:component, verify:documentation이 통과한다
    • 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)

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