wispy-cli 2.7.4 → 2.7.6

package/bin/wispy-mjs

@@ -0,0 +1,3 @@
+case "ws":
+    if (args.length > 1 && !['start-client', 'run-debug'].includes(args[1])) {
+      console.error(`Error: Unrecognized option \${args[1]}`}

package/bin/wispy.mjs

@@ -1,60 +1,341 @@
 #!/usr/bin/env node
 
 /**
- * wispy-cli
- * Async refactored dispatcher avoids direct top-level awaits in Node modules.
+ * wispy-cli — main entry point
+ *
+ * Dispatches to the correct handler based on the first argument:
+ *   - Operator commands (setup, config, doctor, etc.) → operator CLI or inline handler
+ *   - Server commands → server manager
+ *   - Everything else → REPL (interactive chat)
+ *
+ * v2.7.x — rewired to properly route all commands.
  */
-(async () => {
-  const { fileURLToPath } = await import('url');
-  const { dirname } = await import('path');
-  const baseDir = dirname(fileURLToPath(import.meta.url));
-
-  const args = process.argv.slice(2);
-
-  async function handleCommand(command) {
-    const inquirer = (await import('inquirer')).default;
-
-    if (!command) {
-      let answers;
-      try {
-        answers = await inquirer.prompt([
-          {
-            type: 'list',
-            name: 'selectedCommand',
-            message: 'What would you like to do?',
-            choices: [
-              { name: 'Run WebSocket command', value: 'ws' },
-              { name: 'Get help', value: 'help' },
-              { name: 'Exit', value: null }
-            ],
-          }
-        ]);
-      } catch (error) {
-        if (error.isTtyError) {
-          console.error("Prompt couldn't be rendered in the current environment.");
-        } else {
-          console.log("Prompt closed by the user. Exiting gracefully.");
+
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { readFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const rootDir = join(__dirname, "..");
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+// ── Flags ─────────────────────────────────────────────────────────────────────
+
+if (args.includes("--version") || command === "--version" || command === "-v") {
+  try {
+    const pkg = JSON.parse(await readFile(join(rootDir, "package.json"), "utf8"));
+    console.log(`wispy-cli v${pkg.version}`);
+  } catch {
+    console.error("Failed to read version from package.json");
+  }
+  process.exit(0);
+}
+
+if (args.includes("--help") || command === "--help" || command === "-h" || command === "help") {
+  const pkg = JSON.parse(await readFile(join(rootDir, "package.json"), "utf8"));
+  console.log(`
+wispy-cli v${pkg.version}
+AI workspace assistant — chat, automate, and orchestrate from the terminal.
+
+Usage:
+  wispy                        Start interactive REPL
+  wispy <message>              One-shot chat
+  wispy setup                  Run first-time setup wizard
+  wispy config [show|get|set|delete|reset|path|edit]
+                               Manage configuration
+  wispy model                  Show or change AI model
+  wispy doctor                 Check system health
+  wispy trust [level|log]      Security level & audit
+  wispy ws [start-client|run-debug]
+                               WebSocket operations
+  wispy skill [list|run]       Manage learned skills
+  wispy teach <name>           Create skill from conversation
+  wispy improve <name>         Improve a skill
+  wispy where                  Show current mode (local/cloud)
+  wispy handoff [cloud|local]  Sync between environments
+  wispy server [start|stop|status]
+                               Manage HTTP/WS server
+  wispy tui                    Launch full terminal UI
+  wispy overview               Director view of workstreams
+
+Options:
+  -w, --workstream <name>      Set active workstream
+  --session <id>               Resume a session
+  --model <name>               Override AI model
+  --provider <name>            Override AI provider
+  --help, -h                   Show this help
+  --version, -v                Show version
+`);
+  process.exit(0);
+}
+
+// ── Setup (first-run wizard) ──────────────────────────────────────────────────
+
+if (command === "setup") {
+  try {
+    const { OnboardingWizard } = await import(join(rootDir, "core/onboarding.mjs"));
+    const wizard = new OnboardingWizard();
+    await wizard.run();
+  } catch (err) {
+    console.error("Setup failed:", err.message);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+// ── Config ────────────────────────────────────────────────────────────────────
+
+if (command === "config") {
+  try {
+    const { loadConfig, saveConfig, WISPY_DIR, CONFIG_PATH } = await import(join(rootDir, "core/config.mjs"));
+    const sub = args[1];
+    const config = await loadConfig();
+
+    if (!sub || sub === "show") {
+      console.log(JSON.stringify(config, null, 2));
+    } else if (sub === "path") {
+      console.log(CONFIG_PATH);
+    } else if (sub === "get") {
+      const key = args[2];
+      if (!key) { console.error("Usage: wispy config get <key>"); process.exit(1); }
+      console.log(config[key] !== undefined ? JSON.stringify(config[key], null, 2) : `Key '${key}' not found`);
+    } else if (sub === "set") {
+      const key = args[2], value = args[3];
+      if (!key || value === undefined) { console.error("Usage: wispy config set <key> <value>"); process.exit(1); }
+      try { config[key] = JSON.parse(value); } catch { config[key] = value; }
+      await saveConfig(config);
+      console.log(`Set ${key} = ${JSON.stringify(config[key])}`);
+    } else if (sub === "delete") {
+      const key = args[2];
+      if (!key) { console.error("Usage: wispy config delete <key>"); process.exit(1); }
+      delete config[key];
+      await saveConfig(config);
+      console.log(`Deleted '${key}'`);
+    } else if (sub === "reset") {
+      const { confirm } = await import("@inquirer/prompts");
+      const yes = await confirm({ message: "Reset all config to defaults?", default: false });
+      if (yes) { await saveConfig({}); console.log("Config reset to defaults."); }
+    } else if (sub === "edit") {
+      const editor = process.env.EDITOR || "nano";
+      const { execSync } = await import("node:child_process");
+      execSync(`${editor} "${CONFIG_PATH}"`, { stdio: "inherit" });
+    } else {
+      console.error(`Unknown config subcommand: ${sub}`);
+      console.log("Available: show, get, set, delete, reset, path, edit");
+      process.exit(1);
+    }
+  } catch (err) {
+    console.error("Config error:", err.message);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+// ── Doctor ────────────────────────────────────────────────────────────────────
+
+if (command === "doctor") {
+  try {
+    const { loadConfig, detectProvider, WISPY_DIR } = await import(join(rootDir, "core/config.mjs"));
+    const config = await loadConfig();
+    const provider = await detectProvider();
+    const pkg = JSON.parse(await readFile(join(rootDir, "package.json"), "utf8"));
+
+    console.log(`\n  wispy-cli v${pkg.version}`);
+    console.log(`  Config dir:  ${WISPY_DIR}`);
+    console.log(`  Provider:    ${provider?.provider ?? "none"}`);
+    console.log(`  Model:       ${provider?.model ?? "none"}`);
+    console.log(`  API key:     ${provider?.key ? "✓ set" : "✗ missing"}`);
+
+    // Check optional components
+    const checks = [
+      { name: "Config file", ok: existsSync(join(WISPY_DIR, "config.json")) },
+      { name: "Memory dir", ok: existsSync(join(WISPY_DIR, "memory")) },
+      { name: "Sessions dir", ok: existsSync(join(WISPY_DIR, "sessions")) },
+      { name: "MCP config", ok: existsSync(join(WISPY_DIR, "mcp.json")) },
+    ];
+    console.log("");
+    for (const c of checks) {
+      console.log(`  ${c.ok ? "✓" : "✗"} ${c.name}`);
+    }
+    console.log("");
+
+    if (!provider?.key) {
+      console.log("  Run 'wispy setup' to configure an API key.\n");
+    } else {
+      console.log("  All good!\n");
+    }
+  } catch (err) {
+    console.error("Doctor error:", err.message);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+// ── Trust ─────────────────────────────────────────────────────────────────────
+
+if (command === "trust") {
+  try {
+    const { handleTrustCommand } = await import(join(rootDir, "lib/commands/trust.mjs"));
+    await handleTrustCommand(args.slice(1));
+  } catch (err) {
+    console.error("Trust command error:", err.message);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+// ── WebSocket ─────────────────────────────────────────────────────────────────
+
+if (command === "ws") {
+  try {
+    const { handleWsCommand } = await import(join(rootDir, "lib/commands/ws.mjs"));
+    await handleWsCommand(args);
+  } catch (err) {
+    console.error("WS command error:", err.message);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+// ── Skills ────────────────────────────────────────────────────────────────────
+
+if (command === "skill" || command === "skills") {
+  try {
+    const { handleSkillCommand } = await import(join(rootDir, "lib/commands/skills-cmd.mjs"));
+    await handleSkillCommand(args.slice(1));
+  } catch (err) {
+    console.error("Skill command error:", err.message);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+if (command === "teach") {
+  try {
+    const { cmdTeach } = await import(join(rootDir, "lib/commands/skills-cmd.mjs"));
+    await cmdTeach(args[1]);
+  } catch (err) {
+    console.error("Teach error:", err.message);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+if (command === "improve") {
+  try {
+    const { cmdImproveSkill } = await import(join(rootDir, "lib/commands/skills-cmd.mjs"));
+    await cmdImproveSkill(args[1], args.slice(2).join(" "));
+  } catch (err) {
+    console.error("Improve error:", err.message);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+// ── Continuity ────────────────────────────────────────────────────────────────
+
+if (command === "where") {
+  try {
+    const { cmdWhere } = await import(join(rootDir, "lib/commands/continuity.mjs"));
+    await cmdWhere();
+  } catch (err) {
+    console.error("Where error:", err.message);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+if (command === "handoff") {
+  try {
+    const { handleContinuityCommand } = await import(join(rootDir, "lib/commands/continuity.mjs"));
+    await handleContinuityCommand(args.slice(1));
+  } catch (err) {
+    console.error("Handoff error:", err.message);
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+// ── Model ─────────────────────────────────────────────────────────────────────
+
+if (command === "model") {
+  try {
+    const { loadConfig, saveConfig, detectProvider, PROVIDERS } = await import(join(rootDir, "core/config.mjs"));
+    const config = await loadConfig();
+    const detected = await detectProvider();
+
+    if (args[1]) {
+      config.model = args[1];
+      await saveConfig(config);
+      console.log(`Model set to: ${args[1]}`);
+    } else {
+      console.log(`\n  Provider: ${detected?.provider ?? "none"}`);
+      console.log(`  Model:    ${detected?.model ?? "none"}`);
+      console.log(`\n  Override: wispy model <model-name>`);
+      console.log(`  Env var:  WISPY_MODEL=<model-name>`);
+
+      if (PROVIDERS) {
+        console.log(`\n  Available providers:`);
+        for (const [key, p] of Object.entries(PROVIDERS)) {
+          console.log(`    ${key.padEnd(14)} ${p.defaultModel}`);
         }
-        process.exit(0);
       }
-      command = answers.selectedCommand;
+      console.log("");
     }
+  } catch (err) {
+    console.error("Model error:", err.message);
+    process.exit(1);
+  }
+  process.exit(0);
+}
 
-    switch (command) {
-      case "ws":
-        const { handleWsCommand } = await import(baseDir + '/../lib/commands/ws.mjs');
-        return await handleWsCommand(args);
-      case "help":
-        console.log(`\nWispy CLI Help:\n\nCommands:\n  ws   - Run WebSocket command (e.g., 'node bin/wispy.mjs ws')\n  help - Show this help message (e.g., 'node bin/wispy.mjs --help')\n\nExamples:\n  $ node bin/wispy.mjs ws\n  $ node bin/wispy.mjs --help\n\nTip: Run 'node bin/wispy.mjs' with no arguments for an interactive prompt.\n`);
-        break;
-      case null:
-        console.log("Goodbye!");
-        break;
-      default:
-        console.error(`Unknown command: ${command}`);
-        console.log("Try one of the available commands: ws, help");
-    }
+// ── TUI ───────────────────────────────────────────────────────────────────────
+
+if (command === "tui") {
+  try {
+    await import(join(rootDir, "bin/wispy-tui.mjs"));
+  } catch (err) {
+    console.error("TUI launch error:", err.message);
+    process.exit(1);
   }
+  // TUI handles its own lifecycle
+}
 
-  await handleCommand(args[0] === '--help' ? 'help' : args[0]);
-})();
+// ── Overview ──────────────────────────────────────────────────────────────────
+
+if (command === "overview") {
+  // Delegate to REPL with overview flag
+  process.env.WISPY_OVERVIEW = "1";
+}
+
+// ── Server ────────────────────────────────────────────────────────────────────
+
+if (command === "server") {
+  // Delegate to REPL which has server handling built in
+  // (lib/wispy-repl.mjs handles server start/stop/status)
+}
+
+// ── Default: launch REPL ──────────────────────────────────────────────────────
+// For no args, one-shot messages, or unrecognized commands that the REPL handles
+
+if (command === "server" || command === "overview") {
+  // Already set up env flags above, fall through to REPL
+}
+
+// If we get here and it's not a recognized command above, go to REPL
+// The REPL handles: interactive chat, one-shot "wispy <message>", server, overview
+try {
+  await import(join(rootDir, "lib/wispy-repl.mjs"));
+} catch (err) {
+  if (err.code === "ERR_MODULE_NOT_FOUND") {
+    console.error(`Module not found: ${err.message}`);
+    console.error("Try running: npm install");
+  } else {
+    console.error("Failed to start wispy:", err.message);
+  }
+  process.exit(1);
+}

package/lib/commands/ws.mjs

@@ -1,32 +1,41 @@
 import { select } from '@inquirer/prompts';
 
-export async function handleWsCommand() {
-  try {
-    const action = await select({
-      message: 'What WebSocket action would you like to perform?',
-      choices: [
-        { name: 'Start WebSocket Client', value: 'startClient' },
-        { name: 'Run WebSocket Server Debug Mode', value: 'runServerDebug' },
-        { name: 'Exit', value: 'exit' }
-      ]
-    });
+export async function handleWsCommand(args = []) {
+    try {
+        if (args.length > 0 && !['startClient', 'runServerDebug'].includes(args[0])) {
+            console.error(`\nError: Invalid WebSocket subcommand '${args[0]}'.\n`);
+            console.log('Available subcommands:');
+            console.log('  startClient       Start WebSocket Client');
+            console.log('  runServerDebug    Run WebSocket Server Debug Mode');
+            console.log('\nTip: Use no arguments to enter interactive mode.\n');
+            return;
+        }
 
-    switch (action) {
-      case 'startClient':
-        console.log('Starting WebSocket client...');
-        break;
-      case 'runServerDebug':
-        console.log('Running server in debug mode...');
-        break;
-      case 'exit':
-        console.log('Exiting WebSocket command.');
-        return;
-    }
-  } catch (err) {
-    if (err.name === 'ExitPromptError') {
-      console.log('Prompt closed. Exiting command gracefully.');
-    } else {
-      console.error('Unexpected error:', err);
+        const action = args[0] || await select({
+            message: 'What WebSocket action would you like to perform?',
+            choices: [
+                { name: 'Start WebSocket Client', value: 'startClient' },
+                { name: 'Run WebSocket Server Debug Mode', value: 'runServerDebug' },
+                { name: 'Exit', value: 'exit' }
+            ]
+        });
+
+        switch (action) {
+            case 'startClient':
+                console.log('Starting WebSocket client...');
+                break;
+            case 'runServerDebug':
+                console.log('Running server in debug mode...');
+                break;
+            case 'exit':
+                console.log('Exiting WebSocket command.');
+                return;
+        }
+    } catch (err) {
+        if (err.name === 'ExitPromptError') {
+            console.log('Prompt closed. Exiting command gracefully.');
+        } else {
+            console.error('Unexpected error:', err);
+        }
     }
-  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wispy-cli",
-  "version": "2.7.4",
+  "version": "2.7.6",
   "description": "🌿 Wispy — AI workspace assistant with trustworthy execution (harness, receipts, approvals, diffs)",
   "license": "MIT",
   "author": "Minseo & Poropo",