@protoboxai/codeloop 0.3.0

package/dist/commands/publish.js

@@ -0,0 +1,125 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { parseSkillFile } from '../registry/skill-schema.js';
+import { validateSecurity } from '../registry/security.js';
+import { computeIntegrity } from '../registry/lockfile.js';
+const REGISTRY_URL = process.env.CODELOOP_REGISTRY_URL || 'https://skills.codeloop.dev';
+const TOKEN_PATH = join(process.env.HOME || '~', '.codeloop', 'auth.json');
+export const publishCommand = new Command('publish')
+    .description('Publish a skill to the registry (validate locally with --dry-run)')
+    .option('--dry-run', 'Validate only, don\'t publish')
+    .action(async (options) => {
+    const dir = process.cwd();
+    console.log();
+    // Find SKILL.md
+    const skillPath = join(dir, 'SKILL.md');
+    if (!existsSync(skillPath)) {
+        console.log(chalk.red('  No SKILL.md found in current directory.'));
+        console.log(chalk.dim('  Create a SKILL.md file with the required frontmatter to publish.'));
+        console.log();
+        return;
+    }
+    // Parse
+    const content = readFileSync(skillPath, 'utf-8');
+    let parsed;
+    try {
+        parsed = parseSkillFile(content);
+    }
+    catch (e) {
+        console.log(chalk.red(`  Validation error: ${e.message}`));
+        console.log();
+        return;
+    }
+    console.log(chalk.bold(`  Skill: ${parsed.manifest.name}@${parsed.manifest.version}`));
+    console.log(chalk.dim(`  ${parsed.manifest.description}`));
+    // Security check
+    const security = validateSecurity(content);
+    if (!security.passed) {
+        console.log();
+        console.log(chalk.red('  Security validation FAILED:'));
+        for (const finding of security.findings.filter(f => f.severity === 'block')) {
+            console.log(chalk.red(`    Line ${finding.line}: ${finding.message}`));
+        }
+        console.log();
+        return;
+    }
+    if (security.findings.length > 0) {
+        console.log();
+        console.log(chalk.yellow('  Security warnings:'));
+        for (const finding of security.findings.filter(f => f.severity === 'warn')) {
+            console.log(chalk.yellow(`    Line ${finding.line}: ${finding.message}`));
+        }
+    }
+    console.log(chalk.green('  Security: passed'));
+    if (options.dryRun) {
+        console.log();
+        console.log(chalk.bold('  Dry run complete — would publish:'));
+        console.log(chalk.dim(`    Name: ${parsed.manifest.name}`));
+        console.log(chalk.dim(`    Version: ${parsed.manifest.version}`));
+        console.log(chalk.dim(`    Tags: ${parsed.manifest.tags.join(', ') || 'none'}`));
+        console.log(chalk.dim(`    Stack: ${parsed.manifest.stack}`));
+        console.log(chalk.dim(`    Integrity: ${computeIntegrity(content)}`));
+        console.log();
+        return;
+    }
+    // Read auth token
+    if (!existsSync(TOKEN_PATH)) {
+        console.log();
+        console.log(chalk.red('  Not authenticated. Run `codeloop login` first.'));
+        console.log();
+        return;
+    }
+    let token;
+    try {
+        const auth = JSON.parse(readFileSync(TOKEN_PATH, 'utf-8'));
+        token = auth.token;
+        if (!token)
+            throw new Error('No token');
+    }
+    catch {
+        console.log(chalk.red('  Invalid auth file. Run `codeloop login` again.'));
+        console.log();
+        return;
+    }
+    // Publish to registry
+    console.log(chalk.dim('  Publishing...'));
+    try {
+        const res = await fetch(`${REGISTRY_URL}/api/skills/publish`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${token}`,
+            },
+            body: JSON.stringify({
+                name: parsed.manifest.name,
+                version: parsed.manifest.version,
+                description: parsed.manifest.description,
+                manifest: parsed.manifest,
+                integrity: computeIntegrity(content),
+                artifact_url: '', // TODO: upload artifact to GitHub Releases
+                tags: parsed.manifest.tags,
+                stack: parsed.manifest.stack,
+            }),
+        });
+        if (!res.ok) {
+            const data = await res.json();
+            console.log(chalk.red(`  Publish failed: ${data.error || res.statusText}`));
+            console.log();
+            return;
+        }
+        const data = await res.json();
+        console.log(chalk.green(`  Published ${data.name}@${data.version}`));
+        console.log(chalk.dim(`  Install: codeloop install ${data.name}`));
+    }
+    catch (error) {
+        console.log(chalk.red(`  Failed to connect to registry: ${error.message}`));
+        console.log();
+        console.log(chalk.dim('  The community registry (skills.codeloop.dev) is not yet available.'));
+        console.log(chalk.dim('  Use --dry-run to validate your skill locally, or share via GitHub:'));
+        console.log(chalk.dim('  codeloop install github:your-user/your-repo'));
+    }
+    console.log();
+});
+//# sourceMappingURL=publish.js.map

package/dist/commands/publish.js.map

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

package/dist/commands/remove.d.ts

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

package/dist/commands/remove.js

@@ -0,0 +1,31 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { uninstallSkill } from '../registry/installer.js';
+import { loadLockfile } from '../registry/lockfile.js';
+export const removeCommand = new Command('remove')
+    .description('Uninstall a skill')
+    .argument('<name>', 'Skill name to remove')
+    .action((name) => {
+    const projectDir = process.cwd();
+    console.log();
+    // Check if installed
+    const lockfile = loadLockfile(projectDir);
+    if (!lockfile.installed[name]) {
+        console.log(chalk.yellow(`  "${name}" is not in the lockfile.`));
+        console.log(chalk.dim('  Note: built-in skills managed by codeloop init/update are not tracked in the lockfile.'));
+        console.log();
+        return;
+    }
+    const result = uninstallSkill(projectDir, name);
+    if (!result.success) {
+        console.log(chalk.red(`  Failed to remove "${name}"`));
+        console.log();
+        return;
+    }
+    console.log(chalk.green(`  Removed ${name}`));
+    for (const file of result.removed) {
+        console.log(chalk.dim(`    ✗ ${file}`));
+    }
+    console.log();
+});
+//# sourceMappingURL=remove.js.map

package/dist/commands/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../src/commands/remove.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;KAC/C,WAAW,CAAC,mBAAmB,CAAC;KAChC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;KAC1C,MAAM,CAAC,CAAC,IAAY,EAAE,EAAE;IACvB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAEjC,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,qBAAqB;IACrB,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAC1C,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,2BAA2B,CAAC,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,0FAA0F,CAAC,CAAC,CAAC;QACnH,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAEhD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,IAAI,GAAG,CAAC,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC,CAAC,CAAC"}

package/dist/commands/render.d.ts

@@ -0,0 +1,5 @@
+import { Command } from 'commander';
+export declare const renderCommand: Command;
+export declare const mcpCommand: Command;
+export declare const gateCommand: Command;
+export declare const configCommand: Command;

package/dist/commands/render.js

@@ -0,0 +1,47 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { loadConfig } from '../lib/config.js';
+import { RefusalError } from '../lib/engine.js';
+import { gateApproval } from '../lib/flow.js';
+import { serveMcp } from '../lib/mcp.js';
+import { HOSTS, render } from '../lib/render.js';
+import { guard } from './guard.js';
+export const renderCommand = new Command('render')
+    .description('Write each lane stage as an agent, rule or skill for Claude, Cursor and Codex, plus an AGENTS.md block')
+    .option('--host <host>', 'claude | cursor | codex | all', 'all')
+    .action(guard((opts) => {
+    if (opts.host !== 'all' && !HOSTS.includes(opts.host))
+        throw new RefusalError(`unknown host "${opts.host}" (claude, cursor, codex or all)`);
+    const result = render(process.cwd(), opts.host === 'all' ? HOSTS : [opts.host]);
+    result.written.forEach(f => console.log(chalk.green(`  + ${f}`)));
+    console.log(`  ${result.written.length} written, ${result.unchanged.length} unchanged`);
+}));
+export const mcpCommand = new Command('mcp')
+    .description('Serve the card engine over MCP on stdio (tools: inbox, next_up, get_card, advance, approve, reject, task_done, wiki_inject, wiki_capture)')
+    .action(async () => {
+    await serveMcp(process.cwd());
+});
+export const gateCommand = new Command('gate').description('Gate checks for CI');
+gateCommand
+    .command('check <id>')
+    .description('Exit 2 unless the card has an approval for the named gate')
+    .requiredOption('--require <gate>', 'Gate name, e.g. local')
+    .action(guard((id, opts) => {
+    const approval = gateApproval(process.cwd(), id, opts.require);
+    console.log(`  gate ${opts.require} approved by ${approval.actor} at ${approval.at}`);
+    if (!approval.authenticated) {
+        console.log(chalk.yellow('  warning: this approval is a local event. Local roles are not authenticated, so it shows that someone ran the approve command, not who.'));
+    }
+}));
+export const configCommand = new Command('config').description('Read .codeloop/config.yaml, with .codeloop/local.yaml laid over it');
+configCommand
+    .command('get <path>')
+    .description('Print one value by dotted path (empty when unset), for use in CI scripts')
+    .action(guard((path) => {
+    let value = loadConfig(process.cwd());
+    for (const key of path.split('.'))
+        value = value?.[key];
+    if (value !== undefined && value !== null)
+        console.log(typeof value === 'string' ? value : JSON.stringify(value));
+}));
+//# sourceMappingURL=render.js.map

package/dist/commands/render.js.map

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

package/dist/commands/run.d.ts

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

package/dist/commands/run.js

@@ -0,0 +1,45 @@
+import { Command } from 'commander';
+import { loadAgents, resolveAgent } from '../lib/agent.js';
+import { RefusalError } from '../lib/cards.js';
+import { clock } from '../lib/clock.js';
+import { planRun, runDue, runDueWithAgent } from '../lib/run.js';
+import { guard } from './guard.js';
+export const runCommand = new Command('run')
+    .description('Start cards for due cron lanes, then advance every card that is not waiting for you one step')
+    .option('--due', 'Run what is due (the default; kept so older scripts still work)')
+    .option('--agent [name]', 'First start a headless agent on each stage whose check does not pass yet (an entry under agents: in config.yaml)')
+    .option('--no-agent', 'Only check and advance, even when config.yaml has run.agent: true')
+    .option('--dry-run', 'Print what would run; start nothing and change nothing')
+    .option('--now <iso>', 'Treat this as the current time')
+    .option('--json', 'JSON output')
+    .action(guard(async (opts) => {
+    const projectDir = process.cwd();
+    const now = opts.now ? new Date(opts.now) : clock();
+    if (Number.isNaN(now.getTime()))
+        throw new RefusalError(`--now "${opts.now}" is not a date`);
+    const wanted = opts.agent ?? loadAgents(projectDir).runByDefault;
+    const agent = wanted ? resolveAgent(projectDir, wanted === true ? undefined : wanted) : null;
+    if (opts.dryRun) {
+        const plan = planRun(projectDir, agent, now);
+        plan.forEach(l => console.log(`  ${l}`));
+        console.log(`  dry run: nothing was started (${plan.length} ${plan.length === 1 ? 'card' : 'cards'} not waiting for you)`);
+        return;
+    }
+    const result = agent ? await runDueWithAgent(projectDir, agent, now) : runDue(projectDir, now);
+    if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    result.created.forEach(c => console.log(`  created ${c.id} in ${c.lane} (trigger: ${c.trigger})`));
+    result.skipped.forEach(s => console.log(`  skipped ${s.lane}: ${s.reason}`));
+    result.agents?.forEach(a => console.log(a.started
+        ? `  ${a.id}: agent ${a.agent} ran ${a.stage} (${a.exit === 0 ? 'exit 0' : a.exit === null ? 'killed' : `exit ${a.exit}`}, ${Math.round(a.durationMs / 1000)}s, ${a.log})`
+        : `  ${a.id}: agent ${a.agent} not started: ${a.reason}`));
+    result.advanced.forEach(a => {
+        console.log(`  ${a.id}: ${a.outcome === 'unchanged' ? 'unchanged, waiting for work' : a.outcome === 'parked' ? 'waiting for you' : a.outcome}${a.note ? ` (${a.note})` : ''}`);
+        if (a.next)
+            console.log(`    ${a.next}`);
+    });
+    console.log(`  ${result.created.length} created, ${result.advanced.length} advanced${result.agents ? `, ${result.agents.filter(a => a.started).length} agent runs` : ''}`);
+}));
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

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

package/dist/commands/scan.d.ts

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

package/dist/commands/scan.js

@@ -0,0 +1,26 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { scanCompetitors } from '../lib/scan.js';
+import { guard } from './guard.js';
+export const scanCommand = new Command('scan').description('Look outside the repo for what to build next');
+scanCommand
+    .command('competitors')
+    .description("Compare each competitor page's changelog with the last scan and propose one plan card per competitor that shipped something new")
+    .option('--from-file <path>', 'Use this file as the changelog text instead of fetching the URL')
+    .option('--only <name>', 'Scan one competitor')
+    .action(guard(async (opts) => {
+    const results = await scanCompetitors(process.cwd(), opts);
+    if (results.length === 0)
+        console.log('  no competitor page has a changelog link; `codeloop wiki competitor add <name> --changelog <url>`');
+    for (const r of results) {
+        const said = r.outcome === 'proposed' ? chalk.green(`proposed ${r.card}; \`codeloop approve ${r.card}\` puts it in the plan lane`)
+            : r.outcome === 'already-proposed' ? `already proposed as ${r.card}`
+                : r.outcome === 'baseline' ? 'first scan; stored as the baseline'
+                    : r.outcome === 'skipped' ? chalk.yellow(`skipped: ${r.reason}`)
+                        : 'nothing new';
+        console.log(`  ${r.name}: ${said}`);
+    }
+    const proposed = results.filter(r => r.outcome === 'proposed').length;
+    console.log(`  ${results.length} scanned, ${proposed} proposed, ${results.filter(r => r.outcome === 'skipped').length} skipped`);
+}));
+//# sourceMappingURL=scan.js.map

