@xopcai/xopc 0.0.87 → 0.0.89

package/dist/src/agent/workflow/agent-progress.js

@@ -0,0 +1,65 @@
+import { workflowStepLabel } from "./step-labels.js";
+//#region src/agent/workflow/agent-progress.ts
+const MAX_STEPS = 50;
+const MAX_STREAM_TEXT = 32e3;
+function applySubagentProgress(agent, event) {
+	switch (event.type) {
+		case "tool_start": {
+			if (!agent.steps) agent.steps = [];
+			const { label, detail } = workflowStepLabel(event.toolName, event.args);
+			const step = {
+				id: event.toolCallId,
+				kind: "tool",
+				toolName: event.toolName,
+				label,
+				detail,
+				status: "running",
+				startedAtMs: Date.now()
+			};
+			agent.steps.push(step);
+			trimSteps(agent);
+			agent.currentStep = formatCurrentStep(step);
+			return true;
+		}
+		case "tool_end": {
+			const step = findStep(agent, event.toolCallId);
+			if (!step) return false;
+			step.status = event.isError ? "error" : "done";
+			if (step.startedAtMs != null) step.durationMs = Date.now() - step.startedAtMs;
+			if (agent.currentStep === formatCurrentStep(step)) agent.currentStep = void 0;
+			return true;
+		}
+		case "iteration":
+			agent.iteration = event.count;
+			agent.maxIterations = event.max;
+			return true;
+		case "text_delta":
+			if (!event.delta) return false;
+			agent.streamText = appendStreamText(agent.streamText, event.delta);
+			return true;
+		case "thinking_delta":
+			if (!event.delta) return false;
+			agent.streamText = appendStreamText(agent.streamText, event.delta);
+			return true;
+		default: return false;
+	}
+}
+function findStep(agent, id) {
+	return agent.steps?.find((s) => s.id === id);
+}
+function formatCurrentStep(step) {
+	return step.detail ? `${step.label}: ${step.detail}` : step.label;
+}
+function trimSteps(agent) {
+	if (!agent.steps || agent.steps.length <= MAX_STEPS) return;
+	agent.steps = agent.steps.slice(-MAX_STEPS);
+}
+function appendStreamText(existing, delta) {
+	const next = (existing ?? "") + delta;
+	if (next.length <= MAX_STREAM_TEXT) return next;
+	return next.slice(-MAX_STREAM_TEXT);
+}
+//#endregion
+export { applySubagentProgress };
+
+//# sourceMappingURL=agent-progress.js.map

package/dist/src/agent/workflow/agent-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-progress.js","names":[],"sources":["../../../../src/agent/workflow/agent-progress.ts"],"sourcesContent":["/**\n * Apply live subagent progress events onto a {@link WorkflowAgentSnapshot}.\n */\n\nimport type {\n  SubagentProgressEvent,\n  WorkflowAgentSnapshot,\n  WorkflowAgentStep,\n} from './types.js';\nimport { workflowStepLabel } from './step-labels.js';\n\nconst MAX_STEPS = 50;\nconst MAX_STREAM_TEXT = 32_000;\n\nexport function applySubagentProgress(\n  agent: WorkflowAgentSnapshot,\n  event: SubagentProgressEvent,\n): boolean {\n  switch (event.type) {\n    case 'tool_start': {\n      if (!agent.steps) agent.steps = [];\n      const { label, detail } = workflowStepLabel(event.toolName, event.args);\n      const step: WorkflowAgentStep = {\n        id: event.toolCallId,\n        kind: 'tool',\n        toolName: event.toolName,\n        label,\n        detail,\n        status: 'running',\n        startedAtMs: Date.now(),\n      };\n      agent.steps.push(step);\n      trimSteps(agent);\n      agent.currentStep = formatCurrentStep(step);\n      return true;\n    }\n    case 'tool_end': {\n      const step = findStep(agent, event.toolCallId);\n      if (!step) return false;\n      step.status = event.isError ? 'error' : 'done';\n      if (step.startedAtMs != null) step.durationMs = Date.now() - step.startedAtMs;\n      if (agent.currentStep === formatCurrentStep(step)) {\n        agent.currentStep = undefined;\n      }\n      return true;\n    }\n    case 'iteration': {\n      agent.iteration = event.count;\n      agent.maxIterations = event.max;\n      return true;\n    }\n    case 'text_delta': {\n      if (!event.delta) return false;\n      agent.streamText = appendStreamText(agent.streamText, event.delta);\n      return true;\n    }\n    case 'thinking_delta': {\n      if (!event.delta) return false;\n      agent.streamText = appendStreamText(agent.streamText, event.delta);\n      return true;\n    }\n    default:\n      return false;\n  }\n}\n\nfunction findStep(agent: WorkflowAgentSnapshot, id: string): WorkflowAgentStep | undefined {\n  return agent.steps?.find((s) => s.id === id);\n}\n\nfunction formatCurrentStep(step: WorkflowAgentStep): string {\n  return step.detail ? `${step.label}: ${step.detail}` : step.label;\n}\n\nfunction trimSteps(agent: WorkflowAgentSnapshot): void {\n  if (!agent.steps || agent.steps.length <= MAX_STEPS) return;\n  agent.steps = agent.steps.slice(-MAX_STEPS);\n}\n\nfunction appendStreamText(existing: string | undefined, delta: string): string {\n  const next = (existing ?? '') + delta;\n  if (next.length <= MAX_STREAM_TEXT) return next;\n  return next.slice(-MAX_STREAM_TEXT);\n}\n"],"mappings":";;AAWA,MAAM,YAAY;AAClB,MAAM,kBAAkB;AAExB,SAAgB,sBACd,OACA,OACS;AACT,SAAQ,MAAM,MAAd;EACE,KAAK,cAAc;AACjB,OAAI,CAAC,MAAM,MAAO,OAAM,QAAQ,EAAE;GAClC,MAAM,EAAE,OAAO,WAAW,kBAAkB,MAAM,UAAU,MAAM,KAAK;GACvE,MAAM,OAA0B;IAC9B,IAAI,MAAM;IACV,MAAM;IACN,UAAU,MAAM;IAChB;IACA;IACA,QAAQ;IACR,aAAa,KAAK,KAAK;IACxB;AACD,SAAM,MAAM,KAAK,KAAK;AACtB,aAAU,MAAM;AAChB,SAAM,cAAc,kBAAkB,KAAK;AAC3C,UAAO;;EAET,KAAK,YAAY;GACf,MAAM,OAAO,SAAS,OAAO,MAAM,WAAW;AAC9C,OAAI,CAAC,KAAM,QAAO;AAClB,QAAK,SAAS,MAAM,UAAU,UAAU;AACxC,OAAI,KAAK,eAAe,KAAM,MAAK,aAAa,KAAK,KAAK,GAAG,KAAK;AAClE,OAAI,MAAM,gBAAgB,kBAAkB,KAAK,CAC/C,OAAM,cAAc,KAAA;AAEtB,UAAO;;EAET,KAAK;AACH,SAAM,YAAY,MAAM;AACxB,SAAM,gBAAgB,MAAM;AAC5B,UAAO;EAET,KAAK;AACH,OAAI,CAAC,MAAM,MAAO,QAAO;AACzB,SAAM,aAAa,iBAAiB,MAAM,YAAY,MAAM,MAAM;AAClE,UAAO;EAET,KAAK;AACH,OAAI,CAAC,MAAM,MAAO,QAAO;AACzB,SAAM,aAAa,iBAAiB,MAAM,YAAY,MAAM,MAAM;AAClE,UAAO;EAET,QACE,QAAO;;;AAIb,SAAS,SAAS,OAA8B,IAA2C;AACzF,QAAO,MAAM,OAAO,MAAM,MAAM,EAAE,OAAO,GAAG;;AAG9C,SAAS,kBAAkB,MAAiC;AAC1D,QAAO,KAAK,SAAS,GAAG,KAAK,MAAM,IAAI,KAAK,WAAW,KAAK;;AAG9D,SAAS,UAAU,OAAoC;AACrD,KAAI,CAAC,MAAM,SAAS,MAAM,MAAM,UAAU,UAAW;AACrD,OAAM,QAAQ,MAAM,MAAM,MAAM,CAAC,UAAU;;AAG7C,SAAS,iBAAiB,UAA8B,OAAuB;CAC7E,MAAM,QAAQ,YAAY,MAAM;AAChC,KAAI,KAAK,UAAU,gBAAiB,QAAO;AAC3C,QAAO,KAAK,MAAM,CAAC,gBAAgB"}

package/dist/src/agent/workflow/builtins/audit-repo.d.ts

@@ -10,4 +10,4 @@
  *   - scope: subdirectory to focus on (default '.')
  *   - dimensions: subset of dimension keys, e.g. ['security', 'bugs']
  */
