mcp-probe-kit 3.0.8 → 3.0.10

package/build/schemas/structured-output.d.ts

@@ -15,15 +15,20 @@
  */
 /**
  * Commit Message Schema
- * 用于 gencommit 工具的结构化输出
+ * 用于提交草稿（保留给其他场景复用）
  */
 export declare const CommitMessageSchema: {
     readonly type: "object";
     readonly properties: {
+        readonly status: {
+            readonly type: "string";
+            readonly description: "生成状态：ready 表示已生成提交草稿；needs_changes 表示需要补充变更内容";
+            readonly enum: readonly ["ready", "needs_changes"];
+        };
         readonly type: {
             readonly type: "string";
             readonly description: "Commit 类型：feat/fix/docs/refactor/test/chore/style/perf";
-            readonly enum: readonly ["feat", "fix", "docs", "refactor", "test", "chore", "style", "perf", "ci", "build", "revert"];
+            readonly enum: readonly ["feat", "fix", "fixed", "docs", "refactor", "test", "chore", "style", "perf", "ci", "build", "revert"];
         };
         readonly scope: {
             readonly type: "string";
@@ -49,8 +54,101 @@ export declare const CommitMessageSchema: {
             readonly type: "string";
             readonly description: "Emoji 前缀（如果使用 conventional+emoji 风格）";
         };
+        readonly guidance: {
+            readonly type: "string";
+            readonly description: "当 status=needs_changes 时，提示需要补充的信息";
+        };
+        readonly nextAction: {
+            readonly type: "string";
+            readonly description: "下一步建议动作";
+        };
     };
-    readonly required: readonly ["type", "subject", "fullMessage"];
+    readonly required: readonly ["status"];
+};
+/**
+ * Commit Guidance Schema
+ * 用于 gencommit 工具的结构化输出
+ */
+export declare const CommitGuidanceSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly mode: {
+            readonly type: "string";
+            readonly enum: readonly ["guidance"];
+            readonly description: "gencommit 当前只返回指导文档，不直接生成最终提交消息";
+        };
+        readonly status: {
+            readonly type: "string";
+            readonly enum: readonly ["ready", "needs_changes"];
+            readonly description: "ready 表示可直接按规则生成；needs_changes 表示还缺变更信息";
+        };
+        readonly hasChanges: {
+            readonly type: "boolean";
+            readonly description: "是否已拿到变更内容";
+        };
+        readonly inputSummary: {
+            readonly type: "string";
+            readonly description: "对输入变更的简要摘要";
+        };
+        readonly steps: {
+            readonly type: "array";
+            readonly description: "AI 接下来要执行的步骤";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly rules: {
+            readonly type: "array";
+            readonly description: "生成 commit message 时必须遵守的规则";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly allowedTypes: {
+            readonly type: "array";
+            readonly description: "允许使用的 type 及对应 emoji";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly type: {
+                        readonly type: "string";
+                    };
+                    readonly emoji: {
+                        readonly type: "string";
+                    };
+                    readonly when: {
+                        readonly type: "string";
+                    };
+                };
+                readonly required: readonly ["type", "emoji", "when"];
+            };
+        };
+        readonly outputTemplate: {
+            readonly type: "string";
+            readonly description: "最终 commit message 的模板";
+        };
+        readonly examples: {
+            readonly type: "array";
+            readonly description: "参考示例";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly type: {
+                        readonly type: "string";
+                    };
+                    readonly fullMessage: {
+                        readonly type: "string";
+                    };
+                };
+                readonly required: readonly ["type", "fullMessage"];
+            };
+        };
+        readonly nextAction: {
+            readonly type: "string";
+            readonly description: "AI 下一步该做什么";
+        };
+    };
+    readonly required: readonly ["mode", "status", "hasChanges", "steps", "rules", "allowedTypes", "outputTemplate", "examples", "nextAction"];
 };
 /**
  * Workflow Report Schema
@@ -217,6 +315,11 @@ export declare const BugFixReportSchema: {
         readonly $ref: "#/definitions/WorkflowReport";
     }];
     readonly properties: {
+        readonly analysisMode: {
+            readonly type: "string";
+            readonly enum: readonly ["tbp8"];
+            readonly description: "分析方法";
+        };
         readonly rootCause: {
             readonly type: "string";
             readonly description: "根本原因分析";
@@ -240,8 +343,109 @@ export declare const BugFixReportSchema: {
                 readonly type: "string";
             };
         };
+        readonly tbp: {
+            readonly description: "TBP 8 步法分析骨架";
+            readonly type: "object";
+            readonly properties: {
+                readonly phenomenon: {
+                    readonly type: "string";
+                    readonly description: "TBP-1 现象";
+                };
+                readonly timeline: {
+                    readonly type: "array";
+                    readonly description: "TBP-2 时间线";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly order: {
+                                readonly type: "number";
+                                readonly description: "时间线顺序";
+                            };
+                            readonly event: {
+                                readonly type: "string";
+                                readonly description: "事件描述";
+                            };
+                            readonly evidence: {
+                                readonly type: "string";
+                                readonly description: "对应证据";
+                            };
+                        };
+                        readonly required: readonly ["order", "event"];
+                    };
+                };
+                readonly ruledOut: {
+                    readonly type: "array";
+                    readonly description: "TBP-3 已排除方向";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly commonPattern: {
+                    readonly type: "string";
+                    readonly description: "TBP-4 共同模式";
+                };
+                readonly boundary: {
+                    readonly type: "string";
+                    readonly description: "TBP-5 问题边界";
+                };
+                readonly rootCauseStatement: {
+                    readonly type: "string";
+                    readonly description: "TBP-6 真因因果句";
+                };
+                readonly evidence: {
+                    readonly type: "array";
+                    readonly description: "TBP-7 证据链";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly type: {
+                                readonly type: "string";
+                                readonly enum: readonly ["symptom", "timeline", "stack", "code", "comparison", "environment", "graph"];
+                                readonly description: "证据类型";
+                            };
+                            readonly detail: {
+                                readonly type: "string";
+                                readonly description: "证据内容";
+                            };
+                            readonly source: {
+                                readonly type: "string";
+                                readonly description: "证据来源";
+                            };
+                        };
+                        readonly required: readonly ["type", "detail"];
+                    };
+                };
+                readonly repair: {
+                    readonly type: "array";
+                    readonly description: "TBP-8 修复设计";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly layer: {
+                                readonly type: "string";
+                                readonly description: "修复层";
+                            };
+                            readonly action: {
+                                readonly type: "string";
+                                readonly description: "修复动作";
+                            };
+                            readonly risk: {
+                                readonly type: "string";
+                                readonly description: "潜在风险";
+                            };
+                            readonly verification: {
+                                readonly type: "string";
+                                readonly description: "验证方法";
+                            };
+                        };
+                        readonly required: readonly ["layer", "action", "verification"];
+                    };
+                };
+            };
+            readonly required: readonly ["phenomenon", "timeline", "ruledOut", "commonPattern", "boundary", "rootCauseStatement", "evidence", "repair"];
+        };
     };
-    readonly required: readonly ["rootCause", "fixPlan", "testPlan"];
+    readonly required: readonly ["analysisMode", "rootCause", "fixPlan", "testPlan", "tbp"];
 };
 /**
  * Feature Development Report Schema
@@ -746,6 +950,25 @@ export interface CommitMessage {
     fullMessage: string;
     emoji?: string;
 }
+export interface CommitGuidance {
+    mode: 'guidance';
+    status: 'ready' | 'needs_changes';
+    hasChanges: boolean;
+    inputSummary?: string;
+    steps: string[];
+    rules: string[];
+    allowedTypes: Array<{
+        type: string;
+        emoji: string;
+        when: string;
+    }>;
+    outputTemplate: string;
+    examples: Array<{
+        type: string;
+        fullMessage: string;
+    }>;
+    nextAction: string;
+}
 export interface WorkflowStep {
     name: string;
     status: 'completed' | 'skipped' | 'failed' | 'pending';
@@ -782,11 +1005,35 @@ export interface ExecutionPlan {
     steps: PlanStep[];
 }
 export interface BugFixReport extends WorkflowReport {
+    analysisMode: 'tbp8';
     rootCause: string;
     fixPlan: string;
     testPlan: string;
     commitDraft?: CommitMessage;
     affectedFiles?: string[];
+    tbp: {
+        phenomenon: string;
+        timeline: Array<{
+            order: number;
+            event: string;
+            evidence?: string;
+        }>;
+        ruledOut: string[];
+        commonPattern: string;
+        boundary: string;
+        rootCauseStatement: string;
+        evidence: Array<{
+            type: 'symptom' | 'timeline' | 'stack' | 'code' | 'comparison' | 'environment' | 'graph';
+            detail: string;
+            source?: string;
+        }>;
+        repair: Array<{
+            layer: string;
+            action: string;
+            risk?: string;
+            verification: string;
+        }>;
+    };
 }
 export interface FeatureReport extends WorkflowReport {
     specArtifacts: Array<{
@@ -1022,6 +1269,11 @@ export declare const BugAnalysisSchema: {
             readonly enum: readonly ["critical", "high", "medium", "low"];
             readonly description: "严重程度";
         };
+        readonly analysisMode: {
+            readonly type: "string";
+            readonly enum: readonly ["tbp8"];
+            readonly description: "分析方法";
+        };
         readonly rootCause: {
             readonly type: "string";
             readonly description: "根本原因";
@@ -1093,8 +1345,109 @@ export declare const BugAnalysisSchema: {
                 readonly type: "string";
             };
         };
+        readonly tbp: {
+            readonly description: "TBP 8 步法分析结果";
+            readonly type: "object";
+            readonly properties: {
+                readonly phenomenon: {
+                    readonly type: "string";
+                    readonly description: "TBP-1 现象";
+                };
+                readonly timeline: {
+                    readonly type: "array";
+                    readonly description: "TBP-2 时间线";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly order: {
+                                readonly type: "number";
+                                readonly description: "时间线顺序";
+                            };
+                            readonly event: {
+                                readonly type: "string";
+                                readonly description: "事件描述";
+                            };
+                            readonly evidence: {
+                                readonly type: "string";
+                                readonly description: "对应证据";
+                            };
+                        };
+                        readonly required: readonly ["order", "event"];
+                    };
+                };
+                readonly ruledOut: {
+                    readonly type: "array";
+                    readonly description: "TBP-3 已排除方向";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly commonPattern: {
+                    readonly type: "string";
+                    readonly description: "TBP-4 共同模式";
+                };
+                readonly boundary: {
+                    readonly type: "string";
+                    readonly description: "TBP-5 问题边界";
+                };
+                readonly rootCauseStatement: {
+                    readonly type: "string";
+                    readonly description: "TBP-6 真因因果句";
+                };
+                readonly evidence: {
+                    readonly type: "array";
+                    readonly description: "TBP-7 证据链";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly type: {
+                                readonly type: "string";
+                                readonly enum: readonly ["symptom", "timeline", "stack", "code", "comparison", "environment", "graph"];
+                                readonly description: "证据类型";
+                            };
+                            readonly detail: {
+                                readonly type: "string";
+                                readonly description: "证据内容";
+                            };
+                            readonly source: {
+                                readonly type: "string";
+                                readonly description: "证据来源";
+                            };
+                        };
+                        readonly required: readonly ["type", "detail"];
+                    };
+                };
+                readonly repair: {
+                    readonly type: "array";
+                    readonly description: "TBP-8 修复设计";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly layer: {
+                                readonly type: "string";
+                                readonly description: "修复层";
+                            };
+                            readonly action: {
+                                readonly type: "string";
+                                readonly description: "修复动作";
+                            };
+                            readonly risk: {
+                                readonly type: "string";
+                                readonly description: "潜在风险";
+                            };
+                            readonly verification: {
+                                readonly type: "string";
+                                readonly description: "验证方法";
+                            };
+                        };
+                        readonly required: readonly ["layer", "action", "verification"];
+                    };
+                };
+            };
+            readonly required: readonly ["phenomenon", "timeline", "ruledOut", "commonPattern", "boundary", "rootCauseStatement", "evidence", "repair"];
+        };
     };
-    readonly required: readonly ["summary", "bugType", "severity", "rootCause", "fixPlan", "testPlan"];
+    readonly required: readonly ["summary", "bugType", "severity", "analysisMode", "rootCause", "fixPlan", "testPlan", "tbp"];
 };
 /**
  * Test Suite Schema

package/build/schemas/structured-output.js

@@ -15,15 +15,20 @@
  */
 /**
  * Commit Message Schema
- * 用于 gencommit 工具的结构化输出
+ * 用于提交草稿（保留给其他场景复用）
  */
 export const CommitMessageSchema = {
     type: 'object',
     properties: {
+        status: {
+            type: 'string',
+            description: '生成状态：ready 表示已生成提交草稿；needs_changes 表示需要补充变更内容',
+            enum: ['ready', 'needs_changes'],
+        },
         type: {
             type: 'string',
             description: 'Commit 类型：feat/fix/docs/refactor/test/chore/style/perf',
-            enum: ['feat', 'fix', 'docs', 'refactor', 'test', 'chore', 'style', 'perf', 'ci', 'build', 'revert'],
+            enum: ['feat', 'fix', 'fixed', 'docs', 'refactor', 'test', 'chore', 'style', 'perf', 'ci', 'build', 'revert'],
         },
         scope: {
             type: 'string',
@@ -49,8 +54,87 @@ export const CommitMessageSchema = {
             type: 'string',
             description: 'Emoji 前缀（如果使用 conventional+emoji 风格）',
         },
+        guidance: {
+            type: 'string',
+            description: '当 status=needs_changes 时，提示需要补充的信息',
+        },
+        nextAction: {
+            type: 'string',
+            description: '下一步建议动作',
+        },
     },
-    required: ['type', 'subject', 'fullMessage'],
+    required: ['status'],
+};
+/**
+ * Commit Guidance Schema
+ * 用于 gencommit 工具的结构化输出
+ */
+export const CommitGuidanceSchema = {
+    type: 'object',
+    properties: {
+        mode: {
+            type: 'string',
+            enum: ['guidance'],
+            description: 'gencommit 当前只返回指导文档，不直接生成最终提交消息',
+        },
+        status: {
+            type: 'string',
+            enum: ['ready', 'needs_changes'],
+            description: 'ready 表示可直接按规则生成；needs_changes 表示还缺变更信息',
+        },
+        hasChanges: {
+            type: 'boolean',
+            description: '是否已拿到变更内容',
+        },
+        inputSummary: {
+            type: 'string',
+            description: '对输入变更的简要摘要',
+        },
+        steps: {
+            type: 'array',
+            description: 'AI 接下来要执行的步骤',
+            items: { type: 'string' },
+        },
+        rules: {
+            type: 'array',
+            description: '生成 commit message 时必须遵守的规则',
+            items: { type: 'string' },
+        },
+        allowedTypes: {
+            type: 'array',
+            description: '允许使用的 type 及对应 emoji',
+            items: {
+                type: 'object',
+                properties: {
+                    type: { type: 'string' },
+                    emoji: { type: 'string' },
+                    when: { type: 'string' },
+                },
+                required: ['type', 'emoji', 'when'],
+            },
+        },
+        outputTemplate: {
+            type: 'string',
+            description: '最终 commit message 的模板',
+        },
+        examples: {
+            type: 'array',
+            description: '参考示例',
+            items: {
+                type: 'object',
+                properties: {
+                    type: { type: 'string' },
+                    fullMessage: { type: 'string' },
+                },
+                required: ['type', 'fullMessage'],
+            },
+        },
+        nextAction: {
+            type: 'string',
+            description: 'AI 下一步该做什么',
+        },
+    },
+    required: ['mode', 'status', 'hasChanges', 'steps', 'rules', 'allowedTypes', 'outputTemplate', 'examples', 'nextAction'],
 };
 /**
  * Workflow Report Schema
@@ -185,6 +269,68 @@ export const ExecutionPlanSchema = {
     },
     required: ['mode', 'steps'],
 };
+const TbpTimelineEventSchema = {
+    type: 'object',
+    properties: {
+        order: { type: 'number', description: '时间线顺序' },
+        event: { type: 'string', description: '事件描述' },
+        evidence: { type: 'string', description: '对应证据' },
+    },
+    required: ['order', 'event'],
+};
+const TbpEvidenceItemSchema = {
+    type: 'object',
+    properties: {
+        type: {
+            type: 'string',
+            enum: ['symptom', 'timeline', 'stack', 'code', 'comparison', 'environment', 'graph'],
+            description: '证据类型',
+        },
+        detail: { type: 'string', description: '证据内容' },
+        source: { type: 'string', description: '证据来源' },
+    },
+    required: ['type', 'detail'],
+};
+const TbpRepairItemSchema = {
+    type: 'object',
+    properties: {
+        layer: { type: 'string', description: '修复层' },
+        action: { type: 'string', description: '修复动作' },
+        risk: { type: 'string', description: '潜在风险' },
+        verification: { type: 'string', description: '验证方法' },
+    },
+    required: ['layer', 'action', 'verification'],
+};
+const TbpAnalysisSchema = {
+    type: 'object',
+    properties: {
+        phenomenon: { type: 'string', description: 'TBP-1 现象' },
+        timeline: {
+            type: 'array',
+            description: 'TBP-2 时间线',
+            items: TbpTimelineEventSchema,
+        },
+        ruledOut: {
+            type: 'array',
+            description: 'TBP-3 已排除方向',
+            items: { type: 'string' },
+        },
+        commonPattern: { type: 'string', description: 'TBP-4 共同模式' },
+        boundary: { type: 'string', description: 'TBP-5 问题边界' },
+        rootCauseStatement: { type: 'string', description: 'TBP-6 真因因果句' },
+        evidence: {
+            type: 'array',
+            description: 'TBP-7 证据链',
+            items: TbpEvidenceItemSchema,
+        },
+        repair: {
+            type: 'array',
+            description: 'TBP-8 修复设计',
+            items: TbpRepairItemSchema,
+        },
+    },
+    required: ['phenomenon', 'timeline', 'ruledOut', 'commonPattern', 'boundary', 'rootCauseStatement', 'evidence', 'repair'],
+};
 /**
  * Bug Fix Report Schema
  * 用于 start_bugfix 的特定字段
@@ -195,6 +341,11 @@ export const BugFixReportSchema = {
         { $ref: '#/definitions/WorkflowReport' },
     ],
     properties: {
+        analysisMode: {
+            type: 'string',
+            enum: ['tbp8'],
+            description: '分析方法',
+        },
         rootCause: {
             type: 'string',
             description: '根本原因分析',
@@ -218,8 +369,12 @@ export const BugFixReportSchema = {
                 type: 'string',
             },
         },
+        tbp: {
+            ...TbpAnalysisSchema,
+            description: 'TBP 8 步法分析骨架',
+        },
     },
-    required: ['rootCause', 'fixPlan', 'testPlan'],
+    required: ['analysisMode', 'rootCause', 'fixPlan', 'testPlan', 'tbp'],
 };
 /**
  * Feature Development Report Schema
@@ -763,6 +918,11 @@ export const BugAnalysisSchema = {
             enum: ['critical', 'high', 'medium', 'low'],
             description: '严重程度',
         },
+        analysisMode: {
+            type: 'string',
+            enum: ['tbp8'],
+            description: '分析方法',
+        },
         rootCause: {
             type: 'string',
             description: '根本原因',
@@ -816,8 +976,12 @@ export const BugAnalysisSchema = {
             description: '预防措施',
             items: { type: 'string' },
         },
+        tbp: {
+            ...TbpAnalysisSchema,
+            description: 'TBP 8 步法分析结果',
+        },
     },
-    required: ['summary', 'bugType', 'severity', 'rootCause', 'fixPlan', 'testPlan'],
+    required: ['summary', 'bugType', 'severity', 'analysisMode', 'rootCause', 'fixPlan', 'testPlan', 'tbp'],
 };
 /**
  * Test Suite Schema