@context-forge/cli 0.2.2

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[][]): 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,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CAmCvE"}

package/dist/output/tables.js

@@ -0,0 +1,42 @@
+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) {
+    // 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 lines = [];
+    // Header row — bold cyan
+    const headerLine = headers
+        .map((h, i) => chalk.bold.cyan(h.padEnd(colWidths[i])))
+        .join(' '.repeat(pad));
+    lines.push('  ' + headerLine);
+    // Underline — thin dash under each column
+    const underline = colWidths
+        .map((w) => '─'.repeat(w))
+        .join(' '.repeat(pad));
+    lines.push('  ' + chalk.dim(underline));
+    // Data rows
+    for (const row of rows) {
+        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('  ' + 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,CAAC,OAAiB,EAAE,IAAgB;IAC7D,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,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,IAAI,GAAG,UAAU,CAAC,CAAC;IAE9B,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,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IAExC,YAAY;IACZ,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,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,IAAI,GAAG,OAAO,CAAC,CAAC;IAC7B,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/errors.d.ts

@@ -0,0 +1,13 @@
+/**
+ * User-facing error — printed without stack trace.
+ * Use for expected failure conditions (missing config, invalid arguments, etc).
+ */
+export declare class UserError extends Error {
+    constructor(message: string);
+}
+/**
+ * Top-level error handler. Prints the message and exits with code 1.
+ * 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;;;GAGG;AACH,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAS/C"}

package/dist/utils/errors.js

@@ -0,0 +1,27 @@
+/**
+ * User-facing error — printed without stack trace.
+ * Use for expected failure conditions (missing config, invalid arguments, etc).
+ */
+export class UserError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'UserError';
+    }
+}
+/**
+ * Top-level error handler. Prints the message and exits with code 1.
+ * UserErrors get a clean message; unexpected errors get a brief summary.
+ */
+export function handleError(err) {
+    if (err instanceof UserError) {
+        console.error(err.message);
+    }
+    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":"AAAA;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;SAAM,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,UAAU,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzC,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,28 @@
+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>;
+/**
+ * Find the project whose projectPath best matches the current working directory.
+ * When multiple projects match (nested paths), the longest projectPath wins.
+ * Projects without a projectPath are skipped.
+ */
+export declare function findProjectByCwd(store: FileProjectStore): Promise<ProjectData | null>;
+export type ResolutionSource = 'flag' | 'cwd' | 'default' | 'none';
+export interface ResolvedProject {
+    id: string;
+    source: ResolutionSource;
+}
+/**
+ * Resolves which project to use via a three-step chain:
+ *
+ * 1. explicit --project flag → findByNameOrId
+ * 2. CWD detection → findProjectByCwd
+ * 3. default_project config → findByNameOrId
+ * 4. Throw UserError with guidance
+ */
+export declare function resolveProjectId(explicit: string | undefined, store: FileProjectStore): Promise<ResolvedProject>;
+//# 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,EAAiB,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC3E,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;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAa7B;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,eAAe,CAAC,CAgD1B"}

package/dist/utils/project.js

@@ -0,0 +1,81 @@
+import { ConfigManager } from '@context-forge/core/node';
+import { UserError } from './errors.js';
+/**
+ * Find a project by exact ID or case-insensitive name.
+ * ID match takes priority over name match.
+ */
+export async function findByNameOrId(nameOrId, store) {
+    const projects = await store.getAll();
+    // Exact ID match first
+    const byId = projects.find((p) => p.id === nameOrId);
+    if (byId)
+        return byId;
+    // Case-insensitive name match
+    const lower = nameOrId.toLowerCase();
+    const byName = projects.find((p) => p.name?.toLowerCase() === lower);
+    return byName ?? null;
+}
+/**
+ * Find the project whose projectPath best matches the current working directory.
+ * When multiple projects match (nested paths), the longest projectPath wins.
+ * Projects without a projectPath are skipped.
+ */
+export async function findProjectByCwd(store) {
+    const projects = await store.getAll();
+    const cwd = process.cwd();
+    const matches = projects
+        .filter((p) => {
+        if (!p.projectPath)
+            return false;
+        const path = p.projectPath.endsWith('/') ? p.projectPath.slice(0, -1) : p.projectPath;
+        return cwd === path || cwd.startsWith(path + '/');
+    })
+        .sort((a, b) => (b.projectPath?.length ?? 0) - (a.projectPath?.length ?? 0));
+    return matches[0] ?? null;
+}
+/**
+ * Resolves which project to use via a three-step chain:
+ *
+ * 1. explicit --project flag → findByNameOrId
+ * 2. CWD detection → findProjectByCwd
+ * 3. default_project config → findByNameOrId
+ * 4. Throw UserError with guidance
+ */
+export async function resolveProjectId(explicit, store) {
+    // Step 1: explicit --project flag
+    if (explicit) {
+        const project = await findByNameOrId(explicit, store);
+        if (!project) {
+            throw new UserError(`Project '${explicit}' not found.\n` +
+                '  Check the spelling, or run cf project list to see available projects.');
+        }
+        return { id: project.id, source: 'flag' };
+    }
+    // Step 2: CWD detection
+    const cwdProject = await findProjectByCwd(store);
+    if (cwdProject) {
+        return { id: cwdProject.id, source: 'cwd' };
+    }
+    // Step 3: default_project config
+    const cm = new ConfigManager();
+    const result = await cm.get('default_project');
+    const defaultRef = result.value;
+    if (defaultRef) {
+        const project = await findByNameOrId(defaultRef, store);
+        if (!project) {
+            throw new UserError(`default_project is set to '${defaultRef}' but no matching project was found.\n` +
+                '  cf project list                        # see available projects\n' +
+                '  cf config set default_project <name>   # update the default');
+        }
+        console.error('Warning: Resolved via default_project config. Consider using --project or running from within a registered project directory.\n' +
+            '  cf init          # register current directory\n' +
+            '  cf project list  # see registered projects');
+        return { id: project.id, source: 'default' };
+    }
+    // Step 4: no resolution
+    throw new UserError('No project specified and no registered project found at current path.\n' +
+        '  cf init                    # register current directory as a project\n' +
+        '  --project <name>           # specify a project explicitly\n' +
+        '  cf project list            # see registered projects');
+}
+//# sourceMappingURL=project.js.map

package/dist/utils/project.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@context-forge/cli",
+  "version": "0.2.2",
+  "description": "CLI for Context Forge — terminal access to context assembly, project management, workflow navigation, and configuration",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "cf": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "cli",
+    "context",
+    "ai",
+    "context-forge"
+  ],
+  "author": "Manta Templates",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ecorkran/context-forge.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/ecorkran/context-forge/tree/main/packages/cli#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "@context-forge/core": "0.2.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "typescript": "~5.8.3",
+    "vitest": "^3.2.1"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}