@thangnm.nip/arouter 0.1.11 → 0.1.13

package/.next/standalone/server.js

@@ -9,7 +9,7 @@ const currentPort = parseInt(process.env.PORT, 10) || 3000
 const hostname = process.env.HOSTNAME || '0.0.0.0'
 
 let keepAliveTimeout = parseInt(process.env.KEEP_ALIVE_TIMEOUT, 10)
-const nextConfig = {"env":{},"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.mjs","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":true},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":"/Users/nip/WORKSPACE/02.SOURCE/ICHECK/01. PROJECT/AI CENTER/arouter","cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"dynamicOnHover":false,"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":7,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"imgOptSkipMetadata":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"viewTransition":false,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":false,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":false,"serverComponentsHmrCache":true,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":false,"lockDistDir":true,"isolatedDevBuild":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":false,"turbopackInferModuleSideEffects":false,"optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.mjs","turbopack":{"root":"/Users/nip/WORKSPACE/02.SOURCE/ICHECK/01. PROJECT/AI CENTER/arouter"},"distDirRoot":".next","_originalRewrites":{"beforeFiles":[],"afterFiles":[{"source":"/v1/v1/:path*","destination":"/api/v1/:path*"},{"source":"/v1/v1","destination":"/api/v1"},{"source":"/codex/:path*","destination":"/api/v1/responses"},{"source":"/v1/:path*","destination":"/api/v1/:path*"},{"source":"/v1","destination":"/api/v1"}],"fallback":[]}}
+const nextConfig = {"env":{},"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.mjs","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":true},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":"/Users/nip/Desktop/WORKSPACE/iCheck/iCheck.AI.Workflows/arouter","cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"dynamicOnHover":false,"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":9,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"imgOptSkipMetadata":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"viewTransition":false,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":false,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":false,"serverComponentsHmrCache":true,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":false,"lockDistDir":true,"isolatedDevBuild":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":false,"turbopackInferModuleSideEffects":false,"optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.mjs","turbopack":{"root":"/Users/nip/Desktop/WORKSPACE/iCheck/iCheck.AI.Workflows/arouter"},"distDirRoot":".next","_originalRewrites":{"beforeFiles":[],"afterFiles":[{"source":"/v1/v1/:path*","destination":"/api/v1/:path*"},{"source":"/v1/v1","destination":"/api/v1"},{"source":"/codex/:path*","destination":"/api/v1/responses"},{"source":"/v1/:path*","destination":"/api/v1/:path*"},{"source":"/v1","destination":"/api/v1"}],"fallback":[]}}
 
 process.env.__NEXT_PRIVATE_STANDALONE_CONFIG = JSON.stringify(nextConfig)
 

package/.next/standalone/src/mitm/manager.js

@@ -75,22 +75,39 @@ function isProcessAlive(pid) {
     process.kill(pid, 0);
     return true;
   } catch (err) {
-    return err.code === "EACCES";
+    return err.code === "EACCES" || err.code === "EPERM";
   }
 }
 
-function killProcess(pid, force = false, sudoPassword = null) {
+async function killProcess(pid, force = false, sudoPassword = null) {
   if (IS_WIN) {
     const flag = force ? "/F " : "";
-    exec(`taskkill ${flag}/PID ${pid}`, { windowsHide: true }, () => { });
+    return new Promise(r => exec(`taskkill ${flag}/PID ${pid}`, { windowsHide: true }, r));
   } else {
-    const sig = force ? "SIGKILL" : "SIGTERM";
-    const cmd = `pkill -${sig} -P ${pid} 2>/dev/null; kill -${sig} ${pid} 2>/dev/null`;
+    const sig = force ? "KILL" : "TERM";
+    const cmd = `pkill -${sig} -P ${pid} 2>/dev/null || true; kill -${sig} ${pid} 2>/dev/null || true`;
     if (sudoPassword) {
       const { execWithPassword } = require("./dns/dnsConfig");
-      execWithPassword(cmd, sudoPassword).catch(() => exec(cmd, () => { }));
+      const fs = require("fs");
+      const logFile = require("os").homedir() + "/.arouter/mitm_kill.log";
+      try {
+        log(`Executing sudo kill for PID ${pid}...`);
+        fs.appendFileSync(logFile, `\n\n[${new Date().toISOString()}] Attempting kill for PID ${pid} with force=${force}\nCmd: ${cmd}\n`);
+        const out = await execWithPassword(cmd, sudoPassword);
+        fs.appendFileSync(logFile, `execWithPassword SUCCESS: ${out}\n`);
+        log(`Sudo kill output: ${out}`);
+      } catch (e) {
+        fs.appendFileSync(logFile, `execWithPassword FAILED: ${e.message}\n`);
+        err(`Sudo kill failed: ${e.message}`);
+        // Fallback: try raw exec with echo
+        return new Promise(r => exec(`echo "${sudoPassword.replace(/"/g, '\\"')}" | sudo -S sh -c "${cmd}"`, (cmdErr, stdout, stderr) => {
+          fs.appendFileSync(logFile, `Fallback Result -> err: ${cmdErr?.message}, stdout: ${stdout}, stderr: ${stderr}\n`);
+          if (cmdErr) err(`Raw sudo kill failed too: ${stderr || cmdErr.message}`);
+          r();
+        }));
+      }
     } else {
-      exec(cmd, () => { });
+      return new Promise(r => exec(cmd, r));
     }
   }
 }
@@ -276,6 +293,15 @@ async function getMitmStatus() {
     } catch { /* ignore */ }
   }
 
