@morlay/session-rdb 0.0.16-alpha.2 → 0.0.16

package/dist/artifact.mjs

@@ -1,3 +1,3 @@
 import { a as repairAssistantSettlement, c as repairRequestHeaders, d as rowToMeta, f as scanRows, g as toJsonlArtifact, h as syncMeteringRanges, i as renameLegacyPtcEvents, l as repairSurfaceOps, m as sessionInsertRow, n as orphanInboxSpliceSeqs, o as repairOrphanInboxSplices, p as sessionConflictRow, r as recomputeReplaceProvenance, s as repairReadView, t as findSurfaceRepairs, u as rowToEvent } from "./log-BIuXv09P.mjs";
-import { a as persistImport, i as parseJsonlArtifact, n as SESSION_LOG_ARTIFACT_FILENAME, o as registerSessionImport, r as parseImportZip, t as SESSION_IMPORT_PATH } from "./import-eBSoCrxl.mjs";
+import { a as persistImport, i as parseJsonlArtifact, n as SESSION_LOG_ARTIFACT_FILENAME, o as registerSessionImport, r as parseImportZip, t as SESSION_IMPORT_PATH } from "./import-BPEHfHNk.mjs";
 export { SESSION_IMPORT_PATH, SESSION_LOG_ARTIFACT_FILENAME, findSurfaceRepairs, orphanInboxSpliceSeqs, parseImportZip, parseJsonlArtifact, persistImport, recomputeReplaceProvenance, registerSessionImport, renameLegacyPtcEvents, repairAssistantSettlement, repairOrphanInboxSplices, repairReadView, repairRequestHeaders, repairSurfaceOps, rowToEvent, rowToMeta, scanRows, sessionConflictRow, sessionInsertRow, syncMeteringRanges, toJsonlArtifact };

package/dist/{import-eBSoCrxl.mjs → import-BPEHfHNk.mjs}

