문제: 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