@mobrienv/autoloop 0.7.4 → 0.8.0

package/README.md

@@ -59,6 +59,9 @@ If Ralph is the broader experimentation surface, autoloop is the cleaner runtime
 - **Designed for agents too** -- autoloop is intentionally shaped as a surface that agents can use directly, not just a human operator CLI
 - **Dynamic chains** -- compose presets into multi-stage pipelines
 - **Persistent memory + profiles** -- loops accumulate learnings across runs and can load repo/user tuning profiles
+- **Cost budgets + stall protection** -- stop runaway loops automatically with `event_loop.max_cost_usd` (journaled token cost) and `event_loop.stall_iterations` (repeated identical outputs)
+- **Runtime budgets** -- bound wall-clock time with `event_loop.max_runtime` (whole loop) and `event_loop.max_iteration_runtime` (per iteration, for iterations that wait days on long-running workflows); both take `"3d"`/`"12h"`-style durations
+- **Finish notifications** -- run any command when a loop ends (`[notify] command = "..."`) with run metadata in env vars and a JSON payload on stdin
 
 ## What autoloop is
 
@@ -140,23 +143,34 @@ The main commands are:
 
 ```
 autoloop run <preset-name|preset-dir> [prompt...] [flags]
-autoloop list
-autoloop loops [--all]
-autoloop loops show <run-id>
-autoloop loops artifacts <run-id>
+autoloop init [--preset <name>] [dir]
+autoloop list [--json]
+autoloop loops [--all] [--json]
+autoloop loops show <run-id> [--json]
+autoloop loops artifacts <run-id> [--json]
 autoloop loops watch <run-id>
+autoloop loops health [--verbose] [--json]
 autoloop inspect <artifact> [selector] [project-dir] [--format <md|terminal|text|json|csv|graph>]
 autoloop dashboard [--port <port>]
-autoloop worktree <list|show|merge|clean> [args]
-autoloop chain <list|run> [args]
+autoloop worktree <list|show|diff|merge|clean> [args]
+autoloop chain list [project-dir]
+autoloop chain run <name> [project-dir] [prompt...] [--dry-run] [--json]
 autoloop emit <topic> [summary]
-autoloop memory <list|status|find|add|remove> [args]
+autoloop memory <list|status|find|add|remove|compact|prune> [args]
 autoloop task <add|complete|update|remove|list> [args]
 autoloop runs clean [--max-age <days>]
+autoloop stats [project-dir] [--json]
+autoloop doctor [project-dir] [--json]
+autoloop triage [project-dir] [--json]
 autoloop config <show|set|unset|path> [args]
+autoloop capabilities
+autoloop robot-docs
+autoloop --version
 ```
 
-Use `run` to start work, `loops` and `inspect` to understand what happened, and `dashboard` when you want a local operator surface.
+Use `run` to start work, `loops` and `inspect` to understand what happened, and `dashboard` when you want a local operator surface. `stats` summarizes success rates and cost per preset; `doctor` diagnoses the environment and `.autoloop` state. `triage` is the one-call status command for agents — runs, health, doctor, and recommended next commands in a single (optionally `--json`) invocation. `capabilities` prints the machine-readable CLI contract (commands, JSON surfaces, exit codes) and `robot-docs` prints a paste-ready agent handbook.
+
+Errors always go to stderr with a documented exit code (0 success, 1 user-input error, 2 environment error), and mistyped commands, subcommands, and flags get a "Did you mean" correction instead of being misinterpreted.
 
 ### Flags
 
@@ -164,7 +178,7 @@ Use `run` to start work, `loops` and `inspect` to understand what happened, and
 |------|-------------|
 | `-h`, `--help` | Show usage |
 | `-v`, `--verbose` | Debug-level logging |
-| `-b`, `--backend` | Override backend command (e.g. `-b claude`) |
+| `-b`, `--backend` | Override backend (e.g. `-b claude-sdk`, `-b pi`, `-b kiro`, or a command) |
 | `-p`, `--preset` | Resolve a named or custom preset |
 | `--chain` | Run an inline chain of comma-separated presets |
 | `--profile <spec>` | Activate a profile (`repo:<name>` or `user:<name>`), repeatable |

