@protoboxai/codeloop 0.3.0

package/dist/commands/brief.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const briefCommand: Command;

package/dist/commands/brief.js

@@ -0,0 +1,22 @@
+import { Command } from 'commander';
+import { mkdirSync, writeFileSync } from 'fs';
+import { dirname, resolve } from 'path';
+import { buildBrief } from '../lib/agent.js';
+import { findCard, readCards } from '../lib/cards.js';
+import { guard } from './guard.js';
+export const briefCommand = new Command('brief')
+    .description("Print what an agent is given to do a card's current stage: skill, output, check, feedback, wiki pages, rules")
+    .argument('<card>')
+    .option('--out <file>', 'Write the brief to a file')
+    .action(guard((id, opts) => {
+    const projectDir = process.cwd();
+    const brief = buildBrief(projectDir, findCard(readCards(projectDir).cards, id));
+    if (!opts.out) {
+        process.stdout.write(brief);
+        return;
+    }
+    mkdirSync(dirname(resolve(opts.out)), { recursive: true });
+    writeFileSync(opts.out, brief);
+    console.log(`  wrote ${opts.out}`);
+}));
+//# sourceMappingURL=brief.js.map

package/dist/commands/brief.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief.js","sourceRoot":"","sources":["../../src/commands/brief.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;KAC7C,WAAW,CAAC,8GAA8G,CAAC;KAC3H,QAAQ,CAAC,QAAQ,CAAC;KAClB,MAAM,CAAC,cAAc,EAAE,2BAA2B,CAAC;KACnD,MAAM,CAAC,KAAK,CAAC,CAAC,EAAU,EAAE,IAAsB,EAAE,EAAE;IACnD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IAChF,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO;IACT,CAAC;IACD,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;AACrC,CAAC,CAAC,CAAC,CAAC"}

package/dist/commands/card.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+export declare const cardCommand: Command;
+export declare const startCommand: Command;
+export declare const nextCommand: Command;
+export declare const approveCommand: Command;
+export declare const rejectCommand: Command;

package/dist/commands/card.js

