@whispering233/ai-editor-server 0.0.1

package/dist/routes/proposal.js

@@ -0,0 +1,145 @@
+// 提案路由（S7.5）：POST /api/v1/proposal/:proposalId/confirm | reject
+//
+// 契约来源：doc/api/endpoints.md「提案确认」（第 848-888 行）、决策 14（仅内存 / TTL / 快照重校验 /
+//   项目绑定）、决策 19（大纲节点用节点级 updated_at 快照）。
+// 错误映射（对照 endpoints.md 错误码）：
+//   提案不存在/已过期 → 404 PROPOSAL_NOT_FOUND（store.get 与 peek 均不可见）
+//   提案所属项目 ≠ 当前项目 → 409 PROPOSAL_PROJECT_MISMATCH（决策 14 修订：get 返回 null 后
+//     peek 仍可见 ⇒ 跨项目误操作；防御性——正常流程切换项目时提案已被清空）
+//   快照重校验失败 → 409 PROPOSAL_STALE（决策 14：引用对象不存在 **或** updated_at 不一致，
+//     任一失败即 STALE；前端提示重新生成提案）
+//   执行失败 → 500 INTERNAL_ERROR（契约未定义该错误码——执行失败属服务端状态异常/数据竞争，
+//     前端按通用错误呈现）
+//
+// 消费方：defaultProposalStore（@whispering233/ai-editor-agent S7.4 提案仓，与调度同仓消费）+ executeProposal
+//   （@whispering233/ai-editor-tools S6.7 执行门面，按 proposal.type 映射执行函数，args 直接消费执行形态）。
+//
+// 提案移除语义（一次性消费，决策 14「提案是毫秒级交互对象、无跨会话恢复」落地）：
+//   confirm/reject 任一动作到达即消费——确认成功、快照过期、执行失败、拒绝均为终态，
+//   处理完立即 remove 出仓。残留只会造成两类问题：① 重复 confirm 同一无引用提案
+//   （如 propose_create_entity）会**重复执行**产生重复数据；② 已过期提案反复返回 409 无意义
+//   （前端按 PROPOSAL_STALE 引导重新生成，保留不提供任何重试价值）。故失败同样移除。
+import { Hono } from "hono";
+import { defaultProposalStore } from "@whispering233/ai-editor-agent";
+import { executeProposal } from "@whispering233/ai-editor-tools";
+import { findOutlineNode, getDeltaRow, getEntity, getRelation, readOutlineFile } from "@whispering233/ai-editor-db";
+import { HttpError, ok } from "../middleware/error.js";
+import { requireCurrentProject } from "../middleware/project.js";
+/** 提案路由（挂载于 /api/v1/proposal，index.ts） */
+export const proposalRoutes = new Hono();
+/** 快照校验失败统一映射 409 PROPOSAL_STALE（决策 14：存在性 + updated_at 任一失败即 STALE） */
+function throwProposalStale(ref) {
+    throw new HttpError(409, "PROPOSAL_STALE", `提案引用对象已变化或不存在: kind=${ref.kind} id=${ref.id}（请重新生成提案）`);
+}
+/**
+ * 单条引用快照重校验（决策 14/19）：
+ * - kind=entity：getEntity 查 entities（已过滤软删，决策 12）——不存在/软删 → null → STALE；
+ *   存在则比对实体自身 updated_at（软删/还原亦刷新版本戳，决策 12 修订，语义统一）
+ * - kind=relation：getRelation（自身软删 + 端点软删联动过滤，决策 12 修订）——不可见 → STALE；
+ *   存在则比对关系自身 updated_at
+ * - kind=delta：getDeltaRow（记录级：自身软删视为不存在）——不存在 → STALE；比对自身 updated_at
+ * - kind=outline_node：findOutlineNode 查**调用方预读的树**（S2：references 含多条 outline_node
+ *   时不重复读文件；校验前同步读树一次，无间隙）——节点不存在或软删（决策 12）→ STALE；
+ *   存在则比对**节点级** updated_at（决策 19）
+ * - default（防静默，oracle S1）：未知 kind 属上层调度/构造 bug（决策 14 契约仅 4 类引用），
+ *   跳过校验直接放行会让提案绕过快照重校验，按内部错误显式拒绝
+ * 三种 DB 引用不查大纲可见性联动（getRelation 例外——其 API 内置端点过滤）：
+ * 提案引用的是记录本身，「存在性 + 自身 updated_at」即决策 14 契约字面语义。
+ */
+function assertReferenceFresh(project, tree, ref) {
+    switch (ref.kind) {
+        case "entity": {
+            const row = getEntity(project.db, ref.id);
+            if (row === null || row.updated_at !== ref.updated_at)
+                throwProposalStale(ref);
+            return;
+        }
+        case "relation": {
+            const row = getRelation(project.db, ref.id, project.root);
+            if (row === null || row.updated_at !== ref.updated_at)
+                throwProposalStale(ref);
+            return;
+        }
+        case "delta": {
+            const row = getDeltaRow(project.db, ref.id);
+            if (row === null || row.updated_at !== ref.updated_at)
+                throwProposalStale(ref);
+            return;
+        }
+        case "outline_node": {
+            const node = findOutlineNode(tree, ref.id);
+            if (node === undefined || node.deleted === true || node.updated_at !== ref.updated_at) {
+                throwProposalStale(ref);
+            }
+            return;
+        }
+        default: {
+            // 防静默：never 断言提供编译期穷尽性——未来 ProposalReferenceKind 新增成员时
+            // 本行编译报错，强制补 case 而非静默漏校验（oracle S1）
+            const exhaustive = ref.kind;
+            throw new HttpError(500, "INTERNAL_ERROR", `未知提案引用类型: ${String(exhaustive)}`);
+        }
+    }
+}
+/**
+ * 取当前项目提案（confirm/reject 共用，决策 14 修订项目绑定）：
+ * store.get(id, projectId) 校验项目归属；返回 null 时 peek 区分两种不可见——
+ *   peek 可见 ⇒ 提案属于其他项目 → 409 PROPOSAL_PROJECT_MISMATCH（不误报 404）；
+ *   peek 不可见 ⇒ 不存在或已过期 → 404 PROPOSAL_NOT_FOUND。
+ * 注意 peek 走仓内惰性过期清理（决策 14 TTL），超期条目同样归入 404。
+ */
+function resolveProposal(proposalId, projectId) {
+    const proposal = defaultProposalStore.get(proposalId, projectId);
+    if (proposal !== null)
+        return proposal;
+    if (defaultProposalStore.peek(proposalId) !== null) {
+        throw new HttpError(409, "PROPOSAL_PROJECT_MISMATCH", `提案所属项目与当前项目不一致: ${proposalId}`);
+    }
+    throw new HttpError(404, "PROPOSAL_NOT_FOUND", `提案不存在或已过期: ${proposalId}`);
+}
+// POST /api/v1/proposal/:proposalId/confirm —— 用户确认提案（endpoints.md 第 850-874 行）
+// 流程：项目归属解析（404/409）→ 快照逐条重校验（409 PROPOSAL_STALE）→
+//   executeProposal({ db, outlineDir: project.root, projectId }, proposal) →
+//   200 { confirmed: true, result }（ok 包裹，result 为执行结果如新创建的 entity id）。
+// 提案移除在 finally 中（一次性消费，见文件头注释）：校验通过 / 快照过期 / 执行失败均为终态，
+//   确认动作即消费；404/409 MISMATCH 由 resolveProposal 在 try 之前抛出，不进入本块
+//   （跨项目提案不消费）。executeProposal 为同步调用（withTransaction 包复合写），
+//   单线程下「执行后移除」与「执行前移除」无竞态差异。
+proposalRoutes.post("/:proposalId/confirm", (c) => {
+    const project = requireCurrentProject();
+    const proposal = resolveProposal(c.req.param("proposalId"), project.config.id);
+    try {
+        // 快照重校验（决策 14：存在性 + updated_at 比对，任一失败 409 PROPOSAL_STALE）；
+        // 树在校验前读一次（S2：多条 outline_node 引用不重复读文件，同步读取无间隙）
+        const tree = readOutlineFile(project.root);
+        for (const ref of proposal.references) {
+            assertReferenceFresh(project, tree, ref);
+        }
+        let result;
+        try {
+            result = executeProposal({ db: project.db, outlineDir: project.root, projectId: project.config.id }, proposal);
+        }
+        catch (err) {
+            // 执行失败（幂等冲突/数据竞争/防御校验抛错）：契约未定义该错误码，按 500 内部错误呈现；
+            // 前端按通用错误引导重新生成，不保留重试（重试仍会失败）
+            throw new HttpError(500, "INTERNAL_ERROR", err instanceof Error ? err.message : "提案执行失败");
+        }
+        return c.json(ok({ confirmed: true, result }));
+    }
+    finally {
+        // 一次性消费（决策 14 瞬态交互对象）：终态即移除——残留只会让重复 confirm
+        // 对无引用提案（propose_create_entity）产生重复执行，或对过期提案反复返回 409
+        defaultProposalStore.remove(proposal.proposal_id);
+    }
+});
+// POST /api/v1/proposal/:proposalId/reject —— 用户拒绝提案（endpoints.md 第 876-888 行）
+// 项目归属校验与 confirm 同语义（决策 14 修订原文「confirm/reject 时校验与当前项目一致」——
+// 拒绝同样是不可逆消费动作，跨项目拒绝会误伤他项目待确认提案，故 404/409 MISMATCH 同 confirm）。
+// 校验通过 → 移除（拒绝即消费）→ 200 { rejected: true }。
+proposalRoutes.post("/:proposalId/reject", (c) => {
+    const project = requireCurrentProject();
+    const proposal = resolveProposal(c.req.param("proposalId"), project.config.id);
+    defaultProposalStore.remove(proposal.proposal_id);
+    return c.json(ok({ rejected: true }));
+});
+//# sourceMappingURL=proposal.js.map