package/dist/testing/mock-acp-server.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * Deterministic mock ACP stdio server for autoloop integration tests.
+ *
+ * Speaks newline-delimited JSON-RPC 2.0 on stdin/stdout, implementing the
+ * minimal agent surface the autoloop ACP client exercises:
+ *
+ *   initialize          → echoes the requested protocol version
+ *   session/new         → returns a fixed session id
+ *   session/set_mode    → records the mode id
+ *   session/set_model   → records the model id
+ *   session/prompt      → requests tool permission from the client, streams an
+ *                         agent_message_chunk that reports the recorded
+ *                         mode/model/permission outcome, then ends the turn
+ *
+ * Environment knobs:
+ *   MOCK_ACP_RESPONSE    extra response text (defaults to "LOOP_COMPLETE")
+ *   MOCK_ACP_KIRO_NOISE  when "1", emits a provider-private `_kiro.dev/...`
+ *                        notification that ACP clients must filter out
+ */
+export {};

package/dist/testing/mock-acp-server.js

@@ -0,0 +1,139 @@
+#!/usr/bin/env node
+/**
+ * Deterministic mock ACP stdio server for autoloop integration tests.
+ *
+ * Speaks newline-delimited JSON-RPC 2.0 on stdin/stdout, implementing the
+ * minimal agent surface the autoloop ACP client exercises:
+ *
+ *   initialize          → echoes the requested protocol version
+ *   session/new         → returns a fixed session id
+ *   session/set_mode    → records the mode id
+ *   session/set_model   → records the model id
+ *   session/prompt      → requests tool permission from the client, streams an
+ *                         agent_message_chunk that reports the recorded
+ *                         mode/model/permission outcome, then ends the turn
+ *
+ * Environment knobs:
+ *   MOCK_ACP_RESPONSE    extra response text (defaults to "LOOP_COMPLETE")
+ *   MOCK_ACP_KIRO_NOISE  when "1", emits a provider-private `_kiro.dev/...`
+ *                        notification that ACP clients must filter out
+ */
+let modeId = "none";
+let modelId = "none";
+let nextOutboundId = 1000;
+const pendingOutbound = new Map();
+function send(message) {
+    process.stdout.write(`${JSON.stringify({ jsonrpc: "2.0", ...message })}\n`);
+}
+function respond(id, result) {
+    send({ id, result });
+}
+function notify(method, params) {
+    send({ method, params });
+}
+function request(method, params) {
+    const id = nextOutboundId++;
+    return new Promise((resolve) => {
+        pendingOutbound.set(id, resolve);
+        send({ id, method, params });
+    });
+}
+async function handlePrompt(msg) {
+    const params = msg.params;
+    const permission = (await request("session/request_permission", {
+        sessionId: params.sessionId,
+        toolCall: {
+            toolCallId: "mock-tool-1",
+            title: "mock tool",
+            kind: "execute",
+            status: "pending",
+        },
+        options: [
+            { optionId: "allow", name: "Allow always", kind: "allow_always" },
+            { optionId: "reject", name: "Reject", kind: "reject_once" },
+        ],
+    }));
+    const outcome = permission?.outcome?.outcome ?? "none";
+    const optionId = permission?.outcome?.optionId ?? "none";
+    if (process.env.MOCK_ACP_KIRO_NOISE === "1") {
+        notify("_kiro.dev/heartbeat", { noise: true });
+    }
+    const extra = process.env.MOCK_ACP_RESPONSE ?? "LOOP_COMPLETE";
+    const text = `mock-acp mode=${modeId} model=${modelId} permission=${outcome}:${optionId}\n${extra}`;
+    notify("session/update", {
+        sessionId: params.sessionId,
+        update: {
+            sessionUpdate: "agent_message_chunk",
+            content: { type: "text", text },
+        },
+    });
+    if (msg.id !== undefined)
+        respond(msg.id, { stopReason: "end_turn" });
+}
+function handleMessage(msg) {
+    // Response to one of our outbound requests (permission flow)
+    if (msg.id !== undefined && msg.method === undefined) {
+        const resolve = pendingOutbound.get(msg.id);
+        if (resolve) {
+            pendingOutbound.delete(msg.id);
+            resolve(msg.result);
+        }
+        return;
+    }
+    switch (msg.method) {
+        case "initialize": {
+            const params = msg.params;
+            if (msg.id !== undefined)
+                respond(msg.id, {
+                    protocolVersion: params?.protocolVersion ?? 1,
+                    agentCapabilities: {},
+                });
+            return;
+        }
+        case "session/new":
+            if (msg.id !== undefined)
+                respond(msg.id, { sessionId: "mock-acp-session" });
+            return;
+        case "session/set_mode": {
+            modeId = String(msg.params?.modeId ?? "none");
+            if (msg.id !== undefined)
+                respond(msg.id, {});
+            return;
+        }
+        case "session/set_model": {
+            modelId = String(msg.params?.modelId ?? "none");
+            if (msg.id !== undefined)
+                respond(msg.id, {});
+            return;
+        }
+        case "session/prompt":
+            void handlePrompt(msg);
+            return;
+        default:
+            // Unknown request → empty result; notifications (e.g. session/cancel) ignored
+            if (msg.id !== undefined)
+                respond(msg.id, {});
+            return;
+    }
+}
+let buffer = "";
+process.stdin.setEncoding("utf-8");
+process.stdin.on("data", (chunk) => {
+    buffer += chunk;
+    const lines = buffer.split("\n");
+    buffer = lines.pop() ?? "";
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            handleMessage(JSON.parse(trimmed));
+        }
+        catch {
+            /* skip malformed input */
+        }
+    }
+});
+process.stdin.on("end", () => process.exit(0));
+export {};
+//# sourceMappingURL=mock-acp-server.js.map

