mcp-probe-kit 3.0.5 → 3.0.7

package/build/tools/index.d.ts

@@ -1,6 +1,7 @@
 export { initProject } from "./init_project.js";
 export { gencommit } from "./gencommit.js";
 export { codeReview } from "./code_review.js";
+export { codeInsight } from "./code_insight.js";
 export { gentest } from "./gentest.js";
 export { refactor } from "./refactor.js";
 export { initProjectContext } from "./init_project_context.js";

package/build/tools/index.js

@@ -1,6 +1,7 @@
 export { initProject } from "./init_project.js";
 export { gencommit } from "./gencommit.js";
 export { codeReview } from "./code_review.js";
+export { codeInsight } from "./code_insight.js";
 export { gentest } from "./gentest.js";
 export { refactor } from "./refactor.js";
 export { initProjectContext } from "./init_project_context.js";

package/build/tools/interview.js

@@ -302,11 +302,11 @@ export async function interview(args) {
                 ],
                 outputs: ["访谈问题列表或访谈记录文件"],
             });
-            const text = `${header}# 📋 需求访谈工具
-
-## 功能说明
-
-在开发新功能前，通过结构化访谈澄清需求，避免理解偏差和返工。
+            const text = `${header}# 📋 需求访谈工具
+
+## 功能说明
+
+在开发新功能前，通过结构化访谈澄清需求，避免理解偏差和返工。
 
 **核心理念**: 先慢下来，把问题想清楚，反而能更快地交付正确的解决方案。
 
@@ -354,10 +354,10 @@ interview --feature-name user-login --answers {...}
 ## 为什么需要访谈？
 
 - ✅ 澄清需求，避免理解偏差
-- ✅ 发现隐藏的约束和依赖
-- ✅ 减少返工，提高交付质量
-- ✅ 形成清晰的需求文档
-
+- ✅ 发现隐藏的约束和依赖
+- ✅ 减少返工，提高交付质量
+- ✅ 形成清晰的需求文档
+
 **先慢下来，反而能更快。**`;
             const structuredData = {
                 summary: "需求访谈工具使用说明",

package/build/tools/start_bugfix.d.ts

@@ -1,4 +1,5 @@
-export declare function startBugfix(args: any): Promise<import("../lib/response.js").ToolResponse | {
+import { type ToolExecutionContext } from "../lib/tool-execution-context.js";
+export declare function startBugfix(args: any, context?: ToolExecutionContext): Promise<import("../lib/response.js").ToolResponse | {
     content: {
         type: string;
         text: string;

package/build/tools/start_bugfix.js

@@ -2,6 +2,8 @@ import { parseArgs, getString, getNumber } from "../utils/parseArgs.js";
 import { okStructured } from "../lib/response.js";
 import { renderOrchestrationHeader } from "../lib/orchestration-guidance.js";
 import { BugFixReportSchema, RequirementsLoopSchema } from "../schemas/structured-output.js";
+import { reportToolProgress, throwIfAborted, } from "../lib/tool-execution-context.js";
+import { buildBugfixGraphContext } from "../lib/gitnexus-bridge.js";
 function decideTemplateProfile(description) {
     const text = description || '';
     const lengthScore = text.length >= 200 ? 2 : text.length >= 120 ? 1 : 0;
@@ -40,11 +42,11 @@ function resolveTemplateProfile(rawProfile, description) {
         warning: `模板档位 "${rawProfile}" 不支持，已回退为 ${fallback}`,
     };
 }
-const PROMPT_TEMPLATE_GUIDED = `# 🐛 Bug 修复编排指南
-
-## 🎯 目标
-
-修复以下 Bug：
+const PROMPT_TEMPLATE_GUIDED = `# 🐛 Bug 修复编排指南
+
+## 🎯 目标
+
+修复以下 Bug：
 
 **错误信息**:
 \`\`\`
@@ -133,125 +135,125 @@ const PROMPT_TEMPLATE_GUIDED = `# 🐛 Bug 修复编排指南
 
 ---
 