-export declare const AUDIT_REPO_SCRIPT = "export const meta = {\n  name: 'audit_repo',\n  description: 'Fan-out repository audit across multiple dimensions, then synthesize a structured report.',\n  whenToUse: 'User asks for a thorough / multi-dimension code review of the whole repo or a major subsystem.',\n  tags: ['code-review', 'audit'],\n  estimatedAgents: { min: 7, max: 7 },\n  phases: [\n    { title: 'Inventory' },\n    { title: 'Review' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir']\n\nconst scope = args && typeof args === 'object' && args.scope\n  ? String(args.scope)\n  : '.'\n\nconst ALL_DIMENSIONS = [\n  { key: 'bugs', focus: 'Correctness bugs, null-safety, error handling, race conditions, off-by-one, dead code.' },\n  { key: 'perf', focus: 'Performance issues, hot paths, N+1 patterns, accidental quadratic loops, sync I/O, missing caching.' },\n  { key: 'security', focus: 'Auth/authz, input validation, secret handling, injection sinks, unsafe deserialization, SSRF.' },\n  { key: 'tests', focus: 'Test coverage gaps, brittle tests, integration vs unit gaps, missing regression cases.' },\n  { key: 'style', focus: 'Inconsistent conventions, naming, unused exports, duplication, layering violations.' },\n]\n\nlet dimensions = ALL_DIMENSIONS\nif (args && typeof args === 'object' && Array.isArray(args.dimensions) && args.dimensions.length) {\n  const keys = new Set(args.dimensions.map((d) => String(d)))\n  dimensions = ALL_DIMENSIONS.filter((d) => keys.has(d.key))\n  if (!dimensions.length) dimensions = ALL_DIMENSIONS\n}\n\nphase('Inventory')\nconst inventory = await agent(\n  'Produce a compact map of this repository scope: ' + scope + '. ' +\n    'Cover layout, main modules, the 5\u201310 most important files, and obvious entry points. Be terse and structured.',\n  { label: 'repo inventory', toolset: READ_ONLY_TOOLS },\n)\n\nphase('Review')\nconst findings = await parallel(\n  dimensions.map((d) => () =>\n    agent(\n      'Review scope \"' + scope + '\" through the ' + d.key + ' lens.\\n' +\n        'Focus: ' + d.focus + '\\n\\n' +\n        'Inventory for orientation:\\n' + inventory + '\\n\\n' +\n        'Return findings: file paths, line numbers when known, severity (low/med/high), a one-sentence why, a one-sentence fix.',\n      {\n        label: d.key + ' review',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            findings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  file: { type: 'string' },\n                  line: { type: ['number', 'string'] },\n                  severity: { type: 'string', enum: ['low', 'med', 'high'] },\n                  title: { type: 'string' },\n                  fix: { type: 'string' },\n                },\n                required: ['file', 'severity', 'title', 'fix'],\n              },\n            },\n          },\n          required: ['findings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Synthesize')\nconst live = findings.filter(Boolean)\nif (!live.length) {\n  return { ok: true, scope, summary: 'No findings.', byDimension: {}, priorityActions: [] }\n}\nconst byDimension = {}\nfor (let i = 0; i < dimensions.length; i++) {\n  byDimension[dimensions[i].key] = live[i]?.findings ?? []\n}\n\nconst summary = await agent(\n  'Synthesize a compact report from these per-dimension findings. Deduplicate near-identical items. ' +\n    'Order by severity (high \u2192 low). Cap topFindings at 20. ' +\n    'Also return priorityActions: the top 5 fixes ranked by impact, each with effort (S|M|L).\\n\\n' +\n    JSON.stringify(byDimension, null, 2),\n  {\n    label: 'report synthesis',\n    schema: {\n      type: 'object',\n      properties: {\n        topFindings: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              dimension: { type: 'string' },\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n              fix: { type: 'string' },\n            },\n            required: ['dimension', 'file', 'severity', 'title'],\n          },\n        },\n        priorityActions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n              effort: { type: 'string', enum: ['S', 'M', 'L'] },\n            },\n            required: ['file', 'severity', 'title', 'effort'],\n          },\n        },\n        summary: { type: 'string' },\n      },\n      required: ['topFindings', 'priorityActions', 'summary'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  scope,\n  dimensions: dimensions.map((d) => d.key),\n  ...(summary ?? { topFindings: [], priorityActions: [], summary: 'synthesis failed' }),\n  byDimension,\n}\n";
+export declare const AUDIT_REPO_SCRIPT = "export const meta = {\n  name: 'audit_repo',\n  description: 'Fan-out repository audit across multiple dimensions, then synthesize a structured report.',\n  whenToUse: 'User asks for a thorough / multi-dimension code review of the whole repo or a major subsystem.',\n  examplePrompts: [\n    { field: 'goal', text: 'Run a thorough audit of this repository' },\n    { field: 'goal', text: 'Review code quality across the whole codebase' },\n  ],\n  i18n: {\n    zh: {\n      description: '\u591A\u7EF4\u5EA6\u5E76\u884C\u5BA1\u67E5\u6574\u4E2A\u4ED3\u5E93\uFF0C\u5E76\u6C47\u603B\u4E3A\u7ED3\u6784\u5316\u62A5\u544A\u3002',\n      whenToUse: '\u7528\u6237\u9700\u8981\u5BF9\u6574\u5E93\u6216\u4E3B\u8981\u5B50\u7CFB\u7EDF\u505A\u5168\u9762\u3001\u591A\u7EF4\u5EA6\u7684\u4EE3\u7801\u5BA1\u67E5\u65F6\u3002',\n      examplePrompts: [\n        { field: 'goal', text: '\u5BF9\u6574\u4E2A\u4ED3\u5E93\u505A\u4E00\u6B21\u5168\u9762\u5BA1\u67E5' },\n        { field: 'goal', text: '\u4ECE\u4EE3\u7801\u8D28\u91CF\u7EF4\u5EA6\u5BA1\u67E5\u6574\u4E2A\u4EE3\u7801\u5E93' },\n      ],\n    },\n  },\n  tags: ['code-review', 'audit'],\n  estimatedAgents: { min: 7, max: 7 },\n  phases: [\n    { title: 'Inventory' },\n    { title: 'Review' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir']\n\nconst scope = args && typeof args === 'object' && args.scope\n  ? String(args.scope)\n  : '.'\n\nconst ALL_DIMENSIONS = [\n  { key: 'bugs', focus: 'Correctness bugs, null-safety, error handling, race conditions, off-by-one, dead code.' },\n  { key: 'perf', focus: 'Performance issues, hot paths, N+1 patterns, accidental quadratic loops, sync I/O, missing caching.' },\n  { key: 'security', focus: 'Auth/authz, input validation, secret handling, injection sinks, unsafe deserialization, SSRF.' },\n  { key: 'tests', focus: 'Test coverage gaps, brittle tests, integration vs unit gaps, missing regression cases.' },\n  { key: 'style', focus: 'Inconsistent conventions, naming, unused exports, duplication, layering violations.' },\n]\n\nlet dimensions = ALL_DIMENSIONS\nif (args && typeof args === 'object' && Array.isArray(args.dimensions) && args.dimensions.length) {\n  const keys = new Set(args.dimensions.map((d) => String(d)))\n  dimensions = ALL_DIMENSIONS.filter((d) => keys.has(d.key))\n  if (!dimensions.length) dimensions = ALL_DIMENSIONS\n}\n\nphase('Inventory')\nconst inventory = await agent(\n  'Produce a compact map of this repository scope: ' + scope + '. ' +\n    'Cover layout, main modules, the 5\u201310 most important files, and obvious entry points. Be terse and structured.',\n  { label: 'repo inventory', toolset: READ_ONLY_TOOLS },\n)\n\nphase('Review')\nconst findings = await parallel(\n  dimensions.map((d) => () =>\n    agent(\n      'Review scope \"' + scope + '\" through the ' + d.key + ' lens.\\n' +\n        'Focus: ' + d.focus + '\\n\\n' +\n        'Inventory for orientation:\\n' + inventory + '\\n\\n' +\n        'Return findings: file paths, line numbers when known, severity (low/med/high), a one-sentence why, a one-sentence fix.',\n      {\n        label: d.key + ' review',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            findings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  file: { type: 'string' },\n                  line: { type: ['number', 'string'] },\n                  severity: { type: 'string', enum: ['low', 'med', 'high'] },\n                  title: { type: 'string' },\n                  fix: { type: 'string' },\n                },\n                required: ['file', 'severity', 'title', 'fix'],\n              },\n            },\n          },\n          required: ['findings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Synthesize')\nconst live = findings.filter(Boolean)\nif (!live.length) {\n  return { ok: true, scope, summary: 'No findings.', byDimension: {}, priorityActions: [] }\n}\nconst byDimension = {}\nfor (let i = 0; i < dimensions.length; i++) {\n  byDimension[dimensions[i].key] = live[i]?.findings ?? []\n}\n\nconst summary = await agent(\n  'Synthesize a compact report from these per-dimension findings. Deduplicate near-identical items. ' +\n    'Order by severity (high \u2192 low). Cap topFindings at 20. ' +\n    'Also return priorityActions: the top 5 fixes ranked by impact, each with effort (S|M|L).\\n\\n' +\n    JSON.stringify(byDimension, null, 2),\n  {\n    label: 'report synthesis',\n    schema: {\n      type: 'object',\n      properties: {\n        topFindings: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              dimension: { type: 'string' },\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n              fix: { type: 'string' },\n            },\n            required: ['dimension', 'file', 'severity', 'title'],\n          },\n        },\n        priorityActions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n              effort: { type: 'string', enum: ['S', 'M', 'L'] },\n            },\n            required: ['file', 'severity', 'title', 'effort'],\n          },\n        },\n        summary: { type: 'string' },\n      },\n      required: ['topFindings', 'priorityActions', 'summary'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  scope,\n  dimensions: dimensions.map((d) => d.key),\n  ...(summary ?? { topFindings: [], priorityActions: [], summary: 'synthesis failed' }),\n  byDimension,\n}\n";

package/dist/src/agent/workflow/builtins/audit-repo.js

