@documentation-robotics/cli 0.1.7 → 0.1.8

package/dist/cli.js

@@ -47,7 +47,7 @@ async function extractExitCode(error) {
   }
   return 1;
 }
-const cliVersion = "0.1.7", program = new Command();
+const cliVersion = "0.1.8", program = new Command();
 (process.argv.includes("--version") || process.argv.includes("-V")) && (process.argv = ["node", "dr", "version"]), program.name("dr").description("Documentation Robotics CLI - Architecture Model Management").option("-v, --verbose", "Enable verbose output").option("--debug", "Enable debug mode").exitOverride().showSuggestionAfterError().hook("preAction", async (thisCommand) => {
   const options = thisCommand.opts();
   setGlobalOptions({

package/dist/commands/version.js

@@ -2,7 +2,7 @@ import ansis from "ansis";
 import { getCliBundledSpecVersion } from "../utils/spec-version.js";
 import { isTelemetryBuiltIn, isTelemetryConfigured } from "../telemetry/detect.js";
 import { getSpecReferencePath, getModelPath } from "../utils/project-paths.js";
-const gitHash = "6bb0c1f", cliVersion = "0.1.7";
+const gitHash = "f413188", cliVersion = "0.1.8";
 async function versionCommand() {
   const specVersion = getCliBundledSpecVersion(), telemetryBuiltIn = isTelemetryBuiltIn(), telemetryConfigured = await isTelemetryConfigured();
   let telemetryStatus;

package/dist/commands/visualize.js

@@ -56,7 +56,7 @@ async function visualizeCommand(options) {
       DR_WITH_DANGER: String(withDanger)
     }, { isDebug: getDebugState, isVerbose } = await import("../utils/globals.js");
     getDebugState() && (env.DEBUG = "1", env.DR_TELEMETRY_DEBUG = "1", logDebug("Passing DEBUG=1 and DR_TELEMETRY_DEBUG=1 to subprocess")), isVerbose() && (env.VERBOSE = "1", logDebug("Passing VERBOSE=1 to subprocess")), authToken && (env.DR_AUTH_TOKEN = authToken), options.viewerPath && (env.DR_VIEWER_PATH = options.viewerPath, logDebug(`Using custom viewer from: ${options.viewerPath}`));
-    const serverProcess = spawn("bun", ["run", serverEntryPath], {
+    const serverProcess = spawn(process.execPath, [serverEntryPath], {
       cwd: process.cwd(),
       stdio: ["pipe", "pipe", "pipe"],
       env
@@ -131,13 +131,7 @@ ${serverOutput}` : `Server exited with code ${code}`;
     }), serverProcess.on("error", (error) => {
       const errorCode = error.code;
       let message, suggestions;
-      errorCode === "ENOENT" ? (message = "dr visualize requires the Bun runtime, which was not found on this system.", suggestions = [
-        "Install Bun: https://bun.sh/docs/installation",
-        "  curl -fsSL https://bun.sh/install | bash   (macOS/Linux)",
-        '  powershell -c "irm bun.sh/install.ps1 | iex"   (Windows)',
-        "After installing, make sure `bun` is on your PATH, then re-run `dr visualize`.",
-        "Tracking issue: https://github.com/tinkermonkey/documentation_robotics/issues/800"
-      ]) : errorCode === "EACCES" ? (message = "dr visualize could not run the Bun runtime: permission denied.", suggestions = ["Check that the `bun` executable on your PATH is executable (chmod +x)."]) : message = `Failed to start visualization server: ${error.message}`, isTelemetryEnabled && serverStartupSpan && (async () => {
+      errorCode === "EACCES" ? (message = `dr visualize could not run the visualization server: permission denied executing ${process.execPath}.`, suggestions = [`Check that ${process.execPath} is executable (chmod +x).`]) : message = `Failed to start visualization server: ${error.message}`, isTelemetryEnabled && serverStartupSpan && (async () => {
         const { endSpan } = await import("../telemetry/index.js");
         "recordException" in serverStartupSpan && (serverStartupSpan.recordException(error), serverStartupSpan.setStatus({ code: 2, message })), endSpan(serverStartupSpan), serverStartupSpan = null;
       })();

package/dist/commands/visualize.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/commands/visualize.ts"],
-  "sourcesContent": ["/**\n * Visualize command - Launch visualization server\n */\n\nimport ansis from \"ansis\"\nimport { spawn } from \"child_process\"\nimport { fileURLToPath } from \"node:url\"\nimport { dirname } from \"node:path\"\nimport { Model } from \"../core/model.js\"\nimport { logVerbose, logDebug } from \"../utils/globals.js\"\nimport { CLIError } from \"../utils/errors.js\"\nimport { getSpecReferencePath, getModelPath } from \"../utils/project-paths.js\"\nimport { getErrorMessage } from \"../utils/errors.js\"\n\n// Conditional telemetry import based on compile-time flag\ndeclare const TELEMETRY_ENABLED: boolean | undefined\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== \"undefined\" ? TELEMETRY_ENABLED : false\n\nexport interface VisualizeOptions {\n  port?: number\n  noBrowser?: boolean\n  noAuth?: boolean\n  token?: string\n  verbose?: boolean\n  debug?: boolean\n  withDanger?: boolean\n  viewerPath?: string\n}\n\nasync function findAvailablePort(startPort: number): Promise<number> {\n  const { createServer } = await import(\"net\")\n  for (let port = startPort; port <= 65535; port++) {\n    const available = await new Promise<boolean>((resolve) => {\n      const server = createServer()\n      server.once(\"error\", () => resolve(false))\n      server.once(\"listening\", () => { server.close(); resolve(true) })\n      server.listen(port, \"127.0.0.1\")\n    })\n    if (available) return port\n  }\n  throw new Error(\"No available ports found\")\n}\n\nexport async function visualizeCommand(\n  options: VisualizeOptions & { port?: string }\n): Promise<void> {\n  try {\n    logDebug(\"Loading model for validation...\")\n\n    // Load model to validate it exists (without full content to be quick)\n    const model = await Model.load(process.cwd(), { lazyLoad: true })\n\n    logVerbose(`Model validated: ${model.manifest.name}`)\n\n    // Parse and validate port\n    let port = 8080\n    if (options.port) {\n      const portNum = parseInt(String(options.port), 10)\n      if (isNaN(portNum) || portNum < 1 || portNum > 65535) {\n        throw new Error(`Invalid port number: ${options.port}. Port must be between 1 and 65535.`)\n      }\n      port = portNum\n    }\n\n    // Find an available port starting from the requested port\n    port = await findAvailablePort(port)\n    if (port !== (options.port ? parseInt(String(options.port), 10) : 8080)) {\n      console.log(ansis.yellow(`   Port ${options.port ?? 8080} is in use, using port ${port} instead`))\n    }\n\n    // Determine auth settings\n    const authEnabled = !options.noAuth // Auth enabled by default unless --no-auth flag\n    const authToken = options.token // Optional token for testing\n    const withDanger = options.withDanger || false // Danger mode disabled by default\n\n    logDebug(`Starting visualization server on port ${port}`)\n    logDebug(`Authentication: ${authEnabled ? \"enabled\" : \"disabled\"}`)\n    if (authEnabled && authToken) {\n      logDebug(`Using provided token for authentication`)\n    } else if (authEnabled) {\n      logDebug(`Token will be auto-generated`)\n    }\n    if (withDanger) {\n      logDebug(`Danger mode enabled - chat permissions will be skipped`)\n    }\n\n    // Get the directory where this command file is located (dist/commands/)\n    const commandDir = dirname(fileURLToPath(import.meta.url))\n    const distDir = dirname(commandDir) // Go up to dist/\n    const serverEntryPath = `${distDir}/server-entry.js`\n\n    logDebug(`Server entry path: ${serverEntryPath}`)\n\n    // Create telemetry span for server startup\n    let serverStartupSpan: any = null\n    if (isTelemetryEnabled) {\n      logDebug(\"[Telemetry] Creating visualize.server.startup span\")\n      const { startSpan } = await import(\"../telemetry/index.js\")\n      serverStartupSpan = startSpan(\"visualize.server.startup\", {\n        \"server.port\": port,\n        \"server.auth_enabled\": authEnabled,\n        \"server.with_danger\": withDanger,\n      })\n      logDebug(`[Telemetry] Span created: ${serverStartupSpan ? \"success\" : \"failed\"}`)\n    } else {\n      logDebug(\"[Telemetry] TELEMETRY_ENABLED is false - no spans will be created\")\n    }\n\n    // Spawn server in Bun subprocess with environment variables\n    const env: Record<string, string> = {\n      ...process.env,\n      DR_VISUALIZE_PORT: String(port),\n      DR_PROJECT_PATH: process.cwd(),\n      DR_AUTH_ENABLED: String(authEnabled),\n      DR_WITH_DANGER: String(withDanger),\n    }\n\n    // Pass debug/verbose flags to subprocess\n    // The CLI --debug flag sets globalOptions.debug, but subprocess checks process.env.DEBUG\n    const { isDebug: getDebugState, isVerbose } = await import(\"../utils/globals.js\")\n    if (getDebugState()) {\n      env.DEBUG = \"1\"\n      env.DR_TELEMETRY_DEBUG = \"1\" // Enable telemetry exporter debug logging\n      logDebug(\"Passing DEBUG=1 and DR_TELEMETRY_DEBUG=1 to subprocess\")\n    }\n    if (isVerbose()) {\n      env.VERBOSE = \"1\"\n      logDebug(\"Passing VERBOSE=1 to subprocess\")\n    }\n\n    // Only set auth token if provided\n    if (authToken) {\n      env.DR_AUTH_TOKEN = authToken\n    }\n\n    // Set custom viewer path if provided\n    if (options.viewerPath) {\n      env.DR_VIEWER_PATH = options.viewerPath\n      logDebug(`Using custom viewer from: ${options.viewerPath}`)\n    }\n\n    const serverProcess = spawn(\"bun\", [\"run\", serverEntryPath], {\n      cwd: process.cwd(),\n      stdio: [\"pipe\", \"pipe\", \"pipe\"],\n      env,\n    })\n\n    let authTokenFromServer = \"\"\n    let serverOutput = \"\"\n    let serverStartupShown = false\n\n    // Capture output from server process\n    if (serverProcess.stdout) {\n      serverProcess.stdout.on(\"data\", async (data) => {\n        const chunk = data.toString()\n        serverOutput += chunk\n\n        // Process each line individually: Bun's pipe buffering often batches multiple\n        // console.log calls (e.g. \"running at\" + \"TOKEN:\") into a single data event.\n        // Using startsWith/substring on the whole chunk would either miss the TOKEN line\n        // (when \"running at\" is first) or extract a malformed token (when trailing lines\n        // are appended), causing the browser to open with the wrong token and get a 403.\n        const lines = chunk.split(\"\\n\")\n        for (const rawLine of lines) {\n          const line = rawLine.trim()\n          if (!line) continue\n\n          // Extract token from output\n          if (line.startsWith(\"TOKEN:\")) {\n            authTokenFromServer = line.substring(6)\n            logDebug(`Received auth token from server: ${authTokenFromServer.substring(0, 8)}...`)\n\n            // If we haven't shown startup info yet and now have the token, show it\n            if (serverStartupShown && authEnabled && authTokenFromServer) {\n              // Update the URL display with actual token\n              console.log(\n                ansis.cyan(`   Access URL: http://localhost:${port}?token=${authTokenFromServer}`)\n              )\n              console.log(ansis.dim(`   Auth token: ${authTokenFromServer}`))\n\n              // Now that we have the token, open browser if needed\n              if (!options.noBrowser) {\n                try {\n                  const command = getOpenCommand()\n                  const url = `http://localhost:${port}?token=${authTokenFromServer}`\n                  logDebug(`Opening browser with command: ${command} ${url}`)\n                  spawn(command, [url], {\n                    detached: true,\n                    stdio: \"ignore\",\n                  })\n                } catch (error) {\n                  logVerbose(\"Could not auto-open browser (not critical)\")\n                }\n              }\n            }\n          }\n\n          // Server started message - defer detailed output if auth enabled\n          if (line.includes(\"running at http://localhost\")) {\n            serverStartupShown = true\n\n            // End telemetry span for server startup\n            if (isTelemetryEnabled && serverStartupSpan) {\n              logDebug(\n                \"[Telemetry] Ending visualize.server.startup span (server started successfully)\"\n              )\n              const { endSpan } = await import(\"../telemetry/index.js\")\n              endSpan(serverStartupSpan)\n              serverStartupSpan = null\n              logDebug(\"[Telemetry] Span ended\")\n            }\n\n            console.log(ansis.green(`\u2713 Visualization server started`))\n\n            // Display access information (but may be incomplete if auth enabled and token not yet received)\n            if (authEnabled) {\n              const token = authTokenFromServer || authToken || \"(pending)\"\n              if (authTokenFromServer) {\n                // Token already received (same chunk), show full info immediately\n                console.log(ansis.cyan(`   Access URL: http://localhost:${port}?token=${token}`))\n                console.log(ansis.dim(`   Auth token: ${token}`))\n              } else {\n                // Token not yet received, just show port for now\n                console.log(ansis.dim(`   Open http://localhost:${port} in your browser`))\n                logDebug(`   (waiting for auth token...)`)\n              }\n            } else {\n              console.log(ansis.dim(`   Open http://localhost:${port} in your browser`))\n              console.log(ansis.yellow(`   \u26A0 Authentication disabled`))\n            }\n\n            if (withDanger) {\n              console.log(\n                ansis.yellow(`   \u26A0 Danger mode enabled - chat permissions will be skipped`)\n              )\n            }\n\n            console.log(ansis.blueBright(`Model name: ${model.manifest.name}`))\n            const drFolder = await getSpecReferencePath()\n            console.log(\n              `DR folder:    ${ansis.cyan(drFolder || \"Not found\")}`\n            )\n            console.log(`Model path:   ${ansis.cyan((await getModelPath()) || \"Not found\")}`)\n\n            // Optionally open browser\n            // If auth is enabled, delay opening until we have the token\n            const shouldOpenBrowser = !options.noBrowser\n            logDebug(\n              `Browser auto-open: ${shouldOpenBrowser ? \"enabled\" : \"disabled\"} (noBrowser=${options.noBrowser})`\n            )\n\n            if (shouldOpenBrowser && !authEnabled) {\n              // Auth disabled: open immediately\n              try {\n                const command = getOpenCommand()\n                const url = `http://localhost:${port}`\n                logDebug(`Opening browser with command: ${command} ${url}`)\n                spawn(command, [url], {\n                  detached: true,\n                  stdio: \"ignore\",\n                })\n              } catch (error) {\n                logVerbose(\"Could not auto-open browser (not critical)\")\n              }\n            } else if (shouldOpenBrowser && authEnabled && !authTokenFromServer) {\n              // Auth enabled but token not yet in this chunk: will open when TOKEN line is processed\n              logDebug(\"Browser auto-open deferred until token is received\")\n            } else {\n              logDebug(\"Browser auto-open disabled\")\n            }\n          }\n\n          // Log other output\n          if (!line.startsWith(\"TOKEN:\")) {\n            logDebug(`[server] ${line}`)\n          }\n        }\n      })\n    }\n\n    // Capture stderr\n    if (serverProcess.stderr) {\n      serverProcess.stderr.on(\"data\", (data) => {\n        const output = data.toString().trim()\n        if (output) {\n          serverOutput += output + \"\\n\"\n          // Log stderr at debug level so --debug flag shows telemetry exporter logs\n          logDebug(`[server stderr] ${output}`)\n        }\n      })\n    }\n\n    // Handle process close (fires after all stdio streams have closed)\n    let rejectKeepAlive: ((reason: Error) => void) | null = null\n\n    serverProcess.on(\"close\", (code) => {\n      if (code !== 0) {\n        // Include server output in error message if available (avoid separate logDebug to prevent minification issues)\n        const message = serverOutput\n          ? `Server exited with code ${code}\\nServer output:\\n${serverOutput}`\n          : `Server exited with code ${code}`\n\n        // Record error in startup span if still active\n        if (isTelemetryEnabled && serverStartupSpan) {\n          (async () => {\n            const { endSpan } = await import(\"../telemetry/index.js\")\n            if (\"recordException\" in serverStartupSpan) {\n              (serverStartupSpan as any).recordException(new Error(message));\n              (serverStartupSpan as any).setStatus({ code: 2, message }) // ERROR\n            }\n            endSpan(serverStartupSpan)\n            serverStartupSpan = null\n          })()\n        }\n\n        // Print error before rejecting (CLI wrapper expects CLIError messages to be pre-printed)\n        console.error(message)\n        const error = new CLIError(message, code || 1)\n        if (rejectKeepAlive) {\n          rejectKeepAlive(error)\n        }\n      }\n    })\n\n    // Handle process errors\n    serverProcess.on(\"error\", (error) => {\n      const errorCode = (error as NodeJS.ErrnoException).code\n      let message: string\n      let suggestions: string[] | undefined\n\n      if (errorCode === \"ENOENT\") {\n        // `dr visualize` currently spawns its server as a Bun subprocess (see #800 for\n        // the plan to remove this dependency). On a fresh `npm install -g` there's no\n        // reason Bun would be present, so this is an expected, actionable failure mode\n        // rather than an unexpected crash - explain it instead of surfacing the raw\n        // \"spawn bun ENOENT\".\n        message = \"dr visualize requires the Bun runtime, which was not found on this system.\"\n        suggestions = [\n          \"Install Bun: https://bun.sh/docs/installation\",\n          \"  curl -fsSL https://bun.sh/install | bash   (macOS/Linux)\",\n          \"  powershell -c \\\"irm bun.sh/install.ps1 | iex\\\"   (Windows)\",\n          \"After installing, make sure `bun` is on your PATH, then re-run `dr visualize`.\",\n          \"Tracking issue: https://github.com/tinkermonkey/documentation_robotics/issues/800\",\n        ]\n      } else if (errorCode === \"EACCES\") {\n        message = \"dr visualize could not run the Bun runtime: permission denied.\"\n        suggestions = [\"Check that the `bun` executable on your PATH is executable (chmod +x).\"]\n      } else {\n        message = `Failed to start visualization server: ${error.message}`\n      }\n\n      // Record error in startup span if still active\n      if (isTelemetryEnabled && serverStartupSpan) {\n        (async () => {\n          const { endSpan } = await import(\"../telemetry/index.js\")\n          if (\"recordException\" in serverStartupSpan) {\n            (serverStartupSpan as any).recordException(error);\n            (serverStartupSpan as any).setStatus({ code: 2, message }) // ERROR\n          }\n          endSpan(serverStartupSpan)\n          serverStartupSpan = null\n        })()\n      }\n\n      // Don't print here: rejecting propagates this CLIError up through the catch block\n      // below to the top-level CLI handler, which prints `.format()` (including\n      // `suggestions`) exactly once. Printing here too would duplicate the whole block.\n      const cliError = new CLIError(message, 1, suggestions)\n      if (rejectKeepAlive) {\n        rejectKeepAlive(cliError)\n      }\n    })\n\n    // Setup periodic telemetry flushing for long-running command\n    // Since the visualize command never completes (keep-alive pattern),\n    // the cli.execute span would never end and export. We flush periodically\n    // to ensure active spans are exported to the telemetry backend.\n    let flushInterval: NodeJS.Timeout | null = null\n    if (isTelemetryEnabled) {\n      logDebug(\"[Telemetry] Setting up periodic flush (every 15 seconds)\")\n      const { flushTelemetry } = await import(\"../telemetry/index.js\")\n\n      flushInterval = setInterval(async () => {\n        logDebug(\"[Telemetry] Periodic flush: flushing pending spans...\")\n        try {\n          await flushTelemetry()\n          logDebug(\"[Telemetry] Periodic flush complete\")\n        } catch (error) {\n          // Silently ignore flush errors - telemetry should never break the app\n          logDebug(`[Telemetry] Periodic flush failed: ${error}`)\n        }\n      }, 15000) // Flush every 15 seconds\n    }\n\n    // Handle graceful shutdown on SIGINT (Ctrl-C) and SIGTERM\n    const handleShutdown = async (signal: string) => {\n      logDebug(`\\n[${signal}] Shutting down visualization server gracefully...`)\n\n      // Clear periodic flush interval\n      if (flushInterval) {\n        logDebug(\"[Telemetry] Stopping periodic flush\")\n        clearInterval(flushInterval)\n        flushInterval = null\n      }\n\n      // Forward signal to server process for graceful shutdown\n      if (serverProcess && !serverProcess.killed) {\n        logDebug(\"Sending termination signal to server process...\")\n        serverProcess.kill(signal as NodeJS.Signals)\n\n        // Wait for server to exit (with timeout)\n        await new Promise<void>((resolve) => {\n          const timeout = setTimeout(() => {\n            logDebug(\"Server shutdown timeout, forcing exit...\")\n            if (!serverProcess.killed) {\n              serverProcess.kill(\"SIGKILL\")\n            }\n            resolve()\n          }, 3000) // 3 second timeout\n\n          serverProcess.on(\"exit\", () => {\n            clearTimeout(timeout)\n            resolve()\n          })\n        })\n      }\n\n      logDebug(\"Visualization server stopped\")\n      process.exit(0)\n    }\n\n    // Register signal handlers\n    process.on(\"SIGINT\", () => handleShutdown(\"SIGINT\"))\n    process.on(\"SIGTERM\", () => handleShutdown(\"SIGTERM\"))\n\n    // Keep parent process alive - reject promise if server fails\n    await new Promise((_, reject) => {\n      rejectKeepAlive = reject\n    })\n  } catch (error) {\n    // Throw CLIError instead of process.exit to allow telemetry shutdown\n    // Note: Avoid side effects (like logDebug) before throw to prevent minification issues\n    if (error instanceof CLIError) {\n      // CLIError should have already printed its message\n      throw error\n    }\n    // Non-CLIError needs to be printed and wrapped\n    const message = getErrorMessage(error)\n    console.error(message)\n    throw new CLIError(message, 1)\n  }\n}\n\n/**\n * Get the appropriate command to open a URL\n */\nfunction getOpenCommand(): string {\n  const platform = process.platform\n\n  if (platform === \"darwin\") {\n    return \"open\"\n  }\n  if (platform === \"win32\") {\n    return \"start\"\n  }\n  // Linux and others\n  return \"xdg-open\"\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * Visualize command - Launch visualization server\n */\n\nimport ansis from \"ansis\"\nimport { spawn } from \"child_process\"\nimport { fileURLToPath } from \"node:url\"\nimport { dirname } from \"node:path\"\nimport { Model } from \"../core/model.js\"\nimport { logVerbose, logDebug } from \"../utils/globals.js\"\nimport { CLIError } from \"../utils/errors.js\"\nimport { getSpecReferencePath, getModelPath } from \"../utils/project-paths.js\"\nimport { getErrorMessage } from \"../utils/errors.js\"\n\n// Conditional telemetry import based on compile-time flag\ndeclare const TELEMETRY_ENABLED: boolean | undefined\nconst isTelemetryEnabled = typeof TELEMETRY_ENABLED !== \"undefined\" ? TELEMETRY_ENABLED : false\n\nexport interface VisualizeOptions {\n  port?: number\n  noBrowser?: boolean\n  noAuth?: boolean\n  token?: string\n  verbose?: boolean\n  debug?: boolean\n  withDanger?: boolean\n  viewerPath?: string\n}\n\nasync function findAvailablePort(startPort: number): Promise<number> {\n  const { createServer } = await import(\"net\")\n  for (let port = startPort; port <= 65535; port++) {\n    const available = await new Promise<boolean>((resolve) => {\n      const server = createServer()\n      server.once(\"error\", () => resolve(false))\n      server.once(\"listening\", () => { server.close(); resolve(true) })\n      server.listen(port, \"127.0.0.1\")\n    })\n    if (available) return port\n  }\n  throw new Error(\"No available ports found\")\n}\n\nexport async function visualizeCommand(\n  options: VisualizeOptions & { port?: string }\n): Promise<void> {\n  try {\n    logDebug(\"Loading model for validation...\")\n\n    // Load model to validate it exists (without full content to be quick)\n    const model = await Model.load(process.cwd(), { lazyLoad: true })\n\n    logVerbose(`Model validated: ${model.manifest.name}`)\n\n    // Parse and validate port\n    let port = 8080\n    if (options.port) {\n      const portNum = parseInt(String(options.port), 10)\n      if (isNaN(portNum) || portNum < 1 || portNum > 65535) {\n        throw new Error(`Invalid port number: ${options.port}. Port must be between 1 and 65535.`)\n      }\n      port = portNum\n    }\n\n    // Find an available port starting from the requested port\n    port = await findAvailablePort(port)\n    if (port !== (options.port ? parseInt(String(options.port), 10) : 8080)) {\n      console.log(ansis.yellow(`   Port ${options.port ?? 8080} is in use, using port ${port} instead`))\n    }\n\n    // Determine auth settings\n    const authEnabled = !options.noAuth // Auth enabled by default unless --no-auth flag\n    const authToken = options.token // Optional token for testing\n    const withDanger = options.withDanger || false // Danger mode disabled by default\n\n    logDebug(`Starting visualization server on port ${port}`)\n    logDebug(`Authentication: ${authEnabled ? \"enabled\" : \"disabled\"}`)\n    if (authEnabled && authToken) {\n      logDebug(`Using provided token for authentication`)\n    } else if (authEnabled) {\n      logDebug(`Token will be auto-generated`)\n    }\n    if (withDanger) {\n      logDebug(`Danger mode enabled - chat permissions will be skipped`)\n    }\n\n    // Get the directory where this command file is located (dist/commands/)\n    const commandDir = dirname(fileURLToPath(import.meta.url))\n    const distDir = dirname(commandDir) // Go up to dist/\n    const serverEntryPath = `${distDir}/server-entry.js`\n\n    logDebug(`Server entry path: ${serverEntryPath}`)\n\n    // Create telemetry span for server startup\n    let serverStartupSpan: any = null\n    if (isTelemetryEnabled) {\n      logDebug(\"[Telemetry] Creating visualize.server.startup span\")\n      const { startSpan } = await import(\"../telemetry/index.js\")\n      serverStartupSpan = startSpan(\"visualize.server.startup\", {\n        \"server.port\": port,\n        \"server.auth_enabled\": authEnabled,\n        \"server.with_danger\": withDanger,\n      })\n      logDebug(`[Telemetry] Span created: ${serverStartupSpan ? \"success\" : \"failed\"}`)\n    } else {\n      logDebug(\"[Telemetry] TELEMETRY_ENABLED is false - no spans will be created\")\n    }\n\n    // Build environment variables for the server subprocess\n    const env: Record<string, string> = {\n      ...process.env,\n      DR_VISUALIZE_PORT: String(port),\n      DR_PROJECT_PATH: process.cwd(),\n      DR_AUTH_ENABLED: String(authEnabled),\n      DR_WITH_DANGER: String(withDanger),\n    }\n\n    // Pass debug/verbose flags to subprocess\n    // The CLI --debug flag sets globalOptions.debug, but subprocess checks process.env.DEBUG\n    const { isDebug: getDebugState, isVerbose } = await import(\"../utils/globals.js\")\n    if (getDebugState()) {\n      env.DEBUG = \"1\"\n      env.DR_TELEMETRY_DEBUG = \"1\" // Enable telemetry exporter debug logging\n      logDebug(\"Passing DEBUG=1 and DR_TELEMETRY_DEBUG=1 to subprocess\")\n    }\n    if (isVerbose()) {\n      env.VERBOSE = \"1\"\n      logDebug(\"Passing VERBOSE=1 to subprocess\")\n    }\n\n    // Only set auth token if provided\n    if (authToken) {\n      env.DR_AUTH_TOKEN = authToken\n    }\n\n    // Set custom viewer path if provided\n    if (options.viewerPath) {\n      env.DR_VIEWER_PATH = options.viewerPath\n      logDebug(`Using custom viewer from: ${options.viewerPath}`)\n    }\n\n    // Reuse whichever runtime is currently executing the CLI (node or bun) to launch\n    // the server subprocess. server-entry.ts has no Bun-specific dependencies (see #800),\n    // so this works identically under Node.js or Bun \u2014 and unlike spawning a literal\n    // \"bun\" binary, process.execPath is guaranteed to exist since it's already running.\n    const serverProcess = spawn(process.execPath, [serverEntryPath], {\n      cwd: process.cwd(),\n      stdio: [\"pipe\", \"pipe\", \"pipe\"],\n      env,\n    })\n\n    let authTokenFromServer = \"\"\n    let serverOutput = \"\"\n    let serverStartupShown = false\n\n    // Capture output from server process\n    if (serverProcess.stdout) {\n      serverProcess.stdout.on(\"data\", async (data) => {\n        const chunk = data.toString()\n        serverOutput += chunk\n\n        // Process each line individually: stdio pipe buffering can batch multiple\n        // console.log calls (e.g. \"running at\" + \"TOKEN:\") into a single data event,\n        // regardless of runtime.\n        // Using startsWith/substring on the whole chunk would either miss the TOKEN line\n        // (when \"running at\" is first) or extract a malformed token (when trailing lines\n        // are appended), causing the browser to open with the wrong token and get a 403.\n        const lines = chunk.split(\"\\n\")\n        for (const rawLine of lines) {\n          const line = rawLine.trim()\n          if (!line) continue\n\n          // Extract token from output\n          if (line.startsWith(\"TOKEN:\")) {\n            authTokenFromServer = line.substring(6)\n            logDebug(`Received auth token from server: ${authTokenFromServer.substring(0, 8)}...`)\n\n            // If we haven't shown startup info yet and now have the token, show it\n            if (serverStartupShown && authEnabled && authTokenFromServer) {\n              // Update the URL display with actual token\n              console.log(\n                ansis.cyan(`   Access URL: http://localhost:${port}?token=${authTokenFromServer}`)\n              )\n              console.log(ansis.dim(`   Auth token: ${authTokenFromServer}`))\n\n              // Now that we have the token, open browser if needed\n              if (!options.noBrowser) {\n                try {\n                  const command = getOpenCommand()\n                  const url = `http://localhost:${port}?token=${authTokenFromServer}`\n                  logDebug(`Opening browser with command: ${command} ${url}`)\n                  spawn(command, [url], {\n                    detached: true,\n                    stdio: \"ignore\",\n                  })\n                } catch (error) {\n                  logVerbose(\"Could not auto-open browser (not critical)\")\n                }\n              }\n            }\n          }\n\n          // Server started message - defer detailed output if auth enabled\n          if (line.includes(\"running at http://localhost\")) {\n            serverStartupShown = true\n\n            // End telemetry span for server startup\n            if (isTelemetryEnabled && serverStartupSpan) {\n              logDebug(\n                \"[Telemetry] Ending visualize.server.startup span (server started successfully)\"\n              )\n              const { endSpan } = await import(\"../telemetry/index.js\")\n              endSpan(serverStartupSpan)\n              serverStartupSpan = null\n              logDebug(\"[Telemetry] Span ended\")\n            }\n\n            console.log(ansis.green(`\u2713 Visualization server started`))\n\n            // Display access information (but may be incomplete if auth enabled and token not yet received)\n            if (authEnabled) {\n              const token = authTokenFromServer || authToken || \"(pending)\"\n              if (authTokenFromServer) {\n                // Token already received (same chunk), show full info immediately\n                console.log(ansis.cyan(`   Access URL: http://localhost:${port}?token=${token}`))\n                console.log(ansis.dim(`   Auth token: ${token}`))\n              } else {\n                // Token not yet received, just show port for now\n                console.log(ansis.dim(`   Open http://localhost:${port} in your browser`))\n                logDebug(`   (waiting for auth token...)`)\n              }\n            } else {\n              console.log(ansis.dim(`   Open http://localhost:${port} in your browser`))\n              console.log(ansis.yellow(`   \u26A0 Authentication disabled`))\n            }\n\n            if (withDanger) {\n              console.log(\n                ansis.yellow(`   \u26A0 Danger mode enabled - chat permissions will be skipped`)\n              )\n            }\n\n            console.log(ansis.blueBright(`Model name: ${model.manifest.name}`))\n            const drFolder = await getSpecReferencePath()\n            console.log(\n              `DR folder:    ${ansis.cyan(drFolder || \"Not found\")}`\n            )\n            console.log(`Model path:   ${ansis.cyan((await getModelPath()) || \"Not found\")}`)\n\n            // Optionally open browser\n            // If auth is enabled, delay opening until we have the token\n            const shouldOpenBrowser = !options.noBrowser\n            logDebug(\n              `Browser auto-open: ${shouldOpenBrowser ? \"enabled\" : \"disabled\"} (noBrowser=${options.noBrowser})`\n            )\n\n            if (shouldOpenBrowser && !authEnabled) {\n              // Auth disabled: open immediately\n              try {\n                const command = getOpenCommand()\n                const url = `http://localhost:${port}`\n                logDebug(`Opening browser with command: ${command} ${url}`)\n                spawn(command, [url], {\n                  detached: true,\n                  stdio: \"ignore\",\n                })\n              } catch (error) {\n                logVerbose(\"Could not auto-open browser (not critical)\")\n              }\n            } else if (shouldOpenBrowser && authEnabled && !authTokenFromServer) {\n              // Auth enabled but token not yet in this chunk: will open when TOKEN line is processed\n              logDebug(\"Browser auto-open deferred until token is received\")\n            } else {\n              logDebug(\"Browser auto-open disabled\")\n            }\n          }\n\n          // Log other output\n          if (!line.startsWith(\"TOKEN:\")) {\n            logDebug(`[server] ${line}`)\n          }\n        }\n      })\n    }\n\n    // Capture stderr\n    if (serverProcess.stderr) {\n      serverProcess.stderr.on(\"data\", (data) => {\n        const output = data.toString().trim()\n        if (output) {\n          serverOutput += output + \"\\n\"\n          // Log stderr at debug level so --debug flag shows telemetry exporter logs\n          logDebug(`[server stderr] ${output}`)\n        }\n      })\n    }\n\n    // Handle process close (fires after all stdio streams have closed)\n    let rejectKeepAlive: ((reason: Error) => void) | null = null\n\n    serverProcess.on(\"close\", (code) => {\n      if (code !== 0) {\n        // Include server output in error message if available (avoid separate logDebug to prevent minification issues)\n        const message = serverOutput\n          ? `Server exited with code ${code}\\nServer output:\\n${serverOutput}`\n          : `Server exited with code ${code}`\n\n        // Record error in startup span if still active\n        if (isTelemetryEnabled && serverStartupSpan) {\n          (async () => {\n            const { endSpan } = await import(\"../telemetry/index.js\")\n            if (\"recordException\" in serverStartupSpan) {\n              (serverStartupSpan as any).recordException(new Error(message));\n              (serverStartupSpan as any).setStatus({ code: 2, message }) // ERROR\n            }\n            endSpan(serverStartupSpan)\n            serverStartupSpan = null\n          })()\n        }\n\n        // Print error before rejecting (CLI wrapper expects CLIError messages to be pre-printed)\n        console.error(message)\n        const error = new CLIError(message, code || 1)\n        if (rejectKeepAlive) {\n          rejectKeepAlive(error)\n        }\n      }\n    })\n\n    // Handle process errors\n    serverProcess.on(\"error\", (error) => {\n      const errorCode = (error as NodeJS.ErrnoException).code\n      let message: string\n      let suggestions: string[] | undefined\n\n      // The server subprocess is launched via process.execPath (the same node/bun\n      // binary already running this CLI), so it's always present - ENOENT here would\n      // indicate something unusual about the runtime environment rather than a missing\n      // dependency (see #800: this used to hard-depend on a separately installed `bun`).\n      if (errorCode === \"EACCES\") {\n        message = `dr visualize could not run the visualization server: permission denied executing ${process.execPath}.`\n        suggestions = [`Check that ${process.execPath} is executable (chmod +x).`]\n      } else {\n        message = `Failed to start visualization server: ${error.message}`\n      }\n\n      // Record error in startup span if still active\n      if (isTelemetryEnabled && serverStartupSpan) {\n        (async () => {\n          const { endSpan } = await import(\"../telemetry/index.js\")\n          if (\"recordException\" in serverStartupSpan) {\n            (serverStartupSpan as any).recordException(error);\n            (serverStartupSpan as any).setStatus({ code: 2, message }) // ERROR\n          }\n          endSpan(serverStartupSpan)\n          serverStartupSpan = null\n        })()\n      }\n\n      // Don't print here: rejecting propagates this CLIError up through the catch block\n      // below to the top-level CLI handler, which prints `.format()` (including\n      // `suggestions`) exactly once. Printing here too would duplicate the whole block.\n      const cliError = new CLIError(message, 1, suggestions)\n      if (rejectKeepAlive) {\n        rejectKeepAlive(cliError)\n      }\n    })\n\n    // Setup periodic telemetry flushing for long-running command\n    // Since the visualize command never completes (keep-alive pattern),\n    // the cli.execute span would never end and export. We flush periodically\n    // to ensure active spans are exported to the telemetry backend.\n    let flushInterval: NodeJS.Timeout | null = null\n    if (isTelemetryEnabled) {\n      logDebug(\"[Telemetry] Setting up periodic flush (every 15 seconds)\")\n      const { flushTelemetry } = await import(\"../telemetry/index.js\")\n\n      flushInterval = setInterval(async () => {\n        logDebug(\"[Telemetry] Periodic flush: flushing pending spans...\")\n        try {\n          await flushTelemetry()\n          logDebug(\"[Telemetry] Periodic flush complete\")\n        } catch (error) {\n          // Silently ignore flush errors - telemetry should never break the app\n          logDebug(`[Telemetry] Periodic flush failed: ${error}`)\n        }\n      }, 15000) // Flush every 15 seconds\n    }\n\n    // Handle graceful shutdown on SIGINT (Ctrl-C) and SIGTERM\n    const handleShutdown = async (signal: string) => {\n      logDebug(`\\n[${signal}] Shutting down visualization server gracefully...`)\n\n      // Clear periodic flush interval\n      if (flushInterval) {\n        logDebug(\"[Telemetry] Stopping periodic flush\")\n        clearInterval(flushInterval)\n        flushInterval = null\n      }\n\n      // Forward signal to server process for graceful shutdown\n      if (serverProcess && !serverProcess.killed) {\n        logDebug(\"Sending termination signal to server process...\")\n        serverProcess.kill(signal as NodeJS.Signals)\n\n        // Wait for server to exit (with timeout)\n        await new Promise<void>((resolve) => {\n          const timeout = setTimeout(() => {\n            logDebug(\"Server shutdown timeout, forcing exit...\")\n            if (!serverProcess.killed) {\n              serverProcess.kill(\"SIGKILL\")\n            }\n            resolve()\n          }, 3000) // 3 second timeout\n\n          serverProcess.on(\"exit\", () => {\n            clearTimeout(timeout)\n            resolve()\n          })\n        })\n      }\n\n      logDebug(\"Visualization server stopped\")\n      process.exit(0)\n    }\n\n    // Register signal handlers\n    process.on(\"SIGINT\", () => handleShutdown(\"SIGINT\"))\n    process.on(\"SIGTERM\", () => handleShutdown(\"SIGTERM\"))\n\n    // Keep parent process alive - reject promise if server fails\n    await new Promise((_, reject) => {\n      rejectKeepAlive = reject\n    })\n  } catch (error) {\n    // Throw CLIError instead of process.exit to allow telemetry shutdown\n    // Note: Avoid side effects (like logDebug) before throw to prevent minification issues\n    if (error instanceof CLIError) {\n      // CLIError should have already printed its message\n      throw error\n    }\n    // Non-CLIError needs to be printed and wrapped\n    const message = getErrorMessage(error)\n    console.error(message)\n    throw new CLIError(message, 1)\n  }\n}\n\n/**\n * Get the appropriate command to open a URL\n */\nfunction getOpenCommand(): string {\n  const platform = process.platform\n\n  if (platform === \"darwin\") {\n    return \"open\"\n  }\n  if (platform === \"win32\") {\n    return \"start\"\n  }\n  // Linux and others\n  return \"xdg-open\"\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/server/server.js

@@ -1,11 +1,14 @@
 import { OpenAPIHono, createRoute, z } from "@hono/zod-openapi";
 import { cors } from "hono/cors";
 import { swaggerUI } from "@hono/swagger-ui";
+import { serve } from "@hono/node-server";
+import { createNodeWebSocket } from "@hono/node-ws";
+import { spawn, spawnSync } from "child_process";
+import chokidar from "chokidar";
 import { randomBytes } from "crypto";
 import { createRequire } from "module";
 import { fileURLToPath } from "url";
 import path from "path";
-let upgradeWebSocket, websocket;
 const require2 = createRequire(import.meta.url);
 import { Model } from "../core/model.js";
 import { StagedChangesetStorage } from "../core/staged-changeset-storage.js";
@@ -31,7 +34,9 @@ class VisualizationServer {
   app;
   model;
   _server;
-  // Bun.serve return type, loaded dynamically
+  // Node HTTP server returned by @hono/node-server
+  upgradeWebSocket;
+  injectWebSocket;
   clients = /* @__PURE__ */ new Set();
   watcher;
   annotations = /* @__PURE__ */ new Map();
@@ -50,7 +55,7 @@ class VisualizationServer {
   viewerPath;
   // Optional custom viewer path
   activeChatProcesses = /* @__PURE__ */ new Map();
-  // conversationId -> Bun.spawn process
+  // conversationId -> spawned chat process
   chatConversationCounter = 0;
   selectedChatClient;
   // Selected chat client for server
@@ -119,7 +124,7 @@ class VisualizationServer {
     }), ids;
   })();
   constructor(model, options) {
-    this.app = new OpenAPIHono(), this.model = model, this.loadBunAdapters(), this.authEnabled = options?.authEnabled ?? process.env.DR_AUTH_ENABLED !== "false", this.authToken = options?.authToken || process.env.DR_AUTH_TOKEN || this.generateAuthToken(), this.withDanger = options?.withDanger || !1, this.viewerPath = options?.viewerPath || new URL("../viewer", import.meta.url).pathname, !this.authEnabled && options?.authToken && console.warn("[VisualizationServer] Warning: authToken provided but authEnabled is false. The token will be generated but not used for authentication. Set authEnabled: true to enable authentication."), this.app.use("/*", cors()), this.app.use("/*", telemetryMiddleware), this.app.use("/api/*", async (c, next) => {
+    this.app = new OpenAPIHono(), this.model = model, this.loadWebSocketAdapter(), this.authEnabled = options?.authEnabled ?? process.env.DR_AUTH_ENABLED !== "false", this.authToken = options?.authToken || process.env.DR_AUTH_TOKEN || this.generateAuthToken(), this.withDanger = options?.withDanger || !1, this.viewerPath = options?.viewerPath || new URL("../viewer", import.meta.url).pathname, !this.authEnabled && options?.authToken && console.warn("[VisualizationServer] Warning: authToken provided but authEnabled is false. The token will be generated but not used for authentication. Set authEnabled: true to enable authentication."), this.app.use("/*", cors()), this.app.use("/*", telemetryMiddleware), this.app.use("/api/*", async (c, next) => {
       if (!this.authEnabled)
         return next();
       const authHeader = c.req.header("Authorization"), queryToken = c.req.query("token");
@@ -130,19 +135,21 @@ class VisualizationServer {
     });
   }
   /**
-   * Load Bun-specific WebSocket adapters if available
-   * This is called in the constructor to support WebSocket functionality in Bun runtime
-   * In Node.js/tsx environments (e.g., generating OpenAPI spec), these imports are skipped
+   * Set up the WebSocket adapter for this server instance
+   * This is called in the constructor to support WebSocket functionality via @hono/node-ws,
+   * which works identically under Node.js and Bun (both implement Node's http module).
+   * Wrapped in try/catch as a defensive guard so a WS setup failure would degrade the
+   * server gracefully (no /ws route) rather than crash construction entirely, in case
+   * this ever becomes fallible again in the future.
    */
-  loadBunAdapters() {
-    if (typeof global.Bun < "u")
-      try {
-        const honoModule = require2("hono/bun");
-        upgradeWebSocket = honoModule.upgradeWebSocket, websocket = honoModule.websocket;
-      } catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.warn(`[Server] WARNING: Could not load WebSocket adapters from hono/bun: ${message}. WebSocket endpoints (/ws) will not be available. Please ensure 'hono' is installed and the Bun runtime is properly configured.`), process.env.VERBOSE && error instanceof Error && error.stack && console.debug("[Server] Stack trace:", error.stack);
-      }
+  loadWebSocketAdapter() {
+    try {
+      const { injectWebSocket, upgradeWebSocket } = createNodeWebSocket({ app: this.app });
+      this.injectWebSocket = injectWebSocket, this.upgradeWebSocket = upgradeWebSocket;
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      console.warn(`[Server] WARNING: Could not set up WebSocket adapter: ${message}. WebSocket endpoints (/ws) will not be available.`), process.env.VERBOSE && error instanceof Error && error.stack && console.debug("[Server] Stack trace:", error.stack);
+    }
   }
   /**
    * Detect and initialize available chat clients
@@ -858,7 +865,7 @@ class VisualizationServer {
         { name: "Annotations", description: "User annotations on model elements" },
         { name: "WebSocket", description: "Real-time updates via WebSocket" }
       ]
-    }), this.app.get("/api-docs", swaggerUI({ url: "/api-spec.yaml" })), upgradeWebSocket && this.app.get("/ws", async (c, next) => {
+    }), this.app.get("/api-docs", swaggerUI({ url: "/api-spec.yaml" })), this.upgradeWebSocket && this.app.get("/ws", async (c, next) => {
       if (this.authEnabled) {
         const queryToken = c.req.query("token"), wsProtocol = c.req.header("Sec-WebSocket-Protocol");
         let protocolToken = null;
@@ -876,7 +883,7 @@ class VisualizationServer {
         protocolToken && c.header("Sec-WebSocket-Protocol", "token");
       }
       return next();
-    }, upgradeWebSocket(() => ({
+    }, this.upgradeWebSocket(() => ({
       onOpen: async (_evt, ws) => {
         await this.recordWebSocketEvent("ws.connection.open", {
           "ws.client_count": this.clients.size + 1
@@ -1274,23 +1281,33 @@ class VisualizationServer {
     try {
       const cmd = ["claude", "--agent", "dr-architect", "--print"];
       this.withDanger && cmd.push("--dangerously-skip-permissions"), cmd.push("--verbose", "--output-format", "stream-json");
-      const proc = Bun.spawn({
-        cmd,
+      const proc = spawn(cmd[0], cmd.slice(1), {
         cwd: this.model.rootPath,
-        stdin: "pipe",
-        stdout: "pipe",
-        stderr: "pipe"
+        stdio: ["pipe", "pipe", "pipe"]
       });
-      this.activeChatProcesses.set(conversationId, proc), proc.stdin?.write(new TextEncoder().encode(message)), proc.stdin?.end();
-      const stdoutReader = proc.stdout.getReader(), decoder = new TextDecoder();
+      proc.on("error", (err) => {
+        const errorMsg = getErrorMessage(err);
+        console.error(`[Claude Code] Failed to spawn subprocess for conversation ${conversationId}: ${errorMsg}`), this.activeChatProcesses.delete(conversationId);
+        try {
+          ws.send(JSON.stringify({
+            jsonrpc: "2.0",
+            error: {
+              code: JSONRPC_ERRORS.INTERNAL_ERROR,
+              message: `Failed to launch Claude Code: ${errorMsg}`
+            },
+            id: requestId
+          }));
+        } catch (sendError) {
+          console.error(`[Claude Code] Failed to send spawn-error notification: ${getErrorMessage(sendError)}`);
+        }
+      }), proc.stdin?.on("error", () => {
+      }), this.activeChatProcesses.set(conversationId, proc), proc.stdin?.write(message), proc.stdin?.end();
+      const decoder = new TextDecoder();
       (async () => {
         let accumulatedText = "", buffer = "";
         try {
-          for (; ; ) {
-            const { done, value } = await stdoutReader.read();
-            if (done)
-              break;
-            const chunk = decoder.decode(value, { stream: !0 });
+          for await (const chunkBuf of proc.stdout) {
+            const chunk = decoder.decode(chunkBuf, { stream: !0 });
             buffer += chunk;
             const lines = buffer.split(`
 `);
@@ -1354,7 +1371,7 @@ class VisualizationServer {
               timestamp: (/* @__PURE__ */ new Date()).toISOString()
             }
           }));
-          const exitCode = await proc.exited;
+          const exitCode = await this.waitForExit(proc);
           this.activeChatProcesses.delete(conversationId), ws.send(JSON.stringify({
             jsonrpc: "2.0",
             result: {
@@ -1367,6 +1384,8 @@ class VisualizationServer {
             id: requestId
           }));
         } catch (error) {
+          if (!proc.pid)
+            return;
           const errorMsg = getErrorMessage(error);
           ws.send(JSON.stringify({
             jsonrpc: "2.0",
@@ -1416,28 +1435,37 @@ class VisualizationServer {
   async launchCopilotChat(ws, conversationId, message, requestId) {
     try {
       let cmd;
-      Bun.spawnSync({
-        cmd: ["gh", "copilot", "--version"],
-        stdout: "pipe",
-        stderr: "pipe"
-      }).exitCode === 0 ? (cmd = ["gh", "copilot", "explain"], this.withDanger && cmd.push("--allow-all-tools"), cmd.push(message)) : (cmd = ["copilot", "explain"], this.withDanger && cmd.push("--allow-all-tools"), cmd.push(message));
-      const proc = Bun.spawn({
-        cmd,
+      const ghResult = spawnSync("gh", ["copilot", "--version"], {
+        stdio: ["ignore", "pipe", "pipe"]
+      });
+      ghResult.error ? console.warn(`[Copilot] 'gh copilot --version' probe failed to spawn: ${getErrorMessage(ghResult.error)}`) : ghResult.status !== 0 && process.env.VERBOSE && console.log(`[Copilot] 'gh copilot' unavailable (exit ${ghResult.status}), falling back to standalone 'copilot'`), ghResult.status === 0 ? (cmd = ["gh", "copilot", "explain"], this.withDanger && cmd.push("--allow-all-tools"), cmd.push(message)) : (cmd = ["copilot", "explain"], this.withDanger && cmd.push("--allow-all-tools"), cmd.push(message));
+      const proc = spawn(cmd[0], cmd.slice(1), {
         cwd: this.model.rootPath,
-        stdin: "pipe",
-        stdout: "pipe",
-        stderr: "pipe"
+        stdio: ["pipe", "pipe", "pipe"]
       });
-      this.activeChatProcesses.set(conversationId, proc);
-      const stdoutReader = proc.stdout.getReader(), decoder = new TextDecoder();
+      proc.on("error", (err) => {
+        const errorMsg = getErrorMessage(err);
+        console.error(`[Copilot] Failed to spawn subprocess for conversation ${conversationId}: ${errorMsg}`), this.activeChatProcesses.delete(conversationId);
+        try {
+          ws.send(JSON.stringify({
+            jsonrpc: "2.0",
+            error: {
+              code: JSONRPC_ERRORS.INTERNAL_ERROR,
+              message: `Failed to launch GitHub Copilot: ${errorMsg}`
+            },
+            id: requestId
+          }));
+        } catch (sendError) {
+          console.error(`[Copilot] Failed to send spawn-error notification: ${getErrorMessage(sendError)}`);
+        }
+      }), proc.stdin?.on("error", () => {
+      }), this.activeChatProcesses.set(conversationId, proc);
+      const decoder = new TextDecoder();
       (async () => {
         let accumulatedText = "";
         try {
-          for (; ; ) {
-            const { done, value } = await stdoutReader.read();
-            if (done)
-              break;
-            const chunk = decoder.decode(value, { stream: !0 });
+          for await (const chunkBuf of proc.stdout) {
+            const chunk = decoder.decode(chunkBuf, { stream: !0 });
             accumulatedText += chunk, ws.send(JSON.stringify({
               jsonrpc: "2.0",
               method: "chat.response.chunk",
@@ -1449,7 +1477,7 @@ class VisualizationServer {
               }
             }));
           }
-          const exitCode = await proc.exited;
+          const exitCode = await this.waitForExit(proc);
           this.activeChatProcesses.delete(conversationId), ws.send(JSON.stringify({
             jsonrpc: "2.0",
             result: {
@@ -1462,6 +1490,8 @@ class VisualizationServer {
             id: requestId
           }));
         } catch (error) {
+          if (!proc.pid)
+            return;
           const errorMsg = getErrorMessage(error);
           ws.send(JSON.stringify({
             jsonrpc: "2.0",
@@ -1496,35 +1526,33 @@ class VisualizationServer {
    * Setup file watcher for model changes
    */
   setupFileWatcher() {
-    const modelPath = `${this.model.rootPath}/documentation-robotics/model`, bunWatch = globalThis.Bun?.watch;
-    if (!bunWatch) {
-      console.warn("[Watcher] Bun.watch not available, file watching disabled");
-      return;
-    }
+    const modelPath = `${this.model.rootPath}/documentation-robotics/model`;
     try {
-      this.watcher = bunWatch(modelPath, {
-        recursive: !0,
-        onChange: async (_event, path2) => {
-          process.env.VERBOSE && console.log(`[Watcher] File changed: ${path2}`);
-          try {
-            this.model = await Model.load(this.model.rootPath, { lazyLoad: !1 }), await this.loadChangesetsFromDisk();
-            const modelData = await this.serializeModel(), message = JSON.stringify({
-              type: "model.updated",
-              data: modelData,
-              timestamp: (/* @__PURE__ */ new Date()).toISOString()
-            });
-            for (const client of this.clients)
-              try {
-                client.send(message);
-              } catch (error) {
-                const msg = getErrorMessage(error);
-                console.warn(`[Watcher] Failed to send update: ${msg}`);
-              }
-          } catch (error) {
-            const message = getErrorMessage(error);
-            console.error(`[Watcher] Failed to reload model: ${message}`);
-          }
+      this.watcher = chokidar.watch(modelPath, {
+        persistent: !0,
+        ignoreInitial: !0
+      }), this.watcher.on("all", async (_event, path2) => {
+        process.env.VERBOSE && console.log(`[Watcher] File changed: ${path2}`);
+        try {
+          this.model = await Model.load(this.model.rootPath, { lazyLoad: !1 }), await this.loadChangesetsFromDisk();
+          const modelData = await this.serializeModel(), message = JSON.stringify({
+            type: "model.updated",
+            data: modelData,
+            timestamp: (/* @__PURE__ */ new Date()).toISOString()
+          });
+          for (const client of this.clients)
+            try {
+              client.send(message);
+            } catch (error) {
+              const msg = getErrorMessage(error);
+              console.warn(`[Watcher] Failed to send update: ${msg}`);
+            }
+        } catch (error) {
+          const message = getErrorMessage(error);
+          console.error(`[Watcher] Failed to reload model: ${message}`);
         }
+      }), this.watcher.on("error", (err) => {
+        console.warn(`[Watcher] Could not watch ${modelPath}: ${getErrorMessage(err)}`);
       });
     } catch (err) {
       console.warn(`[Watcher] Could not watch ${modelPath}: ${err}`);
@@ -2226,14 +2254,14 @@ class VisualizationServer {
    * Start the server
    */
   async start(port = 8080) {
-    this.changesetStorage = new StagedChangesetStorage(this.model.rootPath), await this.loadChangesetsFromDisk(), this.setupFileWatcher();
-    const { serve } = await import("bun");
-    this._server = serve({
+    this.changesetStorage = new StagedChangesetStorage(this.model.rootPath), await this.loadChangesetsFromDisk(), this.setupFileWatcher(), this._server = serve({
       port,
-      fetch: this.app.fetch,
-      websocket
-      // Add WebSocket handler from hono/bun
-    }), console.log(`\u2713 Visualization server running at http://localhost:${port}`);
+      fetch: this.app.fetch
+    }), await new Promise((resolve, reject) => {
+      this._server.once("listening", resolve), this._server.once("error", (err) => {
+        err.code === "EADDRINUSE" ? reject(new Error(`Port ${port} is already in use. Try a different port with --port <port>.`)) : reject(err);
+      });
+    }), this.injectWebSocket?.(this._server), console.log(`\u2713 Visualization server running at http://localhost:${port}`);
   }
   /**
    * Get the current auth token
@@ -2247,6 +2275,34 @@ class VisualizationServer {
   isAuthEnabled() {
     return this.authEnabled;
   }
+  /**
+   * Wait for a spawned child process to exit and resolve with its exit code
+   * Node's ChildProcess doesn't expose a Bun-style `.exited` promise, so this
+   * wraps the "exit" event (or the already-set exitCode, if it fired before
+   * we started listening).
+   */
+  waitForExit(proc) {
+    return new Promise((resolve) => {
+      if (proc.exitCode !== null) {
+        resolve(proc.exitCode);
+        return;
+      }
+      proc.once("exit", (code) => resolve(code ?? 0));
+    });
+  }
+  /**
+   * Whether a child process has actually terminated.
+   *
+   * NOTE: Node's `ChildProcess.killed` means "kill() was successfully used to send a
+   * signal" — it does NOT mean the process has exited (a process can ignore SIGTERM
+   * and keep running with `.killed === true`). This differs from Bun's
+   * `Subprocess.killed`, which does mean "has the process exited". Use exitCode/
+   * signalCode (set only once the process has actually terminated) instead of
+   * `.killed` to decide whether retry/escalation is still needed.
+   */
+  hasExited(proc) {
+    return proc.exitCode !== null || proc.signalCode !== null;
+  }
   /**
    * Kill a process with retry logic and exponential backoff
    * Attempts graceful SIGTERM first, then force SIGKILL if needed
@@ -2256,7 +2312,7 @@ class VisualizationServer {
     const baseDelay = 100;
     for (; attempt < 3; ) {
       try {
-        if (proc.killed || (proc.kill("SIGTERM"), await new Promise((resolve) => setTimeout(resolve, 500)), proc.killed))
+        if (this.hasExited(proc) || (proc.kill("SIGTERM"), await new Promise((resolve) => setTimeout(resolve, 500)), this.hasExited(proc)))
           return;
       } catch {
       }
@@ -2266,7 +2322,7 @@ class VisualizationServer {
       }
     }
     try {
-      proc.killed || (proc.kill("SIGKILL"), console.warn(`[${label}] Process for conversation ${conversationId} did not respond to SIGTERM, force killed with SIGKILL`));
+      this.hasExited(proc) || (proc.kill("SIGKILL"), console.warn(`[${label}] Process for conversation ${conversationId} did not respond to SIGTERM, force killed with SIGKILL`));
     } catch (error) {
       throw new Error(`Failed to kill process: ${error instanceof Error ? error.message : String(error)}`);
     }
@@ -2282,7 +2338,9 @@ class VisualizationServer {
         const errorMessage = error instanceof Error ? error.message : String(error);
         errorMessage.includes("already closed") || console.warn(`[SERVER] Unexpected error closing WebSocket client: ${errorMessage}`);
       }
-    this.clients.clear(), this.watcher && this.watcher.close?.(), this._server && this._server.stop();
+    this.clients.clear(), this.watcher && this.watcher.close?.(), this._server && this._server.close((error) => {
+      error && process.env.VERBOSE && console.warn(`[SERVER] Error while closing HTTP server: ${getErrorMessage(error)}`);
+    });
   }
 }
 export {