-*编排工具: MCP Probe Kit - start_bugfix*
+*编排工具: MCP Probe Kit - start_bugfix*
 `;
-const PROMPT_TEMPLATE_STRICT = `# 🐛 Bug 修复编排（严格）
-
-## 🎯 目标
-修复 Bug：{error_message}
-
-{stack_trace_section}
-
----
-
-## ✅ 执行计划（按顺序）
-
-1) 检查 \`docs/project-context.md\`，缺失则调用 \`init_project_context\`
-2) 调用 \`fix_bug\`
-\`\`\`json
-{
-  "error_message": "{error_message}",
-  "stack_trace": "{stack_trace}"
-}
-\`\`\`
-3) 调用 \`gentest\`
-\`\`\`json
-{
-  "code": "[修复后的代码]",
-  "framework": "[根据项目上下文选择: jest/vitest/mocha]"
-}
-\`\`\`
-
----
-
-## ✅ 输出汇总
-1. Bug 原因
-2. 修复方案
-3. 修改文件
-4. 测试覆盖
-
----
-
-*编排工具: MCP Probe Kit - start_bugfix*
+const PROMPT_TEMPLATE_STRICT = `# 🐛 Bug 修复编排（严格）
+
+## 🎯 目标
+修复 Bug：{error_message}
+
+{stack_trace_section}
+
+---
+
+## ✅ 执行计划（按顺序）
+
+1) 检查 \`docs/project-context.md\`，缺失则调用 \`init_project_context\`
+2) 调用 \`fix_bug\`
+\`\`\`json
+{
+  "error_message": "{error_message}",
+  "stack_trace": "{stack_trace}"
+}
+\`\`\`
+3) 调用 \`gentest\`
+\`\`\`json
+{
+  "code": "[修复后的代码]",
+  "framework": "[根据项目上下文选择: jest/vitest/mocha]"
+}
+\`\`\`
+
+---
+
+## ✅ 输出汇总
+1. Bug 原因
+2. 修复方案
+3. 修改文件
+4. 测试覆盖
+
+---
+
+*编排工具: MCP Probe Kit - start_bugfix*
 `;
-const LOOP_PROMPT_TEMPLATE_GUIDED = `# 🧭 Bug 需求澄清与补全（Requirements Loop）
-
-本模式用于**生产级稳健补全**：在不改变用户意图的前提下补齐 Bug 修复所需关键信息。
-
-## 🎯 目标
-修复 Bug：{error_message}
-
-## ✅ 规则
-1. **不覆盖用户原始描述**
-2. **补全内容必须标注来源**（User / Derived / Assumption）
-3. **假设必须进入待确认列表**
-4. **每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}**
-
----
-
-## 🔁 执行步骤（每轮）
-
-### 1) 生成待确认问题
-使用 \`ask_user\` 提问，问题来源于 Bug 修复补全清单（复现/环境/期望/影响/验证）。
-
-**调用示例**:
-\`\`\`json
-{
-  "questions": [
-    { "question": "复现步骤是什么？", "context": "复现步骤", "required": true },
-    { "question": "期望行为是什么？", "context": "期望行为", "required": true }
-  ]
-}
-\`\`\`
-
-### 2) 更新结构化输出
-将回答补入 \`requirements\`，并标注来源：
-- User：用户明确回答
-- Derived：合理推导
-- Assumption：无法确认但补全（需确认）
-
-### 3) 自检与结束
-若 \`openQuestions\` 为空且无高风险假设，则结束 loop，进入修复流程。
-
----
-
-## ✅ 结束后继续
-当满足结束条件时，执行：
-1. 调用 \`fix_bug\` 进行定位与修复
-2. 调用 \`gentest\` 生成回归测试
-
----
-
-*编排工具: MCP Probe Kit - start_bugfix (requirements loop)*
+const LOOP_PROMPT_TEMPLATE_GUIDED = `# 🧭 Bug 需求澄清与补全（Requirements Loop）
+
+本模式用于**生产级稳健补全**：在不改变用户意图的前提下补齐 Bug 修复所需关键信息。
+
+## 🎯 目标
+修复 Bug：{error_message}
+
+## ✅ 规则
+1. **不覆盖用户原始描述**
+2. **补全内容必须标注来源**（User / Derived / Assumption）
+3. **假设必须进入待确认列表**
+4. **每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}**
+
+---
+
+## 🔁 执行步骤（每轮）
+
+### 1) 生成待确认问题
+使用 \`ask_user\` 提问，问题来源于 Bug 修复补全清单（复现/环境/期望/影响/验证）。
+
+**调用示例**:
+\`\`\`json
+{
+  "questions": [
+    { "question": "复现步骤是什么？", "context": "复现步骤", "required": true },
+    { "question": "期望行为是什么？", "context": "期望行为", "required": true }
+  ]
+}
+\`\`\`
+
+### 2) 更新结构化输出
+将回答补入 \`requirements\`，并标注来源：
+- User：用户明确回答
+- Derived：合理推导
+- Assumption：无法确认但补全（需确认）
+
+### 3) 自检与结束
+若 \`openQuestions\` 为空且无高风险假设，则结束 loop，进入修复流程。
+
+---
+
+## ✅ 结束后继续
+当满足结束条件时，执行：
+1. 调用 \`fix_bug\` 进行定位与修复
+2. 调用 \`gentest\` 生成回归测试
+
+---
+
+*编排工具: MCP Probe Kit - start_bugfix (requirements loop)*
 `;
