mcp-probe-kit 1.15.0 → 2.0.0

package/build/tools/init_project.d.ts

@@ -1,13 +1,7 @@
-export declare function initProject(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-}>;
+/**
+ * init_project 工具
+ *
+ * 功能：按照 Spec-Driven Development 方式初始化项目
+ * 输出：项目结构、文档模板和初始化指南
+ */
+export declare function initProject(args: any): Promise<import("../lib/response.js").ToolResponse>;

package/build/tools/init_project.js

@@ -1,5 +1,11 @@
 import { parseArgs, getString } from "../utils/parseArgs.js";
-// init_project 工具实现
+import { okStructured } from "../lib/response.js";
+/**
+ * init_project 工具
+ *
+ * 功能：按照 Spec-Driven Development 方式初始化项目
+ * 输出：项目结构、文档模板和初始化指南
+ */
 export async function initProject(args) {
     try {
         // 智能参数解析，支持自然语言输入
@@ -176,25 +182,57 @@ ${input}
 
 🚀 **开始执行**：
 现在请按照上述步骤创建项目结构和所有必需的文档。`;
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: message,
-                },
-            ],
+        // 创建结构化数据对象
+        const structuredData = {
+            summary: `初始化项目：${projectName}`,
+            projectName: projectName,
+            structure: {
+                directories: [
+                    'docs/',
+                    'docs/specs/',
+                    `docs/specs/${featureSlug}/`,
+                    'scripts/',
+                    'src/'
+                ],
+                files: [
+                    'docs/project-context.md',
+                    'docs/constitution.md',
+                    `docs/specs/${featureSlug}/requirements.md`,
+                    `docs/specs/${featureSlug}/design.md`,
+                    `docs/specs/${featureSlug}/tasks.md`,
+                    `docs/specs/${featureSlug}/research.md`,
+                    'scripts/check-prerequisites.sh',
+                    'scripts/setup.sh'
+                ]
+            },
+            nextSteps: [
+                '创建项目目录结构',
+                '生成 project-context.md',
+                '生成 constitution.md',
+                '生成需求文档 requirements.md',
+                '生成设计文档 design.md',
+                '生成任务清单 tasks.md',
+                '生成技术调研 research.md',
+                '创建辅助脚本'
+            ]
         };
+        return okStructured(message, structuredData, {
+            schema: (await import("../schemas/output/project-tools.js")).ProjectInitSchema,
+        });
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `❌ 初始化项目失败: ${errorMessage}`,
-                },
-            ],
-            isError: true,
+        const errorData = {
+            summary: "项目初始化失败",
+            projectName: "",
+            structure: {
+                directories: [],
+                files: []
+            },
+            nextSteps: []
         };
+        return okStructured(`❌ 初始化项目失败: ${errorMessage}`, errorData, {
+            schema: (await import("../schemas/output/project-tools.js")).ProjectInitSchema,
+        });
     }
 }

package/build/tools/init_project_context.d.ts

@@ -5,16 +5,4 @@
  * @param args.docs_dir - 文档目录，默认 "docs"
  * @returns MCP 响应，包含项目分析指南
  */
-export declare function initProjectContext(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-}>;
+export declare function initProjectContext(args: any): Promise<import("../lib/response.js").ToolResponse>;

package/build/tools/init_project_context.js

@@ -1,4 +1,5 @@
 import { parseArgs, getString } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
 /**
  * init_project_context 工具
  *
@@ -316,26 +317,52 @@ export async function initProjectContext(args) {
         const docsDir = getString(parsedArgs.docs_dir) || DEFAULT_DOCS_DIR;
         // 构建指南文本（替换占位符）
         const guide = PROMPT_TEMPLATE.replace(/{docs_dir}/g, docsDir);
-        // 返回结果
-        return {
-            content: [
+        // 创建结构化数据对象
+        const structuredData = {
+            summary: "生成项目上下文文档",
+            projectOverview: {
+                name: "待分析",
+                description: "待分析",
+                techStack: [],
+                architecture: "待分析"
+            },
+            codingStandards: [
+                "分析 ESLint 配置",
+                "分析 Prettier 配置",
+                "分析命名规范",
+                "分析 TypeScript 配置"
+            ],
+            workflows: [
                 {
-                    type: "text",
-                    text: guide,
-                },
+                    name: "开发流程",
+                    description: "分析 package.json scripts",
+                    steps: ["npm run dev", "npm run build", "npm test"]
+                }
             ],
+            documentation: [
+                {
+                    path: `${docsDir}/project-context.md`,
+                    purpose: "项目上下文文档"
+                }
+            ]
         };
+        return okStructured(guide, structuredData, {
+            schema: (await import("../schemas/output/project-tools.js")).ProjectContextSchema,
+        });
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `❌ 初始化项目上下文失败: ${errorMessage}`,
-                },
-            ],
-            isError: true,
+        const errorData = {
+            summary: "项目上下文初始化失败",
+            projectOverview: {
+                name: "",
+                description: "",
+                techStack: [],
+                architecture: ""
+            }
         };
+        return okStructured(`❌ 初始化项目上下文失败: ${errorMessage}`, errorData, {
+            schema: (await import("../schemas/output/project-tools.js")).ProjectContextSchema,
+        });
     }
 }

package/build/tools/perf.d.ts

@@ -1,13 +1 @@
-export declare function perf(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-}>;
+export declare function perf(args: any): Promise<import("../lib/response.js").ToolResponse>;

package/build/tools/perf.js

@@ -1,4 +1,5 @@
 import { parseArgs, getString } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
 // perf 工具实现
 export async function perf(args) {
     try {
@@ -385,25 +386,27 @@ console.log(\`耗时: \${end - start}ms\`);
 - ✅ 输出结构化瓶颈清单和优化建议
 
 现在请分析代码，提供详细的性能优化建议。`;
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: message,
-                },
-            ],
+        // 创建结构化数据对象
+        const perfReport = {
+            summary: `性能分析 - ${type}`,
+            overallScore: 70,
+            bottlenecks: [],
+            optimizations: [],
         };
