zero-workspace 0.0.2

package/dist/services/MemoService.js

@@ -0,0 +1,288 @@
+// src/services/MemoService.ts
+import { ZeroError } from "../types/errors.js";
+import { generateMemoId, generateMemoDirName } from "../utils/id.js";
+import { now } from "../utils/time.js";
+import { devLog } from "../utils/devLog.js";
+import { eventService } from "./EventService.js";
+import { computeContentHash } from "../utils/hash.js";
+/**
+ * Memo 服务
+ * 处理备忘相关的业务逻辑
+ */
+export class MemoService {
+    json;
+    md;
+    fs;
+    constructor(json, md, fs) {
+        this.json = json;
+        this.md = md;
+        this.fs = fs;
+    }
+    /**
+     * 根据 workspaceId 获取工作区信息
+     */
+    async resolveWorkspaceInfo(workspaceId) {
+        const index = await this.json.readIndex();
+        const wsEntry = index.workspaces.find(ws => ws.id === workspaceId);
+        if (!wsEntry) {
+            devLog.workspaceLookup(workspaceId, false);
+            throw new ZeroError("WORKSPACE_NOT_FOUND", `工作区 "${workspaceId}" 不存在`);
+        }
+        if (wsEntry.status === "error" && wsEntry.errorInfo) {
+            throw new ZeroError("WORKSPACE_ERROR", `工作区 "${workspaceId}" 处于错误状态: ${wsEntry.errorInfo.message}`);
+        }
+        const wsDirName = wsEntry.dirName || wsEntry.id;
+        devLog.workspaceLookup(workspaceId, true, wsEntry.status);
+        return {
+            projectRoot: wsEntry.projectRoot,
+            wsDirName,
+        };
+    }
+    /**
+     * 创建备忘
+     */
+    async create(params) {
+        const { workspaceId, title, summary, content, tags = [] } = params;
+        // 1. 校验 tags：过滤空白，至少2个有效标签
+        const validTags = tags
+            .map(tag => tag.trim())
+            .filter(tag => tag.length > 0);
+        if (validTags.length < 2) {
+            throw new ZeroError("INVALID_PARAMS", `tags 至少需要2个有效标签，当前有效标签数: ${validTags.length}`);
+        }
+        // 2. 获取工作区信息
+        const { projectRoot, wsDirName } = await this.resolveWorkspaceInfo(workspaceId);
+        // 3. 生成备忘 ID 和目录名
+        const memoId = generateMemoId();
+        const memoDirName = generateMemoDirName(title, memoId);
+        const timestamp = now();
+        // 4. 构造备忘对象
+        const memo = {
+            id: memoId,
+            title,
+            summary,
+            content,
+            tags: validTags,
+            createdAt: timestamp,
+            updatedAt: timestamp,
+        };
+        // 5. 读取 graph.json
+        const graph = await this.json.readGraph(projectRoot, wsDirName);
+        // 6. 初始化 memos 字段（如果不存在）
+        if (!graph.memos) {
+            graph.memos = {};
+        }
+        // 7. 添加备忘到索引
+        graph.memos[memoId] = {
+            id: memoId,
+            title,
+            summary,
+            tags: validTags,
+            contentLength: content.length,
+            dirName: memoDirName,
+            createdAt: timestamp,
+            updatedAt: timestamp,
+        };
+        // 8. 写回 graph.json
+        await this.json.writeGraph(projectRoot, wsDirName, graph);
+        // 9. 创建备忘目录
+        const memoDir = this.fs.getMemoDir(projectRoot, wsDirName, memoDirName);
+        await this.fs.ensureDir(memoDir);
+        // 10. 写入 Content.md
+        const contentPath = this.fs.getMemoContentPath(projectRoot, wsDirName, memoDirName);
+        await this.fs.writeFile(contentPath, content);
+        // 11. 发送事件通知
+        eventService.emitMemoUpdate(workspaceId, memoId);
+        // 12. 返回结果
+        const relativePath = `memos/${memoDirName}/Content.md`;
+        return {
+            memoId,
+            path: relativePath,
+            hint: `备忘已创建。使用 node_reference(nodeId, "memo://${memoId}", "add") 关联到节点。`,
+        };
+    }
+    /**
+     * 列出备忘（支持 tag 过滤）
+     */
+    async list(params) {
+        const { workspaceId, tags } = params;
+        // 1. 获取工作区信息
+        const { projectRoot, wsDirName } = await this.resolveWorkspaceInfo(workspaceId);
+        // 2. 读取 graph.json
+        const graph = await this.json.readGraph(projectRoot, wsDirName);
+        // 3. 获取备忘索引
+        const memosIndex = graph.memos || {};
+        let memosList = Object.values(memosIndex);
+        // 4. 如果指定了 tags 过滤
+        if (tags && tags.length > 0) {
+            memosList = memosList.filter(memo => tags.some(tag => memo.tags.includes(tag)));
+        }
+        // 5. 收集所有已使用的 tags
+        const allTagsSet = new Set();
+        Object.values(memosIndex).forEach(memo => {
+            memo.tags.forEach(tag => allTagsSet.add(tag));
+        });
+        const allTags = Array.from(allTagsSet).sort();
+        // 6. 按更新时间倒序排序
+        memosList.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+        return {
+            memos: memosList,
+            allTags,
+            hint: memosList.length === 0
+                ? "当前工作区暂无备忘。使用 memo_create 创建第一条备忘。"
+                : undefined,
+        };
+    }
+    /**
+     * 获取备忘内容（支持按行分页）
+     */
+    async get(params) {
+        const { workspaceId, memoId, lineOffset = 1, lineLimit = 500 } = params;
+        // 1. 获取工作区信息
+        const { projectRoot, wsDirName } = await this.resolveWorkspaceInfo(workspaceId);
+        // 2. 读取 graph.json
+        const graph = await this.json.readGraph(projectRoot, wsDirName);
+        // 3. 检查备忘是否存在
+        const memosIndex = graph.memos || {};
+        const memoMeta = memosIndex[memoId];
+        if (!memoMeta) {
+            throw new ZeroError("MEMO_NOT_FOUND", `备忘 "${memoId}" 不存在`);
+        }
+        // 4. 读取 Content.md
+        const memoDirName = memoMeta.dirName;
+        const contentPath = this.fs.getMemoContentPath(projectRoot, wsDirName, memoDirName);
+        const fullContent = await this.fs.readFile(contentPath);
+        // 5. 按行分页
+        const lines = fullContent.split("\n");
+        const totalLines = lines.length;
+        const startLine = Math.max(1, Math.min(lineOffset, totalLines));
+        const endLine = Math.min(startLine + lineLimit - 1, totalLines);
+        const content = lines.slice(startLine - 1, endLine).join("\n");
+        const contentTruncated = startLine > 1 || endLine < totalLines;
+        // 6. 构造备忘对象
+        const memo = {
+            ...memoMeta,
+            content,
+        };
+        // 7. 计算内容 hash（基于完整内容）
+        const contentHash = computeContentHash(fullContent);
+        // 8. 返回结果
+        const result = { memo, totalLines, contentHash };
+        if (contentTruncated) {
+            result.contentTruncated = true;
+            // 生成继续读取提示
+            if (endLine < totalLines) {
+                result.hint = `已返回第 ${startLine}-${endLine} 行（共 ${totalLines} 行）。继续读取：memo_get({ lineOffset: ${endLine + 1} })`;
+            }
+        }
+        return result;
+    }
+    /**
+     * 更新备忘
+     */
+    async update(params) {
+        const { workspaceId, memoId, contentHash, title, summary, content, field, old_str, new_str, tags } = params;
+        // 0. 校验 contentHash 必填
+        if (!contentHash) {
+            throw new ZeroError("INVALID_PARAMS", "请先 memo_get 获取 contentHash");
+        }
+        // 1. 获取工作区信息
+        const { projectRoot, wsDirName } = await this.resolveWorkspaceInfo(workspaceId);
+        // 2. 读取 graph.json
+        const graph = await this.json.readGraph(projectRoot, wsDirName);
+        // 3. 检查备忘是否存在
+        const memosIndex = graph.memos || {};
+        const memoMeta = memosIndex[memoId];
+        if (!memoMeta) {
+            throw new ZeroError("MEMO_NOT_FOUND", `备忘 "${memoId}" 不存在`);
+        }
+        // 4. 获取目录名并读取当前内容
+        const memoDirName = memoMeta.dirName;
+        const contentPath = this.fs.getMemoContentPath(projectRoot, wsDirName, memoDirName);
+        const existingContent = await this.fs.readFile(contentPath);
+        // 5. 校验 contentHash
+        const currentHash = computeContentHash(existingContent);
+        if (currentHash !== contentHash) {
+            throw new ZeroError("CONTENT_CHANGED", "内容已变更，请重新 memo_get");
+        }
+        // 6. 处理内容更新
+        let finalContent;
+        // 6.1 精确替换模式
+        if (field && old_str !== undefined && new_str !== undefined) {
+            const escapeRegExp = (str) => str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            const targetContent = field === 'content' ? existingContent : memoMeta.summary;
+            const regex = new RegExp(escapeRegExp(old_str), 'g');
+            const matches = targetContent.match(regex);
+            const count = matches ? matches.length : 0;
+            if (count === 0) {
+                throw new ZeroError("NO_MATCH", "未找到匹配内容");
+            }
+            if (count > 1) {
+                throw new ZeroError("MULTI_MATCH", `找到 ${count} 处匹配，请提供更多上下文`);
+            }
+            // 执行替换
+            if (field === 'content') {
+                finalContent = targetContent.replace(old_str, new_str);
+            }
+            else {
+                memoMeta.summary = targetContent.replace(old_str, new_str);
+            }
+        }
+        // 6.2 全量替换模式
+        if (content !== undefined) {
+            finalContent = content;
+        }
+        // 7. 更新备忘元数据
+        const timestamp = now();
+        if (title !== undefined)
+            memoMeta.title = title;
+        if (summary !== undefined)
+            memoMeta.summary = summary;
+        if (tags !== undefined)
+            memoMeta.tags = tags;
+        if (finalContent !== undefined)
+            memoMeta.contentLength = finalContent.length;
+        memoMeta.updatedAt = timestamp;
+        // 8. 写回 graph.json
+        await this.json.writeGraph(projectRoot, wsDirName, graph);
+        // 9. 更新 Content.md（如果有内容变更）
+        if (finalContent !== undefined) {
+            await this.fs.writeFile(contentPath, finalContent);
+        }
+        // 10. 发送事件通知
+        eventService.emitMemoUpdate(workspaceId, memoId);
+        return {
+            success: true,
+            updatedAt: timestamp,
+        };
+    }
+    /**
+     * 删除备忘
+     */
+    async delete(params) {
+        const { workspaceId, memoId } = params;
+        // 1. 获取工作区信息
+        const { projectRoot, wsDirName } = await this.resolveWorkspaceInfo(workspaceId);
+        // 2. 读取 graph.json
+        const graph = await this.json.readGraph(projectRoot, wsDirName);
+        // 3. 检查备忘是否存在
+        const memosIndex = graph.memos || {};
+        const memoMeta = memosIndex[memoId];
+        if (!memoMeta) {
+            throw new ZeroError("MEMO_NOT_FOUND", `备忘 "${memoId}" 不存在`);
+        }
+        // 4. 获取目录名
+        const memoDirName = memoMeta.dirName;
+        // 5. 从索引中删除
+        delete memosIndex[memoId];
+        // 6. 写回 graph.json
+        await this.json.writeGraph(projectRoot, wsDirName, graph);
+        // 7. 删除备忘目录
+        const memoDir = this.fs.getMemoDir(projectRoot, wsDirName, memoDirName);
+        await this.fs.remove(memoDir);
+        // 8. 发送事件通知
+        eventService.emitMemoUpdate(workspaceId, memoId);
+        return { success: true };
+    }
+}
+//# sourceMappingURL=MemoService.js.map