package/dist/commands/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../src/commands/scan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,8CAA8C,CAAC,CAAC;AAE3G,WAAW;KACR,OAAO,CAAC,aAAa,CAAC;KACtB,WAAW,CAAC,iIAAiI,CAAC;KAC9I,MAAM,CAAC,oBAAoB,EAAE,iEAAiE,CAAC;KAC/F,MAAM,CAAC,eAAe,EAAE,qBAAqB,CAAC;KAC9C,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,IAA0C,EAAE,EAAE;IACjE,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,oGAAoG,CAAC,CAAC;IAC5I,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,wBAAwB,CAAC,CAAC,IAAI,6BAA6B,CAAC;YAChI,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,kBAAkB,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,IAAI,EAAE;gBACpE,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,oCAAoC;oBACjE,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,CAAC;wBAChE,CAAC,CAAC,aAAa,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;IACtE,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,MAAM,aAAa,QAAQ,cAAc,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,MAAM,UAAU,CAAC,CAAC;AACnI,CAAC,CAAC,CAAC,CAAC"}

package/dist/commands/schedule.d.ts

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

package/dist/commands/schedule.js

@@ -0,0 +1,51 @@
+import { Command } from 'commander';
+import { loadAgents, resolveAgent } from '../lib/agent.js';
+import { RefusalError } from '../lib/cards.js';
+import { everyToCron, installSchedule, removeSchedule, RUN_LOG, scheduleLine, scheduleStatus } from '../lib/schedule.js';
+import { guard } from './guard.js';
+// CODELOOP_CRONTAB names a stand-in for crontab(1), so tests never touch the real table.
+const crontab = () => process.env.CODELOOP_CRONTAB || 'crontab';
+export const scheduleCommand = new Command('schedule').description('Run `codeloop run --agent` in this repo on a schedule, from your crontab');
+scheduleCommand
+    .command('install')
+    .description('Add (or replace) this repo\'s crontab entry')
+    .option('--every <interval>', '5m, 10m, 15m, 20m, 30m, 1h, 2h, 3h, 4h, 6h, 12h or 24h', '30m')
+    .option('--cron <expr>', 'A five-field cron expression, in place of --every')
+    .option('--agent <name>', 'Agent to run (default: agents.default)')
+    .option('--print', 'Print the crontab line and change nothing')
+    .action(guard((opts) => {
+    const projectDir = process.cwd();
+    const configured = Object.keys(loadAgents(projectDir).agents).length > 0;
+    if (opts.agent || configured)
+        resolveAgent(projectDir, opts.agent);
+    const line = scheduleLine(projectDir, { cron: opts.cron ?? everyToCron(opts.every), agent: opts.agent ?? (configured || undefined) });
+    if (opts.print) {
+        console.log(line);
+        return;
+    }
+    installSchedule(projectDir, line, crontab());
+    console.log(`  installed: ${line}`);
+    if (!configured)
+        console.log('  no agent is configured, so the schedule only checks and advances cards; add `agents:` to .codeloop/config.yaml and install again');
+    console.log(`  output goes to ${RUN_LOG}; \`codeloop schedule status\` shows the last run`);
+}));
+scheduleCommand
+    .command('remove')
+    .description('Remove this repo\'s crontab entry')
+    .action(guard(() => {
+    if (!removeSchedule(process.cwd(), crontab()))
+        throw new RefusalError('no schedule is installed for this repo');
+    console.log('  removed');
+}));
+scheduleCommand
+    .command('status')
+    .description('Show the installed entry and the end of the last run\'s output')
+    .action(guard(() => {
+    const status = scheduleStatus(process.cwd(), crontab());
+    console.log(status.line ? `  installed: ${status.line}` : '  not installed (`codeloop schedule install`)');
+    if (status.lastRun)
+        console.log(`  last output ${status.lastRun.toISOString()} in ${RUN_LOG}:\n${status.lastOutput.split('\n').map(l => `    ${l}`).join('\n')}`);
+    else
+        console.log(`  no run has written ${RUN_LOG} yet`);
+}));
+//# sourceMappingURL=schedule.js.map

