zero-workspace 0.0.2

package/dist/services/SearchService.js

@@ -0,0 +1,293 @@
+// src/services/SearchService.ts
+import { ZeroError } from "../types/errors.js";
+/**
+ * 搜索服务
+ */
+export class SearchService {
+    json;
+    md;
+    fs;
+    constructor(json, md, fs) {
+        this.json = json;
+        this.md = md;
+        this.fs = fs;
+    }
+    /**
+     * 搜索工作区
+     */
+    async workspaceSearch(params) {
+        const { query, limit = 10 } = params;
+        const lowerQuery = query.toLowerCase();
+        const index = await this.json.readIndex();
+        const matches = [];
+        for (const ws of index.workspaces) {
+            if (ws.status !== "active")
+                continue;
+            const matchedIn = [];
+            // 搜索名称
+            if (ws.name.toLowerCase().includes(lowerQuery)) {
+                matchedIn.push("name");
+            }
+            // 读取工作区详情搜索 goal 和 rules
+            try {
+                const wsDirName = ws.dirName || ws.id;
+                const workspaceMd = await this.md.readWorkspaceMd(ws.projectRoot, wsDirName);
+                // 从根节点读取 goal（requirement 字段）- goal 已统一到根节点
+                const config = await this.json.readWorkspaceConfig(ws.projectRoot, wsDirName);
+                const graph = await this.json.readGraph(ws.projectRoot, wsDirName);
+                const rootNodeId = config.rootNodeId || "root";
+                const rootNodeMeta = graph.nodes[rootNodeId];
+                const rootNodeDirName = rootNodeMeta?.dirName || rootNodeId;
+                const rootNodeInfo = await this.md.readNodeInfo(ws.projectRoot, wsDirName, rootNodeDirName);
+                const goal = rootNodeInfo.requirement || "";
+                if (goal.toLowerCase().includes(lowerQuery)) {
+                    matchedIn.push("goal");
+                }
+                if (workspaceMd.rules.some(rule => rule.toLowerCase().includes(lowerQuery))) {
+                    matchedIn.push("rules");
+                }
+                if (matchedIn.length > 0) {
+                    matches.push({
+                        id: ws.id,
+                        name: ws.name,
+                        goal,
+                        matchedIn,
+                    });
+                }
+            }
+            catch {
+                // 读取失败，跳过
+            }
+            if (matches.length >= limit + 1)
+                break;
+        }
+        const hasMore = matches.length > limit;
+        return {
+            workspaces: matches.slice(0, limit),
+            hasMore,
+        };
+    }
+    /**
+     * 搜索工作区内容
+     */
+    async contentSearch(params) {
+        const { workspaceId, query, id, target = "all", limit = 20, context = 1 } = params;
+        const lowerQuery = query.toLowerCase();
+        // 获取工作区信息
+        const index = await this.json.readIndex();
+        const wsEntry = index.workspaces.find(ws => ws.id === workspaceId);
+        if (!wsEntry) {
+            throw new ZeroError("WORKSPACE_NOT_FOUND", `工作区 "${workspaceId}" 不存在`);
+        }
+        const { projectRoot } = wsEntry;
+        const wsDirName = wsEntry.dirName || wsEntry.id;
+        const isArchived = wsEntry.status === "archived";
+        const matches = [];
+        // 判断 id 类型
+        const isMemoId = id?.startsWith("memo-");
+        const isNodeId = id && !isMemoId;
+        // 搜索节点
+        if ((target === "all" || target === "node") && !isMemoId) {
+            const graph = await this.json.readGraph(projectRoot, wsDirName, isArchived);
+            // 确定要搜索的节点列表
+            let nodeIds;
+            if (isNodeId) {
+                // 搜索指定节点子树
+                nodeIds = this.collectSubtreeNodes(id, graph.nodes);
+            }
+            else {
+                // 搜索所有节点
+                nodeIds = Object.keys(graph.nodes);
+            }
+            for (const nodeId of nodeIds) {
+                if (matches.length >= limit + 1)
+                    break;
+                const nodeMeta = graph.nodes[nodeId];
+                if (!nodeMeta)
+                    continue;
+                const nodeDirName = nodeMeta.dirName || nodeId;
+                try {
+                    const nodeInfo = await this.md.readNodeInfo(projectRoot, wsDirName, nodeDirName, isArchived);
+                    // 搜索标题
+                    if (nodeInfo.title.toLowerCase().includes(lowerQuery)) {
+                        matches.push({
+                            type: "node",
+                            nodeId,
+                            nodeTitle: nodeInfo.title,
+                            source: "title",
+                            snippet: nodeInfo.title,
+                        });
+                    }
+                    // 搜索需求
+                    if (nodeInfo.requirement && matches.length < limit + 1) {
+                        const reqMatch = this.findInText(nodeInfo.requirement, lowerQuery, context);
+                        if (reqMatch) {
+                            matches.push({
+                                type: "node",
+                                nodeId,
+                                nodeTitle: nodeInfo.title,
+                                source: "requirement",
+                                snippet: reqMatch.snippet,
+                            });
+                        }
+                    }
+                    // 搜索结论
+                    if (nodeInfo.conclusion && matches.length < limit + 1) {
+                        const conMatch = this.findInText(nodeInfo.conclusion, lowerQuery, context);
+                        if (conMatch) {
+                            matches.push({
+                                type: "node",
+                                nodeId,
+                                nodeTitle: nodeInfo.title,
+                                source: "conclusion",
+                                snippet: conMatch.snippet,
+                            });
+                        }
+                    }
+                }
+                catch {
+                    // 读取失败，跳过
+                }
+            }
+        }
+        // 搜索 memo
+        if ((target === "all" || target === "memo") && !isNodeId) {
+            const graph = await this.json.readGraph(projectRoot, wsDirName, isArchived);
+            const memos = graph.memos || {};
+            // 确定要搜索的 memo 列表
+            let memoIds;
+            if (isMemoId) {
+                memoIds = [id];
+            }
+            else {
+                memoIds = Object.keys(memos);
+            }
+            for (const memoId of memoIds) {
+                if (matches.length >= limit + 1)
+                    break;
+                const memoMeta = memos[memoId];
+                if (!memoMeta)
+                    continue;
+                const memoDirName = memoMeta.dirName;
+                // 搜索标题
+                if (memoMeta.title.toLowerCase().includes(lowerQuery)) {
+                    matches.push({
+                        type: "memo",
+                        memoId,
+                        memoTitle: memoMeta.title,
+                        source: "title",
+                        snippet: memoMeta.title,
+                    });
+                }
+                // 搜索摘要
+                if (memoMeta.summary && matches.length < limit + 1) {
+                    if (memoMeta.summary.toLowerCase().includes(lowerQuery)) {
+                        matches.push({
+                            type: "memo",
+                            memoId,
+                            memoTitle: memoMeta.title,
+                            source: "summary",
+                            snippet: memoMeta.summary,
+                        });
+                    }
+                }
+                // 搜索标签
+                if (memoMeta.tags && matches.length < limit + 1) {
+                    const matchedTag = memoMeta.tags.find(tag => tag.toLowerCase().includes(lowerQuery));
+                    if (matchedTag) {
+                        matches.push({
+                            type: "memo",
+                            memoId,
+                            memoTitle: memoMeta.title,
+                            source: "tags",
+                            snippet: `[${memoMeta.tags.join(", ")}]`,
+                        });
+                    }
+                }
+                // 搜索内容（带行号）
+                if (matches.length < limit + 1) {
+                    try {
+                        const contentPath = this.fs.getMemoContentPath(projectRoot, wsDirName, memoDirName);
+                        const content = await this.fs.readFile(contentPath);
+                        const contentMatches = this.findAllInText(content, lowerQuery, context);
+                        for (const match of contentMatches) {
+                            if (matches.length >= limit + 1)
+                                break;
+                            matches.push({
+                                type: "memo",
+                                memoId,
+                                memoTitle: memoMeta.title,
+                                source: "content",
+                                line: match.line,
+                                snippet: match.snippet,
+                            });
+                        }
+                    }
+                    catch {
+                        // 读取失败，跳过
+                    }
+                }
+            }
+        }
+        const hasMore = matches.length > limit;
+        return {
+            matches: matches.slice(0, limit),
+            hasMore,
+        };
+    }
+    /**
+     * 收集节点子树中所有节点 ID
+     */
+    collectSubtreeNodes(rootId, nodes) {
+        const result = [];
+        const stack = [rootId];
+        while (stack.length > 0) {
+            const nodeId = stack.pop();
+            const node = nodes[nodeId];
+            if (!node)
+                continue;
+            result.push(nodeId);
+            if (node.children) {
+                stack.push(...node.children);
+            }
+        }
+        return result;
+    }
+    /**
+     * 在文本中查找关键词，返回第一个匹配的片段
+     */
+    findInText(text, query, contextLines) {
+        const lines = text.split("\n");
+        const lowerLines = lines.map(l => l.toLowerCase());
+        for (let i = 0; i < lowerLines.length; i++) {
+            if (lowerLines[i].includes(query)) {
+                const start = Math.max(0, i - contextLines);
+                const end = Math.min(lines.length, i + contextLines + 1);
+                const snippet = lines.slice(start, end).join("\n");
+                return { snippet };
+            }
+        }
+        return null;
+    }
+    /**
+     * 在文本中查找所有匹配，返回带行号的片段列表
+     */
+    findAllInText(text, query, contextLines) {
+        const lines = text.split("\n");
+        const lowerLines = lines.map(l => l.toLowerCase());
+        const results = [];
+        for (let i = 0; i < lowerLines.length; i++) {
+            if (lowerLines[i].includes(query)) {
+                const start = Math.max(0, i - contextLines);
+                const end = Math.min(lines.length, i + contextLines + 1);
+                const snippet = lines.slice(start, end).join("\n");
+                results.push({
+                    line: i + 1, // 1-based
+                    snippet,
+                });
+            }
+        }
+        return results;
+    }
+}
+//# sourceMappingURL=SearchService.js.map

