docs: record the barrel boundary and IndexedDB kernel designs with a plan

모듈별 구조 리뷰에서 나온 두 설계를 spec으로 남기고, 그중 배럴 경계
작업의 실행 계획을 쓴다. 배럴 규칙은 실제 import 그래프에 돌려 위반
15건이 치환 대상 15줄과 일치함을 확인했고, 재수출할 심볼 82개는 실제
export와 대조했다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

src/adapters/auth/index.ts

@@ -0,0 +1,9 @@
+export {
+  createAnonymousSessionAdapter,
+  createDemoSessionAdapter,
+  createExternalAuthSessionAdapter,
+  createUnavailableSessionAdapter,
+  DEMO_AUTHORIZATION_MARKER,
+  type DemoSessionAdapter,
+  type ExternalSessionOwner,
+} from "./external-session-adapter.ts";

src/adapters/diagnostics/index.ts

@@ -0,0 +1,7 @@
+export {
+  createDiagnosticsAdapter,
+  getLastBootEvidence,
+  MAX_DIAGNOSTIC_ENTRIES,
+  noOpDiagnostics,
+  recordBootFailure,
+} from "./bounded-diagnostics.ts";

src/adapters/http/index.ts

@@ -0,0 +1,39 @@
+/**
+ * §7–§8. 권장 경로는 V3 계약 실행기(`createContractHttpExecutor`)다. 설치된
+ * 계약과 타입 입력을 받아 상한·전체 데드라인·재시도 권한·효과 확실성 판정을
+ * 런타임이 소유한다.
+ */
+export {
+  createContractHttpExecutor,
+  type AuthIntegrationFailureReason,
+  type AuthOperationContext,
+  type CancellationOwner,
+  type ContractHttpExecutor,
+  type ContractHttpExecutorDependencies,
+  type HttpContractViolation,
+  type HttpContractViolationKind,
+  type HttpEffectCertainty,
+  type HttpExecutionContext,
+  type HttpExecutionObservation,
+  type HttpExecutionOutcome,
+  type HttpTransportFailure,
+  type SafeResponseMetadata,
+} from "./http-execution-v3.ts";
+/** V3 `attachCredentials` 콜백이 반환해야 하는 결과 타입. */
+export type { CredentialPatchOutcome } from "./http-contract-bridge.ts";
+/**
+ * V2 legacy. operationId + `LegacyHttpInput`으로 호출하는 범용 클라이언트다.
+ * 새 코드는 위의 V3 실행기를 쓴다. 남아 있는 이유는 계약이 아직 없는
+ * 오퍼레이션을 위한 이행 경로이기 때문이다.
+ */
+export {
+  createHttpClient,
+  type HttpClient,
+  type HttpClientDependencies,
+  type HttpFailure,
+  type HttpResult,
+  type LegacyHttpInput,
+  type Scheduler,
+} from "./client.ts";
+/** V2 `HttpClient.execute`의 첫 인자 타입. */
+export type { OperationRequestInput } from "./request-builder.ts";

src/adapters/platform/index.ts

@@ -0,0 +1,31 @@
+/**
+ * 어댑터 커널의 공개 경계.
+ *
+ * `src/adapters/**` 안에서는 이 배럴을 쓰지 않는다. 커널 프리미티브는 파일
+ * 경로로 직접 import한다 — `scripts/check-adapter-inventory.ts:63-83`이
+ * `platform/abortable-operation.ts`로 해석되는 specifier를 네 소비자에게
+ * 요구하고, `.dependency-cruiser.json`의 kernel carve-out도 폴더 단위다.
+ * 이 배럴은 bootstrap·features·tests 같은 그룹 바깥 소비자를 위한 문이다.
+ */
+export {
+  compensateLateHandle,
+  createAbortableOperation,
+  snapshotAbortTimers,
+  type AbortableOperation,
+  type AbortableOperationInput,
+  type AbortRace,
+  type AbortTerminalReason,
+  type AbortTimerSnapshot,
+} from "./abortable-operation.ts";
+export { assertBoundedCapacity } from "./bounded-capacity.ts";
+export {
+  createBrowserLifecycleRuntime,
+  type BrowserLifecycleEvent,
+  type BrowserLifecycleRuntime,
+  type BrowserLifecycleSnapshot,
+} from "./browser-lifecycle.ts";
+export {
+  createBrowserMutationIntentFactory,
+  type BrowserMutationIntentFactoryDependencies,
+} from "./browser-mutation-intent-factory.ts";
+export { systemClock } from "./system-clock.ts";

