swagmanager-mcp 3.1.0 → 5.0.0

package/bin/swagmanager-mcp.js

@@ -4,21 +4,85 @@
  * whale code — local-first AI agent CLI
  *
  * Usage:
- *   whale              — Start chat (default, interactive terminal)
- *   whale login        — Log in with SwagManager credentials
- *   whale logout       — Clear saved session
- *   whale status       — Show connection status
- *   whale help         — Show this help
- *   (non-TTY stdin)    — MCP stdio server for Claude Code / Cursor
+ *   whale                        Start interactive chat
+ *   whale -p "prompt"            Non-interactive (print) mode
+ *   whale login                  Log in with SwagManager credentials
+ *   whale logout                 Clear saved session
+ *   whale status                 Show connection status
+ *   whale mcp list|add|remove    Manage MCP servers
+ *   whale doctor                 Run diagnostics
+ *   whale config [key] [value]   View/set configuration
+ *   whale help                   Show this help
+ *   (non-TTY stdin)              MCP stdio server for Claude Code / Cursor
  */
 
 import { fileURLToPath } from "url";
 import { dirname, join } from "path";
+import { readFileSync } from "fs";
+import { parseArgs } from "util";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
+const distDir = join(__dirname, "..", "dist");
 
-const command = process.argv[2];
+// Read version once — used for --version, help banner, etc.
+let PKG_VERSION = "0.0.0";
+try {
+  PKG_VERSION = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8")).version;
+} catch { /* fallback */ }
+
+// ── Parse CLI flags ──
+let parsed;
+try {
+  parsed = parseArgs({
+    allowPositionals: true,
+    strict: false,
+    options: {
+      // Print / headless mode
+      print:                  { type: "boolean", short: "p" },
+      "output-format":        { type: "string" },
+      // Model & mode
+      model:                  { type: "string", short: "m" },
+      "permission-mode":      { type: "string" },
+      // Session
+      resume:                 { type: "string", short: "r" },
+      continue:               { type: "boolean", short: "c" },
+      "session-id":           { type: "string" },
+      "no-session-persistence": { type: "boolean" },
+      // Limits
+      "max-turns":            { type: "string" },
+      "max-budget-usd":       { type: "string" },
+      effort:                 { type: "string" },
+      // Tool filtering
+      "allowed-tools":        { type: "string" },
+      "disallowed-tools":     { type: "string" },
+      // Fallback
+      "fallback-model":       { type: "string" },
+      // Serve mode
+      port:                   { type: "string" },
+      host:                   { type: "string" },
+      // Debug / verbose
+      debug:                  { type: "boolean" },
+      verbose:                { type: "boolean", short: "v" },
+      // Standard
+      help:                   { type: "boolean", short: "h" },
+      version:                { type: "boolean" },
+    },
+  });
+} catch (err) {
+  console.error(`Error: ${err.message}`);
+  console.error("Run 'whale help' for usage.");
+  process.exit(1);
+}
+
+const { values: flags, positionals } = parsed;
+
+// First positional is the subcommand (unless --print is used)
+const subcommand = positionals[0];
+// If --print, remaining positionals form the message
+const printMessage = flags.print
+  ? positionals.join(" ")
+  : undefined;
 
 // ── Help ──
 function showHelp() {
@@ -31,18 +95,45 @@ function showHelp() {
   console.log();
   console.log(`  ${g}╭──────────────────────────────────────────╮${r}`);
   console.log(`  ${g}│${r}                                          ${g}│${r}`);
-  console.log(`  ${g}│${r}   ${c}${B}◆ whale code${r}  ${d}v3.0.0${r}                    ${g}│${r}`);
+  console.log(`  ${g}│${r}   ${c}${B}◆ whale code${r}  ${d}v${PKG_VERSION}${r}                    ${g}│${r}`);
   console.log(`  ${g}│${r}   ${d}local-first AI agent CLI${r}               ${g}│${r}`);
   console.log(`  ${g}│${r}                                          ${g}│${r}`);
   console.log(`  ${g}╰──────────────────────────────────────────╯${r}`);
   console.log();
   console.log(`  ${B}Commands:${r}`);
-  console.log(`    whale${d}             Start chatting (default)${r}`);
-  console.log(`    whale login${d}       Log in to SwagManager${r}`);
-  console.log(`    whale logout${d}      Clear session${r}`);
-  console.log(`    whale stores${d}      Switch active store${r}`);
-  console.log(`    whale status${d}      Connection & tools${r}`);
-  console.log(`    whale setup${d}       Install MCP to IDEs${r}`);
+  console.log(`    whale${d}                  Start chatting (default)${r}`);
+  console.log(`    whale login${d}            Log in to SwagManager${r}`);
+  console.log(`    whale logout${d}           Clear session${r}`);
+  console.log(`    whale stores${d}           Switch active store${r}`);
+  console.log(`    whale status${d}           Connection & tools${r}`);
+  console.log(`    whale setup${d}            Install MCP to IDEs${r}`);
+  console.log(`    whale mcp${d}              Manage MCP servers${r}`);
+  console.log(`    whale doctor${d}           Run diagnostics${r}`);
+  console.log(`    whale init${d}             Generate .whale/CLAUDE.md for project${r}`);
+  console.log(`    whale config${d}           View/set configuration${r}`);
+  console.log(`    whale serve${d}            Local agent WebSocket server${r}`);
+  console.log();
+  console.log(`  ${B}Print Mode (non-interactive):${r}`);
+  console.log(`    whale -p "prompt"${d}      Run single prompt, output to stdout${r}`);
+  console.log(`    echo "prompt" | whale -p${d}  Read prompt from stdin${r}`);
+  console.log();
+  console.log(`  ${B}Flags:${r}`);
+  console.log(`    -p, --print${d}                 Non-interactive mode${r}`);
+  console.log(`    --output-format <fmt>${d}       text|json|stream-json (default: text)${r}`);
+  console.log(`    -m, --model <name>${d}          sonnet|opus|haiku${r}`);
+  console.log(`    --permission-mode <mode>${d}    default|plan|yolo${r}`);
+  console.log(`    -r, --resume <id>${d}           Resume session by ID${r}`);
+  console.log(`    -c, --continue${d}              Continue most recent session${r}`);
+  console.log(`    --session-id <id>${d}           Custom session UUID${r}`);
+  console.log(`    --no-session-persistence${d}    Ephemeral session${r}`);
+  console.log(`    --max-turns <n>${d}             Limit agent turns${r}`);
+  console.log(`    --max-budget-usd <n>${d}        Cost cap in USD${r}`);
+  console.log(`    --effort <level>${d}            low|medium|high${r}`);
+  console.log(`    --allowed-tools <list>${d}      Comma-separated tool whitelist${r}`);
+  console.log(`    --disallowed-tools <list>${d}   Comma-separated tool blacklist${r}`);
+  console.log(`    --fallback-model <name>${d}     Auto-fallback on overload${r}`);
+  console.log(`    --debug${d}                     Debug logging to stderr${r}`);
+  console.log(`    -v, --verbose${d}               Extra output${r}`);
   console.log();
   console.log(`  ${B}In chat:${r}`);
   console.log(`    ${d}Type ${r}/${d} to open command menu${r}`);
@@ -50,7 +141,70 @@ function showHelp() {
   console.log();
 }
 
-// ── Route ──
+// Build options object from flags
+function buildOptions() {
+  return {
+    model: flags.model,
+    permissionMode: flags["permission-mode"],
+    resumeSessionId: flags.resume,
+    continueLastSession: flags.continue,
+    sessionId: flags["session-id"],
+    noSessionPersistence: flags["no-session-persistence"],
+    maxTurns: flags["max-turns"] ? parseInt(flags["max-turns"], 10) : undefined,
+    maxBudgetUsd: flags["max-budget-usd"] ? parseFloat(flags["max-budget-usd"]) : undefined,
+    effort: flags.effort,
+    allowedTools: flags["allowed-tools"]?.split(",").map(s => s.trim()),
+    disallowedTools: flags["disallowed-tools"]?.split(",").map(s => s.trim()),
+    fallbackModel: flags["fallback-model"],
+    debug: flags.debug,
+    verbose: flags.verbose,
+  };
+}
+
+// ── Version ──
+if (flags.version) {
+  console.log(PKG_VERSION);
+  process.exit(0);
+}
+
+// ── Help ──
+if (flags.help && !subcommand) {
+  showHelp();
+  process.exit(0);
+}
+
+// ── Print mode ──
+if (flags.print) {
+  const { runPrintMode } = await import(join(distDir, "cli", "print-mode.js"));
+  const options = buildOptions();
+
+  // Read stdin if available (non-TTY)
+  let stdinContent = "";
+  if (!process.stdin.isTTY) {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+      chunks.push(chunk);
+    }
+    stdinContent = Buffer.concat(chunks).toString("utf-8").trim();
+  }
+
+  // Combine stdin + positional message
+  const message = [stdinContent, printMessage].filter(Boolean).join("\n\n");
+  if (!message) {
+    console.error("Error: --print requires a message. Provide as argument or via stdin.");
+    process.exit(1);
+  }
+
+  const exitCode = await runPrintMode({
+    message,
+    outputFormat: flags["output-format"] || "text",
+    ...options,
+  });
+  process.exit(exitCode);
+}
+
+// ── Route subcommands ──
+const command = subcommand;
 switch (command) {
   case "help":
   case "--help":
@@ -63,13 +217,13 @@ switch (command) {
       console.error("Error: whale login requires an interactive terminal.");
       process.exit(1);
     }
-    const { renderLogin } = await import(join(__dirname, "..", "dist", "cli", "app.js"));
+    const { renderLogin } = await import(join(distDir, "cli", "app.js"));
     await renderLogin();
     break;
   }
 
   case "logout": {
-    const { renderLogout } = await import(join(__dirname, "..", "dist", "cli", "app.js"));
+    const { renderLogout } = await import(join(distDir, "cli", "app.js"));
     await renderLogout();
     break;
   }
@@ -77,20 +231,20 @@ switch (command) {
   case "chat":
   case undefined: {
     if (process.stdin.isTTY) {
-      const { renderChat } = await import(join(__dirname, "..", "dist", "cli", "app.js"));
-      await renderChat();
+      const { renderChat } = await import(join(distDir, "cli", "app.js"));
+      await renderChat(buildOptions());
     } else if (command === "chat") {
       console.error("Error: whale chat requires an interactive terminal.");
       process.exit(1);
     } else {
       // Non-TTY, no command → MCP stdio server
-      await import(join(__dirname, "..", "dist", "index.js"));
+      await import(join(distDir, "index.js"));
     }
     break;
   }
 
   case "status": {
-    const { renderStatus } = await import(join(__dirname, "..", "dist", "cli", "app.js"));
+    const { renderStatus } = await import(join(distDir, "cli", "app.js"));
     await renderStatus();
     break;
   }
@@ -100,7 +254,7 @@ switch (command) {
       console.error("Error: whale setup requires an interactive terminal.");
       process.exit(1);
     }
-    const { renderSetup } = await import(join(__dirname, "..", "dist", "cli", "app.js"));
+    const { renderSetup } = await import(join(distDir, "cli", "app.js"));
     await renderSetup();
     break;
   }
@@ -111,11 +265,45 @@ switch (command) {
       console.error("Error: whale stores requires an interactive terminal.");
       process.exit(1);
     }
-    const { renderStores } = await import(join(__dirname, "..", "dist", "cli", "app.js"));
+    const { renderStores } = await import(join(distDir, "cli", "app.js"));
     await renderStores();
     break;
   }
 
