@geeseeker/easyai-dev 3.0.0-alpha.1 → 3.0.0

package/lib/server/resources/spec-resource.js

@@ -0,0 +1,126 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { getProjectRoot } from "../utils/task-utils.js";
+/**
+ * 读取 spec 文件内容的共享逻辑
+ * @param category - spec 分类（如 backend, frontend, guides）
+ * @param name - spec 名称（不带 .md 后缀）
+ * @param uriHref - 原始请求的 URI（用于响应）
+ */
+function readSpec(category, name, uriHref) {
+    const projectRoot = getProjectRoot();
+    // 路径遍历防护：拒绝包含 .. 或路径分隔符的参数
+    if (category.includes("..") || category.includes("/") ||
+        category.includes("\\") ||
+        name.includes("..") || name.includes("/") || name.includes("\\")) {
+        return {
+            contents: [
+                {
+                    uri: uriHref,
+                    text: JSON.stringify({
+                        error: true,
+                        message: "非法路径: category 和 name 不允许包含 '..' 或路径分隔符",
+                    }),
+                },
+            ],
+        };
+    }
+    // 防止 .md.md：如果 name 已含 .md 后缀则不再追加
+    const fileName = name.endsWith(".md") ? name : `${name}.md`;
+    const specRoot = path.join(projectRoot, ".trellis", "spec") + path.sep;
+    const specPath = path.resolve(projectRoot, ".trellis", "spec", category, fileName);
+    // 二次校验：确保解析后的路径仍在 spec 目录内
+    if (!specPath.startsWith(specRoot)) {
+        return {
+            contents: [
+                {
+                    uri: uriHref,
+                    text: JSON.stringify({
+                        error: true,
+                        message: "路径越界: 请求的路径超出 .trellis/spec/ 范围",
+                    }),
+                },
+            ],
+        };
+    }
+    // 检查 spec 文件是否存在
+    if (!fs.existsSync(specPath)) {
+        return {
+            contents: [
+                {
+                    uri: uriHref,
+                    text: JSON.stringify({
+                        category,
+                        name,
+                        error: `规格文档不存在: ${specPath}`,
+                    }),
+                },
+            ],
+        };
+    }
+    // 读取 spec 文件内容
+    const content = fs.readFileSync(specPath, "utf-8");
+    return {
+        contents: [
+            {
+                uri: uriHref,
+                text: JSON.stringify({ category, name, path: specPath, content }, null, 2),
+            },
+        ],
+    };
+}
+/**
+ * 从 Variables 中提取字符串值
+ * MCP SDK 的 Variables 类型为 Record<string, string | string[]>，
+ * 此函数安全地提取第一个字符串值。
+ */
+function extractParam(variables, key) {
+    const val = variables[key];
+    if (Array.isArray(val))
+        return val[0] ?? "";
+    return val ?? "";
+}
+/**
+ * spec resource handler 的共享错误处理包装
+ */
+function createSpecHandler() {
+    return async (uri, variables) => {
+        try {
+            const category = extractParam(variables, "category");
+            const name = extractParam(variables, "name");
+            return readSpec(category, name, uri.href);
+        }
+        catch (error) {
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        text: JSON.stringify({
+                            error: true,
+                            message: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+            };
+        }
+    };
+}
+/**
+ * 注册 spec 资源
+ * 支持两种 URI 协议：
+ *   1. trellis://spec/{category}/{name} — 完整路径
+ *   2. spec://{category}/{name}         — 简写语法（自动展开）
+ *
+ * 两者读取相同的 .trellis/spec/{category}/{name}.md 文件。
+ */
+export function register(server) {
+    // 完整路径：trellis://spec/{category}/{name}
+    server.resource("规格文档", new ResourceTemplate("trellis://spec/{category}/{name}", {
+        list: undefined,
+    }), createSpecHandler());
+    // 简写语法：spec://{category}/{name}
+    // 等价于 trellis://spec/{category}/{name}
+    server.resource("规格文档（简写）", new ResourceTemplate("spec://{category}/{name}", { list: undefined }), createSpecHandler());
+}
+//# sourceMappingURL=spec-resource.js.map

package/lib/server/resources/spec-resource.js.map

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

package/lib/server/resources/status-resource.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * 注册 status 资源
+ * URI: trellis://status
+ * 返回: 项目总览（Git branch/status/recent commits + 任务统计 + 最新日志摘要）
+ */
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=status-resource.d.ts.map

package/lib/server/resources/status-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-resource.d.ts","sourceRoot":"","sources":["../../src/resources/status-resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgChD"}

package/lib/server/resources/status-resource.js

@@ -0,0 +1,36 @@
+import { getProjectStatusData } from '../utils/status-utils.js';
+/**
+ * 注册 status 资源
+ * URI: trellis://status
+ * 返回: 项目总览（Git branch/status/recent commits + 任务统计 + 最新日志摘要）
+ */
+export function register(server) {
+    server.resource('项目状态', 'trellis://status', async () => {
+        try {
+            // 直接使用共享的状态聚合器，返回完整结果
+            const statusData = getProjectStatusData(5, 3);
+            return {
+                contents: [
+                    {
+                        uri: 'trellis://status',
+                        text: JSON.stringify(statusData, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                contents: [
+                    {
+                        uri: 'trellis://status',
+                        text: JSON.stringify({
+                            error: true,
+                            message: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=status-resource.js.map

package/lib/server/resources/status-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-resource.js","sourceRoot":"","sources":["../../src/resources/status-resource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,QAAQ,CACb,MAAM,EACN,kBAAkB,EAClB,KAAK,IAAI,EAAE;QACT,IAAI,CAAC;YACH,sBAAsB;YACtB,MAAM,UAAU,GAAG,oBAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAE9C,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,kBAAkB;wBACvB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;qBAC1C;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,kBAAkB;wBACvB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,IAAI;4BACX,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;yBAChE,CAAC;qBACH;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/lib/server/resources/subtask-context-resource.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * 注册 subtask-context 资源
+ * URI: trellis://tasks/{id}/subtasks/{sid}/context
+ * 返回: 子任务上下文
+ */
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=subtask-context-resource.d.ts.map

package/lib/server/resources/subtask-context-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subtask-context-resource.d.ts","sourceRoot":"","sources":["../../src/resources/subtask-context-resource.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2FhD"}

package/lib/server/resources/subtask-context-resource.js

@@ -0,0 +1,93 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { getTaskDir } from '../utils/task-utils.js';
+import { parseTrellisUri } from '../utils/uri-utils.js';
+/**
+ * 注册 subtask-context 资源
+ * URI: trellis://tasks/{id}/subtasks/{sid}/context
+ * 返回: 子任务上下文
+ */
+export function register(server) {
+    server.resource('子任务上下文', new ResourceTemplate('trellis://tasks/{id}/subtasks/{sid}/context', { list: undefined }), async (uri) => {
+        try {
+            // 使用共享的 URI 解析工具
+            const fullPath = parseTrellisUri(uri);
+            const match = fullPath.match(/^tasks\/([^/]+)\/subtasks\/([^/]+)\/context$/);
+            if (!match) {
+                return {
+                    contents: [
+                        {
+                            uri: uri.href,
+                            text: JSON.stringify({
+                                error: true,
+                                message: '无效的子任务 URI 格式，预期: trellis://tasks/{id}/subtasks/{sid}/context',
+                            }),
+                        },
+                    ],
+                };
+            }
+            const taskId = match[1];
+            const subtaskId = match[2];
+            const taskDir = getTaskDir(taskId);
+            // 尝试多个可能的子任务上下文位置
+            const possiblePaths = [
+                // 子目录中的 context.jsonl
+                path.join(taskDir, 'subtasks', `${subtaskId}.jsonl`),
+                path.join(taskDir, 'subtasks', subtaskId, 'context.jsonl'),
+                // 子任务的 markdown 文件
+                path.join(taskDir, 'subtasks', `${subtaskId}.md`),
+            ];
+            let foundContent = null;
+            let foundPath = '';
+            for (const possiblePath of possiblePaths) {
+                if (fs.existsSync(possiblePath)) {
+                    foundContent = fs.readFileSync(possiblePath, 'utf-8');
+                    foundPath = possiblePath;
+                    break;
+                }
+            }
+            if (!foundContent) {
+                return {
+                    contents: [
+                        {
+                            uri: uri.href,
+                            text: JSON.stringify({
+                                task_id: taskId,
+                                subtask_id: subtaskId,
+                                context: `子任务 ${subtaskId} 的上下文不存在`,
+                            }),
+                        },
+                    ],
+                };
+            }
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        text: JSON.stringify({
+                            task_id: taskId,
+                            subtask_id: subtaskId,
+                            source: foundPath,
+                            context: foundContent,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        text: JSON.stringify({
+                            error: true,
+                            message: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=subtask-context-resource.js.map

package/lib/server/resources/subtask-context-resource.js.map

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

package/lib/server/resources/task-context-resource.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * 注册 task-context 资源
+ * URI: trellis://tasks/{id}/context
+ * 返回: 任务的 context.jsonl 内容
+ */
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=task-context-resource.d.ts.map

package/lib/server/resources/task-context-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-context-resource.d.ts","sourceRoot":"","sources":["../../src/resources/task-context-resource.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwEhD"}

package/lib/server/resources/task-context-resource.js

@@ -0,0 +1,76 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { getTaskDir } from '../utils/task-utils.js';
+import { parseTrellisUri } from '../utils/uri-utils.js';
+/**
+ * 注册 task-context 资源
+ * URI: trellis://tasks/{id}/context
+ * 返回: 任务的 context.jsonl 内容
+ */
+export function register(server) {
+    server.resource('任务上下文', new ResourceTemplate('trellis://tasks/{id}/context', { list: undefined }), async (uri) => {
+        try {
+            // 使用共享的 URI 解析工具
+            const fullPath = parseTrellisUri(uri);
+            const match = fullPath.match(/^tasks\/([^/]+)\/context$/);
+            if (!match) {
+                return {
+                    contents: [
+                        {
+                            uri: uri.href,
+                            text: JSON.stringify({
+                                error: true,
+                                message: '无效的任务 URI 格式，预期: trellis://tasks/{id}/context',
+                            }),
+                        },
+                    ],
+                };
+            }
+            const taskId = match[1];
+            const taskDir = getTaskDir(taskId);
+            const contextPath = path.join(taskDir, 'context.jsonl');
+            // 检查 context.jsonl 是否存在
+            if (!fs.existsSync(contextPath)) {
+                return {
+                    contents: [
+                        {
+                            uri: uri.href,
+                            text: JSON.stringify({
+                                task_id: taskId,
+                                context: '该任务暂无上下文记录（context.jsonl 不存在）',
+                            }),
+                        },
+                    ],
+                };
+            }
+            // 读取 context.jsonl 内容
+            const content = fs.readFileSync(contextPath, 'utf-8');
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        text: JSON.stringify({
+                            task_id: taskId,
+                            context: content,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        text: JSON.stringify({
+                            error: true,
+                            message: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+            };
+        }
+    });
+}
+//# sourceMappingURL=task-context-resource.js.map

package/lib/server/resources/task-context-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-context-resource.js","sourceRoot":"","sources":["../../src/resources/task-context-resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,QAAQ,CACb,OAAO,EACP,IAAI,gBAAgB,CAAC,8BAA8B,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EACzE,KAAK,EAAE,GAAQ,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,iBAAiB;YACjB,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;YACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;YAE1D,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO;oBACL,QAAQ,EAAE;wBACR;4BACE,GAAG,EAAE,GAAG,CAAC,IAAI;4BACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,KAAK,EAAE,IAAI;gCACX,OAAO,EAAE,+CAA+C;6BACzD,CAAC;yBACH;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACxB,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;YACnC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;YAExD,wBAAwB;YACxB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAChC,OAAO;oBACL,QAAQ,EAAE;wBACR;4BACE,GAAG,EAAE,GAAG,CAAC,IAAI;4BACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gCACnB,OAAO,EAAE,MAAM;gCACf,OAAO,EAAE,+BAA+B;6BACzC,CAAC;yBACH;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,sBAAsB;YACtB,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAEtD,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,OAAO,EAAE,MAAM;4BACf,OAAO,EAAE,OAAO;yBACjB,EAAE,IAAI,EAAE,CAAC,CAAC;qBACZ;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,IAAI;4BACX,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;yBAChE,CAAC;qBACH;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/lib/server/tools/conflict-check.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * 注册 conflict_check 工具
+ * 文件范围重叠检测（架构 §4.2）
+ */
+export declare function register(server: McpServer): void;
+//# sourceMappingURL=conflict-check.d.ts.map

package/lib/server/tools/conflict-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-check.d.ts","sourceRoot":"","sources":["../../src/tools/conflict-check.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiGpE;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6JhD"}

package/lib/server/tools/conflict-check.js

@@ -0,0 +1,242 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { z } from "zod";
+import { listTaskDirs, getTasksDir, parseTaskMd, } from "../utils/task-utils.js";
+import { checkCapability, capabilityError } from "../utils/capability-gate.js";
+// ============ 辅助函数 ============
+/**
+ * 简易 glob 匹配（支持 * 和 ** 通配符）
+ * - `*` 匹配不含 `/` 的任意字符
+ * - `**` 匹配包含 `/` 的任意路径
+ * @param pattern - glob 模式
+ * @param filePath - 待匹配的文件路径
+ * @returns 是否匹配
+ */
+function globMatch(pattern, filePath) {
+    // 规范化路径分隔符
+    const normalizedPattern = pattern.replace(/\\/g, "/");
+    const normalizedPath = filePath.replace(/\\/g, "/");
+    // 精确匹配
+    if (normalizedPattern === normalizedPath) {
+        return true;
+    }
+    // 将 glob 模式转换为正则表达式
+    // 顺序关键：占位符 → 转义 → 单字符通配 → GLOBSTAR 展开
+    let regexStr = normalizedPattern
+        // ** 先标记为占位符（必须在转义前处理）
+        .replace(/\*\*/g, "§GLOBSTAR§")
+        // 转义正则特殊字符（除了 * 和 ?）
+        .replace(/[.+^${}()|[\]\\]/g, "\\$&")
+        // * 匹配不含 / 的任意字符（必须在 GLOBSTAR 展开前）
+        .replace(/\*/g, "[^/]*")
+        // ? 匹配单个非 / 字符（必须在 GLOBSTAR 展开前）
+        .replace(/\?/g, "[^/]")
+        // §GLOBSTAR§/ → (.*/)?（零或多层目录）
+        .replace(/§GLOBSTAR§\//g, "(.*/)?")
+        // 尾部 §GLOBSTAR§ → .*（匹配任意路径）
+        .replace(/§GLOBSTAR§/g, ".*");
+    regexStr = `^${regexStr}$`;
+    try {
+        const regex = new RegExp(regexStr);
+        return regex.test(normalizedPath);
+    }
+    catch {
+        // 正则构建失败时回退为精确匹配
+        return normalizedPattern === normalizedPath;
+    }
+}
+/**
+ * 解析 file_scope 字符串为文件路径列表
+ * 支持逗号分隔和换行分隔
+ * @param fileScope - file_scope 字段的值
+ * @returns 文件路径/glob 模式列表
+ */
+function parseFileScope(fileScope) {
+    if (!fileScope)
+        return [];
+    return fileScope
+        .split(/[,\n]/)
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+}
+// ============ 注册函数 ============
+/**
+ * 注册 conflict_check 工具
+ * 文件范围重叠检测（架构 §4.2）
+ */
+export function register(server) {
+    server.tool("conflict_check", "检测文件范围与现有活跃任务的重叠冲突。" +
+        "在 PM 创建新任务前调用，防止多个任务修改同一文件导致合并冲突。" +
+        "返回冲突报告（冲突文件 + 涉及任务 ID + 建议）。", {
+        files: z
+            .array(z.string())
+            .min(1)
+            .describe("待检查的文件路径列表（相对于项目根，支持 glob 模式，" +
+            "如 src/auth/*.ts）"),
+        tasks: z
+            .array(z.string())
+            .optional()
+            .describe("可选的任务 ID 列表（不指定则检查所有活跃任务）"),
+        role: z
+            .string()
+            .optional()
+            .describe("调用者角色（pm / 组长）"),
+    }, async ({ files, tasks, role }) => {
+        // Capability Gate 校验（PM + 组长）
+        const rejectReason = checkCapability(role, "conflict_check");
+        if (rejectReason) {
+            return capabilityError(rejectReason);
+        }
+        try {
+            const conflicts = [];
+            const tasksDir = getTasksDir();
+            // 获取要检查的任务列表
+            let taskDirNames;
+            if (tasks && tasks.length > 0) {
+                // 校验任务 ID 安全性（复用项目统一的路径穿越防护）
+                for (const taskId of tasks) {
+                    if (taskId.includes("..") ||
+                        taskId.includes("/") ||
+                        taskId.includes("\\")) {
+                        return {
+                            content: [
+                                {
+                                    type: "text",
+                                    text: JSON.stringify({
+                                        error: true,
+                                        message: `非法的任务 ID: ${taskId}`,
+                                    }),
+                                },
+                            ],
+                            isError: true,
+                        };
+                    }
+                }
+                taskDirNames = tasks;
+            }
+            else {
+                // 检查所有任务目录
+                taskDirNames = listTaskDirs();
+            }
+            // 活跃状态（排除已完成/已归档/已取消）
+            const ACTIVE_STATUSES = new Set([
+                "pending",
+                "in_progress",
+                "under_review",
+                "rejected",
+            ]);
+            let checkedTaskCount = 0;
+            for (const taskDirName of taskDirNames) {
+                const taskMdPath = path.join(tasksDir, taskDirName, "task.md");
+                // 跳过没有 task.md 的目录
+                if (!fs.existsSync(taskMdPath))
+                    continue;
+                const content = fs.readFileSync(taskMdPath, "utf-8");
+                // 复用项目统一的 frontmatter 解析器（DRY）
+                const { metadata } = parseTaskMd(content);
+                // 只检查活跃状态的任务
+                if (!ACTIVE_STATUSES.has(metadata.status))
+                    continue;
+                checkedTaskCount++;
+                const taskFiles = parseFileScope(metadata.file_scope || "");
+                if (taskFiles.length === 0)
+                    continue;
+                // 检查每个输入文件是否与任务文件范围冲突
+                for (const inputFile of files) {
+                    for (const taskFile of taskFiles) {
+                        // 双向 glob 匹配：
+                        // 1. 输入文件匹配任务的 glob 模式
+                        // 2. 任务文件匹配输入的 glob 模式
+                        const inputMatchesTask = globMatch(taskFile, inputFile);
+                        const taskMatchesInput = globMatch(inputFile, taskFile);
+                        if (inputMatchesTask || taskMatchesInput) {
+                            conflicts.push({
+                                file: inputFile,
+                                conflicting_task: taskDirName,
+                                task_title: metadata.title || taskDirName,
+                                task_status: metadata.status,
+                                overlap_type: inputFile === taskFile ? "exact" : "glob",
+                            });
+                        }
+                    }
+                }
+            }
+            // 去重（同一文件 + 同一任务只报告一次）
+            const uniqueConflicts = deduplicateConflicts(conflicts);
+            // 生成建议
+            const advice = generateAdvice(uniqueConflicts);
+            const report = {
+                has_conflicts: uniqueConflicts.length > 0,
+                conflicts: uniqueConflicts,
+                checked_files: files.length,
+                checked_tasks: checkedTaskCount,
+                advice,
+            };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(report, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            error: true,
+                            message: error instanceof Error ? error.message : String(error),
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+}
+// ============ 辅助函数 ============
+/**
+ * 去重冲突记录（同一文件 + 同一任务只保留一条）
+ */
+function deduplicateConflicts(conflicts) {
+    const seen = new Set();
+    return conflicts.filter((c) => {
+        const key = `${c.file}::${c.conflicting_task}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+/**
+ * 根据冲突情况生成建议
+ */
+function generateAdvice(conflicts) {
+    if (conflicts.length === 0) {
+        return "✅ 未检测到文件范围冲突，可以安全创建任务。";
+    }
+    const taskCount = new Set(conflicts.map((c) => c.conflicting_task)).size;
+    const lines = [
+        `⚠️ 检测到 ${conflicts.length} 个文件冲突，` +
+            `涉及 ${taskCount} 个现有任务。建议：`,
+    ];
+    // 分析冲突类型给出具体建议
+    const inProgressConflicts = conflicts.filter((c) => c.task_status === "in_progress");
+    const pendingConflicts = conflicts.filter((c) => c.task_status === "pending");
+    if (inProgressConflicts.length > 0) {
+        lines.push("1. 执行中的任务有文件冲突 → " +
+            "建议使用 worktree_create() 物理隔离 " +
+            "或建立任务依赖（等前序任务完成）");
+    }
+    if (pendingConflicts.length > 0) {
+        lines.push(`${inProgressConflicts.length > 0 ? "2" : "1"}. ` +
+            "待分配的任务有文件冲突 → " +
+            "建议调整文件范围避开冲突 " +
+            "或合并为同一任务");
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=conflict-check.js.map