-const LOOP_PROMPT_TEMPLATE_STRICT = `# 🧭 Bug 需求澄清与补全（Requirements Loop | 严格）
-
-本模式用于稳健补全关键信息，不改变用户意图。
-
-## 🎯 目标
-修复 Bug：{error_message}
-
-## ✅ 规则
-1. 不覆盖用户原始描述
-2. 补全内容标注来源（User / Derived / Assumption）
-3. 假设进入待确认列表
-4. 每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}
-
----
-
-## 🔁 执行步骤（每轮）
-1) 使用 \`ask_user\` 提问补全关键信息
-2) 更新结构化输出并标注来源
-3) 若 \`openQuestions\` 为空且无高风险假设则结束
-
----
-
-## ✅ 结束后继续
-当满足结束条件时，调用 \`fix_bug\` 与 \`gentest\`
-
----
-
-*编排工具: MCP Probe Kit - start_bugfix (requirements loop)*
+const LOOP_PROMPT_TEMPLATE_STRICT = `# 🧭 Bug 需求澄清与补全（Requirements Loop | 严格）
+
+本模式用于稳健补全关键信息，不改变用户意图。
+
+## 🎯 目标
+修复 Bug：{error_message}
+
+## ✅ 规则
+1. 不覆盖用户原始描述
+2. 补全内容标注来源（User / Derived / Assumption）
+3. 假设进入待确认列表
+4. 每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}
+
+---
+
+## 🔁 执行步骤（每轮）
+1) 使用 \`ask_user\` 提问补全关键信息
+2) 更新结构化输出并标注来源
+3) 若 \`openQuestions\` 为空且无高风险假设则结束
+
+---
+
+## ✅ 结束后继续
+当满足结束条件时，调用 \`fix_bug\` 与 \`gentest\`
+
+---
+
+*编排工具: MCP Probe Kit - start_bugfix (requirements loop)*
 `;
 function buildBugfixQuestions(questionBudget) {
     const base = [
@@ -264,8 +266,10 @@ function buildBugfixQuestions(questionBudget) {
     ];
     return base.slice(0, Math.max(0, questionBudget));
 }
-export async function startBugfix(args) {
+export async function startBugfix(args, context) {
     try {
+        throwIfAborted(context?.signal, "start_bugfix 已取消");
+        await reportToolProgress(context, 10, "start_bugfix: 解析参数");
         // 智能参数解析，支持自然语言输入
         const parsedArgs = parseArgs(args, {
             defaultValues: {
@@ -295,6 +299,8 @@ export async function startBugfix(args) {
         const maxRounds = getNumber(parsedArgs.loop_max_rounds, 2);
         const questionBudget = getNumber(parsedArgs.loop_question_budget, 5);
         const assumptionCap = getNumber(parsedArgs.loop_assumption_cap, 3);
+        throwIfAborted(context?.signal, "start_bugfix 已取消");
+        await reportToolProgress(context, 35, "start_bugfix: 参数解析完成");
         if (!errorMessage) {
             throw new Error("缺少必填参数: error_message（错误信息）");
         }
@@ -319,7 +325,37 @@ export async function startBugfix(args) {
         if (profileDecision.warning) {
             headerNotes.push(profileDecision.warning);
         }
+        throwIfAborted(context?.signal, "start_bugfix 已取消");
+        await reportToolProgress(context, 55, "start_bugfix: 获取代码图谱上下文");
+        const graphContext = await buildBugfixGraphContext({
+            errorMessage,
+            stackTrace,
+            signal: context?.signal,
+        });
+        const graphStatusNote = graphContext.available
+            ? `图谱增强: 可用（${graphContext.mode}）`
+            : "图谱增强: 已降级（自动回退）";
+        headerNotes.push(graphStatusNote);
+        const graphCodeContext = graphContext.available
+            ? [
+                `图谱摘要: ${graphContext.summary}`,
+                ...graphContext.highlights.slice(0, 3).map((item) => `图谱线索: ${item}`),
+            ]
+                .filter(Boolean)
+                .join("\n")
+            : "";
+        const graphGuideSection = `
+
+## 🧠 代码图谱上下文（可选增强）
+- 状态: ${graphContext.available ? "可用" : "降级"}
+- 摘要: ${graphContext.summary}
+${graphContext.highlights.length > 0
+            ? `- 线索:\n${graphContext.highlights.slice(0, 3).map((item) => `  - ${item}`).join("\n")}`
+            : "- 线索: 无"}
+`;
         if (requirementsMode === "loop") {
+            throwIfAborted(context?.signal, "start_bugfix(loop) 已取消");
+            await reportToolProgress(context, 70, "start_bugfix: 生成 loop 计划");
             const openQuestions = buildBugfixQuestions(questionBudget).map((q, index) => ({
                 id: `Q-${index + 1}`,
                 ...q,
@@ -373,6 +409,7 @@ export async function startBugfix(args) {
                         args: {
                             error_message: errorMessage,
                             ...(stackTrace ? { stack_trace: stackTrace } : {}),
+                            ...(graphCodeContext ? { code_context: graphCodeContext } : {}),
                         },
                         outputs: [],
                     },
@@ -400,10 +437,11 @@ export async function startBugfix(args) {
             const loopTemplate = profileDecision.resolved === 'strict'
                 ? LOOP_PROMPT_TEMPLATE_STRICT
                 : LOOP_PROMPT_TEMPLATE_GUIDED;
-            const guide = header + loopTemplate
+            const guide = (header + loopTemplate
                 .replace(/{error_message}/g, errorMessage)
                 .replace(/{question_budget}/g, String(questionBudget))
-                .replace(/{assumption_cap}/g, String(assumptionCap));
+                .replace(/{assumption_cap}/g, String(assumptionCap)))
+                + graphGuideSection;
             const loopReport = {
                 mode: 'loop',
                 round: 1,
@@ -430,8 +468,10 @@ export async function startBugfix(args) {
                 metadata: {
                     plan,
                     template: templateMeta,
+                    graphContext,
                 },
             };
+            await reportToolProgress(context, 95, "start_bugfix: loop 输出已生成");
             return okStructured(guide, loopReport, {
                 schema: RequirementsLoopSchema,
                 note: 'AI 应按轮次澄清 Bug 需求并更新结构化输出，满足结束条件后再进入 fix_bug / gentest',
@@ -452,10 +492,11 @@ export async function startBugfix(args) {
         const promptTemplate = profileDecision.resolved === 'strict'
             ? PROMPT_TEMPLATE_STRICT
             : PROMPT_TEMPLATE_GUIDED;
-        const guide = header + promptTemplate
+        const guide = (header + promptTemplate
             .replace(/{error_message}/g, errorMessage)
             .replace(/{stack_trace}/g, stackTrace)
-            .replace(/{stack_trace_section}/g, stackTraceSection);
+            .replace(/{stack_trace_section}/g, stackTraceSection))
+            + graphGuideSection;
         const plan = {
             mode: 'delegated',
             steps: [
@@ -472,6 +513,7 @@ export async function startBugfix(args) {
                     args: {
                         error_message: errorMessage,
                         ...(stackTrace ? { stack_trace: stackTrace } : {}),
+                        ...(graphCodeContext ? { code_context: graphCodeContext } : {}),
                     },
                     outputs: [],
                 },
@@ -521,8 +563,10 @@ export async function startBugfix(args) {
             metadata: {
                 plan,
                 template: templateMeta,
+                graphContext,
             },
         };
+        await reportToolProgress(context, 95, "start_bugfix: 执行计划输出已生成");
         return okStructured(guide, bugfixReport, {
             schema: BugFixReportSchema,
             note: 'AI 应该按照指南执行步骤，并在每个步骤完成后更新 structuredContent 中的状态',

package/build/tools/start_feature.d.ts

@@ -1,4 +1,5 @@
-export declare function startFeature(args: any): Promise<import("../lib/response.js").ToolResponse | {
+import { type ToolExecutionContext } from "../lib/tool-execution-context.js";
+export declare function startFeature(args: any, context?: ToolExecutionContext): Promise<import("../lib/response.js").ToolResponse | {
     content: {
         type: string;
         text: string;