@node9/proxy 1.8.2 → 1.8.3

package/dist/cli.js

@@ -2872,9 +2872,7 @@ end run`;
           "--text",
           pangoMessage,
           "--ok-label",
-          locked ? "Waiting..." : "Allow  \u21B5",
-          "--timeout",
-          "300"
+          locked ? "Waiting..." : "Allow  \u21B5"
         ];
         if (!locked) {
           argsList.push("--cancel-label", "Block  \u238B");
@@ -5691,6 +5689,12 @@ function estimateToolCost(tool, args) {
     const newStr = a.new_string ?? "";
     return String(newStr).length / BYTES_PER_TOKEN / 1e6 * OUTPUT_PRICE_PER_1M;
   }
+  if (t === "bash" || t === "shell" || t === "run_shell_command" || t === "terminal_execute") {
+    const command = String(a.command ?? a.cmd ?? a.input ?? "");
+    if (command.length > 0) {
+      return command.length / BYTES_PER_TOKEN / 1e6 * OUTPUT_PRICE_PER_1M;
+    }
+  }
   return void 0;
 }
 function broadcast(event, data) {
@@ -6823,7 +6827,7 @@ async function ensureDaemon() {
   } catch {
   }
   console.log(import_chalk17.default.dim("\u{1F6E1}\uFE0F  Starting Node9 daemon..."));
-  const child = (0, import_child_process13.spawn)(process.execPath, [process.argv[1], "daemon"], {
+  const child = (0, import_child_process14.spawn)(process.execPath, [process.argv[1], "daemon"], {
     detached: true,
     stdio: "ignore",
     env: { ...process.env, NODE9_AUTO_STARTED: "1" }
@@ -6997,6 +7001,7 @@ async function startTail(options = {}) {
     return;
   }
   const connectionTime = Date.now();
+  let initialReplayDone = false;
   const activityPending = /* @__PURE__ */ new Map();
   const orphanedResults = /* @__PURE__ */ new Map();
   let csrfToken = "";
@@ -7192,10 +7197,10 @@ async function startTail(options = {}) {
   try {
     const browserEnabled = getConfig().settings.approvers?.browser !== false;
     if (browserEnabled) {
-      if (process.platform === "darwin") (0, import_child_process13.execSync)(`open "${dashboardUrl}"`, { stdio: "ignore" });
+      if (process.platform === "darwin") (0, import_child_process14.execSync)(`open "${dashboardUrl}"`, { stdio: "ignore" });
       else if (process.platform === "win32")
-        (0, import_child_process13.execSync)(`cmd /c start "" "${dashboardUrl}"`, { stdio: "ignore" });
-      else (0, import_child_process13.execSync)(`xdg-open "${dashboardUrl}"`, { stdio: "ignore" });
+        (0, import_child_process14.execSync)(`cmd /c start "" "${dashboardUrl}"`, { stdio: "ignore" });
+      else (0, import_child_process14.execSync)(`xdg-open "${dashboardUrl}"`, { stdio: "ignore" });
       const intToken = getInternalToken();
       fetch(`http://127.0.0.1:${port}/browser-opened`, {
         method: "POST",
