mcp-probe-kit 1.15.0 → 2.0.0

package/build/tools/__tests__/start_ui.integration.test.js

@@ -13,7 +13,7 @@ describe('start_ui 集成测试', () => {
                 framework: 'react'
             });
             expect(result.isError).not.toBe(true);
-            const text = result.content[0].text;
+            const text = result.content[0].text || '';
             // 1. 应该包含快速开始部分
             expect(text).toMatch(/^#\s+快速开始/m);
             // 2. 应该包含 4 个步骤
@@ -69,7 +69,7 @@ describe('start_ui 集成测试', () => {
                 framework: 'react'
             });
             expect(result.isError).not.toBe(true);
-            const text = result.content[0].text;
+            const text = result.content[0].text || '';
             // 应该包含转义后的描述
             expect(text).toMatch(/带有用户认证和权限管理的管理后台/);
             // 所有 JSON 应该是有效的
@@ -100,7 +100,7 @@ describe('start_ui 集成测试', () => {
                 mode: 'invalid'
             });
             expect(result.isError).toBe(true);
-            const text = result.content[0].text;
+            const text = result.content[0].text || '';
             // 应该说明问题
             expect(text).toMatch(/无效的模式/);
             // 应该列出有效选项
@@ -116,7 +116,7 @@ describe('start_ui 集成测试', () => {
                 description: '用户列表',
                 framework: 'vue'
             });
-            const text = result.content[0].text;
+            const text = result.content[0].text || '';
             // 提取所有 JSON 代码块
             const jsonBlocks = text.match(/```json\n([\s\S]*?)\n```/g);
             expect(jsonBlocks).toBeTruthy();
@@ -139,7 +139,7 @@ describe('start_ui 集成测试', () => {
                 description: '测试',
                 framework: 'react'
             });
-            const text = result.content[0].text;
+            const text = result.content[0].text || '';
             // 定义有效的工具名称
             const validTools = [
                 'ui_design_system',

package/build/tools/__tests__/start_ui.property.test.js

@@ -14,7 +14,7 @@ describe('start_ui 属性测试', () => {
             framework: fc.constantFrom('react', 'vue', 'html')
         }), async (input) => {
             const result = await startUi(input);
-            const text = result.content[0].text;
+            const text = result.content[0].text || '';
             // 简单的 token 估算：按空格和标点分割
             const tokenCount = text.split(/[\s\n]+/).length;
             // 硬性约束：必须少于 800 tokens
@@ -28,7 +28,7 @@ describe('start_ui 属性测试', () => {
             framework: fc.constantFrom('react', 'vue', 'html')
         }), async (input) => {
             const result = await startUi(input);
-            const text = result.content[0].text;
+            const text = result.content[0].text || '';
             // 应该包含 H1 标题（快速开始）
             expect(text).toMatch(/^#\s+快速开始/m);
             // 应该包含 H2 标题（步骤）
@@ -46,7 +46,7 @@ describe('start_ui 属性测试', () => {
             framework: fc.constantFrom('react', 'vue', 'html')
         }), async (input) => {
             const result = await startUi(input);
-            const text = result.content[0].text;
+            const text = result.content[0].text || '';
             // 如果包含 JSON 参数，应该在代码块中
             const jsonBlocks = text.match(/```json[\s\S]*?```/g);
             expect(jsonBlocks).toBeTruthy();
@@ -60,7 +60,7 @@ describe('start_ui 属性测试', () => {
             framework: fc.constantFrom('react', 'vue', 'html')
         }), async (input) => {
             const result = await startUi(input);
-            const text = result.content[0].text;
+            const text = result.content[0].text || '';
             // 提取所有 JSON 代码块
             const jsonBlocks = text.match(/```json\n([\s\S]*?)\n```/g);
             if (jsonBlocks) {
@@ -87,7 +87,7 @@ describe('start_ui 属性测试', () => {
             framework: fc.constantFrom('react', 'vue', 'html')
         }), async (input) => {
             const result = await startUi(input);
-            const text = result.content[0].text;
+            const text = result.content[0].text || '';
             // 应该包含有效的工具名称
             const validTools = [
                 'ui_design_system',
@@ -112,7 +112,7 @@ test('任务 3.4: 每个步骤包含预期输出', async () => {
         framework: fc.constantFrom('react', 'vue', 'html')
     }), async (input) => {
         const result = await startUi(input);
-        const text = result.content[0].text;
+        const text = result.content[0].text || '';
         // 应该包含"预期输出"部分
         expect(text).toMatch(/预期输出|Expected Output/i);
         // 每个步骤都应该有预期输出
@@ -131,7 +131,7 @@ test('任务 3.4: 步骤包含依赖关系说明', async () => {
         framework: fc.constantFrom('react', 'vue', 'html')
     }), async (input) => {
         const result = await startUi(input);
-        const text = result.content[0].text;
+        const text = result.content[0].text || '';
         // 应该包含依赖关系的说明（如"确保步骤 1"）
         const hasDependency = text.includes('确保步骤') ||
             text.includes('确保') ||
@@ -147,7 +147,7 @@ test('任务 3.4: 每个步骤包含失败处理', async () => {
         framework: fc.constantFrom('react', 'vue', 'html')
     }), async (input) => {
         const result = await startUi(input);
-        const text = result.content[0].text;
+        const text = result.content[0].text || '';
         // 应该包含"失败处理"部分
         expect(text).toMatch(/失败处理|Failure Handling|On Failure/i);
         // 每个步骤都应该有失败处理
@@ -212,7 +212,7 @@ test('任务 6.4: 指导包含显式工具名称', async () => {
         framework: fc.constantFrom('react', 'vue', 'html')
     }), async (input) => {
         const result = await startUi(input);
-        const text = result.content[0].text;
+        const text = result.content[0].text || '';
         // 应该包含明确的工具名称
         const hasToolNames = text.includes('ui_design_system') ||
             text.includes('init_component_catalog') ||
@@ -230,7 +230,7 @@ test('任务 6.4: 无模糊语言', async () => {
         framework: fc.constantFrom('react', 'vue', 'html')
     }), async (input) => {
         const result = await startUi(input);
-        const text = result.content[0].text;
+        const text = result.content[0].text || '';
         // 不应该包含模糊的指令（没有具体工具名称或文件名）
         // 如果包含"检查"，应该伴随具体的文件名或工具名
         const checkMatches = text.match(/检查[^。\n]*/g) || [];
@@ -254,7 +254,7 @@ test('任务 6.4: 包含职责范围声明', async () => {
         framework: fc.constantFrom('react', 'vue', 'html')
     }), async (input) => {
         const result = await startUi(input);
-        const text = result.content[0].text;
+        const text = result.content[0].text || '';
         // 应该包含职责说明
         expect(text).toMatch(/职责说明|职责|Responsibility/i);
         // 应该说明只提供指导

package/build/tools/add_feature.d.ts

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

package/build/tools/add_feature.js

@@ -1,4 +1,5 @@
 import { parseArgs, getString } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
 /**
  * add_feature 工具
  *
@@ -511,26 +512,60 @@ export async function addFeature(args) {
             .replace(/{feature_name}/g, featureName)
             .replace(/{description}/g, description)
             .replace(/{docs_dir}/g, docsDir);
-        // 返回结果
-        return {
-            content: [
+        // 创建结构化数据对象
+        const structuredData = {
+            summary: `添加功能：${featureName}`,
+            featureName: featureName,
+            requirements: [
+                "待生成需求文档",
+                "使用 EARS 格式编写验收标准"
+            ],
+            design: {
+                architecture: "待设计",
+                components: [],
+                dataFlow: "待设计"
+            },
+            tasks: [
                 {
-                    type: "text",
-                    text: guide,
+                    id: "1",
+                    title: "生成需求文档",
+                    description: `创建 ${docsDir}/specs/${featureName}/requirements.md`,
+                    estimatedHours: 1
                 },
+                {
+                    id: "2",
+                    title: "生成设计文档",
+                    description: `创建 ${docsDir}/specs/${featureName}/design.md`,
+                    estimatedHours: 2
+                },
+                {
+                    id: "3",
+                    title: "生成任务清单",
+                    description: `创建 ${docsDir}/specs/${featureName}/tasks.md`,
+                    estimatedHours: 1
+                }
             ],
+            estimate: {
+                storyPoints: 0,
+                optimistic: "待估算",
+                normal: "待估算",
+                pessimistic: "待估算"
+            }
         };
+        return okStructured(guide, structuredData, {
+            schema: (await import("../schemas/output/project-tools.js")).FeatureSpecSchema,
+        });
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `❌ 添加功能失败: ${errorMessage}`,
-                },
-            ],
-            isError: true,
+        const errorData = {
+            summary: "添加功能失败",
+            featureName: "",
+            requirements: [],
+            tasks: []
         };
+        return okStructured(`❌ 添加功能失败: ${errorMessage}`, errorData, {
+            schema: (await import("../schemas/output/project-tools.js")).FeatureSpecSchema,
+        });
     }
 }

package/build/tools/analyze_project.js

@@ -1,4 +1,5 @@
 import { parseArgs, getString, getNumber, getBoolean } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
 import { readFileSync, readdirSync, statSync, existsSync } from 'fs';
 import { join, extname } from 'path';
 import { VERSION } from '../version.js';
@@ -23,11 +24,7 @@ export async function analyzeProject(args) {
     try {
         console.error(`开始分析项目: ${projectPath}`);
         const analysis = await performProjectAnalysis(projectPath, maxDepth, includeContent);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `# 📊 项目分析报告
+        const message = `# 📊 项目分析报告
 
 ## 🏗️ 项目概览
 - **项目名称**: ${analysis.projectStructure.name}
@@ -62,10 +59,10 @@ ${analysis.dependencies.production.slice(0, 10).map(dep => `- ${dep}`).join('\n'
 ${analysis.codeMetrics.skippedFiles > 0 ? `- **跳过文件**: ${analysis.codeMetrics.skippedFiles} 个（过大或无法读取）` : ''}
 - **文件类型分布**:
 ${Object.entries(analysis.codeMetrics.fileTypes)
-                        .sort(([, a], [, b]) => b - a)
-                        .slice(0, 10)
-                        .map(([type, count]) => `  - ${type}: ${count} 个文件`)
-                        .join('\n')}
+            .sort(([, a], [, b]) => b - a)
+            .slice(0, 10)
+            .map(([type, count]) => `  - ${type}: ${count} 个文件`)
+            .join('\n')}
 ${Object.keys(analysis.codeMetrics.fileTypes).length > 10 ? '  - ... (更多类型已省略)' : ''}
 
 ### 最大文件
@@ -89,21 +86,63 @@ ${analysis.summary.recommendations.map(rec => `- ${rec}`).join('\n')}
 **分析说明**:
 - 大型项目会自动采样分析，限制最多扫描 5000 个文件
 - 已自动忽略以下目录: \`node_modules\`, \`dist\`, \`build\`, \`.git\`, \`coverage\`, \`.next\`, \`.nuxt\`, \`vendor\` 等
-- 单个文件大小限制: 1MB，超过则跳过`,
+- 单个文件大小限制: 1MB，超过则跳过`;
+        // 创建结构化数据对象
+        const structuredData = {
+            summary: `项目分析：${analysis.projectStructure.name}`,
+            structure: {
+                totalFiles: analysis.codeMetrics.totalFiles,
+                totalLines: analysis.codeMetrics.totalLines,
+                languages: analysis.codeMetrics.fileTypes
+            },
+            techStack: [
+                {
+                    name: analysis.projectStructure.framework,
+                    version: "待检测",
+                    purpose: "主要框架"
                 },
+                {
+                    name: analysis.projectStructure.language,
+                    version: "待检测",
+                    purpose: "编程语言"
+                }
             ],
+            architecture: {
+                pattern: analysis.architecture.patterns.join(', '),
+                layers: analysis.architecture.mainModules,
+                description: analysis.summary.purpose
+            },
+            dependencies: {
+                production: analysis.dependencies.production.length,
+                development: analysis.dependencies.development.length,
+                outdated: 0
+            },
+            codeQuality: {
+                complexity: analysis.summary.complexity,
+                maintainability: 0,
+                testCoverage: 0
+            },
+            recommendations: analysis.summary.recommendations
         };
+        return okStructured(message, structuredData, {
+            schema: (await import("../schemas/output/project-tools.js")).ProjectAnalysisSchema,
+        });
     }
     catch (error) {
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `❌ 项目分析失败: ${error instanceof Error ? error.message : String(error)}`,
-                },
-            ],
-            isError: true,
+        const errorMsg = error instanceof Error ? error.message : String(error);
+        const errorData = {
+            summary: "项目分析失败",
+            structure: {
+                totalFiles: 0,
+                totalLines: 0,
+                languages: {}
+            },
+            techStack: [],
+            recommendations: [errorMsg]
         };
+        return okStructured(`❌ 项目分析失败: ${errorMsg}`, errorData, {
+            schema: (await import("../schemas/output/project-tools.js")).ProjectAnalysisSchema,
+        });
     }
 }
 async function performProjectAnalysis(projectPath, maxDepth, includeContent) {

package/build/tools/check_deps.d.ts

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

package/build/tools/check_deps.js

@@ -1,3 +1,4 @@
+import { okStructured } from "../lib/response.js";
 // check_deps 工具实现（无参数）
 export async function checkDeps(_args) {
     try {
@@ -180,25 +181,33 @@ grep -r "from 'package-name'" src/
 ---
 
 现在请开始依赖分析，生成详细的分析报告和升级计划。`;
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: message,
-                },
-            ],
+        // 创建结构化数据对象
+        const structuredData = {
+            summary: "依赖健康度分析",
+            totalDependencies: 0,
+            outdated: [],
+            vulnerabilities: [],
+            unused: [],
+            recommendations: [
+                "运行 npm outdated 检查过期依赖",
+                "运行 npm audit 检查安全漏洞",
+                "使用 depcheck 查找未使用的依赖",
+                "定期更新依赖以保持项目健康"
+            ]
         };
+        return okStructured(message, structuredData, {
+            schema: (await import("../schemas/output/project-tools.js")).DependencyReportSchema,
+        });
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `❌ 依赖分析失败: ${errorMessage}`,
-                },
-            ],
-            isError: true,
+        const errorData = {
+            summary: "依赖分析失败",
+            totalDependencies: 0,
+            recommendations: [errorMessage]
         };
+        return okStructured(`❌ 依赖分析失败: ${errorMessage}`, errorData, {
+            schema: (await import("../schemas/output/project-tools.js")).DependencyReportSchema,
+        });
     }
 }

package/build/tools/code_review.d.ts

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

package/build/tools/code_review.js

@@ -1,4 +1,5 @@
 import { parseArgs, getString } from "../utils/parseArgs.js";
+import { okStructured } from "../lib/response.js";
 // code_review 工具实现
 export async function codeReview(args) {
     try {
@@ -160,25 +161,27 @@ ${code || "请提供需要审查的代码"}
 - ✅ 输出结构化问题清单和改进建议
 
 现在请开始代码审查，生成详细的审查报告。`;
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: message,
-                },
-            ],
+        // 创建结构化数据（示例数据，实际应由 AI 生成）
+        const structuredData = {
+            summary: "代码审查完成，请查看详细报告",
+            overallScore: 0, // AI 会填充实际分数
+            issues: [], // AI 会填充实际问题
+            strengths: [], // AI 会填充优点
+            recommendations: [], // AI 会填充建议
         };
+        return okStructured(message, // 保持向后兼容的文本输出
+        structuredData, {
+            schema: (await import('../schemas/output/core-tools.js')).CodeReviewReportSchema,
+        });
     }
     catch (error) {
         const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `❌ 代码审查失败: ${errorMessage}`,
-                },
-            ],
-            isError: true,
-        };
+        return okStructured(`❌ 代码审查失败: ${errorMessage}`, {
+            summary: `代码审查失败: ${errorMessage}`,
+            overallScore: 0,
+            issues: [],
+        }, {
+            schema: (await import('../schemas/output/core-tools.js')).CodeReviewReportSchema,
+        });
     }
 }

package/build/tools/css_order.js

@@ -1,61 +1,61 @@
 // css_order 工具实现
 export async function cssOrder(_args) {
     try {
-        const message = `请根据以下规则**书写或重排 CSS**（不是解释规则）。目标是让 CSS 属性顺序更一致、可读、可维护。
-
-如果我提供了 CSS 片段/文件，请直接给出**已按规则整理后的 CSS**；如果没提供，请先让我提供需要处理的 CSS。
-
----
-
-## 排序逻辑（由外向内，由大到小）
-
-将属性分为五类，按顺序排列：
-
-### 1. 定位属性 (Positioning)
-决定元素“在哪里”。
-- \`position\` / \`z-index\` / \`top\` / \`right\` / \`bottom\` / \`left\` / \`float\` / \`clear\`
-
-### 2. 盒子模型 (Box Model)
-决定元素“占多大空间”。
-- \`display\` / \`flex\` / \`grid\` 相关属性
-- \`width\` / \`height\` / \`max-width\` / \`min-width\`
-- \`margin\` / \`padding\` / \`border\`
-- \`box-sizing\` / \`overflow\`
-
-### 3. 文本排版 (Typography)
-决定元素内“文字内容”的样式。
-- \`font-family\` / \`font-size\` / \`font-weight\` / \`line-height\`
-- \`text-align\` / \`text-transform\` / \`text-decoration\` / \`letter-spacing\` / \`white-space\` / \`color\`
-
-### 4. 视觉表现 (Visual/Decoration)
-决定元素“皮肤”的外观。
-- \`background\` / \`box-shadow\` / \`opacity\` / \`visibility\` / \`cursor\` / \`outline\`
-
-### 5. 其他与交互 (Misc/Transitions)
-动效和交互相关。
-- \`transition\` / \`animation\` / \`transform\` / \`will-change\`
-
----
-
-## 处理要求
-
-1. **只调整属性顺序，不改动语义**（除非存在明显重复/冲突属性）。
-2. **保留注释与格式风格**（缩进、空行、选择器顺序不变）。
-3. **同类属性保持原有相对顺序**，除非有明显更合理的排序。
-4. 如果存在 **CSS 变量**（\`--*\`）或自定义属性，放在**当前类的最前**。
-5. 如遇 CSS-in-JS、Tailwind 或非标准语法，**只处理可确定的纯 CSS 属性**。
-
----
-
-## 快速对比表
-
-| 顺序 | 类别 | 常用属性举例 | 核心目的 |
-| --- | --- | --- | --- |
-| **1** | **定位** | \`position\`, \`z-index\`, \`top\` | 确定位置 |
-| **2** | **盒模型** | \`display\`, \`width\`, \`margin\`, \`padding\` | 确定形状和间距 |
-| **3** | **排版** | \`font\`, \`line-height\`, \`color\`, \`text-align\` | 确定内容样式 |
-| **4** | **视觉** | \`background\`, \`border-radius\`, \`box-shadow\` | 确定外观修饰 |
-| **5** | **其他** | \`transition\`, \`transform\`, \`animation\` | 确定动态交互 |
+        const message = `请根据以下规则**书写或重排 CSS**（不是解释规则）。目标是让 CSS 属性顺序更一致、可读、可维护。
+
+如果我提供了 CSS 片段/文件，请直接给出**已按规则整理后的 CSS**；如果没提供，请先让我提供需要处理的 CSS。
+
+---
+
+## 排序逻辑（由外向内，由大到小）
+
+将属性分为五类，按顺序排列：
+
+### 1. 定位属性 (Positioning)
+决定元素“在哪里”。
+- \`position\` / \`z-index\` / \`top\` / \`right\` / \`bottom\` / \`left\` / \`float\` / \`clear\`
+
+### 2. 盒子模型 (Box Model)
+决定元素“占多大空间”。
+- \`display\` / \`flex\` / \`grid\` 相关属性
+- \`width\` / \`height\` / \`max-width\` / \`min-width\`
+- \`margin\` / \`padding\` / \`border\`
+- \`box-sizing\` / \`overflow\`
+
+### 3. 文本排版 (Typography)
+决定元素内“文字内容”的样式。
+- \`font-family\` / \`font-size\` / \`font-weight\` / \`line-height\`
+- \`text-align\` / \`text-transform\` / \`text-decoration\` / \`letter-spacing\` / \`white-space\` / \`color\`
+
+### 4. 视觉表现 (Visual/Decoration)
+决定元素“皮肤”的外观。
+- \`background\` / \`box-shadow\` / \`opacity\` / \`visibility\` / \`cursor\` / \`outline\`
+
+### 5. 其他与交互 (Misc/Transitions)
+动效和交互相关。
+- \`transition\` / \`animation\` / \`transform\` / \`will-change\`
+
+---
+
+## 处理要求
+
+1. **只调整属性顺序，不改动语义**（除非存在明显重复/冲突属性）。
+2. **保留注释与格式风格**（缩进、空行、选择器顺序不变）。
+3. **同类属性保持原有相对顺序**，除非有明显更合理的排序。
+4. 如果存在 **CSS 变量**（\`--*\`）或自定义属性，放在**当前类的最前**。
+5. 如遇 CSS-in-JS、Tailwind 或非标准语法，**只处理可确定的纯 CSS 属性**。
+
+---
+
+## 快速对比表
+
+| 顺序 | 类别 | 常用属性举例 | 核心目的 |
+| --- | --- | --- | --- |
+| **1** | **定位** | \`position\`, \`z-index\`, \`top\` | 确定位置 |
+| **2** | **盒模型** | \`display\`, \`width\`, \`margin\`, \`padding\` | 确定形状和间距 |
+| **3** | **排版** | \`font\`, \`line-height\`, \`color\`, \`text-align\` | 确定内容样式 |
+| **4** | **视觉** | \`background\`, \`border-radius\`, \`box-shadow\` | 确定外观修饰 |
+| **5** | **其他** | \`transition\`, \`transform\`, \`animation\` | 确定动态交互 |
 `;
         return {
             content: [

package/build/tools/debug.d.ts

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