package/dist/commands/schedule.js.map

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

package/dist/commands/search.d.ts

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

package/dist/commands/search.js

@@ -0,0 +1,85 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { loadLocalIndex, searchLocalIndex } from '../registry/local-index.js';
+const REGISTRY_URL = process.env.CODELOOP_REGISTRY_URL || 'https://skills.codeloop.dev';
+export const searchCommand = new Command('search')
+    .description('Search for skills in the registry')
+    .argument('<query>', 'Search query')
+    .option('--tag <tag>', 'Filter by tag')
+    .option('--stack <stack>', 'Filter by stack')
+    .option('--local', 'Search local index only (offline)')
+    .action(async (query, options) => {
+    console.log();
+    // 1. Search local index
+    const localIndex = loadLocalIndex();
+    let results = searchLocalIndex(localIndex, query);
+    // Apply filters
+    if (options.tag) {
+        results = results.filter(s => s.tags.includes(options.tag));
+    }
+    if (options.stack) {
+        results = results.filter(s => s.stack === options.stack);
+    }
+    // 2. Search registry API (unless --local)
+    let remoteResults = [];
+    if (!options.local) {
+        try {
+            const params = new URLSearchParams({ q: query });
+            if (options.tag)
+                params.set('tag', options.tag);
+            if (options.stack)
+                params.set('stack', options.stack);
+            const res = await fetch(`${REGISTRY_URL}/api/skills?${params}`);
+            if (res.ok) {
+                const data = await res.json();
+                remoteResults = (data.skills || []).map((s) => ({
+                    name: s.name,
+                    version: s.latest_version || '?',
+                    description: s.description,
+                    author: s.author_name || 'unknown',
+                    tags: s.tags || [],
+                    stack: s.stack || 'generic',
+                    tier: s.tier || 'community',
+                    source: 'registry',
+                }));
+            }
+        }
+        catch {
+            // Registry offline — use local results only
+            if (results.length === 0) {
+                // Only show hint if local had no results either
+                console.log(chalk.dim('  (Community registry offline — showing local results only)'));
+            }
+        }
+    }
+    // Merge results (local first, deduplicate by name)
+    const seen = new Set(results.map(r => r.name));
+    for (const remote of remoteResults) {
+        if (!seen.has(remote.name)) {
+            results.push(remote);
+            seen.add(remote.name);
+        }
+    }
+    if (results.length === 0) {
+        console.log(chalk.dim(`  No skills found for "${query}"`));
+        console.log();
+        return;
+    }
+    console.log(chalk.bold(`  Skills matching "${query}"`));
+    console.log();
+    for (const skill of results) {
+        const tierBadge = skill.tier === 'trusted'
+            ? chalk.green('trusted')
+            : skill.tier === 'community'
+                ? chalk.cyan('community')
+                : chalk.yellow('unreviewed');
+        console.log(`  ${chalk.bold(skill.name)} ${chalk.dim(`v${skill.version}`)} ${tierBadge}`);
+        console.log(`  ${chalk.dim(skill.description)}`);
+        if (skill.tags.length > 0) {
+            console.log(`  ${chalk.dim(`tags: ${skill.tags.join(', ')}`)}`);
+        }
+        console.log(`  ${chalk.dim(`codeloop install ${skill.name}`)}`);
+        console.log();
+    }
+});
+//# sourceMappingURL=search.js.map