@@ -7328,11 +7333,17 @@ async function startTail(options = {}) {
       return;
     }
     if (event === "activity") {
+      const isReplayEvent = data.status && data.status !== "pending";
+      if (isReplayEvent && !initialReplayDone) {
+        renderResult(data, data);
+        return;
+      }
       if (!options.history && data.ts > 0 && data.ts < connectionTime) return;
-      if (data.status && data.status !== "pending") {
+      if (isReplayEvent) {
         renderResult(data, data);
         return;
       }
+      if (!initialReplayDone) initialReplayDone = true;
       const orphaned = orphanedResults.get(data.id);
       if (orphaned) {
         orphanedResults.delete(data.id);
@@ -7371,7 +7382,7 @@ async function startTail(options = {}) {
     process.exit(1);
   });
 }
-var import_http2, import_chalk17, import_fs25, import_os21, import_path28, import_readline5, import_child_process13, PID_FILE, ICONS, RESET2, BOLD2, RED, YELLOW, CYAN, GRAY, GREEN, HIDE_CURSOR, SHOW_CURSOR, ERASE_DOWN, DIVIDER;
+var import_http2, import_chalk17, import_fs25, import_os21, import_path28, import_readline5, import_child_process14, PID_FILE, ICONS, RESET2, BOLD2, RED, YELLOW, CYAN, GRAY, GREEN, HIDE_CURSOR, SHOW_CURSOR, ERASE_DOWN, DIVIDER;
 var init_tail = __esm({
   "src/tui/tail.ts"() {
     "use strict";
@@ -7381,7 +7392,7 @@ var init_tail = __esm({
     import_os21 = __toESM(require("os"));
     import_path28 = __toESM(require("path"));
     import_readline5 = __toESM(require("readline"));
-    import_child_process13 = require("child_process");
+    import_child_process14 = require("child_process");
     init_daemon2();
     init_daemon();
     init_core();
@@ -7716,6 +7727,24 @@ function renderContextLine(stdin) {
 async function main() {
   try {
     const [stdin, daemonStatus2] = await Promise.all([readStdin(), queryDaemon()]);
+    if (import_fs26.default.existsSync(import_path29.default.join(import_os22.default.homedir(), ".node9", "hud-debug"))) {
+      try {
+        const logPath = import_path29.default.join(import_os22.default.homedir(), ".node9", "hud-debug.log");
+        const MAX_LOG_SIZE = 10 * 1024 * 1024;
+        let size = 0;
+        try {
+          size = import_fs26.default.statSync(logPath).size;
+        } catch {
+        }
+        if (size < MAX_LOG_SIZE) {
+          import_fs26.default.appendFileSync(
+            logPath,
+            JSON.stringify({ ts: (/* @__PURE__ */ new Date()).toISOString(), stdin }) + "\n"
+          );
+        }
+      } catch {
+      }
+    }
     if (!daemonStatus2) {
       renderOffline();
       return;
@@ -7832,7 +7861,7 @@ function isNode9Hook(cmd) {
 function teardownClaude() {
   const homeDir2 = import_os10.default.homedir();
   const hooksPath = import_path14.default.join(homeDir2, ".claude", "settings.json");
-  const mcpPath = import_path14.default.join(homeDir2, ".claude.json");
+  const mcpPath = import_path14.default.join(homeDir2, ".claude", ".mcp.json");
   let changed = false;
   const settings = readJson(hooksPath);
   if (settings?.hooks) {
@@ -7858,11 +7887,12 @@ function teardownClaude() {
     let mcpChanged = false;
     if (removeNode9McpServer(claudeConfig.mcpServers)) {
       mcpChanged = true;
-      console.log(import_chalk.default.green("  \u2705 Removed node9 MCP server entry from ~/.claude.json"));
+      console.log(import_chalk.default.green("  \u2705 Removed node9 MCP server entry from ~/.claude/.mcp.json"));
     }
     for (const [name, server] of Object.entries(claudeConfig.mcpServers)) {
-      if (server.command === "node9" && Array.isArray(server.args) && server.args.length > 0) {
-        const [originalCmd, ...originalArgs] = server.args;
+      const args = server.args;
+      if (server.command === "node9" && Array.isArray(args) && args[0] === "mcp" && args[1] === "--upstream" && typeof args[2] === "string") {
+        const [originalCmd, ...originalArgs] = args[2].split(" ");
         claudeConfig.mcpServers[name] = {
           ...server,
           command: originalCmd,
@@ -7870,16 +7900,11 @@ function teardownClaude() {
         };
         mcpChanged = true;
       } else if (server.command === "node9") {
-        console.warn(
-          import_chalk.default.yellow(
-            `  \u26A0\uFE0F  Cannot unwrap MCP server "${name}" in ~/.claude.json \u2014 args is empty. Remove it manually.`
-          )
-        );
       }
     }
     if (mcpChanged) {
       writeJson(mcpPath, claudeConfig);
-      console.log(import_chalk.default.green("  \u2705 Unwrapped MCP servers in ~/.claude.json"));
+      console.log(import_chalk.default.green("  \u2705 Unwrapped MCP servers in ~/.claude/.mcp.json"));
     }
   }
 }
@@ -7908,8 +7933,9 @@ function teardownGemini() {
       console.log(import_chalk.default.green("  \u2705 Removed node9 MCP server entry from ~/.gemini/settings.json"));
     }
     for (const [name, server] of Object.entries(settings.mcpServers)) {
-      if (server.command === "node9" && Array.isArray(server.args) && server.args.length > 0) {
-        const [originalCmd, ...originalArgs] = server.args;
+      const args = server.args;
+      if (server.command === "node9" && Array.isArray(args) && args[0] === "mcp" && args[1] === "--upstream" && typeof args[2] === "string") {
+        const [originalCmd, ...originalArgs] = args[2].split(" ");
         settings.mcpServers[name] = {
           ...server,
           command: originalCmd,
@@ -7940,8 +7966,9 @@ function teardownCursor() {
     console.log(import_chalk.default.green("  \u2705 Removed node9 MCP server entry from ~/.cursor/mcp.json"));
   }
   for (const [name, server] of Object.entries(mcpConfig.mcpServers)) {
-    if (server.command === "node9" && Array.isArray(server.args) && server.args.length > 0) {
-      const [originalCmd, ...originalArgs] = server.args;
+    const args = server.args;
+    if (server.command === "node9" && Array.isArray(args) && args[0] === "mcp" && args[1] === "--upstream" && typeof args[2] === "string") {
+      const [originalCmd, ...originalArgs] = args[2].split(" ");
       mcpConfig.mcpServers[name] = {
         ...server,
         command: originalCmd,
@@ -7959,7 +7986,7 @@ function teardownCursor() {
 }
 async function setupClaude() {
   const homeDir2 = import_os10.default.homedir();
-  const mcpPath = import_path14.default.join(homeDir2, ".claude.json");
+  const mcpPath = import_path14.default.join(homeDir2, ".claude", ".mcp.json");
   const hooksPath = import_path14.default.join(homeDir2, ".claude", "settings.json");
   const claudeConfig = readJson(mcpPath) ?? {};
   const settings = readJson(hooksPath) ?? {};
@@ -7974,7 +8001,7 @@ async function setupClaude() {
     if (!settings.hooks.PreToolUse) settings.hooks.PreToolUse = [];
     settings.hooks.PreToolUse.push({
       matcher: ".*",
-      hooks: [{ type: "command", command: fullPathCommand("check"), timeout: 60 }]
+      hooks: [{ type: "command", command: fullPathCommand("check"), timeout: 600 }]
     });
     console.log(import_chalk.default.green("  \u2705 PreToolUse hook added  \u2192 node9 check"));
     hooksChanged = true;
@@ -8000,6 +8027,15 @@ async function setupClaude() {
     console.log(import_chalk.default.green("  \u2705 node9 MCP server added   \u2192 node9 mcp-server"));
     anythingChanged = true;
   }
+  const hudCommand = fullPathCommand("hud");
+  const statusLineObj = { type: "command", command: hudCommand };
+  const existingStatusLine = settings.statusLine;
+  const existingStatusCommand = typeof existingStatusLine === "object" ? existingStatusLine?.command : existingStatusLine;
+  if (existingStatusCommand !== hudCommand) {
+    settings.statusLine = statusLineObj;
+    hooksChanged = true;
+    anythingChanged = true;
+  }
   if (hooksChanged) {
     writeJson(hooksPath, settings);
     console.log("");
@@ -8007,20 +8043,24 @@ async function setupClaude() {
   const serversToWrap = [];
   for (const [name, server] of Object.entries(servers)) {
     if (!server.command || server.command === "node9") continue;
-    const parts = [server.command, ...server.args ?? []];
-    serversToWrap.push({ name, originalCmd: parts.join(" "), parts });
+    const upstream = [server.command, ...server.args ?? []].join(" ");
+    serversToWrap.push({ name, upstream });
   }
   if (serversToWrap.length > 0) {
     console.log(import_chalk.default.bold("The following existing entries will be modified:\n"));
     console.log(import_chalk.default.white(`  ${mcpPath}`));
-    for (const { name, originalCmd } of serversToWrap) {
-      console.log(import_chalk.default.gray(`    \u2022 ${name}: "${originalCmd}" \u2192 node9 ${originalCmd}`));
+    for (const { name, upstream } of serversToWrap) {
+      console.log(import_chalk.default.gray(`    \u2022 ${name}: "${upstream}" \u2192 node9 mcp --upstream "${upstream}"`));
     }
     console.log("");
     const proceed = await (0, import_prompts.confirm)({ message: "Wrap these MCP servers?", default: true });
     if (proceed) {
-      for (const { name, parts } of serversToWrap) {
-        servers[name] = { ...servers[name], command: "node9", args: parts };
+      for (const { name, upstream } of serversToWrap) {
+        servers[name] = {
+          ...servers[name],
+          command: "node9",
+          args: ["mcp", "--upstream", upstream]
+        };
       }
       claudeConfig.mcpServers = servers;
       writeJson(mcpPath, claudeConfig);
@@ -8100,20 +8140,24 @@ async function setupGemini() {
   const serversToWrap = [];
   for (const [name, server] of Object.entries(servers)) {
     if (!server.command || server.command === "node9") continue;
-    const parts = [server.command, ...server.args ?? []];
-    serversToWrap.push({ name, originalCmd: parts.join(" "), parts });
+    const upstream = [server.command, ...server.args ?? []].join(" ");
+    serversToWrap.push({ name, upstream });
   }
   if (serversToWrap.length > 0) {
     console.log(import_chalk.default.bold("The following existing entries will be modified:\n"));
     console.log(import_chalk.default.white(`  ${settingsPath}  (mcpServers)`));
-    for (const { name, originalCmd } of serversToWrap) {
-      console.log(import_chalk.default.gray(`    \u2022 ${name}: "${originalCmd}" \u2192 node9 ${originalCmd}`));
+    for (const { name, upstream } of serversToWrap) {
+      console.log(import_chalk.default.gray(`    \u2022 ${name}: "${upstream}" \u2192 node9 mcp --upstream "${upstream}"`));
     }
     console.log("");
     const proceed = await (0, import_prompts.confirm)({ message: "Wrap these MCP servers?", default: true });
     if (proceed) {
-      for (const { name, parts } of serversToWrap) {
-        servers[name] = { ...servers[name], command: "node9", args: parts };
+      for (const { name, upstream } of serversToWrap) {
+        servers[name] = {
+          ...servers[name],
+          command: "node9",
+          args: ["mcp", "--upstream", upstream]
+        };
       }
       settings.mcpServers = servers;
       writeJson(settingsPath, settings);
@@ -8172,20 +8216,24 @@ async function setupCursor() {
   const serversToWrap = [];
   for (const [name, server] of Object.entries(servers)) {
     if (!server.command || server.command === "node9") continue;
-    const parts = [server.command, ...server.args ?? []];
-    serversToWrap.push({ name, originalCmd: parts.join(" "), parts });
+    const upstream = [server.command, ...server.args ?? []].join(" ");
+    serversToWrap.push({ name, upstream });
   }
   if (serversToWrap.length > 0) {
     console.log(import_chalk.default.bold("The following existing entries will be modified:\n"));
     console.log(import_chalk.default.white(`  ${mcpPath}`));
-    for (const { name, originalCmd } of serversToWrap) {
-      console.log(import_chalk.default.gray(`    \u2022 ${name}: "${originalCmd}" \u2192 node9 ${originalCmd}`));
+    for (const { name, upstream } of serversToWrap) {
+      console.log(import_chalk.default.gray(`    \u2022 ${name}: "${upstream}" \u2192 node9 mcp --upstream "${upstream}"`));
     }
     console.log("");
     const proceed = await (0, import_prompts.confirm)({ message: "Wrap these MCP servers?", default: true });
     if (proceed) {
-      for (const { name, parts } of serversToWrap) {
-        servers[name] = { ...servers[name], command: "node9", args: parts };
+      for (const { name, upstream } of serversToWrap) {
+        servers[name] = {
+          ...servers[name],
+          command: "node9",
+          args: ["mcp", "--upstream", upstream]
+        };
       }
       mcpConfig.mcpServers = servers;
       writeJson(mcpPath, mcpConfig);
@@ -8248,20 +8296,24 @@ async function setupCodex() {
   const serversToWrap = [];
   for (const [name, server] of Object.entries(servers)) {
     if (!server.command || server.command === "node9") continue;
-    const parts = [server.command, ...server.args ?? []];
-    serversToWrap.push({ name, originalCmd: parts.join(" "), parts });
+    const upstream = [server.command, ...server.args ?? []].join(" ");
+    serversToWrap.push({ name, upstream });
   }
   if (serversToWrap.length > 0) {
     console.log(import_chalk.default.bold("The following existing entries will be modified:\n"));
     console.log(import_chalk.default.white(`  ${configPath}`));
-    for (const { name, originalCmd } of serversToWrap) {
-      console.log(import_chalk.default.gray(`    \u2022 ${name}: "${originalCmd}" \u2192 node9 ${originalCmd}`));
+    for (const { name, upstream } of serversToWrap) {
+      console.log(import_chalk.default.gray(`    \u2022 ${name}: "${upstream}" \u2192 node9 mcp --upstream "${upstream}"`));
     }
     console.log("");
     const proceed = await (0, import_prompts.confirm)({ message: "Wrap these MCP servers?", default: true });
     if (proceed) {
-      for (const { name, parts } of serversToWrap) {
-        servers[name] = { ...servers[name], command: "node9", args: parts };
+      for (const { name, upstream } of serversToWrap) {
+        servers[name] = {
+          ...servers[name],
+          command: "node9",
+          args: ["mcp", "--upstream", upstream]
+        };
       }
       config.mcp_servers = servers;
       writeToml(configPath, config);
@@ -8450,18 +8502,20 @@ async function runProxy(targetCommand) {
   const cmd = commandParts[0];
   const args = commandParts.slice(1);
   let executable = cmd;
+  let useShell = false;
   try {
     const { stdout } = await (0, import_execa.execa)("which", [cmd]);
     if (stdout) executable = stdout.trim();
   } catch {
+    useShell = true;
   }
   console.error(import_chalk4.default.green(`\u{1F680} Node9 Proxy Active: Monitoring [${targetCommand}]`));
-  const child = (0, import_child_process6.spawn)(executable, args, {
+  const spawnEnv = { ...process.env, FORCE_COLOR: "1" };
+  const child = useShell ? (0, import_child_process6.spawn)("/bin/bash", ["-c", targetCommand], {
     stdio: ["pipe", "pipe", "inherit"],
-    // We control STDIN and STDOUT
     shell: false,
-    env: { ...process.env, FORCE_COLOR: "1" }
-  });
+    env: spawnEnv
+  }) : (0, import_child_process6.spawn)(executable, args, { stdio: ["pipe", "pipe", "inherit"], shell: false, env: spawnEnv });
   const agentIn = import_readline.default.createInterface({ input: process.stdin, terminal: false });
   agentIn.on("line", async (line) => {
     let message;
@@ -8570,6 +8624,7 @@ async function autoStartDaemonAndWait() {
 // src/cli/commands/check.ts
 var import_chalk5 = __toESM(require("chalk"));
 var import_fs18 = __toESM(require("fs"));
+var import_child_process9 = require("child_process");
 var import_path20 = __toESM(require("path"));
 var import_os14 = __toESM(require("os"));
 init_orchestrator();
@@ -8953,6 +9008,37 @@ RAW: ${raw}
           process.exit(0);
         }
         const config = getConfig(payload.cwd || void 0);
+        if (config.settings.autoStartDaemon && !isDaemonRunning() && !process.env.NODE9_NO_AUTO_DAEMON) {
+          try {
+            const scriptPath = process.argv[1];
+            if (typeof scriptPath !== "string" || !import_path20.default.isAbsolute(scriptPath))
+              throw new Error("node9: argv[1] is not an absolute path");
+            const resolvedScript = import_fs18.default.realpathSync(scriptPath);
+            const expectedCli = import_fs18.default.realpathSync(import_path20.default.resolve(__dirname, "../../cli.js"));
+            if (resolvedScript !== expectedCli)
+              throw new Error(
+                "node9: daemon spawn aborted \u2014 argv[1] does not resolve to the node9 CLI"
+              );
+            const safeEnv = { ...process.env };
+            for (const key of [
+              "NODE_OPTIONS",
+              "LD_PRELOAD",
+              "LD_LIBRARY_PATH",
+              "DYLD_INSERT_LIBRARIES",
+              "NODE_PATH",
+              "ELECTRON_RUN_AS_NODE"
+            ]) {
+              delete safeEnv[key];
+            }
+            const d = (0, import_child_process9.spawn)(process.execPath, [scriptPath, "daemon"], {
+              detached: true,
+              stdio: "ignore",
+              env: { ...safeEnv, NODE9_AUTO_STARTED: "1", NODE9_BROWSER_OPENED: "1" }
+            });
+            d.unref();
+          } catch {
+          }
+        }
         if (process.env.NODE9_DEBUG === "1" || config.settings.enableHookLogDebug) {
           const logPath = import_path20.default.join(import_os14.default.homedir(), ".node9", "hook-debug.log");
           if (!import_fs18.default.existsSync(import_path20.default.dirname(logPath)))
@@ -9621,7 +9707,7 @@ var import_chalk7 = __toESM(require("chalk"));
 var import_fs20 = __toESM(require("fs"));
 var import_path22 = __toESM(require("path"));
 var import_os16 = __toESM(require("os"));
-var import_child_process9 = require("child_process");
+var import_child_process10 = require("child_process");
 init_daemon();
 function registerDoctorCommand(program2, version2) {
   program2.command("doctor").description("Check that Node9 is installed and configured correctly").action(() => {
@@ -9647,7 +9733,7 @@ function registerDoctorCommand(program2, version2) {
 `));
     section("Binary");
     try {
-      const which = (0, import_child_process9.execSync)("which node9", { encoding: "utf-8", timeout: 3e3 }).trim();
+      const which = (0, import_child_process10.execSync)("which node9", { encoding: "utf-8", timeout: 3e3 }).trim();
       pass(`node9 found at ${which}`);
     } catch {
       warn(
@@ -9665,7 +9751,7 @@ function registerDoctorCommand(program2, version2) {
       );
     }
     try {
-      const gitVersion = (0, import_child_process9.execSync)("git --version", { encoding: "utf-8", timeout: 3e3 }).trim();
+      const gitVersion = (0, import_child_process10.execSync)("git --version", { encoding: "utf-8", timeout: 3e3 }).trim();
       pass(gitVersion);
     } catch {
       warn(
@@ -9862,7 +9948,7 @@ function registerAuditCommand(program2) {
 
 // src/cli/commands/daemon-cmd.ts
 var import_chalk9 = __toESM(require("chalk"));
-var import_child_process10 = require("child_process");
+var import_child_process11 = require("child_process");
 init_daemon2();
 init_daemon();
 function registerDaemonCommand(program2) {
@@ -9895,7 +9981,7 @@ function registerDaemonCommand(program2) {
           console.log(import_chalk9.default.green(`\u{1F310}  Opened browser: http://${DAEMON_HOST}:${DAEMON_PORT}/`));
           process.exit(0);
         }
-        const child = (0, import_child_process10.spawn)(process.execPath, [process.argv[1], "daemon"], {
+        const child = (0, import_child_process11.spawn)(process.execPath, [process.argv[1], "daemon"], {
           detached: true,
           stdio: "ignore"
         });
@@ -9910,7 +9996,7 @@ function registerDaemonCommand(program2) {
         process.exit(0);
       }
       if (options.background) {
-        const child = (0, import_child_process10.spawn)(process.execPath, [process.argv[1], "daemon"], {
+        const child = (0, import_child_process11.spawn)(process.execPath, [process.argv[1], "daemon"], {
           detached: true,
           stdio: "ignore"
         });
@@ -10498,7 +10584,7 @@ function registerUndoCommand(program2) {
 
 // src/cli/commands/watch.ts
 var import_chalk14 = __toESM(require("chalk"));
-var import_child_process11 = require("child_process");
+var import_child_process12 = require("child_process");
 init_daemon();
 function registerWatchCommand(program2) {
   program2.command("watch").description("Run a command under Node9 watch mode (daemon stays alive for the session)").argument("<command>", "Command to run").argument("[args...]", "Arguments for the command").action(async (cmd, args) => {
@@ -10515,7 +10601,7 @@ function registerWatchCommand(program2) {
       }
     } catch {
       console.error(import_chalk14.default.dim("\u{1F6E1}\uFE0F  Starting Node9 daemon (watch mode)..."));
-      const child = (0, import_child_process11.spawn)(process.execPath, [process.argv[1], "daemon"], {
+      const child = (0, import_child_process12.spawn)(process.execPath, [process.argv[1], "daemon"], {
         detached: true,
         stdio: "ignore",
         env: { ...process.env, NODE9_AUTO_STARTED: "1", NODE9_WATCH_MODE: "1" }
@@ -10545,7 +10631,7 @@ function registerWatchCommand(program2) {
         "\n   Tip: run `node9 tail` in another terminal to review and approve AI actions.\n"
       )
     );
-    const result = (0, import_child_process11.spawnSync)(cmd, args, {
+    const result = (0, import_child_process12.spawnSync)(cmd, args, {
       stdio: "inherit",
       env: { ...process.env, NODE9_WATCH_MODE: "1" }
     });
@@ -10560,7 +10646,7 @@ function registerWatchCommand(program2) {
 // src/mcp-gateway/index.ts
 var import_readline3 = __toESM(require("readline"));
 var import_chalk15 = __toESM(require("chalk"));
-var import_child_process12 = require("child_process");
+var import_child_process13 = require("child_process");
 var import_execa3 = require("execa");
 init_orchestrator();
 init_provenance();
@@ -10648,7 +10734,7 @@ async function runMcpGateway(upstreamCommand) {
   const safeEnv = Object.fromEntries(
     Object.entries(process.env).filter(([k]) => !UPSTREAM_INJECTOR_VARS.has(k))
   );
-  const child = (0, import_child_process12.spawn)(executable, cmdArgs, {
+  const child = (0, import_child_process13.spawn)(executable, cmdArgs, {
     stdio: ["pipe", "pipe", "inherit"],
     // control stdin/stdout; inherit stderr
     shell: false,
@@ -10731,8 +10817,11 @@ async function runMcpGateway(upstreamCommand) {
         return;
       } finally {
         authPending = false;
-        agentIn.resume();
-        if (deferredStdinEnd) child.stdin.end();
+        if (deferredStdinEnd) {
+          child.stdin.end();
+        } else {
+          agentIn.resume();
+        }
         if (deferredExitCode !== null) process.exit(deferredExitCode);
       }
       return;
@@ -11467,7 +11556,43 @@ registerMcpGatewayCommand(program);
 registerMcpServerCommand(program);
 registerCheckCommand(program);
 registerLogCommand(program);
-program.command("hud").description("Render node9 security statusline (spawned by Claude Code statusLine)").action(async () => {
+program.command("hud").description("Render node9 security statusline (spawned by Claude Code statusLine)").addHelpText(
+  "after",
+  `
+Outputs up to 3 lines to stdout, then exits:
+
+  Line 1 \u2014 Security state (always shown):
+    \u{1F6E1} node9 | <mode> [shields] | \u2705 allowed  \u{1F6D1} blocked  \u{1F6A8} dlp  ~$cost
+    Shows "offline" if the node9 daemon is not running.
+
+  Line 2 \u2014 Claude context & rate limits (shown when available):
+    <model>  \u2502 ctx \u2588\u2588\u2588\u2588\u2588\u2588\u2591\u2591\u2591\u2591 61%  \u2502 5h \u2588\u2588\u2588\u2588\u2591\u2591\u2591\u2591\u2591\u2591 40% (2h 10m left)
+    Only appears when Claude Code passes context_window / rate_limits data via stdin.
+
+  Line 3 \u2014 Environment counts (shown when non-zero):
+    2 CLAUDE.md | 5 rules | 4 MCPs | 3 hooks
+    Counts CLAUDE.md files, rules/, MCP servers, and hook entries across user + project scope.
+    Disable with: { "settings": { "hud": { "showEnvironmentCounts": false } } } in node9.config.json
+
+Claude Code spawns this command every ~300ms and writes a JSON payload to stdin.
+Run "node9 addto claude" to register it as the statusLine.`
+).argument("[subcommand]", 'Optional: "debug on" / "debug off" to toggle stdin logging').argument("[state]", 'on|off \u2014 used with "debug" subcommand').action(async (subcommand, state) => {
+  if (subcommand === "debug") {
+    const flagFile = import_path30.default.join(import_os23.default.homedir(), ".node9", "hud-debug");
+    if (state === "on") {
+      import_fs27.default.mkdirSync(import_path30.default.dirname(flagFile), { recursive: true });
+      import_fs27.default.writeFileSync(flagFile, "");
+      console.log("HUD debug logging enabled \u2192 ~/.node9/hud-debug.log");
+      console.log("Tail it with: tail -f ~/.node9/hud-debug.log");
+    } else if (state === "off") {
+      if (import_fs27.default.existsSync(flagFile)) import_fs27.default.unlinkSync(flagFile);
+      console.log("HUD debug logging disabled.");
+    } else {
+      console.error("Usage: node9 hud debug on|off");
+      process.exit(1);
+    }
+    return;
+  }
   const { main: main2 } = await Promise.resolve().then(() => (init_hud(), hud_exports));
   await main2();
 });