mcp-probe-kit 3.0.5 → 3.0.6

package/build/tools/start_feature.js

@@ -2,6 +2,7 @@ import { parseArgs, getString, getNumber } from "../utils/parseArgs.js";
 import { okStructured } from "../lib/response.js";
 import { renderOrchestrationHeader } from "../lib/orchestration-guidance.js";
 import { FeatureReportSchema, RequirementsLoopSchema } from "../schemas/structured-output.js";
+import { reportToolProgress, throwIfAborted, } from "../lib/tool-execution-context.js";
 /**
  * start_feature 智能编排工具
  *
@@ -48,110 +49,110 @@ function extractFeatureInfo(input) {
         description: input,
     };
 }
-const PROMPT_TEMPLATE = `# 🚀 新功能开发编排（委托式）
-
-本工具仅生成 **执行计划（steps）**。AI 需要按顺序调用对应工具并落盘文档。
-
-## 🎯 目标
-开发新功能：**{feature_name}**
-功能描述：{description}
-
----
-
-## ✅ 执行计划（按顺序）
-
-### 0) 项目上下文（如缺失）
-**检查**: \`{docs_dir}/project-context.md\`  
-**缺失则调用**: \`init_project_context\`
-\`\`\`json
-{ "docs_dir": "{docs_dir}" }
-\`\`\`
-
-### 1) 生成功能规格
-**调用**: \`add_feature\`
-\`\`\`json
-{
-  "feature_name": "{feature_name}",
-  "description": "{description}",
-  "docs_dir": "{docs_dir}",
-  "template_profile": "{template_profile}"
-}
-\`\`\`
-**预期输出**:
-- \`{docs_dir}/specs/{feature_name}/requirements.md\`
-- \`{docs_dir}/specs/{feature_name}/design.md\`
-- \`{docs_dir}/specs/{feature_name}/tasks.md\`
-
-### 2) 工作量估算
-**调用**: \`estimate\`
-\`\`\`json
-{
-  "task_description": "实现 {feature_name} 功能：{description}",
-  "code_context": "参考生成的 tasks.md 中的任务列表"
-}
-\`\`\`
-
----
-
-## ✅ 输出汇总（执行完成后）
-1. 规格文档位置: \`{docs_dir}/specs/{feature_name}/\`
-2. 估算结果: 故事点 + 时间区间
-3. 主要风险（如有）
-4. 下一步: 按 tasks.md 开始开发
-
----
-
+const PROMPT_TEMPLATE = `# 🚀 新功能开发编排（委托式）
+
+本工具仅生成 **执行计划（steps）**。AI 需要按顺序调用对应工具并落盘文档。
+
+## 🎯 目标
+开发新功能：**{feature_name}**
+功能描述：{description}
+
+---
+
+## ✅ 执行计划（按顺序）
+
+### 0) 项目上下文（如缺失）
+**检查**: \`{docs_dir}/project-context.md\`  
+**缺失则调用**: \`init_project_context\`
+\`\`\`json
+{ "docs_dir": "{docs_dir}" }
+\`\`\`
+
+### 1) 生成功能规格
+**调用**: \`add_feature\`
+\`\`\`json
+{
+  "feature_name": "{feature_name}",
+  "description": "{description}",
+  "docs_dir": "{docs_dir}",
+  "template_profile": "{template_profile}"
+}
+\`\`\`
+**预期输出**:
+- \`{docs_dir}/specs/{feature_name}/requirements.md\`
+- \`{docs_dir}/specs/{feature_name}/design.md\`
+- \`{docs_dir}/specs/{feature_name}/tasks.md\`
+
+### 2) 工作量估算
+**调用**: \`estimate\`
+\`\`\`json
+{
+  "task_description": "实现 {feature_name} 功能：{description}",
+  "code_context": "参考生成的 tasks.md 中的任务列表"
+}
+\`\`\`
+
+---
+
+## ✅ 输出汇总（执行完成后）
+1. 规格文档位置: \`{docs_dir}/specs/{feature_name}/\`
+2. 估算结果: 故事点 + 时间区间
+3. 主要风险（如有）
+4. 下一步: 按 tasks.md 开始开发
+
+---
+
 *编排工具: MCP Probe Kit - start_feature*`;
-const LOOP_PROMPT_TEMPLATE = `# 🧭 需求澄清与补全（Requirements Loop）
-
-本模式用于**生产级稳健补全**：在不改变用户意图的前提下补齐关键要素，并输出可审计的结构化结果。
-
-## 🎯 目标
-开发新功能：**{feature_name}**  
-功能描述：{description}
-
-## ✅ 规则
-1. **不覆盖用户原始需求**
-2. **补全内容必须标注来源**（User / Derived / Assumption）
-3. **假设必须进入待确认列表**
-4. **每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}**
-
----
-
-## 🔁 执行步骤（每轮）
-
-### 1) 生成待确认问题
-使用 \`ask_user\` 提问，问题来源于“功能需求补全清单”（角色/触发/约束/异常/依赖等）。
-
-**调用示例**:
-\`\`\`json
-{
-  "questions": [
-    { "question": "目标用户或角色是谁？", "context": "角色定义", "required": true },
-    { "question": "触发场景是什么？", "context": "业务场景", "required": true }
-  ]
-}
-\`\`\`
-
-### 2) 更新结构化输出
-将回答补入 \`requirements\`，并标注来源：
-- User：用户明确回答
-- Derived：合理推导
-- Assumption：无法确认但补全（需确认）
-
-### 3) 自检与结束
-若 \`openQuestions\` 为空且无高风险假设，则结束 loop，进入规格生成与估算。
-
----
-
-## ✅ 结束后继续
-当满足结束条件时，执行：
-1. 调用 \`add_feature\` 生成规格文档
-2. 调用 \`estimate\` 进行工作量估算
-
----
-
-*编排工具: MCP Probe Kit - start_feature (requirements loop)*
+const LOOP_PROMPT_TEMPLATE = `# 🧭 需求澄清与补全（Requirements Loop）
+
+本模式用于**生产级稳健补全**：在不改变用户意图的前提下补齐关键要素，并输出可审计的结构化结果。
+
+## 🎯 目标
+开发新功能：**{feature_name}**  
+功能描述：{description}
+
+## ✅ 规则
+1. **不覆盖用户原始需求**
+2. **补全内容必须标注来源**（User / Derived / Assumption）
+3. **假设必须进入待确认列表**
+4. **每轮问题 ≤ {question_budget}，假设 ≤ {assumption_cap}**
+
+---
+
+## 🔁 执行步骤（每轮）
+
+### 1) 生成待确认问题
+使用 \`ask_user\` 提问，问题来源于“功能需求补全清单”（角色/触发/约束/异常/依赖等）。
+
+**调用示例**:
+\`\`\`json
+{
+  "questions": [
+    { "question": "目标用户或角色是谁？", "context": "角色定义", "required": true },
+    { "question": "触发场景是什么？", "context": "业务场景", "required": true }
+  ]
+}
+\`\`\`
+
+### 2) 更新结构化输出
+将回答补入 \`requirements\`，并标注来源：
+- User：用户明确回答
+- Derived：合理推导
+- Assumption：无法确认但补全（需确认）
+
+### 3) 自检与结束
+若 \`openQuestions\` 为空且无高风险假设，则结束 loop，进入规格生成与估算。
+
+---
+
+## ✅ 结束后继续
+当满足结束条件时，执行：
+1. 调用 \`add_feature\` 生成规格文档
+2. 调用 \`estimate\` 进行工作量估算
+
+---
+
+*编排工具: MCP Probe Kit - start_feature (requirements loop)*
 `;
 function buildOpenQuestions(questionBudget) {
     const base = [
@@ -163,8 +164,10 @@ function buildOpenQuestions(questionBudget) {
     ];
     return base.slice(0, Math.max(0, questionBudget));
 }
-export async function startFeature(args) {
+export async function startFeature(args, context) {
     try {
+        throwIfAborted(context?.signal, "start_feature 已取消");
+        await reportToolProgress(context, 10, "start_feature: 解析参数");
         // 智能参数解析，支持自然语言输入
         const parsedArgs = parseArgs(args, {
             defaultValues: {
@@ -197,6 +200,8 @@ export async function startFeature(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_feature 已取消");
+        await reportToolProgress(context, 35, "start_feature: 参数解析完成");
         // 如果是纯自然语言输入（input 字段有值但 feature_name 和 description 为空）
         const input = getString(parsedArgs.input);
         if (input && !featureName && !description) {
@@ -221,6 +226,8 @@ export async function startFeature(args) {
                 "- JSON格式：{\"feature_name\": \"user-auth\", \"description\": \"用户认证功能\"}");
         }
         if (requirementsMode === "loop") {
+            throwIfAborted(context?.signal, "start_feature(loop) 已取消");
+            await reportToolProgress(context, 70, "start_feature: 生成 loop 计划");
             const openQuestions = buildOpenQuestions(questionBudget).map((q, index) => ({
                 id: `Q-${index + 1}`,
                 ...q,
@@ -324,6 +331,7 @@ export async function startFeature(args) {
                     plan,
                 },
             };
+            await reportToolProgress(context, 95, "start_feature: loop 输出已生成");
             return okStructured(guide, loopReport, {
                 schema: RequirementsLoopSchema,
                 note: 'AI 应按轮次澄清需求并更新结构化输出，满足结束条件后再进入 add_feature / estimate',
@@ -426,6 +434,7 @@ export async function startFeature(args) {
                 plan,
             },
         };
+        await reportToolProgress(context, 95, "start_feature: 执行计划输出已生成");
         return okStructured(guide, featureReport, {
             schema: FeatureReportSchema,
             note: 'AI 应该按照指南执行步骤，并在每个步骤完成后更新 structuredContent 中的状态和估算信息',

package/build/tools/start_onboard.d.ts

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

package/build/tools/start_onboard.js

@@ -2,47 +2,48 @@ import { parseArgs, getString } from "../utils/parseArgs.js";
 import { okStructured } from "../lib/response.js";
 import { renderOrchestrationHeader } from "../lib/orchestration-guidance.js";
 import { OnboardingReportSchema } from "../schemas/structured-output.js";
+import { reportToolProgress, throwIfAborted, } from "../lib/tool-execution-context.js";
 /**
  * start_onboard 智能编排工具
  *
  * 场景：快速上手项目
  * 编排：init_project_context
  */
