@rcrsr/claude-code-runner 0.3.0 → 0.5.0

package/README.md

@@ -4,12 +4,12 @@ Deterministic, scripted, unattended Claude Code execution.
 
 ## Why Use This?
 
-- **Run unattended** — Execute Claude commands in CI/CD pipelines and automation scripts
-- **Script multiple commands** — Chain prompts together in a single run
-- **Iterative runs with fresh context per phase** — Each command starts with a clean slate, ideal for phase-based implementation plans
-- **Self-correcting loops** — Users can configure prompts with [runner signals](#runner-signals) to control execution, like retry, complete, or escalation to a human
-- **Full visibility** — Watch tool calls stream in real-time
-- **Complete logs** — Every session captured for debugging and review
+- **Walk away** — Workflows run unattended in CI/CD pipelines
+- **Chain results** — Capture output from one step, inject it into the next
+- **Claude decides** — Signals control when to retry, escalate, or finish
+- **No hitting context limits** — Fresh context per step keeps long workflows running
+- **Watch live** — See tool calls stream as they execute
+- **Replay later** — Full session logs for debugging
 
 ## Prerequisites
 
@@ -30,12 +30,6 @@ npm install -g @rcrsr/claude-code-runner
 claude-code-runner prompt "Refactor the auth module to use async/await"
 ```
 
-The `prompt` keyword is optional — bare strings work the same way:
-
-```bash
-claude-code-runner "Fix the failing tests in src/utils"
-```
-
 ### command — Run a slash command file
 
 Store prompts as markdown files in `.claude/commands/` and invoke them by name:
@@ -58,41 +52,102 @@ Review the code in $1 for:
 Output findings as a numbered list.
 ```
 
-Templates support multiple arguments (`$1`, `$2`, `$3`, etc.) and YAML frontmatter is automatically stripped.
+**Template variables:**
+
+- `$1`, `$2`, `$3`... — Positional arguments
+- `$ARGUMENTS` — All arguments joined with spaces
+
+**Frontmatter support:**
+
+```markdown
+---
+description: Review code for issues
+argument-hint: <file> [severity]
+model: sonnet
+---
+
+Review $1 with severity level $2...
+```
+
+- `argument-hint` — Defines required `<arg>` and optional `[arg]` arguments
+- `model` — Default model for this command (CLI `--model` takes precedence)
+- `description` — Command description
 
-### script — Run multiple commands in sequence
+### script — Run multi-phase workflows
 
-Create a script file with one command per line:
+Scripts chain commands where each phase builds on the previous. Output from one step can be captured and reused in subsequent steps via variable substitution.
 
 ```bash
-claude-code-runner script deploy-tasks.txt
+claude-code-runner script refactor-workflow.txt src/api/
+```
+
+**Script syntax:**
+
+| Syntax                              | Description                               |
+| ----------------------------------- | ----------------------------------------- |
+| `prompt("text")`                    | Run a prompt (supports `\n` for newlines) |
+| `prompt(<<EOF...EOF)`               | Multi-line prompt using heredoc           |
+| `command("name")`                   | Run a command template                    |
+| `command("name", ["arg1", "arg2"])` | Run command with arguments                |
+| `-> $varname`                       | Capture output into a variable            |
+| `$_`                                | Previous step's output (auto-captured)    |
+| `$varname`                          | Named captured variable                   |
+| `$1`, `$2`, `$ARGUMENTS`            | Script arguments                          |
+| `# comment`                         | Comments (ignored)                        |
+
+**Example: Variable capture and chaining** (`refactor-workflow.txt`):
+
+```text
+---
+argument-hint: <directory>
+---
+# Phase 1: Analyze - capture issues list
+prompt("Review $1 for error handling issues. List each issue with file:line.") -> $issues
+
+# Phase 2: Fix - use captured issues (no temp file needed)
+prompt(<<EOF
+Fix these issues:
+$issues
+
+For each fix, make minimal changes.
+EOF
+)
+
+# Phase 3: Verify - $_ contains previous output
+prompt("Run tests. Confirm fixes are correct. Previous output: $_")
 ```
 
-**Example script** (`deploy-tasks.txt`):
+**Example: Command with capture** (`test-and-fix.txt`):
 
 ```text
-# Comments start with #
-prompt Run the test suite and fix any failures
-command review-code src/api/handlers.ts
-prompt Update the changelog for version 2.1.0
+# Run tests, capture failures
+command("run-tests", [$1]) -> $failures
+
+# Fix any failures
+prompt("Fix these test failures:\n$failures")
+
+# Verify
+command("run-tests", [$1])
 ```
 
-Scripts stop on `BLOCKED` or `ERROR` signals, letting you catch issues before continuing.
+Scripts stop on `BLOCKED` or `ERROR` signals, catching issues before continuing to the next phase.
 
 ### Options
 
-| Option          | Description                                            |
-| --------------- | ------------------------------------------------------ |
-| `--model`, `-m` | Specify Claude model (e.g., `sonnet`, `opus`, `haiku`) |
-| `--quiet`       | Minimal output (errors only)                           |
-| `--normal`      | Default output level                                   |
-| `--verbose`     | Full output with details                               |
-| `--no-log`      | Disable file logging                                   |
+| Option            | Description                                            |
+| ----------------- | ------------------------------------------------------ |
+| `--version`, `-V` | Print version number                                   |
+| `--model`, `-m`   | Specify Claude model (e.g., `sonnet`, `opus`, `haiku`) |
+| `--quiet`         | Minimal output (errors only)                           |
+| `--normal`        | Default output level                                   |
+| `--verbose`       | Full output with details                               |
+| `--no-log`        | Disable file logging                                   |
+| `--deaddrop`      | Enable [DeadDrop](https://deaddrop.sh) streaming       |
 
 **Example with model selection:**
 
 ```bash
-claude-code-runner -m sonnet "Explain this codebase"
+claude-code-runner -m sonnet prompt "Explain this codebase"
 ```
 
 ## Runner Signals
@@ -107,23 +162,62 @@ Signals give Claude a way to control execution flow. Instruct Claude to output t
 
 No signal means success—the runner exits when Claude finishes without outputting a signal.
 
-**Example prompt using signals:**
+### Document-Driven Workflows
+
+The real power of runner signals is **checklist-based execution**. Create a document with implementation steps, and Claude works through them one at a time across multiple invocations.
+
+**Implementation plan** (`PLAN.md`):
+
+```markdown
+# Feature: User Authentication
+
+- [ ] Create `src/auth/types.ts` with User and Session interfaces
+- [ ] Implement `src/auth/session.ts` with createSession and validateSession
+- [ ] Add JWT signing in `src/auth/jwt.ts`
+- [ ] Write tests in `src/auth/__tests__/session.test.ts`
+- [ ] Update `src/index.ts` to export auth module
+```
+
+**Command template** (`.claude/commands/work-plan.md`):
+
+```markdown
+Read $1 and find the first unchecked item (- [ ]).
+
+1. Implement that single item
+2. Mark it complete by changing `- [ ]` to `- [x]`
+3. Check if any unchecked items remain:
+   - If YES: output :::RUNNER::REPEAT_STEP:::
+   - If NO: output "All tasks complete"
+
+If blocked, output :::RUNNER::BLOCKED::: with what you need.
+```
+
+**Run it:**
 
 ```bash
-claude-code-runner "Fix all lint errors in src/. Output :::RUNNER::BLOCKED::: if you need human input."
+claude-code-runner command work-plan PLAN.md
 ```
 
-**Example template with signals** (`.claude/commands/fix-tests.md`):
+Each invocation: Claude finds the next unchecked step → implements it → marks it done → signals `REPEAT_STEP`. The loop continues until all boxes are checked. The document itself becomes persistent state across runs.
+
+### Self-Correcting Loops
+
+For retry-based patterns where Claude validates its own work:
+
+```bash
+claude-code-runner "Fix all lint errors. Run the linter after each fix. Output :::RUNNER::REPEAT_STEP::: if errors remain, nothing if clean."
+```
+
+Or as a template (`.claude/commands/fix-tests.md`):
 
 ```markdown
 Run the test suite for $1.
 
-- If tests fail and you can fix them, fix them and output :::RUNNER::REPEAT_STEP::: to re-run
-- If tests fail and you need help, output :::RUNNER::BLOCKED::: with an explanation
+- If tests pass: done
+- If tests fail and fixable: fix them, output :::RUNNER::REPEAT_STEP:::
+- If tests fail and stuck: output :::RUNNER::BLOCKED::: with explanation
 ```
 
-This pattern enables self-correcting loops: Claude attempts a fix, signals `REPEAT_STEP` to retry, and exits when done or stuck.
-
 **Defaults:**
 
 - Max 10 iterations per command (prevents runaway loops)

package/dist/cli/args.d.ts

@@ -9,9 +9,6 @@ import type { ParsedArgs } from '../types/index.js';
 export declare function parseCommandLine(line: string): {
     prompt: string;
 };
-/**
- * Parse CLI arguments
- */
 export declare function parseArgs(args: string[]): ParsedArgs;
 /**
  * Print usage information

package/dist/cli/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EACV,UAAU,EAIX,MAAM,mBAAmB,CAAC;AAwC3B;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAkBjE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA8DpD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CA0BjC"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,KAAK,EACV,UAAU,EAIX,MAAM,mBAAmB,CAAC;AAkD3B;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAmBjE;AAWD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAwGpD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CA2BjC"}

package/dist/cli/args.js

@@ -1,15 +1,24 @@
 /**
  * CLI argument parsing
  */
-import * as fs from 'fs';
+import { createRequire } from 'module';
+import { loadScript } from '../script/index.js';
 import { loadCommandTemplate } from '../templates/command.js';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
 /**
  * Extract options from raw args, returning positional args and config
  */
 function extractOptions(args) {
+    // Handle --version early
+    if (args.includes('--version') || args.includes('-V')) {
+        console.log(pkg.version);
+        process.exit(0);
+    }
     let verbosity = 'normal';
     let enableLog = true;
     let model = null;
+    let deaddrop = false;
     const positionalArgs = [];
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
@@ -25,6 +34,9 @@ function extractOptions(args) {
         else if (arg === '--no-log') {
             enableLog = false;
         }
+        else if (arg === '--deaddrop') {
+            deaddrop = true;
+        }
         else if (arg === '--model' || arg === '-m') {
             model = args[++i] ?? null;
         }
@@ -35,7 +47,7 @@ function extractOptions(args) {
             positionalArgs.push(arg ?? '');
         }
     }
-    return { positionalArgs, verbosity, enableLog, model };
+    return { positionalArgs, verbosity, enableLog, model, deaddrop };
 }
 /**
  * Parse a command line into a prompt
@@ -52,7 +64,8 @@ export function parseCommandLine(line) {
         if (!cmdName) {
             throw new Error('command requires a name');
         }
-        return { prompt: loadCommandTemplate(cmdName, parts.slice(2)) };
+        const { prompt } = loadCommandTemplate(cmdName, parts.slice(2));
+        return { prompt };
     }
     else if (cmd === 'script') {
         throw new Error('script cannot be nested');
@@ -65,13 +78,33 @@ export function parseCommandLine(line) {
 /**
  * Parse CLI arguments
  */
+const VALID_SUBCOMMANDS = ['prompt', 'command', 'script'];
+function isValidSubcommand(value) {
+    return VALID_SUBCOMMANDS.includes(value);
+}
 export function parseArgs(args) {
-    const { positionalArgs, verbosity, enableLog, model } = extractOptions(args);
-    const subcommand = (positionalArgs[0] ?? 'prompt');
+    const { positionalArgs, verbosity, enableLog, model, deaddrop } = extractOptions(args);
+    const firstArg = positionalArgs[0];
+    // Validate subcommand
+    if (!firstArg) {
+        console.error('Error: subcommand required');
+        console.error('Usage: claude-code-runner <prompt|command|script> [args...]');
+        process.exit(1);
+    }
+    if (!isValidSubcommand(firstArg)) {
+        console.error(`Error: unknown subcommand '${firstArg}'`);
+        console.error('Valid subcommands: prompt, command, script');
+        console.error('Usage: claude-code-runner <prompt|command|script> [args...]');
+        process.exit(1);
+    }
+    const subcommand = firstArg;
     let prompt = '';
     let displayCommand = '';
     let scriptMode = false;
     let scriptLines = [];
+    let scriptFile = null;
+    let scriptArgs = [];
+    let frontmatterModel = null;
     switch (subcommand) {
         case 'command': {
             const commandName = positionalArgs[1];
@@ -80,40 +113,53 @@ export function parseArgs(args) {
                 console.error('Usage: claude-code-runner command <name> [args...]');
                 process.exit(1);
             }
-            prompt = loadCommandTemplate(commandName, positionalArgs.slice(2));
+            const template = loadCommandTemplate(commandName, positionalArgs.slice(2));
+            prompt = template.prompt;
+            frontmatterModel = template.frontmatter.model ?? null;
             displayCommand = positionalArgs.slice(1).join(' ');
             break;
         }
         case 'script': {
-            const scriptFile = positionalArgs[1];
-            if (!scriptFile) {
+            const file = positionalArgs[1];
+            if (!file) {
                 console.error('Error: script file required');
-                console.error('Usage: claude-code-runner script <file>');
+                console.error('Usage: claude-code-runner script <file> [args...]');
                 process.exit(1);
             }
-            if (!fs.existsSync(scriptFile)) {
-                console.error(`Error: script file not found: ${scriptFile}`);
-                process.exit(1);
-            }
-            scriptLines = fs
-                .readFileSync(scriptFile, 'utf-8')
-                .split('\n')
-                .map((l) => l.trim())
-                .filter((l) => l && !l.startsWith('#')); // Skip empty lines and comments
+            scriptFile = file;
+            scriptArgs = positionalArgs.slice(2);
+            const parsed = loadScript(file, scriptArgs);
+            // Convert parsed lines to display strings for backward compat
+            scriptLines = parsed.lines.map((line) => {
+                if (line.type === 'prompt') {
+                    const text = line.text.length > 50 ? line.text.slice(0, 50) + '...' : line.text;
+                    return `prompt("${text}")${line.capture ? ` -> $${line.capture}` : ''}`;
+                }
+                else {
+                    return `command("${line.name}")${line.capture ? ` -> $${line.capture}` : ''}`;
+                }
+            });
+            frontmatterModel = parsed.frontmatter.model ?? null;
             scriptMode = true;
-            displayCommand = `script ${scriptFile}`;
+            displayCommand = positionalArgs.slice(1).join(' ');
             break;
         }
-        case 'prompt':
-            prompt =
-                positionalArgs.slice(1).join(' ') || 'Tell me about this project';
+        case 'prompt': {
+            prompt = positionalArgs.slice(1).join(' ');
+            if (!prompt) {
+                console.error('Error: prompt text required');
+                console.error('Usage: claude-code-runner prompt <text>');
+                process.exit(1);
+            }
             displayCommand = `"${prompt}"`;
             break;
+        }
     }
     const config = {
         verbosity,
         enableLog,
-        model,
+        model: model ?? frontmatterModel,
+        deaddrop,
     };
     return {
         subcommand: scriptMode ? 'script' : subcommand,
@@ -122,6 +168,8 @@ export function parseArgs(args) {
         scriptLines,
         scriptMode,
         config,
+        scriptFile,
+        scriptArgs,
     };
 }
 /**
@@ -134,12 +182,12 @@ Claude Code Runner - executes claude CLI with proper TTY handling
 Usage:
   claude-code-runner [options] prompt <prompt>
   claude-code-runner [options] command <name> [args...]
-  claude-code-runner [options] script <file>
+  claude-code-runner [options] script <file> [args...]
 
 Subcommands:
   prompt <text>              Run with the given prompt (supports RUNNER signals)
   command <name> [args]      Load .claude/commands/<name>.md (supports RUNNER signals)
-  script <file>              Run commands from file, stop on ERROR/BLOCKED
+  script <file> [args]       Run commands from file, stop on ERROR/BLOCKED
 
 Iteration Signals (control runner execution):
   :::RUNNER::REPEAT_STEP:::  Run the same step again
@@ -152,6 +200,7 @@ Options:
   --verbose            Full output with all details
   --no-log             Disable logging to file (enabled by default)
   --model, -m <model>  Specify Claude model (e.g., sonnet, opus, haiku)
+  --deaddrop           Send messages to Deaddrop (requires DEADDROP_API_KEY env var)
 `);
 }
 //# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

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

package/dist/core/runner.d.ts

@@ -3,16 +3,20 @@
  */
 import type { FormatterState } from '../output/formatter.js';
 import type { Logger } from '../output/logger.js';
-import type { RunnerConfig, SignalResult } from '../types/runner.js';
+import type { RunnerConfig, SignalRunResult } from '../types/runner.js';
 export interface RunnerContext {
     config: RunnerConfig;
     logger: Logger;
     formatterState: FormatterState;
     cwd: string;
+    runId: string | null;
+}
+export interface StepContext {
+    stepNum: number;
 }
 /**
  * Run a command with RUNNER signal support
  * Handles iteration loop and signal detection
  */
-export declare function runWithSignals(promptText: string, displayCommand: string, startTime: number, context: RunnerContext): Promise<SignalResult>;
+export declare function runWithSignals(promptText: string, displayCommand: string, startTime: number, context: RunnerContext, step?: StepContext): Promise<SignalRunResult>;
 //# sourceMappingURL=runner.d.ts.map

package/dist/core/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/core/runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGlD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,cAAc,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAkFvB"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/core/runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAGlD,OAAO,KAAK,EACV,YAAY,EAEZ,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,cAAc,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,EACtB,IAAI,GAAE,WAA4B,GACjC,OAAO,CAAC,eAAe,CAAC,CAuF1B"}

package/dist/core/runner.js

@@ -1,26 +1,27 @@
 /**
  * Core runner with iteration control and signal detection
  */
-import { colors, formatElapsed, printRunner } from '../output/colors.js';
+import { colors, formatDuration, printRunner } from '../output/colors.js';
 import { detectRunnerSignal } from '../parsers/signals.js';
 import { spawnClaude } from '../process/pty.js';
 /**
  * Run a command with RUNNER signal support
  * Handles iteration loop and signal detection
  */
-export async function runWithSignals(promptText, displayCommand, startTime, context) {
+export async function runWithSignals(promptText, displayCommand, startTime, context, step = { stepNum: 1 }) {
     const { config, logger, formatterState, cwd } = context;
     const { verbosity, maxIterations, parallelThresholdMs, iterationPauseMs, model, } = config;
     let iteration = 0;
+    let lastClaudeText = '';
     // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- intentional infinite loop with internal exits
     while (true) {
         iteration++;
         // Check max iterations
         if (iteration > maxIterations) {
-            const totalDuration = Math.round((Date.now() - startTime) / 1000);
-            printRunner(`${colors.red}Run stopped${colors.reset} max iterations (${maxIterations}) in ${formatElapsed(totalDuration)}`);
+            const totalDuration = Date.now() - startTime;
+            printRunner(`${colors.red}Run stopped${colors.reset} max iterations (${maxIterations}) in ${formatDuration(totalDuration)}`);
             logger.log(`\nMAX ITERATIONS reached after ${maxIterations}`);
-            return 'error';
+            return { status: 'error', claudeText: lastClaudeText };
         }
         // Log iteration for subsequent iterations
         if (iteration > 1) {
@@ -28,8 +29,12 @@ export async function runWithSignals(promptText, displayCommand, startTime, cont
         }
         // Print running message
         if (verbosity !== 'quiet') {
-            printRunner(`Running step [${iteration}]: ${displayCommand}`);
+            const iterLabel = iteration > 1 ? ` (iter ${iteration})` : '';
+            const separator = displayCommand.startsWith('with ') ? ' ' : ': ';
+            printRunner(`Running step ${step.stepNum}${iterLabel}${separator}${displayCommand}`);
         }
+        // Update formatter with current step
+        formatterState.currentStep = iteration;
         // Run Claude
         const { exitCode, claudeText } = await spawnClaude({
             prompt: promptText,
@@ -40,29 +45,32 @@ export async function runWithSignals(promptText, displayCommand, startTime, cont
             parallelThresholdMs,
             model,
         });
-        const status = detectRunnerSignal(claudeText);
-        const totalDuration = Math.round((Date.now() - startTime) / 1000);
-        if (status === 'blocked') {
-            printRunner(`${colors.red}Run blocked${colors.reset} [${iteration}] steps in ${formatElapsed(totalDuration)}`);
-            logger.log(`\nBLOCKED after ${iteration} iterations, ${totalDuration}s total`);
-            return 'blocked';
+        lastClaudeText = claudeText;
+        const signal = detectRunnerSignal(claudeText);
+        const stepDuration = Date.now() - startTime;
+        if (signal === 'blocked') {
+            printRunner(`${colors.red}Blocked${colors.reset} step ${step.stepNum} in ${formatDuration(stepDuration)}`);
+            logger.log(`\nBLOCKED at step ${step.stepNum}`);
+            return { status: 'blocked', claudeText };
         }
-        else if (status === 'error') {
-            printRunner(`${colors.red}Run failed${colors.reset} [${iteration}] steps in ${formatElapsed(totalDuration)}`);
-            logger.log(`\nERROR after ${iteration} iterations, ${totalDuration}s total`);
-            return 'error';
+        else if (signal === 'error') {
+            printRunner(`${colors.red}Failed${colors.reset} step ${step.stepNum} in ${formatDuration(stepDuration)}`);
+            logger.log(`\nERROR at step ${step.stepNum}`);
+            return { status: 'error', claudeText };
         }
-        else if (status === 'repeat_step') {
-            printRunner(`Claude requested to repeat the step`);
-            logger.log(`Iteration ${iteration} complete, continuing...`);
+        else if (signal === 'repeat_step') {
+            printRunner(`Repeating step ${step.stepNum}`);
+            logger.log(`Iteration ${iteration} complete, repeating...`);
             await sleep(iterationPauseMs);
         }
         else {
-            // No status signal - treat as successful single run
+            // No signal - step completed
             const exitStatus = exitCode === 0 ? 'ok' : 'error';
-            printRunner(`${exitCode === 0 ? colors.green + 'Run completed' : colors.red + 'Run failed'}${colors.reset} [${iteration}] steps in ${formatElapsed(totalDuration)}`);
-            logger.log(`\nCompleted after ${iteration} iteration(s), exit=${exitCode}`);
-            return exitStatus;
+            if (exitCode !== 0) {
+                printRunner(`${colors.red}Failed${colors.reset} step ${step.stepNum} in ${formatDuration(stepDuration)}`);
+            }
+            logger.log(`\nStep ${step.stepNum} complete, exit=${exitCode}`);
+            return { status: exitStatus, claudeText };
         }
     }
 }

package/dist/core/runner.js.map

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

package/dist/deaddrop/client.d.ts

@@ -0,0 +1,23 @@
+/**
+ * DeadDrop client for sending messages to a Deaddrop endpoint
+ * https://deaddrop.sh
+ */
+export interface DeadDropConfig {
+    apiKey: string;
+    host: string;
+    runId: string;
+}
+export type DeadDropUser = 'Runner' | 'Claude Code';
+export interface DeadDropClient {
+    send(content: string, user: DeadDropUser): Promise<void>;
+}
+/**
+ * Create a DeadDrop client from environment variables
+ * Returns null if DEADDROP_API_KEY is not set
+ */
+export declare function createDeadDropClientFromEnv(runId: string): DeadDropClient | null;
+/**
+ * Create a DeadDrop client with the given configuration
+ */
+export declare function createDeadDropClient(config: DeadDropConfig): DeadDropClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/deaddrop/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/deaddrop/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEpD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAID;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,GACZ,cAAc,GAAG,IAAI,CAQvB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CA4B3E"}