Files
clean-architecture-frontend…/src/adapters/platform
DongHyeonka cc011bc740 docs(platform): kernel 주석의 줄 번호 참조를 심볼 이름으로 바꾼다 (05-05)
문제: kernel 주석이 근거를 다른 파일의 줄 번호로만 준다. 줄이 밀려
참조 20개 중 19개가 엉뚱한 코드를 가리킨다. 예를 들어
indexeddb-transaction.ts의 "runtime은 지운 행 수로 예산을 잰다"는
indexeddb-runtime.ts:2384를 가리키는데 그 줄은 cursor 삭제 onerror다.
네 벌의 transaction 상태 기계를 가리키는 참조 넷은 kernel 이전 코드라
이미 없다(네 어댑터 모두 지금은 runIndexedDbTransaction을 쓴다).

고른 방법: 리뷰 권고대로 줄 번호 대신 심볼 이름을 쓴다.
- purgeEligibleRecords, scanBatch, monotonicClock, runCheckpointTransaction,
  bindScope, 체크포인트 store의 translate, BT-UP-03,
  restrictedBrowserDataProperties, browser-data-boundary 예외 목록,
  REQUIRED_ABORT_CONSUMERS.
- 없어진 코드를 가리키던 역사 설명은 "IDB-X-02 이전에는 네 벌이
  달랐다", "runtime의 kernel 이전 fail/requestFailed 의미"처럼 ID와
  과거형으로 줄였다. "runtime이 지금 inline으로 한다"처럼 더는 사실이
  아닌 문장은 지웠다.
- 유일하게 맞던 abortable-operation.ts:11도 같은 규칙으로 줄 번호만
  뺐다(심볼 AbortTerminalReason이 이미 문장에 있다).

버린 대안: 줄 번호를 지금 위치로 다시 맞추기. 다음 수정에서 또 밀린다.

위험·한계: 주석만 바뀐다. 코드·번들 크기(주석은 minify에서 빠짐)는
그대로다. 심볼 이름도 이름이 바뀌면 낡지만 grep으로 바로 찾을 수 있다.

검증:
- RED(문서·코드 대조): platform/·browser-file-storage/의
  `grep -rnE '\.(ts|json|md|mjs):[0-9]+'` 20건을 스크립트로 열어 대조.
  19건이 다른 코드(예: check-adapter-inventory.ts:63-83은 INVENTORY 중복
  행 검사, eslint.config.ts:519-530은 블록 끝 "},"), 1건만 맞음.
- GREEN: 같은 grep 0건. 새로 적은 심볼은 모두 해당 파일에 있는 것을
  확인했다.
- 회귀: indexeddb-transaction, indexeddb-connection, browser-lifecycle
  3파일 66/66 통과. tsc app 통과, eslint 통과, check-adapter-inventory
  145 files PASS.

Refs: docs/reviews/2026-11-01-maturity-review/05-adapters-storage-kernel.md
2026-11-01 22:25:41 +09:00
..
2026-07-30 15:58:20 +09:00