compounding-loop 0.0.0-stage → 0.2.0

package/dist/core/lanesInit.js

@@ -0,0 +1,143 @@
+// Planning for `loop init --lanes` and `loop lanes add`: decides what to write, without touching the disk.
+import { fillPlaceholders } from './template.js';
+import { isValidLaneName, normalizePath, validateLanesConfig } from './lanes.js';
+export const LANES_START = '<!-- compounding-loop:lanes:start -->';
+export const LANES_END = '<!-- compounding-loop:lanes:end -->';
+/** Shared files every new laned repo starts with; the user edits `.ai/lanes.json` to taste. */
+export const DEFAULT_SHARED = ['package.json', 'package-lock.json', '.gitignore', '.ai/audit/**'];
+// Used when the package has no templates/lanes/ files, so init never fails on a half-installed kit.
+export const FALLBACK_LANE_TEMPLATES = {
+    task: `# Lane: {{lane}}
+
+Run: 0 / 20
+Status: not started
+
+## Contract
+**Goal:**
+**Done when:**
+**Constraints:** edit only the paths this lane owns in \`.ai/lanes.json\`: {{owns}}
+**Out of scope:**
+
+## Units, in order
+1.
+
+## Decisions
+
+## Confirmed
+
+## Guesses
+
+## Tried
+
+## Handoff
+`,
+    outbox: `# Outbox: {{lane}}
+
+Newest first. Format: \`YYYY-MM-DD HH:MM UTC · to <lane|all> · message\`.
+`,
+    controlRoom: `# Control room notes
+
+Written only by the control room routine. Every lane reads it at the start of a run. Newest first. Format: \`YYYY-MM-DD HH:MM UTC · to <lane|all> · message\`.
+`,
+    claudeSection: `## Lanes
+
+Lanes in this repo: {{lanes}}. \`.ai/lanes.json\` says who owns which paths; read it first. Edit only your lane's paths (and the shared ones). Every commit ends with a trailer line \`Lane: <your lane>\`; \`loop check-lanes\` fails a commit that crosses lanes.
+
+Talk to other lanes by writing to your own \`.ai/lanes/<you>/outbox.md\` (newest first). At the start of each run read every other lane's outbox and \`.ai/control-room.md\`. Your task file is \`.ai/lanes/<you>/task.md\`.
+`,
+};
+/** Staggered hourly cron minutes (7, 19, 31, 43, 55, ...) so lanes never start together. */
+export function staggeredCron(index) {
+    return `${(7 + 12 * index) % 60} * * * *`;
+}
+/** Parses `a,b,c` into lane names; returns the first problem as `error`. */
+export function parseLaneList(list) {
+    const names = list.split(',').map((n) => n.trim()).filter(Boolean);
+    if (names.length === 0)
+        return { names, error: 'Give at least one lane name, e.g. --lanes core,web.' };
+    for (const name of names) {
+        if (!isValidLaneName(name))
+            return { names, error: `"${name}" is not a valid lane name: use lowercase letters, digits and dashes, starting with a letter ("control" is reserved).` };
+    }
+    const dupe = names.find((n, i) => names.indexOf(n) !== i);
+    return dupe ? { names, error: `Lane "${dupe}" is listed twice.` } : { names };
+}
+/** Slash-separated and repo-relative: a Windows-style or absolute glob would be stored but could never match. */
+function checkedGlob(lane, glob) {
+    const normalized = normalizePath(glob);
+    if (/^[a-z]:/i.test(normalized) || glob.trim().startsWith('/') || normalized.split('/').includes('..')) {
+        throw new Error(`Lane "${lane}": "${glob}" must be a path relative to the repo root, like src/api/**.`);
+    }
+    return normalized;
+}
+/** Lanes to add to `existing` (undefined = new config); throws with the reason when the result would be invalid. */
+export function addLanes(existing, additions) {
+    const base = existing ?? { lanes: [], shared: [...DEFAULT_SHARED] };
+    additions = additions.map((lane) => ({ ...lane, owns: lane.owns.map((glob) => checkedGlob(lane.name, glob)) }));
+    for (const lane of additions) {
+        if (base.lanes.some((l) => l.name === lane.name))
+            throw new Error(`Lane "${lane.name}" already exists in .ai/lanes.json. Pick another name or edit the file.`);
+    }
+    const next = { lanes: [...base.lanes, ...additions], shared: base.shared };
+    const { errors } = validateLanesConfig(next);
+    if (errors.length > 0)
+        throw new Error(errors.join('\n'));
+    return next;
+}
+/** Same shape as `mergeCard`: re-running is a no-op, and a broken marker pair is reported, not guessed at. */
+export function mergeLanesSection(existing, section, fileName = 'CLAUDE.md') {
+    const block = `${LANES_START}\n${section.trim()}\n${LANES_END}\n`;
+    if (existing === undefined || existing.trim() === '')
+        return block;
+    const start = existing.indexOf(LANES_START);
+    const end = existing.indexOf(LANES_END);
+    if ((start === -1) !== (end === -1) || (start !== -1 && end < start)) {
+        throw new Error(`${fileName} has a broken ${LANES_START} / ${LANES_END} pair: fix or remove the markers, then re-run.`);
+    }
+    if (start !== -1)
+        return existing.slice(0, start) + block + existing.slice(end + LANES_END.length).replace(/^\r?\n/, '');
+    return `${existing.replace(/\s*$/, '')}\n\n${block}`;
+}
+/**
+ * Files for a laned repo. Config is rewritten only when it changed; task, outbox and control-room files are loop
+ * state, created if absent and never overwritten, even with `force`.
+ */
+export function planLanes({ config, newLanes, templates, existing, force }) {
+    const actions = [];
+    const json = `${JSON.stringify(config, null, 2)}\n`;
+    const current = existing.get('.ai/lanes.json');
+    if (current === undefined)
+        actions.push({ dest: '.ai/lanes.json', kind: 'create', content: json });
+    else if (current === json)
+        actions.push({ dest: '.ai/lanes.json', kind: 'skip', reason: 'already up to date' });
+    else if (force || newLanes.length > 0)
+        actions.push({ dest: '.ai/lanes.json', kind: 'update', content: json });
+    else
+        actions.push({ dest: '.ai/lanes.json', kind: 'skip', reason: 'exists with different lanes (use --force to replace, or `loop lanes add`)' });
+    const state = (dest, content) => {
+        if (existing.has(dest))
+            actions.push({ dest, kind: 'skip', reason: 'loop state, never overwritten' });
+        else
+            actions.push({ dest, kind: 'create', content });
+    };
+    for (const name of newLanes) {
+        const lane = config.lanes.find((l) => l.name === name);
+        const vars = { lane: name, owns: lane ? lane.owns.join(', ') : '', lanes: config.lanes.map((l) => l.name).join(', ') };
+        state(`.ai/lanes/${name}/task.md`, fillPlaceholders(templates.task, vars));
+        state(`.ai/lanes/${name}/outbox.md`, fillPlaceholders(templates.outbox, vars));
+    }
+    state('.ai/control-room.md', templates.controlRoom);
+    const section = fillPlaceholders(templates.claudeSection, { lanes: config.lanes.map((l) => l.name).join(', ') });
+    // AGENTS.md is merged only when the repo already has one; CLAUDE.md is always installed.
+    const instructionFiles = existing.has('AGENTS.md') ? ['CLAUDE.md', 'AGENTS.md'] : ['CLAUDE.md'];
+    for (const dest of instructionFiles) {
+        const current = existing.get(dest);
+        const merged = mergeLanesSection(current, section, dest);
+        if (merged === current)
+            actions.push({ dest, kind: 'skip', reason: 'lane section already installed' });
+        else
+            actions.push({ dest, kind: current === undefined ? 'create' : 'update', content: merged });
+    }
+    return actions;
+}
+//# sourceMappingURL=lanesInit.js.map