-const PROMPT_TEMPLATE = `# 📚 快速上手编排指南
-
-## 🎯 目标
-
-快速了解并上手当前项目
-
----
-
-## 📝 步骤 1: 生成项目上下文
-
-**调用工具**: \`init_project_context\`
-
-**参数**:
-\`\`\`json
-{
-  "docs_dir": "{docs_dir}",
-  "project_root": "{project_path}"
-}
-\`\`\`
-
-**生成内容**:
-- 技术栈文档
-- 架构说明
-- 编码规范
-- 开发指南
-
-**产出**: \`{docs_dir}/project-context.md\`
+const PROMPT_TEMPLATE = `# 📚 快速上手编排指南
+
+## 🎯 目标
+
+快速了解并上手当前项目
+
+---
+
+## 📝 步骤 1: 生成项目上下文
+
+**调用工具**: \`init_project_context\`
+
+**参数**:
+\`\`\`json
+{
+  "docs_dir": "{docs_dir}",
+  "project_root": "{project_path}"
+}
+\`\`\`
+
+**生成内容**:
+- 技术栈文档
+- 架构说明
+- 编码规范
+- 开发指南
+
+**产出**: \`{docs_dir}/project-context.md\`
 
 ---
 
 ## ✅ 完成检查
 
-- [ ] 技术栈已识别
-- [ ] 项目上下文已生成
-- [ ] 文档已保存
+- [ ] 技术栈已识别
+- [ ] 项目上下文已生成
+- [ ] 文档已保存
 
 ---
 
@@ -50,25 +51,25 @@ const PROMPT_TEMPLATE = `# 📚 快速上手编排指南
 
 完成后，向用户提供：
 
