@whispering233/ai-editor-shared 0.0.21 → 0.0.26

package/dist/types/project.d.ts

@@ -1,57 +1,57 @@
 /** 项目语言 */
 export type ProjectLanguage = "zh" | "en";
 /**
- * 项目配置（API 响应形态，GET /api/v1/project/config，endpoints.md）
- * 注：`prompt` 字段已废弃（决策 41）——不再返回；项目规则唯一事实源改为项目目录 AGENTS.md
+ * 项目配置（API 响应形态，GET /api/v1/project/config，）
+ * 注：`prompt` 字段已废弃——不再返回；项目规则唯一事实源改为项目目录
  * （见 GET /api/v1/project/agents）
  */
 export interface ProjectConfig {
     id: string;
     name: string;
     language: ProjectLanguage;
-    /** schema 版本（对应 project.json 的 schema_version，决策 13） */
+    /** schema 版本（对应 project.json 的 schema_version） */
     schemaVersion: number;
-    /** 大纲「当前位置」节点 id（伏笔健康指标依赖，决策 21）；null = 未设置 */
+    /** 大纲「当前位置」节点 id（伏笔健康指标依赖）；null = 未设置 */
     currentPosition: string | null;
-    /** 自动备份频率（分钟，决策 27）；null = 关闭；缺省 10（新项目默认开启，读侧兜底） */
+    /** 自动备份频率（分钟）；null = 关闭；缺省 10（新项目默认开启，读侧兜底） */
     backupFrequencyMinutes: number | null;
     createdAt: string;
     updatedAt: string;
 }
 /**
- * project.json 存储形态（schema.md 契约，内部 snake_case）
- * 硬约束：DeepSeek API key 绝不写入本文件（决策 17）
+ * project.json 存储形态（ ，内部 snake_case）
+ * 硬约束：DeepSeek API key 绝不写入本文件
  */
 export interface ProjectFileConfig {
     id: string;
     name: string;
     language: ProjectLanguage;
     /**
-     * **已废弃（决策 41）**：项目级提示词——不再读写；项目规则改由项目目录 AGENTS.md 承载。
-     * 旧文件中的残留字段宽松读取（不参与 schema_version 判定），新写入不再产生该字段
-     */
+    * **已废弃**：项目级提示词——不再读写；项目规则改由项目目录 承载。
+    * 旧文件中的残留字段宽松读取（不参与 schema_version 判定），新写入不再产生该字段
+    */
     prompt?: string;
     schema_version: number;
     current_position: string | null;
     /**
-     * 自动备份频率（决策 27，**可选字段**——旧项目文件可缺失，读侧兜底缺省 10；
-     * 写侧「只写显式值」：未在 patch 中出现则不写盘，避免污染旧数据）
-     * 仅接受枚举 5/10/15/30/60；null / 0 = 关闭（0 为读侧兼容旧数据语义）
-     */
+    * 自动备份频率（**可选字段**——旧项目文件可缺失，读侧兜底缺省 10；
+    * 写侧「只写显式值」：未在 patch 中出现则不写盘，避免污染旧数据）
+    * 仅接受枚举 5/10/15/30/60；null / 0 = 关闭（0 为读侧兼容旧数据语义）
+    */
     backup_frequency_minutes?: number | null;
     created_at: string;
     updated_at: string;
 }
 /**
- * 项目规则文件 AGENTS.md（决策 41：项目规则唯一事实源，取代 project.json `prompt` 字段）
- * GET /api/v1/project/agents 响应形态（endpoints.md）
+ * 项目规则文件 （项目规则唯一事实源，取代 project.json `prompt` 字段）
+ * GET /api/v1/project/agents 响应形态（）
  */
 export interface ProjectAgents {
-    /** AGENTS.md 文件内容（文件不存在 → 空串） */
+    /** 文件内容（文件不存在 → 空串） */
     content: string;
     /** 文件是否存在（false 时 content 为空串） */
     exists: boolean;
-    /** 文件 mtime（ISO 8601；文件不存在 → null）——外部修改检测依据（决策 41） */
+    /** 文件 mtime（ISO 8601；文件不存在 → null）——外部修改检测依据 */
     updatedAt: string | null;
 }
 //# sourceMappingURL=project.d.ts.map

package/dist/types/project.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/types/project.ts"],"names":[],"mappings":"AAGA,WAAW;AACX,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B,wDAAwD;IACxD,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,qDAAqD;IACrD,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC1B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,uDAAuD;IACvD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B"}
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/types/project.ts"],"names":[],"mappings":"AAEA,WAAW;AACX,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC3B,kDAAkD;IACjD,aAAa,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACxC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,+CAA+C;IAC9C,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,eAAe,CAAC;IAC3B;;;MAGE;IACD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;;;MAIE;IACD,wBAAwB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,uBAAuB;IACtB,OAAO,EAAE,MAAM,CAAC;IACjB,kCAAkC;IACjC,MAAM,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAC/C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B"}

