compounding-loop 0.2.0 → 0.5.0

package/README.md

@@ -8,7 +8,7 @@ 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.
+**[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. Steering and scheduling: [Glance, steer, sleep](#glance-steer-sleep). 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)
 
@@ -56,6 +56,18 @@ flowchart LR
 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`.
 
+## Glance, steer, sleep
+
+Leave a laned loop running, look at the dashboard, and steer it without opening a chat. The top strip says in five seconds whether anything needs you, whether lanes are running or stalled, whether runs hit the usage limit, whether CI is green and whether it is ready to ship.
+
+```sh
+npx compounding-loop steer docs "Update the README screenshots first"   # saved as a file in the repo, read at the lane's next run
+npx compounding-loop schedule snooze web 6h                             # or pause, resume, wake
+npx compounding-loop pace set sprint                                    # how much checking each run does
+```
+
+Lanes with nothing to do back off (3 h, then 6 h, then asleep until there is steering, a message or a new round), so a loop can stay on around the clock and a skipped run costs seconds. Routine prompts stay short and point at `.ai/lane-run.md`, so changing how every lane runs is one commit. Details: [Steer, schedule and pace a loop](docs/steering.md).
+
 ## Quick start
 
 ```sh
@@ -65,7 +77,9 @@ 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).
+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).
 
@@ -101,7 +115,7 @@ If you work at the keyboard and want to watch agents in parallel, those tools ar
 
 ## 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)
+[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) · [Steering](docs/steering.md) · [Release](docs/release.md) · [Templates](docs/templates.md) · [FAQ](docs/faq.md) · [Troubleshooting](docs/troubleshooting.md) · [Contributing](CONTRIBUTING.md)
 
 ## FAQ
 
@@ -117,6 +131,8 @@ If you work at the keyboard and want to watch agents in parallel, those tools ar
 
 **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.
 
+**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.
 
 ## License

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":"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"}

package/dist/cli/draft.js

