@rcrsr/claude-code-runner 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Andre Bremer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,148 @@
+# Claude Code Runner
+
+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
+
+## Prerequisites
+
+- Node.js 18 or later
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed and authenticated
+
+## Installation
+
+```bash
+npm install -g @rcrsr/claude-code-runner
+```
+
+## Usage
+
+### prompt — Run a single prompt
+
+```bash
+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:
+
+```bash
+claude-code-runner command review-code src/auth.ts
+```
+
+This loads `.claude/commands/review-code.md` and substitutes `$1` with `src/auth.ts`.
+
+**Example template** (`.claude/commands/review-code.md`):
+
+```markdown
+Review the code in $1 for:
+
+- Security vulnerabilities
+- Performance issues
+- Code style violations
+
+Output findings as a numbered list.
+```
+
+Templates support multiple arguments (`$1`, `$2`, `$3`, etc.) and YAML frontmatter is automatically stripped.
+
+### script — Run multiple commands in sequence
+
+Create a script file with one command per line:
+
+```bash
+claude-code-runner script deploy-tasks.txt
+```
+
+**Example script** (`deploy-tasks.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
+```
+
+Scripts stop on `BLOCKED` or `ERROR` signals, letting you catch issues before continuing.
+
+### Options
+
+| Option      | Description                  |
+| ----------- | ---------------------------- |
+| `--quiet`   | Minimal output (errors only) |
+| `--normal`  | Default output level         |
+| `--verbose` | Full output with details     |
+| `--no-log`  | Disable file logging         |
+
+## Runner Signals
+
+Signals give Claude a way to control execution flow. Instruct Claude to output these signals in your prompts or templates, and the runner will respond accordingly.
+
+| Signal                   | Effect                           |
+| ------------------------ | -------------------------------- |
+| `:::RUNNER::DONE:::`     | Exit successfully                |
+| `:::RUNNER::CONTINUE:::` | Continue to next iteration       |
+| `:::RUNNER::BLOCKED:::`  | Exit with error (awaiting human) |
+| `:::RUNNER::ERROR:::`    | Exit with error                  |
+
+**Example prompt using signals:**
+
+```bash
+claude-code-runner "Fix all lint errors in src/. Output :::RUNNER::DONE::: when complete, or :::RUNNER::BLOCKED::: if you need human input."
+```
+
+**Example template with signals** (`.claude/commands/fix-tests.md`):
+
+```markdown
+Run the test suite for $1.
+
+- If all tests pass, output :::RUNNER::DONE:::
+- If tests fail and you can fix them, fix them and output :::RUNNER::CONTINUE::: to re-run
+- If tests fail and you need help, output :::RUNNER::BLOCKED::: with an explanation
+```
+
+This pattern enables self-correcting loops: Claude attempts a fix, signals `CONTINUE` to retry, and only exits when done or stuck.
+
+**Defaults:**
+
+- Max 10 iterations per command (prevents runaway loops)
+- If no signal is detected, the runner uses the CLI exit code (0 = success, non-0 = error)
+
+## Exit Codes
+
+For CI/CD integration:
+
+| Code | Meaning                                      |
+| ---- | -------------------------------------------- |
+| 0    | Success (`DONE` signal or clean exit)        |
+| 1    | Error (`ERROR`, `BLOCKED`, or non-zero exit) |
+
+## Logs
+
+Sessions are logged to `./logs/` with timestamped filenames. Disable with `--no-log`.
+
+## Development
+
+```bash
+npm run check    # Run all checks (typecheck, lint, format, test)
+npm run build    # Build the project
+npm test         # Run tests
+```
+
+## License
+
+MIT

package/dist/cli/args.d.ts

@@ -0,0 +1,20 @@
+/**
+ * CLI argument parsing
+ */
+import type { ParsedArgs } from '../types/index.js';
+/**
+ * Parse a command line into a prompt
+ * Used for script mode line parsing
+ */
+export declare function parseCommandLine(line: string): {
+    prompt: string;
+};
+/**
+ * Parse CLI arguments
+ */
+export declare function parseArgs(args: string[]): ParsedArgs;
+/**
+ * Print usage information
+ */
+export declare function printUsage(): void;
+//# sourceMappingURL=args.d.ts.map

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

@@ -0,0 +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;AAsC3B;;;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,CAwDpD;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CA0BjC"}

package/dist/cli/args.js

@@ -0,0 +1,144 @@
+/**
+ * CLI argument parsing
+ */
+import * as fs from 'fs';
+import { loadCommandTemplate } from '../templates/command.js';
+/**
+ * Extract options from raw args, returning positional args and config
+ */
+function extractOptions(args) {
+    let verbosity = 'normal';
+    let enableLog = true;
+    const positionalArgs = [];
+    for (const arg of args) {
+        switch (arg) {
+            case '--quiet':
+                verbosity = 'quiet';
+                break;
+            case '--normal':
+                verbosity = 'normal';
+                break;
+            case '--verbose':
+                verbosity = 'verbose';
+                break;
+            case '--no-log':
+                enableLog = false;
+                break;
+            default:
+                positionalArgs.push(arg);
+        }
+    }
+    return { positionalArgs, verbosity, enableLog };
+}
+/**
+ * Parse a command line into a prompt
+ * Used for script mode line parsing
+ */
+export function parseCommandLine(line) {
+    const parts = line.trim().split(/\s+/);
+    const cmd = parts[0];
+    if (cmd === 'prompt') {
+        return { prompt: parts.slice(1).join(' ') };
+    }
+    else if (cmd === 'command') {
+        const cmdName = parts[1];
+        if (!cmdName) {
+            throw new Error('command requires a name');
+        }
+        return { prompt: loadCommandTemplate(cmdName, parts.slice(2)) };
+    }
+    else if (cmd === 'script') {
+        throw new Error('script cannot be nested');
+    }
+    else {
+        // Treat as raw prompt
+        return { prompt: line.trim() };
+    }
+}
+/**
+ * Parse CLI arguments
+ */
+export function parseArgs(args) {
+    const { positionalArgs, verbosity, enableLog } = extractOptions(args);
+    const subcommand = (positionalArgs[0] ?? 'prompt');
+    let prompt = '';
+    let scriptMode = false;
+    let scriptLines = [];
+    switch (subcommand) {
+        case 'command': {
+            const commandName = positionalArgs[1];
+            if (!commandName) {
+                console.error('Error: command name required');
+                console.error('Usage: claude-code-runner command <name> [args...]');
+                process.exit(1);
+            }
+            prompt = loadCommandTemplate(commandName, positionalArgs.slice(2));
+            break;
+        }
+        case 'script': {
+            const scriptFile = positionalArgs[1];
+            if (!scriptFile) {
+                console.error('Error: script file required');
+                console.error('Usage: claude-code-runner script <file>');
+                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
+            scriptMode = true;
+            break;
+        }
+        case 'prompt':
+            prompt =
+                positionalArgs.slice(1).join(' ') || 'Tell me about this project';
+            break;
+    }
+    const config = {
+        verbosity,
+        enableLog,
+    };
+    return {
+        subcommand: scriptMode ? 'script' : subcommand,
+        prompt,
+        scriptLines,
+        scriptMode,
+        config,
+    };
+}
+/**
+ * Print usage information
+ */
+export function printUsage() {
+    console.log(`
+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>
+
+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
+
+Iteration Status Signals (output by Claude to control loop):
+  :::RUNNER::DONE:::         Exit successfully
+  :::RUNNER::CONTINUE:::     Continue to next iteration
+  :::RUNNER::BLOCKED:::      Exit with error (awaiting human intervention)
+  :::RUNNER::ERROR:::        Exit with error (something went wrong)
+
+Options:
+  --quiet      Minimal output (errors only)
+  --normal     Default output level
+  --verbose    Full output with all details
+  --no-log     Disable logging to file (enabled by default)
+`);
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+export * from './args.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,2 @@
+export * from './args.js';
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/core/index.d.ts

@@ -0,0 +1,2 @@
+export * from './runner.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,2 @@
+export * from './runner.js';
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/core/runner.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Core runner with iteration control and signal detection
+ */
+import type { FormatterState } from '../output/formatter.js';
+import type { Logger } from '../output/logger.js';
+import type { RunnerConfig, SignalResult } from '../types/runner.js';
+export interface RunnerContext {
+    config: RunnerConfig;
+    logger: Logger;
+    formatterState: FormatterState;
+    cwd: string;
+}
+/**
+ * Run a command with RUNNER signal support
+ * Handles iteration loop and signal detection
+ */
+export declare function runWithSignals(promptText: string, startTime: number, context: RunnerContext): Promise<SignalResult>;
+//# sourceMappingURL=runner.d.ts.map

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

@@ -0,0 +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,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAoGvB"}

package/dist/core/runner.js

@@ -0,0 +1,107 @@
+/**
+ * Core runner with iteration control and signal detection
+ */
+import { colors, formatDuration } 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, startTime, context) {
+    const { config, logger, formatterState, cwd } = context;
+    const { verbosity, maxIterations, parallelThresholdMs, iterationPauseMs } = config;
+    let iteration = 0;
+    // 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);
+            console.log('');
+            printSeparator();
+            console.log(`${colors.red}MAX ITERATIONS (${maxIterations})${colors.reset} | Total: ${formatDuration(totalDuration * 1000)}`);
+            printSeparator();
+            logger.log(`\nMAX ITERATIONS reached after ${maxIterations}`);
+            return 'error';
+        }
+        // Print iteration header for subsequent iterations
+        if (iteration > 1) {
+            console.log('');
+            printIterationHeader(iteration);
+            logger.log(`\n--- Iteration ${iteration} ---\n`);
+        }
+        // Run Claude
+        const { exitCode, duration, claudeText } = await spawnClaude({
+            prompt: promptText,
+            cwd,
+            verbosity,
+            logger,
+            formatterState,
+            parallelThresholdMs,
+        });
+        const status = detectRunnerSignal(claudeText);
+        const totalDuration = Math.round((Date.now() - startTime) / 1000);
+        console.log('');
+        printSeparator();
+        if (status === 'done') {
+            console.log(`${colors.green}COMPLETE${colors.reset} | Iterations: ${iteration} | Total: ${formatDuration(totalDuration * 1000)}`);
+            printSeparator();
+            logger.log(`\nCOMPLETE after ${iteration} iterations, ${totalDuration}s total`);
+            return 'ok';
+        }
+        else if (status === 'blocked') {
+            console.log(`${colors.red}BLOCKED${colors.reset} | Iterations: ${iteration} | Total: ${formatDuration(totalDuration * 1000)}`);
+            printSeparator();
+            logger.log(`\nBLOCKED after ${iteration} iterations, ${totalDuration}s total`);
+            return 'blocked';
+        }
+        else if (status === 'error') {
+            console.log(`${colors.red}ERROR${colors.reset} | Iterations: ${iteration} | Total: ${formatDuration(totalDuration * 1000)}`);
+            printSeparator();
+            logger.log(`\nERROR after ${iteration} iterations, ${totalDuration}s total`);
+            return 'error';
+        }
+        else if (status === 'continue') {
+            console.log(`${colors.yellow}CONTINUE${colors.reset} | Iteration ${iteration} done (${duration}s), continuing...`);
+            printSeparator();
+            logger.log(`Iteration ${iteration} complete, continuing...`);
+            await sleep(iterationPauseMs);
+        }
+        else {
+            // No status signal - treat as successful single run
+            const exitStatus = exitCode === 0 ? 'ok' : 'error';
+            if (iteration === 1) {
+                console.log(`Exit: ${exitCode === 0 ? colors.green : colors.red}${exitCode}${colors.reset} | Duration: ${duration}s`);
+            }
+            else {
+                console.log(`${exitCode === 0 ? colors.green + 'COMPLETE' : colors.red + 'FAILED'}${colors.reset} | Iterations: ${iteration} | Total: ${formatDuration(totalDuration * 1000)}`);
+            }
+            printSeparator();
+            logger.log(`\nCompleted after ${iteration} iteration(s), exit=${exitCode}`);
+            return exitStatus;
+        }
+    }
+}
+/**
+ * Print a separator line
+ */
+function printSeparator() {
+    console.log(`${colors.bold}════════════════════════════════════════════════════════════${colors.reset}`);
+}
+/**
+ * Print iteration header
+ */
+function printIterationHeader(iteration) {
+    console.log(`${colors.blue}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}`);
+    console.log(`${colors.blue}Iteration ${iteration}${colors.reset}`);
+    console.log(`${colors.blue}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}`);
+    console.log('');
+}
+/**
+ * Sleep for a given number of milliseconds
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=runner.js.map

package/dist/core/runner.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Claude Code Runner - executes claude CLI with proper TTY handling
+ * Shows intermediate tool calls and responses in real-time
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+/**
+ * Claude Code Runner - executes claude CLI with proper TTY handling
+ * Shows intermediate tool calls and responses in real-time
+ */
+import { parseArgs, parseCommandLine } from './cli/args.js';
+import { runWithSignals } from './core/runner.js';
+import { colors, formatDuration, truncate } from './output/colors.js';
+import { createFormatterState } from './output/formatter.js';
+import { createLogger } from './output/logger.js';
+import { DEFAULT_CONFIG } from './types/runner.js';
+async function main() {
+    const totalStart = Date.now();
+    const args = process.argv.slice(2);
+    const parsed = parseArgs(args);
+    // Merge config with defaults
+    const config = {
+        ...DEFAULT_CONFIG,
+        ...parsed.config,
+    };
+    // Create logger
+    const commandName = parsed.scriptMode
+        ? 'script'
+        : parsed.subcommand === 'command'
+            ? (args[1] ?? 'prompt')
+            : 'prompt';
+    const logger = createLogger(config.enableLog, config.logDir, commandName);
+    // Create formatter state
+    const formatterState = createFormatterState();
+    // Create runner context
+    const context = {
+        config,
+        logger,
+        formatterState,
+        cwd: process.cwd(),
+    };
+    // Print header
+    printHeader(parsed.subcommand, config.verbosity, logger.filePath);
+    logger.log(`Started: ${new Date().toISOString()}`);
+    if (parsed.scriptMode) {
+        // Script mode: run each line
+        await runScriptMode(parsed.scriptLines, context, totalStart);
+    }
+    else {
+        // Single command mode
+        await runSingleMode(parsed.prompt, context, totalStart);
+    }
+}
+/**
+ * Print runner header
+ */
+function printHeader(mode, verbosity, logFile) {
+    console.log(`${colors.bold}════════════════════════════════════════════════════════════${colors.reset}`);
+    console.log(`${colors.bold}Claude Code Runner${colors.reset} ${colors.dim}(${verbosity}, ${mode})${colors.reset}`);
+    console.log(`${colors.bold}════════════════════════════════════════════════════════════${colors.reset}`);
+    if (logFile) {
+        console.log(`${colors.dim}Log:${colors.reset} ${logFile}`);
+    }
+}
+/**
+ * Run in single command mode (prompt or command)
+ */
+async function runSingleMode(prompt, context, startTime) {
+    console.log(`${colors.dim}Prompt:${colors.reset} ${truncate(prompt, 80)}`);
+    console.log('');
+    context.logger.log(`Prompt: ${prompt}\n`);
+    const result = await runWithSignals(prompt, startTime, context);
+    context.logger.close();
+    process.exit(result === 'ok' ? 0 : 1);
+}
+/**
+ * Run in script mode
+ */
+async function runScriptMode(scriptLines, context, startTime) {
+    console.log(`${colors.dim}Script:${colors.reset} ${scriptLines.length} commands`);
+    console.log('');
+    context.logger.log(`Script: ${scriptLines.length} commands\n`);
+    for (const [i, line] of scriptLines.entries()) {
+        printScriptStep(i + 1, scriptLines.length, line);
+        context.logger.log(`\n=== [${i + 1}/${scriptLines.length}] ${line} ===\n`);
+        let result;
+        try {
+            const parsed = parseCommandLine(line);
+            result = await runWithSignals(parsed.prompt, startTime, context);
+        }
+        catch (err) {
+            console.log(`${colors.red}PARSE ERROR:${colors.reset} ${err.message}`);
+            result = 'error';
+        }
+        if (result === 'blocked' || result === 'error') {
+            const totalDuration = Math.round((Date.now() - startTime) / 1000);
+            console.log('');
+            console.log(`${colors.bold}════════════════════════════════════════════════════════════${colors.reset}`);
+            console.log(`${colors.red}SCRIPT STOPPED${colors.reset} at step ${i + 1}/${scriptLines.length} | Total: ${formatDuration(totalDuration * 1000)}`);
+            console.log(`${colors.bold}════════════════════════════════════════════════════════════${colors.reset}`);
+            context.logger.log(`\nSCRIPT STOPPED at step ${i + 1}, ${totalDuration}s total`);
+            context.logger.close();
+            process.exit(1);
+        }
+    }
+    // All commands completed
+    const totalDuration = Math.round((Date.now() - startTime) / 1000);
+    console.log('');
+    console.log(`${colors.bold}════════════════════════════════════════════════════════════${colors.reset}`);
+    console.log(`${colors.green}SCRIPT COMPLETE${colors.reset} | ${scriptLines.length} commands | Total: ${formatDuration(totalDuration * 1000)}`);
+    console.log(`${colors.bold}════════════════════════════════════════════════════════════${colors.reset}`);
+    context.logger.log(`\nSCRIPT COMPLETE, ${scriptLines.length} commands, ${totalDuration}s total`);
+    context.logger.close();
+    process.exit(0);
+}
+/**
+ * Print script step header
+ */
+function printScriptStep(current, total, line) {
+    console.log(`${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}`);
+    console.log(`${colors.cyan}[${current}/${total}]${colors.reset} ${truncate(line, 60)}`);
+    console.log(`${colors.cyan}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${colors.reset}`);
+    console.log('');
+}
+// Run main
+main().catch((err) => {
+    console.error('Fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map