+  case "mcp": {
+    const { runMcpCommand } = await import(join(distDir, "cli", "commands", "mcp.js"));
+    await runMcpCommand(positionals.slice(1));
+    break;
+  }
+
+  case "doctor": {
+    const { runDoctor } = await import(join(distDir, "cli", "commands", "doctor.js"));
+    await runDoctor();
+    break;
+  }
+
+  case "config": {
+    const { runConfigCommand } = await import(join(distDir, "cli", "commands", "config-cmd.js"));
+    await runConfigCommand(positionals.slice(1), flags);
+    break;
+  }
+
+  case "init": {
+    const { runInit } = await import(join(distDir, "cli", "commands", "init.js"));
+    await runInit();
+    break;
+  }
+
+  case "serve": {
+    const { runServeMode } = await import(join(distDir, "cli", "serve-mode.js"));
+    await runServeMode({
+      port: flags.port ? parseInt(flags.port, 10) : 3847,
+      host: flags.host || "127.0.0.1",
+      ...buildOptions(),
+    });
+    break;
+  }
+
   default:
     console.error(`Unknown command: ${command}`);
     console.error(`Run 'whale help' for usage.`);

package/dist/cli/app.d.ts

@@ -3,9 +3,24 @@
  *
  * Dynamic imports for each mode — keeps MCP server path clean.
  */
