mcp-probe-kit 2.3.0 → 2.5.0

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

@@ -3,15 +3,15 @@
  * 用于 MCP 2025-11-25 协议的 structuredContent
  *
  * 注意：其他工具的 Schema 已按功能分类到 src/schemas/output/ 目录：
- * - core-tools.ts: 核心开发工具 (code_review, debug, fix_bug, gentest, refactor, security_scan, perf)
+ * - core-tools.ts: 核心开发工具 (code_review, fix_bug, gentest, refactor, security_scan, perf)
  * - generation-tools.ts: 代码生成工具 (gendoc, genapi, gensql, genreadme, genui, gen_mock, etc.)
  * - workflow-tools.ts: 工作流编排工具 (start_review, start_release, start_refactor, start_api, start_doc)
- * - project-tools.ts: 项目管理工具 (init_project, add_feature, analyze_project, estimate, etc.)
+ * - project-tools.ts: 项目管理工具 (init_project, add_feature, estimate, etc.)
  * - ui-ux-tools.ts: UI/UX 工具 (ui_design_system, ui_search, design2code, etc.)
  * - helper-tools.ts: 辅助工具 (detect_shell, init_setting, gen_skill)
  *
  * 使用方式：
- * import { CodeReviewReportSchema, DebugReportSchema } from '@/schemas/output';
+ * import { CodeReviewReportSchema } from '@/schemas/output';
  */
 /**
  * Commit Message Schema
@@ -144,6 +144,69 @@ export declare const WorkflowReportSchema: {
     };
     readonly required: readonly ["summary", "status", "steps"];
 };
+/**
+ * Execution Plan Schema
+ * 用于 start_* 编排工具的执行计划（metadata.plan）
+ */
+export declare const ExecutionPlanSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly mode: {
+            readonly type: "string";
+            readonly enum: readonly ["delegated"];
+            readonly description: "执行模式（delegated = AI 按步骤调用工具）";
+        };
+        readonly steps: {
+            readonly type: "array";
+            readonly description: "执行步骤";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly description: "步骤 ID";
+                    };
+                    readonly tool: {
+                        readonly type: "string";
+                        readonly description: "工具名称（无工具时可省略）";
+                    };
+                    readonly action: {
+                        readonly type: "string";
+                        readonly description: "手动操作描述（无工具时使用）";
+                    };
+                    readonly args: {
+                        readonly type: "object";
+                        readonly description: "工具参数";
+                    };
+                    readonly outputs: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "预期产物";
+                    };
+                    readonly when: {
+                        readonly type: "string";
+                        readonly description: "执行条件（可选）";
+                    };
+                    readonly dependsOn: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "依赖步骤";
+                    };
+                    readonly note: {
+                        readonly type: "string";
+                        readonly description: "补充说明";
+                    };
+                };
+                readonly required: readonly ["id"];
+            };
+        };
+    };
+    readonly required: readonly ["mode", "steps"];
+};
 /**
  * Bug Fix Report Schema
  * 用于 start_bugfix 的特定字段
@@ -489,6 +552,188 @@ export declare const RalphLoopReportSchema: {
     };
     readonly required: readonly ["loopPolicy", "iterations", "stopConditions"];
 };
+/**
+ * Requirements Loop Schema
+ * 用于需求澄清与补全的结构化输出
+ */
+export declare const RequirementsLoopSchema: {
+    readonly type: "object";
+    readonly properties: {
+        readonly mode: {
+            readonly type: "string";
+            readonly enum: readonly ["loop"];
+            readonly description: "需求循环模式标记";
+        };
+        readonly round: {
+            readonly type: "number";
+            readonly minimum: 1;
+            readonly description: "当前轮次";
+        };
+        readonly maxRounds: {
+            readonly type: "number";
+            readonly minimum: 1;
+            readonly description: "最大轮次";
+        };
+        readonly questionBudget: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly description: "本轮问题配额";
+        };
+        readonly assumptionCap: {
+            readonly type: "number";
+            readonly minimum: 0;
+            readonly description: "本轮假设上限";
+        };
+        readonly requirements: {
+            readonly type: "array";
+            readonly description: "需求条目列表";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly description: "需求 ID";
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                        readonly description: "需求标题";
+                    };
+                    readonly description: {
+                        readonly type: "string";
+                        readonly description: "需求描述";
+                    };
+                    readonly source: {
+                        readonly type: "string";
+                        readonly enum: readonly ["User", "Derived", "Assumption"];
+                        readonly description: "来源标记";
+                    };
+                    readonly acceptance: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "验收标准（EARS）";
+                    };
+                };
+                readonly required: readonly ["id", "title", "description", "source", "acceptance"];
+            };
+        };
+        readonly openQuestions: {
+            readonly type: "array";
+            readonly description: "待确认问题";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly question: {
+                        readonly type: "string";
+                    };
+                    readonly context: {
+                        readonly type: "string";
+                    };
+                    readonly required: {
+                        readonly type: "boolean";
+                    };
+                };
+                readonly required: readonly ["id", "question"];
+            };
+        };
+        readonly assumptions: {
+            readonly type: "array";
+            readonly description: "待确认假设";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                    };
+                    readonly statement: {
+                        readonly type: "string";
+                    };
+                    readonly risk: {
+                        readonly type: "string";
+                        readonly enum: readonly ["low", "medium", "high"];
+                    };
+                    readonly needsConfirmation: {
+                        readonly type: "boolean";
+                    };
+                };
+                readonly required: readonly ["id", "statement", "risk", "needsConfirmation"];
+            };
+        };
+        readonly delta: {
+            readonly type: "object";
+            readonly description: "本轮变更摘要";
+            readonly properties: {
+                readonly added: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly modified: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly removed: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            readonly required: readonly ["added", "modified", "removed"];
+        };
+        readonly validation: {
+            readonly type: "object";
+            readonly description: "结构化自检结果";
+            readonly properties: {
+                readonly passed: {
+                    readonly type: "boolean";
+                };
+                readonly missingFields: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+                readonly warnings: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            readonly required: readonly ["passed", "missingFields"];
+        };
+        readonly stopConditions: {
+            readonly type: "object";
+            readonly description: "结束条件状态";
+            readonly properties: {
+                readonly ready: {
+                    readonly type: "boolean";
+                };
+                readonly reasons: {
+                    readonly type: "array";
+                    readonly items: {
+                        readonly type: "string";
+                    };
+                };
+            };
+            readonly required: readonly ["ready", "reasons"];
+        };
+        readonly metadata: {
+            readonly type: "object";
+            readonly description: "额外元数据（如 delegated plan）";
+            readonly additionalProperties: true;
+        };
+    };
+    readonly required: readonly ["mode", "round", "maxRounds", "requirements", "openQuestions", "assumptions", "delta", "validation", "stopConditions"];
+};
 /**
  * TypeScript 类型定义
  */
