@protoboxai/codeloop 0.3.0

package/dist/lib/proposals.js

@@ -0,0 +1,240 @@
+import { spawnSync } from 'child_process';
+import { checkEnv } from './shell.js';
+import { createHash } from 'crypto';
+import { copyFileSync, existsSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'fs';
+import { tmpdir } from 'os';
+import { dirname, join } from 'path';
+import { parse as parseYaml, stringify } from 'yaml';
+import { DONE, readCards, safeName } from './cards.js';
+import { writeCloudLane } from './cloud.js';
+import { RefusalError } from './engine.js';
+import { clock } from './clock.js';
+import { withLock } from './lock.js';
+import { LANES_DIR, lanePath, lintLane, loadLane, loadLanes, loadSkillsIndex, parseLane, substitute } from './lane.js';
+export const PROPOSALS_DIR = '.codeloop/proposals';
+export const LANE_CHANGES = '.codeloop/state/lane-changes.json';
+const HISTORY_DIR = `${LANES_DIR}/.history`;
+const REPLAY_CARDS = 10;
+const REJECTIONS_TO_PROPOSE = 3;
+const STUCKS_TO_PROPOSE = 2;
+const proposalDir = (projectDir, id) => join(projectDir, PROPOSALS_DIR, safeName(id, 'proposal id'));
+const sha = (file) => createHash('sha256').update(readFileSync(file)).digest('hex');
+const lastLine = (text) => text.trim().split('\n').at(-1) ?? '';
+export function propose(projectDir, now = clock()) {
+    const { cards } = readCards(projectDir);
+    const root = join(projectDir, PROPOSALS_DIR);
+    const existing = existsSync(root) ? readdirSync(root) : [];
+    const created = [];
+    for (const lane of loadLanes(projectDir)) {
+        // Only cards run under the current version count: events from before a promotion were
+        // already answered by it and must not raise the same proposal again.
+        const events = cards
+            .filter(c => c.lane === lane.id && c.laneVersion === lane.version)
+            .flatMap(c => c.events.map(e => ({ ...e, card: c.id })));
+        for (const stage of lane.stages) {
+            const rejects = events.filter(e => e.action === 'reject' && e.stage === stage.id);
+            const stucks = events.filter(e => e.action === 'stuck' && e.stage === stage.id);
+            const byRejects = rejects.length >= REJECTIONS_TO_PROPOSE;
+            const byStucks = stucks.length >= STUCKS_TO_PROPOSE;
+            if (!byRejects && !byStucks)
+                continue;
+            const prefix = `${lane.id}-${stage.id}-`;
+            const mine = existing.filter(d => d.startsWith(prefix));
+            const open = mine.some(d => {
+                const file = join(root, d, 'lane.yaml');
+                return existsSync(file) && parseLane(readFileSync(file, 'utf-8')).version === lane.version + 1;
+            });
+            if (open)
+                continue;
+            const notes = [
+                ...(byRejects ? rejects.map(e => e.note ?? '') : []),
+                ...(byStucks ? stucks.map(e => `done check failed with: ${lastLine(e.note ?? '')}`) : []),
+            ].filter(Boolean);
+            const distinct = [...new Set(notes)];
+            const raw = parseYaml(readFileSync(lanePath(projectDir, lane.id), 'utf-8'));
+            raw.version = lane.version + 1;
+            const target = raw.stages.find((s) => s.id === stage.id);
+            target.notes = [...new Set([...(target.notes ?? []), ...distinct])];
+            const id = `${prefix}${mine.length + 1}`;
+            const dir = join(root, id);
+            mkdirSync(dir, { recursive: true });
+            writeFileSync(join(dir, 'lane.yaml'), stringify(raw));
+            writeFileSync(join(dir, 'why.md'), why(lane.id, lane.version, stage.id, stage.gate?.name, byRejects ? rejects : [], byStucks ? stucks : [], distinct, id, now));
+            writeFileSync(join(dir, 'eval.yaml'), EVAL_TEMPLATE);
+            created.push(id);
+        }
+    }
+    return created;
+}
+const EVAL_TEMPLATE = `# Fixtures for \`codeloop lane eval\`. Each one runs in an empty temp dir: \`setup\`, then the
+# check (done.cmd) of every stage this proposal changes. The exit code must match \`expect\`.
+# A changed check needs at least one \`expect: fail\` fixture that it really fails on.
+fixtures:
+  - name: broken-output
+    setup: ""   # fill in: a shell command that writes the output the check must reject
+    expect: fail
+`;
+function why(lane, version, stage, gate, rejects, stucks, notes, id, now) {
+    const row = (e, text) => `| ${e.card} | ${e.at} | ${text.replace(/\|/g, '\\|')} |`;
+    const lines = [`# Proposal ${id}: lane ${lane}, stage ${stage} (v${version} to v${version + 1})`, '', `Status: proposed ${now.toISOString().slice(0, 10)}`, '', '## Why', ''];
+    if (rejects.length) {
+        lines.push(`Gate \`${gate ?? stage}\` on stage \`${stage}\` was rejected ${rejects.length} times.`, '', '| Card | When | Rejection note |', '|---|---|---|', ...rejects.map(e => row(e, e.note ?? '')), '');
+    }
+    if (stucks.length) {
+        lines.push(`Stage \`${stage}\` hit \`stuck\` ${stucks.length} times.`, '', '| Card | When | Last line of the failing check |', '|---|---|---|', ...stucks.map(e => row(e, lastLine(e.note ?? ''))), '');
+    }
+    lines.push('## Change', '', `\`lane.yaml\` bumps the version and adds these \`notes:\` to stage \`${stage}\`, which \`codeloop card show\` prints for whoever runs the stage:`, '', ...notes.map(n => `- ${n}`), '');
+    lines.push('## Next', '', `Fill in \`eval.yaml\`, then \`codeloop lane eval ${id}\` and \`codeloop lane promote ${id} --as owner\`.`, '');
+    return lines.join('\n');
+}
+function shell(cmd, cwd) {
+    return spawnSync(cmd, { cwd, shell: true, encoding: 'utf-8', timeout: 600_000, env: checkEnv() }).status === 0;
+}
+export function evalProposal(projectDir, id, now = clock()) {
+    const dir = proposalDir(projectDir, id);
+    const laneFile = join(dir, 'lane.yaml');
+    if (!existsSync(laneFile))
+        throw new RefusalError(`proposal "${id}" has no lane.yaml under ${PROPOSALS_DIR}`);
+    const proposed = parseLane(readFileSync(laneFile, 'utf-8'));
+    const current = existsSync(lanePath(projectDir, proposed.id)) ? loadLane(projectDir, proposed.id) : null;
+    const lint = lintLane(proposed, loadSkillsIndex(projectDir));
+    const evalFile = join(dir, 'eval.yaml');
+    const evalSpec = existsSync(evalFile) ? parseYaml(readFileSync(evalFile, 'utf-8')) ?? {} : {};
+    const fixtures = evalSpec.fixtures ?? [];
+    const accepted = new Set(evalSpec.accept_regressions ?? []);
+    const changed = proposed.stages.filter(s => s.done?.cmd && s.done.cmd !== current?.stages.find(c => c.id === s.id)?.done?.cmd);
+    const runs = [];
+    const vacuous = [];
+    for (const stage of changed) {
+        if (!fixtures.some(f => f.expect === 'fail')) {
+            vacuous.push(`stage ${stage.id}: the check changed but eval.yaml has no \`expect: fail\` fixture, so nothing shows the check can fail`);
+        }
+        for (const fixture of fixtures) {
+            if (!fixture.setup?.trim()) {
+                vacuous.push(`stage ${stage.id}: fixture ${fixture.name} has no setup`);
+                continue;
+            }
+            const tmp = mkdtempSync(join(tmpdir(), 'codeloop-eval-'));
+            try {
+                const got = !shell(fixture.setup, tmp) ? 'setup-failed' : shell(substitute(stage.done.cmd, 'eval-001', { shell: true }), tmp) ? 'pass' : 'fail';
+                const ok = got === fixture.expect;
+                runs.push({ stage: stage.id, fixture: fixture.name, expect: fixture.expect, got, ok });
+                if (!ok)
+                    vacuous.push(`stage ${stage.id}: fixture ${fixture.name} expected ${fixture.expect}, got ${got}`);
+            }
+            finally {
+                rmSync(tmp, { recursive: true, force: true });
+            }
+        }
+    }
+    const replay = [];
+    const replayed = [];
+    const finished = readCards(projectDir).cards.filter(c => c.lane === proposed.id && c.stage === DONE);
+    // A proposal can pass every check and still make the lane weaker. Each such change has to be
+    // named, with a reason, by the person proposing it.
+    const reasons = new Map((evalSpec.accept_weakening ?? []).map(a => [String(a?.change), String(a?.reason ?? '').trim()]));
+    const found = [];
+    for (const before of current?.stages ?? []) {
+        const after = proposed.stages.find(s => s.id === before.id);
+        if (!after) {
+            const passed = finished.filter(c => c.events.some(e => e.stage === before.id && (e.action === 'advance' || e.action === 'approve')));
+            if (passed.length)
+                found.push([`remove-stage:${before.id}`, `removes stage ${before.id}, which ${passed.map(c => c.id).join(', ')} passed`]);
+            continue;
+        }
+        if (before.gate && !after.gate)
+            found.push([`remove-gate:${before.id}`, `removes gate ${before.gate.name} from stage ${before.id}`]);
+        if (before.gate && after.gate && before.gate.approver !== after.gate.approver)
+            found.push([`approver:${before.id}`, `changes the approver of gate ${before.gate.name} from ${before.gate.approver} to ${after.gate.approver}`]);
+        if (before.gate?.outward && after.gate && !after.gate.outward)
+            found.push([`remove-outward:${before.id}`, `stage ${before.id} would no longer wait for approval before its public step`]);
+    }
+    if (current && current.retries > 0 && proposed.retries <= 0)
+        found.push(['retries-0', `lowers retries from ${current.retries} to ${proposed.retries}, so a card is stuck on its first failed check`]);
+    const weakening = found.map(([change, detail]) => ({ change, detail, accepted: !!reasons.get(change), ...(reasons.get(change) ? { reason: reasons.get(change) } : {}) }));
+    for (const w of weakening.filter(w => !w.accepted)) {
+        replay.push(`${w.detail}; if that is intended, add \`- { change: "${w.change}", reason: "..." }\` under accept_weakening in eval.yaml`);
+    }
+    // Each changed check is re-run against work that was already accepted. A stage the card never
+    // passed (one the proposal adds) has no artifact to judge, so it is left out.
+    const recent = [...finished].sort((a, b) => a.updatedAt.localeCompare(b.updatedAt)).slice(-REPLAY_CARDS);
+    for (const card of recent) {
+        for (const stage of changed.filter(s => card.events.some(e => e.action === 'advance' && e.stage === s.id))) {
+            const passed = shell(substitute(stage.done.cmd, card, { shell: true }), projectDir);
+            const ok = accepted.has(card.id);
+            replayed.push({ card: card.id, stage: stage.id, passed, accepted: ok });
+            if (!passed && !ok) {
+                replay.push(`card ${card.id} finished, but its ${stage.id} output fails the new check; fix the check or list ${card.id} under accept_regressions in eval.yaml`);
+            }
+        }
+    }
+    const exitCode = lint.length ? 2 : vacuous.length ? 4 : replay.length ? 1 : 0;
+    const result = {
+        proposal: id, lane: proposed.id, version: proposed.version, at: now.toISOString(), laneSha: sha(laneFile),
+        lint, fixtures: runs, vacuous, replay, replayed, weakening, green: exitCode === 0, exitCode,
+    };
+    writeFileSync(join(dir, 'eval-result.json'), JSON.stringify(result, null, 2) + '\n');
+    return result;
+}
+function logChange(projectDir, entry) {
+    const file = join(projectDir, LANE_CHANGES);
+    withLock(file, () => {
+        const log = existsSync(file) ? JSON.parse(readFileSync(file, 'utf-8')) : [];
+        writeFileSync(file, JSON.stringify([...log, entry], null, 2) + '\n');
+    });
+}
+export function promote(projectDir, id, role, now = clock()) {
+    if (role !== 'owner')
+        throw new RefusalError(`a lane change needs the owner; ${role} cannot promote`);
+    const dir = proposalDir(projectDir, id);
+    const laneFile = join(dir, 'lane.yaml');
+    const resultFile = join(dir, 'eval-result.json');
+    if (!existsSync(laneFile))
+        throw new RefusalError(`proposal "${id}" not found`);
+    if (!existsSync(resultFile))
+        throw new RefusalError(`proposal ${id} has not been evaluated; run \`codeloop lane eval ${id}\``);
+    const result = JSON.parse(readFileSync(resultFile, 'utf-8'));
+    if (!result.green)
+        throw new RefusalError(`proposal ${id} failed its eval; fix it and re-run \`codeloop lane eval ${id}\``);
+    if (result.laneSha !== sha(laneFile))
+        throw new RefusalError(`proposal ${id} changed after its eval; re-run \`codeloop lane eval ${id}\``);
+    const proposed = parseLane(readFileSync(laneFile, 'utf-8'));
+    const target = lanePath(projectDir, proposed.id);
+    let from = null;
+    if (existsSync(target)) {
+        from = loadLane(projectDir, proposed.id).version;
+        if (proposed.version !== from + 1)
+            throw new RefusalError(`proposal ${id} is v${proposed.version} but lane ${proposed.id} is at v${from}; it was written against an older version`);
+        mkdirSync(join(projectDir, HISTORY_DIR), { recursive: true });
+        copyFileSync(target, join(projectDir, HISTORY_DIR, `${proposed.id}.v${from}.yaml`));
+    }
+    // The cloud page goes first, so a lane that someone else changed there refuses this promote
+    // before the local file is replaced.
+    writeCloudLane(projectDir, proposed.id, readFileSync(laneFile, 'utf-8'));
+    mkdirSync(dirname(target), { recursive: true });
+    copyFileSync(laneFile, target);
+    const weakening = result.weakening ?? [];
+    logChange(projectDir, { at: now.toISOString(), action: 'promote', lane: proposed.id, from, to: proposed.version, proposal: id, actor: role, ...(weakening.length ? { weakening } : {}) });
+    return { lane: proposed.id, from, to: proposed.version, weakening };
+}
+export function rollback(projectDir, laneId, role, now = clock()) {
+    if (role !== 'owner')
+        throw new RefusalError(`a lane change needs the owner; ${role} cannot roll back`);
+    const dir = join(projectDir, HISTORY_DIR);
+    const versions = (existsSync(dir) ? readdirSync(dir) : [])
+        .map(f => new RegExp(`^${laneId}\\.v(\\d+)\\.yaml$`).exec(f))
+        .filter((m) => m !== null)
+        .map(m => parseInt(m[1], 10));
+    if (versions.length === 0)
+        throw new RefusalError(`lane ${laneId} has no earlier version in ${HISTORY_DIR}`);
+    const to = Math.max(...versions);
+    const from = loadLane(projectDir, laneId).version;
+    const history = join(dir, `${laneId}.v${to}.yaml`);
+    writeCloudLane(projectDir, laneId, readFileSync(history, 'utf-8'));
+    copyFileSync(history, lanePath(projectDir, laneId));
+    // Removed so a second rollback steps back one more version instead of restoring this one again.
+    rmSync(history);
+    logChange(projectDir, { at: now.toISOString(), action: 'rollback', lane: laneId, from, to, actor: role });
+    return { lane: laneId, from, to };
+}
+//# sourceMappingURL=proposals.js.map

package/dist/lib/proposals.js.map

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

package/dist/lib/render.d.ts

@@ -0,0 +1,7 @@
+export type Host = 'claude' | 'cursor' | 'codex';
+export declare const HOSTS: Host[];
+/** Writes only when content differs, so a second run changes nothing. Text outside the AGENTS.md markers is kept. */
+export declare function render(projectDir: string, hosts: Host[]): {
+    written: string[];
+    unchanged: string[];
+};

package/dist/lib/render.js

@@ -0,0 +1,84 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { loadLanes, loadSkillsIndex } from './lane.js';
+export const HOSTS = ['claude', 'cursor', 'codex'];
+const START = '<!-- codeloop:start -->';
+const END = '<!-- codeloop:end -->';
+const who = (stage) => stage.skill ?? [stage.role ?? ''].flat().join(', ');
+const gateText = (stage) => !stage.gate ? '' : stage.gate.outward ? `${stage.gate.name} (${stage.gate.approver}, before the stage runs)` : `${stage.gate.name} (${stage.gate.approver}, after the check passes)`;
+function stageSteps(lane, stage, skills) {
+    const skill = skills.find(s => s.name === stage.skill);
+    const steps = [
+        '1. Run `codeloop card show <id>`. It prints the output path, the done check, the stage notes and any earlier rejection notes. Follow those over anything remembered.',
+        '2. Run `codeloop wiki inject --files <files you expect to touch>` and read every page it prints.',
+        stage.skill
+            ? `3. Do the work with the \`${stage.skill}\` skill${skill ? ` (${skill.source})` : ''}.${skill?.description ? ` ${skill.description}` : ''}`
+            : `3. Do the work for the \`${stage.id}\` stage${who(stage) ? ` as ${who(stage)}` : ''}.`,
+        stage.output ? `4. Write the result to \`${stage.output}\`.` : '4. Keep the change inside what the card asks for.',
+        `5. Run \`codeloop card advance <id>\`. It runs \`${stage.done?.cmd ?? `event ${stage.done?.event}`}\`. If it exits 2, read the output, fix the work and run it again. Stop after ${lane.retries} failures: the card parks as stuck for the owner.`,
+    ];
+    if (stage.gate?.outward)
+        steps.unshift(`0. This stage changes something public. The card waits at gate \`${stage.gate.name}\` as it enters. Do nothing until a person has approved it.`);
+    else if (stage.gate)
+        steps.push(`6. The card then waits at gate \`${stage.gate.name}\` for the ${stage.gate.approver}. Stop there. Never run \`codeloop approve\` yourself.`);
+    return steps;
+}
+function laneTable(lane) {
+    return ['| Stage | Skill | Output | Done check | Gate |', '|---|---|---|---|---|', ...lane.stages.map(s => `| ${s.id} | ${who(s)} | ${s.output ?? ''} | \`${(s.done?.cmd ?? `event ${s.done?.event}`).replace(/\|/g, '\\|')}\` | ${gateText(s)} |`)];
+}
+function laneBody(lane, skills) {
+    const lines = [`# codeloop lane: ${lane.id} (v${lane.version})`, '', 'Run `codeloop card show <id>` first; the card says which stage it is in. Gates are approved only by a person.', '', ...laneTable(lane), ''];
+    for (const stage of lane.stages)
+        lines.push(`## ${stage.id}`, '', ...stageSteps(lane, stage, skills), '');
+    return lines.join('\n');
+}
+function files(lanes, skills, host) {
+    const out = {};
+    for (const lane of lanes) {
+        const description = `Work a codeloop card through the ${lane.id} lane: ${lane.stages.map(s => s.id).join(', ')}.`;
+        if (host === 'claude') {
+            for (const stage of lane.stages) {
+                const name = `codeloop-${lane.id}-${stage.id}`;
+                out[`.claude/agents/${name}.md`] = `---\nname: ${name}\ndescription: Run the ${stage.id} stage of the ${lane.id} lane for one codeloop card${stage.skill ? `, using the ${stage.skill} skill` : ''}.\n---\n\n# ${lane.id} / ${stage.id}\n\n${stageSteps(lane, stage, skills).join('\n')}\n`;
+            }
+        }
+        else if (host === 'cursor') {
+            out[`.cursor/rules/codeloop-${lane.id}.mdc`] = `---\ndescription: ${description}\nalwaysApply: false\n---\n\n${laneBody(lane, skills)}`;
+        }
+        else {
+            out[`.agents/skills/codeloop-${lane.id}/SKILL.md`] = `---\nname: codeloop-${lane.id}\ndescription: ${description}\n---\n\n${laneBody(lane, skills)}`;
+        }
+    }
+    return out;
+}
+function agentsBlock(lanes) {
+    const lines = [START, '## codeloop', '', '- Run `codeloop card show <id>` first. It names the stage, the skill, the output path and the done check.', '- Move a card only with `codeloop card advance <id>`. Never edit `.codeloop/cards.json` or a lane file.', '- Gates are approved only by a person. Stop when a card parks.', '- Run `codeloop wiki inject --files <paths>` before changing files.', ''];
+    for (const lane of lanes)
+        lines.push(`### ${lane.id}`, '', ...laneTable(lane), '');
+    lines.push(END);
+    return lines.join('\n');
+}
+/** Writes only when content differs, so a second run changes nothing. Text outside the AGENTS.md markers is kept. */
+export function render(projectDir, hosts) {
+    const lanes = loadLanes(projectDir);
+    const skills = loadSkillsIndex(projectDir) ?? [];
+    const out = Object.assign({}, ...hosts.map(h => files(lanes, skills, h)));
+    const agentsFile = join(projectDir, 'AGENTS.md');
+    const current = existsSync(agentsFile) ? readFileSync(agentsFile, 'utf-8') : '';
+    const block = agentsBlock(lanes);
+    const [start, end] = [current.indexOf(START), current.indexOf(END)];
+    out['AGENTS.md'] = start >= 0 && end > start ? current.slice(0, start) + block + current.slice(end + END.length) : `${current.trimEnd()}${current.trim() ? '\n\n' : ''}${block}\n`;
+    const result = { written: [], unchanged: [] };
+    for (const [path, text] of Object.entries(out)) {
+        const file = join(projectDir, path);
+        if (existsSync(file) && readFileSync(file, 'utf-8') === text) {
+            result.unchanged.push(path);
+            continue;
+        }
+        mkdirSync(dirname(file), { recursive: true });
+        writeFileSync(file, text);
+        result.written.push(path);
+    }
+    return result;
+}
+//# sourceMappingURL=render.js.map

package/dist/lib/render.js.map

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

package/dist/lib/research.d.ts

@@ -0,0 +1,8 @@
+/** `ref` is a card id or number. The research file is the one in the card's spec folder. */
+export declare function checkResearch(projectDir: string, ref: string, minSources: number): {
+    file: string;
+    errors: string[];
+    urls: string[];
+};
+/** One line per URL that does not answer with 2xx or 3xx. */
+export declare function checkOnline(urls: string[]): Promise<string[]>;

package/dist/lib/research.js

@@ -0,0 +1,39 @@
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { resolveSpecDir } from './spec.js';
+// `- source: <url> — <note>`. A spaced hyphen is accepted in place of the dash.
+const SOURCE = /^- source: (https?:\/\/\S+) (?:—|–|-) \S.*$/;
+const VERDICT = /^verdict:\s*\S/m;
+const ONLINE_TIMEOUT_MS = 10_000;
+/** `ref` is a card id or number. The research file is the one in the card's spec folder. */
+export function checkResearch(projectDir, ref, minSources) {
+    const file = `${resolveSpecDir(projectDir, ref)}/research.md`;
+    if (!existsSync(join(projectDir, file)))
+        return { file, errors: [`missing file: ${file}`], urls: [] };
+    const text = readFileSync(join(projectDir, file), 'utf-8');
+    const urls = text.split('\n').map(l => SOURCE.exec(l.trim())?.[1]).filter((u) => !!u);
+    const errors = [];
+    if (!VERDICT.test(text))
+        errors.push(`${file} has no line starting with "verdict:"`);
+    if (urls.length < minSources)
+        errors.push(`${file} cites ${urls.length} ${urls.length === 1 ? 'source' : 'sources'}, needs ${minSources} (\`- source: <url> — <note>\`)`);
+    return { file, errors, urls };
+}
+async function answers(url) {
+    const ask = (method) => fetch(url, { method, redirect: 'manual', signal: AbortSignal.timeout(ONLINE_TIMEOUT_MS) });
+    try {
+        let res = await ask('HEAD');
+        // Some servers refuse HEAD and serve the page to GET.
+        if (res.status >= 400)
+            res = await ask('GET');
+        return res.status < 400 ? null : `${url} answered ${res.status}`;
+    }
+    catch (e) {
+        return `${url} did not answer (${e.cause instanceof Error ? e.cause.code ?? e.message : e.message})`;
+    }
+}
+/** One line per URL that does not answer with 2xx or 3xx. */
+export async function checkOnline(urls) {
+    return (await Promise.all(urls.map(answers))).filter((e) => e !== null);
+}
+//# sourceMappingURL=research.js.map

package/dist/lib/research.js.map

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

package/dist/lib/run.d.ts

@@ -0,0 +1,38 @@
+import { type AgentConfig } from './agent.js';
+import { type Outcome } from './engine.js';
+export declare const LAST_RUN = ".codeloop/state/last-run.json";
+export interface RunResult {
+    created: {
+        lane: string;
+        id: string;
+        slot: string;
+        trigger: string;
+    }[];
+    skipped: {
+        lane: string;
+        reason: string;
+    }[];
+    advanced: {
+        id: string;
+        outcome: Outcome | 'refused';
+        note?: string;
+        next?: string;
+    }[];
+    /** Only on a run with an agent: one entry per card an agent was started for, or would have been. */
+    agents?: AgentStep[];
+}
+export interface AgentStep {
+    id: string;
+    stage: string;
+    agent: string;
+    started: boolean;
+    reason?: string;
+    exit?: number | null;
+    durationMs?: number;
+    log?: string;
+}
+export declare function runDue(projectDir: string, now?: Date): RunResult;
+/** `runDue`, with an agent started first on each card whose stage check does not pass yet. One stage per card. */
+export declare function runDueWithAgent(projectDir: string, agent: AgentConfig, now?: Date): Promise<RunResult>;
+/** What a run would do, for `--dry-run`. Nothing is started, checked or written. */
+export declare function planRun(projectDir: string, agent: AgentConfig | null, now?: Date): string[];