@mobrienv/autoloop 0.8.0 → 0.9.1

package/README.md

@@ -233,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-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":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mobrienv/autoloop",
-  "version": "0.8.0",
+  "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.8.0",
-    "@mobrienv/autoloop-core": "0.8.0",
-    "@mobrienv/autoloop-harness": "0.8.0",
-    "@mobrienv/autoloop-presets": "0.8.0"
+    "@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.8.0",
+  "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

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 |