@mobrienv/autoloop 0.1.2

package/README.md

@@ -0,0 +1,145 @@
+# autoloop
+
+Autonomous LLM loop harness and control plane for long-horizon autonomous work. Runs multi-role, event-driven loops where each iteration is handled by a specialized role (planner, builder, critic, etc.) that hands off to the next via structured events. The harness manages iteration limits, event routing, memory, and completion detection so you can focus on the prompt and preset design.
+
+External interfaces — CLI, chat, cron, future API — are thin shells that launch, observe, and report on runs. Presets are the product surface; the append-only journal is the source of truth. See [Platform Architecture](docs/platform.md) for the full model.
+
+## Prerequisites
+
+- **Node.js** >= 18 (ES2022 target)
+- **npm**
+- An LLM backend on your `$PATH` — defaults to `pi`, but any CLI that accepts a prompt argument works (e.g. `claude`)
+
+## Install from npm
+
+```bash
+npm install -g @mobrienv/autoloop
+autoloop --help
+```
+
+## Quick start
+
+```bash
+# Clone and build
+git clone <repo-url> && cd autoloop
+npm install
+npm run build
+
+# Run your first autoloop
+node bin/autoloop run autocode "Fix the login bug"
+```
+
+`autocode` is a bundled preset. The quoted string is the prompt passed to the loop. The harness iterates through roles (planner -> builder -> critic -> finalizer) until a `task.complete` event is emitted or the iteration limit is reached.
+
+## Usage
+
+```
+npx @mobrienv/autoloop run <preset> [prompt...] [flags]
+npx @mobrienv/autoloop list
+npx @mobrienv/autoloop emit <topic> [summary]
+npx @mobrienv/autoloop inspect <artifact> [selector] [--format <md|terminal|json|csv>]
+npx @mobrienv/autoloop memory <list|status|find|add|remove> [args]
+npx @mobrienv/autoloop chain <list|run> [args]
+```
+
+### Flags
+
+| Flag | Description |
+|------|-------------|
+| `-h`, `--help` | Show usage |
+| `-v`, `--verbose` | Debug-level logging |
+| `-b`, `--backend` | Override backend command (e.g. `-b claude`) |
+| `-p`, `--preset` | Resolve a named or custom preset |
+| `--chain` | Run an inline chain of comma-separated presets |
+
+### Examples
+
+```bash
+# Run a preset by name
+node bin/autoloop run autocode "Refactor the auth module"
+
+# Run from a custom preset directory
+node bin/autoloop run ./my-preset "Analyze the API"
+
+# Override the backend
+node bin/autoloop run autoqa -b claude "Review recent changes"
+
+# List available presets
+node bin/npx @mobrienv/autoloop list
+
+# Run an inline chain
+node bin/autoloop run --chain autospec,autocode "Design and build feature X"
+```
+
+## Bundled presets
+
+| Preset | Purpose |
+|--------|---------|
+| `autocode` | Plan, build, review, and commit code changes |
+| `autodoc` | Audit, write, verify, and publish documentation |
+| `autofix` | Diagnose, fix, and verify bugs |
+| `autoideas` | Scan, analyze, review, and synthesize improvement ideas |
+| `autoperf` | Profile, measure, optimize, and judge performance |
+| `autoqa` | Plan, execute, inspect, and report on QA |
+| `autoresearch` | Research strategies, implement, evaluate, and benchmark |
+| `autoreview` | Read, suggest, check, and summarize code reviews |
+| `autosec` | Scan, analyze, harden, and report on security |
+| `autosimplify` | Scope, simplify, verify, and review code for simplicity |
+| `autospec` | Research, clarify, design, plan, and critique specifications |
+| `autotest` | Survey, write, run, and assess tests |
+
+## Project structure
+
+```
+autoloop/
+├── bin/autoloop       # CLI entry point (Node.js ESM)
+├── src/                   # TypeScript source
+│   ├── main.ts            # CLI dispatch
+│   ├── harness/           # Loop engine (iteration, events, routing)
+│   ├── config.ts          # TOML config loading
+│   ├── chains.ts          # Chain orchestration
+│   ├── memory.ts          # Persistent loop memory
+│   └── usage.ts           # Help text
+├── presets/               # Bundled preset definitions
+│   └── <name>/
+│       ├── autoloops.toml # Loop config
+│       ├── topology.toml  # Role deck and handoff graph
+│       ├── harness.md     # Shared instructions
+│       └── roles/         # Per-role prompt files
+├── docs/                  # Reference documentation
+├── dist/                  # Compiled output (generated)
+└── package.json
+```
+
+## Creating custom presets
+
+A preset is a directory containing `autoloops.toml`, `topology.toml`, `harness.md`, and a `roles/` folder. See [docs/creating-presets.md](docs/creating-presets.md) for the full guide, or examine any `presets/<name>/` directory as a working example.
+
+## Running tests
+
+```bash
+npm test
+```
+
+Runs the test suite via [Vitest](https://vitest.dev/).
+
+### Mock backend
+
+A deterministic mock backend (`src/testing/mock-backend.ts`) removes the need for a live LLM backend during testing. Point it at a JSON fixture to control the output, exit code, and emitted events:
+
+```bash
+export MOCK_FIXTURE_PATH=test/fixtures/backend/complete-success.json
+node bin/autoloop run . -b "node dist/testing/mock-backend.js"
+```
+
+See [docs/cli.md](docs/cli.md#mock-backend) for fixture schema and bundled scenarios.
+
+## Further reading
+
+- [Platform architecture](docs/platform.md)
+- [Configuration reference](docs/configuration.md)
+- [Creating presets](docs/creating-presets.md)
+- [Topology and event routing](docs/topology.md)
+- [Memory system](docs/memory.md)
+- [Dynamic chains](docs/dynamic-chains.md)
+- [CLI reference](docs/cli.md)

package/bin/autoloop

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/main.js');

package/dist/backend/index.d.ts

@@ -0,0 +1,10 @@
+import type { BackendCommandContext, BackendRunResult } from "./types.js";
+export type { BackendSpec, BackendRunResult, BackendCommandContext } from "./types.js";
+export declare function normalizeBackendLabel(command: string): string;
+export declare function buildBackendShellCommand(ctx: BackendCommandContext): string;
+export declare function runBackendCommand(providerKind: string, command: string, timeoutMs: number): BackendRunResult;
+export declare function normalizeProviderKind(spec: {
+    kind: string;
+    command: string;
+    args: string[];
+}): string;

package/dist/backend/index.js

@@ -0,0 +1,59 @@
+import { basename, join } from "node:path";
+import { shellQuote } from "../utils.js";
+import { buildPiAdapterInvocation } from "./run-pi.js";
+import { buildCommandInvocation, runShellCommand } from "./run-command.js";
+import { mockBackend } from "./run-mock.js";
+export function normalizeBackendLabel(command) {
+    if (!command)
+        return "";
+    const base = basename(command);
+    if (base === "claude")
+        return "claude";
+    if (base === "pi")
+        return "pi";
+    return base || command;
+}
+export function buildBackendShellCommand(ctx) {
+    const promptPath = join(ctx.loop.paths.stateDir, "active-prompt.md");
+    const envLines = promptRuntimeEnvLines(ctx.spec, ctx.prompt, promptPath, ctx.runtimeEnv);
+    const childCommand = ctx.spec.kind === "pi"
+        ? buildPiAdapterInvocation(ctx.loop, ctx.spec)
+        : buildCommandInvocation(ctx.spec, ctx.prompt);
+    return envLines + wrapProcessInvocation(childCommand);
+}
+export function runBackendCommand(providerKind, command, timeoutMs) {
+    return runShellCommand(providerKind, command, timeoutMs);
+}
+export function normalizeProviderKind(spec) {
+    if (spec.kind === "pi")
+        return "pi";
+    if (mockBackend(spec.command, spec.args))
+        return "mock";
+    return spec.kind || "command";
+}
+function promptRuntimeEnvLines(spec, prompt, promptPath, runtimeEnv) {
+    let lines = runtimeEnv +
+        "export MINILOOPS_PROMPT_PATH=" + shellQuote(promptPath) + "\n" +
+        "printf '%s' " + shellQuote(prompt) + " > " + shellQuote(promptPath) + "\n";
+    if (spec.kind !== "pi") {
+        lines += "export MINILOOPS_PROMPT=" + shellQuote(prompt) + "\n";
+    }
+    return lines;
+}
+function wrapProcessInvocation(command) {
+    return ("autoloops_child_pid=''\n" +
+        "autoloops_cleanup() {\n" +
+        '  if [ -n "$autoloops_child_pid" ]; then\n' +
+        '    kill "$autoloops_child_pid" 2>/dev/null || true\n' +
+        '    wait "$autoloops_child_pid" 2>/dev/null || true\n' +
+        "  fi\n" +
+        "}\n" +
+        "trap 'autoloops_cleanup; exit 130' INT TERM\n" +
+        "(\n" + command + "\n) &\n" +
+        "autoloops_child_pid=$!\n" +
+        'wait "$autoloops_child_pid"\n' +
+        "autoloops_status=$?\n" +
+        "trap - INT TERM\n" +
+        'exit "$autoloops_status"\n');
+}
+//# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAM5C,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACvC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,OAAO,IAAI,IAAI,OAAO,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAA0B;IACjE,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,qBAAqB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IACzF,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI;QACzC,CAAC,CAAC,wBAAwB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC;QAC9C,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACjD,OAAO,QAAQ,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,YAAoB,EACpB,OAAe,EACf,SAAiB;IAEjB,OAAO,eAAe,CAAC,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAuD;IAC3F,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IACxD,OAAO,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC;AAChC,CAAC;AAED,SAAS,qBAAqB,CAC5B,IAAsB,EACtB,MAAc,EACd,UAAkB,EAClB,UAAkB;IAElB,IAAI,KAAK,GACP,UAAU;QACV,+BAA+B,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,IAAI;QAC/D,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,UAAU,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IAC9E,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACvB,KAAK,IAAI,0BAA0B,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAClE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAe;IAC5C,OAAO,CACL,0BAA0B;QAC1B,yBAAyB;QACzB,4CAA4C;QAC5C,uDAAuD;QACvD,uDAAuD;QACvD,QAAQ;QACR,KAAK;QACL,+CAA+C;QAC/C,KAAK,GAAG,OAAO,GAAG,SAAS;QAC3B,0BAA0B;QAC1B,+BAA+B;QAC/B,uBAAuB;QACvB,mBAAmB;QACnB,4BAA4B,CAC7B,CAAC;AACJ,CAAC"}

package/dist/backend/run-command.d.ts

@@ -0,0 +1,7 @@
+import type { BackendRunResult } from "./types.js";
+export declare function buildCommandInvocation(spec: {
+    command: string;
+    args: string[];
+    promptMode: string;
+}, prompt: string): string;
+export declare function runShellCommand(providerKind: string, command: string, timeoutMs: number): BackendRunResult;

package/dist/backend/run-command.js

@@ -0,0 +1,50 @@
+import { execSync } from "node:child_process";
+import { shellQuote, shellWords } from "../utils.js";
+export function buildCommandInvocation(spec, prompt) {
+    const argv = shellWords([spec.command, ...spec.args]);
+    if (spec.promptMode === "stdin") {
+        return "printf '%s' " + shellQuote(prompt) + " | " + argv;
+    }
+    return argv + " " + shellQuote(prompt);
+}
+export function runShellCommand(providerKind, command, timeoutMs) {
+    try {
+        const output = execSync(command, {
+            encoding: "utf-8",
+            timeout: timeoutMs,
+            stdio: ["pipe", "pipe", "inherit"],
+            shell: "/bin/sh",
+            maxBuffer: 100 * 1024 * 1024,
+        });
+        return {
+            output: output ?? "",
+            exitCode: 0,
+            timedOut: false,
+            providerKind,
+            errorCategory: "none",
+        };
+    }
+    catch (err) {
+        const e = err;
+        if (e.killed ||
+            e.signal === "SIGTERM" ||
+            e.code === "ETIMEDOUT" ||
+            e.message?.includes("ETIMEDOUT")) {
+            return {
+                output: e.stdout ?? "",
+                exitCode: 1,
+                timedOut: true,
+                providerKind,
+                errorCategory: "timeout",
+            };
+        }
+        return {
+            output: e.stdout ?? "",
+            exitCode: e.status ?? 1,
+            timedOut: false,
+            providerKind,
+            errorCategory: "non_zero_exit",
+        };
+    }
+}
+//# sourceMappingURL=run-command.js.map

package/dist/backend/run-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-command.js","sourceRoot":"","sources":["../../src/backend/run-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGrD,MAAM,UAAU,sBAAsB,CACpC,IAA6D,EAC7D,MAAc;IAEd,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,IAAI,IAAI,CAAC,UAAU,KAAK,OAAO,EAAE,CAAC;QAChC,OAAO,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,GAAG,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,YAAoB,EACpB,OAAe,EACf,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE;YAC/B,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,SAAS;YAClB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;YAClC,KAAK,EAAE,SAAS;YAChB,SAAS,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;SAC7B,CAAC,CAAC;QACH,OAAO;YACL,MAAM,EAAE,MAAM,IAAI,EAAE;YACpB,QAAQ,EAAE,CAAC;YACX,QAAQ,EAAE,KAAK;YACf,YAAY;YACZ,aAAa,EAAE,MAAM;SACtB,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,GAOT,CAAC;QACF,IACE,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,MAAM,KAAK,SAAS;YACtB,CAAC,CAAC,IAAI,KAAK,WAAW;YACtB,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,EAChC,CAAC;YACD,OAAO;gBACL,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;gBACtB,QAAQ,EAAE,CAAC;gBACX,QAAQ,EAAE,IAAI;gBACd,YAAY;gBACZ,aAAa,EAAE,SAAS;aACzB,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;YACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC;YACvB,QAAQ,EAAE,KAAK;YACf,YAAY;YACZ,aAAa,EAAE,eAAe;SAC/B,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/backend/run-mock.d.ts

@@ -0,0 +1 @@
+export declare function mockBackend(command: string, args: string[]): boolean;

package/dist/backend/run-mock.js

@@ -0,0 +1,6 @@
+export function mockBackend(command, args) {
+    if (command.includes("mock-backend"))
+        return true;
+    return args.some((arg) => arg.includes("mock-backend"));
+}
+//# sourceMappingURL=run-mock.js.map

package/dist/backend/run-mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-mock.js","sourceRoot":"","sources":["../../src/backend/run-mock.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,IAAc;IACzD,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/backend/run-pi.d.ts

@@ -0,0 +1,5 @@
+import type { LoopContext } from "../harness/types.js";
+export declare function buildPiAdapterInvocation(loop: LoopContext, spec: {
+    command: string;
+    args: string[];
+}): string;

package/dist/backend/run-pi.js

@@ -0,0 +1,5 @@
+import { shellWords } from "../utils.js";
+export function buildPiAdapterInvocation(loop, spec) {
+    return shellWords([loop.paths.piAdapterPath, spec.command, ...spec.args]);
+}
+//# sourceMappingURL=run-pi.js.map

package/dist/backend/run-pi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-pi.js","sourceRoot":"","sources":["../../src/backend/run-pi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,MAAM,UAAU,wBAAwB,CACtC,IAAiB,EACjB,IAAyC;IAEzC,OAAO,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5E,CAAC"}

package/dist/backend/types.d.ts

@@ -0,0 +1,21 @@
+import type { LoopContext } from "../harness/types.js";
+export interface BackendSpec {
+    kind: string;
+    command: string;
+    args: string[];
+    promptMode: string;
+    timeoutMs: number;
+}
+export interface BackendRunResult {
+    output: string;
+    exitCode: number;
+    timedOut: boolean;
+    providerKind: string;
+    errorCategory: "none" | "timeout" | "non_zero_exit";
+}
+export interface BackendCommandContext {
+    loop: LoopContext;
+    spec: Pick<BackendSpec, "kind" | "command" | "args" | "promptMode">;
+    prompt: string;
+    runtimeEnv: string;
+}

package/dist/backend/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/backend/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/backend/types.ts"],"names":[],"mappings":""}

package/dist/chains/budget.d.ts

@@ -0,0 +1,7 @@
+import type { Budget, ChainTracker } from "./types.js";
+export declare function defaultBudget(): Budget;
+export declare function checkBudget(budget: Budget, tracker: ChainTracker): {
+    ok: boolean;
+    reason?: string;
+};
+export declare function parseBudgetFromToml(raw: unknown): Budget;

package/dist/chains/budget.js

@@ -0,0 +1,42 @@
+export function defaultBudget() {
+    return {
+        maxDepth: 5,
+        maxSteps: 50,
+        maxRuntimeMs: 3600000,
+        maxChildren: 10,
+        maxConsecutiveFailures: 3,
+    };
+}
+export function checkBudget(budget, tracker) {
+    if (tracker.depth >= budget.maxDepth) {
+        return { ok: false, reason: `max_depth exceeded (${tracker.depth}/${budget.maxDepth})` };
+    }
+    if (tracker.totalSteps >= budget.maxSteps) {
+        return { ok: false, reason: `max_steps exceeded (${tracker.totalSteps}/${budget.maxSteps})` };
+    }
+    if (tracker.children >= budget.maxChildren) {
+        return { ok: false, reason: `max_children exceeded (${tracker.children}/${budget.maxChildren})` };
+    }
+    if (tracker.consecutiveFailures >= budget.maxConsecutiveFailures) {
+        return { ok: false, reason: `max_consecutive_failures exceeded (${tracker.consecutiveFailures}/${budget.maxConsecutiveFailures})` };
+    }
+    return { ok: true };
+}
+export function parseBudgetFromToml(raw) {
+    const budget = defaultBudget();
+    if (typeof raw !== "object" || raw === null)
+        return budget;
+    const obj = raw;
+    if (typeof obj.max_depth === "number")
+        budget.maxDepth = obj.max_depth;
+    if (typeof obj.max_steps === "number")
+        budget.maxSteps = obj.max_steps;
+    if (typeof obj.max_runtime_ms === "number")
+        budget.maxRuntimeMs = obj.max_runtime_ms;
+    if (typeof obj.max_children === "number")
+        budget.maxChildren = obj.max_children;
+    if (typeof obj.max_consecutive_failures === "number")
+        budget.maxConsecutiveFailures = obj.max_consecutive_failures;
+    return budget;
+}
+//# sourceMappingURL=budget.js.map

package/dist/chains/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/chains/budget.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa;IAC3B,OAAO;QACL,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,EAAE;QACZ,YAAY,EAAE,OAAO;QACrB,WAAW,EAAE,EAAE;QACf,sBAAsB,EAAE,CAAC;KAC1B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,MAAc,EACd,OAAqB;IAErB,IAAI,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC;IAC3F,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC1C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,QAAQ,GAAG,EAAE,CAAC;IAChG,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QAC3C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,0BAA0B,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,WAAW,GAAG,EAAE,CAAC;IACpG,CAAC;IACD,IAAI,OAAO,CAAC,mBAAmB,IAAI,MAAM,CAAC,sBAAsB,EAAE,CAAC;QACjE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,sCAAsC,OAAO,CAAC,mBAAmB,IAAI,MAAM,CAAC,sBAAsB,GAAG,EAAE,CAAC;IACtI,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,MAAM,MAAM,GAAG,aAAa,EAAE,CAAC;IAC/B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAC3D,MAAM,GAAG,GAAG,GAA8B,CAAC;IAC3C,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;QAAE,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,SAAS,CAAC;IACvE,IAAI,OAAO,GAAG,CAAC,SAAS,KAAK,QAAQ;QAAE,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,SAAS,CAAC;IACvE,IAAI,OAAO,GAAG,CAAC,cAAc,KAAK,QAAQ;QAAE,MAAM,CAAC,YAAY,GAAG,GAAG,CAAC,cAAc,CAAC;IACrF,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ;QAAE,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,YAAY,CAAC;IAChF,IAAI,OAAO,GAAG,CAAC,wBAAwB,KAAK,QAAQ;QAAE,MAAM,CAAC,sBAAsB,GAAG,GAAG,CAAC,wBAAwB,CAAC;IACnH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/chains/load.d.ts

@@ -0,0 +1,12 @@
+import type { ChainSpec, ChainsConfig, Budget } from "./types.js";
+export declare function load(projectDir: string): ChainsConfig;
+export declare function resolveChain(chains: ChainsConfig, name: string): ChainSpec | null;
+export declare function listChains(chains: ChainsConfig): ChainSpec[];
+export declare function parseInlineChain(csvSteps: string, projectDir: string): ChainSpec;
+export declare function loadBudget(projectDir: string): Budget;
+export declare function resolvePresetDir(name: string, projectDir: string): string;
+export declare function listKnownPresets(): string[];
+export declare function validatePresetVocabulary(steps: string[], projectDir: string): {
+    ok: boolean;
+    reason?: string;
+};

package/dist/chains/load.js

@@ -0,0 +1,80 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import TOML from "@iarna/toml";
+import * as config from "../config.js";
+import { parseStringList } from "../utils.js";
+import { defaultBudget, parseBudgetFromToml } from "./budget.js";
+export function load(projectDir) {
+    const path = join(projectDir, "chains.toml");
+    if (!existsSync(path))
+        return { chains: [], budget: defaultBudget() };
+    return loadExisting(path, projectDir);
+}
+export function resolveChain(chains, name) {
+    return chains.chains.find((c) => c.name === name) ?? null;
+}
+export function listChains(chains) {
+    return chains.chains;
+}
+export function parseInlineChain(csvSteps, projectDir) {
+    const stepNames = parseStringList(csvSteps);
+    return {
+        name: "inline",
+        steps: resolveSteps(stepNames, projectDir),
+    };
+}
+export function loadBudget(projectDir) {
+    const path = join(projectDir, "chains.toml");
+    if (!existsSync(path))
+        return defaultBudget();
+    const parsed = TOML.parse(readFileSync(path, "utf-8"));
+    return parseBudgetFromToml(parsed.budget);
+}
+export function resolvePresetDir(name, projectDir) {
+    const candidate = join(projectDir, "presets/" + name);
+    if (existsSync(candidate))
+        return candidate;
+    const cwdCandidate = join(".", "presets/" + name);
+    if (existsSync(cwdCandidate))
+        return cwdCandidate;
+    return name;
+}
+export function listKnownPresets() {
+    return [
+        "autocode", "autosimplify", "autoideas", "autoresearch",
+        "autoqa", "autotest", "autofix", "autoreview",
+        "autodoc", "autosec", "autoperf", "autospec",
+    ];
+}
+export function validatePresetVocabulary(steps, projectDir) {
+    const known = listKnownPresets();
+    for (const name of steps) {
+        if (!known.includes(name) && !config.projectHasConfig(resolvePresetDir(name, projectDir))) {
+            return { ok: false, reason: "unknown preset: " + name };
+        }
+    }
+    return { ok: true };
+}
+function loadExisting(path, projectDir) {
+    const text = readFileSync(path, "utf-8");
+    const parsed = TOML.parse(text);
+    return parseChainsFromToml(parsed, projectDir);
+}
+function parseChainsFromToml(parsed, projectDir) {
+    const rawChains = (parsed.chain ?? []);
+    const chains = rawChains
+        .filter((c) => typeof c.name === "string" && c.name !== "")
+        .map((c) => ({
+        name: c.name,
+        steps: resolveSteps(c.steps ?? [], projectDir),
+    }));
+    const budget = parseBudgetFromToml(parsed.budget);
+    return { chains, budget };
+}
+function resolveSteps(stepNames, projectDir) {
+    return stepNames.map((name) => ({
+        name,
+        presetDir: resolvePresetDir(name, projectDir),
+    }));
+}
+//# sourceMappingURL=load.js.map

package/dist/chains/load.js.map

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

package/dist/chains/render.d.ts

@@ -0,0 +1,2 @@
+export declare function renderChainState(projectDir: string): string;
+export declare function renderChainLines(lines: string[]): string;

package/dist/chains/render.js

@@ -0,0 +1,46 @@
+import { extractTopic, extractField, readLines } from "../harness/journal.js";
+import * as config from "../config.js";
+export function renderChainState(projectDir) {
+    const journalFile = config.resolveJournalFile(projectDir);
+    const lines = readLines(journalFile);
+    return renderChainLines(lines);
+}
+export function renderChainLines(lines) {
+    const entries = [];
+    for (const line of lines) {
+        const topic = extractTopic(line);
+        if (isChainTopic(topic)) {
+            entries.push({ topic, line });
+        }
+    }
+    if (entries.length === 0)
+        return "(no chain runs found)";
+    let result = "# Chain State\n\n";
+    for (const entry of entries) {
+        result += renderChainEntry(entry.topic, entry.line);
+    }
+    return result;
+}
+function isChainTopic(topic) {
+    return [
+        "chain.start", "chain.step.start", "chain.step.finish",
+        "chain.complete", "chain.spawn",
+    ].includes(topic);
+}
+function renderChainEntry(topic, line) {
+    switch (topic) {
+        case "chain.start":
+            return "## Chain: " + extractField(line, "name") + "\n" + "Steps: " + extractField(line, "steps") + "\n\n";
+        case "chain.step.start":
+            return "- Step " + extractField(line, "step") + " (" + extractField(line, "preset") + ") started\n";
+        case "chain.step.finish":
+            return "- Step " + extractField(line, "step") + " (" + extractField(line, "preset") + ") finished: " + extractField(line, "stop_reason") + "\n";
+        case "chain.complete":
+            return "\nOutcome: " + extractField(line, "outcome") + " (" + extractField(line, "steps_completed") + " steps completed)\n\n";
+        case "chain.spawn":
+            return "- Spawned: " + extractField(line, "chain_id") + " (parent: " + extractField(line, "parent_id") + ", steps: " + extractField(line, "steps") + ")\n";
+        default:
+            return "";
+    }
+}
+//# sourceMappingURL=render.js.map

package/dist/chains/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/chains/render.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AAEvC,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,MAAM,WAAW,GAAG,MAAM,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IACrC,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAe;IAC9C,MAAM,OAAO,GAA2C,EAAE,CAAC;IAC3D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,uBAAuB,CAAC;IACzD,IAAI,MAAM,GAAG,mBAAmB,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,gBAAgB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO;QACL,aAAa,EAAE,kBAAkB,EAAE,mBAAmB;QACtD,gBAAgB,EAAE,aAAa;KAChC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa,EAAE,IAAY;IACnD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,aAAa;YAChB,OAAO,YAAY,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;QAC7G,KAAK,kBAAkB;YACrB,OAAO,SAAS,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,aAAa,CAAC;QACtG,KAAK,mBAAmB;YACtB,OAAO,SAAS,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,cAAc,GAAG,YAAY,CAAC,IAAI,EAAE,aAAa,CAAC,GAAG,IAAI,CAAC;QAClJ,KAAK,gBAAgB;YACnB,OAAO,aAAa,GAAG,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,iBAAiB,CAAC,GAAG,uBAAuB,CAAC;QAChI,KAAK,aAAa;YAChB,OAAO,aAAa,GAAG,YAAY,CAAC,IAAI,EAAE,UAAU,CAAC,GAAG,YAAY,GAAG,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,WAAW,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC;QAC7J;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/chains/run.d.ts

@@ -0,0 +1,17 @@
+import * as harness from "../harness/index.js";
+import type { ChainSpec, DynamicChainSpec, StepRecord } from "./types.js";
+export declare function runChain(chainSpec: ChainSpec, projectDir: string, selfCommand: string, runOptions: harness.RunOptions): {
+    completed: StepRecord[];
+    outcome: string;
+    failedStep?: number;
+    failedReason?: string;
+};
+export declare function spawnDynamicChain(spec: DynamicChainSpec, projectDir: string, selfCommand: string, runOptions: harness.RunOptions, parentId: string): {
+    outcome: string;
+    reason?: string;
+    chainId?: string;
+    completed?: StepRecord[];
+    failedStep?: number;
+    failedReason?: string;
+};
+export declare function writeDynamicSpec(projectDir: string, spec: DynamicChainSpec): string;