@@ -0,0 +1,159 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { DONE, DROPPED, findCard, inLane, readCards, RefusalError } from '../lib/cards.js';
+import { advanceCard, proposeCard, rejectCard, resolveRole } from '../lib/engine.js';
+import { approveFlow, describeAdvance, nextHint, stageBrief, startCard } from '../lib/flow.js';
+import { guard } from './guard.js';
+function line(card) {
+    const state = card.gate ? chalk.yellow(`waiting for you: ${card.gate}`) : card.stage === DONE ? chalk.green('done') : card.stage;
+    return `  ${card.id}  ${card.lane.padEnd(8)} ${state}  ${chalk.dim(card.title)}`;
+}
+function print(result) {
+    result.lines.forEach(l => console.log(l.startsWith('Next:') ? chalk.cyan(l) : l));
+    if (result.exitCode)
+        process.exit(result.exitCode);
+}
+const start = (lane, title, opts) => {
+    const projectDir = process.cwd();
+    const card = startCard(projectDir, { lane, title, id: opts.id, role: resolveRole(opts.as) });
+    console.log(`created ${card.id} in ${card.lane} at stage ${card.stage}${card.spec ? ` (${card.spec}/)` : ''}`);
+    print({ lines: [nextHint(projectDir, card)], exitCode: 0 });
+};
+const next = (id, opts) => {
+    const projectDir = process.cwd();
+    let ref = id;
+    if (!ref) {
+        const active = readCards(projectDir).cards.filter(c => inLane(c) && !c.gate);
+        if (active.length !== 1)
+            throw new RefusalError(active.length ? `${active.length} cards are active (${active.map(c => c.id).join(', ')}); say which` : 'no active card; `codeloop start "<title>"` creates one');
+        ref = active[0].id;
+    }
+    print(describeAdvance(projectDir, advanceCard(projectDir, ref, { event: opts.event })));
+};
+const approve = (id, opts) => {
+    const projectDir = process.cwd();
+    const result = approveFlow(projectDir, id, resolveRole(opts.as), opts.note);
+    console.log(`${result.card.id} ${result.gate === 'stuck' ? 'can be retried' : result.gate === 'proposal' ? `promoted to ${result.card.lane}/${result.card.stage}` : `gate ${result.gate} approved`}`);
+    print(result.advanced ? describeAdvance(projectDir, result.advanced) : { lines: [nextHint(projectDir, result.card)], exitCode: 0 });
+};
+const reject = (id, note, opts) => {
+    const projectDir = process.cwd();
+    const card = rejectCard(projectDir, id, resolveRole(opts.as), note ?? opts.note ?? '');
+    if (card.stage === DROPPED) {
+        console.log(`${card.id} dropped; note recorded`);
+        return;
+    }
+    console.log(`${card.id} rejected at ${card.stage}; note recorded`);
+    print({ lines: [nextHint(projectDir, card).replace('Next: run', 'Next: redo with')], exitCode: 0 });
+};
+const ROLE = ['--as <role>', 'owner | reviewer | agent (default: owner at a terminal, agent otherwise)'];
+export const cardCommand = new Command('card').description('Create and move cards through a lane');
+cardCommand
+    .command('new <lane> <title>')
+    .description('Create a card in the first stage of a lane')
+    .option('--id <id>', 'Card id (default: next c-NNN)')
+    .option(...ROLE)
+    .action(guard(start));
+cardCommand
+    .command('propose <lane> <title>')
+    .description('Propose a card: it waits in the inbox until the owner promotes it with `codeloop approve`, and nothing starts it')
+    .option('--description <text>', 'What was seen, for the owner deciding')
+    .option('--source <url or path>', 'Where it came from')
+    .option(...ROLE)
+    .action(guard((lane, title, opts) => {
+    const { card, created } = proposeCard(process.cwd(), { lane, title, description: opts.description, source: opts.source, dedupe: opts.source ? `${lane}:${opts.source}:${title}` : undefined, role: resolveRole(opts.as) });
+    console.log(created ? `proposed ${card.id} for ${card.lane}: ${card.title}` : `already proposed as ${card.id}`);
+    print({ lines: [nextHint(process.cwd(), card)], exitCode: 0 });
+}));
+cardCommand
+    .command('show <id>')
+    .description('Show a card, its current stage brief and its events')
+    .option('--json', 'JSON output')
+    .action(guard((id, opts) => {
+    const projectDir = process.cwd();
+    const card = findCard(readCards(projectDir).cards, id);
+    const stage = stageBrief(projectDir, card);
+    if (opts.json) {
+        console.log(JSON.stringify({ ...card, brief: stage }, null, 2));
+        return;
+    }
+    console.log(line(card));
+    if (card.description)
+        console.log(card.description.split('\n').map(l => `  ${l}`).join('\n'));
+    if (card.source && !card.description?.includes(card.source))
+        console.log(`  source: ${card.source}`);
+    if (stage) {
+        if (stage.skill)
+            console.log(`  skill:  ${stage.skill}`);
+        if (stage.output)
+            console.log(`  output: ${stage.output}`);
+        if (stage.done)
+            console.log(`  check:  ${stage.done}`);
+        for (const note of stage.notes)
+            console.log(`  note:   ${note}`);
+        for (const note of stage.rejections)
+            console.log(chalk.yellow(`  rejected: ${note}`));
+    }
+    console.log();
+    for (const e of card.events) {
+        console.log(chalk.dim(`  ${e.at}  ${e.actor.padEnd(8)} ${e.action}${e.stage ? ` ${e.stage}` : ''}${e.note ? `: ${e.note.split('\n').at(-1)}` : ''}`));
+    }
+    console.log(chalk.cyan(nextHint(projectDir, card)));
+}));
+cardCommand
+    .command('list')
+    .description('List cards')
+    .option('--json', 'JSON output')
+    .action(guard((opts) => {
+    const { cards } = readCards(process.cwd());
+    if (opts.json)
+        console.log(JSON.stringify(cards, null, 2));
+    else if (cards.length === 0)
+        console.log('  no cards');
+    else
+        cards.forEach(c => console.log(line(c)));
+}));
+cardCommand
+    .command('advance [id]')
+    .description("Run the current stage's check and move the card if it passes")
+    .option('--event <name>', 'Report the event a stage with `done.event` is waiting for')
+    .action(guard(next));
+cardCommand
+    .command('approve <id>')
+    .description('Approve the gate a card is waiting at, then advance it once')
+    .option(...ROLE)
+    .option('--note <note>', 'Optional note')
+    .action(guard(approve));
+cardCommand
+    .command('reject <id> [note]')
+    .description('Reject the gate with a note; the card stays in its stage')
+    .option('--note <note>', 'What to change')
+    .option(...ROLE)
+    .action(guard(reject));
+// Short forms of the four commands a person types most.
+export const startCommand = new Command('start')
+    .description('Start a card: `codeloop start "<title>"` (same as card new, plus its spec folder)')
+    .argument('<title>')
+    .option('--lane <lane>', 'Lane to start in', 'build')
+    .option('--id <id>', 'Card id (default: next c-NNN)')
+    .option(...ROLE)
+    .action(guard((title, opts) => start(opts.lane, title, opts)));
+export const nextCommand = new Command('next')
+    .description('Run the check for a card and move it on (same as card advance); with one active card the id is optional')
+    .argument('[id]')
+    .option('--event <name>', 'Report the event a stage with `done.event` is waiting for')
+    .action(guard(next));
+export const approveCommand = new Command('approve')
+    .description('Approve the gate a card is waiting at (same as card approve)')
+    .argument('<id>')
+    .option(...ROLE)
+    .option('--note <note>', 'Optional note')
+    .action(guard(approve));
+export const rejectCommand = new Command('reject')
+    .description('Reject with a note: `codeloop reject <id> "<what to change>"`')
+    .argument('<id>')
+    .argument('[note]')
+    .option('--note <note>', 'What to change')
+    .option(...ROLE)
+    .action(guard(reject));
+//# sourceMappingURL=card.js.map