-### 1. 项目概览
-
-| 项目 | 内容 |
-|------|------|
-| 项目名称 | [名称] |
-| 项目类型 | [前端/后端/全栈/库] |
-| 主要语言 | [语言] |
-| 框架 | [框架] |
-
-### 2. 技术栈
-
-| 类别 | 技术 |
-|------|------|
-| 语言 | [语言列表] |
-| 框架 | [框架列表] |
-| 构建工具 | [工具列表] |
-| 测试框架 | [框架列表] |
-
-### 3. 快速开始
+### 1. 项目概览
+
+| 项目 | 内容 |
+|------|------|
+| 项目名称 | [名称] |
+| 项目类型 | [前端/后端/全栈/库] |
+| 主要语言 | [语言] |
+| 框架 | [框架] |
+
+### 2. 技术栈
+
+| 类别 | 技术 |
+|------|------|
+| 语言 | [语言列表] |
+| 框架 | [框架列表] |
+| 构建工具 | [工具列表] |
+| 测试框架 | [框架列表] |
+
+### 3. 快速开始
 
 \`\`\`bash
 # 安装依赖
@@ -81,7 +82,7 @@ const PROMPT_TEMPLATE = `# 📚 快速上手编排指南
 [测试命令]
 \`\`\`
 
-### 4. 下一步建议
+### 4. 下一步建议
 
 1. 阅读 \`{docs_dir}/project-context.md\` 了解详细信息
 2. 查看 README.md 了解项目背景
@@ -92,8 +93,10 @@ const PROMPT_TEMPLATE = `# 📚 快速上手编排指南
 
 *编排工具: MCP Probe Kit - start_onboard*
 `;
-export async function startOnboard(args) {
+export async function startOnboard(args, context) {
     try {
+        throwIfAborted(context?.signal, "start_onboard 已取消");
+        await reportToolProgress(context, 10, "start_onboard: 解析参数");
         // 智能参数解析，支持自然语言输入
         const parsedArgs = parseArgs(args, {
             defaultValues: {
@@ -108,6 +111,8 @@ export async function startOnboard(args) {
         });
         const projectPath = getString(parsedArgs.project_path) || ".";
         const docsDir = getString(parsedArgs.docs_dir) || "docs";
+        throwIfAborted(context?.signal, "start_onboard 已取消");
+        await reportToolProgress(context, 85, "start_onboard: 生成执行计划");
         const header = renderOrchestrationHeader({
             tool: 'start_onboard',
             goal: '快速了解并上手项目',
@@ -165,6 +170,7 @@ export async function startOnboard(args) {
                 plan,
             },
         };
+        await reportToolProgress(context, 95, "start_onboard: 输出已生成");
         return okStructured(guide, onboardingReport, {
             schema: OnboardingReportSchema,
             note: 'AI 应该按照指南执行步骤，并在上下文生成后更新 structuredContent 中的项目信息',

package/build/tools/start_product.d.ts

@@ -1,9 +1,10 @@
+import { type ToolExecutionContext } from "../lib/tool-execution-context.js";
 /**
  * start_product - 产品设计完整工作流指导
  *
  * 返回从需求到 HTML 原型的完整工作流执行指导，由 AI 按步骤调用工具并创建文件
  */
-export declare function startProduct(args: any): Promise<import("../lib/response.js").ToolResponse | {
+export declare function startProduct(args: any, context?: ToolExecutionContext): Promise<import("../lib/response.js").ToolResponse | {
     content: {
         type: string;
         text: string;

package/build/tools/start_product.js

@@ -3,13 +3,16 @@ import { promises as fs } from "fs";
 import { okStructured } from "../lib/response.js";
 import { renderOrchestrationHeader } from "../lib/orchestration-guidance.js";
 import { WorkflowReportSchema } from "../schemas/structured-output.js";
+import { reportToolProgress, throwIfAborted, } from "../lib/tool-execution-context.js";
 /**
  * start_product - 产品设计完整工作流指导
  *
  * 返回从需求到 HTML 原型的完整工作流执行指导，由 AI 按步骤调用工具并创建文件
  */
-export async function startProduct(args) {
+export async function startProduct(args, context) {
     try {
+        throwIfAborted(context?.signal, "start_product 已取消");
+        await reportToolProgress(context, 10, "start_product: 解析参数");
         // 使用智能参数解析
         const parsedArgs = parseArgs(args, {
             defaultValues: {
@@ -36,9 +39,13 @@ export async function startProduct(args) {
         const productType = getString(parsedArgs.product_type) || "SaaS";
         const skipDesignSystem = getBoolean(parsedArgs.skip_design_system);
         const docsDir = getString(parsedArgs.docs_dir) || "docs";
+        throwIfAborted(context?.signal, "start_product 已取消");
+        await reportToolProgress(context, 35, "start_product: 参数解析完成");
         // 如果提供了需求文件，读取文件内容
         let requirementsSource = '';
         if (requirementsFile) {
+            throwIfAborted(context?.signal, "start_product 已取消");
+            await reportToolProgress(context, 55, "start_product: 读取需求文档");
             try {
                 description = await fs.readFile(requirementsFile, 'utf-8');
                 requirementsSource = `需求文档文件: ${requirementsFile}`;
@@ -468,6 +475,7 @@ ${!skipDesignSystem ? `├── design-system.json          # 设计系统配
                 plan,
             },
         };