package/dist/commands/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAmB,MAAM,4BAA4B,CAAC;AAE/F,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,6BAA6B,CAAC;AAExF,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;KAC/C,WAAW,CAAC,mCAAmC,CAAC;KAChD,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;KACnC,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC;KACtC,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;KAC5C,MAAM,CAAC,SAAS,EAAE,mCAAmC,CAAC;KACtD,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,OAA0D,EAAE,EAAE;IAC1F,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,wBAAwB;IACxB,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IACpC,IAAI,OAAO,GAAG,gBAAgB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAElD,gBAAgB;IAChB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC;IAED,0CAA0C;IAC1C,IAAI,aAAa,GAAiB,EAAE,CAAC;IACrC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YACjD,IAAI,OAAO,CAAC,GAAG;gBAAE,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;YAChD,IAAI,OAAO,CAAC,KAAK;gBAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YAEtD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,YAAY,eAAe,MAAM,EAAE,CAAC,CAAC;YAChE,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;gBACX,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC9B,aAAa,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;oBACnD,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,OAAO,EAAE,CAAC,CAAC,cAAc,IAAI,GAAG;oBAChC,WAAW,EAAE,CAAC,CAAC,WAAW;oBAC1B,MAAM,EAAE,CAAC,CAAC,WAAW,IAAI,SAAS;oBAClC,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE;oBAClB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,SAAS;oBAC3B,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,WAAW;oBAC3B,MAAM,EAAE,UAAmB;iBAC5B,CAAC,CAAC,CAAC;YACN,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,4CAA4C;YAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,gDAAgD;gBAChD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,0BAA0B,KAAK,GAAG,CAAC,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB,KAAK,GAAG,CAAC,CAAC,CAAC;IACxD,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,KAAK,SAAS;YACxC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC;YACxB,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW;gBAC1B,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;gBACzB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAEjC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC;QAC1F,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;QAEjD,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,oBAAoB,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAChE,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/commands/serve.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+export declare const serveCommand: Command;
+export declare function getServeStatus(projectDir: string): {
+    running: boolean;
+    pid?: number;
+    port?: number;
+};

