@whispering233/ai-editor-db 0.0.1

package/dist/connection.d.ts

@@ -0,0 +1,24 @@
+import Database from "better-sqlite3";
+/** better-sqlite3 连接实例类型 */
+export type Db = Database.Database;
+/**
+ * 打开（或创建）data.db 并初始化：
+ * 1. better-sqlite3 打开指定路径（文件不存在则创建）
+ * 2. WAL 模式（journal_mode 为数据库持久属性，重复设置幂等）
+ * 3. synchronous = FULL：每个事务提交后 WAL 落盘（fsync），写入即时持久化
+ * 4. 自动建表（CREATE TABLE IF NOT EXISTS，表不存在时创建）
+ */
+export declare function openDatabase(path: string): Db;
+/** 关闭数据库连接（同步 API，close 后该连接不可再用；幂等：已关闭则直接返回） */
+export declare function closeDatabase(db: Db): void;
+/**
+ * 事务辅助：fn 正常返回则提交并返回其结果；fn 内任一语句抛错则整体回滚、异常向上传播。
+ *
+ * 基于 better-sqlite3 的 db.transaction（内部自动处理 BEGIN/COMMIT/ROLLBACK，
+ * 嵌套调用自动升级为 SAVEPOINT）。
+ *
+ * 注意：better-sqlite3 事务是同步语义——fn 必须是同步函数；若在异步回调内抛错，
+ * 事务已在同步流程结束后提交，错误无法触发回滚。
+ */
+export declare function withTransaction<T>(db: Db, fn: () => T): T;
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAKA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,4BAA4B;AAC5B,MAAM,MAAM,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC;AAEnC;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,EAAE,CAM7C;AAED,iDAAiD;AACjD,wBAAgB,aAAa,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAI1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEzD"}

package/dist/connection.js

@@ -0,0 +1,39 @@
+// @whispering233/ai-editor-db 连接与事务管理（T2.1）
+//
+// better-sqlite3 为同步 API（架构选型：内嵌零配置、同步简单可靠，见 doc/design/architecture.md 第 11 行）。
+// 持久化语义（doc/api/data-flow.md 第 51 行）：WAL 模式 + synchronous=FULL，写入即时落盘。
+import Database from "better-sqlite3";
+import { createTables } from "./schema.js";
+/**
+ * 打开（或创建）data.db 并初始化：
+ * 1. better-sqlite3 打开指定路径（文件不存在则创建）
+ * 2. WAL 模式（journal_mode 为数据库持久属性，重复设置幂等）
+ * 3. synchronous = FULL：每个事务提交后 WAL 落盘（fsync），写入即时持久化
+ * 4. 自动建表（CREATE TABLE IF NOT EXISTS，表不存在时创建）
+ */
+export function openDatabase(path) {
+    const db = new Database(path);
+    db.pragma("journal_mode = WAL");
+    db.pragma("synchronous = FULL");
+    createTables(db);
+    return db;
+}
+/** 关闭数据库连接（同步 API，close 后该连接不可再用；幂等：已关闭则直接返回） */
+export function closeDatabase(db) {
+    if (db.open) {
+        db.close();
+    }
+}
+/**
+ * 事务辅助：fn 正常返回则提交并返回其结果；fn 内任一语句抛错则整体回滚、异常向上传播。
+ *
+ * 基于 better-sqlite3 的 db.transaction（内部自动处理 BEGIN/COMMIT/ROLLBACK，
+ * 嵌套调用自动升级为 SAVEPOINT）。
+ *
+ * 注意：better-sqlite3 事务是同步语义——fn 必须是同步函数；若在异步回调内抛错，
+ * 事务已在同步流程结束后提交，错误无法触发回滚。
+ */
+export function withTransaction(db, fn) {
+    return db.transaction(fn)();
+}
+//# sourceMappingURL=connection.js.map

