agents-harness 0.1.0

package/README.md

@@ -0,0 +1,317 @@
+# agent-harness
+
+A multi-agent orchestrator for autonomous software development. Three AI agents — **Planner**, **Generator**, and **Evaluator** — work together in a loop to turn your feature spec into working code.
+
+Built on the architecture described in Anthropic's engineering blog post: [**Harness Design for Long-Running Apps**](https://www.anthropic.com/engineering/harness-design-long-running-apps). The core idea: separate generation from evaluation (like a GAN), reset context between agent invocations to prevent degradation, and use file-based handoffs so each agent starts fresh.
+
+## How It Works
+
+```
+You write a spec
+     |
+     v
+ [Planner]  -----> Expands spec, breaks it into sprints, writes contracts
+     |
+     v
+ [Generator] ----> Implements the sprint contract (reads/writes/edits code)
+     |
+     v
+ [Evaluator] ----> Critically tests the implementation against the contract
+     |
+   PASS? ----yes--> Next sprint (or done)
+     |
+    no
+     |
+     v
+ [Generator] ----> Tries again with evaluator feedback
+     |
+     v
+   (loop up to max attempts)
+```
+
+Each agent gets a **fresh context** on every invocation — no accumulated confusion from long conversations. State is passed between agents via files in the `.harness/` directory, not conversation history.
+
+## Quick Start
+
+### 1. Install
+
+```bash
+npm install -g agent-harness
+```
+
+### 2. Set your API key
+
+```bash
+# Option A: Environment variable
+export ANTHROPIC_API_KEY=sk-ant-...
+
+# Option B: Global config
+agent-harness config set api-key sk-ant-...
+```
+
+### 3. Run
+
+```bash
+cd your-project
+agent-harness run "Add user authentication with email/password login and JWT tokens"
+```
+
+That's it. The harness will plan, implement, and test the feature across multiple sprints.
+
+## Commands
+
+### `run` — Start a new run
+
+```bash
+agent-harness run "<spec>"
+```
+
+Give it a feature description and it handles the rest.
+
+**Options:**
+
+| Flag | Description | Default |
+|------|-------------|---------|
+| `-s, --scope <workspaces...>` | Limit to specific workspaces (monorepo) | All |
+| `--max-attempts <n>` | Max retry attempts per sprint | 3 |
+| `--max-budget <n>` | Max total spend in USD | 50 |
+| `--dashboard` | Open a live web dashboard | Off |
+| `--port <n>` | Dashboard port | 3117 |
+
+**Examples:**
+
+```bash
+# Simple feature
+agent-harness run "Add a /health endpoint that returns 200 OK"
+
+# With budget limit
+agent-harness run "Refactor the auth module to use OAuth2" --max-budget 20
+
+# Monorepo — only touch the backend
+agent-harness run "Add pagination to the users API" --scope packages/api
+
+# With live dashboard
+agent-harness run "Build a notification system" --dashboard
+```
+
+### `init` — Initialize project config (optional)
+
+```bash
+agent-harness init
+```
+
+Creates a `.harness/` directory with:
+- `config.yaml` — agent models, budget limits, attempt limits
+- `criteria.md` — custom evaluation criteria template
+
+The harness works without `init` — it auto-detects your stack. Only run this if you want to customize settings.
+
+**Example output:**
+
+```
+Detected project:
+  Repository type: single
+  Workspace: .
+    Language: typescript
+    Framework: next.js
+    Test runner: vitest
+    Test command: npx vitest run
+  CLAUDE.md: found
+
+Created .harness/config.yaml
+Created .harness/criteria.md
+```
+
+### `status` — Check run progress
+
+```bash
+agent-harness status
+```
+
+Shows the current state of a run — which sprint you're on, pass/fail status, and cost.
+
+**Example output:**
+
+```
+Status: RUNNING
+Spec: Add user authentication with email/password login...
+Started: 2025-03-28T10:30:00.000Z
+Phase: evaluate
+Cost: $2.45 / $50.00
+
+Sprints: 2 / 3
+  [PASS] Sprint 1 — 1 attempt, $0.85
+  [....] Sprint 2 — 2 attempts, $1.60
+  [    ] Sprint 3
+```
+
+### `resume` — Resume a stopped run
+
+```bash
+agent-harness resume
+```
+
+Picks up where a stopped or failed run left off. Skips completed sprints.
+
+**Options:**
+
+| Flag | Description | Default |
+|------|-------------|---------|
+| `--max-budget <n>` | Max total spend in USD | 50 |
+| `--dashboard` | Open a live web dashboard | Off |
+| `--port <n>` | Dashboard port | 3117 |
+
+**Example:**
+
+```bash
+# Hit Ctrl+C during a run, then later:
+agent-harness resume
+
+# Resume with a higher budget
+agent-harness resume --max-budget 100
+```
+
+### `config` — Manage global settings
+
+```bash
+agent-harness config set <key> <value>
+agent-harness config get <key>
+```
+
+**Examples:**
+
+```bash
+# Save your API key globally
+agent-harness config set api-key sk-ant-api03-...
+
+# Check what's set
+agent-harness config get api-key
+```
+
+Config is stored at `~/.agent-harness/config.yaml`.
+
+## Configuration
+
+### Zero-config (default)
+
+The harness auto-detects your project:
+- **Language** — TypeScript, Python, Rust, Go
+- **Framework** — Next.js, Django, etc.
+- **Test runner** — vitest, jest, pytest, cargo test, go test
+- **Repo type** — single repo or monorepo (npm workspaces, pnpm, lerna)
+- **CLAUDE.md** — reads project conventions if present
+
+### Custom config (optional)
+
+Run `agent-harness init`, then edit `.harness/config.yaml`:
+
+```yaml
+agents:
+  planner:
+    model: sonnet
+  generator:
+    model: opus
+    maxTurns: 100
+  evaluator:
+    model: sonnet
+max_attempts_per_sprint: 3
+max_budget_per_sprint_usd: 5
+max_total_budget_usd: 50
+```
+
+**Available models:** `opus`, `sonnet`, `haiku`
+
+### Custom evaluation criteria
+
+Edit `.harness/criteria.md` to add project-specific rules:
+
+```markdown
+# Custom Evaluation Criteria
+
+- All API endpoints must return proper HTTP status codes
+- Database migrations must be reversible
+- All user-facing strings must be internationalized
+```
+
+These are checked **in addition to** the built-in defaults (correctness, testing, code quality, integration).
+
+## Live Dashboard
+
+Enable with `--dashboard` to get a real-time web UI:
+
+```bash
+agent-harness run "Build a feature" --dashboard
+# Dashboard: http://localhost:3117
+```
+
+The dashboard shows:
+- Sprint progress with pass/fail status
+- Live activity stream (every file read, edit, bash command)
+- Evaluation results with passed/failed criteria
+- Cost tracking with budget progress bar
+- Auto-reconnects if the connection drops
+
+## Programmatic API
+
+Use agent-harness as a library in your own tools:
+
+```typescript
+import { Harness } from "agent-harness";
+
+const harness = new Harness({
+  apiKey: process.env.ANTHROPIC_API_KEY!,
+  root: "/path/to/project",
+  maxTotalBudgetUsd: 20,
+});
+
+harness.on("phase:start", (data) => {
+  console.log(`Phase: ${data.phase}, Sprint: ${data.sprint}`);
+});
+
+harness.on("evaluation", (data) => {
+  console.log(`Sprint ${data.sprint}: ${data.result.passed ? "PASS" : "FAIL"}`);
+});
+
+harness.on("run:complete", (data) => {
+  console.log(`Done — ${data.status}, cost: $${data.totalCostUsd.toFixed(2)}`);
+});
+
+await harness.run("Add a REST API for managing todos");
+```
+
+### Exported classes and functions
+
+| Export | Description |
+|--------|-------------|
+| `Harness` | Main orchestrator class |
+| `ContextManager` | Wraps Agent SDK with fresh context per call |
+| `FileProtocol` | Manages `.harness/` directory state |
+| `DashboardServer` | HTTP + WebSocket dashboard server |
+| `buildProjectContext` | Auto-detect project stack and config |
+| `detectStack` | Detect language, framework, test runner |
+| `buildSystemPrompt` | Build agent system prompts |
+| `DEFAULT_CRITERIA` | Built-in evaluation criteria |
+
+## The Three Agents
+
+| Agent | Model | Role | Tools |
+|-------|-------|------|-------|
+| **Planner** | Sonnet | Writes specs, decomposes into sprints, writes contracts | Read, Write |
+| **Generator** | Opus | Implements code based on the contract | Read, Edit, Write, Bash, Glob, Grep |
+| **Evaluator** | Sonnet | Critically tests implementation against contract | Read, Bash, Grep, Glob |
+
+Key design principle from the Anthropic article: **the generator never evaluates its own work**. A separate evaluator with fresh context provides unbiased assessment.
+
+## Requirements
+
+- Node.js 18+
+- An [Anthropic API key](https://console.anthropic.com/)
+- The `@anthropic-ai/claude-agent-sdk` package (peer dependency)
+
+## Credits
+
+This project is built on the harness architecture described in Anthropic's engineering article: [**Harness Design for Long-Running Apps**](https://www.anthropic.com/engineering/harness-design-long-running-apps). The article introduces the pattern of separating generation from evaluation, using fresh context windows per agent invocation, and file-based state handoffs to enable reliable multi-hour autonomous coding sessions.
+
+## License
+
+ISC

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { runCommand } from "./commands/run.js";
+import { initCommand } from "./commands/init.js";
+import { statusCommand } from "./commands/status.js";
+import { resumeCommand } from "./commands/resume.js";
+import { configCommand } from "./commands/config.js";
+const program = new Command();
+program
+    .name("agent-harness")
+    .description("Multi-agent orchestrator for autonomous software development")
+    .version("0.1.0");
+program
+    .command("run")
+    .description("Start a new harness run with a specification")
+    .argument("<spec>", "The feature specification to implement")
+    .option("-s, --scope <workspaces...>", "Limit to specific workspaces")
+    .option("--max-attempts <n>", "Max attempts per sprint", parseInt)
+    .option("--max-budget <n>", "Max total budget in USD", parseFloat)
+    .option("--dashboard", "Enable live dashboard")
+    .option("--port <n>", "Dashboard port", parseInt)
+    .action((spec, options) => {
+    runCommand(spec, options);
+});
+program
+    .command("init")
+    .description("Initialize .harness/ config for the current project")
+    .action(() => {
+    initCommand();
+});
+program
+    .command("status")
+    .description("Show status of the current run")
+    .action(() => {
+    statusCommand();
+});
+program
+    .command("resume")
+    .description("Resume a stopped or failed run")
+    .option("--max-budget <n>", "Max total budget in USD", parseFloat)
+    .option("--dashboard", "Enable live dashboard")
+    .option("--port <n>", "Dashboard port", parseInt)
+    .action((options) => {
+    resumeCommand(options);
+});
+program
+    .command("config")
+    .description("Get or set global configuration")
+    .argument("<action>", "Action: get or set")
+    .argument("[key]", "Config key (e.g. api-key)")
+    .argument("[value]", "Value to set (for set action)")
+    .action((action, key, value) => {
+    configCommand(action, key, value);
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,eAAe,CAAC;KACrB,WAAW,CAAC,8DAA8D,CAAC;KAC3E,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,8CAA8C,CAAC;KAC3D,QAAQ,CAAC,QAAQ,EAAE,wCAAwC,CAAC;KAC5D,MAAM,CAAC,6BAA6B,EAAE,8BAA8B,CAAC;KACrE,MAAM,CAAC,oBAAoB,EAAE,yBAAyB,EAAE,QAAQ,CAAC;KACjE,MAAM,CAAC,kBAAkB,EAAE,yBAAyB,EAAE,UAAU,CAAC;KACjE,MAAM,CAAC,aAAa,EAAE,uBAAuB,CAAC;KAC9C,MAAM,CAAC,YAAY,EAAE,gBAAgB,EAAE,QAAQ,CAAC;KAChD,MAAM,CAAC,CAAC,IAAY,EAAE,OAAO,EAAE,EAAE;IAChC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,qDAAqD,CAAC;KAClE,MAAM,CAAC,GAAG,EAAE;IACX,WAAW,EAAE,CAAC;AAChB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,gCAAgC,CAAC;KAC7C,MAAM,CAAC,GAAG,EAAE;IACX,aAAa,EAAE,CAAC;AAClB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,gCAAgC,CAAC;KAC7C,MAAM,CAAC,kBAAkB,EAAE,yBAAyB,EAAE,UAAU,CAAC;KACjE,MAAM,CAAC,aAAa,EAAE,uBAAuB,CAAC;KAC9C,MAAM,CAAC,YAAY,EAAE,gBAAgB,EAAE,QAAQ,CAAC;KAChD,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;IAClB,aAAa,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,iCAAiC,CAAC;KAC9C,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAC;KAC1C,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAC;KAC9C,QAAQ,CAAC,SAAS,EAAE,+BAA+B,CAAC;KACpD,MAAM,CAAC,CAAC,MAAc,EAAE,GAAY,EAAE,KAAc,EAAE,EAAE;IACvD,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/commands/config.d.ts

@@ -0,0 +1,26 @@
+export interface GlobalConfig {
+    api_key?: string;
+    [key: string]: unknown;
+}
+/**
+ * Load global config from ~/.agent-harness/config.yaml
+ */
+export declare function loadGlobalConfig(): GlobalConfig;
+/**
+ * Save global config to ~/.agent-harness/config.yaml
+ */
+export declare function saveGlobalConfig(config: GlobalConfig): void;
+/**
+ * Resolve the API key from (in priority order):
+ * 1. ANTHROPIC_API_KEY environment variable
+ * 2. Global config file (~/.agent-harness/config.yaml)
+ */
+export declare function resolveApiKey(): string | undefined;
+/**
+ * CLI config command handler.
+ *
+ * Usage:
+ *   agent-harness config set api-key <value>
+ *   agent-harness config get api-key
+ */
+export declare function configCommand(action: string, key?: string, value?: string): void;

package/dist/commands/config.js

@@ -0,0 +1,91 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { parse as parseYaml, stringify as toYaml } from "yaml";
+function getGlobalConfigDir() {
+    return join(homedir(), ".agent-harness");
+}
+function getGlobalConfigPath() {
+    return join(getGlobalConfigDir(), "config.yaml");
+}
+/**
+ * Load global config from ~/.agent-harness/config.yaml
+ */
+export function loadGlobalConfig() {
+    if (!existsSync(getGlobalConfigPath())) {
+        return {};
+    }
+    try {
+        const content = readFileSync(getGlobalConfigPath(), "utf-8");
+        return parseYaml(content) ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Save global config to ~/.agent-harness/config.yaml
+ */
+export function saveGlobalConfig(config) {
+    mkdirSync(getGlobalConfigDir(), { recursive: true });
+    writeFileSync(getGlobalConfigPath(), toYaml(config), "utf-8");
+}
+/**
+ * Resolve the API key from (in priority order):
+ * 1. ANTHROPIC_API_KEY environment variable
+ * 2. Global config file (~/.agent-harness/config.yaml)
+ */
+export function resolveApiKey() {
+    // Check env var first
+    const envKey = process.env.ANTHROPIC_API_KEY;
+    if (envKey)
+        return envKey;
+    // Check global config
+    const config = loadGlobalConfig();
+    if (config.api_key)
+        return config.api_key;
+    return undefined;
+}
+/**
+ * CLI config command handler.
+ *
+ * Usage:
+ *   agent-harness config set api-key <value>
+ *   agent-harness config get api-key
+ */
+export function configCommand(action, key, value) {
+    // Map CLI key names to config key names
+    const keyMap = {
+        "api-key": "api_key",
+    };
+    if (action === "set") {
+        if (!key || !value) {
+            console.error("Usage: agent-harness config set <key> <value>");
+            return;
+        }
+        const configKey = keyMap[key] ?? key;
+        const config = loadGlobalConfig();
+        config[configKey] = value;
+        saveGlobalConfig(config);
+        console.log(`Set ${key} in global config.`);
+    }
+    else if (action === "get") {
+        if (!key) {
+            console.error("Usage: agent-harness config get <key>");
+            return;
+        }
+        const configKey = keyMap[key] ?? key;
+        const config = loadGlobalConfig();
+        const val = config[configKey];
+        if (val !== undefined) {
+            console.log(String(val));
+        }
+        else {
+            console.log(`${key} is not set.`);
+        }
+    }
+    else {
+        console.error(`Unknown config action: ${action}. Use "get" or "set".`);
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"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"}

package/dist/commands/init.d.ts

@@ -0,0 +1 @@
+export declare function initCommand(): void;

package/dist/commands/init.js

@@ -0,0 +1,67 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { stringify as toYaml } from "yaml";
+import { buildProjectContext } from "../discovery/project-context.js";
+export function initCommand() {
+    const root = process.cwd();
+    const harnessDir = join(root, ".harness");
+    const configPath = join(harnessDir, "config.yaml");
+    if (existsSync(configPath)) {
+        console.log(".harness/config.yaml already exists. Skipping init.");
+        return;
+    }
+    // Run project discovery
+    const ctx = buildProjectContext(root, null);
+    console.log("Detected project:");
+    console.log(`  Repository type: ${ctx.repoType}`);
+    for (const ws of ctx.workspaces) {
+        console.log(`  Workspace: ${ws.path}`);
+        console.log(`    Language: ${ws.stack.language}`);
+        if (ws.stack.framework) {
+            console.log(`    Framework: ${ws.stack.framework}`);
+        }
+        if (ws.stack.testRunner) {
+            console.log(`    Test runner: ${ws.stack.testRunner}`);
+        }
+        console.log(`    Test command: ${ws.stack.testCommand}`);
+    }
+    if (ctx.rootClaudeMd) {
+        console.log("  CLAUDE.md: found");
+    }
+    console.log("");
+    // Scaffold .harness directory
+    mkdirSync(harnessDir, { recursive: true });
+    // Build initial config from detected values
+    const config = {
+        // Agent configuration (defaults shown as comments in the YAML)
+        agents: {
+            planner: { model: "sonnet" },
+            generator: { model: "opus" },
+            evaluator: { model: "sonnet" },
+        },
+        max_attempts_per_sprint: 3,
+        max_budget_per_sprint_usd: 5,
+        max_total_budget_usd: 50,
+    };
+    writeFileSync(configPath, toYaml(config), "utf-8");
+    console.log("Created .harness/config.yaml");
+    // Create criteria.md template
+    const criteriaPath = join(harnessDir, "criteria.md");
+    if (!existsSync(criteriaPath)) {
+        const criteriaTemplate = `# Custom Evaluation Criteria
+
+Add project-specific criteria here. These are checked IN ADDITION to the default criteria.
+
+## Examples (uncomment and customize):
+# - All API endpoints must return proper HTTP status codes
+# - Database migrations must be reversible
+# - All user-facing strings must be internationalized
+# - Performance: API responses must be under 200ms
+`;
+        writeFileSync(criteriaPath, criteriaTemplate, "utf-8");
+        console.log("Created .harness/criteria.md");
+    }
+    console.log("\nDone! Edit .harness/config.yaml to customize settings.");
+    console.log("Run 'agent-harness run \"<spec>\"' to start.");
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/commands/resume.d.ts

@@ -0,0 +1,6 @@
+export interface ResumeOptions {
+    maxBudget?: number;
+    dashboard?: boolean;
+    port?: number;
+}
+export declare function resumeCommand(options: ResumeOptions): Promise<void>;

package/dist/commands/resume.js

@@ -0,0 +1,88 @@
+import { Harness } from "../core/orchestrator.js";
+import { resolveApiKey } from "./config.js";
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60)
+        return `${seconds}s`;
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    if (minutes < 60)
+        return `${minutes}m ${remainingSeconds}s`;
+    const hours = Math.floor(minutes / 60);
+    const remainingMinutes = minutes % 60;
+    return `${hours}h ${remainingMinutes}m`;
+}
+export async function resumeCommand(options) {
+    const apiKey = resolveApiKey();
+    if (!apiKey) {
+        console.error("Error: No API key found.");
+        console.error("Set ANTHROPIC_API_KEY environment variable or run: agent-harness config set api-key <key>");
+        process.exit(1);
+    }
+    const root = process.cwd();
+    console.log("Resuming agent-harness run...");
+    console.log("");
+    const harness = new Harness({
+        apiKey,
+        root,
+        maxTotalBudgetUsd: options.maxBudget,
+    });
+    // Same event listeners as run command
+    harness.on("phase:start", (data) => {
+        const sprint = data.sprint > 0 ? ` [Sprint ${data.sprint}]` : "";
+        const attempt = data.attempt > 0 ? ` (attempt ${data.attempt})` : "";
+        console.log(`\n--- ${data.phase.toUpperCase()}${sprint}${attempt} ---`);
+    });
+    harness.on("agent:activity", (data) => {
+        console.log(`  [${data.role}] ${data.summary}`);
+    });
+    harness.on("evaluation", (data) => {
+        const icon = data.result.passed ? "PASS" : "FAIL";
+        console.log(`\n  Evaluation: ${icon}`);
+        if (data.result.passedCriteria.length > 0) {
+            for (const c of data.result.passedCriteria) {
+                console.log(`    + ${c}`);
+            }
+        }
+        if (data.result.failedCriteria.length > 0) {
+            for (const c of data.result.failedCriteria) {
+                console.log(`    - ${c}`);
+            }
+        }
+        if (!data.result.passed && data.result.critique) {
+            console.log(`  Critique: ${data.result.critique.slice(0, 200)}`);
+        }
+    });
+    harness.on("cost:update", (data) => {
+        console.log(`  Cost: $${data.totalCostUsd.toFixed(2)} / $${data.budgetUsd.toFixed(2)}`);
+    });
+    harness.on("sprint:complete", (data) => {
+        const icon = data.status === "passed" ? "PASS" : "FAIL";
+        console.log(`\nSprint ${data.sprint}: ${icon} (${data.attempts} attempt${data.attempts > 1 ? "s" : ""}, $${data.costUsd.toFixed(2)})`);
+    });
+    harness.on("run:complete", (data) => {
+        console.log("\n========================================");
+        console.log(`Run ${data.status.toUpperCase()}`);
+        console.log(`Sprints: ${data.totalSprints}`);
+        console.log(`Total cost: $${data.totalCostUsd.toFixed(2)}`);
+        console.log(`Duration: ${formatDuration(data.durationMs)}`);
+        console.log("========================================");
+    });
+    // Handle SIGINT for graceful shutdown
+    const handleSignal = () => {
+        console.log("\nReceived interrupt signal. Stopping...");
+        harness.stop();
+    };
+    process.on("SIGINT", handleSignal);
+    try {
+        await harness.resume();
+    }
+    catch (error) {
+        console.error(`\nResume failed: ${error instanceof Error ? error.message : String(error)}`);
+        process.exit(1);
+    }
+    finally {
+        process.off("SIGINT", handleSignal);
+    }
+}
+//# sourceMappingURL=resume.js.map