@@ -522,6 +767,20 @@ export interface WorkflowReport {
     warnings?: string[];
     metadata?: Record<string, any>;
 }
+export interface PlanStep {
+    id: string;
+    tool?: string;
+    action?: string;
+    args?: Record<string, any>;
+    outputs?: string[];
+    when?: string;
+    dependsOn?: string[];
+    note?: string;
+}
+export interface ExecutionPlan {
+    mode: 'delegated';
+    steps: PlanStep[];
+}
 export interface BugFixReport extends WorkflowReport {
     rootCause: string;
     fixPlan: string;
@@ -603,6 +862,53 @@ export interface RalphLoopReport extends WorkflowReport {
         message?: string;
     }>;
 }
+export interface RequirementItem {
+    id: string;
+    title: string;
+    description: string;
+    source: 'User' | 'Derived' | 'Assumption';
+    acceptance: string[];
+}
+export interface OpenQuestion {
+    id: string;
+    question: string;
+    context?: string;
+    required?: boolean;
+}
+export interface RequirementAssumption {
+    id: string;
+    statement: string;
+    risk: 'low' | 'medium' | 'high';
+    needsConfirmation: boolean;
+}
+export interface RequirementsDelta {
+    added: string[];
+    modified: string[];
+    removed: string[];
+}
+export interface RequirementsValidation {
+    passed: boolean;
+    missingFields: string[];
+    warnings?: string[];
+}
+export interface RequirementsStopConditions {
+    ready: boolean;
+    reasons: string[];
+}
+export interface RequirementsLoopReport {
+    mode: 'loop';
+    round: number;
+    maxRounds: number;
+    questionBudget?: number;
+    assumptionCap?: number;
+    requirements: RequirementItem[];
+    openQuestions: OpenQuestion[];
+    assumptions: RequirementAssumption[];
+    delta: RequirementsDelta;
+    validation: RequirementsValidation;
+    stopConditions: RequirementsStopConditions;
+    metadata?: Record<string, any>;
+}
 /**
  * Code Review Report Schema
  * 用于 code_review 工具的结构化输出
@@ -695,102 +1001,6 @@ export declare const CodeReviewReportSchema: {
     };
     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 description: "错误位置";
-            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 description: "堆栈跟踪";
-            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 description: "调试策略";
-            readonly items: {
-                readonly type: "string";
-            };
-        };
-        readonly solutions: {
-            readonly type: "array";
-            readonly description: "解决方案列表";
-            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 description: "相关问题";
-            readonly items: {
-                readonly type: "string";
-            };
-        };
-    };
-    readonly required: readonly ["summary", "rootCause", "errorType", "solutions"];
-};
 /**
  * Bug Analysis Schema
  * 用于 fix_bug 工具的结构化输出