opencode-swarm 4.4.0 → 5.0.0

package/README.md

@@ -1,9 +1,9 @@
 <p align="center">
-  <img src="https://img.shields.io/badge/version-4.3.1-blue" alt="Version">
+  <img src="https://img.shields.io/badge/version-5.0.0-blue" alt="Version">
   <img src="https://img.shields.io/badge/license-MIT-green" alt="License">
   <img src="https://img.shields.io/badge/opencode-plugin-purple" alt="OpenCode Plugin">
   <img src="https://img.shields.io/badge/agents-8-orange" alt="Agents">
-  <img src="https://img.shields.io/badge/tests-483-brightgreen" alt="Tests">
+  <img src="https://img.shields.io/badge/tests-876-brightgreen" alt="Tests">
 </p>
 
 <h1 align="center">🐝 OpenCode Swarm</h1>
@@ -168,8 +168,11 @@ Other frameworks lose everything when the session ends. Swarm doesn't.
 
 ```
 .swarm/
-├── plan.md          # Your project roadmap
+├── plan.md          # Your project roadmap (+ plan.json)
 ├── context.md       # Everything a new Architect needs
+├── evidence/        # Per-task execution evidence
+│   ├── 1.1/         # Evidence for task 1.1
+│   └── 2.3/         # Evidence for task 2.3
 └── history/
     ├── phase-1.md   # What was done, what was learned
     └── phase-2.md
@@ -313,37 +316,62 @@ Each architect automatically delegates to its own swarm's agents.
 ## Installation
 
 ```bash
-# Add to opencode.json
-{
-  "plugin": ["opencode-swarm"]
-}
-
-# Or install via CLI
+# Install via CLI (recommended)
 bunx opencode-swarm install
 ```
 
----
-
-## What's New in v4.3.0
+### Uninstall
 
-### 🔧 Hooks Pipeline
-- **`safeHook()`** — Crash-safe wrapper for all hooks. Errors are caught and logged, never crash the plugin.
-- **`composeHandlers()`** — Compose multiple handlers for the same hook type (Plugin API allows only one handler per type).
+```bash
+# Remove from opencode.json
+bunx opencode-swarm uninstall
 
