agentflow-core 0.5.2 → 0.6.0

package/dist/cli.js

@@ -1,16 +1,19 @@
 #!/usr/bin/env node
 import {
+  auditProcesses,
   createTraceStore,
+  discoverProcessConfig,
+  formatAuditReport,
   runTraced,
   startLive,
   startWatch,
   toAsciiTree,
   toTimeline
-} from "./chunk-YTMQBL3T.js";
+} from "./chunk-VF4FSBXR.js";
 import "./chunk-DY7YHFIB.js";
 
 // src/cli.ts
-import { basename } from "path";
+import { basename, resolve as resolve2 } from "path";
 
 // src/trace-cli.ts
 import { resolve } from "path";
@@ -216,6 +219,7 @@ Commands:
   live   [dir...] [options]      Real-time terminal monitor (auto-detects any JSON/JSONL)
   watch  [dir...] [options]      Headless alert system \u2014 detects failures, sends notifications
   trace  <command> [options]     Inspect saved execution traces (list, show, timeline, stuck, loops)
+  audit  [options]               Audit OS processes \u2014 detect stale PIDs, orphans, systemd issues
 
 Run \`agentflow <command> --help\` for command-specific options.
 
@@ -367,9 +371,102 @@ async function runCommand(argv) {
     process.exit(1);
   }
 }
+function parseAuditArgs(argv) {
+  let processName = "";
+  let pidFile;
+  let workersFile;
+  let systemdUnit;
+  const discoverDirs = [];
+  const args = argv.slice(0);
+  if (args[0] === "audit") args.shift();
+  let i = 0;
+  while (i < args.length) {
+    const arg = args[i];
+    if (arg === "--help" || arg === "-h") {
+      printAuditUsage();
+      process.exit(0);
+    } else if (arg === "--process" || arg === "-p") {
+      i++;
+      processName = args[i] ?? "";
+      i++;
+    } else if (arg === "--pid-file") {
+      i++;
+      pidFile = args[i];
+      i++;
+    } else if (arg === "--workers-file") {
+      i++;
+      workersFile = args[i];
+      i++;
+    } else if (arg === "--systemd") {
+      i++;
+      systemdUnit = args[i];
+      i++;
+    } else if (arg === "--no-systemd") {
+      systemdUnit = null;
+      i++;
+    } else if (!arg.startsWith("-")) {
+      discoverDirs.push(resolve2(arg));
+      i++;
+    } else {
+      i++;
+    }
+  }
+  if (!processName && !pidFile && !workersFile && discoverDirs.length > 0) {
+    const discovered = discoverProcessConfig(discoverDirs);
+    if (discovered) {
+      console.log(`Auto-discovered: process="${discovered.processName}"${discovered.pidFile ? ` pid-file=${discovered.pidFile}` : ""}${discovered.workersFile ? ` workers=${discovered.workersFile}` : ""}`);
+      return { ...discovered, systemdUnit };
+    }
+  }
+  if (!processName) {
+    console.error("Error: --process <name> is required, or provide directories for auto-discovery.");
+    console.error("Examples:");
+    console.error("  agentflow audit --process alfred --pid-file ./data/alfred.pid");
+    console.error("  agentflow audit ./data    # auto-discovers *.pid and workers.json");
+    process.exit(1);
+  }
+  return { processName, pidFile, workersFile, systemdUnit };
+}
+function printAuditUsage() {
+  console.log(
+    `
+AgentFlow Audit \u2014 OS-level process health check for agent systems.
+
+Detects stale PID files, orphan processes, systemd crash loops, and
+mismatches between declared state and actual OS process state.
+
+Usage:
+  agentflow audit [dir...] [options]
+  agentflow audit --process <name> [options]
+
+Arguments:
+  dir                         Directories to scan for auto-discovery of *.pid and workers.json
+
+Options:
+  -p, --process <name>        Process name to search for (e.g. "alfred", "myagent")
+  --pid-file <path>           Path to PID file
+  --workers-file <path>       Path to workers.json or process registry
+  --systemd <unit>            Systemd user unit name (e.g. "alfred.service")
+  --no-systemd                Skip systemd checks
+  -h, --help                  Show this help message
+
+Examples:
+  agentflow audit ./data                          # auto-discover from data directory
+  agentflow audit --process alfred --systemd alfred.service
+  agentflow audit --process myagent --pid-file /var/run/myagent.pid --workers-file ./workers.json
+  agentflow audit --process crewai --no-systemd
+`.trim()
+  );
+}
+function runAudit(argv) {
+  const config = parseAuditArgs(argv);
+  const result = auditProcesses(config);
+  console.log(formatAuditReport(result));
+  process.exit(result.problems.length > 0 ? 1 : 0);
+}
 async function main() {
   const argv = process.argv.slice(2);
-  const knownCommands = ["run", "live", "watch", "trace"];
+  const knownCommands = ["run", "live", "watch", "trace", "audit"];
   if (argv.length === 0 || !knownCommands.includes(argv[0]) && (argv.includes("--help") || argv.includes("-h"))) {
     printHelp();
     process.exit(0);
@@ -388,6 +485,9 @@ async function main() {
     case "trace":
       await handleTrace(argv);
       break;
+    case "audit":
+      runAudit(argv);
+      break;
     default:
       if (!subcommand?.startsWith("-")) {
         startLive(["live", ...argv]);