+  if (!running) {
+    const health = await pollMitmHealth(1000, MITM_PORT);
+    if (health && health.ok) {
+      running = true;
+      pid = health.pid;
+      try { fs.writeFileSync(PID_FILE, String(pid)); } catch {}
+    }
+  }
+
   const dnsStatus = checkAllDNSStatus();
   const rootCACertPath = path.join(MITM_DIR, "rootCA.crt");
   const certExists = fs.existsSync(rootCACertPath);
@@ -350,6 +376,18 @@ async function startServer(apiKey, sudoPassword) {
     } catch { /* ignore */ }
   }
 
+  if (!serverProcess || serverProcess.killed) {
+    const health = await pollMitmHealth(1000, MITM_PORT);
+    if (health && health.ok) {
+      serverPid = health.pid;
+      log(`♻️ Found running MITM server (PID: ${health.pid}). Adopting it.`);
+      try { fs.writeFileSync(PID_FILE, String(serverPid)); } catch {}
+      await saveMitmSettings(true, sudoPassword);
+      if (sudoPassword) setCachedPassword(sudoPassword);
+      return { running: true, pid: serverPid };
+    }
+  }
+
   if (serverProcess && !serverProcess.killed) {
     throw new Error("MITM server is already running");
   }
@@ -520,9 +558,13 @@ async function stopServer(sudoPassword) {
 
   if (pidToKill && isProcessAlive(pidToKill)) {
     log(`Killing server (PID: ${pidToKill})...`);
-    killProcess(pidToKill, false, password);
+    await killProcess(pidToKill, false, password);
     await new Promise(r => setTimeout(r, 1000));
-    if (isProcessAlive(pidToKill)) killProcess(pidToKill, true, password);
+    if (isProcessAlive(pidToKill)) await killProcess(pidToKill, true, password);
+    await new Promise(r => setTimeout(r, 1000));
+    if (isProcessAlive(pidToKill)) {
+      throw new Error("Cannot kill server process. Sudo password may be missing or incorrect.");
+    }
   }
   serverProcess = null;
   serverPid = null;

package/bin/arouter.js

@@ -0,0 +1,292 @@
+#!/usr/bin/env node
+
+import { spawn, execSync } from "child_process";
+import { existsSync, readFileSync, writeFileSync, unlinkSync, openSync } from "fs";
+import { resolve } from "path";
+import { platform } from "os";
+import { createServer } from "net";
+import { PROJECT_ROOT, DATA_DIR, PID_FILE, LOG_FILE, PORT, DASHBOARD_URL } from "./paths.js";
+
+// ─── Helpers ────────────────────────────────────────────────────────────
+
+const IS_WIN = platform() === "win32";
+const GREEN = "\x1b[32m";
+const YELLOW = "\x1b[33m";
+const RED = "\x1b[31m";
+const CYAN = "\x1b[36m";
+const DIM = "\x1b[2m";
+const BOLD = "\x1b[1m";
+const RESET = "\x1b[0m";
+
+function log(msg) { console.log(`${DIM}[arouter]${RESET} ${msg}`); }
+function success(msg) { console.log(`${GREEN}✔${RESET} ${msg}`); }
+function warn(msg) { console.log(`${YELLOW}⚠${RESET} ${msg}`); }
+function error(msg) { console.error(`${RED}✖${RESET} ${msg}`); }
+
+/** Cross-platform port check using Node.js net module */
+function isPortInUse(port) {
+  return new Promise((resolve) => {
+    const server = createServer();
+    server.once("error", (err) => {
+      if (err.code === "EADDRINUSE") resolve(true);
+      else resolve(false);
+    });
+    server.once("listening", () => {
+      server.close(() => resolve(false));
+    });
+    server.listen(port, "0.0.0.0");
+  });
+}
+
+function getRunningPid() {
+  if (!existsSync(PID_FILE)) return null;
+  const pid = parseInt(readFileSync(PID_FILE, "utf-8").trim(), 10);
+  if (isNaN(pid)) return null;
+  try {
+    process.kill(pid, 0); // check if alive (works on all platforms)
+    return pid;
+  } catch {
+    // stale PID file
+    try { unlinkSync(PID_FILE); } catch { /* ignore */ }
+    return null;
+  }
+}
+
+function waitForServer(timeoutMs = 60000) {
+  return new Promise((resolve, reject) => {
+    const start = Date.now();
+    const check = () => {
+      if (Date.now() - start > timeoutMs) {
+        return reject(new Error("Server startup timed out"));
+      }
+      import("http").then(({ default: http }) => {
+        const req = http.get(`http://localhost:${PORT}`, (res) => {
+          res.resume();
+          resolve();
+        });
+        req.on("error", () => setTimeout(check, 500));
+        req.setTimeout(2000, () => { req.destroy(); setTimeout(check, 500); });
+      });
+    };
+    check();
+  });
+}
+
+/** Cross-platform: get npm executable name */
+function npmCommand() {
+  return IS_WIN ? "npm.cmd" : "npm";
+}
+
+// ─── Commands ───────────────────────────────────────────────────────────
+
+async function buildIfNeeded() {
+  const standaloneServer = resolve(PROJECT_ROOT, ".next/standalone/server.js");
+  if (existsSync(standaloneServer)) return;
+
+  log("First run — building production bundle...");
+  log(`${DIM}This will take a minute, please wait...${RESET}`);
+
+  try {
+    execSync(`${npmCommand()} run build`, {
+      cwd: PROJECT_ROOT,
+      stdio: "inherit",
+      env: { ...process.env, NODE_ENV: "production" },
+      shell: true,
+    });
+    success("Build complete!");
+  } catch (e) {
+    error("Build failed. Check the output above.");
+    process.exit(1);
+  }
+}
+
+async function startServer() {
+  const pid = getRunningPid();
+  if (pid) {
+    success(`aRouter is already running ${DIM}(PID: ${pid})${RESET}`);
+    console.log();
+    console.log(`  ${BOLD}Dashboard${RESET}  ${CYAN}${DASHBOARD_URL}${RESET}`);
+    console.log();
+    return;
+  }
+
+  const portBusy = await isPortInUse(PORT);
+  if (portBusy) {
+    error(`Port ${PORT} is already in use by another process.`);
+    log(`Stop the other process or change the port.`);
+    process.exit(1);
+  }
+
+  await buildIfNeeded();
+
+  log("Starting aRouter...");
+
+  const logFd = openSync(LOG_FILE, "a");
+
+  // Cross-platform: use node directly to run server.js
+  const serverScript = resolve(PROJECT_ROOT, ".next/standalone/server.js");
+  const child = spawn(process.execPath, [serverScript], {
+    cwd: PROJECT_ROOT,
+    detached: !IS_WIN, // detached not supported on Windows the same way
+    stdio: ["ignore", logFd, logFd],
+    env: {
+      ...process.env,
+      NODE_ENV: "production",
+      PORT: String(PORT),
+      HOSTNAME: "0.0.0.0",
+    },
+    // Windows: use windowsHide to hide console window
+    ...(IS_WIN ? { windowsHide: true } : {}),
+  });
+
+  writeFileSync(PID_FILE, String(child.pid));
+  child.unref();
+
+  // Wait for server to be ready
+  try {
+    process.stdout.write(`  Waiting for server `);
+    await waitForServer(60000);
+    process.stdout.write(`${GREEN}ready!${RESET}\n`);
+  } catch {
+    process.stdout.write(`${YELLOW}(timeout — check logs)${RESET}\n`);
+  }
+
+  console.log();
+  console.log(`  ${GREEN}${BOLD}aRouter is running!${RESET}`);
+  console.log();
+  console.log(`  ${BOLD}Dashboard${RESET}  ${CYAN}${DASHBOARD_URL}${RESET}`);
+  console.log(`  ${BOLD}API${RESET}        ${CYAN}${DASHBOARD_URL}/v1${RESET}`);
+  console.log(`  ${BOLD}PID${RESET}        ${DIM}${child.pid}${RESET}`);
+  console.log(`  ${BOLD}Logs${RESET}       ${DIM}${LOG_FILE}${RESET}`);
+  console.log();
+  console.log(`  ${DIM}Run ${RESET}arouter stop${DIM} to stop the server.${RESET}`);
+  console.log();
+}
+
+function stopServer() {
+  const pid = getRunningPid();
+  if (!pid) {
+    warn("aRouter is not running.");
+    return;
+  }
+
+  log(`Stopping aRouter (PID: ${pid})...`);
+  try {
+    if (IS_WIN) {
+      // Windows: use taskkill for tree kill
+      execSync(`taskkill /PID ${pid} /T /F`, { stdio: "ignore", shell: true });
+    } else {
+      process.kill(pid, "SIGTERM");
+      // Wait a bit then force kill if needed
+      setTimeout(() => {
+        try {
+          process.kill(pid, 0);
+          process.kill(pid, "SIGKILL");
+        } catch { /* already dead */ }
+      }, 3000);
+    }
+  } catch (e) {
+    warn(`Could not kill process: ${e.message}`);
+  }
+
+  try { unlinkSync(PID_FILE); } catch { /* ignore */ }
+  success("aRouter stopped.");
+}
+
+function showStatus() {
+  const pid = getRunningPid();
+  if (pid) {
+    success(`aRouter is running ${DIM}(PID: ${pid})${RESET}`);
+    console.log(`  ${BOLD}Dashboard${RESET}  ${CYAN}${DASHBOARD_URL}${RESET}`);
+  } else {
+    warn("aRouter is not running.");
+  }
+}
+
+function showLogs() {
+  if (!existsSync(LOG_FILE)) {
+    warn("No log file found. Start the server first.");
+    return;
+  }
+
+  // Tail last 50 lines
+  try {
+    const content = readFileSync(LOG_FILE, "utf-8");
+    const lines = content.split("\n").slice(-50);
+    console.log(lines.join("\n"));
+  } catch (e) {
+    error(`Could not read logs: ${e.message}`);
+  }
+}
+
+async function restartServer() {
+  stopServer();
+  // Wait for port release
+  await new Promise(r => setTimeout(r, 1500));
+  await startServer();
+}
+
+function showHelp() {
+  console.log();
+  console.log(`  ${BOLD}aRouter${RESET} — AI Model Router & MITM Proxy`);
+  console.log();
+  console.log(`  ${BOLD}Usage:${RESET}`);
+  console.log(`    ${CYAN}arouter${RESET}              Start the server (background)`);
+  console.log(`    ${CYAN}arouter start${RESET}         Same as above`);
+  console.log(`    ${CYAN}arouter stop${RESET}          Stop the server`);
+  console.log(`    ${CYAN}arouter restart${RESET}       Restart the server`);
+  console.log(`    ${CYAN}arouter status${RESET}        Show server status`);
+  console.log(`    ${CYAN}arouter logs${RESET}          Show recent logs`);
+  console.log(`    ${CYAN}arouter dev${RESET}           Run in foreground (dev mode)`);
+  console.log(`    ${CYAN}arouter build${RESET}         Force rebuild`);
+  console.log(`    ${CYAN}arouter help${RESET}          Show this help`);
+  console.log();
+  console.log(`  ${BOLD}Data:${RESET}  ${DIM}${DATA_DIR}${RESET}`);
+  console.log(`  ${BOLD}Port:${RESET}  ${DIM}${PORT}${RESET}`);
+  console.log();
+}
+
+function devMode() {
+  log("Starting in dev mode (foreground)...");
+  const child = spawn(npmCommand(), ["run", "dev"], {
+    cwd: PROJECT_ROOT,
+    stdio: "inherit",
+    env: { ...process.env },
+    shell: IS_WIN,
+  });
+  child.on("exit", (code) => process.exit(code || 0));
+}
+
+async function forceBuild() {
+  log("Force rebuilding...");
+  const nextDir = resolve(PROJECT_ROOT, ".next");
+  try {
+    if (IS_WIN) {
+      execSync(`rmdir /s /q "${nextDir}"`, { cwd: PROJECT_ROOT, shell: true, stdio: "ignore" });
+    } else {
+      execSync(`rm -rf "${nextDir}"`, { cwd: PROJECT_ROOT, stdio: "ignore" });
+    }
+  } catch { /* ignore */ }
+  await buildIfNeeded();
+}
+
+// ─── Main ───────────────────────────────────────────────────────────────
+
+const command = process.argv[2] || "start";
+
+switch (command) {
+  case "start":   await startServer(); break;
+  case "stop":    stopServer(); break;
+  case "restart": await restartServer(); break;
+  case "status":  showStatus(); break;
+  case "logs":    showLogs(); break;
+  case "dev":     devMode(); break;
+  case "build":   await forceBuild(); break;
+  case "help":
+  case "--help":
+  case "-h":      showHelp(); break;
+  default:
+    error(`Unknown command: ${command}`);
+    showHelp();
+    process.exit(1);
+}