package/dist/routes/proposal.js.map

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

package/dist/routes/relation.d.ts

@@ -0,0 +1,6 @@
+import { Hono } from "hono";
+/** 关系路由（挂载于 /api/v1/relation，index.ts） */
+export declare const relationRoutes: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+/** RelationError → HttpError 映射（文件头注释表） */
+export declare function mapRelationError(err: unknown): never;
+//# sourceMappingURL=relation.d.ts.map

package/dist/routes/relation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../../src/routes/relation.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAS5B,0CAA0C;AAC1C,eAAO,MAAM,cAAc,4EAAa,CAAC;AAyEzC,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAWpD"}

package/dist/routes/relation.js

@@ -0,0 +1,87 @@
+// 关系路由（S3.4）：GET / 查询（k 跳遍历）、POST / 创建（判重）、DELETE /:id 物理删
+//
+// 契约来源：doc/api/endpoints.md 第 304-391 行（关系管理）、决策 2（通用关系表）、
+// 决策 12 修订（可见性联动端点状态；手动删关系 = 物理删）。
+// 错误映射（db RelationError → HttpError，对照 endpoints.md 错误码）：
+//   RELATION_EXISTS         → 409 RELATION_EXISTS（同三元组已存在，endpoints.md 第 372-374 行）
+//   ENDPOINT_NOT_FOUND      → 400 VALIDATION_ERROR（端点不存在/软删是参数问题）
+//   INVALID_RELATION_TYPE   → 400 VALIDATION_ERROR（白名单外——schema 层 enum 已拦截，防御分支）
+//   DELETE 0 影响行         → 404 RELATION_NOT_FOUND
+import { Hono } from "hono";
+import { createRelation, deleteRelation, listRelations, RelationError } from "@whispering233/ai-editor-db";
+import { relationCreateReqSchema, relationQuerySchema, } from "@whispering233/ai-editor-shared/schemas";
+import { HttpError, ok } from "../middleware/error.js";
+import { requireCurrentProject } from "../middleware/project.js";
+/** 关系路由（挂载于 /api/v1/relation，index.ts） */
+export const relationRoutes = new Hono();
+// GET /api/v1/relation —— 查询（depth 必填 1|2|3；过滤条件组合；响应 camelCase）
+relationRoutes.get("/", (c) => {
+    const project = requireCurrentProject();
+    const parsed = relationQuerySchema.safeParse(c.req.query());
+    if (!parsed.success) {
+        throw parsed.error; // → 400 VALIDATION_ERROR（depth 缺失/非法等，含 fields）
+    }
+    const { depth, source_type, source_id, target_type, target_id, relation_type } = parsed.data;
+    // snake_case（请求约定）→ camelCase（db 层接口）；undefined 字段透传（db 可选过滤）。
+    // depth 经 schema min(1).max(3) 校验，收窄断言到 db 的 1|2|3 字面量联合
+    const result = listRelations(project.db, { sourceType: source_type, sourceId: source_id, targetType: target_type, targetId: target_id, relationType: relation_type }, depth, project.root);
+    return c.json(ok(result));
+});
+// POST /api/v1/relation —— 创建（判重 409；端点存在性校验；201）
+relationRoutes.post("/", async (c) => {
+    const project = requireCurrentProject();
+    const raw = await c.req.json().catch(() => null);
+    const parsed = relationCreateReqSchema.safeParse(raw);
+    if (!parsed.success) {
+        throw parsed.error; // → 400 VALIDATION_ERROR（含 relation_type enum 白名单、字段校验）
+    }
+    const { source_type, source_id, target_type, target_id, relation_type, metadata } = parsed.data;
+    let row;
+    try {
+        row = createRelation(project.db, {
+            sourceType: source_type,
+            sourceId: source_id,
+            targetType: target_type,
+            targetId: target_id,
+            relationType: relation_type,
+            ...(metadata !== undefined ? { metadata } : {}),
+        }, project.root);
+    }
+    catch (err) {
+        throw mapRelationError(err);
+    }
+    return c.json(ok({
+        id: row.id,
+        relation: {
+            sourceType: row.source_type,
+            sourceId: row.source_id,
+            targetType: row.target_type,
+            targetId: row.target_id,
+            relationType: row.relation_type,
+        },
+    }), 201);
+});
+// DELETE /api/v1/relation/:id —— 物理删除（决策 12 修订：不进回收站）
+relationRoutes.delete("/:id", (c) => {
+    const project = requireCurrentProject();
+    const id = c.req.param("id");
+    const changes = deleteRelation(project.db, id);
+    if (changes === 0) {
+        throw new HttpError(404, "RELATION_NOT_FOUND", `关系不存在: ${id}`);
+    }
+    return c.json(ok({ deleted: true }));
+});
+/** RelationError → HttpError 映射（文件头注释表） */
+export function mapRelationError(err) {
+    if (err instanceof RelationError) {
+        switch (err.code) {
+            case "RELATION_EXISTS":
+                throw new HttpError(409, "RELATION_EXISTS", err.message);
+            case "ENDPOINT_NOT_FOUND":
+            case "INVALID_RELATION_TYPE":
+                throw new HttpError(400, "VALIDATION_ERROR", err.message);
+        }
+    }
+    throw err instanceof Error ? err : new HttpError(500, "INTERNAL_ERROR", "关系操作失败");
+}
+//# sourceMappingURL=relation.js.map