@@ -0,0 +1,69 @@
+import { execFile } from 'node:child_process';
+import { mkdir, readFile, readdir, stat, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { lintBrief } from '../core/brief.js';
+import { buildDraftPrompt, draftClaudeArgs, extractOpenFindings, extractOutOfScope, nextRoundNumber } from '../core/draftBrief.js';
+import { parseLanesConfig } from '../core/lanes.js';
+import { parseSteer, steerPath, unacknowledged } from '../core/parse/steer.js';
+import { extractNextItems } from '../core/rounds.js';
+import { resolveInvocation } from './run.js';
+export const DRAFT_FILE = '.ai/next-round.draft.md';
+const read = (dir, rel) => readFile(path.join(dir, ...rel.split('/')), 'utf8').catch(() => undefined);
+export const realClaude = async (rawArgs, cwd) => {
+    const { command, args } = await resolveInvocation('claude', rawArgs);
+    return new Promise((resolve, reject) => {
+        execFile(command, args, { cwd, maxBuffer: 16 * 1024 * 1024, timeout: 15 * 60_000 }, (error, stdout) => {
+            if (error)
+                reject(new Error(`Could not run \`claude -p\`: ${error.message}. Is Claude Code installed, on your PATH and signed in? \`loop next-round --draft --print-prompt\` prints the prompt to paste yourself.`));
+            else
+                resolve(stdout);
+        });
+    });
+};
+/** Collects the ingredients: DONE.md next-10 lists, open audit findings, unacknowledged steer, the old out-of-scope. */
+export async function gatherDraftPrompt(dir) {
+    const idea = (await read(dir, 'IDEA.md')) ?? '';
+    const lanes = parseLanesConfig((await read(dir, '.ai/lanes.json')) ?? '').config?.lanes.map((l) => l.name) ?? [];
+    const next = [];
+    for (const source of ['DONE.md', ...lanes.map((l) => `.ai/lanes/${l}/DONE.md`)]) {
+        const items = extractNextItems((await read(dir, source)) ?? '');
+        if (items.length)
+            next.push({ source, items });
+    }
+    const findings = [];
+    for (const file of (await readdir(path.join(dir, '.ai', 'audit')).catch(() => [])).filter((f) => f.endsWith('.md')).sort()) {
+        findings.push(...extractOpenFindings(`.ai/audit/${file}`, (await read(dir, `.ai/audit/${file}`)) ?? ''));
+    }
+    const steer = [];
+    for (const lane of lanes) {
+        const entries = unacknowledged(parseSteer((await read(dir, steerPath(lane))) ?? ''));
+        if (entries.length)
+            steer.push({ lane, entries });
+    }
+    const name = path.basename(dir);
+    return buildDraftPrompt({ name, round: nextRoundNumber(idea), next, findings, steer, outOfScope: extractOutOfScope(idea) });
+}
+/** The draft goes inside the repo, as a new .md file (only the default draft file may be overwritten). */
+async function assertDraftTarget(dir, outFile, isDefault) {
+    const rel = path.relative(path.resolve(dir), outFile);
+    if (rel.startsWith('..') || path.isAbsolute(rel) || !/\.md$/i.test(outFile))
+        throw new Error(`--out must be a .md file inside ${dir}, not ${outFile}.`);
+    if (!isDefault && (await stat(outFile).then(() => true, () => false)))
+        throw new Error(`${rel} already exists; pick a new file name for the draft (nothing is overwritten).`);
+}
+/** `loop next-round --draft`: builds the prompt, runs `claude -p` through the usual runner, writes the draft and scores it. */
+export async function runDraft(dir, options = {}) {
+    const prompt = await gatherDraftPrompt(dir);
+    if (options.printPrompt)
+        return { prompt };
+    const draft = (await (options.claude ?? realClaude)(draftClaudeArgs(prompt, options.model), dir)).trim();
+    if (!draft)
+        throw new Error('Claude returned an empty draft. Run again, or use --print-prompt and paste the prompt into Claude Code yourself.');
+    const rel = options.out ?? DRAFT_FILE;
+    const outFile = path.resolve(dir, rel);
+    await assertDraftTarget(dir, outFile, rel === DRAFT_FILE);
+    await mkdir(path.dirname(outFile), { recursive: true });
+    await writeFile(outFile, `${draft}\n`);
+    return { prompt, draft, outFile, lint: lintBrief(draft) };
+}
+//# sourceMappingURL=draft.js.map

package/dist/cli/draft.js.map

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

package/dist/cli/index.js

@@ -1,6 +1,9 @@
 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';
@@ -9,8 +12,15 @@ 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';
+import { runDraft } from './draft.js';
+import { formatPaceReport, runPaceSet, runPaceShow } from './pace.js';
+import { formatScheduleReport, runScheduleAction, runScheduleShow, runScheduleUpdate, runSteer } from './schedule.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')
@@ -117,11 +127,31 @@ 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)')
+    .option('--draft', 'ask Claude (claude -p) to draft the next brief from the DONE.md lists, open audit findings and steering; writes it and prints its score')
+    .option('--out <file>', 'with --draft: where the draft goes (default .ai/next-round.draft.md)')
+    .option('--print-prompt', 'with --draft: print the prompt only, to paste into Claude Code yourself')
+    .option('--model <model>', 'with --draft: the Claude model to use')
     .action(async (dir, options) => {
     try {
+        if (options.draft || options.printPrompt) {
+            const r = await runDraft(path.resolve(dir), { ...(options.printPrompt && { printPrompt: true }), ...(options.out && { out: options.out }), ...(options.model && { model: options.model }) });
+            if (!r.draft)
+                console.log(r.prompt);
+            else
+                console.log(`Draft written to ${path.relative(process.cwd(), r.outFile) || r.outFile}. Brief score ${r.lint?.score}/100${r.lint?.gaps.length ? `; missing: ${r.lint.gaps.map((g) => g.message).join(' ')}` : ''}\nReview it, then: loop next-round --brief ${options.out ?? '.ai/next-round.draft.md'}`);
+            return;
+        }
+        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.`);
     }
@@ -159,11 +189,13 @@ program
     .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);
@@ -224,5 +256,256 @@ program
         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);
+    }
+});
+const scheduleNote = (r) => (r.pushed === false ? `\nCommitted, but the push failed: ${r.pushError}` : '');
+const scheduleCmd = program.command('schedule').description('Which lanes are due (.ai/schedule.json): show, pause, resume, snooze, wake, update');
+const scheduleOpts = (c) => c.option('--no-commit', 'write the file but do not commit').option('--no-push', 'commit but do not push').option('--dir <dir>', 'repo folder', '.');
+scheduleCmd
+    .command('show')
+    .description('Each lane: due, paused, sleeping or snoozed, with idle runs')
+    .option('--json', 'print the report as JSON (shape: ScheduleReport in src/cli/schedule.ts)')
+    .option('--dir <dir>', 'repo folder', '.')
+    .action(async (options) => {
+    try {
+        const report = await runScheduleShow(path.resolve(options.dir));
+        console.log(options.json ? JSON.stringify(report, null, 2) : formatScheduleReport(report));
+    }
+    catch (error) {
+        fail(error);
+    }
+});
+const simple = (name, args, description, build, withReason) => {
+    const c = scheduleOpts(scheduleCmd.command(`${name} ${args}`).description(description));
+    if (withReason)
+        c.option('--reason <text>', 'why');
+    c.action(async (...argv) => {
+        const opts = argv[argv.length - 2];
+        const positional = argv.slice(0, -2);
+        try {
+            const r = await runScheduleAction(path.resolve(opts.dir), build(positional, opts), { commit: opts.commit, push: opts.push });
+            console.log(r.changed.length ? `${name}: ${r.changed.join(', ')}${scheduleNote(r)}` : `${name}: nothing to change.`);
+            if (r.pushed === false)
+                process.exitCode = 1;
+        }
+        catch (error) {
+            fail(error);
+        }
+    });
+};
+simple('pause', '<lane>', 'Hold a lane back until it is resumed', ([lane], o) => ({ action: 'pause', lane: lane, ...(o.reason && { reason: o.reason }) }), true);
+simple('resume', '<lane>', 'Undo `schedule pause`', ([lane]) => ({ action: 'resume', lane: lane }), false);
+simple('snooze', '<lane> <until>', 'Hold a lane back until a time (ISO, a date, or 3h / 2d)', ([lane, until], o) => ({ action: 'snooze', lane: lane, until: until, ...(o.reason && { reason: o.reason }) }), true);
+simple('wake', '<lane|all>', 'Make a sleeping or snoozed lane due now', ([lane]) => ({ action: 'wake', lane: lane }), false);
+scheduleOpts(scheduleCmd.command('update').description('Idle backoff from the run logs, and wake lanes that have steering, a message or a new round'))
+    .option('--new-round', 'a new round started: wake every lane')
+    .option('--lane <name>', 'change only this lane\'s entry and commit as that lane (the end-of-run backoff)')
+    .action(async (options) => {
+    try {
+        const r = await runScheduleUpdate(path.resolve(options.dir), { commit: options.commit, push: options.push, ...(options.newRound && { newRound: true }), ...(options.lane && { lane: options.lane }) });
+        console.log(r.changed.length ? `update: ${r.changed.join(', ')}${scheduleNote(r)}` : 'update: nothing to change.');
+        if (r.pushed === false)
+            process.exitCode = 1;
+    }
+    catch (error) {
+        fail(error);
+    }
+});
+const paceCmd = program.command('pace').description('How much checking a run does (.ai/policy.json): show, set');
+paceCmd
+    .command('show')
+    .description('The global pace and any lane overrides, with what each skips')
+    .option('--json', 'print the report as JSON (shape: PaceReport in src/cli/pace.ts)')
+    .option('--dir <dir>', 'repo folder', '.')
+    .action(async (options) => {
+    try {
+        const report = await runPaceShow(path.resolve(options.dir));
+        console.log(options.json ? JSON.stringify(report, null, 2) : formatPaceReport(report));
+    }
+    catch (error) {
+        fail(error);
+    }
+});
+scheduleOpts(paceCmd.command('set').description('Set the pace: careful, balanced, fast or sprint (commits with Lane: control)'))
+    .argument('<preset>', 'careful | balanced | fast | sprint')
+    .option('--lane <name>', 'override only this lane')
+    .action(async (preset, options) => {
+    try {
+        const r = await runPaceSet(path.resolve(options.dir), preset, { commit: options.commit, push: options.push, ...(options.lane && { lane: options.lane }) });
+        console.log(r.changed.length ? `pace: ${preset}${options.lane ? ` for ${options.lane}` : ''}${scheduleNote(r)}` : 'pace: nothing to change.');
+        if (r.pushed === false)
+            process.exitCode = 1;
+    }
+    catch (error) {
+        fail(error);
+    }
+});
+program
+    .command('steer')
+    .description('Leave a note for a lane in .ai/lanes/<lane>/steer.md, wake the lane and commit (Lane: control)')
+    .argument('<lane>', 'lane name')
+    .argument('<text>', 'what the lane should do')
+    .option('--standing', 'applies to every run until removed (default: the next run only)')
+    .option('--author <name>', 'your name (default: git config user.name)')
+    .option('--no-commit', 'write the file but do not commit')
+    .option('--no-push', 'commit but do not push')
+    .option('--dir <dir>', 'repo folder', '.')
+    .action(async (lane, text, options) => {
+    try {
+        const r = await runSteer(path.resolve(options.dir), lane, text, { commit: options.commit, push: options.push, ...(options.standing && { standing: true }), ...(options.author && { author: options.author }) });
+        console.log(`Steer saved for ${lane}${options.standing ? ' (standing)' : ''}.${scheduleNote(r)}`);
+        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