-### 📊 Context Pruning
-- **Token budget tracking** — Estimates context window usage and injects warnings at 70% and 90% thresholds.
-- **Enhanced session compaction** — Guides OpenCode's built-in compaction with plan.md phases and context.md decisions.
-- **System prompt enhancement** — Injects current phase, task, and key decisions to keep agents focused post-compaction.
+# Remove from opencode.json + clean up config files
+bunx opencode-swarm uninstall --clean
+```
 
-### ⚡ Slash Commands
-- **`/swarm status`** — Current phase, progress, and agent count.
-- **`/swarm plan [N]`** — View full plan or a specific phase.
-- **`/swarm agents`** — List all registered agents with models and permissions.
+---
 
-### 🤖 Agent Awareness
-- **Activity tracking** — Tool usage tracked per agent via `tool.execute.before/after` hooks. Activity summary flushed to context.md every 20 events.
-- **Delegation tracking** — Active agent per session tracked via `chat.message` hook. Optional delegation chain logging.
-- **Cross-agent context** — System enhancer injects relevant context from other agents' activity into system prompts.
+## What's New
+
+### v5.0.0 — Verifiable Execution
+- **Canonical plan schema** — Machine-readable `plan.json` with Zod-validated `PlanSchema`/`TaskSchema`/`PhaseSchema`. Automatic migration from legacy `plan.md` format. Structured status tracking (`pending`, `in_progress`, `completed`, `blocked`).
+- **Evidence bundles** — Per-task execution evidence persisted to `.swarm/evidence/`. Five evidence types: `review`, `test`, `diff`, `approval`, `note`. Sanitized task IDs, atomic writes, configurable size limits. `/swarm evidence` to view, `/swarm archive` to manage retention.
+- **Per-agent guardrail profiles** — Override guardrail limits for individual agents via `guardrails.profiles`. `resolveGuardrailsConfig()` merges base + profile with per-agent specificity.
+- **Context injection budget** — `max_injection_tokens` config controls how much context is injected into system prompts. Priority-ordered: phase → task → decisions → agent context. Lower-priority items dropped when budget exhausted.
+- **Enhanced `/swarm agents`** — Agent count summary, `⚡ custom limits` indicator for profiled agents, guardrail profiles section.
+- **Packaging smoke tests** — CI-safe `dist/` validation (8 tests).
+- **208 new tests** — 876 total tests across 39 files (up from 668 in v4.6.0).
+
+### v4.6.0 — Agent Guardrails
+- **Circuit breaker** — Two-layer protection against runaway agents. Soft warning at 50% of limits, hard block at 100%. Prevents infinite loops and runaway API costs.
+- **Detection signals** — Tool call count, wall-clock time, consecutive repetition, and consecutive error tracking per agent session.
+- **Configurable limits** — All thresholds tunable via `guardrails` config: `max_tool_calls`, `max_duration_minutes`, `max_repetitions`, `max_consecutive_errors`, `warning_threshold`.
+- **46 new tests** — 668 total tests across 30 files.
+
+### v4.5.0 — Tech Debt + New Commands
+- **Lint cleanup** — Replaced string concatenation with template literals, documented `as any` casts with biome-ignore comments.
+- **Code deduplication** — Extracted `stripSwarmPrefix()` utility to eliminate 3 duplicate prefix-stripping blocks.
+- **`/swarm diagnose`** — Health check for `.swarm/` files, plan structure, and plugin configuration.
+- **`/swarm export`** — Export plan.md and context.md as portable JSON.
+- **`/swarm reset --confirm`** — Clear swarm state files with safety confirmation.
+
+### v4.4.0 — DX & Quality
+- **CLI `uninstall` command** — Remove plugin with optional `--clean` flag.
+- **Custom error classes** — `SwarmError` hierarchy with actionable `guidance` messages.
+- **`/swarm history`** — View completed phases from plan.md.
+- **`/swarm config`** — View current resolved plugin configuration.
+
+### v4.3.2 — Security Hardening
+- **Path validation** — `validateSwarmPath()` prevents directory traversal in `.swarm/` file operations.
+- **Fetch hardening** — 10s timeout, 5MB limit, retry logic for gitingest tool.
+- **Config limits** — Deep merge depth limit (10), config file size limit (100KB).
+
+### v4.3.0 — Hooks & Agent Awareness
+- **Hooks pipeline** — `safeHook()` crash-safe wrapper, `composeHandlers()` for multi-handler composition.
+- **Context pruning** — Token budget tracking with 70%/90% threshold warnings.
+- **Slash commands** — `/swarm status`, `/swarm plan`, `/swarm agents`.
+- **Agent awareness** — Activity tracking, delegation tracking, cross-agent context injection.
 
 All features are opt-in via configuration. See [Installation Guide](docs/installation.md) for config options.
 
@@ -380,6 +408,23 @@ All features are opt-in via configuration. See [Installation Guide](docs/install
 
 ---
 
+## Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/swarm status` | Current phase, task progress, and agent count |
+| `/swarm plan [N]` | View full plan or filter by phase number |
+| `/swarm agents` | List all registered agents with models and permissions |
+| `/swarm history` | View completed phases with status icons |
+| `/swarm config` | View current resolved plugin configuration |
+| `/swarm diagnose` | Health check for .swarm/ files and config |
+| `/swarm export` | Export plan and context as portable JSON |
+| `/swarm reset --confirm` | Clear swarm state files (with safety gate) |
+| `/swarm evidence [task]` | View evidence bundles for a task or all tasks |
+| `/swarm archive [--dry-run]` | Archive old evidence bundles with retention policy |
+
+---
+
 ## Configuration
 
 Create `~/.config/opencode/opencode-swarm.json`:
@@ -408,6 +453,73 @@ Create `~/.config/opencode/opencode-swarm.json`:
 
 ---
 