package/dist/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,EAAE;AACF,iFAAiF;AACjF,uEAAuE;AAEvE,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,aAAa,CAAC,EAAM;IAClC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;QACZ,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAI,EAAM,EAAE,EAAW;IACpD,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;AAC9B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export * from "./schema.js";
+export * from "./connection.js";
+export * from "./storage/atomic.js";
+export * from "./storage/outline.js";
+export * from "./storage/project.js";
+export * from "./queries/chat.js";
+export * from "./queries/migration.js";
+export * from "./migrations/index.js";
+export * from "./queries/outline-ops.js";
+export * from "./queries/entity.js";
+export * from "./queries/relation.js";
+export * from "./queries/delta.js";
+export * from "./queries/compute-state.js";
+export * from "./queries/trash.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+// @whispering233/ai-editor-db 入口：导出建表（schema）、连接（connection）、对话历史查询（queries/chat）与
+// JSON 存储（storage/：outline.json / project.json 原子读写，T2.2）、增量迁移（migrations/，E5）
+export * from "./schema.js";
+export * from "./connection.js";
+export * from "./storage/atomic.js";
+export * from "./storage/outline.js";
+export * from "./storage/project.js";
+export * from "./queries/chat.js";
+export * from "./queries/migration.js";
+export * from "./migrations/index.js";
+export * from "./queries/outline-ops.js";
+export * from "./queries/entity.js";
+export * from "./queries/relation.js";
+export * from "./queries/delta.js";
+export * from "./queries/compute-state.js";
+export * from "./queries/trash.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,+EAA+E;AAC/E,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC"}

package/dist/migrations/index.d.ts

@@ -0,0 +1,10 @@
+import type { Db } from "../connection.js";
+/** 单条增量迁移（version = 迁移完成后 data.db 的 user_version） */
+export interface Migration {
+    version: number;
+    /** 迁移逻辑（DDL/数据变更）；抛错 → 该迁移事务整体回滚，版本号不变 */
+    up: (db: Db) => void;
+}
+/** 全量迁移集（按 version 升序；SCHEMA_VERSION = 1 当前为空） */
+export declare const MIGRATIONS: readonly Migration[];
+//# sourceMappingURL=index.d.ts.map

package/dist/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAgCA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAE3C,qDAAqD;AACrD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,0CAA0C;IAC1C,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,IAAI,CAAC;CACtB;AAED,kDAAkD;AAClD,eAAO,MAAM,UAAU,EAAE,SAAS,SAAS,EAAO,CAAC"}

package/dist/migrations/index.js

@@ -0,0 +1,34 @@
+// 增量迁移脚本目录（E5：release-review §一 建议动作 2）
+//
+// **形态**：每个迁移一个 TS 文件（001_xxx.ts → version 1、002_xxx.ts → version 2...），
+// 文件内 `export default { version, up }` 形态的 Migration 对象；本目录 index.ts 按
+// version 升序聚合导出 MIGRATIONS（tsc 编译进 dist 随包分发，无运行时目录读取——
+// 迁移集在构建期冻结，避免「读目录顺序不稳定/漏文件」的运行时不确定性）。
+//
+// **version 语义**：迁移完成后 data.db 的 user_version（`setUserVersion(m.version)`）。
+// 从 v=N 库升级到 v=N+1 的迁移条目 version = N+1（SCHEMA_VERSION 即目标版本）。
+//
+// **写法示例**（首个真实迁移（SCHEMA_VERSION 提升到 2 时）加入）：
+// ```ts
+// import type { Db } from "../connection.js";
+// import type { Migration } from "./index.js";
+// export default {
+//   version: 2,
+//   up: (db: Db) => {
+//     // DDL/数据变更（better-sqlite3 同步 API；抛错 → 该迁移整体回滚）
+//     db.exec("ALTER TABLE entities ADD COLUMN note TEXT");
+//   },
+// } satisfies Migration;
+// ```
+//
+// **执行语义**（runMigrations，见 queries/migration.ts）：
+// - 按 version 升序逐个执行，每个迁移一个事务（up + setUserVersion 原子提交）
+// - 整批迁移前自动快照 data.db（`data.db.v{n}.{时间戳}.bak`，不覆盖旧备份）
+// - 失败 → 该迁移回滚 + 版本停在前一迁移后，下次 open 重试
+// - 无迁移路径的旧版本（如 v0 且无 0→1 条目）保持删库重建兜底（决策 13）
+//
+// **当前状态**：SCHEMA_VERSION = 1 且无历史版本 → 数组为空（机制已就绪，
+// 首个真实条目在未来的 schema 变更时加入）。
+/** 全量迁移集（按 version 升序；SCHEMA_VERSION = 1 当前为空） */
+export const MIGRATIONS = [];
+//# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,EAAE;AACF,yEAAyE;AACzE,uEAAuE;AACvE,yDAAyD;AACzD,uCAAuC;AACvC,EAAE;AACF,4EAA4E;AAC5E,8DAA8D;AAC9D,EAAE;AACF,8CAA8C;AAC9C,QAAQ;AACR,8CAA8C;AAC9C,+CAA+C;AAC/C,mBAAmB;AACnB,gBAAgB;AAChB,sBAAsB;AACtB,sDAAsD;AACtD,4DAA4D;AAC5D,OAAO;AACP,yBAAyB;AACzB,MAAM;AACN,EAAE;AACF,kDAAkD;AAClD,wDAAwD;AACxD,uDAAuD;AACvD,sCAAsC;AACtC,6CAA6C;AAC7C,EAAE;AACF,mDAAmD;AACnD,4BAA4B;AAW5B,kDAAkD;AAClD,MAAM,CAAC,MAAM,UAAU,GAAyB,EAAE,CAAC"}