package/dist/core/lanesInit.js.map

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

package/dist/core/repo.js

@@ -0,0 +1,81 @@
+import { execFile } from 'node:child_process';
+import { readdir, readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+/** Reads the `Run: N / LIMIT` line of a task.md; undefined when the line is missing or malformed. */
+export function parseRunCounter(taskText) {
+    const match = /^Run:\s*(\d+)\s*\/\s*(\d+)\b/m.exec(taskText);
+    if (!match)
+        return undefined;
+    return { run: Number(match[1]), limit: Number(match[2]) };
+}
+/** Parses the single UTC timestamp line of `.ai/session.lock`; undefined when it is not a valid date. */
+export function parseLockTime(lockText) {
+    const line = lockText.trim().split(/\r?\n/)[0]?.trim();
+    if (!line)
+        return undefined;
+    // The lock is documented as UTC; a bare "2026-10-08 05:00" would otherwise parse as local time.
+    const hasZone = /(?:Z|[+-]\d{2}:?\d{2})$/i.test(line);
+    const at = new Date(hasZone ? line : `${line.replace(' ', 'T')}Z`);
+    return Number.isNaN(at.getTime()) ? undefined : at;
+}
+/** Counts file names like `done-v1.md`, `done-v2.md`. */
+export function countDoneRounds(fileNames) {
+    return fileNames.filter((name) => /^done-v\d+\.md$/.test(name)).length;
+}
+async function exists(file) {
+    try {
+        await stat(file);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readOptional(file) {
+    try {
+        return await readFile(file, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Commit time of HEAD, or undefined when the folder is not a git repo or has no commits. */
+export async function readLastCommitAt(dir) {
+    try {
+        const { stdout } = await execFileAsync('git', ['log', '-1', '--format=%cI'], {
+            cwd: dir,
+            // Stop git walking up into a parent repo: a folder that is not itself a repo has no commits.
+            env: { ...process.env, GIT_CEILING_DIRECTORIES: path.dirname(path.resolve(dir)) },
+        });
+        const at = new Date(stdout.trim());
+        return Number.isNaN(at.getTime()) ? undefined : at;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Reads one loop's facts from its folder. Health failures are filled in by the health checks, not here. */
+export async function readLoopFacts(dir) {
+    const aiDir = path.join(dir, '.ai');
+    const aiFiles = await readdir(aiDir).catch(() => []);
+    const lockText = await readOptional(path.join(aiDir, 'session.lock'));
+    const lockAt = lockText === undefined ? undefined : parseLockTime(lockText);
+    const lastCommitAt = await readLastCommitAt(dir);
+    return {
+        // The stop files sit at the repo root, per CLAUDE.md "Unattended mode".
+        hasBlocked: await exists(path.join(dir, 'BLOCKED.md')),
+        hasDone: await exists(path.join(dir, 'DONE.md')),
+        roundsDone: countDoneRounds(aiFiles),
+        ...(lockAt && { lockAt }),
+        ...(lastCommitAt && { lastCommitAt }),
+        healthFailures: [],
+    };
+}
+/** Reads `Run: N / LIMIT` from a loop's `.ai/task.md`. */
+export async function readRunCounter(dir) {
+    const text = await readOptional(path.join(dir, '.ai', 'task.md'));
+    return text === undefined ? undefined : parseRunCounter(text);
+}
+//# sourceMappingURL=repo.js.map

package/dist/core/repo.js.map

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

package/dist/core/rounds.js

@@ -0,0 +1,50 @@
+import { listItems } from './brief.js';
+/** Items under the "next 10 improvements" heading of a DONE.md; empty when the section is missing. */
+export function extractNextItems(doneText) {
+    const lines = doneText.split(/\r?\n/);
+    // Any heading about what comes next ("Next 10 improvements", "Ten best next pages", "Next steps").
+    const start = lines.findIndex((line) => /^#{1,6}\s+.*\b(next|ten best)\b/i.test(line));
+    if (start === -1)
+        return [];
+    const rest = lines.slice(start + 1);
+    const end = rest.findIndex((line) => /^#{1,6}\s/.test(line));
+    return listItems((end === -1 ? rest : rest.slice(0, end)).join('\n'));
+}
+/** Next archive name: one above the highest existing `done-vN.md` (so gaps never collide). */
+export function nextDoneFileName(fileNames) {
+    const numbers = fileNames.flatMap((name) => {
+        const match = /^done-v(\d+)\.md$/.exec(name);
+        return match ? [Number(match[1])] : [];
+    });
+    return `done-v${Math.max(0, ...numbers) + 1}.md`;
+}
+/** Writes the next round's task.md from the items; `round` is the number of the round being started. */
+export function buildNextRoundTask(items, round, runLimit = 30) {
+    const units = items.map((item, i) => `${i + 1}. ${item}`).join('\n');
+    return `# TASK: Round ${round}, improvements from the previous DONE.md
+
+Run: 0 / ${runLimit}
+Status: not started
+
+## Contract
+- Goal: ship the units below, most valuable first, without breaking what already passes.
+- Done when: \`npm test\` passes and every unit has a test that proves it.
+- Constraints: see CLAUDE.md hard rules.
+- Out of scope: anything not listed under Units.
+
+## Units, in order
+${units}
+
+## Decisions
+
+## Confirmed
+
+## Guesses
+
+## Tried
+
+## Handoff
+(each run ends by writing: where it stopped, the exact next step, anything half-done)
+`;
+}
+//# sourceMappingURL=rounds.js.map

package/dist/core/rounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rounds.js","sourceRoot":"","sources":["../../src/core/rounds.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,sGAAsG;AACtG,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtC,mGAAmG;IACnG,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kCAAkC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACvF,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,OAAO,SAAS,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,gBAAgB,CAAC,SAA4B;IAC3D,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACzC,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IACH,OAAO,SAAS,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;AACnD,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,kBAAkB,CAAC,KAAwB,EAAE,KAAa,EAAE,QAAQ,GAAG,EAAE;IACvF,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,OAAO,iBAAiB,KAAK;;WAEpB,QAAQ;;;;;;;;;;EAUjB,KAAK;;;;;;;;;;;;CAYN,CAAC;AACF,CAAC"}

package/dist/core/runPrompt.js

@@ -0,0 +1,31 @@
+import { fillPlaceholders } from './template.js';
+/** Used only when neither the repo nor the package ships a prompt file. A copy of runners/routine/prompt.md; a test keeps them equal. */
+export const DEFAULT_PROMPT = `You are one scheduled run of the build loop for this repository ({{name}}). Nobody is watching; the owner reads the results later. Read CLAUDE.md and follow it exactly, especially "Unattended mode". IDEA.md is the brief. Your task file is \`.ai/task.md\`.
+
+0. Run \`date -u\` and note it as this run's start time. Run \`git checkout main && git pull --ff-only\`. Every commit goes to \`main\` and is pushed with \`git push origin main\`. Never create or push a \`claude/\` branch: the next run starts from \`main\` and would never see it. If a push is rejected, run \`git pull --rebase\`, re-run the checks if incoming commits touched code, and push again.
+1. Session lock: if \`.ai/session.lock\` holds a UTC time less than 90 minutes old, another session owns the repo, unless the lock is your own (the runner's run note says so when the loop runner created it). Otherwise reply "Nothing to do" and stop. If the file is older than that, it is stale: ignore it.
+2. If \`DONE.md\` or \`BLOCKED.md\` exists, reply "Nothing to do" and stop.
+3. Run the install command from CLAUDE.md (\`npm install\` unless it says otherwise). If it fails, write \`BLOCKED.md\` with the error and stop.
+4. If \`.ai/task.md\` exists, run the resume protocol (.ai/method.md §9.2) and add 1 to its \`Run: N / 30\` counter. When the counter reaches 30, write \`BLOCKED.md\` saying "run budget reached", push, and stop. If there is no task file, write one from IDEA.md first.
+5. Run the test command from CLAUDE.md (\`npm test\` unless it says otherwise) on the fresh pull. If it fails, fixing it is your first unit ("main stays green"). Otherwise take the next unit from the task file. Do one unit at a time.
+6. After each unit run the test command from CLAUDE.md (\`npm test\` unless it says otherwise). Green: commit, have a reviewer subagent that did not write the code check the diff against IDEA.md ("find the three most likely ways this is wrong for a real user, and check each"), fix any blockers, run the tests again, pull, then push to \`main\`. Red: write the attempt and the reason under Tried in the task file, then discard the unit's uncommitted changes. The same failure twice means the stuck protocol (§9.3); its last step is \`BLOCKED.md\`.
+7. A pushed unit does not end the run. Keep taking units until one of these is true: 40 minutes have passed since the start time (check \`date -u\` after each push), your context is about 60% full, or no unit is left.
+8. Run the handoff (§9.1) in the task file so a fresh run with zero memory can continue at full quality. Commit it, push to \`main\`, and stop. If every done-when in the contract passes and the reviewer finds no blockers, run the retro (§12), write \`DONE.md\` (what was built, test results, anything unsure, the 10 best next improvements ranked by value) and push instead.
+
+Never spend money, sign up for anything, create accounts, publish anything, add API keys, secrets, ads, analytics or tracking, copy other projects' content without a compatible licence, force-push, rewrite history, or touch anything outside this repository.`;
+/** Fills `{{name}}`-style placeholders and normalises the ending. */
+export function buildRunPrompt(promptText, vars) {
+    return `${fillPlaceholders(promptText, vars).trim()}\n`;
+}
+/** Tools an unattended round needs (git, npm test, edits, reviewer subagent, web search). Passed explicitly so `claude -p` can run them headless. */
+export const ROUND_TOOLS = ['Bash', 'Edit', 'Write', 'Read', 'Glob', 'Grep', 'Agent', 'WebSearch'];
+/** Argument array for `claude`; the prompt is a single argv entry, never part of a shell string. */
+export function buildClaudeArgs(prompt, options) {
+    return [
+        '-p',
+        prompt,
+        ...(options.model ? ['--model', options.model] : []),
+        ...(options.skipPermissions ? ['--dangerously-skip-permissions'] : ['--permission-mode', 'acceptEdits', '--allowedTools', ROUND_TOOLS.join(',')]),
+    ];
+}
+//# sourceMappingURL=runPrompt.js.map

package/dist/core/runPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runPrompt.js","sourceRoot":"","sources":["../../src/core/runPrompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,yIAAyI;AACzI,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;;kQAYoO,CAAC;AAEnQ,qEAAqE;AACrE,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,IAAsC;IACvF,OAAO,GAAG,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC;AAC1D,CAAC;AAQD,qJAAqJ;AACrJ,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAU,CAAC;AAE5G,oGAAoG;AACpG,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,OAA0B;IACxE,OAAO;QACL,IAAI;QACJ,MAAM;QACN,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;KAClJ,CAAC;AACJ,CAAC"}

package/dist/core/status.js

@@ -0,0 +1,21 @@
+export const LOCK_MINUTES = 90;
+export const RECENT_COMMIT_MINUTES = 60;
+const minutesBetween = (later, earlier) => (later.getTime() - earlier.getTime()) / 60_000;
+/** Applies the status rules from IDEA.md in order; a failing health check overrides everything. */
+export function deriveStatus(facts, now = new Date()) {
+    const [firstFailure] = facts.healthFailures;
+    if (firstFailure !== undefined)
+        return { state: 'failing', reason: firstFailure };
+    if (facts.hasBlocked)
+        return { state: 'blocked', reason: 'BLOCKED.md is waiting for an answer' };
+    if (facts.hasDone)
+        return { state: 'done', reason: `Round ${facts.roundsDone + 1} finished` };
+    if (facts.lockAt && minutesBetween(now, facts.lockAt) < LOCK_MINUTES) {
+        return { state: 'building', reason: 'A session holds the lock' };
+    }
+    if (facts.lastCommitAt && minutesBetween(now, facts.lastCommitAt) < RECENT_COMMIT_MINUTES) {
+        return { state: 'building', reason: 'Committed in the last hour' };
+    }
+    return { state: 'waiting', reason: 'Waiting for the next scheduled run' };
+}
+//# sourceMappingURL=status.js.map

package/dist/core/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/core/status.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAC/B,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAExC,MAAM,cAAc,GAAG,CAAC,KAAW,EAAE,OAAa,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC;AAEtG,mGAAmG;AACnG,MAAM,UAAU,YAAY,CAAC,KAAgB,EAAE,GAAG,GAAS,IAAI,IAAI,EAAE;IACnE,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC;IAC5C,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAClF,IAAI,KAAK,CAAC,UAAU;QAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,qCAAqC,EAAE,CAAC;IACjG,IAAI,KAAK,CAAC,OAAO;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,CAAC,UAAU,GAAG,CAAC,WAAW,EAAE,CAAC;IAC9F,IAAI,KAAK,CAAC,MAAM,IAAI,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,YAAY,EAAE,CAAC;QACrE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,0BAA0B,EAAE,CAAC;IACnE,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,IAAI,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,qBAAqB,EAAE,CAAC;QAC1F,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,4BAA4B,EAAE,CAAC;IACrE,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,oCAAoC,EAAE,CAAC;AAC5E,CAAC"}

package/dist/core/table.js

@@ -0,0 +1,43 @@
+import { deriveStatus } from './status.js';
+const ICON = { blocked: '!', failing: 'x', done: '+', building: '~', waiting: '-' };
+// Needs-you states first: blocked, failing, done, then the quiet ones.
+const ORDER = ['blocked', 'failing', 'done', 'building', 'waiting'];
+/** Plain-text fleet table; status is always a word plus an icon, never colour alone. */
+export function formatFleet(rows, now = new Date()) {
+    const lines = rows
+        .map((row) => ({ row, status: deriveStatus(row.facts, now) }))
+        .sort((a, b) => ORDER.indexOf(a.status.state) - ORDER.indexOf(b.status.state) || a.row.name.localeCompare(b.row.name))
+        .map(({ row, status }) => [
+        row.name,
+        `${ICON[status.state]} ${status.state}`,
+        `round ${row.facts.roundsDone + 1}`,
+        row.run ? `run ${row.run.run}/${row.run.limit}` : 'run -',
+        status.reason,
+    ]);
+    const header = ['LOOP', 'STATUS', 'ROUND', 'RUN', 'WHY'];
+    const widths = header.map((h, i) => Math.max(h.length, ...lines.map((l) => (l[i] ?? '').length)));
+    const render = (cols) => cols.map((c, i) => c.padEnd(widths[i] ?? 0)).join('  ').trimEnd();
+    const needs = lines.filter((l) => /blocked|failing/.test(l[1] ?? '')).length;
+    const summary = needs === 0 ? 'Nothing needs you.' : `${needs} ${needs === 1 ? 'loop needs' : 'loops need'} you.`;
+    return [summary, '', render(header), ...lines.map(render)].join('\n');
+}
+const LANE_ICON = { blocked: '!', stalled: 'x', done: '+', building: '~', waiting: '-' };
+/** One row per lane, for `loop status` on a laned loop. */
+export function formatLanes(lanes, now = new Date()) {
+    const ago = (iso) => {
+        const minutes = Math.max(0, Math.round((now.getTime() - new Date(iso).getTime()) / 60_000));
+        return minutes < 60 ? `${minutes}m ago` : minutes < 2880 ? `${Math.round(minutes / 60)}h ago` : `${Math.round(minutes / 1440)}d ago`;
+    };
+    const rows = lanes.map((l) => [
+        l.name,
+        `${LANE_ICON[l.state]} ${l.state}`,
+        l.limit > 0 ? `run ${l.run}/${l.limit}` : 'run -',
+        l.lastCommit ? `${ago(l.lastCommit.at)}: ${l.lastCommit.subject.slice(0, 48)}` : 'no lane commits yet',
+        l.waitingOn?.length ? `waits on ${l.waitingOn.join(', ')}` : l.unanswered.length ? `${l.unanswered.length} unanswered` : '',
+    ]);
+    const header = ['LANE', 'STATUS', 'RUN', 'LAST COMMIT', 'MESSAGES'];
+    const widths = header.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? '').length)));
+    const render = (cols) => cols.map((c, i) => c.padEnd(widths[i] ?? 0)).join('  ').trimEnd();
+    return [render(header), ...rows.map(render)].join('\n');
+}
+//# sourceMappingURL=table.js.map

package/dist/core/table.js.map

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

package/dist/core/template.js

@@ -0,0 +1,29 @@
+// Pure helpers for `loop new`: names, placeholders and which files to fill.
+/** Lowercase letters, digits, `-` and `_`; becomes a folder name and a GitHub repo name. */
+const PROJECT_NAME = /^[a-z0-9][a-z0-9_-]{0,99}$/;
+export function validateProjectName(name) {
+    return PROJECT_NAME.test(name)
+        ? undefined
+        : `"${name}" is not a valid name: use lowercase letters, digits, "-" or "_" (max 100 characters, starting with a letter or digit).`;
+}
+const TEXT_EXTENSIONS = new Set(['.md', '.json', '.js', '.mjs', '.ts', '.html', '.css', '.txt', '.xml', '.toml', '.yml', '.yaml', '.gitignore']);
+/** True for files whose `{{placeholders}}` should be filled; everything else is copied byte for byte. */
+export function isTextFile(fileName) {
+    const dot = fileName.lastIndexOf('.');
+    return dot !== -1 && TEXT_EXTENSIONS.has(fileName.slice(dot).toLowerCase());
+}
+/** Replaces `{{key}}` with its value; unknown keys are left as they are so a typo stays visible. */
+export function fillPlaceholders(text, vars) {
+    return text.replace(/\{\{\s*([\w.-]+)\s*\}\}/g, (whole, key) => vars[key] ?? whole);
+}
+/** Names never copied out of a template. */
+export const TEMPLATE_IGNORED = new Set(['node_modules', '.git', 'test-results', 'playwright-report']);
+/** npm drops `.gitignore` from tarballs, so templates ship it as `gitignore`; this is the name it gets in a new repo. */
+export function templateTargetName(fileName) {
+    return fileName === 'gitignore' ? '.gitignore' : fileName;
+}
+/** Hostname-safe form of a project name (`_` becomes `-`, no leading/trailing `-`, at most 63 characters) for `{{host}}`. */
+export function hostLabel(name) {
+    return name.replace(/_/g, '-').slice(0, 63).replace(/^-+|-+$/g, '');
+}
+//# sourceMappingURL=template.js.map

package/dist/core/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/core/template.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,4FAA4F;AAC5F,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAElD,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,IAAI,IAAI,yHAAyH,CAAC;AACxI,CAAC;AAED,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;AAEjJ,yGAAyG;AACzG,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACtC,OAAO,GAAG,KAAK,CAAC,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,IAAsC;IACnF,OAAO,IAAI,CAAC,OAAO,CAAC,0BAA0B,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC;AAC9F,CAAC;AAED,4CAA4C;AAC5C,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,mBAAmB,CAAC,CAAC,CAAC;AAEvG,yHAAyH;AACzH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC5D,CAAC;AAED,6HAA6H;AAC7H,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AACtE,CAAC"}

package/dist/core/types.js

@@ -0,0 +1,3 @@
+// Shared types for the CLI, server and dashboard. Owned by the core lane; other lanes may add, never rename or remove.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,uHAAuH"}

package/dist/server/data.js

@@ -0,0 +1,50 @@
+import { readFile } from 'node:fs/promises';
+/** Fleet order from the contract: what needs the owner first. */
+const ATTENTION_ORDER = ['failing', 'blocked', 'building', 'waiting', 'done'];
+export function sortByAttention(loops) {
+    return [...loops].sort((a, b) => ATTENTION_ORDER.indexOf(a.state) - ATTENTION_ORDER.indexOf(b.state) || a.name.localeCompare(b.name));
+}
+/** The detail-only fields stay out of the fleet list. */
+export function toSummary(detail) {
+    const { timeline: _timeline, contract: _contract, knowledge: _knowledge, decisions: _decisions, history: _history, ...summary } = detail;
+    return summary;
+}
+export function snapshotSource(snapshot) {
+    return {
+        loops: async () => sortByAttention(snapshot.loops.map(toSummary)),
+        loop: async (id) => snapshot.loops.find((l) => l.id === id),
+        inbox: async () => snapshot.inbox,
+        checks: async () => snapshot.checks,
+    };
+}
+async function readFirst(candidates) {
+    for (const file of candidates) {
+        try {
+            return JSON.parse(await readFile(file, 'utf8'));
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT')
+                throw error;
+        }
+    }
+    return undefined;
+}
+/**
+ * Appends the sixth loop (this repo building itself) after the five sites. Its checks are left out for now:
+ * web's health e2e asserts exactly the five sites' 10 checks (see outbox).
+ */
+export function withSelfLoop(snapshot, self) {
+    return { ...snapshot, loops: [...snapshot.loops, self.loop] };
+}
+/**
+ * Reads the demo snapshot: the five sites plus, when present, the sixth loop (this repo). In the repo they live
+ * in `demo/`; in the published package the build copies them next to the compiled server, because `demo/` does not ship.
+ */
+export async function loadDemoSnapshot(candidates = [new URL('./five-sites.json', import.meta.url), new URL('../../demo/five-sites.json', import.meta.url)], selfCandidates = [new URL('./this-repo.json', import.meta.url), new URL('../../demo/this-repo.json', import.meta.url)]) {
+    const snapshot = await readFirst(candidates);
+    if (!snapshot)
+        throw new Error('demo snapshot not found (run `node demo/build-demo.mjs`)');
+    const self = await readFirst(selfCandidates);
+    return self ? withSelfLoop(snapshot, self) : snapshot;
+}
+//# sourceMappingURL=data.js.map

package/dist/server/data.js.map

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

package/dist/server/events.js

@@ -0,0 +1,106 @@
+import { execFile } from 'node:child_process';
+import { stat } from 'node:fs/promises';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import { findLoopDirs, readTimeline } from './loops.js';
+const execFileAsync = promisify(execFile);
+/** A tiny in-process pub/sub; each SSE connection subscribes for its lifetime. */
+export class EventBus {
+    listeners = new Set();
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => void this.listeners.delete(listener);
+    }
+    emit(event) {
+        for (const listener of this.listeners)
+            listener(event);
+    }
+    get size() {
+        return this.listeners.size;
+    }
+}
+const WATCHED_FILES = ['BLOCKED.md', 'DONE.md', path.join('.ai', 'session.lock'), path.join('.ai', 'task.md')];
+/** A string that changes whenever a loop's HEAD or one of its status files changes. */
+export async function fingerprint(dir) {
+    const [head] = await readTimeline(dir, 1);
+    // A `git fetch` only moves the upstream ref, so include it: the owner sees a push before pulling.
+    const upstream = await execFileAsync('git', ['rev-parse', '--short', '@{u}'], { cwd: dir }).then((r) => r.stdout.trim(), () => 'no-upstream');
+    const stamps = await Promise.all(WATCHED_FILES.map(async (file) => {
+        const info = await stat(path.join(dir, file)).catch(() => undefined);
+        return info ? `${file}:${info.mtimeMs}:${info.size}` : `${file}:-`;
+    }));
+    return [head?.sha ?? 'no-commits', upstream, ...stamps].join('|');
+}
+export const DEFAULT_WATCH = { intervalMs: 5_000, fetchIntervalMs: 5 * 60_000 };
+/** Fetches quietly; a clone without a remote or network simply stays as it is. */
+async function fetchClone(dir) {
+    await execFileAsync('git', ['fetch', '--quiet'], { cwd: dir, timeout: 60_000, env: { ...process.env, GIT_TERMINAL_PROMPT: '0' } }).catch(() => undefined);
+}
+const FETCH_CONCURRENCY = 4;
+/** Fetches every clone, a few at a time so many clones do not start many git processes at once. */
+async function fetchAll(projectsDir) {
+    const queue = await findLoopDirs(projectsDir);
+    const worker = async () => {
+        for (let dir = queue.shift(); dir !== undefined; dir = queue.shift())
+            await fetchClone(dir);
+    };
+    await Promise.all(Array.from({ length: FETCH_CONCURRENCY }, worker));
+}
+/**
+ * Polls every clone in `projectsDir` and emits events on change. Polling (not fs.watch) keeps it
+ * identical on Windows, macOS and Linux and also sees commits made by `git pull`. Returns a stop function
+ * that resolves once any poll already running has finished (on Windows a running `git` keeps the clone folder open).
+ */
+export function watchProjects(projectsDir, bus, options = DEFAULT_WATCH) {
+    const seen = new Map();
+    const blocked = new Set();
+    let first = true;
+    let running;
+    let stopped = false;
+    const tick = () => {
+        if (running || stopped)
+            return running ?? Promise.resolve();
+        running = poll().finally(() => {
+            running = undefined;
+        });
+        return running;
+    };
+    const poll = async () => {
+        const dirs = await findLoopDirs(projectsDir);
+        const nowBlocked = new Set();
+        for (const dir of dirs) {
+            const id = path.basename(dir);
+            // One unreadable clone must not stop the others from being checked.
+            const print = await fingerprint(dir).catch(() => seen.get(id) ?? 'unreadable');
+            if (!print.includes('BLOCKED.md:-'))
+                nowBlocked.add(id);
+            if (!first && seen.get(id) !== print)
+                bus.emit({ type: 'loop-updated', id });
+            seen.set(id, print);
+        }
+        for (const id of [...seen.keys()])
+            if (!dirs.some((d) => path.basename(d) === id))
+                seen.delete(id);
+        const inboxChanged = nowBlocked.size !== blocked.size || [...nowBlocked].some((id) => !blocked.has(id));
+        blocked.clear();
+        for (const id of nowBlocked)
+            blocked.add(id);
+        if (!first && inboxChanged)
+            bus.emit({ type: 'inbox-changed' });
+        first = false;
+        options.onPoll?.();
+    };
+    const timer = setInterval(() => void tick().catch(() => undefined), options.intervalMs);
+    const fetcher = options.fetchIntervalMs > 0
+        ? setInterval(() => void fetchAll(projectsDir).catch(() => undefined), options.fetchIntervalMs)
+        : undefined;
+    void tick().catch(() => undefined);
+    return async () => {
+        stopped = true;
+        clearInterval(timer);
+        if (fetcher)
+            clearInterval(fetcher);
+        await running?.catch(() => undefined);
+    };
+}
+//# sourceMappingURL=events.js.map