@context-forge/cli 0.8.5 → 0.8.6

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { registerBuildCommand } from './commands/build.js';
+import { registerCheckCommand } from './commands/check.js';
+import { registerFutureCommand } from './commands/future.js';
+import { registerNextCommand } from './commands/next.js';
+import { registerProjectCommand, projectSetAction, projectGetAction, projectUnsetAction, buildSettableFieldsHelp } from './commands/project.js';
+import { registerPromptCommand } from './commands/prompt.js';
+import { registerStatusCommand } from './commands/status.js';
+import { registerListCommand } from './commands/list.js';
+import { registerWorktreeCommand } from './commands/worktree.js';
+import { registerBackupCommand } from './commands/backup.js';
+import { registerConfigCommand } from './commands/config.js';
+import { registerGuidesCommand } from './commands/guides.js';
+import { registerInitCommand } from './commands/init.js';
+import { registerInstallCommandsCommand, registerUninstallCommandsCommand } from './commands/commandInstaller.js';
+import { registerSetupIdeCommand } from './commands/setup-ide.js';
+import { registerUpdateCommand } from './commands/update.js';
+import { handleError, setJsonMode } from './utils/errors.js';
+import { buildCommandCatalog } from './utils/commandCatalog.js';
+import { BREAKING_CHANGES } from './utils/breaking-changes.js';
+import { withJsonOption, withProjectOption, withProjectLevelOption } from './options.js';
+const require = createRequire(import.meta.url);
+const { version } = require('../package.json');
+const program = new Command();
+program
+    .name('cf')
+    .version(version, '-v, --version', 'Output the version number')
+    .description('Context Forge CLI — terminal access to context assembly, project management, and workflow navigation')
+    .configureHelp({
+    styleTitle: (str) => chalk.bold(str),
+    styleCommandText: (str) => chalk.yellow(str),
+    styleSubcommandText: (str) => chalk.yellow(str),
+    styleOptionText: (str) => chalk.cyan(str),
+    styleArgumentText: (str) => chalk.magenta(str),
+    styleDescriptionText: (str) => str,
+    subcommandTerm: (cmd) => cmd.name(),
+})
+    .addHelpText('after', `\n${chalk.bold('Common options')} (available on most commands):\n  ${chalk.cyan('--project <name|id>')}  Project name or ID (overrides CWD-based project detection)\n  ${chalk.cyan('--json')}               Output as JSON (not applicable to build/prompt get)`);
+// Workflow commands
+registerBuildCommand(program);
+registerCheckCommand(program);
+registerFutureCommand(program);
+registerNextCommand(program);
+registerProjectCommand(program);
+registerPromptCommand(program);
+registerStatusCommand(program);
+// Top-level shortcuts for project get/set/unset
+const getCmd = program
+    .command('get')
+    .description('Show details for the active project (shortcut for cf project get)');
+withJsonOption(getCmd);
+withProjectOption(getCmd);
+withProjectLevelOption(getCmd);
+getCmd.action(async (opts) => {
+    try {
+        await projectGetAction(opts);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const setCmd = program
+    .command('set [field] [value]')
+    .description('Set a field on the active project (shortcut for cf project set)');
+withProjectOption(setCmd);
+withProjectLevelOption(setCmd);
+setCmd.addHelpText('after', buildSettableFieldsHelp)
+    .action(async (field, val, opts) => {
+    // Allow `cf set date` (no value) as shorthand for `cf set date now`
+    const resolvedVal = (!val && field && /^date/i.test(field)) ? 'now' : val;
+    if (!field || !resolvedVal) {
+        console.log(`Usage: cf set [options] <field> <value>  —  run cf set --help for details`);
+        return;
+    }
+    try {
+        await projectSetAction(field, resolvedVal, opts);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+const unsetCmd = program
+    .command('unset [field]')
+    .description('Unset (clear) a field on the active project (shortcut for cf project unset)');
+withProjectOption(unsetCmd);
+withProjectLevelOption(unsetCmd);
+unsetCmd.action(async (field, opts) => {
+    if (!field) {
+        console.log(`Usage: cf unset [options] <field>  —  run cf unset --help for details`);
+        return;
+    }
+    try {
+        await projectUnsetAction(field, opts);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+// Compound workflow commands
+// Artifact listing
+registerListCommand(program);
+// Worktree management
+registerWorktreeCommand(program);
+// Setup and administration
+registerBackupCommand(program);
+registerConfigCommand(program);
+registerGuidesCommand(program);
+registerInitCommand(program);
+registerInstallCommandsCommand(program);
+registerUninstallCommandsCommand(program);
+registerSetupIdeCommand(program);
+registerUpdateCommand(program);
+// Version introspection
+const versionCmd = program
+    .command('version')
+    .description('Show version information (use --json for machine-readable output)');
+withJsonOption(versionCmd);
+versionCmd.action(async (opts) => {
+    if (opts.json) {
+        let guideVersion = null;
+        try {
+            const { GuideDetector } = await import('@context-forge/core/node');
+            const detector = new GuideDetector();
+            const info = await detector.detect(process.cwd());
+            guideVersion = info.version;
+        }
+        catch {
+            // Guide detection is best-effort
+        }
+        const output = {
+            name: '@context-forge/cli',
+            version,
+            guideVersion,
+            breaking: BREAKING_CHANGES,
+        };
+        process.stdout.write(JSON.stringify(output, null, 2) + '\n');
+    }
+    else {
+        process.stdout.write(`@context-forge/cli v${version}\n`);
+    }
+});
+// Machine-readable help
+const helpCmd = program
+    .command('help')
+    .description('Display help information (use --json for machine-readable catalog)');
+withJsonOption(helpCmd);
+helpCmd.action((opts) => {
+    if (opts.json) {
+        const catalog = buildCommandCatalog(program, version);
+        process.stdout.write(JSON.stringify(catalog, null, 2) + '\n');
+    }
+    else {
+        program.outputHelp();
+    }
+});
+// Catch unhandled errors at top level
+process.on('uncaughtException', handleError);
+process.on('unhandledRejection', handleError);
+// Detect --json in argv to enable structured error output before parsing
+if (process.argv.includes('--json') || process.env.CF_JSON === '1') {
+    setJsonMode();
+}
+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/options.d.ts

@@ -0,0 +1,16 @@
+import type { Command } from 'commander';
+/** -j, --json — Output as JSON */
+export declare function withJsonOption(cmd: Command): Command;
+/** -p, --project <id> — Project ID or name (overrides default) */
+export declare function withProjectOption(cmd: Command): Command;
+/** -y, --yes — Skip confirmation prompt */
+export declare function withYesOption(cmd: Command): Command;
+/** -f, --fix — Apply non-destructive corrections (when available) */
+export declare function withFixOption(cmd: Command): Command;
+/** -a, --all — Show items from all worktrees */
+export declare function withAllOption(cmd: Command): Command;
+/** -r, --raw — Output raw content without formatting */
+export declare function withRawOption(cmd: Command): Command;
+/** --project-level — Force operation at project level (skip worktree routing) */
+export declare function withProjectLevelOption(cmd: Command): Command;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,kCAAkC;AAClC,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEpD;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEvD;AAED,2CAA2C;AAC3C,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE5D"}

package/dist/options.js

@@ -0,0 +1,29 @@
+/** -j, --json — Output as JSON */
+export function withJsonOption(cmd) {
+    return cmd.option('-j, --json', 'Output as JSON');
+}
+/** -p, --project <id> — Project ID or name (overrides default) */
+export function withProjectOption(cmd) {
+    return cmd.option('-p, --project <id>', 'Project ID or name (overrides default)');
+}
+/** -y, --yes — Skip confirmation prompt */
+export function withYesOption(cmd) {
+    return cmd.option('-y, --yes', 'Skip confirmation prompt');
+}
+/** -f, --fix — Apply non-destructive corrections (when available) */
+export function withFixOption(cmd) {
+    return cmd.option('-f, --fix', 'Apply non-destructive corrections (when available)');
+}
+/** -a, --all — Show items from all worktrees */
+export function withAllOption(cmd) {
+    return cmd.option('-a, --all', 'Show items from all worktrees');
+}
+/** -r, --raw — Output raw content without formatting */
+export function withRawOption(cmd) {
+    return cmd.option('-r, --raw', 'Output raw content without formatting');
+}
+/** --project-level — Force operation at project level (skip worktree routing) */
+export function withProjectLevelOption(cmd) {
+    return cmd.option('--project-level', 'Force operation at project level (skip worktree routing)');
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAEA,kCAAkC;AAClC,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,OAAO,GAAG,CAAC,MAAM,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;AACpD,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,iBAAiB,CAAC,GAAY;IAC5C,OAAO,GAAG,CAAC,MAAM,CAAC,oBAAoB,EAAE,wCAAwC,CAAC,CAAC;AACpF,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,0BAA0B,CAAC,CAAC;AAC7D,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,oDAAoD,CAAC,CAAC;AACvF,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,+BAA+B,CAAC,CAAC;AAClE,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,aAAa,CAAC,GAAY;IACxC,OAAO,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,uCAAuC,CAAC,CAAC;AAC1E,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,sBAAsB,CAAC,GAAY;IACjD,OAAO,GAAG,CAAC,MAAM,CAAC,iBAAiB,EAAE,0DAA0D,CAAC,CAAC;AACnG,CAAC"}

package/dist/output/formatter.d.ts

@@ -0,0 +1,6 @@
+export type OutputMode = 'terminal' | 'json';
+/** Print structured data as formatted JSON to stdout. */
+export declare function printJson(data: unknown): void;
+/** Print raw text to stdout (no formatting, no trailing newline unless in text). */
+export declare function printRaw(text: string): void;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/output/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/output/formatter.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,MAAM,CAAC;AAE7C,yDAAyD;AACzD,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAE7C;AAED,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE3C"}

package/dist/output/formatter.js

@@ -0,0 +1,9 @@
+/** Print structured data as formatted JSON to stdout. */
+export function printJson(data) {
+    process.stdout.write(JSON.stringify(data, null, 2) + '\n');
+}
+/** Print raw text to stdout (no formatting, no trailing newline unless in text). */
+export function printRaw(text) {
+    process.stdout.write(text);
+}
+//# sourceMappingURL=formatter.js.map

package/dist/output/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/output/formatter.ts"],"names":[],"mappings":"AAEA,yDAAyD;AACzD,MAAM,UAAU,SAAS,CAAC,IAAa;IACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/output/styles.d.ts

@@ -0,0 +1,15 @@
+/** Style for field labels (e.g. "Project:", "Phase:") */
+export declare const label: import("chalk").ChalkInstance;
+/** Style for field values */
+export declare const value: import("chalk").ChalkInstance;
+/** Style for section headings */
+export declare const heading: import("chalk").ChalkInstance;
+/** Style for secondary/subdued text */
+export declare const dim: import("chalk").ChalkInstance;
+/** Style for error messages */
+export declare const error: import("chalk").ChalkInstance;
+/** Style for success messages */
+export declare const success: import("chalk").ChalkInstance;
+/** Style for warning messages */
+export declare const warn: import("chalk").ChalkInstance;
+//# sourceMappingURL=styles.d.ts.map

package/dist/output/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/output/styles.ts"],"names":[],"mappings":"AAEA,yDAAyD;AACzD,eAAO,MAAM,KAAK,+BAAa,CAAC;AAEhC,6BAA6B;AAC7B,eAAO,MAAM,KAAK,+BAAa,CAAC;AAEhC,iCAAiC;AACjC,eAAO,MAAM,OAAO,+BAAuB,CAAC;AAE5C,uCAAuC;AACvC,eAAO,MAAM,GAAG,+BAAY,CAAC;AAE7B,+BAA+B;AAC/B,eAAO,MAAM,KAAK,+BAAY,CAAC;AAE/B,iCAAiC;AACjC,eAAO,MAAM,OAAO,+BAAc,CAAC;AAEnC,iCAAiC;AACjC,eAAO,MAAM,IAAI,+BAAe,CAAC"}

package/dist/output/styles.js

@@ -0,0 +1,16 @@
+import chalk from 'chalk';
+/** Style for field labels (e.g. "Project:", "Phase:") */
+export const label = chalk.bold;
+/** Style for field values */
+export const value = chalk.cyan;
+/** Style for section headings */
+export const heading = chalk.bold.underline;
+/** Style for secondary/subdued text */
+export const dim = chalk.dim;
+/** Style for error messages */
+export const error = chalk.red;
+/** Style for success messages */
+export const success = chalk.green;
+/** Style for warning messages */
+export const warn = chalk.yellow;
+//# sourceMappingURL=styles.js.map

package/dist/output/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../src/output/styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,yDAAyD;AACzD,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC;AAEhC,6BAA6B;AAC7B,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC;AAEhC,iCAAiC;AACjC,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;AAE5C,uCAAuC;AACvC,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;AAE7B,+BAA+B;AAC/B,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC;AAE/B,iCAAiC;AACjC,MAAM,CAAC,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC;AAEnC,iCAAiC;AACjC,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC"}

package/dist/output/tables.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Render a borderless table with bold/cyan headers and an underline separator.
+ * Matches orchestration CLI style: no cell borders, column-aligned with padding.
+ */
+export declare function renderTable(headers: string[], rows: string[][], rowPrefixes?: string[]): string;
+//# sourceMappingURL=tables.d.ts.map

package/dist/output/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../src/output/tables.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,MAAM,EAAE,EAAE,EAChB,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,MAAM,CAsCR"}

package/dist/output/tables.js

@@ -0,0 +1,45 @@
+import chalk from 'chalk';
+/**
+ * Render a borderless table with bold/cyan headers and an underline separator.
+ * Matches orchestration CLI style: no cell borders, column-aligned with padding.
+ */
+export function renderTable(headers, rows, rowPrefixes) {
+    // Calculate column widths from headers and data
+    const colWidths = headers.map((h, i) => {
+        const dataMax = rows.reduce((max, row) => Math.max(max, stripAnsi(row[i] ?? '').length), 0);
+        return Math.max(stripAnsi(h).length, dataMax);
+    });
+    const pad = 2; // spacing between columns
+    const indent = '  ';
+    const lines = [];
+    // Header row — bold cyan
+    const headerLine = headers
+        .map((h, i) => chalk.bold.cyan(h.padEnd(colWidths[i])))
+        .join(' '.repeat(pad));
+    lines.push(indent + headerLine);
+    // Underline — thin dash under each column
+    const underline = colWidths
+        .map((w) => '─'.repeat(w))
+        .join(' '.repeat(pad));
+    lines.push(indent + chalk.dim(underline));
+    // Data rows
+    for (let r = 0; r < rows.length; r++) {
+        const row = rows[r];
+        const prefix = rowPrefixes ? rowPrefixes[r] : indent;
+        const rowLine = row
+            .map((cell, i) => {
+            const visible = stripAnsi(cell ?? '');
+            const padding = colWidths[i] - visible.length;
+            return (cell ?? '') + ' '.repeat(Math.max(0, padding));
+        })
+            .join(' '.repeat(pad));
+        lines.push(prefix + rowLine);
+    }
+    return lines.join('\n');
+}
+/** Strip ANSI escape codes to get visible character length. */
+function stripAnsi(str) {
+    // eslint-disable-next-line no-control-regex
+    return str.replace(/\x1B\[[0-9;]*m/g, '');
+}
+//# sourceMappingURL=tables.js.map

package/dist/output/tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.js","sourceRoot":"","sources":["../../src/output/tables.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,OAAiB,EACjB,IAAgB,EAChB,WAAsB;IAEtB,gDAAgD;IAChD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5F,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,0BAA0B;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,yBAAyB;IACzB,MAAM,UAAU,GAAG,OAAO;SACvB,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACtD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC;IAEhC,0CAA0C;IAC1C,MAAM,SAAS,GAAG,SAAS;SACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;SACzB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IAE1C,YAAY;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACrD,MAAM,OAAO,GAAG,GAAG;aAChB,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACf,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACtC,MAAM,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;YAC9C,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC;aACD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,+DAA+D;AAC/D,SAAS,SAAS,CAAC,GAAW;IAC5B,4CAA4C;IAC5C,OAAO,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC"}

package/dist/utils/breaking-changes.d.ts

@@ -0,0 +1,14 @@
+/** A breaking CLI change that agents should be aware of. */
+export interface BreakingChange {
+    /** Version that introduced the breaking change. */
+    since: string;
+    /** Human-readable description of what changed. */
+    change: string;
+}
+/**
+ * Breaking changes since the last minor version bump.
+ * Manually maintained — add entries when making breaking CLI changes.
+ * Clear this array when bumping the minor version.
+ */
+export declare const BREAKING_CHANGES: BreakingChange[];
+//# sourceMappingURL=breaking-changes.d.ts.map

package/dist/utils/breaking-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breaking-changes.d.ts","sourceRoot":"","sources":["../../src/utils/breaking-changes.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAI5C,CAAC"}

package/dist/utils/breaking-changes.js

@@ -0,0 +1,11 @@
+/**
+ * Breaking changes since the last minor version bump.
+ * Manually maintained — add entries when making breaking CLI changes.
+ * Clear this array when bumping the minor version.
+ */
+export const BREAKING_CHANGES = [
+    { since: '0.6.20', change: 'cf slice list → cf list slices (and other artifact list commands)' },
+    { since: '0.6.23', change: 'Bare cf build no longer outputs raw prompt — use cf build --json or /cf:build slash command' },
+    { since: '0.6.26', change: 'Compound commands (cf concept, cf arch, cf slice, cf tasks, cf implement, cf plan, cf initiatives) removed — use cf set + cf build, or Squadron (sq) equivalents' },
+];
+//# sourceMappingURL=breaking-changes.js.map

package/dist/utils/breaking-changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breaking-changes.js","sourceRoot":"","sources":["../../src/utils/breaking-changes.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAqB;IAChD,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,mEAAmE,EAAE;IAChG,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,6FAA6F,EAAE;IAC1H,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,kKAAkK,EAAE;CAChM,CAAC"}

package/dist/utils/commandCatalog.d.ts

@@ -0,0 +1,25 @@
+import type { Command } from 'commander';
+interface CatalogArg {
+    name: string;
+    required: boolean;
+    description: string;
+}
+interface CatalogOption {
+    flag: string;
+    description: string;
+}
+interface CatalogCommand {
+    name: string;
+    description: string;
+    args: CatalogArg[];
+    options: CatalogOption[];
+    subcommands: CatalogCommand[];
+}
+export interface CommandCatalog {
+    version: string;
+    commands: CatalogCommand[];
+}
+/** Walk the Commander tree and produce a machine-readable command catalog. */
+export declare function buildCommandCatalog(program: Command, version: string): CommandCatalog;
+export {};
+//# sourceMappingURL=commandCatalog.d.ts.map

package/dist/utils/commandCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandCatalog.d.ts","sourceRoot":"","sources":["../../src/utils/commandCatalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAgCD,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,CAMrF"}

package/dist/utils/commandCatalog.js

@@ -0,0 +1,32 @@
+function buildCommandEntry(cmd) {
+    // Filter out default help option and version option
+    const options = cmd.options
+        .filter((o) => !o.flags.includes('--help') && !o.flags.includes('--version'))
+        .map((o) => ({
+        flag: o.flags,
+        description: o.description,
+    }));
+    const args = (cmd.registeredArguments ?? []).map((a) => ({
+        name: a.name(),
+        required: a.required,
+        description: a.description,
+    }));
+    const subcommands = cmd.commands
+        .filter((sub) => sub.name() !== 'help')
+        .map((sub) => buildCommandEntry(sub));
+    return {
+        name: cmd.name(),
+        description: cmd.description(),
+        args,
+        options,
+        subcommands,
+    };
+}
+/** Walk the Commander tree and produce a machine-readable command catalog. */
+export function buildCommandCatalog(program, version) {
+    const commands = program.commands
+        .filter((cmd) => cmd.name() !== 'help')
+        .map((cmd) => buildCommandEntry(cmd));
+    return { version, commands };
+}
+//# sourceMappingURL=commandCatalog.js.map

package/dist/utils/commandCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandCatalog.js","sourceRoot":"","sources":["../../src/utils/commandCatalog.ts"],"names":[],"mappings":"AA0BA,SAAS,iBAAiB,CAAC,GAAY;IACrC,oDAAoD;IACpD,MAAM,OAAO,GAAoB,GAAG,CAAC,OAAO;SACzC,MAAM,CAAC,CAAC,CAAoB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;SAC/F,GAAG,CAAC,CAAC,CAAyC,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI,EAAE,CAAC,CAAC,KAAK;QACb,WAAW,EAAE,CAAC,CAAC,WAAW;KAC3B,CAAC,CAAC,CAAC;IAEN,MAAM,IAAI,GAAiB,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,GAAG,CAC5D,CAAC,CAAiE,EAAE,EAAE,CAAC,CAAC;QACtE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,WAAW,EAAE,CAAC,CAAC,WAAW;KAC3B,CAAC,CACH,CAAC;IAEF,MAAM,WAAW,GAAqB,GAAG,CAAC,QAAQ;SAC/C,MAAM,CAAC,CAAC,GAAY,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC;SAC/C,GAAG,CAAC,CAAC,GAAY,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;IAEjD,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE;QAChB,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE;QAC9B,IAAI;QACJ,OAAO;QACP,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,mBAAmB,CAAC,OAAgB,EAAE,OAAe;IACnE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ;SAC9B,MAAM,CAAC,CAAC,GAAY,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,MAAM,CAAC;SAC/C,GAAG,CAAC,CAAC,GAAY,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC;IAEjD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC"}

package/dist/utils/confirm.d.ts

@@ -0,0 +1,3 @@
+/** Prompt user for y/N confirmation via stdin. Returns true if confirmed. */
+export declare function askConfirmation(prompt: string): Promise<boolean>;
+//# sourceMappingURL=confirm.d.ts.map

package/dist/utils/confirm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm.d.ts","sourceRoot":"","sources":["../../src/utils/confirm.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQhE"}

package/dist/utils/confirm.js

@@ -0,0 +1,12 @@
+import * as readline from 'node:readline';
+/** Prompt user for y/N confirmation via stdin. Returns true if confirmed. */
+export function askConfirmation(prompt) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() === 'y');
+        });
+    });
+}
+//# sourceMappingURL=confirm.js.map

package/dist/utils/confirm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../../src/utils/confirm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAE1C,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;YAC7B,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,22 @@
+/** Standard error codes for machine-readable error responses. */
+export type ErrorCode = 'PROJECT_NOT_FOUND' | 'FIELD_NOT_FOUND' | 'INVALID_ARGUMENT' | 'INVALID_VALUE' | 'MISSING_CONFIG' | 'ARTIFACT_NOT_FOUND' | 'READ_ONLY' | 'ALREADY_EXISTS';
+/**
+ * User-facing error — printed without stack trace.
+ * Use for expected failure conditions (missing config, invalid arguments, etc).
+ */
+export declare class UserError extends Error {
+    code?: ErrorCode;
+    suggestion?: string;
+    constructor(message: string, code?: ErrorCode, suggestion?: string);
+}
+/** Enable JSON-structured error output. Called when --json is parsed. */
+export declare function setJsonMode(): void;
+/** Check if JSON mode is active (flag or CF_JSON env var). */
+export declare function isJsonMode(): boolean;
+/**
+ * Top-level error handler. Prints the message and exits with code 1.
+ * In JSON mode, outputs structured JSON to stderr.
+ * Otherwise, UserErrors get a clean message; unexpected errors get a brief summary.
+ */
+export declare function handleError(err: unknown): never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,MAAM,SAAS,GACjB,mBAAmB,GACnB,iBAAiB,GACjB,kBAAkB,GAClB,eAAe,GACf,gBAAgB,GAChB,oBAAoB,GACpB,WAAW,GACX,gBAAgB,CAAC;AAErB;;;GAGG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAER,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM;CAMnE;AAKD,yEAAyE;AACzE,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CA0B/C"}

package/dist/utils/errors.js

@@ -0,0 +1,63 @@
+/**
+ * User-facing error — printed without stack trace.
+ * Use for expected failure conditions (missing config, invalid arguments, etc).
+ */
+export class UserError extends Error {
+    code;
+    suggestion;
+    constructor(message, code, suggestion) {
+        super(message);
+        this.name = 'UserError';
+        this.code = code;
+        this.suggestion = suggestion;
+    }
+}
+/** Module-level JSON mode flag — set during option parsing. */
+let jsonMode = false;
+/** Enable JSON-structured error output. Called when --json is parsed. */
+export function setJsonMode() {
+    jsonMode = true;
+}
+/** Check if JSON mode is active (flag or CF_JSON env var). */
+export function isJsonMode() {
+    return jsonMode || process.env.CF_JSON === '1';
+}
+/**
+ * Top-level error handler. Prints the message and exits with code 1.
+ * In JSON mode, outputs structured JSON to stderr.
+ * Otherwise, UserErrors get a clean message; unexpected errors get a brief summary.
+ */
+export function handleError(err) {
+    if (isJsonMode()) {
+        const jsonError = { error: true };
+        if (err instanceof UserError) {
+            jsonError.code = err.code ?? 'UNKNOWN';
+            jsonError.message = err.message;
+            if (err.suggestion)
+                jsonError.suggestion = err.suggestion;
+        }
+        else if (err instanceof Error) {
+            jsonError.code = 'UNKNOWN';
+            jsonError.message = err.message;
+        }
+        else {
+            jsonError.code = 'UNKNOWN';
+            jsonError.message = String(err);
+        }
+        process.stderr.write(JSON.stringify(jsonError) + '\n');
+    }
+    else {
+        if (err instanceof UserError) {
+            const msg = err.suggestion ? `${err.message}\n  ${err.suggestion}` : err.message;
+            console.error(msg);
+        }
+        else if (err instanceof Error) {
+            console.error(`Error: ${err.message}`);
+        }
+        else {
+            console.error(`Error: ${String(err)}`);
+        }
+    }
+    process.exit(1);
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,IAAI,CAAa;IACjB,UAAU,CAAU;IAEpB,YAAY,OAAe,EAAE,IAAgB,EAAE,UAAmB;QAChE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,+DAA+D;AAC/D,IAAI,QAAQ,GAAG,KAAK,CAAC;AAErB,yEAAyE;AACzE,MAAM,UAAU,WAAW;IACzB,QAAQ,GAAG,IAAI,CAAC;AAClB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,UAAU;IACxB,OAAO,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,IAAI,UAAU,EAAE,EAAE,CAAC;QACjB,MAAM,SAAS,GAA4B,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC3D,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;YAC7B,SAAS,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,SAAS,CAAC;YACvC,SAAS,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;YAChC,IAAI,GAAG,CAAC,UAAU;gBAAE,SAAS,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;QAC5D,CAAC;aAAM,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YAChC,SAAS,CAAC,IAAI,GAAG,SAAS,CAAC;YAC3B,SAAS,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAClC,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,GAAG,SAAS,CAAC;YAC3B,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;IACzD,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,OAAO,OAAO,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;YACjF,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;aAAM,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;YAChC,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,UAAU,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/utils/phaseShorthand.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Parse phase shorthands from the system prompt file.
+ *
+ * Extracts headings matching `(Phase n)` or `(Phase n.m)` and builds
+ * a map: { P1: 'Concept', P2: 'Architecture', ... }
+ *
+ * The prompt file is resolved from the project path.
+ */
+export declare function getPhaseShorthands(projectPath: string): Promise<Map<string, string>>;
+/** Clear the cached shorthands (for testing). */
+export declare function clearPhaseShorthandCache(): void;
+/**
+ * Resolve a phase input (name, shorthand, or key) to a prompt key suitable
+ * for SystemPromptParser.getPromptForInstruction().
+ *
+ * Resolution order:
+ * 1. Phase shorthand (P1–P7) → resolved name
+ * 2. Otherwise: return as-is (case-insensitive matching handled by parser)
+ *
+ * Hyphens and spaces are interchangeable.
+ */
+export declare function resolvePhaseInput(input: string, projectPath: string): Promise<string>;
+//# sourceMappingURL=phaseShorthand.d.ts.map

package/dist/utils/phaseShorthand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phaseShorthand.d.ts","sourceRoot":"","sources":["../../src/utils/phaseShorthand.ts"],"names":[],"mappings":"AAUA;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAyB1F;AAED,iDAAiD;AACjD,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAajB"}