package/dist/queries/atomic.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 原子写 JSON 文件（决策 11）：
+ * 1. 写同目录临时文件 `{filePath}.tmp`（writeSync 到已打开的 fd）
+ * 2. fsync 数据落盘（保证 rename 后文件内容完整，崩溃不产生半写文件）
+ * 3. rename 覆盖目标文件（同文件系统内原子操作）
+ *
+ * 任一步抛错：原文件保持完好；临时文件可能残留（由调用方/启动清理兜底）。
+ */
+export declare function writeJsonAtomic(filePath: string, data: unknown): void;
+/**
+ * 读取 JSON 文件：文件不存在返回 null，存在则 JSON.parse 并返回（parse 失败抛错，不静默吞）。
+ * 用于 loadOutlineFile / loadProjectFile 的统一入口。
+ */
+export declare function readJsonFile<T>(filePath: string): T | null;
+//# sourceMappingURL=atomic.d.ts.map

package/dist/queries/atomic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic.d.ts","sourceRoot":"","sources":["../../src/queries/atomic.ts"],"names":[],"mappings":"AAOA;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAWrE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAW1D"}

package/dist/queries/atomic.js

@@ -0,0 +1,44 @@
+// @ai-editor/db JSON 文件原子读写辅助（T2.2）
+// 决策 11：outline.json / project.json 保存必须「写临时文件 → fsync → rename 覆盖」，
+// 保证崩溃/断电时磁盘上要么是旧文件要么是新文件；禁止直接覆盖写。
+// 时间约定（schema.md 第 16 行）：时间字段由应用层写入 ISO 8601，本模块只负责文件 I/O。
+import { closeSync, fsyncSync, openSync, readFileSync, renameSync, writeSync } from "node:fs";
+/**
+ * 原子写 JSON 文件（决策 11）：
+ * 1. 写同目录临时文件 `{filePath}.tmp`（writeSync 到已打开的 fd）
+ * 2. fsync 数据落盘（保证 rename 后文件内容完整，崩溃不产生半写文件）
+ * 3. rename 覆盖目标文件（同文件系统内原子操作）
+ *
+ * 任一步抛错：原文件保持完好；临时文件可能残留（由调用方/启动清理兜底）。
+ */
+export function writeJsonAtomic(filePath, data) {
+    const tmpPath = `${filePath}.tmp`;
+    const content = `${JSON.stringify(data, null, 2)}\n`;
+    const fd = openSync(tmpPath, "w");
+    try {
+        writeSync(fd, content);
+        fsyncSync(fd);
+    }
+    finally {
+        closeSync(fd);
+    }
+    renameSync(tmpPath, filePath);
+}
+/**
+ * 读取 JSON 文件：文件不存在返回 null，存在则 JSON.parse 并返回（parse 失败抛错，不静默吞）。
+ * 用于 loadOutlineFile / loadProjectFile 的统一入口。
+ */
+export function readJsonFile(filePath) {
+    let raw;
+    try {
+        raw = readFileSync(filePath, "utf8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            return null;
+        }
+        throw err;
+    }
+    return JSON.parse(raw);
+}
+//# sourceMappingURL=atomic.js.map