package/dist/commands/card.js.map

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

package/dist/commands/check.d.ts

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+/** Why the file does not pass, or null. With nothing to look for, an empty file still fails: `touch` is not work. */
+export declare function fileProblem(path: string, has: string[]): string | null;
+export declare const checkCommand: Command;

package/dist/commands/check.js

@@ -0,0 +1,76 @@
+import { Command } from 'commander';
+import { existsSync, readFileSync } from 'fs';
+import { RefusalError } from '../lib/cards.js';
+import { checkMock } from '../lib/mock.js';
+import { checkOnline, checkResearch } from '../lib/research.js';
+import { blockingGotchas } from '../lib/wiki.js';
+/** Why the file does not pass, or null. With nothing to look for, an empty file still fails: `touch` is not work. */
+export function fileProblem(path, has) {
+    if (!existsSync(path))
+        return `missing file: ${path}`;
+    const text = readFileSync(path, 'utf-8');
+    if (text.trim() === '')
+        return `${path} is empty`;
+    const missing = has.filter(s => !text.includes(s));
+    return missing.length ? `${path} is missing: ${missing.map(s => `"${s}"`).join(', ')}` : null;
+}
+export const checkCommand = new Command('check').description('Done-check helpers for lane stages');
+checkCommand
+    .command('file <path>')
+    .description('Exit 1 unless the file exists, is not empty, and contains every --has string')
+    .option('--has <str...>', 'Strings the file must contain')
+    .action((path, opts) => {
+    const problem = fileProblem(path, opts.has ?? []);
+    if (problem) {
+        console.error(problem);
+        process.exit(1);
+    }
+});
+checkCommand
+    .command('gotchas')
+    .description('Exit 1 while a critical wiki page applies to these files and has not been acknowledged')
+    .requiredOption('--files <path...>', 'Changed files')
+    .option('--ack <title...>', 'Titles of critical pages that were read and handled', [])
+    .action((opts) => {
+    const blocking = blockingGotchas(process.cwd(), opts.files, opts.ack);
+    for (const p of blocking)
+        console.error(`critical: ${p.title} (freq ${p.freq}, ${p.path})\n${p.body}\n`);
+    if (blocking.length) {
+        console.error(`${blocking.length} critical wiki page(s) apply. Read them, then re-run with --ack "<title>" for each.`);
+        process.exit(1);
+    }
+});
+// A check exits 1 with one line per problem. A card with no spec folder is a problem too, not a crash.
+function failing(run) {
+    return async () => {
+        let problems;
+        try {
+            problems = await run();
+        }
+        catch (e) {
+            if (!(e instanceof RefusalError))
+                throw e;
+            problems = [e.message];
+        }
+        problems.forEach(p => console.error(p));
+        if (problems.length)
+            process.exit(1);
+    };
+}
+checkCommand
+    .command('research <card>')
+    .description("Exit 1 unless the card's research.md has a `verdict:` line and enough `- source: <url> — <note>` lines")
+    .option('--min-sources <n>', 'How many source lines are required', '3')
+    .option('--online', 'Also require each source URL to answer with 2xx or 3xx')
+    .action((card, opts) => failing(async () => {
+    const min = parseInt(opts.minSources, 10);
+    if (!Number.isInteger(min) || min < 0)
+        return [`--min-sources "${opts.minSources}" is not a number`];
+    const { errors, urls } = checkResearch(process.cwd(), card, min);
+    return opts.online ? [...errors, ...(await checkOnline(urls))] : errors;
+})());
+checkCommand
+    .command('mock <card>')
+    .description("Exit 1 unless the card's mock is built from the shared template, keeps its tokens, uses no other colours and draws every screen the spec names")
+    .action((card) => failing(() => checkMock(process.cwd(), card))());
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

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