package/dist/types/project.js

@@ -1,4 +1,3 @@
 // 项目配置类型：API 形态（camelCase）+ project.json 存储形态（snake_case）两套
-// 契约来源：doc/api/endpoints.md（GET /api/v1/project/config）、doc/database/schema.md（project.json 契约）
 export {};
 //# sourceMappingURL=project.js.map

package/dist/types/project.js.map

@@ -1 +1 @@
-{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/types/project.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,gGAAgG"}
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/types/project.ts"],"names":[],"mappings":"AAAA,4DAA4D"}

package/dist/types/tool.d.ts

@@ -36,7 +36,7 @@ export declare const searchEntitiesArgsSchema: z.ZodObject<{
 export type SearchEntitiesArgs = z.infer<typeof searchEntitiesArgsSchema>;
 /**
  * query_relationships 入参：source_type/target_type 为自由字符串（实体类型或 outline_node）；
- * relation_type 用 z.enum(RELATION_TYPES) **白名单校验**（schema.md 预定义 16 种，
+ * relation_type 用 z.enum(RELATION_TYPES) **白名单校验**（ 预定义 16 种，
  * 与 REST relationQuerySchema 的宽松 string 不同——工具参数由 LLM 生成，枚举提前拦非法值）；
  * depth 1=紧邻 / 2=k跳 / 3=全量（必填，与 API 层一致）
  */
@@ -77,7 +77,7 @@ export declare const getOutlinePathArgsSchema: z.ZodObject<{
 export type GetOutlinePathArgs = z.infer<typeof getOutlinePathArgsSchema>;
 /**
  * compute_state 入参（与 POST /api/v1/delta/compute 同构，api.ts deltaComputeReqSchema）：
- * 目标实体到达 at_node_id 时的累积状态（只沿大纲树父链累积已确认 Delta，决策 9）
+ * 目标实体到达 at_node_id 时的累积状态（只沿大纲树父链累积已确认 Delta）
  */
 export declare const computeStateArgsSchema: z.ZodObject<{
     target_type: z.ZodString;
@@ -195,13 +195,13 @@ export declare const proposeCreateEntityArgsSchema: z.ZodObject<{
     data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strict>;
 export type ProposeCreateEntityArgs = z.infer<typeof proposeCreateEntityArgsSchema>;
-/** 入参：entity_id + patches（data 部分字段，至少一项）；快照校验基于实体自身 updated_at（决策 14） */
+/** 入参：entity_id + patches（data 部分字段，至少一项）；快照校验基于实体自身 updated_at */
 export declare const proposeUpdateEntityArgsSchema: z.ZodObject<{
     entity_id: z.ZodString;
     patches: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, z.core.$strict>;
 export type ProposeUpdateEntityArgs = z.infer<typeof proposeUpdateEntityArgsSchema>;
-/** 入参：entity_id（软删 + 级联，可回收站还原，决策 12） */
+/** 入参：entity_id（软删 + 级联，可回收站还原） */
 export declare const proposeDeleteEntityArgsSchema: z.ZodObject<{
     entity_id: z.ZodString;
 }, z.core.$strict>;
@@ -235,7 +235,7 @@ export declare const proposeAddRelationArgsSchema: z.ZodObject<{
     metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strict>;
 export type ProposeAddRelationArgs = z.infer<typeof proposeAddRelationArgsSchema>;
-/** 入参：relation_id（手动删关系 = 物理删，不进回收站，决策 12） */
+/** 入参：relation_id（手动删关系 = 物理删，不进回收站） */
 export declare const proposeRemoveRelationArgsSchema: z.ZodObject<{
     relation_id: z.ZodString;
 }, z.core.$strict>;
@@ -258,7 +258,7 @@ export declare const proposeAddDeltaArgsSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strict>;
 export type ProposeAddDeltaArgs = z.infer<typeof proposeAddDeltaArgsSchema>;
-/** 入参：type（volume|chapter|scene）+ title + parent_id（缺省挂根；scene 必须挂 chapter，决策 19） */
+/** 入参：type（volume|chapter|scene）+ title + parent_id（缺省挂根；scene 必须挂 chapter） */
 export declare const proposeOutlineNodeArgsSchema: z.ZodObject<{
     type: z.ZodEnum<{
         volume: "volume";
@@ -270,7 +270,7 @@ export declare const proposeOutlineNodeArgsSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type ProposeOutlineNodeArgs = z.infer<typeof proposeOutlineNodeArgsSchema>;
 /**
- * 入参：node_id + parent_id（目标父节点，**可为 "root"**——决策 19 允许 volume/chapter 挂根，
+ * 入参：node_id + parent_id（目标父节点，**可为 "root"**—— 允许 volume/chapter 挂根，
  * db moveOutlineNode 支持 parentId === "root"）+ order（目标位置，0 起）。
  * order 无范围上限：超出目标父 children 长度的行为（clamp 或抛错）由 S6.7/db 执行时定义，
  * 生成时校验不做上限（提案只承载意图，合法性由执行层兜底）。
@@ -281,7 +281,7 @@ export declare const proposeMoveNodeArgsSchema: z.ZodObject<{
     order: z.ZodNumber;
 }, z.core.$strict>;
 export type ProposeMoveNodeArgs = z.infer<typeof proposeMoveNodeArgsSchema>;
-/** 入参：node_id（软删 + 递归子树，可回收站还原，决策 12） */
+/** 入参：node_id（软删 + 递归子树，可回收站还原） */
 export declare const proposeDeleteNodeArgsSchema: z.ZodObject<{
     node_id: z.ZodString;
 }, z.core.$strict>;
@@ -293,27 +293,27 @@ export declare const proposeCreateHookArgsSchema: z.ZodObject<{
     plant_at_node_id: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 export type ProposeCreateHookArgs = z.infer<typeof proposeCreateHookArgsSchema>;
-/** 入参：hook_id + patches（data 部分字段，至少一项）；快照校验基于伏笔实体自身 updated_at（决策 14） */
+/** 入参：hook_id + patches（data 部分字段，至少一项）；快照校验基于伏笔实体自身 updated_at */
 export declare const proposeUpdateHookArgsSchema: z.ZodObject<{
     hook_id: z.ZodString;
     patches: z.ZodRecord<z.ZodString, z.ZodUnknown>;
 }, z.core.$strict>;
 export type ProposeUpdateHookArgs = z.infer<typeof proposeUpdateHookArgsSchema>;
-/** 入参：hook_id + node_id（推进发生的节点）+ description（推进内容描述；确认后复合写 delta+relations，tools.md） */
+/** 入参：hook_id + node_id（推进发生的节点）+ description（推进内容描述；确认后复合写 delta+relations，） */
 export declare const proposeAdvanceHookArgsSchema: z.ZodObject<{
     hook_id: z.ZodString;
     node_id: z.ZodString;
     description: z.ZodString;
 }, z.core.$strict>;
 export type ProposeAdvanceHookArgs = z.infer<typeof proposeAdvanceHookArgsSchema>;
-/** 入参：hook_id + node_id（回收节点）+ description（回收内容描述；确认后复合写 delta+relations，tools.md） */
+/** 入参：hook_id + node_id（回收节点）+ description（回收内容描述；确认后复合写 delta+relations，） */
 export declare const proposeResolveHookArgsSchema: z.ZodObject<{
     hook_id: z.ZodString;
     node_id: z.ZodString;
     description: z.ZodString;
 }, z.core.$strict>;
 export type ProposeResolveHookArgs = z.infer<typeof proposeResolveHookArgsSchema>;
-/** 入参：hook_id + description（废弃原因；确认后复合写 delta 记 status=abandoned，tools.md） */
+/** 入参：hook_id + description（废弃原因；确认后复合写 delta 记 status=abandoned，） */
 export declare const proposeAbandonHookArgsSchema: z.ZodObject<{
     hook_id: z.ZodString;
     description: z.ZodString;
@@ -322,7 +322,7 @@ export type ProposeAbandonHookArgs = z.infer<typeof proposeAbandonHookArgsSchema
 /**
  * 入参：timepoint_ids——LLM 按时间点 name（时间标签文本）语义识别先后后产出的
  * **有序时间点 id 全量序列**（顺序 = 建议新序，须覆盖当前全部未软删时间点，缺/多/重复
- * 由生成时校验拒绝）；200 = 时间点量上限，与列表 limit 对齐（endpoints.md 契约）。
+ * 由生成时校验拒绝）；200 = 时间点量上限，与列表 limit 对齐（ ）。
  * G2 取代 F9 的 propose_reorder_events：事件不再带 time_label，语义序的载体变为时间点实体
  */
 export declare const proposeReorderTimepointsArgsSchema: z.ZodObject<{
@@ -330,7 +330,7 @@ export declare const proposeReorderTimepointsArgsSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type ProposeReorderTimepointsArgs = z.infer<typeof proposeReorderTimepointsArgsSchema>;
 /**
- * search_references 入参：query 关键词（标题+tags 命中）+ 可选 type 分类过滤（自由文本，决策 44：
+ * search_references 入参：query 关键词（标题+tags 命中）+ 可选 type 分类过滤（自由文本，
  * 原预置枚举已取消，建议沿用项目内已有分类）+ 可选 tags 过滤。
  * 返回摘要列表（content 摘要截断 120 字由 db toSummary 承担——全文长文本不随列表返回，防 token 膨胀）
  */
@@ -341,7 +341,7 @@ export declare const searchReferencesArgsSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type SearchReferencesArgs = z.infer<typeof searchReferencesArgsSchema>;
 /**
- * 入参：name 标题（必填）+ type 分类（自由文本，决策 44：原枚举已取消，建议沿用项目内已有分类，
+ * 入参：name 标题（必填）+ type 分类（自由文本，原枚举已取消，建议沿用项目内已有分类，
  * 缺省 material 写入侧兜底）+ content 全文长文本 +
  * source 来源（可选）+ tags 标签数组（可选）。无引用对象（新实体 id 由执行时生成）。
  */

package/dist/types/tool.d.ts.map

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

package/dist/types/tool.js

@@ -1,15 +1,11 @@
 // AI 工具参数 Zod schema（@whispering233/ai-editor-shared/types/tool.ts，S6.3）
-// 契约来源：doc/api/tools.md「查询类（自动）」——8 个查询工具的入参/返回语义；
-//   字段名沿用 tools.md 的 snake_case 参数约定（工具参数由 LLM 直接生成，snake_case 与
-//   REST 请求体一致）；取值范围引用 constants/entity.ts 既有枚举（EntityType/RelationType），
-//   不另造类型。
 // **导出边界**：运行时 schema 仅经 @whispering233/ai-editor-shared/schemas/tools 子路径导出（供服务端
-//   tools 包/executor 使用）；types/index.ts 的 type-only barrel 只导出推断类型——
-//   client 浏览器包不打包 zod 校验函数（与 types/api.ts 同款约束，见 index.ts 头注释）。
+// tools 包/executor 使用）；types/index.ts 的 type-only barrel 只导出推断类型——
+// client 浏览器包不打包 zod 校验函数（与 types/api.ts 同款约束，见 index.ts 头注释）。
 import { z } from "zod";
 import { ENTITY_TYPES, RELATION_TYPES } from "../constants/entity.js";
 import { deltaChangeSchema } from "./api.js"; // 复用 delta 单条变更 schema（api.ts 已导出）
-// ============ get_entity（实体详情，tools.md「实体查询」） ============
+// ============ get_entity（实体详情，「实体查询」） ============
 /** get_entity 入参：type（实体类型）+ id；id 前缀体系全局唯一，type 用于回显与一致性校验 */
 export const getEntityArgsSchema = z
     .object({
@@ -17,7 +13,7 @@ export const getEntityArgsSchema = z
     id: z.string(),
 })
     .strict();
-// ============ search_entities（实体搜索，tools.md「实体查询」） ============
+// ============ search_entities（实体搜索，「实体查询」） ============
 /**
  * search_entities 入参：type + query（name 模糊匹配）+ filters（data 字段过滤）
  * filters.status：data.status 字符串相等匹配；filters.tags：data.tags 数组须包含全部指定 tags（AND）
@@ -34,10 +30,10 @@ export const searchEntitiesArgsSchema = z
         .optional(),
 })
     .strict();
-// ============ query_relationships（关系图子图，tools.md「关系查询」） ============
+// ============ query_relationships（关系图子图，「关系查询」） ============
 /**
  * query_relationships 入参：source_type/target_type 为自由字符串（实体类型或 outline_node）；
- * relation_type 用 z.enum(RELATION_TYPES) **白名单校验**（schema.md 预定义 16 种，
+ * relation_type 用 z.enum(RELATION_TYPES) **白名单校验**（ 预定义 16 种，
  * 与 REST relationQuerySchema 的宽松 string 不同——工具参数由 LLM 生成，枚举提前拦非法值）；
  * depth 1=紧邻 / 2=k跳 / 3=全量（必填，与 API 层一致）
  */
@@ -51,20 +47,20 @@ export const queryRelationshipsArgsSchema = z
     depth: z.union([z.literal(1), z.literal(2), z.literal(3)]),
 })
     .strict();
-// ============ get_outline（完整大纲树，tools.md「大纲查询」） ============
+// ============ get_outline（完整大纲树，「大纲查询」） ============
 /** get_outline 入参：无参；默认不含 metadata 统计（省 token，需统计走 API with_metadata） */
 export const getOutlineArgsSchema = z.object({}).strict();
-// ============ get_outline_path（节点路径，tools.md「大纲查询」） ============
+// ============ get_outline_path（节点路径，「大纲查询」） ============
 /** get_outline_path 入参：node_id（根 → 该节点的路径 ID 列表，含 root） */
 export const getOutlinePathArgsSchema = z
     .object({
     node_id: z.string(),
 })
     .strict();
-// ============ compute_state（状态计算，tools.md「状态查询」） ============
+// ============ compute_state（状态计算，「状态查询」） ============
 /**
  * compute_state 入参（与 POST /api/v1/delta/compute 同构，api.ts deltaComputeReqSchema）：
- * 目标实体到达 at_node_id 时的累积状态（只沿大纲树父链累积已确认 Delta，决策 9）
+ * 目标实体到达 at_node_id 时的累积状态（只沿大纲树父链累积已确认 Delta）
  */
 export const computeStateArgsSchema = z
     .object({
@@ -73,7 +69,7 @@ export const computeStateArgsSchema = z
     at_node_id: z.string(),
 })
     .strict();
-// ============ get_delta_history（Delta 历史，tools.md「状态查询」） ============
+// ============ get_delta_history（Delta 历史，「状态查询」） ============
 /** get_delta_history 入参：target_type + target_id（该实体的全部属性变更记录，按时间/节点排序） */
 export const getDeltaHistoryArgsSchema = z
     .object({
@@ -81,14 +77,14 @@ export const getDeltaHistoryArgsSchema = z
     target_id: z.string(),
 })
     .strict();
-// ============ get_entity_summary（聚合统计，tools.md「聚合分析」） ============
+// ============ get_entity_summary（聚合统计，「聚合分析」） ============
 /** get_entity_summary 入参：type（指定类型实体的统计数据：总数 + 类型专属分布） */
 export const getEntitySummaryArgsSchema = z
     .object({
     type: z.enum(ENTITY_TYPES),
 })
     .strict();
-// ============ 分析类工具（tools.md「分析类（自动）」，S6.4） ============
+// ============ 分析类工具（「分析类（自动）」，S6.4） ============
 // === analyze_consistency（一致性分析） ===
 /** analyze_consistency 入参：entity_id（检查该实体档案内部的矛盾，如性格反义词对/状态冲突） */
 export const analyzeConsistencyArgsSchema = z
@@ -126,7 +122,7 @@ export const suggestConnectionsArgsSchema = z
     entity_id: z.string(),
 })
     .strict();
-// ============ 伏笔分析工具（hooks.md「工具扩展」+ 决策 21，S6.5） ============
+// ============ 伏笔分析工具（「工具扩展」+ ，S6.5） ============
 // === analyze_hook_health（伏笔健康总览） ===
 /** analyze_hook_health 入参：无参（全项目活跃伏笔健康总览：stale/overdue/blocked/warnings） */
 export const analyzeHookHealthArgsSchema = z.object({}).strict();
@@ -154,14 +150,14 @@ export const findHookOpportunitiesArgsSchema = z
 // === detect_hook_conflicts（伏笔矛盾检测） ===
 /** detect_hook_conflicts 入参：无参（依赖循环/依赖废弃/时间悖论检测） */
 export const detectHookConflictsArgsSchema = z.object({}).strict();
-// ============ 提案类工具（tools.md「提案类（需确认）」+ hooks.md「工具扩展」提案类，S6.6） ============
+// ============ 提案类工具（「提案类（需确认）」+ 「工具扩展」提案类，S6.6） ============
 //
-// 语义（tools.md「返回语义」2026-08 修订）：AI **不能直接修改数据**——propose_* 仅产出
+// 语义（「返回语义」2026-08 修订）：AI **不能直接修改数据**——propose_* 仅产出
 // 提案对象（proposal_id + 一句话摘要），tool_result 不含预览细节（避免 LLM 误以为提案已生效
 // 而重复提案）；完整预览只经 SSE proposal 事件推送 GUI（S7 实现）。
-// 参数签名与 tools.md 逐字对齐（propose_add_relation(source, target, type, metadata?) 等）：
+// 参数签名与 逐字对齐（propose_add_relation(source, target, type, metadata?) 等）：
 // 端点 id（source/target/plant_at_node_id 等）由服务端在生成时自动识别实体/大纲节点类型
-// 并采集 updated_at 快照（决策 14/19），故入参只需 id 字符串。
+// 并采集 updated_at 快照，故入参只需 id 字符串。
 // patches（部分更新字段）拒绝空对象——空补丁提案无意义（生成时校验）。
 // === propose_create_entity（创建实体提案） ===
 /** 入参：type（实体类型）+ name（必填）+ data（可选自定义字段） */
@@ -173,7 +169,7 @@ export const proposeCreateEntityArgsSchema = z
 })
     .strict();
 // === propose_update_entity（更新实体提案） ===
-/** 入参：entity_id + patches（data 部分字段，至少一项）；快照校验基于实体自身 updated_at（决策 14） */
+/** 入参：entity_id + patches（data 部分字段，至少一项）；快照校验基于实体自身 updated_at */
 export const proposeUpdateEntityArgsSchema = z
     .object({
     entity_id: z.string(),
@@ -183,7 +179,7 @@ export const proposeUpdateEntityArgsSchema = z
 })
     .strict();
 // === propose_delete_entity（删除实体提案） ===
-/** 入参：entity_id（软删 + 级联，可回收站还原，决策 12） */
+/** 入参：entity_id（软删 + 级联，可回收站还原） */
 export const proposeDeleteEntityArgsSchema = z
     .object({
     entity_id: z.string(),
@@ -203,7 +199,7 @@ export const proposeAddRelationArgsSchema = z
 })
     .strict();
 // === propose_remove_relation（移除关系提案） ===
-/** 入参：relation_id（手动删关系 = 物理删，不进回收站，决策 12） */
+/** 入参：relation_id（手动删关系 = 物理删，不进回收站） */
 export const proposeRemoveRelationArgsSchema = z
     .object({
     relation_id: z.string(),
@@ -219,7 +215,7 @@ export const proposeAddDeltaArgsSchema = z
 })
     .strict();
 // === propose_outline_node（新增大纲节点提案） ===
-/** 入参：type（volume|chapter|scene）+ title + parent_id（缺省挂根；scene 必须挂 chapter，决策 19） */
+/** 入参：type（volume|chapter|scene）+ title + parent_id（缺省挂根；scene 必须挂 chapter） */
 export const proposeOutlineNodeArgsSchema = z
     .object({
     type: z.enum(["volume", "chapter", "scene"]),
@@ -229,7 +225,7 @@ export const proposeOutlineNodeArgsSchema = z
     .strict();
 // === propose_move_node（移动大纲节点提案） ===
 /**
- * 入参：node_id + parent_id（目标父节点，**可为 "root"**——决策 19 允许 volume/chapter 挂根，
+ * 入参：node_id + parent_id（目标父节点，**可为 "root"**—— 允许 volume/chapter 挂根，
  * db moveOutlineNode 支持 parentId === "root"）+ order（目标位置，0 起）。
  * order 无范围上限：超出目标父 children 长度的行为（clamp 或抛错）由 S6.7/db 执行时定义，
  * 生成时校验不做上限（提案只承载意图，合法性由执行层兜底）。
@@ -242,13 +238,13 @@ export const proposeMoveNodeArgsSchema = z
 })
     .strict();
 // === propose_delete_node（删除大纲节点提案） ===
-/** 入参：node_id（软删 + 递归子树，可回收站还原，决策 12） */
+/** 入参：node_id（软删 + 递归子树，可回收站还原） */
 export const proposeDeleteNodeArgsSchema = z
     .object({
     node_id: z.string(),
 })
     .strict();
-// === propose_create_hook（创建伏笔提案，hooks.md「工具扩展」提案类） ===
+// === propose_create_hook（创建伏笔提案，「工具扩展」提案类） ===
 /** 入参：name + data（可选伏笔字段，如 payoff_timing/half_life/expected_resolve_node_id）+ plant_at_node_id（可选埋设节点） */
 export const proposeCreateHookArgsSchema = z
     .object({
@@ -258,7 +254,7 @@ export const proposeCreateHookArgsSchema = z
 })
     .strict();
 // === propose_update_hook（更新伏笔提案） ===
-/** 入参：hook_id + patches（data 部分字段，至少一项）；快照校验基于伏笔实体自身 updated_at（决策 14） */
+/** 入参：hook_id + patches（data 部分字段，至少一项）；快照校验基于伏笔实体自身 updated_at */
 export const proposeUpdateHookArgsSchema = z
     .object({
     hook_id: z.string(),
@@ -268,7 +264,7 @@ export const proposeUpdateHookArgsSchema = z
 })
     .strict();
 // === propose_advance_hook（推进伏笔提案） ===
-/** 入参：hook_id + node_id（推进发生的节点）+ description（推进内容描述；确认后复合写 delta+relations，tools.md） */
+/** 入参：hook_id + node_id（推进发生的节点）+ description（推进内容描述；确认后复合写 delta+relations，） */
 export const proposeAdvanceHookArgsSchema = z
     .object({
     hook_id: z.string(),
@@ -277,7 +273,7 @@ export const proposeAdvanceHookArgsSchema = z
 })
     .strict();
 // === propose_resolve_hook（回收伏笔提案） ===
-/** 入参：hook_id + node_id（回收节点）+ description（回收内容描述；确认后复合写 delta+relations，tools.md） */
+/** 入参：hook_id + node_id（回收节点）+ description（回收内容描述；确认后复合写 delta+relations，） */
 export const proposeResolveHookArgsSchema = z
     .object({
     hook_id: z.string(),
@@ -286,18 +282,18 @@ export const proposeResolveHookArgsSchema = z
 })
     .strict();
 // === propose_abandon_hook（废弃伏笔提案） ===
-/** 入参：hook_id + description（废弃原因；确认后复合写 delta 记 status=abandoned，tools.md） */
+/** 入参：hook_id + description（废弃原因；确认后复合写 delta 记 status=abandoned，） */
 export const proposeAbandonHookArgsSchema = z
     .object({
     hook_id: z.string(),
     description: z.string().min(1),
 })
     .strict();
-// === propose_reorder_timepoints（时间轴时间点重排提案，G2，决策 26 修订注记） ===
+// === propose_reorder_timepoints（时间轴时间点重排提案，G2，注记） ===
 /**
  * 入参：timepoint_ids——LLM 按时间点 name（时间标签文本）语义识别先后后产出的
  * **有序时间点 id 全量序列**（顺序 = 建议新序，须覆盖当前全部未软删时间点，缺/多/重复
- * 由生成时校验拒绝）；200 = 时间点量上限，与列表 limit 对齐（endpoints.md 契约）。
+ * 由生成时校验拒绝）；200 = 时间点量上限，与列表 limit 对齐（ ）。
  * G2 取代 F9 的 propose_reorder_events：事件不再带 time_label，语义序的载体变为时间点实体
  */
 export const proposeReorderTimepointsArgsSchema = z
@@ -305,9 +301,9 @@ export const proposeReorderTimepointsArgsSchema = z
     timepoint_ids: z.array(z.string()).min(1).max(200),
 })
     .strict();
-// ============ search_references（参考资料搜索，决策 36，批次九） ============
+// ============ search_references（参考资料搜索，，批次九） ============
 /**
- * search_references 入参：query 关键词（标题+tags 命中）+ 可选 type 分类过滤（自由文本，决策 44：
+ * search_references 入参：query 关键词（标题+tags 命中）+ 可选 type 分类过滤（自由文本，
  * 原预置枚举已取消，建议沿用项目内已有分类）+ 可选 tags 过滤。
  * 返回摘要列表（content 摘要截断 120 字由 db toSummary 承担——全文长文本不随列表返回，防 token 膨胀）
  */
@@ -318,9 +314,9 @@ export const searchReferencesArgsSchema = z
     tags: z.array(z.string()).optional(),
 })
     .strict();
-// === propose_create_reference（创建参考资料提案，决策 36） ===
+// === propose_create_reference（创建参考资料提案） ===
 /**
- * 入参：name 标题（必填）+ type 分类（自由文本，决策 44：原枚举已取消，建议沿用项目内已有分类，
+ * 入参：name 标题（必填）+ type 分类（自由文本，原枚举已取消，建议沿用项目内已有分类，
  * 缺省 material 写入侧兜底）+ content 全文长文本 +
  * source 来源（可选）+ tags 标签数组（可选）。无引用对象（新实体 id 由执行时生成）。
  */

package/dist/types/tool.js.map

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

package/dist/utils/backup.d.ts

@@ -1,19 +1,19 @@
 import { type BackupKind } from "../constants/backup.js";
-/** 备份文件名解析结果（决策 28 + 决策 29：time + 类型 + 可选自定义名称） */
+/** 备份文件名解析结果（time + 类型 + 可选自定义名称） */
 export interface ParsedBackupFileName {
     /** 本地时区时间（文件名时间戳；旧秒级格式 → 毫秒为 0） */
     time: Date;
-    /** 备份类型（决策 29，由文件名 kind 段解析推断：auto / manual） */
+    /** 备份类型（由文件名 kind 段解析推断：auto / manual） */
     kind: BackupKind;
-    /** 手动备份自定义名称（决策 28；自动备份/快照/旧秒级备份无此字段） */
+    /** 手动备份自定义名称（自动备份/快照/旧秒级备份无此字段） */
     name?: string;
 }
 /**
  * 解析备份文件名 → { time, kind, name? }。
  *
  * 格式不符返回 null：非时间戳形状（含路径分隔符、`..`、空串、非数字、多后缀等）一律
- * 拒绝——白名单校验语义（endpoints.md restore 流程第 1 步）。兼容三类：
- *   新格式（带/不带 kind 段）/ 旧带名称无 kind 段 / 旧秒级格式（决策 29：历史备份不迁移）。
+ * 拒绝——白名单校验语义（ restore 流程第 1 步）。兼容三类：
+ * 新格式（带/不带 kind 段）/ 旧带名称无 kind 段 / 旧秒级格式（历史备份不迁移）。
  * 数字合法但日期不存在（如 20261301、2 月 30 日）同样返回 null：Date 构造会对
  * 越界值滚动进位（20261301 → 2027-01-01），回读比对不一致即拒绝。
  *
@@ -23,9 +23,9 @@ export interface ParsedBackupFileName {
 export declare function parseBackupFileName(fileName: string): ParsedBackupFileName | null;
 /**
  * 生成备份文件名：Date → `<YYYYMMDD-HHmmssSSS>[-<kind>][-<名称>].zip`（本地时区，与 parse 对称）。
- * 决策 29 四类输出：
- *   auto 无名称 → 纯时间戳；auto 带名称 → `-a-<名称>`；manual 无名称 → `-m`；manual 带名称 → `-m-<名称>`。
- * 决策 28：毫秒精度；决策 27：文件名时间戳命名，`.backups/` 内按文件名排序即时间序（保留策略依赖）。
+ * 四类输出：
+ * auto 无名称 → 纯时间戳；auto 带名称 → `-a-<名称>`；manual 无名称 → `-m`；manual 带名称 → `-m-<名称>`。
+ * 毫秒精度；文件名时间戳命名，`.backups/` 内按文件名排序即时间序（保留策略依赖）。
  *
  * @param opts.kind 备份类型（缺省 "auto"）
  * @param opts.name 自定义名称——调用方保证已 sanitize（见 sanitizeBackupName）；本函数纯拼接
@@ -35,12 +35,12 @@ export declare function formatBackupFileName(date: Date, opts?: {
     name?: string;
 }): string;
 /**
- * 备份名称规则（决策 28）：
- *   - trim 后非空，长度 ≤ MAX_BACKUP_NAME_LENGTH（constants/backup.ts）
- *   - 禁路径分隔符（/ \）与保留字符（: * ? " < > |）与控制字符
- *   - 禁纯点（. / ..）
- *   - 自动剥离尾部 .zip（用户输入习惯，如「定稿.zip」→「定稿」；**循环剥尽**——
- *     「定稿.zip.zip」→「定稿」，避免双 .zip 文件名，oracle 审核 P2-2）
+ * 备份名称规则：
+ * - trim 后非空，长度 ≤ MAX_BACKUP_NAME_LENGTH（constants/backup.ts）
+ * - 禁路径分隔符（/ \）与保留字符（ * ? " < > |）与控制字符
+ * - 禁纯点（. / ..）
+ * - 自动剥离尾部 .zip（用户输入习惯，如「定稿.zip」→「定稿」；**循环剥尽**——
+ * 「定稿.zip.zip」→「定稿」，避免双 .zip 文件名，oracle 审核 P2-2）
  *
  * 服务端唯一执行点：writeBackup（backup.ts）；路由层 zod schema 仅做形状校验。
  * @returns 规范化后的名称；非法 → null（调用方转 400 VALIDATION_ERROR）

package/dist/utils/backup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/utils/backup.ts"],"names":[],"mappings":"AAgBA,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAajF,mDAAmD;AACnD,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,IAAI,EAAE,IAAI,CAAC;IACX,gDAAgD;IAChD,IAAI,EAAE,UAAU,CAAC;IACjB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CA0CjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,UAAU,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAUpG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAa7D"}
+{"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../src/utils/backup.ts"],"names":[],"mappings":"AAaA,OAAO,EAA0B,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAajF,qCAAqC;AACrC,MAAM,WAAW,oBAAoB;IACpC,mCAAmC;IAClC,IAAI,EAAE,IAAI,CAAC;IACZ,0CAA0C;IACzC,IAAI,EAAE,UAAU,CAAC;IAClB,mCAAmC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CA0CjF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,UAAU,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAUpG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAa7D"}