compounding-loop 0.1.0 → 0.4.0

package/README.md

@@ -1,12 +1,20 @@
 # Compounding Loop
 
-**Write the brief, check back tomorrow.** Unattended, verified Claude Code build loops with a local dashboard.
+**Write the brief, check back tomorrow.** Several unattended Claude Code lanes, one repo, each lane owning its own paths so they do not step on each other, every round verified by your own tests. Local dashboard included.
 
 ```sh
 npx compounding-loop init
 ```
 
-![The Compounding Loop dashboard showing five finished loops](docs/assets/dashboard.png)
+[![npm](https://img.shields.io/npm/v/compounding-loop)](https://www.npmjs.com/package/compounding-loop) [![CI](https://github.com/Minntooos/Compounding-Loop/actions/workflows/ci.yml/badge.svg)](https://github.com/Minntooos/Compounding-Loop/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+
+**[Watch this repo build itself](https://minntooos.github.io/Compounding-Loop/)**: the live demo reads this repo's commits from GitHub in your browser, next to the real five-site data. Working with a teammate? [Five steps](docs/team.md).
+
+![The Compounding Loop fleet screen: six loops, one with lanes](docs/assets/screens/fleet-light-laptop.png)
+
+![A loop's detail screen in the dark theme](docs/assets/screens/loop-dark-laptop.png)
+
+**Lanes:** each lane is a scheduled run that owns a set of paths (`.ai/lanes.json`). `loop check-lanes` fails any commit that touches files outside its lane, so parallel runs do not collide. This repo is the proof: five lanes (core, kit, server, web, docs) built and documented it by pushing to one `main`. See [Lanes](docs/lanes.md).
 
 Most agent tools show a demo. This one ships with proof: the method in this repo built five live sites, 215 pages in all, with nobody watching, and made **verification** the product. A round only counts when the repo's own tests pass and a reviewer that did not write the code has checked the diff.
 
@@ -57,6 +65,10 @@ npx compounding-loop run                       # one round now
 npx compounding-loop dashboard                 # the local dashboard
 ```
 
+Several lanes in one repo (needs an `IDEA.md` brief first): `npx compounding-loop init --lanes core,web,docs`, then `npx compounding-loop run --lane core`. Check ownership with `npx compounding-loop check-lanes`. Details: [Lanes](docs/lanes.md). Sharing a loop with a teammate: [Work on a loop with a teammate](docs/team.md).
+
+**Run the loop without tokens.** Pause every lane (`npx compounding-loop pause`, undo with `resume`), start the next round from a brief in a laned repo (`next-round --brief`), see which scheduled runs happened (`runs`) and check whether you can ship (`ship-check`). The dashboard has buttons for all of it (Pause all, Start next round, Release), each with a confirm step, plus the run history and a Ready to ship checklist: see [Dashboard](docs/dashboard.md#controls). Releases go through a GitHub Actions workflow with npm trusted publishing and a protected `release` environment: see [Release](docs/release.md).
+
 Already have a repo? `npx compounding-loop init` adds the method to it without overwriting anything. Details: [Getting started](docs/getting-started.md).
 
 ## Just loop the agent?
@@ -75,17 +87,39 @@ An honest comparison with `while true; do claude -p "keep going"; done`:
 
 If your task is one afternoon of work and you are at the keyboard, a plain loop is fine. This pays off for work that runs for days.
 
+## How it differs from other tools
+
+These tools solve a neighbouring problem: running several agents side by side while you watch. Compounding Loop is for work that runs unattended and has to prove itself. Descriptions come from each project's own page (checked 2026-10-08).
+
+| Tool | What it is for | Where Compounding Loop differs |
+|---|---|---|
+| [Claude Squad](https://github.com/smtg-ai/claude-squad) | A terminal app that manages several agents, each in its own tmux session and git worktree; an experimental `-y` flag auto-accepts prompts. | Squad isolates work by branch. We isolate by path ownership on one `main`, and a round only counts when your tests and a reviewer pass. |
+| [Parallel Code](https://github.com/johannesjo/parallel-code) | Runs several agents at once, each in its own git worktree; you merge the branch back yourself. | Interactive and merge-driven. We are scheduled, and the agent never marks itself done. |
+| [Agent Orchestrator](https://github.com/ComposioHQ/agent-orchestrator) | A local desktop workspace where an orchestrator delegates work to agents on separate branches and worktrees, shown on a Kanban board. | A desktop planner. We are a plain-file method (task file, notes, handoffs) you can read in git. |
+| [Vibe Kanban](https://github.com/BloopAI/vibe-kanban) | Plan issues on a kanban board, then run coding agents in workspaces with a branch and a terminal. Its page says it is sunsetting. | We have no board; the contract is a file of checkable commands. |
+| [Claude Code agent teams](https://code.claude.com/docs/en/agent-teams) | Experimental, off by default: a lead session coordinates teammates with a shared task list and messages. Needs an interactive session (not `claude -p`). | Teams are live and interactive. Lanes are scheduled, unattended and leave a git trail. They can be combined. |
+
+If you work at the keyboard and want to watch agents in parallel, those tools are a good fit.
+
 ## Docs
 
-[Getting started](docs/getting-started.md) · [Concepts](docs/concepts.md) · [Runners](docs/runners.md) · [Dashboard](docs/dashboard.md) · [Templates](docs/templates.md) · [FAQ](docs/faq.md) · [Troubleshooting](docs/troubleshooting.md) · [Contributing](CONTRIBUTING.md)
+[Getting started](docs/getting-started.md) · [Lanes](docs/lanes.md) · [Team](docs/team.md) · [Concepts](docs/concepts.md) · [Runners](docs/runners.md) · [Dashboard](docs/dashboard.md) · [Release](docs/release.md) · [Templates](docs/templates.md) · [FAQ](docs/faq.md) · [Troubleshooting](docs/troubleshooting.md) · [Contributing](CONTRIBUTING.md)
 
 ## FAQ
 
-**What does it cost?** The tool is free and MIT licensed. Your Claude Code plan pays for the runs; the budget (`Run: N / LIMIT`) caps how many happen.
+**Isn't this cron + `claude -p`?** Partly, and the table above shows what is added: your checks decide when a round is done, a fresh reviewer attacks the diff, each run writes a handoff and notes the next run reads, a run budget stops runaway loops, and lanes keep parallel runs out of each other's files.
+
+**What does it cost (plan usage vs API)?** The tool is free and MIT licensed. Runs use whatever your Claude Code login uses: plan usage on a subscription, or API billing if you authenticate with a key. The `Run: N / LIMIT` budget caps how many runs happen. More lanes means more runs, so cost scales with lanes times runs.
+
+**Why not agent teams?** Agent teams are experimental, off by default and need an interactive session ([docs](https://code.claude.com/docs/en/agent-teams)). Lanes are for scheduled runs nobody is watching. Use teams when you are at the keyboard; use lanes when you are away.
+
+**What happens when it goes wrong?** A red round is discarded and logged under Tried. The same failure twice triggers the stuck protocol, then a `BLOCKED.md` appears in your dashboard inbox. When the run budget is reached the lane stops. Everything is a git commit, so it is reversible. See [Troubleshooting](docs/troubleshooting.md).
+
+**Is my code sent anywhere?** Only what Claude Code and git already send. Compounding Loop has no telemetry and no call home, the dashboard binds to loopback, and tokens come from your environment or `gh` and are never stored. See [SECURITY.md](SECURITY.md).
 
-**Is it safe?** The dashboard binds to loopback, there is no telemetry and no call home, and tokens come from your environment or `gh` and are never stored. The loop works on branches or `main` as you configure; read [SECURITY.md](SECURITY.md).
+**What won't it do?** It will not publish, spend money, create accounts or change repo settings on its own, and it stops and asks (`BLOCKED.md`) rather than guess.
 
-**What won't it do?** It will not publish, spend money, create accounts or change repo settings on its own, and it stops and asks (`BLOCKED.md`) rather than guess when the brief contradicts reality.
+**Why does the live demo sometimes say "Snapshot"?** The demo page reads this repo from GitHub's public API without a login, which allows 60 requests an hour per IP address (a page load uses about three). When that runs out, or you are offline, it shows the bundled snapshot and the header chip says so; it switches back to live on the next refresh once GitHub allows requests again. Nothing is sent anywhere else.
 
 **Does it need a GitHub login?** Only to create a private repo with `loop new`; `--dry-run` and every test work offline.
 

package/dist/cli/checkLanes.js

@@ -0,0 +1,60 @@
+import { execFile } from 'node:child_process';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import { checkCommitFiles, parseLaneTrailer, parseLanesConfig } from '../core/lanes.js';
+const execFileAsync = promisify(execFile);
+// core.quotepath=false keeps non-ASCII names readable in git's output.
+const git = async (cwd, ...args) => (await execFileAsync('git', ['-c', 'core.quotepath=false', ...args], { cwd, maxBuffer: 64 * 1024 * 1024 })).stdout;
+const RECORD = '\u001e';
+/** Checks every commit in `range` (default: the last 50 commits) against `.ai/lanes.json`. */
+export async function runCheckLanes(dir, range) {
+    const text = await readFile(path.join(dir, '.ai', 'lanes.json'), 'utf8').catch(() => undefined);
+    if (text === undefined)
+        throw new Error('No .ai/lanes.json here. Create one with `loop init --lanes a,b,c`.');
+    const { config, errors } = parseLanesConfig(text);
+    if (!config)
+        throw new Error(`.ai/lanes.json is invalid:\n- ${errors.join('\n- ')}`);
+    if (!range && !(await git(dir, 'rev-parse', '--verify', '--quiet', 'HEAD').then(() => true, () => false))) {
+        return { checked: 0, untagged: [], skipped: [], problems: [] };
+    }
+    const log = await git(dir, 'log', '--no-merges', `--format=${RECORD}%H%n%B`, ...(range ? [range] : ['-n', '50'])).catch((error) => {
+        throw new Error(`git could not read ${range ?? 'the history'}: ${error instanceof Error ? error.message.split('\n')[0] : String(error)}. Check the range (for example origin/main..HEAD).`);
+    });
+    const result = { checked: 0, untagged: [], skipped: [], problems: [] };
+    const shallow = (await git(dir, 'rev-parse', '--is-shallow-repository')).trim() === 'true';
+    for (const record of log.split(RECORD).filter((r) => r.trim() !== '')) {
+        const [hash = '', ...body] = record.split('\n');
+        const short = hash.slice(0, 7);
+        result.checked++;
+        const lane = parseLaneTrailer(body.join('\n'));
+        if (!lane) {
+            result.untagged.push(short);
+            continue;
+        }
+        // Without its parent, a shallow clone's oldest commit would look like it added every file.
+        if (shallow && (await git(dir, 'rev-list', '--parents', '-n', '1', hash)).trim().split(' ').length === 1) {
+            result.skipped.push(short);
+            continue;
+        }
+        const files = (await git(dir, 'diff-tree', '-z', '--no-commit-id', '--name-only', '-r', '--root', hash)).split('\0').filter(Boolean);
+        for (const violation of checkCommitFiles(config, lane, files))
+            result.problems.push(`${short} (Lane: ${lane}): ${violation.message}`);
+    }
+    return result;
+}
+export function formatLaneCheck(result) {
+    const lines = [`Checked ${result.checked} commit(s).`];
+    if (result.checked === 0)
+        lines.push('Nothing to check: no commits in the range (or no commits yet). If you passed --range, is it right (for example origin/main..HEAD)?');
+    if (result.skipped.length > 0)
+        lines.push(`${result.skipped.length} skipped because this is a shallow clone (${result.skipped.join(', ')}). Use fetch-depth: 0 to check them.`);
+    if (result.untagged.length > 0)
+        lines.push(`${result.untagged.length} without a Lane: trailer (not an error): ${result.untagged.join(', ')}`);
+    if (result.problems.length === 0)
+        lines.push('All lane-tagged commits stayed in their lane.');
+    else
+        lines.push(...result.problems.map((p) => `FAIL ${p}`));
+    return lines.join('\n');
+}
+//# sourceMappingURL=checkLanes.js.map

package/dist/cli/checkLanes.js.map

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

package/dist/cli/claim.js

@@ -0,0 +1,84 @@
+import { execFile } from 'node:child_process';
+import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import { parseLanesConfig } from '../core/lanes.js';
+import { activeClaim, formatClaim } from '../core/parse/claim.js';
+const execFileAsync = promisify(execFile);
+const git = (cwd, ...args) => execFileAsync('git', args, { cwd });
+async function requireLane(dir, lane) {
+    const text = await readFile(path.join(dir, '.ai', 'lanes.json'), 'utf8').catch(() => undefined);
+    if (text === undefined)
+        throw new Error('No .ai/lanes.json here. Create one with `loop init --lanes a,b,c`.');
+    const { config, errors } = parseLanesConfig(text);
+    if (!config)
+        throw new Error(`.ai/lanes.json is invalid:\n- ${errors.join('\n- ')}`);
+    if (!config.lanes.some((l) => l.name === lane))
+        throw new Error(`No lane "${lane}". Lanes here: ${config.lanes.map((l) => l.name).join(', ')}.`);
+}
+const claimPath = (lane) => `.ai/lanes/${lane}/claim`;
+const readClaim = (dir, lane) => readFile(path.join(dir, ...claimPath(lane).split('/')), 'utf8').catch(() => undefined);
+async function pushIfWanted(dir, result, push) {
+    if (push === false)
+        return;
+    try {
+        try {
+            await git(dir, 'push');
+        }
+        catch {
+            // Five lanes push to one branch, so a rejection is routine: rebase once and retry.
+            await git(dir, 'pull', '--rebase', '-q');
+            await git(dir, 'push');
+        }
+        result.pushed = true;
+    }
+    catch (error) {
+        result.pushed = false;
+        const lines = (error instanceof Error ? error.message : String(error)).split('\n').map((l) => l.trim()).filter(Boolean);
+        result.pushError = lines.find((l) => /rejected|fatal|error:/i.test(l)) ?? lines[0] ?? 'git push failed';
+    }
+}
+async function commitTrailer(dir, lane, subject, file) {
+    await git(dir, 'commit', '-qm', `${subject}\n\nLane: ${lane}`, '--', file);
+}
+/** Writes the claim file, commits it with a `Lane:` trailer and (by default) pushes. */
+export async function runClaim(dir, lane, options = {}) {
+    await requireLane(dir, lane);
+    const now = options.now ?? new Date();
+    const minutes = options.minutes ?? 90;
+    if (!Number.isFinite(minutes) || minutes <= 0)
+        throw new Error('--minutes must be a positive number.');
+    const name = (options.as ?? (await git(dir, 'config', 'user.name').then((r) => r.stdout.trim(), () => ''))).trim();
+    if (!name || name.includes('·') || /[\r\n]/.test(name))
+        throw new Error('Say who you are with --as <name> (git user.name is not set, or contains "·").');
+    const held = activeClaim(await readClaim(dir, lane), now);
+    if (held && held.name.toLowerCase() !== name.toLowerCase() && !options.force) {
+        throw new Error(`Lane "${lane}" is claimed by ${held.name} until ${held.expiresAt.toISOString()}. Pick another lane (\`loop next\`), wait, or pass --force.`);
+    }
+    const expiresAt = new Date(now.getTime() + minutes * 60_000);
+    const file = path.join(dir, ...claimPath(lane).split('/'));
+    await mkdir(path.dirname(file), { recursive: true });
+    await writeFile(file, formatClaim(name, expiresAt));
+    await git(dir, 'add', '--', claimPath(lane));
+    await commitTrailer(dir, lane, `${lane}: claimed by ${name} until ${expiresAt.toISOString()}`, claimPath(lane));
+    const result = { lane, name, expiresAt, committed: true };
+    await pushIfWanted(dir, result, options.push);
+    return result;
+}
+/** Removes the claim file and commits that. A lane without a claim is not an error. */
+export async function runRelease(dir, lane, options = {}) {
+    await requireLane(dir, lane);
+    const text = await readClaim(dir, lane);
+    if (text === undefined)
+        return { lane, name: '', committed: false };
+    const tracked = (await git(dir, 'ls-files', '--', claimPath(lane))).stdout.trim() !== '';
+    await rm(path.join(dir, ...claimPath(lane).split('/')), { force: true });
+    if (!tracked)
+        return { lane, name: '', committed: false };
+    await git(dir, 'add', '--', claimPath(lane));
+    await commitTrailer(dir, lane, `${lane}: claim released`, claimPath(lane));
+    const result = { lane, name: '', committed: true };
+    await pushIfWanted(dir, result, options.push);
+    return result;
+}
+//# sourceMappingURL=claim.js.map

package/dist/cli/claim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim.js","sourceRoot":"","sources":["../../src/cli/claim.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAElE,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAC1C,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,GAAG,IAAc,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;AAqBpF,KAAK,UAAU,WAAW,CAAC,GAAW,EAAE,IAAY;IAClD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAChG,IAAI,IAAI,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;IAC9G,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACrF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,kBAAkB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACnJ,CAAC;AAED,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,aAAa,IAAI,QAAQ,CAAC;AAC9D,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAExI,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,MAAmB,EAAE,IAAyB;IACrF,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO;IAC3B,IAAI,CAAC;QACH,IAAI,CAAC;YACH,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,mFAAmF;YACnF,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;YACzC,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACzB,CAAC;QACD,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;QACtB,MAAM,KAAK,GAAG,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxH,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,iBAAiB,CAAC;IAC1G,CAAC;AACH,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,IAAY,EAAE,OAAe,EAAE,IAAY;IACnF,MAAM,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,OAAO,aAAa,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC7E,CAAC;AAED,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,GAAW,EAAE,IAAY,EAAE,OAAO,GAAiB,EAAE;IAClF,MAAM,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACvG,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnH,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,+EAA+E,CAAC,CAAC;IAEzJ,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1D,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC7E,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,mBAAmB,IAAI,CAAC,IAAI,UAAU,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,6DAA6D,CAAC,CAAC;IAChK,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,GAAG,MAAM,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IACpD,MAAM,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,gBAAgB,IAAI,UAAU,SAAS,CAAC,WAAW,EAAE,EAAE,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAChH,MAAM,MAAM,GAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACvE,MAAM,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,IAAY,EAAE,OAAO,GAAuB,EAAE;IAC1F,MAAM,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACpE,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IACzF,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzE,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC1D,MAAM,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7C,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,kBAAkB,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAgB,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IAChE,MAAM,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cli/doctor.js

@@ -0,0 +1,54 @@
+import { execFile } from 'node:child_process';
+import { readdir } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import { doctorPassed, evaluateDoctor, formatDoctor } from '../core/doctor.js';
+import { resolveInvocation } from './run.js';
+const execFileAsync = promisify(execFile);
+/** Runs `command args` and reports success plus its first output; never throws. */
+export async function probe(command, args) {
+    try {
+        const invocation = await resolveInvocation(command, args);
+        const { stdout, stderr } = await execFileAsync(invocation.command, invocation.args, { timeout: 15_000 });
+        return { ok: true, output: stdout.trim() || stderr.trim() };
+    }
+    catch (error) {
+        return { ok: false, output: error instanceof Error ? error.message : String(error) };
+    }
+}
+/** Folders where Playwright keeps downloaded browsers, most specific first. */
+export function playwrightCacheDirs(env, platform, home) {
+    const custom = env.PLAYWRIGHT_BROWSERS_PATH;
+    if (custom && custom !== '0')
+        return [custom];
+    if (platform === 'win32')
+        return [path.win32.join(env.LOCALAPPDATA ?? path.win32.join(home, 'AppData', 'Local'), 'ms-playwright')];
+    if (platform === 'darwin')
+        return [path.posix.join(home, 'Library', 'Caches', 'ms-playwright')];
+    return [path.posix.join(home, '.cache', 'ms-playwright'), '/opt/pw-browsers'];
+}
+export async function findChromium(dirs, list = (dir) => readdir(dir)) {
+    for (const dir of dirs) {
+        const found = (await list(dir).catch(() => [])).find((name) => /^chromium(?:_headless_shell)?-\d+$/.test(name));
+        if (found)
+            return path.join(dir, found);
+    }
+    return undefined;
+}
+export async function gatherDoctorInput() {
+    const gh = await probe('gh', ['--version']);
+    const [git, claude, ghAuth, chromium] = await Promise.all([
+        probe('git', ['--version']),
+        probe('claude', ['--version']),
+        gh.ok ? probe('gh', ['auth', 'status']) : Promise.resolve({ ok: false, output: 'gh missing' }),
+        findChromium(playwrightCacheDirs(process.env, process.platform, os.homedir())),
+    ]);
+    return { nodeVersion: process.version, git, gh, ghAuth, claude, chromium };
+}
+/** `loop doctor`: prints the report and returns whether every required tool is present. */
+export async function runDoctor(gather = gatherDoctorInput) {
+    const checks = evaluateDoctor(await gather());
+    return { report: formatDoctor(checks), passed: doctorPassed(checks) };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/doctor.js.map

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

package/dist/cli/index.js

@@ -1,11 +1,22 @@
 import { Command } from 'commander';
 import { readFileSync } from 'node:fs';
 import path from 'node:path';
+import { runClaim, runRelease } from './claim.js';
+import { runNext } from './next.js';
+import { formatNext } from '../core/next.js';
+import { formatLaneCheck, runCheckLanes } from './checkLanes.js';
+import { runDoctor } from './doctor.js';
+import { runAddLanes } from './lanesInit.js';
+import { parseLaneList } from '../core/lanesInit.js';
 import { DEFAULT_PORT, runDashboard } from './dashboard.js';
 import { realGh } from './gh.js';
 import { runInit } from './init.js';
 import { runAnswer, runNextRound, runStatus } from './loops.js';
+import { formatLaneRound, runLaneRound } from './laneRound.js';
 import { runNew } from './new.js';
+import { formatShipCheck, runShipCheck } from './shipCheck.js';
+import { formatRuns, logRun, readRuns } from './runs.js';
+import { runPause, runResume } from './pause.js';
 import { runRound } from './run.js';
 const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
 // Commands are added by the core lane: init, new, run, status, next-round, answer, dashboard.
@@ -18,8 +29,15 @@ program
     .argument('[dir]', 'target repo folder', '.')
     .option('--force', 'skip the brief check and overwrite existing kit files')
     .option('--dry-run', 'show what would be written without writing')
+    .option('--lanes <names>', 'also set up parallel lanes, e.g. --lanes core,web,docs (writes .ai/lanes.json and per-lane files)')
     .action(async (dir, options) => {
-    const result = await runInit(path.resolve(dir), { force: Boolean(options.force), dryRun: Boolean(options.dryRun) });
+    const laneList = options.lanes === undefined ? undefined : parseLaneList(options.lanes);
+    if (laneList?.error) {
+        console.error(laneList.error);
+        process.exitCode = 1;
+        return;
+    }
+    const result = await runInit(path.resolve(dir), { force: Boolean(options.force), dryRun: Boolean(options.dryRun), ...(laneList && { skipTask: true }) });
     if (result.refused) {
         console.error(result.refused);
         process.exitCode = 1;
@@ -31,6 +49,43 @@ program
         console.error('warning: the Operating Card was NOT installed, so CLAUDE.md is unchanged.');
     for (const rel of result.missing)
         console.error(`warning: ${rel} is not in this package yet; used a built-in fallback or skipped it`);
+    if (laneList) {
+        try {
+            const lanes = await runAddLanes(path.resolve(dir), laneList.names.map((name) => ({ name, owns: [`${name}/**`] })), { force: Boolean(options.force), dryRun: Boolean(options.dryRun), existingOk: true });
+            for (const action of lanes.actions)
+                console.log(`${action.kind.padEnd(9)} ${action.dest}${action.reason ? `  (${action.reason})` : ''}`);
+            for (const rel of lanes.missing)
+                console.error(`warning: ${rel} is not in this package yet; used a built-in fallback`);
+            console.log('Each lane owns `<name>/**` for now: edit "owns" in .ai/lanes.json to match your folders, then run `loop check-lanes`.');
+        }
+        catch (error) {
+            fail(error);
+        }
+    }
+});
+const lanesCommand = program.command('lanes').description('Manage parallel lanes (see .ai/lanes.json)');
+lanesCommand
+    .command('add')
+    .description('Add a lane that owns the given path globs, with its task file and outbox')
+    .argument('<name>', 'lane name: lowercase letters, digits, dashes')
+    .requiredOption('--owns <globs...>', 'path globs this lane owns, e.g. --owns "src/api/**" "tests/api/**"')
+    .option('--cron <cron>', 'cron expression for the lane (default: next staggered hourly minute)')
+    .option('--dir <dir>', 'repo folder', '.')
+    .option('--dry-run', 'show what would be written without writing')
+    .action(async (name, options) => {
+    try {
+        const parsed = parseLaneList(name);
+        if (parsed.error || parsed.names.length !== 1)
+            throw new Error(parsed.error ?? 'Add one lane at a time.');
+        const lanes = await runAddLanes(path.resolve(options.dir), [{ name, owns: options.owns, ...(options.cron && { cron: options.cron }) }], { force: false, dryRun: Boolean(options.dryRun) });
+        for (const action of lanes.actions)
+            console.log(`${action.kind.padEnd(9)} ${action.dest}${action.reason ? `  (${action.reason})` : ''}`);
+        for (const rel of lanes.missing)
+            console.error(`warning: ${rel} is not in this package yet; used a built-in fallback`);
+    }
+    catch (error) {
+        fail(error);
+    }
 });
 program
     .command('new')
@@ -69,11 +124,19 @@ program
 });
 program
     .command('next-round')
-    .description('After DONE.md: archive it as .ai/done-vN.md and write the next round\'s task.md from its "next 10" list')
+    .description('After DONE.md: archive it as .ai/done-vN.md and write the next round\'s task.md from its "next 10" list. With --brief in a laned repo: put the brief first in IDEA.md, archive every DONE.md, reset each lane\'s task file')
     .argument('[dir]', 'loop folder', '.')
     .option('--dry-run', 'report what would happen without writing')
+    .option('--brief <file>', 'laned repos: the next round\'s brief (scored first)')
+    .option('--no-commit', 'with --brief: write the changes but do not commit')
+    .option('--json', 'with --brief: print the plan as JSON (shape: RoundPlan in src/core/laneRound.ts)')
     .action(async (dir, options) => {
     try {
+        if (options.brief) {
+            const result = await runLaneRound(path.resolve(dir), { briefFile: options.brief, dryRun: Boolean(options.dryRun), commit: options.commit });
+            console.log(options.json ? JSON.stringify(result, null, 2) : formatLaneRound(result, Boolean(options.dryRun)));
+            return;
+        }
         const result = await runNextRound(path.resolve(dir), { dryRun: Boolean(options.dryRun) });
         console.log(`${options.dryRun ? 'Would archive' : 'Archived'} DONE.md as .ai/${result.archivedAs}; next round has ${result.units} units.`);
     }
@@ -87,13 +150,17 @@ program
     .argument('[answer]', 'your answer; omit with --accept to take the agent\'s best guess')
     .option('--accept', 'accept the best guess in BLOCKED.md')
     .option('--dir <dir>', 'loop folder', '.')
+    .option('--push', 'push the commit so the loop restarts without another step')
     .option('--dry-run', 'show the question and answer without writing')
     .action(async (answer, options) => {
     try {
         if (!options.accept && !answer)
             throw new Error('Pass an answer, or --accept to take the best guess.');
-        const result = await runAnswer(path.resolve(options.dir), options.accept ? 'accept' : (answer ?? ''), { dryRun: Boolean(options.dryRun) });
-        console.log(`Question: ${result.question}\nAnswer:   ${result.answer}${options.dryRun ? '\n(dry run: nothing written)' : '\nCommitted. Push to restart the loop.'}`);
+        const result = await runAnswer(path.resolve(options.dir), options.accept ? 'accept' : (answer ?? ''), { dryRun: Boolean(options.dryRun), push: Boolean(options.push) });
+        const ending = options.dryRun ? '\n(dry run: nothing written)' : result.pushed ? '\nCommitted and pushed. The loop restarts on its next run.' : result.pushed === false ? `\nCommitted, but the push failed: ${result.pushError}\nFix that (for a rejected push: \`git pull --rebase && git push\`) to restart the loop.` : '\nCommitted. Push (or use --push next time) to restart the loop.';
+        console.log(`Question: ${result.question}\nAnswer:   ${result.answer}${ending}`);
+        if (result.pushed === false)
+            process.exitCode = 1;
     }
     catch (error) {
         fail(error);
@@ -106,10 +173,14 @@ program
     .option('--dry-run', 'print the prompt and stop; never starts claude')
     .option('--skip-permissions', 'pass --dangerously-skip-permissions to claude (you accept the risk)')
     .option('--model <model>', 'model for this round')
+    .option('--lane <name>', 'run as this lane from .ai/lanes.json (own task file, outbox and session lock)')
+    .option('--as <name>', 'your name for lane claims: a claim by this name does not stop the run')
     .action(async (dir, options) => {
     try {
         const result = await runRound(path.resolve(dir), {
             dryRun: Boolean(options.dryRun), skipPermissions: Boolean(options.skipPermissions), ...(options.model && { model: options.model }),
+            ...(options.lane && { lane: options.lane }),
+            ...(options.as && { as: options.as }),
         });
         if (result.skipped)
             console.log(result.skipped);
@@ -140,5 +211,183 @@ program
         fail(error);
     }
 });
+program
+    .command('check-lanes')
+    .description('Fail if a commit with a "Lane: <name>" trailer touched files outside its lane (see .ai/lanes.json)')
+    .argument('[dir]', 'repo folder', '.')
+    .option('--range <range>', 'commits to check, e.g. origin/main..HEAD (default: the last 50)')
+    .action(async (dir, options) => {
+    try {
+        const result = await runCheckLanes(path.resolve(dir), options.range);
+        console.log(formatLaneCheck(result));
+        if (result.problems.length > 0)
+            process.exitCode = 1;
+    }
+    catch (error) {
+        fail(error);
+    }
+});
+program
+    .command('doctor')
+    .description('Check that node, git, gh, claude and Playwright Chromium are installed, and say how to fix what is not')
+    .action(async () => {
+    try {
+        const { report, passed } = await runDoctor();
+        console.log(report);
+        if (!passed)
+            process.exitCode = 1;
+    }
+    catch (error) {
+        fail(error);
+    }
+});
+const pushNote = (r) => (r.pushed === false ? `\nCommitted, but the push failed: ${r.pushError}\nFix that (for a rejected push: \`git pull --rebase && git push\`) so teammates see it.` : '');
+program
+    .command('claim')
+    .description('Tell teammates you are working a lane: writes .ai/lanes/<lane>/claim, commits and pushes it')
+    .argument('<lane>', 'lane name from .ai/lanes.json')
+    .option('--as <name>', 'your name (default: git config user.name)')
+    .option('--minutes <n>', 'how long the claim lasts', '90')
+    .option('--force', 'take over a lane someone else has claimed')
+    .option('--no-push', 'commit but do not push')
+    .option('--dir <dir>', 'repo folder', '.')
+    .action(async (lane, options) => {
+    try {
+        const r = await runClaim(path.resolve(options.dir), lane, { ...(options.as && { as: options.as }), minutes: Number(options.minutes), force: Boolean(options.force), push: options.push });
+        console.log(`Claimed ${r.lane} as ${r.name} until ${r.expiresAt?.toISOString()}.${pushNote(r)}`);
+        if (r.pushed === false)
+            process.exitCode = 1;
+    }
+    catch (error) {
+        fail(error);
+    }
+});
+program
+    .command('release')
+    .description('Remove your claim on a lane (commits and pushes)')
+    .argument('<lane>', 'lane name from .ai/lanes.json')
+    .option('--no-push', 'commit but do not push')
+    .option('--dir <dir>', 'repo folder', '.')
+    .action(async (lane, options) => {
+    try {
+        const r = await runRelease(path.resolve(options.dir), lane, { push: options.push });
+        console.log(r.committed ? `Released ${lane}.${pushNote(r)}` : `Lane ${lane} had no committed claim; nothing to release.`);
+        if (r.pushed === false)
+            process.exitCode = 1;
+    }
+    catch (error) {
+        fail(error);
+    }
+});
+program
+    .command('next')
+    .description('List open units across all lanes with their claims, and recommend one nobody has claimed')
+    .argument('[dir]', 'repo folder', '.')
+    .option('--json', 'print the report as JSON (shape: NextReport in src/core/types.ts)')
+    .action(async (dir, options) => {
+    try {
+        const report = await runNext(path.resolve(dir));
+        console.log(options.json ? JSON.stringify(report, null, 2) : formatNext(report));
+    }
+    catch (error) {
+        fail(error);
+    }
+});
+const pauseNote = (r) => (r.pushed === false ? `\nCommitted, but the push failed: ${r.pushError}\nFix that (for a rejected push: \`git pull --rebase && git push\`) so the lanes see it.` : '');
+program
+    .command('pause')
+    .description('Stop every lane run and the control room: writes .ai/PAUSED, commits (Lane: control) and pushes')
+    .option('--reason <text>', 'why (shown on the dashboard)')
+    .option('--as <name>', 'your name (default: git config user.name)')
+    .option('--no-push', 'commit but do not push')
+    .option('--dir <dir>', 'repo folder', '.')
+    .action(async (options) => {
+    try {
+        const r = await runPause(path.resolve(options.dir), { ...(options.reason && { reason: options.reason }), ...(options.as && { as: options.as }), push: options.push });
+        console.log(r.changed ? `Paused. Scheduled runs now stop at their first step; \`loop resume\` undoes it.${pauseNote(r)}` : `Already paused by ${r.by}.`);
+        if (r.pushed === false)
+            process.exitCode = 1;
+    }
+    catch (error) {
+        fail(error);
+    }
+});
+program
+    .command('resume')
+    .description('Undo `loop pause`: removes .ai/PAUSED, commits (Lane: control) and pushes')
+    .option('--no-push', 'commit but do not push')
+    .option('--dir <dir>', 'repo folder', '.')
+    .action(async (options) => {
+    try {
+        const r = await runResume(path.resolve(options.dir), { push: options.push });
+        console.log(r.changed ? `Resumed.${pauseNote(r)}` : 'Not paused; nothing to do.');
+        if (r.pushed === false)
+            process.exitCode = 1;
+    }
+    catch (error) {
+        fail(error);
+    }
+});
+program
+    .command('ship-check')
+    .description('Is this repo ready to release? Checks DONE.md, open findings, CHANGELOG, the tag, a clean tree and the latest test result; exit 0 only if ready')
+    .argument('[dir]', 'repo folder', '.')
+    .option('--json', 'print the checklist as JSON (shape: ShipCheck in src/core/shipCheck.ts)')
+    .action(async (dir, options) => {
+    try {
+        const result = await runShipCheck(path.resolve(dir));
+        console.log(options.json ? JSON.stringify(result, null, 2) : formatShipCheck(result));
+        if (!result.ready)
+            process.exitCode = 1;
+    }
+    catch (error) {
+        fail(error);
+    }
+});
+const runsCommand = program
+    .command('runs')
+    .description('List each lane\'s logged runs and the scheduled runs that left no trace (from .ai/lanes/<lane>/runs.jsonl and each lane\'s cron)')
+    .option('--json', 'print the report as JSON (shape: RunsReport in src/cli/runs.ts)')
+    .option('--hours <n>', 'how far back to look', '24')
+    .option('--dir <dir>', 'repo folder', '.')
+    .action(async (options) => {
+    try {
+        const report = await readRuns(path.resolve(options.dir), { hours: Number(options.hours) });
+        console.log(options.json ? JSON.stringify(report, null, 2) : formatRuns(report));
+    }
+    catch (error) {
+        fail(error);
+    }
+});
+runsCommand
+    .command('log')
+    .description('Append one line to a lane\'s run log; every lane run ends with this and commits the file with its last commit')
+    .requiredOption('--lane <name>', 'lane name from .ai/lanes.json')
+    .option('--units <list...>', 'units finished this run')
+    .option('--passed <n>', 'tests passed on the last npm test')
+    .option('--failed <n>', 'tests failed on the last npm test')
+    .option('--pushed', 'this run pushed to main')
+    .option('--no-pushed', 'this run pushed nothing')
+    .option('--session <url>', 'session link or id')
+    .option('--note <text>', 'one line of context')
+    .option('--dir <dir>', 'repo folder', '.')
+    .action(async (options) => {
+    try {
+        // The parent `runs` command declares --dir too and Commander gives it the value wherever it appears.
+        const dir = options.dir !== '.' ? options.dir : (runsCommand.opts().dir);
+        const entry = await logRun(path.resolve(dir), options.lane, {
+            ...(options.units && { units: options.units }),
+            ...(options.passed !== undefined && { passed: Number(options.passed) }),
+            ...(options.failed !== undefined && { failed: Number(options.failed) }),
+            pushed: options.pushed ?? false,
+            ...(options.session && { session: options.session }),
+            ...(options.note && { note: options.note }),
+        });
+        console.log(`Logged ${entry.lane} run at ${entry.at} (${entry.pushed ? 'pushed' : 'pushed nothing'}). Commit .ai/lanes/${entry.lane}/runs.jsonl with your last commit.`);
+    }
+    catch (error) {
+        fail(error);
+    }
+});
 await program.parseAsync();
 //# sourceMappingURL=index.js.map