agentflow-core 0.6.0 → 0.6.2

package/dist/{chunk-VF4FSBXR.js → chunk-BXZC5ZMJ.js}

@@ -206,9 +206,289 @@ function getTraceTree(trace) {
   return result;
 }
 
+// src/process-audit.ts
+import { execSync } from "child_process";
+import { existsSync, readdirSync, readFileSync, statSync } from "fs";
+import { basename, join } from "path";
+function isPidAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function pidMatchesName(pid, name) {
+  try {
+    const cmdline = readFileSync(`/proc/${pid}/cmdline`, "utf8");
+    return cmdline.includes(name);
+  } catch {
+    return false;
+  }
+}
+function readPidFile(path) {
+  try {
+    const pid = parseInt(readFileSync(path, "utf8").trim(), 10);
+    return isNaN(pid) ? null : pid;
+  } catch {
+    return null;
+  }
+}
+function auditPidFile(config) {
+  if (!config.pidFile) return null;
+  const pid = readPidFile(config.pidFile);
+  if (pid === null) {
+    return {
+      path: config.pidFile,
+      pid: null,
+      alive: false,
+      matchesProcess: false,
+      stale: !existsSync(config.pidFile),
+      reason: existsSync(config.pidFile) ? "PID file exists but content is invalid" : "No PID file found"
+    };
+  }
+  const alive = isPidAlive(pid);
+  const matchesProcess = alive ? pidMatchesName(pid, config.processName) : false;
+  const stale = !alive || alive && !matchesProcess;
+  let reason;
+  if (alive && matchesProcess) {
+    reason = `PID ${pid} alive and matches ${config.processName}`;
+  } else if (alive && !matchesProcess) {
+    reason = `PID ${pid} alive but is NOT ${config.processName} (PID reused by another process)`;
+  } else {
+    reason = `PID ${pid} no longer exists`;
+  }
+  return { path: config.pidFile, pid, alive, matchesProcess, stale, reason };
+}
+function auditSystemd(config) {
+  if (config.systemdUnit === null || config.systemdUnit === void 0) return null;
+  const unit = config.systemdUnit;
+  try {
+    const raw = execSync(
+      `systemctl --user show ${unit} --property=ActiveState,SubState,MainPID,NRestarts,Result --no-pager 2>/dev/null`,
+      { encoding: "utf8", timeout: 5e3 }
+    );
+    const props = {};
+    for (const line of raw.trim().split("\n")) {
+      const [k, ...v] = line.split("=");
+      if (k) props[k.trim()] = v.join("=").trim();
+    }
+    const activeState = props["ActiveState"] ?? "unknown";
+    const subState = props["SubState"] ?? "unknown";
+    const mainPid = parseInt(props["MainPID"] ?? "0", 10);
+    const restarts = parseInt(props["NRestarts"] ?? "0", 10);
+    const result = props["Result"] ?? "unknown";
+    return {
+      unit,
+      activeState,
+      subState,
+      mainPid,
+      restarts,
+      result,
+      crashLooping: activeState === "activating" && subState === "auto-restart",
+      failed: activeState === "failed"
+    };
+  } catch {
+    return null;
+  }
+}
+function auditWorkers(config) {
+  if (!config.workersFile || !existsSync(config.workersFile)) return null;
+  try {
+    const data = JSON.parse(readFileSync(config.workersFile, "utf8"));
+    const orchPid = data.pid ?? null;
+    const orchAlive = orchPid ? isPidAlive(orchPid) : false;
+    const workers = [];
+    for (const [name, info] of Object.entries(data.tools ?? {})) {
+      const w = info;
+      const wPid = w.pid ?? null;
+      const wAlive = wPid ? isPidAlive(wPid) : false;
+      workers.push({
+        name,
+        pid: wPid,
+        declaredStatus: w.status ?? "unknown",
+        alive: wAlive,
+        stale: w.status === "running" && !wAlive
+      });
+    }
+    return {
+      orchestratorPid: orchPid,
+      orchestratorAlive: orchAlive,
+      startedAt: data.started_at ?? "",
+      workers
+    };
+  } catch {
+    return null;
+  }
+}
+function readCmdline(pid) {
+  try {
+    return readFileSync(`/proc/${pid}/cmdline`, "utf8").replace(/\0/g, " ").trim();
+  } catch {
+    return "";
+  }
+}
+function getOsProcesses(processName) {
+  try {
+    const raw = execSync(
+      `ps -eo pid,pcpu,pmem,etime,lstart,args --no-headers`,
+      { encoding: "utf8", timeout: 5e3 }
+    );
+    const results = [];
+    for (const line of raw.split("\n")) {
+      if (!line.includes(processName)) continue;
+      if (line.includes("process-audit") || line.includes(" grep ")) continue;
+      const trimmed = line.trim();
+      const parts = trimmed.split(/\s+/);
+      const pid = parseInt(parts[0] ?? "0", 10);
+      if (isNaN(pid) || pid <= 0) continue;
+      const cpu = parts[1] ?? "0";
+      const mem = parts[2] ?? "0";
+      const elapsed = parts[3] ?? "";
+      const started = parts.slice(4, 9).join(" ");
+      const command = parts.slice(9).join(" ");
+      const cmdline = readCmdline(pid);
+      results.push({ pid, cpu, mem, elapsed, started, command, cmdline });
+    }
+    return results;
+  } catch {
+    return [];
+  }
+}
+function discoverProcessConfig(dirs) {
+  let pidFile;
+  let workersFile;
+  let processName = "";
+  for (const dir of dirs) {
+    if (!existsSync(dir)) continue;
+    let entries;
+    try {
+      entries = readdirSync(dir);
+    } catch {
+      continue;
+    }
+    for (const f of entries) {
+      const fp = join(dir, f);
+      try {
+        if (!statSync(fp).isFile()) continue;
+      } catch {
+        continue;
+      }
+      if (f.endsWith(".pid") && !pidFile) {
+        pidFile = fp;
+        if (!processName) {
+          processName = basename(f, ".pid");
+        }
+      }
+      if ((f === "workers.json" || f.endsWith("-workers.json")) && !workersFile) {
+        workersFile = fp;
+        if (!processName && f !== "workers.json") {
+          processName = basename(f, "-workers.json");
+        }
+      }
+    }
+  }
+  if (!processName && !pidFile && !workersFile) return null;
+  if (!processName) processName = "agent";
+  return { processName, pidFile, workersFile };
+}
+function auditProcesses(config) {
+  const pidFile = auditPidFile(config);
+  const systemd = auditSystemd(config);
+  const workers = auditWorkers(config);
+  const osProcesses = getOsProcesses(config.processName);
+  const knownPids = /* @__PURE__ */ new Set();
+  if (pidFile?.pid && !pidFile.stale) knownPids.add(pidFile.pid);
+  if (workers) {
+    if (workers.orchestratorPid) knownPids.add(workers.orchestratorPid);
+    for (const w of workers.workers) {
+      if (w.pid) knownPids.add(w.pid);
+    }
+  }
+  if (systemd?.mainPid) knownPids.add(systemd.mainPid);
+  const selfPid = process.pid;
+  const selfPpid = process.ppid;
+  const orphans = osProcesses.filter(
+    (p) => !knownPids.has(p.pid) && p.pid !== selfPid && p.pid !== selfPpid
+  );
+  const problems = [];
+  if (pidFile?.stale) problems.push(`Stale PID file: ${pidFile.reason}`);
+  if (systemd?.crashLooping) problems.push("Systemd unit is crash-looping (auto-restart)");
+  if (systemd?.failed) problems.push("Systemd unit has failed");
+  if (systemd && systemd.restarts > 10) problems.push(`High systemd restart count: ${systemd.restarts}`);
+  if (pidFile?.pid && systemd?.mainPid && pidFile.pid !== systemd.mainPid) {
+    problems.push(`PID mismatch: file says ${pidFile.pid}, systemd says ${systemd.mainPid}`);
+  }
+  if (workers) {
+    for (const w of workers.workers) {
+      if (w.stale) problems.push(`Worker "${w.name}" (pid ${w.pid}) declares running but is dead`);
+    }
+  }
+  if (orphans.length > 0) problems.push(`${orphans.length} orphan process(es) not tracked by PID file or workers registry`);
+  return { pidFile, systemd, workers, osProcesses, orphans, problems };
+}
+function formatAuditReport(result) {
+  const lines = [];
+  lines.push("");
+  lines.push("\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557");
+  lines.push("\u2551            \u{1F50D}  P R O C E S S   A U D I T                      \u2551");
+  lines.push("\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D");
+  if (result.pidFile) {
+    const pf = result.pidFile;
+    const icon = pf.pid && pf.alive && pf.matchesProcess ? "\u2705" : pf.stale ? "\u26A0\uFE0F " : "\u2139\uFE0F ";
+    lines.push(`
+  PID File: ${pf.path}`);
+    lines.push(`  ${icon} ${pf.reason}`);
+  }
+  if (result.systemd) {
+    const sd = result.systemd;
+    const icon = sd.activeState === "active" ? "\u{1F7E2}" : sd.crashLooping ? "\u{1F7E1}" : sd.failed ? "\u{1F534}" : "\u26AA";
+    lines.push(`
+  Systemd: ${sd.unit}`);
+    lines.push(`  ${icon} State: ${sd.activeState} (${sd.subState})  Result: ${sd.result}`);
+    lines.push(`     Main PID: ${sd.mainPid || "none"}  Restarts: ${sd.restarts}`);
+  }
+  if (result.workers) {
+    const w = result.workers;
+    lines.push(`
+  Workers (orchestrator pid ${w.orchestratorPid ?? "unknown"} ${w.orchestratorAlive ? "\u2705" : "\u274C"})`);
+    for (const worker of w.workers) {
+      const icon = worker.declaredStatus === "running" && worker.alive ? "\u{1F7E2}" : worker.stale ? "\u{1F534} STALE" : "\u26AA";
+      lines.push(`  ${icon}  ${worker.name.padEnd(14)} pid=${String(worker.pid ?? "-").padEnd(8)} status=${worker.declaredStatus}`);
+    }
+  }
+  if (result.osProcesses.length > 0) {
+    lines.push(`
+  OS Processes (${result.osProcesses.length} total)`);
+    for (const p of result.osProcesses) {
+      lines.push(`    PID ${String(p.pid).padEnd(8)} CPU=${p.cpu.padEnd(6)} MEM=${p.mem.padEnd(6)} Up=${p.elapsed.padEnd(10)} ${p.command.substring(0, 50)}`);
+    }
+  }
+  if (result.orphans.length > 0) {
+    lines.push(`
+  \u26A0\uFE0F  ${result.orphans.length} ORPHAN PROCESS(ES):`);
+    for (const p of result.orphans) {
+      lines.push(`     PID ${String(p.pid).padEnd(8)} CPU=${p.cpu.padEnd(6)} MEM=${p.mem.padEnd(6)} Up=${p.elapsed}`);
+      lines.push(`       Started: ${p.started}`);
+      lines.push(`       Command: ${p.cmdline || p.command}`);
+    }
+  }
+  lines.push("");
+  if (result.problems.length === 0) {
+    lines.push("  \u2705 All checks passed \u2014 no process issues detected.");
+  } else {
+    lines.push(`  \u26A0\uFE0F  ${result.problems.length} issue(s):`);
+    for (const p of result.problems) {
+      lines.push(`     \u2022 ${p}`);
+    }
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+
 // src/live.ts
-import { existsSync, readdirSync, readFileSync, statSync, watch } from "fs";
-import { basename, join, resolve } from "path";
+import { existsSync as existsSync2, readdirSync as readdirSync2, readFileSync as readFileSync2, statSync as statSync2, watch } from "fs";
+import { basename as basename2, join as join2, resolve } from "path";
 var C = {
   reset: "\x1B[0m",
   bold: "\x1B[1m",
@@ -283,7 +563,7 @@ function scanFiles(dirs, recursive) {
   const seen = /* @__PURE__ */ new Set();
   function scanDir(d, topLevel) {
     try {
-      const dirStat = statSync(d);
+      const dirStat = statSync2(d);
       const dirMtime = dirStat.mtime.getTime();
       const cachedMtime = dirMtimeCache.get(d);
       if (cachedMtime === dirMtime) {
@@ -299,13 +579,13 @@ function scanFiles(dirs, recursive) {
         }
       }
       const dirResults = [];
-      for (const f of readdirSync(d)) {
+      for (const f of readdirSync2(d)) {
         if (f.startsWith(".")) continue;
-        const fp = join(d, f);
+        const fp = join2(d, f);
         if (seen.has(fp)) continue;
         let stat;
         try {
-          stat = statSync(fp);
+          stat = statSync2(fp);
         } catch {
           continue;
         }
@@ -337,13 +617,13 @@ function scanFiles(dirs, recursive) {
 }
 function safeReadJson(fp) {
   try {
-    return JSON.parse(readFileSync(fp, "utf8"));
+    return JSON.parse(readFileSync2(fp, "utf8"));
   } catch {
     return null;
   }
 }
 function nameFromFile(filename) {
-  return basename(filename).replace(/\.(json|jsonl)$/, "").replace(/-state$/, "");
+  return basename2(filename).replace(/\.(json|jsonl)$/, "").replace(/-state$/, "");
 }
 function normalizeStatus(val) {
   if (typeof val !== "string") return "unknown";
@@ -521,7 +801,7 @@ function processJsonFile(file) {
 }
 function processJsonlFile(file) {
   try {
-    const content = readFileSync(file.path, "utf8").trim();
+    const content = readFileSync2(file.path, "utf8").trim();
     if (!content) return [];
     const lines = content.split("\n");
     const lineCount = lines.length;
@@ -673,6 +953,9 @@ var prevFileCount = 0;
 var newExecCount = 0;
 var sessionStart = Date.now();
 var firstRender = true;
+var cachedAuditConfig = null;
+var cachedAuditResult = null;
+var lastAuditTime = 0;
 var fileCache = /* @__PURE__ */ new Map();
 function getRecordsCached(f) {
   const cached = fileCache.get(f.path);
@@ -792,6 +1075,24 @@ function render(config) {
     const level = Math.round(v / maxBucket * 8);
     return (failBuckets[i] > 0 ? C.red : C.green) + sparkChars[level] + C.reset;
   }).join("");
+  let auditResult = null;
+  if (now - lastAuditTime > 1e4) {
+    if (!cachedAuditConfig) {
+      cachedAuditConfig = discoverProcessConfig(config.dirs);
+    }
+    if (cachedAuditConfig) {
+      try {
+        auditResult = auditProcesses(cachedAuditConfig);
+        cachedAuditResult = auditResult;
+        lastAuditTime = now;
+      } catch (err) {
+        process.stderr.write(`[agentflow] process audit error: ${err instanceof Error ? err.message : err}
+`);
+      }
+    }
+  } else {
+    auditResult = cachedAuditResult;
+  }
   const distributedTraces = [];
   if (allTraces.length > 1) {
     const traceGroups = groupByTraceId(allTraces);
@@ -872,6 +1173,50 @@ function render(config) {
   );
   writeLine(L, "");
   writeLine(L, `  ${C.bold}Activity (1h)${C.reset}  ${spark}  ${C.dim}\u2190 now${C.reset}`);
+  if (auditResult) {
+    const ar = auditResult;
+    const healthy = ar.problems.length === 0;
+    const healthIcon = healthy ? `${C.green}\u25CF${C.reset}` : `${C.red}\u25CF${C.reset}`;
+    const healthLabel = healthy ? `${C.green}healthy${C.reset}` : `${C.red}${ar.problems.length} issue(s)${C.reset}`;
+    const workerParts = [];
+    if (ar.workers) {
+      for (const w of ar.workers.workers) {
+        const wIcon = w.declaredStatus === "running" && w.alive ? `${C.green}\u25CF${C.reset}` : w.stale ? `${C.red}\u25CF${C.reset}` : `${C.dim}\u25CB${C.reset}`;
+        workerParts.push(`${wIcon} ${w.name}`);
+      }
+    }
+    let sysdLabel = "";
+    if (ar.systemd) {
+      const si = ar.systemd.activeState === "active" ? `${C.green}\u25CF${C.reset}` : ar.systemd.crashLooping ? `${C.yellow}\u25CF${C.reset}` : ar.systemd.failed ? `${C.red}\u25CF${C.reset}` : `${C.dim}\u25CB${C.reset}`;
+      sysdLabel = `  ${C.bold}Systemd${C.reset} ${si} ${ar.systemd.activeState}`;
+      if (ar.systemd.restarts > 0) sysdLabel += ` ${C.dim}(${ar.systemd.restarts} restarts)${C.reset}`;
+    }
+    let pidLabel = "";
+    if (ar.pidFile?.pid) {
+      const pi = ar.pidFile.alive && ar.pidFile.matchesProcess ? `${C.green}\u25CF${C.reset}` : `${C.red}\u25CF${C.reset}`;
+      pidLabel = `  ${C.bold}PID${C.reset} ${pi} ${ar.pidFile.pid}`;
+    }
+    writeLine(L, "");
+    writeLine(L, `  ${C.bold}${C.under}Process Health${C.reset}`);
+    writeLine(L, `  ${healthIcon} ${healthLabel}${pidLabel}${sysdLabel}    ${C.bold}Procs${C.reset} ${C.dim}${ar.osProcesses.length}${C.reset}    ${ar.orphans.length > 0 ? `${C.red}Orphans ${ar.orphans.length}${C.reset}` : `${C.dim}Orphans 0${C.reset}`}`);
+    if (workerParts.length > 0) {
+      writeLine(L, `  ${C.dim}Workers${C.reset}  ${workerParts.join("  ")}`);
+    }
+    if (!healthy) {
+      for (const p of ar.problems.slice(0, 3)) {
+        writeLine(L, `  ${C.red}\u2022${C.reset} ${C.dim}${p}${C.reset}`);
+      }
+    }
+    if (ar.orphans.length > 0) {
+      for (const o of ar.orphans.slice(0, 5)) {
+        const cmd = (o.cmdline || o.command).substring(0, detailWidth);
+        writeLine(L, `    ${C.red}?${C.reset} ${C.dim}pid=${o.pid} cpu=${o.cpu} mem=${o.mem} up=${o.elapsed}${C.reset}  ${C.dim}${cmd}${C.reset}`);
+      }
+      if (ar.orphans.length > 5) {
+        writeLine(L, `    ${C.dim}... +${ar.orphans.length - 5} more orphans${C.reset}`);
+      }
+    }
+  }
   writeLine(L, "");
   writeLine(
     L,
@@ -990,13 +1335,13 @@ function getDistDepth(dt, spanId, visited) {
 }
 function startLive(argv) {
   const config = parseArgs(argv);
-  const valid = config.dirs.filter((d) => existsSync(d));
+  const valid = config.dirs.filter((d) => existsSync2(d));
   if (valid.length === 0) {
     console.error(`No valid directories found: ${config.dirs.join(", ")}`);
     console.error("Specify directories containing JSON/JSONL files: agentflow live <dir> [dir...]");
     process.exit(1);
   }
-  const invalid = config.dirs.filter((d) => !existsSync(d));
+  const invalid = config.dirs.filter((d) => !existsSync2(d));
   if (invalid.length > 0) {
     console.warn(`Skipping non-existent: ${invalid.join(", ")}`);
   }
@@ -1019,262 +1364,6 @@ function startLive(argv) {
   });
 }
 
-// src/process-audit.ts
-import { execSync } from "child_process";
-import { existsSync as existsSync2, readdirSync as readdirSync2, readFileSync as readFileSync2, statSync as statSync2 } from "fs";
-import { basename as basename2, join as join2 } from "path";
-function isPidAlive(pid) {
-  try {
-    process.kill(pid, 0);
-    return true;
-  } catch {
-    return false;
-  }
-}
-function pidMatchesName(pid, name) {
-  try {
-    const cmdline = readFileSync2(`/proc/${pid}/cmdline`, "utf8");
-    return cmdline.includes(name);
-  } catch {
-    return false;
-  }
-}
-function readPidFile(path) {
-  try {
-    const pid = parseInt(readFileSync2(path, "utf8").trim(), 10);
-    return isNaN(pid) ? null : pid;
-  } catch {
-    return null;
-  }
-}
-function auditPidFile(config) {
-  if (!config.pidFile) return null;
-  const pid = readPidFile(config.pidFile);
-  if (pid === null) {
-    return {
-      path: config.pidFile,
-      pid: null,
-      alive: false,
-      matchesProcess: false,
-      stale: !existsSync2(config.pidFile),
-      reason: existsSync2(config.pidFile) ? "PID file exists but content is invalid" : "No PID file found"
-    };
-  }
-  const alive = isPidAlive(pid);
-  const matchesProcess = alive ? pidMatchesName(pid, config.processName) : false;
-  const stale = !alive || alive && !matchesProcess;
-  let reason;
-  if (alive && matchesProcess) {
-    reason = `PID ${pid} alive and matches ${config.processName}`;
-  } else if (alive && !matchesProcess) {
-    reason = `PID ${pid} alive but is NOT ${config.processName} (PID reused by another process)`;
-  } else {
-    reason = `PID ${pid} no longer exists`;
-  }
-  return { path: config.pidFile, pid, alive, matchesProcess, stale, reason };
-}
-function auditSystemd(config) {
-  if (config.systemdUnit === null || config.systemdUnit === void 0) return null;
-  const unit = config.systemdUnit;
-  try {
-    const raw = execSync(
-      `systemctl --user show ${unit} --property=ActiveState,SubState,MainPID,NRestarts,Result --no-pager 2>/dev/null`,
-      { encoding: "utf8", timeout: 5e3 }
-    );
-    const props = {};
-    for (const line of raw.trim().split("\n")) {
-      const [k, ...v] = line.split("=");
-      if (k) props[k.trim()] = v.join("=").trim();
-    }
-    const activeState = props["ActiveState"] ?? "unknown";
-    const subState = props["SubState"] ?? "unknown";
-    const mainPid = parseInt(props["MainPID"] ?? "0", 10);
-    const restarts = parseInt(props["NRestarts"] ?? "0", 10);
-    const result = props["Result"] ?? "unknown";
-    return {
-      unit,
-      activeState,
-      subState,
-      mainPid,
-      restarts,
-      result,
-      crashLooping: activeState === "activating" && subState === "auto-restart",
-      failed: activeState === "failed"
-    };
-  } catch {
-    return null;
-  }
-}
-function auditWorkers(config) {
-  if (!config.workersFile || !existsSync2(config.workersFile)) return null;
-  try {
-    const data = JSON.parse(readFileSync2(config.workersFile, "utf8"));
-    const orchPid = data.pid ?? null;
-    const orchAlive = orchPid ? isPidAlive(orchPid) : false;
-    const workers = [];
-    for (const [name, info] of Object.entries(data.tools ?? {})) {
-      const w = info;
-      const wPid = w.pid ?? null;
-      const wAlive = wPid ? isPidAlive(wPid) : false;
-      workers.push({
-        name,
-        pid: wPid,
-        declaredStatus: w.status ?? "unknown",
-        alive: wAlive,
-        stale: w.status === "running" && !wAlive
-      });
-    }
-    return {
-      orchestratorPid: orchPid,
-      orchestratorAlive: orchAlive,
-      startedAt: data.started_at ?? "",
-      workers
-    };
-  } catch {
-    return null;
-  }
-}
-function getOsProcesses(processName) {
-  try {
-    const raw = execSync(`ps aux`, { encoding: "utf8", timeout: 5e3 });
-    return raw.split("\n").filter((line) => line.includes(processName) && !line.includes("process-audit") && !line.includes("grep")).map((line) => {
-      const parts = line.trim().split(/\s+/);
-      return {
-        pid: parseInt(parts[1] ?? "0", 10),
-        cpu: parts[2] ?? "0",
-        mem: parts[3] ?? "0",
-        command: parts.slice(10).join(" ")
-      };
-    }).filter((p) => !isNaN(p.pid) && p.pid > 0);
-  } catch {
-    return [];
-  }
-}
-function discoverProcessConfig(dirs) {
-  let pidFile;
-  let workersFile;
-  let processName = "";
-  for (const dir of dirs) {
-    if (!existsSync2(dir)) continue;
-    let entries;
-    try {
-      entries = readdirSync2(dir);
-    } catch {
-      continue;
-    }
-    for (const f of entries) {
-      const fp = join2(dir, f);
-      try {
-        if (!statSync2(fp).isFile()) continue;
-      } catch {
-        continue;
-      }
-      if (f.endsWith(".pid") && !pidFile) {
-        pidFile = fp;
-        if (!processName) {
-          processName = basename2(f, ".pid");
-        }
-      }
-      if ((f === "workers.json" || f.endsWith("-workers.json")) && !workersFile) {
-        workersFile = fp;
-        if (!processName && f !== "workers.json") {
-          processName = basename2(f, "-workers.json");
-        }
-      }
-    }
-  }
-  if (!processName && !pidFile && !workersFile) return null;
-  if (!processName) processName = "agent";
-  return { processName, pidFile, workersFile };
-}
-function auditProcesses(config) {
-  const pidFile = auditPidFile(config);
-  const systemd = auditSystemd(config);
-  const workers = auditWorkers(config);
-  const osProcesses = getOsProcesses(config.processName);
-  const knownPids = /* @__PURE__ */ new Set();
-  if (pidFile?.pid && !pidFile.stale) knownPids.add(pidFile.pid);
-  if (workers) {
-    if (workers.orchestratorPid) knownPids.add(workers.orchestratorPid);
-    for (const w of workers.workers) {
-      if (w.pid) knownPids.add(w.pid);
-    }
-  }
-  if (systemd?.mainPid) knownPids.add(systemd.mainPid);
-  const orphans = osProcesses.filter((p) => !knownPids.has(p.pid));
-  const problems = [];
-  if (pidFile?.stale) problems.push(`Stale PID file: ${pidFile.reason}`);
-  if (systemd?.crashLooping) problems.push("Systemd unit is crash-looping (auto-restart)");
-  if (systemd?.failed) problems.push("Systemd unit has failed");
-  if (systemd && systemd.restarts > 10) problems.push(`High systemd restart count: ${systemd.restarts}`);
-  if (pidFile?.pid && systemd?.mainPid && pidFile.pid !== systemd.mainPid) {
-    problems.push(`PID mismatch: file says ${pidFile.pid}, systemd says ${systemd.mainPid}`);
-  }
-  if (workers) {
-    for (const w of workers.workers) {
-      if (w.stale) problems.push(`Worker "${w.name}" (pid ${w.pid}) declares running but is dead`);
-    }
-  }
-  if (orphans.length > 0) problems.push(`${orphans.length} orphan process(es) not tracked by PID file or workers registry`);
-  return { pidFile, systemd, workers, osProcesses, orphans, problems };
-}
-function formatAuditReport(result) {
-  const lines = [];
-  lines.push("");
-  lines.push("\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557");
-  lines.push("\u2551            \u{1F50D}  P R O C E S S   A U D I T                      \u2551");
-  lines.push("\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D");
-  if (result.pidFile) {
-    const pf = result.pidFile;
-    const icon = pf.pid && pf.alive && pf.matchesProcess ? "\u2705" : pf.stale ? "\u26A0\uFE0F " : "\u2139\uFE0F ";
-    lines.push(`
-  PID File: ${pf.path}`);
-    lines.push(`  ${icon} ${pf.reason}`);
-  }
-  if (result.systemd) {
-    const sd = result.systemd;
-    const icon = sd.activeState === "active" ? "\u{1F7E2}" : sd.crashLooping ? "\u{1F7E1}" : sd.failed ? "\u{1F534}" : "\u26AA";
-    lines.push(`
-  Systemd: ${sd.unit}`);
-    lines.push(`  ${icon} State: ${sd.activeState} (${sd.subState})  Result: ${sd.result}`);
-    lines.push(`     Main PID: ${sd.mainPid || "none"}  Restarts: ${sd.restarts}`);
-  }
-  if (result.workers) {
-    const w = result.workers;
-    lines.push(`
-  Workers (orchestrator pid ${w.orchestratorPid ?? "unknown"} ${w.orchestratorAlive ? "\u2705" : "\u274C"})`);
-    for (const worker of w.workers) {
-      const icon = worker.declaredStatus === "running" && worker.alive ? "\u{1F7E2}" : worker.stale ? "\u{1F534} STALE" : "\u26AA";
-      lines.push(`  ${icon}  ${worker.name.padEnd(14)} pid=${String(worker.pid ?? "-").padEnd(8)} status=${worker.declaredStatus}`);
-    }
-  }
-  if (result.osProcesses.length > 0) {
-    lines.push(`
-  OS Processes (${result.osProcesses.length} total)`);
-    for (const p of result.osProcesses) {
-      lines.push(`    PID ${String(p.pid).padEnd(8)} CPU=${p.cpu.padEnd(6)} MEM=${p.mem.padEnd(6)} ${p.command.substring(0, 55)}`);
-    }
-  }
-  if (result.orphans.length > 0) {
-    lines.push(`
-  \u26A0\uFE0F  ${result.orphans.length} ORPHAN PROCESS(ES):`);
-    for (const p of result.orphans) {
-      lines.push(`     PID ${p.pid} \u2014 not tracked by PID file or workers registry`);
-    }
-  }
-  lines.push("");
-  if (result.problems.length === 0) {
-    lines.push("  \u2705 All checks passed \u2014 no process issues detected.");
-  } else {
-    lines.push(`  \u26A0\uFE0F  ${result.problems.length} issue(s):`);
-    for (const p of result.problems) {
-      lines.push(`     \u2022 ${p}`);
-    }
-  }
-  lines.push("");
-  return lines.join("\n");
-}
-
 // src/graph-builder.ts
 import { randomUUID } from "crypto";
 function deepFreeze(obj) {
@@ -2459,10 +2548,10 @@ export {
   groupByTraceId,
   stitchTrace,
   getTraceTree,
-  startLive,
   discoverProcessConfig,
   auditProcesses,
   formatAuditReport,
+  startLive,
   createGraphBuilder,
   runTraced,
   createTraceStore,