compounding-loop 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Minntooos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,4 +1,124 @@
-# Temporary Holding Version
+# Compounding Loop
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
-If no other versions are published within 30 days, this package and version will be deleted.
+**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
+```
+
+[![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)
+
+**[Live demo](https://minntooos.github.io/Compounding-Loop/)**: the dashboard on the real five-site data, in your browser.
+
+![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.
+
+## Proof
+
+Five calculator sites, each built by scheduled Claude Code runs working from a written brief. Numbers come from the repo data in [`demo/five-sites.json`](demo/five-sites.json).
+
+| Site | Pages | Tests passing | Commits | Rounds | Elapsed* |
+|---|---:|---:|---:|---:|---:|
+| [powerstationruntime.netlify.app](https://powerstationruntime.netlify.app) | 55 | 278 | 112 | 5 / 5 | 22 h |
+| [clearpoolmath.netlify.app](https://clearpoolmath.netlify.app) | 40 | 543 | 83 | 5 / 5 | 22 h |
+| [yarnsums.netlify.app](https://yarnsums.netlify.app) | 40 | 419 | 109 | 5 / 5 | 19 h |
+| [quiltcalculators.netlify.app](https://quiltcalculators.netlify.app) | 43 | 452 | 77 | 5 / 5 | 18 h |
+| [mathtank.netlify.app](https://mathtank.netlify.app) | 37 | 433 | 83 | 5 / 5 | 18 h |
+| **Total** | **215** | **2,125** | **464** | | |
+
+\*Wall-clock time from the first to the last commit, rounded. It is not the time a human spent: that was writing five briefs.
+
+## How it works
+
+```mermaid
+flowchart LR
+  B[Brief] --> T[task.md contract]
+  T --> R[Scheduled run]
+  R --> U[One unit of work]
+  U --> C{npm test}
+  C -- red --> X[Log under Tried, discard]
+  C -- green --> V[Reviewer subagent]
+  V --> P[Push]
+  P --> K[Retro: knowledge]
+  K --> R
+  R -. stuck .-> Q[BLOCKED.md: your inbox]
+```
+
+1. **Brief and contract.** You write what "done" means as commands that can be checked.
+2. **Scheduled runs.** A routine, a GitHub Action or `loop run` wakes up, reads its task file and does one unit at a time.
+3. **Checks decide.** The agent never declares itself done; `npm test` does.
+4. **Reviewer gate.** A fresh subagent attacks the diff before it is pushed.
+5. **Compounding.** Every run writes what it learned into a small indexed knowledge base the next run reads first.
+6. **Escalation.** When it is stuck it writes `BLOCKED.md`. You answer from the dashboard inbox or `loop answer`.
+
+## Quick start
+
+```sh
+npx compounding-loop new static-site my-site   # a new loop repo from a template
+cd my-site
+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).
+
+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?
+
+An honest comparison with `while true; do claude -p "keep going"; done`:
+
+| | Plain loop | Compounding Loop |
+|---|---|---|
+| Knows when it is done | When the model says so | When your checks pass |
+| Reviews its own work | Same context, same blind spots | A fresh reviewer must find no blockers |
+| Survives context limits | Starts cold every time | Writes a handoff the next run resumes from |
+| Learns from mistakes | No | Notes and a retro, indexed |
+| Overlapping runs | Collide on the same files | Session lock |
+| Stuck for hours | Burns budget | Run budget, then `BLOCKED.md` |
+| You can see what happened | `git log` | Fleet dashboard and inbox |
+
+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) · [Lanes](docs/lanes.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)
+
+## FAQ
+
+**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).
+
+**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.
+
+**Does it need a GitHub login?** Only to create a private repo with `loop new`; `--dry-run` and every test work offline.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

package/bin/loop.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/cli/index.js';

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/dashboard.js

