diff --git a/tasks/plan.md b/tasks/plan.md index 5844bf5f..45ea3ec1 100644 --- a/tasks/plan.md +++ b/tasks/plan.md @@ -120,3 +120,24 @@ - 실행 방식: 1차와 같다. 레인 A–I를 병렬 worktree에서 진행하고, 레인마다 cherry-pick한 뒤 전체 게이트를 돌린다. 마지막 T115(번들 예산)는 통합 단계에서 한다. - 레인 사이 공유 파일: `http/retry-policy.ts`(C는 retryKinds, D는 Retry-After 파서), `http/client.ts`(C, 그리고 G의 한 줄), `web-push/push-codec.ts`(D는 중복 키 스캔, F는 나머지), `INVENTORY.md`. 충돌이 나면 통합 단계에서 해결한다. - 최종 확인: 1차와 같은 게이트 목록 + `check:optional-recipes` + Playwright(Chromium/Firefox). + +## 2차 결과 (2026-09-24) + +T51–T115를 모두 커밋했다. 레인 9개와 T115를 병합할 때마다 전체 게이트를 돌렸다. + +깨끗한 체크아웃 기준 최종 결과: +- 통과: check:architecture, check:types, lint, runtime-schema(55), unit(2057), contract(14), component(177), integration(110), recipes(17), reference-feature(59), platform(248), release-coherence(46), adapter-inventory(래칫 17/17), registries, ci, diagnostics, i18n, design-system, realtime-boundaries, verify:documentation, build, **check:optional-recipes** + - 번들 예산: file-transfer 54562/54600, offline-indexeddb 35854/36000, realtime 39685/40000, service-worker-pwa 9500/10000 +- Playwright(Chromium·Firefox): e2e 66, browser-capabilities 30 전부 통과. WebKit은 이 머신에서 실행 불가 + +사용자가 알아야 할 동작 변경은 커밋 메시지와 각 Q-ID에 적었다. 주요 항목: +- presigned provider의 401/403/429/5xx recovery가 REISSUE_CAPABILITY로 통일됐다(T55) +- contracts 레지스트리가 accessor, 비열거 키, 커스텀 prototype을 거부한다(T91) +- 킬스위치로 끈 feature는 API를 받지 않는다(T107) +- 텔레메트리 전송 한도는 두 포트 합쳐 분당 20회다(T106) +- 플랫폼 라우트는 모르는 쿼리를 무시한다(T102) + +남은 것: +- file-transfer 번들 여유가 38바이트뿐이다 +- V2에서 408/425는 SERVER_FAILURE로 분류되지만 재시도하지 않는다(T72) +- Retry-After 복사본 2곳(http client, resumable fetch transport)은 커널로 옮기지 않았다 diff --git a/tasks/todo.md b/tasks/todo.md index 077eb0c5..0ba96b02 100644 --- a/tasks/todo.md +++ b/tasks/todo.md @@ -343,86 +343,86 @@ 요구사항은 `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` +- [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 -- [ ] 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` 등 +- [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 -- [ ] 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만) +- [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 헬퍼) -- [ ] 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 +- [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 -- [ ] 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` +- [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 -- [ ] 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 +- [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 -- [ ] 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 규칙 +- [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 -- [ ] 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 바이트 동일) +- [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 -- [ ] 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로 이동, 메시지 로케일 도출 +- [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로 이동, 메시지 로케일 도출 ## 통합 -- [ ] T115 Q-B 번들 예산 통과(코드 축소, D-11) +- [x] T115 Q-B 번들 예산 통과(코드 축소, D-11)