@jakkrichm/create-nexus-devflow 2.0.25 → 2.1.0

package/dist/bin/create-nexus-devflow.js

@@ -5,11 +5,25 @@ import readline from "node:readline/promises";
 import { fileURLToPath } from "node:url";
 import { openDashboard, startDashboardServer } from "../lib/dashboard.js";
 import { formatHumanStatus, readProjectStatus, shouldUseColor } from "../lib/status.js";
+import { addIdea, formatIdeasHuman, readIdeas } from "../lib/ideas.js";
+import { addFinding, formatFindingsHuman, readFindings, resolveFinding } from "../lib/findings.js";
+import { formatDoctorHuman, runDoctor } from "../lib/doctor.js";
+import { formatHistoryHuman, readHistory } from "../lib/history.js";
+import { evaluateGate, formatGateReport } from "../lib/gatekeeper.js";
+import { sliceContextForStage } from "../lib/context-slicer.js";
+import { detectGitDrift, reconcileState } from "../lib/drift-reconciler.js";
+import { renderStudioHtml } from "../lib/webview-studio.js";
+import { buildCodeGraph, calculateBlastRadius } from "../lib/code-graph.js";
+import { generateSwarmPlan } from "../lib/swarm-orchestrator.js";
+import { startMcpServer } from "../lib/mcp.js";
+import { installGitHook, uninstallGitHooks } from "../lib/git-hooks.js";
 import { createSpinner, createStyle } from "../lib/ui.js";
 import { applyPreparedUpdate, prepareUpdate } from "../lib/update.js";
 import { applyUninstall, prepareUninstall } from "../lib/uninstall.js";
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const packageRoot = path.resolve(__dirname, "..", "..");
+const packageRoot = fsSync.existsSync(path.join(__dirname, "..", "package.json"))
+    ? path.resolve(__dirname, "..")
+    : path.resolve(__dirname, "..", "..");
 const templateRoot = path.join(packageRoot, "template");
 const adapterChoices = new Set(["codex", "antigravity", "claude", "copilot", "both", "all"]);
 async function main(args = process.argv.slice(2)) {
@@ -23,6 +37,146 @@ async function main(args = process.argv.slice(2)) {
         return;
     }
     const targetDir = path.resolve(process.cwd(), options.target || ".");
+    if (options.deprecatedUi) {
+        console.warn("Warning: `ui` is deprecated; use `dashboard` instead.");
+    }
+    if (options.command === "mcp") {
+        startMcpServer(targetDir);
+        return;
+    }
+    if (options.command === "slice") {
+        const stage = options.sliceStage || "implement";
+        const sliceResult = await sliceContextForStage(targetDir, stage, { maxTokens: options.maxTokens });
+        if (options.json) {
+            console.log(JSON.stringify(sliceResult, null, 2));
+        }
+        else {
+            console.log(`[DevFlow JIT Context Slice - Stage: ${sliceResult.stage}]`);
+            console.log(`Estimated Tokens: ~${sliceResult.estimatedTokens} (Reduction: ~${sliceResult.reductionPercentage}%)\n`);
+            console.log(sliceResult.content);
+        }
+        return;
+    }
+    if (options.command === "drift") {
+        const drift = await detectGitDrift(targetDir);
+        if (options.json) {
+            console.log(JSON.stringify(drift, null, 2));
+        }
+        else {
+            const style = createStyle();
+            if (!drift.hasDrift && drift.phantomFiles.length === 0) {
+                console.log(style.green("✔ No Git drift detected. Living spec is in sync with repository files."));
+            }
+            else {
+                console.log(style.bold(style.yellow("Git Drift Detection Report:")));
+                if (drift.undocumentedFiles.length > 0) {
+                    console.log(style.red(`  - Undocumented modified files (${drift.undocumentedFiles.length}):`));
+                    for (const f of drift.undocumentedFiles) {
+                        console.log(`    ✖ ${f}`);
+                    }
+                }
+                if (drift.phantomFiles.length > 0) {
+                    console.log(style.yellow(`  - Phantom spec files (not modified in git) (${drift.phantomFiles.length}):`));
+                    for (const f of drift.phantomFiles) {
+                        console.log(`    ⚠ ${f}`);
+                    }
+                }
+                if (drift.stageDrift.isDrifted) {
+                    console.log(style.yellow(`  - Stage alignment drift: Active branch '${drift.stageDrift.activeBranch}' vs Stage ID '${drift.stageDrift.stageRunningId}'`));
+                }
+                console.log(`\nRun ${style.cyan("nexus-devflow reconcile --fix")} to auto-heal spec alignment.`);
+            }
+        }
+        return;
+    }
+    if (options.command === "reconcile") {
+        const result = await reconcileState(targetDir, {
+            autoAddUndocumented: options.fix,
+            healStage: options.fix
+        });
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            const style = createStyle();
+            if (result.reconciled) {
+                console.log(style.green(`✔ ${result.message}`));
+                if (result.addedFiles.length > 0) {
+                    for (const f of result.addedFiles) {
+                        console.log(style.dim(`  + Added to spec: ${f}`));
+                    }
+                }
+            }
+            else {
+                console.log(style.dim(result.message));
+            }
+        }
+        return;
+    }
+    if (options.command === "studio") {
+        const html = await renderStudioHtml(targetDir);
+        if (options.json) {
+            console.log(JSON.stringify({ html }, null, 2));
+        }
+        else {
+            console.log(html);
+        }
+        return;
+    }
+    if (options.command === "swarm") {
+        const plan = await generateSwarmPlan(targetDir);
+        if (options.json) {
+            console.log(JSON.stringify(plan, null, 2));
+        }
+        else {
+            const style = createStyle();
+            console.log(style.bold(style.cyan(`[Nexus-DevFlow Multi-Agent Swarm Matrix: ${plan.runId}]`)));
+            console.log(`Title: ${plan.title} (Strategy: ${plan.executionStrategy})\n`);
+            for (const t of plan.tasks) {
+                const roleIcon = t.role === "coder" ? "👨‍💻" : t.role === "qa" ? "🕵️" : t.role === "security" ? "🛡️" : "👑";
+                console.log(`  ${roleIcon} ${style.bold(t.id)}: ${t.title} [Role: ${t.role.toUpperCase()}]`);
+                console.log(style.dim(`     Context: ${t.requiredContext.join(", ")}`));
+                console.log(style.dim(`     Verify : ${t.verificationCriterion}`));
+            }
+        }
+        return;
+    }
+    if (options.command === "graph") {
+        const graph = await buildCodeGraph(targetDir);
+        if (options.graphFile) {
+            const blast = calculateBlastRadius(graph, options.graphFile);
+            if (options.json) {
+                console.log(JSON.stringify(blast, null, 2));
+            }
+            else {
+                const style = createStyle();
+                console.log(style.bold(style.cyan(`[Code Graph Blast Radius: ${blast.targetFile}]`)));
+                console.log(`Impact Score: ${blast.impactScore} | Total Affected: ${blast.totalAffected} files\n`);
+                if (blast.directDependents.length > 0) {
+                    console.log(style.bold("Direct Dependents:"));
+                    for (const d of blast.directDependents)
+                        console.log(`  - ${d}`);
+                }
+                if (blast.transitiveDependents.length > 0) {
+                    console.log(style.bold("Transitive Dependents:"));
+                    for (const t of blast.transitiveDependents)
+                        console.log(`  ~ ${t}`);
+                }
+            }
+        }
+        else {
+            if (options.json) {
+                console.log(JSON.stringify({ totalFiles: graph.totalFiles, totalEdges: graph.totalEdges, files: Object.keys(graph.nodes) }, null, 2));
+            }
+            else {
+                const style = createStyle();
+                console.log(style.bold(style.cyan("[Nexus-DevFlow Semantic Code Graph]")));
+                console.log(`Indexed Files: ${graph.totalFiles} | Total Dependency Edges: ${graph.totalEdges}`);
+                console.log(`\nRun ${style.yellow("nexus-devflow graph --file <path>")} to calculate Blast Radius.`);
+            }
+        }
+        return;
+    }
     if (options.command === "status") {
         const status = await readProjectStatus(targetDir);
         console.log(options.json
@@ -30,7 +184,163 @@ async function main(args = process.argv.slice(2)) {
             : formatHumanStatus(status, { color: shouldUseColor() }));
         return;
     }
-    if (options.command === "ui") {
+    if (options.command === "check-gate") {
+        const report = await evaluateGate(targetDir, {
+            strict: options.strict,
+            color: shouldUseColor()
+        });
+        if (options.json) {
+            console.log(JSON.stringify(report, null, 2));
+        }
+        else {
+            console.log(formatGateReport(report, { color: shouldUseColor() }));
+        }
+        if (!report.passed) {
+            process.exitCode = 1;
+        }
+        return;
+    }
+    if (options.command === "hook") {
+        if (options.subcommandAction === "uninstall") {
+            const result = await uninstallGitHooks(targetDir);
+            if (options.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                const style = createStyle(shouldUseColor());
+                console.log(`\n${style.green("✔")} ${style.bold(result.message)}`);
+            }
+            return;
+        }
+        // Default: install
+        const hookType = options.hookType || "pre-commit";
+        const result = await installGitHook(targetDir, hookType, { strict: options.strict });
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            const style = createStyle(shouldUseColor());
+            if (result.success) {
+                console.log(`\n${style.green("✔")} ${style.bold(result.message)}`);
+                console.log(`  ${style.dim("Hook:")} ${style.cyan(result.path)}`);
+            }
+            else {
+                console.error(`\n${style.red("✖")} ${style.bold(result.message)}`);
+                process.exitCode = 1;
+            }
+        }
+        return;
+    }
+    if (options.command === "idea" || options.command === "ideas") {
+        if (options.subcommandAction === "add") {
+            const text = options.subcommandArg || "";
+            if (!text.trim()) {
+                throw new Error("Idea text is required. Example: nexus-devflow idea add \"My idea\"");
+            }
+            const created = await addIdea(targetDir, {
+                text,
+                title: options.ideaTitle
+            });
+            if (options.json) {
+                console.log(JSON.stringify(created, null, 2));
+            }
+            else {
+                const style = createStyle(shouldUseColor());
+                console.log(`\n${style.green("✔")} ${style.bold("Idea added successfully!")}`);
+                console.log(`  ${style.dim("ID   :")} ${style.bold(style.cyan(created.id))}`);
+                console.log(`  ${style.dim("Title:")} ${style.bold(created.title)}`);
+                console.log(`  ${style.dim("Start:")} ${style.yellow(`/feature ${created.id}`)} or ${style.yellow(`/00-explore ${created.id}`)}`);
+            }
+            return;
+        }
+        const ideas = await readIdeas(targetDir);
+        console.log(options.json
+            ? JSON.stringify(ideas, null, 2)
+            : formatIdeasHuman(ideas, { color: shouldUseColor() }));
+        return;
+    }
+    if (options.command === "findings") {
+        if (options.subcommandAction === "add") {
+            const title = options.subcommandArg || "";
+            if (!title.trim()) {
+                throw new Error('Finding title is required. Example: nexus-devflow findings add "Hardcoded secret" --severity P0');
+            }
+            const result = await addFinding(targetDir, title, {
+                id: options.findingId,
+                severity: options.findingSeverity,
+                status: options.findingStatus,
+                location: options.findingLocation,
+                impact: options.findingImpact,
+                remediation: options.findingRemediation
+            });
+            if (options.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                const style = createStyle(shouldUseColor());
+                console.log(`\n${style.green("✔")} ${style.bold("Finding recorded successfully!")}`);
+                console.log(`  ${style.dim("ID      :")} ${style.bold(style.cyan(result.finding?.id || ""))}`);
+                const sev = result.finding?.severity || "P2";
+                const isBlocker = sev === "P0" || sev === "P1";
+                console.log(`  ${style.dim("Severity:")} ${style.bold(isBlocker ? style.red(`[${sev}]`) : style.yellow(`[${sev}]`))}`);
+                console.log(`  ${style.dim("Status  :")} ${style.yellow(result.finding?.status || "")}`);
+                console.log(`  ${style.dim("Title   :")} ${style.bold(result.finding?.title || "")}`);
+                console.log(`  ${style.dim("File    :")} ${style.dim(result.filePath)}`);
+            }
+            return;
+        }
+        if (options.subcommandAction === "resolve") {
+            const findingId = options.subcommandArg || "";
+            if (!findingId.trim()) {
+                throw new Error("Finding ID is required. Example: nexus-devflow findings resolve FIND-001");
+            }
+            const statusToSet = options.findingStatus || "closed";
+            const result = await resolveFinding(targetDir, findingId, statusToSet);
+            if (options.json) {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                const style = createStyle(shouldUseColor());
+                if (result.success) {
+                    console.log(`\n${style.green("✔")} ${style.bold(result.message)}`);
+                }
+                else {
+                    console.error(`\n${style.red("✖")} ${style.bold(result.message)}`);
+                    process.exitCode = 1;
+                }
+            }
+            return;
+        }
+        const findings = await readFindings(targetDir);
+        console.log(options.json
+            ? JSON.stringify(findings, null, 2)
+            : formatFindingsHuman(findings, {
+                blockersOnly: options.blockersOnly,
+                color: shouldUseColor()
+            }));
+        return;
+    }
+    if (options.command === "doctor") {
+        const report = await runDoctor(targetDir, {
+            fix: options.fix,
+            color: shouldUseColor()
+        });
+        console.log(options.json
+            ? JSON.stringify(report, null, 2)
+            : formatDoctorHuman(report, { color: shouldUseColor() }));
+        return;
+    }
+    if (options.command === "archive") {
+        const history = await readHistory(targetDir);
+        console.log(options.json
+            ? JSON.stringify(history, null, 2)
+            : formatHistoryHuman(history, {
+                statsOnly: options.statsOnly,
+                color: shouldUseColor()
+            }));
+        return;
+    }
+    if (options.command === "dashboard" || options.command === "ui") {
         const server = await startDashboardServer(targetDir);
         const style = createStyle();
         console.log(style.bold(style.cyan(`Nexus-DevFlow Dashboard live at ${server.url}`)));
@@ -137,6 +447,24 @@ async function main(args = process.argv.slice(2)) {
 }
 function parseArgs(args) {
     let command = "install";
+    let subcommandAction;
+    let subcommandArg;
+    let graphFile;
+    let sliceStage;
+    let maxTokens;
+    let hookType;
+    let ideaTitle;
+    let findingStatus;
+    let findingSeverity;
+    let findingId;
+    let findingLocation;
+    let findingImpact;
+    let findingRemediation;
+    let blockersOnly = false;
+    let fix = false;
+    let statsOnly = false;
+    let strict = false;
+    let deprecatedUi = false;
     let target = null;
     let adapter = "both";
     let force = false;
@@ -182,6 +510,137 @@ function parseArgs(args) {
             keepHistory = true;
             continue;
         }
+        if (arg === "--blockers") {
+            blockersOnly = true;
+            continue;
+        }
+        if (arg === "--file" && args[i + 1] && !args[i + 1].startsWith("-")) {
+            graphFile = args[i + 1];
+            i++;
+            continue;
+        }
+        if (arg === "--fix") {
+            fix = true;
+            continue;
+        }
+        if (arg === "--stats") {
+            statsOnly = true;
+            continue;
+        }
+        if (arg === "--strict") {
+            strict = true;
+            continue;
+        }
+        if (arg === "--title") {
+            const next = args[++i];
+            if (!next) {
+                throw new Error(`${arg} requires a title string`);
+            }
+            ideaTitle = next;
+            continue;
+        }
+        if (arg.startsWith("--title=")) {
+            ideaTitle = arg.slice("--title=".length);
+            continue;
+        }
+        if (arg === "--status") {
+            const next = args[++i];
+            if (!next) {
+                throw new Error(`${arg} requires a status string (e.g. closed, accepted, invalid)`);
+            }
+            findingStatus = next.toLowerCase();
+            continue;
+        }
+        if (arg.startsWith("--status=")) {
+            findingStatus = arg.slice("--status=".length).toLowerCase();
+            continue;
+        }
+        if (arg === "--severity" || arg === "-s") {
+            const next = args[++i];
+            if (!next) {
+                throw new Error(`${arg} requires a severity level (P0, P1, P2, P3)`);
+            }
+            const sev = next.toUpperCase();
+            if (sev !== "P0" && sev !== "P1" && sev !== "P2" && sev !== "P3") {
+                throw new Error(`Invalid severity "${next}". Expected one of: P0, P1, P2, P3`);
+            }
+            findingSeverity = sev;
+            continue;
+        }
+        if (arg.startsWith("--severity=")) {
+            const sev = arg.slice("--severity=".length).toUpperCase();
+            if (sev !== "P0" && sev !== "P1" && sev !== "P2" && sev !== "P3") {
+                throw new Error(`Invalid severity "${sev}". Expected one of: P0, P1, P2, P3`);
+            }
+            findingSeverity = sev;
+            continue;
+        }
+        if (arg === "--id") {
+            const next = args[++i];
+            if (!next)
+                throw new Error(`${arg} requires an ID string`);
+            findingId = next;
+            continue;
+        }
+        if (arg.startsWith("--id=")) {
+            findingId = arg.slice("--id=".length);
+            continue;
+        }
+        if (arg === "--location") {
+            const next = args[++i];
+            if (!next)
+                throw new Error(`${arg} requires a location string`);
+            findingLocation = next;
+            continue;
+        }
+        if (arg.startsWith("--location=")) {
+            findingLocation = arg.slice("--location=".length);
+            continue;
+        }
+        if (arg === "--impact") {
+            const next = args[++i];
+            if (!next)
+                throw new Error(`${arg} requires an impact string`);
+            findingImpact = next;
+            continue;
+        }
+        if (arg.startsWith("--impact=")) {
+            findingImpact = arg.slice("--impact=".length);
+            continue;
+        }
+        if (arg === "--remediation") {
+            const next = args[++i];
+            if (!next)
+                throw new Error(`${arg} requires a remediation string`);
+            findingRemediation = next;
+            continue;
+        }
+        if (arg.startsWith("--remediation=")) {
+            findingRemediation = arg.slice("--remediation=".length);
+            continue;
+        }
+        if (arg === "--stage") {
+            const next = args[++i];
+            if (!next)
+                throw new Error(`${arg} requires a stage name`);
+            sliceStage = next.toLowerCase();
+            continue;
+        }
+        if (arg.startsWith("--stage=")) {
+            sliceStage = arg.slice("--stage=".length).toLowerCase();
+            continue;
+        }
+        if (arg === "--max-tokens") {
+            const next = args[++i];
+            if (!next || isNaN(Number(next)))
+                throw new Error(`${arg} requires a number`);
+            maxTokens = Number(next);
+            continue;
+        }
+        if (arg.startsWith("--max-tokens=")) {
+            maxTokens = Number(arg.slice("--max-tokens=".length));
+            continue;
+        }
         if (arg === "--target" || arg === "-t") {
             const next = args[++i];
             if (!next) {
@@ -216,27 +675,164 @@ function parseArgs(args) {
         positional.push(arg);
     }
     if (positional.length > 0) {
-        if (positional[0] === "status") {
+        const first = positional[0].toLowerCase();
+        if (first === "status") {
             command = "status";
             target = positional[1] || target || ".";
         }
-        else if (positional[0] === "ui") {
-            command = "ui";
+        else if (first === "mcp") {
+            command = "mcp";
+            target = positional[1] || target || ".";
+        }
+        else if (first === "slice") {
+            command = "slice";
+            if (positional[1] && !positional[1].startsWith("-")) {
+                sliceStage = positional[1].toLowerCase();
+                target = positional[2] || target || ".";
+            }
+            else {
+                target = positional[1] || target || ".";
+            }
+        }
+        else if (first === "drift") {
+            command = "drift";
+            target = positional[1] || target || ".";
+        }
+        else if (first === "reconcile") {
+            command = "reconcile";
+            target = positional[1] || target || ".";
+        }
+        else if (first === "studio") {
+            command = "studio";
+            target = positional[1] || target || ".";
+        }
+        else if (first === "swarm") {
+            command = "swarm";
             target = positional[1] || target || ".";
         }
-        else if (positional[0] === "update") {
+        else if (first === "graph") {
+            command = "graph";
+            target = positional[1] || target || ".";
+        }
+        else if (first === "check-gate") {
+            command = "check-gate";
+            target = positional[1] || target || ".";
+        }
+        else if (first === "hook" || first === "hooks") {
+            command = "hook";
+            if (positional[1] === "uninstall") {
+                subcommandAction = "uninstall";
+                target = positional[2] || target || ".";
+            }
+            else if (positional[1] === "install") {
+                subcommandAction = "install";
+                if (positional[2] === "pre-commit" || positional[2] === "pre-push") {
+                    hookType = positional[2];
+                    target = positional[3] || target || ".";
+                }
+                else {
+                    target = positional[2] || target || ".";
+                }
+            }
+            else if (positional[1] === "pre-commit" || positional[1] === "pre-push") {
+                subcommandAction = "install";
+                hookType = positional[1];
+                target = positional[2] || target || ".";
+            }
+            else {
+                subcommandAction = "install";
+                target = positional[1] || target || ".";
+            }
+        }
+        else if (first === "dashboard") {
+            command = "dashboard";
+            target = positional[1] || target || ".";
+        }
+        else if (first === "ui") {
+            command = "dashboard";
+            deprecatedUi = true;
+            target = positional[1] || target || ".";
+        }
+        else if (first === "update") {
             command = "update";
             target = positional[1] || target || ".";
         }
-        else if (positional[0] === "uninstall") {
+        else if (first === "uninstall") {
             command = "uninstall";
             target = positional[1] || target || ".";
         }
-        else if (positional[0] === "eject") {
+        else if (first === "eject") {
             command = "eject";
             target = positional[1] || target || ".";
         }
-        else if (positional[0] === "install") {
+        else if (first === "idea" || first === "ideas") {
+            command = first === "idea" ? "idea" : "ideas";
+            if (positional[1] === "add") {
+                subcommandAction = "add";
+                subcommandArg = positional[2];
+                target = positional[3] || target || ".";
+            }
+            else if (positional[1] === "list") {
+                subcommandAction = "list";
+                target = positional[2] || target || ".";
+            }
+            else if (positional[1] && !positional[1].startsWith("-")) {
+                subcommandAction = "add";
+                subcommandArg = positional[1];
+                target = positional[2] || target || ".";
+            }
+            else {
+                subcommandAction = "list";
+                target = positional[1] || target || ".";
+            }
+        }
+        else if (first === "findings") {
+            command = "findings";
+            if (positional[1] === "add") {
+                subcommandAction = "add";
+                subcommandArg = positional[2];
+                target = positional[3] || target || ".";
+            }
+            else if (positional[1] === "resolve") {
+                subcommandAction = "resolve";
+                subcommandArg = positional[2];
+                target = positional[3] || target || ".";
+            }
+            else if (positional[1] === "list") {
+                subcommandAction = "list";
+                target = positional[2] || target || ".";
+            }
+            else if (positional[1] && !positional[1].startsWith("-")) {
+                subcommandAction = "add";
+                subcommandArg = positional[1];
+                target = positional[2] || target || ".";
+            }
+            else {
+                subcommandAction = "list";
+                target = positional[1] || target || ".";
+            }
+        }
+        else if (first === "doctor") {
+            command = "doctor";
+            target = positional[1] || target || ".";
+        }
+        else if (first === "archive") {
+            command = "archive";
+            if (positional[1] === "list") {
+                subcommandAction = "list";
+                target = positional[2] || target || ".";
+            }
+            else if (positional[1] === "stats") {
+                subcommandAction = "stats";
+                statsOnly = true;
+                target = positional[2] || target || ".";
+            }
+            else {
+                subcommandAction = "list";
+                target = positional[1] || target || ".";
+            }
+        }
+        else if (first === "install") {
             command = "install";
             target = positional[1] || target || ".";
         }
@@ -246,6 +842,24 @@ function parseArgs(args) {
     }
     return {
         command,
+        subcommandAction,
+        subcommandArg,
+        graphFile,
+        sliceStage,
+        maxTokens,
+        hookType,
+        ideaTitle,
+        findingStatus,
+        findingSeverity,
+        findingId,
+        findingLocation,
+        findingImpact,
+        findingRemediation,
+        blockersOnly,
+        fix,
+        statsOnly,
+        strict,
+        deprecatedUi,
         target,
         adapter,
         force,
@@ -282,18 +896,51 @@ ${style.bold(style.cyan("Nexus-DevFlow CLI"))} ${style.bold(`v${readPackageVersi
 ${style.bold("Usage:")}
   ${style.cyan("npx @jakkrichm/create-nexus-devflow")} [target-dir] [options]
   ${style.cyan("nexus-devflow status")} [target-dir] [options]
-  ${style.cyan("nexus-devflow ui")} [target-dir] [options]
+  ${style.cyan("nexus-devflow mcp")} [target-dir]
+  ${style.cyan("nexus-devflow slice")} [--stage <stage>] [--max-tokens <num>] [--json]
+  ${style.cyan("nexus-devflow drift")} [target-dir] [--json]
+  ${style.cyan("nexus-devflow reconcile")} [target-dir] [--fix] [--json]
+  ${style.cyan("nexus-devflow studio")} [target-dir] [--json]
+  ${style.cyan("nexus-devflow swarm")} [target-dir] [--json]
+  ${style.cyan("nexus-devflow graph")} [target-dir] [--file <path>] [--json]
+  ${style.cyan("nexus-devflow check-gate")} [--strict] [--json]
+  ${style.cyan("nexus-devflow hook install")} [pre-commit|pre-push]
+  ${style.cyan("nexus-devflow hook uninstall")}
+  ${style.cyan("nexus-devflow dashboard")} [target-dir] [options]
+  ${style.cyan("nexus-devflow idea")} add "<text>" [--title "<title>"]
+  ${style.cyan("nexus-devflow ideas")} [list] [--json]
+  ${style.cyan("nexus-devflow findings add")} "<title>" [--severity P0|P1|P2|P3] [--location <loc>]
+  ${style.cyan("nexus-devflow findings")} [list] [--blockers] [--json]
+  ${style.cyan("nexus-devflow findings resolve")} <ID> [--status <status>]
+  ${style.cyan("nexus-devflow doctor")} [--fix] [--json]
+  ${style.cyan("nexus-devflow archive")} [list|stats] [--json]
   ${style.cyan("nexus-devflow update")} [target-dir] [options]
   ${style.cyan("nexus-devflow uninstall")} [target-dir] [options]
   ${style.cyan("nexus-devflow eject")} [target-dir] [options]
 
 ${style.bold("Commands:")}
   ${style.brightCyan("status")}             Show project overview, progress, findings, git status, and next action
-  ${style.brightCyan("ui")}                 Run local interactive web dashboard for Nexus-DevFlow
+  ${style.brightCyan("mcp")}                Run Model Context Protocol (MCP) JSON-RPC Stdio Server for AI agents
+  ${style.brightCyan("slice")}              Generate JIT stage-aware context slice (reduces AI tokens by 60-70%)
+  ${style.brightCyan("check-gate")}         CI/CD quality gatekeeper check (returns exit code 0 or 1)
+  ${style.brightCyan("hook")}               Install or remove local Git pre-commit/pre-push gatekeeper hooks
+  ${style.brightCyan("dashboard")}          Run local interactive web dashboard for Nexus-DevFlow (alias: ui)
+  ${style.brightCyan("idea, ideas")}        Manage idea backlog: add new ideas or list pending ideas
+  ${style.brightCyan("findings")}           Inspect findings ledger, record new findings, filter blockers, or resolve
+  ${style.brightCyan("doctor")}             Inspect project workspace health and auto-heal missing files (--fix)
+  ${style.brightCyan("archive")}            Explore delivered runs and release statistics from devflow/history/
   ${style.brightCyan("update")}             Update existing DevFlow installation without overwriting user changes
   ${style.brightCyan("uninstall, eject")}   Completely remove DevFlow workflow files and adapters from project
 
 ${style.bold("Options:")}
+  ${style.cyan("--strict")}           Strict mode for check-gate (blocks unverified runs)
+  ${style.cyan("--title <text>")}     Custom title for idea add
+  ${style.cyan("--severity, -s")}     Finding severity: P0, P1, P2, P3 (default: P2)
+  ${style.cyan("--status <name>")}    Status to set when resolving finding (default: closed)
+  ${style.cyan("--location <path>")}  Finding source code file and line location
+  ${style.cyan("--blockers")}         Filter findings to only active P0/P1 blockers
+  ${style.cyan("--fix")}              Automatically repair/create missing context files in doctor
+  ${style.cyan("--stats")}            Display history summary statistics only
   ${style.cyan("--adapter <name>")}   Tool adapters to install: codex, antigravity, claude, copilot, both, all
   ${style.cyan("--no-open")}          Start local dashboard without opening a browser
   ${style.cyan("--keep-history")}     Keep devflow/history/ directory during uninstall