package/dist/commands/cloud.d.ts

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+/**
+ * The step before every command while connected. What it did goes to stderr, so `--json` output
+ * and the MCP server's stdout stay clean. A pending board write that the cloud has moved past
+ * refuses the command with exit 3; any other trouble leaves the command to run on local files.
+ */
+export declare function syncBeforeCommand(command: string): void;
+export declare const cloudCommand: Command;

package/dist/commands/cloud.js

@@ -0,0 +1,123 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { CloudConflictError, CloudError, connect, disconnect, pull, push, search, status, syncBefore } from '../lib/cloud.js';
+const CONFLICT_HINT = 'Next: `codeloop cloud pull` takes the cloud board; `codeloop cloud push --force` replaces it with yours.';
+/** Exit 3 on a version conflict, as for a local one; 1 for anything else the cloud refuses. */
+function guardCloud(fn) {
+    return (...args) => {
+        try {
+            fn(...args);
+        }
+        catch (e) {
+            if (e instanceof CloudConflictError) {
+                console.error(chalk.red(`conflict: ${e.message}`));
+                console.error(CONFLICT_HINT);
+                process.exit(3);
+            }
+            console.error(chalk.red(e instanceof CloudError ? e.message : String(e.message)));
+            process.exit(1);
+        }
+    };
+}
+// `cloud` commands sync themselves, `init` and `check` have nothing to sync, and a command started
+// by a check or an agent runs inside one that has already synced. CODELOOP_NO_SYNC=1 skips the
+// step for any command: a script that reads many times in a row would otherwise spend the
+// endpoint's requests on listings.
+const NO_SYNC = new Set(['cloud', 'init', 'check', 'help']);
+/**
+ * The step before every command while connected. What it did goes to stderr, so `--json` output
+ * and the MCP server's stdout stay clean. A pending board write that the cloud has moved past
+ * refuses the command with exit 3; any other trouble leaves the command to run on local files.
+ */
+export function syncBeforeCommand(command) {
+    if (NO_SYNC.has(command) || process.env.CODELOOP_NO_SYNC)
+        return;
+    try {
+        for (const note of syncBefore(process.cwd()))
+            console.error(chalk.dim(`  cloud: ${note}`));
+    }
+    catch (e) {
+        if (e instanceof CloudConflictError) {
+            console.error(chalk.red(`conflict: ${e.message}`));
+            console.error(CONFLICT_HINT);
+            process.exit(3);
+        }
+        console.error(chalk.yellow(`  cloud: ${e.message}; working from the local files`));
+    }
+}
+export const cloudCommand = new Command('cloud').description('Optional: keep the board, wiki, config and lanes in a Protobox workspace as well as in the repo');
+cloudCommand
+    .command('connect')
+    .description('Save the connection in .codeloop/cloud.json (gitignored) and upload the board, wiki, config.yaml and lanes')
+    .requiredOption('--url <mcp url>', 'Workspace MCP URL')
+    .requiredOption('--key <api key>', 'Workspace API key (stored in cloud.json, never printed)')
+    .option('--workspace-name <name>', 'A label for status output')
+    .option('--folder <path>', 'Workspace folder for this project\'s pages (default: codeloop)')
+    .action(guardCloud((opts) => {
+    const r = connect(process.cwd(), opts);
+    console.log(r.adopted
+        ? `  connected: a board page already exists (revision ${r.revision}) and was left as it is`
+        : `  connected: board uploaded (revision ${r.revision})`);
+    console.log(`  ${r.wikiPages} wiki pages uploaded`);
+    r.notes.forEach(n => console.log(chalk.yellow(`  ${n}`)));
+    if (r.adopted)
+        console.log('Next: `codeloop cloud pull` to take the cloud board, or `codeloop cloud push --force` to replace it with yours.');
+}));
+cloudCommand
+    .command('status')
+    .description('Workspace, page revision against the local version, and each document as in-sync, local-ahead, cloud-ahead or both-changed')
+    .option('--json', 'JSON output')
+    .action(guardCloud((opts) => {
+    const s = status(process.cwd());
+    if (opts.json) {
+        console.log(JSON.stringify(s, null, 2));
+        return;
+    }
+    console.log(`  workspace: ${s.workspaceName ? `${s.workspaceName} ` : ''}${s.url}`);
+    console.log(`  board page "${s.boardTitle}": revision ${s.pageRevision} (last seen here: ${s.lastSeenRevision})`);
+    console.log(`  local cards.json: version ${s.localVersion}, ${s.cards} cards`);
+    console.log(`  in sync: ${s.inSync ? 'yes' : 'no'}   wiki pages: ${s.wikiPages}`);
+    for (const d of s.documents) {
+        const state = d.state === 'in-sync' ? chalk.green(d.state.padEnd(12)) : chalk.yellow(d.state.padEnd(12));
+        console.log(`  ${state} ${d.path}${d.pending ? chalk.dim('  (pending: kept locally while the cloud was unreachable)') : ''}`);
+    }
+}));
+cloudCommand
+    .command('push')
+    .description('Write the board, wiki pages and config that changed here to the cloud. Lanes are not pushed: they change through `lane promote`')
+    .option('--force', 'Overwrite even if the cloud copy changed since it was last seen here')
+    .action(guardCloud((opts) => {
+    const r = push(process.cwd(), opts);
+    console.log(`  pushed: board revision ${r.revision}, ${r.wikiPages} wiki pages`);
+    r.held.forEach(p => console.log(chalk.yellow(`  not pushed: ${p} was edited here; a lane changes through \`codeloop lane promote\``)));
+}));
+cloudCommand
+    .command('pull')
+    .description('Take the cloud board, and every other cloud copy whose local file was not edited here')
+    .option('--force', 'Take the cloud copy of every document, discarding local edits')
+    .action(guardCloud((opts) => {
+    const r = pull(process.cwd(), opts);
+    console.log(`  pulled: board revision ${r.revision}, ${r.wikiPages} wiki pages`);
+    r.notes.forEach(n => console.log(chalk.yellow(`  ${n}`)));
+}));
+cloudCommand
+    .command('disconnect')
+    .description('Push pending writes, pull everything back into the repo, then remove cloud.json')
+    .action(guardCloud(() => {
+    const r = disconnect(process.cwd());
+    console.log(`  disconnected: board (revision ${r.revision}) and ${r.wikiPages} wiki pages are back in the repo; .codeloop/cloud.json removed`);
+}));
+cloudCommand
+    .command('search <query>')
+    .description('Search the workspace knowledge base')
+    .option('--json', 'JSON output')
+    .action(guardCloud((query, opts) => {
+    const results = search(process.cwd(), query);
+    if (opts.json)
+        console.log(JSON.stringify(results, null, 2));
+    else if (results.length === 0)
+        console.log('  no results');
+    else
+        results.forEach(r => console.log(`  ${r.title}`));
+}));
+//# sourceMappingURL=cloud.js.map