package/dist/queries/atomic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic.js","sourceRoot":"","sources":["../../src/queries/atomic.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,qEAAqE;AACrE,mCAAmC;AACnC,2DAA2D;AAE3D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAE9F;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAa;IAC7D,MAAM,OAAO,GAAG,GAAG,QAAQ,MAAM,CAAC;IAClC,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IACrD,MAAM,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC;QACH,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACvB,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,EAAE,CAAC,CAAC;IAChB,CAAC;IACD,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAI,QAAgB;IAC9C,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;AAC9B,CAAC"}

package/dist/queries/chat.d.ts

@@ -0,0 +1,74 @@
+import { type ChatMessage, type ChatMessageRow, type ChatRole, type ChatSessionSummary } from "@whispering233/ai-editor-shared";
+import type { Db } from "../connection.js";
+/** 会话列表 lastMessage 截断长度（endpoints.md 仅要求「截断」，长度为本实现约定，未入文档契约） */
+export declare const SESSION_LAST_MESSAGE_MAX_LEN = 50;
+/**
+ * 插入一条对话消息。
+ *
+ * id 生成约定：chat_messages 表 id 无文档前缀（endpoints.md id 约定仅覆盖
+ * char-/set-/loc-/hook-、sc-/ch-/vol-、proj- 与运行时 prop_/sess_/call_），
+ * 省略 id 时直接用 nanoid 生成（与消息 id 前缀空缺保持一致）。
+ *
+ * 存储形态转换：row.tool_calls 按 shared 类型契约为「解析后的数组」，
+ * 本函数负责 JSON.stringify 落库（列存 TEXT）；created_at 必须由调用方
+ * 提供 ISO 8601 字符串（应用层写入，决策 18）。
+ */
+export declare function insertChatMessage(db: Db, row: Pick<ChatMessageRow, "session_id" | "project_id" | "role" | "created_at"> & Partial<Pick<ChatMessageRow, "id" | "content" | "tool_calls" | "tool_call_id">>): void;
+/**
+ * 会话列表（GET /api/v1/chat/sessions）：
+ * - 按 project_id 隔离（决策 18 修订：会话按项目隔离）
+ * - 仅返回含消息的会话；updatedAt = 该会话最后一条消息的 created_at
+ * - 按最后活动时间（updatedAt）倒序，同时间戳按 session_id 升序保证稳定
+ * - lastMessage = 最后一条消息的 content 截断（无 content 时为空串）
+ */
+export declare function listSessions(db: Db, projectId: string): ChatSessionSummary[];
+/**
+ * 解析 chat_messages.tool_calls 的 JSON 文本列为数组（ChatMessage.toolCalls）。
+ * 防御性处理：NULL / 非法 JSON / 非数组一律返回 null（视为无工具调用）。
+ */
+export declare function parseToolCalls(json: string | null): unknown[] | null;
+/**
+ * 消息历史（GET /api/v1/chat/sessions/:id/messages）：
+ * - 按 project_id 隔离（决策 18 修订）
+ * - 按 created_at 升序，同时间戳按 rowid（插入序）升序保证稳定
+ * - 存储形态 → API 形态：tool_calls JSON 解析、tool_call_id → toolCallId、snake_case → camelCase
+ */
+export declare function listMessages(db: Db, sessionId: string, projectId: string): ChatMessage[];
+/**
+ * 消息历史原始行（S7.6 续聊重建专用）：
+ * - listMessages 输出 API 形态（camelCase，供 GET /messages）；本函数输出**存储形态**
+ *   （snake_case ChatMessageRow，tool_calls 已解析为数组）——直供 agent 包
+ *   loadHistory/restoreSession（决策 18 成对重组），避免 server 层做 API→存储形态反映射。
+ * - 查询语义与 listMessages 一致：按 project_id 隔离、created_at 升序 + rowid 稳定序。
+ */
+export declare function listMessageRows(db: Db, sessionId: string, projectId: string): ChatMessageRow[];
+/** 成对重组后喂给 LLM 的历史消息形态（决策 18 修订：DeepSeek 要求 tool_call 与 tool 结果严格配对） */
+export interface ReassembledChatMessage {
+    role: ChatRole;
+    content?: string | null;
+    /** assistant 消息的工具调用数组（仅当该组全部调用均成对成功时保留） */
+    toolCalls?: unknown[];
+    /** tool 消息关联的调用 id（与所属 assistant 消息 tool_calls[].id 配对） */
+    toolCallId?: string | null;
+}
+/**
+ * 成对重组历史消息（决策 18 修订：assistant.tool_calls[].id ↔ tool.tool_call_id 成对重组喂回模型）。
+ *
+ * 用途：服务重启后凭 session_id 重建「继续上次对话」上下文，或会话级滑动窗口裁剪前的重组。
+ * 注意：本函数是纯函数，输入为 ChatMessageRow（tool_calls 已按 shared 类型契约为解析后的数组，
+ * 由调用方先经 parseToolCalls / 直接构造）。
+ *
+ * 算法：
+ * 1. 按 created_at 升序稳定排序（同时间戳保持输入顺序）
+ * 2. 第一遍收集 tool 消息：tool_call_id → content（同一 id 多条结果取最先到达者，防御性处理）
+ * 3. 第二遍顺序扫描：
+ *    - user 消息：原样保留
+ *    - assistant 消息（无 tool_calls）：原样保留
+ *    - assistant 消息（有 tool_calls）：逐个调用校验——任一调用缺 id 或缺对应 tool 结果
+ *      即判定为孤儿半对，该 assistant 消息与其工具结果**整组丢弃**（决策 18 修订：
+ *      孤儿半对整对丢弃，不返回 409 也不部分保留）；全部配对成功则输出 assistant 消息，
+ *      工具结果按 tool_calls 数组顺序紧随其后（tool 消息保留 toolCallId 供模型配对）
+ *    - tool 消息：不单独输出——未被任何保留的 assistant 消息引用的即孤儿，整对丢弃
+ */
+export declare function reassembleMessages(rows: ChatMessageRow[]): ReassembledChatMessage[];
+//# sourceMappingURL=chat.d.ts.map

