mcp-probe-kit 1.15.1 → 2.0.0

package/build/schemas/output/core-tools.d.ts

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