@mobrienv/autoloop 0.7.4 → 0.9.1

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 |
@@ -219,6 +233,7 @@ Bundled presets give you opinionated starting points for common workflows like c
 | `autospec` | Research, clarify, design, plan, and critique specifications |
 | `automerge` | Merge a completed worktree branch back into its base branch |
 | `autopr` | Turn the current branch into a reviewable pull request |
+| `autowiki` | Ingest a queue of source URLs into an OKF-conformant LLM wiki of cross-linked concept pages |
 
 ## Creating custom presets
 

package/dist/index.d.ts

@@ -3,4 +3,5 @@ export { type Config, defaults as configDefaults, get as configGet, getInt as co
 export { emit, run, runParallelBranchCli } from "@mobrienv/autoloop-harness";
 export type { EmitResult } from "@mobrienv/autoloop-harness/emit";
 export type { LoopEvent, LoopEventEmitter, } from "@mobrienv/autoloop-harness/events";
-export type { LoopContext, RunOptions, RunSummary, TriggerSource, Verdict, VerdictKind, } from "@mobrienv/autoloop-harness/types";
+export type { LoopContext, RunOptions, RunSummary, StopReason, TriggerSource, Verdict, VerdictKind, } from "@mobrienv/autoloop-harness/types";
+export { STOP_REASONS } from "@mobrienv/autoloop-harness/types";

package/dist/index.js

@@ -16,4 +16,5 @@ export { loadProject as loadProjectConfig } from "@mobrienv/autoloop-core/config
 // without re-implementing the schema layer.
 export { defaults as configDefaults, get as configGet, getInt as configGetInt, getList as configGetList, parseToml as parseConfigToml, } from "@mobrienv/autoloop-core/config-schema";
 export { emit, run, runParallelBranchCli } from "@mobrienv/autoloop-harness";
+export { STOP_REASONS } from "@mobrienv/autoloop-harness/types";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,2EAA2E;AAC3E,EAAE;AACF,SAAS;AACT,8DAA8D;AAC9D,EAAE;AACF,gEAAgE;AAChE,iCAAiC;AACjC,sDAAsD;AACtD,QAAQ;AAER,OAAO,EAAE,WAAW,IAAI,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAClF,uEAAuE;AACvE,4CAA4C;AAC5C,OAAO,EAEL,QAAQ,IAAI,cAAc,EAC1B,GAAG,IAAI,SAAS,EAChB,MAAM,IAAI,YAAY,EACtB,OAAO,IAAI,aAAa,EAExB,SAAS,IAAI,eAAe,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,2EAA2E;AAC3E,EAAE;AACF,SAAS;AACT,8DAA8D;AAC9D,EAAE;AACF,gEAAgE;AAChE,iCAAiC;AACjC,sDAAsD;AACtD,QAAQ;AAER,OAAO,EAAE,WAAW,IAAI,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAClF,uEAAuE;AACvE,4CAA4C;AAC5C,OAAO,EAEL,QAAQ,IAAI,cAAc,EAC1B,GAAG,IAAI,SAAS,EAChB,MAAM,IAAI,YAAY,EACtB,OAAO,IAAI,aAAa,EAExB,SAAS,IAAI,eAAe,GAC7B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAe7E,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC"}

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/dist/testing/mock-backend.js

@@ -9,7 +9,7 @@
  * or accepts a fixture path as the first positional argument.
  */
 import { execFileSync } from "node:child_process";
-import { readFileSync } from "node:fs";
+import { readFileSync, writeFileSync } from "node:fs";
 import { createRequire } from "node:module";
 function fixturePathFromArgs() {
     return process.argv[2] ?? "";
@@ -29,6 +29,8 @@ function loadFixture() {
             delay_ms: parsed.delay_ms ?? 0,
             emit_event: parsed.emit_event,
             emit_payload: parsed.emit_payload,
+            usage: parsed.usage,
+            trap_usr1: parsed.trap_usr1 ?? false,
         };
     }
     catch (err) {
@@ -56,6 +58,12 @@ function sleep(ms) {
 }
 async function main() {
     const fixture = loadFixture();
+    if (fixture.trap_usr1) {
+        process.on("SIGUSR1", () => {
+            process.stdout.write("mock-backend: interrupted by SIGUSR1\n");
+            process.exit(130);
+        });
+    }
     if (fixture.delay_ms > 0) {
         await sleep(fixture.delay_ms);
     }
@@ -65,6 +73,12 @@ async function main() {
     if (fixture.output) {
         process.stdout.write(fixture.output);
     }
+    if (fixture.usage) {
+        const usageFile = process.env.AUTOLOOP_USAGE_FILE;
+        if (usageFile) {
+            writeFileSync(usageFile, JSON.stringify(fixture.usage));
+        }
+    }
     process.exitCode = fixture.exit_code;
 }
 main().catch((err) => {

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

@@ -1 +1 @@
-{"version":3,"file":"mock-backend.js","sourceRoot":"","sources":["../../src/testing/mock-backend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mock-backend.js","sourceRoot":"","sources":["../../src/testing/mock-backend.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAsB5C,SAAS,mBAAmB;IAC1B,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC/B,CAAC;AAED,SAAS,WAAW;IAClB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,mBAAmB,EAAE,CAAC;IAC3E,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,8FAA8F,CAC/F,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqB,CAAC;QACnD,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;YAC3B,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,CAAC;YAChC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC;YAC9B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,KAAK;SACrC,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,GAAG,IAAI,CAAC,CAAC;QACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,OAAe;IAC/C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAE5D,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE;YAClE,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC;YAClC,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,GAAG,IAAI,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;IAE9B,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;YAC/D,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;QAClD,IAAI,SAAS,EAAE,CAAC;YACd,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;AACvC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,GAAG,IAAI,CAAC,CAAC;IACjE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mobrienv/autoloop",
-  "version": "0.7.4",
+  "version": "0.9.1",
   "license": "MIT",
   "description": "Simpler, opinionated loop harness for inspectable long-running agent workflows",
   "type": "module",
@@ -32,7 +32,10 @@
     "packages/harness",
     "packages/dashboard",
     "packages/kanban",
-    "packages/cli"
+    "packages/cli",
+    "packages/issue-sync-core",
+    "packages/gh-sync",
+    "packages/linear-sync"
   ],
   "repository": {
     "type": "git",
@@ -62,7 +65,7 @@
     "format": "biome format src/ test/",
     "format:fix": "biome format --write src/ test/",
     "test": "node --experimental-vm-modules node_modules/.bin/vitest run",
-    "test:coverage": "node --experimental-vm-modules node_modules/.bin/vitest run --coverage",
+    "test:coverage": "node --experimental-vm-modules node_modules/.bin/vitest run --no-file-parallelism --coverage",
     "test:watch": "node --experimental-vm-modules node_modules/.bin/vitest",
     "check": "biome check src/ test/ && tsc --noEmit && npm run test:coverage",
     "release": "node bin/release",
@@ -90,9 +93,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.9.1",
+    "@mobrienv/autoloop-core": "0.9.1",
+    "@mobrienv/autoloop-harness": "0.9.1",
+    "@mobrienv/autoloop-presets": "0.9.1"
   }
 }

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

@@ -1,9 +1,9 @@
 {
   "name": "autoloop",
-  "version": "0.7.4",
+  "version": "0.9.1",
   "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",
+  "homepage": "https://github.com/mikeyobrien/autoloop",
+  "repository": "https://github.com/mikeyobrien/autoloop",
   "license": "MIT",
   "keywords": ["autoloop", "ai-agents", "autonomous", "coding"]
 }

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

@@ -1,7 +1,7 @@
 ---
 name: autoloop
 description: Run and operate autoloops — start runs, monitor progress, inject guidance, manage worktrees, inspect artifacts, and clean up. Use when the user asks to run an autoloop, check loop status, merge/clean worktrees, or operate on runs.
-argument-hint: [run|status|guide|merge|clean|inspect] [args...]
+argument-hint: "[run|status|guide|merge|clean|inspect] [args...]"
 ---
 
 # Autoloop Operations
@@ -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.
 

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

@@ -0,0 +1,118 @@
+---
+name: autoloop-acp
+description: Drive autoloop over the Agent Client Protocol (ACP) — connect an external editor, harness, or agent to `autoloop acp` over stdio, send prompts/slash commands that map to autoloop verbs, and stream loop runs as tool calls. Use when wiring up or operating an ACP connection to autoloop from another system.
+argument-hint: "[connect|run|<slash-command>] [args...]"
+---
+
+# Autoloop over ACP
+
+`autoloop acp` presents an **Agent Client Protocol** (ACP) interface over stdio. The external system (an editor, harness, or another agent) is the ACP **client**; autoloop is the ACP **agent**. This skill is for setting up that connection and driving autoloop through it. Parse `$ARGUMENTS` to determine what the user needs; if ambiguous, ask.
+
+> Direction matters. This skill is about **other systems driving autoloop** (autoloop is the agent). The inverse — autoloop *consuming* an external ACP agent as a backend — is the separate `-b kiro` option and is **not** what this covers.
+
+## Launching the agent
+
+```bash
+# Start the ACP agent on stdio (the client spawns this as a subprocess)
+autoloop acp
+
+# Surface debug logs as agent thoughts
+autoloop acp --verbose      # or -v
+
+# Usage
+autoloop acp --help         # or -h
+```
+
+**Transport rules (important):**
+- Frames are **NDJSON over stdio**. **Stdout is the protocol channel** — nothing else may write to it. All logs go to **stderr**.
+- The client therefore launches `autoloop acp` as a subprocess and speaks ACP on stdin/stdout. Don't pipe other output into stdout.
+
+**Working directory (REQUIRED):** per session. The ACP client **must** set it via the `session/new` `cwd` field, as the absolute path of the target project directory. autoloop anchors **all run state** (journal, registry, `runs/`) on `cwd`. If `cwd` is missing or blank, `session/new` is **rejected** with a JSON-RPC `invalid params` error — autoloop does **not** silently fall back to its own launch directory, because doing so would misroute the entire run into the wrong project. `--project-dir` / `AUTOLOOP_PROJECT_DIR` only affect dashboard control; they are not a fallback for the session working directory.
+
+### Representative client config
+
+ACP clients differ, but they spawn the agent as a command + args. A generic entry looks like:
+
+```json
+{
+  "command": "autoloop",
+  "args": ["acp"]
+}
+```
+
+Add `"--verbose"` to `args` if needed. The client **must** send a valid `cwd` on `session/new` (see Working directory above). No authentication step is required — `authenticate` is a no-op because autoloop runs locally under the caller's own credentials.
+
+## What the client sees
+
+On `initialize`, autoloop reports:
+- `agentInfo`: `{ name: "autoloop", version: "0.1.0" }`
+- `agentCapabilities`: `{ loadSession: false }` — sessions are not resumable; one session lives for the life of the connection and can launch many runs and quick commands over successive prompt turns.
+
+On `session/new`, autoloop **requires** a valid `cwd` (rejecting the session otherwise) and advertises its verbs as **slash commands** (`available_commands_update`), each with a description and an input hint.
+
+## Prompt behaviour
+
+Each prompt turn's text is dispatched as an autoloop command line:
+
+- **Bare objective** (no recognised verb) → runs the default preset: `run autocode "<your prompt>"`. So sending `build the login page` starts an `autocode` loop on that objective.
+- **Explicit verb** or **`/slash` command** always overrides the default (e.g. `run autofix "..."`, `/loops`, `inspect scratchpad`).
+- A single outer **XML-ish wrapper** is stripped before parsing — `<user_message>`, `<user>`, `<message>`, `<query>`, or `<prompt>`. This makes model-driven clients that wrap prompts work transparently. Unrecognised tags are left untouched.
+- Tokenising honours single and double quotes, so quoted objectives with spaces survive: `run autocode "Fix the login bug"`.
+- An empty prompt returns help text.
+
+## Command surface
+
+All 14 verbs work both as bare prompt lines and as `/slash` commands. They run in one of three modes:
+
+### Stream mode — long-running loops, streamed as ACP tool calls
+
+| Verb | Hint | Description |
+|---|---|---|
+| `run` | `<preset> [objective] [flags]` | Start a loop with a preset (e.g. `run autocode "Fix bug"`) |
+| `chain` | `<list\|run> [args]` | Run or list chains of presets |
+
+These execute a loop and bridge its events onto ACP `session/update` notifications as tool calls. The turn ends with a summary message.
+
+### Capture mode — quick commands, returns captured text
+
+| Verb | Hint | Description |
+|---|---|---|
+| `loops` | `[--all\|show <id>\|artifacts <id>\|health]` | List active/recent runs or show/health a run |
+| `inspect` | `<artifact> [selector] [--format <fmt>]` | Inspect a run artifact (journal, scratchpad, metrics, ...) |
+| `guide` | `[--run <id>] <message>` | Inject operator guidance into the next iteration of a run |
+| `list` | | List available presets |
+| `memory` | `<list\|status\|find\|add\|remove> [args]` | Manage persistent loop memory |
+| `task` | `<add\|complete\|update\|remove\|list> [args]` | Manage loop tasks |
+| `worktree` | `<list\|show\|merge\|clean> [args]` | Manage git worktrees for isolated runs |
+| `runs` | `clean [--max-age <days>]` | Maintain run directories |
+| `config` | `<show\|set\|unset\|path> [args]` | Show or edit autoloop configuration |
+| `control` | `<show\|capabilities\|interrupt\|guide> <id>` | Inspect or control a live run |
+| `emit` | `<topic> [summary]` | Emit a coordination topic event into a run |
+
+These run synchronously with stdout/stderr captured and return the text as a single agent message.
+
+### Control mode — dashboard lifecycle
+
+| Verb | Hint | Description |
+|---|---|---|
+| `dashboard` | `[start\|stop\|status] [--port <port>] [--host <host>]` | Start/stop the local dashboard and return its URL |
+
+Handled directly by the agent. On start, the dashboard **URL is returned on its own line** so clients can linkify it.
+
+## Streaming & cancellation
+
+- **Stream verbs** (`run`, `chain`) emit live `session/update` notifications as the loop runs, then a final summary with a stop reason.
+- **Capture verbs** return their full captured output in one message.
+- Cancel an in-flight turn with the ACP **`session/cancel`** notification — it aborts the active turn (and the running loop) for that session.
+
+## Quick reference
+
+| The client wants to... | Send this prompt |
+|---|---|
+| Start a feature loop | `run autocode "..."` (or just the bare objective) |
+| Fix a bug | `run autofix "..."` |
+| List/inspect runs | `loops` / `loops show <id>` / `inspect scratchpad` |
+| Steer a running loop | `guide "..."` |
+| List presets | `list` |
+| Open the dashboard | `dashboard start` (URL returned on its own line) |
+| Cancel the current turn | ACP `session/cancel` notification |