mcp-probe-kit 3.6.9 → 3.6.11

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

@@ -91,9 +91,109 @@ export declare const CodeReviewReportSchema: {
     };
     readonly required: readonly ["summary", "overallScore", "issues"];
 };
+/** SRC-8 Step 4 真因工作表 — Agent 必须产出 */
+export declare const RootCauseAnalysisSchema: {
+    readonly type: "object";
+    readonly description: "SRC-8 Step 4 把握真因：假设清单、排除矩阵、对比分叉、5 Why、因果陈述";
+    readonly properties: {
+        readonly mode: {
+            readonly type: "string";
+            readonly enum: readonly ["simple", "complex"];
+        };
+        readonly attributionLayer: {
+            readonly type: "string";
+            readonly enum: readonly ["code", "runtime", "data_contract", "integration", "agent_behavior", "environment"];
+        };
+        readonly hypotheses: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly statement: {
+                        readonly type: "string";
+                    };
+                    readonly attributionLayer: {
+                        readonly type: "string";
+                        readonly enum: readonly ["code", "runtime", "data_contract", "integration", "agent_behavior", "environment"];
+                    };
+                    readonly status: {
+                        readonly type: "string";
+                        readonly enum: readonly ["ruled_out", "pending", "confirmed"];
+                    };
+                    readonly evidence: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly counterEvidence: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                };
+                readonly required: readonly ["id", "statement", "status"];
+            };
+        };
+        readonly forkPoint: {
+            readonly type: "string";
+            readonly description: "成功/失败分叉点";
+        };
+        readonly whyChain: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly level: {
+                        readonly type: "number";
+                    };
+                    readonly observation: {
+                        readonly type: "string";
+                        readonly description: "观察到的事实";
+                    };
+                    readonly why: {
+                        readonly type: "string";
+                    };
+                    readonly because: {
+                        readonly type: "string";
+                    };
+                };
+                readonly required: readonly ["level", "observation", "why", "because"];
+            };
+        };
+        readonly primaryCause: {
+            readonly type: "string";
+        };
+        readonly contributingFactors: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly rootCauseStatement: {
+            readonly type: "string";
+            readonly description: "因果句：A + B 在 D 下导致 C";
+        };
+        readonly confidence: {
+            readonly type: "string";
+            readonly enum: readonly ["high", "medium", "low"];
+        };
+        readonly evidenceGaps: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+    };
+    readonly required: readonly ["mode", "hypotheses", "whyChain", "rootCauseStatement", "confidence"];
+};
 /**
  * Bug Analysis Schema
- * 用于 fix_bug 工具的结构化输出
+ * 用于 fix_bug 工具的结构化输出（SRC-8，TBP-inspired）
  */
 export declare const BugAnalysisSchema: {
     readonly type: "object";
@@ -112,10 +212,111 @@ export declare const BugAnalysisSchema: {
         };
         readonly analysisMode: {
             readonly type: "string";
-            readonly enum: readonly ["tbp8"];
+            readonly enum: readonly ["src8", "tbp8"];
+            readonly description: "分析方法：src8（推荐）；tbp8 为兼容别名";
         };
         readonly rootCause: {
             readonly type: "string";
+            readonly description: "SRC-4 真因摘要";
+        };
+        readonly rootCauseAnalysis: {
+            readonly type: "object";
+            readonly description: "SRC-8 Step 4 把握真因：假设清单、排除矩阵、对比分叉、5 Why、因果陈述";
+            readonly properties: {
+                readonly mode: {
+                    readonly type: "string";
+                    readonly enum: readonly ["simple", "complex"];
+                };
+                readonly attributionLayer: {
+                    readonly type: "string";
+                    readonly enum: readonly ["code", "runtime", "data_contract", "integration", "agent_behavior", "environment"];
+                };
+                readonly hypotheses: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly id: {
+                                readonly type: "string";
+                            };
+                            readonly statement: {
+                                readonly type: "string";
+                            };
+                            readonly attributionLayer: {
+                                readonly type: "string";
+                                readonly enum: readonly ["code", "runtime", "data_contract", "integration", "agent_behavior", "environment"];
+                            };
+                            readonly status: {
+                                readonly type: "string";
+                                readonly enum: readonly ["ruled_out", "pending", "confirmed"];
+                            };
+                            readonly evidence: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                            };
+                            readonly counterEvidence: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly type: "string";
+                                };
+                            };
+                        };
+                        readonly required: readonly ["id", "statement", "status"];
+                    };
+                };
+                readonly forkPoint: {
+                    readonly type: "string";
+                    readonly description: "成功/失败分叉点";
+                };
+                readonly whyChain: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "object";
+                        readonly properties: {
+                            readonly level: {
+                                readonly type: "number";
+                            };
+                            readonly observation: {
+                                readonly type: "string";
+                                readonly description: "观察到的事实";
+                            };
+                            readonly why: {
+                                readonly type: "string";
+                            };
+                            readonly because: {
+                                readonly type: "string";
+                            };
+                        };
+                        readonly required: readonly ["level", "observation", "why", "because"];
+                    };
+                };
+                readonly primaryCause: {
+                    readonly type: "string";
+                };
+                readonly contributingFactors: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly rootCauseStatement: {
+                    readonly type: "string";
+                    readonly description: "因果句：A + B 在 D 下导致 C";
+                };
+                readonly confidence: {
+                    readonly type: "string";
+                    readonly enum: readonly ["high", "medium", "low"];
+                };
+                readonly evidenceGaps: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            readonly required: readonly ["mode", "hypotheses", "whyChain", "rootCauseStatement", "confidence"];
         };
         readonly affectedComponents: {
             readonly type: "array";
@@ -180,16 +381,16 @@ export declare const BugAnalysisSchema: {
             };
         };
         readonly tbp: {
-            readonly description: "TBP 8 步法分析结果";
+            readonly description: "SRC-8 各步产出（字段名 tbp 为历史兼容）";
             readonly type: "object";
             readonly properties: {
                 readonly phenomenon: {
                     readonly type: "string";
-                    readonly description: "TBP-1 现象";
+                    readonly description: "SRC-1 明确差距";
                 };
                 readonly timeline: {
                     readonly type: "array";
-                    readonly description: "TBP-2 时间线";
+                    readonly description: "SRC-2 时间线/分解";
                     readonly items: {
                         readonly type: "object";
                         readonly properties: {
@@ -211,26 +412,26 @@ export declare const BugAnalysisSchema: {
                 };
                 readonly ruledOut: {
                     readonly type: "array";
-                    readonly description: "TBP-3 已排除方向";
+                    readonly description: "SRC-4 已排除假设";
                     readonly items: {
                         readonly type: "string";
                     };
                 };
                 readonly commonPattern: {
                     readonly type: "string";
-                    readonly description: "TBP-4 共同模式";
+                    readonly description: "SRC-4 对比分叉";
                 };
                 readonly boundary: {
                     readonly type: "string";
-                    readonly description: "TBP-5 问题边界";
+                    readonly description: "SRC-2 问题边界/归因层";
                 };
                 readonly rootCauseStatement: {
                     readonly type: "string";
-                    readonly description: "TBP-6 真因因果句";
+                    readonly description: "SRC-4 真因因果句";
                 };
                 readonly evidence: {
                     readonly type: "array";
-                    readonly description: "TBP-7 证据链";
+                    readonly description: "SRC-4 证据链";
                     readonly items: {
                         readonly type: "object";
                         readonly properties: {
@@ -253,7 +454,7 @@ export declare const BugAnalysisSchema: {
                 };
                 readonly repair: {
                     readonly type: "array";
-                    readonly description: "TBP-8 修复设计";
+                    readonly description: "SRC-5 对策设计";
                     readonly items: {
                         readonly type: "object";
                         readonly properties: {
@@ -281,7 +482,7 @@ export declare const BugAnalysisSchema: {
             readonly required: readonly ["phenomenon", "timeline", "ruledOut", "commonPattern", "boundary", "rootCauseStatement", "evidence", "repair"];
         };
     };
-    readonly required: readonly ["summary", "bugType", "severity", "analysisMode", "rootCause", "fixPlan", "testPlan", "tbp"];
+    readonly required: readonly ["summary", "bugType", "severity", "analysisMode", "rootCause", "rootCauseAnalysis", "fixPlan", "testPlan", "tbp"];
 };
 /**
  * Test Suite Schema
@@ -685,8 +886,32 @@ export interface BugAnalysis {
     summary: string;
     bugType: 'functional' | 'performance' | 'security' | 'ui' | 'data' | 'integration';
     severity: 'critical' | 'high' | 'medium' | 'low';
-    analysisMode: 'tbp8';
+    analysisMode: 'src8' | 'tbp8';
     rootCause: string;
+    rootCauseAnalysis: {
+        mode: 'simple' | 'complex';
+        attributionLayer?: 'code' | 'runtime' | 'data_contract' | 'integration' | 'agent_behavior' | 'environment';
+        hypotheses: Array<{
+            id: string;
+            statement: string;
+            attributionLayer?: 'code' | 'runtime' | 'data_contract' | 'integration' | 'agent_behavior' | 'environment';
+            status: 'ruled_out' | 'pending' | 'confirmed';
+            evidence?: string[];
+            counterEvidence?: string[];
+        }>;
+        forkPoint?: string;
+        whyChain: Array<{
+            level: number;
+            observation: string;
+            why: string;
+            because: string;
+        }>;
+        primaryCause?: string;
+        contributingFactors?: string[];
+        rootCauseStatement: string;
+        confidence: 'high' | 'medium' | 'low';
+        evidenceGaps?: string[];
+    };
     affectedComponents?: string[];
     affectedFiles?: string[];
     fixPlan: {

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

@@ -98,31 +98,77 @@ const TbpRepairItemSchema = {
     },
     required: ['layer', 'action', 'verification'],
 };
+const RootCauseHypothesisSchema = {
+    type: 'object',
+    properties: {
+        id: { type: 'string' },
+        statement: { type: 'string' },
+        attributionLayer: {
+            type: 'string',
+            enum: ['code', 'runtime', 'data_contract', 'integration', 'agent_behavior', 'environment'],
+        },
+        status: { type: 'string', enum: ['ruled_out', 'pending', 'confirmed'] },
+        evidence: { type: 'array', items: { type: 'string' } },
+        counterEvidence: { type: 'array', items: { type: 'string' } },
+    },
+    required: ['id', 'statement', 'status'],
+};
+const WhyChainItemSchema = {
+    type: 'object',
+    properties: {
+        level: { type: 'number' },
+        observation: { type: 'string', description: '观察到的事实' },
+        why: { type: 'string' },
+        because: { type: 'string' },
+    },
+    required: ['level', 'observation', 'why', 'because'],
+};
+/** SRC-8 Step 4 真因工作表 — Agent 必须产出 */
+export const RootCauseAnalysisSchema = {
+    type: 'object',
+    description: 'SRC-8 Step 4 把握真因：假设清单、排除矩阵、对比分叉、5 Why、因果陈述',
+    properties: {
+        mode: { type: 'string', enum: ['simple', 'complex'] },
+        attributionLayer: {
+            type: 'string',
+            enum: ['code', 'runtime', 'data_contract', 'integration', 'agent_behavior', 'environment'],
+        },
+        hypotheses: { type: 'array', items: RootCauseHypothesisSchema },
+        forkPoint: { type: 'string', description: '成功/失败分叉点' },
+        whyChain: { type: 'array', items: WhyChainItemSchema },
+        primaryCause: { type: 'string' },
+        contributingFactors: { type: 'array', items: { type: 'string' } },
+        rootCauseStatement: { type: 'string', description: '因果句：A + B 在 D 下导致 C' },
+        confidence: { type: 'string', enum: ['high', 'medium', 'low'] },
+        evidenceGaps: { type: 'array', items: { type: 'string' } },
+    },
+    required: ['mode', 'hypotheses', 'whyChain', 'rootCauseStatement', 'confidence'],
+};
 const TbpAnalysisSchema = {
     type: 'object',
     properties: {
-        phenomenon: { type: 'string', description: 'TBP-1 现象' },
+        phenomenon: { type: 'string', description: 'SRC-1 明确差距' },
         timeline: {
             type: 'array',
-            description: 'TBP-2 时间线',
+            description: 'SRC-2 时间线/分解',
             items: TbpTimelineEventSchema,
         },
         ruledOut: {
             type: 'array',
-            description: 'TBP-3 已排除方向',
+            description: 'SRC-4 已排除假设',
             items: { type: 'string' },
         },
-        commonPattern: { type: 'string', description: 'TBP-4 共同模式' },
-        boundary: { type: 'string', description: 'TBP-5 问题边界' },
-        rootCauseStatement: { type: 'string', description: 'TBP-6 真因因果句' },
+        commonPattern: { type: 'string', description: 'SRC-4 对比分叉' },
+        boundary: { type: 'string', description: 'SRC-2 问题边界/归因层' },
+        rootCauseStatement: { type: 'string', description: 'SRC-4 真因因果句' },
         evidence: {
             type: 'array',
-            description: 'TBP-7 证据链',
+            description: 'SRC-4 证据链',
             items: TbpEvidenceItemSchema,
         },
         repair: {
             type: 'array',
-            description: 'TBP-8 修复设计',
+            description: 'SRC-5 对策设计',
             items: TbpRepairItemSchema,
         },
     },
@@ -130,7 +176,7 @@ const TbpAnalysisSchema = {
 };
 /**
  * Bug Analysis Schema
- * 用于 fix_bug 工具的结构化输出
+ * 用于 fix_bug 工具的结构化输出（SRC-8，TBP-inspired）
  */
 export const BugAnalysisSchema = {
     type: 'object',
@@ -146,9 +192,13 @@ export const BugAnalysisSchema = {
         },
         analysisMode: {
             type: 'string',
-            enum: ['tbp8'],
+            enum: ['src8', 'tbp8'],
+            description: '分析方法：src8（推荐）；tbp8 为兼容别名',
+        },
+        rootCause: { type: 'string', description: 'SRC-4 真因摘要' },
+        rootCauseAnalysis: {
+            ...RootCauseAnalysisSchema,
         },
-        rootCause: { type: 'string' },
         affectedComponents: {
             type: 'array',
             items: { type: 'string' },
@@ -180,10 +230,10 @@ export const BugAnalysisSchema = {
         },
         tbp: {
             ...TbpAnalysisSchema,
-            description: 'TBP 8 步法分析结果',
+            description: 'SRC-8 各步产出（字段名 tbp 为历史兼容）',
         },
     },
-    required: ['summary', 'bugType', 'severity', 'analysisMode', 'rootCause', 'fixPlan', 'testPlan', 'tbp'],
+    required: ['summary', 'bugType', 'severity', 'analysisMode', 'rootCause', 'rootCauseAnalysis', 'fixPlan', 'testPlan', 'tbp'],
 };
 /**
  * Test Suite Schema

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

@@ -317,8 +317,8 @@ export declare const BugFixReportSchema: {
     readonly properties: {
         readonly analysisMode: {
             readonly type: "string";
-            readonly enum: readonly ["tbp8"];
-            readonly description: "分析方法";
+            readonly enum: readonly ["src8", "tbp8"];
+            readonly description: "分析方法（src8 推荐；tbp8 兼容）";
         };
         readonly rootCause: {
             readonly type: "string";
@@ -344,7 +344,7 @@ export declare const BugFixReportSchema: {
             };
         };
         readonly tbp: {
-            readonly description: "TBP 8 步法分析骨架";
+            readonly description: "SRC-8 分析骨架（字段名 tbp 为历史兼容）";
             readonly type: "object";
             readonly properties: {
                 readonly phenomenon: {
@@ -1005,7 +1005,7 @@ export interface ExecutionPlan {
     steps: PlanStep[];
 }
 export interface BugFixReport extends WorkflowReport {
-    analysisMode: 'tbp8';
+    analysisMode: 'src8' | 'tbp8';
     rootCause: string;
     fixPlan: string;
     testPlan: string;
@@ -1271,13 +1271,31 @@ export declare const BugAnalysisSchema: {
         };
         readonly analysisMode: {
             readonly type: "string";
-            readonly enum: readonly ["tbp8"];
-            readonly description: "分析方法";
+            readonly enum: readonly ["src8", "tbp8"];
+            readonly description: "分析方法（src8 推荐；tbp8 兼容）";
         };
         readonly rootCause: {
             readonly type: "string";
             readonly description: "根本原因";
         };
+        readonly rootCauseAnalysis: {
+            readonly type: "object";
+            readonly description: "SRC-8 Step 4 真因工作表产出";
+            readonly properties: {
+                readonly mode: {
+                    readonly type: "string";
+                    readonly enum: readonly ["simple", "complex"];
+                };
+                readonly rootCauseStatement: {
+                    readonly type: "string";
+                };
+                readonly confidence: {
+                    readonly type: "string";
+                    readonly enum: readonly ["high", "medium", "low"];
+                };
+            };
+            readonly required: readonly ["mode", "rootCauseStatement", "confidence"];
+        };
         readonly affectedComponents: {
             readonly type: "array";
             readonly description: "受影响的组件";
@@ -1346,7 +1364,7 @@ export declare const BugAnalysisSchema: {
             };
         };
         readonly tbp: {
-            readonly description: "TBP 8 步法分析结果";
+            readonly description: "SRC-8 各步产出（字段名 tbp 为历史兼容）";
             readonly type: "object";
             readonly properties: {
                 readonly phenomenon: {
@@ -1447,7 +1465,7 @@ export declare const BugAnalysisSchema: {
             readonly required: readonly ["phenomenon", "timeline", "ruledOut", "commonPattern", "boundary", "rootCauseStatement", "evidence", "repair"];
         };
     };
-    readonly required: readonly ["summary", "bugType", "severity", "analysisMode", "rootCause", "fixPlan", "testPlan", "tbp"];
+    readonly required: readonly ["summary", "bugType", "severity", "analysisMode", "rootCause", "rootCauseAnalysis", "fixPlan", "testPlan", "tbp"];
 };
 /**
  * Test Suite Schema

package/build/schemas/structured-output.js

@@ -343,8 +343,8 @@ export const BugFixReportSchema = {
     properties: {
         analysisMode: {
             type: 'string',
-            enum: ['tbp8'],
-            description: '分析方法',
+            enum: ['src8', 'tbp8'],
+            description: '分析方法（src8 推荐；tbp8 兼容）',
         },
         rootCause: {
             type: 'string',
@@ -371,7 +371,7 @@ export const BugFixReportSchema = {
         },
         tbp: {
             ...TbpAnalysisSchema,
-            description: 'TBP 8 步法分析骨架',
+            description: 'SRC-8 分析骨架（字段名 tbp 为历史兼容）',
         },
     },
     required: ['analysisMode', 'rootCause', 'fixPlan', 'testPlan', 'tbp'],
@@ -920,13 +920,23 @@ export const BugAnalysisSchema = {
         },
         analysisMode: {
             type: 'string',
-            enum: ['tbp8'],
-            description: '分析方法',
+            enum: ['src8', 'tbp8'],
+            description: '分析方法（src8 推荐；tbp8 兼容）',
         },
         rootCause: {
             type: 'string',
             description: '根本原因',
         },
+        rootCauseAnalysis: {
+            type: 'object',
+            description: 'SRC-8 Step 4 真因工作表产出',
+            properties: {
+                mode: { type: 'string', enum: ['simple', 'complex'] },
+                rootCauseStatement: { type: 'string' },
+                confidence: { type: 'string', enum: ['high', 'medium', 'low'] },
+            },
+            required: ['mode', 'rootCauseStatement', 'confidence'],
+        },
         affectedComponents: {
             type: 'array',
             description: '受影响的组件',
@@ -978,10 +988,10 @@ export const BugAnalysisSchema = {
         },
         tbp: {
             ...TbpAnalysisSchema,
-            description: 'TBP 8 步法分析结果',
+            description: 'SRC-8 各步产出（字段名 tbp 为历史兼容）',
         },
     },
-    required: ['summary', 'bugType', 'severity', 'analysisMode', 'rootCause', 'fixPlan', 'testPlan', 'tbp'],
+    required: ['summary', 'bugType', 'severity', 'analysisMode', 'rootCause', 'rootCauseAnalysis', 'fixPlan', 'testPlan', 'tbp'],
 };
 /**
  * Test Suite Schema

package/build/tools/__tests__/code_review.unit.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/tools/__tests__/code_review.unit.test.js

@@ -0,0 +1,43 @@
+import { describe, expect, test } from "vitest";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { codeReview } from "../code_review.js";
+describe("code_review 单元测试", () => {
+    test("传入 code 时注入待审内容，并标明由 Agent 生成 issues", async () => {
+        const sample = "const api_key = 'sk-live-abcdefgh';\n// TODO: fix\n";
+        const result = await codeReview({ code: sample, focus: "security" });
+        expect(result.isError).toBeFalsy();
+        const text = String(result.content[0].text);
+        expect(text).toContain("sk-live-abcdefgh");
+        expect(text).toContain("Agent 必须输出的 JSON");
+        expect(text).toMatch(/指南型|guidance/i);
+        expect(text).not.toMatch(/静态扫描结果/);
+        const meta = result._meta;
+        const structured = result.structuredContent;
+        expect(structured.mode).toBe("guidance");
+        expect(structured.reviewInput.received).toBe(true);
+        expect(structured.reviewInput.code).toContain("sk-live-abcdefgh");
+        expect(meta?.note).toMatch(/Agent/);
+    });
+    test("未传 code/file_path 时明确提示 Agent 需先获取代码", async () => {
+        const result = await codeReview({ focus: "quality" });
+        const text = String(result.content[0].text);
+        expect(text).toMatch(/未提供 code/);
+        expect(result.structuredContent.reviewInput.received).toBe(false);
+    });
+    test("file_path 可读时注入文件内容", async () => {
+        const dir = fs.mkdtempSync(path.join(os.tmpdir(), "code-review-"));
+        const filePath = path.join(dir, "sample.ts");
+        fs.writeFileSync(filePath, "eval(input);\n", "utf-8");
+        try {
+            const result = await codeReview({ file_path: filePath, project_root: dir });
+            const text = String(result.content[0].text);
+            expect(text).toContain("eval(input)");
+            expect(result.structuredContent.reviewInput.file).toBe(filePath);
+        }
+        finally {
+            fs.rmSync(dir, { recursive: true, force: true });
+        }
+    });
+});