+## Guardrails
+
+OpenCode Swarm includes a built-in circuit breaker that prevents subagents from running away — burning API credits in infinite loops, repeating the same tool call, or spinning for hours.
+
+### How It Works
+
+| Layer | Trigger | Action |
+|-------|---------|--------|
+| ⚠️ **Soft Warning** | 50% of any limit reached | Injects warning message into agent's chat stream |
+| 🛑 **Hard Block** | 100% of any limit reached | Blocks ALL further tool calls + injects stop message |
+
+### Detection Signals
+
+| Signal | Default Limit | Description |
+|--------|---------------|-------------|
+| Tool calls | 200 | Total tool invocations per agent session |
+| Duration | 30 min | Wall-clock time since delegation started |
+| Repetition | 10 | Same tool + args called consecutively |
+| Consecutive errors | 5 | Sequential null/undefined tool outputs |
+
+### Configuration
+
+Guardrails are **enabled by default**. Customize in your swarm config:
+
+```jsonc
+{
+  "guardrails": {
+    "enabled": true,              // default: true
+    "max_tool_calls": 200,        // range: 10–1000
+    "max_duration_minutes": 30,   // range: 1–120
+    "max_repetitions": 10,        // range: 3–50
+    "max_consecutive_errors": 5,  // range: 2–20
+    "warning_threshold": 0.5      // range: 0.1–0.9 (fraction of limit for soft warning)
+  }
+}
+```
+
+### Per-Agent Profiles
+
+Override limits for specific agents that need more (or less) room:
+
+```jsonc
+{
+  "guardrails": {
+    "max_tool_calls": 200,
+    "profiles": {
+      "coder": { "max_tool_calls": 500, "max_duration_minutes": 60 },
+      "explorer": { "max_tool_calls": 50 }
+    }
+  }
+}
+```
+
+Profiles merge with base config — only specified fields are overridden.
+
+### Disable Guardrails
+
+```json
+{
+  "guardrails": {
+    "enabled": false
+  }
+}
+```
+
+---
+
 ## Comparison
 
 | Feature | OpenCode Swarm | AutoGen | CrewAI | LangGraph |
