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>
29 KiB
29 KiB
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] demosetState는 같은 값이면 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_VIOLATIONResult가 반환되고 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 테스트(
installingfixture 추가) - 파일:
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-pushpush-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)