docs(architecture): 캐시 문서의 밀린 줄 번호 참조를 심볼 이름으로 바꾼다

문제: client-cache-and-storage.md의 cross-context 조립 설명이
runtime-adapters.ts·server-state-scope-runtime.ts·tanstack-cache-
coordinator.ts의 줄 번호를 가리키는데, 네 곳 모두 다른 코드로 밀렸다
(0929/02-04). 문서 줄 번호를 보는 검사는 없어서 다음 변경에도 또 밀린다.
browser-file-and-origin-storage.md의 participant 등록 예 줄 번호는 앞
커밋(02-01)이 이미 고쳤다.

고른 방법: 줄 번호 대신 함수·호출 이름을 적는다(1101/05-05와 같은
방식). 리뷰가 맞다고 확인한 다른 줄 번호는 그대로 둔다.

위험·한계: 문서만 바꾼다. 다른 문서의 줄 번호 참조는 건드리지 않았다.

검증: verify:documentation PASS_SCOPED.

Refs: docs/reviews/2026-11-03-maturity-review/02-adapters-browser-files-cache.md 0929/02-04
This commit is contained in:
DongHyeonka
2026-11-04 21:02:15 +09:00
parent 3bfe6a8580
commit d9ca6537d8
@@ -90,14 +90,16 @@ host facade는 native `StorageEvent.storageArea`를 캡처한 `localStorage` 객
(`browser-cross-context-invalidation.ts:197-201`).
현재 epoch는 release 하나다. `cacheEpoch`는 release ID의 64-bit FNV-1a digest를
`release.<16자리 hex>`로 쓴 값이다(`browser-cross-context-host.ts:45-51`, 조립
`src/bootstrap/runtime-adapters.ts:364-366`). 세션 identity가 바뀌면 scope
`release.<16자리 hex>`로 쓴 값이다(`browser-cross-context-host.ts`
`crossContextCacheEpochForRelease`, 조립은 `src/bootstrap/runtime-adapters.ts`의
`createServerStateGenerationStore` 콜백). 세션 identity가 바뀌면 scope
runtime이 다음 server-state generation을 열고
(`src/adapters/query-cache/server-state-scope-runtime.ts:148`), generation마다
새 `QueryClient`와 새 cross-context transport(새 `sourceId`·`sourceEpoch`)를
만든다(`src/bootstrap/server-state-generation-store.ts:50-57`,
`runtime-adapters.ts:359-372`). 이전 generation의 transport는 coordinator
dispose에서 닫힌다(`src/adapters/query-cache/tanstack-cache-coordinator.ts:276-280`).
(`src/adapters/query-cache/server-state-scope-runtime.ts`의
`activateNextGeneration` 호출), generation마다 새 `QueryClient`와 새
cross-context transport(새 `sourceId`·`sourceEpoch`)를 만든다
(`src/bootstrap/server-state-generation-store.ts:50-57`, 같은 콜백). 이전
generation의 transport는 coordinator `dispose()`에서 닫힌다
(`src/adapters/query-cache/tanstack-cache-coordinator.ts`).
session/account epoch, opaque account partition과 durable namespace epoch는
아직 없다. wire event에 사용자·세션 scope가 없으므로 현재 cross-tab event는 같은
release의 등록 query topic을 빠르게 stale 처리하는 용도에 한정된다.