mcp-probe-kit 1.15.1 → 2.0.0

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

@@ -0,0 +1,446 @@
+/**
+ * 代码生成工具的结构化输出 Schema
+ * 包含: gendoc, genapi, gensql, genreadme, genui, gen_mock, genchangelog, genpr, fix, explain, convert, css_order
+ */
+/**
+ * Documentation Schema
+ * 用于 gendoc 工具的结构化输出
+ */
+export const DocumentationSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string', description: '文档摘要' },
+        docType: {
+            type: 'string',
+            enum: ['jsdoc', 'tsdoc', 'javadoc', 'pydoc', 'godoc'],
+            description: '文档类型',
+        },
+        documentation: {
+            type: 'string',
+            description: '生成的文档内容',
+        },
+        functions: {
+            type: 'array',
+            description: '函数文档列表',
+            items: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string' },
+                    description: { type: 'string' },
+                    parameters: {
+                        type: 'array',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                name: { type: 'string' },
+                                type: { type: 'string' },
+                                description: { type: 'string' },
+                                optional: { type: 'boolean' },
+                            },
+                        },
+                    },
+                    returns: {
+                        type: 'object',
+                        properties: {
+                            type: { type: 'string' },
+                            description: { type: 'string' },
+                        },
+                    },
+                    throws: {
+                        type: 'array',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                type: { type: 'string' },
+                                description: { type: 'string' },
+                            },
+                        },
+                    },
+                    examples: {
+                        type: 'array',
+                        items: { type: 'string' },
+                    },
+                },
+            },
+        },
+    },
+    required: ['summary', 'docType', 'documentation'],
+};
+/**
+ * API Documentation Schema
+ * 用于 genapi 工具的结构化输出
+ */
+export const APIDocumentationSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        format: {
+            type: 'string',
+            enum: ['markdown', 'openapi', 'swagger', 'postman'],
+        },
+        endpoints: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    method: { type: 'string', enum: ['GET', 'POST', 'PUT', 'DELETE', 'PATCH'] },
+                    path: { type: 'string' },
+                    summary: { type: 'string' },
+                    description: { type: 'string' },
+                    parameters: {
+                        type: 'array',
+                        items: {
+                            type: 'object',
+                            properties: {
+                                name: { type: 'string' },
+                                in: { type: 'string', enum: ['query', 'path', 'header', 'body'] },
+                                type: { type: 'string' },
+                                required: { type: 'boolean' },
+                                description: { type: 'string' },
+                            },
+                        },
+                    },
+                    requestBody: {
+                        type: 'object',
+                        properties: {
+                            contentType: { type: 'string' },
+                            schema: { type: 'object' },
+                            example: { type: 'object' },
+                        },
+                    },
+                    responses: {
+                        type: 'object',
+                        additionalProperties: {
+                            type: 'object',
+                            properties: {
+                                description: { type: 'string' },
+                                schema: { type: 'object' },
+                                example: { type: 'object' },
+                            },
+                        },
+                    },
+                },
+            },
+        },
+        documentation: { type: 'string' },
+    },
+    required: ['summary', 'format', 'endpoints', 'documentation'],
+};
+/**
+ * SQL Query Schema
+ * 用于 gensql 工具的结构化输出
+ */
+export const SQLQuerySchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        dialect: {
+            type: 'string',
+            enum: ['postgres', 'mysql', 'sqlite', 'mssql', 'oracle'],
+        },
+        query: { type: 'string', description: '生成的 SQL 查询' },
+        explanation: { type: 'string', description: '查询说明' },
+        parameters: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string' },
+                    type: { type: 'string' },
+                    description: { type: 'string' },
+                },
+            },
+        },
+        performance: {
+            type: 'object',
+            properties: {
+                estimatedRows: { type: 'number' },
+                indexes: { type: 'array', items: { type: 'string' } },
+                optimizations: { type: 'array', items: { type: 'string' } },
+            },
+        },
+    },
+    required: ['summary', 'dialect', 'query'],
+};
+/**
+ * README Schema
+ * 用于 genreadme 工具的结构化输出
+ */
+export const ReadmeSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        content: { type: 'string', description: '完整的 README 内容' },
+        sections: {
+            type: 'object',
+            properties: {
+                title: { type: 'string' },
+                description: { type: 'string' },
+                installation: { type: 'string' },
+                usage: { type: 'string' },
+                api: { type: 'string' },
+                examples: { type: 'string' },
+                contributing: { type: 'string' },
+                license: { type: 'string' },
+            },
+        },
+        badges: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string' },
+                    url: { type: 'string' },
+                    imageUrl: { type: 'string' },
+                },
+            },
+        },
+    },
+    required: ['summary', 'content'],
+};
+/**
+ * UI Component Schema
+ * 用于 genui 工具的结构化输出
+ */
+export const UIComponentSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        framework: {
+            type: 'string',
+            enum: ['react', 'vue', 'angular', 'svelte', 'html'],
+        },
+        componentName: { type: 'string' },
+        code: { type: 'string', description: '组件代码' },
+        props: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    name: { type: 'string' },
+                    type: { type: 'string' },
+                    required: { type: 'boolean' },
+                    default: { type: 'string' },
+                    description: { type: 'string' },
+                },
+            },
+        },
+        styles: { type: 'string', description: '样式代码' },
+        usage: { type: 'string', description: '使用示例' },
+    },
+    required: ['summary', 'framework', 'componentName', 'code'],
+};
+/**
+ * Mock Data Schema
+ * 用于 gen_mock 工具的结构化输出
+ */
+export const MockDataSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        format: {
+            type: 'string',
+            enum: ['json', 'typescript', 'javascript', 'csv'],
+        },
+        count: { type: 'number', description: '生成的数据条数' },
+        data: {
+            type: 'array',
+            description: '生成的 Mock 数据',
+            items: { type: 'object' },
+        },
+        schema: {
+            type: 'object',
+            description: '数据结构定义',
+        },
+        code: { type: 'string', description: '可直接使用的代码' },
+    },
+    required: ['summary', 'format', 'count', 'data'],
+};
+/**
+ * Changelog Schema
+ * 用于 genchangelog 工具的结构化输出
+ */
+export const ChangelogSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        version: { type: 'string' },
+        date: { type: 'string' },
+        content: { type: 'string', description: '完整的 Changelog 内容' },
+        changes: {
+            type: 'object',
+            properties: {
+                features: { type: 'array', items: { type: 'string' } },
+                fixes: { type: 'array', items: { type: 'string' } },
+                breaking: { type: 'array', items: { type: 'string' } },
+                deprecated: { type: 'array', items: { type: 'string' } },
+                security: { type: 'array', items: { type: 'string' } },
+                performance: { type: 'array', items: { type: 'string' } },
+                docs: { type: 'array', items: { type: 'string' } },
+                chore: { type: 'array', items: { type: 'string' } },
+            },
+        },
+    },
+    required: ['summary', 'version', 'content', 'changes'],
+};
+/**
+ * Pull Request Schema
+ * 用于 genpr 工具的结构化输出
+ */
+export const PullRequestSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        title: { type: 'string' },
+        description: { type: 'string', description: '完整的 PR 描述' },
+        type: {
+            type: 'string',
+            enum: ['feature', 'bugfix', 'hotfix', 'refactor', 'docs', 'chore'],
+        },
+        changes: {
+            type: 'object',
+            properties: {
+                added: { type: 'array', items: { type: 'string' } },
+                modified: { type: 'array', items: { type: 'string' } },
+                removed: { type: 'array', items: { type: 'string' } },
+            },
+        },
+        testing: { type: 'string', description: '测试说明' },
+        screenshots: {
+            type: 'array',
+            items: { type: 'string' },
+            description: '截图说明',
+        },
+        checklist: {
+            type: 'array',
+            items: { type: 'string' },
+        },
+    },
+    required: ['summary', 'title', 'description', 'type'],
+};
+/**
+ * Code Fix Schema
+ * 用于 fix 工具的结构化输出
+ */
+export const CodeFixSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        fixType: {
+            type: 'string',
+            enum: ['lint', 'format', 'typescript', 'import', 'syntax'],
+        },
+        originalCode: { type: 'string' },
+        fixedCode: { type: 'string' },
+        diff: { type: 'string', description: 'Unified diff' },
+        issues: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    line: { type: 'number' },
+                    message: { type: 'string' },
+                    fixed: { type: 'boolean' },
+                },
+            },
+        },
+    },
+    required: ['summary', 'fixType', 'fixedCode'],
+};
+/**
+ * Explanation Schema
+ * 用于 explain 工具的结构化输出
+ */
+export const ExplanationSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        overview: { type: 'string', description: '代码概述' },
+        purpose: { type: 'string', description: '代码目的' },
+        flow: {
+            type: 'array',
+            description: '执行流程',
+            items: {
+                type: 'object',
+                properties: {
+                    step: { type: 'number' },
+                    description: { type: 'string' },
+                    code: { type: 'string' },
+                },
+            },
+        },
+        keyConcepts: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    concept: { type: 'string' },
+                    explanation: { type: 'string' },
+                },
+            },
+        },
+        complexity: {
+            type: 'object',
+            properties: {
+                time: { type: 'string' },
+                space: { type: 'string' },
+            },
+        },
+    },
+    required: ['summary', 'overview', 'purpose'],
+};
+/**
+ * Conversion Schema
+ * 用于 convert 工具的结构化输出
+ */
+export const ConversionSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        from: { type: 'string', description: '源格式' },
+        to: { type: 'string', description: '目标格式' },
+        originalCode: { type: 'string' },
+        convertedCode: { type: 'string' },
+        changes: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    type: { type: 'string' },
+                    description: { type: 'string' },
+                    before: { type: 'string' },
+                    after: { type: 'string' },
+                },
+            },
+        },
+        warnings: {
+            type: 'array',
+            items: { type: 'string' },
+        },
+    },
+    required: ['summary', 'from', 'to', 'convertedCode'],
+};
+/**
+ * CSS Order Schema
+ * 用于 css_order 工具的结构化输出
+ */
+export const CSSOrderSchema = {
+    type: 'object',
+    properties: {
+        summary: { type: 'string' },
+        originalCSS: { type: 'string' },
+        orderedCSS: { type: 'string' },
+        rules: {
+            type: 'array',
+            items: {
+                type: 'object',
+                properties: {
+                    selector: { type: 'string' },
+                    propertiesCount: { type: 'number' },
+                    reordered: { type: 'boolean' },
+                },
+            },
+        },
+    },
+    required: ['summary', 'orderedCSS'],
+};

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

