@morlay/session-rdb 0.0.18 → 0.0.20

package/dist/index.mjs

@@ -1,17 +1,20 @@
-import { S as WriteGuard, a as EVENT_ENCODING, b as postgresTableDefs, c as eventDimensions, i as DEFAULT_BUSY_TIMEOUT_MS, o as SCHEMA_VERSION, r as createStorageRepository, t as SqliteBackend, x as toPostgresSchema } from "./sqlite-BIPdMNQb.mjs";
+import { S as WriteGuard, a as EVENT_ENCODING, b as postgresTableDefs, c as eventDimensions, i as DEFAULT_BUSY_TIMEOUT_MS, o as SCHEMA_VERSION, r as createStorageRepository, t as SqliteBackend, x as toPostgresSchema } from "./sqlite-DYExtbLo.mjs";
 import { _ as toJsonlArtifact, c as repairRequestHeaders, d as rowToMeta, f as scanRows, g as titleOfEventData, m as sessionInsertRow, p as sessionConflictRow, s as repairReadView } from "./log-DO69NQnn.mjs";
-import { c as SessionBranchRdbProvider, l as locateTurnEnd, o as registerSessionImport, s as SessionBranchRdb } from "./import-DZIAjOUr.mjs";
+import { n as SessionBranchRdbProvider, r as locateTurnEnd, t as SessionBranchRdb } from "./branch-Co6xlbi0.mjs";
+import { registerSessionImport } from "./import.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 { SESSION_FORMAT_VERSION, SessionLogOffset } from "@deepseek-ai/dsh-session";
+import { sessionFormatLogFilename } from "@deepseek-ai/dsh-session-format";
 import { sessionFormatCatalog } from "@deepseek-ai/dsh-session-format-catalog";
 import { and, desc, eq, gte, sql } from "drizzle-orm";
 import { readdirSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { migrate } from "drizzle-orm/node-postgres/migrator";
+import { SessionQueryEngine, SessionQueryError } from "@deepseek-ai/dsh-session-query";
 import { StorageError, storageBackendServiceKey } from "@deepseek-ai/dsh-storage";
 import { Service } from "@deepseek-ai/cordis";
 //#region src/postgres.ts
@@ -49,7 +52,7 @@ var PostgresBackend = class PostgresBackend {
 				} finally {
 					this.txOverride = previous;
 				}
-			}),
+			}, { isolationLevel: "serializable" }),
 			tables: this.tables
 		});
 	}
@@ -212,6 +215,22 @@ var PostgresBackend = class PostgresBackend {
 	}
 };
 //#endregion