package/dist/testing/mock-acp-server.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mobrienv/autoloop",
-  "version": "0.7.4",
+  "version": "0.8.0",
   "license": "MIT",
   "description": "Simpler, opinionated loop harness for inspectable long-running agent workflows",
   "type": "module",
@@ -90,9 +90,9 @@
     "vitest": "^3.0.0"
   },
   "dependencies": {
-    "@mobrienv/autoloop-cli": "0.7.4",
-    "@mobrienv/autoloop-core": "0.7.4",
-    "@mobrienv/autoloop-harness": "0.7.4",
-    "@mobrienv/autoloop-presets": "0.7.4"
+    "@mobrienv/autoloop-cli": "0.8.0",
+    "@mobrienv/autoloop-core": "0.8.0",
+    "@mobrienv/autoloop-harness": "0.8.0",
+    "@mobrienv/autoloop-presets": "0.8.0"
   }
 }

package/plugins/autoloop/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "autoloop",
-  "version": "0.7.4",
+  "version": "0.8.0",
   "description": "Run and operate autoloops — start runs, monitor progress, inject guidance, manage worktrees, inspect artifacts, and clean up.",
   "homepage": "https://github.com/mikeyobrien/autoloop-ts",
   "repository": "https://github.com/mikeyobrien/autoloop-ts",

package/plugins/autoloop/skills/autoloop/SKILL.md

@@ -32,7 +32,7 @@ autoloop run --chain autocode,autoqa "objective" --worktree
 
 **When to use `--automerge`:** When the user wants hands-off operation. Appends an automerge step that squash-merges on completion.
 
-**Backend override:** Use `-b claude` or `-b pi` or `-b kiro` to switch backends.
+**Backend override:** Use `-b claude`, `-b pi`, `-b kiro`, `-b claude-agent-acp`, or `-b acp:<provider>:<command>` to switch backends.
 
 Use `run_in_background: true` on the Bash tool when starting runs so the user isn't blocked.