@@ -0,0 +1,243 @@
+/**
+ * 辅助工具的结构化输出 Schema
+ * 包含: detect_shell, init_setting, gen_skill
+ */
+/**
+ * Shell Detection Schema
+ * 用于 detect_shell 工具的结构化输出
+ */
+export declare const ShellDetectionSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly summary: {
+            readonly type: "string";
+        };
+        readonly shell: {
+            readonly type: "string";
+            readonly enum: readonly ["bash", "zsh", "fish", "powershell", "cmd", "sh", "unknown"];
+            readonly description: "检测到的 Shell 类型";
+        };
+        readonly version: {
+            readonly type: "string";
+            readonly description: "Shell 版本";
+        };
+        readonly os: {
+            readonly type: "string";
+            readonly enum: readonly ["linux", "macos", "windows", "unknown"];
+            readonly description: "操作系统";
+        };
+        readonly features: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly description: "Shell 特性";
+        };
+        readonly configFiles: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly path: {
+                        readonly type: "string";
+                    };
+                    readonly exists: {
+                        readonly type: "boolean";
+                    };
+                    readonly purpose: {
+                        readonly type: "string";
+                    };
+                };
+            };
+        };
+        readonly recommendations: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+    };
+    readonly required: readonly ["summary", "shell", "os"];
+};
+/**
+ * Setting Init Schema
+ * 用于 init_setting 工具的结构化输出
+ */
+export declare const SettingInitSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly summary: {
+            readonly type: "string";
+        };
+        readonly settingsPath: {
+            readonly type: "string";
+            readonly description: "设置文件路径";
+        };
+        readonly settings: {
+            readonly type: "object";
+            readonly description: "推荐的设置";
+            readonly additionalProperties: true;
+        };
+        readonly applied: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly key: {
+                        readonly type: "string";
+                    };
+                    readonly value: {
+                        readonly type: "string";
+                    };
+                    readonly reason: {
+                        readonly type: "string";
+                    };
+                };
+            };
+        };
+        readonly nextSteps: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+    };
+    readonly required: readonly ["summary", "settingsPath", "settings"];
+};
+/**
+ * Skill Doc Schema
+ * 用于 gen_skill 工具的结构化输出
+ */
+export declare const SkillDocSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly summary: {
+            readonly type: "string";
+        };
+        readonly scope: {
+            readonly type: "string";
+            readonly enum: readonly ["all", "single"];
+            readonly description: "生成范围";
+        };
+        readonly skills: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly toolName: {
+                        readonly type: "string";
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                    };
+                    readonly category: {
+                        readonly type: "string";
+                    };
+                    readonly useCases: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly examples: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly scenario: {
+                                    readonly type: "string";
+                                };
+                                readonly input: {
+                                    readonly type: "string";
+                                };
+                                readonly output: {
+                                    readonly type: "string";
+                                };
+                            };
+                        };
+                    };
+                    readonly parameters: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly name: {
+                                    readonly type: "string";
+                                };
+                                readonly type: {
+                                    readonly type: "string";
+                                };
+                                readonly required: {
+                                    readonly type: "boolean";
+                                };
+                                readonly description: {
+                                    readonly type: "string";
+                                };
+                            };
+                        };
+                    };
+                };
+            };
+        };
+        readonly outputPath: {
+            readonly type: "string";
+            readonly description: "输出路径";
+        };
+        readonly format: {
+            readonly type: "string";
+            readonly enum: readonly ["markdown", "json"];
+        };
+    };
+    readonly required: readonly ["summary", "scope", "skills"];
+};
+export interface ShellDetection {
+    summary: string;
+    shell: 'bash' | 'zsh' | 'fish' | 'powershell' | 'cmd' | 'sh' | 'unknown';
+    version?: string;
+    os: 'linux' | 'macos' | 'windows' | 'unknown';
+    features?: string[];
+    configFiles?: Array<{
+        path?: string;
+        exists?: boolean;
+        purpose?: string;
+    }>;
+    recommendations?: string[];
+}
+export interface SettingInit {
+    summary: string;
+    settingsPath: string;
+    settings: Record<string, any>;
+    applied?: Array<{
+        key?: string;
+        value?: string;
+        reason?: string;
+    }>;
+    nextSteps?: string[];
+}
+export interface SkillDoc {
+    summary: string;
+    scope: 'all' | 'single';
+    skills: Array<{
+        toolName?: string;
+        title?: string;
+        description?: string;
+        category?: string;
+        useCases?: string[];
+        examples?: Array<{
+            scenario?: string;
+            input?: string;
+            output?: string;
+        }>;
+        parameters?: Array<{
+            name?: string;
+            type?: string;
+            required?: boolean;
+            description?: string;
+        }>;
+    }>;
+    outputPath?: string;
+    format?: 'markdown' | 'json';
+}