+//#region src/session-query.ts
+var SessionQueryRdb = class extends SessionQueryEngine {
+	constructor(ctx, config = {}) {
+		super(ctx, config);
+	}
+	async searchSessions() {
+		throw searchDisabled();
+	}
+	async searchEvents() {
+		throw searchDisabled();
+	}
+};
+function searchDisabled() {
+	return new SessionQueryError("session search is disabled: this deployment serves session queries from the rdb backend without a full-text index", "SESSION_QUERY_SEARCH_DISABLED");
+}
+//#endregion
 //#region src/legacy.ts
 /** 重建 v0/v1/v2 物理 header 记录（RDB 行 → 物理 JSON 对象）。 */
 function physicalHeader(row) {
@@ -319,36 +338,41 @@ const SESSION_PROJECTION_CACHE_SERVICE = "sessionProjectionCache";
 const PREDECESSOR_TITLE_KEY = "title";
 /** rdb 持久化的投影 checkpoint 服务：同步驱动直读介质，异步驱动用写穿镜像支撑同步签名。 */
 var SessionProjectionCacheRdb = class extends Service {
-	config;
-	repository;
-	ready;
 	static inject = ["sessionProjections", "sessions"];
 	/** 异步驱动（PostgreSQL）的同步读镜像：同步驱动（SQLite）直读介质，这里恒为空。 */
 	records = /* @__PURE__ */ new Map();
 	dirty = /* @__PURE__ */ new Map();
 	/** 读路径是否直读介质（`readProjcacheSync` 存在即同步驱动）。 */
 	directReads;
+	config;
+	repository;
+	ready;
 	/**
-	* @param ctx - 插件上下文（须已注入 sessionProjections 与 sessions）。
-	* @param config - 写节流参数。
-	* @param repository - storages 接管表访问层。
-	* @param ready - 介质就绪信号（直读介质前必须等到）。
+	* 本类按 cordis class plugin 装载（`ctx.plugin(SessionProjectionCacheRdb, options)`）：
+	* `static inject` 等依赖就绪后构造，构造后框架调用 `[Service.init]` 安装写入
+	* 路径——直接 `new` 不会触发 init，写入路径会静默缺失。
+	* @param ctx - 插件上下文（已注入 sessionProjections 与 sessions）。
+	* @param options - 写节流 + storages 接管访问层 + 介质就绪信号。
 	*/
-	constructor(ctx, config, repository, ready) {
+	constructor(ctx, options) {
 		super(ctx, SESSION_PROJECTION_CACHE_SERVICE);
-		this.config = config;
-		this.repository = repository;
-		this.ready = ready;
-		this.directReads = repository.readProjcacheSync !== void 0;
+		this.config = options;
+		this.repository = options.repository;
+		this.ready = options.ready;
+		this.directReads = options.repository.readProjcacheSync !== void 0;
 	}
 	/**
-	* Wait for the medium, then install the write path. Only the async driver
-	* needs a startup mirror: the sync driver serves every read from the table.
+	* Install the write path before the async medium wait: listeners must exist
+	* from plugin activation on, or sessions created while the medium settles
+	* lose their mandatory checkpoints. Only the async driver needs the startup
+	* mirror; the sync driver serves every read from the table.
 	*/
 	async [Service.init]() {
+		this.installWritePath();
 		await this.ready;
+		const pruned = await this.repository.pruneStaleProjcache();
+		if (pruned > 0) this.ctx.logger.info(`session projection cache: pruned stale snapshot(s) for ${String(pruned)} session(s)`);
 		if (!this.directReads) for (const entry of await this.repository.loadProjcache()) this.records.set(entry.sessionId, entry);
-		this.installWritePath();
 	}
 	/** Read one session's stored record: straight from the medium, or from the async mirror. */
 	lookup(id) {
@@ -601,8 +625,8 @@ const WORKSPACE_TABLE = "workspaces";
 var RdbStorageBackend = class {
 	repository;
 	kv = { open: (descriptor) => this.openUnit(descriptor) };
-	/** 已打开（或打开中）的 unit 名；重复 open 是调用方 bug。 */
-	open = /* @__PURE__ */ new Set();
+	/** 已打开（或打开中）的 unit；重复 open 是调用方 bug。 */
+	open = /* @__PURE__ */ new Map();
 	closed = false;
 	/**
 	* @param repository - storages 接管表访问层（与事件日志同介质）。
@@ -614,35 +638,52 @@ var RdbStorageBackend = class {
 		if (this.closed) throw new StorageError("closed", "rdb storage backend is closed");
 		if (descriptor.name !== WORKSPACE_UNIT) throw new Error(`rdb storage backend serves only the '${WORKSPACE_UNIT}' domain (requested '${descriptor.name}')`);
 		if (!descriptor.tables.includes(WORKSPACE_TABLE) || descriptor.hasGlobal !== true) throw new Error(`rdb storage backend expects the '${WORKSPACE_UNIT}' domain shape (table '${WORKSPACE_TABLE}' plus a global slot)`);
+		if (descriptor.layout !== void 0 && descriptor.layout !== "single") throw new Error(`rdb storage backend serves only the 'single' layout (domain '${descriptor.name}' declares '${descriptor.layout}')`);
 		if (this.open.has(descriptor.name)) throw new Error(`kv unit '${descriptor.name}' is already open (double-open is a caller bug)`);
-		const stored = await this.repository.readUnitVersion(descriptor.name);
-		if (stored === void 0) await this.repository.insertUnitVersion(descriptor.name, descriptor.version);
-		else if (stored !== descriptor.version) throw new StorageError("version-mismatch", `kv unit '${descriptor.name}' is stamped version ${stored} on the medium, incompatible with descriptor version ${descriptor.version}`);
-		this.open.add(descriptor.name);
-		return new WorkspaceKvUnit(this.repository, descriptor, () => {
+		const unit = new WorkspaceKvUnit(this.repository, descriptor);
+		this.open.set(descriptor.name, unit);
+		try {
+			const stored = await this.repository.readUnitVersion(descriptor.name);
+			if (stored === void 0) await this.repository.insertUnitVersion(descriptor.name, descriptor.version);
+			else if (stored !== descriptor.version) throw new StorageError("version-mismatch", `kv unit '${descriptor.name}' is stamped version ${stored} on the medium, incompatible with descriptor version ${descriptor.version}`);
+		} catch (error) {
+			this.open.delete(descriptor.name);
+			throw error;
+		}
+		unit.onClose(() => {
 			this.open.delete(descriptor.name);
 		});
+		return unit;
 	}
 	/**
-	* Release the backend. The medium (the session database) belongs to the
-	* owning session-rdb plugin, so closing open units here does not close it.
-	* @returns resolution after the name table is cleared.
+	* Release the backend. New writes are rejected immediately; already-queued
+	* unit writes drain first (upstream backend contract). The medium (the
+	* session database) belongs to the owning session-rdb plugin, so closing
+	* open units here does not close it.
+	* @returns resolution after every open unit drained.
 	*/
 	async close() {
 		this.closed = true;
+		const units = [...this.open.values()];
 		this.open.clear();
+		await Promise.all(units.map((unit) => unit.close()));
 	}
 };
 /** workspace 域的 KV unit：每个原语一条 SQL 语句，值形状与上游记录一致。 */
 var WorkspaceKvUnit = class {
 	repository;
 	descriptor;
-	onClose;
 	closed = false;
-	constructor(repository, descriptor, onClose) {
+	/** 在途写操作：close 先拒绝新写，再 drain 它们（不丢已受理的写）。 */
+	inflight = /* @__PURE__ */ new Set();
+	onClosed;
+	constructor(repository, descriptor) {
 		this.repository = repository;
 		this.descriptor = descriptor;
-		this.onClose = onClose;
+	}
+	/** Install the name-release callback after the backend registered this unit. */
+	onClose(release) {
+		this.onClosed = release;
 	}
 	async loadAll() {
 		this.assertOpen();
@@ -657,21 +698,32 @@ var WorkspaceKvUnit = class {
 	async putRecord(table, key, value) {
 		this.assertOpen();
 		this.assertTable(table);
-		await this.repository.putWorkspace(key, workspaceRecordOf(value));
+		await this.track(this.repository.putWorkspace(key, workspaceRecordOf(value)));
 	}
 	async deleteRecord(table, key) {
 		this.assertOpen();
 		this.assertTable(table);
-		await this.repository.deleteWorkspace(key);
+		await this.track(this.repository.deleteWorkspace(key));
 	}
 	async setGlobal(value) {
 		this.assertOpen();
-		await this.repository.writeWorkspaceState(workspaceStateOf(value));
+		await this.track(this.repository.writeWorkspaceState(workspaceStateOf(value)));
 	}
 	async close() {
 		if (this.closed) return;
 		this.closed = true;
-		this.onClose();
+		while (this.inflight.size > 0) await Promise.allSettled(this.inflight);
+		this.onClosed?.();
+	}
+	/** Register one accepted write so close can drain it. */
+	async track(operation) {
+		const settled = operation.then(() => void 0, () => void 0);
+		this.inflight.add(settled);
+		try {
+			await operation;
+		} finally {
+			this.inflight.delete(settled);
+		}
 	}
 	assertOpen() {
 		if (this.closed) throw new StorageError("closed", `kv unit '${this.descriptor.name}' is closed`);
@@ -722,8 +774,10 @@ function installStorageTakeover(ctx, options) {
 		}, "session-rdb.storageBackend");
 		storageCtx.provide(storageBackendServiceKey("rdb"), backend);
 	});
-	ctx.inject(["sessionProjections"], (projectionCtx) => {
-		new SessionProjectionCacheRdb(projectionCtx, options.projectionCache, options.repository, options.ready);
+	ctx.plugin(SessionProjectionCacheRdb, {
+		...options.projectionCache,
+		repository: options.repository,
+		ready: options.ready
 	});
 }
 //#endregion
@@ -1047,6 +1101,7 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 		this.ready = this.init();
 		this.installLiveRouting(ctx);
 		new SessionBranchRdb(this.ctx);
+		this.ctx.plugin(SessionQueryRdb, {});
 		registerSessionImport(this.ctx, this);
 		installStorageTakeover(this.ctx, {
 			repository: this.backend.storage,
@@ -1166,7 +1221,7 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 		}
 		return snapshots;
 	}
-	/** 导出 artifact（jsonl v2 文本），视图只读不落库。 */
+	/** 导出当前世代的 jsonl artifact，视图只读不落库。 */
 	async readRaw(id, signal) {
 		signal?.throwIfAborted();
 		await this.ready;
@@ -1178,7 +1233,7 @@ var SessionPersistenceRdb = class SessionPersistenceRdb extends SessionPersisten
 		return {
 			meta: log.meta,
 			inheritedEventCount,
-			filename: "session.jsonl",
+			filename: sessionFormatLogFilename(SESSION_FORMAT_VERSION),
 			content: toJsonlArtifact(log.meta, inheritedEventCount, log.events)
 		};
 	}

package/dist/{magic-string.es-BWtG0AyA.mjs → magic-string.es-BgJoa-3K.mjs}

@@ -1,4 +1,4 @@
-//#region ../../node_modules/.pnpm/@jridgewell+sourcemap-codec@1.6.0/node_modules/@jridgewell/sourcemap-codec/dist/sourcemap-codec.mjs
+//#region ../../../node_modules/.pnpm/@jridgewell+sourcemap-codec@1.6.0/node_modules/@jridgewell/sourcemap-codec/dist/sourcemap-codec.mjs
 var comma = ",".charCodeAt(0);
 var semicolon = ";".charCodeAt(0);
 var chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
@@ -78,7 +78,7 @@ function encode(decoded) {
 	return writer.flush();
 }
 //#endregion
-//#region ../../node_modules/.pnpm/magic-string@0.30.21/node_modules/magic-string/dist/magic-string.es.mjs
+//#region ../../../node_modules/.pnpm/magic-string@0.30.21/node_modules/magic-string/dist/magic-string.es.mjs
 var BitSet = class BitSet {
 	constructor(arg) {
 		this.bits = arg instanceof BitSet ? arg.bits.slice() : [];

package/dist/{schema-Bo6Hy5gW.d.mts → schema-BkQN5GyT.d.mts}

@@ -4,7 +4,7 @@ import { Session, SessionEvent, SessionHeader, SessionId, SessionLogOffset, Sess
 import { KvUnit } from "@deepseek-ai/dsh-storage";
 import { Context, Service } from "@deepseek-ai/cordis";
 import { SessionId as SessionId$1 } from "@deepseek-ai/dsh-session/types";
-//#region ../../node_modules/.pnpm/zod@4.6.1/node_modules/zod/v4/core/json-schema.d.cts
+//#region ../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/json-schema.d.cts
 type _JSONSchema = boolean | JSONSchema;
 type SchemaType = "object" | "array" | "string" | "number" | "boolean" | "null" | "integer";
 type JSONSchema = {
@@ -73,7 +73,7 @@ type JSONSchema = {
 };
 type BaseSchema = JSONSchema;
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.6.1/node_modules/zod/v4/core/standard-schema.d.cts
+//#region ../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/standard-schema.d.cts
 /** The Standard interface. */
 interface StandardTypedV1<Input = unknown, Output = Input> {
   /** The Standard properties. */
@@ -192,7 +192,7 @@ declare namespace StandardJSONSchemaV1 {
 }
 interface StandardSchemaWithJSONProps<Input = unknown, Output = Input> extends StandardSchemaV1.Props<Input, Output>, StandardJSONSchemaV1.Props<Input, Output> {}
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.6.1/node_modules/zod/v4/core/registries.d.cts
+//#region ../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/registries.d.cts
 declare const $output: unique symbol;
 type $output = typeof $output;
 declare const $input: unique symbol;
@@ -219,7 +219,7 @@ interface JSONSchemaMeta {
 }
 interface GlobalMeta extends JSONSchemaMeta {}
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.6.1/node_modules/zod/v4/core/to-json-schema.d.cts
+//#region ../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/to-json-schema.d.cts
 type Processor<T extends $ZodType = $ZodType> = (schema: T, ctx: ToJSONSchemaContext, json: BaseSchema, params: ProcessParams) => void;
 /**
  * Called for each schema that has no JSON Schema equivalent. Return a JSON Schema to use in its
@@ -341,14 +341,13 @@ interface ZodStandardJSONSchemaPayload<T> extends BaseSchema {
   "~standard": ZodStandardSchemaWithJSON$1<T>;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.6.1/node_modules/zod/v4/core/util.d.cts
+//#region ../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/util.d.cts
 type JWTAlgorithm = "HS256" | "HS384" | "HS512" | "RS256" | "RS384" | "RS512" | "ES256" | "ES384" | "ES512" | "PS256" | "PS384" | "PS512" | "EdDSA" | (string & {});
 type MimeTypes = "application/json" | "application/xml" | "application/x-www-form-urlencoded" | "application/javascript" | "application/pdf" | "application/zip" | "application/vnd.ms-excel" | "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" | "application/msword" | "application/vnd.openxmlformats-officedocument.wordprocessingml.document" | "application/vnd.ms-powerpoint" | "application/vnd.openxmlformats-officedocument.presentationml.presentation" | "application/octet-stream" | "application/graphql" | "text/html" | "text/plain" | "text/css" | "text/javascript" | "text/csv" | "image/png" | "image/jpeg" | "image/gif" | "image/svg+xml" | "image/webp" | "audio/mpeg" | "audio/ogg" | "audio/wav" | "audio/webm" | "video/mp4" | "video/webm" | "video/ogg" | "font/woff" | "font/woff2" | "font/ttf" | "font/otf" | "multipart/form-data" | (string & {});
 type IsAny<T> = 0 extends 1 & T ? true : false;
 type Omit$1<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>;
 type MakePartial<T, K extends keyof T> = Omit$1<T, K> & InexactPartial<Pick<T, K>>;
 type NoUndefined<T> = T extends undefined ? never : T;
-type Widen<T> = T extends string ? string : T extends number ? number : T extends boolean ? boolean : T extends bigint ? bigint : T;
 type LoosePartial<T extends object> = InexactPartial<T> & {
   [k: string]: unknown;
 };
@@ -385,14 +384,14 @@ declare abstract class Class {
 /** A trait's prototype members: a partial view of its own interface, with `this` typed as the instance. */
 type ProtoOf<T> = { [K in keyof T]?: (T[K] extends ((...args: infer A) => infer R) ? (...args: A) => R : T[K]) | undefined; } & ThisType<T>;
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.6.1/node_modules/zod/v4/core/versions.d.cts
+//#region ../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/versions.d.cts
 declare const version: {
   readonly major: 4;
   readonly minor: 6;
   readonly patch: number;
 };
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.6.1/node_modules/zod/v4/core/schemas.d.cts
+//#region ../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/schemas.d.cts
 interface ParseContext<T extends $ZodIssueBase = never> {
   /** Customize error messages. */
   readonly error?: $ZodErrorMap<T>;
@@ -420,7 +419,7 @@ interface ParsePayload<T = unknown> {
 }
 type CheckFn<T> = (input: ParsePayload<T>) => MaybeAsync<void>;
 interface $ZodTypeDef {
-  type: "string" | "number" | "int" | "boolean" | "bigint" | "symbol" | "null" | "undefined" | "void" | "never" | "any" | "unknown" | "date" | "object" | "record" | "file" | "array" | "tuple" | "union" | "intersection" | "map" | "set" | "enum" | "literal" | "nullable" | "optional" | "nonoptional" | "success" | "transform" | "default" | "prefault" | "catch" | "nan" | "pipe" | "readonly" | "template_literal" | "promise" | "lazy" | "function" | "custom" | "properties";
+  type: "string" | "number" | "int" | "boolean" | "bigint" | "symbol" | "null" | "undefined" | "void" | "never" | "any" | "unknown" | "date" | "object" | "record" | "file" | "array" | "tuple" | "union" | "intersection" | "map" | "set" | "enum" | "literal" | "nullable" | "optional" | "nonoptional" | "success" | "transform" | "default" | "prefault" | "catch" | "nan" | "pipe" | "readonly" | "template_literal" | "promise" | "lazy" | "function" | "custom";
   error?: $ZodErrorMap<never> | undefined;
   checks?: $ZodCheck<never>[];
 }
@@ -1198,7 +1197,7 @@ interface $ZodPrefaultDef<T extends SomeType = $ZodType> extends $ZodTypeDef {
   /** The default value. May be a getter. */
   defaultValue: input<T>;
 }
-interface $ZodPrefaultInternals<T extends SomeType = $ZodType> extends $ZodTypeInternals<NoUndefined<output<T>>, input<T> | undefined> {
+interface $ZodPrefaultInternals<T extends SomeType = $ZodType> extends $ZodTypeInternals<output<T>, input<T> | undefined> {
   def: $ZodPrefaultDef<T>;
   optin: "defaulted";
   optout?: "optional" | undefined;
@@ -1411,24 +1410,9 @@ interface $ZodCustom<O = unknown, I = unknown> extends $ZodType {
   _zod: $ZodCustomInternals<O, I>;
 }
 declare const $ZodCustom: $constructor<$ZodCustom>;
-interface $ZodPropertiesDef<Shape extends $ZodShape = $ZodShape> extends $ZodTypeDef, $ZodCheckDef {
-  type: "properties";
-  check: "properties";
-  shape: Shape;
-}
-interface $ZodPropertiesInternals<Shape extends $ZodShape = $ZodShape> extends $ZodTypeInternals<$InferObjectInput<Shape, {}>, $InferObjectInput<Shape, {}>>, $ZodCheckInternals<{ -readonly [k in keyof Shape]: Widen<input<Shape[k]>>; }> {
-  def: $ZodPropertiesDef<Shape>;
-  isst: $ZodIssueInvalidType;
-  issc: $ZodIssue;
-}
-interface $ZodProperties<Shape extends $ZodShape = $ZodShape> extends $ZodType {
-  _zod: $ZodPropertiesInternals<Shape>;
-  [Symbol.iterator](): Iterator<this>;
-}
-declare const $ZodProperties: $constructor<$ZodProperties>;
-type $ZodTypes = $ZodString | $ZodNumber | $ZodBigInt | $ZodBoolean | $ZodDate | $ZodSymbol | $ZodUndefined | $ZodNullable | $ZodNull | $ZodAny | $ZodUnknown | $ZodNever | $ZodVoid | $ZodArray | $ZodObject | $ZodUnion | $ZodIntersection | $ZodTuple | $ZodRecord | $ZodMap | $ZodSet | $ZodLiteral | $ZodEnum | $ZodFunction | $ZodPromise | $ZodLazy | $ZodOptional | $ZodDefault | $ZodPrefault | $ZodTemplateLiteral | $ZodCustom | $ZodProperties | $ZodTransform | $ZodNonOptional | $ZodReadonly | $ZodNaN | $ZodPipe | $ZodSuccess | $ZodCatch | $ZodFile;
+type $ZodTypes = $ZodString | $ZodNumber | $ZodBigInt | $ZodBoolean | $ZodDate | $ZodSymbol | $ZodUndefined | $ZodNullable | $ZodNull | $ZodAny | $ZodUnknown | $ZodNever | $ZodVoid | $ZodArray | $ZodObject | $ZodUnion | $ZodIntersection | $ZodTuple | $ZodRecord | $ZodMap | $ZodSet | $ZodLiteral | $ZodEnum | $ZodFunction | $ZodPromise | $ZodLazy | $ZodOptional | $ZodDefault | $ZodPrefault | $ZodTemplateLiteral | $ZodCustom | $ZodTransform | $ZodNonOptional | $ZodReadonly | $ZodNaN | $ZodPipe | $ZodSuccess | $ZodCatch | $ZodFile;
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.6.1/node_modules/zod/v4/core/checks.d.cts
+//#region ../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/checks.d.cts
 interface $ZodCheckDef {
   check: string;
   error?: $ZodErrorMap<never> | undefined;
@@ -1610,7 +1594,7 @@ interface $ZodCheckEndsWith extends $ZodCheckInternals<string> {
 }
 declare const $ZodCheckEndsWith: $constructor<$ZodCheckEndsWith>;
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.6.1/node_modules/zod/v4/core/errors.d.cts
+//#region ../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/errors.d.cts
 interface $ZodIssueBase {
   readonly code?: string;
   readonly input?: unknown;
@@ -1739,7 +1723,7 @@ type $ZodFormattedError<T, U = string> = {
   _errors: U[];
 } & Flatten<_ZodFormattedError<T, U>>;
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.6.1/node_modules/zod/v4/core/core.d.cts
+//#region ../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/core.d.cts
 type ZodTrait = {
   _zod: {
     def: any;
@@ -1785,7 +1769,7 @@ type output<T> = T extends {
   };
 } ? T["_zod"]["output"] : unknown;
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.6.1/node_modules/zod/v4/core/api.d.cts
+//#region ../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/core/api.d.cts
 type Params<T extends $ZodType | $ZodCheck, IssueTypes extends $ZodIssueBase, OmitKeys extends keyof T["_zod"]["def"] = never> = Flatten<Partial<EmptyToNever<Omit<T["_zod"]["def"], OmitKeys> & ([IssueTypes] extends [never] ? {} : {
   error?: string | $ZodErrorMap<IssueTypes> | undefined;
   /** @deprecated This parameter is deprecated. Use `error` instead. */
@@ -1857,7 +1841,7 @@ interface $ZodSuperRefineParams {
   when?: ((payload: ParsePayload) => boolean) | undefined;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.6.1/node_modules/zod/v4/classic/errors.d.cts
+//#region ../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/classic/errors.d.cts
 /** An Error-like class used to store Zod validation issues.  */
 interface ZodError<T = unknown> extends $ZodError<T> {
   /** @deprecated Use the `z.treeifyError(err)` function instead. */
@@ -1875,7 +1859,7 @@ interface ZodError<T = unknown> extends $ZodError<T> {
 }
 declare const ZodError: $constructor<ZodError>;
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.6.1/node_modules/zod/v4/classic/parse.d.cts
+//#region ../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/classic/parse.d.cts
 type ZodSafeParseResult<T> = ZodSafeParseSuccess<T> | ZodSafeParseError<T>;
 type ZodSafeParseSuccess<T> = {
   success: true;
@@ -1888,7 +1872,7 @@ type ZodSafeParseError<T> = {
   error: ZodError<T>;
 };
 //#endregion
-//#region ../../node_modules/.pnpm/zod@4.6.1/node_modules/zod/v4/classic/schemas.d.cts
+//#region ../../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/classic/schemas.d.cts
 type ZodStandardSchemaWithJSON<T> = StandardSchemaWithJSONProps<input<T>, output<T>>;
 interface ZodType<out Output = unknown, out Input = unknown, out Internals extends $ZodTypeInternals<Output, Input> = $ZodTypeInternals<Output, Input>> extends $ZodType<Output, Input, Internals> {
   def: Internals["def"];
@@ -2220,7 +2204,7 @@ interface ZodReadonly<T extends SomeType = $ZodType> extends _ZodType<$ZodReadon
 }
 declare const ZodReadonly: $constructor<ZodReadonly>;
 //#endregion
-//#region ../../vendor/deepseek-harness/packages/session/session-projection/lib/types/types.d.ts
+//#region ../../../vendor/deepseek-harness/packages/session/session-projection/lib/types/types.d.ts
 /**
  * Pure-type outlet of the session-projection Service Definition: the one projection type
  * table, importable from client aggregates without dragging the host-side
@@ -2244,7 +2228,7 @@ interface SessionProjectionMap {}
  */
 interface SessionProjectionStateMap {}
 //#endregion
-//#region ../../vendor/deepseek-harness/packages/session/session-projection/lib/types/index.d.ts
+//#region ../../../vendor/deepseek-harness/packages/session/session-projection/lib/types/index.d.ts
 declare module '@deepseek-ai/cordis' {
   interface Context {
     sessionProjections: SessionProjectionRegistry;
@@ -2512,7 +2496,7 @@ declare class SessionProjectionRegistry extends Service {
   private viewCell;
 }
 //#endregion
-//#region ../../vendor/deepseek-harness/packages/storage/storage-domain/lib/types/spec.d.ts
+//#region ../../../vendor/deepseek-harness/packages/storage/storage-domain/lib/types/spec.d.ts
 /** Global singleton declaration: schema plus the value used before the first write. */
 interface DomainGlobalSpec<G> {
   /** Validates the stored global at the durable boundary. */
@@ -2575,7 +2559,7 @@ type TableKeyOf<S extends DomainSpec, N extends keyof S['tables']> = S['tables']
 /** Value type of one declared table. */
 type TableValueOf<S extends DomainSpec, N extends keyof S['tables']> = S['tables'][N] extends DomainTableSpec<string, infer V> ? V : never;
 //#endregion
-//#region ../../vendor/deepseek-harness/packages/storage/storage-domain/lib/types/domain.d.ts
+//#region ../../../vendor/deepseek-harness/packages/storage/storage-domain/lib/types/domain.d.ts
 /** Handle on a domain's global singleton. */
 interface DomainGlobal<G> {
   /**
@@ -2729,7 +2713,7 @@ declare class DomainImpl {
   private assertReadable;
 }
 //#endregion
-//#region ../../vendor/deepseek-harness/packages/storage/storage-domain/lib/types/events.d.ts
+//#region ../../../vendor/deepseek-harness/packages/storage/storage-domain/lib/types/events.d.ts
 /**
  * Change-event vocabulary of the domain data form. Every durable write emits
  * one event after the backend resolves durability, carrying the new snapshot
@@ -2774,7 +2758,7 @@ declare module '@deepseek-ai/cordis' {
   }
 }
 //#endregion
-//#region ../../vendor/deepseek-harness/packages/storage/storage-domain/lib/types/index.d.ts
+//#region ../../../vendor/deepseek-harness/packages/storage/storage-domain/lib/types/index.d.ts
 declare module '@deepseek-ai/dsh-storage' {
   interface StorageForms {
     domain: DomainFacility;
@@ -2852,7 +2836,7 @@ declare class DomainFacility {
   closeAll(): Promise<void>;
 }
 //#endregion
-//#region ../../vendor/deepseek-harness/packages/session/session-projection-cache/lib/types/spec.d.ts
+//#region ../../../vendor/deepseek-harness/packages/session/session-projection-cache/lib/types/spec.d.ts
 /**
  * The stored-log identity a record is bound to: the immutable header fields
  * that distinguish one session lifecycle from another under the same id. A
@@ -2879,7 +2863,7 @@ declare const checkpointIdentity: ZodObject<{
 /** The identity fields a record is bound to, inferred from {@link checkpointIdentity}. */
 type CheckpointIdentity = output<typeof checkpointIdentity>;
 //#endregion
-//#region ../../vendor/deepseek-harness/packages/session/session-projection-cache/lib/types/index.d.ts
+//#region ../../../vendor/deepseek-harness/packages/session/session-projection-cache/lib/types/index.d.ts
 declare module '@deepseek-ai/cordis' {
   interface Context {
     sessionProjectionCache: SessionProjectionCache;
@@ -3014,7 +2998,7 @@ declare class SessionProjectionCache extends Service {
   private requireTable;
 }
 //#endregion
-//#region ../../vendor/deepseek-harness/packages/util/brand/lib/types/index.d.ts
+//#region ../../../vendor/deepseek-harness/packages/util/brand/lib/types/index.d.ts
 /**
  * Duplicate-install-safe nominal primitive helpers.
  *
@@ -3034,7 +3018,7 @@ type Branded<B extends string> = string & {
   readonly [BRAND]: B;
 };
 //#endregion
-//#region ../../vendor/deepseek-harness/packages/workspace/workspace/lib/types/types.d.ts
+//#region ../../../vendor/deepseek-harness/packages/workspace/workspace/lib/types/types.d.ts
 /**
  * Identifies one workspace record. A generated uuid, never the path: path
  * normalization rewrites paths, and a reference anchor must stay stable.
@@ -3127,7 +3111,7 @@ interface Workspace {
   status(): Promise<'ok' | 'missing-dir'>;
 }
 //#endregion
-//#region ../../vendor/deepseek-harness/packages/workspace/workspace/lib/types/spec.d.ts
+//#region ../../../vendor/deepseek-harness/packages/workspace/workspace/lib/types/spec.d.ts
 /**
  * Durable shape of one workspace record. `path` is the `fs.realpath` canon
  * stamped at create; `sessionIds` is the ordered ownership account (array
@@ -3166,7 +3150,7 @@ declare const workspaceDomainState: ZodObject<{
 /** Durable registry state inferred from {@link workspaceDomainState}. */
 type WorkspaceDomainState = output<typeof workspaceDomainState>;
 //#endregion
-//#region ../../vendor/deepseek-harness/packages/workspace/workspace/lib/types/index.d.ts
+//#region ../../../vendor/deepseek-harness/packages/workspace/workspace/lib/types/index.d.ts
 /** Identifies one workspace record (see `src/types.ts` for the brand rationale). */
 type WorkspaceId = WorkspaceId$1;
 /**
@@ -3359,8 +3343,13 @@ interface StorageRepository {
    * @param rows - 每个投影 key 一行。
    */
   putProjcache(sessionId: string, rows: ProjectionCheckpoint): Promise<void>;
-  /** 删除一个会话的 checkpoint（缺失为 no-op）。 */
-  deleteProjcache(sessionId: string): Promise<void>;
+  /**
+   * 清理陈旧 checkpoint 行：水位为负却已有事件的会话（旧版写入路径的产物，
+   * 会把有对话的会话误判为空白）。缓存是派生数据，删除只让该会话回到
+   * 「未知即可见」并等待下一次强制点重写。
+   * @returns 删除的行数。
+   */
+  pruneStaleProjcache(): Promise<number>;
 }
 //#endregion
 //#region src/backend.d.ts

package/dist/{sqlite-BIPdMNQb.mjs → sqlite-DYExtbLo.mjs}

@@ -1,7 +1,7 @@
 import { g as titleOfEventData, m as sessionInsertRow, p as sessionConflictRow } from "./log-DO69NQnn.mjs";
 import { randomUUID } from "node:crypto";
-import { SessionId, SessionLogOffset, SessionSeq } from "@deepseek-ai/dsh-session";
-import { and, desc, eq, gte, isNotNull, notInArray, sql } from "drizzle-orm";
+import { SESSION_FORMAT_VERSION, SessionId, SessionLogOffset, SessionSeq } from "@deepseek-ai/dsh-session";
+import { and, desc, eq, gte, inArray, isNotNull, lt, notInArray, sql } from "drizzle-orm";
 import { check, index, integer, sqliteTable, text, unique } from "drizzle-orm/sqlite-core";
 import { bigint, check as check$1, index as index$1, integer as integer$1, pgSchema, pgTable, serial, text as text$1, unique as unique$1 } from "drizzle-orm/pg-core";
 import { readdirSync, statSync } from "node:fs";
@@ -407,7 +407,7 @@ const workspaceSessions = {
 * workspace 域 global 单例（上游 `workspaceDomainState`）：`initialized` 是
 * 引导标记，`pendingMutation` 拆成操作与目标两列（create / delete 的可恢复
 * 两写标记）。显示顺序（`workspaceIds`）在 `t_workspaces.f_position`，
-* 归档集在 `t_session_archives`。
+* 归档集由 `t_sessions.f_archived_at` 承载（归档不触碰归属槽位）。
 */
 const workspaceState = {
 	name: "t_workspace_state",
@@ -842,7 +842,24 @@ function createStorageRepository(host) {
 				const archived = state.archivedSessionIds;
 				await runQuery(archived.length === 0 ? db.update(tSessions).set({ fArchivedAt: null }).where(isNotNull(tSessions.fArchivedAt)) : db.update(tSessions).set({ fArchivedAt: null }).where(and(isNotNull(tSessions.fArchivedAt), notInArray(tSessions.fSessionId, archived))));
 				const stamp = Date.now();
-				for (const sessionId of archived) await runQuery(db.update(tSessions).set({ fArchivedAt: sql`COALESCE(${tSessions.fArchivedAt}, ${stamp})` }).where(eq(tSessions.fSessionId, sessionId)));
+				for (const sessionId of archived) await runQuery(db.insert(tSessions).values({
+					fSessionId: sessionId,
+					fHeadEventId: "",
+					fHeadSequence: -1,
+					fVersion: SESSION_FORMAT_VERSION,
+					fCreatedAt: stamp,
+					fCwd: null,
+					fParentSession: null,
+					fSeedLength: null,
+					fOrigin: null,
+					fDelegationDepth: null,
+					fIncarnation: randomUUID(),
+					fRevision: 0,
+					fArchivedAt: stamp
+				}).onConflictDoUpdate({
+					target: tSessions.fSessionId,
+					set: { fArchivedAt: sql`COALESCE(${tSessions.fArchivedAt}, ${stamp})` }
+				}));
 			});
 		},
 		async loadProjcache() {
@@ -881,8 +898,12 @@ function createStorageRepository(host) {
 				if (values.length > 0) await runQuery(db.insert(tProjcacheRows).values(values));
 			});
 		},
-		async deleteProjcache(sessionId) {
-			await runQuery((await dbx()).delete(tProjcacheRows).where(eq(tProjcacheRows.fSessionId, sessionId)));
+		async pruneStaleProjcache() {
+			const db = await dbx();
+			const stale = await allRows(db.select({ fSessionId: tProjcacheRows.fSessionId }).from(tProjcacheRows).where(and(lt(tProjcacheRows.fSeq, 0), inArray(tProjcacheRows.fSessionId, db.select({ fSessionId: tSessions.fSessionId }).from(tSessions).where(gte(tSessions.fHeadSequence, 0))))));
+			if (stale.length === 0) return 0;
+			await runQuery(db.delete(tProjcacheRows).where(inArray(tProjcacheRows.fSessionId, stale.map((row) => row.fSessionId))));
+			return stale.length;
 		},
 		...host.dbSync === void 0 ? {} : {
 			readProjcacheSync: (sessionId) => {

package/dist/storage.d.mts

@@ -1,4 +1,4 @@
-import { C as EventRow, S as BackendTx, T as StorageRepository, _ as tWorkspaceSessions, a as JournalMode, b as WriteGuard, c as eventDimensions, d as tPersistenceState, f as tSchemaMeta, g as tStorageUnits, h as tSessions, i as EventRole, l as eventKind, m as tSessionProjcacheRows, n as EVENT_ENCODING, o as SCHEMA_VERSION, p as tSessionEvents, r as EventKind, s as SESSION_PERSISTENCE_SQLITE_APPLICATION_ID, t as DEFAULT_BUSY_TIMEOUT_MS, u as tEvents, v as tWorkspaceState, w as SessionRow, x as Backend, y as tWorkspaces } from "./schema-Bo6Hy5gW.mjs";
+import { C as EventRow, S as BackendTx, T as StorageRepository, _ as tWorkspaceSessions, a as JournalMode, b as WriteGuard, c as eventDimensions, d as tPersistenceState, f as tSchemaMeta, g as tStorageUnits, h as tSessions, i as EventRole, l as eventKind, m as tSessionProjcacheRows, n as EVENT_ENCODING, o as SCHEMA_VERSION, p as tSessionEvents, r as EventKind, s as SESSION_PERSISTENCE_SQLITE_APPLICATION_ID, t as DEFAULT_BUSY_TIMEOUT_MS, u as tEvents, v as tWorkspaceState, w as SessionRow, x as Backend, y as tWorkspaces } from "./schema-BkQN5GyT.mjs";
 import { SessionId } from "@deepseek-ai/dsh-session";
 import { DatabaseSync } from "node:sqlite";
 //#region src/sqlite.d.ts

package/dist/storage.mjs

@@ -1,2 +1,2 @@
-import { S as WriteGuard, _ as tWorkspaceSessions, a as EVENT_ENCODING, c as eventDimensions, d as tPersistenceState, f as tSchemaMeta, g as tStorageUnits, h as tSessions, i as DEFAULT_BUSY_TIMEOUT_MS, l as eventKind, m as tSessionProjcacheRows, n as openDatabase, o as SCHEMA_VERSION, p as tSessionEvents, s as SESSION_PERSISTENCE_SQLITE_APPLICATION_ID, t as SqliteBackend, u as tEvents, v as tWorkspaceState, y as tWorkspaces } from "./sqlite-BIPdMNQb.mjs";
+import { S as WriteGuard, _ as tWorkspaceSessions, a as EVENT_ENCODING, c as eventDimensions, d as tPersistenceState, f as tSchemaMeta, g as tStorageUnits, h as tSessions, i as DEFAULT_BUSY_TIMEOUT_MS, l as eventKind, m as tSessionProjcacheRows, n as openDatabase, o as SCHEMA_VERSION, p as tSessionEvents, s as SESSION_PERSISTENCE_SQLITE_APPLICATION_ID, t as SqliteBackend, u as tEvents, v as tWorkspaceState, y as tWorkspaces } from "./sqlite-DYExtbLo.mjs";
 export { DEFAULT_BUSY_TIMEOUT_MS, EVENT_ENCODING, SCHEMA_VERSION, SESSION_PERSISTENCE_SQLITE_APPLICATION_ID, SqliteBackend, WriteGuard, eventDimensions, eventKind, openDatabase, tEvents, tPersistenceState, tSchemaMeta, tSessionEvents, tSessionProjcacheRows, tSessions, tStorageUnits, tWorkspaceSessions, tWorkspaceState, tWorkspaces };