+        return okStructured(message, perfReport, {
+            schema: (await import('../schemas/output/core-tools.js')).PerformanceReportSchema,
+        });
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `❌ 性能分析失败: ${errorMessage}`,
-                },
-            ],
-            isError: true,
+        const errorData = {
+            summary: `性能分析失败: ${errorMessage}`,
+            overallScore: 0,
+            bottlenecks: [],
+            optimizations: [],
         };
+        return okStructured(`❌ 性能分析失败: ${errorMessage}`, errorData, {
+            schema: (await import('../schemas/output/core-tools.js')).PerformanceReportSchema,
+        });
     }
 }

package/build/tools/refactor.d.ts

@@ -1,13 +1 @@
-export declare function refactor(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-}>;
+export declare function refactor(args: any): Promise<import("../lib/response.js").ToolResponse>;

package/build/tools/refactor.js

@@ -1,4 +1,5 @@
 import { parseArgs, getString } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
 // refactor 工具实现
 export async function refactor(args) {
     try {
@@ -315,26 +316,64 @@ const result = pipe(
 - ✅ 保持功能不变，仅改善代码结构
 - ✅ 输出结构化重构方案和示例代码
 
+---
+
+## 📤 输出格式要求
+
+请严格按以下 JSON 格式输出重构计划：
+
+\`\`\`json
+{
+  "summary": "重构摘要",
+  "goal": "improve_readability|reduce_complexity|improve_performance|improve_maintainability|modernize",
+  "currentIssues": ["问题1", "问题2"],
+  "refactoringSteps": [
+    {
+      "step": 1,
+      "title": "步骤标题",
+      "description": "步骤描述",
+      "before": "重构前代码",
+      "after": "重构后代码",
+      "rationale": "重构理由"
+    }
+  ],
+  "riskAssessment": {
+    "level": "low|medium|high",
+    "risks": ["风险1", "风险2"],
+    "mitigations": ["缓解措施1", "缓解措施2"]
+  },
+  "expectedBenefits": ["收益1", "收益2"]
+}
+\`\`\`
+
 现在请分析代码，提供详细的重构建议和实施计划。`;
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: message,
-                },
-            ],
+        // 创建结构化数据对象
+        const refactorPlan = {
+            summary: `代码重构计划 - 目标: ${goal || '全面优化'}`,
+            goal: goal || 'improve_maintainability',
+            refactoringSteps: [],
+            riskAssessment: {
+                level: 'medium',
+                risks: [],
+            },
         };
+        return okStructured(message, refactorPlan, {
+            schema: (await import('../schemas/output/core-tools.js')).RefactorPlanSchema,
+        });
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `❌ 重构分析失败: ${errorMessage}`,
-                },
-            ],
-            isError: true,
+        const errorData = {
+            summary: `重构分析失败: ${errorMessage}`,
+            goal: 'improve_maintainability',
+            refactoringSteps: [],
+            riskAssessment: {
+                level: 'high',
+                risks: [errorMessage],
+            },
         };
+        return okStructured(`❌ 重构分析失败: ${errorMessage}`, errorData, {
+            schema: (await import('../schemas/output/core-tools.js')).RefactorPlanSchema,
+        });
     }
 }

package/build/tools/render_ui.d.ts

@@ -1,22 +1,5 @@
 /**
- * UI 渲染工具
- *
+ * UI 渲染引擎（内部工具）
  * 将 JSON 模板渲染为最终代码
- * 自动应用设计规范，确保样式统一
  */
-/**
- * UI 渲染工具
- */
-export declare function renderUi(args: any): Promise<{
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError: boolean;
-} | {
-    content: {
-        type: string;
-        text: string;
-    }[];
-    isError?: undefined;
-}>;
+export declare function renderUi(args: any): Promise<import("../lib/response.js").ToolResponse>;