package/dist/services/SearchService.js.map

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

package/dist/services/SessionService.d.ts

@@ -0,0 +1,136 @@
+import type { FileSystemAdapter } from "../storage/FileSystemAdapter.js";
+import type { JsonStorage } from "../storage/JsonStorage.js";
+import type { MarkdownStorage } from "../storage/MarkdownStorage.js";
+import type { SessionBindingStorage, SessionBinding } from "../storage/SessionBindingStorage.js";
+import type { InstallationService } from "./InstallationService.js";
+import type { InstallationWarning } from "../types/settings.js";
+/**
+ * session_bind 参数
+ */
+export interface SessionBindParams {
+    sessionId: string;
+    workspaceId: string;
+    nodeId?: string;
+}
+/**
+ * session_bind 返回值
+ */
+export interface SessionBindResult {
+    success: true;
+    message: string;
+    binding: SessionBinding;
+}
+/**
+ * session_unbind 参数
+ */
+export interface SessionUnbindParams {
+    sessionId: string;
+}
+/**
+ * session_unbind 返回值
+ */
+export interface SessionUnbindResult {
+    success: true;
+    message: string;
+}
+/**
+ * session_status 参数
+ */
+export interface SessionStatusParams {
+    sessionId: string;
+}
+/**
+ * session_status 返回值（已绑定）
+ */
+export interface SessionStatusBoundResult {
+    bound: true;
+    workspace: {
+        id: string;
+        name: string;
+        goal: string;
+    };
+    focusedNode?: {
+        id: string;
+        title: string;
+        status: string;
+        requirement?: string;
+    };
+    rules: string[];
+    installationWarnings?: InstallationWarning[];
+}
+/**
+ * session_status 返回值（未绑定）
+ */
+export interface SessionStatusUnboundResult {
+    bound: false;
+    availableWorkspaces: Array<{
+        id: string;
+        name: string;
+        status: string;
+    }>;
+}
+export type SessionStatusResult = SessionStatusBoundResult | SessionStatusUnboundResult;
+/**
+ * get_pending_changes 参数
+ */
+export interface GetPendingChangesParams {
+    sessionId: string;
+    workspaceId?: string;
+}
+/**
+ * get_pending_changes 返回值
+ */
+export interface GetPendingChangesResult {
+    hasChanges: boolean;
+    reminderText: string;
+}
+/**
+ * 会话服务
+ * 管理 Claude Code 会话与工作区的绑定关系
+ */
+export declare class SessionService {
+    private sessionStorage;
+    private json;
+    private md;
+    private fs;
+    private installationService;
+    constructor(sessionStorage: SessionBindingStorage, json: JsonStorage, md: MarkdownStorage, fs: FileSystemAdapter);
+    /**
+     * 设置 InstallationService 依赖（延迟注入避免循环依赖）
+     */
+    setInstallationService(service: InstallationService): void;
+    /**
+     * 绑定会话到工作区
+     */
+    bind(params: SessionBindParams): Promise<SessionBindResult>;
+    /**
+     * 解除会话绑定
+     */
+    unbind(params: SessionUnbindParams): Promise<SessionUnbindResult>;
+    /**
+     * 查询会话状态
+     */
+    status(params: SessionStatusParams): Promise<SessionStatusResult>;
+    /**
+     * 检查安装版本警告
+     * 使用组件级版本检查，每个组件独立比较版本
+     */
+    private checkInstallationWarnings;
+    /**
+     * 更新聚焦节点
+     */
+    updateFocus(sessionId: string, nodeId: string): Promise<boolean>;
+    /**
+     * 清理过期会话绑定
+     */
+    cleanup(maxAgeMs?: number): Promise<string[]>;
+    /**
+     * 清理指定工作区的所有会话绑定
+     */
+    cleanupByWorkspace(workspaceId: string): Promise<string[]>;
+    /**
+     * 获取待处理的手动变更提醒（供 Hook 脚本调用）
+     */
+    getPendingChanges(params: GetPendingChangesParams): Promise<GetPendingChangesResult>;
+}
+//# sourceMappingURL=SessionService.d.ts.map

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

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