package/dist/commands/serve.js

@@ -0,0 +1,126 @@
+import { Command } from 'commander';
+import { randomBytes } from 'crypto';
+import chalk from 'chalk';
+import { existsSync, readFileSync, writeFileSync, unlinkSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { createApp } from '../lib/server.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PACKAGE_ROOT = join(__dirname, '..', '..');
+const UI_DIR = join(PACKAGE_ROOT, 'dist', 'ui');
+const DEFAULT_PORT = 4040;
+const PID_FILE = '.codeloop/.serve.pid';
+export const serveCommand = new Command('serve')
+    .description('Start the visual board server')
+    .option('-p, --port <port>', 'Port to listen on', String(DEFAULT_PORT))
+    .option('--bg', 'Run in background')
+    .option('--stop', 'Stop background server')
+    .option('--open', 'Open browser after starting')
+    .option('--owner', 'Allow Approve and Reject from the board, for whoever has the URL with its token')
+    .option('--host <host>', 'Address to listen on. Anything but the default exposes the board to the network', '127.0.0.1')
+    .action(async (options) => {
+    const projectDir = process.cwd();
+    const port = parseInt(options.port, 10);
+    // --stop: kill background server
+    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 server (PID ${pid})`));
+        }
+        catch {
+            console.log(chalk.yellow(`  Process ${pid} not found (already stopped?)`));
+        }
+        unlinkSync(pidPath);
+        return;
+    }
+    const token = process.env.CODELOOP_SERVE_TOKEN ?? randomBytes(24).toString('hex');
+    const loopback = ['127.0.0.1', 'localhost', '::1'].includes(options.host);
+    const url = `http://${loopback ? '127.0.0.1' : options.host}:${port}/?token=${token}`;
+    const stateDir = join(projectDir, '.codeloop');
+    if (!existsSync(stateDir)) {
+        console.log(chalk.red('  No .codeloop folder found. Run `codeloop init` first.'));
+        process.exit(1);
+    }
+    // --bg: fork as background process
+    if (options.bg) {
+        const { fork } = await import('child_process');
+        const child = fork(process.argv[1], ['serve', '--port', String(port), '--host', options.host, ...(options.owner ? ['--owner'] : [])], {
+            detached: true,
+            stdio: 'ignore',
+            // The child cannot print its token to this terminal, so the parent chooses it.
+            env: { ...process.env, CODELOOP_SERVE_TOKEN: token },
+        });
+        child.unref();
+        if (child.pid) {
+            const pidPath = join(projectDir, PID_FILE);
+            writeFileSync(pidPath, String(child.pid), 'utf-8');
+            console.log(chalk.green(`  Board server started in background (PID ${child.pid})`));
+            console.log(`  ${chalk.cyan(url)}`);
+        }
+        return;
+    }
+    // Foreground mode
+    const uiDir = existsSync(UI_DIR) ? UI_DIR : undefined;
+    const { app, broadcast, broadcastCards } = createApp(projectDir, uiDir, { owner: options.owner, token, anyHost: !loopback });
+    const { serve } = await import('@hono/node-server');
+    serve({ fetch: app.fetch, port, hostname: options.host }, () => {
+        console.log();
+        console.log(chalk.bold(`  Codeloop board: ${chalk.cyan(url)}`));
+        console.log(chalk.dim('  The token in that URL is needed for every change. Anyone who has the URL can make them.'));
+        if (!loopback)
+            console.log(chalk.yellow(`  Listening on ${options.host}: the board is reachable from the network.`));
+        console.log(chalk.dim(options.owner ? '  Approve and Reject are enabled (--owner)' : '  Read-only for cards; add --owner to approve from the board'));
+        console.log(chalk.dim('  Press Ctrl+C to stop'));
+        console.log();
+        // --open: open browser
+        if (options.open) {
+            import('child_process').then(({ exec }) => {
+                const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+                exec(`${cmd} '${url}'`);
+            });
+        }
+    });
+    // Watch the folder, not the files: cards.json is replaced by rename on every write, and
+    // board.json may not exist yet. Lane edits change what the Cards view draws too.
+    const { watch } = await import('fs');
+    const timers = {};
+    const later = (key, run) => {
+        clearTimeout(timers[key]);
+        timers[key] = setTimeout(run, 100);
+    };
+    watch(stateDir, (_event, name) => {
+        if (name === 'board.json')
+            later('board', broadcast);
+        if (name === 'cards.json')
+            later('cards', broadcastCards);
+    });
+    const lanesDir = join(stateDir, 'lanes');
+    if (existsSync(lanesDir))
+        watch(lanesDir, () => later('cards', broadcastCards));
+});
+export function getServeStatus(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); // Test if process exists
+        return { running: true, pid };
+    }
+    catch {
+        // Stale PID file — clean up
+        try {
+            unlinkSync(pidPath);
+        }
+        catch { }
+        return { running: false };
+    }
+}
+//# sourceMappingURL=serve.js.map