docs: record round 2 results
Mark T51-T115 done and record the fresh-checkout gate, bundle budget and Playwright results plus the behaviour changes to know about. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5.5
parent
dc223161d6
commit
60900fe232
@@ -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)은 커널로 옮기지 않았다
|
||||
|
||||
+65
-65
@@ -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)
|
||||
|
||||
Reference in New Issue
Block a user