package/dist/services/MemoService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoService.js","sourceRoot":"","sources":["../../src/services/MemoService.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAmB9B,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrE,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;GAGG;AACH,MAAM,OAAO,WAAW;IAEZ;IACA;IACA;IAHV,YACU,IAAiB,EACjB,EAAmB,EACnB,EAAqB;QAFrB,SAAI,GAAJ,IAAI,CAAa;QACjB,OAAE,GAAF,EAAE,CAAiB;QACnB,OAAE,GAAF,EAAE,CAAmB;IAC5B,CAAC;IAEJ;;OAEG;IACK,KAAK,CAAC,oBAAoB,CAAC,WAAmB;QACpD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC;QACnE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;YAC3C,MAAM,IAAI,SAAS,CAAC,qBAAqB,EAAE,QAAQ,WAAW,OAAO,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACpD,MAAM,IAAI,SAAS,CAAC,iBAAiB,EAAE,QAAQ,WAAW,aAAa,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;QACtG,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,EAAE,CAAC;QAChD,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1D,OAAO;YACL,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,SAAS;SACV,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,MAAwB;QACnC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;QAEnE,2BAA2B;QAC3B,MAAM,SAAS,GAAG,IAAI;aACnB,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;aACtB,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEjC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,SAAS,CACjB,gBAAgB,EAChB,4BAA4B,SAAS,CAAC,MAAM,EAAE,CAC/C,CAAC;QACJ,CAAC;QAED,aAAa;QACb,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAEhF,kBAAkB;QAClB,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,WAAW,GAAG,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC;QAExB,YAAY;QACZ,MAAM,IAAI,GAAS;YACjB,EAAE,EAAE,MAAM;YACV,KAAK;YACL,OAAO;YACP,OAAO;YACP,IAAI,EAAE,SAAS;YACf,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,SAAS;SACrB,CAAC;QAEF,mBAAmB;QACnB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAEhE,yBAAyB;QACzB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACjB,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC;QACnB,CAAC;QAED,aAAa;QACb,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG;YACpB,EAAE,EAAE,MAAM;YACV,KAAK;YACL,OAAO;YACP,IAAI,EAAE,SAAS;YACf,aAAa,EAAE,OAAO,CAAC,MAAM;YAC7B,OAAO,EAAE,WAAW;YACpB,SAAS,EAAE,SAAS;YACpB,SAAS,EAAE,SAAS;SACrB,CAAC;QAEF,mBAAmB;QACnB,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAE1D,YAAY;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACxE,MAAM,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAEjC,oBAAoB;QACpB,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACpF,MAAM,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAE9C,aAAa;QACb,YAAY,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAEjD,WAAW;QACX,MAAM,YAAY,GAAG,SAAS,WAAW,aAAa,CAAC;QACvD,OAAO;YACL,MAAM;YACN,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,2CAA2C,MAAM,kBAAkB;SAC1E,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,MAAsB;QAC/B,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAErC,aAAa;QACb,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAEhF,mBAAmB;QACnB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAEhE,YAAY;QACZ,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QACrC,IAAI,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAE1C,mBAAmB;QACnB,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAClC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAC1C,CAAC;QACJ,CAAC;QAED,mBAAmB;QACnB,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACvC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;QAE9C,eAAe;QACf,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;QAEjE,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,OAAO;YACP,IAAI,EAAE,SAAS,CAAC,MAAM,KAAK,CAAC;gBAC1B,CAAC,CAAC,mCAAmC;gBACrC,CAAC,CAAC,SAAS;SACd,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,MAAqB;QAC7B,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,CAAC,EAAE,SAAS,GAAG,GAAG,EAAE,GAAG,MAAM,CAAC;QAExE,aAAa;QACb,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAEhF,mBAAmB;QACnB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAEhE,cAAc;QACd,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,SAAS,CAAC,gBAAgB,EAAE,OAAO,MAAM,OAAO,CAAC,CAAC;QAC9D,CAAC;QAED,mBAAmB;QACnB,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC;QACrC,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACpF,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAExD,UAAU;QACV,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,SAAS,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,MAAM,gBAAgB,GAAG,SAAS,GAAG,CAAC,IAAI,OAAO,GAAG,UAAU,CAAC;QAE/D,YAAY;QACZ,MAAM,IAAI,GAAS;YACjB,GAAG,QAAQ;YACX,OAAO;SACR,CAAC;QAEF,uBAAuB;QACvB,MAAM,WAAW,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAEpD,UAAU;QACV,MAAM,MAAM,GAAkB,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;QAChE,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC;YAC/B,WAAW;YACX,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;gBACzB,MAAM,CAAC,IAAI,GAAG,QAAQ,SAAS,IAAI,OAAO,QAAQ,UAAU,mCAAmC,OAAO,GAAG,CAAC,KAAK,CAAC;YAClH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,MAAwB;QACnC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAE5G,uBAAuB;QACvB,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,SAAS,CAAC,gBAAgB,EAAE,4BAA4B,CAAC,CAAC;QACtE,CAAC;QAED,aAAa;QACb,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAEhF,mBAAmB;QACnB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAEhE,cAAc;QACd,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,SAAS,CAAC,gBAAgB,EAAE,OAAO,MAAM,OAAO,CAAC,CAAC;QAC9D,CAAC;QAED,kBAAkB;QAClB,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC;QACrC,MAAM,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACpF,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAE5D,oBAAoB;QACpB,MAAM,WAAW,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC;QACxD,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;YAChC,MAAM,IAAI,SAAS,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC;QAC/D,CAAC;QAED,YAAY;QACZ,IAAI,YAAgC,CAAC;QAErC,aAAa;QACb,IAAI,KAAK,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC5D,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;YACjF,MAAM,aAAa,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC/E,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;YACrD,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;gBAChB,MAAM,IAAI,SAAS,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YAC7C,CAAC;YACD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACd,MAAM,IAAI,SAAS,CAAC,aAAa,EAAE,MAAM,KAAK,eAAe,CAAC,CAAC;YACjE,CAAC;YACD,OAAO;YACP,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,YAAY,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACzD,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;QAED,aAAa;QACb,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,YAAY,GAAG,OAAO,CAAC;QACzB,CAAC;QAED,aAAa;QACb,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC;QACxB,IAAI,KAAK,KAAK,SAAS;YAAE,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;QAChD,IAAI,OAAO,KAAK,SAAS;YAAE,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAC;QACtD,IAAI,IAAI,KAAK,SAAS;YAAE,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC;QAC7C,IAAI,YAAY,KAAK,SAAS;YAAE,QAAQ,CAAC,aAAa,GAAG,YAAY,CAAC,MAAM,CAAC;QAC7E,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;QAE/B,mBAAmB;QACnB,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAE1D,4BAA4B;QAC5B,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;QACrD,CAAC;QAED,aAAa;QACb,YAAY,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAEjD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,SAAS;SACrB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,MAAwB;QACnC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAEvC,aAAa;QACb,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,CAAC;QAEhF,mBAAmB;QACnB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAEhE,cAAc;QACd,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,SAAS,CAAC,gBAAgB,EAAE,OAAO,MAAM,OAAO,CAAC,CAAC;QAC9D,CAAC;QAED,WAAW;QACX,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC;QAErC,YAAY;QACZ,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;QAE1B,mBAAmB;QACnB,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAE1D,YAAY;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QACxE,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAE9B,YAAY;QACZ,YAAY,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAEjD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;CACF"}

