@mobrienv/autoloop 0.1.4 → 0.2.1

package/dist/worktree/clean.js.map

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

package/dist/worktree/create.d.ts

@@ -0,0 +1,14 @@
+export interface CreateWorktreeOpts {
+    mainProjectDir: string;
+    mainStateDir: string;
+    runId: string;
+    branchPrefix?: string;
+    baseBranch?: string;
+    mergeStrategy?: string;
+}
+export interface CreateWorktreeResult {
+    worktreePath: string;
+    branch: string;
+    metaDir: string;
+}
+export declare function createWorktree(opts: CreateWorktreeOpts): CreateWorktreeResult;

package/dist/worktree/create.js

@@ -0,0 +1,71 @@
+import { execSync } from "node:child_process";
+import { rmSync } from "node:fs";
+import { join } from "node:path";
+import { shellQuote } from "../utils.js";
+import { metaDirForRun, writeMeta } from "./meta.js";
+export function createWorktree(opts) {
+    const { mainProjectDir, mainStateDir, runId, branchPrefix = "autoloop", mergeStrategy = "squash", } = opts;
+    const baseBranch = opts.baseBranch ?? detectBaseBranch(mainProjectDir);
+    const branch = `${branchPrefix}/${runId}`;
+    const metaDir = metaDirForRun(mainStateDir, runId);
+    const worktreePath = join(metaDir, "tree");
+    // Fail fast if branch already exists
+    if (branchExists(mainProjectDir, branch)) {
+        throw new Error(`branch "${branch}" already exists; cannot create worktree for run ${runId}`);
+    }
+    try {
+        execSync(`git worktree add ${shellQuote(worktreePath)} -b ${shellQuote(branch)}`, {
+            cwd: mainProjectDir,
+            stdio: "pipe",
+        });
+    }
+    catch (err) {
+        // Clean up partial state on failure
+        try {
+            rmSync(worktreePath, { recursive: true, force: true });
+        }
+        catch {
+            /* ignore */
+        }
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`git worktree add failed: ${msg}`);
+    }
+    const meta = {
+        run_id: runId,
+        branch,
+        worktree_path: worktreePath,
+        base_branch: baseBranch,
+        status: "running",
+        merge_strategy: mergeStrategy,
+        created_at: new Date().toISOString(),
+        merged_at: null,
+        removed_at: null,
+    };
+    writeMeta(metaDir, meta);
+    return { worktreePath, branch, metaDir };
+}
+function detectBaseBranch(projectDir) {
+    try {
+        return execSync("git rev-parse --abbrev-ref HEAD", {
+            cwd: projectDir,
+            encoding: "utf-8",
+            stdio: "pipe",
+        }).trim();
+    }
+    catch {
+        return "main";
+    }
+}
+function branchExists(projectDir, branch) {
+    try {
+        execSync(`git rev-parse --verify refs/heads/${shellQuote(branch)}`, {
+            cwd: projectDir,
+            stdio: "pipe",
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=create.js.map

package/dist/worktree/create.js.map

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

package/dist/worktree/index.d.ts

@@ -0,0 +1,10 @@
+export type { CleanOpts, CleanResult } from "./clean.js";
+export { cleanWorktrees } from "./clean.js";
+export type { CreateWorktreeOpts, CreateWorktreeResult } from "./create.js";
+export { createWorktree } from "./create.js";
+export type { WorktreeListEntry } from "./list.js";
+export { listWorktreeMetas } from "./list.js";
+export type { MergeOpts, MergeResult } from "./merge.js";
+export { mergeWorktree } from "./merge.js";
+export type { WorktreeMeta, WorktreeStatus } from "./meta.js";
+export { isOrphanWorktree, metaDirForRun, readMeta, updateStatus, writeMeta, } from "./meta.js";

package/dist/worktree/index.js

@@ -0,0 +1,6 @@
+export { cleanWorktrees } from "./clean.js";
+export { createWorktree } from "./create.js";
+export { listWorktreeMetas } from "./list.js";
+export { mergeWorktree } from "./merge.js";
+export { isOrphanWorktree, metaDirForRun, readMeta, updateStatus, writeMeta, } from "./meta.js";
+//# sourceMappingURL=index.js.map

package/dist/worktree/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/worktree/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,SAAS,GACV,MAAM,WAAW,CAAC"}

package/dist/worktree/list.d.ts

@@ -0,0 +1,9 @@
+import type { WorktreeMeta } from "./meta.js";
+export interface WorktreeListEntry extends WorktreeMeta {
+    orphan: boolean;
+}
+/**
+ * List all worktree metadata entries, flagging orphans where the
+ * worktree path no longer exists on disk but meta.json is still present.
+ */
+export declare function listWorktreeMetas(mainStateDir: string): WorktreeListEntry[];

package/dist/worktree/list.js

@@ -0,0 +1,24 @@
+import { existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+import { isOrphanWorktree, readMeta } from "./meta.js";
+/**
+ * List all worktree metadata entries, flagging orphans where the
+ * worktree path no longer exists on disk but meta.json is still present.
+ */
+export function listWorktreeMetas(mainStateDir) {
+    const worktreesDir = join(mainStateDir, "worktrees");
+    if (!existsSync(worktreesDir))
+        return [];
+    const entries = [];
+    for (const dirent of readdirSync(worktreesDir, { withFileTypes: true })) {
+        if (!dirent.isDirectory())
+            continue;
+        const meta = readMeta(join(worktreesDir, dirent.name));
+        if (!meta)
+            continue;
+        const orphan = isOrphanWorktree(meta);
+        entries.push({ ...meta, orphan });
+    }
+    return entries;
+}
+//# sourceMappingURL=list.js.map

package/dist/worktree/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../src/worktree/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAMvD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,YAAoB;IACpD,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,CAAC;IAEzC,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,KAAK,MAAM,MAAM,IAAI,WAAW,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QACxE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE;YAAE,SAAS;QACpC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAEtC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/worktree/merge.d.ts

@@ -0,0 +1,11 @@
+export interface MergeOpts {
+    mainProjectDir: string;
+    metaDir: string;
+    strategy?: "squash" | "merge" | "rebase";
+}
+export interface MergeResult {
+    success: boolean;
+    conflicts?: string[];
+    recoveryHint?: string;
+}
+export declare function mergeWorktree(opts: MergeOpts): MergeResult;

package/dist/worktree/merge.js

@@ -0,0 +1,129 @@
+import { execSync } from "node:child_process";
+import { shellQuote } from "../utils.js";
+import { readMeta, updateStatus } from "./meta.js";
+const DEFAULT_GIT_NAME = "autoloop";
+const DEFAULT_GIT_EMAIL = "autoloop@local";
+export function mergeWorktree(opts) {
+    const { mainProjectDir, metaDir, strategy = "squash" } = opts;
+    const meta = readMeta(metaDir);
+    if (!meta)
+        throw new Error(`no worktree meta found in ${metaDir}`);
+    validateMergeStatus(meta);
+    const baseBranch = meta.base_branch;
+    const branch = meta.branch;
+    const gitEnv = resolveGitEnv(mainProjectDir);
+    // Checkout base branch
+    exec(mainProjectDir, `git checkout ${shellQuote(baseBranch)}`, gitEnv);
+    try {
+        if (strategy === "squash") {
+            exec(mainProjectDir, `git merge --squash ${shellQuote(branch)}`, gitEnv);
+            exec(mainProjectDir, `git commit --no-edit -m ${shellQuote(`merge worktree ${meta.run_id} (squash)`)}`, gitEnv);
+        }
+        else if (strategy === "rebase") {
+            exec(mainProjectDir, `git rebase ${shellQuote(branch)}`, gitEnv);
+        }
+        else {
+            exec(mainProjectDir, `git merge --no-ff ${shellQuote(branch)} -m ${shellQuote(`merge worktree ${meta.run_id}`)}`, gitEnv);
+        }
+    }
+    catch (err) {
+        // Attempt to detect conflicts and abort
+        const msg = err instanceof Error ? err.message : String(err);
+        const conflicts = detectConflicts(mainProjectDir);
+        try {
+            if (strategy === "rebase") {
+                exec(mainProjectDir, "git rebase --abort", gitEnv);
+            }
+            else {
+                exec(mainProjectDir, "git merge --abort", gitEnv);
+            }
+        }
+        catch {
+            /* abort best-effort */
+        }
+        if (conflicts.length > 0) {
+            return {
+                success: false,
+                conflicts,
+                recoveryHint: `Resolve conflicts manually, then run: git merge ${branch}`,
+            };
+        }
+        throw new Error(`merge failed: ${msg}`);
+    }
+    updateStatus(metaDir, "merged");
+    return { success: true };
+}
+function validateMergeStatus(meta) {
+    if (meta.status === "running") {
+        throw new Error(`cannot merge worktree ${meta.run_id}: still running`);
+    }
+    if (meta.status === "merged") {
+        throw new Error(`worktree ${meta.run_id} is already merged`);
+    }
+    if (meta.status === "removed") {
+        throw new Error(`worktree ${meta.run_id} has been removed`);
+    }
+}
+function detectConflicts(cwd) {
+    try {
+        const out = execSync("git diff --name-only --diff-filter=U", {
+            cwd,
+            encoding: "utf-8",
+            stdio: "pipe",
+        }).trim();
+        return out ? out.split("\n") : [];
+    }
+    catch {
+        return [];
+    }
+}
+function resolveGitEnv(cwd) {
+    const configuredName = readGitConfig(cwd, "user.name");
+    const configuredEmail = readGitConfig(cwd, "user.email");
+    const hasIdentityEnv = hasText(process.env.GIT_AUTHOR_NAME) ||
+        hasText(process.env.GIT_AUTHOR_EMAIL) ||
+        hasText(process.env.GIT_COMMITTER_NAME) ||
+        hasText(process.env.GIT_COMMITTER_EMAIL);
+    if (!hasIdentityEnv && configuredName && configuredEmail) {
+        return undefined;
+    }
+    const fallbackName = textOr(process.env.AUTOLOOP_GIT_NAME, DEFAULT_GIT_NAME);
+    const fallbackEmail = textOr(process.env.AUTOLOOP_GIT_EMAIL, DEFAULT_GIT_EMAIL);
+    const authorName = textOr(process.env.GIT_AUTHOR_NAME) ?? configuredName ?? fallbackName;
+    const authorEmail = textOr(process.env.GIT_AUTHOR_EMAIL) ?? configuredEmail ?? fallbackEmail;
+    const committerName = textOr(process.env.GIT_COMMITTER_NAME) ?? configuredName ?? authorName;
+    const committerEmail = textOr(process.env.GIT_COMMITTER_EMAIL) ?? configuredEmail ?? authorEmail;
+    return {
+        ...process.env,
+        GIT_AUTHOR_NAME: authorName,
+        GIT_AUTHOR_EMAIL: authorEmail,
+        GIT_COMMITTER_NAME: committerName,
+        GIT_COMMITTER_EMAIL: committerEmail,
+    };
+}
+function readGitConfig(cwd, key) {
+    try {
+        const value = execSync(`git config --get ${shellQuote(key)}`, {
+            cwd,
+            encoding: "utf-8",
+            stdio: "pipe",
+        }).trim();
+        return value === "" ? undefined : value;
+    }
+    catch {
+        return undefined;
+    }
+}
+function hasText(value) {
+    return value !== undefined && value.trim() !== "";
+}
+function textOr(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    const trimmed = value.trim();
+    return trimmed === "" ? fallback : trimmed;
+}
+function exec(cwd, cmd, env) {
+    return execSync(cmd, { cwd, encoding: "utf-8", env, stdio: "pipe" });
+}
+//# sourceMappingURL=merge.js.map

package/dist/worktree/merge.js.map

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

package/dist/worktree/meta.d.ts

@@ -0,0 +1,17 @@
+export type WorktreeStatus = "running" | "completed" | "failed" | "merged" | "removed";
+export interface WorktreeMeta {
+    run_id: string;
+    branch: string;
+    worktree_path: string;
+    base_branch: string;
+    status: WorktreeStatus;
+    merge_strategy: string;
+    created_at: string;
+    merged_at: string | null;
+    removed_at: string | null;
+}
+export declare function metaDirForRun(mainStateDir: string, runId: string): string;
+export declare function writeMeta(metaDir: string, meta: WorktreeMeta): void;
+export declare function readMeta(metaDir: string): WorktreeMeta | null;
+export declare function isOrphanWorktree(meta: WorktreeMeta): boolean;
+export declare function updateStatus(metaDir: string, status: WorktreeStatus): void;

package/dist/worktree/meta.js

@@ -0,0 +1,34 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync, } from "node:fs";
+import { join } from "node:path";
+const META_FILE = "meta.json";
+export function metaDirForRun(mainStateDir, runId) {
+    return join(mainStateDir, "worktrees", runId);
+}
+export function writeMeta(metaDir, meta) {
+    mkdirSync(metaDir, { recursive: true });
+    const target = join(metaDir, META_FILE);
+    const tmp = `${target}.tmp`;
+    writeFileSync(tmp, `${JSON.stringify(meta, null, 2)}\n`);
+    renameSync(tmp, target);
+}
+export function readMeta(metaDir) {
+    const target = join(metaDir, META_FILE);
+    if (!existsSync(target))
+        return null;
+    return JSON.parse(readFileSync(target, "utf-8"));
+}
+export function isOrphanWorktree(meta) {
+    return meta.status !== "removed" && !existsSync(meta.worktree_path);
+}
+export function updateStatus(metaDir, status) {
+    const meta = readMeta(metaDir);
+    if (!meta)
+        throw new Error(`no worktree meta found in ${metaDir}`);
+    meta.status = status;
+    if (status === "merged")
+        meta.merged_at = new Date().toISOString();
+    if (status === "removed")
+        meta.removed_at = new Date().toISOString();
+    writeMeta(metaDir, meta);
+}
+//# sourceMappingURL=meta.js.map

package/dist/worktree/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/worktree/meta.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,SAAS,EACT,YAAY,EACZ,UAAU,EACV,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAqBjC,MAAM,SAAS,GAAG,WAAW,CAAC;AAE9B,MAAM,UAAU,aAAa,CAAC,YAAoB,EAAE,KAAa;IAC/D,OAAO,IAAI,CAAC,YAAY,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,IAAkB;IAC3D,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,GAAG,MAAM,MAAM,CAAC;IAC5B,aAAa,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACzD,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACxC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAiB,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAkB;IACjD,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe,EAAE,MAAsB;IAClE,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,OAAO,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACrB,IAAI,MAAM,KAAK,QAAQ;QAAE,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnE,IAAI,MAAM,KAAK,SAAS;QAAE,IAAI,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrE,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mobrienv/autoloop",
-  "version": "0.1.4",
+  "version": "0.2.1",
   "description": "Autonomous LLM loop harness and control plane for long-horizon autonomous work",
   "type": "module",
   "main": "dist/main.js",
@@ -38,15 +38,35 @@
   },
   "scripts": {
     "build": "tsc",
+    "lint": "biome check src/ test/",
+    "lint:fix": "biome check --write src/ test/",
+    "format": "biome format src/ test/",
+    "format:fix": "biome format --write src/ test/",
     "test": "node --experimental-vm-modules node_modules/.bin/vitest run",
-    "test:watch": "node --experimental-vm-modules node_modules/.bin/vitest"
+    "test:coverage": "node --experimental-vm-modules node_modules/.bin/vitest run --coverage",
+    "test:watch": "node --experimental-vm-modules node_modules/.bin/vitest",
+    "check": "biome check src/ test/ && tsc --noEmit && npm run test:coverage",
+    "prepare": "husky"
+  },
+  "lint-staged": {
+    "*.{ts,js,json}": [
+      "biome check --write --no-errors-on-unmatched"
+    ]
   },
   "devDependencies": {
+    "@biomejs/biome": "^2.4.10",
     "@types/node": "^25.5.2",
-    "typescript": "^5.7.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0",
+    "playwright": "^1.59.1",
+    "typescript": "^5.9.3",
     "vitest": "^3.0.0"
   },
   "dependencies": {
-    "@iarna/toml": "^2.2.5"
+    "@agentclientprotocol/sdk": "^0.18.0",
+    "@hono/node-server": "^1.19.12",
+    "@iarna/toml": "^2.2.5",
+    "hono": "^4.12.10"
   }
 }

package/presets/autocode/README.md

@@ -1,6 +1,6 @@
 # Autocode miniloop
 
-An autoloop-native port of Ralph's code-assist/autocode loop.
+Use when you need to implement a feature, refactor code, or make structured changes across a codebase.
 
 Shape:
 - planner

package/presets/autocode/autoloops.toml

@@ -5,7 +5,7 @@ event_loop.completion_promise = "LOOP_COMPLETE"
 event_loop.required_events = ["review.passed"]
 
 backend.kind = "command"
-backend.command = "/Users/rook/.npm-global/bin/claude"
+backend.command = "claude"
 backend.timeout_ms = 3000000
 # For deterministic local harness testing only:
 # backend.kind = "command"
@@ -20,3 +20,11 @@ harness.instructions_file = "harness.md"
 core.state_dir = ".autoloop"
 core.journal_file = ".autoloop/journal.jsonl"
 core.memory_file = ".autoloop/memory.jsonl"
+
+# Kiro backend (persistent ACP session):
+# backend.kind = "kiro"
+# backend.command = "kiro-cli"
+# backend.args = ["acp"]
+# backend.trust_all_tools = true
+# backend.agent = ""
+# backend.model = ""

package/presets/autocode/harness.md

@@ -1,7 +1,7 @@
 This project is a autoloops-native port of Ralph's code-assist/autocode preset.
 
 Global rules:
-- Shared working files are the source of truth: `.autoloop/context.md`, `.autoloop/plan.md`, `.autoloop/progress.md`, and `.autoloop/logs/`.
+- Shared working files are the source of truth: `{{STATE_DIR}}/context.md`, `{{STATE_DIR}}/plan.md`, `{{STATE_DIR}}/progress.md`, and `{{STATE_DIR}}/logs/`.
 - Keep only one concrete slice active at a time.
 - Use the event tool instead of prose-only handoffs.
 - Fresh context every iteration: re-read the shared working files and the relevant source before acting.
@@ -11,9 +11,16 @@ Global rules:
 - Missing evidence means no success. No role may treat another role's assertion as proof.
 - Every success handoff should cite exact files changed, exact verification command(s), and commit hash when applicable.
 - After a slice is implemented and verified, commit it before `review.ready` or any later handoff. Every completed slice should land as its own commit. Avoid carrying verified but uncommitted work into the next iteration.
-- Do not dismiss a relevant issue as merely pre-existing. If it matters to the current objective, touched surface, or verification path, you must fix it now, make it the next slice, explicitly defer it with rationale in `.autoloop/progress.md`, or prove it is out of scope.
-- Maintain a `Relevant Issues` section in `.autoloop/progress.md`. Every relevant issue must have an explicit disposition: `fix-now`, `fix-next`, `deferred`, or `out-of-scope`.
-- Use `./.autoloop/autoloops memory add learning ...` for durable repo/process learnings.
+- Do not dismiss a relevant issue as merely pre-existing. If it matters to the current objective, touched surface, or verification path, you must fix it now, make it the next slice, explicitly defer it with rationale in `{{STATE_DIR}}/progress.md`, or prove it is out of scope.
+- Maintain a `Relevant Issues` section in `{{STATE_DIR}}/progress.md`. Every relevant issue must have an explicit disposition: `fix-now`, `fix-next`, `deferred`, or `out-of-scope`.
+- Use `{{TOOL_PATH}} memory add learning ...` for durable repo/process learnings.
 - Do not invent extra phases. Stay inside planner → builder → critic → finalizer.
 - Only the finalizer may emit `task.complete`.
-- If the prompt is a path to a `.code-task.md` file or an existing implementation directory, use that as source material instead of treating it like plain prose.
+- If the prompt is a path to a `.code-task.md` file or an existing implementation directory, use that as source material instead of treating it like plain prose.
+
+Role boundaries (strict):
+- The planner MUST NOT implement code, run tests, or make commits. It writes shared working files and emits `tasks.ready`.
+- The builder implements the active slice, verifies it, commits it, and emits `review.ready`. It does not plan or review.
+- The critic independently verifies the builder's work and emits `review.passed` or `review.rejected`. It does not build.
+- The finalizer checks whole-task completeness and emits `queue.advance` or `task.complete`.
+- If the routing topology says your next event is X, emit X — do not attempt completion or skip-ahead events.

package/presets/autocode/roles/build.md

@@ -3,9 +3,9 @@ You are the builder.
 Implement exactly the active slice from the latest `tasks.ready` handoff.
 
 On every activation:
-- Re-read `.autoloop/context.md`, `.autoloop/plan.md`, and `.autoloop/progress.md`.
+- Re-read `{{STATE_DIR}}/context.md`, `{{STATE_DIR}}/plan.md`, and `{{STATE_DIR}}/progress.md`.
 - Re-read the source files named in the current slice.
-- Update `.autoloop/progress.md` with what you are doing and how you will verify it.
+- Update `{{STATE_DIR}}/progress.md` with what you are doing and how you will verify it.
 
 Process:
 1. Understand the active slice and its acceptance criteria.
@@ -13,7 +13,7 @@ Process:
 3. Make the smallest code change that satisfies the slice.
 4. Run the strongest focused verification you can for that slice.
 5. Commit the completed slice before handoff. Each completed slice should land as its own commit.
-6. Record concise evidence in `.autoloop/progress.md` and longer output in `.autoloop/logs/` when useful, including the commit hash when available.
+6. Record concise evidence in `{{STATE_DIR}}/progress.md` and longer output in `{{STATE_DIR}}/logs/` when useful, including the commit hash when available.
 7. Emit `review.ready` with:
    - what changed
    - what was verified
@@ -21,7 +21,7 @@ Process:
    - any known risk or uncertainty
 
 If blocked:
-- Record the reason in `.autoloop/progress.md`.
+- Record the reason in `{{STATE_DIR}}/progress.md`.
 - Emit `build.blocked` with a concrete blocker and the safest next planning move.
 
 Rules:
@@ -31,3 +31,4 @@ Rules:
 - No fake verification.
 - Do not emit `review.ready` for an uncommitted completed slice.
 - If confidence is shaky, choose the narrower, more reversible change and document why.
+- You MUST emit `review.ready` (or `build.blocked`) — never `review.passed`, `task.complete`, or any other event. The critic reviews your work; you do not self-approve.

package/presets/autocode/roles/critic.md

@@ -5,7 +5,7 @@ You are not the builder. Fresh eyes matter.
 Your job is to challenge the latest increment and try to prove it is not ready.
 
 On activation:
-- Re-read `.autoloop/context.md`, `.autoloop/plan.md`, and `.autoloop/progress.md`.
+- Re-read `{{STATE_DIR}}/context.md`, `{{STATE_DIR}}/plan.md`, and `{{STATE_DIR}}/progress.md`.
 - Inspect the changed files and the builder's stated verification.
 - Re-run the strongest relevant checks yourself when possible.
 - Run at least one manual smoke test that actually exercises the builder's changed code path whenever the repo exposes a practical manual surface (for example an existing smoke script, CLI invocation, dev server flow, or reproducible app path). Run it yourself instead of relying only on the builder's checks. If no practical manual smoke path exists, say that explicitly.
@@ -20,7 +20,7 @@ Review checklist:
 - Did you run your own manual smoke test that exercised the builder's changed code path when a practical manual path existed?
 - Can you independently validate the claim from code plus evidence?
 - Is the verified slice committed, with `git status --short` clean except for intentional unrelated files?
-- Were all relevant issues discovered during the slice given an explicit disposition in `.autoloop/progress.md`?
+- Were all relevant issues discovered during the slice given an explicit disposition in `{{STATE_DIR}}/progress.md`?
 - Did anyone try to dismiss a relevant issue just because it was pre-existing?
 
 Emit (only these two events — never emit builder events like `review.ready` or `build.blocked`):

package/presets/autocode/roles/finalizer.md

@@ -6,7 +6,7 @@ Your job is not just to ask whether the latest diff is okay.
 Your job is to decide whether the whole requested outcome is complete or whether the loop should continue.
 
 On activation:
-- Re-read `.autoloop/context.md`, `.autoloop/plan.md`, and `.autoloop/progress.md`.
+- Re-read `{{STATE_DIR}}/context.md`, `{{STATE_DIR}}/plan.md`, and `{{STATE_DIR}}/progress.md`.
 - Reconcile the latest reviewed slice against the whole request.
 - Check whether the numbered plan still has unfinished steps.
 - Check whether the current step is truly exhausted.
@@ -38,6 +38,6 @@ Rules:
 - Do not invent new requirements.
 - Do not use `task.complete` just because one small slice passed review.
 - If the work is done but the accepted changes are still uncommitted, commit them before `task.complete`.
-- Do not allow `task.complete` while `.autoloop/progress.md` still contains a relevant issue with no clear disposition or owner.
+- Do not allow `task.complete` while `{{STATE_DIR}}/progress.md` still contains a relevant issue with no clear disposition or owner.
 - `pre-existing` is not a valid completion rationale for a relevant issue.
 - Missing evidence means no completion.

package/presets/autocode/roles/planner.md

@@ -8,17 +8,17 @@ Your job:
 3. Hand exactly one concrete slice to the builder.
 
 On every activation:
-- Read `.autoloop/context.md`, `.autoloop/plan.md`, and `.autoloop/progress.md` if they exist.
+- Read `{{STATE_DIR}}/context.md`, `{{STATE_DIR}}/plan.md`, and `{{STATE_DIR}}/progress.md` if they exist.
 - If the objective text points at a `.code-task.md` file, read it.
 - If the objective text points at an existing implementation/spec directory, inspect that directory.
 - Re-read the latest scratchpad/journal context before deciding the next slice.
 
 On first activation:
-- Create or refresh:
-  - `.autoloop/context.md` — request summary, source type, constraints, repo patterns, acceptance criteria
-  - `.autoloop/plan.md` — numbered high-level steps, not a blob checklist
-  - `.autoloop/progress.md` — current step, active slice, verification notes, completed steps
-  - `.autoloop/logs/` directory if useful
+- Overwrite (not append) these files to clear any stale state from prior runs:
+  - `{{STATE_DIR}}/context.md` — request summary, source type, constraints, repo patterns, acceptance criteria
+  - `{{STATE_DIR}}/plan.md` — numbered high-level steps, not a blob checklist
+  - `{{STATE_DIR}}/progress.md` — current step, active slice, verification notes, completed steps
+  - `{{STATE_DIR}}/logs/` directory if useful
 - Choose only Step 1's current slice.
 - Emit `tasks.ready` with a payload that includes:
   - current step
@@ -29,7 +29,7 @@ On first activation:
 On later activations (`queue.advance` or `build.blocked`):
 - Re-read the shared working files.
 - If the current step still has unfinished work, hand the next smallest slice in the same step.
-- If the current step is complete, mark it complete in `.autoloop/progress.md`, advance to the next numbered step, and emit the next `tasks.ready`.
+- If the current step is complete, mark it complete in `{{STATE_DIR}}/progress.md`, advance to the next numbered step, and emit the next `tasks.ready`.
 - Planner never emits completion. If the plan appears done, leave that proof to the critic/finalizer path instead of self-certifying success.
 
 Rules:

package/presets/autodoc/README.md

@@ -1,6 +1,6 @@
 # AutoDoc miniloop
 
-An autoloop-native documentation generation and maintenance loop.
+Use when you need to generate or update documentation to match current code.
 
 AutoDoc audits existing documentation against the codebase, identifies gaps and staleness, writes or updates docs, verifies accuracy, and tracks progress — iterating until documentation is current.
 

package/presets/autodoc/autoloops.toml

@@ -4,7 +4,7 @@ event_loop.completion_promise = "LOOP_COMPLETE"
 event_loop.required_events = ["doc.checked"]
 
 backend.kind = "command"
-backend.command = "/Users/rook/.npm-global/bin/claude"
+backend.command = "claude"
 backend.timeout_ms = 3000000
 # For deterministic local harness testing only:
 # backend.kind = "command"