package/dist/commands/cloud.js.map

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

package/dist/commands/guard.d.ts

@@ -0,0 +1,2 @@
+/** Exit codes: 2 = a check, gate or permission refused; 3 = cards.json version conflict. */
+export declare function guard<A extends unknown[]>(fn: (...args: A) => void | Promise<void>): (...args: A) => Promise<void>;

package/dist/commands/guard.js

@@ -0,0 +1,26 @@
+import chalk from 'chalk';
+import { ConflictError } from '../lib/cards.js';
+import { CloudConflictError } from '../lib/cloud.js';
+import { RefusalError } from '../lib/engine.js';
+/** Exit codes: 2 = a check, gate or permission refused; 3 = cards.json version conflict. */
+export function guard(fn) {
+    return async (...args) => {
+        try {
+            await fn(...args);
+        }
+        catch (e) {
+            const message = e.message;
+            if (e instanceof RefusalError) {
+                console.error(chalk.red(`refused: ${message}`));
+                process.exit(2);
+            }
+            if (e instanceof ConflictError || e instanceof CloudConflictError) {
+                console.error(chalk.red(`conflict: ${message}`));
+                process.exit(3);
+            }
+            console.error(chalk.red(message));
+            process.exit(1);
+        }
+    };
+}
+//# sourceMappingURL=guard.js.map

