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

package/dist/artifact.d.mts

@@ -45,8 +45,51 @@ declare function findSurfaceRepairs(events: readonly SessionEvent[]): {
   degradeToAppend: Set<number>;
   addAppendMarker: Set<number>;
   clearSurfaceOp: Set<number>;
+  clampEnd: Map<number, number>;
 };
 declare function repairSurfaceOps(events: SessionEvent[]): void;
+/**
+ * 读取时补全 assistant 结算字段：旧写入器不落库 `stream`（v2 才把流式记录
+ * 嵌入消息），读回时缺失即补空数组——上游 seed 校验要求 turn/step/stream
+ * 三者齐备，缺失会让整个会话加载失败。
+ */
+declare function repairAssistantSettlement(events: SessionEvent[]): void;
+/**
+ * 读取时把旧格式 `request/header` 归一为当前格式：v3 起 system prompt 由
+ * surface 上的 `system/message` 承载，header 必须省略 `system`，空 `tools` /
+ * `adapterDefaults` 也必须省略（上游 v3 事件校验 fail loud）。混合世代回退
+ * 视图直接采用存储行，不归一会让整个会话加载失败。system prompt 因此不再
+ * 进入模型请求；会话下次运行由 v3 的 system/message 机制重建。
+ */
+declare function repairRequestHeaders(events: SessionEvent[]): void;
+/**
+ * 把紧邻 replace 的 metering 事件的 `shadowedRange` / `shadowedSeqs` 对齐到
+ * replace 最终的稠密 range。
+ *
+ * 旧写入器重编号事件后，metering 与 replace 一起落在旧坐标空间：二者数值
+ * 相等但与当前 surface 无关。夹取（或 range 本身已落在稠密空间而 metering
+ * 仍是旧值）后二者不再相等，而上游 token-meter 契约要求紧邻的 metering
+ * range 与 replace range 完全一致（否则报 no adjacent shadow price）。range
+ * 已一致时不改写——当前写入器保证一致，shadowedSeqs 的额外并发节点因此
+ * 原样保留。
+ */
+declare function syncMeteringRanges(events: SessionEvent[]): void;
+/**
+ * 读取时把 v2 时代的 PTC 词汇归一为当前词汇。
+ *
+ * 上游 v2→v3 迁移把 `tool/code-dispatch(-start)` 改名为
+ * `tool/ptc-dispatch(-start)`、把 `tools-code-mode` 插件来源改名为 `tools-ptc`、
+ * 把 agent preset 值 `code` 改名为 `ptc`。混合世代回退视图直接采用存储行，
+ * 不重命名会被上游 v3 校验以「unknown event type」拒绝整个会话。词汇改写
+ * 与上游迁移链的 renamePtcEvent 对齐。
+ */
+declare function renameLegacyPtcEvents(events: SessionEvent[]): void;
+/**
+ * 读取视图修复总入口：形状补全（结算字段 / request header）→ PTC 词汇归一
+ * → surface 语义修复 → metering 对齐 → provenance 重算 → 孤儿 inbox splice
+ * 改写。全部只作用于内存视图，不落库。
+ */
+declare function repairReadView(events: SessionEvent[]): void;
 /**
  * 定位无法从空状态增量重放的 agent/inbox/spliced 事件（孤儿操作）。
  *
@@ -64,4 +107,4 @@ declare function scanRows(rows: readonly EventRow[], base?: number): {
 };
 declare function toJsonlArtifact(meta: SessionHeader, inheritedEventCount: number, events: readonly SessionEvent[]): string;
 //#endregion
-export { SESSION_IMPORT_PATH, SESSION_LOG_ARTIFACT_FILENAME, findSurfaceRepairs, orphanInboxSpliceSeqs, parseImportZip, parseJsonlArtifact, persistImport, recomputeReplaceProvenance, registerSessionImport, repairOrphanInboxSplices, repairSurfaceOps, rowToEvent, rowToMeta, scanRows, sessionConflictRow, sessionInsertRow, toJsonlArtifact };
+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/artifact.mjs

@@ -1,3 +1,3 @@
-import { a as repairSurfaceOps, c as scanRows, d as toJsonlArtifact, i as repairOrphanInboxSplices, l as sessionConflictRow, n as orphanInboxSpliceSeqs, o as rowToEvent, r as recomputeReplaceProvenance, s as rowToMeta, t as findSurfaceRepairs, u as sessionInsertRow } from "./log-DTJsxMud.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-CKrzjXVB.mjs";
-export { SESSION_IMPORT_PATH, SESSION_LOG_ARTIFACT_FILENAME, findSurfaceRepairs, orphanInboxSpliceSeqs, parseImportZip, parseJsonlArtifact, persistImport, recomputeReplaceProvenance, registerSessionImport, repairOrphanInboxSplices, repairSurfaceOps, rowToEvent, rowToMeta, scanRows, sessionConflictRow, sessionInsertRow, toJsonlArtifact };
+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";
+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-CKrzjXVB.mjs → import-eBSoCrxl.mjs}

@@ -1,4 +1,4 @@
-import { s as rowToMeta } from "./log-DTJsxMud.mjs";
+import { d as rowToMeta } from "./log-BIuXv09P.mjs";
 import { randomUUID } from "node:crypto";
 import { SESSION_FORMAT_VERSION, SessionLogOffset } from "@deepseek-ai/dsh-session";
 import { sessionFormatCatalog } from "@deepseek-ai/dsh-session-format-catalog";

package/dist/import.d.mts

@@ -1,4 +1,4 @@
-import { n as SessionPersistenceRdb } from "./index-CgGDHQSK.mjs";
+import { n as SessionPersistenceRdb } from "./index-DfS0PzGM.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-CKrzjXVB.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";
 export { SESSION_IMPORT_PATH, SESSION_LOG_ARTIFACT_FILENAME, parseImportZip, parseJsonlArtifact, persistImport, registerSessionImport };

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

@@ -182,9 +182,9 @@ declare class SessionPersistenceRdb extends SessionPersistence {
   /** 空会话 materialize（flush 的持久化屏障）。 */
   materializeEmpty(meta: SessionHeader, inheritedEventCount: SessionLogOffset): Promise<void>;
   /** 原样 append 落库（handle 已校验 contiguity；torn tail 先截断）。
-   *  与上游 JSONL 一致：ignorable 事件原样存储，不做过滤。写路径校验 v2
-   *  形状（fail-closed）：未知类型（非 ignorable）与非法消息形状拒绝入库；
-   *  旧格式（v0/v1）数据只在读取时经 legacy 转换链动态转换，不落新库。 */
+   *  与上游 JSONL 一致：ignorable 事件原样存储，不做过滤。写路径校验当前
+   *  格式形状（fail-closed）：未知类型（非 ignorable）与非法消息形状拒绝入库；
+   *  非当前格式（v0/v1/v2）数据只在读取时经 legacy 转换链动态转换，不落新库。 */
   appendBatch(meta: SessionHeader, inheritedEventCount: SessionLogOffset, events: readonly SessionEvent[], tornTruncateTo?: number): Promise<boolean>;
   /** 读取一个会话的稠密 log（含 torn tail 检测，不含修复改写）。 */
   readLog(id: SessionId, options?: {
@@ -196,7 +196,21 @@ declare class SessionPersistenceRdb extends SessionPersistence {
     tornFrom?: number;
     incarnation: string;
     revision: number;
+    /** 存储桥接行数（迁移链可能生成/合并事件，与 `events.length` 不同）。 */
+    storedCount: number;
+    /** 是否经上游迁移链转换（非当前格式 → 当前格式）。 */
+    migrated: boolean;
   } | undefined>;
+  /**
+   * 把迁移链读出的当前格式视图整体落库（非当前格式会话写打开时的一次性迁移）。
+   *
+   * 迁移链会生成/合并事件（end-seed / attempt / chunk 合并），事件 seq 空间
+   * 与存储桥接行数不再相等；写路径以存储 head 为锚点重编号，二者不一致会让
+   * append 撞上已有行。这里在同一事务内删光本会话桥接行、按迁移视图重建
+   * （新事件行，完整信封），并更新 head 与 revision；旧事件行保留（可能被
+   * fork 子会话引用，孤儿由惰性 GC 处理）。
+   */
+  private rewriteMigratedLog;
   listSnapshots(signal?: AbortSignal): Promise<Array<SessionPersistenceSnapshot & {
     inheritedEventCount: number;
   }>>;

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-CgGDHQSK.mjs";
+import { a as SessionBranchRdbProvider, i as SessionBranchRdb, n as SessionPersistenceRdb, o as locateTurnEnd, r as SessionPersistenceRdbInternals, t as Config } from "./index-DfS0PzGM.mjs";
 export { Config, SCHEMA_VERSION, SessionBranchRdb, SessionBranchRdbProvider, SessionPersistenceRdb, SessionPersistenceRdb as default, SessionPersistenceRdbInternals, locateTurnEnd };

package/dist/index.mjs

@@ -1,12 +1,12 @@
-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-DCy4VTD8.mjs";
-import { a as repairSurfaceOps, c as scanRows, d as toJsonlArtifact, i as repairOrphanInboxSplices, l as sessionConflictRow, r as recomputeReplaceProvenance, s as rowToMeta, u as sessionInsertRow } from "./log-DTJsxMud.mjs";
-import { c as SessionBranchRdbProvider, l as locateTurnEnd, o as registerSessionImport, s as SessionBranchRdb } from "./import-CKrzjXVB.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-Dpd17YhI.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 z from "@deepseek-ai/schemastery";
 import { randomUUID } from "node:crypto";
 import { Pool } from "pg";
 import { drizzle } from "drizzle-orm/node-postgres";
 import { SessionAlreadyExistsError, SessionAlreadyOwnedError, SessionHandleClosedError, SessionPersistence, SessionPersistenceNotFoundError, SessionPersistenceRevision, SessionReadOnlyError, assertContiguous, assertVersion, materializeAppendBatch, materializeCreateHeader, validateStoredEvents } from "@deepseek-ai/dsh-session-persistence";
-import { SessionLogOffset } from "@deepseek-ai/dsh-session";
+import { SESSION_FORMAT_VERSION, SessionLogOffset } from "@deepseek-ai/dsh-session";
 import { sessionFormatCatalog } from "@deepseek-ai/dsh-session-format-catalog";
 import { and, eq, gte, sql } from "drizzle-orm";
 import { readdirSync } from "node:fs";
@@ -161,35 +161,43 @@ var PostgresBackend = class PostgresBackend {
 };
 //#endregion
 //#region src/legacy.ts
-/** 重建 v0/v1 物理 header 记录（RDB 行 → 物理 JSON 对象）。 */
+/** 重建 v0/v1/v2 物理 header 记录（RDB 行 → 物理 JSON 对象）。 */
 function physicalHeader(row) {
-	return {
+	const common = {
 		type: "session",
 		version: row.fVersion,
 		id: row.fSessionId,
 		createdAt: row.fCreatedAt,
 		...row.fCwd !== null ? { cwd: row.fCwd } : {},
 		...row.fParentSession !== null ? { parentSession: row.fParentSession } : {},
-		...row.fSeedLength !== null ? { seedLength: row.fSeedLength } : {},
 		...row.fOrigin !== null ? { origin: row.fOrigin } : {},
 		delegationDepth: row.fDelegationDepth ?? 0
 	};
+	return row.fVersion < 2 ? {
+		...common,
+		...row.fSeedLength !== null ? { seedLength: row.fSeedLength } : {}
+	} : {
+		...common,
+		isSeeded: row.fSeedLength !== null
+	};
 }
-/** 重建一条 v0/v1 物理事件记录（桥接行 + 事件行 → 物理 JSON 对象）。 */
+/** 重建一条 v0/v1/v2 物理事件记录（桥接行 + 事件行 → 物理 JSON 对象）。 */
 function physicalEvent(row) {
+	const stored = JSON.parse(row.fData);
+	const full = typeof stored === "object" && stored !== null && !Array.isArray(stored) && typeof stored["type"] === "string" && "data" in stored;
 	return {
 		type: row.fType,
 		seq: row.fSequence,
 		time: row.fCreatedAt,
-		data: JSON.parse(row.fData),
+		data: full ? stored["data"] : stored,
 		...row.fSurfaceOp !== null ? { surfaceOp: JSON.parse(row.fSurfaceOp) } : {}
 	};
 }
 /**
-* 把旧格式（v0/v1）行转换为 v2 逻辑事件与 header。
-* @param row - 会话行（f_version < 2）。
+* 把非当前格式（v0/v1/v2）行转换为当前逻辑事件与 header。
+* @param row - 会话行（f_version < SESSION_FORMAT_VERSION）。
 * @param eventRows - 已扫描保留的桥接行（稠密 seq，torn tail 已剔除）。
-* @returns v2 逻辑 header、继承前缀长度与事件。
+* @returns 当前逻辑 header、继承前缀长度与事件。
 * @throws 迁移链拒绝（格式损坏 / 无法迁移）时原样抛出。
 */
 function convertLegacyRows(row, eventRows) {
@@ -205,9 +213,40 @@ function convertLegacyRows(row, eventRows) {
 		events: artifact.events
 	};
 }
-/** 会话行是否携带旧格式（v0/v1）数据。 */
+/** 会话行是否携带非当前格式（f_version < SESSION_FORMAT_VERSION）数据。 */
 function isLegacyVersion(version) {
-	return version < 2;
+	return version < SESSION_FORMAT_VERSION;
+}
+/**
+* 迁移链拒绝后，把旧格式行直接当**当前格式**事件视图采用。
+*
+* 旧写入器只在建会话时落一次 header version，之后跟随上游演进继续追加
+* 事件——同一个 log 因此可能是混合世代（v0 时代的行 + 新版本字段），不是
+* 任何单一已发布格式，严格迁移链必然拒绝。这些行的数据形状（消息包装、
+* 类型名）已经是当前格式，只需 header 版本归一到当前、按稠密 seq 读取；
+* 事件数据的补全与 surface 修复由读取视图修复（repairReadView）负责。
+*
+* 调用方须在此之后执行 `validateStoredEvents`：真正属于旧格式的类型
+* （`assistant/chunk` / `compact/*` 等）仍会被 fail-loud 拒绝。
+*
+* @param row - 会话行（f_version < SESSION_FORMAT_VERSION）。
+* @param eventRows - 该会话全部桥接行（按 f_sequence 升序）。
+* @returns 当前格式 header（version 归一到 SESSION_FORMAT_VERSION）、收缩后的
+*   继承前缀长度、稠密事件与可选 torn tail 起点。
+* @throws scanRows 的已提交区损坏错误（seq gap / 不可解析行）。
+*/
+function adoptLegacyRows(row, eventRows) {
+	const { preserved, tornFrom } = scanRows(eventRows, 0);
+	repairRequestHeaders(preserved);
+	return {
+		meta: {
+			...rowToMeta(row),
+			version: SESSION_FORMAT_VERSION
+		},
+		inheritedEventCount: Math.min(row.fSeedLength ?? 0, preserved.length),
+		events: preserved,
+		...tornFrom !== void 0 ? { tornFrom } : {}
+	};
 }
 //#endregion
 //#region src/index.ts
@@ -352,9 +391,7 @@ var RdbSessionHandle = class RdbSessionHandle {
 			};
 			throw new SessionPersistenceNotFoundError(this.id);
 		}
-		repairSurfaceOps(log.events);
-		recomputeReplaceProvenance(log.events);
-		repairOrphanInboxSplices(log.events);
+		repairReadView(log.events);
 		return {
 			eventState: "detached",
 			events: log.events.slice(offset, offset + length)
@@ -550,6 +587,7 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 			}));
 			const log = await this.readLog(id, {}, options?.signal);
 			if (log === void 0) throw new SessionPersistenceNotFoundError(id);