package/dist/services/NodeService.d.ts

@@ -0,0 +1,90 @@
+import type { FileSystemAdapter } from "../storage/FileSystemAdapter.js";
+import type { JsonStorage } from "../storage/JsonStorage.js";
+import type { MarkdownStorage } from "../storage/MarkdownStorage.js";
+import type { NodeCreateParams, NodeCreateResult, NodeGetParams, NodeGetResult, NodeListParams, NodeListResult, NodeDeleteParams, NodeDeleteResult, NodeUpdateParams, NodeUpdateResult, NodeMoveParams, NodeMoveResult } from "../types/node.js";
+/**
+ * 内部调用专用的 magic hash，绕过 rulesHash 验证
+ * 仅供 capability_select 等内部模块使用
+ */
+export declare const INTERNAL_RULES_HASH = "__internal__";
+/**
+ * 节点服务
+ * 处理节点相关的业务逻辑
+ */
+export declare class NodeService {
+    private json;
+    private md;
+    private fs;
+    private stateService?;
+    private guidanceService;
+    constructor(json: JsonStorage, md: MarkdownStorage, fs: FileSystemAdapter);
+    /**
+     * 设置 StateService 依赖（用于 token 生成）
+     */
+    setStateService(stateService: import("./StateService.js").StateService): void;
+    /**
+     * 根据 workspaceId 获取 projectRoot 和 wsDirName
+     */
+    private resolveProjectRoot;
+    /**
+     * 根据 workspaceId 获取工作区信息（包括归档状态和目录名）
+     */
+    private resolveWorkspaceInfo;
+    /**
+     * 解析并验证节点目录名
+     * 当 graph.json 中的 dirName 对应的目录不存在时，尝试通过 shortId 查找实际目录
+     * 这是运行时兜底机制，用于处理迁移失败或遗漏的情况
+     *
+     * @param projectRoot 项目根目录
+     * @param wsDirName 工作区目录名
+     * @param nodeId 节点 ID
+     * @param meta 节点元数据
+     * @param isArchived 是否归档
+     * @returns 实际的节点目录名
+     */
+    private resolveNodeDirName;
+    /**
+     * 创建节点
+     */
+    create(params: NodeCreateParams): Promise<NodeCreateResult>;
+    /**
+     * 获取节点详情
+     */
+    get(params: NodeGetParams): Promise<NodeGetResult>;
+    /**
+     * 获取节点树
+     */
+    list(params: NodeListParams): Promise<NodeListResult>;
+    /**
+     * 递归构建节点树
+     */
+    private buildNodeTree;
+    /**
+     * 删除节点及子树
+     */
+    delete(params: NodeDeleteParams): Promise<NodeDeleteResult>;
+    /**
+     * 递归收集所有子节点 ID（包括自身）
+     */
+    private collectAllChildren;
+    /**
+     * 更新节点
+     */
+    update(params: NodeUpdateParams): Promise<NodeUpdateResult>;
+    /**
+     * 移动节点到新的父节点
+     */
+    move(params: NodeMoveParams): Promise<NodeMoveResult>;
+    /**
+     * 重新排序节点的子节点
+     * @param workspaceId 工作区 ID
+     * @param nodeId 父节点 ID
+     * @param orderedChildIds 排序后的子节点 ID 数组
+     */
+    reorderChildren(params: {
+        workspaceId: string;
+        nodeId: string;
+        orderedChildIds: string[];
+    }): Promise<void>;
+}
+//# sourceMappingURL=NodeService.d.ts.map