@@ -0,0 +1,52 @@
+import { execFile } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+export const DEFAULT_PORT = 4321;
+/** Loads the server lazily so every other command works before (or without) the dashboard being built. */
+async function loadStartServer() {
+    const specifier = '../server/index.js';
+    try {
+        const mod = (await import(specifier));
+        if (typeof mod.startServer === 'function')
+            return mod.startServer;
+    }
+    catch (error) {
+        // Only "the server file itself is missing" is expected; a missing dependency inside it must surface as is.
+        const serverMissing = error instanceof Error && /Cannot find module|ERR_MODULE_NOT_FOUND/.test(error.message) && /server[\\/]index/.test(error.message);
+        if (!serverMissing)
+            throw error;
+    }
+    throw new Error('The dashboard server is not available in this build (src/server/index.ts must export startServer).');
+}
+/** Command and arguments that open a URL in the default browser; always an argument array, never a shell string. */
+export function browserCommand(url, platform = process.platform) {
+    if (platform === 'darwin')
+        return ['open', [url]];
+    if (platform === 'win32')
+        return ['rundll32', ['url.dll,FileProtocolHandler', url]];
+    return ['xdg-open', [url]];
+}
+function openBrowser(url) {
+    const [command, args] = browserCommand(url);
+    // Best effort: a missing opener must not stop the server, the URL is printed anyway.
+    execFile(command, args, () => undefined).on('error', () => undefined);
+}
+/** Starts the local dashboard server and (unless told not to) opens the browser. */
+export async function runDashboard(options, deps = {}) {
+    if (!Number.isInteger(options.port) || options.port < 0 || options.port > 65535) {
+        throw new Error(`"${options.port}" is not a valid port (0-65535).`);
+    }
+    const start = deps.start ?? (await loadStartServer());
+    const server = await start({ port: options.port, demo: options.demo, projectsDir: path.resolve(options.projectsDir) }).catch((error) => {
+        if (error.code === 'EADDRINUSE')
+            throw new Error(`Port ${options.port} is already in use. Pick another with --port.`);
+        throw error;
+    });
+    (deps.log ?? console.log)(`Dashboard${options.demo ? ' (demo)' : ''}: ${server.url}`);
+    if (options.open)
+        (deps.open ?? openBrowser)(server.url);
+    return server;
+}
+/** True once the server lane has shipped `startServer`; lets tests run the real thing only when it exists. */
+export const serverShipped = (root) => existsSync(path.join(root, 'src', 'server', 'index.ts'));
+//# sourceMappingURL=dashboard.js.map

package/dist/cli/dashboard.js.map

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

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/gh.js

@@ -0,0 +1,29 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/** Runs a command and rethrows with its stderr, not the raw command line execFile puts in the message. */
+async function run(command, args, cwd) {
+    try {
+        return (await execFileAsync(command, args, { cwd })).stdout;
+    }
+    catch (error) {
+        const stderr = error.stderr;
+        const detail = typeof stderr === 'string' && stderr.trim() ? stderr.trim() : error instanceof Error ? error.message : String(error);
+        throw new Error(`\`${command} ${args[0] ?? ''}\` failed: ${detail}`);
+    }
+}
+/** Uses the user's own `gh` login; no token is read, stored or logged here. */
+export const realGh = {
+    async createRepoFromFolder(folder, name, options) {
+        await run('git', ['init', '-q'], folder);
+        await run('git', ['checkout', '-q', '-B', 'main'], folder);
+        await run('git', ['add', '-A'], folder);
+        // Fresh machines often have no git identity; fall back only when none is configured.
+        const hasIdentity = await run('git', ['config', 'user.email'], folder).then((out) => out.trim() !== '', () => false);
+        const identity = hasIdentity ? [] : ['-c', 'user.name=Compounding Loop', '-c', 'user.email=loop@users.noreply.github.com'];
+        await run('git', [...identity, 'commit', '-qm', 'Start from the Compounding Loop template'], folder);
+        await run('gh', ['repo', 'create', name, options.private ? '--private' : '--public', '--source', '.', '--push'], folder);
+        return (await run('gh', ['repo', 'view', '--json', 'url', '--jq', '.url'], folder)).trim();
+    },
+};
+//# sourceMappingURL=gh.js.map