@@ -142,7 +142,8 @@ var SessionBranchRdbProvider = class {
 		if (!Number.isSafeInteger(toBoundary) || toBoundary < -1) throw new SessionBranchError(`rewind boundary must be a non-negative safe integer, got ${toBoundary}`, "INVALID_BOUNDARY");
 		const live = this.live.getSession(id);
 		if (live !== void 0) await this.live.flush(live);
-		const raw = live === void 0 ? await this.readRawEvents(id, signal) : void 0;
+		const raw = live === void 0 ? await this.persistence.readLog(id, {}, signal) : void 0;
+		if (live === void 0 && raw === void 0) throw new SessionBranchError(`session "${id}" not found`, "SESSION_NOT_FOUND");
 		const inspection = live === void 0 ? void 0 : await this.persistence.internals().inspect(id, signal);
 		const events = live === void 0 ? raw.events : inspection.events;
 		const meta = live === void 0 ? raw.meta : inspection.meta;
@@ -150,7 +151,8 @@ var SessionBranchRdbProvider = class {
 		if (toBoundary === -1) {} else if (boundaryEvent === void 0) throw new SessionBranchError(`rewind boundary ${toBoundary} does not exist in session "${id}"`, "INVALID_BOUNDARY");
 		else if (boundaryEvent.type !== "turn/end" && boundaryEvent.type !== "user/message") throw new SessionBranchError(`rewind boundary ${toBoundary} is not a turn/end or user/message (${boundaryEvent.type})`, "INVALID_BOUNDARY");
 		const rawKeepLength = toBoundary === -1 ? 0 : boundaryEvent.type === "turn/end" ? toBoundary + 1 : toBoundary;
-		const keepLength = balanceRewindPrefix(events.slice(0, rawKeepLength)).length;
+		const kept = balanceRewindPrefix(events.slice(0, rawKeepLength));
+		const keepLength = kept.length;
 		const internals = this.persistence.internals();
 		const denseBoundary = keepLength - 1;
 		const newSeedLength = await internals.backend.transaction(async (tx) => {
@@ -175,6 +177,7 @@ var SessionBranchRdbProvider = class {
 		internals.writeGuard.confirmHead(id, denseBoundary);
 		if (live !== void 0) {
 			truncateLiveSession(live, keepLength);
+			this.live.resetProjections?.(live);
 			const agent = this.live.getAgent(id);
 			if (agent !== void 0) {
 				agent.requestHeaderLogged = false;
@@ -184,7 +187,15 @@ var SessionBranchRdbProvider = class {
 			}
 			const handle = this.persistence.tracker.writerOf(id);
 			if (handle !== void 0) handle.resetAfterRewind(keepLength, newSeedLength === null ? void 0 : newSeedLength);
-		}
+			agent?.inbox?.clear();
+			await this.live.flush(live);
+			await this.refreshProjectionCache(live);
+		} else await this.refreshProjectionCache({
+			id,
+			header: meta,
+			inheritedEventCount: SessionLogOffset(raw.inheritedEventCount),
+			snapshotEvents: () => kept
+		});
 		const row = await internals.backend.getSession(id);
 		if (row === void 0) return {
 			header: {
@@ -205,6 +216,16 @@ var SessionBranchRdbProvider = class {
 			revision: await internals.readStoredRevision(id)
 		};
 	}
+	/**
+	* 让持久化投影检查点跟随截断后的 log（见 {@link LiveSessionHooks.refreshProjectionCache}）。
+	* 缓存是派生数据：刷新失败只让缓存多滞后一轮，不能让 rewind 失败。
+	*/
+	async refreshProjectionCache(session) {
+		if (this.live.refreshProjectionCache === void 0) return;
+		try {
+			await this.live.refreshProjectionCache(session);
+		} catch {}
+	}
 };
 var SessionBranchRdb = class extends SessionBranch {
 	static inject = ["sessionPersistence", "sessions"];
@@ -216,7 +237,21 @@ var SessionBranchRdb = class extends SessionBranch {
 		getAgent: (id) => {
 			return this.ctx.get("agents")?.get(id);
 		},
-		flush: (session) => this.ctx.sessions.flush(session)
+		flush: (session) => this.ctx.sessions.flush(session),
+		resetProjections: (session) => {
+			const registry = this.ctx.get("sessionProjections");
+			if (registry?.registrations === void 0) return;
+			for (const registration of registry.registrations.values()) registration.cells.delete(session);
+		},
+		refreshProjectionCache: async (session) => {
+			const cache = this.ctx.get("sessionProjectionCache");
+			if (cache === void 0) return;
+			try {
+				await cache.write(session);
+			} catch (error) {
+				this.ctx.logger.warn(`session-rdb: projection cache refresh after rewind for "${session.id}" failed (cache stays stale): ${String(error)}`);
+			}
+		}
 	});
 	readBranchPrefix(id, atSeq, mode, signal) {
 		return this.provider.readBranchPrefix(id, atSeq, mode, signal);

package/dist/import.d.mts

@@ -1,4 +1,4 @@
-import { n as SessionPersistenceRdb } from "./index-DfS0PzGM.mjs";
+import { n as SessionPersistenceRdb } from "./index-CgAqCQAb.mjs";
 import { SessionStorageMetadata } from "@deepseek-ai/dsh-session-persistence";
 import { Session, SessionEvent, SessionId } from "@deepseek-ai/dsh-session";
 import { Context } from "@deepseek-ai/cordis";

package/dist/import.mjs

@@ -1,2 +1,2 @@
-import { a as persistImport, i as parseJsonlArtifact, n as SESSION_LOG_ARTIFACT_FILENAME, o as registerSessionImport, r as parseImportZip, t as SESSION_IMPORT_PATH } from "./import-eBSoCrxl.mjs";
+import { a as persistImport, i as parseJsonlArtifact, n as SESSION_LOG_ARTIFACT_FILENAME, o as registerSessionImport, r as parseImportZip, t as SESSION_IMPORT_PATH } from "./import-BPEHfHNk.mjs";
 export { SESSION_IMPORT_PATH, SESSION_LOG_ARTIFACT_FILENAME, parseImportZip, parseJsonlArtifact, persistImport, registerSessionImport };

package/dist/{index-DfS0PzGM.d.mts → index-CgAqCQAb.d.mts}

@@ -10,10 +10,27 @@ interface LiveSessionHooks {
   getSession(id: SessionId): Session | undefined;
   getAgent(id: SessionId): LiveAgentLike | undefined;
   flush(session: Session): Promise<boolean>;
+  resetProjections?(session: Session): void;
+  refreshProjectionCache?(session: ProjectionCacheSession): Promise<void>;
+}
+/**
+ * 投影检查点刷新所需的最小会话面：cold rewind 没有 live Session 可复用，
+ * 而截断后的前缀未必是合法的独立会话（surface 引用可能悬空），不能走
+ * `Session.create` 的校验；缓存服务只读 id / header / inheritedEventCount
+ * 与事件前缀，用普通对象承载即可。
+ */
+interface ProjectionCacheSession {
+  readonly id: SessionId;
+  readonly header: SessionHeader;
+  readonly inheritedEventCount: SessionLogOffset;
+  snapshotEvents(): readonly SessionEvent[];
 }
 interface LiveAgentLike {
   session: Session;
   requestHeaderLogged?: boolean;
+  inbox?: {
+    clear(): void;
+  };
 }
 declare class SessionBranchRdbProvider implements SessionBranchProvider {
   private readonly persistence;
@@ -27,6 +44,11 @@ declare class SessionBranchRdbProvider implements SessionBranchProvider {
   }>;
   forkFrom(sourceId: SessionId, options?: ForkFromOptions, signal?: AbortSignal): Promise<SessionId>;
   rewind(id: SessionId, toBoundary: number, signal?: AbortSignal): Promise<SessionPersistenceSnapshot>;
+  /**
+   * 让持久化投影检查点跟随截断后的 log（见 {@link LiveSessionHooks.refreshProjectionCache}）。
+   * 缓存是派生数据：刷新失败只让缓存多滞后一轮，不能让 rewind 失败。
+   */
+  private refreshProjectionCache;
 }
 declare class SessionBranchRdb extends SessionBranch {
   static inject: string[];

package/dist/index.d.mts

@@ -1,3 +1,3 @@
 import { o as SCHEMA_VERSION } from "./schema-COK7-wRV.mjs";
-import { a as SessionBranchRdbProvider, i as SessionBranchRdb, n as SessionPersistenceRdb, o as locateTurnEnd, r as SessionPersistenceRdbInternals, t as Config } from "./index-DfS0PzGM.mjs";
+import { a as SessionBranchRdbProvider, i as SessionBranchRdb, n as SessionPersistenceRdb, o as locateTurnEnd, r as SessionPersistenceRdbInternals, t as Config } from "./index-CgAqCQAb.mjs";
 export { Config, SCHEMA_VERSION, SessionBranchRdb, SessionBranchRdbProvider, SessionPersistenceRdb, SessionPersistenceRdb as default, SessionPersistenceRdbInternals, locateTurnEnd };

package/dist/index.mjs

@@ -1,6 +1,6 @@
-import { a as SCHEMA_VERSION, g as WriteGuard, h as toPostgresSchema, i as EVENT_ENCODING, m as postgresTableDefs, r as DEFAULT_BUSY_TIMEOUT_MS, s as eventDimensions, t as SqliteBackend } from "./sqlite-Dpd17YhI.mjs";
+import { a as SCHEMA_VERSION, g as WriteGuard, h as toPostgresSchema, i as EVENT_ENCODING, m as postgresTableDefs, r as DEFAULT_BUSY_TIMEOUT_MS, s as eventDimensions, t as SqliteBackend } from "./sqlite-IH5I48aL.mjs";
 import { c as repairRequestHeaders, d as rowToMeta, f as scanRows, g as toJsonlArtifact, m as sessionInsertRow, p as sessionConflictRow, s as repairReadView } from "./log-BIuXv09P.mjs";
-import { c as SessionBranchRdbProvider, l as locateTurnEnd, o as registerSessionImport, s as SessionBranchRdb } from "./import-eBSoCrxl.mjs";
+import { c as SessionBranchRdbProvider, l as locateTurnEnd, o as registerSessionImport, s as SessionBranchRdb } from "./import-BPEHfHNk.mjs";
 import z from "@deepseek-ai/schemastery";
 import { randomUUID } from "node:crypto";
 import { Pool } from "pg";
@@ -10,10 +10,11 @@ import { SESSION_FORMAT_VERSION, SessionLogOffset } from "@deepseek-ai/dsh-sessi
 import { sessionFormatCatalog } from "@deepseek-ai/dsh-session-format-catalog";
 import { and, eq, gte, sql } from "drizzle-orm";
 import { readdirSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 import { migrate } from "drizzle-orm/node-postgres/migrator";
 //#region src/postgres.ts
 /** drizzle-kit 生成的迁移目录（随包根 drizzle/ 发布；src/dist 形态经相对 URL 统一解析）。 */
-const postgresMigrationsDir = new URL("../drizzle/postgres/", import.meta.url).pathname;
+const postgresMigrationsDir = fileURLToPath(new URL("../drizzle/postgres/", import.meta.url));
 var PostgresBackend = class PostgresBackend {
 	db;
 	options;

package/dist/{sqlite-Dpd17YhI.mjs → sqlite-IH5I48aL.mjs}

@@ -6,6 +6,7 @@ import { bigint, check as check$1, index as index$1, integer as integer$1, pgSch
 import { readdirSync, statSync } from "node:fs";
 import { mkdir, open } from "node:fs/promises";
 import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { DatabaseSync } from "node:sqlite";
 import { drizzle } from "drizzle-orm/node-sqlite";
 import { migrate } from "drizzle-orm/node-sqlite/migrator";
@@ -482,7 +483,7 @@ function eventDimensions(event) {
 //#endregion
 //#region src/sqlite.ts
 /** drizzle-kit 生成的迁移目录（随包根 drizzle/ 发布；src/dist 形态经相对 URL 统一解析）。 */
-const sqliteMigrationsDir = new URL("../drizzle/sqlite/", import.meta.url).pathname;
+const sqliteMigrationsDir = fileURLToPath(new URL("../drizzle/sqlite/", import.meta.url));
 const sqliteTxQueues = /* @__PURE__ */ new Map();
 function enqueueSqliteTx(path, fn) {
 	const run = (sqliteTxQueues.get(path) ?? Promise.resolve()).then(fn);

package/dist/storage.mjs

@@ -1,2 +1,2 @@
-import { a as SCHEMA_VERSION, c as eventKind, d as tSchemaMeta, f as tSessionEvents, g as WriteGuard, i as EVENT_ENCODING, l as tEvents, n as openDatabase, o as SESSION_PERSISTENCE_SQLITE_APPLICATION_ID, p as tSessions, r as DEFAULT_BUSY_TIMEOUT_MS, s as eventDimensions, t as SqliteBackend, u as tPersistenceState } from "./sqlite-Dpd17YhI.mjs";
+import { a as SCHEMA_VERSION, c as eventKind, d as tSchemaMeta, f as tSessionEvents, g as WriteGuard, i as EVENT_ENCODING, l as tEvents, n as openDatabase, o as SESSION_PERSISTENCE_SQLITE_APPLICATION_ID, p as tSessions, r as DEFAULT_BUSY_TIMEOUT_MS, s as eventDimensions, t as SqliteBackend, u as tPersistenceState } from "./sqlite-IH5I48aL.mjs";
 export { DEFAULT_BUSY_TIMEOUT_MS, EVENT_ENCODING, SCHEMA_VERSION, SESSION_PERSISTENCE_SQLITE_APPLICATION_ID, SqliteBackend, WriteGuard, eventDimensions, eventKind, openDatabase, tEvents, tPersistenceState, tSchemaMeta, tSessionEvents, tSessions };

package/dist/testing.mjs

@@ -5116,7 +5116,7 @@ function manageArtifactAttachment(attachment) {
 	if (attachment.body != null) attachment.bodyEncoding ??= "base64";
 }
 //#endregion
-//#region ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@26.5.0_happy-dom@20.14.0_vite@8.2.2__b2fde82745a4512744fb5cfb49e8ecf4/node_modules/vitest/dist/chunks/utils.BX5Fg8C4.js
+//#region ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@26.5.1_happy-dom@20.14.3_vite@8.2.2__e05875f349154650201ff2ddb1226938/node_modules/vitest/dist/chunks/utils.BX5Fg8C4.js
 const NAME_WORKER_STATE = "__vitest_worker__";
 function getWorkerState() {
 	const workerState = globalThis[NAME_WORKER_STATE];
@@ -10019,10 +10019,10 @@ function offsetToLineNumber(source, offset) {
 	return line + 1;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@26.5.0_happy-dom@20.14.0_vite@8.2.2__b2fde82745a4512744fb5cfb49e8ecf4/node_modules/vitest/dist/chunks/_commonjsHelpers.D26ty3Ew.js
+//#region ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@26.5.1_happy-dom@20.14.3_vite@8.2.2__e05875f349154650201ff2ddb1226938/node_modules/vitest/dist/chunks/_commonjsHelpers.D26ty3Ew.js
 var commonjsGlobal = typeof globalThis !== "undefined" ? globalThis : typeof window !== "undefined" ? window : typeof global !== "undefined" ? global : typeof self !== "undefined" ? self : {};
 //#endregion
-//#region ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@26.5.0_happy-dom@20.14.0_vite@8.2.2__b2fde82745a4512744fb5cfb49e8ecf4/node_modules/vitest/dist/chunks/rpc.MzXet3jl.js
+//#region ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@26.5.1_happy-dom@20.14.3_vite@8.2.2__e05875f349154650201ff2ddb1226938/node_modules/vitest/dist/chunks/rpc.MzXet3jl.js
 const RealDate = Date;
 let now = null;
 var MockDate = class MockDate extends RealDate {
@@ -10987,7 +10987,7 @@ function raceWith(promise, other) {
 	}))]);
 }
 //#endregion
-//#region ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@26.5.0_happy-dom@20.14.0_vite@8.2.2__b2fde82745a4512744fb5cfb49e8ecf4/node_modules/vitest/dist/chunks/test.DNmyFkvJ.js
+//#region ../../node_modules/.pnpm/vitest@4.1.11_@opentelemetry+api@1.9.1_@types+node@26.5.1_happy-dom@20.14.3_vite@8.2.2__e05875f349154650201ff2ddb1226938/node_modules/vitest/dist/chunks/test.DNmyFkvJ.js
 var fakeTimersSrc = {};
 var global$1;
 var hasRequiredGlobal;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morlay/session-rdb",
-  "version": "0.0.16-alpha.2",
+  "version": "0.0.16",
   "description": "RDB durable session backend for DeepSeek Harness: implements both session-persistence and session-branch (rewind / retry / fork) providers.",
   "keywords": [
     "branch",
@@ -35,27 +35,32 @@
     "./cordis.patch.yml": "./cordis.patch.yml"
   },
   "dependencies": {
-    "@morlay/session-branch": "^0.0.4-alpha.2",
+    "@morlay/session-branch": "^0.0.4",
     "drizzle-orm": "^1.0.0-rc.5-ab785fc",
     "fflate": "^0.8.2",
     "pg": "^8.23.0"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-session-projection": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-token-meter": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session-projection": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-projection-cache": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-turn-outline": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-storage": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-storage-domain": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-storage-json": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-token-meter": "^0.1.5-rc.1",
     "@types/pg": "^8.23.1",
     "drizzle-kit": "1.0.0-rc.5-ab785fc"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-scope": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-format": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-format-catalog": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.5-alpha.1",
-    "@deepseek-ai/dsh-settings": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-invariants": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-scope": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-format": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-format-catalog": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.5-rc.1",
+    "@deepseek-ai/dsh-settings": "^0.1.5-rc.1",
     "@deepseek-ai/schemastery": "^3.18.2"
   },
   "dsh": {

package/src/branch.ts

@@ -66,12 +66,45 @@ export interface LiveSessionHooks {
   getAgent(id: SessionId): LiveAgentLike | undefined;
 
   flush(session: Session): Promise<boolean>;
+
+  // 丢弃 live 会话已缓存的投影单元：rewind 直接截断内存 log，投影 registry
+  // 的 observedSeq 仍停在截断前，后续 append 的事件（seq 更小）会被 drive()
+  // 跳过，重放输入永远进不了 inbox 投影。可选：纯持久化环境没有投影服务。
+  resetProjections?(session: Session): void;
+
+  // 用截断后的 log 重写该会话的持久化投影检查点：rewind 不会产生事件，
+  // 缓存行的水位（以及基于它折出的值）仍停在截断前。超前行不会被前端投影
+  // store 的 higher-seq-wins 规则覆盖（rewind 后的正确值 seq 更小），表现为
+  // 轮次导航残留被删除的旧轮次。可选：纯持久化环境没有投影缓存服务。
+  refreshProjectionCache?(session: ProjectionCacheSession): Promise<void>;
+}
+
+/**
+ * 投影检查点刷新所需的最小会话面：cold rewind 没有 live Session 可复用，
+ * 而截断后的前缀未必是合法的独立会话（surface 引用可能悬空），不能走
+ * `Session.create` 的校验；缓存服务只读 id / header / inheritedEventCount
+ * 与事件前缀，用普通对象承载即可。
+ */
+export interface ProjectionCacheSession {
+  readonly id: SessionId;
+  readonly header: SessionHeader;
+  readonly inheritedEventCount: SessionLogOffset;
+  snapshotEvents(): readonly SessionEvent[];
+}
+
+// 投影 registry 的失效面（上游私有结构，duck-type 读取）。
+interface ProjectionRegistryLike {
+  registrations?: Map<string, { cells: WeakMap<object, unknown> }>;
 }
 
 export interface LiveAgentLike {
   session: Session;
 
   requestHeaderLogged?: boolean;
+
+  // 上游 Agent 的 inbox 契约面（ReactLoopInbox.clear）：rewind 后残留的排队
+  // 输入必须 durable 取消，否则 agent 会继续处理它们。可选：测试替身可能没有。
+  inbox?: { clear(): void };
 }
 
 export function truncateLiveSession(session: Session, newLength: number): void {
@@ -246,8 +279,12 @@ export class SessionBranchRdbProvider implements SessionBranchProvider {
     if (live !== undefined) await this.live.flush(live);
     // 边界校验用原始事件（readLog，不补 closers）——inspect 会给未闭合
     // log 补合成 closers，把 user/message 边界掩盖成 turn/end，丢失 exclusive
-    // 语义。
-    const raw = live === undefined ? await this.readRawEvents(id, signal) : undefined;
+    // 语义。cold 分支同时取回 inheritedEventCount：刷新投影检查点时要用它
+    // 重建与存储一致的会话身份。
+    const raw = live === undefined ? await this.persistence.readLog(id, {}, signal) : undefined;
+    if (live === undefined && raw === undefined) {
+      throw new SessionBranchError(`session "${id}" not found`, "SESSION_NOT_FOUND");
+    }
     const inspection =
       live === undefined ? undefined : await this.persistence.internals().inspect(id, signal);
     const events = live === undefined ? raw!.events : inspection!.events;
@@ -270,7 +307,8 @@ export class SessionBranchRdbProvider implements SessionBranchProvider {
     // 编辑版替换）。exclusive 截断可能残留孤儿 step/start，经平衡化剔除。
     const rawKeepLength =
       toBoundary === -1 ? 0 : boundaryEvent!.type === "turn/end" ? toBoundary + 1 : toBoundary;
-    const keepLength = balanceRewindPrefix(events.slice(0, rawKeepLength)).length;
+    const kept = balanceRewindPrefix(events.slice(0, rawKeepLength));
+    const keepLength = kept.length;
 
     const internals = this.persistence.internals();
     // 原样存储（无过滤）：live 视图与 RDB head 同空间（上游 seq），
@@ -314,6 +352,9 @@ export class SessionBranchRdbProvider implements SessionBranchProvider {
       // agent 轮次游标。不调用 load——live 时 load 会先 flush 把旧内存写回，
       // 撤销本次截断。
       truncateLiveSession(live, keepLength);
+      // 投影缓存同样停在截断前的水位，必须先失效，否则截断后的重放事件
+      // （seq 回退）不会进入投影。
+      this.live.resetProjections?.(live);
       const agent = this.live.getAgent(id);
       if (agent !== undefined) {
         agent.requestHeaderLogged = false;
@@ -330,6 +371,24 @@ export class SessionBranchRdbProvider implements SessionBranchProvider {
       if (handle !== undefined) {
         handle.resetAfterRewind(keepLength, newSeedLength === null ? undefined : newSeedLength);
       }
+      // 截断后强制清空排队输入：保留区里未被截断的 pending（`agent/inbox/spliced`）
+      // 仍会被 agent 处理，必须 durable 取消。cursor 已对齐，取消事件从截断点续接。
+      agent?.inbox?.clear();
+      // 取消事件先经 coordinator 缓冲，落盘后 rewind 才真正 durable（调用方
+      // 可能在 rewind 返回后直接读后端）。
+      await this.live.flush(live);
+      // 持久化投影检查点也要退到截断后的水位：rewind 不产生事件，缓存行
+      // 会停在截断前；超前行锁死前端（higher-seq-wins），轮次导航残留旧轮次。
+      await this.refreshProjectionCache(live);
+    } else {
+      // cold：用截断后的前缀 + 存储身份构造最小会话面，让缓存服务按截断后
+      // 的 log 重写检查点（没有 live 会话可复用，也不为此 resume 一个 agent）。
+      await this.refreshProjectionCache({
+        id,
+        header: meta,
+        inheritedEventCount: SessionLogOffset(raw!.inheritedEventCount),
+        snapshotEvents: () => kept,
+      });
     }
 
     const row = await internals.backend.getSession(id);
@@ -354,6 +413,19 @@ export class SessionBranchRdbProvider implements SessionBranchProvider {
     }
     return { header: rowToMeta(row), revision: (await internals.readStoredRevision(id))! };
   }
+
+  /**
+   * 让持久化投影检查点跟随截断后的 log（见 {@link LiveSessionHooks.refreshProjectionCache}）。
+   * 缓存是派生数据：刷新失败只让缓存多滞后一轮，不能让 rewind 失败。
+   */
+  private async refreshProjectionCache(session: ProjectionCacheSession): Promise<void> {
+    if (this.live.refreshProjectionCache === undefined) return;
+    try {
+      await this.live.refreshProjectionCache(session);
+    } catch {
+      // 实现方（SessionBranchRdb）已记日志；此处只保证 rewind 不因派生数据失败。
+    }
+  }
 }
 
 export class SessionBranchRdb extends SessionBranch {
@@ -375,6 +447,30 @@ export class SessionBranchRdb extends SessionBranch {
         return agents?.get(id);
       },
       flush: (session) => this.ctx.sessions.flush(session),
+      resetProjections: (session) => {
+        // sessionProjections 是可选服务（纯持久化环境无 agent-loop/投影）。
+        const registry = (this.ctx as unknown as { get(name: string): unknown }).get(
+          "sessionProjections",
+        ) as ProjectionRegistryLike | undefined;
+        if (registry?.registrations === undefined) return;
+        for (const registration of registry.registrations.values()) {
+          registration.cells.delete(session);
+        }
+      },
+      refreshProjectionCache: async (session) => {
+        // sessionProjectionCache 是可选服务（纯持久化环境无投影缓存）。
+        const cache = this.ctx.get("sessionProjectionCache") as
+          | { write(session: ProjectionCacheSession): Promise<void> }
+          | undefined;
+        if (cache === undefined) return;
+        try {
+          await cache.write(session);
+        } catch (error: unknown) {
+          this.ctx.logger.warn(
+            `session-rdb: projection cache refresh after rewind for "${session.id}" failed (cache stays stale): ${String(error)}`,
+          );
+        }
+      },
     },
   );
 

package/src/postgres.ts

@@ -1,5 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { readdirSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 import { and, eq, gte, sql } from "drizzle-orm";
 import type { PgAsyncDatabase, PgAsyncTransaction } from "drizzle-orm/pg-core";
 import type { NodePgDatabase, NodePgQueryResultHKT } from "drizzle-orm/node-postgres";
@@ -18,7 +19,7 @@ import { postgresTableDefs } from "./entities/index.ts";
 import { sessionConflictRow, sessionInsertRow } from "./log.ts";
 
 /** drizzle-kit 生成的迁移目录（随包根 drizzle/ 发布；src/dist 形态经相对 URL 统一解析）。 */
-const postgresMigrationsDir = new URL("../drizzle/postgres/", import.meta.url).pathname;
+const postgresMigrationsDir = fileURLToPath(new URL("../drizzle/postgres/", import.meta.url));
 
 export interface PostgresBackendOptions {
   identityBase: string;

package/src/sqlite.ts

@@ -2,6 +2,7 @@ import { randomUUID } from "node:crypto";
 import { readdirSync, statSync } from "node:fs";
 import { mkdir, open } from "node:fs/promises";
 import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { DatabaseSync } from "node:sqlite";
 import { and, eq, gte, sql } from "drizzle-orm";
 import { drizzle, type NodeSQLiteDatabase } from "drizzle-orm/node-sqlite";
@@ -30,7 +31,7 @@ import {
 type SqliteDb = NodeSQLiteDatabase & { $client: DatabaseSync };
 
 /** drizzle-kit 生成的迁移目录（随包根 drizzle/ 发布；src/dist 形态经相对 URL 统一解析）。 */
-const sqliteMigrationsDir = new URL("../drizzle/sqlite/", import.meta.url).pathname;
+const sqliteMigrationsDir = fileURLToPath(new URL("../drizzle/sqlite/", import.meta.url));
 
 const sqliteTxQueues = new Map<string, Promise<void>>();