src/adapters/query-cache/index.ts

@@ -0,0 +1,21 @@
+export {
+  createConditionalValidatorStore,
+  type ConditionalValidatorBinding,
+  type ConditionalValidatorStore,
+} from "./conditional-validator-store.ts";
+export { createCursorPaginationRuntime } from "./cursor-pagination-runtime.ts";
+export {
+  createServerStateScopeRuntime,
+  type ScopeResetParticipant,
+  type ServerStateScopeDependencies,
+} from "./server-state-scope-runtime.ts";
+export {
+  createTanStackCacheCoordinator,
+  type TanStackCacheCoordinatorDependencies,
+} from "./tanstack-cache-coordinator.ts";
+export {
+  createQueryCacheAdapter,
+  createQueryClient,
+  QUERY_CACHE_DEFAULTS,
+  type QueryCacheDependencies,
+} from "./tanstack-query-cache.ts";

src/adapters/service-worker/index.ts

@@ -0,0 +1,31 @@
+/**
+ * 이 배럴은 그룹 바깥(bootstrap, tests)을 위한 문이다. 워커 realm 진입점
+ * `service-worker-entry.ts`는 이 배럴을 쓰지 않고 파일을 직접 import한다.
+ *
+ * 그래서 `tsconfig.service-worker.json`의 `exclude`에 이 파일이 들어 있다.
+ * 그 설정은 `src/adapters/service-worker` 폴더를 통째로 WebWorker lib로
+ * 컴파일하면서 페이지 realm 파일(`service-worker-page-controller.ts`,
+ * `service-worker-removal.ts`)만 빼는 구조다. 배럴이 제외되지 않으면 그
+ * 페이지 realm 파일을 다시 끌어들여 `document`를 찾지 못한다.
+ * 타입 커버리지는 `tsconfig.app.json`이 이 배럴을 포함하므로 유지된다.
+ *
+ * `service-worker-entry.ts`도 여기서 참조하지 않는다. `tsconfig.app.json:18`이
+ * 제외한 파일이고, export가 0개이므로 넣을 것도 없다.
+ */
+export {
+  createServiceWorkerRuntime,
+  type WorkerClientLike,
+  type WorkerRuntimeConfig,
+  type WorkerScopeLike,
+} from "./service-worker-lifecycle.ts";
+export {
+  createServiceWorkerPageController,
+  type ActivationBlocker,
+  type PageControllerDependencies,
+} from "./service-worker-page-controller.ts";
+export {
+  createNonceRegistry,
+  createServiceWorkerMessage,
+  parseServiceWorkerMessage,
+  type ParsedMessage,
+} from "./service-worker-protocol.ts";

src/adapters/storage/index.ts

@@ -0,0 +1,12 @@
+/**
+ * 최상위 storage 배럴은 Web Storage 어댑터만 내보낸다.
+ *
+ * `./indexeddb/index.ts`와 `./opfs/index.ts`를 여기서 재수출하지 말 것.
+ * `scripts/test-browser-file-storage-runtime-removal.ts:23-34`가 그 두 폴더만
+ * 삭제한 뒤 잔존 import를 예외로 잡는다 — 재수출하면 제거 드릴이 죽는다.
+ * 두 서브배럴이 각자 제거 가능한 런타임의 경계다.
+ */
+export {
+  createBrowserStorageAdapter,
+  type BrowserStorageDependencies,
+} from "./browser-storage-adapter.ts";

src/adapters/telemetry/index.ts

@@ -0,0 +1,7 @@
+export {
+  createTelemetryAdapter,
+  MAX_TELEMETRY_QUEUE,
+  noOpTelemetry,
+  type TelemetryAdapter,
+  type TelemetryAdapterOptions,
+} from "./best-effort-telemetry.ts";