@@ -15,6 +15,20 @@ const AUDIT_REPO_SCRIPT = `export const meta = {
   name: 'audit_repo',
   description: 'Fan-out repository audit across multiple dimensions, then synthesize a structured report.',
   whenToUse: 'User asks for a thorough / multi-dimension code review of the whole repo or a major subsystem.',
+  examplePrompts: [
+    { field: 'goal', text: 'Run a thorough audit of this repository' },
+    { field: 'goal', text: 'Review code quality across the whole codebase' },
+  ],
+  i18n: {
+    zh: {
+      description: '多维度并行审查整个仓库，并汇总为结构化报告。',
+      whenToUse: '用户需要对整库或主要子系统做全面、多维度的代码审查时。',
+      examplePrompts: [
+        { field: 'goal', text: '对整个仓库做一次全面审查' },
+        { field: 'goal', text: '从代码质量维度审查整个代码库' },
+      ],
+    },
+  },
   tags: ['code-review', 'audit'],
   estimatedAgents: { min: 7, max: 7 },
   phases: [

package/dist/src/agent/workflow/builtins/audit-repo.js.map

@@ -1 +1 @@
-{"version":3,"file":"audit-repo.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/audit-repo.ts"],"sourcesContent":["/**\n * Built-in workflow: `audit_repo`\n *\n * Fan-out repo audit. Phase 1 inventories the repo; phase 2 spawns N reviewers\n * in parallel, one per dimension (bugs / perf / security / tests / style);\n * phase 3 synthesises into a structured report. The script is kept readable so\n * users can copy it into `~/.xopc/workflows/` as a starting point.\n *\n * Args:\n *   - scope: subdirectory to focus on (default '.')\n *   - dimensions: subset of dimension keys, e.g. ['security', 'bugs']\n */\n\nexport const AUDIT_REPO_SCRIPT = `export const meta = {\n  name: 'audit_repo',\n  description: 'Fan-out repository audit across multiple dimensions, then synthesize a structured report.',\n  whenToUse: 'User asks for a thorough / multi-dimension code review of the whole repo or a major subsystem.',\n  tags: ['code-review', 'audit'],\n  estimatedAgents: { min: 7, max: 7 },\n  phases: [\n    { title: 'Inventory' },\n    { title: 'Review' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir']\n\nconst scope = args && typeof args === 'object' && args.scope\n  ? String(args.scope)\n  : '.'\n\nconst ALL_DIMENSIONS = [\n  { key: 'bugs', focus: 'Correctness bugs, null-safety, error handling, race conditions, off-by-one, dead code.' },\n  { key: 'perf', focus: 'Performance issues, hot paths, N+1 patterns, accidental quadratic loops, sync I/O, missing caching.' },\n  { key: 'security', focus: 'Auth/authz, input validation, secret handling, injection sinks, unsafe deserialization, SSRF.' },\n  { key: 'tests', focus: 'Test coverage gaps, brittle tests, integration vs unit gaps, missing regression cases.' },\n  { key: 'style', focus: 'Inconsistent conventions, naming, unused exports, duplication, layering violations.' },\n]\n\nlet dimensions = ALL_DIMENSIONS\nif (args && typeof args === 'object' && Array.isArray(args.dimensions) && args.dimensions.length) {\n  const keys = new Set(args.dimensions.map((d) => String(d)))\n  dimensions = ALL_DIMENSIONS.filter((d) => keys.has(d.key))\n  if (!dimensions.length) dimensions = ALL_DIMENSIONS\n}\n\nphase('Inventory')\nconst inventory = await agent(\n  'Produce a compact map of this repository scope: ' + scope + '. ' +\n    'Cover layout, main modules, the 5–10 most important files, and obvious entry points. Be terse and structured.',\n  { label: 'repo inventory', toolset: READ_ONLY_TOOLS },\n)\n\nphase('Review')\nconst findings = await parallel(\n  dimensions.map((d) => () =>\n    agent(\n      'Review scope \"' + scope + '\" through the ' + d.key + ' lens.\\\\n' +\n        'Focus: ' + d.focus + '\\\\n\\\\n' +\n        'Inventory for orientation:\\\\n' + inventory + '\\\\n\\\\n' +\n        'Return findings: file paths, line numbers when known, severity (low/med/high), a one-sentence why, a one-sentence fix.',\n      {\n        label: d.key + ' review',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            findings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  file: { type: 'string' },\n                  line: { type: ['number', 'string'] },\n                  severity: { type: 'string', enum: ['low', 'med', 'high'] },\n                  title: { type: 'string' },\n                  fix: { type: 'string' },\n                },\n                required: ['file', 'severity', 'title', 'fix'],\n              },\n            },\n          },\n          required: ['findings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Synthesize')\nconst live = findings.filter(Boolean)\nif (!live.length) {\n  return { ok: true, scope, summary: 'No findings.', byDimension: {}, priorityActions: [] }\n}\nconst byDimension = {}\nfor (let i = 0; i < dimensions.length; i++) {\n  byDimension[dimensions[i].key] = live[i]?.findings ?? []\n}\n\nconst summary = await agent(\n  'Synthesize a compact report from these per-dimension findings. Deduplicate near-identical items. ' +\n    'Order by severity (high → low). Cap topFindings at 20. ' +\n    'Also return priorityActions: the top 5 fixes ranked by impact, each with effort (S|M|L).\\\\n\\\\n' +\n    JSON.stringify(byDimension, null, 2),\n  {\n    label: 'report synthesis',\n    schema: {\n      type: 'object',\n      properties: {\n        topFindings: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              dimension: { type: 'string' },\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n              fix: { type: 'string' },\n            },\n            required: ['dimension', 'file', 'severity', 'title'],\n          },\n        },\n        priorityActions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n              effort: { type: 'string', enum: ['S', 'M', 'L'] },\n            },\n            required: ['file', 'severity', 'title', 'effort'],\n          },\n        },\n        summary: { type: 'string' },\n      },\n      required: ['topFindings', 'priorityActions', 'summary'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  scope,\n  dimensions: dimensions.map((d) => d.key),\n  ...(summary ?? { topFindings: [], priorityActions: [], summary: 'synthesis failed' }),\n  byDimension,\n}\n`\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,oBAAoB"}
+{"version":3,"file":"audit-repo.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/audit-repo.ts"],"sourcesContent":["/**\n * Built-in workflow: `audit_repo`\n *\n * Fan-out repo audit. Phase 1 inventories the repo; phase 2 spawns N reviewers\n * in parallel, one per dimension (bugs / perf / security / tests / style);\n * phase 3 synthesises into a structured report. The script is kept readable so\n * users can copy it into `~/.xopc/workflows/` as a starting point.\n *\n * Args:\n *   - scope: subdirectory to focus on (default '.')\n *   - dimensions: subset of dimension keys, e.g. ['security', 'bugs']\n */\n\nexport const AUDIT_REPO_SCRIPT = `export const meta = {\n  name: 'audit_repo',\n  description: 'Fan-out repository audit across multiple dimensions, then synthesize a structured report.',\n  whenToUse: 'User asks for a thorough / multi-dimension code review of the whole repo or a major subsystem.',\n  examplePrompts: [\n    { field: 'goal', text: 'Run a thorough audit of this repository' },\n    { field: 'goal', text: 'Review code quality across the whole codebase' },\n  ],\n  i18n: {\n    zh: {\n      description: '多维度并行审查整个仓库，并汇总为结构化报告。',\n      whenToUse: '用户需要对整库或主要子系统做全面、多维度的代码审查时。',\n      examplePrompts: [\n        { field: 'goal', text: '对整个仓库做一次全面审查' },\n        { field: 'goal', text: '从代码质量维度审查整个代码库' },\n      ],\n    },\n  },\n  tags: ['code-review', 'audit'],\n  estimatedAgents: { min: 7, max: 7 },\n  phases: [\n    { title: 'Inventory' },\n    { title: 'Review' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir']\n\nconst scope = args && typeof args === 'object' && args.scope\n  ? String(args.scope)\n  : '.'\n\nconst ALL_DIMENSIONS = [\n  { key: 'bugs', focus: 'Correctness bugs, null-safety, error handling, race conditions, off-by-one, dead code.' },\n  { key: 'perf', focus: 'Performance issues, hot paths, N+1 patterns, accidental quadratic loops, sync I/O, missing caching.' },\n  { key: 'security', focus: 'Auth/authz, input validation, secret handling, injection sinks, unsafe deserialization, SSRF.' },\n  { key: 'tests', focus: 'Test coverage gaps, brittle tests, integration vs unit gaps, missing regression cases.' },\n  { key: 'style', focus: 'Inconsistent conventions, naming, unused exports, duplication, layering violations.' },\n]\n\nlet dimensions = ALL_DIMENSIONS\nif (args && typeof args === 'object' && Array.isArray(args.dimensions) && args.dimensions.length) {\n  const keys = new Set(args.dimensions.map((d) => String(d)))\n  dimensions = ALL_DIMENSIONS.filter((d) => keys.has(d.key))\n  if (!dimensions.length) dimensions = ALL_DIMENSIONS\n}\n\nphase('Inventory')\nconst inventory = await agent(\n  'Produce a compact map of this repository scope: ' + scope + '. ' +\n    'Cover layout, main modules, the 5–10 most important files, and obvious entry points. Be terse and structured.',\n  { label: 'repo inventory', toolset: READ_ONLY_TOOLS },\n)\n\nphase('Review')\nconst findings = await parallel(\n  dimensions.map((d) => () =>\n    agent(\n      'Review scope \"' + scope + '\" through the ' + d.key + ' lens.\\\\n' +\n        'Focus: ' + d.focus + '\\\\n\\\\n' +\n        'Inventory for orientation:\\\\n' + inventory + '\\\\n\\\\n' +\n        'Return findings: file paths, line numbers when known, severity (low/med/high), a one-sentence why, a one-sentence fix.',\n      {\n        label: d.key + ' review',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            findings: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  file: { type: 'string' },\n                  line: { type: ['number', 'string'] },\n                  severity: { type: 'string', enum: ['low', 'med', 'high'] },\n                  title: { type: 'string' },\n                  fix: { type: 'string' },\n                },\n                required: ['file', 'severity', 'title', 'fix'],\n              },\n            },\n          },\n          required: ['findings'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Synthesize')\nconst live = findings.filter(Boolean)\nif (!live.length) {\n  return { ok: true, scope, summary: 'No findings.', byDimension: {}, priorityActions: [] }\n}\nconst byDimension = {}\nfor (let i = 0; i < dimensions.length; i++) {\n  byDimension[dimensions[i].key] = live[i]?.findings ?? []\n}\n\nconst summary = await agent(\n  'Synthesize a compact report from these per-dimension findings. Deduplicate near-identical items. ' +\n    'Order by severity (high → low). Cap topFindings at 20. ' +\n    'Also return priorityActions: the top 5 fixes ranked by impact, each with effort (S|M|L).\\\\n\\\\n' +\n    JSON.stringify(byDimension, null, 2),\n  {\n    label: 'report synthesis',\n    schema: {\n      type: 'object',\n      properties: {\n        topFindings: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              dimension: { type: 'string' },\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n              fix: { type: 'string' },\n            },\n            required: ['dimension', 'file', 'severity', 'title'],\n          },\n        },\n        priorityActions: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              file: { type: 'string' },\n              severity: { type: 'string' },\n              title: { type: 'string' },\n              effort: { type: 'string', enum: ['S', 'M', 'L'] },\n            },\n            required: ['file', 'severity', 'title', 'effort'],\n          },\n        },\n        summary: { type: 'string' },\n      },\n      required: ['topFindings', 'priorityActions', 'summary'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  scope,\n  dimensions: dimensions.map((d) => d.key),\n  ...(summary ?? { topFindings: [], priorityActions: [], summary: 'synthesis failed' }),\n  byDimension,\n}\n`\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,oBAAoB"}

package/dist/src/agent/workflow/builtins/debug-incident.d.ts

@@ -10,4 +10,4 @@
  *   - logs: optional log excerpt
  *   - context: optional extra context (what changed, when it started)
  */
-export declare const DEBUG_INCIDENT_SCRIPT = "export const meta = {\n  name: 'debug_incident',\n  description: 'Triage an error or log snippet with parallel hypotheses and ranked root-cause analysis.',\n  whenToUse: 'User reports a bug, crash, error message, or unexpected behavior and wants systematic triage.',\n  tags: ['debug', 'incident', 'troubleshooting'],\n  estimatedAgents: { min: 7, max: 7 },\n  phases: [\n    { title: 'Triage' },\n    { title: 'Hypotheses' },\n    { title: 'Rank' },\n  ],\n}\n\nconst READ_TOOLS = ['read_file', 'grep', 'find', 'list_dir', 'shell']\n\nconst error = args && typeof args === 'object' && args.error\n  ? String(args.error)\n  : 'Infer the primary error from the most recent user message or conversation context.'\n\nconst logs = args && typeof args === 'object' && args.logs\n  ? String(args.logs)\n  : ''\n\nconst context = args && typeof args === 'object' && args.context\n  ? String(args.context)\n  : ''\n\nphase('Triage')\nconst triage = await agent(\n  'Parse this incident signal. Extract: error type, likely subsystem, affected files/modules if identifiable, and 2\u20133 key facts from logs.\\n\\n' +\n    'ERROR:\\n' + error + '\\n\\n' +\n    (logs ? 'LOGS:\\n' + logs + '\\n\\n' : '') +\n    (context ? 'CONTEXT:\\n' + context + '\\n\\n' : '') +\n    'Use read/grep tools to locate relevant code if the workspace may contain the failing path.',\n  {\n    label: 'incident triage',\n    toolset: READ_TOOLS,\n    schema: {\n      type: 'object',\n      properties: {\n        errorType: { type: 'string' },\n        subsystem: { type: 'string' },\n        affectedPaths: { type: 'array', items: { type: 'string' } },\n        keyFacts: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['errorType', 'keyFacts'],\n    },\n  },\n)\n\nconst HYPOTHESES = [\n  { key: 'config', angle: 'Misconfiguration, missing env vars, wrong defaults, feature flags, stale config cache.' },\n  { key: 'race', angle: 'Concurrency, timing, ordering, partial failure under load, missing locks or awaits.' },\n  { key: 'dependency', angle: 'Version mismatch, breaking upstream change, network/API failure, timeout, auth expiry.' },\n  { key: 'data', angle: 'Bad input, schema drift, null/empty edge case, corrupt state, migration gap.' },\n  { key: 'environment', angle: 'OS, permissions, disk, memory, container/network isolation, platform-specific behavior.' },\n]\n\nphase('Hypotheses')\nconst hypothesisReports = await parallel(\n  HYPOTHESES.map((h) => () =>\n    agent(\n      'Evaluate whether this hypothesis explains the incident. Search the codebase for supporting or refuting evidence.\\n\\n' +\n        'HYPOTHESIS: ' + h.key + ' \u2014 ' + h.angle + '\\n\\n' +\n        'TRIAGE:\\n' + JSON.stringify(triage, null, 2) + '\\n\\n' +\n        'ERROR:\\n' + error + '\\n\\n' +\n        (logs ? 'LOGS:\\n' + logs + '\\n\\n' : '') +\n        'Return: likelihood (low/med/high), evidence (file paths + brief notes), and one verification step.',\n      {\n        label: h.key + ' hypothesis',\n        toolset: READ_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            likelihood: { type: 'string', enum: ['low', 'med', 'high'] },\n            evidence: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  path: { type: 'string' },\n                  note: { type: 'string' },\n                },\n                required: ['path', 'note'],\n              },\n            },\n            verificationStep: { type: 'string' },\n          },\n          required: ['likelihood', 'evidence', 'verificationStep'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Rank')\nconst live = hypothesisReports.filter(Boolean)\nconst byHypothesis = {}\nfor (let i = 0; i < HYPOTHESES.length; i++) {\n  byHypothesis[HYPOTHESES[i].key] = live[i] ?? null\n}\n\nconst ranking = await agent(\n  'Rank root causes by likelihood. Pick the top 3 with confidence and concrete next steps to confirm or fix.\\n\\n' +\n    JSON.stringify({ triage, byHypothesis }, null, 2),\n  {\n    label: 'root cause ranking',\n    schema: {\n      type: 'object',\n      properties: {\n        topCauses: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              hypothesis: { type: 'string' },\n              likelihood: { type: 'string', enum: ['low', 'med', 'high'] },\n              summary: { type: 'string' },\n              nextStep: { type: 'string' },\n            },\n            required: ['hypothesis', 'likelihood', 'summary', 'nextStep'],\n          },\n        },\n        immediateActions: { type: 'array', items: { type: 'string' } },\n        summary: { type: 'string' },\n      },\n      required: ['topCauses', 'summary'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  triage,\n  ...(ranking ?? { topCauses: [], summary: 'ranking failed', immediateActions: [] }),\n  byHypothesis,\n}\n";
+export declare const DEBUG_INCIDENT_SCRIPT = "export const meta = {\n  name: 'debug_incident',\n  description: 'Triage an error or log snippet with parallel hypotheses and ranked root-cause analysis.',\n  whenToUse: 'User reports a bug, crash, error message, or unexpected behavior and wants systematic triage.',\n  examplePrompts: [\n    { field: 'error', text: 'Triage this stack trace from production' },\n    { field: 'error', text: 'Why does the gateway return 502 after deploy?' },\n  ],\n  i18n: {\n    zh: {\n      description: '\u5BF9\u9519\u8BEF\u6216\u65E5\u5FD7\u7247\u6BB5\u505A\u5E76\u884C\u5047\u8BBE\u63A8\u6F14\uFF0C\u5E76\u6392\u5E8F\u6839\u56E0\u4E0E\u9A8C\u8BC1\u6B65\u9AA4\u3002',\n      whenToUse: '\u7528\u6237\u62A5\u544A bug\u3001\u5D29\u6E83\u3001\u62A5\u9519\u6216\u5F02\u5E38\u884C\u4E3A\uFF0C\u9700\u8981\u7CFB\u7EDF\u5316\u6392\u67E5\u65F6\u3002',\n      examplePrompts: [\n        { field: 'error', text: '\u6392\u67E5\u751F\u4EA7\u73AF\u5883\u8FD9\u6761\u5806\u6808' },\n        { field: 'error', text: '\u90E8\u7F72\u540E\u7F51\u5173\u8FD4\u56DE 502\uFF0C\u53EF\u80FD\u662F\u4EC0\u4E48\u539F\u56E0\uFF1F' },\n      ],\n    },\n  },\n  tags: ['debug', 'incident', 'troubleshooting'],\n  estimatedAgents: { min: 7, max: 7 },\n  phases: [\n    { title: 'Triage' },\n    { title: 'Hypotheses' },\n    { title: 'Rank' },\n  ],\n}\n\nconst READ_TOOLS = ['read_file', 'grep', 'find', 'list_dir', 'shell']\n\nconst error = args && typeof args === 'object' && args.error\n  ? String(args.error)\n  : 'Infer the primary error from the most recent user message or conversation context.'\n\nconst logs = args && typeof args === 'object' && args.logs\n  ? String(args.logs)\n  : ''\n\nconst context = args && typeof args === 'object' && args.context\n  ? String(args.context)\n  : ''\n\nphase('Triage')\nconst triage = await agent(\n  'Parse this incident signal. Extract: error type, likely subsystem, affected files/modules if identifiable, and 2\u20133 key facts from logs.\\n\\n' +\n    'ERROR:\\n' + error + '\\n\\n' +\n    (logs ? 'LOGS:\\n' + logs + '\\n\\n' : '') +\n    (context ? 'CONTEXT:\\n' + context + '\\n\\n' : '') +\n    'Use read/grep tools to locate relevant code if the workspace may contain the failing path.',\n  {\n    label: 'incident triage',\n    toolset: READ_TOOLS,\n    schema: {\n      type: 'object',\n      properties: {\n        errorType: { type: 'string' },\n        subsystem: { type: 'string' },\n        affectedPaths: { type: 'array', items: { type: 'string' } },\n        keyFacts: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['errorType', 'keyFacts'],\n    },\n  },\n)\n\nconst HYPOTHESES = [\n  { key: 'config', angle: 'Misconfiguration, missing env vars, wrong defaults, feature flags, stale config cache.' },\n  { key: 'race', angle: 'Concurrency, timing, ordering, partial failure under load, missing locks or awaits.' },\n  { key: 'dependency', angle: 'Version mismatch, breaking upstream change, network/API failure, timeout, auth expiry.' },\n  { key: 'data', angle: 'Bad input, schema drift, null/empty edge case, corrupt state, migration gap.' },\n  { key: 'environment', angle: 'OS, permissions, disk, memory, container/network isolation, platform-specific behavior.' },\n]\n\nphase('Hypotheses')\nconst hypothesisReports = await parallel(\n  HYPOTHESES.map((h) => () =>\n    agent(\n      'Evaluate whether this hypothesis explains the incident. Search the codebase for supporting or refuting evidence.\\n\\n' +\n        'HYPOTHESIS: ' + h.key + ' \u2014 ' + h.angle + '\\n\\n' +\n        'TRIAGE:\\n' + JSON.stringify(triage, null, 2) + '\\n\\n' +\n        'ERROR:\\n' + error + '\\n\\n' +\n        (logs ? 'LOGS:\\n' + logs + '\\n\\n' : '') +\n        'Return: likelihood (low/med/high), evidence (file paths + brief notes), and one verification step.',\n      {\n        label: h.key + ' hypothesis',\n        toolset: READ_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            likelihood: { type: 'string', enum: ['low', 'med', 'high'] },\n            evidence: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  path: { type: 'string' },\n                  note: { type: 'string' },\n                },\n                required: ['path', 'note'],\n              },\n            },\n            verificationStep: { type: 'string' },\n          },\n          required: ['likelihood', 'evidence', 'verificationStep'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Rank')\nconst live = hypothesisReports.filter(Boolean)\nconst byHypothesis = {}\nfor (let i = 0; i < HYPOTHESES.length; i++) {\n  byHypothesis[HYPOTHESES[i].key] = live[i] ?? null\n}\n\nconst ranking = await agent(\n  'Rank root causes by likelihood. Pick the top 3 with confidence and concrete next steps to confirm or fix.\\n\\n' +\n    JSON.stringify({ triage, byHypothesis }, null, 2),\n  {\n    label: 'root cause ranking',\n    schema: {\n      type: 'object',\n      properties: {\n        topCauses: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              hypothesis: { type: 'string' },\n              likelihood: { type: 'string', enum: ['low', 'med', 'high'] },\n              summary: { type: 'string' },\n              nextStep: { type: 'string' },\n            },\n            required: ['hypothesis', 'likelihood', 'summary', 'nextStep'],\n          },\n        },\n        immediateActions: { type: 'array', items: { type: 'string' } },\n        summary: { type: 'string' },\n      },\n      required: ['topCauses', 'summary'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  triage,\n  ...(ranking ?? { topCauses: [], summary: 'ranking failed', immediateActions: [] }),\n  byHypothesis,\n}\n";

package/dist/src/agent/workflow/builtins/debug-incident.js

@@ -15,6 +15,20 @@ const DEBUG_INCIDENT_SCRIPT = `export const meta = {
   name: 'debug_incident',
   description: 'Triage an error or log snippet with parallel hypotheses and ranked root-cause analysis.',
   whenToUse: 'User reports a bug, crash, error message, or unexpected behavior and wants systematic triage.',
+  examplePrompts: [
+    { field: 'error', text: 'Triage this stack trace from production' },
+    { field: 'error', text: 'Why does the gateway return 502 after deploy?' },
+  ],
+  i18n: {
+    zh: {
+      description: '对错误或日志片段做并行假设推演，并排序根因与验证步骤。',
+      whenToUse: '用户报告 bug、崩溃、报错或异常行为，需要系统化排查时。',
+      examplePrompts: [
+        { field: 'error', text: '排查生产环境这条堆栈' },
+        { field: 'error', text: '部署后网关返回 502，可能是什么原因？' },
+      ],
+    },
+  },
   tags: ['debug', 'incident', 'troubleshooting'],
   estimatedAgents: { min: 7, max: 7 },
   phases: [

package/dist/src/agent/workflow/builtins/debug-incident.js.map

@@ -1 +1 @@
-{"version":3,"file":"debug-incident.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/debug-incident.ts"],"sourcesContent":["/**\n * Built-in workflow: `debug_incident`\n *\n * Triage an error, stack trace, or log snippet. Parses the signal, fans out\n * parallel hypotheses (config, race, dependency, data, environment), then\n * ranks likely root causes with verification steps.\n *\n * Args:\n *   - error: error message or stack trace\n *   - logs: optional log excerpt\n *   - context: optional extra context (what changed, when it started)\n */\n\nexport const DEBUG_INCIDENT_SCRIPT = `export const meta = {\n  name: 'debug_incident',\n  description: 'Triage an error or log snippet with parallel hypotheses and ranked root-cause analysis.',\n  whenToUse: 'User reports a bug, crash, error message, or unexpected behavior and wants systematic triage.',\n  tags: ['debug', 'incident', 'troubleshooting'],\n  estimatedAgents: { min: 7, max: 7 },\n  phases: [\n    { title: 'Triage' },\n    { title: 'Hypotheses' },\n    { title: 'Rank' },\n  ],\n}\n\nconst READ_TOOLS = ['read_file', 'grep', 'find', 'list_dir', 'shell']\n\nconst error = args && typeof args === 'object' && args.error\n  ? String(args.error)\n  : 'Infer the primary error from the most recent user message or conversation context.'\n\nconst logs = args && typeof args === 'object' && args.logs\n  ? String(args.logs)\n  : ''\n\nconst context = args && typeof args === 'object' && args.context\n  ? String(args.context)\n  : ''\n\nphase('Triage')\nconst triage = await agent(\n  'Parse this incident signal. Extract: error type, likely subsystem, affected files/modules if identifiable, and 2–3 key facts from logs.\\\\n\\\\n' +\n    'ERROR:\\\\n' + error + '\\\\n\\\\n' +\n    (logs ? 'LOGS:\\\\n' + logs + '\\\\n\\\\n' : '') +\n    (context ? 'CONTEXT:\\\\n' + context + '\\\\n\\\\n' : '') +\n    'Use read/grep tools to locate relevant code if the workspace may contain the failing path.',\n  {\n    label: 'incident triage',\n    toolset: READ_TOOLS,\n    schema: {\n      type: 'object',\n      properties: {\n        errorType: { type: 'string' },\n        subsystem: { type: 'string' },\n        affectedPaths: { type: 'array', items: { type: 'string' } },\n        keyFacts: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['errorType', 'keyFacts'],\n    },\n  },\n)\n\nconst HYPOTHESES = [\n  { key: 'config', angle: 'Misconfiguration, missing env vars, wrong defaults, feature flags, stale config cache.' },\n  { key: 'race', angle: 'Concurrency, timing, ordering, partial failure under load, missing locks or awaits.' },\n  { key: 'dependency', angle: 'Version mismatch, breaking upstream change, network/API failure, timeout, auth expiry.' },\n  { key: 'data', angle: 'Bad input, schema drift, null/empty edge case, corrupt state, migration gap.' },\n  { key: 'environment', angle: 'OS, permissions, disk, memory, container/network isolation, platform-specific behavior.' },\n]\n\nphase('Hypotheses')\nconst hypothesisReports = await parallel(\n  HYPOTHESES.map((h) => () =>\n    agent(\n      'Evaluate whether this hypothesis explains the incident. Search the codebase for supporting or refuting evidence.\\\\n\\\\n' +\n        'HYPOTHESIS: ' + h.key + ' — ' + h.angle + '\\\\n\\\\n' +\n        'TRIAGE:\\\\n' + JSON.stringify(triage, null, 2) + '\\\\n\\\\n' +\n        'ERROR:\\\\n' + error + '\\\\n\\\\n' +\n        (logs ? 'LOGS:\\\\n' + logs + '\\\\n\\\\n' : '') +\n        'Return: likelihood (low/med/high), evidence (file paths + brief notes), and one verification step.',\n      {\n        label: h.key + ' hypothesis',\n        toolset: READ_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            likelihood: { type: 'string', enum: ['low', 'med', 'high'] },\n            evidence: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  path: { type: 'string' },\n                  note: { type: 'string' },\n                },\n                required: ['path', 'note'],\n              },\n            },\n            verificationStep: { type: 'string' },\n          },\n          required: ['likelihood', 'evidence', 'verificationStep'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Rank')\nconst live = hypothesisReports.filter(Boolean)\nconst byHypothesis = {}\nfor (let i = 0; i < HYPOTHESES.length; i++) {\n  byHypothesis[HYPOTHESES[i].key] = live[i] ?? null\n}\n\nconst ranking = await agent(\n  'Rank root causes by likelihood. Pick the top 3 with confidence and concrete next steps to confirm or fix.\\\\n\\\\n' +\n    JSON.stringify({ triage, byHypothesis }, null, 2),\n  {\n    label: 'root cause ranking',\n    schema: {\n      type: 'object',\n      properties: {\n        topCauses: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              hypothesis: { type: 'string' },\n              likelihood: { type: 'string', enum: ['low', 'med', 'high'] },\n              summary: { type: 'string' },\n              nextStep: { type: 'string' },\n            },\n            required: ['hypothesis', 'likelihood', 'summary', 'nextStep'],\n          },\n        },\n        immediateActions: { type: 'array', items: { type: 'string' } },\n        summary: { type: 'string' },\n      },\n      required: ['topCauses', 'summary'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  triage,\n  ...(ranking ?? { topCauses: [], summary: 'ranking failed', immediateActions: [] }),\n  byHypothesis,\n}\n`\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,wBAAwB"}
+{"version":3,"file":"debug-incident.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/debug-incident.ts"],"sourcesContent":["/**\n * Built-in workflow: `debug_incident`\n *\n * Triage an error, stack trace, or log snippet. Parses the signal, fans out\n * parallel hypotheses (config, race, dependency, data, environment), then\n * ranks likely root causes with verification steps.\n *\n * Args:\n *   - error: error message or stack trace\n *   - logs: optional log excerpt\n *   - context: optional extra context (what changed, when it started)\n */\n\nexport const DEBUG_INCIDENT_SCRIPT = `export const meta = {\n  name: 'debug_incident',\n  description: 'Triage an error or log snippet with parallel hypotheses and ranked root-cause analysis.',\n  whenToUse: 'User reports a bug, crash, error message, or unexpected behavior and wants systematic triage.',\n  examplePrompts: [\n    { field: 'error', text: 'Triage this stack trace from production' },\n    { field: 'error', text: 'Why does the gateway return 502 after deploy?' },\n  ],\n  i18n: {\n    zh: {\n      description: '对错误或日志片段做并行假设推演，并排序根因与验证步骤。',\n      whenToUse: '用户报告 bug、崩溃、报错或异常行为，需要系统化排查时。',\n      examplePrompts: [\n        { field: 'error', text: '排查生产环境这条堆栈' },\n        { field: 'error', text: '部署后网关返回 502，可能是什么原因？' },\n      ],\n    },\n  },\n  tags: ['debug', 'incident', 'troubleshooting'],\n  estimatedAgents: { min: 7, max: 7 },\n  phases: [\n    { title: 'Triage' },\n    { title: 'Hypotheses' },\n    { title: 'Rank' },\n  ],\n}\n\nconst READ_TOOLS = ['read_file', 'grep', 'find', 'list_dir', 'shell']\n\nconst error = args && typeof args === 'object' && args.error\n  ? String(args.error)\n  : 'Infer the primary error from the most recent user message or conversation context.'\n\nconst logs = args && typeof args === 'object' && args.logs\n  ? String(args.logs)\n  : ''\n\nconst context = args && typeof args === 'object' && args.context\n  ? String(args.context)\n  : ''\n\nphase('Triage')\nconst triage = await agent(\n  'Parse this incident signal. Extract: error type, likely subsystem, affected files/modules if identifiable, and 2–3 key facts from logs.\\\\n\\\\n' +\n    'ERROR:\\\\n' + error + '\\\\n\\\\n' +\n    (logs ? 'LOGS:\\\\n' + logs + '\\\\n\\\\n' : '') +\n    (context ? 'CONTEXT:\\\\n' + context + '\\\\n\\\\n' : '') +\n    'Use read/grep tools to locate relevant code if the workspace may contain the failing path.',\n  {\n    label: 'incident triage',\n    toolset: READ_TOOLS,\n    schema: {\n      type: 'object',\n      properties: {\n        errorType: { type: 'string' },\n        subsystem: { type: 'string' },\n        affectedPaths: { type: 'array', items: { type: 'string' } },\n        keyFacts: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['errorType', 'keyFacts'],\n    },\n  },\n)\n\nconst HYPOTHESES = [\n  { key: 'config', angle: 'Misconfiguration, missing env vars, wrong defaults, feature flags, stale config cache.' },\n  { key: 'race', angle: 'Concurrency, timing, ordering, partial failure under load, missing locks or awaits.' },\n  { key: 'dependency', angle: 'Version mismatch, breaking upstream change, network/API failure, timeout, auth expiry.' },\n  { key: 'data', angle: 'Bad input, schema drift, null/empty edge case, corrupt state, migration gap.' },\n  { key: 'environment', angle: 'OS, permissions, disk, memory, container/network isolation, platform-specific behavior.' },\n]\n\nphase('Hypotheses')\nconst hypothesisReports = await parallel(\n  HYPOTHESES.map((h) => () =>\n    agent(\n      'Evaluate whether this hypothesis explains the incident. Search the codebase for supporting or refuting evidence.\\\\n\\\\n' +\n        'HYPOTHESIS: ' + h.key + ' — ' + h.angle + '\\\\n\\\\n' +\n        'TRIAGE:\\\\n' + JSON.stringify(triage, null, 2) + '\\\\n\\\\n' +\n        'ERROR:\\\\n' + error + '\\\\n\\\\n' +\n        (logs ? 'LOGS:\\\\n' + logs + '\\\\n\\\\n' : '') +\n        'Return: likelihood (low/med/high), evidence (file paths + brief notes), and one verification step.',\n      {\n        label: h.key + ' hypothesis',\n        toolset: READ_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            likelihood: { type: 'string', enum: ['low', 'med', 'high'] },\n            evidence: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  path: { type: 'string' },\n                  note: { type: 'string' },\n                },\n                required: ['path', 'note'],\n              },\n            },\n            verificationStep: { type: 'string' },\n          },\n          required: ['likelihood', 'evidence', 'verificationStep'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Rank')\nconst live = hypothesisReports.filter(Boolean)\nconst byHypothesis = {}\nfor (let i = 0; i < HYPOTHESES.length; i++) {\n  byHypothesis[HYPOTHESES[i].key] = live[i] ?? null\n}\n\nconst ranking = await agent(\n  'Rank root causes by likelihood. Pick the top 3 with confidence and concrete next steps to confirm or fix.\\\\n\\\\n' +\n    JSON.stringify({ triage, byHypothesis }, null, 2),\n  {\n    label: 'root cause ranking',\n    schema: {\n      type: 'object',\n      properties: {\n        topCauses: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              hypothesis: { type: 'string' },\n              likelihood: { type: 'string', enum: ['low', 'med', 'high'] },\n              summary: { type: 'string' },\n              nextStep: { type: 'string' },\n            },\n            required: ['hypothesis', 'likelihood', 'summary', 'nextStep'],\n          },\n        },\n        immediateActions: { type: 'array', items: { type: 'string' } },\n        summary: { type: 'string' },\n      },\n      required: ['topCauses', 'summary'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  triage,\n  ...(ranking ?? { topCauses: [], summary: 'ranking failed', immediateActions: [] }),\n  byHypothesis,\n}\n`\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,wBAAwB"}

package/dist/src/agent/workflow/builtins/implementation-plan.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Built-in workflow: `implementation_plan`
+ *
+ * Turns a feature or refactor request into an actionable implementation plan.
+ * It first frames the goal, then explores relevant code areas in parallel, and
+ * finally synthesizes phased tasks with risks and validation steps.
+ *
+ * Args:
+ *   - request: feature, bugfix, or refactor request
+ *   - scope: optional repo path or subsystem hint
+ */
+export declare const IMPLEMENTATION_PLAN_SCRIPT = "export const meta = {\n  name: 'implementation_plan',\n  description: 'Create an actionable implementation plan from a feature, refactor, or bugfix request.',\n  whenToUse: 'User wants a technical plan before coding, especially for multi-file or unfamiliar code changes.',\n  examplePrompts: [\n    { field: 'request', text: 'Plan a refactor of the session store' },\n    { field: 'request', text: 'Design implementation steps for OAuth login' },\n  ],\n  i18n: {\n    zh: {\n      description: '\u5C06\u529F\u80FD\u3001\u91CD\u6784\u6216\u4FEE\u590D\u9700\u6C42\u8F6C\u5316\u4E3A\u53EF\u6267\u884C\u7684\u5B9E\u73B0\u8BA1\u5212\u3002',\n      whenToUse: '\u7528\u6237\u60F3\u5728\u52A8\u624B\u5199\u4EE3\u7801\u524D\u62FF\u5230\u6280\u672F\u65B9\u6848\uFF0C\u5C24\u5176\u662F\u591A\u6587\u4EF6\u6216\u4E0D\u719F\u6089\u4EE3\u7801\u7684\u6539\u52A8\u3002',\n      examplePrompts: [\n        { field: 'request', text: '\u89C4\u5212 session store \u7684\u91CD\u6784\u6B65\u9AA4' },\n        { field: 'request', text: '\u8BBE\u8BA1 OAuth \u767B\u5F55\u7684\u5B9E\u73B0\u6B65\u9AA4' },\n      ],\n    },\n  },\n  tags: ['planning', 'implementation', 'architecture'],\n  estimatedAgents: { min: 5, max: 6 },\n  phases: [\n    { title: 'Frame' },\n    { title: 'Explore' },\n    { title: 'Plan' },\n    { title: 'Validate' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir']\n\nconst request = args && typeof args === 'object' && args.request\n  ? String(args.request)\n  : 'Infer the implementation request from the current conversation context.'\n\nconst scope = args && typeof args === 'object' && args.scope\n  ? String(args.scope)\n  : '.'\n\nphase('Frame')\nconst frame = await agent(\n  'Frame this implementation request. Identify the desired outcome, non-goals, likely affected domains, and open questions. Be concrete and avoid generic advice.\\n\\n' +\n    'REQUEST:\\n' + request + '\\n\\nSCOPE HINT:\\n' + scope,\n  {\n    label: 'request framing',\n    toolset: READ_ONLY_TOOLS,\n    schema: {\n      type: 'object',\n      properties: {\n        outcome: { type: 'string' },\n        nonGoals: { type: 'array', items: { type: 'string' } },\n        affectedDomains: { type: 'array', items: { type: 'string' } },\n        openQuestions: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['outcome', 'affectedDomains'],\n    },\n  },\n)\n\nconst AREAS = [\n  { key: 'entrypoints', focus: 'Routes, commands, UI pages, public APIs, and user-facing surfaces that must change.' },\n  { key: 'domain', focus: 'Core domain model, state transitions, stores, services, and invariants.' },\n  { key: 'integration', focus: 'Cross-module dependencies, config, events, async jobs, persistence, and external APIs.' },\n  { key: 'validation', focus: 'Existing tests, missing regression tests, build/type/lint commands, and release validation.' },\n]\n\nphase('Explore')\nconst explorations = await parallel(\n  AREAS.map((area) => () =>\n    agent(\n      'Explore the repository for this implementation plan through the ' + area.key + ' lens.\\n' +\n        'Focus: ' + area.focus + '\\n\\n' +\n        'REQUEST:\\n' + request + '\\n\\n' +\n        'FRAME:\\n' + JSON.stringify(frame, null, 2) + '\\n\\n' +\n        'Return concrete files/functions/modules to inspect or modify, existing patterns to follow, and constraints that affect the plan.',\n      {\n        label: area.key + ' exploration',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            targets: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  path: { type: 'string' },\n                  reason: { type: 'string' },\n                },\n                required: ['path', 'reason'],\n              },\n            },\n            patterns: { type: 'array', items: { type: 'string' } },\n            constraints: { type: 'array', items: { type: 'string' } },\n          },\n          required: ['targets', 'constraints'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Plan')\nconst plan = await agent(\n  'Synthesize an implementation plan from the framing and explorations. Make it executable by an engineer or coding agent. ' +\n    'Use phased tasks, name the concrete files/modules, include sequencing/dependencies, and call out decisions that need user confirmation.\\n\\n' +\n    JSON.stringify({ request, scope, frame, explorations }, null, 2),\n  {\n    label: 'plan synthesis',\n    schema: {\n      type: 'object',\n      properties: {\n        summary: { type: 'string' },\n        phases: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              title: { type: 'string' },\n              tasks: { type: 'array', items: { type: 'string' } },\n              files: { type: 'array', items: { type: 'string' } },\n            },\n            required: ['title', 'tasks'],\n          },\n        },\n        decisions: { type: 'array', items: { type: 'string' } },\n        risks: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['summary', 'phases', 'risks'],\n    },\n  },\n)\n\nphase('Validate')\nconst validation = await agent(\n  'Create a validation checklist for this implementation plan. Include targeted tests, full commands, manual UI/API checks if relevant, and rollback/recovery notes.\\n\\n' +\n    JSON.stringify({ request, plan }, null, 2),\n  {\n    label: 'validation checklist',\n    toolset: READ_ONLY_TOOLS,\n    schema: {\n      type: 'object',\n      properties: {\n        testCommands: { type: 'array', items: { type: 'string' } },\n        manualChecks: { type: 'array', items: { type: 'string' } },\n        rollbackNotes: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['testCommands', 'manualChecks'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  request,\n  scope,\n  ...(plan ?? { summary: 'plan synthesis failed', phases: [], decisions: [], risks: [] }),\n  validation: validation ?? { testCommands: [], manualChecks: [], rollbackNotes: [] },\n}\n";

package/dist/src/agent/workflow/builtins/implementation-plan.js

@@ -0,0 +1,175 @@
+//#region src/agent/workflow/builtins/implementation-plan.ts
+/**
+* Built-in workflow: `implementation_plan`
+*
+* Turns a feature or refactor request into an actionable implementation plan.
+* It first frames the goal, then explores relevant code areas in parallel, and
+* finally synthesizes phased tasks with risks and validation steps.
+*
+* Args:
+*   - request: feature, bugfix, or refactor request
+*   - scope: optional repo path or subsystem hint
+*/
+const IMPLEMENTATION_PLAN_SCRIPT = `export const meta = {
+  name: 'implementation_plan',
+  description: 'Create an actionable implementation plan from a feature, refactor, or bugfix request.',
+  whenToUse: 'User wants a technical plan before coding, especially for multi-file or unfamiliar code changes.',
+  examplePrompts: [
+    { field: 'request', text: 'Plan a refactor of the session store' },
+    { field: 'request', text: 'Design implementation steps for OAuth login' },
+  ],
+  i18n: {
+    zh: {
+      description: '将功能、重构或修复需求转化为可执行的实现计划。',
+      whenToUse: '用户想在动手写代码前拿到技术方案，尤其是多文件或不熟悉代码的改动。',
+      examplePrompts: [
+        { field: 'request', text: '规划 session store 的重构步骤' },
+        { field: 'request', text: '设计 OAuth 登录的实现步骤' },
+      ],
+    },
+  },
+  tags: ['planning', 'implementation', 'architecture'],
+  estimatedAgents: { min: 5, max: 6 },
+  phases: [
+    { title: 'Frame' },
+    { title: 'Explore' },
+    { title: 'Plan' },
+    { title: 'Validate' },
+  ],
+}
+
+const READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir']
+
+const request = args && typeof args === 'object' && args.request
+  ? String(args.request)
+  : 'Infer the implementation request from the current conversation context.'
+
+const scope = args && typeof args === 'object' && args.scope
+  ? String(args.scope)
+  : '.'
+
+phase('Frame')
+const frame = await agent(
+  'Frame this implementation request. Identify the desired outcome, non-goals, likely affected domains, and open questions. Be concrete and avoid generic advice.\\n\\n' +
+    'REQUEST:\\n' + request + '\\n\\nSCOPE HINT:\\n' + scope,
+  {
+    label: 'request framing',
+    toolset: READ_ONLY_TOOLS,
+    schema: {
+      type: 'object',
+      properties: {
+        outcome: { type: 'string' },
+        nonGoals: { type: 'array', items: { type: 'string' } },
+        affectedDomains: { type: 'array', items: { type: 'string' } },
+        openQuestions: { type: 'array', items: { type: 'string' } },
+      },
+      required: ['outcome', 'affectedDomains'],
+    },
+  },
+)
+
+const AREAS = [
+  { key: 'entrypoints', focus: 'Routes, commands, UI pages, public APIs, and user-facing surfaces that must change.' },
+  { key: 'domain', focus: 'Core domain model, state transitions, stores, services, and invariants.' },
+  { key: 'integration', focus: 'Cross-module dependencies, config, events, async jobs, persistence, and external APIs.' },
+  { key: 'validation', focus: 'Existing tests, missing regression tests, build/type/lint commands, and release validation.' },
+]
+
+phase('Explore')
+const explorations = await parallel(
+  AREAS.map((area) => () =>
+    agent(
+      'Explore the repository for this implementation plan through the ' + area.key + ' lens.\\n' +
+        'Focus: ' + area.focus + '\\n\\n' +
+        'REQUEST:\\n' + request + '\\n\\n' +
+        'FRAME:\\n' + JSON.stringify(frame, null, 2) + '\\n\\n' +
+        'Return concrete files/functions/modules to inspect or modify, existing patterns to follow, and constraints that affect the plan.',
+      {
+        label: area.key + ' exploration',
+        toolset: READ_ONLY_TOOLS,
+        schema: {
+          type: 'object',
+          properties: {
+            targets: {
+              type: 'array',
+              items: {
+                type: 'object',
+                properties: {
+                  path: { type: 'string' },
+                  reason: { type: 'string' },
+                },
+                required: ['path', 'reason'],
+              },
+            },
+            patterns: { type: 'array', items: { type: 'string' } },
+            constraints: { type: 'array', items: { type: 'string' } },
+          },
+          required: ['targets', 'constraints'],
+        },
+      },
+    ),
+  ),
+)
+
+phase('Plan')
+const plan = await agent(
+  'Synthesize an implementation plan from the framing and explorations. Make it executable by an engineer or coding agent. ' +
+    'Use phased tasks, name the concrete files/modules, include sequencing/dependencies, and call out decisions that need user confirmation.\\n\\n' +
+    JSON.stringify({ request, scope, frame, explorations }, null, 2),
+  {
+    label: 'plan synthesis',
+    schema: {
+      type: 'object',
+      properties: {
+        summary: { type: 'string' },
+        phases: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              title: { type: 'string' },
+              tasks: { type: 'array', items: { type: 'string' } },
+              files: { type: 'array', items: { type: 'string' } },
+            },
+            required: ['title', 'tasks'],
+          },
+        },
+        decisions: { type: 'array', items: { type: 'string' } },
+        risks: { type: 'array', items: { type: 'string' } },
+      },
+      required: ['summary', 'phases', 'risks'],
+    },
+  },
+)
+
+phase('Validate')
+const validation = await agent(
+  'Create a validation checklist for this implementation plan. Include targeted tests, full commands, manual UI/API checks if relevant, and rollback/recovery notes.\\n\\n' +
+    JSON.stringify({ request, plan }, null, 2),
+  {
+    label: 'validation checklist',
+    toolset: READ_ONLY_TOOLS,
+    schema: {
+      type: 'object',
+      properties: {
+        testCommands: { type: 'array', items: { type: 'string' } },
+        manualChecks: { type: 'array', items: { type: 'string' } },
+        rollbackNotes: { type: 'array', items: { type: 'string' } },
+      },
+      required: ['testCommands', 'manualChecks'],
+    },
+  },
+)
+
+return {
+  ok: true,
+  request,
+  scope,
+  ...(plan ?? { summary: 'plan synthesis failed', phases: [], decisions: [], risks: [] }),
+  validation: validation ?? { testCommands: [], manualChecks: [], rollbackNotes: [] },
+}
+`;
+//#endregion
+export { IMPLEMENTATION_PLAN_SCRIPT };
+
+//# sourceMappingURL=implementation-plan.js.map

package/dist/src/agent/workflow/builtins/implementation-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"implementation-plan.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/implementation-plan.ts"],"sourcesContent":["/**\n * Built-in workflow: `implementation_plan`\n *\n * Turns a feature or refactor request into an actionable implementation plan.\n * It first frames the goal, then explores relevant code areas in parallel, and\n * finally synthesizes phased tasks with risks and validation steps.\n *\n * Args:\n *   - request: feature, bugfix, or refactor request\n *   - scope: optional repo path or subsystem hint\n */\n\nexport const IMPLEMENTATION_PLAN_SCRIPT = `export const meta = {\n  name: 'implementation_plan',\n  description: 'Create an actionable implementation plan from a feature, refactor, or bugfix request.',\n  whenToUse: 'User wants a technical plan before coding, especially for multi-file or unfamiliar code changes.',\n  examplePrompts: [\n    { field: 'request', text: 'Plan a refactor of the session store' },\n    { field: 'request', text: 'Design implementation steps for OAuth login' },\n  ],\n  i18n: {\n    zh: {\n      description: '将功能、重构或修复需求转化为可执行的实现计划。',\n      whenToUse: '用户想在动手写代码前拿到技术方案，尤其是多文件或不熟悉代码的改动。',\n      examplePrompts: [\n        { field: 'request', text: '规划 session store 的重构步骤' },\n        { field: 'request', text: '设计 OAuth 登录的实现步骤' },\n      ],\n    },\n  },\n  tags: ['planning', 'implementation', 'architecture'],\n  estimatedAgents: { min: 5, max: 6 },\n  phases: [\n    { title: 'Frame' },\n    { title: 'Explore' },\n    { title: 'Plan' },\n    { title: 'Validate' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir']\n\nconst request = args && typeof args === 'object' && args.request\n  ? String(args.request)\n  : 'Infer the implementation request from the current conversation context.'\n\nconst scope = args && typeof args === 'object' && args.scope\n  ? String(args.scope)\n  : '.'\n\nphase('Frame')\nconst frame = await agent(\n  'Frame this implementation request. Identify the desired outcome, non-goals, likely affected domains, and open questions. Be concrete and avoid generic advice.\\\\n\\\\n' +\n    'REQUEST:\\\\n' + request + '\\\\n\\\\nSCOPE HINT:\\\\n' + scope,\n  {\n    label: 'request framing',\n    toolset: READ_ONLY_TOOLS,\n    schema: {\n      type: 'object',\n      properties: {\n        outcome: { type: 'string' },\n        nonGoals: { type: 'array', items: { type: 'string' } },\n        affectedDomains: { type: 'array', items: { type: 'string' } },\n        openQuestions: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['outcome', 'affectedDomains'],\n    },\n  },\n)\n\nconst AREAS = [\n  { key: 'entrypoints', focus: 'Routes, commands, UI pages, public APIs, and user-facing surfaces that must change.' },\n  { key: 'domain', focus: 'Core domain model, state transitions, stores, services, and invariants.' },\n  { key: 'integration', focus: 'Cross-module dependencies, config, events, async jobs, persistence, and external APIs.' },\n  { key: 'validation', focus: 'Existing tests, missing regression tests, build/type/lint commands, and release validation.' },\n]\n\nphase('Explore')\nconst explorations = await parallel(\n  AREAS.map((area) => () =>\n    agent(\n      'Explore the repository for this implementation plan through the ' + area.key + ' lens.\\\\n' +\n        'Focus: ' + area.focus + '\\\\n\\\\n' +\n        'REQUEST:\\\\n' + request + '\\\\n\\\\n' +\n        'FRAME:\\\\n' + JSON.stringify(frame, null, 2) + '\\\\n\\\\n' +\n        'Return concrete files/functions/modules to inspect or modify, existing patterns to follow, and constraints that affect the plan.',\n      {\n        label: area.key + ' exploration',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            targets: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  path: { type: 'string' },\n                  reason: { type: 'string' },\n                },\n                required: ['path', 'reason'],\n              },\n            },\n            patterns: { type: 'array', items: { type: 'string' } },\n            constraints: { type: 'array', items: { type: 'string' } },\n          },\n          required: ['targets', 'constraints'],\n        },\n      },\n    ),\n  ),\n)\n\nphase('Plan')\nconst plan = await agent(\n  'Synthesize an implementation plan from the framing and explorations. Make it executable by an engineer or coding agent. ' +\n    'Use phased tasks, name the concrete files/modules, include sequencing/dependencies, and call out decisions that need user confirmation.\\\\n\\\\n' +\n    JSON.stringify({ request, scope, frame, explorations }, null, 2),\n  {\n    label: 'plan synthesis',\n    schema: {\n      type: 'object',\n      properties: {\n        summary: { type: 'string' },\n        phases: {\n          type: 'array',\n          items: {\n            type: 'object',\n            properties: {\n              title: { type: 'string' },\n              tasks: { type: 'array', items: { type: 'string' } },\n              files: { type: 'array', items: { type: 'string' } },\n            },\n            required: ['title', 'tasks'],\n          },\n        },\n        decisions: { type: 'array', items: { type: 'string' } },\n        risks: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['summary', 'phases', 'risks'],\n    },\n  },\n)\n\nphase('Validate')\nconst validation = await agent(\n  'Create a validation checklist for this implementation plan. Include targeted tests, full commands, manual UI/API checks if relevant, and rollback/recovery notes.\\\\n\\\\n' +\n    JSON.stringify({ request, plan }, null, 2),\n  {\n    label: 'validation checklist',\n    toolset: READ_ONLY_TOOLS,\n    schema: {\n      type: 'object',\n      properties: {\n        testCommands: { type: 'array', items: { type: 'string' } },\n        manualChecks: { type: 'array', items: { type: 'string' } },\n        rollbackNotes: { type: 'array', items: { type: 'string' } },\n      },\n      required: ['testCommands', 'manualChecks'],\n    },\n  },\n)\n\nreturn {\n  ok: true,\n  request,\n  scope,\n  ...(plan ?? { summary: 'plan synthesis failed', phases: [], decisions: [], risks: [] }),\n  validation: validation ?? { testCommands: [], manualChecks: [], rollbackNotes: [] },\n}\n`\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,6BAA6B"}

package/dist/src/agent/workflow/builtins/index.d.ts

@@ -6,12 +6,14 @@
  */
 import { AUDIT_REPO_SCRIPT } from './audit-repo.js';
 import { DEBUG_INCIDENT_SCRIPT } from './debug-incident.js';
+import { IMPLEMENTATION_PLAN_SCRIPT } from './implementation-plan.js';
 import { MULTI_PERSPECTIVE_REVIEW_SCRIPT } from './multi-perspective-review.js';
 import { PR_REVIEW_SCRIPT } from './pr-review.js';
+import { RELEASE_CHECK_SCRIPT } from './release-check.js';
 import { RESEARCH_SCRIPT } from './research.js';
 export interface BuiltinWorkflow {
     name: string;
     script: string;
 }
 export declare const BUILTIN_WORKFLOWS: readonly BuiltinWorkflow[];
-export { AUDIT_REPO_SCRIPT, DEBUG_INCIDENT_SCRIPT, MULTI_PERSPECTIVE_REVIEW_SCRIPT, PR_REVIEW_SCRIPT, RESEARCH_SCRIPT, };
+export { AUDIT_REPO_SCRIPT, DEBUG_INCIDENT_SCRIPT, IMPLEMENTATION_PLAN_SCRIPT, MULTI_PERSPECTIVE_REVIEW_SCRIPT, PR_REVIEW_SCRIPT, RELEASE_CHECK_SCRIPT, RESEARCH_SCRIPT, };

package/dist/src/agent/workflow/builtins/index.js

@@ -1,7 +1,9 @@
 import { AUDIT_REPO_SCRIPT } from "./audit-repo.js";
 import { DEBUG_INCIDENT_SCRIPT } from "./debug-incident.js";
+import { IMPLEMENTATION_PLAN_SCRIPT } from "./implementation-plan.js";
 import { MULTI_PERSPECTIVE_REVIEW_SCRIPT } from "./multi-perspective-review.js";
 import { PR_REVIEW_SCRIPT } from "./pr-review.js";
+import { RELEASE_CHECK_SCRIPT } from "./release-check.js";
 import { RESEARCH_SCRIPT } from "./research.js";
 //#region src/agent/workflow/builtins/index.ts
 /**
@@ -19,6 +21,10 @@ const BUILTIN_WORKFLOWS = Object.freeze([
 		name: "debug_incident",
 		script: DEBUG_INCIDENT_SCRIPT
 	},
+	{
+		name: "implementation_plan",
+		script: IMPLEMENTATION_PLAN_SCRIPT
+	},
 	{
 		name: "multi_perspective_review",
 		script: MULTI_PERSPECTIVE_REVIEW_SCRIPT
@@ -27,12 +33,16 @@ const BUILTIN_WORKFLOWS = Object.freeze([
 		name: "pr_review",
 		script: PR_REVIEW_SCRIPT
 	},
+	{
+		name: "release_check",
+		script: RELEASE_CHECK_SCRIPT
+	},
 	{
 		name: "research",
 		script: RESEARCH_SCRIPT
 	}
 ]);
 //#endregion
-export { AUDIT_REPO_SCRIPT, BUILTIN_WORKFLOWS, DEBUG_INCIDENT_SCRIPT, MULTI_PERSPECTIVE_REVIEW_SCRIPT, PR_REVIEW_SCRIPT, RESEARCH_SCRIPT };
+export { AUDIT_REPO_SCRIPT, BUILTIN_WORKFLOWS, DEBUG_INCIDENT_SCRIPT, IMPLEMENTATION_PLAN_SCRIPT, MULTI_PERSPECTIVE_REVIEW_SCRIPT, PR_REVIEW_SCRIPT, RELEASE_CHECK_SCRIPT, RESEARCH_SCRIPT };
 
 //# sourceMappingURL=index.js.map

package/dist/src/agent/workflow/builtins/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/index.ts"],"sourcesContent":["/**\n * Bundled workflow templates. These are shipped with xopc and discoverable\n * via the catalog alongside user workflows in `~/.xopc/workflows/`. A user\n * workflow with the same `name` always wins — built-ins are starting points,\n * not authority.\n */\n\nimport { AUDIT_REPO_SCRIPT } from './audit-repo.js';\nimport { DEBUG_INCIDENT_SCRIPT } from './debug-incident.js';\nimport { MULTI_PERSPECTIVE_REVIEW_SCRIPT } from './multi-perspective-review.js';\nimport { PR_REVIEW_SCRIPT } from './pr-review.js';\nimport { RESEARCH_SCRIPT } from './research.js';\n\nexport interface BuiltinWorkflow {\n  name: string;\n  script: string;\n}\n\nexport const BUILTIN_WORKFLOWS: readonly BuiltinWorkflow[] = Object.freeze([\n  { name: 'audit_repo', script: AUDIT_REPO_SCRIPT },\n  { name: 'debug_incident', script: DEBUG_INCIDENT_SCRIPT },\n  { name: 'multi_perspective_review', script: MULTI_PERSPECTIVE_REVIEW_SCRIPT },\n  { name: 'pr_review', script: PR_REVIEW_SCRIPT },\n  { name: 'research', script: RESEARCH_SCRIPT },\n]);\n\nexport {\n  AUDIT_REPO_SCRIPT,\n  DEBUG_INCIDENT_SCRIPT,\n  MULTI_PERSPECTIVE_REVIEW_SCRIPT,\n  PR_REVIEW_SCRIPT,\n  RESEARCH_SCRIPT,\n};\n"],"mappings":";;;;;;;;;;;;AAkBA,MAAa,oBAAgD,OAAO,OAAO;CACzE;EAAE,MAAM;EAAc,QAAQ;EAAmB;CACjD;EAAE,MAAM;EAAkB,QAAQ;EAAuB;CACzD;EAAE,MAAM;EAA4B,QAAQ;EAAiC;CAC7E;EAAE,MAAM;EAAa,QAAQ;EAAkB;CAC/C;EAAE,MAAM;EAAY,QAAQ;EAAiB;CAC9C,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../../../src/agent/workflow/builtins/index.ts"],"sourcesContent":["/**\n * Bundled workflow templates. These are shipped with xopc and discoverable\n * via the catalog alongside user workflows in `~/.xopc/workflows/`. A user\n * workflow with the same `name` always wins — built-ins are starting points,\n * not authority.\n */\n\nimport { AUDIT_REPO_SCRIPT } from './audit-repo.js';\nimport { DEBUG_INCIDENT_SCRIPT } from './debug-incident.js';\nimport { IMPLEMENTATION_PLAN_SCRIPT } from './implementation-plan.js';\nimport { MULTI_PERSPECTIVE_REVIEW_SCRIPT } from './multi-perspective-review.js';\nimport { PR_REVIEW_SCRIPT } from './pr-review.js';\nimport { RELEASE_CHECK_SCRIPT } from './release-check.js';\nimport { RESEARCH_SCRIPT } from './research.js';\n\nexport interface BuiltinWorkflow {\n  name: string;\n  script: string;\n}\n\nexport const BUILTIN_WORKFLOWS: readonly BuiltinWorkflow[] = Object.freeze([\n  { name: 'audit_repo', script: AUDIT_REPO_SCRIPT },\n  { name: 'debug_incident', script: DEBUG_INCIDENT_SCRIPT },\n  { name: 'implementation_plan', script: IMPLEMENTATION_PLAN_SCRIPT },\n  { name: 'multi_perspective_review', script: MULTI_PERSPECTIVE_REVIEW_SCRIPT },\n  { name: 'pr_review', script: PR_REVIEW_SCRIPT },\n  { name: 'release_check', script: RELEASE_CHECK_SCRIPT },\n  { name: 'research', script: RESEARCH_SCRIPT },\n]);\n\nexport {\n  AUDIT_REPO_SCRIPT,\n  DEBUG_INCIDENT_SCRIPT,\n  IMPLEMENTATION_PLAN_SCRIPT,\n  MULTI_PERSPECTIVE_REVIEW_SCRIPT,\n  PR_REVIEW_SCRIPT,\n  RELEASE_CHECK_SCRIPT,\n  RESEARCH_SCRIPT,\n};\n"],"mappings":";;;;;;;;;;;;;;AAoBA,MAAa,oBAAgD,OAAO,OAAO;CACzE;EAAE,MAAM;EAAc,QAAQ;EAAmB;CACjD;EAAE,MAAM;EAAkB,QAAQ;EAAuB;CACzD;EAAE,MAAM;EAAuB,QAAQ;EAA4B;CACnE;EAAE,MAAM;EAA4B,QAAQ;EAAiC;CAC7E;EAAE,MAAM;EAAa,QAAQ;EAAkB;CAC/C;EAAE,MAAM;EAAiB,QAAQ;EAAsB;CACvD;EAAE,MAAM;EAAY,QAAQ;EAAiB;CAC9C,CAAC"}

package/dist/src/agent/workflow/builtins/multi-perspective-review.d.ts

@@ -11,4 +11,4 @@
  *   - lenses: optional array of { name, angle } to override default lenses
  *   - skipAdversarial: when true, skip the adversarial judge phase
  */
-export declare const MULTI_PERSPECTIVE_REVIEW_SCRIPT = "export const meta = {\n  name: 'multi_perspective_review',\n  description: 'Review a target from N independent perspectives, then adversarially judge what would actually break.',\n  whenToUse: 'User wants a stress-test of a design, plan, PR, or proposal before committing to it.',\n  tags: ['review', 'planning', 'decision'],\n  estimatedAgents: { min: 5, max: 6 },\n  phases: [\n    { title: 'Lenses' },\n    { title: 'Adversarial' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir']\n\nconst target = args && typeof args === 'object' && args.target\n  ? String(args.target)\n  : 'No explicit target was provided. Treat the currently focused file or recent context as the target.'\n\nconst skipAdversarial = Boolean(args && typeof args === 'object' && args.skipAdversarial)\n\nconst DEFAULT_LENSES = [\n  { name: 'User', angle: 'How a real user experiences this. Friction, confusion, surprise paths, accessibility.' },\n  { name: 'Operator', angle: 'How an on-call engineer experiences this in production. Failure modes, observability, rollback.' },\n  { name: 'Skeptic', angle: 'Hidden assumptions. What is being implied but not stated. What would break under load or weird input.' },\n  { name: 'Maintainer', angle: 'Six-month-later view. Clarity, naming, layering, ease of changing nearby code.' },\n]\n\nlet lenses = DEFAULT_LENSES\nif (args && typeof args === 'object' && Array.isArray(args.lenses) && args.lenses.length) {\n  lenses = args.lenses\n    .filter((l) => l && typeof l === 'object' && l.name && l.angle)\n    .map((l) => ({ name: String(l.name), angle: String(l.angle) }))\n  if (!lenses.length) lenses = DEFAULT_LENSES\n}\n\nphase('Lenses')\nconst lensViews = await parallel(\n  lenses.map((l) => () =>\n    agent(\n      'Review the following target through the ' + l.name + ' lens.\\n' +\n        'Lens focus: ' + l.angle + '\\n\\n' +\n        'TARGET:\\n' + target + '\\n\\n' +\n        'Return 3\u20137 concrete observations. Each entry: title (5\u201310 words), why-it-matters (1 sentence), risk (low/med/high).',\n      {\n        label: l.name + ' lens',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            observations: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  title: { type: 'string' },\n                  why: { type: 'string' },\n                  risk: { type: 'string', enum: ['low', 'med', 'high'] },\n                },\n                required: ['title', 'why', 'risk'],\n              },\n            },\n          },\n          required: ['observations'],\n        },\n      },\n    ),\n  ),\n)\n\nconst valid = lensViews.filter(Boolean)\nconst allObs = valid.flatMap((v, i) =>\n  (v?.observations ?? []).map((o) => ({ lens: lenses[i].name, ...o })),\n)\n\nlet verdict = null\nif (!skipAdversarial) {\n  phase('Adversarial')\n  verdict = await agent(\n    'You are an adversarial judge. Given these multi-lens observations of a target, decide which would actually cause real harm if shipped as-is. ' +\n      'Default to realRisk=false unless an observation has clear, mechanism-level evidence. ' +\n      'Rate evidenceStrength as weak | moderate | strong.\\n\\n' +\n      JSON.stringify(allObs, null, 2),\n    {\n      label: 'adversarial verdict',\n      schema: {\n        type: 'object',\n        properties: {\n          verdicts: {\n            type: 'array',\n            items: {\n              type: 'object',\n              properties: {\n                title: { type: 'string' },\n                lens: { type: 'string' },\n                realRisk: { type: 'boolean' },\n                evidenceStrength: { type: 'string', enum: ['weak', 'moderate', 'strong'] },\n                reason: { type: 'string' },\n              },\n              required: ['title', 'lens', 'realRisk', 'evidenceStrength', 'reason'],\n            },\n          },\n        },\n        required: ['verdicts'],\n      },\n    },\n  )\n}\n\nphase('Synthesize')\nconst confirmed = (verdict?.verdicts ?? []).filter((v) => v.realRisk)\nconst goNoGo = skipAdversarial\n  ? (allObs.some((o) => o.risk === 'high') ? 'fix_first' : 'ship')\n  : confirmed.some((v) => v.evidenceStrength === 'strong')\n    ? 'fix_first'\n    : confirmed.length\n      ? 'fix_first'\n      : 'ship'\n\nreturn {\n  ok: true,\n  target,\n  lenses: lenses.map((l) => l.name),\n  skipAdversarial,\n  observationCount: allObs.length,\n  confirmedRiskCount: confirmed.length,\n  goNoGo,\n  topRisks: confirmed.slice(0, 10),\n  allVerdicts: verdict?.verdicts ?? [],\n}\n";
+export declare const MULTI_PERSPECTIVE_REVIEW_SCRIPT = "export const meta = {\n  name: 'multi_perspective_review',\n  description: 'Review a target from N independent perspectives, then adversarially judge what would actually break.',\n  whenToUse: 'User wants a stress-test of a design, plan, PR, or proposal before committing to it.',\n  examplePrompts: [\n    { field: 'target', text: 'Stress-test this API redesign before we ship' },\n    { field: 'target', text: 'Review the migration plan from multiple angles' },\n  ],\n  i18n: {\n    zh: {\n      description: '\u4ECE\u591A\u4E2A\u72EC\u7ACB\u89C6\u89D2\u8BC4\u5BA1\u76EE\u6807\uFF0C\u5E76\u7531\u5BF9\u6297\u6027\u8BC4\u5BA1\u5224\u65AD\u5B9E\u9645\u4F1A\u51FA\u4EC0\u4E48\u95EE\u9898\u3002',\n      whenToUse: '\u7528\u6237\u60F3\u5728\u843D\u5730\u524D\u5BF9\u8BBE\u8BA1\u3001\u65B9\u6848\u3001PR \u6216\u63D0\u6848\u505A\u538B\u529B\u6D4B\u8BD5\u65F6\u3002',\n      examplePrompts: [\n        { field: 'target', text: '\u4E0A\u7EBF\u524D\u4ECE\u591A\u89D2\u5EA6\u538B\u529B\u6D4B\u8BD5\u8FD9\u4E2A API redesign' },\n        { field: 'target', text: '\u4ECE\u591A\u4E2A\u89C6\u89D2\u8BC4\u5BA1\u8FD9\u4EFD\u8FC1\u79FB\u65B9\u6848' },\n      ],\n    },\n  },\n  tags: ['review', 'planning', 'decision'],\n  estimatedAgents: { min: 5, max: 6 },\n  phases: [\n    { title: 'Lenses' },\n    { title: 'Adversarial' },\n    { title: 'Synthesize' },\n  ],\n}\n\nconst READ_ONLY_TOOLS = ['read_file', 'grep', 'find', 'list_dir']\n\nconst target = args && typeof args === 'object' && args.target\n  ? String(args.target)\n  : 'No explicit target was provided. Treat the currently focused file or recent context as the target.'\n\nconst skipAdversarial = Boolean(args && typeof args === 'object' && args.skipAdversarial)\n\nconst DEFAULT_LENSES = [\n  { name: 'User', angle: 'How a real user experiences this. Friction, confusion, surprise paths, accessibility.' },\n  { name: 'Operator', angle: 'How an on-call engineer experiences this in production. Failure modes, observability, rollback.' },\n  { name: 'Skeptic', angle: 'Hidden assumptions. What is being implied but not stated. What would break under load or weird input.' },\n  { name: 'Maintainer', angle: 'Six-month-later view. Clarity, naming, layering, ease of changing nearby code.' },\n]\n\nlet lenses = DEFAULT_LENSES\nif (args && typeof args === 'object' && Array.isArray(args.lenses) && args.lenses.length) {\n  lenses = args.lenses\n    .filter((l) => l && typeof l === 'object' && l.name && l.angle)\n    .map((l) => ({ name: String(l.name), angle: String(l.angle) }))\n  if (!lenses.length) lenses = DEFAULT_LENSES\n}\n\nphase('Lenses')\nconst lensViews = await parallel(\n  lenses.map((l) => () =>\n    agent(\n      'Review the following target through the ' + l.name + ' lens.\\n' +\n        'Lens focus: ' + l.angle + '\\n\\n' +\n        'TARGET:\\n' + target + '\\n\\n' +\n        'Return 3\u20137 concrete observations. Each entry: title (5\u201310 words), why-it-matters (1 sentence), risk (low/med/high).',\n      {\n        label: l.name + ' lens',\n        toolset: READ_ONLY_TOOLS,\n        schema: {\n          type: 'object',\n          properties: {\n            observations: {\n              type: 'array',\n              items: {\n                type: 'object',\n                properties: {\n                  title: { type: 'string' },\n                  why: { type: 'string' },\n                  risk: { type: 'string', enum: ['low', 'med', 'high'] },\n                },\n                required: ['title', 'why', 'risk'],\n              },\n            },\n          },\n          required: ['observations'],\n        },\n      },\n    ),\n  ),\n)\n\nconst valid = lensViews.filter(Boolean)\nconst allObs = valid.flatMap((v, i) =>\n  (v?.observations ?? []).map((o) => ({ lens: lenses[i].name, ...o })),\n)\n\nlet verdict = null\nif (!skipAdversarial) {\n  phase('Adversarial')\n  verdict = await agent(\n    'You are an adversarial judge. Given these multi-lens observations of a target, decide which would actually cause real harm if shipped as-is. ' +\n      'Default to realRisk=false unless an observation has clear, mechanism-level evidence. ' +\n      'Rate evidenceStrength as weak | moderate | strong.\\n\\n' +\n      JSON.stringify(allObs, null, 2),\n    {\n      label: 'adversarial verdict',\n      schema: {\n        type: 'object',\n        properties: {\n          verdicts: {\n            type: 'array',\n            items: {\n              type: 'object',\n              properties: {\n                title: { type: 'string' },\n                lens: { type: 'string' },\n                realRisk: { type: 'boolean' },\n                evidenceStrength: { type: 'string', enum: ['weak', 'moderate', 'strong'] },\n                reason: { type: 'string' },\n              },\n              required: ['title', 'lens', 'realRisk', 'evidenceStrength', 'reason'],\n            },\n          },\n        },\n        required: ['verdicts'],\n      },\n    },\n  )\n}\n\nphase('Synthesize')\nconst confirmed = (verdict?.verdicts ?? []).filter((v) => v.realRisk)\nconst goNoGo = skipAdversarial\n  ? (allObs.some((o) => o.risk === 'high') ? 'fix_first' : 'ship')\n  : confirmed.some((v) => v.evidenceStrength === 'strong')\n    ? 'fix_first'\n    : confirmed.length\n      ? 'fix_first'\n      : 'ship'\n\nreturn {\n  ok: true,\n  target,\n  lenses: lenses.map((l) => l.name),\n  skipAdversarial,\n  observationCount: allObs.length,\n  confirmedRiskCount: confirmed.length,\n  goNoGo,\n  topRisks: confirmed.slice(0, 10),\n  allVerdicts: verdict?.verdicts ?? [],\n}\n";

package/dist/src/agent/workflow/builtins/multi-perspective-review.js

@@ -16,6 +16,20 @@ const MULTI_PERSPECTIVE_REVIEW_SCRIPT = `export const meta = {
   name: 'multi_perspective_review',
   description: 'Review a target from N independent perspectives, then adversarially judge what would actually break.',
   whenToUse: 'User wants a stress-test of a design, plan, PR, or proposal before committing to it.',
+  examplePrompts: [
+    { field: 'target', text: 'Stress-test this API redesign before we ship' },
+    { field: 'target', text: 'Review the migration plan from multiple angles' },
+  ],
+  i18n: {
+    zh: {
+      description: '从多个独立视角评审目标，并由对抗性评审判断实际会出什么问题。',
+      whenToUse: '用户想在落地前对设计、方案、PR 或提案做压力测试时。',
+      examplePrompts: [
+        { field: 'target', text: '上线前从多角度压力测试这个 API redesign' },
+        { field: 'target', text: '从多个视角评审这份迁移方案' },
+      ],
+    },
+  },
   tags: ['review', 'planning', 'decision'],
   estimatedAgents: { min: 5, max: 6 },
   phases: [