@context-forge/cli 0.8.5 → 0.8.6

package/dist/commands/status.js

@@ -0,0 +1,209 @@
+import { join } from 'node:path';
+import { FileProjectStore, WorkflowNavigator, GitWorktreeDiscovery, parseSlicePlan, resolveArtifactPath } from '@context-forge/core/node';
+import { resolveProject } from '@context-forge/core';
+import { resolveProjectWorktree, findWorktreeByNameOrId } from '../utils/project.js';
+import { applyWorktreeOverlay } from '../utils/worktree-overlay.js';
+import { handleError, UserError } from '../utils/errors.js';
+import { withJsonOption, withProjectOption } from '../options.js';
+import { printJson } from '../output/formatter.js';
+import { renderTable } from '../output/tables.js';
+import { label, value as valueStyle, success, dim, warn } from '../output/styles.js';
+export function registerStatusCommand(program) {
+    const statusCmd = program
+        .command('status')
+        .description('Show workflow status for the active project');
+    withJsonOption(statusCmd);
+    withProjectOption(statusCmd);
+    statusCmd
+        .option('--worktree <name>', 'Show status for a specific worktree')
+        .option('--worktrees', 'Show summary of all worktrees');
+    statusCmd.action(async (opts) => {
+        try {
+            if (opts.worktree && opts.worktrees) {
+                throw new UserError('--worktree and --worktrees are mutually exclusive.');
+            }
+            const store = new FileProjectStore();
+            const { id, source, worktreeId: cwdWorktreeId } = await resolveProjectWorktree({ project: opts.project }, store);
+            const rawProject = await store.getById(id);
+            if (!rawProject) {
+                throw new UserError(`Project not found: '${id}'. Run cf project list to see available projects.`);
+            }
+            // ── --worktrees dashboard ──────────────────────────────────────────
+            if (opts.worktrees) {
+                const worktrees = rawProject.worktrees ?? [];
+                if (worktrees.length === 0) {
+                    if (opts.json) {
+                        printJson([]);
+                    }
+                    else {
+                        console.log(dim('No worktrees configured.'));
+                    }
+                    return;
+                }
+                const summaries = await Promise.all(worktrees.map(async (wt) => {
+                    const overlaid = applyWorktreeOverlay(rawProject, wt.id);
+                    let sliceProgress = '—';
+                    const wtPath = wt.worktreePath ?? rawProject.projectPath;
+                    if (overlaid.fileSlicePlan && wtPath) {
+                        const planRelPath = resolveArtifactPath('fileSlicePlan', overlaid.fileSlicePlan);
+                        if (planRelPath) {
+                            try {
+                                const planPath = join(wtPath, planRelPath);
+                                const plan = await parseSlicePlan(planPath);
+                                sliceProgress = `${plan.completedSlices}/${plan.totalSlices} slices`;
+                            }
+                            catch {
+                                // Plan file may not exist on disk
+                            }
+                        }
+                    }
+                    const isActive = wt.id === cwdWorktreeId;
+                    return {
+                        id: wt.id,
+                        name: wt.name,
+                        range: wt.indexRange ? `${wt.indexRange[0]}-${wt.indexRange[1]}` : '—',
+                        phase: overlaid.developmentPhase || '—',
+                        slice: overlaid.fileSlice || '—',
+                        progress: sliceProgress,
+                        isActive,
+                    };
+                }));
+                if (opts.json) {
+                    printJson(summaries);
+                    return;
+                }
+                console.log(label('Project:  ') + valueStyle(rawProject.name));
+                console.log('');
+                const rows = summaries.map((s) => {
+                    const activeSuffix = s.isActive ? success(' ← active') : '';
+                    return [s.name + activeSuffix, s.range, s.phase, s.slice, s.progress];
+                });
+                console.log(label('Worktrees'));
+                console.log(renderTable(['Name', 'Range', 'Phase', 'Slice', 'Progress'], rows));
+                return;
+            }
+            // ── Single worktree / default status ───────────────────────────────
+            // Resolve worktree: explicit --worktree flag takes priority over CWD resolution
+            let resolvedWorktreeId = cwdWorktreeId;
+            if (opts.worktree) {
+                const wt = await findWorktreeByNameOrId(id, opts.worktree, store);
+                if (!wt) {
+                    throw new UserError(`Worktree '${opts.worktree}' not found. Run cf worktree list to see available worktrees.`);
+                }
+                resolvedWorktreeId = wt.id;
+            }
+            // Apply worktree overlay so navigator and display use correct fields
+            const project = await resolveProject(store, id, resolvedWorktreeId);
+            if (!project) {
+                throw new UserError(`Project not found: '${id}'.`);
+            }
+            const worktreeCtx = resolvedWorktreeId
+                ? (rawProject.worktrees ?? []).find((w) => w.id === resolvedWorktreeId)
+                : undefined;
+            const nav = new WorkflowNavigator();
+            const status = await nav.getStatus(project);
+            if (opts.json) {
+                printJson({ ...status, resolutionSource: source, ...(worktreeCtx ? { worktree: worktreeCtx } : {}) });
+                return;
+            }
+            const sourceLabels = {
+                flag: '(--project flag)',
+                cwd: '(from CWD)',
+                worktree: '(from CWD)',
+                default: '(default)',
+                none: '',
+            };
+            // When worktree is resolved, show a dedicated Worktree line instead of
+            // embedding worktree info in the Project line's source label.
+            const sourceLabel = sourceLabels[source];
+            const projectLine = sourceLabel
+                ? `${valueStyle(status.project)}  ${dim(sourceLabel)}`
+                : valueStyle(status.project);
+            console.log(label('Project:  ') + projectLine);
+            if (worktreeCtx) {
+                const range = worktreeCtx.indexRange
+                    ? ` [${worktreeCtx.indexRange[0]}-${worktreeCtx.indexRange[1]}]`
+                    : '';
+                console.log(label('Worktree: ') + valueStyle(`${worktreeCtx.name}${range}`));
+            }
+            console.log(label('Date:     ') + valueStyle(project.dateProject || 'Not set'));
+            console.log(label('Phase:    ') + valueStyle(status.phase ?? 'Not set'));
+            console.log(label('Arch:     ') + valueStyle(project.fileArch || 'Not set'));
+            console.log(label('Plan:     ') + valueStyle(project.fileSlicePlan || 'Not set'));
+            console.log(label('Slice:    ') + valueStyle(project.fileSlice || 'Not set'));
+            console.log(label('Tasks:    ') + valueStyle(project.fileTasks || 'Not set'));
+            if (status.activeSlice?.taskProgress) {
+                const { completed, total, inferredStatus } = status.activeSlice.taskProgress;
+                console.log(label('Progress: ') + valueStyle(`${completed}/${total} tasks (${inferredStatus})`));
+            }
+            if (status.activeSlice && status.activeSlice.status !== 'no-active-slice') {
+                console.log(label('Status:   ') + valueStyle(status.activeSlice.status));
+            }
+            if (status.slicePlan) {
+                console.log('');
+                console.log(label('Slice Plan'));
+                console.log(dim(`  ${status.slicePlan.completed}/${status.slicePlan.total} slices complete`));
+            }
+        }
+        catch (err) {
+            // First-run messaging: suggest cf worktree init if CWD is a git worktree of a known project
+            if (err instanceof UserError) {
+                const shown = await showWorktreeSuggestion();
+                if (shown)
+                    return;
+            }
+            handleError(err);
+        }
+    });
+}
+/**
+ * When project resolution fails, check if CWD is a git worktree of a known project.
+ * If so, display a helpful suggestion to create a worktree context.
+ * Returns true if a suggestion was displayed.
+ */
+async function showWorktreeSuggestion() {
+    try {
+        const discovery = new GitWorktreeDiscovery();
+        const gitWorktrees = await discovery.listWorktrees(process.cwd());
+        if (gitWorktrees.length === 0)
+            return false;
+        // Main worktree is the first entry from git worktree list
+        const mainWorktreePath = gitWorktrees[0].path;
+        // Check if main worktree path matches a registered project
+        const store = new FileProjectStore();
+        const projects = await store.getAll();
+        const matchingProject = projects.find((p) => p.projectPath === mainWorktreePath);
+        if (!matchingProject)
+            return false;
+        // Derive suggested name from current git branch
+        const currentBranch = gitWorktrees.find((wt) => {
+            const cwd = process.cwd();
+            return wt.path === cwd || cwd.startsWith(wt.path + '/');
+        })?.branch;
+        let suggestedName = 'my-worktree';
+        if (currentBranch) {
+            // Strip refs/heads/ and common prefixes like feature/, bugfix/
+            suggestedName = currentBranch
+                .replace(/^refs\/heads\//, '')
+                .replace(/^(feature|bugfix|hotfix|fix|chore|refactor)\//, '');
+        }
+        // Suggest next available 100-block range
+        const existingWorktrees = matchingProject.worktrees ?? [];
+        let maxEnd = 99;
+        for (const wt of existingWorktrees) {
+            if (wt.indexRange[1] > maxEnd)
+                maxEnd = wt.indexRange[1];
+        }
+        const rangeStart = Math.ceil((maxEnd + 1) / 100) * 100;
+        const rangeEnd = rangeStart + 99;
+        console.log('');
+        console.log(warn(`This directory appears to be a git worktree of project '${matchingProject.name}'.`));
+        console.log(`Create a worktree context: ${dim(`cf worktree init --name '${suggestedName}' --range ${rangeStart}-${rangeEnd}`)}`);
+        console.log('');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC1I,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAyB,MAAM,qBAAqB,CAAC;AAC5G,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,UAAU,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAErF,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,SAAS,GAAG,OAAO;SACtB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,6CAA6C,CAAC,CAAC;IAC9D,cAAc,CAAC,SAAS,CAAC,CAAC;IAC1B,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC7B,SAAS;SACN,MAAM,CAAC,mBAAmB,EAAE,qCAAqC,CAAC;SAClE,MAAM,CAAC,aAAa,EAAE,+BAA+B,CAAC,CAAC;IAC1D,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,IAAkF,EAAE,EAAE;QAC1G,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACpC,MAAM,IAAI,SAAS,CAAC,oDAAoD,CAAC,CAAC;YAC5E,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,gBAAgB,EAAE,CAAC;YACrC,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,MAAM,sBAAsB,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;YACjH,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAE3C,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,SAAS,CAAC,uBAAuB,EAAE,mDAAmD,CAAC,CAAC;YACpG,CAAC;YAED,sEAAsE;YACtE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,EAAE,CAAC;gBAC7C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC3B,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;wBACd,SAAS,CAAC,EAAE,CAAC,CAAC;oBAChB,CAAC;yBAAM,CAAC;wBACN,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,CAAC;oBAC/C,CAAC;oBACD,OAAO;gBACT,CAAC;gBAED,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CACjC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE;oBACzB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;oBACzD,IAAI,aAAa,GAAG,GAAG,CAAC;oBAExB,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,IAAI,UAAU,CAAC,WAAW,CAAC;oBACzD,IAAI,QAAQ,CAAC,aAAa,IAAI,MAAM,EAAE,CAAC;wBACrC,MAAM,WAAW,GAAG,mBAAmB,CAAC,eAAe,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;wBACjF,IAAI,WAAW,EAAE,CAAC;4BAChB,IAAI,CAAC;gCACH,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;gCAC3C,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;gCAC5C,aAAa,GAAG,GAAG,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,WAAW,SAAS,CAAC;4BACvE,CAAC;4BAAC,MAAM,CAAC;gCACP,kCAAkC;4BACpC,CAAC;wBACH,CAAC;oBACH,CAAC;oBAED,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,KAAK,aAAa,CAAC;oBACzC,OAAO;wBACL,EAAE,EAAE,EAAE,CAAC,EAAE;wBACT,IAAI,EAAE,EAAE,CAAC,IAAI;wBACb,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG;wBACtE,KAAK,EAAE,QAAQ,CAAC,gBAAgB,IAAI,GAAG;wBACvC,KAAK,EAAE,QAAQ,CAAC,SAAS,IAAI,GAAG;wBAChC,QAAQ,EAAE,aAAa;wBACvB,QAAQ;qBACT,CAAC;gBACJ,CAAC,CAAC,CACH,CAAC;gBAEF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBACd,SAAS,CAAC,SAAS,CAAC,CAAC;oBACrB,OAAO;gBACT,CAAC;gBAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC/D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAEhB,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;oBAC/B,MAAM,YAAY,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC5D,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,YAAY,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;gBACxE,CAAC,CAAC,CAAC;gBAEH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;gBAChF,OAAO;YACT,CAAC;YAED,sEAAsE;YAEtE,gFAAgF;YAChF,IAAI,kBAAkB,GAAG,aAAa,CAAC;YACvC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,MAAM,EAAE,GAAG,MAAM,sBAAsB,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBAClE,IAAI,CAAC,EAAE,EAAE,CAAC;oBACR,MAAM,IAAI,SAAS,CAAC,aAAa,IAAI,CAAC,QAAQ,+DAA+D,CAAC,CAAC;gBACjH,CAAC;gBACD,kBAAkB,GAAG,EAAE,CAAC,EAAE,CAAC;YAC7B,CAAC;YAED,qEAAqE;YACrE,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,EAAE,EAAE,kBAAkB,CAAC,CAAC;YACpE,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,SAAS,CAAC,uBAAuB,EAAE,IAAI,CAAC,CAAC;YACrD,CAAC;YACD,MAAM,WAAW,GAAG,kBAAkB;gBACpC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,kBAAkB,CAAC;gBACvE,CAAC,CAAC,SAAS,CAAC;YAEd,MAAM,GAAG,GAAG,IAAI,iBAAiB,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YAE5C,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,SAAS,CAAC,EAAE,GAAG,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBACtG,OAAO;YACT,CAAC;YAED,MAAM,YAAY,GAAqC;gBACrD,IAAI,EAAE,kBAAkB;gBACxB,GAAG,EAAE,YAAY;gBACjB,QAAQ,EAAE,YAAY;gBACtB,OAAO,EAAE,WAAW;gBACpB,IAAI,EAAE,EAAE;aACT,CAAC;YAEF,uEAAuE;YACvE,8DAA8D;YAC9D,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;YACzC,MAAM,WAAW,GAAG,WAAW;gBAC7B,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,CAAC,WAAW,CAAC,EAAE;gBACtD,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,WAAW,CAAC,CAAC;YAE/C,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU;oBAClC,CAAC,CAAC,KAAK,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG;oBAChE,CAAC,CAAC,EAAE,CAAC;gBACP,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC,GAAG,WAAW,CAAC,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;YAC/E,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,WAAW,IAAI,SAAS,CAAC,CAAC,CAAC;YAChF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC;YACzE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,IAAI,SAAS,CAAC,CAAC,CAAC;YAC7E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,aAAa,IAAI,SAAS,CAAC,CAAC,CAAC;YAClF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC;YAC9E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC;YAE9E,IAAI,MAAM,CAAC,WAAW,EAAE,YAAY,EAAE,CAAC;gBACrC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC;gBAC7E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC,GAAG,SAAS,IAAI,KAAK,WAAW,cAAc,GAAG,CAAC,CAAC,CAAC;YACnG,CAAC;YAED,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,iBAAiB,EAAE,CAAC;gBAC1E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;YAC3E,CAAC;YAED,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;gBACjC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,SAAS,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,kBAAkB,CAAC,CAAC,CAAC;YAChG,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,4FAA4F;YAC5F,IAAI,GAAG,YAAY,SAAS,EAAE,CAAC;gBAC7B,MAAM,KAAK,GAAG,MAAM,sBAAsB,EAAE,CAAC;gBAC7C,IAAI,KAAK;oBAAE,OAAO;YACpB,CAAC;YACD,WAAW,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,sBAAsB;IACnC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC7C,MAAM,YAAY,GAAG,MAAM,SAAS,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAClE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAE5C,0DAA0D;QAC1D,MAAM,gBAAgB,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAE9C,2DAA2D;QAC3D,MAAM,KAAK,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;QACtC,MAAM,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,KAAK,gBAAgB,CAAC,CAAC;QACjF,IAAI,CAAC,eAAe;YAAE,OAAO,KAAK,CAAC;QAEnC,gDAAgD;QAChD,MAAM,aAAa,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE;YAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC,IAAI,KAAK,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;QAC1D,CAAC,CAAC,EAAE,MAAM,CAAC;QACX,IAAI,aAAa,GAAG,aAAa,CAAC;QAClC,IAAI,aAAa,EAAE,CAAC;YAClB,+DAA+D;YAC/D,aAAa,GAAG,aAAa;iBAC1B,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;iBAC7B,OAAO,CAAC,+CAA+C,EAAE,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,yCAAyC;QACzC,MAAM,iBAAiB,GAAG,eAAe,CAAC,SAAS,IAAI,EAAE,CAAC;QAC1D,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,MAAM,EAAE,IAAI,iBAAiB,EAAE,CAAC;YACnC,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,MAAM;gBAAE,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;QACvD,MAAM,QAAQ,GAAG,UAAU,GAAG,EAAE,CAAC;QAEjC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,2DAA2D,eAAe,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;QACvG,OAAO,CAAC,GAAG,CAAC,8BAA8B,GAAG,CAAC,4BAA4B,aAAa,aAAa,UAAU,IAAI,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QACjI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/commands/task.d.ts

@@ -0,0 +1,12 @@
+/** Shared action handler for listing task files. */
+export declare function taskListAction(opts: {
+    json?: boolean;
+    all?: boolean;
+    project?: string;
+}): Promise<void>;
+/** Shared action handler for listing task items from the active task file. */
+export declare function taskItemsAction(opts: {
+    json?: boolean;
+    project?: string;
+}): Promise<void>;
+//# sourceMappingURL=task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/commands/task.ts"],"names":[],"mappings":"AAgBA,oDAAoD;AACpD,wBAAsB,cAAc,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B7G;AAED,8EAA8E;AAC9E,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB/F"}

package/dist/commands/task.js

@@ -0,0 +1,185 @@
+import { join } from 'node:path';
+import { readdir } from 'node:fs/promises';
+import { FileProjectStore, resolveArtifactPath, extractSliceIndex, parseSlicePlan, parseTaskFile, } from '@context-forge/core/node';
+import { resolveProjectWorktree } from '../utils/project.js';
+import { resolveProject } from '@context-forge/core';
+import { resolveOperationPath, getWorktreeIndexRange, isInIndexRange, resolveAllOperationPaths } from '../utils/worktree-overlay.js';
+import { UserError } from '../utils/errors.js';
+import { printJson } from '../output/formatter.js';
+import { label, success, dim } from '../output/styles.js';
+/** Shared action handler for listing task files. */
+export async function taskListAction(opts) {
+    const store = new FileProjectStore();
+    const { id, worktreeId } = await resolveProjectWorktree({ project: opts.project }, store);
+    const rawProject = await store.getById(id);
+    if (!rawProject) {
+        throw new UserError(`Project not found: '${id}'.`);
+    }
+    const project = await resolveProject(store, id, worktreeId);
+    if (!project) {
+        throw new UserError(`Project not found: '${id}'.`);
+    }
+    if (!project.projectPath) {
+        throw new UserError('No projectPath configured. Set one with: cf set projectPath /path/to/project');
+    }
+    if (opts.all && rawProject.worktrees?.length) {
+        const paths = resolveAllOperationPaths(rawProject);
+        await listTaskFiles(project, paths, undefined, opts.json);
+    }
+    else {
+        const operationPath = resolveOperationPath(project, worktreeId) ?? project.projectPath;
+        const indexRange = getWorktreeIndexRange(rawProject, worktreeId);
+        await listTaskFiles(project, [operationPath], indexRange, opts.json);
+    }
+}
+/** Shared action handler for listing task items from the active task file. */
+export async function taskItemsAction(opts) {
+    const store = new FileProjectStore();
+    const { id, worktreeId } = await resolveProjectWorktree({ project: opts.project }, store);
+    const project = await resolveProject(store, id, worktreeId);
+    if (!project) {
+        throw new UserError(`Project not found: '${id}'.`);
+    }
+    if (!project.projectPath) {
+        throw new UserError('No projectPath configured. Set one with: cf set projectPath /path/to/project');
+    }
+    const operationPath = resolveOperationPath(project, worktreeId) ?? project.projectPath;
+    await listTaskItems(project, operationPath, opts.json);
+}
+async function listTaskItems(project, operationPath, json) {
+    if (!project.fileTasks) {
+        throw new UserError('No task file configured. Set one with: cf set tasks <filename>');
+    }
+    const taskRelPath = resolveArtifactPath('fileTasks', project.fileTasks);
+    if (!taskRelPath) {
+        throw new UserError('Could not resolve task file path.');
+    }
+    // Detect split task files via index
+    const sliceIndex = extractSliceIndex(project.fileSlice);
+    let taskPaths;
+    if (sliceIndex !== null) {
+        const tasksDir = join(operationPath, 'project-documents/user/tasks');
+        try {
+            const files = await readdir(tasksDir);
+            const matching = files
+                .filter((f) => f.startsWith(`${sliceIndex}-tasks.`) && f.endsWith('.md'))
+                .sort()
+                .map((f) => join(tasksDir, f));
+            taskPaths = matching.length > 0 ? matching : [join(operationPath, taskRelPath)];
+        }
+        catch {
+            taskPaths = [join(operationPath, taskRelPath)];
+        }
+    }
+    else {
+        taskPaths = [join(operationPath, taskRelPath)];
+    }
+    const taskResult = await parseTaskFile(taskPaths);
+    if (json) {
+        printJson(taskResult);
+        return;
+    }
+    const fileName = project.fileTasks.split('/').pop() ?? project.fileTasks;
+    console.log(label(`\nTasks: ${fileName}`) +
+        dim(`  (${taskResult.completedTasks}/${taskResult.totalTasks} complete)`));
+    for (const item of taskResult.items) {
+        const icon = item.done ? success('  ✓ ') : dim('  ○ ');
+        const text = item.done ? dim(item.name) : item.name;
+        console.log(icon + text);
+    }
+}
+async function listTaskFiles(project, operationPaths, indexRange, json) {
+    if (!project.fileSlicePlan) {
+        throw new UserError('No slice plan configured. Set one with: cf set slicePlan <path>');
+    }
+    const planRelPath = resolveArtifactPath('fileSlicePlan', project.fileSlicePlan);
+    if (!planRelPath) {
+        throw new UserError('Could not resolve slice plan path.');
+    }
+    // Try to find the plan file across operation paths
+    let plan;
+    for (const op of operationPaths) {
+        try {
+            plan = await parseSlicePlan(join(op, planRelPath));
+            break;
+        }
+        catch {
+            continue;
+        }
+    }
+    if (!plan) {
+        throw new UserError('Could not resolve slice plan path.');
+    }
+    const activeIndex = extractSliceIndex(project.fileSlice);
+    // Collect task files from all operation paths, deduplicate by filename
+    const fileMap = new Map(); // filename -> full path to tasks dir
+    for (const op of operationPaths) {
+        const tasksDir = join(op, 'project-documents/user/tasks');
+        try {
+            const files = await readdir(tasksDir);
+            for (const f of files) {
+                if (!fileMap.has(f))
+                    fileMap.set(f, tasksDir);
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    if (fileMap.size === 0) {
+        if (json) {
+            console.log(JSON.stringify([]));
+            return;
+        }
+        console.log('No task files found.');
+        return;
+    }
+    const summaries = [];
+    // Skip range filtering when the plan itself is outside the range
+    const planBaseIndex = /^(\d+)-/.exec(project.fileSlicePlan ?? '')?.[1];
+    const planOutsideRange = planBaseIndex && indexRange && !isInIndexRange(parseInt(planBaseIndex, 10), indexRange);
+    const filteredEntries = planOutsideRange
+        ? plan.entries
+        : plan.entries.filter((e) => isInIndexRange(e.index, indexRange));
+    for (const entry of filteredEntries) {
+        const matching = [...fileMap.entries()]
+            .filter(([f]) => f.startsWith(`${entry.index}-tasks.`) && f.endsWith('.md'))
+            .sort(([a], [b]) => a.localeCompare(b));
+        if (matching.length === 0)
+            continue;
+        const paths = matching.map(([f, dir]) => join(dir, f));
+        try {
+            const result = await parseTaskFile(paths);
+            summaries.push({
+                index: entry.index,
+                name: entry.name,
+                files: matching.map(([f]) => f),
+                completed: result.completedTasks,
+                total: result.totalTasks,
+                isActive: entry.index === activeIndex,
+            });
+        }
+        catch {
+            summaries.push({
+                index: entry.index,
+                name: entry.name,
+                files: matching.map(([f]) => f),
+                completed: 0,
+                total: 0,
+                isActive: entry.index === activeIndex,
+            });
+        }
+    }
+    if (json) {
+        printJson(summaries);
+        return;
+    }
+    console.log(label('\nTask Files'));
+    for (const s of summaries) {
+        const active = s.isActive ? success(' ← active') : '';
+        const progress = s.total > 0 ? dim(` (${s.completed}/${s.total})`) : dim(' (empty)');
+        const icon = s.total > 0 && s.completed === s.total ? success('  ✓ ') : dim('  ○ ');
+        console.log(icon + `${s.index} ${s.name}` + progress + active);
+    }
+}
+//# sourceMappingURL=task.js.map

package/dist/commands/task.js.map

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

package/dist/commands/update.d.ts

@@ -0,0 +1,27 @@
+import { Command } from 'commander';
+/**
+ * Compare two semver strings (major.minor.patch).
+ * Returns -1 if a < b, 0 if equal, 1 if a > b.
+ */
+export declare function compareSemver(a: string, b: string): number;
+/**
+ * Fetch the latest published version of a package from the npm registry.
+ * Returns null on any failure (network, non-200, malformed JSON).
+ */
+export declare function fetchLatestVersion(packageName: string): Promise<string | null>;
+/**
+ * Detect how cf was installed globally.
+ * Returns the package manager method and whether this is a local/dev install.
+ */
+export declare function detectInstallMethod(): {
+    method: 'npm' | 'pnpm' | 'unknown';
+    isLocal: boolean;
+};
+/**
+ * Run the global install command to update the CLI package.
+ * Uses execSync so the user sees output directly. Throws on failure.
+ */
+export declare function runUpdate(method: 'npm' | 'pnpm'): void;
+/** Register the `cf update` command. */
+export declare function registerUpdateCommand(program: Command): void;
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAU1D;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBpF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI;IAAE,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CA4B9F;AAcD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAKtD;AAED,wCAAwC;AACxC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4E5D"}

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