@context-forge/cli 0.8.5 → 0.9.0

package/dist/output/entryStatusDisplay.d.ts

@@ -0,0 +1,12 @@
+import type { NormalizedStatus } from '@context-forge/core';
+/** A derived status, or the TD-2a degraded case for a signal that failed to resolve. */
+export type DisplayStatus = NormalizedStatus | 'degraded';
+/**
+ * Render a plan/arch entry's derived status for table display.
+ * Distinguishes a signed-off complete entry (checkbox ticked) from a
+ * derived-complete-but-unchecked one (tasks done, awaiting sign-off) — this
+ * is presentation only; callers must branch on the underlying NormalizedStatus,
+ * never on this rendered label (CLAUDE.md: labels are not logical structure).
+ */
+export declare function renderEntryStatus(status: DisplayStatus, isChecked: boolean): string;
+//# sourceMappingURL=entryStatusDisplay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entryStatusDisplay.d.ts","sourceRoot":"","sources":["../../src/output/entryStatusDisplay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAI5D,wFAAwF;AACxF,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,UAAU,CAAC;AAE1D;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAYnF"}

package/dist/output/entryStatusDisplay.js

@@ -0,0 +1,24 @@
+import { STATUS } from '@context-forge/core';
+import { success, dim, warn } from './styles.js';
+/**
+ * Render a plan/arch entry's derived status for table display.
+ * Distinguishes a signed-off complete entry (checkbox ticked) from a
+ * derived-complete-but-unchecked one (tasks done, awaiting sign-off) — this
+ * is presentation only; callers must branch on the underlying NormalizedStatus,
+ * never on this rendered label (CLAUDE.md: labels are not logical structure).
+ */
+export function renderEntryStatus(status, isChecked) {
+    if (status === 'degraded')
+        return warn('⚠ unreadable');
+    switch (status) {
+        case STATUS.Deprecated:
+            return dim('⊘ deprecated');
+        case STATUS.Complete:
+            return isChecked ? success('✓ complete') : success('● tasks done');
+        case STATUS.InProgress:
+            return warn('◐ in progress');
+        case STATUS.NotStarted:
+            return dim('○ not started');
+    }
+}
+//# sourceMappingURL=entryStatusDisplay.js.map

package/dist/output/entryStatusDisplay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entryStatusDisplay.js","sourceRoot":"","sources":["../../src/output/entryStatusDisplay.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAKjD;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAqB,EAAE,SAAkB;IACzE,IAAI,MAAM,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC,cAAc,CAAC,CAAC;IACvD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,UAAU;YACpB,OAAO,GAAG,CAAC,cAAc,CAAC,CAAC;QAC7B,KAAK,MAAM,CAAC,QAAQ;YAClB,OAAO,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACrE,KAAK,MAAM,CAAC,UAAU;YACpB,OAAO,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/B,KAAK,MAAM,CAAC,UAAU;YACpB,OAAO,GAAG,CAAC,eAAe,CAAC,CAAC;IAChC,CAAC;AACH,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/archIndex.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Parse and validate an `[archIndex]` positional argument shared by
+ * `cf list slices` / `cf list tasks`. Throws UserError on non-numeric or
+ * negative input; returns the parsed integer otherwise.
+ */
+export declare function parseArchIndex(raw: string): number;
+//# sourceMappingURL=archIndex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"archIndex.d.ts","sourceRoot":"","sources":["../../src/utils/archIndex.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMlD"}

package/dist/utils/archIndex.js

@@ -0,0 +1,14 @@
+import { UserError } from './errors.js';
+/**
+ * Parse and validate an `[archIndex]` positional argument shared by
+ * `cf list slices` / `cf list tasks`. Throws UserError on non-numeric or
+ * negative input; returns the parsed integer otherwise.
+ */
+export function parseArchIndex(raw) {
+    const archIndex = Number(raw);
+    if (!Number.isInteger(archIndex) || archIndex < 0) {
+        throw new UserError(`Invalid archIndex '${raw}' — must be a non-negative integer.`);
+    }
+    return archIndex;
+}
+//# sourceMappingURL=archIndex.js.map

package/dist/utils/archIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archIndex.js","sourceRoot":"","sources":["../../src/utils/archIndex.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,SAAS,CAAC,sBAAsB,GAAG,qCAAqC,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,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"}

package/dist/utils/phaseShorthand.js

