@gachlab/devup 0.3.0 → 0.5.0

package/dist/index.js

@@ -3,8 +3,10 @@
 // src/index.ts
 import React7 from "react";
 import { render } from "ink";
-import { join as join6 } from "path";
-import { homedir as homedir2 } from "os";
+import { readFileSync as readFileSync2 } from "fs";
+import { dirname as dirname6, join as join7 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import { homedir as homedir3 } from "os";
 
 // src/config/loader.ts
 import { existsSync } from "fs";
@@ -112,6 +114,19 @@ function validateConfig(config, cwd) {
     if (svc.cwd && !existsSync2(resolve2(cwd, svc.cwd))) {
       errors.push({ field: `services[${svc.name}].cwd`, message: `Directory not found: ${svc.cwd}` });
     }
+    if (svc.errorPattern !== void 0) {
+      if (typeof svc.errorPattern !== "string" || !svc.errorPattern.length) {
+        errors.push({ field: `services[${svc.name}].errorPattern`, message: `errorPattern must be a non-empty string` });
+      } else {
+        const slashed = /^\/(.+)\/([gimsuy]*)$/.exec(svc.errorPattern);
+        try {
+          if (slashed) new RegExp(slashed[1], slashed[2] || "i");
+          else new RegExp(svc.errorPattern, "i");
+        } catch (e) {
+          errors.push({ field: `services[${svc.name}].errorPattern`, message: `Invalid regex: ${e.message}` });
+        }
+      }
+    }
     if (svc.readyPattern !== void 0) {
       if (typeof svc.readyPattern !== "string" || !svc.readyPattern.length) {
         errors.push({ field: `services[${svc.name}].readyPattern`, message: `readyPattern must be a non-empty string` });
@@ -136,6 +151,9 @@ function validateConfig(config, cwd) {
       if (hc.type !== "tcp" && hc.type !== "http") {
         errors.push({ field: `services[${svc.name}].healthCheck.type`, message: `Invalid healthCheck.type: ${hc.type} (must be "tcp" or "http")` });
       }
+      if (hc.startPeriod !== void 0 && (typeof hc.startPeriod !== "number" || hc.startPeriod < 0)) {
+        errors.push({ field: `services[${svc.name}].healthCheck.startPeriod`, message: `startPeriod must be a non-negative number (seconds), got ${hc.startPeriod}` });
+      }
       if (hc.type === "http" && hc.path && !hc.path.startsWith("/")) {
         errors.push({ field: `services[${svc.name}].healthCheck.path`, message: `healthCheck.path must start with "/": got "${hc.path}"` });
       }
@@ -221,6 +239,44 @@ function formatValidationErrors(errors) {
 // src/config/cli.ts
 var DEFAULT_LAZY_TIMEOUT = 10;
 var DEFAULT_ONCE_TIMEOUT = 90;
+var USAGE = `devup \u2014 terminal UI dev stack runner
+
+Usage: devup [options]
+
+Service selection:
+  --only apis | webs       Start only APIs or only webs
+  --services a,b,c         Start only the named services
+  --profile <name>         Start the services in a named profile (see ROADMAP)
+  --skip a,b,c             Start everything except these
+  --config <path>          Use a custom config file
+
+Lazy mode:
+  --lazy                   Enable lazy mode (default)
+  --no-lazy                Start every service immediately
+  --timeout <minutes>      Idle timeout for lazy services. Default: 10
+
+Reverse proxy:
+  --proxy                  Enable proxy config generation
+  --proxy-host <host>      Override the target host (Docker/local)
+  --proxy-conf <path>      Override the generated config file path
+  --proxy-tls              Enable TLS in the generated config (default)
+  --no-proxy-tls           Disable TLS
+  --proxy-entrypoint <n>   Override entrypoint name (Traefik only)
+
+CI / scripting:
+  --dry-run                Print the resolved boot plan and exit
+  --once                   Boot, wait for readiness, exit 0/1 (no TUI)
+  --once-timeout <s>       Max seconds to wait in --once mode. Default: 90
+
+Log files:
+  --no-log-file            Disable persistent log files
+  --log-dir <path>         Override log root (default: ~/.devup/logs)
+
+Other:
+  -h, --help               Show this help and exit
+  -v, --version            Show version and exit
+
+See https://github.com/gachlab/devup for the full documentation.`;
 function parseCliArgs(argv) {
   const args = {
     skip: [],
@@ -344,6 +400,394 @@ function filterServices(services, args, config) {
   return result;
 }
 
+// src/orchestrator/subcommands.ts
+import { spawn } from "child_process";
+import { createReadStream, watchFile, unwatchFile, existsSync as existsSync4, statSync } from "fs";
+import { readFile as readFile2 } from "fs/promises";
+import { join as join3, dirname } from "path";
+import { fileURLToPath } from "url";
+import { homedir } from "os";
+import { createInterface } from "readline";
+
+// src/process/health.ts
+import net from "net";
+import http from "http";
+function checkPort(port, host = "127.0.0.1", timeoutMs = 2e3) {
+  return new Promise((resolve4) => {
+    const socket = new net.Socket();
+    socket.setTimeout(timeoutMs);
+    socket.once("connect", () => {
+      socket.destroy();
+      resolve4(true);
+    });
+    socket.once("error", () => {
+      socket.destroy();
+      resolve4(false);
+    });
+    socket.once("timeout", () => {
+      socket.destroy();
+      resolve4(false);
+    });
+    socket.connect(port, host);
+  });
+}
+function checkHttp(port, opts = {}) {
+  const path = opts.path ?? "/";
+  const host = opts.host ?? "127.0.0.1";
+  const timeoutMs = opts.timeoutMs ?? 2e3;
+  const accept = (code) => {
+    if (opts.expect === void 0) return code >= 200 && code < 300;
+    if (Array.isArray(opts.expect)) return opts.expect.includes(code);
+    return code === opts.expect;
+  };
+  return new Promise((resolve4) => {
+    const req = http.get({ host, port, path, timeout: timeoutMs }, (res) => {
+      const ok = typeof res.statusCode === "number" && accept(res.statusCode);
+      res.resume();
+      resolve4(ok);
+    });
+    req.on("error", () => resolve4(false));
+    req.on("timeout", () => {
+      req.destroy();
+      resolve4(false);
+    });
+  });
+}
+function checkHealth(port, hc) {
+  if (hc?.type === "http") {
+    return checkHttp(port, {
+      path: hc.path,
+      expect: hc.expect,
+      host: hc.host,
+      timeoutMs: hc.timeoutMs
+    });
+  }
+  return checkPort(port, "127.0.0.1", hc?.timeoutMs);
+}
+function waitForPort(port, opts = {}) {
+  const { timeout = 45e3, interval = 1e3 } = opts;
+  return new Promise((resolve4) => {
+    const start = Date.now();
+    const check = () => {
+      checkPort(port).then((ok) => {
+        if (ok) return resolve4(true);
+        if (Date.now() - start > timeout) return resolve4(false);
+        setTimeout(check, interval);
+      });
+    };
+    check();
+  });
+}
+function deriveHealth(isUp, currentStatus) {
+  if (currentStatus === "idle") return "idle";
+  if (isUp) return "up";
+  return currentStatus === "starting" ? "wait" : "down";
+}
+
+// src/utils.ts
+import { existsSync as existsSync3, readFileSync, writeFileSync } from "fs";
+import { createHash } from "crypto";
+import { join as join2 } from "path";
+function parseEnvFile(filePath, baseEnv = {}) {
+  const env = { ...baseEnv };
+  if (!existsSync3(filePath)) return env;
+  for (const line of readFileSync(filePath, "utf8").split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIdx = trimmed.indexOf("=");
+    if (eqIdx === -1) continue;
+    const key = trimmed.slice(0, eqIdx).trim();
+    let val = trimmed.slice(eqIdx + 1).trim();
+    if (val.startsWith('"') && val.endsWith('"') || val.startsWith("'") && val.endsWith("'")) {
+      val = val.slice(1, -1);
+    }
+    if (!env[key]) env[key] = val;
+  }
+  return env;
+}
+function nextRamBannerVisibility(usagePct, previousVisible, highWatermark = 80, lowWatermark = 75) {
+  if (usagePct >= highWatermark) return true;
+  if (usagePct < lowWatermark) return false;
+  return previousVisible;
+}
+function redactSecrets(env) {
+  if (!env) return {};
+  const out = {};
+  for (const [k, v] of Object.entries(env)) {
+    out[k] = /secret|token|password|api[_-]?key|auth/i.test(k) ? "***" : v;
+  }
+  return out;
+}
+function detectLogLevel(line) {
+  const l = line.toLowerCase();
+  if (/\b(?:error|err|fail(?:ed|ure|ures|s)?|fatal|exception|crash(?:ed|es)?)\b/.test(l) || /❌|✗|⛔/.test(line)) return "error";
+  if (/\b(?:warn(?:ed|ing|s|ings)?|deprec)\b/.test(l) || /⚠/.test(line)) return "warn";
+  return "info";
+}
+function compileSearchPattern(term) {
+  if (!term) return null;
+  const slashed = /^\/(.+)\/([gimsuy]*)$/.exec(term);
+  if (slashed) {
+    const flags = slashed[2].includes("i") ? slashed[2] : slashed[2] + "i";
+    try {
+      const re = new RegExp(slashed[1], flags);
+      return { test: (l) => re.test(l), regex: re };
+    } catch {
+      const lower2 = term.toLowerCase();
+      return { test: (l) => l.toLowerCase().includes(lower2), invalid: true };
+    }
+  }
+  const lower = term.toLowerCase();
+  return { test: (l) => l.toLowerCase().includes(lower) };
+}
+function fmtUptime(ms) {
+  if (!ms || ms < 0) return "-";
+  const s = Math.floor(ms / 1e3);
+  if (s < 60) return `${s}s`;
+  const m = Math.floor(s / 60);
+  if (m < 60) return `${m}m${s % 60}s`;
+  const h = Math.floor(m / 60);
+  if (h < 24) return `${h}h${m % 60}m`;
+  const d = Math.floor(h / 24);
+  return `${d}d${h % 24}h`;
+}
+function needsInstall(fullCwd) {
+  const nm = join2(fullCwd, "node_modules");
+  if (!existsSync3(nm)) return true;
+  try {
+    const pkgHash = createHash("md5").update(readFileSync(join2(fullCwd, "package.json"))).digest("hex");
+    const stampFile = join2(nm, ".install-stamp");
+    if (existsSync3(stampFile) && readFileSync(stampFile, "utf8") === pkgHash) return false;
+  } catch {
+  }
+  return true;
+}
+function writeInstallStamp(fullCwd) {
+  try {
+    const pkgHash = createHash("md5").update(readFileSync(join2(fullCwd, "package.json"))).digest("hex");
+    writeFileSync(join2(fullCwd, "node_modules", ".install-stamp"), pkgHash);
+  } catch {
+  }
+}
+function sortServiceNames(names, sortMode, statsMap, procState) {
+  if (sortMode === "name") return names.slice().sort();
+  return names.slice().sort((a, b) => {
+    if (sortMode === "mem") {
+      return (parseFloat(statsMap[b]?.mem ?? "0") || 0) - (parseFloat(statsMap[a]?.mem ?? "0") || 0);
+    }
+    return (procState[b]?.errors ?? 0) - (procState[a]?.errors ?? 0);
+  });
+}
+function groupByPhase(services) {
+  const phases = {};
+  for (const s of services) {
+    (phases[s.phase] ??= []).push(s);
+  }
+  return phases;
+}
+function buildProcessArgs(svc) {
+  const extra = svc.nodeArgs ?? [];
+  if (!svc.maxMem) return [...extra, ...svc.args];
+  if (svc.cmd === "node") return [`--max-old-space-size=${svc.maxMem}`, ...extra, ...svc.args];
+  return [...extra, ...svc.args];
+}
+function buildProcessEnv(svc, baseEnv) {
+  const env = { ...baseEnv, ...svc.extraEnv ?? {} };
+  if (svc.maxMem && svc.cmd !== "node") {
+    const existing = env["NODE_OPTIONS"] ?? "";
+    const flag = `--max-old-space-size=${svc.maxMem}`;
+    if (!existing.includes("max-old-space-size")) {
+      env["NODE_OPTIONS"] = existing ? `${existing} ${flag}` : flag;
+    }
+  }
+  return env;
+}
+function calcCpuPercent(totalCpuSec, prevCpu, prevTime) {
+  const elapsed = (Date.now() - prevTime) / 1e3;
+  const cpuDelta = totalCpuSec - prevCpu;
+  return elapsed > 0 ? cpuDelta / elapsed * 100 : 0;
+}
+var tagColors = [
+  "cyan",
+  "yellow",
+  "green",
+  "magenta",
+  "blue",
+  "red",
+  "#5faf5f",
+  "#d7af5f",
+  "#5f87d7",
+  "#af5faf",
+  "#5fd7d7",
+  "#d75f5f",
+  "white"
+];
+
+// src/orchestrator/subcommands.ts
+var KNOWN = /* @__PURE__ */ new Set(["logs", "install", "status", "help"]);
+function detectSubcommand(argv) {
+  const first = argv[0];
+  return first && KNOWN.has(first) ? first : null;
+}
+function logRoot(config, override) {
+  const root = override ?? join3(homedir(), ".devup", "logs");
+  return join3(root, sanitize(config.name));
+}
+function sanitize(name) {
+  return name.replace(/[^a-zA-Z0-9._-]+/g, "_").replace(/^_+|_+$/g, "") || "devup";
+}
+async function runLogs(argv, opts) {
+  const out = opts.out ?? ((l) => console.log(l));
+  const follow = argv.includes("--follow") || argv.includes("-f");
+  const svcArg = argv.find((a) => !a.startsWith("-"));
+  if (!svcArg) {
+    out("usage: devup logs <service> [--follow]");
+    return 1;
+  }
+  const knownSvcs = opts.config.services.map((s) => s.name);
+  if (!knownSvcs.includes(svcArg)) {
+    out(`Unknown service "${svcArg}". Known: ${knownSvcs.join(", ")}`);
+    return 1;
+  }
+  const file = join3(logRoot(opts.config, opts.logDir), `${sanitize(svcArg)}.log`);
+  if (!existsSync4(file)) {
+    out(`No log file yet for "${svcArg}" (${file})`);
+    return follow ? await followFile(file, out) : 1;
+  }
+  await streamFile(file, out);
+  if (!follow) return 0;
+  return await followFile(file, out, statSync(file).size);
+}
+async function streamFile(file, out) {
+  return new Promise((resolve4, reject) => {
+    const rl = createInterface({ input: createReadStream(file, { encoding: "utf8" }) });
+    rl.on("line", (l) => out(l));
+    rl.on("close", () => resolve4());
+    rl.on("error", reject);
+  });
+}
+async function followFile(file, out, startAt = 0) {
+  let pos = startAt;
+  while (!existsSync4(file)) await new Promise((r) => setTimeout(r, 500));
+  return new Promise((resolve4) => {
+    const tick = async () => {
+      const size = statSync(file).size;
+      if (size > pos) {
+        await new Promise((res) => {
+          const rl = createInterface({ input: createReadStream(file, { encoding: "utf8", start: pos, end: size - 1 }) });
+          rl.on("line", (l) => out(l));
+          rl.on("close", () => {
+            pos = size;
+            res();
+          });
+        });
+      } else if (size < pos) {
+        pos = 0;
+      }
+    };
+    watchFile(file, { interval: 500 }, () => {
+      void tick();
+    });
+    process.once("SIGINT", () => {
+      unwatchFile(file);
+      resolve4(0);
+    });
+  });
+}
+async function runInstall(opts) {
+  const out = opts.out ?? ((l) => console.log(l));
+  const concurrency = opts.concurrency ?? 4;
+  const items = opts.config.services.map((s) => ({ name: s.name, cwd: join3(opts.baseCwd, s.cwd) }));
+  const queue = [...items];
+  const failed = [];
+  let inFlight = 0;
+  await new Promise((resolve4) => {
+    const pump = () => {
+      while (inFlight < concurrency && queue.length) {
+        const item = queue.shift();
+        inFlight++;
+        installOne(item.cwd, opts.env).then((ok) => {
+          inFlight--;
+          if (ok) out(`\u2713 ${item.name}`);
+          else {
+            failed.push(item.name);
+            out(`\u2717 ${item.name}`);
+          }
+          if (queue.length === 0 && inFlight === 0) resolve4();
+          else pump();
+        });
+      }
+    };
+    pump();
+  });
+  if (failed.length) {
+    out(`
+failed: ${failed.join(", ")}`);
+    return 1;
+  }
+  out(`
+${items.length} services up to date`);
+  return 0;
+}
+function installOne(cwd, env) {
+  if (!existsSync4(cwd)) return Promise.resolve(false);
+  if (!needsInstall(cwd)) return Promise.resolve(true);
+  return new Promise((resolve4) => {
+    const command = process.platform === "win32" ? "npm.cmd" : "npm";
+    const proc = spawn(command, ["install"], { cwd, env, stdio: ["ignore", "ignore", "pipe"] });
+    proc.on("close", (code) => {
+      if (code === 0) {
+        writeInstallStamp(cwd);
+        resolve4(true);
+      } else resolve4(false);
+    });
+    proc.on("error", () => resolve4(false));
+  });
+}
+async function runStatus(opts) {
+  const out = opts.out ?? ((l) => console.log(l));
+  out(`${opts.config.icon ?? "\u{1F4E6}"} ${opts.config.name} \u2014 ${opts.config.services.length} services`);
+  out("");
+  const maxLen = Math.max(...opts.config.services.map((s) => s.name.length), 12);
+  out(`${"Service".padEnd(maxLen)}  ${"Port".padStart(5)}  ${"Type".padEnd(4)}  Health`);
+  out("-".repeat(maxLen + 24));
+  for (const svc of opts.config.services) {
+    const up = await checkHealth(svc.port, svc.healthCheck);
+    const health = up ? "\u2713 up" : "\u2717 down";
+    out(`${svc.name.padEnd(maxLen)}  ${String(svc.port).padStart(5)}  ${svc.type.padEnd(4)}  ${health}`);
+  }
+  return 0;
+}
+function runHelp(argv, opts = {}) {
+  const out = opts.out ?? ((l) => console.log(l));
+  const sub = argv[0];
+  if (sub === "logs") {
+    out("Usage: devup logs <service> [--follow|-f]");
+    out("  Print the persisted log file for a service (works without devup running).");
+    out("  --follow tails new lines as they are appended.");
+    return 0;
+  }
+  if (sub === "install") {
+    out("Usage: devup install");
+    out("  Run `npm install` across every service.cwd in parallel (max 4 at a time).");
+    out("  Skips services whose .install-stamp matches package.json hash.");
+    return 0;
+  }
+  if (sub === "status") {
+    out("Usage: devup status");
+    out("  For each service, probes its health-check endpoint and prints up/down.");
+    return 0;
+  }
+  out("Subcommands:");
+  out("  devup logs <service> [--follow]   Read the persisted log file");
+  out("  devup install                     Concurrent npm install across services");
+  out("  devup status                      Health check every service in config");
+  out("  devup help [<subcommand>]         Show detailed help for a subcommand");
+  out("");
+  out("No subcommand \u2192 launch the interactive TUI.");
+  return 0;
+}
+
 // src/platform/detect.ts
 async function detectPlatform() {
   switch (process.platform) {
@@ -365,8 +809,8 @@ async function detectPlatform() {
 }
 
 // src/proxy-config/traefik.ts
-import { existsSync as existsSync3, mkdirSync, writeFileSync } from "fs";
-import { dirname } from "path";
+import { existsSync as existsSync5, mkdirSync, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname2 } from "path";
 var EMPTY_CONFIG = "http:\n  routers: {}\n  services: {}\n";
 var TraefikProvider = class {
   name = "traefik";
@@ -403,9 +847,9 @@ ${svcs.join("\n")}
 `;
   }
   write(content, opts) {
-    const dir = dirname(opts.confPath);
-    if (!existsSync3(dir)) mkdirSync(dir, { recursive: true });
-    writeFileSync(opts.confPath, content);
+    const dir = dirname2(opts.confPath);
+    if (!existsSync5(dir)) mkdirSync(dir, { recursive: true });
+    writeFileSync2(opts.confPath, content);
   }
   clear(opts) {
     this.write(EMPTY_CONFIG, opts);
@@ -413,8 +857,8 @@ ${svcs.join("\n")}
 };
 
 // src/proxy-config/nginx.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
-import { dirname as dirname2 } from "path";
+import { existsSync as existsSync6, mkdirSync as mkdirSync2, writeFileSync as writeFileSync3 } from "fs";
+import { dirname as dirname3 } from "path";
 var EMPTY_CONFIG2 = "# devup: no healthy services\n";
 var NginxProvider = class {
   name = "nginx";
@@ -451,9 +895,9 @@ var NginxProvider = class {
     return blocks.join("\n\n") + "\n";
   }
   write(content, opts) {
-    const dir = dirname2(opts.confPath);
-    if (!existsSync4(dir)) mkdirSync2(dir, { recursive: true });
-    writeFileSync2(opts.confPath, content);
+    const dir = dirname3(opts.confPath);
+    if (!existsSync6(dir)) mkdirSync2(dir, { recursive: true });
+    writeFileSync3(opts.confPath, content);
   }
   clear(opts) {
     this.write(EMPTY_CONFIG2, opts);
@@ -461,8 +905,8 @@ var NginxProvider = class {
 };
 
 // src/proxy-config/caddy.ts
-import { existsSync as existsSync5, mkdirSync as mkdirSync3, writeFileSync as writeFileSync3 } from "fs";
-import { dirname as dirname3 } from "path";
+import { existsSync as existsSync7, mkdirSync as mkdirSync3, writeFileSync as writeFileSync4 } from "fs";
+import { dirname as dirname4 } from "path";
 var EMPTY_CONFIG3 = "# devup: no healthy services\n";
 var CaddyProvider = class {
   name = "caddy";
@@ -485,9 +929,9 @@ var CaddyProvider = class {
     return blocks.join("\n\n") + "\n";
   }
   write(content, opts) {
-    const dir = dirname3(opts.confPath);
-    if (!existsSync5(dir)) mkdirSync3(dir, { recursive: true });
-    writeFileSync3(opts.confPath, content);
+    const dir = dirname4(opts.confPath);
+    if (!existsSync7(dir)) mkdirSync3(dir, { recursive: true });
+    writeFileSync4(opts.confPath, content);
   }
   clear(opts) {
     this.write(EMPTY_CONFIG3, opts);
@@ -509,201 +953,23 @@ function detectProxyProvider(name) {
   return factory();
 }
 
-// src/utils.ts
-import { existsSync as existsSync6, readFileSync, writeFileSync as writeFileSync4 } from "fs";
-import { createHash } from "crypto";
-import { join as join2 } from "path";
-function parseEnvFile(filePath, baseEnv = {}) {
-  const env = { ...baseEnv };
-  if (!existsSync6(filePath)) return env;
-  for (const line of readFileSync(filePath, "utf8").split("\n")) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith("#")) continue;
-    const eqIdx = trimmed.indexOf("=");
-    if (eqIdx === -1) continue;
-    const key = trimmed.slice(0, eqIdx).trim();
-    let val = trimmed.slice(eqIdx + 1).trim();
-    if (val.startsWith('"') && val.endsWith('"') || val.startsWith("'") && val.endsWith("'")) {
-      val = val.slice(1, -1);
-    }
-    if (!env[key]) env[key] = val;
-  }
-  return env;
-}
-function fmtUptime(ms) {
-  if (!ms || ms < 0) return "-";
-  const s = Math.floor(ms / 1e3);
-  if (s < 60) return `${s}s`;
-  const m = Math.floor(s / 60);
-  if (m < 60) return `${m}m${s % 60}s`;
-  const h = Math.floor(m / 60);
-  if (h < 24) return `${h}h${m % 60}m`;
-  const d = Math.floor(h / 24);
-  return `${d}d${h % 24}h`;
-}
-function needsInstall(fullCwd) {
-  const nm = join2(fullCwd, "node_modules");
-  if (!existsSync6(nm)) return true;
-  try {
-    const pkgHash = createHash("md5").update(readFileSync(join2(fullCwd, "package.json"))).digest("hex");
-    const stampFile = join2(nm, ".install-stamp");
-    if (existsSync6(stampFile) && readFileSync(stampFile, "utf8") === pkgHash) return false;
-  } catch {
-  }
-  return true;
-}
-function writeInstallStamp(fullCwd) {
-  try {
-    const pkgHash = createHash("md5").update(readFileSync(join2(fullCwd, "package.json"))).digest("hex");
-    writeFileSync4(join2(fullCwd, "node_modules", ".install-stamp"), pkgHash);
-  } catch {
-  }
-}
-function sortServiceNames(names, sortMode, statsMap, procState) {
-  if (sortMode === "name") return names.slice().sort();
-  return names.slice().sort((a, b) => {
-    if (sortMode === "mem") {
-      return (parseFloat(statsMap[b]?.mem ?? "0") || 0) - (parseFloat(statsMap[a]?.mem ?? "0") || 0);
-    }
-    return (procState[b]?.errors ?? 0) - (procState[a]?.errors ?? 0);
-  });
-}
-function groupByPhase(services) {
-  const phases = {};
-  for (const s of services) {
-    (phases[s.phase] ??= []).push(s);
-  }
-  return phases;
-}
-function buildProcessArgs(svc) {
-  const extra = svc.nodeArgs ?? [];
-  if (!svc.maxMem) return [...extra, ...svc.args];
-  if (svc.cmd === "node") return [`--max-old-space-size=${svc.maxMem}`, ...extra, ...svc.args];
-  return [...extra, ...svc.args];
-}
-function buildProcessEnv(svc, baseEnv) {
-  const env = { ...baseEnv, ...svc.extraEnv ?? {} };
-  if (svc.maxMem && svc.cmd !== "node") {
-    const existing = env["NODE_OPTIONS"] ?? "";
-    const flag = `--max-old-space-size=${svc.maxMem}`;
-    if (!existing.includes("max-old-space-size")) {
-      env["NODE_OPTIONS"] = existing ? `${existing} ${flag}` : flag;
-    }
-  }
-  return env;
-}
-function calcCpuPercent(totalCpuSec, prevCpu, prevTime) {
-  const elapsed = (Date.now() - prevTime) / 1e3;
-  const cpuDelta = totalCpuSec - prevCpu;
-  return elapsed > 0 ? cpuDelta / elapsed * 100 : 0;
-}
-var tagColors = [
-  "cyan",
-  "yellow",
-  "green",
-  "magenta",
-  "blue",
-  "red",
-  "#5faf5f",
-  "#d7af5f",
-  "#5f87d7",
-  "#af5faf",
-  "#5fd7d7",
-  "#d75f5f",
-  "white"
-];
-
 // src/tui/App.tsx
-import { useEffect as useEffect5, useState as useState5, useCallback as useCallback3, useRef as useRef3 } from "react";
+import { useEffect as useEffect5, useState as useState6, useCallback as useCallback3, useRef as useRef3 } from "react";
 import { Box as Box6, Text as Text6, useStdout } from "ink";
 
 // src/tui/hooks/useProcessManager.ts
 import { useState, useEffect, useRef, useCallback } from "react";
 
 // src/process/manager.ts
-import { spawn as spawn2 } from "child_process";
-import { join as join3 } from "path";
-
-// src/process/health.ts
-import net from "net";
-import http from "http";
-function checkPort(port, host = "127.0.0.1", timeoutMs = 2e3) {
-  return new Promise((resolve3) => {
-    const socket = new net.Socket();
-    socket.setTimeout(timeoutMs);
-    socket.once("connect", () => {
-      socket.destroy();
-      resolve3(true);
-    });
-    socket.once("error", () => {
-      socket.destroy();
-      resolve3(false);
-    });
-    socket.once("timeout", () => {
-      socket.destroy();
-      resolve3(false);
-    });
-    socket.connect(port, host);
-  });
-}
-function checkHttp(port, opts = {}) {
-  const path = opts.path ?? "/";
-  const host = opts.host ?? "127.0.0.1";
-  const timeoutMs = opts.timeoutMs ?? 2e3;
-  const accept = (code) => {
-    if (opts.expect === void 0) return code >= 200 && code < 300;
-    if (Array.isArray(opts.expect)) return opts.expect.includes(code);
-    return code === opts.expect;
-  };
-  return new Promise((resolve3) => {
-    const req = http.get({ host, port, path, timeout: timeoutMs }, (res) => {
-      const ok = typeof res.statusCode === "number" && accept(res.statusCode);
-      res.resume();
-      resolve3(ok);
-    });
-    req.on("error", () => resolve3(false));
-    req.on("timeout", () => {
-      req.destroy();
-      resolve3(false);
-    });
-  });
-}
-function checkHealth(port, hc) {
-  if (hc?.type === "http") {
-    return checkHttp(port, {
-      path: hc.path,
-      expect: hc.expect,
-      host: hc.host,
-      timeoutMs: hc.timeoutMs
-    });
-  }
-  return checkPort(port, "127.0.0.1", hc?.timeoutMs);
-}
-function waitForPort(port, opts = {}) {
-  const { timeout = 45e3, interval = 1e3 } = opts;
-  return new Promise((resolve3) => {
-    const start = Date.now();
-    const check = () => {
-      checkPort(port).then((ok) => {
-        if (ok) return resolve3(true);
-        if (Date.now() - start > timeout) return resolve3(false);
-        setTimeout(check, interval);
-      });
-    };
-    check();
-  });
-}
-function deriveHealth(isUp, currentStatus) {
-  if (currentStatus === "idle") return "idle";
-  if (isUp) return "up";
-  return currentStatus === "starting" ? "wait" : "down";
-}
+import { spawn as spawn3 } from "child_process";
+import { existsSync as existsSync9 } from "fs";
+import { join as join4, resolve as resolve3 } from "path";
 
 // src/process/installer.ts
-import { spawn } from "child_process";
-import { existsSync as existsSync7 } from "fs";
+import { spawn as spawn2 } from "child_process";
+import { existsSync as existsSync8 } from "fs";
 function installService(cwd, env, onLog) {
-  if (!existsSync7(cwd)) {
+  if (!existsSync8(cwd)) {
     onLog?.(`\u26A0 directory not found: ${cwd}`);
     return Promise.resolve(false);
   }
@@ -712,9 +978,9 @@ function installService(cwd, env, onLog) {
     return Promise.resolve(true);
   }
   onLog?.("\u{1F4E6} npm install...");
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     const command = process.platform === "win32" ? "npm.cmd" : "npm";
-    const proc = spawn(command, ["install"], { cwd, env, stdio: ["ignore", "ignore", "pipe"] });
+    const proc = spawn2(command, ["install"], { cwd, env, stdio: ["ignore", "ignore", "pipe"] });
     let stderr = "";
     proc.stderr?.on("data", (d) => {
       stderr += d.toString();
@@ -722,16 +988,16 @@ function installService(cwd, env, onLog) {
     proc.on("close", (code) => {
       if (code !== 0) {
         onLog?.(`\u26A0 npm install failed: ${stderr.split("\n")[0]}`);
-        resolve3(false);
+        resolve4(false);
       } else {
         writeInstallStamp(cwd);
         onLog?.("\u2705 dependencies ready");
-        resolve3(true);
+        resolve4(true);
       }
     });
     proc.on("error", (err) => {
       onLog?.(`\u26A0 spawn error: ${err.message}`);
-      resolve3(false);
+      resolve4(false);
     });
   });
 }
@@ -749,6 +1015,26 @@ function compileReadyPattern(pattern) {
     return null;
   }
 }
+function extractWatchPaths(args) {
+  const watchFlags = /* @__PURE__ */ new Set(["--watch", "--watch-path"]);
+  const out = [];
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (watchFlags.has(a)) {
+      const v = args[i + 1];
+      if (v && !v.startsWith("-")) {
+        out.push(v);
+        i++;
+      }
+      continue;
+    }
+    const eq = a.indexOf("=");
+    if (eq > 0 && watchFlags.has(a.slice(0, eq))) {
+      out.push(a.slice(eq + 1));
+    }
+  }
+  return out;
+}
 function lineBuffer(onLine) {
   let buf = "";
   return {
@@ -783,12 +1069,12 @@ var ProcessManager = class {
     this.events = opts.events;
   }
   async install(svc, colorIdx) {
-    const cwd = join3(this.baseCwd, svc.cwd);
+    const cwd = join4(this.baseCwd, svc.cwd);
     const idx = colorIdx ?? this.state.get(svc.name)?.colorIdx ?? 0;
     return installService(cwd, this.env, (msg) => this.log(svc.name, msg, idx));
   }
   async start(svc, colorIdx, isRestart = false) {
-    const cwd = join3(this.baseCwd, svc.cwd);
+    const cwd = join4(this.baseCwd, svc.cwd);
     if (svc.type === "api") {
       const occupied = await checkPort(svc.port);
       if (occupied && !isRestart) {
@@ -804,8 +1090,14 @@ var ProcessManager = class {
       }
     }
     const args = buildProcessArgs(svc);
+    const missingWatchPaths = extractWatchPaths(args).filter((p) => !existsSync9(resolve3(cwd, p)));
+    if (missingWatchPaths.length) {
+      this.log(svc.name, `\u26A0 missing watch paths: ${missingWatchPaths.join(", ")}`, colorIdx);
+      this.recordCrashedState(svc, colorIdx);
+      return;
+    }
     const env = buildProcessEnv(svc, this.env);
-    const proc = spawn2(svc.cmd, args, { cwd, env, detached: true, stdio: ["ignore", "pipe", "pipe"] });
+    const proc = spawn3(svc.cmd, args, { cwd, env, detached: true, stdio: ["ignore", "pipe", "pipe"] });
     const prev = this.state.get(svc.name);
     const state = {
       svc,
@@ -831,12 +1123,14 @@ var ProcessManager = class {
         this.events.onStateChange(svc.name, state);
       }
     };
+    const errorRegex = compileReadyPattern(svc.errorPattern);
+    const countsAsError = (line) => errorRegex ? errorRegex.test(line) : true;
     const stdoutBuf = lineBuffer((line) => {
       markReadyIfMatch(line);
       this.log(svc.name, line, colorIdx);
     });
     const stderrBuf = lineBuffer((line) => {
-      state.errors += 1;
+      if (countsAsError(line)) state.errors += 1;
       markReadyIfMatch(line);
       this.log(svc.name, line, colorIdx);
     });
@@ -877,29 +1171,29 @@ var ProcessManager = class {
   }
   runPreBuild(svc, cwd, colorIdx) {
     this.log(svc.name, `\u{1F528} preBuild: ${svc.preBuild}`, colorIdx);
-    return new Promise((resolve3) => {
+    return new Promise((resolve4) => {
       const isWin = process.platform === "win32";
       const shell = isWin ? "cmd.exe" : "sh";
       const shellFlag = isWin ? "/c" : "-c";
       const env = buildProcessEnv(svc, this.env);
-      const child = spawn2(shell, [shellFlag, svc.preBuild], { cwd, env, stdio: ["ignore", "pipe", "pipe"] });
+      const child = spawn3(shell, [shellFlag, svc.preBuild], { cwd, env, stdio: ["ignore", "pipe", "pipe"] });
       const outBuf = lineBuffer((line) => this.log(svc.name, `[build] ${line}`, colorIdx));
       const errBuf = lineBuffer((line) => this.log(svc.name, `[build] ${line}`, colorIdx));
       child.stdout?.on("data", (d) => outBuf.push(d));
       child.stderr?.on("data", (d) => errBuf.push(d));
       child.on("error", (err) => {
         this.log(svc.name, `[build] \u274C ${err.message}`, colorIdx);
-        resolve3(false);
+        resolve4(false);
       });
       child.on("close", (code) => {
         outBuf.flush();
         errBuf.flush();
         if (code === 0) {
           this.log(svc.name, `[build] \u2705 done`, colorIdx);
-          resolve3(true);
+          resolve4(true);
         } else {
           this.log(svc.name, `[build] \u274C exited with code ${code}`, colorIdx);
-          resolve3(false);
+          resolve4(false);
         }
       });
     });
@@ -909,7 +1203,7 @@ var ProcessManager = class {
     const isWin = process.platform === "win32";
     const shell = isWin ? "cmd.exe" : "sh";
     const shellFlag = isWin ? "/c" : "-c";
-    const child = spawn2(shell, [shellFlag, svc.watchBuild], {
+    const child = spawn3(shell, [shellFlag, svc.watchBuild], {
       cwd,
       env,
       detached: true,
@@ -971,6 +1265,10 @@ var ProcessManager = class {
         st.health = st.status === "idle" ? "idle" : "down";
         continue;
       }
+      const startPeriodMs = (st.svc.healthCheck?.startPeriod ?? 0) * 1e3;
+      if (startPeriodMs > 0 && st.startedAt && Date.now() - st.startedAt < startPeriodMs) {
+        continue;
+      }
       const isUp = await checkHealth(st.svc.port, st.svc.healthCheck);
       const prev = st.health;
       st.health = deriveHealth(isUp, st.status);
@@ -992,14 +1290,14 @@ var ProcessManager = class {
     }
     for (const st of this.state.values()) this.stopWatchProc(st);
     const waits = procs.map(
-      (p) => p.exitCode !== null || p.signalCode !== null ? Promise.resolve() : new Promise((resolve3) => p.once("close", () => resolve3()))
+      (p) => p.exitCode !== null || p.signalCode !== null ? Promise.resolve() : new Promise((resolve4) => p.once("close", () => resolve4()))
     );
     let timedOut = false;
     await Promise.race([
       Promise.all(waits),
-      new Promise((resolve3) => setTimeout(() => {
+      new Promise((resolve4) => setTimeout(() => {
         timedOut = true;
-        resolve3();
+        resolve4();
       }, grace))
     ]);
     if (timedOut) {
@@ -1010,7 +1308,7 @@ var ProcessManager = class {
       }
       await Promise.race([
         Promise.all(waits),
-        new Promise((resolve3) => setTimeout(resolve3, 1e3))
+        new Promise((resolve4) => setTimeout(resolve4, 1e3))
       ]);
     }
   }
@@ -1042,7 +1340,7 @@ function useProcessManager(platform, baseCwd, env, logSink = null) {
       events: {
         onLog: (svcName, text, colorIdx) => {
           sinkRef.current?.write(svcName, text);
-          const entry = { svcName, text, colorIdx, ts: Date.now() };
+          const entry = { svcName, text, colorIdx, ts: Date.now(), level: detectLogLevel(text) };
           if (pausedRef.current) {
             pendingLogsRef.current.push(entry);
             if (pendingLogsRef.current.length > 5e3) {
@@ -1100,7 +1398,7 @@ function useProcessManager(platform, baseCwd, env, logSink = null) {
   }, []);
   const pushLog = useCallback((svcName, text, colorIdx = 0) => {
     sinkRef.current?.write(svcName, text);
-    const entry = { svcName, text, colorIdx, ts: Date.now() };
+    const entry = { svcName, text, colorIdx, ts: Date.now(), level: detectLogLevel(text) };
     if (pausedRef.current) {
       pendingLogsRef.current.push(entry);
       if (pendingLogsRef.current.length > 5e3) {
@@ -1173,8 +1471,11 @@ function useKeyBindings(opts) {
     sortIdx: 0,
     proxyEnabled: false,
     logsScrollOffset: 0,
-    statsScrollOffset: 0
+    statsScrollOffset: 0,
+    levelFilter: "all",
+    verboseStats: false
   });
+  const LEVEL_CYCLE = ["all", "error", "warn"];
   const setModal = useCallback2((modal) => setState((s) => ({ ...s, modal })), []);
   const setFilter = useCallback2((f) => setState((s) => ({ ...s, logFilter: f, modal: "none" })), []);
   const setSearch = useCallback2((t) => setState((s) => ({ ...s, searchTerm: t, modal: "none" })), []);
@@ -1196,14 +1497,15 @@ function useKeyBindings(opts) {
     else if (input === "r") setModal("restart");
     else if (input === "o") setModal("open");
     else if (input === "/") setModal("search");
-    else if (input === "a") setState((s) => ({ ...s, logFilter: null, searchTerm: null }));
+    else if (input === "a") setState((s) => ({ ...s, logFilter: null, searchTerm: null, levelFilter: "all" }));
     else if (input === "p") setState((s) => ({ ...s, logsPaused: !s.logsPaused }));
     else if (input === "t") setState((s) => ({ ...s, showTimestamps: !s.showTimestamps }));
     else if (input === "s") setState((s) => ({ ...s, sortIdx: (s.sortIdx + 1) % SORT_MODES.length }));
     else if (input === "T") {
       opts.onToggleProxy();
       setState((s) => ({ ...s, proxyEnabled: !s.proxyEnabled }));
-    }
+    } else if (input === "L") setState((s) => ({ ...s, levelFilter: LEVEL_CYCLE[(LEVEL_CYCLE.indexOf(s.levelFilter) + 1) % LEVEL_CYCLE.length] }));
+    else if (input === "v") setState((s) => ({ ...s, verboseStats: !s.verboseStats }));
   }, { isActive });
   return {
     ...state,
@@ -1245,11 +1547,12 @@ function useProxySync(provider, opts, states, enabled) {
 }
 
 // src/tui/LogsPanel.tsx
-import { useEffect as useEffect3 } from "react";
+import { useEffect as useEffect3, useMemo } from "react";
 import { Box, Text } from "ink";
 import { jsx, jsxs } from "react/jsx-runtime";
-function LogsPanel({ logs, filter, searchTerm, paused, showTimestamps, maxNameLen, height, focused, scrollOffset, resetScroll }) {
-  const filtered = filter ? logs.filter((l) => l.svcName === filter) : logs;
+function LogsPanel({ logs, filter, searchTerm, paused, showTimestamps, maxNameLen, height, focused, scrollOffset, resetScroll, levelFilter = "all" }) {
+  const byService = filter ? logs.filter((l) => l.svcName === filter) : logs;
+  const filtered = levelFilter === "all" ? byService : levelFilter === "error" ? byService.filter((l) => l.level === "error") : byService.filter((l) => l.level === "error" || l.level === "warn");
   const contentHeight = Math.max(1, height - 2);
   const totalLines = filtered.length;
   const maxOffset = Math.max(0, totalLines - contentHeight);
@@ -1260,11 +1563,14 @@ function LogsPanel({ logs, filter, searchTerm, paused, showTimestamps, maxNameLe
   useEffect3(() => {
     resetScroll();
   }, [filter, searchTerm, resetScroll]);
+  const matcher = useMemo(() => compileSearchPattern(searchTerm), [searchTerm]);
   const scrolled = effectiveOffset > 0;
   const label = [
     "Logs",
     filter ? `[${filter}]` : "",
     searchTerm ? `/${searchTerm}` : "",
+    matcher?.invalid ? "(invalid regex)" : "",
+    levelFilter !== "all" ? `[level: ${levelFilter}${levelFilter === "warn" ? "+error" : ""}]` : "",
     paused ? "[PAUSED]" : "",
     scrolled ? "[SCROLL]" : "",
     `${filtered.length} lines`,
@@ -1280,7 +1586,7 @@ function LogsPanel({ logs, filter, searchTerm, paused, showTimestamps, maxNameLe
       const color = tagColors[entry.colorIdx % tagColors.length];
       const ts = showTimestamps ? new Date(entry.ts).toLocaleTimeString("en-GB") + " " : "";
       const line = entry.text;
-      const isMatch = searchTerm && line.toLowerCase().includes(searchTerm.toLowerCase());
+      const isMatch = matcher ? matcher.test(line) : false;
       return /* @__PURE__ */ jsxs(Box, { children: [
         showTimestamps && /* @__PURE__ */ jsx(Text, { dimColor: true, children: ts }),
         /* @__PURE__ */ jsxs(Text, { color, children: [
@@ -1296,7 +1602,7 @@ function LogsPanel({ logs, filter, searchTerm, paused, showTimestamps, maxNameLe
 }
 
 // src/tui/StatsPanel.tsx
-import { useEffect as useEffect4 } from "react";
+import { useEffect as useEffect4, useState as useState3 } from "react";
 import { Box as Box2, Text as Text2 } from "ink";
 import os from "os";
 import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
@@ -1306,29 +1612,71 @@ var H = {
   down: { c: "\u25CF", color: "red" },
   idle: { c: "\u25CB", color: "blue" }
 };
-function Row({ name, st, stat, ml }) {
-  const h = H[st.health] ?? H["down"];
+var MAX_RESTARTS2 = 3;
+function isCrashLooped(st) {
+  return st.status === "crashed" && st.restarts >= MAX_RESTARTS2;
+}
+function Row({ name, st, stat, ml, verbose }) {
+  const looped = isCrashLooped(st);
+  const indicator = looped ? /* @__PURE__ */ jsx2(Text2, { color: "red", bold: true, children: "\u2716" }) : /* @__PURE__ */ jsx2(Text2, { color: (H[st.health] ?? H["down"]).color, children: (H[st.health] ?? H["down"]).c });
   const color = tagColors[st.colorIdx % tagColors.length];
-  const sc = st.status === "running" ? "green" : st.status === "starting" ? "yellow" : st.status === "idle" ? "blue" : "red";
+  const sc = looped ? "red" : st.status === "running" ? "green" : st.status === "starting" ? "yellow" : st.status === "idle" ? "blue" : "red";
+  const statusLabel = looped ? "looping" : st.status;
   const up = st.startedAt ? fmtUptime(Date.now() - st.startedAt) : "-";
-  return /* @__PURE__ */ jsxs2(Text2, { children: [
-    /* @__PURE__ */ jsx2(Text2, { color: h.color, children: h.c }),
-    " ",
-    /* @__PURE__ */ jsx2(Text2, { color, children: name.padEnd(ml) }),
-    " ",
-    String(st.svc.port).padStart(5),
-    " ",
-    /* @__PURE__ */ jsx2(Text2, { color: sc, children: st.status.padEnd(8) }),
-    " ",
-    (stat?.cpu ?? "-").padStart(6),
-    " ",
-    (stat?.mem ?? "-").padStart(8),
-    " ",
-    String(st.errors).padStart(3),
-    " ",
-    String(st.restarts).padStart(3),
-    " ",
-    up.padStart(6)
+  if (!verbose) {
+    return /* @__PURE__ */ jsxs2(Text2, { children: [
+      indicator,
+      " ",
+      /* @__PURE__ */ jsx2(Text2, { color, children: name.padEnd(ml) }),
+      " ",
+      String(st.svc.port).padStart(5),
+      " ",
+      /* @__PURE__ */ jsx2(Text2, { color: sc, bold: looped, children: statusLabel.padEnd(8) }),
+      " ",
+      (stat?.cpu ?? "-").padStart(6),
+      " ",
+      (stat?.mem ?? "-").padStart(8),
+      " ",
+      String(st.errors).padStart(3),
+      " ",
+      String(st.restarts).padStart(3),
+      " ",
+      up.padStart(6)
+    ] });
+  }
+  const resolvedArgs = buildProcessArgs(st.svc).join(" ");
+  const env = redactSecrets(st.svc.extraEnv);
+  const envStr = Object.entries(env).map(([k, v]) => `${k}=${v}`).join(" ");
+  return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", children: [
+    /* @__PURE__ */ jsxs2(Text2, { children: [
+      indicator,
+      " ",
+      /* @__PURE__ */ jsx2(Text2, { color, children: name.padEnd(ml) }),
+      " ",
+      String(st.svc.port).padStart(5),
+      " ",
+      /* @__PURE__ */ jsx2(Text2, { color: sc, bold: looped, children: statusLabel.padEnd(8) }),
+      " ",
+      (stat?.cpu ?? "-").padStart(6),
+      " ",
+      (stat?.mem ?? "-").padStart(8),
+      " ",
+      String(st.errors).padStart(3),
+      " ",
+      String(st.restarts).padStart(3),
+      " ",
+      up.padStart(6)
+    ] }),
+    /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
+      "   cmd: ",
+      st.svc.cmd,
+      " ",
+      resolvedArgs
+    ] }),
+    envStr && /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
+      "   env: ",
+      envStr
+    ] })
   ] });
 }
 function ColHeader({ ml }) {
@@ -1347,7 +1695,7 @@ function ColHeader({ ml }) {
     "Up".padStart(6)
   ] });
 }
-function StatsPanel({ states, stats, sortMode, maxNameLen, height, focused, scrollOffset, resetScroll }) {
+function StatsPanel({ states, stats, sortMode, maxNameLen, height, focused, scrollOffset, resetScroll, verbose = false }) {
   const names = [...states.keys()];
   const stObj = Object.fromEntries([...states].map(([k, v]) => [k, { errors: v.errors }]));
   const statsObj = Object.fromEntries([...stats].map(([k, v]) => [k, v]));
@@ -1385,6 +1733,13 @@ function StatsPanel({ states, stats, sortMode, maxNameLen, height, focused, scro
   const totalRowsLong = Math.max(apis.length, webs.length);
   const positionInfo = focused && totalRowsLong > 0 ? `(${effectiveOffset + 1}-${Math.min(effectiveOffset + rowsPerCol, totalRowsLong)}/${totalRowsLong})` : "";
   const scrolled = effectiveOffset > 0;
+  const loopedCount = [...states.values()].filter(isCrashLooped).length;
+  const ramPct = parseFloat(usedGB) / parseFloat(totalGB) * 100;
+  const [ramBanner, setRamBanner] = useState3(false);
+  useEffect4(() => {
+    setRamBanner((prev) => nextRamBannerVisibility(ramPct, prev));
+  }, [ramPct]);
+  const topConsumers = ramBanner ? [...stats.entries()].map(([n, s]) => ({ name: n, mb: parseFloat(s.mem) || 0 })).sort((a, b) => b.mb - a.mb).slice(0, 3) : [];
   return /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", borderStyle: "round", borderColor: focused ? "green" : "gray", height, children: [
     /* @__PURE__ */ jsxs2(Box2, { children: [
       /* @__PURE__ */ jsxs2(Text2, { bold: true, color: "green", children: [
@@ -1392,6 +1747,11 @@ function StatsPanel({ states, stats, sortMode, maxNameLen, height, focused, scro
         positionInfo
       ] }),
       scrolled && /* @__PURE__ */ jsx2(Text2, { color: "yellow", children: " [SCROLL]" }),
+      loopedCount > 0 && /* @__PURE__ */ jsxs2(Text2, { color: "red", bold: true, children: [
+        " \u26A0 ",
+        loopedCount,
+        " need attention"
+      ] }),
       /* @__PURE__ */ jsxs2(Text2, { dimColor: true, children: [
         " System: ",
         cpus,
@@ -1421,6 +1781,14 @@ function StatsPanel({ states, stats, sortMode, maxNameLen, height, focused, scro
         sortMode
       ] })
     ] }),
+    ramBanner && /* @__PURE__ */ jsxs2(Box2, { children: [
+      /* @__PURE__ */ jsxs2(Text2, { color: "yellow", bold: true, children: [
+        " \u26A0 RAM ",
+        ramPct.toFixed(0),
+        "% \u2014 top: "
+      ] }),
+      /* @__PURE__ */ jsx2(Text2, { color: "yellow", children: topConsumers.map((c) => `${c.name} ${c.mb.toFixed(0)}MB`).join(", ") })
+    ] }),
     /* @__PURE__ */ jsxs2(Box2, { flexGrow: 1, children: [
       /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", flexGrow: 1, flexBasis: 0, children: [
         /* @__PURE__ */ jsxs2(Text2, { bold: true, color: "cyan", children: [
@@ -1429,7 +1797,7 @@ function StatsPanel({ states, stats, sortMode, maxNameLen, height, focused, scro
           ")"
         ] }),
         /* @__PURE__ */ jsx2(ColHeader, { ml }),
-        visibleApis.map((n) => /* @__PURE__ */ jsx2(Row, { name: n, st: states.get(n), stat: stats.get(n), ml }, n))
+        visibleApis.map((n) => /* @__PURE__ */ jsx2(Row, { name: n, st: states.get(n), stat: stats.get(n), ml, verbose }, n))
       ] }),
       /* @__PURE__ */ jsx2(Box2, { flexDirection: "column", width: 1, children: Array.from({ length: contentHeight }, (_, i) => /* @__PURE__ */ jsx2(Text2, { dimColor: true, children: "\u2502" }, i)) }),
       /* @__PURE__ */ jsxs2(Box2, { flexDirection: "column", flexGrow: 1, flexBasis: 0, children: [
@@ -1439,7 +1807,7 @@ function StatsPanel({ states, stats, sortMode, maxNameLen, height, focused, scro
           ")"
         ] }),
         /* @__PURE__ */ jsx2(ColHeader, { ml }),
-        visibleWebs.map((n) => /* @__PURE__ */ jsx2(Row, { name: n, st: states.get(n), stat: stats.get(n), ml }, n))
+        visibleWebs.map((n) => /* @__PURE__ */ jsx2(Row, { name: n, st: states.get(n), stat: stats.get(n), ml, verbose }, n))
       ] })
     ] })
   ] });
@@ -1464,6 +1832,8 @@ function StatusBar() {
     " Clear  ",
     /* @__PURE__ */ jsx3(Text3, { bold: true, children: "f" }),
     " Filter  ",
+    /* @__PURE__ */ jsx3(Text3, { bold: true, children: "L" }),
+    " Level  ",
     /* @__PURE__ */ jsx3(Text3, { bold: true, children: "a" }),
     " All  ",
     /* @__PURE__ */ jsx3(Text3, { bold: true, children: "r" }),
@@ -1478,48 +1848,86 @@ function StatusBar() {
     " Pause  ",
     /* @__PURE__ */ jsx3(Text3, { bold: true, children: "t" }),
     " Time  ",
+    /* @__PURE__ */ jsx3(Text3, { bold: true, children: "v" }),
+    " Verbose  ",
     /* @__PURE__ */ jsx3(Text3, { bold: true, children: "T" }),
     " Proxy"
   ] }) });
 }
 
 // src/tui/ServiceList.tsx
-import { useState as useState3 } from "react";
+import { useState as useState4, useMemo as useMemo2 } from "react";
 import { Box as Box4, Text as Text4, useInput as useInput2 } from "ink";
 import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 function ServiceList({ title, services, onSelect, onClose, filterType }) {
-  const names = [...services.keys()].filter((n) => !filterType || services.get(n).svc.type === filterType);
-  const [idx, setIdx] = useState3(0);
+  const allNames = useMemo2(
+    () => [...services.keys()].filter((n) => !filterType || services.get(n).svc.type === filterType),
+    [services, filterType]
+  );
+  const [idx, setIdx] = useState4(0);
+  const [query, setQuery] = useState4("");
+  const names = useMemo2(() => {
+    if (!query) return allNames;
+    const q = query.toLowerCase();
+    return allNames.filter((n) => n.toLowerCase().includes(q));
+  }, [allNames, query]);
+  const clamped = Math.min(idx, Math.max(0, names.length - 1));
   useInput2((input, key) => {
-    if (key.escape) onClose();
-    else if (key.return) {
-      if (names[idx]) onSelect(names[idx]);
-    } else if (key.upArrow) setIdx((i) => Math.max(0, i - 1));
-    else if (key.downArrow) setIdx((i) => Math.min(names.length - 1, i + 1));
+    if (key.escape) {
+      if (query) setQuery("");
+      else onClose();
+      return;
+    }
+    if (key.return) {
+      if (names[clamped]) onSelect(names[clamped]);
+      return;
+    }
+    if (key.upArrow) {
+      setIdx((i) => Math.max(0, i - 1));
+      return;
+    }
+    if (key.downArrow) {
+      setIdx((i) => Math.min(names.length - 1, i + 1));
+      return;
+    }
+    if (key.backspace || key.delete) {
+      setQuery((q) => q.slice(0, -1));
+      setIdx(0);
+      return;
+    }
+    if (input && !key.ctrl && !key.meta && input.length === 1) {
+      setQuery((q) => q + input);
+      setIdx(0);
+    }
   }, { isActive: process.stdin.isTTY ?? false });
   return /* @__PURE__ */ jsxs4(Box4, { flexDirection: "column", borderStyle: "round", borderColor: "cyan", paddingX: 1, children: [
     /* @__PURE__ */ jsxs4(Text4, { bold: true, color: "cyan", children: [
       " ",
       title,
-      " "
+      " ",
+      query && /* @__PURE__ */ jsxs4(Text4, { color: "yellow", children: [
+        "[",
+        query,
+        "]"
+      ] })
     ] }),
-    names.map((name, i) => /* @__PURE__ */ jsx4(Box4, { children: /* @__PURE__ */ jsxs4(Text4, { color: i === idx ? "cyan" : void 0, inverse: i === idx, children: [
+    names.length === 0 ? /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: " (no matches) " }) : names.map((name, i) => /* @__PURE__ */ jsx4(Box4, { children: /* @__PURE__ */ jsxs4(Text4, { color: i === clamped ? "cyan" : void 0, inverse: i === clamped, children: [
       " ",
       name,
       " :",
       services.get(name).svc.port,
       " "
     ] }) }, name)),
-    /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: "\u2191\u2193 navigate  Enter select  Esc close" })
+    /* @__PURE__ */ jsx4(Text4, { dimColor: true, children: "type to filter  \u2191\u2193 navigate  Enter select  Esc clear/close" })
   ] });
 }
 
 // src/tui/SearchInput.tsx
-import { useState as useState4 } from "react";
+import { useState as useState5 } from "react";
 import { Box as Box5, Text as Text5, useInput as useInput3 } from "ink";
 import { jsx as jsx5, jsxs as jsxs5 } from "react/jsx-runtime";
 function SearchInput({ onSubmit, onClose }) {
-  const [value, setValue] = useState4("");
+  const [value, setValue] = useState5("");
   useInput3((input, key) => {
     if (key.escape) onClose();
     else if (key.return) onSubmit(value.trim() || null);
@@ -1647,8 +2055,8 @@ function createLazyProxy(opts) {
 }
 
 // src/process/external.ts
-import { spawn as spawn3 } from "child_process";
-import { join as join4 } from "path";
+import { spawn as spawn4 } from "child_process";
+import { join as join5 } from "path";
 var DEFAULT_START_TIMEOUT_S = 60;
 async function startExternals(externals, opts) {
   const procs = [];
@@ -1681,16 +2089,16 @@ async function stopExternals(procs, platform, opts = {}) {
       if (pid) platform.killTree(pid);
       if (svc.stopCmd) {
         opts.onLog?.(svc.name, `\u{1F9F9} ${svc.stopCmd}`);
-        await new Promise((resolve3) => {
+        await new Promise((resolve4) => {
           const isWin = process.platform === "win32";
           const shell = isWin ? "cmd.exe" : "sh";
           const flag = isWin ? "/c" : "-c";
-          const cwd = svc.cwd ? join4(opts.baseCwd, svc.cwd) : opts.baseCwd;
+          const cwd = svc.cwd ? join5(opts.baseCwd, svc.cwd) : opts.baseCwd;
           const env = { ...opts.env, ...svc.extraEnv ?? {} };
-          const child = spawn3(shell, [flag, svc.stopCmd], { cwd, env, stdio: "ignore" });
-          child.on("close", () => resolve3());
-          child.on("error", () => resolve3());
-          setTimeout(() => resolve3(), 1e4);
+          const child = spawn4(shell, [flag, svc.stopCmd], { cwd, env, stdio: "ignore" });
+          child.on("close", () => resolve4());
+          child.on("error", () => resolve4());
+          setTimeout(() => resolve4(), 1e4);
         });
       }
     } catch {
@@ -1702,10 +2110,10 @@ function spawnExternal(svc, opts) {
   const isWin = process.platform === "win32";
   const shell = isWin ? "cmd.exe" : "sh";
   const flag = isWin ? "/c" : "-c";
-  const cwd = svc.cwd ? join4(opts.baseCwd, svc.cwd) : opts.baseCwd;
+  const cwd = svc.cwd ? join5(opts.baseCwd, svc.cwd) : opts.baseCwd;
   const env = { ...opts.env, ...svc.extraEnv ?? {} };
   opts.onLog?.(svc.name, `\u{1F680} ${svc.cmd}`);
-  const child = spawn3(shell, [flag, svc.cmd], {
+  const child = spawn4(shell, [flag, svc.cmd], {
     cwd,
     env,
     detached: true,
@@ -1726,11 +2134,36 @@ async function waitHealthy(svc, timeoutMs) {
   return false;
 }
 
+// src/tui/tips.ts
+function pickTip(state) {
+  if (state.crashLoopedCount > 0 && !state.shown.has("crashed")) {
+    return { id: "crashed", message: "tip: press r to restart, or check the log of the failing service" };
+  }
+  if (state.totalLogs > 1e3 && !state.hasSearch && !state.shown.has("search")) {
+    return { id: "search", message: "tip: press / to search in logs" };
+  }
+  if (state.totalLogs > 500 && !state.hasFilter && !state.shown.has("filter")) {
+    return { id: "filter", message: "tip: press f to filter logs by service" };
+  }
+  return null;
+}
+
 // src/tui/App.tsx
 import { jsx as jsx6, jsxs as jsxs6 } from "react/jsx-runtime";
+function buildServiceUrl(name, port, proxyActive, proxyOpts) {
+  if (proxyActive && proxyOpts) {
+    const sub = proxyOpts.routes[name];
+    if (sub !== void 0) {
+      const host = sub ? `${sub}.${proxyOpts.domain}` : proxyOpts.domain;
+      const scheme = proxyOpts.tls ? "https" : "http";
+      return `${scheme}://${host}`;
+    }
+  }
+  return `http://localhost:${port}`;
+}
 function App({ config, services, cliArgs, platform, env, baseCwd, proxyProvider, proxyOpts, logSink }) {
   const { stdout } = useStdout();
-  const [rows, setRows] = useState5(stdout?.rows ?? 40);
+  const [rows, setRows] = useState6(stdout?.rows ?? 40);
   useEffect5(() => {
     if (!stdout) return;
     const onResize = () => setRows(stdout.rows ?? 40);
@@ -1743,9 +2176,11 @@ function App({ config, services, cliArgs, platform, env, baseCwd, proxyProvider,
   const statsHeight = rows - logsHeight - 2;
   const maxNameLen = Math.max(...services.map((s) => s.name.length), 10);
   const pm = useProcessManager(platform, baseCwd, env, logSink);
-  const [booted, setBooted] = useState5(false);
+  const [booted, setBooted] = useState6(false);
   const lazyProxies = useRef3(/* @__PURE__ */ new Map());
   const externals = useRef3([]);
+  const shownTips = useRef3(/* @__PURE__ */ new Set());
+  const [activeTip, setActiveTip] = useState6(null);
   const kb = useKeyBindings({
     onQuit: () => {
       void shutdown();
@@ -1771,6 +2206,21 @@ function App({ config, services, cliArgs, platform, env, baseCwd, proxyProvider,
   useEffect5(() => {
     pm.setPaused(kb.logsPaused || kb.logsScrollOffset > 0);
   }, [kb.logsPaused, kb.logsScrollOffset, pm]);
+  useEffect5(() => {
+    const tip = pickTip({
+      totalLogs: pm.logs.length,
+      hasSearch: !!kb.searchTerm,
+      hasFilter: !!kb.logFilter,
+      crashLoopedCount: [...pm.states.values()].filter(isCrashLooped).length,
+      shown: shownTips.current
+    });
+    if (tip && tip.id !== activeTip) {
+      shownTips.current.add(tip.id);
+      setActiveTip(tip.message);
+      const timer = setTimeout(() => setActiveTip(null), 12e3);
+      return () => clearTimeout(timer);
+    }
+  }, [pm.logs.length, pm.states, kb.searchTerm, kb.logFilter, activeTip]);
   useProxySync(proxyProvider, proxyOpts, pm.states, kb.proxyEnabled);
   useEffect5(() => {
     if (booted || !pm.manager) return;
@@ -1885,23 +2335,32 @@ function App({ config, services, cliArgs, platform, env, baseCwd, proxyProvider,
   }, [pm, kb]);
   const handleOpenSelect = useCallback3((name) => {
     const st = pm.states.get(name);
-    if (st) platform.openBrowser(`http://localhost:${st.svc.port}`);
+    if (st) {
+      const url = buildServiceUrl(name, st.svc.port, cliArgs.proxy, proxyOpts);
+      platform.openBrowser(url);
+    }
     kb.setModal("none");
-  }, [pm, platform, kb]);
+  }, [pm, platform, kb, cliArgs.proxy, proxyOpts]);
   const icon = config.icon ?? "\u{1F4E6}";
   const modeLabel = cliArgs.lazy && config.lazy ? "lazy" : "normal";
   return /* @__PURE__ */ jsxs6(Box6, { flexDirection: "column", height: rows, children: [
-    /* @__PURE__ */ jsx6(Box6, { children: /* @__PURE__ */ jsxs6(Text6, { bold: true, color: "cyan", children: [
-      " ",
-      icon,
-      " ",
-      config.name,
-      " \u2014 devup \u2014 ",
-      services.length,
-      " services (",
-      modeLabel,
-      ") "
-    ] }) }),
+    /* @__PURE__ */ jsxs6(Box6, { children: [
+      /* @__PURE__ */ jsxs6(Text6, { bold: true, color: "cyan", children: [
+        " ",
+        icon,
+        " ",
+        config.name,
+        " \u2014 devup \u2014 ",
+        services.length,
+        " services (",
+        modeLabel,
+        ") "
+      ] }),
+      activeTip && /* @__PURE__ */ jsxs6(Text6, { dimColor: true, children: [
+        " \xB7 ",
+        activeTip
+      ] })
+    ] }),
     /* @__PURE__ */ jsx6(
       LogsPanel,
       {
@@ -1914,7 +2373,8 @@ function App({ config, services, cliArgs, platform, env, baseCwd, proxyProvider,
         height: logsHeight,
         focused: kb.panel === "logs",
         scrollOffset: kb.logsScrollOffset,
-        resetScroll: kb.resetLogsScroll
+        resetScroll: kb.resetLogsScroll,
+        levelFilter: kb.levelFilter
       }
     ),
     /* @__PURE__ */ jsx6(
@@ -1927,7 +2387,8 @@ function App({ config, services, cliArgs, platform, env, baseCwd, proxyProvider,
         height: statsHeight,
         focused: kb.panel === "stats",
         scrollOffset: kb.statsScrollOffset,
-        resetScroll: kb.resetStatsScroll
+        resetScroll: kb.resetStatsScroll,
+        verbose: kb.verboseStats
       }
     ),
     kb.modal === "filter" && /* @__PURE__ */ jsx6(ServiceList, { title: "Filter by service", services: pm.states, onSelect: handleFilterSelect, onClose: () => kb.setModal("none") }),
@@ -1939,23 +2400,23 @@ function App({ config, services, cliArgs, platform, env, baseCwd, proxyProvider,
 }
 
 // src/process/log-sink.ts
-import { existsSync as existsSync8, mkdirSync as mkdirSync4, renameSync, createWriteStream } from "fs";
-import { join as join5, dirname as dirname4 } from "path";
-import { homedir } from "os";
+import { existsSync as existsSync10, mkdirSync as mkdirSync4, renameSync, createWriteStream } from "fs";
+import { join as join6, dirname as dirname5 } from "path";
+import { homedir as homedir2 } from "os";
 var LogSink = class {
   dir;
   rotateOnStart;
   streams = /* @__PURE__ */ new Map();
   seen = /* @__PURE__ */ new Set();
   constructor(opts) {
-    const root = opts.rootDir ?? join5(homedir(), ".devup", "logs");
-    this.dir = join5(root, sanitize(opts.projectName));
+    const root = opts.rootDir ?? join6(homedir2(), ".devup", "logs");
+    this.dir = join6(root, sanitize2(opts.projectName));
     this.rotateOnStart = opts.rotateOnStart ?? true;
     mkdirSync4(this.dir, { recursive: true });
   }
   /** Returns the file path for a service log (useful for tests / UI). */
   pathFor(svcName) {
-    return join5(this.dir, `${sanitize(svcName)}.log`);
+    return join6(this.dir, `${sanitize2(svcName)}.log`);
   }
   write(svcName, line) {
     const stream = this.streamFor(svcName);
@@ -1974,9 +2435,9 @@ var LogSink = class {
     let s = this.streams.get(svcName);
     if (s) return s;
     const file = this.pathFor(svcName);
-    if (this.rotateOnStart && !this.seen.has(svcName) && existsSync8(file)) {
+    if (this.rotateOnStart && !this.seen.has(svcName) && existsSync10(file)) {
       try {
-        mkdirSync4(dirname4(file), { recursive: true });
+        mkdirSync4(dirname5(file), { recursive: true });
         renameSync(file, file + ".prev");
       } catch {
       }
@@ -1989,7 +2450,7 @@ var LogSink = class {
     return s;
   }
 };
-function sanitize(name) {
+function sanitize2(name) {
   return name.replace(/[^a-zA-Z0-9._-]+/g, "_").replace(/^_+|_+$/g, "") || "devup";
 }
 
@@ -2160,9 +2621,46 @@ function defineConfig(config) {
 }
 
 // src/index.ts
+function readVersion() {
+  try {
+    const here = dirname6(fileURLToPath2(import.meta.url));
+    const pkgPath = join7(here, "..", "package.json");
+    return JSON.parse(readFileSync2(pkgPath, "utf8")).version ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+}
 async function main() {
+  const raw = process.argv.slice(2);
+  if (raw.includes("-v") || raw.includes("--version")) {
+    console.log(readVersion());
+    return;
+  }
+  if (raw.includes("-h") || raw.includes("--help")) {
+    console.log(USAGE);
+    return;
+  }
+  const subcmd = detectSubcommand(raw);
+  if (subcmd === "help") {
+    process.exit(runHelp(raw.slice(1)));
+  }
   const cwd = process.cwd();
-  const cliArgs = parseCliArgs(process.argv.slice(2));
+  const cliArgs = parseCliArgs(raw);
+  if (subcmd) {
+    const subArgs = raw.slice(1);
+    let cfgPath;
+    try {
+      cfgPath = findConfigFile(cwd, cliArgs.configPath);
+    } catch (e) {
+      console.error(`\u274C ${e.message}`);
+      process.exit(1);
+    }
+    const cfg = await loadConfig(cfgPath);
+    const subOpts = { config: cfg, baseCwd: cwd, env: process.env, logDir: cliArgs.logDir };
+    if (subcmd === "logs") process.exit(await runLogs(subArgs, subOpts));
+    if (subcmd === "install") process.exit(await runInstall(subOpts));
+    if (subcmd === "status") process.exit(await runStatus(subOpts));
+  }
   let configPath;
   try {
     configPath = findConfigFile(cwd, cliArgs.configPath);
@@ -2189,7 +2687,7 @@ ${formatValidationErrors(errors)}`);
     process.exit(1);
   }
   const platform = await detectPlatform();
-  const envFile = config.envFile ? join6(cwd, config.envFile) : join6(cwd, ".env");
+  const envFile = config.envFile ? join7(cwd, config.envFile) : join7(cwd, ".env");
   const env = parseEnvFile(envFile, process.env);
   if (config.env) {
     for (const [k, v] of Object.entries(config.env)) {
@@ -2206,7 +2704,7 @@ ${formatValidationErrors(errors)}`);
       routes: config.proxy.routes,
       tls: cliArgs.proxyTls ?? config.proxy.tls ?? true,
       entrypoint: cliArgs.proxyEntrypoint ?? config.proxy.entrypoint ?? "websecure",
-      confPath: cliArgs.proxyConf ?? config.proxy.confPath ?? join6(homedir2(), ".traefik", "traefik_conf.yaml")
+      confPath: cliArgs.proxyConf ?? config.proxy.confPath ?? join7(homedir3(), ".traefik", "traefik_conf.yaml")
     };
   }
   if (cliArgs.dryRun) {