Commit Graph
53 Commits
Author SHA1 Message Date
DongHyeonka ddc6353d81 docs(review): D7 커밋 본문의 다시 짓기 전 해시를 맞는 해시로 적는다
문제: D7 커밋 `287dc6f` 본문의 "늘어난 곳"이 1105/03-01과 1105/08-03에
적은 해시 둘은 통합에서 다시 짓기 전 해시라 `bbde570`에서 닿지 않는다
(`git merge-base --is-ancestor` rc=1). 같은 변경은 이 이력에서 `5c0b37e`,
`f849d78`이다(`git log --format='%h %s' 409d72e..bbde570`, rc=0). 원격
clone에는 두 객체가 없다. 통합 절차에 CHANGELOG·커밋 본문의 해시를 범위와
대조하는 단계가 없다.

고른 방법: 올린 이력은 고쳐 쓰지 않는다(`287dc6f`을 amend·rebase하지 않음).
1105 README 16.2절 D7 행에 본문의 두 해시가 다시 짓기 전 것이라는 것과 이
이력의 해시를 적는다(지시대로 그 행만). 닿지 않는 해시는 새로 적지 않는다.
적으면 아래 대조에 다시 걸린다. CHANGELOG 머리말의 "그 절의 해시는 모두 그
범위에 있다" 뒤에, 해시를 다시 쓴 뒤 절과 범위 커밋 본문의 해시를
`git merge-base --is-ancestor`로 대조하고 결과를 리뷰 README 조치 절에 적는
한 단계를 둔다(리뷰의 대안 b).
버린 대안: 해시를 대조하는 단위 테스트(대안 c). 싸지 않다.
- 복사한 프로젝트에는 템플릿 이력이 없거나(tech-log는 이력 없이 3-way로
  옮긴다) CI checkout이 얕을 수 있어, 테스트가 그때 건너뛰어야 한다. 조건부로
  도는 테스트는 이번 라운드 지시가 막는다.
- 커밋 본문은 작업 트리가 아니라 `git log` 범위를 읽어야 하고, 이미 올린
  `287dc6f`이 영구히 걸리므로 예외가 필요하다. 예외 추가도 지시가 막는다.
- CHANGELOG에는 다른 repo 해시(`d3810a0` 등)가 섞여 있어 repo 표시 규칙부터
  정해야 한다.

위험·한계: 대조는 사람이 하는 단계다. 빼먹으면 같은 일이 다시 난다. 완료
기준 "다음 통합 기록에 그 대조 결과가 있다"는 이번 라운드를 합칠
오케스트레이터가 채운다. 새 clone에서 `git show 287dc6f` 본문의 두 해시는
여전히 열리지 않는다.

검증: 문서만 바꿨다. desktop batch에서 확인.
node scripts/run-vitest.ts run tests/unit/changelog-review-ids.test.ts
(새 괄호 `(1106/14-02, 1105 README 16.2)`가 참조 꼴을 지킨다)
git merge-base --is-ancestor 5c0b37e bbde570 && git merge-base --is-ancestor f849d78 bbde570

Refs: 1106/14-02
2026-11-06 05:21:41 +09:00
DongHyeonka 302d3a5359 docs(review): 2026-11-06 5라운드 성숙도 리뷰 결과를 기록한다
문제: PR B(`bbde570`)가 2026-11-05 리뷰의 조치를 모두 담았다. 멈춤
기준(새 High 0, 새 P1 0, merge 게이트 14개 통과)을 판정하려면 그 커밋을
다시 리뷰해야 한다.

고른 방법:
- 지난 라운드의 영역 16개를 그대로 쓰고, 영역마다 리뷰어 하나가 코드를
  읽었다.
- merge stage는 같은 커밋에서 메인 세션이 돌린 실행(2026-11-06
  03:24~03:56)을 게이트 증거로 썼다. merge stage 밖의 명령과 리뷰어가 읽을
  산출물은 잠금 안에서 한 번 돌려 공유했다.
- 리뷰어 요청 65건과 12-04 완료 드릴은 desktop에서 한 항목씩 묶어 돌렸다.
- 지난 발견은 ID별로 다시 판정했다. 지난 README 16절의 "고침"을 그대로
  쓰지 않았다. 새 High·P1 후보 둘(03-01, 08-01)은 코드에서 다시 읽었다.
버린 대안: 리뷰어마다 desktop에서 따로 실행. 지난 라운드에 잠금 줄이
30건까지 쌓였다.

위험·한계: FE-GATE-013의 tests/system 18건, release run 산출물, 실제 짝
백엔드 연동은 이 환경에서 확인하지 못했다(README 8절). 리뷰 중 배치
runner를 둘 띄워 한 항목을 다시 돌렸다(README 11.5절).

검증: 새 발견 25건(High 0, P1 0, Medium 1, Low 24). 지난 발견 140건을
다시 판정했다. 배치 67항목 모두 restore=clean이었고, desktop checkout은
원래 상태(`fix/maturity-review-2026-11-03` `8a44226`, git status 비어 있음)로
끝났다.

Refs: docs/reviews/2026-11-06-maturity-review/README.md
2026-11-06 05:06:05 +09:00
DongHyeonka bbde570796 docs(review): 1105 조치의 결정·통합 문제·발견별 상태를 적는다
문제: 1105 리뷰 README에는 수정 라운드의 기록이 없다. 1103 리뷰는 14절에
방법·결정·통합 문제·발견별 상태를 적었다. 초기 JS 예산 상향(D7)은 결정이라
이유·대안·재검토 조건을 남겨야 한다.

