From d9ca6537d8687e29de4e577a78114851b75f788b Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Wed, 4 Nov 2026 21:02:15 +0900 Subject: [PATCH] =?UTF-8?q?docs(architecture):=20=EC=BA=90=EC=8B=9C=20?= =?UTF-8?q?=EB=AC=B8=EC=84=9C=EC=9D=98=20=EB=B0=80=EB=A6=B0=20=EC=A4=84=20?= =?UTF-8?q?=EB=B2=88=ED=98=B8=20=EC=B0=B8=EC=A1=B0=EB=A5=BC=20=EC=8B=AC?= =?UTF-8?q?=EB=B3=BC=20=EC=9D=B4=EB=A6=84=EC=9C=BC=EB=A1=9C=20=EB=B0=94?= =?UTF-8?q?=EA=BE=BC=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: 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 --- docs/architecture/client-cache-and-storage.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) 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 처리하는 용도에 한정된다.