package/dist/routes/relation.js.map

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

package/dist/routes/settings.d.ts

@@ -0,0 +1,37 @@
+import { Hono } from "hono";
+/** 默认模型名（endpoints.md settings 端点） */
+export declare const DEFAULT_MODEL = "deepseek-v4-flash";
+/** DeepSeek key 环境变量（决策 17：环境变量优先于用户级配置） */
+export declare const DEEPSEEK_API_KEY_ENV = "DEEPSEEK_API_KEY";
+/** 用户级配置文件相对 HOME 的路径（决策 17：不入项目文件） */
+export declare const USER_CONFIG_RELATIVE_PATH: string;
+/** 用户级配置文件结构（~/.ai-editor/config.json） */
+export interface UserConfigFile {
+    model?: string;
+    api_key?: string;
+}
+/** 用户级配置文件绝对路径（os.homedir() 读 $HOME，测试设 HOME 即可隔离） */
+export declare function userConfigPath(): string;
+/**
+ * 读取用户级配置；文件不存在或 JSON 损坏 → 返回空配置（默认值语义，不抛错）
+ */
+export declare function getUserConfig(): UserConfigFile;
+/**
+ * 写入用户级配置（合并 partial；显式 undefined 字段不覆盖已有值）；
+ * api_key 为空字符串 = 清除 key 字段
+ * 原子写：复用 @whispering233/ai-editor-db 的 writeJsonAtomic（决策 11 精神完整版：临时文件 wx 独占 +
+ *   文件 fsync + rename + 目录 fsync）。目标在 $HOME/.ai-editor/ 下，目录 fsync 在部分
+ *   平台/文件系统受限时由 db 实现静默忽略（主链路已保证文件内容完整）
+ */
+export declare function saveUserConfig(partial: Partial<UserConfigFile>): UserConfigFile;
+/**
+ * 计算有效 key 与掩码：环境变量 > config.json（决策 17 来源优先级）
+ * 两者都没有 → null（apiKeySet=false，无掩码）
+ */
+export declare function effectiveApiKey(): {
+    key: string | null;
+    masked: string | undefined;
+};
+/** 设置路由（挂载于 /api/v1/settings） */
+export declare const settingsRoutes: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+//# sourceMappingURL=settings.d.ts.map