package/dist/commands/guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard.js","sourceRoot":"","sources":["../../src/commands/guard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,4FAA4F;AAC5F,MAAM,UAAU,KAAK,CAAsB,EAAwC;IACjF,OAAO,KAAK,EAAE,GAAG,IAAO,EAAiB,EAAE;QACzC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,OAAO,GAAI,CAAW,CAAC,OAAO,CAAC;YACrC,IAAI,CAAC,YAAY,YAAY,EAAE,CAAC;gBAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC,CAAC;gBAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,IAAI,CAAC,YAAY,aAAa,IAAI,CAAC,YAAY,kBAAkB,EAAE,CAAC;gBAClE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,OAAO,EAAE,CAAC,CAAC,CAAC;gBACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/commands/import.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const importCommand: Command;

package/dist/commands/import.js

@@ -0,0 +1,24 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { importBmad, importSpecKit } from '../lib/import.js';
+import { guard } from './guard.js';
+function report(result) {
+    result.cards.forEach(c => console.log(`  ${c.id} at ${c.stage}: ${c.title}  ${chalk.dim(c.spec ?? '')}`));
+    if (result.flagged.length) {
+        console.log(chalk.yellow(`  ${result.flagged.length} tasks have no layer; replace [?] with api, sdk, ui, test or docs:`));
+        result.flagged.forEach(f => console.log(chalk.dim(`    ${f.file}: ${f.task}`)));
+    }
+    console.log(`  imported ${result.cards.length} cards`);
+}
+export const importCommand = new Command('import').description('Bring existing specs in as cards; source files are only read');
+importCommand
+    .command('speckit [dir]')
+    .description('One card per specs/NNN* feature, tasks rewritten with layer tags')
+    .option('--lane <id>', 'Lane to create cards in', 'build')
+    .action(guard((dir, opts) => report(importSpecKit(process.cwd(), dir ?? '.', opts.lane))));
+importCommand
+    .command('bmad [dir]')
+    .description('One card per story in sprint-status.yaml, status mapped to a stage')
+    .option('--lane <id>', 'Lane to create cards in', 'build')
+    .action(guard((dir, opts) => report(importBmad(process.cwd(), dir ?? '.', opts.lane))));
+//# sourceMappingURL=import.js.map