@@ -0,0 +1,68 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { PROMPT_FILE_RELATIVE_PATH } from '@context-forge/core';
+/**
+ * Phase shorthand map: P1 → phase name, derived at runtime from the prompt asset.
+ * Cached after first parse.
+ */
+let cachedShorthands = null;
+/**
+ * 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 async function getPhaseShorthands(projectPath) {
+    if (cachedShorthands)
+        return cachedShorthands;
+    const promptFilePath = path.join(projectPath, PROMPT_FILE_RELATIVE_PATH);
+    const content = await fs.readFile(promptFilePath, 'utf-8');
+    const map = new Map();
+    // Match headings like "##### Concept (Phase 1)" or "##### Implementation (Phase 6)"
+    const pattern = /^#{1,6}\s+(.+?)\s+\(Phase\s+(\d+(?:\.\d+)?)\)\s*$/gm;
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+        const name = match[1].trim();
+        const number = match[2];
+        // Only use the integer part for shorthand (P1, P2, etc.)
+        const intPart = number.split('.')[0];
+        const shorthand = `P${intPart}`;
+        // First match for each integer wins (e.g. P2 = Architecture, not P2.1)
+        if (!map.has(shorthand)) {
+            map.set(shorthand, name);
+        }
+    }
+    cachedShorthands = map;
+    return map;
+}
+/** Clear the cached shorthands (for testing). */
+export function clearPhaseShorthandCache() {
+    cachedShorthands = null;
+}
+/**
+ * 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 async function resolvePhaseInput(input, projectPath) {
+    // Check if input is a shorthand like P1, p5, etc.
+    const shorthandMatch = input.match(/^[Pp](\d+)$/);
+    if (shorthandMatch) {
+        const shorthands = await getPhaseShorthands(projectPath);
+        const key = `P${shorthandMatch[1]}`;
+        const name = shorthands.get(key);
+        if (name)
+            return name;
+        // Fall through — return as-is and let the parser handle it
+    }
+    // Normalize: hyphens ↔ spaces
+    return input.replace(/-/g, ' ');
+}
+//# sourceMappingURL=phaseShorthand.js.map

package/dist/utils/phaseShorthand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phaseShorthand.js","sourceRoot":"","sources":["../../src/utils/phaseShorthand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAEhE;;;GAGG;AACH,IAAI,gBAAgB,GAA+B,IAAI,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,WAAmB;IAC1D,IAAI,gBAAgB;QAAE,OAAO,gBAAgB,CAAC;IAE9C,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,yBAAyB,CAAC,CAAC;IACzE,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAE3D,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,oFAAoF;IACpF,MAAM,OAAO,GAAG,qDAAqD,CAAC;IAEtE,IAAI,KAAK,CAAC;IACV,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACzB,yDAAyD;QACzD,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;QACtC,MAAM,SAAS,GAAG,IAAI,OAAO,EAAE,CAAC;QAChC,uEAAuE;QACvE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACxB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,gBAAgB,GAAG,GAAG,CAAC;IACvB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,wBAAwB;IACtC,gBAAgB,GAAG,IAAI,CAAC;AAC1B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAa,EACb,WAAmB;IAEnB,kDAAkD;IAClD,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAClD,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,UAAU,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,IAAI,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;QACtB,2DAA2D;IAC7D,CAAC;IAED,8BAA8B;IAC9B,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC"}

package/dist/utils/project.d.ts

@@ -0,0 +1,60 @@
+import { FileProjectStore } from '@context-forge/core/node';
+import type { ProjectData } from '@context-forge/core';
+/**
+ * Find a project by exact ID or case-insensitive name.
+ * ID match takes priority over name match.
+ */
+export declare function findByNameOrId(nameOrId: string, store: FileProjectStore): Promise<ProjectData | null>;
+/** Result of a CWD-based project match, including optional worktree context. */
+export interface CwdMatch {
+    project: ProjectData;
+    /** Set when the match was via a worktree's worktreePath rather than projectPath. */
+    worktreeId?: string;
+}
+/**
+ * Find the project whose projectPath or worktreePath best matches the current
+ * working directory. When multiple paths match (nested paths), the longest wins.
+ * Projects without a projectPath are skipped; worktrees without a worktreePath
+ * are also skipped.
+ */
+export declare function findProjectByCwd(store: FileProjectStore): Promise<CwdMatch | null>;
+export type ResolutionSource = 'flag' | 'cwd' | 'worktree' | 'default' | 'none';
+export interface ResolvedProject {
+    id: string;
+    source: ResolutionSource;
+}
+export interface ResolvedProjectWorktree {
+    id: string;
+    source: ResolutionSource;
+    /** Set when CWD matched a worktree's worktreePath. */
+    worktreeId?: string;
+}
+/** Options for resolveProjectWorktree. */
+export interface ResolveProjectWorktreeOptions {
+    /** Explicit --project flag value (name or id). */
+    project?: string;
+    /** Explicit --worktree flag value (name or id) — overrides CWD-derived worktreeId. */
+    worktree?: string;
+}
+/**
+ * Resolves which project and (optionally) worktree to use via a three-step chain:
+ *
+ * 1. explicit --project flag → findByNameOrId
+ * 2. CWD detection → findProjectByCwd (worktree-aware)
+ * 3. Throw UserError with guidance
+ *
+ * When opts.worktree is provided and a project was resolved, also resolves the
+ * worktreeId via findWorktreeByNameOrId.
+ */
+export declare function resolveProjectWorktree(opts: ResolveProjectWorktreeOptions, store: FileProjectStore): Promise<ResolvedProjectWorktree>;
+/**
+ * Resolves which project to use via a three-step chain.
+ * Backwards-compatible wrapper around resolveProjectWorktree — drops worktreeId.
+ */
+export declare function resolveProjectId(explicit: string | undefined, store: FileProjectStore): Promise<ResolvedProject>;
+/**
+ * Find a worktree within a project by exact ID or case-insensitive name.
+ * ID match takes priority over name match. Returns undefined if not found.
+ */
+export declare function findWorktreeByNameOrId(projectId: string, nameOrId: string, store: FileProjectStore): Promise<import('@context-forge/core').WorktreeContext | undefined>;
+//# sourceMappingURL=project.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/utils/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAwB,MAAM,0BAA0B,CAAC;AAClF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAW7B;AAED,gFAAgF;AAChF,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,WAAW,CAAC;IACrB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAyC1B;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;IACzB,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,0CAA0C;AAC1C,MAAM,WAAW,6BAA6B;IAC5C,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,6BAA6B,EACnC,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,uBAAuB,CAAC,CAsDlC;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,eAAe,CAAC,CAG1B;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,OAAO,qBAAqB,EAAE,eAAe,GAAG,SAAS,CAAC,CAapE"}