@sifxprime/krouter 0.5.6 → 0.5.8

package/cli.js

@@ -47,7 +47,7 @@ const { ensureSqliteRuntime, buildEnvWithRuntime } = require("./hooks/sqliteRunt
 const { ensureTrayRuntime } = require("./hooks/trayRuntime");
 const args = process.argv.slice(2);
 
-// Self-heal SQLite runtime deps (sql.js + better-sqlite3) into ~/.9router/runtime
+// Self-heal SQLite runtime deps (sql.js + better-sqlite3) into ~/.krouter/runtime
 // so the server can resolve them via NODE_PATH. Best-effort — sql.js is required,
 // better-sqlite3 is optional. Logs to stderr only on failure.
 try { ensureSqliteRuntime({ silent: true }); } catch {}
@@ -55,6 +55,15 @@ try { ensureSqliteRuntime({ silent: true }); } catch {}
 // Self-heal tray runtime (systray for macOS/Linux only). Windows skipped.
 try { ensureTrayRuntime({ silent: true }); } catch {}
 
+// Upgrade safety: existing v0.5.6 users who had autostart enabled may have a
+// LaunchAgent / Startup .vbs / .desktop file pointing at the old `9router`
+// global binary that's been uninstalled. Sweep dangling entries so launchd
+// doesn't error every boot — user re-enables from the new tray when ready.
+try {
+  const { sweepDanglingAutostartEntries } = require("./src/cli/tray/autostart");
+  sweepDanglingAutostartEntries();
+} catch {}
+
 // Configuration constants
 const APP_NAME = pkg.name; // Use from package.json
 const INSTALL_CMD_LATEST = `npm i -g ${APP_NAME}@latest --prefer-online`;
@@ -62,9 +71,10 @@ const INSTALL_CMD_LATEST = `npm i -g ${APP_NAME}@latest --prefer-online`;
 const DEFAULT_PORT = 20128;
 const DEFAULT_HOST = "0.0.0.0";
 const MAX_PORT_ATTEMPTS = 10;
-// Identifiers for killAllAppProcesses - only kill 9router specifically
+// Identifiers for killAllAppProcesses - only kill our own app specifically (new + legacy names)
 const PROCESS_IDENTIFIERS = [
-  '9router'  // Only package name - avoid killing other apps
+  'krouter',
+  '9router'  // legacy — kept so an existing install still cleans up properly
 ];
 
 // Parse arguments
@@ -132,11 +142,36 @@ function compareVersions(a, b) {
   return 0;
 }
 
-// Get app data dir (matches app/src/lib/dataDir.js convention)
-function getAppDataDir() {
+// Get app data dir (must match src/mitm/paths.js — same one-time auto-migration).
+const DATA_DIR_NAME = "krouter";
+const LEGACY_DATA_DIR_NAME = "9router";
+function dataDirByName(name) {
   return process.platform === "win32"
-    ? path.join(process.env.APPDATA || "", "9router")
-    : path.join(os.homedir(), ".9router");
+    ? path.join(process.env.APPDATA || "", name)
+    : path.join(os.homedir(), `.${name}`);
+}
+let legacyCoexistWarned = false;
+function getAppDataDir() {
+  const target = dataDirByName(DATA_DIR_NAME);
+  const legacy = dataDirByName(LEGACY_DATA_DIR_NAME);
+  try {
+    if (!fs.existsSync(target) && fs.existsSync(legacy)) {
+      fs.renameSync(legacy, target);
+      console.log(`[cli] Migrated data dir: ${legacy} → ${target}`);
+    } else if (fs.existsSync(target) && fs.existsSync(legacy) && !legacyCoexistWarned) {
+      // Both dirs exist — auto-migration won't fire. Surface so user can reconcile.
+      // Don't auto-delete (user data); they decide how to merge / remove the legacy.
+      legacyCoexistWarned = true;
+      console.warn(
+        `[cli] Legacy ${legacy} still exists alongside ${target}. ` +
+        `New writes go to ${target}; the legacy is not read. ` +
+        `If unmerged settings exist there, back it up, merge manually, then: rm -rf ${legacy}`
+      );
+    }
+  } catch (e) {
+    console.warn(`[cli] Data-dir auto-migration failed (${e.code || e.message}); continuing with ${target}`);
+  }
+  return target;
 }
 
 // Kill PID from file (best-effort, removes file after)
@@ -193,7 +228,7 @@ function killCloudflaredByAppPort(appPort) {
   return pids;
 }
 
-// Kill all 9router processes
+// Kill all krouter (or legacy 9router) processes
 function killAllAppProcesses(appPort) {
   return new Promise((resolve) => {
     try {
@@ -219,11 +254,13 @@ function killAllAppProcesses(appPort) {
           });
           const lines = output.split("\n").slice(1).filter(l => l.trim());
           lines.forEach(line => {
-            // Whitelist: real node process running 9router/cli.js, or next-server.
-            // Avoids killing editors/grep/strace/cursor that just have "9router" in cmdline.
+            // Whitelist: real node process running krouter (or legacy 9router) cli.js, or next-server.
+            // Avoids killing editors/grep/strace/cursor that just incidentally match the name.
             const cmd = line.toLowerCase();
+            const hasAppName = cmd.includes("krouter") || cmd.includes("9router");
+            const hasAppPath = cmd.includes("cli.js") || cmd.includes("\\krouter") || cmd.includes("/krouter") || cmd.includes("\\9router") || cmd.includes("/9router");
             const isAppProcess =
-              (cmd.includes("node") && cmd.includes("9router") && (cmd.includes("cli.js") || cmd.includes("\\9router") || cmd.includes("/9router")))
+              (cmd.includes("node") && hasAppName && hasAppPath)
               || cmd.includes("next-server");
             if (isAppProcess) {
               const match = line.match(/^"(\d+)"/);
@@ -245,11 +282,13 @@ function killAllAppProcesses(appPort) {
           const lines = output.split('\n');
 
           lines.forEach(line => {
-            // Whitelist: real node process running 9router/cli.js, or next-server.
-            // Avoids killing grep/strace/editors/cursor that incidentally match "9router".
+            // Whitelist: real node process running krouter (or legacy 9router) cli.js, or next-server.
+            // Avoids killing grep/strace/editors/cursor that incidentally match the name.
             const cmd = line.toLowerCase();
+            const hasAppName = cmd.includes("krouter") || cmd.includes("9router");
+            const hasAppPath = cmd.includes("cli.js") || cmd.includes("/krouter") || cmd.includes("/9router");
             const isAppProcess =
-              (cmd.includes("node") && cmd.includes("9router") && (cmd.includes("cli.js") || cmd.includes("/9router")))
+              (cmd.includes("node") && hasAppName && hasAppPath)
               || cmd.includes("next-server");
             if (isAppProcess) {
               const parts = line.trim().split(/\s+/);
@@ -541,10 +580,30 @@ async function showInterfaceMenu(latestVersion) {
 const MAX_RESTARTS = 2;
 const RESTART_RESET_MS = 30000; // Reset counter if alive > 30s
 
+// First non-internal IPv4 — the address remote peers actually reach when bound to 0.0.0.0.
+function getLanIp() {
+  for (const ifaces of Object.values(os.networkInterfaces())) {
+    for (const i of ifaces || []) {
+      if (i.family === "IPv4" && !i.internal) return i.address;
+    }
+  }
+  return null;
+}
+
 function startServer(latestVersion) {
   const displayHost = host === DEFAULT_HOST ? "localhost" : host;
   const url = `http://${displayHost}:${port}/dashboard`;
 
+  // Surface real network exposure when bound to all interfaces (default 0.0.0.0).
+  // Ported from upstream — without this the user has no signal that their
+  // dashboard + API is reachable from anyone else on their LAN.
+  if (host === DEFAULT_HOST) {
+    const lanIp = getLanIp();
+    if (lanIp) {
+      console.log(`\x1b[33m⚠ Network-exposed: reachable at http://${lanIp}:${port} (bound 0.0.0.0). Use --host 127.0.0.1 for local-only.\x1b[0m`);
+    }
+  }
+
   let restartCount = 0;
   let serverStartTime = Date.now();
 
@@ -714,7 +773,7 @@ function startServer(latestVersion) {
             process.on("SIGHUP", () => {});
 
             console.log(`\n⏳ Switching to tray mode... (icon already visible in menu bar)`);
-            console.log(`🔔 9Router is running in tray (PID: ${process.pid})`);
+            console.log(`🔔 kRouter is running in tray (PID: ${process.pid})`);
             console.log(`   Server: http://${displayHost}:${port}`);
             console.log(`\n💡 You can close this terminal. Right-click tray icon to quit.\n`);
 
@@ -733,7 +792,7 @@ function startServer(latestVersion) {
           });
           bgProcess.unref();
 
-          console.log(`🔔 9Router is now running in background (PID: ${bgProcess.pid})`);
+          console.log(`🔔 kRouter is now running in background (PID: ${bgProcess.pid})`);
           console.log(`   Server: http://${displayHost}:${port}`);
           console.log(`\n💡 You can close this terminal. Right-click tray icon to quit.\n`);
 
@@ -778,7 +837,7 @@ function startServer(latestVersion) {
     if (restartCount >= MAX_RESTARTS) {
       console.error(`\n⚠️  Server crashed ${MAX_RESTARTS} times. Disabling MIT and restarting...`);
       try {
-        const dbPath = path.join(os.homedir(), process.platform === "win32" ? path.join("AppData", "Roaming", "9router", "db.json") : path.join(".9router", "db.json"));
+        const dbPath = path.join(getAppDataDir(), "db.json");
         if (fs.existsSync(dbPath)) {
           const db = JSON.parse(fs.readFileSync(dbPath, "utf-8"));
           if (db.settings) db.settings.mitmEnabled = false;

package/hooks/postinstall.js

@@ -1,22 +1,22 @@
 #!/usr/bin/env node
 
-// Postinstall: warm-up SQLite deps into ~/.9router/runtime so the first
-// `9router` start doesn't need network. Failure here is non-fatal —
+// Postinstall: warm-up SQLite deps into ~/.krouter/runtime so the first
+// `krouter` start doesn't need network. Failure here is non-fatal —
 // cli.js will retry at runtime if anything is missing.
 const { ensureSqliteRuntime } = require("./sqliteRuntime");
 const { ensureTrayRuntime } = require("./trayRuntime");
 
 try {
   ensureSqliteRuntime({ silent: false });
-  console.log("[9router] runtime SQLite deps ready");
+  console.log("[krouter] runtime SQLite deps ready");
 } catch (e) {
-  console.warn(`[9router] runtime warm-up skipped: ${e.message}`);
+  console.warn(`[krouter] runtime warm-up skipped: ${e.message}`);
 }
 
 try {
   ensureTrayRuntime({ silent: false });
 } catch (e) {
-  console.warn(`[9router] tray runtime skipped: ${e.message}`);
+  console.warn(`[krouter] tray runtime skipped: ${e.message}`);
 }
 
 process.exit(0);

package/hooks/sqliteRuntime.js

@@ -8,11 +8,23 @@ const path = require("path");
 
 const BETTER_SQLITE3_VERSION = "12.6.2";
 
+// Must match src/mitm/paths.js / src/lib/dataDir.js — one-time auto-migration
+// of ~/.9router → ~/.krouter. Idempotent.
+function appNameDir(name) {
+  return process.platform === "win32"
+    ? path.join(process.env.APPDATA || os.homedir(), name)
+    : path.join(os.homedir(), `.${name}`);
+}
 function getDataDir() {
   if (process.env.DATA_DIR) return process.env.DATA_DIR;
-  return process.platform === "win32"
-    ? path.join(process.env.APPDATA || os.homedir(), "9router")
-    : path.join(os.homedir(), ".9router");
+  const target = appNameDir("krouter");
+  const legacy = appNameDir("9router");
+  try {
+    if (!fs.existsSync(target) && fs.existsSync(legacy)) {
+      fs.renameSync(legacy, target);
+    }
+  } catch { /* best effort */ }
+  return target;
 }
 
 function getRuntimeDir() {
@@ -31,10 +43,10 @@ function ensureRuntimeDir() {
   const pkgPath = path.join(dir, "package.json");
   if (!fs.existsSync(pkgPath)) {
     fs.writeFileSync(pkgPath, JSON.stringify({
-      name: "9router-runtime",
+      name: "krouter-runtime",
       version: "1.0.0",
       private: true,
-      description: "User-writable runtime deps for 9router (better-sqlite3 native binary)",
+      description: "User-writable runtime deps for krouter (better-sqlite3 native binary)",
     }, null, 2));
   }
   return dir;

package/hooks/trayRuntime.js

@@ -23,8 +23,8 @@ function hasSystray() {
 // On Windows it was an AV false-positive risk; on macOS/Linux its bundled
 // binary is broken on modern OS versions.
 function cleanupLegacySystray({ silent = false } = {}) {
-  // 1) Runtime dir: ~/.9router/runtime/node_modules/systray (or %APPDATA% on Win)
-  // 2) npm global nested: <npm_prefix>/node_modules/9router/node_modules/systray
+  // 1) Runtime dir: ~/.krouter/runtime/node_modules/systray (or %APPDATA% on Win)
+  // 2) npm global nested: <npm_prefix>/node_modules/krouter/node_modules/systray
   //    __dirname here = <pkg root>/hooks → up 1 = pkg root
   const targets = [
     path.join(getRuntimeNodeModules(), LEGACY_SYSTRAY_PKG),
@@ -34,9 +34,9 @@ function cleanupLegacySystray({ silent = false } = {}) {
     if (fs.existsSync(dir)) {
       try {
         fs.rmSync(dir, { recursive: true, force: true });
-        if (!silent) console.log(`[9router][runtime] removed legacy systray: ${dir}`);
+        if (!silent) console.log(`[krouter][runtime] removed legacy systray: ${dir}`);
       } catch (e) {
-        if (!silent) console.warn(`[9router][runtime] failed to remove ${dir}: ${e.message}`);
+        if (!silent) console.warn(`[krouter][runtime] failed to remove ${dir}: ${e.message}`);
       }
     }
   }
@@ -53,7 +53,7 @@ function chmodSystrayBin({ silent = false } = {}) {
   try {
     fs.chmodSync(binPath, 0o755);
   } catch (e) {
-    if (!silent) console.warn(`[9router][runtime] chmod tray bin failed: ${e.message}`);
+    if (!silent) console.warn(`[krouter][runtime] chmod tray bin failed: ${e.message}`);
   }
 }
 
@@ -63,7 +63,7 @@ function ensureRuntimeDir() {
   const pkgPath = path.join(dir, "package.json");
   if (!fs.existsSync(pkgPath)) {
     fs.writeFileSync(pkgPath, JSON.stringify({
-      name: "9router-runtime",
+      name: "krouter-runtime",
       version: "1.0.0",
       private: true
     }, null, 2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sifxprime/krouter",
-  "version": "0.5.6",
+  "version": "0.5.8",
   "description": "kRouter (Kodelyth Router) CLI — Kodelyth AI Infrastructure",
   "homepage": "https://github.com/sifxprime/krouter",
   "repository": {
@@ -36,8 +36,8 @@
     "react": "19.2.1",
     "react-dom": "19.2.1"
   },
-  "comment_sqlite": "sql.js + better-sqlite3 are NOT bundled here. They are installed into ~/.9router/runtime/node_modules by hooks/postinstall.js (and re-checked at runtime by cli.js). This avoids Windows EBUSY errors when updating the global CLI, since native .node files no longer live under the locked install dir.",
-  "comment_systray": "systray2 is NOT bundled here. It is lazy-installed into ~/.9router/runtime/node_modules by hooks/postinstall.js on macOS/Linux only. Windows uses PowerShell NotifyIcon (zero binary). This avoids shipping unsigned Go binaries that trigger antivirus false positives (Kaspersky). We use the systray2 fork because the legacy systray@1.0.5 ships a 2017 x86_64 binary that fails on modern macOS dyld.",
+  "comment_sqlite": "sql.js + better-sqlite3 are NOT bundled here. They are installed into ~/.krouter/runtime/node_modules by hooks/postinstall.js (and re-checked at runtime by cli.js). This avoids Windows EBUSY errors when updating the global CLI, since native .node files no longer live under the locked install dir.",
+  "comment_systray": "systray2 is NOT bundled here. It is lazy-installed into ~/.krouter/runtime/node_modules by hooks/postinstall.js on macOS/Linux only. Windows uses PowerShell NotifyIcon (zero binary). This avoids shipping unsigned Go binaries that trigger antivirus false positives (Kaspersky). We use the systray2 fork because the legacy systray@1.0.5 ships a 2017 x86_64 binary that fails on modern macOS dyld.",
   "engines": {
     "node": ">=18.0.0"
   },

package/src/cli/api/client.js

@@ -15,14 +15,28 @@ const DEFAULT_CONFIG = {
 
 const CLI_TOKEN_HEADER = "x-9r-cli-token";
 const CLI_TOKEN_SALT = "9r-cli-auth";
-const APP_NAME = "9router";
+// Must match src/mitm/paths.js / src/lib/dataDir.js — one-time auto-migration
+// of ~/.9router → ~/.krouter. Idempotent.
+const APP_NAME = "krouter";
+const LEGACY_APP_NAME = "9router";
 
-function getDataDir() {
-  if (process.env.DATA_DIR) return process.env.DATA_DIR;
+function appNameDir(name) {
   if (process.platform === "win32") {
-    return path.join(process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming"), APP_NAME);
+    return path.join(process.env.APPDATA || path.join(os.homedir(), "AppData", "Roaming"), name);
   }
-  return path.join(os.homedir(), `.${APP_NAME}`);
+  return path.join(os.homedir(), `.${name}`);
+}
+
+function getDataDir() {
+  if (process.env.DATA_DIR) return process.env.DATA_DIR;
+  const target = appNameDir(APP_NAME);
+  const legacy = appNameDir(LEGACY_APP_NAME);
+  try {
+    if (!fs.existsSync(target) && fs.existsSync(legacy)) {
+      fs.renameSync(legacy, target);
+    }
+  } catch { /* best effort */ }
+  return target;
 }
 
 const MACHINE_ID_FILE = path.join(getDataDir(), "machine-id");

package/src/cli/menus/cliTools.js

@@ -277,8 +277,10 @@ async function buildDroidHeader() {
     ].join("\n");
   }
 
-  // Extract 9Router custom model config
-  const custom = settings?.customModels?.find(m => m.id === "custom:9Router-0");
+  // Extract kRouter custom model config (read either new or legacy id for compat)
+  const custom = settings?.customModels?.find(
+    m => m.id === "custom:kRouter-0" || m.id === "custom:9Router-0"
+  );
   const lines = [`Status:   ${COLORS.green}✓ Configured${COLORS.reset}`];
   if (custom?.baseUrl) lines.push(`Endpoint: ${COLORS.cyan}${custom.baseUrl}${COLORS.reset}`);
   if (custom?.model)   lines.push(`Model:    ${COLORS.dim}${custom.model}${COLORS.reset}`);
@@ -360,10 +362,12 @@ async function buildOpenClawHeader() {
     ].join("\n");
   }
 
-  // Extract 9Router provider config
-  const provider = settings?.models?.providers?.["9router"];
+  // Extract kRouter provider config (read either new or legacy key for compat)
+  const provider = settings?.models?.providers?.["krouter"] ?? settings?.models?.providers?.["9router"];
   const primary = settings?.agents?.defaults?.model?.primary || "";
-  const model = primary.startsWith("9router/") ? primary.replace("9router/", "") : (provider?.models?.[0]?.id || "");
+  const model = /^(?:krouter|9router)\//.test(primary)
+    ? primary.replace(/^(?:krouter|9router)\//, "")
+    : (provider?.models?.[0]?.id || "");
   const lines = [`Status:   ${COLORS.green}✓ Configured${COLORS.reset}`];
   if (provider?.baseUrl) lines.push(`Endpoint: ${COLORS.cyan}${provider.baseUrl}${COLORS.reset}`);
   if (model)             lines.push(`Model:    ${COLORS.dim}${model}${COLORS.reset}`);
@@ -585,7 +589,7 @@ async function showCliToolsMenu(port, breadcrumb = []) {
   await showMenuWithBack({
     title: "🔧 CLI Tools",
     breadcrumb,
-    headerContent: `Configure CLI tools to use 9Router\nEndpoint: ${endpoint}`,
+    headerContent: `Configure CLI tools to use kRouter\nEndpoint: ${endpoint}`,
     items: [
       {
         label: "Claude Code",

package/src/cli/terminalUI.js

@@ -67,14 +67,14 @@ async function startTerminalUI(port) {
   // Configure API client
   api.configure({ port });
 
-  const basePath = ["9Router"];
+  const basePath = ["kRouter"];
 
   // Prime header cache before first render
   await refreshHeaderBg(port);
 
   // Main menu
   await showMenuWithBack({
-    title: "📡 9Router Terminal UI",
+    title: "📡 kRouter Terminal UI",
     breadcrumb: basePath,
     headerContent: () => getHeader(port),
     items: [