package/dist/queries/chat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../src/queries/chat.ts"],"names":[],"mappings":"AASA,OAAO,EAAY,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,KAAK,QAAQ,EAAE,KAAK,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAC1I,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAE3C,kEAAkE;AAClE,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,EAAE,EACN,GAAG,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,YAAY,GAAG,MAAM,GAAG,YAAY,CAAC,GAC5E,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,SAAS,GAAG,YAAY,GAAG,cAAc,CAAC,CAAC,GAChF,IAAI,CAcN;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAqC5E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,EAAE,GAAG,IAAI,CASpE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CA6BxF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE,CAsB9F;AAED,wEAAwE;AACxE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;IACtB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,sBAAsB,EAAE,CAwCnF"}

package/dist/queries/chat.js

@@ -0,0 +1,188 @@
+// @whispering233/ai-editor-db 对话历史数据层查询（T2.3）
+//
+// 单一事实来源：doc/database/schema.md（chat_messages 表结构，决策 18）、
+// doc/api/endpoints.md（chat/sessions 会话列表、chat/sessions/:id/messages 消息历史）。
+// 时间约定（schema.md 第 16 行）：created_at 统一 ISO 8601 字符串、由应用层写入，本模块不生成时间。
+// 注意：本模块只处理 chat_messages 表，不涉及会话元数据——会话列表信息（createdAt/updatedAt/
+// messageCount/lastMessage）全部由消息行实时聚合得出，无独立会话表。
+import { nanoid } from "nanoid";
+import { truncate } from "@whispering233/ai-editor-shared";
+/** 会话列表 lastMessage 截断长度（endpoints.md 仅要求「截断」，长度为本实现约定，未入文档契约） */
+export const SESSION_LAST_MESSAGE_MAX_LEN = 50;
+/**
+ * 插入一条对话消息。
+ *
+ * id 生成约定：chat_messages 表 id 无文档前缀（endpoints.md id 约定仅覆盖
+ * char-/set-/loc-/hook-、sc-/ch-/vol-、proj- 与运行时 prop_/sess_/call_），
+ * 省略 id 时直接用 nanoid 生成（与消息 id 前缀空缺保持一致）。
+ *
+ * 存储形态转换：row.tool_calls 按 shared 类型契约为「解析后的数组」，
+ * 本函数负责 JSON.stringify 落库（列存 TEXT）；created_at 必须由调用方
+ * 提供 ISO 8601 字符串（应用层写入，决策 18）。
+ */
+export function insertChatMessage(db, row) {
+    db.prepare(`INSERT INTO chat_messages (id, session_id, project_id, role, content, tool_calls, tool_call_id, created_at)
+     VALUES (@id, @session_id, @project_id, @role, @content, @tool_calls, @tool_call_id, @created_at)`).run({
+        id: row.id ?? nanoid(),
+        session_id: row.session_id,
+        project_id: row.project_id,
+        role: row.role,
+        content: row.content ?? null,
+        tool_calls: row.tool_calls == null ? null : JSON.stringify(row.tool_calls),
+        tool_call_id: row.tool_call_id ?? null,
+        created_at: row.created_at,
+    });
+}
+/**
+ * 会话列表（GET /api/v1/chat/sessions）：
+ * - 按 project_id 隔离（决策 18 修订：会话按项目隔离）
+ * - 仅返回含消息的会话；updatedAt = 该会话最后一条消息的 created_at
+ * - 按最后活动时间（updatedAt）倒序，同时间戳按 session_id 升序保证稳定
+ * - lastMessage = 最后一条消息的 content 截断（无 content 时为空串）
+ */
+export function listSessions(db, projectId) {
+    const rows = db
+        .prepare(`SELECT
+         t.session_id  AS id,
+         t.message_count,
+         t.created_at,
+         t.updated_at,
+         (SELECT lm.content FROM chat_messages lm
+           WHERE lm.session_id = t.session_id AND lm.project_id = ?
+           ORDER BY lm.created_at DESC, lm.rowid DESC LIMIT 1) AS last_content
+       FROM (
+         SELECT session_id,
+                COUNT(*)        AS message_count,
+                MIN(created_at) AS created_at,
+                MAX(created_at) AS updated_at
+         FROM chat_messages
+         WHERE project_id = ?
+         GROUP BY session_id
+       ) t
+       ORDER BY t.updated_at DESC, t.session_id ASC`)
+        .all(projectId, projectId);
+    return rows.map((r) => ({
+        id: r.id,
+        lastMessage: truncate(r.last_content ?? "", SESSION_LAST_MESSAGE_MAX_LEN),
+        messageCount: r.message_count,
+        createdAt: r.created_at,
+        updatedAt: r.updated_at,
+    }));
+}
+/**
+ * 解析 chat_messages.tool_calls 的 JSON 文本列为数组（ChatMessage.toolCalls）。
+ * 防御性处理：NULL / 非法 JSON / 非数组一律返回 null（视为无工具调用）。
+ */
+export function parseToolCalls(json) {
+    if (json === null)
+        return null;
+    try {
+        const parsed = JSON.parse(json);
+        return Array.isArray(parsed) ? parsed : null;
+    }
+    catch {
+        // 非法 JSON：按无工具调用处理，不向上抛（查询层不阻断会话恢复）
+        return null;
+    }
+}
+/**
+ * 消息历史（GET /api/v1/chat/sessions/:id/messages）：
+ * - 按 project_id 隔离（决策 18 修订）
+ * - 按 created_at 升序，同时间戳按 rowid（插入序）升序保证稳定
+ * - 存储形态 → API 形态：tool_calls JSON 解析、tool_call_id → toolCallId、snake_case → camelCase
+ */
+export function listMessages(db, sessionId, projectId) {
+    const rows = db
+        .prepare(`SELECT id, session_id, project_id, role, content, tool_calls, tool_call_id, created_at
+       FROM chat_messages
+       WHERE session_id = ? AND project_id = ?
+       ORDER BY created_at ASC, rowid ASC`)
+        .all(sessionId, projectId);
+    return rows.map((r) => ({
+        id: r.id,
+        sessionId: r.session_id,
+        projectId: r.project_id,
+        role: r.role,
+        content: r.content,
+        toolCalls: parseToolCalls(r.tool_calls) ?? undefined,
+        toolCallId: r.tool_call_id,
+        createdAt: r.created_at,
+    }));
+}
+/**
+ * 消息历史原始行（S7.6 续聊重建专用）：
+ * - listMessages 输出 API 形态（camelCase，供 GET /messages）；本函数输出**存储形态**
+ *   （snake_case ChatMessageRow，tool_calls 已解析为数组）——直供 agent 包
+ *   loadHistory/restoreSession（决策 18 成对重组），避免 server 层做 API→存储形态反映射。
+ * - 查询语义与 listMessages 一致：按 project_id 隔离、created_at 升序 + rowid 稳定序。
+ */
+export function listMessageRows(db, sessionId, projectId) {
+    const rows = db
+        .prepare(`SELECT id, session_id, project_id, role, content, tool_calls, tool_call_id, created_at
+       FROM chat_messages
+       WHERE session_id = ? AND project_id = ?
+       ORDER BY created_at ASC, rowid ASC`)
+        .all(sessionId, projectId);
+    return rows.map((r) => ({
+        ...r,
+        tool_calls: parseToolCalls(r.tool_calls), // TEXT 列 → 解析后的数组（NULL/损坏 → null）
+    }));
+}
+/**
+ * 成对重组历史消息（决策 18 修订：assistant.tool_calls[].id ↔ tool.tool_call_id 成对重组喂回模型）。
+ *
+ * 用途：服务重启后凭 session_id 重建「继续上次对话」上下文，或会话级滑动窗口裁剪前的重组。
+ * 注意：本函数是纯函数，输入为 ChatMessageRow（tool_calls 已按 shared 类型契约为解析后的数组，
+ * 由调用方先经 parseToolCalls / 直接构造）。
+ *
+ * 算法：
+ * 1. 按 created_at 升序稳定排序（同时间戳保持输入顺序）
+ * 2. 第一遍收集 tool 消息：tool_call_id → content（同一 id 多条结果取最先到达者，防御性处理）
+ * 3. 第二遍顺序扫描：
+ *    - user 消息：原样保留
+ *    - assistant 消息（无 tool_calls）：原样保留
+ *    - assistant 消息（有 tool_calls）：逐个调用校验——任一调用缺 id 或缺对应 tool 结果
+ *      即判定为孤儿半对，该 assistant 消息与其工具结果**整组丢弃**（决策 18 修订：
+ *      孤儿半对整对丢弃，不返回 409 也不部分保留）；全部配对成功则输出 assistant 消息，
+ *      工具结果按 tool_calls 数组顺序紧随其后（tool 消息保留 toolCallId 供模型配对）
+ *    - tool 消息：不单独输出——未被任何保留的 assistant 消息引用的即孤儿，整对丢弃
+ */
+export function reassembleMessages(rows) {
+    // 1. 按 created_at 升序稳定排序
+    const sorted = [...rows].sort((a, b) => a.created_at.localeCompare(b.created_at));
+    // 2. 收集 tool 消息：tool_call_id → content
+    const toolResults = new Map();
+    for (const r of sorted) {
+        if (r.role === "tool" && r.tool_call_id !== null && !toolResults.has(r.tool_call_id)) {
+            toolResults.set(r.tool_call_id, r.content);
+        }
+    }
+    // 3. 顺序扫描重组
+    const out = [];
+    for (const r of sorted) {
+        if (r.role === "user") {
+            out.push({ role: "user", content: r.content });
+            continue;
+        }
+        if (r.role === "assistant") {
+            const calls = r.tool_calls ?? [];
+            if (calls.length === 0) {
+                out.push({ role: "assistant", content: r.content });
+                continue;
+            }
+            const callIds = calls.map((c) => c.id);
+            // 任一调用缺 id 或缺对应结果 → 整组丢弃
+            const allPaired = callIds.every((cid) => typeof cid === "string" && toolResults.has(cid));
+            if (!allPaired)
+                continue;
+            out.push({ role: "assistant", content: r.content, toolCalls: calls });
+            for (const cid of callIds) {
+                out.push({ role: "tool", toolCallId: cid, content: toolResults.get(cid) });
+            }
+            continue;
+        }
+        // role === "tool"：仅作为上面对应的结果被引用；孤儿在此自然丢弃
+    }
+    return out;
+}
+//# sourceMappingURL=chat.js.map

