From ee98444c43044f2053884d158e86e1b1f8f87b31 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Thu, 24 Sep 2026 12:46:47 +0900 Subject: [PATCH] docs: record src review fix results and open decisions Mark all 50 tasks done, record the fresh-checkout gate results, the two out-of-plan fixes (R-0 follow-up, inventory rows) and the decisions left for the user (bundle budgets, SW fallback scope, session subject, disabled query state, SSE multibyte speedup, V2 5xx). Co-Authored-By: Claude Opus 5.5 --- tasks/plan.md | 53 +++++++++++++++++-------- tasks/todo.md | 108 +++++++++++++++++++++++++------------------------- 2 files changed, 90 insertions(+), 71 deletions(-) diff --git a/tasks/plan.md b/tasks/plan.md index ca69755f..bc4a1bd6 100644 --- a/tasks/plan.md +++ b/tasks/plan.md @@ -41,27 +41,27 @@ - [x] T01 R-0 깨끗한 체크아웃에서 게이트 동작 ### Checkpoint 0 -- [ ] `src/.generated` 삭제 후 arch/types/lint/unit/component/verify:documentation 통과 +- [x] `src/.generated` 삭제 후 arch/types/lint/unit/component/verify:documentation 통과 ### Phase 1: 레인 A–I (병렬) -- [ ] 레인 A: T02–T05 -- [ ] 레인 B: T06–T10 -- [ ] 레인 C: T11–T16 (고위험 T12, T13, T15 포함) -- [ ] 레인 D: T17–T20 -- [ ] 레인 E: T21–T25 (고위험 T21, T22, T24, T25 포함) -- [ ] 레인 F: T26–T33 (고위험 T33 포함) -- [ ] 레인 G: T34–T38 (고위험 T37 포함) -- [ ] 레인 H: T39–T47 -- [ ] 레인 I: T48–T50 (고위험 T50 포함) +- [x] 레인 A: T02–T05 +- [x] 레인 B: T06–T10 +- [x] 레인 C: T11–T16 (고위험 T12, T13, T15 포함) +- [x] 레인 D: T17–T20 +- [x] 레인 E: T21–T25 (고위험 T21, T22, T24, T25 포함) +- [x] 레인 F: T26–T33 (고위험 T33 포함) +- [x] 레인 G: T34–T38 (고위험 T37 포함) +- [x] 레인 H: T39–T47 +- [x] 레인 I: T48–T50 (고위험 T50 포함) ### Checkpoint 레인별 (통합할 때마다) -- [ ] check:architecture, check:types:app, check:types:test, lint, test:unit, test:component 통과 -- [ ] adapter 파일을 바꿨으면 check:adapter-inventory 통과 +- [x] check:architecture, check:types:app, check:types:test, lint, test:unit, test:component 통과 +- [x] adapter 파일을 바꿨으면 check:adapter-inventory 통과 ### Checkpoint 최종 -- [ ] 위 게이트 + `corepack pnpm build` 통과 -- [ ] 깨끗한 체크아웃 재현 통과 -- [ ] 리뷰 문서의 해당 항목 47개에 해결 커밋을 대응(todo 체크) +- [x] 위 게이트 + `corepack pnpm build` 통과 +- [x] 깨끗한 체크아웃 재현 통과 +- [x] 리뷰 문서의 해당 항목 47개에 해결 커밋을 대응(todo 체크) ## 고위험 작업 (계획 승인 = 이 작업들의 사전 승인) @@ -88,6 +88,25 @@ | T20 성능 요구(10배)는 CI에서 측정하기 불안정 | Low | 정확성 테스트는 자동, 성능은 벤치 스크립트 수동 측정값을 커밋 메시지에 기록 | | R-0 방식이 pnpm pre/post 훅에 의존하면 환경마다 다름 | Med | 훅에 의존하지 않고 진입점에서 명시적으로 생성 | -## Open Questions +## 결과 (2026-09-24) -- 없음. 방향이 여러 개인 항목은 SPEC.md의 D-1 ~ D-7로 정했다. 승인하면 그대로 진행한다. +50개 작업을 모두 커밋했다. 레인 9개를 병합할 때마다 전체 게이트를 돌렸다. + +깨끗한 체크아웃(`src/.generated` 삭제) 기준 최종 게이트 결과: +- 통과: check:architecture, check:types, lint, test:runtime-schema(53), test:unit(1890), test:contract(12), test:component(149), test:integration(104), test:recipes(17), test:reference-feature(56), test:platform(245), check:release-coherence(46), check:adapter-inventory, check:registries, check:ci, verify:documentation, build +- Playwright: test:e2e는 Chromium·Firefox 전부 통과, test:browser-capabilities도 Chromium·Firefox 전부 통과. WebKit은 이 머신에 시스템 의존성이 없어 실행 자체가 안 됨(`playwright install-deps` 필요) + +계획 밖에서 추가로 한 일: +- R-0 1차 수정이 진입점 36개를 놓쳤다. 여기에는 CI 게이트 실행기 `ci:gate`와 `check:ci`가 포함된다. 가드 테스트가 import를 따라가 검사하도록 바꾸고 누락분을 채웠다(`7dfb89f`). +- `check:adapter-inventory`가 기준 브랜치에서도 실패하고 있었다(6f6c48e에서 추가한 파일 2개가 인벤토리에 없음). 행을 추가했다(`2fb07c8`). + +## Open Questions (사용자 결정 필요) + +1. **번들 예산**: `check:optional-recipes`가 기준 커밋부터 실패하고 있었다. 기준 커밋 대비 file-transfer는 99바이트 줄었고, realtime은 초과폭이 9바이트에서 139바이트로 늘었다. offline-indexeddb는 이번 수정으로 예산을 56바이트 새로 넘었다. 예산을 올릴지, 코드를 줄일지 결정이 필요하다. +2. **T29(R-6.3b) vs T32(R-6.6)**: fetch를 manifest URL로만 가로채도록 좁혔기 때문에, 이전 캐시 fallback은 현재 manifest에 있는 URL에만 적용된다. 리뷰의 원래 시나리오(옛 빌드 lazy chunk)는 여전히 네트워크로만 간다. 가로채는 범위를 "same-origin GET + 해시 파일명"으로 넓힐지 결정이 필요하다. +3. **T12(R-3.2a)**: 기존 owner는 subject를 제공하지 않는다. 그래서 인증 상태에서 인증 상태로 오는 알림(토큰 갱신 등)은 owner가 `readSubject`를 구현하기 전까지 여전히 캐시를 비운다. fail-closed 기본값이다. +4. **T41(R-8.8)**: disabled 쿼리는 이제 `empty`("데이터가 없습니다")로 보인다. 의존 쿼리에 이 화면이 맞지 않다면 `idle` 상태를 따로 만들어야 한다. +5. **T20(R-4.4)**: 250KB 벤치에서 ASCII는 36~80배 빨라졌지만 멀티바이트 위주 입력은 약 5배에 그쳤다. 10배 목표는 ASCII만 달성했다. +6. **T14(R-3.3)**: V2 client(`client.ts`)는 바꾸지 않았다. V2에서 HTML 바디 502는 여전히 CONTENT_TYPE_MISMATCH이고 재시도하지 않는다. + +실제 브라우저에서 따로 확인해야 하는 항목: SW 두 빌드 간 업데이트 순서(T26~T30), 실제 서버의 MIME·gzip 응답(T31), 네이티브 file picker 호출(T09), `Cache.match`와 Vary(T10), 멀티 탭 OPFS 경합(T22), 모바일 드로어 포커스(T44), Safari 청크 오류 메시지(T40). WebKit 계열은 전부 미검증이다. diff --git a/tasks/todo.md b/tasks/todo.md index d520148f..b774db06 100644 --- a/tasks/todo.md +++ b/tasks/todo.md @@ -4,11 +4,11 @@ ## 모든 작업에 공통인 검증 -- [ ] RED: 재현 테스트가 수정 전에 실패한다 -- [ ] GREEN: 해당 테스트 파일 통과 — `node scripts/run-vitest.ts run ` -- [ ] 게이트 통과 — `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 포함, 해당 작업 파일만 스테이징 +- [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 포함, 해당 작업 파일만 스테이징 --- @@ -27,25 +27,25 @@ ## 레인 A — browser-transfer ### T02 — R-1.1 dispose 재시도 가능 (6.1-1) -- 완료 조건: [ ] deadline 초과 뒤 작업이 끝나면 두 번째 `dispose()`가 성공하고 `lifecycle()==="CLOSED"`, checkpoint store가 닫힌다 +- 완료 조건: [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) -- 완료 조건: [ ] `maxFileBytes`/`maxPartCount` 초과 upload가 `LIMIT_EXCEEDED`를 반환한다 +- 완료 조건: [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) -- 완료 조건: [ ] `-`/`_`로 시작하는 43자 base64url ID가 session, part 발급, download 발급까지 통과한다 [ ] 정규식 정의는 한 곳 +- 완료 조건: [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) -- 완료 조건: [ ] 정책 검증이 `partSize×maxConcurrency×copyFactor > maxInFlightBytes`를 거절한다 [ ] 기본 정책이 검증을 통과한다 [ ] createSession이 실제 worker 수를 요청한다 +- 완료 조건: [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 @@ -53,31 +53,31 @@ ## 레인 B — browser-files / cache-storage / cross-context ### T06 — R-2.1 BOUNDED_OBJECT_URL open 실패 시 Result 반환 (6.2-1) -- 완료 조건: [ ] presigned source + BOUNDED_OBJECT_URL에서 open 중 abort하면 `deliver()`가 `{ok:false, ABORTED}`로 resolve된다 [ ] 늦게 온 lease가 닫힌다 +- 완료 조건: [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) -- 완료 조건: [ ] 같은 source의 seq 1 → 61초 뒤 seq 2가 `NEXT`로 전달된다 [ ] watermark 메모리는 `sourceCapacity`로만 제한된다 +- 완료 조건: [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) -- 완료 조건: [ ] postMessage가 한 번 실패한 탭이 다른 탭의 broadcast를 계속 받는다 [ ] BroadcastChannel을 만들 수 없는 탭의 status가 DEGRADED다 +- 완료 조건: [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) -- 완료 조건: [ ] `this`가 options이면 throw하는 fake picker를 주입해도 picker와 save가 동작한다 +- 완료 조건: [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) -- 완료 조건: [ ] 기본 정책으로 `Vary: Accept-Encoding` 응답을 stage하고 activate할 수 있다 [ ] `content-type`이 없는 정책은 `assertPublicCachePolicy`가 거부한다 +- 완료 조건: [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 @@ -85,37 +85,37 @@ ## 레인 C — http / query-cache / auth ### T11 — R-3.1 경로 값 `.`/`..` 거부 (6.3-1) -- 완료 조건: [ ] V3 bridge가 `PATH_VALUE_INVALID`, V2 request-builder가 `PATH_PARAMETER_INVALID`를 반환한다(`"."`, `".."` 각각) +- 완료 조건: [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) [고위험] -- 완료 조건: [ ] 같은 (상태, 주체) 알림은 fence·abort·cache clear를 일으키지 않는다 [ ] 상태나 주체가 바뀌면 여전히 fence된다 +- 완료 조건: [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) [고위험] -- 완료 조건: [ ] V3 요청 전 자격증명 없음은 `onUnauthenticated`를 호출하지 않는다 [ ] 서버 401은 호출한다 [ ] demo `setState`는 같은 값이면 listener를 부르지 않는다 +- 완료 조건: [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) -- 완료 조건: [ ] HTML/빈 바디 502/503/504가 status를 담은 서버 장애(재시도 가능)로 끝난다 [ ] 바인딩 결과가 `contact-support`가 아니다 [ ] `FINAL_REQUEST_INVARIANT_FAILED`/`MISSING_IDEMPOTENCY_KEY`가 `ENVELOPE_MISMATCH`로 매핑되지 않는다 +- 완료 조건: [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) [고위험] -- 완료 조건: [ ] NUL, 비 Latin-1, 제어문자가 든 값이 전송 전에 `CREDENTIAL_HEADER_VALUE_INVALID`가 된다(NETWORK_FAILURE 아님) [ ] 대소문자만 다른 중복 헤더가 거부된다 [ ] 정상 Bearer 토큰은 통과한다 +- 완료 조건: [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) -- 완료 조건: [ ] `mapSuccess`/`mapProblem`이 throw하면 `MAPPING_CONTRACT_VIOLATION` Result가 반환되고 effect가 보존된다 +- 완료 조건: [x] `mapSuccess`/`mapProblem`이 throw하면 `MAPPING_CONTRACT_VIOLATION` Result가 반환되고 effect가 보존된다 - 테스트: feature-http-binding 테스트 - 파일: `feature-http-binding.ts` - 의존: T14 · 크기: S @@ -123,25 +123,25 @@ ## 레인 D — realtime ### T17 — R-4.2 hint 없는 retryable 실패도 재연결 (6.4-2) -- 완료 조건: [ ] WS `NETWORK_LOST`/`RESTART`, SSE 502/504(hint 없음)가 재연결된다 [ ] polling도 같다 [ ] `retryable:false`는 여전히 종료된다 +- 완료 조건: [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) -- 완료 조건: [ ] quiescence를 기다리는 동안 effect가 DRAINING이 되면 recovery가 authority를 호출하지 않고 실패한다 +- 완료 조건: [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) -- 완료 조건: [ ] SNAPSHOT_ONLY + barrier NONE 스트림에서 gap → recovery 뒤 연결이 유지되고 PROTOCOL_MISMATCH가 나지 않는다 +- 완료 조건: [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) -- 완료 조건: [ ] 기존 파서 테스트가 모두 통과한다(CRLF, 분할 chunk, BOM 등) [ ] 250KB chunk 벤치에서 10배 이상 빨라진다(수동 측정값을 커밋 메시지에 기록) +- 완료 조건: [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 @@ -149,31 +149,31 @@ ## 레인 E — storage ### T21 — R-5.1 orphan 후보 커서 (6.5-1) [고위험] -- 완료 조건: [ ] 참조 중 청크 150개 뒤에 있는 orphan이 reconcile로 지워진다 [ ] 참조 중 청크는 지워지지 않는다 +- 완료 조건: [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) [고위험] -- 완료 조건: [ ] 같은 digest를 다시 쓰면 청크의 mtime이 갱신되어 `listOrphanCandidates`에 나오지 않는다 +- 완료 조건: [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) -- 완료 조건: [ ] 긴 put이 lock을 잡고 있어도 뒤에 온 put/remove가 60초에 실패하지 않고 lock을 얻은 뒤 진행된다 [ ] lock 대기는 정책값 상한으로 끝난다 +- 완료 조건: [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) [고위험] -- 완료 조건: [ ] 손상 record/sidecar/budget이 섞인 파티션에서 LOGOUT/ACCOUNT_DELETION purge가 COMPLETE된다 [ ] 다른 파티션의 행은 남는다 [ ] 손상은 observe로 보고된다 +- 완료 조건: [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) [고위험] -- 완료 조건: [ ] 4MiB 청크로 저장한 객체를 정책 `chunkSizeBytes=8MiB`인 런타임에서 open, reconcile할 수 있다 [ ] 검증 함수 정의는 한 곳 +- 완료 조건: [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 @@ -181,49 +181,49 @@ ## 레인 F — service-worker / web-push ### T26 — R-6.1 확정 이후 메시지 처리 (6.6-1) -- 완료 조건: [ ] ACCEPTED 도착 시 `registration.waiting===null`, `active===worker`여도 활성화가 성공한다 [ ] 관련 없는 메시지(SYNC_WAKE_OBSERVED 등)가 활성화를 실패시키지 않는다 +- 완료 조건: [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) -- 완료 조건: [ ] 빌드 N 탭과 N+1 탭이 함께 있어도 활성화가 drain을 끝내고 완료된다 +- 완료 조건: [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) -- 완료 조건: [ ] host 계약에 구독 API가 추가되고, 다른 탭의 `ACTIVATED_RELOAD_REQUIRED`와 주기 update의 waiting이 구독자에게 전달된다 +- 완료 조건: [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) -- 완료 조건: [ ] current 캐시에 없는 hashed asset을 previous 캐시에서 제공한다 [ ] hashed가 아닌 URL에는 적용되지 않는다 +- 완료 조건: [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) -- 완료 조건: [ ] `installing`만 있는 등록에서 `start()`가 ACTIVE가 아닌 상태를 반환한다 [ ] 설치가 끝나면 올바른 상태로 수렴한다 +- 완료 조건: [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) -- 완료 조건: [ ] `application/javascript` 응답과 `content-encoding: gzip` + 압축 크기 Content-Length 응답이 설치된다 [ ] 바이트와 sha256 검증은 유지된다 +- 완료 조건: [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) -- 완료 조건: [ ] navigate, 비 GET, manifest 밖 URL에서는 `respondWith`가 호출되지 않는다 [ ] manifest asset은 캐시에서 제공된다 +- 완료 조건: [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) [고위험] -- 완료 조건: [ ] fence REVOKED/UNASSOCIATED + native 구독 잔존 + 서버 ABSENT → 재등록하지 않고 native를 해제한다 [ ] local ACTIVE(크래시 복구)면 재등록한다 +- 완료 조건: [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 @@ -231,31 +231,31 @@ ## 레인 G — contracts ### T34 — R-7.1 멱등 키 문법 (6.7-1) -- 완료 조건: [ ] 앞뒤 공백, 비 ASCII, 257자 키가 거부된다 [ ] UUID 등 정상 키는 통과한다 [ ] 기존 고정 테스트(`legacy-and-optional-network-remediation.test.ts:136`)를 고친다 +- 완료 조건: [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) -- 완료 조건: [ ] `{"FEATURE_OVERRIDES":{"cookie-consent":"DISABLED"}}`로 부팅 설정 로드가 성공한다 [ ] 최상위나 다른 중첩의 금지 이름은 여전히 거부된다 +- 완료 조건: [x] `{"FEATURE_OVERRIDES":{"cookie-consent":"DISABLED"}}`로 부팅 설정 로드가 성공한다 [x] 최상위나 다른 중첩의 금지 이름은 여전히 거부된다 - 테스트: runtime-config 테스트 - 파일: `src/contracts/env.ts` - 의존: T01 · 크기: S ### T36 — R-7.3 매니페스트 URL 검증 (6.7-3) -- 완료 조건: [ ] `"/\t/evil.example/m.json"`, 개행 포함, `/a/%2e%2e/b`가 거부된다 [ ] 정상 경로는 통과한다 +- 완료 조건: [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) [고위험] -- 완료 조건: [ ] `{semantics:"COMMAND", method:"GET"}`와 모르는 `semantics`/`replayPolicy` 값이 거부된다 [ ] 설치된 기존 operation은 모두 통과한다 +- 완료 조건: [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) -- 완료 조건: [ ] `getUser` 같은 V3 operationId의 `api.request.failed` 이벤트가 검증을 통과해 드롭되지 않는다 [ ] 정의는 contracts 한 곳 [ ] diagnostics도 같은 규칙 +- 완료 조건: [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 @@ -263,55 +263,55 @@ ## 레인 H — presentation ### T39 — R-8.1 청크 복구 상태 라우트별 초기화 (6.8-1) -- 완료 조건: [ ] 라우트 A에서 청크 실패 → 라우트 B로 이동하면 B가 정상 렌더된다 [ ] 실패 화면에 한 번 새로고침 버튼이 있다 +- 완료 조건: [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) -- 완료 조건: [ ] 두 메시지가 `isChunkLoadFailure`에서 true다 [ ] `vite:preloadError`가 복구 경로로 이어진다 +- 완료 조건: [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) -- 완료 조건: [ ] disabled 쿼리의 `isInitialLoading`이 false다 [ ] 실제 첫 로딩은 여전히 true다 +- 완료 조건: [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) -- 완료 조건: [ ] 언어를 바꾸면 제목만 갱신되고 focus, scrollTo, reportRouteChanged가 호출되지 않는다 +- 완료 조건: [x] 언어를 바꾸면 제목만 갱신되고 focus, scrollTo, reportRouteChanged가 호출되지 않는다 - 테스트: 라우터 컴포넌트 테스트 - 파일: `app-router.tsx` - 의존: T39 · 크기: S ### T43 — R-8.5 모든 분기에서 RouteLifecycle (6.8-5) -- 완료 조건: [ ] 인증필요, 잘못된 주소, 비활성 기능 화면에서 title, main focus, route 텔레메트리가 동작한다 +- 완료 조건: [x] 인증필요, 잘못된 주소, 비활성 기능 화면에서 title, main focus, route 텔레메트리가 동작한다 - 테스트: 라우터 컴포넌트 테스트 - 파일: `app-router.tsx` - 의존: T42 · 크기: S ### T44 — R-8.6 드로어 이동 시 포커스 (6.8-6) -- 완료 조건: [ ] 드로어 링크로 이동하면 activeElement가 새 페이지 h1 또는 main이다 [ ] Escape로 닫으면 여전히 메뉴 버튼으로 돌아간다 +- 완료 조건: [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) -- 완료 조건: [ ] 로케일 선택이 preferences에 저장되고 새 mount 때 저장값으로 시작한다 +- 완료 조건: [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) -- 완료 조건: [ ] scope가 FENCED → READY가 되어도 LocaleProvider/ThemeProvider 상태가 유지된다 [ ] AppRouter unmount 시 `router.dispose()`가 호출된다 +- 완료 조건: [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) -- 완료 조건: [ ] context가 바뀌면 이전 routes로 매칭하지 않는다(NOT_FOUND 텔레메트리 없음) [ ] routes 모듈 로드의 청크 실패가 `recoverChunk`를 거친다 +- 완료 조건: [x] context가 바뀌면 이전 routes로 매칭하지 않는다(NOT_FOUND 텔레메트리 없음) [x] routes 모듈 로드의 청크 실패가 `recoverChunk`를 거친다 - 테스트: 라우터 컴포넌트 테스트(가짜 context 2개) - 파일: `app-router.tsx` - 의존: T46 · 크기: S @@ -319,19 +319,19 @@ ## 레인 I — bootstrap / platform ### T48 — R-9.1 부트 reload 세션당 1회 (6.9-1) -- 완료 조건: [ ] 키가 A→B→A로 바뀌어도 TTL 안에서는 두 번째부터 `show-failure`다 [ ] 기존 연속 reload 기대 테스트를 고친다 +- 완료 조건: [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) -- 완료 조건: [ ] 기본 스케줄(queueMicrotask)에서 같은 이벤트 1000회 → 수집기가 받는 occurrences 합계가 1000이다 +- 완료 조건: [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) [고위험] -- 완료 조건: [ ] 중간의 `Authorization: Bearer …`, URL `?access_token=…`, 이메일, `pwd`/`pass`/`auth`/`otp`/`pin` 키가 가려진다 [ ] 정상 enum/id 값은 가려지지 않는다 +- 완료 조건: [x] 중간의 `Authorization: Bearer …`, URL `?access_token=…`, 이메일, `pwd`/`pass`/`auth`/`otp`/`pin` 키가 가려진다 [x] 정상 enum/id 값은 가려지지 않는다 - 테스트: redact-telemetry 테스트 - 파일: `src/platform/telemetry/redact-telemetry.ts` - 의존: T01 · 크기: S