@protoboxai/codeloop 0.3.0

package/dist/commands/watch.js

@@ -0,0 +1,111 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { existsSync, readFileSync, writeFileSync, unlinkSync } from 'fs';
+import { join } from 'path';
+import { createWatchEngine, loadWatchConfig } from '../watch/index.js';
+const PID_FILE = '.codeloop/.watch.pid';
+export const watchCommand = new Command('watch')
+    .description('Watch project for changes, track progress on the board')
+    .option('--with-serve', 'Also start the board server')
+    .option('--stop', 'Stop background watcher')
+    .option('--bg', 'Run in background')
+    .action(async (options) => {
+    const projectDir = process.cwd();
+    // --stop: kill background watcher
+    if (options.stop) {
+        const pidPath = join(projectDir, PID_FILE);
+        if (!existsSync(pidPath)) {
+            console.log(chalk.dim('  Not running'));
+            return;
+        }
+        const pid = parseInt(readFileSync(pidPath, 'utf-8').trim(), 10);
+        try {
+            process.kill(pid);
+            console.log(chalk.green(`  Stopped watcher (PID ${pid})`));
+        }
+        catch {
+            console.log(chalk.yellow(`  Process ${pid} not found (already stopped?)`));
+        }
+        unlinkSync(pidPath);
+        return;
+    }
+    // Check project is initialized
+    const configPath = join(projectDir, '.codeloop', 'config.yaml');
+    if (!existsSync(configPath)) {
+        console.log(chalk.red('  No config.yaml found. Run `codeloop init` first.'));
+        process.exit(1);
+    }
+    const config = loadWatchConfig(projectDir);
+    if (!config.enabled) {
+        console.log(chalk.yellow('  Watch mode is disabled in config.yaml (watch.enabled: false)'));
+        return;
+    }
+    // --bg: fork as background process
+    if (options.bg) {
+        const { fork } = await import('child_process');
+        const args = ['watch'];
+        if (options.withServe)
+            args.push('--with-serve');
+        const child = fork(process.argv[1], args, {
+            detached: true,
+            stdio: 'ignore',
+        });
+        child.unref();
+        if (child.pid) {
+            const pidPath = join(projectDir, PID_FILE);
+            writeFileSync(pidPath, String(child.pid), 'utf-8');
+            console.log(chalk.green(`  Watcher started in background (PID ${child.pid})`));
+        }
+        return;
+    }
+    // Foreground mode
+    let broadcastFn;
+    // --with-serve: also start board server
+    if (options.withServe) {
+        const { createApp } = await import('../lib/server.js');
+        const { serve } = await import('@hono/node-server');
+        const { app, broadcast } = createApp(projectDir);
+        broadcastFn = broadcast;
+        const port = 4040;
+        serve({ fetch: app.fetch, port }, () => {
+            console.log(chalk.bold(`  Board: ${chalk.cyan(`http://localhost:${port}`)}`));
+        });
+    }
+    const engine = createWatchEngine(projectDir, broadcastFn);
+    console.log();
+    console.log(chalk.bold('  Codeloop Watch'));
+    const signals = Object.entries(config.signals)
+        .filter(([, v]) => v)
+        .map(([k]) => k);
+    console.log(chalk.dim(`  Signals: ${signals.join(', ')}`));
+    console.log(chalk.dim(`  Idle timeout: ${config.idle_timeout}s`));
+    console.log(chalk.dim('  Press Ctrl+C to stop'));
+    console.log();
+    engine.start();
+    // Graceful shutdown
+    const shutdown = () => {
+        console.log(chalk.dim('\n  Stopping watcher...'));
+        engine.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+});
+export function getWatchStatus(projectDir) {
+    const pidPath = join(projectDir, PID_FILE);
+    if (!existsSync(pidPath))
+        return { running: false };
+    const pid = parseInt(readFileSync(pidPath, 'utf-8').trim(), 10);
+    try {
+        process.kill(pid, 0);
+        return { running: true, pid };
+    }
+    catch {
+        try {
+            unlinkSync(pidPath);
+        }
+        catch { /* ignore */ }
+        return { running: false };
+    }
+}
+//# sourceMappingURL=watch.js.map

package/dist/commands/watch.js.map

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

package/dist/commands/wiki.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const wikiCommand: Command;
+export declare const learnCommand: Command;

package/dist/commands/wiki.js

@@ -0,0 +1,85 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { addCompetitor, listCompetitors } from '../lib/competitors.js';
+import { capture, inject, learn, lintWiki, listPages } from '../lib/wiki.js';
+import { guard } from './guard.js';
+const row = (p) => `  ${p.severity === 'critical' ? chalk.red('critical') : 'warning '} freq ${String(p.freq).padEnd(3)} ${p.title}  ${chalk.dim(p.path)}`;
+export const wikiCommand = new Command('wiki').description('Gotchas, decisions and concepts that agents read before a stage and write after it');
+wikiCommand
+    .command('capture')
+    .description('Write a page; capturing an existing title raises its frequency')
+    .requiredOption('--title <title>', 'Page title')
+    .option('--scope <glob...>', 'File globs the page applies to', [])
+    .option('--body <text>', 'Page body', '')
+    .option('--kind <kind>', 'gotcha | decision | concept', 'gotcha')
+    .option('--card <id>', 'Card this came from')
+    .action(guard((opts) => {
+    console.log(row(capture(process.cwd(), opts)));
+}));
+wikiCommand
+    .command('inject')
+    .description('Print the pages whose scope matches the given files')
+    .requiredOption('--files <path...>', 'Changed or soon-to-change files')
+    .option('--json', 'JSON output')
+    .action(guard((opts) => {
+    const pages = inject(process.cwd(), opts.files);
+    if (opts.json) {
+        console.log(JSON.stringify(pages, null, 2));
+        return;
+    }
+    for (const p of pages)
+        console.log(`## ${p.title} (${p.kind}, freq ${p.freq}, ${p.severity})\n\n${p.body}\n`);
+    if (pages.length === 0)
+        console.log('  no wiki pages apply to these files');
+}));
+wikiCommand
+    .command('list')
+    .description('List pages')
+    .action(guard(() => {
+    const pages = listPages(process.cwd());
+    if (pages.length === 0)
+        console.log('  no wiki pages');
+    pages.forEach(p => console.log(row(p)));
+}));
+wikiCommand
+    .command('lint')
+    .description('Report broken links (exit 1), stale pages and duplicate titles')
+    .action(guard(() => {
+    const { broken, stale, duplicates } = lintWiki(process.cwd());
+    broken.forEach(b => console.error(chalk.red(`  broken: ${b}`)));
+    stale.forEach(s => console.log(chalk.yellow(`  stale: ${s}`)));
+    duplicates.forEach(d => console.log(chalk.yellow(`  duplicate: ${d}`)));
+    if (broken.length)
+        process.exit(1);
+    console.log(`  wiki ok${stale.length + duplicates.length ? ` (${stale.length} stale, ${duplicates.length} duplicate)` : ''}`);
+}));
+const competitorCommand = wikiCommand.command('competitor').description('One wiki page per competitor: links at the top, findings from each research stage below');
+competitorCommand
+    .command('add <name>')
+    .description('Create .codeloop/wiki/competitors/<name>.md, or update the links of an existing page')
+    .option('--docs <url>', 'Where their product docs are')
+    .option('--changelog <url>', 'Where they announce what shipped; `codeloop scan competitors` reads it')
+    .option('--title <title>', 'Display name (default: the name)')
+    .action(guard((name, opts) => {
+    const page = addCompetitor(process.cwd(), { name, ...opts });
+    console.log(`  ${page.path}  ${chalk.dim(`docs ${page.docs ?? '-'}  changelog ${page.changelog ?? '-'}`)}`);
+}));
+competitorCommand
+    .command('list')
+    .description('List competitor pages')
+    .action(guard(() => {
+    const pages = listCompetitors(process.cwd());
+    if (pages.length === 0)
+        console.log('  no competitor pages; `codeloop wiki competitor add <name> --docs <url> --changelog <url>`');
+    pages.forEach(c => console.log(`  ${c.title.padEnd(16)} ${chalk.dim(c.path)}  changelog ${c.changelog ?? '-'}`));
+}));
+export const learnCommand = new Command('learn')
+    .description('Apply frequency thresholds: critical at critical_frequency, promoted to rules.md at promote_frequency')
+    .action(guard(() => {
+    const { critical, promoted } = learn(process.cwd());
+    critical.forEach(t => console.log(`  now critical: ${t}`));
+    promoted.forEach(t => console.log(`  promoted to .codeloop/rules.md: ${t}`));
+    if (critical.length + promoted.length === 0)
+        console.log('  nothing crossed a threshold');
+}));
+//# sourceMappingURL=wiki.js.map

package/dist/commands/wiki.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { initCommand } from './commands/init.js';
+import { updateCommand } from './commands/update.js';
+import { statusCommand } from './commands/status.js';
+import { serveCommand } from './commands/serve.js';
+import { watchCommand } from './commands/watch.js';
+import { installCommand } from './commands/install.js';
+import { searchCommand } from './commands/search.js';
+import { listCommand } from './commands/list.js';
+import { removeCommand } from './commands/remove.js';
+import { publishCommand } from './commands/publish.js';
+import { loginCommand } from './commands/login.js';
+import { laneCommand } from './commands/lane.js';
+import { approveCommand, cardCommand, nextCommand, rejectCommand, startCommand } from './commands/card.js';
+import { inboxCommand } from './commands/inbox.js';
+import { runCommand } from './commands/run.js';
+import { briefCommand } from './commands/brief.js';
+import { scheduleCommand } from './commands/schedule.js';
+import { adoptCommand } from './commands/adopt.js';
+import { checkCommand } from './commands/check.js';
+import { packCommand } from './commands/pack.js';
+import { specCommand, taskCommand } from './commands/spec.js';
+import { importCommand } from './commands/import.js';
+import { statsCommand, verifyCommand } from './commands/verify.js';
+import { learnCommand, wikiCommand } from './commands/wiki.js';
+import { configCommand, gateCommand, mcpCommand, renderCommand } from './commands/render.js';
+import { cloudCommand, syncBeforeCommand } from './commands/cloud.js';
+import { mockCommand, mocksCommand } from './commands/mock.js';
+import { scanCommand } from './commands/scan.js';
+const program = new Command();
+program
+    .name('codeloop')
+    .description('Self-improving development workflow for AI coding agents')
+    .version('0.3.0');
+// With the cloud connected, every command first pushes pending writes and takes what changed there.
+program.hook('preAction', (_program, action) => {
+    let top = action;
+    while (top.parent && top.parent !== program)
+        top = top.parent;
+    syncBeforeCommand(top.name());
+});
+// Project management
+program.addCommand(initCommand);
+program.addCommand(updateCommand);
+program.addCommand(statusCommand);
+program.addCommand(serveCommand);
+program.addCommand(watchCommand);
+// Lane engine
+program.addCommand(laneCommand);
+program.addCommand(cardCommand);
+program.addCommand(startCommand);
+program.addCommand(nextCommand);
+program.addCommand(approveCommand);
+program.addCommand(rejectCommand);
+program.addCommand(inboxCommand);
+program.addCommand(runCommand);
+program.addCommand(briefCommand);
+program.addCommand(scheduleCommand);
+program.addCommand(adoptCommand);
+program.addCommand(checkCommand);
+program.addCommand(packCommand);
+program.addCommand(specCommand);
+program.addCommand(mockCommand);
+program.addCommand(mocksCommand);
+program.addCommand(scanCommand);
+program.addCommand(taskCommand);
+program.addCommand(importCommand);
+program.addCommand(verifyCommand);
+program.addCommand(statsCommand);
+program.addCommand(wikiCommand);
+program.addCommand(learnCommand);
+program.addCommand(renderCommand);
+program.addCommand(mcpCommand);
+program.addCommand(gateCommand);
+program.addCommand(configCommand);
+program.addCommand(cloudCommand);
+// Skill registry
+program.addCommand(installCommand);
+program.addCommand(searchCommand);
+program.addCommand(listCommand);
+program.addCommand(removeCommand);
+program.addCommand(publishCommand);
+program.addCommand(loginCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/agent.d.ts

@@ -0,0 +1,27 @@
+import { type Card } from './cards.js';
+export declare const BRIEFS_DIR = ".codeloop/state/briefs";
+export declare const AGENT_RUNS_DIR = ".codeloop/state/agent-runs";
+export interface AgentConfig {
+    name: string;
+    cmd: string;
+    timeoutMinutes: number;
+    maxRunsPerDay: number;
+}
+export interface AgentsConfig {
+    agents: Record<string, AgentConfig>;
+    default?: string;
+    /** `run.agent: true`: a plain `codeloop run` starts agents too. */
+    runByDefault: boolean;
+}
+export declare function loadAgents(projectDir: string): AgentsConfig;
+export declare function resolveAgent(projectDir: string, name?: string): AgentConfig;
+export declare function briefPath(card: Card): string;
+/** Everything a headless agent is given to do the card's current stage. */
+export declare function buildBrief(projectDir: string, card: Card): string;
+export interface AgentRun {
+    exit: number | null;
+    timedOut: boolean;
+    durationMs: number;
+}
+/** Runs the agent command in the project with `{brief}` filled in. Output goes to `logFile`. */
+export declare function runAgent(projectDir: string, agent: AgentConfig, briefFile: string, logFile: string): Promise<AgentRun>;

package/dist/lib/agent.js

@@ -0,0 +1,178 @@
+import { spawn } from 'child_process';
+import { closeSync, existsSync, mkdirSync, openSync, readdirSync, readFileSync, readSync, statSync, writeFileSync } from 'fs';
+import { dirname, isAbsolute, join } from 'path';
+import { RefusalError, safeName } from './cards.js';
+import { listCompetitors } from './competitors.js';
+import { loadConfig } from './config.js';
+import { stageBrief } from './flow.js';
+import { loadLane, loadSkillsIndex, shellQuote, SKILLS_INDEX } from './lane.js';
+import { checkEnv } from './shell.js';
+import { parseFrontmatter } from './skills.js';
+import { readTasks } from './spec.js';
+import { inject } from './wiki.js';
+export const BRIEFS_DIR = '.codeloop/state/briefs';
+export const AGENT_RUNS_DIR = '.codeloop/state/agent-runs';
+const DEFAULT_TIMEOUT_MINUTES = 20;
+const DEFAULT_MAX_RUNS_PER_DAY = 20;
+const LOG_TAIL_BYTES = 64_000;
+export function loadAgents(projectDir) {
+    const raw = loadConfig(projectDir);
+    const agents = {};
+    for (const [name, value] of Object.entries((raw.agents ?? {}))) {
+        if (name === 'default')
+            continue;
+        if (typeof value?.cmd !== 'string' || !value.cmd.trim())
+            throw new RefusalError(`agents.${name} in .codeloop/config.yaml has no cmd`);
+        agents[name] = {
+            name,
+            cmd: value.cmd,
+            timeoutMinutes: Number(value.timeout_minutes ?? DEFAULT_TIMEOUT_MINUTES),
+            maxRunsPerDay: Number(value.max_runs_per_day ?? DEFAULT_MAX_RUNS_PER_DAY),
+        };
+    }
+    return { agents, default: raw.agents?.default, runByDefault: raw.run?.agent === true };
+}
+export function resolveAgent(projectDir, name) {
+    const config = loadAgents(projectDir);
+    const names = Object.keys(config.agents);
+    if (names.length === 0)
+        throw new RefusalError('no agent is configured; add `agents:` to .codeloop/config.yaml (the starter config has presets for claude and codex)');
+    const wanted = name ?? config.default ?? (names.length === 1 ? names[0] : undefined);
+    if (!wanted)
+        throw new RefusalError(`several agents are configured (${names.join(', ')}); name one or set agents.default`);
+    const agent = config.agents[wanted];
+    if (!agent)
+        throw new RefusalError(`agent "${wanted}" is not in .codeloop/config.yaml (configured: ${names.join(', ')})`);
+    return agent;
+}
+export function briefPath(card) {
+    return `${BRIEFS_DIR}/${card.id}-${safeName(card.stage, 'stage id')}.md`;
+}
+function skillBody(projectDir, name) {
+    const source = loadSkillsIndex(projectDir)?.find(s => s.name === name)?.source;
+    if (!source)
+        return null;
+    const file = isAbsolute(source) ? source : join(projectDir, source);
+    return existsSync(file) ? parseFrontmatter(readFileSync(file, 'utf-8')).body.trim() : null;
+}
+// The stage output, what is already in the card's spec folder, and the paths its open tasks name.
+function filesInScope(projectDir, card, output) {
+    const files = output ? [output] : [];
+    if (card.spec && existsSync(join(projectDir, card.spec))) {
+        files.push(...readdirSync(join(projectDir, card.spec)).map(f => `${card.spec}/${f}`));
+        if (existsSync(join(projectDir, card.spec, 'tasks.md'))) {
+            for (const task of readTasks(projectDir, card.spec).tasks.filter(t => !t.done)) {
+                files.push(...(task.text.match(/(?:[\w.-]+\/)+[\w.-]+/g) ?? []));
+            }
+        }
+    }
+    return [...new Set(files)];
+}
+/** Everything a headless agent is given to do the card's current stage. */
+export function buildBrief(projectDir, card) {
+    const stage = stageBrief(projectDir, card);
+    if (!stage)
+        throw new RefusalError(`card ${card.id} has no stage to brief (it is ${card.stage})`);
+    const lane = loadLane(projectDir, card.lane);
+    const events = card.events.filter(e => e.stage === card.stage);
+    const lines = [
+        `# Stage brief: ${card.id} ${card.stage}`,
+        '',
+        `Card: ${card.id}`,
+        `Title: ${card.title}`,
+        `Lane: ${lane.id} (version ${lane.version})`,
+        `Stage: ${card.stage}`,
+        ...(stage.skill ? [`Skill: ${stage.skill}`] : []),
+        ...(stage.output ? [`Output: ${stage.output}`] : []),
+        '',
+        '## The check that must pass',
+        '',
+        `The stage is finished when this command, run from the project root, exits 0${stage.output ? `. It judges ${stage.output}, which this stage writes` : ''}:`,
+        '',
+        `    ${stage.done}`,
+        '',
+    ];
+    const failed = events.filter(e => e.action === 'fail' || e.action === 'stuck').at(-1);
+    if (stage.notes.length || stage.rejections.length || failed?.note) {
+        lines.push('## Feedback on this stage', '');
+        for (const note of stage.notes)
+            lines.push(`- Stage note: ${note}`);
+        stage.rejections.forEach((note, i) => lines.push(`- ${i === stage.rejections.length - 1 ? 'Latest rejection' : 'Earlier rejection'}: ${note}`));
+        if (failed?.note)
+            lines.push('', `The check last failed${failed.action === 'stuck' ? ' and the card was marked stuck' : ''} with:`, '', ...failed.note.split('\n').map(l => `    ${l}`));
+        lines.push('');
+    }
+    if (stage.skill) {
+        const body = skillBody(projectDir, stage.skill);
+        lines.push(`## Skill: ${stage.skill}`, '', body ?? `The skill's text is not in ${SKILLS_INDEX}; use the /${stage.skill} skill if your tool has it.`, '');
+    }
+    const pages = inject(projectDir, filesInScope(projectDir, card, stage.output));
+    if (pages.length) {
+        lines.push('## Wiki pages that apply', '');
+        for (const p of pages)
+            lines.push(`### ${p.title} (${p.kind}, freq ${p.freq}, ${p.severity})`, '', p.body, '');
+    }
+    const competitors = card.stage === 'research' ? listCompetitors(projectDir) : [];
+    if (competitors.length) {
+        lines.push('## Competitors', '', `Read each one's docs and changelog for this feature. Give each a row in ${stage.output ?? 'the research file'} that starts with its name: the row is copied to its page when the stage passes.`, '');
+        for (const c of competitors)
+            lines.push(`### ${c.title} (${c.path})`, '', ...(c.docs ? [`Docs: ${c.docs}`] : []), ...(c.changelog ? [`Changelog: ${c.changelog}`] : []), '', c.body, '');
+    }
+    lines.push('## Rules', '', `- Do only the ${card.stage} stage of ${card.id}.`, stage.output ? `- Write the output to ${stage.output}.` : '- Leave the project in the state the check asks for.', '- Do not run `codeloop approve`, `codeloop next` or `codeloop card advance`. The run that started you checks the work and moves the card.', '- Do not edit .codeloop/cards.json or anything in .codeloop/lanes/.', '- Stop when the output is written.', '');
+    return lines.join('\n');
+}
+// Keeps the end of the log, where an agent says what it did or why it stopped.
+function keepTail(file) {
+    const size = statSync(file).size;
+    if (size <= LOG_TAIL_BYTES)
+        return;
+    const fd = openSync(file, 'r');
+    const buffer = Buffer.alloc(LOG_TAIL_BYTES);
+    readSync(fd, buffer, 0, LOG_TAIL_BYTES, size - LOG_TAIL_BYTES);
+    closeSync(fd);
+    writeFileSync(file, `[first ${size - LOG_TAIL_BYTES} bytes dropped]\n${buffer.toString('utf-8')}`);
+}
+/** Runs the agent command in the project with `{brief}` filled in. Output goes to `logFile`. */
+export function runAgent(projectDir, agent, briefFile, logFile) {
+    mkdirSync(dirname(logFile), { recursive: true });
+    const out = openSync(logFile, 'w');
+    const started = Date.now();
+    return new Promise(done => {
+        let timedOut = false;
+        let finished = false;
+        const finish = (exit) => {
+            if (finished)
+                return;
+            finished = true;
+            clearTimeout(timer);
+            closeSync(out);
+            keepTail(logFile);
+            done({ exit, timedOut, durationMs: Date.now() - started });
+        };
+        // The command's output goes straight to the file: a pipe held open by a child the agent left
+        // behind would keep this process waiting after the agent itself has gone.
+        const child = spawn(agent.cmd.replaceAll('{brief}', shellQuote(briefFile)), {
+            cwd: projectDir,
+            shell: true,
+            detached: true,
+            stdio: ['ignore', out, out],
+            env: { ...checkEnv(), CODELOOP_ROLE: 'agent', CODELOOP_AGENT_RUN: agent.name },
+        });
+        const timer = setTimeout(() => {
+            timedOut = true;
+            // `detached` made the shell a process group leader, so this reaches the agent and its children.
+            try {
+                process.kill(-child.pid, 'SIGKILL');
+            }
+            catch {
+                child.kill('SIGKILL');
+            }
+        }, agent.timeoutMinutes * 60_000);
+        child.on('error', e => {
+            writeFileSync(logFile, `could not start: ${e.message}\n`, { flag: 'a' });
+            finish(null);
+        });
+        child.on('exit', code => finish(code));
+    });
+}
+//# sourceMappingURL=agent.js.map

package/dist/lib/agent.js.map

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

package/dist/lib/board.d.ts

@@ -0,0 +1,38 @@
+export interface TaskStep {
+    text: string;
+    done: boolean;
+}
+export interface Task {
+    id: string;
+    title: string;
+    description?: string;
+    status: 'backlog' | 'planned' | 'in_progress' | 'review' | 'done';
+    labels: string[];
+    steps: TaskStep[];
+    commits: string[];
+    acceptanceCriteria?: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Board {
+    version: 1;
+    columns: string[];
+    tasks: Task[];
+}
+export declare function createBoard(): Board;
+export declare function nextId(board: Board): string;
+export interface AddTaskInput {
+    title: string;
+    description?: string;
+    status?: Task['status'];
+    labels?: string[];
+    steps?: TaskStep[];
+    acceptanceCriteria?: string[];
+}
+export declare function addTask(board: Board, input: AddTaskInput): Board;
+export declare function updateTask(board: Board, id: string, patch: Partial<Omit<Task, 'id' | 'createdAt'>>): Board;
+export declare function moveTask(board: Board, id: string, newStatus: Task['status']): Board;
+export declare function deleteTask(board: Board, id: string): Board;
+export declare function getTask(board: Board, id: string): Task | undefined;
+export declare function loadBoard(dir: string): Board;
+export declare function saveBoard(dir: string, board: Board): void;