package/dist/services/NodeService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeService.d.ts","sourceRoot":"","sources":["../../src/services/NodeService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,cAAc,EAKf,MAAM,kBAAkB,CAAC;AAS1B;;;GAGG;AACH,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAIlD;;;GAGG;AACH,qBAAa,WAAW;IAKpB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,EAAE;IANZ,OAAO,CAAC,YAAY,CAAC,CAA2C;IAChE,OAAO,CAAC,eAAe,CAAkB;gBAG/B,IAAI,EAAE,WAAW,EACjB,EAAE,EAAE,eAAe,EACnB,EAAE,EAAE,iBAAiB;IAK/B;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,OAAO,mBAAmB,EAAE,YAAY,GAAG,IAAI;IAI7E;;OAEG;YACW,kBAAkB;IAehC;;OAEG;YACW,oBAAoB;IA4BlC;;;;;;;;;;;OAWG;YACW,kBAAkB;IAkDhC;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwZjE;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAyExD;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAqB3D;;OAEG;YACW,aAAa;IA6C3B;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgGjE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkB1B;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkKjE;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAqG3D;;;;;OAKG;IACG,eAAe,CAAC,MAAM,EAAE;QAC5B,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,EAAE,CAAC;KAC3B,GAAG,OAAO,CAAC,IAAI,CAAC;CAmClB"}