package/dist/routes/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/routes/settings.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAM5B,sCAAsC;AACtC,eAAO,MAAM,aAAa,sBAAsB,CAAC;AAEjD,4CAA4C;AAC5C,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD,uCAAuC;AACvC,eAAO,MAAM,yBAAyB,QAAoC,CAAC;AAE3E,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,sDAAsD;AACtD,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,cAAc,CAO9C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAW/E;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI;IAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAKpF;AAED,iCAAiC;AACjC,eAAO,MAAM,cAAc,4EAAa,CAAC"}

package/dist/routes/settings.js

@@ -0,0 +1,91 @@
+// 设置路由（S1.3）：GET/PUT /api/v1/settings/llm
+// 契约来源：doc/api/endpoints.md 第 858-890 行、doc/design/decisions.md 决策 17
+// 关键约束（决策 17）：DeepSeek key 只走环境变量 DEEPSEEK_API_KEY 或用户级配置
+//   ~/.ai-editor/config.json（HOME 可覆盖——测试隔离依赖），**绝不写入项目文件**
+import { mkdirSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { Hono } from "hono";
+import { maskApiKey } from "@whispering233/ai-editor-shared";
+import { writeJsonAtomic } from "@whispering233/ai-editor-db";
+import { settingsLlmGetResSchema, settingsLlmPutReqSchema } from "@whispering233/ai-editor-shared/schemas";
+import { ok } from "../middleware/error.js";
+/** 默认模型名（endpoints.md settings 端点） */
+export const DEFAULT_MODEL = "deepseek-v4-flash";
+/** DeepSeek key 环境变量（决策 17：环境变量优先于用户级配置） */
+export const DEEPSEEK_API_KEY_ENV = "DEEPSEEK_API_KEY";
+/** 用户级配置文件相对 HOME 的路径（决策 17：不入项目文件） */
+export const USER_CONFIG_RELATIVE_PATH = join(".ai-editor", "config.json");
+/** 用户级配置文件绝对路径（os.homedir() 读 $HOME，测试设 HOME 即可隔离） */
+export function userConfigPath() {
+    return join(homedir(), USER_CONFIG_RELATIVE_PATH);
+}
+/**
+ * 读取用户级配置；文件不存在或 JSON 损坏 → 返回空配置（默认值语义，不抛错）
+ */
+export function getUserConfig() {
+    try {
+        const raw = readFileSync(userConfigPath(), "utf8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * 写入用户级配置（合并 partial；显式 undefined 字段不覆盖已有值）；
+ * api_key 为空字符串 = 清除 key 字段
+ * 原子写：复用 @whispering233/ai-editor-db 的 writeJsonAtomic（决策 11 精神完整版：临时文件 wx 独占 +
+ *   文件 fsync + rename + 目录 fsync）。目标在 $HOME/.ai-editor/ 下，目录 fsync 在部分
+ *   平台/文件系统受限时由 db 实现静默忽略（主链路已保证文件内容完整）
+ */
+export function saveUserConfig(partial) {
+    const file = userConfigPath();
+    const next = { ...getUserConfig() };
+    if (partial.model !== undefined)
+        next.model = partial.model;
+    if (partial.api_key !== undefined)
+        next.api_key = partial.api_key;
+    if (next.api_key === "") {
+        delete next.api_key; // 空字符串 = 清除已保存 key（endpoints.md PUT 语义）
+    }
+    mkdirSync(dirname(file), { recursive: true }); // writeJsonAtomic 不负责建目录
+    writeJsonAtomic(file, next);
+    return next;
+}
+/**
+ * 计算有效 key 与掩码：环境变量 > config.json（决策 17 来源优先级）
+ * 两者都没有 → null（apiKeySet=false，无掩码）
+ */
+export function effectiveApiKey() {
+    const envKey = process.env[DEEPSEEK_API_KEY_ENV] ?? "";
+    const fileKey = getUserConfig().api_key ?? "";
+    const key = envKey || fileKey || null; // 环境变量优先
+    return key === null ? { key, masked: undefined } : { key, masked: maskApiKey(key) };
+}
+/** 设置路由（挂载于 /api/v1/settings） */
+export const settingsRoutes = new Hono();
+// GET /api/v1/settings/llm —— 读取 LLM 配置（key 不回传明文，仅掩码；决策 17）
+settingsRoutes.get("/llm", (c) => {
+    const { key, masked } = effectiveApiKey();
+    const payload = settingsLlmGetResSchema.parse({
+        model: getUserConfig().model ?? DEFAULT_MODEL,
+        apiKeySet: key !== null,
+        ...(masked ? { apiKeyMasked: masked } : {}),
+    });
+    return c.json(ok(payload));
+});
+// PUT /api/v1/settings/llm —— 更新 LLM 配置（写入 ~/.ai-editor/config.json，绝不入项目文件，决策 17）
+settingsRoutes.put("/llm", async (c) => {
+    const raw = await c.req.json().catch(() => null); // 空 body / 非法 JSON → 校验失败
+    const parsed = settingsLlmPutReqSchema.safeParse(raw);
+    if (!parsed.success) {
+        throw parsed.error; // → app.onError → 400 VALIDATION_ERROR（含 fields）
+    }
+    saveUserConfig({
+        model: parsed.data.model,
+        api_key: parsed.data.api_key,
+    });
+    return c.json(ok({ saved: true })); // settingsLlmPutResSchema 形状
+});
+//# sourceMappingURL=settings.js.map

package/dist/routes/settings.js.map

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

package/dist/routes/trash.d.ts

@@ -0,0 +1,4 @@
+import { Hono } from "hono";
+/** 回收站路由（挂载于 /api/v1/trash，index.ts） */
+export declare const trashRoutes: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+//# sourceMappingURL=trash.d.ts.map

package/dist/routes/trash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trash.d.ts","sourceRoot":"","sources":["../../src/routes/trash.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAU5B,wCAAwC;AACxC,eAAO,MAAM,WAAW,4EAAa,CAAC"}

package/dist/routes/trash.js

@@ -0,0 +1,135 @@
+// 回收站路由（S2.2 大纲侧 + S4.3 实体侧）：GET /trash、restore 实体/节点、purge 实体/节点
+//
+// 契约来源：doc/api/endpoints.md 第 660-736 行、决策 12（软删/级联还原/物理清除）。
+// 组织说明：大纲侧（S2.2）与实体侧（S4.3）同文件；relation/delta 级联 helper 在 db 包
+// queries/trash.ts（S4.1 下沉）；实体 restore/purge 为纯 DB 操作（无 outline.json 侧），
+// 写序天然满足「先 DB 后 JSON」（决策 16）。
+// restore 祖先链校验（大纲侧）：存在软删祖先 → 409 OUTLINE_ANCESTOR_DELETED（决策 12 修订）。
+// purge 语义拦截（两侧同构）：未软删对象拒绝 purge——仅用于回收站清理。
+import { Hono } from "hono";
+import { cascadePurge, cascadeRestore, getOutlinePathIds, readOutlineFile } from "@whispering233/ai-editor-db";
+import { listDeletedEntities, listDeletedNodes, purgeEntity, purgeOutlineNode, restoreEntity, restoreOutlineNode } from "@whispering233/ai-editor-db";
+import { nowIso } from "@whispering233/ai-editor-db";
+import { HttpError, ok } from "../middleware/error.js";
+import { requireCurrentProject } from "../middleware/project.js";
+import { collectSubtreeIds, mapOutlineError } from "./outline.js";
+import { parseTypeParam } from "./entity.js";
+/** 回收站路由（挂载于 /api/v1/trash，index.ts） */
+export const trashRoutes = new Hono();
+// GET /api/v1/trash —— 回收站列表（大纲侧 + 实体侧，endpoints.md 第 664-674 行）
+trashRoutes.get("/", (c) => {
+    const project = requireCurrentProject();
+    const nodes = listDeletedNodes(project.root).map((n) => ({
+        id: n.id,
+        type: n.type,
+        title: n.title,
+        deletedAt: n.deleted_at,
+    }));
+    // 实体侧：db 层 listDeletedEntities 已返回 camelCase deletedAt（S4.1），直接透传
+    return c.json(ok({ entities: listDeletedEntities(project.db), nodes }));
+});
+// POST /api/v1/trash/outline/:nodeId/restore —— 还原（级联还原子树 + 关联关系与 Delta）
+// 写序（决策 16）：**先 DB 后 JSON**——先级联还原 relation/delta，再原子写 outline.json。
+// 祖先链预校验必须在 DB 级联**之前**：409 拒绝的请求不产生任何副作用
+// （restoreOutlineNode 内部的校验在 JSON 写前，但 DB 已先行——此处路由层先拦截）
+trashRoutes.post("/outline/:nodeId/restore", (c) => {
+    const project = requireCurrentProject();
+    const nodeId = c.req.param("nodeId");
+    const tree = readOutlineFile(project.root);
+    const subtreeIds = collectSubtreeIds(tree, nodeId); // 404 语义
+    // 0. 祖先链预校验（决策 12 修订）：存在软删祖先 → 409，且不产生任何 DB 副作用
+    const path = getOutlinePathIds(tree, nodeId);
+    for (const ancestorId of path.slice(1, -1)) {
+        const ancestor = findNodeById(tree, ancestorId);
+        if (ancestor?.deleted === true) {
+            throw new HttpError(409, "OUTLINE_ANCESTOR_DELETED", `存在软删祖先 ${ancestorId}，请先还原祖先再还原本节点`);
+        }
+    }
+    // 1. DB 级联还原（决策 12 修订：全部还原，不因另一端仍软删而跳过）
+    const { relations, deltas } = cascadeRestore(project.db, subtreeIds);
+    // 2. JSON 原子写（还原节点 + 递归子树；db 层校验为双保险）
+    let restoredChildren;
+    try {
+        restoredChildren = restoreOutlineNode(project.root, nodeId, nowIso()).children;
+    }
+    catch (err) {
+        throw mapOutlineError(err); // OUTLINE_ANCESTOR_DELETED → 409（预校验后不可达，防御）
+    }
+    return c.json(ok({ restored: true, restoredChildren, restoredRelations: relations, restoredDeltas: deltas }));
+});
+// DELETE /api/v1/trash/outline/:nodeId —— 物理清除（purge，不可恢复；仅用于回收站清理）
+// 写序（决策 16）：**先 DB 后 JSON**——先物理清除 relation/delta，再原子写 outline.json
+trashRoutes.delete("/outline/:nodeId", (c) => {
+    const project = requireCurrentProject();
+    const nodeId = c.req.param("nodeId");
+    const tree = readOutlineFile(project.root);
+    const subtreeIds = collectSubtreeIds(tree, nodeId); // 404 语义
+    // 回收站语义拦截（oracle 审核建议）：purge 仅用于回收站清理——节点未软删拒绝，
+    // 防误调把未进回收站的数据物理清掉
+    if (!isSoftDeleted(tree, nodeId)) {
+        throw new HttpError(400, "VALIDATION_ERROR", `节点未软删，purge 仅用于回收站清理: ${nodeId}`);
+    }
+    // 1. DB 物理清除关联关系与 Delta
+    cascadePurge(project.db, subtreeIds);
+    // 2. JSON 原子写（移除整棵子树；物理删除的极端崩溃窗口：DB 已清、JSON 未清，
+    //    不在 S4.2 一致性校验范围——其只兜软删联动（决策 16 修订），同步操作中途
+    //    崩溃概率极低，注释明示）
+    purgeOutlineNode(project.root, nodeId);
+    return c.json(ok({ purged: true }));
+});
+// POST /api/v1/trash/entity/:type/:id/restore —— 还原软删实体（endpoints.md 第 676-692 行，决策 12 修订）
+// 纯 DB 操作：自身 deleted_at 置 NULL + updated_at 刷新（S4.1 db 层），级联还原关联关系与 Delta
+// （全部还原，不因另一端仍软删而跳过——可见性由查询层兜底，端点还原后自动可见）。
+// db 层幂等：实体不存在、类型不匹配或未软删 → null → 404（endpoints.md 第 689 行）。
+trashRoutes.post("/entity/:type/:id/restore", (c) => {
+    const project = requireCurrentProject();
+    const type = parseTypeParam(c.req.param("type"));
+    const id = c.req.param("id");
+    const result = restoreEntity(project.db, type, id);
+    if (result === null) {
+        throw new HttpError(404, "ENTITY_NOT_FOUND", `实体不存在或未软删: ${id}`);
+    }
+    return c.json(ok({ restored: true, restoredRelations: result.restoredRelations, restoredDeltas: result.restoredDeltas }));
+});
+// DELETE /api/v1/trash/entity/:type/:id —— 物理清除（purge，endpoints.md 第 713-724 行；不可恢复，
+// 仅用于回收站清理）。拦截顺序与 outline purge 同构：先 404（不存在）后 400（未软删）——
+// 未软删对象拒绝，防误调把未进回收站的数据物理清掉（oracle 审核建议）。
+trashRoutes.delete("/entity/:type/:id", (c) => {
+    const project = requireCurrentProject();
+    const type = parseTypeParam(c.req.param("type"));
+    const id = c.req.param("id");
+    // 存在性 + 软删状态检查（原始 SQL：路由守卫，S4.1 purgeEntity 明确不校验「必须已软删」，
+    //   outline purge 的 isSoftDeleted 同构——db 层只保证原子物理清除）
+    const row = project.db
+        .prepare("SELECT deleted_at FROM entities WHERE id = ? AND type = ?")
+        .get(id, type);
+    if (row === undefined) {
+        throw new HttpError(404, "ENTITY_NOT_FOUND", `实体不存在: ${id}`);
+    }
+    if (row.deleted_at === null) {
+        throw new HttpError(400, "VALIDATION_ERROR", `实体未软删，purge 仅用于回收站清理: ${id}`);
+    }
+    if (purgeEntity(project.db, type, id) === null) {
+        throw new HttpError(404, "ENTITY_NOT_FOUND", `实体不存在: ${id}`); // 防御（上一步已确认存在）
+    }
+    return c.json(ok({ purged: true }));
+});
+/** 从树中按 id 找节点（restore 祖先预校验 / purge 拦截用；不存在由 collectSubtreeIds 先抛 404） */
+function findNodeById(tree, nodeId) {
+    const visit = (nodes) => {
+        for (const n of nodes) {
+            if (n.id === nodeId)
+                return n;
+            const found = visit(n.children ?? []);
+            if (found !== undefined)
+                return found;
+        }
+        return undefined;
+    };
+    return visit(tree.children);
+}
+/** 判断节点是否已软删（purge 拦截校验用） */
+function isSoftDeleted(tree, nodeId) {
+    return findNodeById(tree, nodeId)?.deleted === true;
+}
+//# sourceMappingURL=trash.js.map

package/dist/routes/trash.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@whispering233/ai-editor-server",
+  "version": "0.0.1",
+  "description": "Hono API 服务端（单进程：API + SPA 静态托管，决策 8）",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "ai-editor": "dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "client-dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "NODE_ENV=development tsx watch src/index.ts",
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "lint": "eslint .",
+    "prepack": "node ../../scripts/copy-client-dist.mjs && node ../../scripts/prepare-package-for-publish.mjs",
+    "postpack": "node ../../scripts/restore-package-json.mjs"
+  },
+  "dependencies": {
+    "@whispering233/ai-editor-agent": "0.0.1",
+    "@whispering233/ai-editor-db": "0.0.1",
+    "@whispering233/ai-editor-llm": "0.0.1",
+    "@whispering233/ai-editor-shared": "0.0.1",
+    "@whispering233/ai-editor-tools": "0.0.1",
+    "@hono/node-server": "^2.0.12",
+    "fflate": "^0.8.3",
+    "hono": "^4.7.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^24.13.3",
+    "tsx": "^4.23.1",
+    "typescript": "^5.8.0"
+  }
+}