cool-workflow 0.1.86 → 0.1.88

package/dist/cli/command-surface.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -6,6 +39,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runCli = runCli;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const readline = __importStar(require("node:readline"));
 const orchestrator_1 = require("../orchestrator");
 const capability_core_1 = require("../capability-core");
 const observability_1 = require("../observability");
@@ -22,8 +57,38 @@ const multi_agent_eval_1 = require("../multi-agent-eval");
 const state_explosion_1 = require("../state-explosion");
 const evidence_reasoning_1 = require("../evidence-reasoning");
 const doctor_1 = require("../doctor");
+const orchestrator_2 = require("../orchestrator");
+const term_1 = require("../term");
+const version_1 = require("../version");
 async function runCli(argv = process.argv.slice(2)) {
     const args = (0, orchestrator_1.parseArgv)(argv);
+    // Top-level flags: accept --version / -v / --help / -h before command lookup.
+    if (args.command?.startsWith("-") || !args.command) {
+        if (args.command === "--version" || args.command === "-v" || args.options.v || args.options.version) {
+            process.stdout.write(`${version_1.CURRENT_COOL_WORKFLOW_VERSION}\n`);
+            return;
+        }
+        if (!args.command || args.command === "--help" || args.command === "-h" || args.options.h || args.options.help) {
+            process.stdout.write((0, orchestrator_1.formatHelp)());
+            return;
+        }
+    }
+    // Map vendor shorthand flags (-claude, -codex, -deepseek) to --agent-command.
+    if (args.options.claude)
+        args.options["agent-command"] = "builtin:claude";
+    if (args.options.codex)
+        args.options["agent-command"] = "builtin:codex";
+    if (args.options.deepseek)
+        args.options["agent-command"] = "builtin:deepseek";
+    // Bare -q / --question -> redirect to quickstart (auto-detect repo/agent/app).
+    if (args.command === "-q" || args.command === "--question") {
+        if (!args.options.question && args.positionals[0])
+            args.options.question = args.positionals[0];
+        args.command = "quickstart";
+    }
+    else if (!args.command && typeof args.options.question === "string") {
+        args.command = "quickstart";
+    }
     const runner = new orchestrator_1.CoolWorkflowRunner({
         pluginRoot: node_path_1.default.resolve(__dirname, "../..")
     });
@@ -34,13 +99,87 @@ async function runCli(argv = process.argv.slice(2)) {
         case undefined:
             process.stdout.write((0, orchestrator_1.formatHelp)());
             return;
+        case "version":
+            process.stdout.write(`${version_1.CURRENT_COOL_WORKFLOW_VERSION}\n`);
+            return;
+        case "update": {
+            process.stderr.write("Updating cool-workflow...\n");
+            const npm = (0, node_child_process_1.spawnSync)("npm", ["update", "-g", "cool-workflow"], { encoding: "utf8", stdio: "inherit" });
+            if (npm.status !== 0) {
+                process.stderr.write("Update failed, trying install...\n");
+                const install = (0, node_child_process_1.spawnSync)("npm", ["install", "-g", "cool-workflow@latest"], { encoding: "utf8", stdio: "inherit" });
+                if (install.status !== 0) {
+                    process.stderr.write("Install failed. Check npm and try again.\n");
+                    process.exitCode = 1;
+                }
+            }
+            return;
+        }
+        case "fix": {
+            const report = (0, doctor_1.runDoctor)(args.options, process.env, String(args.options.cwd || process.cwd()));
+            process.stdout.write(`${(0, doctor_1.formatDoctorFixes)(report)}\n`);
+            if (!report.ok)
+                process.exitCode = 1;
+            return;
+        }
         case "list":
             printJson(runner.listWorkflows());
             return;
+        case "search": {
+            const keyword = args.positionals.join(" ");
+            if (!keyword.trim())
+                throw new Error("Missing search keyword.\n  Tip: cw search architecture to find workflows about architecture.");
+            const apps = runner.listApps();
+            const lower = keyword.toLowerCase();
+            const results = apps.filter((a) => a.title.toLowerCase().includes(lower) || a.summary.toLowerCase().includes(lower) || a.id.toLowerCase().includes(lower)).map((a) => ({ id: a.id, title: a.title, summary: a.summary }));
+            if (wantsJson(args.options))
+                printJson(results);
+            else
+                process.stdout.write(`${(0, orchestrator_2.formatSearchResults)(keyword, results)}\n`);
+            return;
+        }
+        case "man": {
+            const [topic] = args.positionals;
+            if (!topic)
+                throw new Error("Missing topic.\n  Tip: cw man release-tooling for the release tooling manual.");
+            const docsDir = node_path_1.default.resolve(runner.pluginRoot, "docs");
+            const candidates = [
+                node_path_1.default.join(docsDir, `${topic}.7.md`),
+                node_path_1.default.join(docsDir, `${topic}.md`),
+                node_path_1.default.join(docsDir, `${topic}`)
+            ];
+            let found;
+            for (const c of candidates) {
+                try {
+                    if (node_fs_1.default.statSync(c).isFile()) {
+                        found = c;
+                        break;
+                    }
+                }
+                catch { /* keep looking */ }
+            }
+            if (!found)
+                throw new Error(`Man page not found: ${topic}.\n  Tip: cw list for workflow topics, or browse docs/ for manuals.`);
+            process.stdout.write(node_fs_1.default.readFileSync(found, "utf8"));
+            return;
+        }
+        case "info": {
+            const [appId] = args.positionals;
+            if (!appId)
+                throw new Error("Missing workflow app id.\n  Tip: list apps with \"cw list\", then \"cw info <id>\" for details");
+            const data = runner.showApp(appId);
+            if (wantsJson(args.options))
+                printJson(data);
+            else
+                process.stdout.write(`${(0, orchestrator_2.formatInfo)(appId, data)}\n`);
+            return;
+        }
         case "doctor": {
             const report = (0, doctor_1.runDoctor)(args.options, process.env, String(args.options.cwd || process.cwd()));
             if (wantsJson(args.options))
                 printJson(report);
+            else if (args.options.fix)
+                process.stdout.write(`${(0, doctor_1.formatDoctorFixes)(report)}\n`);
             else
                 process.stdout.write(`${(0, doctor_1.formatDoctorReport)(report)}\n`);
             if (!report.ok)
@@ -50,7 +189,7 @@ async function runCli(argv = process.argv.slice(2)) {
         case "init": {
             const [workflowId] = args.positionals;
             if (!workflowId)
-                throw new Error("Missing workflow id. Example: cw.js init my-workflow");
+                throw new Error("Missing workflow id.\n  Tip: create one with \"cw init my-workflow\" or list with \"cw list\"");
             printJson(runner.init(workflowId, args.options));
             return;
         }
@@ -91,8 +230,18 @@ async function runCli(argv = process.argv.slice(2)) {
             // fails closed (status=blocked) when none is set. No new executor/scheduler.
             const [appId] = args.positionals;
             const runId = optionalArg(args.options.run) || optionalArg(args.options.runId);
+            await promptQuestion(args.options);
             const qs = (0, capability_core_1.quickstart)(runner, { ...args.options, ...(appId ? { appId } : {}), ...(runId ? { runId } : {}) });
             printJson(qs);
+            const qr = qs;
+            if (typeof qr.runId === "string" && typeof qr.reportPath === "string") {
+                (0, term_1.printSuccessSummary)({
+                    runId: qr.runId,
+                    reportPath: qr.reportPath,
+                    status: String(qr.status || ""),
+                    bundle: Boolean(args.options.bundle)
+                });
+            }
             if (qs.mode === "check" && qs.ok === false) {
                 process.exitCode = 1;
             }
@@ -107,7 +256,7 @@ async function runCli(argv = process.argv.slice(2)) {
         case "plan": {
             const [workflowId] = args.positionals;
             if (!workflowId)
-                throw new Error("Missing workflow id. Example: cw.js plan architecture-review");
+                throw new Error("Missing workflow id.\n  Tip: plan an architecture review with \"cw plan architecture-review\"");
             printJson((0, capability_core_1.planSummary)(runner, workflowId, args.options));
             return;
         }
@@ -121,8 +270,10 @@ async function runCli(argv = process.argv.slice(2)) {
             }
             else if (wantsJson(args.options))
                 printJson(runner.status(args.positionals[0]));
-            else
-                process.stdout.write(`${(0, operator_ux_1.formatOperatorStatus)(runner.operatorStatus(args.positionals[0]))}\n`);
+            else {
+                const summary = runner.operatorStatus(args.positionals[0]);
+                process.stdout.write(`${(args.options.summary || args.options.brief ? (0, operator_ux_1.formatOperatorSummary)(summary) : (0, operator_ux_1.formatOperatorStatus)(summary))}\n`);
+            }
             return;
         case "next":
             printJson(runner.next(required(args.positionals[0], "run id"), args.options));
@@ -204,8 +355,10 @@ async function runCli(argv = process.argv.slice(2)) {
                 case "status":
                     if (wantsJson(args.options))
                         printJson(runner.operatorStatus(required(runId, "run id")));
-                    else
-                        process.stdout.write(`${(0, operator_ux_1.formatOperatorStatus)(runner.operatorStatus(required(runId, "run id")))}\n`);
+                    else {
+                        const summary = runner.operatorStatus(required(runId, "run id"));
+                        process.stdout.write(`${(args.options.summary || args.options.brief ? (0, operator_ux_1.formatOperatorSummary)(summary) : (0, operator_ux_1.formatOperatorStatus)(summary))}\n`);
+                    }
                     return;
                 case "report":
                     if (wantsJson(args.options))
@@ -1050,7 +1203,9 @@ async function runCli(argv = process.argv.slice(2)) {
                     driveArgs.runId = runId;
                 else
                     driveArgs.appId = target;
-                printJson((0, capability_core_1.runDrive)(runner, driveArgs));
+                const dr = (0, capability_core_1.runDrive)(runner, driveArgs);
+                printJson(dr);
+                (0, term_1.printSuccessSummary)({ runId: dr.runId, reportPath: dr.reportPath, status: dr.status });
                 return;
             }
             const registry = (0, capability_core_1.runRegistryFor)(args.options, runner);
@@ -1062,7 +1217,9 @@ async function runCli(argv = process.argv.slice(2)) {
                         const driveArgs = { ...args.options };
                         if (id)
                             driveArgs.runId = id;
-                        printJson((0, capability_core_1.runDrive)(runner, driveArgs));
+                        const dr = (0, capability_core_1.runDrive)(runner, driveArgs);
+                        printJson(dr);
+                        (0, term_1.printSuccessSummary)({ runId: dr.runId, reportPath: dr.reportPath, status: dr.status });
                         return;
                     }
                     printJson((0, capability_core_1.runDrivePreview)(runner, { ...args.options, runId: required(id, "run id") }));
@@ -1132,7 +1289,7 @@ async function runCli(argv = process.argv.slice(2)) {
                     return;
                 }
                 default:
-                    throw new Error("Usage: cw.js run search|list|show|resume|archive|rerun|drive|export|import|verify-import|inspect-archive [run-id|archive] [--scope repo|home] [--json]  |  cw.js run <app> --drive [--once] [--repo R --question Q]");
+                    throw new Error("Usage: cw.js run search|list|show|resume|archive|rerun|drive|export|import|verify-import|inspect-archive [run-id|archive] [--scope repo|home] [--json]  |  cw.js run <app> --drive [--once] [--incremental] [--repo R --question Q]");
             }
         }
         case "queue": {
@@ -1332,12 +1489,12 @@ async function runCli(argv = process.argv.slice(2)) {
             }
         }
         default:
-            throw new Error(`Unknown command: ${args.command}`);
+            throw new Error(`Unknown command: ${args.command}${((0, orchestrator_1.suggestCommand)(String(args.command || "")) ? `. Did you mean: ${(0, orchestrator_1.suggestCommand)(String(args.command))}?` : "")}`);
     }
 }
 function required(value, label) {
     if (!value)
-        throw new Error(`Missing ${label}. Run "cw.js help" for usage.`);
+        throw new Error(`Missing ${label}.\n  Tip: find run ids with "cw run list" or create one with "cw quickstart"`);
     return value;
 }
 function optionalArg(value) {
@@ -1349,6 +1506,20 @@ function printJson(value) {
 function wantsJson(options) {
     return Boolean(options.json || options.format === "json");
 }
+/** Prompt the user for a question interactively when --question is missing on a TTY. */
+async function promptQuestion(options) {
+    if (options.question || !process.stdin.isTTY)
+        return;
+    const rl = readline.createInterface({ input: process.stdin, output: process.stderr });
+    return new Promise((resolve) => {
+        rl.question("Question: ", (answer) => {
+            rl.close();
+            if (answer.trim())
+                options.question = answer.trim();
+            resolve();
+        });
+    });
+}
 function formatWorkbenchView(view) {
     const lines = [
         `Workbench view ${view.runId} (${view.resolved ? "resolved" : "UNRESOLVED"})`,

package/dist/cli.js

@@ -2,8 +2,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const command_surface_1 = require("./cli/command-surface");
+const term_1 = require("./term");
 (0, command_surface_1.runCli)(process.argv.slice(2)).catch((error) => {
     const message = error instanceof Error ? error.message : String(error);
-    process.stderr.write(`cw: ${message}\n`);
+    process.stderr.write(`${(0, term_1.bold)("cw:")} ${(0, term_1.red)(message)}\n`);
     process.exitCode = 1;
 });

package/dist/doctor.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runDoctor = runDoctor;
 exports.formatDoctorReport = formatDoctorReport;
+exports.formatDoctorFixes = formatDoctorFixes;
 // `cw doctor` — environment diagnostics, in the spirit of `brew doctor`.
 //
 // Homebrew's `doctor` turned "something is subtly wrong with your setup" into a
@@ -26,6 +27,7 @@ const node_path_1 = __importDefault(require("node:path"));
 const node_child_process_1 = require("node:child_process");
 const agent_config_1 = require("./agent-config");
 const onramp_1 = require("./onramp");
+const term_1 = require("./term");
 /** Resolve a bare binary name against $PATH (or accept an explicit path). Returns
  *  the resolved path, or undefined when not found. No spawning. */
 function whichBinary(bin, env) {
@@ -89,7 +91,15 @@ function runDoctor(args = {}, env = process.env, cwd = process.cwd()) {
         : { name: "node", status: "fail", detail: `Node ${process.version} is below the required v18.`, fix: "Install Node.js 18+ (e.g. `brew install node`, or https://nodejs.org)." });
     // 2. Agent backend — CW delegates execution; without one, real runs park.
     const cfg = (0, agent_config_1.resolveAgentConfig)(args, env);
-    if (cfg.source === "none") {
+    if (cfg.source === "auto") {
+        const vendor = (cfg.model && cfg.model.startsWith("builtin:")) ? cfg.model.slice("builtin:".length) : "auto";
+        checks.push({
+            name: "agent",
+            status: "ok",
+            detail: `Agent auto-detected: ${vendor}. Set CW_AGENT_COMMAND or --agent-command to override.`
+        });
+    }
+    else if (cfg.source === "none") {
         checks.push({
             name: "agent",
             status: "warn",
@@ -149,16 +159,21 @@ function runDoctor(args = {}, env = process.env, cwd = process.cwd()) {
 }
 /** Human rendering (TTY/default). `--json` callers use the report object directly. */
 function formatDoctorReport(report) {
-    const glyph = { ok: "✓", warn: "!", fail: "✗" };
-    const lines = ["cw doctor"];
+    const lines = [(0, term_1.bold)("cw doctor")];
     for (const check of report.checks) {
-        lines.push(`  ${glyph[check.status]} ${check.name}: ${check.detail}`);
+        lines.push(`  ${(0, term_1.doctorGlyph)(check.status)} ${check.name}: ${check.detail}`);
         if (check.fix && check.status !== "ok")
             lines.push(`      fix: ${check.fix}`);
     }
     lines.push("");
-    lines.push(`${report.ok ? "✓" : "✗"} ${report.summary}`);
+    const summaryGlyph = report.ok ? (0, term_1.green)("✓") : (0, term_1.red)("✗");
+    lines.push(`${summaryGlyph} ${report.summary}`);
     if (report.onramp) {
+        lines.push("");
+        lines.push("Quick start (3 steps):");
+        lines.push("  1. cw demo tamper        — prove trust checks work (30s)");
+        lines.push("  2. cw demo bundle         — prove portable bundles (30s)");
+        lines.push('  3. cw -q "what risks?"     — your first real report (needs an agent)');
         lines.push("");
         lines.push("Onramp");
         lines.push(`  ${report.onramp.summary}`);
@@ -187,3 +202,10 @@ function formatDoctorReport(report) {
     }
     return lines.join("\n");
 }
+/** `--fix` rendering: consolidates all fix strings into an actionable block. */
+function formatDoctorFixes(report) {
+    const fixes = report.checks.filter((c) => c.fix && c.status !== "ok").map((c) => c.fix);
+    if (!fixes.length)
+        return "No fixes needed.";
+    return [(0, term_1.bold)("Fix Commands"), ...fixes.map((f, i) => `  ${i + 1}. ${f}`), ""].join("\n");
+}