zero-workspace 0.0.2

package/dist/services/DetectionService.js

@@ -0,0 +1,262 @@
+// src/services/DetectionService.ts
+import * as path from "node:path";
+import * as os from "node:os";
+import * as fs from "node:fs/promises";
+/**
+ * 检测服务
+ * 检测各平台的 ZeroWorkspace 组件安装状态
+ */
+export class DetectionService {
+    claudeSettingsPath;
+    claudeConfigPath; // ~/.claude.json (MCP 配置所在)
+    claudeAgentsPath;
+    claudeSkillsPath;
+    cursorHooksPath;
+    cursorMcpPath;
+    zeroScriptsPath;
+    zeroSkillsSource;
+    constructor() {
+        const isDev = process.env.NODE_ENV === "development" || process.env.ZERO_DEV === "true";
+        const zeroBaseDir = isDev ? ".zero-workspace-dev" : ".zero-workspace";
+        this.claudeSettingsPath = path.join(os.homedir(), ".claude", "settings.json");
+        this.claudeConfigPath = path.join(os.homedir(), ".claude.json"); // MCP 配置在这里
+        this.claudeAgentsPath = path.join(os.homedir(), ".claude", "agents");
+        this.claudeSkillsPath = path.join(os.homedir(), ".claude", "skills");
+        this.cursorHooksPath = path.join(os.homedir(), ".cursor", "hooks.json");
+        this.cursorMcpPath = path.join(os.homedir(), ".cursor", "mcp.json");
+        this.zeroScriptsPath = path.join(os.homedir(), zeroBaseDir, "scripts");
+        this.zeroSkillsSource = path.join(os.homedir(), zeroBaseDir, "templates", "skills");
+    }
+    /**
+     * 检测 Claude Code 组件安装状态
+     */
+    async detectClaudeCode() {
+        const result = {
+            platform: "claudeCode",
+            detected: false,
+            components: {
+                hooks: { installed: false },
+                mcp: { installed: false },
+                agents: { installed: false },
+            },
+        };
+        try {
+            const content = await fs.readFile(this.claudeSettingsPath, "utf-8");
+            const settings = JSON.parse(content);
+            // 检测 Hooks
+            if (settings.hooks) {
+                const hooksJson = JSON.stringify(settings.hooks);
+                // 检查是否包含 zero-workspace 相关脚本
+                if (hooksJson.includes("zero-workspace") || hooksJson.includes("hook-entry.cjs")) {
+                    result.components.hooks = {
+                        installed: true,
+                        path: path.join(this.zeroScriptsPath, "hook-entry.cjs"),
+                    };
+                    result.detected = true;
+                }
+            }
+        }
+        catch (err) {
+            // 文件不存在或解析失败，返回未检测到
+            if (err.code !== "ENOENT") {
+                console.error("检测 Claude Code settings.json 失败:", err);
+            }
+        }
+        // 检测 MCP（配置在 ~/.claude.json 中）
+        try {
+            const content = await fs.readFile(this.claudeConfigPath, "utf-8");
+            const config = JSON.parse(content);
+            if (config.mcpServers) {
+                const mcpJson = JSON.stringify(config.mcpServers);
+                if (mcpJson.includes("zero-workspace")) {
+                    result.components.mcp = { installed: true };
+                    result.detected = true;
+                }
+            }
+        }
+        catch (err) {
+            if (err.code !== "ENOENT") {
+                console.error("检测 Claude Code .claude.json 失败:", err);
+            }
+        }
+        // 检测 Agents（独立于 settings.json）
+        try {
+            const agentsDetected = await this.checkAgentsInstalled();
+            if (agentsDetected) {
+                result.components.agents = {
+                    installed: true,
+                    path: this.claudeAgentsPath,
+                };
+                result.detected = true;
+            }
+        }
+        catch (err) {
+            // agents 检测失败不影响其他组件
+            if (err.code !== "ENOENT") {
+                console.error("检测 Claude Code agents 失败:", err);
+            }
+        }
+        // 检测 Skills（独立于 settings.json）
+        try {
+            const skillsDetected = await this.checkSkillsInstalled();
+            if (skillsDetected) {
+                result.components.skills = {
+                    installed: true,
+                    path: this.claudeSkillsPath,
+                };
+                result.detected = true;
+            }
+        }
+        catch (err) {
+            // skills 检测失败不影响其他组件
+            if (err.code !== "ENOENT") {
+                console.error("检测 Claude Code skills 失败:", err);
+            }
+        }
+        return result;
+    }
+    /**
+     * 检测 Cursor 组件安装状态
+     */
+    async detectCursor() {
+        const result = {
+            platform: "cursor",
+            detected: false,
+            components: {
+                hooks: { installed: false },
+                mcp: { installed: false },
+            },
+        };
+        // 检测 Hooks
+        try {
+            const content = await fs.readFile(this.cursorHooksPath, "utf-8");
+            const config = JSON.parse(content);
+            if (config.hooks) {
+                const hooksJson = JSON.stringify(config.hooks);
+                // 检查是否包含 zero-workspace 相关脚本
+                if (hooksJson.includes("zero-workspace") || hooksJson.includes("cursor-hook-entry.cjs")) {
+                    result.components.hooks = {
+                        installed: true,
+                        path: path.join(this.zeroScriptsPath, "cursor-hook-entry.cjs"),
+                    };
+                    result.detected = true;
+                }
+            }
+        }
+        catch (err) {
+            // 文件不存在或解析失败
+            if (err.code !== "ENOENT") {
+                console.error("检测 Cursor Hooks 配置失败:", err);
+            }
+        }
+        // 检测 MCP
+        try {
+            const content = await fs.readFile(this.cursorMcpPath, "utf-8");
+            const config = JSON.parse(content);
+            if (config.mcpServers) {
+                const mcpJson = JSON.stringify(config.mcpServers);
+                if (mcpJson.includes("zero-workspace")) {
+                    result.components.mcp = {
+                        installed: true,
+                        path: this.cursorMcpPath,
+                    };
+                    result.detected = true;
+                }
+            }
+        }
+        catch (err) {
+            // 文件不存在或解析失败
+            if (err.code !== "ENOENT") {
+                console.error("检测 Cursor MCP 配置失败:", err);
+            }
+        }
+        return result;
+    }
+    /**
+     * 检测 Codex 组件安装状态（预留）
+     */
+    async detectCodex() {
+        // Codex 检测暂未实现，返回未检测到
+        return {
+            platform: "codex",
+            detected: false,
+            components: {
+                hooks: { installed: false },
+                mcp: { installed: false },
+            },
+        };
+    }
+    /**
+     * 检测所有平台
+     */
+    async detectAll() {
+        const [claudeCode, cursor, codex] = await Promise.all([
+            this.detectClaudeCode(),
+            this.detectCursor(),
+            this.detectCodex(),
+        ]);
+        const results = {};
+        if (claudeCode.detected) {
+            results.claudeCode = claudeCode;
+        }
+        if (cursor.detected) {
+            results.cursor = cursor;
+        }
+        if (codex.detected) {
+            results.codex = codex;
+        }
+        return results;
+    }
+    /**
+     * 检查 Hook 脚本文件是否存在
+     */
+    async checkHookScriptExists(platform) {
+        const scriptName = platform === "cursor" ? "cursor-hook-entry.cjs" : "hook-entry.cjs";
+        const scriptPath = path.join(this.zeroScriptsPath, scriptName);
+        try {
+            await fs.access(scriptPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 检查 ZeroWorkspace dispatch agents 是否已安装
+     * 检测 ~/.claude/agents/ 下是否存在 zero-executor.md 和 zero-reviewer.md
+     */
+    async checkAgentsInstalled() {
+        const agentFiles = ["zero-executor.md", "zero-reviewer.md"];
+        try {
+            // 检查所有 agent 文件是否存在
+            for (const agentFile of agentFiles) {
+                const agentPath = path.join(this.claudeAgentsPath, agentFile);
+                await fs.access(agentPath);
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * 检查 ZeroWorkspace skills 是否已安装
+     * 检测 ~/.claude/skills/ 下是否存在任何 ZeroWorkspace 提供的 skill 文件
+     * 由于 skills 目录可能为空（模板尚未创建），返回 false 表示未安装
+     */
+    async checkSkillsInstalled() {
+        try {
+            // 检查 skills 目录是否存在
+            await fs.access(this.claudeSkillsPath);
+            // 读取目录内容，检查是否有 .md 文件
+            const files = await fs.readdir(this.claudeSkillsPath);
+            const skillFiles = files.filter(f => f.endsWith(".md"));
+            // 只有存在 skill 文件时才认为已安装
+            return skillFiles.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=DetectionService.js.map

package/dist/services/DetectionService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DetectionService.js","sourceRoot":"","sources":["../../src/services/DetectionService.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAkCvC;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACnB,kBAAkB,CAAS;IAC3B,gBAAgB,CAAS,CAAE,4BAA4B;IACvD,gBAAgB,CAAS;IACzB,gBAAgB,CAAS;IACzB,eAAe,CAAS;IACxB,aAAa,CAAS;IACtB,eAAe,CAAS;IACxB,gBAAgB,CAAS;IAEjC;QACE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC;QACxF,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,iBAAiB,CAAC;QAEtE,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;QAC9E,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC,CAAE,YAAY;QAC9E,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACrE,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACrE,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;QACxE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QACpE,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;QACvE,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB;QACpB,MAAM,MAAM,GAAoB;YAC9B,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;gBAC3B,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;gBACzB,MAAM,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;aAC7B;SACF,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;YACpE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAErC,WAAW;YACX,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACnB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBACjD,6BAA6B;gBAC7B,IAAI,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBACjF,MAAM,CAAC,UAAU,CAAC,KAAK,GAAG;wBACxB,SAAS,EAAE,IAAI;wBACf,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,gBAAgB,CAAC;qBACxD,CAAC;oBACF,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACzB,CAAC;YACH,CAAC;QAEH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,oBAAoB;YACpB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,GAAG,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;QAED,+BAA+B;QAC/B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAClD,IAAI,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBACvC,MAAM,CAAC,UAAU,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;oBAC5C,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,OAAO,CAAC,KAAK,CAAC,iCAAiC,EAAE,GAAG,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;QAED,+BAA+B;QAC/B,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACzD,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG;oBACzB,SAAS,EAAE,IAAI;oBACf,IAAI,EAAE,IAAI,CAAC,gBAAgB;iBAC5B,CAAC;gBACF,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;YACzB,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,qBAAqB;YACrB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,+BAA+B;QAC/B,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACzD,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG;oBACzB,SAAS,EAAE,IAAI;oBACf,IAAI,EAAE,IAAI,CAAC,gBAAgB;iBAC5B,CAAC;gBACF,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;YACzB,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,qBAAqB;YACrB,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,OAAO,CAAC,KAAK,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QAChB,MAAM,MAAM,GAAoB;YAC9B,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;gBAC3B,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;aAC1B;SACF,CAAC;QAEF,WAAW;QACX,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YACjE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAEnC,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC/C,6BAA6B;gBAC7B,IAAI,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;oBACxF,MAAM,CAAC,UAAU,CAAC,KAAK,GAAG;wBACxB,SAAS,EAAE,IAAI;wBACf,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,uBAAuB,CAAC;qBAC/D,CAAC;oBACF,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,aAAa;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE,GAAG,CAAC,CAAC;YAC9C,CAAC;QACH,CAAC;QAED,SAAS;QACT,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAEnC,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAClD,IAAI,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBACvC,MAAM,CAAC,UAAU,CAAC,GAAG,GAAG;wBACtB,SAAS,EAAE,IAAI;wBACf,IAAI,EAAE,IAAI,CAAC,aAAa;qBACzB,CAAC;oBACF,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACzB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,aAAa;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,sBAAsB;QACtB,OAAO;YACL,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;gBAC3B,GAAG,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;aAC1B;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACpD,IAAI,CAAC,gBAAgB,EAAE;YACvB,IAAI,CAAC,YAAY,EAAE;YACnB,IAAI,CAAC,WAAW,EAAE;SACnB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAwB,EAAE,CAAC;QAExC,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;YACxB,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC;QAClC,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;QAC1B,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;QACxB,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,qBAAqB,CAAC,QAAsB;QAChD,MAAM,UAAU,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,gBAAgB,CAAC;QACtF,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QAE/D,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC5B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,oBAAoB;QACxB,MAAM,UAAU,GAAG,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAAC;QAE5D,IAAI,CAAC;YACH,oBAAoB;YACpB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;gBAC9D,MAAM,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC7B,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,oBAAoB;QACxB,IAAI,CAAC;YACH,mBAAmB;YACnB,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAEvC,sBAAsB;YACtB,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACtD,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;YAExD,uBAAuB;YACvB,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/dist/services/DispatchService.d.ts

@@ -0,0 +1,267 @@
+import type { FileSystemAdapter } from "../storage/FileSystemAdapter.js";
+import type { JsonStorage } from "../storage/JsonStorage.js";
+import type { MarkdownStorage } from "../storage/MarkdownStorage.js";
+import type { DispatchConfig, ActionRequired } from "../types/workspace.js";
+import type { NodeMeta, AcceptanceCriteria } from "../types/node.js";
+import type { ConfigService } from "./ConfigService.js";
+/**
+ * 合并策略类型
+ */
+export type MergeStrategy = "sequential" | "squash" | "cherry-pick" | "skip";
+/**
+ * 节点完整性检查结果
+ */
+export interface NodeReadinessCheck {
+    ready: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * 派发准备结果
+ * @deprecated 使用 DispatchUpgradeResult 代替
+ */
+export interface DispatchPrepareResult {
+    success: boolean;
+    startMarker: string;
+    actionRequired: ActionRequired;
+    readinessWarnings?: string[];
+}
+/**
+ * 派发升级结果
+ */
+export interface DispatchUpgradeResult {
+    success: boolean;
+    upgraded: boolean;
+    skipReason?: string;
+    actionRequired?: ActionRequired;
+}
+/**
+ * 派发完成结果
+ * 简化版：不再返回 nextAction/testNodeId，由母节点通过 context_get 读取子节点状态决定下一步
+ */
+export interface DispatchCompleteResult {
+    success: boolean;
+    endMarker?: string;
+    hint?: string;
+}
+/**
+ * Git 状态信息
+ */
+export interface GitStatusInfo {
+    currentBranch: string;
+    hasUncommittedChanges: boolean;
+    isDispatchBranch: boolean;
+}
+/**
+ * 禁用派发询问结果
+ */
+export interface DisableDispatchQueryResult {
+    actionRequired: ActionRequired;
+    status: {
+        originalBranch?: string;
+        processBranch?: string;
+        backupBranch?: string | null;
+        hasBackupChanges: boolean;
+        processCommits?: Array<{
+            hash: string;
+            message: string;
+        }>;
+        startMarker?: string;
+        useGit: boolean;
+    };
+}
+/**
+ * 执行禁用选择的参数
+ */
+export interface ExecuteDisableParams {
+    workspaceId: string;
+    mergeStrategy: MergeStrategy;
+    keepBackupBranch: boolean;
+    keepProcessBranch: boolean;
+    commitMessage?: string;
+}
+/**
+ * 派发子节点创建结果
+ */
+export interface DispatchCreateResult {
+    execId: string;
+    specId: string;
+    qualityId?: string;
+    actionRequired: ActionRequired;
+}
+import type { NodeService } from "./NodeService.js";
+/**
+ * 派发服务
+ * 处理派发功能的核心业务逻辑
+ */
+export declare class DispatchService {
+    private json;
+    private md;
+    private fs;
+    private configService?;
+    private nodeService?;
+    constructor(json: JsonStorage, md: MarkdownStorage, fs: FileSystemAdapter, configService?: ConfigService | undefined);
+    /**
+     * 设置 NodeService 依赖（用于自动创建 Review 节点）
+     */
+    setNodeService(nodeService: NodeService): void;
+    /**
+     * 启用派发模式
+     */
+    enableDispatch(workspaceId: string, projectRoot: string, options?: {
+        useGit?: boolean;
+    }): Promise<{
+        success: boolean;
+        config: DispatchConfig;
+    }>;
+    /**
+     * 查询禁用派发状态（返回 actionRequired 让用户选择）
+     */
+    queryDisableDispatch(workspaceId: string, projectRoot: string): Promise<DisableDispatchQueryResult | {
+        success: boolean;
+    }>;
+    /**
+     * 执行用户选择的禁用操作
+     */
+    executeDisableChoice(projectRoot: string, params: ExecuteDisableParams): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * 获取原分支的起始 commit（用于确定派发提交范围）
+     */
+    private getOriginalBranchCommit;
+    /**
+     * 禁用派发模式（兼容旧接口，直接合并）
+     * @deprecated 使用 queryDisableDispatch + executeDisableChoice 代替
+     */
+    disableDispatch(workspaceId: string, projectRoot: string, merge?: boolean): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * 检查节点是否准备好派发
+     * @param nodeInfo 节点信息
+     * @param nodeMeta 节点元数据
+     * @returns 完整性检查结果
+     */
+    checkNodeReadiness(nodeInfo: {
+        title: string;
+        requirement: string;
+        acceptanceCriteria?: AcceptanceCriteria[];
+    }, nodeMeta: NodeMeta): NodeReadinessCheck;
+    /**
+     * 准备派发节点任务
+     * @deprecated 使用 upgradeToDispatchParent 代替
+     */
+    prepareDispatch(workspaceId: string, projectRoot: string, nodeId: string): Promise<DispatchPrepareResult>;
+    /**
+     * 升级执行节点为派发母节点
+     * 将 execution 节点升级为 planning 节点，并设置为派发母节点
+     */
+    upgradeToDispatchParent(workspaceId: string, projectRoot: string, nodeId: string): Promise<DispatchUpgradeResult>;
+    /**
+     * 处理派发完成
+     * 简化版：不再自动创建 Review 节点，由 dispatch_create 统一创建子节点
+     */
+    completeDispatch(workspaceId: string, projectRoot: string, nodeId: string, success: boolean, conclusion?: string): Promise<DispatchCompleteResult>;
+    /**
+     * 处理测试结果
+     * 注：在新的附属化设计中，测试节点和执行节点是兄弟关系，由父管理节点统一管理。
+     * 此方法简化为记录测试结果，不再操作关联的执行节点。
+     */
+    handleTestResult(workspaceId: string, projectRoot: string, testNodeId: string, passed: boolean, _conclusion?: string): Promise<{
+        success: boolean;
+        hint?: string;
+    }>;
+    /**
+     * 获取 Git 状态信息
+     */
+    getGitStatus(workspaceId: string, projectRoot: string): Promise<GitStatusInfo | null>;
+    /**
+     * 清理派发分支
+     */
+    cleanupBranches(workspaceId: string, projectRoot: string): Promise<{
+        success: boolean;
+        deleted: string[];
+    }>;
+    /**
+     * 检测 Git 环境是否仍然可用（11.2 环境变化检测）
+     * 如果配置要求 Git 模式但 .git 目录消失，抛出警告
+     */
+    private validateGitEnvironment;
+    /**
+     * 检测活跃的派发工作区及其模式（用于混合模式检测）
+     * 返回工作区 ID 和 useGit 模式
+     */
+    private getActiveDispatchWorkspaceWithMode;
+    /**
+     * 通过配置文件检测活跃的派发工作区（用于无 Git 模式）
+     */
+    private getActiveDispatchWorkspaceByConfig;
+    /**
+     * 构建执行者 prompt（增强版：包含完整任务上下文）
+     */
+    private buildExecutorPrompt;
+    /**
+     * 构建 Reviewer prompt（用于 spec 和 quality 节点）
+     */
+    private buildReviewerPrompt;
+    /**
+     * 创建派发子节点（exec + spec + quality）
+     * 在派发母节点下一次性创建所有派发子节点
+     */
+    createDispatchChildren(workspaceId: string, projectRoot: string, parentId: string, exec: {
+        requirement: string;
+        acceptanceCriteria: AcceptanceCriteria[];
+    }, includeQuality?: boolean): Promise<DispatchCreateResult>;
+    /**
+     * 启用派发模式 (HTTP API 包装)
+     */
+    enable(params: {
+        workspaceId: string;
+        useGit?: boolean;
+    }): Promise<{
+        success: boolean;
+        config: DispatchConfig;
+        hint?: string;
+    }>;
+    /**
+     * 查询禁用派发选项 (HTTP API 包装)
+     */
+    queryDisable(params: {
+        workspaceId: string;
+    }): Promise<{
+        success: boolean;
+        status?: any;
+        hint?: string;
+    }>;
+    /**
+     * 执行禁用派发 (HTTP API 包装)
+     */
+    executeDisable(params: {
+        workspaceId: string;
+        mergeStrategy: "sequential" | "squash" | "cherry-pick" | "skip";
+        keepBackupBranch?: boolean;
+        keepProcessBranch?: boolean;
+        commitMessage?: string;
+    }): Promise<{
+        success: boolean;
+        hint?: string;
+    }>;
+    /**
+     * 切换派发模式 (HTTP API 包装)
+     * 仅支持在已启用派发模式时切换 useGit 值
+     */
+    switchMode(params: {
+        workspaceId: string;
+        useGit: boolean;
+    }): Promise<{
+        success: boolean;
+        hint?: string;
+    }>;
+    /**
+     * 获取工作区的项目根目录
+     */
+    private getProjectRoot;
+}
+//# sourceMappingURL=DispatchService.d.ts.map

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

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