package/dist/cli/gh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gh.js","sourceRoot":"","sources":["../../src/cli/gh.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,0GAA0G;AAC1G,KAAK,UAAU,GAAG,CAAC,OAAe,EAAE,IAAc,EAAE,GAAW;IAC7D,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAI,KAA8B,CAAC,MAAM,CAAC;QACtD,MAAM,MAAM,GAAG,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpI,MAAM,IAAI,KAAK,CAAC,KAAK,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,cAAc,MAAM,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,MAAM,GAAO;IACxB,KAAK,CAAC,oBAAoB,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO;QAC9C,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3D,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACxC,qFAAqF;QACrF,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QACrH,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,4BAA4B,EAAE,IAAI,EAAE,0CAA0C,CAAC,CAAC;QAC3H,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,0CAA0C,CAAC,EAAE,MAAM,CAAC,CAAC;QACrG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACzH,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7F,CAAC;CACF,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,228 @@
+import { Command } from 'commander';
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+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 { runNew } from './new.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.
+export const program = new Command('loop')
+    .description('Unattended, verified Claude Code build loops. Write the brief, check back tomorrow.')
+    .version(pkg.version);
+program
+    .command('init')
+    .description('Add the Compounding Loop method to a repo (idempotent; never overwrites without --force)')
+    .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 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;
+        return;
+    }
+    for (const action of result.actions)
+        console.log(`${action.kind.padEnd(9)} ${action.dest}${action.reason ? `  (${action.reason})` : ''}`);
+    if (result.missing.includes('method/operating-card.md'))
+        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')
+    .description('Create a new loop repo from a template (private GitHub repo unless --dry-run)')
+    .argument('<template>', 'template name, e.g. static-site')
+    .argument('[name]', 'folder and repo name (defaults to the template name)')
+    .option('--dry-run', 'write the folder locally and never touch GitHub')
+    .option('--public', 'create the GitHub repo as public (default: private)')
+    .action(async (template, name, options) => {
+    try {
+        const result = await runNew(template, name ?? template, {
+            parentDir: process.cwd(), dryRun: Boolean(options.dryRun), publicRepo: Boolean(options.public), gh: realGh,
+        });
+        console.log(`Created ${result.dir}${result.repoUrl ? `\nGitHub: ${result.repoUrl}` : ''}`);
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    }
+});
+const fail = (error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+};
+program
+    .command('status')
+    .description('Fleet table for one or more loop folders')
+    .argument('[dirs...]', 'loop folders', ['.'])
+    .action(async (dirs) => {
+    try {
+        console.log(await runStatus(dirs.map((d) => path.resolve(d))));
+    }
+    catch (error) {
+        fail(error);
+    }
+});
+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')
+    .argument('[dir]', 'loop folder', '.')
+    .option('--dry-run', 'report what would happen without writing')
+    .action(async (dir, options) => {
+    try {
+        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.`);
+    }
+    catch (error) {
+        fail(error);
+    }
+});
+program
+    .command('answer')
+    .description('Answer a BLOCKED.md: record the answer, remove the file, commit')
+    .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), 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);
+    }
+});
+program
+    .command('run')
+    .description('Run one build round now with Claude Code, using the same prompt the scheduler uses')
+    .argument('[dir]', 'loop folder', '.')
+    .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)')
+    .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 }),
+        });
+        if (result.skipped)
+            console.log(result.skipped);
+        else if (options.dryRun)
+            console.log(`Prompt from ${result.source}:\n\n${result.prompt}`);
+        if (result.exitCode)
+            process.exitCode = result.exitCode;
+    }
+    catch (error) {
+        fail(error);
+    }
+});
+program
+    .command('dashboard')
+    .description('Start the local dashboard and open it in your browser')
+    .option('--demo', 'show the built-in snapshot of five real loops')
+    .option('--port <port>', 'port to listen on', String(DEFAULT_PORT))
+    .option('--no-open', 'do not open the browser')
+    .option('--projects <dir>', 'folder that holds your loops', '.')
+    .action(async (options) => {
+    try {
+        const server = await runDashboard({ demo: Boolean(options.demo), port: Number(options.port), open: options.open, projectsDir: options.projects });
+        for (const signal of ['SIGINT', 'SIGTERM'])
+            process.once(signal, () => void Promise.resolve(server.close()).finally(() => process.exit(0)));
+        // The server keeps the process alive; Ctrl+C stops it.
+    }
+    catch (error) {
+        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);
+    }
+});
+await program.parseAsync();
+//# sourceMappingURL=index.js.map