고른 방법: README 16절에 방법, 결정 표(7절 D1~D6의 결과, 새 D7과 그 근거: 커밋별 증가와 올린 뒤
여유), 합칠 때 생긴 문제와 고친 위치, 새 발견 48건·1103 이월 22건·그 밖의
이월 상태, 돌린 검사와 돌리지 않은 것을 적는다. CHANGELOG의 예산 행에 예산
커밋 `287dc6f`를 더한다.
버린 대안: 결정을 `docs/improvement/` 결정 색인에 적기. 그 폴더는 매뉴얼
PR(#6)과 겹쳐 건드리지 않는다.

위험·한계: 해시는 이 브랜치 끝에서 닿는 커밋이다. 브랜치를 다시 쓰면 함께
고쳐야 한다.

검증: desktop batch에서 확인.
옆 백엔드 checkout 없는 verify:documentation
node scripts/run-vitest.ts run tests/unit/changelog-review-ids.test.ts tests/unit/documentation-readiness.test.ts tests/unit/deletable-history-documents.test.ts

Refs: 1105/15-02, docs/reviews/2026-11-05-maturity-review/README.md
2026-11-06 03:00:21 +09:00
DongHyeonka e85c8361b6 docs(review): 2026-11-05 4라운드 성숙도 리뷰 결과를 기록한다
2026-11-03 리뷰의 조치가 main(409d72e)에 들어간 뒤 전체를 다시 봐야
한다. 지난 README 14.4절의 상태 판정("그 밖의 81건 고침")과, 조치가
검사를 약하게 했는지는 아무도 확인하지 않았다.

가이드 기준으로 16개 영역을 다시 리뷰했다. 기준은 8a44226(= main
409d72e 트리)이다. desktop에서 merge 단계 14개(workflow env)와
CLAUDE.md 게이트 목록을 직접 돌렸다. 실험은 게이트가 끝난 뒤 78항목을
한 묶음으로 하나씩 돌렸고, 항목마다 checkout을 기준 커밋으로 되돌렸다.
처음에는 영역마다 따로 실행했으나 공유 잠금에 30여 건이 줄을 서서
취소했다(README 11.4절).

결과: 새 발견 48건(High 0, Medium 11, Low 37 / P1 3, P2 15, P3 30).
P1은 09-01, 12-01, 13-01. 지난 96건은 고쳐짐 74, 일부 22이고,
14.4절이 고침이라 한 13건을 일부로 바로잡았다. merge 게이트는 13/14
통과, FE-GATE-013은 호스트 user namespace 제한으로 실패한다.

위험·한계: 실제 Gitea 러너와 짝 백엔드 연동은 확인하지 못했다(README
8절). 리뷰라 코드는 고치지 않았다. 영역 문서의 실행 기록 일부는
리뷰 세션 scratchpad 경로를 가리킨다.

검증: desktop에서 이 커밋으로 documentation-readiness,
deletable-history-documents, changelog-review-ids 테스트와
verify:documentation(옆 백엔드 checkout 없이)을 돌렸다.

Refs: docs/reviews/2026-11-05-maturity-review/README.md
2026-11-05 20:52:21 +09:00
DongHyeonka 8a4422624e docs(review): desktop merge 게이트 11회차와 FE-GATE-008 연속 3회를 기록한다
문제: 14.5절 표에 메인 세션의 ee7e195 실행(11-10을 찾은 회차)과 11-10 조치
뒤 FE-GATE-008 확인이 없었다.

방법: 11회차(ee7e195, 008·013 실패, 013은 desktop 환경)와 12~14회차(8c5e047,
GATES="008" 연속 3회, RUN_NO 45·46·47 모두 통과)를 더했다.

검증: desktop에서 changelog-review-ids test와 verify:documentation(scoped).
2026-11-05 10:01:24 +09:00
DongHyeonka 8c5e047576 docs(review): 11-10(클릭 도중 움직이는 capability test 버튼)을 기록한다
문제: 메인 세션이 desktop(ee7e195, 부하 0.96)에서 FE-GATE-008의 firefox
capability 실패를 다시 찾았다. 14.7절은 같은 실패(browser-files 다운로드
test)를 부하 탓 flake로 적어 두었는데 틀렸다.

방법:
- 13절에 11-10(Medium·P1, 관점 10·21, 고침 ee37dd86)을 더했다. 근거는
  진단 event 기록 6건(mouseup이 홈 화면 내용), 위치 기록 3건(scrollY
  그대로, body·button 12 px 아래로), ×30 재현 3/60 두 번이다.
- 색인·발견 수(95건)·14.4 행을 맞췄다.
- 14.7절의 Firefox 줄을 지우고 정정을 적었다. "FE-GATE-008이 한 번에
  통과하지 않을 수 있다"는 줄도 지웠다.

검증: desktop에서 changelog-review-ids test와 verify:documentation(scoped).
2026-11-05 09:51:48 +09:00
DongHyeonka ee7e195fb2 docs(review): desktop에서 돌린 merge 게이트 9·10회차를 기록한다
문제: 14.5절 표에 메인 세션의 desktop 실행(8a3b16a, 11-09를 찾은 회차)과
11-09 조치 뒤 실행이 없었다.

방법: 9회차(8a3b16a, 008·013 실패, 013은 desktop 환경)와 10회차(37c63e8,
008·005·012·020 통과)를 더했다. 10회차에 초기 JS를 조치 전후로 적었다.
제품 입력은 같고 차이 6 B는 빌드에 박힌 커밋 ID다.

검증: desktop에서 changelog-review-ids test와 verify:documentation.
2026-11-05 08:40:19 +09:00
DongHyeonka 37c63e8370 docs(review): 11-09(WebKit preload 추정에 기댄 브라우저 테스트)를 기록한다
문제: 메인 세션이 desktop(부하 0.68)에서 8a3b16a의 FE-GATE-008 webkit
실패(i18n.spec.ts:60)를 찾았다. 14.7절은 같은 경고(production-csp.spec.ts:52)를
부하 탓 flake로 적어 두었는데 틀렸다.

방법:
- 13절에 11-09(Medium·P1, 관점 10·21, 고침 aad005cb)를 더했다. 근거는 실패
  trace의 시각, 재현 3/10·0/10·2/2, 이전 fixture가 정말 안 쓴 preload를
  놓친 probe다.
- 색인·발견 수(94건)·14.4 행을 맞췄다.
- 14.7절의 webkit flake 줄을 지우고 정정을 적었다. FE-GATE-008이 한 번에
  통과하지 않을 수 있는 이유는 이제 Firefox 다운로드 건 하나다.

검증: desktop에서 changelog-review-ids test와 verify:documentation.
2026-11-05 08:14:53 +09:00
DongHyeonka 8a3b16adb3 docs(review): 11-08과 CI=true로 다시 돌린 merge 게이트 결과를 기록한다
문제: 14.5절 X4의 1~7회차와 799ab7f 결과는 CI=true와 CI_RUNNER_IMAGE
없이 돌린 것이라, 메인 세션이 c7c7887에서 workflow env로 찾은
FE-GATE-005·008·020 실패(11-08)를 놓쳤다. 리뷰 기록에 그 사실과 새 발견이
없었다.

방법:
- 13절에 11-08(Medium·P1, 고침 b693600, 안내 cd7e784)을 더하고 색인·
  14.4 행·발견 수(93건)를 맞췄다.
- 14.5절에 앞 회차가 CI=true 없이 돌았다고 적고, 8회차(cd7e784, CI=true와
  CI_RUNNER_IMAGE digest)와 최종 행을 더했다. 표 중간의 빈 줄로 7회차와
  최종 행이 표 밖으로 빠져 있던 것도 고쳤다.
- 14.7절에 FE-GATE-008을 한 번에 통과시키지 못하게 하는 두 flake(Firefox
  다운로드 시간 초과, webkit preload 경고)와 원인 조사 결과를 적었다.
  Blob URL을 일찍 회수하는 경쟁을 의심해 A/B로 쟀으나 둘 다 60/60이라
  테스트는 고치지 않았다.

위험·한계: 실제 Gitea 러너가 아니라 로컬에서 workflow env를 준 실행이고
CI_RUNNER_IMAGE는 가짜 digest다. 두 flake의 원인은 찾지 못했다.

검증: 깨끗한 clone(cd7e784)에서 14개 ci:gate. 001~007·009~013·020은 한
번에, 008은 세 번째 실행에서 통과. verify:documentation PASS_SCOPED.
2026-11-05 05:06:50 +09:00
DongHyeonka c7c7887937 docs(review): 2026-11-03 리뷰 조치 결과와 merge 단계 검증을 기록한다
문제
리뷰 README에 조치 결과가 없다. 사용자가 "나머지 전부 진행하세요"라고
했고, 이 세션이 발견 90건과 0929/03-03을 고치고 통합했다.

고른 방법
- 13절에 조치 중 찾은 발견 둘(11-07 CI 빌드 식별값 누출, 16-09 dev
  manifest 고정 contract set)을 36.3 양식으로 더하고 색인을 92건으로 고친다.
- 14절을 새로 둔다: 방법(수정 브랜치 11개, wave 1~3), 결정 D1~D6, 통합에서
  생긴 것, 발견별 상태(일부 9건과 결정 대기 3건), 깨끗한 clone의 merge 단계
  14개 회차별 결과(X4), 매뉴얼 재실험 막힘 7건과 처리(X2), 남은 문제.

위험·한계
- X2(매뉴얼만 보는 재실험)는 고친 뒤 다시 돌리지 않았다. 고친 것은 생성
  기능을 넣은 clone 확인과 X4로 확인했다.
- 실제 Gitea 러너, 짝 백엔드·nginx·Keycloak·Redis 연동은 확인하지 않았다.

검증
- 최종 커밋 799ab7f, 깨끗한 clone, CI env: FE-GATE-001~013·020 통과
  (FE-GATE-008은 첫 실행 Firefox 다운로드 시간 초과 1건, 재실행 2회 통과).
- verify:documentation PASS_SCOPED.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 13절 14절
2026-11-05 04:08:56 +09:00
DongHyeonka f800549315 feat(http): 짝 백엔드 Fileserver의 multipart 한 번 업로드 client를 더한다
문제: 두 템플릿을 짝으로 쓰면 파일 업로드 경로가 없다. 프론트 업로드
레시피는 PRESIGNED_MULTIPART_V1 서버를 가정하는데 짝 백엔드는 그 코드를
지웠고, 짝 백엔드 Fileserver(POST /v1/files)를 부를 프론트 client는 없다.
src 전체에 multipart 요청을 만드는 코드가 없다.

고친 방법(리뷰 D1 (나-1)): src/adapters/http/fileserver-upload.ts에
createFileserverUploadClient를 둔다. 백엔드 bbe944bd 계약 그대로다.
- 입력은 FileContentPort.openSource가 주는 FileByteSource다. 바이트를 한
  번 읽어 multipart 본문(파트 이름 file, RFC 7578, 파일 이름은 HTML 폼
  인코더처럼 escape)을 직접 만든다. File·Blob은 이 adapter에 들어오지
  않는다(eslint browser-data 경계). 선언 크기가 maxFileBytes보다 크면 읽기
  전에 거절하고, 읽는 중에 넘어도 멈춘다. 선언 크기가 있으면 본문 버퍼
  하나에 바로 쓴다.
- 전송 규칙은 레시피와 V3 실행기와 같다. credentials는 인증 프로필이
  정하고, 자격 증명 헤더는 admitCredentialHeaders로 프로필에 맞춰 받는다.
  redirect "error", no-referrer, no-store, 응답 본문 상한, 바이트에 비례한
  deadline 하나, 호출자 abort(커널 createAbortableOperation).
- 성공: 201 READY / 202 그 밖의 state를 Envelope에서 읽는다. 201과 202의
  state가 맞지 않거나 size가 보낸 바이트와 다르면 SCHEMA_MISMATCH,
  APPLIED_CONFIRMED.
- 실패: backend-envelope.ts의 readFailureEnvelope와 envelopeFailureReading을
  그대로 쓴다. 효과 판정은 Fileserver 계약을 따른다. details.ambiguous,
  AMBIGUOUS_COMPLETION, IDEMPOTENT_IN_FLIGHT, IDEMPOTENCY_COMPLETION_UNKNOWN은
  MAYBE_APPLIED. 그 밖의 4xx는 NOT_APPLIED(백엔드 UploadFile use case가
  모호하지 않은 실패에서 업로드를 취소한다). 5xx는 이름 붙인 Fileserver
  code만 NOT_APPLIED이고 나머지는 MAYBE_APPLIED. 보낸 뒤 네트워크 실패·
  시간 초과·abort도 MAYBE_APPLIED. Envelope의 retryable:false와 상한(기본
  30초)을 넘는 Retry-After는 retryable을 false로 만든다(01-02와 같은 규칙).
- Idempotency-Key 헤더를 보낸다. client는 스스로 다시 보내지 않는다.

위치를 http adapter로 고른 이유: Envelope 해석(backend-envelope.ts), 자격
증명 admission(http-contract-bridge.ts), bounded reader를 adapter 안
import로 다시 쓴다. 새 adapter 사이 import 예외가 필요 없다. 바꾼 http
파일은 index.ts의 export 한 묶음뿐이다.
버린 대안:
- backend-envelope.ts를 커널(src/adapters/platform/)로 옮기고 client를
  browser-transfer에 둔다. 다른 작업이 지금 고치는 파일을 옮겨야 하고,
  커널은 제품 중립 primitive 자리인데 백엔드 짝 정책이 들어간다.
  file-transfer 레시피 예산 여유도 1.7KB뿐이고, 이 client는 presigned
  레시피와 무관한데 그 제거 드릴에 함께 지워진다.
- browser-transfer에 Envelope 파서를 하나 더 둔다. 갈라진 사본이다.
- V3 실행기에 multipart 본문을 더한다. 1,900줄짜리 실행기를 다른 작업과
  동시에 크게 고쳐야 한다.
- FormData와 Blob을 쓴다. http adapter는 File·Blob을 쓸 수 없고(eslint),
  기능은 Blob을 갖지 않는다.

조립: 제품이 product-composition.ts에서 client 재료
(FileserverUploadClientDependencies)를 capability로 넘기고, 기능 adapter가
createFileserverUploadClient를 부른다. 그래서 템플릿 boot 번들에는 들지
않는다. 매뉴얼 02 결정표 7절, patterns.md, 두 architecture 문서, 레시피
fallback이 이 경로를 가리킨다. adapter INVENTORY와 상세 리뷰 표에 행을
더했다(번호는 끝에 141로 붙였다).

위험·한계:
- 재개가 없다. 파일 전체를 메모리에 한 번 읽는다(maxFileBytes까지). tus
  client는 없다.
- 짝 백엔드 bbe944bd의 POST /v1/files는 멱등 키를 읽지 않는다
  (NOT_IDEMPOTENT). MAYBE_APPLIED 뒤 같은 키로 다시 보내도 파일이 두 개
  생길 수 있다. 매뉴얼에 적었다.
- 효과 판정 표(NOT_APPLIED_5XX_CODES, MAYBE_APPLIED_CODES)는 백엔드
  bbe944bd 기준이다. 어긋남을 알리는 검사는 없다(12-06과 같은 종류).
- 실제 짝 백엔드를 띄운 업로드는 하지 않았다. 테스트는 계약대로 답하는
  MSW다. 실제 브라우저(Playwright)에서도 돌리지 않았다.
- 템플릿 기본 product-composition.ts가 자격 증명 owner를 노출하지 않으므로,
  템플릿 세션(EXTERNAL_BEARER)으로 올리려면 제품이 자기 credential
  provider를 써야 한다.

검증:
- tests/integration/fileserver-upload.test.ts 48건 통과(201/202 본문,
  Envelope 실패 16종, 409 IDEMPOTENT_IN_FLIGHT + Retry-After 2, 상한 밖
  Retry-After, 보낸 뒤 네트워크 실패 뒤 같은 키 재전송, 시간 초과, abort,
  자격 증명 거절, 크기·입력 거절). multipart 본문은 undici FormData
  파서로 다시 읽어 확인했다.
- 변이 7건(4xx 판정, ambiguous 무시, 상한 무시, credentials 고정, 키 누락,
  201/202 state 검사 제거, Envelope retryable 무시) 모두 실패를 만들었다.
- check:types, lint(바꾼 파일), check:architecture, check:adapter-inventory,
  verify:documentation, check:registries, check:ci 통과
- check:bundle PASS: initial JS 201,921 / 204,800 gzip bytes. 빌드 산출물
  어디에도 client 코드가 없다(dist grep). check:optional-recipes:source PASS
  (file-transfer 56,082 / 57,800)

Refs: docs/reviews/2026-11-03-maturity-review/01-adapters-browser-transfer.md 01-01
2026-11-04 21:05:23 +09:00
DongHyeonka 004a205748 docs(review): 리뷰가 놓친 merge 게이트 결함 2건을 더한다
문제
리뷰 README 10.1절의 게이트 목록은 merge stage 전체가 아니었다.
coverage 증거 검사, storybook, a11y, browser-capabilities, CI env 값의
e2e가 빠졌다. 리뷰를 맡긴 세션이 병합의 한쪽 부모 8c39e77에서
`ci:gate FE-GATE-NNN` 14개를 돌려, 실제 러너에서 항상 실패하는 merge
게이트 두 개를 찾았다.

고른 방법
- 11-06: tests/e2e/compact-smoke.spec.ts:18이 build id를 "local-build"로
  고정하고, workflow는 VITE_BUILD_ID를 gitea-<run>-<attempt>로 준다.
  FE-GATE-008이 CI에서 항상 실패한다.
- 12-09: scripts/lib/ci-artifact-validator.ts:79-91의 .strict() schema가
  istanbul-lib-coverage 3.2.2 summary의 branchesTrue를 거절한다.
  FE-GATE-005가 테스트가 모두 통과해도 실패한다.
- 두 결함의 코드를 e40684b에서 다시 읽고, README 13절에 36.3 양식으로
  적었다. 사용 결정, P1 표, 개선 순서 2, 관점 21, 색인(90건), 미검증,
  오케스트레이터 실수(10.5)에 반영했다. 등급은 02-06과 같은 기준으로
  Medium·P1이다.
- 셋째 결함(FE-GATE-020)은 02-06과 같아 따로 세지 않았다.
  worktree 안 checkout·inotify 부족은 환경 조건이라 결함으로 세지
  않았다.

위험·한계
- e40684b에서 ci:gate를 실행하지 않았다. 재현은 8c39e77 깨끗한
  복제본에서 다른 세션이 했다. CI=true와 러너 이미지 조건은 아무도
  재현하지 않았다.
- 코드는 고치지 않았다.

검증
- verify:documentation PASS_SCOPED.
- documentation-readiness·changelog-review-ids 테스트 15건 통과.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 13절
2026-11-04 00:31:18 +09:00
DongHyeonka 9c521ecd75 docs(review): 2026-11-03 프론트 전체 성숙도 리뷰를 기록한다
문제
V2 HTTP 경로를 지운 뒤(048f490, 12f3bb7) 사용자가 "V2에만 있던 동작이
없어져도 되는가"를 묻고, 프론트 전체를 다시 리뷰하라고 했다. 기준은
docs/reviews/TEMPLATE-MATURITY-REVIEW-GUIDE.md다.

고른 방법
- 두 작업 브랜치를 합친 e40684b를 기준 커밋으로 고정했다(사용자 선택).
- 지난 리뷰의 16개 영역을 그대로 나눠, 격리 worktree 에이전트가 병렬로
  읽고 변이·실험을 했다. 무거운 실행은 공유 잠금으로 한 번에 하나씩
  돌렸다.
- High 제안 6건과 상향 제안 1건을 코드에서 다시 확인했다. 제거 드릴
  5개, feature-scaffold, lab 게이트는 직접 돌렸다.
- README에 범위(36.1), 28개 관점 판정(36.2), 최종 요약(36.5), 발견
  색인을 적었다. 영역 문서의 발견 96건 중 같은 결함 8건을 대표 항목에
  합쳐 색인은 88건이다.
- 버린 대안: 두 브랜치를 따로 리뷰하기. 병합 뒤 상태(문서 충돌을 푼
  6.1절, 두 쪽 변경이 겹친 번들 크기)를 보지 못한다.

위험·한계
- High는 3건이다: 03-01(=08-01), 01-01, 0929/03-03(Medium에서 상향).
  03-01은 이 작성자가 3261208에서 만든 판정 표가 원인이다. 14-02와
  04-01도 작성자의 문장·판정이 틀렸다(README 10.5).
- V2 판정을 다시 보니 V2가 하던 일이 셋보다 많았다. 레지스트리의 wire
  칸 감시(07-01), traceId 채우기(03-06), 테스트 3건(10-04), 조회
  SAFE·IDEMPOTENT 제한(03-03)이 같이 사라졌다(README 3절).
- 영역이 High로 제안한 02-06·12-01·15-01은 Medium·P1로 낮췄다.
  지난 라운드의 같은 모양(1101/11-01, 1101/15-01)과 등급을 맞췄다.
  P1이라 첫 조치 묶음에 그대로 있다(README 2.3).
- 짝 백엔드가 리뷰 도중 7ef8d0b4에서 bbe944bd로 바뀌었다. 새 code
  IDEMPOTENCY_COMPLETION_UNKNOWN 하나만 대조했다(README 10.6).
- CI 러너, 짝 백엔드 실연동, d99301b와의 lab A/B는 직접 확인하지
  않았다(README 7절).
- 리뷰 중 코드는 고치지 않았다.

검증
- e40684b 게이트: check:architecture, check:types, lint, test:unit
  2,580, test:component 263, test:integration 117, test:contract 23,
  test:runtime-schema 56, verify:documentation, check:adapter-inventory,
  check:ci, check:registries, check:i18n, check:design-system,
  check:diagnostics, check:bundle(201,848 / 204,800 B) 통과.
- test:sample-removal(23 checks), test:feature-scaffold(16 checks) 통과.
- test:browser-file-storage-removal, test:realtime-removal,
  test:optional-recipe-removal 실패. 세 드릴 모두 fixture에 README.md·
  CHANGELOG.md가 없어 문서 테스트 2파일만 떨어진다(02-06).
- test:performance 실패: 상호작용 중앙값 227 ms > 200 ms(15-01).
- 이 문서를 넣은 뒤 verify:documentation PASS_SCOPED,
  documentation-readiness·changelog-review-ids 테스트 15건 통과.

Refs: docs/reviews/2026-11-03-maturity-review/README.md
2026-11-04 00:18:59 +09:00
DongHyeonka 93c81dfc6f docs: 사라진 V2 동작 셋의 판정과 되살린 것을 기록한다
문제
14.7은 V2 삭제로 "401 뒤 세션 복구 재전송"과 "보낸 KEYED 요청 자동 재시도"가
사라졌다고만 적었다. 사용자가 없어져도 되는지 물었고, V2 보안 프로필 일관성
검사도 같이 사라졌다.

고른 방법
14.7에 세 동작의 판정 표를 적었다. 기준은 설계 정본(2026-07-30 closed deep
design) 8절이다.
- 401 재전송: 없어져도 된다(8.4 FRT-D016 hidden replay 금지). VD-23의 낡은
  문장은 리뷰 대상으로 남긴다.
- KEYED 자동 재시도: 정본 8.3이 허용하는 부분(재시도를 허락하는 알려진 응답)만
  되살렸다(c05f41a).
- 보안 프로필 검사: 쿠키 인증 쓰기의 CSRF 요구만 보안 불변식이라 되살렸다
  (365d8c3).
CHANGELOG에 [보안] 행과 [계약] 행을 더했다.

검증
- verify:documentation PASS_SCOPED, tests/unit/changelog-review-ids.test.ts 통과.

Refs: docs/reviews/2026-11-01-maturity-review/README.md 14.7
2026-11-03 22:22:48 +09:00
DongHyeonka dcadc0be92 docs: V2 HTTP 경로 삭제를 CHANGELOG와 리뷰 기록에 적는다
문제
048f490(V2 클라이언트 삭제)과 12f3bb7(V2 API 행 삭제)은 공개 이름을 깨는
변경인데 CHANGELOG 미출시 절에 행이 없고, "먼저 할 일" 절의 기능 모양 옮기기
순서가 아직 apiContract(V2 API 필드 네 개)를 만들라고 적는다. 리뷰 README
14.6의 "V2와 남은 차이"도 V2가 있는 것으로 적는다.

고른 방법
- CHANGELOG: [계약] BREAKING 행 둘(지운 이름, 옮기는 법, memento-web 영향)을
  더하고, "먼저 할 일" 1·3번을 schemas 하나로 고쳤다.
- 리뷰 README 14.7: 사용자 지시, 지우기 전·후 도식, 두 커밋이 지운 것과 바꾼
  것, 레지스트리 재승인 digest, 초기 JS 변화, 사라진 V2 전용 동작, 남긴
  BoundedPollOperationContract, 다운스트림 영향. 14.6의 차이 절에 지금은 없다고
  적었다.

위험·한계
- 다운스트림 동기화 방법은 CHANGELOG의 문장뿐이다. memento-web을 직접 옮겨
  보지는 않았다.

검증
- verify:documentation PASS_SCOPED.
- tests/unit/changelog-review-ids.test.ts 통과.

Refs: docs/reviews/2026-11-01-maturity-review/README.md 14.7
2026-11-03 21:38:04 +09:00
DongHyeonka 048f490ada refactor(http)!: V2 HTTP 클라이언트를 지우고 V3 실행기 하나만 남긴다
문제
HTTP 실행 경로가 둘이다. V3 실행기(createContractHttpExecutor)가 모든 기능을
실행하고, V2 클라이언트(createHttpClient)는 bootstrap의
createRuntimeHttpClient에서만 만들어지는데 그 함수를 앱 안에서 부르는 곳이
없다(테스트만 부른다). tech-log·memento도 같다. 그런데도 V2는 초기 청크에
들어가고, 짝 백엔드 해석(7db32e1~3261208)과 테스트를 두 벌로 유지하게 했다.
사용자 지시: 레거시를 두지 말고 최신 경로 하나만 남긴다.

고른 방법
- src/adapters/http/의 client.ts, bounded-json.ts, request-builder.ts,
  resource-mapper.ts, retry-policy.ts, schema-registry.ts를 지웠다. Envelope
  스키마는 backend-envelope.ts로 옮겼다. V3가 retry-policy.ts에서 쓰던
  parseRetryAfter는 그것이 감싸던 platform/retry-after.ts의
  parseRetryAfterDelay를 직접 부른다.
- 배럴의 V2 export와 bootstrap의 createRuntimeHttpClient·RuntimeHttpContract를
  지웠다.
- V2 전용 테스트(http-client, http-diagnostics, auth-recovery,
  legacy-http-credential-authority, bounded-json-compatibility,
  request-builder, retry-policy)와 tests/helpers/http-contract-fixture.ts를
  지웠다. 섞인 파일(http-execution-contract, runtime-adapters,
  boundary-mapper)은 V2 블록만 지웠다.
- V2로 돌던 폼 테스트(form-foundation)는 Envelope을 읽는 V3 keyed create
  계약으로 옮겼다. 400 VALIDATION_FAILED 필드 오류, {cause} 뒤 다시 저장,
  422 뒤 저장 꺼짐을 그대로 검사한다. http-execution-v3-envelope 테스트는 V2와
  비교하던 행을 기대 판정을 직접 적는 행으로 바꿨다.
- drill:runbook FE-RB-003은 V2 shouldRetry 대신 V3 실행기를 실제로 돌려
  보낸 요청 수를 센다(NEVER 503: 1회, SAFE 503: 재시도, SAFE 스키마 불일치:
  1회).
- check:diagnostics의 http 이벤트 생산자, registry-governance의 오류 표 소비자,
  risk-coverage 고위험 경로, 아키텍처 금지 fixture, adapter INVENTORY, 문서의
  경로를 V3 파일로 바꿨다.

버린 대안
- V2를 @deprecated로 한 릴리스 남기기: 템플릿과 두 다운스트림 모두 부르는
  곳이 없어 옮겨 갈 사용자가 없다. 남기면 초기 JS와 두 벌 유지 비용만 남는다.

위험·한계
- BREAKING: 배럴과 bootstrap의 V2 이름을 쓰던 제품 코드는 컴파일이 깨진다.
  CHANGELOG에 옮기는 방법을 적었다.
- V2에만 있던 동작이 사라졌다: 401 뒤 세션 복구 후 한 번 재전송, KEYED 503
  자동 재시도. V3는 401을 UNAUTHENTICATED로 넘기고 KEYED 요청은 보낸 뒤
  재시도하지 않는다.
- 기능마다 적는 V2 API 행(*-api-contract.ts, check:registries가 읽음)은 이
  커밋에서 지우지 않았다. 다음 커밋이 지운다.

검증
- check:types, lint, check:architecture(금지 fixture 9건 거절),
  check:adapter-inventory(140 files), check:diagnostics, check:registries,
  check:ci, verify:documentation 통과.
- test:unit 2,585, test:integration 114, test:component 245, test:contract 23,
  test:runtime-schema 56, tests/features 101 통과.
- drill:runbook FE-RB-003: no local check failed.
- check:bundle 통과. 초기 JS 203,354 → 201,598 B(−1,756 B).

BREAKING CHANGE: src/adapters/http/index.ts가 createHttpClient, HttpClient,
HttpClientDependencies, HttpFailure, HttpResult, LegacyHttpInput, Scheduler,
OperationRequestInput를, src/bootstrap/runtime-adapters.ts가
createRuntimeHttpClient, RuntimeHttpContract를 내보내지 않는다. 그 operation의
V3 descriptor를 만들어 createFeatureHttpBinding으로 실행한다.
2026-11-03 21:12:34 +09:00
DongHyeonka bf86fe5cd0 docs(contract): 4.2절의 400·422 행을 짝 백엔드 거절 표에 맞춘다
문제
계약 문서 4.2절은 422를 "field validation"으로 적는다. 3261208 뒤로 프론트는
422 중 IDEMPOTENT_REQUEST_MISMATCH만 적용 안 됨으로 보고, 짝 백엔드는 필드
검증을 400 VALIDATION_FAILED로 보낸다. 같은 문서의 6.1절 표와 4.2절이 서로
다른 말을 한다.

고른 방법
- 400 행에 짝 백엔드 필드 검증이 400 VALIDATION_FAILED라는 것을 더하고
  적용 여부는 6.1절을 가리킨다.
- 422 행을 짝 백엔드 기준으로 바꿨다. 기본 배포는 IDEMPOTENT_REQUEST_MISMATCH만,
  fileserver는 쓰기 뒤에도 나오는 code를 422로 보낸다. 폼 필드 오류는
  details.issues[]가 있으면 여전히 읽는다.
- 리뷰 README 14.6의 위험 줄을 고친 상태로 바꿨다.

버린 대안
- 422 행을 그대로 두고 6.1절만 믿기: 같은 문서 안에서 두 절이 어긋난다.

위험·한계
- 422로 필드 검증을 보내는 다른 백엔드를 쓰는 프로젝트는 422 뒤에 폼에서
  다시 저장할 수 없다. 문서는 그 동작을 적을 뿐 바꾸지 않는다.

검증
- verify:documentation PASS_SCOPED.

Refs: docs/reviews/2026-11-01-maturity-review/README.md 14.6
2026-11-03 20:55:50 +09:00
DongHyeonka fbd93ac9a8 docs: 거절 적용 여부를 백엔드 기준 표로 바꾼 것을 매뉴얼과 기록에 적는다
문제
3261208이 V2·V3의 거절 판정을 계약 문서 6.1절 표로 바꿨다. 매뉴얼 02
4절은 아직 "422 전부와 필드 목록 400은 적용 안 됨, 그 밖은
classifyProblem"으로 적고, 리뷰 README 14.6 판정 표, 14.4의 검증 거절 줄,
CHANGELOG의 7db32e1 행도 같은 옛 규칙을 적는다.

고른 방법
- 매뉴얼 02 4절: 표의 세 code(적용 안 됨)와 그 밖의 400·409·422(결과 불명),
  근거가 계약 문서 6.1절이라는 것, 쓰기 전 거절 code를 새로 만들 때 두 곳을
  함께 고친다는 것.
- 매뉴얼 01 3단계: 실행기가 정하는 status 범위를 400·409·422와 503으로 적었다.
- 리뷰 README 14.6: 판정 표를 새 표로 바꾸고 처음 규칙을 한 줄로 남겼다.
  "6.1 표 반영" 단락에 바뀐 것, 버린 대안, 위험, RED·GREEN, 게이트를 적었다.
  14.4 줄에 바뀐 판정을 덧붙였다.
- CHANGELOG: [계약] 행 하나를 더하고 02e35d2·7db32e1 행이 그 행을 가리키게
  했다.

위험·한계
- 계약 문서 6.1절은 오케스트레이터 브랜치(ed0e4b1)에만 있다. 이 브랜치의
  매뉴얼은 그 절을 가리키지만, 합치기 전에는 그 절이 없다.
- 프론트 계약 문서 4.2절 "422 field validation" 행은 고치지 않았다.

검증
- verify:documentation PASS_SCOPED.
- tests/unit/changelog-review-ids.test.ts 통과.

Refs: docs/reviews/2026-11-01-maturity-review/README.md 14.4, 14.6
2026-11-03 20:34:23 +09:00
DongHyeonka f3b87b3f02 docs: 생성한 기능이 짝 백엔드 Envelope를 읽는다는 결정과 결과를 적는다
문제
매뉴얼 01 3단계, CHANGELOG 미출시 절, 리뷰 README 14.3은 "생성한 기능은
짝 백엔드 응답을 그대로 읽지 못한다, 해결 방법은 정하지 않았다"를 알려진
제한으로 적는다. 7db32e1로 V3가 responseEnvelope: "ENVELOPE_V1"
operation의 Envelope를 읽게 되어 이 문장들이 틀렸다. 매뉴얼 02 4절의 503
흐름도와 계약 문서 4.1절도 "V3는 Envelope 없이 DTO를 검증"으로 적는다.

고른 방법
- 리뷰 README 14.6: 선택지 넷(V3 operation 단위 / provider 단위 / 백엔드
  problem+json 모드 / 기능 스키마가 감쌈)의 판정과 이유, V2와 같은 판정
  표, 의도한 차이 세 가지, RED→GREEN·게이트 결과, 남은 것. 14.3 행의
  처리 칸은 14.6을 가리킨다.
- 매뉴얼 01 3단계: "응답 모양"을 짝 백엔드 Envelope 기준으로 다시 쓰고,
  Envelope가 아닌 백엔드에 붙이는 순서(responseEnvelope 줄 삭제, problem
  details 스키마)를 따로 적었다. 알려진 제한 문단은 지웠다.
- 매뉴얼 02 4절: 실행기가 먼저 정하는 판정 목록과 바뀐 503 흐름.
- CHANGELOG: [계약] 행 하나, 알려진 제한을 남은 차이(참조 기능 미선언,
  V2와의 차이 셋, e2e 접근성 스펙의 [] 본문)로 바꿨다.
- 14.4와 CHANGELOG의 "V3 진단에 problem code가 없다"에 bd83b49가 싣는
  범위(멱등성 거절 reason 두 값)와 싣지 않는 것, 그 이유를 적었다.
- 계약 문서 4.1절·compatibility.md: Envelope를 읽는 곳을
  backend-envelope.ts로 고쳤다.

버린 대안
- 백엔드에 요청 문서 쓰기: (나)를 고르지 않아 요청할 것이 없다.

위험·한계
- 문서의 게이트 결과는 이 커밋 직전 트리(bd83b49, scaffold·sample-removal은
  7db32e1)에서 잰 값이다.
- 백엔드 링크는 두 repo가 나란히 있을 때만 열린다(기존과 같다).

검증
- verify:documentation PASS_SCOPED.
- 게이트 수치는 README 14.6 결과 표에 실행한 커밋과 함께 적었다.
- tests/unit/changelog-review-ids.test.ts 통과.

Refs: docs/reviews/2026-11-01-maturity-review/README.md 14.3, 14.6
2026-11-03 20:13:31 +09:00
DongHyeonka 7db32e1343 fix(http): V3 실행기가 짝 백엔드 Envelope를 operation 단위로 읽는다
문제
create:feature가 만든 기능과 참조 기능이 쓰는 V3 실행기
(http-execution-v3.ts, feature-http-binding.ts)는 성공 본문을 DTO로,
실패 본문을 problem details(최상위 code)로 바로 검증한다. 짝 백엔드는
모든 JSON 응답을 Envelope {success, data|error, meta}로 보내고 null 필드는
키째 뺀다(백엔드 docs/web/http-contract.md 1절). 그래서 생성한 기능은 짝
백엔드의 성공을 SCHEMA_MISMATCH로, 실패를 PROBLEM_SCHEMA_INVALID(쓰기는
결과 불명)로 읽는다. 백엔드 맞추기(969979d~64e98ee)는 V2 클라이언트에만
들어갔다.

고른 방법: (가) V3 실행기에 operation 단위 Envelope 읽기
- V3 descriptor에 선택 필드 responseEnvelope("NONE" | "ENVELOPE_V1")를
  둔다. 조립은 이 키를 허용하고 모르는 값을 거부한다. 값이 없으면 지금과
  같다.
- ENVELOPE_V1이면 실행기가 바이트 상한·구조 예산을 Envelope 전체에 건 뒤
  프레임을 확인한다. outputValidator는 data(키가 없으면 null),
  problemValidator는 error를 받는다. 성공 status에 Envelope가 아닌 본문은
  새 위반 ENVELOPE_MISMATCH다. 실패 Envelope의 바이트 상한은
  min(64 KiB, responseByteLimit)이다.
- V2 client.ts의 멱등성 거절 표·필드 검증 판정·gateway status 규칙을
  backend-envelope.ts로 옮기고 V2, V3 실행기, feature binding이 함께
  읽는다. 실행기는 그 표의 판정(422·400 거절, 필드 목록 400은 적용 안 됨,
  409 IDEMPOTENT_IN_FLIGHT·503 IDEMPOTENCY_UNAVAILABLE은 결과 불명)을
  classifyProblem보다 먼저 쓴다. binding은 mapProblem이 답하지 않으면 V2와
  같은 kind·code·validationIssues로 읽는다. V2 출력은 바뀌지 않았다.
- create:feature 뼈대: contribution이 ENVELOPE_V1을 선언하고 problem
  스키마가 Envelope error(code 필수)다. 백엔드 본문을 그대로 적은
  <base>-http-gateway.test.ts를 생성한다.
- MSW createHttpScenarioHandler는 descriptor가 ENVELOPE_V1이면 Envelope로
  답한다.

버린 대안
- provider 단위(실행기 전체): V3 실행기는 baseUrl 하나라 앱 전체가 바뀐다.
  참조 기능·테스트 계약의 problem details fixture가 모두 깨지고 한 앱이 두
  모양의 API를 쓸 수 없다.
- (나) 백엔드 problem+json·DTO 모드: 백엔드 소유자 결정 2(JSON은 모두
  Envelope)와 반대이고 백엔드가 두 모양을 계속 유지해야 한다.
- (다) 기능 스키마가 Envelope를 감쌈: 기능마다 null 생략·success 판별·
  멱등성 판정을 다시 쓰고, V2 행(data 스키마)과 V3 스키마 ID가 갈라진다.

위험·한계
- HttpContractViolationKind에 ENVELOPE_MISMATCH가 더해졌다. default 없는
  exhaustive switch는 분기를 더해야 한다.
- 실행기가 ENVELOPE_V1 operation의 위 판정을 classifyProblem보다 먼저
  정한다. 패키지가 409 IDEMPOTENT_IN_FLIGHT를 적용 안 됨이라 해도 결과
  불명이다.
- V2와 남은 차이: 64 KiB를 넘는 실패 Envelope는 V3만 읽지 않는다. 보낸
  KEYED 요청의 503은 V2만 같은 키로 자동 재시도한다(판정은 같다). 구조
  예산은 V3에만 있다.
- 참조 기능은 그대로 DTO·problem details다. tests/e2e/accessibility.spec.ts는
  모든 API에 []로 답하므로 생성한 기능 라우트는 오류 화면이 검사된다(e2e는
  돌리지 않았다).
- 초기 JS 202,770 → 203,321 B(+551 B, 예산 204,800 B).

검증
- RED: tests/integration/http-execution-v3-envelope.test.ts 19건 중 17건
  실패(성공 → SCHEMA_MISMATCH, 실패 → PROBLEM_SCHEMA_INVALID·MAYBE_APPLIED,
  조립 → unexpected key: responseEnvelope). 크기 2건은 처음부터 통과(동작
  고정).
- GREEN: 같은 파일 25건 통과. 같은 응답을 V2와 V3에 보내 kind·code·
  httpStatus·effect·retryAfterMs·validationIssues가 같음을 7가지 응답으로
  비교한다.
- check:types, lint, check:architecture, check:adapter-inventory,
  check:registries, check:diagnostics, check:i18n, check:ci 통과.
  test:unit 2,604, test:component 244, test:integration 200 통과.
  tests/features·tests/contract 124건 통과.
  test:feature-scaffold 16개 검사 통과(생성한 gateway 테스트 5건,
  Envelope로 답하는 목록 화면 테스트 3건 포함).
  test:sample-removal 23개 검사 통과.
  check:bundle 통과(203,321 / 204,800 B).

Refs: docs/reviews/2026-11-01-maturity-review/README.md 14.3, 14.6
2026-11-03 20:10:51 +09:00
DongHyeonka ec7435c3f7 docs(review): 최종 게이트와 매뉴얼 재실험에서 찾은 것을 적는다
문제: 결정 반영 묶음을 다 합친 뒤의 게이트 결과, 매뉴얼만으로 기능을
추가한 재실험 결과, 그 과정에서 찾은 결함이 리뷰 README와 CHANGELOG에
없었다.

방법:
- 리뷰 README 14.3에 세 가지를 더했다.
  - create:feature와 참조 기능(V3 실행기)이 짝 백엔드 Envelope 응답을
    읽지 못한다(High, P1, 결정 필요라 남김).
  - 매뉴얼 재실험 결과: 막힘 5건, 예고된 실패 1건. 막힘은 매뉴얼에 메웠다.
  - webkit old-tab-chunk-recovery 간헐 실패.
- 14.5에 7c7ef32 최종 게이트 표를 둔다.
- CHANGELOG 알려진 제한에 Envelope 제한과 webkit 간헐 실패를 더했다.
버린 대안: Envelope 제한을 이번에 고치기. V3 실행기에 Envelope 읽기를
넣을지, 백엔드가 problem+json을 보낼지는 두 repo에 걸친 결정이다.
게다가 백엔드 repo는 사람만 커밋한다.

위험: Envelope 제한이 풀리기 전에는 생성한 기능을 짝 백엔드에 바로 붙일
수 없다. 매뉴얼 01-3단계가 이를 적는다.

검증: tests/unit/changelog-review-ids.test.ts 통과. webkit 반복 실행
10/10 통과(load 16).
2026-11-03 08:02:03 +09:00
DongHyeonka 7c7ef32bb7 docs(changelog): 결정 반영 묶음의 계약 변경과 결과를 적는다
문제: 2026-11-03 결정(리뷰 README 14절)에 따라 만든 커밋 40여 개가
CHANGELOG 미출시 절과 리뷰 README에 없었다. 다운스트림은 CHANGELOG의
[계약]·BREAKING 행으로 가져갈 수정을 고른다. CHANGELOG 11행은 0.2.0
해시가 main에서 다를 수 있다고 적었지만 52개 모두 main에서 닿는다.

방법:
- CHANGELOG 보안·계약 표에 BREAKING 2건(1101/08-03, 0929/05-03)과
  [계약] 28건을 더했다. file-transfer 예산 행은 새 예산 규칙 행으로 바꿨다.
- 백엔드 리뷰에서 온 ID는 "백엔드 리뷰 1101/02-01"로 적어 이 repo의 같은
  번호와 섞이지 않게 했다.
- 알려진 제한에서 풀린 것(registry-baseline source, OPFS 여러 페이지
  purge)을 지우고 남은 위험을 더했다.
- 11행 해시 문장을 사실대로 고치고, docs/reviews/를 지운 복사본은 원본
  repo에서 ID를 찾는다고 적었다.
- 리뷰 README에 14.2 결과, 14.3 새로 찾은 것, 14.4 남은 문제를 더했다.

위험: 행 수가 많아 다운스트림이 놓칠 수 있다. BREAKING은 표시 열 맨
앞에 둔다.

검증: tests/unit/changelog-review-ids.test.ts 통과(라운드 없는 ID 0).
표의 각 행 열 수를 확인했다(기존 이스케이프 행 1개 제외).
2026-11-03 07:28:19 +09:00
DongHyeonka b26517e6f2 fix(docs): 설계 주석에 문서 이름을 붙이고 지운 뒤 끊기는 링크를 없앤다 (1101/14-01)
문제: 코드 주석 87곳(74파일, .dependency-cruiser.json 포함)이 "Spec §N"
처럼 문서 이름 없이 절 번호만 적는다(대문자 83, 소문자 "spec §" 4).
가리키는 설계서는 README가 복사 뒤 지워도 된다고 한 docs/reviews/ 안에
있었다. 지울 수 있는 기록 검사는 경로 문자열만 찾아 이 참조를 잡지
못했다. 현재 계약 문서도 지울 수 있는 파일로 링크한다:
docs/reviews/adapters/INVENTORY.md 145행이 옆의 adapter 리뷰로,
docs/operations/adapter-remediation-ledger.md가 adapter 리뷰와
docs/superpowers/plans의 계획으로.

고른 방법:
- 주석의 "Spec §"/"spec §"를 "scale-architecture.md §"로 바꾼다(앞
  커밋이 옮긴 docs/architecture/scale-architecture.md). 설명 문장과 절
  번호는 그대로다. 절 번호가 없는 "Spec §"는 없었다.
- tests/unit/deletable-history-documents.test.ts에 "spec" + 선택 공백 +
  "§"(대소문자 무시)를 거부하는 검사를 더하고, 검사 대상에
  .dependency-cruiser.json을 넣는다.
- README "Files you can delete after copying"에서 INVENTORY.md 한 파일
  대신 docs/reviews/adapters/ 폴더를 남기게 하고 이유(INVENTORY 행과
  ledger가 그 리뷰로 링크한다)를 적는다. docs/README.md §3도 같게 고친다.
  INVENTORY의 행 구조는 바꾸지 않는다.
- 남긴 adapter 리뷰와 ledger가 docs/superpowers/plans로 거는 링크 5곳은
  링크를 풀고 "작업 이력 계획, 복사본은 지울 수 있다"로 적는다.
버린 대안: INVENTORY 145칸의 링크를 그룹 이름으로 바꾸기. 템플릿에서도
상세 리뷰로 가는 길이 없어지고 수정이 145곳이다. 계획 3개도 지우기
목록에서 빼기. 지울 수 있는 폴더 안에 예외가 흩어지고, 계획이 다시
다른 이력을 가리키면 남길 목록이 계속 커진다.

위험·한계: 검사는 "HTML spec §4"처럼 다른 명세를 "spec §"로 부르는
주석도 거부한다. 그때는 "HTML Standard §4"처럼 이름을 쓴다.
src/contracts/storage-keys.ts:79의 "release-coherence plan Task 6"처럼
이름 없는 계획 참조는 이 검사가 잡지 않는다. 복사한 프로젝트가 이미
docs/reviews/adapters/를 지웠다면 링크는 계속 끊겨 있다. CHANGELOG.md의
이력 언급 4곳(:15 두 경로, :75 PRODUCT.md, :93)은 고치지 않았다.
check:remediation-ledger는 이 변경 전후 같은 4줄로 실패한다(이미 있던
실패, 게이트 밖). tests/unit/telemetry.test.ts의 describe 이름 하나가
바뀐다.

검증:
- RED: 치환 전 새 검사가 87줄을 들어 실패(1 failed | 1 passed).
- GREEN: 같은 테스트 2 passed. 변이 "// Spec §4. budgets live here"를
  src/platform/errors/app-error.ts에 넣으면 그 한 줄로 실패, 되돌림.
- 치환 diff: 바뀐 87줄 쌍이 토큰 외에 같음(스크립트 대조, 불일치 0).
- 삭제 실험(작업 트리 복사본에서 README 목록대로 지움): 끊긴 링크
  148→0, 끊긴 경로 언급 10→4(남은 4는 CHANGELOG.md), 이름 없는 설계
  참조 87→0, scale-architecture.md §N 87곳 중 없는 절 0. 같은 복사본에서
  verify-documentation-readiness PASS_SCOPED, 지울 수 있는 기록 테스트
  2 passed.
- node scripts/verify-documentation-readiness.ts: PASS_SCOPED
- node scripts/check-adapter-inventory.ts: PASS
- node scripts/run-vitest.ts run tests/unit/deletable-history-documents.test.ts
  tests/unit/documentation-readiness.test.ts tests/unit/telemetry.test.ts:
  50 passed. tests/architecture: 39 passed.
- npx tsc --noEmit (app·node·test): 모두 통과. 바꾼 TS 74파일 eslint 통과.
  .dependency-cruiser.json JSON 파싱 통과.
- 미실행: check:architecture(pnpm 필요).
2026-11-03 07:17:49 +09:00
DongHyeonka 7a70cea631 docs(review): 결정 대기 항목의 결정과 이유를 적는다
문제: 13.5절의 건너뛴 20건과 5절의 확장 지점 범위가 결정을 기다리고
있었다. 결정이 없어서 0929/08-02·08-03, 13-01 같은 항목이 계속 미뤄졌다.

방법: 사용자가 결정을 오케스트레이터에게 맡겼다. 14절에 항목마다 결정,
이유, 버린 대안을 적었다. 레지스트리 기준선 재승인도 이 위임으로 한다는
것을 함께 적었다. 처리 결과는 구현을 합친 뒤 14.2절에 적는다.

위험: 08-03(raw mutation 제거)과 0929/05-03(recipe port 통합)은 다운스트림
코드를 깨는 공개 계약 변경이다. CHANGELOG에 이행 방법을 함께 적어야 한다.

검증: 문서만 바꿨다. 결정 근거는 각 영역 문서의 최소 개선 방향·대안 비교와
지난밤 에이전트 보고에서 가져왔다.
2026-11-03 00:33:03 +09:00
DongHyeonka d9366b73e3 docs(review): 개선 순서 2와 P2·P3 조치 현황, 건너뛴 것과 이유를 적는다
문제: 리뷰 README 13절은 개선 순서 1까지만 적혀 있었다. 밤사이 고친
ID와 커밋, 건너뛴 항목과 이유, 새로 찾은 결함, 예산 여유가 에이전트
보고에만 있었다. CHANGELOG 알려진 제한에는 이미 해결된 두 줄(규모
기준선이 15-01 전 측정, 좁은 화면 골든 미갱신)이 남아 있었고, 규모 근거
문장이 옛 수치를 적고 있었다.

방법: README 13.3~13.8에 개선 순서 2, 영역별 고친 ID와 커밋, 결정이
필요한 건너뛴 항목 20줄, 새 발견(여러 페이지 OPFS purge), 예산 여유,
마지막 게이트를 더했다. 영역 문서는 리뷰 시점 기록이라 고치지 않았다.
CHANGELOG는 해결된 두 줄을 지우고 OPFS purge 제한을 더했다.
feature-shape-ceilings.json의 Initial/Lazy JavaScript 수치를 9333595
측정에 맞췄다.

위험: 13.6의 OPFS purge 결함은 코드로만 확인했다(E2). 실행 재현은 없다.

검증: changelog-review-ids, feature-shape-growth, documentation-readiness,
deletable-history-documents 11/11 통과. verify:documentation PASS_SCOPED.
2026-11-02 00:53:54 +09:00
DongHyeonka 003832b694 docs(changelog): 리뷰 발견 ID에 라운드를 붙인다 (1101/14-02)
문제
리뷰 라운드마다 발견 ID를 `NN-MM`으로 새로 매긴다. CHANGELOG의
`(14-02)`는 0925 라운드의 "CI 계약 고정"인데, 0929 라운드의 14-02는
"README 업데이트 절차"이고 이번 라운드에도 14-02가 있다. CHANGELOG는
복사한 프로젝트가 변경 근거를 찾는 유일한 링크라 ID가 어느 라운드인지
모르면 다른 결함을 읽게 된다. 리뷰 가이드에 ID 네임스페이스 규칙이 없다.

고른 방법
- CHANGELOG 0.2.0 절의 ID 98개에 `0925/`를 붙였다(`F-N`은 0925
  FOLLOW-UP의 ID라 같이 붙였다). 기계적 치환이다: 괄호 안의
  `NN-MM`·`F-N`만, 범위(`01-01~01-11`)는 앞에만, 날짜는 건드리지 않는다.
  0.1.0 절의 `R-x.y`는 다른 체계라 그대로 둔다.
- CHANGELOG 머리말에 `MMDD/NN-MM` 규칙과 F-N의 뜻을 적었다.
- 리뷰 가이드 36.3 "ID·제목"에 같은 규칙을 넣었다. 라운드 안에서는
  `NN-MM`, 밖에서 가리킬 때는 `MMDD/NN-MM`. 기존 코드 주석 약 339곳은
  고치지 않고 새로 쓰는 것부터 붙인다(리뷰의 최소 개선 방향 ③).
- tests/unit/changelog-review-ids.test.ts가 CHANGELOG 괄호 안의 라운드
  없는 ID를 막는다. 리뷰가 적은 grep 검증을 test:unit 게이트로 옮긴 것이다.

버린 대안
- CHANGELOG 표에 라운드 열 추가: "그 밖의 수정" 목록에는 표가 없어 규칙이
  둘이 된다. ID 자체에 붙이는 쪽이 코드 주석·커밋 제목과 같은 형식이다.
- 접두어를 `YYYYMMDD/`로: 이미 브랜치의 커밋과 리뷰 README가
  `0929/03-01` 형식을 쓴다. 해가 바뀌어 월일이 겹치면 그때 연도를 붙인다.

위험·한계
- 기존 주석과 0.2.0 커밋 제목은 라운드 없는 ID로 남는다(혼재 기간).
- 테스트는 괄호 안 쉼표 구분 토큰만 본다. 괄호 밖 본문에 쓴 ID는 잡지
  않는다.

검증
- RED: node scripts/run-vitest.ts run tests/unit/changelog-review-ids.test.ts
  실패 "expected [ '03-03', '03-01', '08-03', …(95) ] to deeply equal []"
- GREEN: 같은 테스트 통과. 리뷰의 검증 명령
  `grep -cE '\(([0-9]{2}-[0-9]{2})' CHANGELOG.md` → 0
- eslint, tsc(test), verify-documentation-readiness PASS_SCOPED,
  check-ci-contract PASS(새 테스트 파일이 test:unit 게이트에 들어감)

Refs: docs/reviews/2026-11-01-maturity-review/14-template-product-docs.md 14-02
2026-11-01 22:49:13 +09:00
DongHyeonka 4b646f687f docs(review): 개선 순서 1의 조치 현황과 남은 cgroup 경쟁을 기록한다
리뷰 README에 개선 순서 1을 어떻게 닫았는지가 없었다. 11-01은 고친 뒤
다른 단언에서 간헐 실패가 드러났다.

13절에 발견별 상태, 커밋, 막는 테스트를 적었다. 11-01은 부분 충족으로
두고, 되돌린 시도 세 가지와 다음 방향(표본 대신 실행 증거 파일)을
13.1절에 남겼다. 영역 문서는 리뷰 시점 기록이라 고치지 않았다.

위험: 문서만 바뀐다.
검증: verify:documentation PASS_SCOPED. cgroup 테스트 10회 중 6회 통과
(부하 약 3)를 직접 측정했다.
2026-11-01 19:32:32 +09:00
DongHyeonka 49d8675f97 fix(design-system): 컴포넌트 토큰 사용 검사가 이름 전체를 맞춰 본다 (12-01, 12-02)
문제: UI-03 규칙은 source.includes(`var(${token}`)로 독자를 찾는다.
"var(--field-border"가 var(--field-border-invalid) 안에도 있어서, 독자가
0곳이던 --field-border를 통과시켰다. 주석 안의 var(--x)도 독자로 셌다.
그리고 이번 브랜치의 디자인 규칙 4개(포커스 대비, oklab 혼합, 토큰
사용, 첫 글꼴)는 스크립트 본문에 바로 있어서, 규칙을 꺼도 잡는 테스트가
없었다(12-02).

고른 방법:
- 규칙 4개를 scripts/lib/design-system-rules.ts의 순수 함수로 옮긴다.
  입력은 CSS 글자와 토큰 맵이고 출력은 실패 메시지다. 메시지 문구와
  순서는 그대로다.
- 토큰 독자는 var(--name) 또는 var(--name, ...)처럼 이름 전체가 맞아야
  한다. "var"는 대소문자를 무시하고, 사용자 정의 속성 이름은 CSS 규칙
  대로 대소문자를 구분한다.
- 토큰 사용 규칙과 oklab 혼합 규칙은 CSS 주석을 지우고 본다(리뷰 probe
  B5 우회, B12 오탐).
- oklab 혼합 규칙은 대소문자를 무시한다(B1 `in OKLCH` 우회). CSS
  키워드는 대소문자를 구분하지 않는다.
- ui-design-audit.md의 UI-03 행에 다섯 번째 토큰을 적는다.
버린 대안: 12-02가 제안한 --root 인자와 CSS 음성 fixture 폴더. 규칙별
검출을 증명하려면 어차피 실패 메시지를 단언하는 테스트가 필요하고,
순수 함수 단위 테스트가 fixture 파일 없이 같은 것을 증명한다. 게이트의
--fixture 모드와 산출물 스키마는 바꾸지 않았다.

위험·한계:
- 주석 제거는 정규식이라 따옴표 문자열 안의 "/*"를 주석 시작으로
  본다. 지금 CSS에는 없다.
- 12-03의 나머지 우회(그라디언트, TSX 인라인, base.css 재정의,
  outline-offset 0, feature CSS)와 12-04의 오탐(-apple-system, deg,
  알파, color-mix 표면)은 그대로다. 포커스·글꼴 규칙은 주석을 지우지
  않는다.
- 게이트의 check:design-system:fixture는 여전히 TSX fixture 두 개만으로
  "기대 실패"를 채운다. CSS 규칙 회귀는 test:unit이 잡는다.

검증:
- RED(규칙을 동작 그대로 옮긴 상태): tests/unit/design-system-rules.test.ts
  11개 중 5개 실패. "does not count a longer token that starts with the
  same name"이 "expected [] to deeply equal [ Array(1) ]"로 실패했다.
  나머지 4개는 대문자 OKLCH, 주석 안 혼합, VAR( --x , ...) 형태, 주석
  안 독자.
- 고친 검사를 앞 커밋 전 CSS(402e1db)에 돌리면 "component token
  --field-border is defined but no style reads it"으로 실패했다.
- GREEN: 같은 파일 11/11 통과. tests/unit 166파일 2364개 통과.
- 변이: 대비 기준 < 0, 혼합 정규식 무력화, 토큰·글꼴 판정 무조건
  통과로 바꾸면 규칙마다 실패 테스트가 하나 이상 깨졌다(7/11 실패).
- check:design-system PASS, --fixture는 기대대로 실패. tsc(app, node,
  test) 통과, 바꾼 파일 eslint 통과, verify-documentation PASS_SCOPED.

Refs: docs/reviews/2026-11-01-maturity-review/12-guardrails-ci.md 12-01, 12-02
2026-11-01 19:07:05 +09:00
DongHyeonka 402e1db592 docs(review): 2026-11-01 성숙도 리뷰 16개 영역 결과를 추가한다
지난 리뷰(09-29) 뒤로 무엇이 고쳐졌고 무엇이 남았는지, 그리고 이번에
사용자가 요구한 성능 실측·폴더 구조·리팩토링·기능 개발 패턴을 확인한
기록이 없었다.

지난 14개 영역에 15(성능 실측)와 16(폴더 구조·기능 개발 패턴)을 더해
영역 에이전트 16개가 병렬로 리뷰했다. README에는 사용 결정, 차단 항목,
28개 관점 판정, 결정이 필요한 것, 개선 순서, 발견 색인을 모았다.
High 4건과 P1 일부(11-01)는 오케스트레이터가 코드에서 다시 확인했다.

위험: 문서만 추가한다. 영역 문서의 기준 커밋 d99301b는 메시지를 다시
쓴 c0c5d9c와 트리가 같다(README 9절).
검증: verify:documentation PASS_SCOPED. 발견 색인은 영역 문서에서
스크립트로 뽑았다(95건, 새 발견 90건).
2026-11-01 18:34:47 +09:00
DongHyeonka df66cc9e53 docs(review): UI 감사 발견별 조치 결과를 기록한다
감사 문서에 발견마다 어떻게 닫았는지가 없었다.

조치 결과 표를 추가했다. 넣은 검사, 커밋, UI-03 범위 확대(읽히지 않던
컴포넌트 토큰 4개), UI-05의 남은 절반(시각 테스트 글꼴 고정),
UI-07 재판정(정상 구성과 데모 틀이라 조치 안 함)을 적었다.

위험: 문서만 바뀐다.
검증: 표의 커밋 ID와 검사 이름을 브랜치 기록과 대조했다.
2026-11-01 18:34:28 +09:00
DongHyeonka b28715c783 docs: PRODUCT.md와 2026-11-01 UI 디자인 감사 문서를 추가한다
impeccable이 읽을 제품 정보(사용자, 목적, 제약, 원칙)가 없었다.
화면 품질을 실제 브라우저에서 잰 기록도 없었다.

PRODUCT.md에는 사용자 답으로 확인한 제품 사실만 적었다. 감사 문서는
6개 화면을 라이트·다크, 1280·375·320 폭에서 잰 발견 8건(UI-01~08)을
가이드 36.3 양식으로 적었다. DESIGN.md는 만들지 않았다. 토큰 값을
문서 머리에 복사하는 형식이라 tokens/*.css와 갈라진 복사본이 생긴다.

위험: 문서만 추가한다. 동작 변경은 없다.
검증: verify:documentation PASS_SCOPED.
2026-11-01 18:34:28 +09:00
DongHyeonka 752a61f28b refactor: 리펙토링 문서 추가 2026-10-02 14:25:27 +09:00
donghyeon-kaandClaude Opus 5.5 af3d8e6ffe docs(review): record the calls deferred during the maturity review round
FOLLOW-UP.md lists, with priority and code locations, what this round
left as it is although practice would not: raised bundle budgets and
the near-full initial JS budget, the ungated remediation ledger check,
the readSubject breaking change, load-flaky tests, gaps outside the
completion criteria, and test-side workarounds. README section 11
links it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 01:54:29 +09:00
donghyeon-kaandClaude Opus 5.5 f753669333 docs: record the WebKit run now that the host can launch it
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 01:44:12 +09:00
donghyeon-kaandClaude Opus 5.5 37113c3be0 docs(review): record the regressions the full browser run found
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 01:23:15 +09:00
donghyeon-kaandClaude Opus 5.5 9042420e27 docs(review): record the resolution of every finding and check off the task list
The index notes now name the fixing commits, with user-owned remainders
and the 01-06 decision marked. Section 11 records the post-lane
verification, the gaps it found and closed, what could not be verified
on this host, and the user-owned items.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-28 01:01:20 +09:00
donghyeon-kaandClaude Opus 5.5 70f4ff8717 fix(scale): keep the ceiling rationale next to the baseline, not in a review document (11-04, 00-02, 14-05)
The growth test read docs/reviews/, which the removal fixtures do not copy and
README lets a project delete, so three removal checks failed with ENOENT. The
rationale now lives in config/scale/feature-shape-ceilings.json and a guard
test keeps code from reading the deletable history documents.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-27 14:03:03 +09:00
donghyeon-kaandClaude Opus 5.5 34c97885ea test(e2e): recover an old tab's missing chunk without a service worker (11-05)
Old-tab chunk recovery in the default configuration only had jsdom tests, and
the old-asset test checked its own hosting fixture. A spec now serves two real
builds: the old tab reloads once into the new one and not a second time. The
fixture test and the acceptance row now say what they cover.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-27 13:10:13 +09:00
donghyeon-kaandClaude Opus 5.5 a96fd241db test(scale): measure one app growing with real-shape features (11-04)
The scale evidence came from stub features, so the cost of one app growing
towards its declared ceiling was never measured. Copies of the reference
feature at 25 and 100 are now the baseline, and the acceptance matrix says
what the ceilings rest on and which axes stay unverified.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-27 13:06:23 +09:00
DongHyeonkaandClaude Opus 5.5 6cc652610d refactor(storage): move the IndexedDB error table to the kernel exception file (05-11)
The OPFS journal imported mapIndexedDbException from the IndexedDB runtime's
folder, so the two runtimes were not separable as the comments claimed. The
table now lives in browser-file-storage/result.ts next to the DOM table, with
the differences between the two written down; storage/opfs imports nothing
from storage/indexeddb. The storage barrel comment now states the drill's
real scope: it removes the whole bundle, never one folder.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 22:52:29 +09:00
DongHyeonkaandClaude Opus 5.5 412b3d1f1e docs: add the maturity review guide and the 2026-09-25 full review
CLAUDE.md makes the guide the standing review standard for this repo.
The review folder holds 14 area reports and the summary with the
28-perspective table and the finding index.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-25 21:05:08 +09:00
DongHyeonkaandClaude Opus 5.5 a328776bf2 fix(telemetry): send both telemetry ports through one collector transport (Q-6.9-4)
The application port (best-effort-telemetry) and the feature port
(feature-telemetry pipeline) each posted to TELEMETRY_ENDPOINT on their
own: 20+20 sends per minute, cookies on the application side, no
pagehide flush or dispose abort on the feature side, and no deadline on
any fetch, so a hung collector held activeFlush forever (6.3-10).

New src/adapters/telemetry/telemetry-collector.ts is the one transport:
shared send-rate window (createTelemetrySendRate, now in the platform
pipeline and injectable via `sendRate`), credentials "omit", cache
"no-store", a per-request deadline through the kernel
createAbortableOperation, and one pagehide fan-out. runtime-adapters
builds one collector and passes it to both ports. Body projections are
unchanged and pinned by characterization tests first.

Verified: new tests in tests/unit/telemetry.test.ts (5 RED before
wiring: credentials/cache, hung collector timeout, shared rate,
feature pagehide flush, feature dispose abort); all gates pass except
the known tests/unit/removal-fixture.test.ts (artifacts/ absent);
check:adapter-inventory 137/137; FE-RB-004 drill PASS.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 13:58:35 +09:00
DongHyeonkaandClaude Opus 5.5 ae2f006b6d refactor(realtime): merge snapshot and race helpers, move shared parsers to kernel (Q-6.4-8)
Realtime kept three DataSnapshot readers and about ten hand-written
abort/timeout races, and two parsers had drifted copies in other adapters.

Snapshot: reconnect-coordinator and bounded-poll now use result.ts
captureRealtimeDataSnapshot (+ `source`, variadic hasExactSnapshotKeys).
Kept the result.ts rules, the stricter ones: Object.hasOwn instead of
`"value" in` (prototype pollution), enumerable fields only, keys read from
one descriptor snapshot, frozen computed at snapshot time instead of a
later Object.isFrozen. Poll therefore now rejects non-enumerable fields;
it also accepts null-prototype records, which the other two copies
already did (pure data, no inherited accessors). Characterization test
added for both in bounded-poll-coordinator.test.ts.

Race: one raceRealtimeTask(task, signal, deadline) in result.ts, built on
kernel createAbortableOperation, replaces fetch-sse timed/cancelReader,
reconnect race/drain (the drain keeps a host timer via timerDeadline,
since the clock itself may hang), poll awaitTaskOrAbort/awaitWithinLease,
live-poll checkpoint + two quiescence races (now one), stream-coordinator
deadline/recovery-wait/close-drain, and the two WS inline races. Kept
semantics: deadline armed first and wins a tie (poll lease), task still
starts when the clock throws (reader cancel), collaborator rejections
still reach stream-coordinator callers, scheduler install failure still
fails closed as a timeout. Small change: nothing starts once the signal is
already aborted (WS apply / SSE onEvent / reader.read could run just
before being reported ABORTED). The mapping adds one microtask per race,
so the reconnect test flush() helper gets 16 turns instead of 8.

Kernel: parseRetryAfterDelay moves to platform/retry-after.ts (realtime
re-exports it; http retry-policy parseRetryAfter now delegates, so it
rejects "", "  ", "1e3", "1.5", "0x10" and non-IMF dates it used to
accept). json-member-scanner moves to platform/; web-push push-codec uses
it instead of its top-level-only duplicate-key check, so nested
duplicates are rejected too. INVENTORY 136 -> 137, detail tables updated.

Tests: RED for http strict Retry-After, web-push nested duplicate, poll
snapshot rules; new direct raceRealtimeTask tests. Gates: architecture,
types app/test (+ service-worker/web-worker), lint, adapter-inventory
(abort ratchet 21/21), test:unit, test:component, realtime-boundaries,
integration/platform all pass. Realtime bundle 40346 -> 39433 gzip.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 13:54:42 +09:00
DongHyeonkaandClaude Opus 5.5 1b9e2c5ec6 fix(http): recover a V2 401 outside the retry budget and correct the rollback claim (Q-6.3-11)
The V2 client only attempted 401 session recovery while the physical
attempt count was under maxRetryAttempts + 1. With MAX_RETRY_ATTEMPTS=0,
or when a 503 retry had already used the budget, a recoverable 401 went
straight to onUnauthenticated() and logged the user out. Recovery is
already bounded to one replay by recoveryUsed and by the deadline, so
the budget check is removed.

The comments in runtime-adapters.ts and adapters/http/index.ts said V2
works as a rollback path for V3 once its four slots are injected. That
is wrong: V2 validates the {success,data,meta} envelope and V3 the bare
DTO, so the same backend fails every V2 response with
ENVELOPE_MISMATCH. The comments and the client.ts ledger row in
docs/reviews/adapters/01-network-and-state.md now say a rollback also
needs a V2-envelope server. No docs/architecture page made the claim.
V2 code is kept.

Verified: two new auth-recovery cases (retries disabled; 503 then 401)
failed RED with ok:false and now recover. All lane gates pass except
the known removal-fixture test; verify:documentation passes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 13:41:45 +09:00
DongHyeonkaandClaude Opus 5.5 4093ee8fc2 refactor(cache-storage): split the cache and download codecs out of their adapters (Q-6.2-11)
public-response-cache-adapter.ts (1986 lines) and download-delivery-adapter.ts
(1491 lines) mixed the facade with codecs and validators. Moved verbatim:
- cache-storage/public-cache-codec.ts: manifest normalization and canonical
  digest input, marker/active-pointer validation, bounded control JSON,
  owned cache names, CacheValidationFailure -> Result mapping.
- cache-storage/public-cache-response-validation.ts: response admission
  (status, directives, Content-Type, Vary, bounded body, digest).
- browser-files/download-input-validation.ts: request snapshot, input/limit
  checks, presigned and browser-managed capability validation, handoff target.
The adapters drop to 1164 and 1157 lines.

Two non-verbatim edits: validateDownloadInput takes a structural
DownloadInputValidationOptions instead of DownloadDeliveryAdapterOptions (no
import cycle), and readBodyBounded races reads on the kernel
createAbortableOperation instead of its own abort listener. Moving it out of
a primitive-importing file would otherwise have raised the hand-rolled abort
ratchet to 20/19; the abort outcome (ABORTED, reader cancelled) is unchanged.

Verified: characterization tests added first and passing before the move
(cache manifest/response/control-JSON failure codes, lookup abort during a
pending body read; download input validation codes); a line diff confirms the
moved code is verbatim apart from the two edits above. Inventory 139/139,
lane gates, check:browser-file-storage-boundaries pass.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 13:39:59 +09:00
DongHyeonkaandClaude Opus 5.5 ec71b0b0a2 refactor(web-push): merge codec primitives into one module and inject the page document (Q-6.6-12)
web-push/codec-primitives.ts now owns OPAQUE_ID/validOpaqueId, isRecord,
hasExactKeys, exactRecord, validAuthority, base64UrlDecode and (to share the
alphabet) base64UrlEncode. push-codec,
push-registration-gateway, push-association-fence-store,
push-subscription-adapter and service-worker-runtime import them instead of
carrying their own copies (the fence store's control/association key checks
now use exactRecord/hasExactKeys with the same key lists). The duplicate-key
JSON scan in push-codec.ts is untouched (realtime lane, T76).

Where the copies differed, the stricter validated behavior is kept:
- validAuthority: the fence store's null guard. The gateway's copy threw a
  TypeError for a null authority, so register()/reconcile() rejected instead
  of returning INVALID_INPUT; they now return INVALID_INPUT (the only change a
  caller can observe; characterization test was RED before the merge).
  Non-record values (arrays) are also refused.
- base64UrlDecode: the gateway's decoder, which refuses a lone trailing
  character (length % 4 == 1). The window adapter's copy accepted it when the
  spare bits were zero; its only caller pre-checks an 87-char VAPID key, so
  that difference was not reachable. `>>` vs `>>>` gave identical bytes.
- OPAQUE_ID, isRecord/hasExactKeys/exactRecord were already identical.

Page controller: PageControllerDependencies gains optional `document`; the
6-hour update check reads it (falling back to the global document), and
bootstrap/register-service-worker.ts now passes host.document through.

New adapter file: INVENTORY.md row 126 + renumber, total 137/137; detail row in
docs/reviews/adapters/05-service-worker-and-web-push.md.

Verified: characterization tests pinned the caller-visible behavior of every
copy before the merge (spare-bit keys, VAPID key, null authority in fence
store and gateway, array/extra-key backend answers, opaque ids); all pass
after, plus direct base64UrlDecode tests and an encode round-trip against
Node's base64url for lengths 0..66. Document injection test was RED
(update() ran while the injected document was hidden), green after. Gates:
check:architecture, types app/test/service-worker, lint, test:unit (only
pre-existing removal-fixture failure), test:component,
check:realtime-boundaries, check:adapter-inventory.
Realtime reference bundle (check:optional-recipes:source, already over budget
at b953142): 40139 -> 40097 gzip bytes after T89+T90.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 13:37:56 +09:00
DongHyeonkaandClaude Opus 5.5 7e610d1d05 refactor(browser-transfer): split validation and dependency snapshots out of the upload runtime (Q-6.1-10)
resumable-upload-runtime.ts carried the upload flow, retry/deadline, the
server response decoders and eight dependency snapshot wrappers in one
2.3k-line file. Moved without changing behavior:
- runtime-dependencies.ts: the dependency types, snapshotDependencies and
  its per-collaborator wrappers, safeNow/safeRandom and the default sleep.
- upload-response-validation.ts: validateSession, validateStatus,
  validatePartCapability, the receipt check and the small shared helpers
  (exactKeys, sameFingerprint, snapshotReceipts).
The runtime re-exports ResumableUploadRuntimeDependencies, so the public
surface is unchanged. The default sleep now waits on the kernel
createAbortableOperation instead of its own timer/listener pair, so the
moved file does not add a hand-rolled abort offender (ratchet stays 20/21).
INVENTORY and the detail review list the two files.

Verified: new characterization suite resumable-upload-runtime-contract
(invalid collaborators throw at composition, methods captured at
composition, frozen observer copies, throwing clock, default sleep retry
and abort, session/capability/status/receipt rejections) written and green
before the move, still green after + existing runtime suites + all gates.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 13:33:05 +09:00
DongHyeonkaandClaude Opus 5.5 9e2c98272f fix(browser-transfer): share one presigned HTTP helper module (Q-6.1-9)
The presigned executor and the capability provider each carried a copy of
createAbortScope, readWithSignal, transferFailure, isAbortSignal,
byteBucket, body/reader cancel, Content-Length parsing and statusFailure.
They now import them from presigned/http-common.ts.

Behavior changes:
- statusFailure is one table. The provider used NONE for 401/403 and RETRY
  for 429/5xx; it now answers REISSUE_CAPABILITY like the executor. Retry
  decisions (retryable) are unchanged. Chosen because capabilities are
  single-use and the architecture doc (3.2) and BT-PRE-04 already say a
  refusal is recovered by a new capability.
- The download check used Number(Content-Length), which let "5e0", "0x5",
  "+5" and "5.0" through; it now uses the strict decimal parser the upload
  path and the provider already had.
- The executor's compensateLateResponse had no caller and is deleted.
- The resumable runtime's invokeProviderAttempt now bounds each attempt with
  the kernel createAbortableOperation instead of its own listener/timer
  race; outcomes (ABORTED on caller abort, retryable UNAVAILABLE on the
  deadline) are unchanged.

INVENTORY and the browser-transfer detail review list the new file. The
hand-rolled abort ratchet drops to 20/21; the ceiling constant is left for
the integration step so parallel lanes do not conflict on it.

Verified: RED tests "rejects a download Content-Length that is not a plain
decimal" (5e0 was accepted) and "maps capability endpoint statuses with the
executor's recovery table" (401 was NONE); existing presigned and runtime
suites cover the moved code + all gates.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 13:32:56 +09:00
DongHyeonkaandClaude Opus 5.5 16abd920a7 refactor(storage): keep IndexedDB stored-row rules in one module (Q-6.5-7)
The runtime and maintenance each carried their own Stored* row types,
isStored* validators, record size formula, countBucket and failureOf, and
the dataset binding check had a third, hand-written budget validator. A
field added to one copy would make the other judge a healthy row corrupt.

indexeddb-records.ts now holds the row types, the validators, the budget
key and measureRecordBytes (payload + 512-byte envelope + UTF-16 key). Each
call site keeps its own failure code for a bad measurement (runtime
INVALID_INPUT, maintenance MIGRATION_FAILED), and only the binding check
still bounds a stored budget by hardBudgetBytes. The one validator
difference (maintenance's retention check did not re-validate the key it
compared against) is unobservable: it always passes a validated record key.

Verified: characterization tests added first in
tests/unit/indexeddb-maintenance.test.ts pin the size formula in both
writers, the per-site failure codes for NaN/negative/oversized sizes, and
the hardBudgetBytes bound at open (runtime and maintenance fail with
POLICY_REJECTED one byte over, open at the limit). They passed before and
after the refactor. INVENTORY.md (137/137) and the storage detail table
list the new file. All gates pass.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 13:30:26 +09:00
DongHyeonkaandClaude Opus 5.5 2fb07c857a docs: register adapter files missing from the inventory ledger
6f6c48e added src/adapters/http/platform-error-mapping.ts and
src/adapters/telemetry/feature-telemetry.ts without ledger rows, so
check:adapter-inventory failed on the base branch. Add both rows, renumber,
update the total to 136/136 and add the matching detail-review rows.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 12:29:53 +09:00