@context-forge/cli 0.8.5 → 0.9.0

package/dist/commands/update.js

@@ -0,0 +1,172 @@
+import { createRequire } from 'node:module';
+import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { handleError } from '../utils/errors.js';
+import { withJsonOption, withYesOption } from '../options.js';
+import { askConfirmation } from '../utils/confirm.js';
+import { printJson } from '../output/formatter.js';
+import { label, value, dim, success, warn } from '../output/styles.js';
+const require = createRequire(import.meta.url);
+const { version: currentVersion } = require('../../package.json');
+/**
+ * Compare two semver strings (major.minor.patch).
+ * Returns -1 if a < b, 0 if equal, 1 if a > b.
+ */
+export function compareSemver(a, b) {
+    const partsA = a.split('.').map(Number);
+    const partsB = b.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const segA = partsA[i] ?? 0;
+        const segB = partsB[i] ?? 0;
+        if (segA < segB)
+            return -1;
+        if (segA > segB)
+            return 1;
+    }
+    return 0;
+}
+/**
+ * Fetch the latest published version of a package from the npm registry.
+ * Returns null on any failure (network, non-200, malformed JSON).
+ */
+export async function fetchLatestVersion(packageName) {
+    try {
+        const response = await globalThis.fetch(`https://registry.npmjs.org/${packageName}/latest`, { signal: AbortSignal.timeout(10_000) });
+        if (!response.ok)
+            return null;
+        const data = await response.json();
+        if (typeof data === 'object' && data !== null && 'version' in data) {
+            const ver = data.version;
+            if (typeof ver === 'string')
+                return ver;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Detect how cf was installed globally.
+ * Returns the package manager method and whether this is a local/dev install.
+ */
+export function detectInstallMethod() {
+    const scriptPath = process.argv[1] ?? '';
+    // pnpm global install (check first — pnpm global paths also contain node_modules)
+    if (scriptPath.includes('.pnpm') || scriptPath.includes('pnpm/global')) {
+        return { method: 'pnpm', isLocal: false };
+    }
+    // Check for global npm install (system-level node_modules)
+    const isGlobalNpm = /\/(usr|opt)\/(local\/)?lib\/node_modules\//.test(scriptPath)
+        || /\/lib\/node_modules\//.test(scriptPath);
+    if (isGlobalNpm) {
+        return { method: 'npm', isLocal: false };
+    }
+    // Local/dev install: project-local node_modules or relative path
+    if (scriptPath.includes('node_modules') || !scriptPath.startsWith('/')) {
+        return { method: 'unknown', isLocal: true };
+    }
+    // Heuristic: if a package.json exists in the script's ancestor directories
+    // (within 4 levels), this is likely a local dev install (e.g., `node packages/cli/dist/index.js`)
+    if (isLocalDevPath(scriptPath)) {
+        return { method: 'unknown', isLocal: true };
+    }
+    // Default to npm global (absolute path not matching known patterns)
+    return { method: 'npm', isLocal: false };
+}
+/** Check if the script path is under a local project by looking for package.json nearby. */
+function isLocalDevPath(scriptPath) {
+    let dir = dirname(resolve(scriptPath));
+    for (let i = 0; i < 4; i++) {
+        if (existsSync(join(dir, 'package.json')))
+            return true;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return false;
+}
+/**
+ * Run the global install command to update the CLI package.
+ * Uses execSync so the user sees output directly. Throws on failure.
+ */
+export function runUpdate(method) {
+    const cmd = method === 'pnpm'
+        ? 'pnpm add -g @context-forge/cli@latest'
+        : 'npm install -g @context-forge/cli@latest';
+    execSync(cmd, { stdio: 'inherit' });
+}
+/** Register the `cf update` command. */
+export function registerUpdateCommand(program) {
+    const updateCmd = program
+        .command('update')
+        .description('Check for updates and install the latest version');
+    withYesOption(updateCmd);
+    withJsonOption(updateCmd);
+    updateCmd.action(async (opts) => {
+        try {
+            const install = detectInstallMethod();
+            // Local/dev install — skip update
+            if (install.isLocal) {
+                console.log(warn('Local development install detected — skipping self-update.'));
+                console.log(dim('  To update, pull the latest changes and rebuild.'));
+                return;
+            }
+            // Fetch latest version from npm
+            const latest = await fetchLatestVersion('@context-forge/cli');
+            if (!latest) {
+                handleError(new Error('Could not reach npm registry — check your network connection.'));
+            }
+            const cmp = compareSemver(currentVersion, latest);
+            // JSON output — no side effects
+            if (opts.json) {
+                printJson({
+                    current: currentVersion,
+                    latest,
+                    updateAvailable: cmp < 0,
+                    installMethod: install.method,
+                });
+                return;
+            }
+            // Already up to date
+            if (cmp >= 0) {
+                console.log(success(`@context-forge/cli v${currentVersion} is up to date.`));
+                return;
+            }
+            // Update available
+            console.log(`${label('Update available:')} ${value(currentVersion)} → ${value(latest)}`);
+            console.log('');
+            const isTTY = process.stdin.isTTY;
+            if (opts.yes) {
+                // --yes: proceed without prompt
+            }
+            else if (isTTY) {
+                // Interactive: prompt
+                const confirmed = await askConfirmation('Install now? (y/N) ');
+                if (!confirmed) {
+                    console.log(dim('Update skipped.'));
+                    return;
+                }
+            }
+            else {
+                // Non-TTY without --yes: inform and exit
+                console.log(dim('Run with --yes to install non-interactively.'));
+                return;
+            }
+            if (install.method === 'unknown') {
+                console.log(warn('Could not determine install method. Run manually:'));
+                console.log(dim('  npm install -g @context-forge/cli@latest'));
+                return;
+            }
+            runUpdate(install.method);
+            console.log('');
+            console.log(success(`✓ Updated @context-forge/cli to ${latest}`));
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

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

package/dist/commands/workflow.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerWorkflowCommands(program: Command): void;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/commands/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/commands/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuEpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4I/D"}

package/dist/commands/workflow.js

@@ -0,0 +1,204 @@
+import { FileProjectStore, detectDocuments, checkFileExists } from '@context-forge/core/node';
+import { resolveProject } from '@context-forge/core';
+import { projectSetAction } from './project.js';
+import { buildAndPrint } from './build.js';
+import { resolveProjectWorktree } from '../utils/project.js';
+import { resolveOperationPath } from '../utils/worktree-overlay.js';
+import { handleError, UserError } from '../utils/errors.js';
+import { warn } from '../output/styles.js';
+/** Validate that a compound command argument is a numeric index. */
+function requireNumericIndex(value, commandName) {
+    if (!/^\d+$/.test(value)) {
+        throw new UserError(`'cf ${commandName}' requires a numeric index, got '${value}'.`, 'INVALID_ARGUMENT', `Use: cf ${commandName} <index>  (e.g. cf ${commandName} 200)\n` +
+            `  To list: cf list ${commandName === 'implement' ? 'slices' : commandName === 'tasks' ? 'tasks' : commandName + 's'}`);
+    }
+}
+/** Warn to stderr if an artifact already exists for the given index. */
+async function warnIfArtifactExists(projectPath, index, field, label) {
+    try {
+        const docs = await detectDocuments(projectPath, index);
+        const value = docs[field];
+        const exists = Array.isArray(value) ? value.length > 0 : value !== null;
+        if (exists) {
+            process.stderr.write(warn(`${label} already exists for index ${index}. Building prompt anyway.\n`));
+        }
+    }
+    catch {
+        // Detection failure is not fatal
+    }
+}
+/** Warn to stderr if the concept document already exists. */
+async function warnIfConceptExists(opts) {
+    try {
+        const store = new FileProjectStore();
+        const { id, worktreeId } = await resolveProjectWorktree({ project: opts.project }, store);
+        const project = await resolveProject(store, id, worktreeId);
+        if (!project?.projectPath || !project.fileConcept)
+            return;
+        const opPath = resolveOperationPath(project, worktreeId) ?? project.projectPath;
+        const exists = await checkFileExists(opPath, project.fileConcept);
+        if (exists) {
+            process.stderr.write(warn('Concept document already exists. Building concept prompt anyway.\n'));
+        }
+    }
+    catch {
+        // Detection failure is not fatal
+    }
+}
+/** Resolve the operation path for artifact detection. */
+async function getOperationPath(opts) {
+    try {
+        const store = new FileProjectStore();
+        const { id, worktreeId } = await resolveProjectWorktree({ project: opts.project }, store);
+        const project = await resolveProject(store, id, worktreeId);
+        if (!project?.projectPath)
+            return undefined;
+        return resolveOperationPath(project, worktreeId) ?? project.projectPath;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function registerWorkflowCommands(program) {
+    // cf concept
+    program
+        .command('concept')
+        .description('Set phase to Concept and build prompt')
+        .option('--project <name|id>', 'Project name or ID')
+        .option('--project-level', 'Force project-level field updates')
+        .option('--json', 'Output context as JSON to stdout')
+        .action(async (opts) => {
+        try {
+            await warnIfConceptExists(opts);
+            await projectSetAction('developmentPhase', 'Phase 0: Concept', opts);
+            await buildAndPrint({ ...opts, commandHint: 'concept' });
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    // cf initiatives
+    program
+        .command('initiatives')
+        .description('Set phase to Initiative Plan and build prompt')
+        .option('--project <name|id>', 'Project name or ID')
+        .option('--project-level', 'Force project-level field updates')
+        .option('--json', 'Output context as JSON to stdout')
+        .action(async (opts) => {
+        try {
+            await projectSetAction('developmentPhase', 'Phase 1: Initiative Plan', opts);
+            await buildAndPrint({ ...opts, commandHint: 'initiatives' });
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    // cf arch <index>
+    program
+        .command('arch <index>')
+        .description('Set architecture initiative and build prompt')
+        .option('--project <name|id>', 'Project name or ID')
+        .option('--project-level', 'Force project-level field updates')
+        .option('--json', 'Output context as JSON to stdout')
+        .action(async (index, opts) => {
+        try {
+            requireNumericIndex(index, 'arch');
+            await projectSetAction('fileArch', index, opts);
+            await projectSetAction('developmentPhase', 'Phase 2: Architecture', opts);
+            const opPath = await getOperationPath(opts);
+            if (opPath) {
+                await warnIfArtifactExists(opPath, parseInt(index, 10), 'architecture', 'Architecture document');
+            }
+            await buildAndPrint({ ...opts, commandHint: `arch ${index}` });
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    // cf plan <index>
+    program
+        .command('plan <index>')
+        .description('Set slice plan and build prompt')
+        .option('--project <name|id>', 'Project name or ID')
+        .option('--project-level', 'Force project-level field updates')
+        .option('--json', 'Output context as JSON to stdout')
+        .action(async (index, opts) => {
+        try {
+            requireNumericIndex(index, 'plan');
+            await projectSetAction('fileSlicePlan', index, opts);
+            await projectSetAction('developmentPhase', 'Phase 3: Slice Planning', opts);
+            const opPath = await getOperationPath(opts);
+            if (opPath) {
+                await warnIfArtifactExists(opPath, parseInt(index, 10), 'slicePlan', 'Slice plan');
+            }
+            await buildAndPrint({ ...opts, commandHint: `plan ${index}` });
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    // cf slice <index>
+    program
+        .command('slice <index>')
+        .description('Set active slice and build prompt')
+        .option('--project <name|id>', 'Project name or ID')
+        .option('--project-level', 'Force project-level field updates')
+        .option('--json', 'Output context as JSON to stdout')
+        .action(async (index, opts) => {
+        try {
+            requireNumericIndex(index, 'slice');
+            await projectSetAction('fileSlice', index, opts);
+            await projectSetAction('developmentPhase', 'Phase 4: Slice Design', opts);
+            const opPath = await getOperationPath(opts);
+            if (opPath) {
+                await warnIfArtifactExists(opPath, parseInt(index, 10), 'sliceDesign', 'Slice design');
+            }
+            await buildAndPrint({ ...opts, commandHint: `slice ${index}` });
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    // cf tasks <index>
+    program
+        .command('tasks <index>')
+        .description('Set active task file and build prompt')
+        .option('--project <name|id>', 'Project name or ID')
+        .option('--project-level', 'Force project-level field updates')
+        .option('--json', 'Output context as JSON to stdout')
+        .action(async (index, opts) => {
+        try {
+            requireNumericIndex(index, 'tasks');
+            await projectSetAction('fileTasks', index, opts);
+            await projectSetAction('developmentPhase', 'Phase 5: Task Breakdown', opts);
+            const opPath = await getOperationPath(opts);
+            if (opPath) {
+                await warnIfArtifactExists(opPath, parseInt(index, 10), 'taskFile', 'Task file');
+            }
+            await buildAndPrint({ ...opts, commandHint: `tasks ${index}` });
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    // cf implement <index>
+    program
+        .command('implement <index>')
+        .description('Set active slice for implementation and build prompt')
+        .option('--project <name|id>', 'Project name or ID')
+        .option('--project-level', 'Force project-level field updates')
+        .option('--json', 'Output context as JSON to stdout')
+        .action(async (index, opts) => {
+        try {
+            requireNumericIndex(index, 'implement');
+            await projectSetAction('fileSlice', index, opts);
+            await projectSetAction('developmentPhase', 'Phase 6: Implementation', opts);
+            // No artifact warning for implement — implementation is always continuation
+            await buildAndPrint({ ...opts, commandHint: `implement ${index}` });
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+//# sourceMappingURL=workflow.js.map

package/dist/commands/workflow.js.map

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

package/dist/commands/worktree.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerWorktreeCommand(program: Command): void;
+//# sourceMappingURL=worktree.d.ts.map

package/dist/commands/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/commands/worktree.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsCpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAia9D"}