@@ -448,7 +560,22 @@ bun test
 bun test tests/unit/config/schema.test.ts
 ```
 
-447 unit tests across 21 files covering config, tools, agents, hooks, commands, and state. Uses Bun's built-in test runner — zero additional test dependencies.
+876 unit tests across 39 files covering config, tools, agents, hooks, commands, state, guardrails, evidence, and plan schemas. Uses Bun's built-in test runner — zero additional test dependencies.
+
+## Troubleshooting
+
+### Plugin not loading
+1. Verify `opencode-swarm` is listed in your `opencode.json` plugins array
+2. Run `bunx opencode-swarm install` to auto-configure
+3. Run `/swarm diagnose` to check health status
+
+### Commands not working
+- Ensure you're using `/swarm <command>`, not `/swarm/<command>`
+- Run `/swarm` with no arguments to see available commands
+
+### Resuming a project
+- Swarm automatically detects `.swarm/plan.md` and resumes where you left off
+- If you get unexpected behavior, run `/swarm export` to backup, then `/swarm reset --confirm` to start fresh
 
 ---
 

package/dist/agents/index.d.ts

@@ -2,6 +2,12 @@ import type { AgentConfig as SDKAgentConfig } from '@opencode-ai/sdk';
 import { type PluginConfig } from '../config';
 import { type AgentDefinition } from './architect';
 export type { AgentDefinition } from './architect';
+/**
+ * Strip the swarm prefix from an agent name to get the base name.
+ * e.g., "local_coder" with prefix "local" → "coder"
+ * Returns the name unchanged if no prefix matches.
+ */
+export declare function stripSwarmPrefix(agentName: string, swarmPrefix?: string): string;
 /**
  * Create all agent definitions with configuration applied
  */

package/dist/commands/agents.d.ts

@@ -1,2 +1,3 @@
 import type { AgentDefinition } from '../agents';
-export declare function handleAgentsCommand(agents: Record<string, AgentDefinition>): string;
+import type { GuardrailsConfig } from '../config/schema';
+export declare function handleAgentsCommand(agents: Record<string, AgentDefinition>, guardrails?: GuardrailsConfig): string;

package/dist/commands/archive.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Handles the /swarm archive command.
+ * Archives old evidence bundles based on retention policy.
+ */
+export declare function handleArchiveCommand(directory: string, args: string[]): Promise<string>;

package/dist/commands/diagnose.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Handles the /swarm diagnose command.
+ * Performs health checks on swarm state files and configuration.
+ */
+export declare function handleDiagnoseCommand(directory: string, _args: string[]): Promise<string>;

package/dist/commands/evidence.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Handles the /swarm evidence command.
+ * Lists all evidence bundles or shows details for a specific task.
+ */
+export declare function handleEvidenceCommand(directory: string, args: string[]): Promise<string>;

package/dist/commands/export.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Handles the /swarm export command.
+ * Exports plan.md and context.md as a portable JSON object.
+ */
+export declare function handleExportCommand(directory: string, _args: string[]): Promise<string>;

package/dist/commands/index.d.ts

@@ -1,8 +1,13 @@
 import type { AgentDefinition } from '../agents';
 export { handleAgentsCommand } from './agents';
+export { handleArchiveCommand } from './archive';
 export { handleConfigCommand } from './config';
+export { handleDiagnoseCommand } from './diagnose';
+export { handleEvidenceCommand } from './evidence';
+export { handleExportCommand } from './export';
 export { handleHistoryCommand } from './history';
 export { handlePlanCommand } from './plan';
+export { handleResetCommand } from './reset';
 export { handleStatusCommand } from './status';
 /**
  * Creates a command.execute.before handler for /swarm commands.

package/dist/commands/reset.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Handles the /swarm reset command.
+ * Clears plan.md and context.md from .swarm/ directory.
+ * Requires --confirm flag as a safety gate.
+ */
+export declare function handleResetCommand(directory: string, args: string[]): Promise<string>;

package/dist/config/evidence-schema.d.ts

@@ -0,0 +1,353 @@
+import { z } from 'zod';
+export declare const EVIDENCE_MAX_JSON_BYTES: number;
+export declare const EVIDENCE_MAX_PATCH_BYTES: number;
+export declare const EVIDENCE_MAX_TASK_BYTES: number;
+export declare const EvidenceTypeSchema: z.ZodEnum<{
+    review: "review";
+    test: "test";
+    diff: "diff";
+    approval: "approval";
+    note: "note";
+}>;
+export type EvidenceType = z.infer<typeof EvidenceTypeSchema>;
+export declare const EvidenceVerdictSchema: z.ZodEnum<{
+    pass: "pass";
+    fail: "fail";
+    approved: "approved";
+    rejected: "rejected";
+    info: "info";
+}>;
+export type EvidenceVerdict = z.infer<typeof EvidenceVerdictSchema>;
+export declare const BaseEvidenceSchema: z.ZodObject<{
+    task_id: z.ZodString;
+    type: z.ZodEnum<{
+        review: "review";
+        test: "test";
+        diff: "diff";
+        approval: "approval";
+        note: "note";
+    }>;
+    timestamp: z.ZodString;
+    agent: z.ZodString;
+    verdict: z.ZodEnum<{
+        pass: "pass";
+        fail: "fail";
+        approved: "approved";
+        rejected: "rejected";
+        info: "info";
+    }>;
+    summary: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type BaseEvidence = z.infer<typeof BaseEvidenceSchema>;
+export declare const ReviewEvidenceSchema: z.ZodObject<{
+    task_id: z.ZodString;
+    timestamp: z.ZodString;
+    agent: z.ZodString;
+    verdict: z.ZodEnum<{
+        pass: "pass";
+        fail: "fail";
+        approved: "approved";
+        rejected: "rejected";
+        info: "info";
+    }>;
+    summary: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"review">;
+    risk: z.ZodEnum<{
+        medium: "medium";
+        low: "low";
+        high: "high";
+        critical: "critical";
+    }>;
+    issues: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warning: "warning";
+        }>;
+        message: z.ZodString;
+        file: z.ZodOptional<z.ZodString>;
+        line: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type ReviewEvidence = z.infer<typeof ReviewEvidenceSchema>;
+export declare const TestEvidenceSchema: z.ZodObject<{
+    task_id: z.ZodString;
+    timestamp: z.ZodString;
+    agent: z.ZodString;
+    verdict: z.ZodEnum<{
+        pass: "pass";
+        fail: "fail";
+        approved: "approved";
+        rejected: "rejected";
+        info: "info";
+    }>;
+    summary: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"test">;
+    tests_passed: z.ZodNumber;
+    tests_failed: z.ZodNumber;
+    test_file: z.ZodOptional<z.ZodString>;
+    failures: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type TestEvidence = z.infer<typeof TestEvidenceSchema>;
+export declare const DiffEvidenceSchema: z.ZodObject<{
+    task_id: z.ZodString;
+    timestamp: z.ZodString;
+    agent: z.ZodString;
+    verdict: z.ZodEnum<{
+        pass: "pass";
+        fail: "fail";
+        approved: "approved";
+        rejected: "rejected";
+        info: "info";
+    }>;
+    summary: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"diff">;
+    files_changed: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    additions: z.ZodDefault<z.ZodNumber>;
+    deletions: z.ZodDefault<z.ZodNumber>;
+    patch_path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DiffEvidence = z.infer<typeof DiffEvidenceSchema>;
+export declare const ApprovalEvidenceSchema: z.ZodObject<{
+    task_id: z.ZodString;
+    timestamp: z.ZodString;
+    agent: z.ZodString;
+    verdict: z.ZodEnum<{
+        pass: "pass";
+        fail: "fail";
+        approved: "approved";
+        rejected: "rejected";
+        info: "info";
+    }>;
+    summary: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"approval">;
+}, z.core.$strip>;
+export type ApprovalEvidence = z.infer<typeof ApprovalEvidenceSchema>;
+export declare const NoteEvidenceSchema: z.ZodObject<{
+    task_id: z.ZodString;
+    timestamp: z.ZodString;
+    agent: z.ZodString;
+    verdict: z.ZodEnum<{
+        pass: "pass";
+        fail: "fail";
+        approved: "approved";
+        rejected: "rejected";
+        info: "info";
+    }>;
+    summary: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"note">;
+}, z.core.$strip>;
+export type NoteEvidence = z.infer<typeof NoteEvidenceSchema>;
+export declare const EvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    task_id: z.ZodString;
+    timestamp: z.ZodString;
+    agent: z.ZodString;
+    verdict: z.ZodEnum<{
+        pass: "pass";
+        fail: "fail";
+        approved: "approved";
+        rejected: "rejected";
+        info: "info";
+    }>;
+    summary: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"review">;
+    risk: z.ZodEnum<{
+        medium: "medium";
+        low: "low";
+        high: "high";
+        critical: "critical";
+    }>;
+    issues: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<{
+            error: "error";
+            info: "info";
+            warning: "warning";
+        }>;
+        message: z.ZodString;
+        file: z.ZodOptional<z.ZodString>;
+        line: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    task_id: z.ZodString;
+    timestamp: z.ZodString;
+    agent: z.ZodString;
+    verdict: z.ZodEnum<{
+        pass: "pass";
+        fail: "fail";
+        approved: "approved";
+        rejected: "rejected";
+        info: "info";
+    }>;
+    summary: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"test">;
+    tests_passed: z.ZodNumber;
+    tests_failed: z.ZodNumber;
+    test_file: z.ZodOptional<z.ZodString>;
+    failures: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    task_id: z.ZodString;
+    timestamp: z.ZodString;
+    agent: z.ZodString;
+    verdict: z.ZodEnum<{
+        pass: "pass";
+        fail: "fail";
+        approved: "approved";
+        rejected: "rejected";
+        info: "info";
+    }>;
+    summary: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"diff">;
+    files_changed: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    additions: z.ZodDefault<z.ZodNumber>;
+    deletions: z.ZodDefault<z.ZodNumber>;
+    patch_path: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    task_id: z.ZodString;
+    timestamp: z.ZodString;
+    agent: z.ZodString;
+    verdict: z.ZodEnum<{
+        pass: "pass";
+        fail: "fail";
+        approved: "approved";
+        rejected: "rejected";
+        info: "info";
+    }>;
+    summary: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"approval">;
+}, z.core.$strip>, z.ZodObject<{
+    task_id: z.ZodString;
+    timestamp: z.ZodString;
+    agent: z.ZodString;
+    verdict: z.ZodEnum<{
+        pass: "pass";
+        fail: "fail";
+        approved: "approved";
+        rejected: "rejected";
+        info: "info";
+    }>;
+    summary: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    type: z.ZodLiteral<"note">;
+}, z.core.$strip>], "type">;
+export type Evidence = z.infer<typeof EvidenceSchema>;
+export declare const EvidenceBundleSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<"1.0.0">;
+    task_id: z.ZodString;
+    entries: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        task_id: z.ZodString;
+        timestamp: z.ZodString;
+        agent: z.ZodString;
+        verdict: z.ZodEnum<{
+            pass: "pass";
+            fail: "fail";
+            approved: "approved";
+            rejected: "rejected";
+            info: "info";
+        }>;
+        summary: z.ZodString;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        type: z.ZodLiteral<"review">;
+        risk: z.ZodEnum<{
+            medium: "medium";
+            low: "low";
+            high: "high";
+            critical: "critical";
+        }>;
+        issues: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            severity: z.ZodEnum<{
+                error: "error";
+                info: "info";
+                warning: "warning";
+            }>;
+            message: z.ZodString;
+            file: z.ZodOptional<z.ZodString>;
+            line: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        task_id: z.ZodString;
+        timestamp: z.ZodString;
+        agent: z.ZodString;
+        verdict: z.ZodEnum<{
+            pass: "pass";
+            fail: "fail";
+            approved: "approved";
+            rejected: "rejected";
+            info: "info";
+        }>;
+        summary: z.ZodString;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        type: z.ZodLiteral<"test">;
+        tests_passed: z.ZodNumber;
+        tests_failed: z.ZodNumber;
+        test_file: z.ZodOptional<z.ZodString>;
+        failures: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        task_id: z.ZodString;
+        timestamp: z.ZodString;
+        agent: z.ZodString;
+        verdict: z.ZodEnum<{
+            pass: "pass";
+            fail: "fail";
+            approved: "approved";
+            rejected: "rejected";
+            info: "info";
+        }>;
+        summary: z.ZodString;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        type: z.ZodLiteral<"diff">;
+        files_changed: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        additions: z.ZodDefault<z.ZodNumber>;
+        deletions: z.ZodDefault<z.ZodNumber>;
+        patch_path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        task_id: z.ZodString;
+        timestamp: z.ZodString;
+        agent: z.ZodString;
+        verdict: z.ZodEnum<{
+            pass: "pass";
+            fail: "fail";
+            approved: "approved";
+            rejected: "rejected";
+            info: "info";
+        }>;
+        summary: z.ZodString;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        type: z.ZodLiteral<"approval">;
+    }, z.core.$strip>, z.ZodObject<{
+        task_id: z.ZodString;
+        timestamp: z.ZodString;
+        agent: z.ZodString;
+        verdict: z.ZodEnum<{
+            pass: "pass";
+            fail: "fail";
+            approved: "approved";
+            rejected: "rejected";
+            info: "info";
+        }>;
+        summary: z.ZodString;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        type: z.ZodLiteral<"note">;
+    }, z.core.$strip>], "type">>>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strip>;
+export type EvidenceBundle = z.infer<typeof EvidenceBundleSchema>;

package/dist/config/index.d.ts

@@ -1,5 +1,9 @@
-export { ALL_AGENT_NAMES, ALL_SUBAGENT_NAMES, DEFAULT_MODELS, ORCHESTRATOR_NAME, PIPELINE_AGENTS, QA_AGENTS, isQAAgent, isSubagent, } from './constants';
 export type { AgentName, PipelineAgentName, QAAgentName, } from './constants';
-export { AgentOverrideConfigSchema, PluginConfigSchema, SwarmConfigSchema, } from './schema';
-export type { AgentOverrideConfig, PluginConfig, SwarmConfig, } from './schema';
+export { ALL_AGENT_NAMES, ALL_SUBAGENT_NAMES, DEFAULT_MODELS, isQAAgent, isSubagent, ORCHESTRATOR_NAME, PIPELINE_AGENTS, QA_AGENTS, } from './constants';
 export { loadAgentPrompt, loadPluginConfig, } from './loader';
+export type { MigrationStatus, Phase, PhaseStatus, Plan, Task, TaskSize, TaskStatus, } from './plan-schema';
+export { MigrationStatusSchema, PhaseSchema, PhaseStatusSchema, PlanSchema, TaskSchema, TaskSizeSchema, TaskStatusSchema, } from './plan-schema';
+export type { ApprovalEvidence, BaseEvidence, DiffEvidence, Evidence, EvidenceBundle, EvidenceType, EvidenceVerdict, NoteEvidence, ReviewEvidence, TestEvidence, } from './evidence-schema';
+export { ApprovalEvidenceSchema, BaseEvidenceSchema, DiffEvidenceSchema, EVIDENCE_MAX_JSON_BYTES, EVIDENCE_MAX_PATCH_BYTES, EVIDENCE_MAX_TASK_BYTES, EvidenceBundleSchema, EvidenceSchema, EvidenceTypeSchema, EvidenceVerdictSchema, NoteEvidenceSchema, ReviewEvidenceSchema, TestEvidenceSchema, } from './evidence-schema';
+export type { AgentOverrideConfig, PluginConfig, SwarmConfig, } from './schema';
+export { AgentOverrideConfigSchema, PluginConfigSchema, SwarmConfigSchema, } from './schema';