mcp-probe-kit 1.15.1 → 2.0.0

package/build/schemas/output/core-tools.js

@@ -0,0 +1,421 @@
+/**
+ * 核心开发工具的结构化输出 Schema
+ * 包含: code_review, debug, fix_bug, gentest, refactor, security_scan, perf
+ */
+/**
+ * Code Review Report Schema
+ * 用于 code_review 工具的结构化输出
+ */
+export const CodeReviewReportSchema = {
+    type: 'object',
+    properties: {
+        summary: {
+            type: 'string',
+            description: '审查总结',
+        },
+        overallScore: {
+            type: 'number',
+            minimum: 0,
+            maximum: 100,
+            description: '总体评分（0-100）',
+        },
+        issues: {
+            type: 'array',
+            description: '问题列表',
+            items: {
+                type: 'object',
+                properties: {
+                    severity: {
+                        type: 'string',
+                        enum: ['critical', 'high', 'medium', 'low', 'info'],
+                        description: '严重程度',
+                    },
+                    category: {
+                        type: 'string',
+                        enum: ['security', 'performance', 'quality', 'style', 'best-practice'],
+                        description: '问题类别',
+                    },
+                    line: { type: 'number', description: '行号' },
+                    file: { type: 'string', description: '文件路径' },
+                    message: { type: 'string', description: '问题描述' },
+                    suggestion: { type: 'string', description: '修复建议' },
+                    code: { type: 'string', description: '问题代码片段' },
+                },
+                required: ['severity', 'category', 'message'],
+            },
+        },
+        strengths: {
+            type: 'array',
+            items: { type: 'string' },
+            description: '代码优点',
+        },
+        recommendations: {
+            type: 'array',
+            items: { type: 'string' },
+            description: '改进建议',
+        },
+        metrics: {
+            type: 'object',
+            description: '代码指标',
+            properties: {
+                complexity: { type: 'number' },
+                maintainability: { type: 'number' },
+                testCoverage: { type: 'number' },
+            },
+        },
+    },
+    required: ['summary', 'overallScore', 'issues'],
+};
+/**
+ * Debug Report Schema
+ * 用于 debug 工具的结构化输出
+ */
+export const DebugReportSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string', description: '调试摘要' },
+        rootCause: { type: 'string', description: '根本原因分析' },
+        errorType: {
+            type: 'string',
+            enum: ['syntax', 'runtime', 'logic', 'performance', 'memory', 'network', 'unknown'],
+            description: '错误类型',
+        },
+        location: {
+            type: 'object',
+            properties: {
+                file: { type: 'string' },
+                line: { type: 'number' },
+                column: { type: 'number' },
+                function: { type: 'string' },
+            },
+        },
+        stackTrace: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    file: { type: 'string' },
+                    line: { type: 'number' },
+                    function: { type: 'string' },
+                },
+            },
+        },
+        debugStrategy: {
+            type: 'array',
+            items: { type: 'string' },
+            description: '调试策略',
+        },
+        solutions: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string' },
+                    description: { type: 'string' },
+                    code: { type: 'string' },
+                    priority: { type: 'string', enum: ['high', 'medium', 'low'] },
+                },
+                required: ['title', 'description'],
+            },
+        },
+        relatedIssues: {
+            type: 'array',
+            items: { type: 'string' },
+        },
+    },
+    required: ['summary', 'rootCause', 'errorType', 'solutions'],
+};
+/**
+ * Bug Analysis Schema
+ * 用于 fix_bug 工具的结构化输出
+ */
+export const BugAnalysisSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string', description: 'Bug 摘要' },
+        bugType: {
+            type: 'string',
+            enum: ['functional', 'performance', 'security', 'ui', 'data', 'integration'],
+        },
+        severity: {
+            type: 'string',
+            enum: ['critical', 'high', 'medium', 'low'],
+        },
+        rootCause: { type: 'string' },
+        affectedComponents: {
+            type: 'array',
+            items: { type: 'string' },
+        },
+        affectedFiles: {
+            type: 'array',
+            items: { type: 'string' },
+        },
+        fixPlan: {
+            type: 'object',
+            properties: {
+                steps: { type: 'array', items: { type: 'string' } },
+                estimatedTime: { type: 'string' },
+                risks: { type: 'array', items: { type: 'string' } },
+            },
+            required: ['steps'],
+        },
+        testPlan: {
+            type: 'object',
+            properties: {
+                unitTests: { type: 'array', items: { type: 'string' } },
+                integrationTests: { type: 'array', items: { type: 'string' } },
+                manualTests: { type: 'array', items: { type: 'string' } },
+            },
+        },
+        preventionMeasures: {
+            type: 'array',
+            items: { type: 'string' },
+        },
+    },
+    required: ['summary', 'bugType', 'severity', 'rootCause', 'fixPlan', 'testPlan'],
+};
+/**
+ * Test Suite Schema
+ * 用于 gentest 工具的结构化输出
+ */
+export const TestSuiteSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        framework: {
+            type: 'string',
+            enum: ['jest', 'vitest', 'mocha', 'jasmine', 'pytest', 'junit'],
+        },
+        testCases: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string' },
+                    description: { type: 'string' },
+                    type: {
+                        type: 'string',
+                        enum: ['unit', 'integration', 'e2e', 'performance'],
+                    },
+                    code: { type: 'string' },
+                    assertions: { type: 'array', items: { type: 'string' } },
+                },
+                required: ['name', 'type', 'code'],
+            },
+        },
+        edgeCases: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    scenario: { type: 'string' },
+                    input: { type: 'string' },
+                    expectedOutput: { type: 'string' },
+                },
+            },
+        },
+        mockData: {
+            type: 'object',
+            additionalProperties: true,
+        },
+        coverage: {
+            type: 'object',
+            properties: {
+                statements: { type: 'number' },
+                branches: { type: 'number' },
+                functions: { type: 'number' },
+                lines: { type: 'number' },
+            },
+        },
+    },
+    required: ['summary', 'framework', 'testCases'],
+};
+/**
+ * Refactor Plan Schema
+ * 用于 refactor 工具的结构化输出
+ */
+export const RefactorPlanSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        goal: {
+            type: 'string',
+            enum: ['improve_readability', 'reduce_complexity', 'improve_performance', 'improve_maintainability', 'modernize'],
+        },
+        currentIssues: {
+            type: 'array',
+            items: { type: 'string' },
+        },
+        refactoringSteps: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    step: { type: 'number' },
+                    title: { type: 'string' },
+                    description: { type: 'string' },
+                    before: { type: 'string' },
+                    after: { type: 'string' },
+                    rationale: { type: 'string' },
+                },
+                required: ['step', 'title', 'description'],
+            },
+        },
+        riskAssessment: {
+            type: 'object',
+            properties: {
+                level: { type: 'string', enum: ['low', 'medium', 'high'] },
+                risks: { type: 'array', items: { type: 'string' } },
+                mitigations: { type: 'array', items: { type: 'string' } },
+            },
+            required: ['level', 'risks'],
+        },
+        rollbackPlan: { type: 'string' },
+        estimatedEffort: {
+            type: 'object',
+            properties: {
+                hours: { type: 'number' },
+                complexity: { type: 'string', enum: ['low', 'medium', 'high'] },
+            },
+        },
+        expectedBenefits: {
+            type: 'array',
+            items: { type: 'string' },
+        },
+    },
+    required: ['summary', 'goal', 'refactoringSteps', 'riskAssessment'],
+};
+/**
+ * Security Report Schema
+ * 用于 security_scan 工具的结构化输出
+ */
+export const SecurityReportSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        overallRisk: {
+            type: 'string',
+            enum: ['critical', 'high', 'medium', 'low', 'none'],
+        },
+        vulnerabilities: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string' },
+                    type: {
+                        type: 'string',
+                        enum: ['injection', 'xss', 'csrf', 'auth', 'crypto', 'data-exposure', 'dos', 'other'],
+                    },
+                    severity: {
+                        type: 'string',
+                        enum: ['critical', 'high', 'medium', 'low'],
+                    },
+                    title: { type: 'string' },
+                    description: { type: 'string' },
+                    location: {
+                        type: 'object',
+                        properties: {
+                            file: { type: 'string' },
+                            line: { type: 'number' },
+                            code: { type: 'string' },
+                        },
+                    },
+                    cwe: { type: 'string' },
+                    cvss: { type: 'number' },
+                    remediation: { type: 'string' },
+                    references: { type: 'array', items: { type: 'string' } },
+                },
+                required: ['type', 'severity', 'title', 'description'],
+            },
+        },
+        complianceChecks: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    standard: { type: 'string' },
+                    passed: { type: 'boolean' },
+                    details: { type: 'string' },
+                },
+            },
+        },
+        recommendations: {
+            type: 'array',
+            items: { type: 'string' },
+        },
+    },
+    required: ['summary', 'overallRisk', 'vulnerabilities'],
+};
+/**
+ * Performance Report Schema
+ * 用于 perf 工具的结构化输出
+ */
+export const PerformanceReportSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        overallScore: {
+            type: 'number',
+            minimum: 0,
+            maximum: 100,
+        },
+        bottlenecks: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    type: {
+                        type: 'string',
+                        enum: ['algorithm', 'memory', 'database', 'network', 'rendering', 'io'],
+                    },
+                    severity: {
+                        type: 'string',
+                        enum: ['critical', 'high', 'medium', 'low'],
+                    },
+                    location: {
+                        type: 'object',
+                        properties: {
+                            file: { type: 'string' },
+                            line: { type: 'number' },
+                            function: { type: 'string' },
+                        },
+                    },
+                    description: { type: 'string' },
+                    impact: { type: 'string' },
+                    currentMetric: { type: 'string' },
+                },
+                required: ['type', 'severity', 'description'],
+            },
+        },
+        metrics: {
+            type: 'object',
+            properties: {
+                executionTime: { type: 'number' },
+                memoryUsage: { type: 'number' },
+                cpuUsage: { type: 'number' },
+                throughput: { type: 'number' },
+                latency: { type: 'number' },
+            },
+        },
+        optimizations: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string' },
+                    description: { type: 'string' },
+                    priority: { type: 'string', enum: ['high', 'medium', 'low'] },
+                    expectedImprovement: { type: 'string' },
+                    implementation: { type: 'string' },
+                },
+                required: ['title', 'description', 'priority'],
+            },
+        },
+        benchmarks: {
+            type: 'object',
+            additionalProperties: true,
+        },
+    },
+    required: ['summary', 'overallScore', 'bottlenecks', 'optimizations'],
+};