@deepseek-ai/dsh-session-query-sqlite 0.1.2-alpha.3 → 0.1.2-alpha.5

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/session-query/session-query-sqlite/README.md
-README.md: 96ad49d6b14b38849ad800e5802ecdc78344bdc8
-README.zh.md: 241f652bb85cc4a8bee489babd699522e3236b3c
+README.md: 1db3999186beebc10a6a3c6874122fa65f2787a3
+README.zh.md: f6ef419293ab0df3a3edfd171cc60bc62ee4bcb0

package/README.md

@@ -97,11 +97,11 @@ The design history lives in the [SQLite FTS5 session search note](../../../.agen
 | [`src/index.ts`](src/index.ts) | Service: config, openAt lifecycle, serialized reconciliation, query execution, cursors |
 | [`src/query.ts`](src/query.ts) | Request normalization, parameterized predicates, snippets, predicate and binding budgets |
 | [`src/schema.ts`](src/schema.ts) | Database schema, application-id ownership, in-place reset, owner-only file creation |
-| [`src/invariant.ts`](src/invariant.ts) | Invariant companion (no runtime invariant; boundaries are validated per serialized query) |
+| — | No runtime invariant companion is published; reconciliation, cursor generations, and derived-index ownership are validated at each serialized query boundary. |
 
 ### Index lifecycle
 
-Persisted FTS rows live in a dedicated derived database and survive restarts; live sessions use connection-local TEMP tables that shadow the durable base for the same session and reveal it again when the live owner detaches. Each search runs one serialized observation: list persistence snapshots, compare per-session revisions with the indexed rows, inspect only new or changed logs, extract semantic documents, and commit the reconciliation in one transaction before running the query. Repeated queries and unchanged reopens inspect nothing; switching stores or observing new, changed, deleted, or externally repaired sources reconciles on the next stable observation. Source or transaction failure commits nothing and the next search retries.
+Persisted FTS rows live in a dedicated derived database and survive restarts; live sessions use connection-local TEMP tables that shadow the durable base for the same session and reveal it again when the live owner detaches. Both tables retain the exact inherited cut in numeric `seed_length`; reconstructed headers expose only `isSeeded`, while the cut participates in live fingerprints and persisted source revisions. Each search runs one serialized observation: list persistence snapshots, compare per-session revisions with the indexed rows, inspect only new or changed logs, extract semantic documents, and commit the reconciliation in one transaction before running the query. Repeated queries and unchanged reopens inspect nothing; switching stores or observing new, changed, deleted, or externally repaired sources reconciles on the next stable observation. Source or transaction failure commits nothing and the next search retries.
 
 ### Schema ownership
 

package/README.zh.md

@@ -97,11 +97,11 @@ kind: "package-reference"
 | [`src/index.ts`](src/index.ts) | 服务：配置、openAt 生命周期、串行化对账、查询执行、游标 |
 | [`src/query.ts`](src/query.ts) | 请求规范化、参数化谓词、摘录、谓词与绑定预算 |
 | [`src/schema.ts`](src/schema.ts) | 数据库 schema、application id 归属、原地重置、仅所有者文件创建 |
-| [`src/invariant.ts`](src/invariant.ts) | 不变式伴生插件（无运行时不变式；边界在每次串行化查询时校验） |
+| — | 不发布运行时不变式伴生入口；边界在每次串行化查询时校验。 |
 
 ### 索引生命周期
 
-持久化 FTS 行存放在专用派生数据库中并跨重启保留；实时会话使用连接本地 TEMP 表，遮蔽同一会话的持久化基库，并在实时所有者脱离后再次显示基库。每次搜索执行一次串行化观察：列出持久化快照、把逐会话修订与已索引行比较、只检查新增或已更改日志、提取语义文档，并在运行查询前于一个事务中提交对账。重复查询与不变的重新打开不会检查任何内容；切换存储或观察到新增、已更改、已删除或经外部修复的来源时，会在下次稳定观察时对账。来源或事务失败不提交任何内容，下一次搜索重试。
+持久化 FTS 行存放在专用派生数据库中并跨重启保留；实时会话使用连接本地 TEMP 表，遮蔽同一会话的持久化基库，并在实时所有者脱离后再次显示基库。两类表都在数字 `seed_length` 中保留精确继承切点；重建的 header 只公开 `isSeeded`，而切点参与实时 fingerprint 与持久来源修订。每次搜索执行一次串行化观察：列出持久化快照、把逐会话修订与已索引行比较、只检查新增或已更改日志、提取语义文档，并在运行查询前于一个事务中提交对账。重复查询与不变的重新打开不会检查任何内容；切换存储或观察到新增、已更改、已删除或经外部修复的来源时，会在下次稳定观察时对账。来源或事务失败不提交任何内容，下一次搜索重试。
 
 ### Schema 归属
 

package/lib/index.js

@@ -1,6 +1,7 @@
 import { createHash, randomUUID } from "node:crypto";
 import { Service } from "@deepseek-ai/cordis";
 import z from "@deepseek-ai/schemastery";
+import { SessionSeq } from "@deepseek-ai/dsh-session";
 import SessionQueryEngine, { SESSION_QUERY_DEFAULT_PERSISTED_INSPECT_CONCURRENCY, SESSION_QUERY_READ_WINDOW_MAX, SessionQueryError, SessionSearchCursor, assertSessionHeadersCompatible, buildSessionEventSearchDocuments, materializeSessionEventResultFilters, materializeSessionResultFilters } from "@deepseek-ai/dsh-session-query";
 import { mkdir, open } from "node:fs/promises";
 import { dirname, resolve } from "node:path";
@@ -721,7 +722,7 @@ var SqliteSessionQueryEngine = class extends SessionQueryEngine {
 					const loaded = await persistence.inspect(entry.header.id, signal);
 					assertNotAborted(signal);
 					assertSessionHeadersCompatible(entry.header, loaded.meta);
-					entry.loaded = observeSession(loaded.meta, loaded.events);
+					entry.loaded = observeSession(loaded.meta, loaded.inheritedEventCount, loaded.events);
 				}
 				assertNotAborted(signal);
 				const afterSnapshots = await persistence.listSnapshots(signal);
@@ -771,7 +772,7 @@ var SqliteSessionQueryEngine = class extends SessionQueryEngine {
       INSERT INTO persisted_sessions
         (id, version, created_at, cwd, parent_session, seed_length, delegation_depth, agent_preset, revision, generation)
       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `).run(...headerBindings(entry.header), revision, generation);
+    `).run(...headerBindings(entry.header, entry.inheritedEventCount), revision, generation);
 		const insert = db.prepare(`
       INSERT INTO persisted_docs (text, session_id, seq, type, time, surface, codepoint_length)
       VALUES (?, ?, ?, ?, ?, ?, ?)
@@ -788,7 +789,7 @@ var SqliteSessionQueryEngine = class extends SessionQueryEngine {
       INSERT INTO temp.live_sessions
         (id, version, created_at, cwd, parent_session, seed_length, delegation_depth, agent_preset, fingerprint, persisted, generation)
       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `).run(...headerBindings(entry.header), entry.fingerprint, persisted ? 1 : 0, generation);
+    `).run(...headerBindings(entry.header, entry.inheritedEventCount), entry.fingerprint, persisted ? 1 : 0, generation);
 		const insert = db.prepare(`
       INSERT INTO temp.live_docs (text, session_id, seq, type, time, surface, codepoint_length)
       VALUES (?, ?, ?, ?, ?, ?, ?)
@@ -884,7 +885,7 @@ var SqliteSessionQueryEngine = class extends SessionQueryEngine {
 	_eventHit(row) {
 		return {
 			sessionId: row.session_id,
-			seq: row.seq,
+			seq: SessionSeq(row.seq),
 			type: row.type,
 			time: row.time,
 			surface: row.surface,
@@ -906,14 +907,14 @@ var SqliteSessionQueryEngine = class extends SessionQueryEngine {
 * @param header - the session header being written.
 * @returns one bound value per header column.
 */
-function headerBindings(header) {
+function headerBindings(header, inheritedEventCount) {
 	return [
 		header.id,
 		header.version,
 		header.createdAt,
 		header.cwd ?? null,
 		header.parentSession ?? null,
-		header.seedLength ?? null,
+		header.isSeeded ? inheritedEventCount : null,
 		header.delegationDepth ?? null,
 		header.agentPreset ?? null
 	];
@@ -989,16 +990,18 @@ function selectedDocumentsParams(query, persistenceVisible) {
 	];
 }
 function observeLive(session) {
-	return observeSession(session.header, session.events);
+	return observeSession(session.header, session.inheritedEventCount, session.snapshotEvents());
 }
-function observeSession(header, events) {
+function observeSession(header, inheritedEventCount, events) {
 	const detachedHeader = structuredClone(header);
 	const detachedEvents = events.map((event) => structuredClone(event));
 	return {
 		header: detachedHeader,
+		inheritedEventCount,
 		documents: buildSessionEventSearchDocuments(detachedHeader.id, detachedEvents),
 		fingerprint: createHash("sha256").update(JSON.stringify({
 			header: detachedHeader,
+			inheritedEventCount,
 			events: detachedEvents
 		})).digest("base64url")
 	};
@@ -1031,7 +1034,7 @@ function sameSessionIds(before, after) {
 	return true;
 }
 function sameHeader(a, b) {
-	return a.version === b.version && a.id === b.id && a.createdAt === b.createdAt && a.cwd === b.cwd && a.parentSession === b.parentSession && a.seedLength === b.seedLength && (a.delegationDepth ?? 0) === (b.delegationDepth ?? 0) && a.agentPreset === b.agentPreset;
+	return a.version === b.version && a.id === b.id && a.createdAt === b.createdAt && a.cwd === b.cwd && a.parentSession === b.parentSession && a.isSeeded === b.isSeeded && (a.delegationDepth ?? 0) === (b.delegationDepth ?? 0) && a.agentPreset === b.agentPreset;
 }
 function rowHeader(row) {
 	return {
@@ -1040,7 +1043,7 @@ function rowHeader(row) {
 		createdAt: row.created_at,
 		...row.cwd === null ? {} : { cwd: row.cwd },
 		...row.parent_session === null ? {} : { parentSession: row.parent_session },
-		...row.seed_length === null ? {} : { seedLength: row.seed_length },
+		isSeeded: row.seed_length !== null,
 		...row.delegation_depth === null ? {} : { delegationDepth: row.delegation_depth },
 		...row.agent_preset === null ? {} : { agentPreset: row.agent_preset }
 	};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-session-query-sqlite",
   "description": "Concrete ctx.sessionQuery backend with SQLite FTS5 search",
-  "version": "0.1.2-alpha.3",
+  "version": "0.1.2-alpha.5",
   "publishConfig": {
     "access": "public"
   },
@@ -18,24 +18,18 @@
       "types": "./lib/types/index.d.ts",
       "default": "./lib/index.js"
     },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/invariant.js"
-    },
     "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
   "files": [
     "lib/index.js",
-    "lib/invariant.js",
     "lib/types/**/*.d.ts"
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-session-query": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-session-query": "^0.1.2-alpha.5",
     "@deepseek-ai/cordis": "^4.0.2"
   },
   "peerDependenciesMeta": {
@@ -47,13 +41,12 @@
     "@deepseek-ai/schemastery": "^3.18.2"
   },
   "devDependencies": {
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-session-persistence": "^0.1.2-alpha.5",
     "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-session-persistence": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-session-persistence-jsonl": "^0.1.2-alpha.3",
-    "@deepseek-ai/dsh-session-query": "^0.1.2-alpha.3",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-session-projection": "^0.1.2-alpha.3"
+    "@deepseek-ai/dsh-session-persistence-jsonl": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-session-query": "^0.1.2-alpha.5",
+    "@deepseek-ai/dsh-session-projection": "^0.1.2-alpha.5",
+    "@deepseek-ai/cordis": "^4.0.2"
   }
 }

package/lib/invariant.js

@@ -1,23 +0,0 @@
-//#region lib/types/invariant.js
-/**
-* Package-owned invariant companion for `@deepseek-ai/dsh-session-query-sqlite`.
-* @module @deepseek-ai/dsh-session-query-sqlite/invariant
-*/
-const PACKAGE_NAME = "@deepseek-ai/dsh-session-query-sqlite";
-/** Cordis companion plugin name. */
-const name = "session-query-sqlite-invariant";
-/** Service required before the companion can reserve package ownership. */
-const inject = ["invariants"];
-/**
-* No runtime invariant: reconciliation, cursor generations, and derived-index
-* ownership are validated at each serialized query boundary.
-*/
-const install = () => {};
-/**
-* Register this package's invariant companion.
-* @param ctx - Cordis context carrying the invariant service.
-* @returns the installed registration's disposer after setup succeeds.
-*/
-const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
-//#endregion
-export { apply, inject, name };

package/lib/types/invariant.d.ts

@@ -1,16 +0,0 @@
-/**
- * Package-owned invariant companion for `@deepseek-ai/dsh-session-query-sqlite`.
- * @module @deepseek-ai/dsh-session-query-sqlite/invariant
- */
-import type { Context } from '@deepseek-ai/cordis';
-/** Cordis companion plugin name. */
-export declare const name = "session-query-sqlite-invariant";
-/** Service required before the companion can reserve package ownership. */
-export declare const inject: string[];
-/**
- * Register this package's invariant companion.
- * @param ctx - Cordis context carrying the invariant service.
- * @returns the installed registration's disposer after setup succeeds.
- */
-export declare const apply: (ctx: Context) => Promise<() => void>;
-//# sourceMappingURL=invariant.d.ts.map