package/dist/commands/import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.js","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,aAAa,EAAqB,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,SAAS,MAAM,CAAC,MAAoB;IAClC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1G,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,MAAM,oEAAoE,CAAC,CAAC,CAAC;QAC1H,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,8DAA8D,CAAC,CAAC;AAE/H,aAAa;KACV,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,kEAAkE,CAAC;KAC/E,MAAM,CAAC,aAAa,EAAE,yBAAyB,EAAE,OAAO,CAAC;KACzD,MAAM,CAAC,KAAK,CAAC,CAAC,GAAuB,EAAE,IAAsB,EAAE,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAEnI,aAAa;KACV,OAAO,CAAC,YAAY,CAAC;KACrB,WAAW,CAAC,oEAAoE,CAAC;KACjF,MAAM,CAAC,aAAa,EAAE,yBAAyB,EAAE,OAAO,CAAC;KACzD,MAAM,CAAC,KAAK,CAAC,CAAC,GAAuB,EAAE,IAAsB,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/commands/inbox.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const inboxCommand: Command;

package/dist/commands/inbox.js

@@ -0,0 +1,48 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { buildInbox, markInboxSeen } from '../lib/inbox.js';
+import { guard } from './guard.js';
+export const inboxCommand = new Command('inbox')
+    .description('What needs you, what shipped, and the numbers per lane')
+    .option('--json', 'JSON output')
+    .option('--seen', 'Mark everything shipped so far as seen')
+    .action(guard((opts) => {
+    const projectDir = process.cwd();
+    const inbox = buildInbox(projectDir);
+    if (opts.json) {
+        console.log(JSON.stringify(inbox, null, 2));
+    }
+    else {
+        console.log(inbox.summary);
+        console.log();
+        console.log(chalk.bold(`Waiting for you (${inbox.needs_you.length + inbox.needs_merge.length})`));
+        for (const c of inbox.needs_you) {
+            console.log(`  ${c.id}  ${c.title}: ${c.lane}/${c.stage}, gate ${chalk.yellow(c.gate)}`);
+            if (c.gate === 'proposal') {
+                console.log(chalk.dim(`        proposed${c.source ? ` from ${c.source}` : ''}; \`codeloop card show ${c.id}\` has the detail`));
+                console.log(chalk.dim(`        codeloop approve ${c.id}   puts it in the ${c.lane} lane   or   codeloop reject ${c.id} "<why not>"   drops it`));
+                continue;
+            }
+            console.log(chalk.dim(`        read: ${c.read ?? 'nothing written for this stage'}   last check: ${c.last_check}`));
+            if (c.mock)
+                console.log(chalk.dim(`        mock: ${c.mock}`));
+            console.log(chalk.dim(`        codeloop approve ${c.id}   or   codeloop reject ${c.id} "<what to change>"`));
+        }
+        for (const m of inbox.needs_merge) {
+            console.log(`  wiki  ${m.path}: changed here and in the cloud`);
+            console.log(chalk.dim(`        merge ${m.cloud} into it, then delete that file; the next command pushes your merge`));
+        }
+        console.log(chalk.bold(`Shipped (${inbox.shipped.length})`));
+        for (const c of inbox.shipped)
+            console.log(`  ${c.id}  ${c.lane}  ${chalk.dim(c.title)}`);
+        console.log(chalk.bold('Numbers'));
+        const pct = (n) => (n === null ? '-' : `${Math.round(n * 100)}%`);
+        for (const n of inbox.numbers) {
+            const turns = n.human_turns_per_card === null ? '-' : n.human_turns_per_card.toFixed(1);
+            console.log(`  ${n.lane.padEnd(10)} active ${n.active}  waiting ${n.parked}  done ${n.done}  human turns/card ${turns}  first pass ${pct(n.first_pass_rate)}`);
+        }
+    }
+    if (opts.seen)
+        markInboxSeen(projectDir);
+}));
+//# sourceMappingURL=inbox.js.map

package/dist/commands/inbox.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare const initCommand: Command;