+        await reportToolProgress(context, 95, "start_product: 工作流输出已生成");
         return okStructured(guidanceText, report, {
             schema: WorkflowReportSchema,
             note: 'AI 应该严格按照执行计划调用工具并创建文档',

package/build/tools/start_ralph.d.ts

@@ -1,7 +1,8 @@
+import { type ToolExecutionContext } from "../lib/tool-execution-context.js";
 /**
  * start_ralph 主函数
  */
-export declare function startRalph(args: any): Promise<import("../lib/response.js").ToolResponse | {
+export declare function startRalph(args: any, context?: ToolExecutionContext): Promise<import("../lib/response.js").ToolResponse | {
     content: {
         type: string;
         text: string;

package/build/tools/start_ralph.js

@@ -2,6 +2,7 @@ import { parseArgs, getString, getNumber } from "../utils/parseArgs.js";
 import { okStructured } from "../lib/response.js";
 import { renderOrchestrationHeader } from "../lib/orchestration-guidance.js";
 import { RalphLoopReportSchema } from "../schemas/structured-output.js";
+import { reportToolProgress, throwIfAborted, } from "../lib/tool-execution-context.js";
 // 默认值（保守安全）
 const DEFAULTS = {
     mode: "safe",
@@ -664,8 +665,10 @@ cat .ralph/last_output_*.txt
 /**
  * start_ralph 主函数
  */
-export async function startRalph(args) {
+export async function startRalph(args, context) {
     try {
+        throwIfAborted(context?.signal, "start_ralph 已取消");
+        await reportToolProgress(context, 10, "start_ralph: 解析参数");
         const parsedArgs = parseArgs(args, {
             defaultValues: DEFAULTS,
             primaryField: "goal",
@@ -705,6 +708,8 @@ export async function startRalph(args) {
         };
         // 检测操作系统
         const isWindows = process.platform === "win32";
+        throwIfAborted(context?.signal, "start_ralph 已取消");
+        await reportToolProgress(context, 60, "start_ralph: 生成脚本模板");
         // 生成所有文件内容
         const promptMd = generatePromptTemplate(params.goal, params.completion_promise, params.test_command);
         const fixPlanMd = generateFixPlanTemplate(params.goal);
@@ -724,7 +729,7 @@ export async function startRalph(args) {
                 '按指南运行 loop 并监控结果',
             ],
         });
-        const output = `${header}${guide}
+        const output = `${header}${guide}
 
 ---
 
@@ -774,7 +779,7 @@ ${normalScript}
 5. Run \`ralph_loop_safe.${scriptExt}\`
 6. Monitor progress and logs
 
-**Happy coding! 🚀**
+**Happy coding! 🚀**
 `;
         const plan = {
             mode: 'delegated',
@@ -899,6 +904,7 @@ ${normalScript}
                 plan,
             },
         };
+        await reportToolProgress(context, 95, "start_ralph: 输出已生成");
         return okStructured(output, ralphReport, {
             schema: RalphLoopReportSchema,
             note: 'AI 应该帮助用户创建 .ralph/ 目录并复制文件，然后指导用户启动循环',

package/build/tools/start_ui.d.ts

@@ -7,10 +7,11 @@
  * 3. 搜索/生成 UI 模板
  * 4. 渲染最终代码
  */
+import { type ToolExecutionContext } from "../lib/tool-execution-context.js";
 /**
  * 统一 UI 开发编排工具
  */
-export declare function startUi(args: any): Promise<import("../lib/response.js").ToolResponse | {
+export declare function startUi(args: any, context?: ToolExecutionContext): Promise<import("../lib/response.js").ToolResponse | {
     content: {
         type: string;
         text: string;