buildwithnexus 0.2.4 → 0.2.6

package/dist/bin.js

@@ -16,7 +16,7 @@ var BANNER = `
 `;
 function showBanner() {
   console.log(BANNER);
-  console.log(chalk.dim("  v0.2.4 \xB7 buildwithnexus.dev\n"));
+  console.log(chalk.dim("  v0.2.6 \xB7 buildwithnexus.dev\n"));
 }
 function showPhase(phase, total, description) {
   const progress = chalk.cyan(`[${phase}/${total}]`);
@@ -461,6 +461,8 @@ import fs3 from "fs";
 import net from "net";
 import path3 from "path";
 import { execa } from "execa";
+import { select } from "@inquirer/prompts";
+import chalk5 from "chalk";
 var VM_DIR = path3.join(NEXUS_HOME2, "vm");
 var IMAGES_DIR = path3.join(VM_DIR, "images");
 var PID_FILE = path3.join(VM_DIR, "qemu.pid");
@@ -500,29 +502,95 @@ async function createDisk(basePath, sizeGb) {
   await execa("qemu-img", ["create", "-f", "qcow2", "-b", basePath, "-F", "qcow2", diskPath, `${sizeGb}G`], { env: scrubEnv() });
   return diskPath;
 }
-function isPortFree(port) {
+function tryBind(port, host) {
   return new Promise((resolve) => {
     const server = net.createServer();
     server.once("error", () => resolve(false));
     server.once("listening", () => {
       server.close(() => resolve(true));
     });
-    server.listen(port, "127.0.0.1");
+    server.listen(port, host);
   });
 }
+async function isPortFree(port) {
+  const free0 = await tryBind(port, "0.0.0.0");
+  if (!free0) return false;
+  const free1 = await tryBind(port, "127.0.0.1");
+  return free1;
+}
+async function getPortBlocker(port) {
+  try {
+    const { stdout } = await execa("lsof", ["-i", `:${port}`, "-t", "-sTCP:LISTEN"], { env: scrubEnv() });
+    const pid = parseInt(stdout.trim().split("\n")[0], 10);
+    if (!pid) return null;
+    try {
+      const { stdout: psOut } = await execa("ps", ["-p", String(pid), "-o", "comm="], { env: scrubEnv() });
+      return { port, pid, process: psOut.trim() };
+    } catch {
+      return { port, pid, process: "unknown" };
+    }
+  } catch {
+    return null;
+  }
+}
 async function findFreePort(preferred, max = 20) {
   for (let offset = 0; offset < max; offset++) {
-    const port = preferred + offset;
-    if (await isPortFree(port)) return port;
+    if (await isPortFree(preferred + offset)) return preferred + offset;
   }
   throw new Error(`No free port found near ${preferred}`);
 }
+async function resolvePortConflicts(ports) {
+  const labels = { ssh: "SSH", http: "HTTP", https: "HTTPS" };
+  const resolved2 = { ...ports };
+  for (const [key, port] of Object.entries(ports)) {
+    if (await isPortFree(port)) continue;
+    const blocker = await getPortBlocker(port);
+    const desc = blocker ? `${blocker.process} (PID ${blocker.pid})` : "unknown process";
+    const altPort = await findFreePort(port + 1).catch(() => null);
+    const choices = [];
+    if (blocker) {
+      choices.push({
+        name: `Kill ${desc} and use port ${port}`,
+        value: "kill"
+      });
+    }
+    if (altPort) {
+      choices.push({
+        name: `Use alternate port ${altPort} instead`,
+        value: "alt"
+      });
+    }
+    choices.push({ name: "Abort init", value: "abort" });
+    console.log("");
+    console.log(chalk5.yellow(`  \u26A0 Port ${port} (${labels[key]}) is in use by ${desc}`));
+    const action = await select({
+      message: `How would you like to resolve the ${labels[key]} port conflict?`,
+      choices
+    });
+    if (action === "kill" && blocker) {
+      try {
+        process.kill(blocker.pid, "SIGTERM");
+        await new Promise((r) => setTimeout(r, 1e3));
+        if (!await isPortFree(port)) {
+          process.kill(blocker.pid, "SIGKILL");
+          await new Promise((r) => setTimeout(r, 500));
+        }
+        console.log(chalk5.green(`  \u2713 Killed ${desc}, port ${port} is now free`));
+      } catch {
+        console.log(chalk5.red(`  \u2717 Failed to kill PID ${blocker.pid}. Try: sudo kill ${blocker.pid}`));
+        process.exit(1);
+      }
+    } else if (action === "alt" && altPort) {
+      resolved2[key] = altPort;
+      console.log(chalk5.green(`  \u2713 Using port ${altPort} for ${labels[key]}`));
+    } else {
+      console.log(chalk5.dim("  Init aborted."));
+      process.exit(0);
+    }
+  }
+  return resolved2;
+}
 async function launchVm(platform, diskPath, initIsoPath, ram, cpus, ports) {
-  const resolved = {
-    ssh: await findFreePort(ports.ssh),
-    http: await findFreePort(ports.http),
-    https: await findFreePort(ports.https)
-  };
   const machineArg = platform.os === "mac" ? "-machine virt,gic-version=3" : "-machine pc";
   const biosArgs = fs3.existsSync(platform.biosPath) ? ["-bios", platform.biosPath] : [];
   const args = [
@@ -1001,14 +1069,16 @@ var initCommand = new Command("init").description("Scaffold and launch a new NEX
     const isoPath = await createCloudInitIso(userDataPath);
     succeed(spinner, "Cloud-init ISO created");
     showPhase(6, TOTAL_PHASES, "VM Launch");
+    spinner = createSpinner("Checking port availability...");
+    spinner.start();
+    const requestedPorts = { ssh: config.sshPort, http: config.httpPort, https: config.httpsPort };
+    spinner.stop();
+    spinner.clear();
+    const resolvedPorts = await resolvePortConflicts(requestedPorts);
     spinner = createSpinner("Creating disk and launching VM...");
     spinner.start();
     const diskPath = await createDisk(imagePath, config.vmDisk);
-    const resolvedPorts = await launchVm(platform, diskPath, isoPath, config.vmRam, config.vmCpus, {
-      ssh: config.sshPort,
-      http: config.httpPort,
-      https: config.httpsPort
-    });
+    await launchVm(platform, diskPath, isoPath, config.vmRam, config.vmCpus, resolvedPorts);
     config.sshPort = resolvedPorts.ssh;
     config.httpPort = resolvedPorts.http;
     config.httpsPort = resolvedPorts.https;
@@ -1185,7 +1255,7 @@ var stopCommand = new Command3("stop").description("Gracefully shut down the NEX
 
 // src/commands/status.ts
 import { Command as Command4 } from "commander";
-import chalk5 from "chalk";
+import chalk6 from "chalk";
 var statusCommand = new Command4("status").description("Check NEXUS runtime health").option("--json", "Output as JSON").action(async (opts) => {
   const config = loadConfig();
   if (!config) {
@@ -1198,15 +1268,15 @@ var statusCommand = new Command4("status").description("Check NEXUS runtime heal
     console.log(JSON.stringify({ ...health, pid: getVmPid(), ports: { ssh: config.sshPort, http: config.httpPort, https: config.httpsPort } }, null, 2));
     return;
   }
-  const check = (ok) => ok ? chalk5.green("\u25CF") : chalk5.red("\u25CB");
+  const check = (ok) => ok ? chalk6.green("\u25CF") : chalk6.red("\u25CB");
   console.log("");
-  console.log(chalk5.bold("  NEXUS Runtime Status"));
+  console.log(chalk6.bold("  NEXUS Runtime Status"));
   console.log("");
-  console.log(`  ${check(health.vmRunning)}  VM         ${health.vmRunning ? chalk5.green("running") + chalk5.dim(` (PID ${getVmPid()})`) : chalk5.red("stopped")}`);
-  console.log(`  ${check(health.sshReady)}  SSH        ${health.sshReady ? chalk5.green("connected") + chalk5.dim(` (port ${config.sshPort})`) : chalk5.red("unreachable")}`);
-  console.log(`  ${check(health.dockerReady)}  Docker     ${health.dockerReady ? chalk5.green("ready") : chalk5.red("not ready")}`);
-  console.log(`  ${check(health.serverHealthy)}  Server     ${health.serverHealthy ? chalk5.green("healthy") + chalk5.dim(` (port ${config.httpPort})`) : chalk5.red("unhealthy")}`);
-  console.log(`  ${check(!!health.tunnelUrl)}  Tunnel     ${health.tunnelUrl ? chalk5.green(health.tunnelUrl) : chalk5.dim("not active")}`);
+  console.log(`  ${check(health.vmRunning)}  VM         ${health.vmRunning ? chalk6.green("running") + chalk6.dim(` (PID ${getVmPid()})`) : chalk6.red("stopped")}`);
+  console.log(`  ${check(health.sshReady)}  SSH        ${health.sshReady ? chalk6.green("connected") + chalk6.dim(` (port ${config.sshPort})`) : chalk6.red("unreachable")}`);
+  console.log(`  ${check(health.dockerReady)}  Docker     ${health.dockerReady ? chalk6.green("ready") : chalk6.red("not ready")}`);
+  console.log(`  ${check(health.serverHealthy)}  Server     ${health.serverHealthy ? chalk6.green("healthy") + chalk6.dim(` (port ${config.httpPort})`) : chalk6.red("unhealthy")}`);
+  console.log(`  ${check(!!health.tunnelUrl)}  Tunnel     ${health.tunnelUrl ? chalk6.green(health.tunnelUrl) : chalk6.dim("not active")}`);
   console.log("");
   if (health.serverHealthy) {
     log.success(`NEXUS CLI ready \u2014 connect via: buildwithnexus ssh`);
@@ -1215,18 +1285,18 @@ var statusCommand = new Command4("status").description("Check NEXUS runtime heal
 
 // src/commands/doctor.ts
 import { Command as Command5 } from "commander";
-import chalk6 from "chalk";
+import chalk7 from "chalk";
 import fs7 from "fs";
 import path8 from "path";
 import { execa as execa4 } from "execa";
 var doctorCommand = new Command5("doctor").description("Diagnose NEXUS runtime environment").action(async () => {
   const platform = detectPlatform();
-  const check = (ok) => ok ? chalk6.green("\u2713") : chalk6.red("\u2717");
+  const check = (ok) => ok ? chalk7.green("\u2713") : chalk7.red("\u2717");
   console.log("");
-  console.log(chalk6.bold("  NEXUS Doctor"));
+  console.log(chalk7.bold("  NEXUS Doctor"));
   console.log("");
   const nodeOk = Number(process.versions.node.split(".")[0]) >= 18;
-  console.log(`  ${check(nodeOk)}  Node.js ${process.versions.node} ${nodeOk ? "" : chalk6.red("(need >= 18)")}`);
+  console.log(`  ${check(nodeOk)}  Node.js ${process.versions.node} ${nodeOk ? "" : chalk7.red("(need >= 18)")}`);
   console.log(`  ${check(true)}  Platform: ${platform.os} ${platform.arch}`);
   const qemuOk = await isQemuInstalled(platform);
   if (qemuOk) {
@@ -1266,14 +1336,14 @@ var doctorCommand = new Command5("doctor").description("Diagnose NEXUS runtime e
           });
           server.listen(port);
         });
-        console.log(`  ${check(available)}  Port ${port} (${name}) ${available ? "available" : chalk6.red("in use")}`);
+        console.log(`  ${check(available)}  Port ${port} (${name}) ${available ? "available" : chalk7.red("in use")}`);
       } catch {
         console.log(`  ${check(false)}  Port ${port} (${name}) \u2014 check failed`);
       }
     }
   }
   const biosOk = fs7.existsSync(platform.biosPath);
-  console.log(`  ${check(biosOk)}  UEFI firmware ${biosOk ? "" : chalk6.dim(platform.biosPath)}`);
+  console.log(`  ${check(biosOk)}  UEFI firmware ${biosOk ? "" : chalk7.dim(platform.biosPath)}`);
   console.log("");
   if (qemuOk && isoTool && biosOk) {
     log.success("Environment ready for NEXUS");
@@ -1377,7 +1447,7 @@ var updateCommand = new Command7("update").description("Update NEXUS to the late
 
 // src/commands/destroy.ts
 import { Command as Command8 } from "commander";
-import chalk7 from "chalk";
+import chalk8 from "chalk";
 import fs9 from "fs";
 import { input as input2 } from "@inquirer/prompts";
 import path10 from "path";
@@ -1385,11 +1455,11 @@ var destroyCommand = new Command8("destroy").description("Remove NEXUS VM and al
   const config = loadConfig();
   if (!opts.force) {
     console.log("");
-    console.log(chalk7.red.bold("  This will permanently delete:"));
-    console.log(chalk7.red("  - NEXUS VM and all data inside it"));
-    console.log(chalk7.red("  - VM disk images"));
-    console.log(chalk7.red("  - SSH keys"));
-    console.log(chalk7.red("  - Configuration and API keys"));
+    console.log(chalk8.red.bold("  This will permanently delete:"));
+    console.log(chalk8.red("  - NEXUS VM and all data inside it"));
+    console.log(chalk8.red("  - VM disk images"));
+    console.log(chalk8.red("  - SSH keys"));
+    console.log(chalk8.red("  - Configuration and API keys"));
     console.log("");
     const confirm2 = await input2({
       message: 'Type "destroy" to confirm:'
@@ -1433,7 +1503,7 @@ var destroyCommand = new Command8("destroy").description("Remove NEXUS VM and al
 // src/commands/keys.ts
 import { Command as Command9 } from "commander";
 import { password as password2 } from "@inquirer/prompts";
-import chalk8 from "chalk";
+import chalk9 from "chalk";
 var keysCommand = new Command9("keys").description("Manage API keys");
 keysCommand.command("list").description("Show configured API keys (masked)").action(() => {
   const keys = loadKeys();
@@ -1441,10 +1511,10 @@ keysCommand.command("list").description("Show configured API keys (masked)").act
     log.error("No keys configured. Run: buildwithnexus init");
     process.exit(1);
   }
-  console.log(chalk8.bold("\n  Configured Keys\n"));
+  console.log(chalk9.bold("\n  Configured Keys\n"));
   for (const [name, value] of Object.entries(keys)) {
     if (value) {
-      console.log(`  ${chalk8.cyan(name.padEnd(24))} ${maskKey(value)}`);
+      console.log(`  ${chalk9.cyan(name.padEnd(24))} ${maskKey(value)}`);
     }
   }
   console.log("");
@@ -1506,14 +1576,14 @@ var sshCommand = new Command10("ssh").description("Open an SSH session into the
 
 // src/commands/brainstorm.ts
 import { Command as Command11 } from "commander";
-import chalk9 from "chalk";
+import chalk10 from "chalk";
 import { input as input3 } from "@inquirer/prompts";
-var COS_PREFIX = chalk9.bold.cyan("  Chief of Staff");
-var YOU_PREFIX = chalk9.bold.white("  You");
-var DIVIDER = chalk9.dim("  " + "\u2500".repeat(56));
+var COS_PREFIX = chalk10.bold.cyan("  Chief of Staff");
+var YOU_PREFIX = chalk10.bold.white("  You");
+var DIVIDER = chalk10.dim("  " + "\u2500".repeat(56));
 function formatResponse(text) {
   const lines = text.split("\n");
-  return lines.map((line) => chalk9.white("  " + line)).join("\n");
+  return lines.map((line) => chalk10.white("  " + line)).join("\n");
 }
 async function sendMessage(sshPort, message, source) {
   const payload = JSON.stringify({ message, source });
@@ -1556,13 +1626,13 @@ var brainstormCommand = new Command11("brainstorm").description("Brainstorm an i
     }
     succeed(spinner, "Connected to NEXUS");
     console.log("");
-    console.log(chalk9.bold("  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557"));
-    console.log(chalk9.bold("  \u2551  ") + chalk9.bold.cyan("NEXUS Brainstorm Session") + chalk9.bold("                                \u2551"));
-    console.log(chalk9.bold("  \u2560\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2563"));
-    console.log(chalk9.bold("  \u2551  ") + chalk9.dim("The Chief of Staff will discuss your idea with the".padEnd(55)) + chalk9.bold("\u2551"));
-    console.log(chalk9.bold("  \u2551  ") + chalk9.dim("NEXUS team and share their recommendations.".padEnd(55)) + chalk9.bold("\u2551"));
-    console.log(chalk9.bold("  \u2551  ") + chalk9.dim("Type 'exit' or 'quit' to end the session.".padEnd(55)) + chalk9.bold("\u2551"));
-    console.log(chalk9.bold("  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D"));
+    console.log(chalk10.bold("  \u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557"));
+    console.log(chalk10.bold("  \u2551  ") + chalk10.bold.cyan("NEXUS Brainstorm Session") + chalk10.bold("                                \u2551"));
+    console.log(chalk10.bold("  \u2560\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2563"));
+    console.log(chalk10.bold("  \u2551  ") + chalk10.dim("The Chief of Staff will discuss your idea with the".padEnd(55)) + chalk10.bold("\u2551"));
+    console.log(chalk10.bold("  \u2551  ") + chalk10.dim("NEXUS team and share their recommendations.".padEnd(55)) + chalk10.bold("\u2551"));
+    console.log(chalk10.bold("  \u2551  ") + chalk10.dim("Type 'exit' or 'quit' to end the session.".padEnd(55)) + chalk10.bold("\u2551"));
+    console.log(chalk10.bold("  \u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D"));
     console.log("");
     let idea = ideaWords.length > 0 ? ideaWords.join(" ") : "";
     if (!idea) {
@@ -1579,7 +1649,7 @@ var brainstormCommand = new Command11("brainstorm").description("Brainstorm an i
     while (true) {
       turn++;
       if (turn === 1) {
-        console.log(`${YOU_PREFIX}: ${chalk9.white(idea)}`);
+        console.log(`${YOU_PREFIX}: ${chalk10.white(idea)}`);
       }
       console.log(DIVIDER);
       const thinking = createSpinner(
@@ -1597,17 +1667,17 @@ var brainstormCommand = new Command11("brainstorm").description("Brainstorm an i
       console.log(formatResponse(redact(response)));
       console.log(DIVIDER);
       const followUp = await input3({
-        message: chalk9.bold("You:")
+        message: chalk10.bold("You:")
       });
       const trimmed = followUp.trim().toLowerCase();
       if (!trimmed || trimmed === "exit" || trimmed === "quit" || trimmed === "q") {
         console.log("");
         log.success("Brainstorm session ended");
-        console.log(chalk9.dim("    Run again anytime: buildwithnexus brainstorm"));
+        console.log(chalk10.dim("    Run again anytime: buildwithnexus brainstorm"));
         console.log("");
         return;
       }
-      console.log(`${YOU_PREFIX}: ${chalk9.white(followUp)}`);
+      console.log(`${YOU_PREFIX}: ${chalk10.white(followUp)}`);
       currentMessage = `[BRAINSTORM FOLLOW-UP] The CEO responds: ${followUp}`;
     }
   } catch (err) {
@@ -1623,7 +1693,7 @@ var brainstormCommand = new Command11("brainstorm").description("Brainstorm an i
 });
 
 // src/cli.ts
-var cli = new Command12().name("buildwithnexus").description("Auto-scaffold and launch a fully autonomous NEXUS runtime").version("0.2.4");
+var cli = new Command12().name("buildwithnexus").description("Auto-scaffold and launch a fully autonomous NEXUS runtime").version("0.2.6");
 cli.addCommand(initCommand);
 cli.addCommand(startCommand);
 cli.addCommand(stopCommand);
@@ -1644,7 +1714,7 @@ import fs10 from "fs";
 import path11 from "path";
 import os3 from "os";
 import https from "https";
-import chalk10 from "chalk";
+import chalk11 from "chalk";
 var PACKAGE_NAME = "buildwithnexus";
 var CHECK_INTERVAL_MS = 4 * 60 * 60 * 1e3;
 var STATE_DIR = path11.join(os3.homedir(), ".buildwithnexus");
@@ -1725,8 +1795,8 @@ async function checkForUpdates(currentVersion) {
 function printUpdateBanner(current, latest) {
   const msg = [
     "",
-    chalk10.yellow(`  Update available: ${current} \u2192 ${latest}`),
-    chalk10.cyan(`  Run: npm update -g buildwithnexus`),
+    chalk11.yellow(`  Update available: ${current} \u2192 ${latest}`),
+    chalk11.cyan(`  Run: npm update -g buildwithnexus`),
     ""
   ].join("\n");
   process.stderr.write(msg + "\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "buildwithnexus",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Launch an autonomous AI runtime with triple-nested VM isolation in one command",
   "type": "module",
   "bin": {