package/dist/queries/chat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../src/queries/chat.ts"],"names":[],"mappings":"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"}

package/dist/queries/compute-state.d.ts

@@ -0,0 +1,32 @@
+import type { ComputeStateResult } from "@whispering233/ai-editor-shared";
+import type { Db } from "../connection.js";
+/**
+ * 计算实体到达指定大纲节点时的累积状态（POST /api/v1/delta/compute，endpoints.md 第 464-510 行）。
+ *
+ * **前置约定**：
+ * - atNodeId 必须存在——路由层先校验节点存在性并映射 404 OUTLINE_NODE_NOT_FOUND 后调用；
+ *   getOutlinePathIds 对缺失节点抛错，视为调用方 bug，本模块不捕获。
+ * - 目标实体不存在（或已软删，getEntity 过滤）→ 返回 **null**，路由层映射 404 ENTITY_NOT_FOUND。
+ *
+ * 累积流程（决策 9 + schema.md 第 107 行）：
+ * 1. state 基座 = 实体初始 data 深拷贝（structuredClone，不污染 getEntity 返回行）
+ * 2. 树路径 = getOutlinePathIds(tree, atNodeId)（根 → at_node，含 root 哨兵——无 delta 挂它，
+ *    无害）；路径上每节点调 listDeltasByNode（内置可见性三态过滤与 order ASC），
+ *    过滤 target_id === targetId——天然满足「节点间树路径序 + 节点内 order 序」双层排序
+ *    与软删过滤
+ * 3. 逐 change 应用（applyChange，决策 9 修订四段语义）；update 冲突跳过不打断后续累积
+ * 4. 响应：appliedDeltas 每项 { nodeId, description, changes（原样数组）, skipped?（仅该 delta
+ *    有跳过时出现）}；conflicts 为跨全部 delta 的扁平数组
+ *
+ * target_type 不参与过滤（仅回显）：id 前缀体系（char-/set-/loc-/hook-/sc-/ch-/vol- 等）保证
+ * target_id 全局唯一，targetId 即足以定位目标；endpoints.md Req 携带 target_type 用于响应回显。
+ *
+ * @param outlineDir 项目根目录（outline.json 读取：树路径 + 节点软删校验）
+ * @returns ComputeStateResult；目标实体不存在/已软删返回 null
+ */
+export declare function computeState(db: Db, outlineDir: string, input: {
+    targetType: string;
+    targetId: string;
+    atNodeId: string;
+}): ComputeStateResult | null;
+//# sourceMappingURL=compute-state.d.ts.map

package/dist/queries/compute-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-state.d.ts","sourceRoot":"","sources":["../../src/queries/compute-state.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAGV,kBAAkB,EAGnB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAyD3C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,EAAE,EACN,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAChE,kBAAkB,GAAG,IAAI,CA0C3B"}