compounding-loop 0.0.0-stage → 0.1.0

package/dist/cli/run.js

@@ -0,0 +1,81 @@
+import { spawn } from 'node:child_process';
+import { appendFile, mkdir, readFile, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { parseLockTime } from '../core/repo.js';
+import { LOCK_MINUTES } from '../core/status.js';
+import { buildClaudeArgs, buildRunPrompt, DEFAULT_PROMPT } from '../core/runPrompt.js';
+import { packageRoot } from './init.js';
+const exists = (file) => stat(file).then(() => true, () => false);
+/** First readable prompt: the repo's own, then the routine prompt in the repo, then the package's, then the built-in. */
+export async function loadPromptText(dir, root = packageRoot) {
+    const candidates = [
+        path.join(dir, '.ai', 'loop-prompt.md'),
+        path.join(dir, 'runners', 'routine', 'prompt.md'),
+        path.join(root, 'runners', 'routine', 'prompt.md'),
+    ];
+    for (const file of candidates) {
+        const text = await readFile(file, 'utf8').catch(() => undefined);
+        if (text !== undefined)
+            return { text, source: file };
+    }
+    return { text: DEFAULT_PROMPT, source: 'built-in default' };
+}
+/**
+ * Finds an executable on PATH. Node cannot start `.cmd` shims without a shell (and we never build shell strings),
+ * so on Windows only `.exe` files count; a lone `claude.cmd` gets an explanatory error.
+ */
+export async function resolveExecutable(name, platform = process.platform, pathEnv = process.env.PATH ?? '', has = exists) {
+    if (platform !== 'win32')
+        return name;
+    const dirs = pathEnv.split(path.win32.delimiter).filter(Boolean);
+    for (const dir of dirs)
+        if (await has(path.win32.join(dir, `${name}.exe`)))
+            return path.win32.join(dir, `${name}.exe`);
+    for (const dir of dirs) {
+        if (await has(path.win32.join(dir, `${name}.cmd`))) {
+            throw new Error(`Found ${name}.cmd but Node cannot start it safely. Install the native ${name}.exe build of Claude Code, or run the round from a terminal with \`${name} -p\`.`);
+        }
+    }
+    throw new Error(`Could not find ${name}.exe on PATH. Is Claude Code installed?`);
+}
+const realSpawn = async (command, args, cwd) => {
+    const executable = await resolveExecutable(command);
+    return new Promise((resolve, reject) => {
+        const child = spawn(executable, args, { cwd, stdio: 'inherit' });
+        child.on('error', (error) => reject(new Error(`Could not start \`${command}\`: ${error.message}. Is Claude Code installed and on your PATH?`)));
+        child.on('close', (code) => resolve(code ?? 1));
+    });
+};
+/** Minutes left on a fresh `.ai/session.lock`, or undefined when no session holds the repo. */
+export function lockMinutesLeft(lockText, now) {
+    const at = lockText === undefined ? undefined : parseLockTime(lockText);
+    if (!at)
+        return undefined;
+    const left = LOCK_MINUTES - (now.getTime() - at.getTime()) / 60_000;
+    return left > 0 ? Math.ceil(left) : undefined;
+}
+/** One `{"startedAt","endedAt"}` line per round in `.ai/runs.jsonl`; the dashboard's health checks read it. */
+export async function recordRun(dir, startedAt, endedAt) {
+    await mkdir(path.join(dir, '.ai'), { recursive: true });
+    await appendFile(path.join(dir, '.ai', 'runs.jsonl'), `${JSON.stringify({ startedAt: startedAt.toISOString(), endedAt: endedAt.toISOString() })}\n`);
+}
+/** `loop run`: one build round now, using the same prompt the scheduler uses. */
+export async function runRound(dir, options, spawner = realSpawn) {
+    const { text, source } = await loadPromptText(dir);
+    const prompt = buildRunPrompt(text, { name: path.basename(path.resolve(dir)) });
+    for (const stop of ['DONE.md', 'BLOCKED.md']) {
+        if (await exists(path.join(dir, stop)))
+            return { skipped: `${stop} exists: nothing to do`, prompt, source };
+    }
+    const lockLeft = lockMinutesLeft(await readFile(path.join(dir, '.ai', 'session.lock'), 'utf8').catch(() => undefined), new Date());
+    if (lockLeft !== undefined)
+        return { skipped: `another session holds .ai/session.lock (about ${lockLeft} min left): nothing to do`, prompt, source };
+    if (options.dryRun)
+        return { prompt, source };
+    console.error(`Running one round in ${dir} (prompt: ${source})`);
+    const startedAt = new Date();
+    const exitCode = await spawner('claude', buildClaudeArgs(prompt, { skipPermissions: options.skipPermissions, ...(options.model && { model: options.model }) }), dir);
+    await recordRun(dir, startedAt, new Date());
+    return { prompt, source, exitCode };
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/run.js.map

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

package/dist/core/blocked.js

@@ -0,0 +1,42 @@
+function sectionText(text, label) {
+    const lines = text.split(/\r?\n/);
+    const start = lines.findIndex((l) => label.test(l.replace(/^#+\s*|\*\*/g, '').trim()));
+    if (start === -1)
+        return '';
+    const first = (lines[start] ?? '').replace(/^#+\s*/, '').replace(/\*\*/g, '');
+    const inline = first.replace(/^[^:]*:/, '').trim();
+    const body = inline && first.includes(':') ? [inline] : [];
+    for (const line of lines.slice(start + 1)) {
+        if (/^#+\s/.test(line) || /^\s*\*\*[^*]+\*\*:?/.test(line))
+            break;
+        body.push(line);
+    }
+    return body.join('\n').trim();
+}
+/** Pulls the question and best guess out of a BLOCKED.md, tolerating headings or bold labels. */
+export function parseBlocked(text) {
+    const question = sectionText(text, /^(the )?(specific )?question/i);
+    const bestGuess = sectionText(text, /^(my |the )?best guess/i);
+    return { question: question || text.trim(), bestGuess, raw: text };
+}
+/** The block appended to task.md so the next run sees the owner's answer as a decision. */
+export function formatAnswer(note, answer, date) {
+    const question = note.question.split(/\r?\n/)[0] ?? '';
+    return `### Owner answer, ${date}\nQuestion: ${question}\nAnswer: ${answer.trim()}\n`;
+}
+/** Inserts an answer block under "## Decisions" (or at the end when the file has none). */
+export function addAnswerToTask(taskText, block) {
+    const match = /^## Decisions[^\n]*\n/m.exec(taskText);
+    if (!match)
+        return `${taskText.replace(/\s*$/, '')}\n\n## Decisions\n${block}`;
+    const at = match.index + match[0].length;
+    return `${taskText.slice(0, at)}${block}\n${taskText.slice(at)}`;
+}
+export const BUDGET_EXTENSION = 30;
+/** True when BLOCKED.md was written because the run budget ran out (it has no real question). */
+export const isBudgetBlock = (text) => /run budget/i.test(text);
+/** Raises the limit of `Run: N / LIMIT` to N + BUDGET_EXTENSION; leaves other text alone. */
+export function extendRunBudget(taskText, extra = BUDGET_EXTENSION) {
+    return taskText.replace(/^Run:\s*(\d+)\s*\/\s*\d+/m, (_whole, run) => `Run: ${run} / ${Number(run) + extra}`);
+}
+//# sourceMappingURL=blocked.js.map

package/dist/core/blocked.js.map

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

package/dist/core/brief.js

@@ -0,0 +1,91 @@
+// Brief linter. Pure and free of Node imports: the web wizard runs the same code in the browser.
+export const MIN_BRIEF_SCORE = 60;
+const VAGUE_WORDS = /\b(good|nice|great|modern|fast|clean|user-friendly|intuitive|robust|scalable|beautiful)\b/i;
+const MIN_WORDS = 120;
+/** Bold labels (`**Goal:** text`) count as the deepest heading level. */
+const LABEL_LEVEL = 7;
+function splitSections(text) {
+    const flat = [];
+    for (const line of text.split(/\r?\n/)) {
+        const heading = /^(#{1,6})\s+(.*?)\s*#*\s*$/.exec(line);
+        const label = /^\s*\*\*(.+?)\*\*:?\s*(.*)$/.exec(line) ?? /^\s*\*\*(.+?):\*\*\s*(.*)$/.exec(line);
+        if (heading)
+            flat.push({ heading: heading[2] ?? '', level: (heading[1] ?? '#').length, own: '' });
+        else if (label && !/^\s*[-*+]\s/.test(line))
+            flat.push({ heading: (label[1] ?? '').replace(/:$/, ''), level: LABEL_LEVEL, own: `${label[2] ?? ''}\n` });
+        else {
+            const last = flat[flat.length - 1];
+            if (last)
+                last.own += `${line}\n`;
+        }
+    }
+    return flat.map((section, i) => {
+        let body = section.own;
+        for (const later of flat.slice(i + 1)) {
+            if (later.level <= section.level)
+                break;
+            body += later.own;
+        }
+        return { heading: section.heading, body };
+    });
+}
+const findSection = (sections, pattern) => sections.find((s) => pattern.test(s.heading));
+/** Bullet and numbered-list items of a section body, without their markers. */
+export function listItems(body) {
+    return body
+        .split(/\r?\n/)
+        .map((line) => /^\s*(?:[-*+]|\d+[.)])\s+(?:\[[ xX]\]\s+)?(.+)$/.exec(line)?.[1]?.trim())
+        .filter((item) => Boolean(item));
+}
+/** A must-have is vague when it is very short, or leans on a fuzzy word with no number, path or command to check. */
+export function isVagueItem(item) {
+    const hasEvidence = /`[^`]+`|\d/.test(item);
+    if (item.split(/\s+/).length < 4 && !hasEvidence)
+        return true;
+    return VAGUE_WORDS.test(item) && !hasEvidence;
+}
+/** Scores a brief (the project's IDEA.md) and names what is missing. */
+export function lintBrief(text) {
+    const sections = splitSections(text);
+    const gaps = [];
+    const miss = (gap) => gaps.push(gap);
+    const oneLine = findSection(sections, /^\W*(one[- ]line|summary|overview|goal|what (this|it) is|pitch)\b/i);
+    if (!oneLine || oneLine.body.trim().length < 20) {
+        miss({ id: 'one-line', cost: 15, message: 'No one-line description of what you are building.' });
+    }
+    const audience = findSection(sections, /^\W*(who\b|audience|users?\b|customers?\b|target)/i);
+    if (!audience || audience.body.trim().length < 20) {
+        miss({ id: 'audience', cost: 15, message: 'No audience: say who this is for.' });
+    }
+    const mustHeading = findSection(sections, /^\W*(must[- ]?haves?|requirements?|features?|deliverables?|scope\b)/i);
+    const items = mustHeading ? listItems(mustHeading.body) : [];
+    if (items.length < 3) {
+        miss({ id: 'must-haves', cost: 20, message: 'Fewer than three must-haves listed as bullets.' });
+    }
+    else {
+        const vague = items.filter(isVagueItem);
+        if (vague.length > items.length / 2) {
+            miss({
+                id: 'vague-must-haves',
+                cost: 10,
+                message: `Vague must-haves (${vague.length} of ${items.length}): add numbers, paths or commands that can be checked.`,
+            });
+        }
+    }
+    const doneWhen = findSection(sections, /^\W*(done[- ]when|definition of done|acceptance|success criteria)/i);
+    const checkable = doneWhen ? /`[^`]+`|\b(npm|pnpm|yarn|pytest|make|cargo)\b|\btests?\s+(pass|green)/i.test(doneWhen.body) : false;
+    if (!checkable) {
+        miss({ id: 'done-when', cost: 25, message: 'No checkable done-when: list commands or tests that must pass.' });
+    }
+    const outOfScope = findSection(sections, /^\W*(out of scope|not in scope|non-goals?|not included|won'?t)/i);
+    if (!outOfScope || outOfScope.body.trim().length < 10) {
+        miss({ id: 'out-of-scope', cost: 15, message: 'No out-of-scope section: say what the loop must not build.' });
+    }
+    if (text.split(/\s+/).filter(Boolean).length < MIN_WORDS) {
+        miss({ id: 'length', cost: 10, message: `Under ${MIN_WORDS} words: too thin for an unattended build.` });
+    }
+    const score = Math.max(0, 100 - gaps.reduce((sum, gap) => sum + gap.cost, 0));
+    return { score, gaps };
+}
+export const briefPasses = (lint) => lint.score >= MIN_BRIEF_SCORE;
+//# sourceMappingURL=brief.js.map

package/dist/core/brief.js.map

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

package/dist/core/gh.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gh.js.map

package/dist/core/gh.js.map

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

package/dist/core/init.js

@@ -0,0 +1,59 @@
+// Planning for `loop init`: decides what to write, without touching the disk.
+import { briefPasses, lintBrief } from './brief.js';
+export const CARD_START = '<!-- compounding-loop:start -->';
+export const CARD_END = '<!-- compounding-loop:end -->';
+const AGENTS_POINTER = '# AGENTS.md\n\nThis repository follows the rules in [CLAUDE.md](CLAUDE.md). Read it first; it applies to any coding agent.\n';
+/** Wraps the card in markers and merges it into an existing CLAUDE.md. Re-running is a no-op. */
+export function mergeCard(existing, card) {
+    const block = `${CARD_START}\n${card.trim()}\n${CARD_END}\n`;
+    if (existing === undefined || existing.trim() === '')
+        return block;
+    const start = existing.indexOf(CARD_START);
+    const end = existing.indexOf(CARD_END);
+    if ((start === -1) !== (end === -1) || (start !== -1 && end < start)) {
+        throw new Error(`CLAUDE.md has a broken ${CARD_START} / ${CARD_END} pair: fix or remove the markers, then re-run.`);
+    }
+    if (start !== -1 && end > start) {
+        return existing.slice(0, start) + block + existing.slice(end + CARD_END.length).replace(/^\r?\n/, '');
+    }
+    return `${existing.replace(/\s*$/, '')}\n\n${block}`;
+}
+/** Returns why a brief blocks `init`, or undefined when it is good enough. */
+export function briefBlocker(brief) {
+    if (brief === undefined)
+        return 'IDEA.md is missing: write the brief first (or pass --force).';
+    const lint = lintBrief(brief);
+    if (briefPasses(lint))
+        return undefined;
+    const gaps = lint.gaps.map((gap) => `  - ${gap.message}`).join('\n');
+    return `IDEA.md scores ${lint.score}/100 (needs 60):\n${gaps}`;
+}
+export function planInit({ kit, card, existing, force }) {
+    const actions = [];
+    for (const file of kit) {
+        const current = existing.get(file.dest);
+        if (current === undefined)
+            actions.push({ dest: file.dest, kind: 'create', content: file.content });
+        else if (current === file.content)
+            actions.push({ dest: file.dest, kind: 'skip', reason: 'already up to date' });
+        else if (force && !file.keep)
+            actions.push({ dest: file.dest, kind: 'overwrite', content: file.content });
+        else
+            actions.push({ dest: file.dest, kind: 'skip', reason: file.keep ? 'loop state, never overwritten' : 'exists (use --force to overwrite)' });
+    }
+    if (card !== undefined) {
+        const current = existing.get('CLAUDE.md');
+        const merged = mergeCard(current, card);
+        if (merged === current)
+            actions.push({ dest: 'CLAUDE.md', kind: 'skip', reason: 'Operating Card already installed' });
+        else
+            actions.push({ dest: 'CLAUDE.md', kind: current === undefined ? 'create' : 'update', content: merged });
+    }
+    const agents = existing.get('AGENTS.md');
+    if (agents === undefined)
+        actions.push({ dest: 'AGENTS.md', kind: 'create', content: AGENTS_POINTER });
+    else
+        actions.push({ dest: 'AGENTS.md', kind: 'skip', reason: 'exists' });
+    return actions;
+}
+//# sourceMappingURL=init.js.map

package/dist/core/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/core/init.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,CAAC,MAAM,UAAU,GAAG,iCAAiC,CAAC;AAC5D,MAAM,CAAC,MAAM,QAAQ,GAAG,+BAA+B,CAAC;AA4BxD,MAAM,cAAc,GAAG,8HAA8H,CAAC;AAEtJ,iGAAiG;AACjG,MAAM,UAAU,SAAS,CAAC,QAA4B,EAAE,IAAY;IAClE,MAAM,KAAK,GAAG,GAAG,UAAU,KAAK,IAAI,CAAC,IAAI,EAAE,KAAK,QAAQ,IAAI,CAAC;IAC7D,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACnE,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK,CAAC,EAAE,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,0BAA0B,UAAU,MAAM,QAAQ,gDAAgD,CAAC,CAAC;IACtH,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,GAAG,KAAK,EAAE,CAAC;QAChC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACxG,CAAC;IACD,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,KAAK,EAAE,CAAC;AACvD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,KAAyB;IACpD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,8DAA8D,CAAC;IAC/F,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,WAAW,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,OAAO,kBAAkB,IAAI,CAAC,KAAK,qBAAqB,IAAI,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAiB;IACpE,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,KAAK,MAAM,IAAI,IAAI,GAAG,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;aAC/F,IAAI,OAAO,KAAK,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;aAC5G,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;;YACrG,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,mCAAmC,EAAE,CAAC,CAAC;IAClJ,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACxC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAC,CAAC;;YACjH,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/G,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;;QAClG,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACzE,OAAO,OAAO,CAAC;AACjB,CAAC"}

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. 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,24 @@
+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');
+}
+//# 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"}