+export interface ChatOptions {
+    model?: string;
+    permissionMode?: string;
+    resumeSessionId?: string;
+    continueLastSession?: boolean;
+    sessionId?: string;
+    maxTurns?: number;
+    maxBudgetUsd?: number;
+    effort?: string;
+    allowedTools?: string[];
+    disallowedTools?: string[];
+    fallbackModel?: string;
+    debug?: boolean;
+    verbose?: boolean;
+}
 export declare function renderLogin(): Promise<void>;
 export declare function renderLogout(): Promise<void>;
-export declare function renderChat(): Promise<void>;
+export declare function renderChat(options?: ChatOptions): Promise<void>;
 export declare function renderSetup(): Promise<void>;
 export declare function renderStatus(): Promise<void>;
 export declare function renderStores(): Promise<void>;

package/dist/cli/app.js

@@ -15,9 +15,18 @@ export async function renderLogout() {
         console.log("Logged out. Tokens cleared.");
     }
 }
-export async function renderChat() {
+export async function renderChat(options) {
     const { matrixIntro } = await import("./shared/MatrixIntro.js");
     await matrixIntro();
+    // Apply options before starting chat
+    if (options?.model || options?.permissionMode) {
+        const agentLoop = await import("./services/agent-loop.js");
+        if (options.model)
+            agentLoop.setModel(options.model);
+        if (options.permissionMode) {
+            agentLoop.setPermissionMode(options.permissionMode);
+        }
+    }
     const { ChatApp } = await import("./chat/ChatApp.js");
     const { waitUntilExit } = render(_jsx(ChatApp, {}));
     await waitUntilExit();

package/dist/cli/chat/ChatApp.d.ts

@@ -1,7 +1,9 @@
 /**
  * ChatApp — whale code CLI
  *
- * Clean, Apple-polished chat interface.
- * Minimal header, generous spacing, subtle status.
+ * Uses Ink's <Static> for completed messages — written to stdout once,
+ * never re-rendered. Only the active area (streaming, tools, input)
+ * is managed by Ink's render loop. This prevents scroll bounce when
+ * content exceeds the terminal height.
  */
 export declare function ChatApp(): import("react/jsx-runtime").JSX.Element;