diff --git a/docs/architecture/client-cache-and-storage.md b/docs/architecture/client-cache-and-storage.md index f7915853..8e7143d6 100644 --- a/docs/architecture/client-cache-and-storage.md +++ b/docs/architecture/client-cache-and-storage.md @@ -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 처리하는 용도에 한정된다.