+			repairReadView(log.events);
 			validateStoredEvents(log.meta, log.events);
 			return this.tracker.adopt(new RdbSessionHandle(this, id, log.meta, "read", {
 				cursor: log.events.length,
@@ -566,7 +604,9 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 			}));
 			const log = await this.readLog(id, {}, options?.signal);
 			if (log === void 0) throw new SessionPersistenceNotFoundError(id);
+			repairReadView(log.events);
 			validateStoredEvents(log.meta, log.events);
+			if (log.migrated && log.events.length !== log.storedCount) await this.rewriteMigratedLog(id, log);
 			this.writeGuard.confirmHead(id, log.events.at(-1)?.seq ?? -1);
 			return this.tracker.adopt(new RdbSessionHandle(this, id, log.meta, "write", {
 				cursor: log.events.length,
@@ -630,8 +670,7 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 		signal?.throwIfAborted();
 		const log = await this.readLog(id, {}, signal);
 		if (log === void 0) return void 0;
-		repairSurfaceOps(log.events);
-		recomputeReplaceProvenance(log.events);
+		repairReadView(log.events);
 		const inheritedEventCount = Math.min(log.inheritedEventCount, log.events.length);
 		return {
 			meta: log.meta,
@@ -654,9 +693,9 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 		this.writeGuard.confirmHead(meta.id, -1);
 	}
 	/** 原样 append 落库（handle 已校验 contiguity；torn tail 先截断）。
-	*  与上游 JSONL 一致：ignorable 事件原样存储，不做过滤。写路径校验 v2
-	*  形状（fail-closed）：未知类型（非 ignorable）与非法消息形状拒绝入库；
-	*  旧格式（v0/v1）数据只在读取时经 legacy 转换链动态转换，不落新库。 */
+	*  与上游 JSONL 一致：ignorable 事件原样存储，不做过滤。写路径校验当前
+	*  格式形状（fail-closed）：未知类型（非 ignorable）与非法消息形状拒绝入库；
+	*  非当前格式（v0/v1/v2）数据只在读取时经 legacy 转换链动态转换，不落新库。 */
 	async appendBatch(meta, inheritedEventCount, events, tornTruncateTo) {
 		await this.ready;
 		if (events.length === 0) return false;
@@ -699,14 +738,29 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 		const meta = rowToMeta(row);
 		const eventRows = options.fromSeq === void 0 ? await this.backend.getEventRows(id) : await this.backend.getEventRows(id, options.fromSeq);
 		signal?.throwIfAborted();
-		if (isLegacyVersion(row.fVersion)) {
+		if (isLegacyVersion(row.fVersion)) try {
 			const converted = convertLegacyRows(row, eventRows);
 			return {
 				meta: converted.meta,
 				inheritedEventCount: converted.inheritedEventCount,
 				events: converted.events,
 				incarnation: row.fIncarnation,
-				revision: row.fRevision
+				revision: row.fRevision,
+				storedCount: eventRows.length,
+				migrated: true
+			};
+		} catch (error) {
+			this.ctx.logger.warn(`session-rdb: session "${id}" is not a single released format; adopting its stored rows as current-format data (${error instanceof Error ? error.message : String(error)})`);
+			const adopted = adoptLegacyRows(row, eventRows);
+			return {
+				meta: adopted.meta,
+				inheritedEventCount: adopted.inheritedEventCount,
+				events: adopted.events,
+				incarnation: row.fIncarnation,
+				revision: row.fRevision,
+				storedCount: eventRows.length,
+				migrated: false,
+				...adopted.tornFrom !== void 0 ? { tornFrom: adopted.tornFrom } : {}
 			};
 		}
 		const { preserved, tornFrom } = scanRows(eventRows, options.fromSeq ?? 0);
@@ -716,9 +770,35 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 			events: preserved,
 			incarnation: row.fIncarnation,
 			revision: row.fRevision,
+			storedCount: eventRows.length,
+			migrated: false,
 			...tornFrom !== void 0 ? { tornFrom } : {}
 		};
 	}
+	/**
+	* 把迁移链读出的当前格式视图整体落库（非当前格式会话写打开时的一次性迁移）。
+	*
+	* 迁移链会生成/合并事件（end-seed / attempt / chunk 合并），事件 seq 空间
+	* 与存储桥接行数不再相等；写路径以存储 head 为锚点重编号，二者不一致会让
+	* append 撞上已有行。这里在同一事务内删光本会话桥接行、按迁移视图重建
+	* （新事件行，完整信封），并更新 head 与 revision；旧事件行保留（可能被
+	* fork 子会话引用，孤儿由惰性 GC 处理）。
+	*/
+	async rewriteMigratedLog(id, log) {
+		await this.backend.transaction(async (tx) => {
+			await tx.deleteBridgeTail(id, 0);
+			await tx.upsertSession({
+				meta: log.meta,
+				inheritedEventCount: SessionLogOffset(log.inheritedEventCount)
+			}, randomUUID());
+			const { headEventId, headSequence } = await appendEventTail(tx, log.meta, log.events, {
+				parentId: "",
+				nextSeq: 0
+			});
+			await tx.updateHead(id, headEventId, headSequence);
+			await tx.bumpRevision(id);
+		});
+	}
 	async listSnapshots(signal) {
 		signal?.throwIfAborted();
 		await this.ready;
@@ -904,6 +984,7 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 			if (stored.meta.cwd !== session.header.cwd) throw new Error(`session "${id}" is already persisted at a different cwd (persisted: ${String(stored.meta.cwd)}, live: ${String(session.header.cwd)}) (id collision)`);
 			if (stored.inheritedEventCount !== session.inheritedEventCount) throw new Error(`session "${id}" is already persisted with a different inherited event count (id collision)`);
 			assertVersion(stored.meta);
+			repairReadView(stored.events);
 			const seed = session.snapshotEvents();
 			if (!seedCoversPrefix(seed, stored.events)) throw new Error(`session "${id}" already has a persisted log on disk that does not match this live session (id collision)`);
 			handle = await this.open(id, "write");