agentflow-dashboard 0.7.1 → 0.8.1

package/dist/cli.cjs

@@ -37,11 +37,86 @@ var os = __toESM(require("os"), 1);
 var path3 = __toESM(require("path"), 1);
 
 // src/server.ts
+var import_node_child_process = require("child_process");
 var fs2 = __toESM(require("fs"), 1);
 var import_node_http = require("http");
 var path2 = __toESM(require("path"), 1);
 var import_node_url = require("url");
+
+// src/config.ts
+var import_node_fs = require("fs");
+var import_node_os = require("os");
+var import_node_path = require("path");
+var EMPTY_CONFIG = {};
+function expandTilde(p) {
+  if (p.startsWith("~/") || p === "~") {
+    return (0, import_node_path.join)((0, import_node_os.homedir)(), p.slice(1));
+  }
+  return p;
+}
+function loadConfig(explicitPath) {
+  const candidates = [];
+  if (explicitPath) {
+    candidates.push((0, import_node_path.resolve)(explicitPath));
+  }
+  if (process.env.AGENTFLOW_CONFIG) {
+    candidates.push((0, import_node_path.resolve)(process.env.AGENTFLOW_CONFIG));
+  }
+  candidates.push((0, import_node_path.resolve)("agentflow.config.json"));
+  candidates.push((0, import_node_path.join)((0, import_node_os.homedir)(), ".config", "agentflow", "config.json"));
+  for (const candidate of candidates) {
+    if (!(0, import_node_fs.existsSync)(candidate)) continue;
+    try {
+      const raw = (0, import_node_fs.readFileSync)(candidate, "utf-8");
+      const parsed = JSON.parse(raw);
+      const cleaned = stripCommentKeys(parsed);
+      console.log(`Loaded config: ${candidate}`);
+      return { config: cleaned, configPath: candidate };
+    } catch (err) {
+      console.warn(`Warning: Failed to load config from ${candidate}: ${err.message}`);
+      console.warn("Continuing with empty defaults.");
+      return { config: EMPTY_CONFIG, configPath: null };
+    }
+  }
+  return { config: EMPTY_CONFIG, configPath: null };
+}
+function stripCommentKeys(obj) {
+  if (Array.isArray(obj)) return obj.map(stripCommentKeys);
+  if (obj && typeof obj === "object") {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+      if (key.startsWith("//")) continue;
+      result[key] = stripCommentKeys(value);
+    }
+    return result;
+  }
+  return obj;
+}
+function getAliases(config) {
+  return config.aliases ?? {};
+}
+function getSkipFiles(config) {
+  return config.skipFiles ?? [];
+}
+function getSkipDirectories(config) {
+  return config.skipDirectories ?? [];
+}
+function getDiscoveryPaths(config) {
+  return (config.discoveryPaths ?? []).map(expandTilde);
+}
+function getSystemdServices(config) {
+  return config.systemdServices ?? [];
+}
+function getAgentDetection(config) {
+  return config.agentDetection ?? {};
+}
+function getProcessPreference(config) {
+  return config.processPreference ?? null;
+}
+
+// src/server.ts
 var import_agentflow_core3 = require("agentflow-core");
+var import_chokidar2 = __toESM(require("chokidar"), 1);
 var import_express = __toESM(require("express"), 1);
 var import_ws = require("ws");
 
@@ -74,17 +149,17 @@ var AgentFlowAdapter = class {
 };
 
 // src/adapters/openclaw.ts
-var import_node_fs = require("fs");
-var import_node_path = require("path");
+var import_node_fs2 = require("fs");
+var import_node_path2 = require("path");
 var jobCache = /* @__PURE__ */ new Map();
 function loadJobs(openclawDir) {
   const cached = jobCache.get(openclawDir);
   if (cached) return cached;
-  const jobsPath = (0, import_node_path.join)(openclawDir, "cron", "jobs.json");
+  const jobsPath = (0, import_node_path2.join)(openclawDir, "cron", "jobs.json");
   const map = /* @__PURE__ */ new Map();
   try {
-    if ((0, import_node_fs.existsSync)(jobsPath)) {
-      const data = JSON.parse((0, import_node_fs.readFileSync)(jobsPath, "utf-8"));
+    if ((0, import_node_fs2.existsSync)(jobsPath)) {
+      const data = JSON.parse((0, import_node_fs2.readFileSync)(jobsPath, "utf-8"));
       const jobs = Array.isArray(data) ? data : data.jobs ?? [];
       for (const job of jobs) {
         if (job.id) map.set(job.id, job);
@@ -96,19 +171,19 @@ function loadJobs(openclawDir) {
   return map;
 }
 function findOpenClawRoot(filePath) {
-  let dir = (0, import_node_path.dirname)(filePath);
+  let dir = (0, import_node_path2.dirname)(filePath);
   for (let i = 0; i < 5; i++) {
-    if ((0, import_node_fs.existsSync)((0, import_node_path.join)(dir, "cron", "jobs.json")) || (0, import_node_path.basename)(dir) === ".openclaw") {
+    if ((0, import_node_fs2.existsSync)((0, import_node_path2.join)(dir, "cron", "jobs.json")) || (0, import_node_path2.basename)(dir) === ".openclaw") {
       return dir;
     }
-    dir = (0, import_node_path.dirname)(dir);
+    dir = (0, import_node_path2.dirname)(dir);
   }
   return null;
 }
 var OpenClawAdapter = class {
   name = "openclaw";
   detect(dirPath) {
-    return (0, import_node_fs.existsSync)((0, import_node_path.join)(dirPath, "cron", "jobs.json")) || dirPath.includes(".openclaw") || (0, import_node_fs.existsSync)((0, import_node_path.join)(dirPath, "cron", "runs"));
+    return (0, import_node_fs2.existsSync)((0, import_node_path2.join)(dirPath, "cron", "jobs.json")) || dirPath.includes(".openclaw") || (0, import_node_fs2.existsSync)((0, import_node_path2.join)(dirPath, "cron", "runs"));
   }
   canHandle(filePath) {
     if (!filePath.endsWith(".jsonl")) return false;
@@ -117,7 +192,7 @@ var OpenClawAdapter = class {
   parse(filePath) {
     const traces = [];
     try {
-      const content = (0, import_node_fs.readFileSync)(filePath, "utf-8");
+      const content = (0, import_node_fs2.readFileSync)(filePath, "utf-8");
       const root = findOpenClawRoot(filePath);
       const jobs = root ? loadJobs(root) : /* @__PURE__ */ new Map();
       for (const line of content.split("\n")) {
@@ -129,7 +204,7 @@ var OpenClawAdapter = class {
           continue;
         }
         if (entry.action !== "finished") continue;
-        const jobId = entry.jobId ?? (0, import_node_path.basename)(filePath, ".jsonl");
+        const jobId = entry.jobId ?? (0, import_node_path2.basename)(filePath, ".jsonl");
         const job = jobs.get(jobId);
         const jobName = (job == null ? void 0 : job.name) ?? jobId;
         const startTime = entry.runAtMs ?? entry.ts;
@@ -181,8 +256,8 @@ var OpenClawAdapter = class {
 };
 
 // src/adapters/otel.ts
-var import_node_fs2 = require("fs");
-var import_node_path2 = require("path");
+var import_node_fs3 = require("fs");
+var import_node_path3 = require("path");
 var SPAN_TYPE_MAP = {
   "gen_ai.chat": "llm",
   "gen_ai.completion": "llm",
@@ -289,8 +364,8 @@ var OTelAdapter = class {
   name = "otel";
   detect(dirPath) {
     try {
-      if ((0, import_node_fs2.existsSync)((0, import_node_path2.join)(dirPath, "otel-traces"))) return true;
-      const files = (0, import_node_fs2.readdirSync)(dirPath);
+      if ((0, import_node_fs3.existsSync)((0, import_node_path3.join)(dirPath, "otel-traces"))) return true;
+      const files = (0, import_node_fs3.readdirSync)(dirPath);
       return files.some((f) => f.endsWith(".otlp.json"));
     } catch {
       return false;
@@ -301,7 +376,7 @@ var OTelAdapter = class {
   }
   parse(filePath) {
     try {
-      const content = (0, import_node_fs2.readFileSync)(filePath, "utf-8");
+      const content = (0, import_node_fs3.readFileSync)(filePath, "utf-8");
       const payload = JSON.parse(content);
       const traces = parseOtlpPayload(payload);
       for (const t of traces) t.filePath = filePath;
@@ -343,9 +418,7 @@ function extractSource(agentId) {
   const colonIdx = agentId.indexOf(":");
   if (colonIdx > 0 && colonIdx < 20) {
     const prefix = agentId.slice(0, colonIdx);
-    if (["openclaw", "otel", "langchain", "crewai", "mastra"].includes(prefix)) {
-      return { source: prefix, localId: agentId.slice(colonIdx + 1) };
-    }
+    return { source: prefix, localId: agentId.slice(colonIdx + 1) };
   }
   return { source: "agentflow", localId: agentId };
 }
@@ -376,16 +449,20 @@ function deduplicateAgents(agents) {
   for (const a of tagged) {
     const suffix = extractSuffix(a.localId);
     if (!suffix) continue;
-    const group = suffixGroups.get(suffix) ?? [];
+    const key = `${a.source}:${suffix}`;
+    const group = suffixGroups.get(key) ?? [];
     group.push(a);
-    suffixGroups.set(suffix, group);
+    suffixGroups.set(key, group);
   }
   const mergedIds = /* @__PURE__ */ new Set();
   const mergedAgents = [];
-  for (const [suffix, group] of suffixGroups) {
+  for (const [_key, group] of suffixGroups) {
+    const suffix = extractSuffix(group[0].localId);
     if (group.length < 2) continue;
     const prefixes = new Set(group.map((a) => a.localId.split("-")[0]));
     if (prefixes.size < 2) continue;
+    const longPrefixes = [...prefixes].filter((p) => p !== suffix && p.length > 2);
+    if (longPrefixes.length >= 2) continue;
     const merged = {
       agentId: group[0].source === "agentflow" ? suffix : `${group[0].source}:${suffix}`,
       displayName: suffix,
@@ -433,10 +510,7 @@ function groupAgents(agents) {
   }
   const SOURCE_DISPLAY = {
     agentflow: "AgentFlow",
-    openclaw: "OpenClaw",
-    otel: "OpenTelemetry",
-    langchain: "LangChain",
-    crewai: "CrewAI"
+    otel: "OpenTelemetry"
   };
   const groups = [];
   for (const [source, sourceAgents] of sourceMap) {
@@ -782,10 +856,6 @@ function getUniversalNodeStatus(activity) {
   return "completed";
 }
 function openClawSessionIdToAgent(sessionId) {
-  if (sessionId.startsWith("janitor-")) return "vault-janitor";
-  if (sessionId.startsWith("curator-")) return "vault-curator";
-  if (sessionId.startsWith("distiller-")) return "vault-distiller";
-  if (sessionId.startsWith("main-")) return "alfred-main";
   const firstSegment = sessionId.split("-")[0];
   if (firstSegment) return firstSegment;
   return "openclaw";
@@ -798,19 +868,81 @@ var TraceWatcher = class _TraceWatcher extends import_node_events.EventEmitter {
   tracesDir;
   dataDirs;
   allWatchDirs;
+  maxAgeMs;
+  userConfig;
   constructor(tracesDirOrOptions) {
     super();
+    const defaultMaxAgeMs = 48 * 60 * 60 * 1e3;
+    const envHours = process.env.AGENTFLOW_TRACE_WINDOW_HOURS;
+    const envMaxAgeMs = envHours ? parseFloat(envHours) * 60 * 60 * 1e3 : void 0;
     if (typeof tracesDirOrOptions === "string") {
       this.tracesDir = path.resolve(tracesDirOrOptions);
       this.dataDirs = [];
+      this.maxAgeMs = envMaxAgeMs ?? defaultMaxAgeMs;
+      this.userConfig = {};
     } else {
       this.tracesDir = path.resolve(tracesDirOrOptions.tracesDir);
       this.dataDirs = (tracesDirOrOptions.dataDirs || []).map((d) => path.resolve(d));
-    }
-    this.allWatchDirs = [this.tracesDir, ...this.dataDirs];
+      this.maxAgeMs = envMaxAgeMs ?? tracesDirOrOptions.maxAgeMs ?? defaultMaxAgeMs;
+      this.userConfig = tracesDirOrOptions.userConfig ?? {};
+    }
+    this.skipFiles = /* @__PURE__ */ new Set([
+      ..._TraceWatcher.STRUCTURAL_SKIP_FILES,
+      ...getSkipFiles(this.userConfig)
+    ]);
+    this.userSkipDirs = new Set(getSkipDirectories(this.userConfig));
+    this.allWatchDirs = [...new Set([this.tracesDir, ...this.dataDirs].map((d) => path.resolve(d)))];
     this.ensureTracesDir();
     this.loadExistingFiles();
+    this.archiveOldTraces();
     this.startWatching();
+    setInterval(() => this.archiveOldTraces(), 6 * 60 * 60 * 1e3);
+  }
+  /** Move trace files older than maxAgeMs into archive/YYYY-MM/ subdirectories. */
+  archiveOldTraces() {
+    const cutoff = Date.now() - this.maxAgeMs;
+    let archived = 0;
+    for (const dir of this.allWatchDirs) {
+      if (!fs.existsSync(dir)) continue;
+      try {
+        this.archiveDirectory(dir, cutoff, 0);
+      } catch (error) {
+        console.warn(`Archival error in ${dir}:`, error.message);
+      }
+    }
+  }
+  archiveDirectory(dir, cutoff, depth) {
+    if (depth > 10) return 0;
+    if (path.basename(dir) === "archive") return 0;
+    let archived = 0;
+    try {
+      const entries = fs.readdirSync(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.name.startsWith(".") || entry.name === "archive" || this.userSkipDirs.has(entry.name)) continue;
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+          archived += this.archiveDirectory(fullPath, cutoff, depth + 1);
+          continue;
+        }
+        if (!entry.isFile() || !this.isSupportedFile(entry.name)) continue;
+        try {
+          const stats = fs.statSync(fullPath);
+          if (stats.mtimeMs >= cutoff) continue;
+          const mtime = new Date(stats.mtimeMs);
+          const yearMonth = `${mtime.getFullYear()}-${String(mtime.getMonth() + 1).padStart(2, "0")}`;
+          const archiveDir = path.join(this.tracesDir, "archive", yearMonth);
+          fs.mkdirSync(archiveDir, { recursive: true });
+          const dest = path.join(archiveDir, entry.name);
+          fs.renameSync(fullPath, dest);
+          const key = this.traceKey(fullPath);
+          this.traces.delete(key);
+          archived++;
+        } catch {
+        }
+      }
+    } catch {
+    }
+    return archived;
   }
   ensureTracesDir() {
     if (!fs.existsSync(this.tracesDir)) {
@@ -843,9 +975,17 @@ var TraceWatcher = class _TraceWatcher extends import_node_events.EventEmitter {
       const entries = fs.readdirSync(dir, { withFileTypes: true });
       for (const entry of entries) {
         if (entry.name.startsWith(".")) continue;
+        if (entry.name === "archive") continue;
+        if (this.userSkipDirs.has(entry.name)) continue;
         const fullPath = path.join(dir, entry.name);
         if (entry.isFile()) {
           if (this.isSupportedFile(entry.name)) {
+            try {
+              const mtime = fs.statSync(fullPath).mtimeMs;
+              if (Date.now() - mtime > this.maxAgeMs) continue;
+            } catch {
+              continue;
+            }
             if (this.loadFile(fullPath)) {
               fileCount++;
             }
@@ -863,8 +1003,8 @@ var TraceWatcher = class _TraceWatcher extends import_node_events.EventEmitter {
   isSupportedFile(filename) {
     return filename.endsWith(".json") || filename.endsWith(".jsonl") || filename.endsWith(".log") || filename.endsWith(".trace");
   }
-  /** File names that are config/state, not traces — skip them. */
-  static SKIP_FILES = /* @__PURE__ */ new Set([
+  /** Structural file names that are never trace data — always skipped. */
+  static STRUCTURAL_SKIP_FILES = /* @__PURE__ */ new Set([
     "workers.json",
     "package.json",
     "package-lock.json",
@@ -879,6 +1019,10 @@ var TraceWatcher = class _TraceWatcher extends import_node_events.EventEmitter {
     "update-check.json",
     "exec-approvals.json"
   ]);
+  /** Skip files = structural + user config */
+  skipFiles;
+  /** Skip directories from user config */
+  userSkipDirs;
   static SKIP_SUFFIXES = [
     "-state.json",
     "-config.json",
@@ -890,7 +1034,7 @@ var TraceWatcher = class _TraceWatcher extends import_node_events.EventEmitter {
   /** Load a file using the adapter registry, falling back to built-in parsing. */
   loadFile(filePath) {
     const filename = path.basename(filePath);
-    if (_TraceWatcher.SKIP_FILES.has(filename)) return false;
+    if (this.skipFiles.has(filename)) return false;
     if (_TraceWatcher.SKIP_SUFFIXES.some((s) => filename.endsWith(s))) return false;
     const adapter = findAdapter(filePath);
     if (adapter && adapter.name !== "agentflow") {
@@ -1067,43 +1211,26 @@ var TraceWatcher = class _TraceWatcher extends import_node_events.EventEmitter {
     }
     return traces;
   }
-  /**
-   * Normalise agent identifiers so that the same worker is never shown
-   * under two different names (e.g. "vault-curator" vs "openclaw-vault-curator").
-   *
-   * Canonical names:  alfred-main, vault-curator, vault-janitor,
-   *                   vault-distiller, vault-surveyor
-   */
-  static AGENT_ALIASES = {
-    "openclaw-main": "alfred-main",
-    "openclaw-vault-curator": "vault-curator",
-    "openclaw-vault-janitor": "vault-janitor",
-    "openclaw-vault-distiller": "vault-distiller",
-    "openclaw-vault-surveyor": "vault-surveyor",
-    "alfred-curator": "vault-curator",
-    "alfred-janitor": "vault-janitor",
-    "alfred-distiller": "vault-distiller",
-    "alfred-surveyor": "vault-surveyor",
-    curator: "vault-curator",
-    janitor: "vault-janitor",
-    distiller: "vault-distiller",
-    surveyor: "vault-surveyor"
-  };
+  /** Normalise agent identifiers using config-driven alias map. */
   normaliseAgentId(raw) {
-    return _TraceWatcher.AGENT_ALIASES[raw] ?? raw;
+    const aliases = getAliases(this.userConfig);
+    return aliases[raw] ?? raw;
   }
   detectAgentIdentifier(activity, _filename, filePath) {
     if (activity.agent_id) {
-      const agentId = activity.agent_id;
-      if (agentId === "main" && filePath.includes(".alfred/")) return this.normaliseAgentId("alfred-main");
-      return this.normaliseAgentId(agentId);
+      return this.normaliseAgentId(activity.agent_id);
     }
     const pathAgent = this.extractAgentFromPath(filePath);
-    if (filePath.includes(".alfred/") && !pathAgent.startsWith("alfred-")) {
+    const detection = getAgentDetection(this.userConfig);
+    if (detection.filePatterns) {
       const basename3 = path.basename(filePath, path.extname(filePath));
-      if (basename3.match(/^(janitor|curator|distiller|surveyor|alfred)$/)) {
-        const raw = basename3 === "alfred" ? "alfred" : `alfred-${basename3}`;
-        return this.normaliseAgentId(raw);
+      for (const [pattern, template] of Object.entries(detection.filePatterns)) {
+        const re = new RegExp(`^(${pattern})$`);
+        const match = basename3.match(re);
+        if (match) {
+          const resolved = template.replace("${match}", match[1]);
+          return this.normaliseAgentId(resolved);
+        }
       }
     }
     return this.normaliseAgentId(pathAgent);
@@ -1111,20 +1238,23 @@ var TraceWatcher = class _TraceWatcher extends import_node_events.EventEmitter {
   extractAgentFromPath(filePath) {
     const filename = path.basename(filePath, path.extname(filePath));
     const pathParts = filePath.split(path.sep);
-    if (filePath.includes(".openclaw/")) {
-      const agentsIndex = pathParts.lastIndexOf("agents");
-      if (agentsIndex !== -1 && agentsIndex + 1 < pathParts.length) {
-        return `openclaw-${pathParts[agentsIndex + 1]}`;
-      }
-      if (filename.startsWith("openclaw-")) {
-        return "openclaw-gateway";
+    const detection = getAgentDetection(this.userConfig);
+    let pathPrefix = "";
+    if (detection.pathPatterns) {
+      for (const [pathSubstring, agentId] of Object.entries(detection.pathPatterns)) {
+        if (filePath.includes(pathSubstring)) {
+          pathPrefix = agentId;
+          break;
+        }
       }
-      return "openclaw";
     }
-    if (filePath.includes(".alfred/") || filename.includes("alfred")) {
-      return "alfred";
+    const agentsIndex = pathParts.lastIndexOf("agents");
+    if (agentsIndex !== -1 && agentsIndex + 1 < pathParts.length) {
+      const agentName = pathParts[agentsIndex + 1];
+      return pathPrefix ? `${pathPrefix}-${agentName}` : agentName;
     }
-    for (const part of pathParts.reverse()) {
+    if (pathPrefix) return pathPrefix;
+    for (const part of [...pathParts].reverse()) {
       if (part.match(/agent|worker|service|daemon|bot|ai|llm/i)) {
         return part;
       }
@@ -1459,19 +1589,22 @@ var TraceWatcher = class _TraceWatcher extends import_node_events.EventEmitter {
       const parentDir = path.basename(path.dirname(filePath));
       const grandParentDir = path.basename(path.dirname(path.dirname(filePath)));
       const greatGrandParentDir = path.basename(path.dirname(path.dirname(path.dirname(filePath))));
-      let agentId;
+      let agentName;
       if (parentDir === "sessions" && greatGrandParentDir === "agents") {
-        agentId = grandParentDir;
+        agentName = grandParentDir;
       } else if (grandParentDir === "agents") {
-        agentId = parentDir;
-      } else if (parentDir === "runs" && grandParentDir === "cron") {
-        agentId = "openclaw-cron";
+        agentName = parentDir;
       } else {
-        agentId = parentDir;
-      }
-      if (filePath.includes(".alfred/") || filePath.includes("alfred")) {
-        if (!agentId.startsWith("alfred-")) {
-          agentId = `alfred-${agentId}`;
+        agentName = parentDir;
+      }
+      let agentId = agentName;
+      const detection = getAgentDetection(this.userConfig);
+      if (detection.pathPatterns) {
+        for (const [pathSubstring, prefix] of Object.entries(detection.pathPatterns)) {
+          if (filePath.includes(pathSubstring)) {
+            agentId = `${prefix}-${agentName}`;
+            break;
+          }
         }
       }
       const modelEvent = rawEvents.find((e) => e.type === "model_change");
@@ -1760,6 +1893,7 @@ var TraceWatcher = class _TraceWatcher extends import_node_events.EventEmitter {
         edges: [],
         events: [],
         startTime,
+        status,
         agentId,
         trigger,
         name: rootName,
@@ -1880,8 +2014,12 @@ var TraceWatcher = class _TraceWatcher extends import_node_events.EventEmitter {
           // Ignore git directories
           /\.vscode/,
           // Ignore vscode
-          /\.idea/
+          /\.idea/,
           // Ignore idea
+          /\/archive\//,
+          // Ignore archived trace files
+          // Ignore user-configured skip directories
+          ...getSkipDirectories(this.userConfig).map((d) => new RegExp(`/${d}/`))
         ],
         persistent: true,
         ignoreInitial: true,
@@ -1935,29 +2073,42 @@ var TraceWatcher = class _TraceWatcher extends import_node_events.EventEmitter {
     });
   }
   getTrace(filename) {
+    const candidates = [];
     const exact = this.traces.get(filename);
-    if (exact) return exact;
+    if (exact) candidates.push(exact);
     if (filename.includes("::")) {
       const [fname, startTimeStr] = filename.split("::");
       const startTime = Number(startTimeStr);
       if (fname && !Number.isNaN(startTime)) {
         for (const trace of this.traces.values()) {
           if (trace.filename === fname && trace.startTime === startTime) {
-            return trace;
+            candidates.push(trace);
           }
         }
       }
     }
     for (const prefix of ["openclaw:", "otel:", ""]) {
       const prefixed = this.traces.get(prefix + filename);
-      if (prefixed) return prefixed;
+      if (prefixed) candidates.push(prefixed);
     }
     for (const [key, trace] of this.traces) {
       if (trace.filename === filename || trace.id === filename || key.endsWith(filename)) {
-        return trace;
+        candidates.push(trace);
       }
     }
-    return void 0;
+    if (candidates.length === 0) return void 0;
+    if (candidates.length === 1) return candidates[0];
+    let best = candidates[0];
+    let bestNodeCount = best.nodes instanceof Map ? best.nodes.size : Object.keys(best.nodes ?? {}).length;
+    for (let i = 1; i < candidates.length; i++) {
+      const c = candidates[i];
+      const nc = c.nodes instanceof Map ? c.nodes.size : Object.keys(c.nodes ?? {}).length;
+      if (nc > bestNodeCount) {
+        best = c;
+        bestNodeCount = nc;
+      }
+    }
+    return best;
   }
   getTracesByAgent(agentId) {
     return this.getAllTraces().filter((trace) => trace.agentId === agentId);
@@ -2019,12 +2170,15 @@ function serializeTrace(trace) {
 var DashboardServer = class {
   constructor(config) {
     this.config = config;
-    const home = process.env.HOME ?? "/home/trader";
-    const configPath = path2.join(home, ".agentflow/dashboard-config.json");
+    const { config: userCfg, configPath: cfgPath } = loadConfig(config.configPath);
+    this.userConfig = userCfg;
+    this.configPath = cfgPath;
+    const home = process.env.HOME ?? process.env.USERPROFILE ?? "/tmp";
+    const dashConfigPath = path2.join(home, ".agentflow/dashboard-config.json");
     if (!config.dataDirs) config.dataDirs = [];
     try {
-      if (fs2.existsSync(configPath)) {
-        const saved = JSON.parse(fs2.readFileSync(configPath, "utf-8"));
+      if (fs2.existsSync(dashConfigPath)) {
+        const saved = JSON.parse(fs2.readFileSync(dashConfigPath, "utf-8"));
         const extraDirs = saved.extraDirs ?? [];
         for (const d of extraDirs) {
           if (!config.dataDirs.includes(d)) config.dataDirs.push(d);
@@ -2032,21 +2186,15 @@ var DashboardServer = class {
       }
     } catch {
     }
-    const autoDiscoverPaths = [
-      path2.join(home, ".openclaw/cron/runs"),
-      path2.join(home, ".openclaw/workspace/traces"),
-      path2.join(home, ".openclaw/subagents"),
-      path2.join(home, ".openclaw/agents/main/sessions"),
-      path2.join(home, ".agentflow/traces")
-    ];
-    for (const p of autoDiscoverPaths) {
+    for (const p of getDiscoveryPaths(this.userConfig)) {
       if (fs2.existsSync(p) && !config.dataDirs.includes(p)) {
         config.dataDirs.push(p);
       }
     }
     this.watcher = new TraceWatcher({
       tracesDir: config.tracesDir,
-      dataDirs: config.dataDirs
+      dataDirs: config.dataDirs,
+      userConfig: this.userConfig
     });
     this.stats = new AgentStats();
     this.knowledgeStore = (0, import_agentflow_core3.createKnowledgeStore)({
@@ -2055,6 +2203,7 @@ var DashboardServer = class {
     this.setupExpress();
     this.setupWebSocket();
     this.setupTraceWatcher();
+    this.setupSomaReportWatcher();
     let knowledgeCount = 0;
     for (const trace of this.watcher.getAllTraces()) {
       this.stats.processTrace(trace);
@@ -2081,6 +2230,8 @@ var DashboardServer = class {
     ts: 0
   };
   knowledgeStore;
+  userConfig;
+  configPath;
   setupExpress() {
     if (this.config.enableCors) {
       this.app.use((_req, res, next) => {
@@ -2092,18 +2243,35 @@ var DashboardServer = class {
         next();
       });
     }
-    const clientDir = path2.join(__dirname, "../dist/client");
+    const pkgDir = path2.join(__dirname, "..");
+    const clientDir = path2.join(pkgDir, "dist/client");
+    const clientIndex = path2.join(clientDir, "index.html");
+    const srcDir = path2.join(pkgDir, "src/client");
+    const needsBuild = !fs2.existsSync(clientIndex) || fs2.existsSync(srcDir) && this.isClientStale(srcDir, clientDir);
+    if (needsBuild) {
+      try {
+        console.log("Building dashboard client...");
+        (0, import_node_child_process.execSync)("npm run build:client", { cwd: pkgDir, stdio: "inherit", timeout: 3e4 });
+      } catch (err) {
+        console.warn("Client build failed \u2014 dashboard UI may be stale:", err.message);
+      }
+    }
     if (fs2.existsSync(clientDir)) {
       this.app.use(import_express.default.static(clientDir));
     }
-    const publicDir = path2.join(__dirname, "../public");
-    if (fs2.existsSync(publicDir)) {
-      this.app.use("/v1", import_express.default.static(publicDir));
-    }
-    this.app.get("/api/traces", (_req, res) => {
+    this.app.get("/api/traces", (req, res) => {
       try {
-        const traces = this.watcher.getAllTraces().map(serializeTrace);
-        res.json(traces);
+        const limit = Math.min(Math.max(parseInt(req.query.limit, 10) || 50, 1), 200);
+        const cursor = req.query.cursor ? parseFloat(req.query.cursor) : void 0;
+        let allTraces = this.watcher.getAllTraces();
+        if (cursor) {
+          allTraces = allTraces.filter((t) => (t.lastModified || t.startTime) < cursor);
+        }
+        const page = allTraces.slice(0, limit);
+        const serialized = page.map(serializeTrace);
+        const lastTrace = page[page.length - 1];
+        const nextCursor = page.length === limit && lastTrace ? lastTrace.lastModified || lastTrace.startTime : null;
+        res.json({ traces: serialized, nextCursor });
       } catch (_error) {
         res.status(500).json({ error: "Failed to load traces" });
       }
@@ -2394,6 +2562,235 @@ var DashboardServer = class {
         res.status(500).json({ error: "Failed to load agent statistics" });
       }
     });
+    this.app.get("/api/soma/tier", (_req, res) => {
+      const somaVault = this.config.somaVault;
+      if (!somaVault) {
+        return res.json({ tier: "teaser", somaVault: false, governanceAvailable: false });
+      }
+      try {
+        const reportPath = path2.join(somaVault, "..", "soma-report.json");
+        if (!fs2.existsSync(reportPath)) {
+          return res.json({ tier: "free", somaVault: true, governanceAvailable: false });
+        }
+        const report = JSON.parse(fs2.readFileSync(reportPath, "utf-8"));
+        const hasGovernance = report.governance && typeof report.governance.pending === "number";
+        return res.json({
+          tier: hasGovernance ? "pro" : "free",
+          somaVault: true,
+          governanceAvailable: !!hasGovernance
+        });
+      } catch {
+        return res.json({ tier: "free", somaVault: true, governanceAvailable: false });
+      }
+    });
+    this.app.get("/api/soma/report", (_req, res) => {
+      const somaVault = this.config.somaVault;
+      if (!somaVault) {
+        return res.json({ available: false, teaser: true });
+      }
+      try {
+        const reportPath = path2.join(somaVault, "..", "soma-report.json");
+        if (!fs2.existsSync(reportPath)) {
+          return res.json({ available: false, teaser: false, message: "No report file yet. Run soma watch." });
+        }
+        const report = JSON.parse(fs2.readFileSync(reportPath, "utf-8"));
+        res.json(report);
+      } catch (error) {
+        console.error("Soma report error:", error);
+        res.json({ available: false, teaser: false, message: "Failed to read report" });
+      }
+    });
+    this.app.get("/api/soma/governance", (_req, res) => {
+      const somaVault = this.config.somaVault;
+      if (!somaVault) {
+        return res.json({ available: false });
+      }
+      try {
+        const reportPath = path2.join(somaVault, "..", "soma-report.json");
+        if (!fs2.existsSync(reportPath)) {
+          return res.json({ available: false, message: "No report file. Run soma report." });
+        }
+        const report = JSON.parse(fs2.readFileSync(reportPath, "utf-8"));
+        res.json({
+          available: true,
+          layers: report.layers ?? { archive: 0, working: 0, emerging: 0, canon: 0 },
+          governance: report.governance ?? { pending: 0, promoted: 0, rejected: 0 },
+          insights: (report.insights ?? []).filter((i) => i.layer === "emerging" && i.proposal_status === "pending"),
+          canon: (report.insights ?? []).filter((i) => i.layer === "canon"),
+          generatedAt: report.generatedAt
+        });
+      } catch (error) {
+        console.error("Soma governance error:", error);
+        res.status(500).json({ available: false, message: "Failed to read governance data" });
+      }
+    });
+    const sanitizeArg = (s) => s.replace(/[^a-zA-Z0-9_\-.:]/g, "");
+    const sanitizeReason = (s) => s.replace(/["`$\\]/g, "").slice(0, 500);
+    this.app.post("/api/soma/governance/promote", (req, res) => {
+      var _a;
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.status(400).json({ error: "Soma vault not configured" });
+      const { entryId } = req.body ?? {};
+      if (!entryId) return res.status(400).json({ error: "entryId required" });
+      try {
+        const { execSync: execSync2 } = require("child_process");
+        const safeId = sanitizeArg(String(entryId));
+        const result = execSync2(`npx soma governance promote ${safeId} --vault "${somaVault}"`, {
+          encoding: "utf-8",
+          timeout: 1e4
+        });
+        res.json({ success: true, message: result.trim() });
+      } catch (error) {
+        res.status(400).json({ error: ((_a = error.stderr) == null ? void 0 : _a.trim()) || error.message });
+      }
+    });
+    this.app.post("/api/soma/governance/reject", (req, res) => {
+      var _a;
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.status(400).json({ error: "Soma vault not configured" });
+      const { entryId, reason } = req.body ?? {};
+      if (!entryId || !reason) return res.status(400).json({ error: "entryId and reason required" });
+      try {
+        const { execSync: execSync2 } = require("child_process");
+        const safeId = sanitizeArg(String(entryId));
+        const safeReason = sanitizeReason(String(reason));
+        const result = execSync2(`npx soma governance reject ${safeId} "${safeReason}" --vault "${somaVault}"`, {
+          encoding: "utf-8",
+          timeout: 1e4
+        });
+        res.json({ success: true, message: result.trim() });
+      } catch (error) {
+        res.status(400).json({ error: ((_a = error.stderr) == null ? void 0 : _a.trim()) || error.message });
+      }
+    });
+    this.app.get("/api/soma/governance/evidence/:id", (req, res) => {
+      var _a;
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.status(400).json({ error: "Soma vault not configured" });
+      try {
+        const { execSync: execSync2 } = require("child_process");
+        const safeId = sanitizeArg(String(req.params.id));
+        const result = execSync2(`npx soma governance show ${safeId} --vault "${somaVault}"`, {
+          encoding: "utf-8",
+          timeout: 1e4
+        });
+        res.json({ available: true, output: result.trim() });
+      } catch (error) {
+        res.status(404).json({ error: ((_a = error.stderr) == null ? void 0 : _a.trim()) || error.message });
+      }
+    });
+    this.app.get("/api/soma/policies", (_req, res) => {
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.json({ policies: [] });
+      try {
+        const reportPath = path2.join(somaVault, "..", "soma-report.json");
+        if (!fs2.existsSync(reportPath)) return res.json({ policies: [] });
+        const report = JSON.parse(fs2.readFileSync(reportPath, "utf-8"));
+        res.json({ policies: report.policies ?? [] });
+      } catch {
+        res.json({ policies: [] });
+      }
+    });
+    this.app.post("/api/soma/policies", import_express.default.json(), (req, res) => {
+      var _a;
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.status(400).json({ error: "Soma vault not configured" });
+      const { name, enforcement, scope, conditions } = req.body ?? {};
+      if (!name) return res.status(400).json({ error: "name required" });
+      try {
+        const safeName = sanitizeArg(String(name));
+        const safeEnf = sanitizeArg(String(enforcement || "warn"));
+        const safeScope = sanitizeReason(String(scope || "all"));
+        const safeCond = sanitizeReason(String(conditions || ""));
+        const result = (0, import_node_child_process.execSync)(
+          `npx soma policy create "${safeName}" --enforcement ${safeEnf} --scope "${safeScope}" --conditions "${safeCond}" --vault "${somaVault}"`,
+          { encoding: "utf-8", timeout: 1e4 }
+        );
+        res.json({ success: true, message: result.trim() });
+      } catch (error) {
+        res.status(400).json({ error: ((_a = error.stderr) == null ? void 0 : _a.trim()) || error.message });
+      }
+    });
+    this.app.delete("/api/soma/policies/:name", (req, res) => {
+      var _a;
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.status(400).json({ error: "Soma vault not configured" });
+      try {
+        const safeName = sanitizeArg(String(req.params.name));
+        const result = (0, import_node_child_process.execSync)(
+          `npx soma policy delete "${safeName}" --vault "${somaVault}"`,
+          { encoding: "utf-8", timeout: 1e4 }
+        );
+        res.json({ success: true, message: result.trim() });
+      } catch (error) {
+        res.status(400).json({ error: ((_a = error.stderr) == null ? void 0 : _a.trim()) || error.message });
+      }
+    });
+    this.app.get("/api/soma/vault/entities", (req, res) => {
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.json({ entities: [], total: 0 });
+      try {
+        const reportPath = path2.join(somaVault, "..", "soma-report.json");
+        if (!fs2.existsSync(reportPath)) return res.json({ entities: [], total: 0 });
+        const report = JSON.parse(fs2.readFileSync(reportPath, "utf-8"));
+        let entities = [
+          ...(report.agents ?? []).map((a) => ({ ...a, type: "agent", id: a.name })),
+          ...(report.insights ?? []).map((i, idx) => {
+            var _a;
+            return { ...i, type: i.type || "insight", id: ((_a = i.title) == null ? void 0 : _a.replace(/\s+/g, "-").toLowerCase()) || `insight-${idx}` };
+          }),
+          ...(report.policies ?? []).map((p) => ({ ...p, type: "policy", id: p.name }))
+        ];
+        const { type, layer, q, limit: limitStr, offset: offsetStr } = req.query;
+        if (type) entities = entities.filter((e) => e.type === type);
+        if (layer) entities = entities.filter((e) => e.layer === layer);
+        if (q) {
+          const lq = q.toLowerCase();
+          entities = entities.filter((e) => (e.name || e.title || "").toLowerCase().includes(lq) || (e.claim || e.body || "").toLowerCase().includes(lq));
+        }
+        const total = entities.length;
+        const offset = parseInt(offsetStr || "0", 10);
+        const limit = Math.min(parseInt(limitStr || "50", 10), 200);
+        entities = entities.slice(offset, offset + limit);
+        res.json({ entities, total });
+      } catch (error) {
+        console.error("Vault entities error:", error);
+        res.json({ entities: [], total: 0 });
+      }
+    });
+    this.app.get("/api/soma/vault/entities/:type/:id", (req, res) => {
+      const somaVault = this.config.somaVault;
+      if (!somaVault) return res.status(404).json({ error: "Soma vault not configured" });
+      try {
+        const reportPath = path2.join(somaVault, "..", "soma-report.json");
+        const report = JSON.parse(fs2.readFileSync(reportPath, "utf-8"));
+        const { type, id } = req.params;
+        let entity = null;
+        if (type === "agent") {
+          entity = (report.agents ?? []).find((a) => a.name === id);
+        } else if (type === "policy") {
+          entity = (report.policies ?? []).find((p) => p.name === id);
+        } else {
+          entity = (report.insights ?? []).find(
+            (i) => {
+              var _a;
+              return (((_a = i.title) == null ? void 0 : _a.replace(/\s+/g, "-").toLowerCase()) || "") === id || i.title === id;
+            }
+          );
+        }
+        if (!entity) return res.status(404).json({ error: "Entity not found" });
+        res.json({
+          ...entity,
+          type,
+          id,
+          body: entity.claim || entity.conditions || "",
+          tags: entity.tags ?? [],
+          related: entity.related ?? []
+        });
+      } catch {
+        res.status(404).json({ error: "Entity not found" });
+      }
+    });
     this.app.get("/api/process-health", (_req, res) => {
       var _a, _b;
       try {
@@ -2406,7 +2803,14 @@ var DashboardServer = class {
           path2.dirname(this.config.tracesDir),
           ...this.config.dataDirs || []
         ];
-        const configs = (0, import_agentflow_core3.discoverAllProcessConfigs)(discoveryDirs);
+        let configs = (0, import_agentflow_core3.discoverAllProcessConfigs)(discoveryDirs);
+        const pref = getProcessPreference(this.userConfig);
+        if (pref) {
+          const hasPreferred = configs.some((c) => c.processName === pref.prefer);
+          if (hasPreferred) {
+            configs = configs.filter((c) => c.processName !== pref.over);
+          }
+        }
         if (configs.length === 0) {
           return res.json(null);
         }
@@ -2490,35 +2894,32 @@ var DashboardServer = class {
           }
         } catch {
         }
-        const watched = [
+        const watched = [...new Set([
           this.config.tracesDir,
           ...this.config.dataDirs || [],
           ...extraDirs
-        ];
+        ].map((w) => path2.resolve(w)))];
         const discovered = [];
-        try {
-          const { execSync } = require("child_process");
-          const raw = execSync(
-            "systemctl --user show --property=ExecStart --no-pager alfred.service openclaw-gateway.service 2>/dev/null",
-            { encoding: "utf8", timeout: 5e3 }
-          );
-          for (const line of raw.split("\n")) {
-            const match = line.match(/path=([^\s;]+)/);
-            if (match == null ? void 0 : match[1]) {
-              const dir = path2.dirname(match[1]);
-              if (fs2.existsSync(dir)) discovered.push(dir);
+        const svcNames = getSystemdServices(this.userConfig);
+        if (svcNames.length > 0) {
+          try {
+            const { execSync: execSync2 } = require("child_process");
+            const raw = execSync2(
+              `systemctl --user show --property=ExecStart --no-pager ${svcNames.join(" ")} 2>/dev/null`,
+              { encoding: "utf8", timeout: 5e3 }
+            );
+            for (const line of raw.split("\n")) {
+              const match = line.match(/path=([^\s;]+)/);
+              if (match == null ? void 0 : match[1]) {
+                const dir = path2.dirname(match[1]);
+                if (fs2.existsSync(dir)) discovered.push(dir);
+              }
             }
+          } catch {
           }
-        } catch {
         }
         const commonPaths = [
-          path2.join(home, ".alfred/traces"),
-          path2.join(home, ".alfred/data"),
-          path2.join(home, ".openclaw/workspace/traces"),
-          path2.join(home, ".openclaw/subagents"),
-          path2.join(home, ".openclaw/cron/runs"),
-          path2.join(home, ".openclaw/cron"),
-          path2.join(home, ".openclaw/agents/main/sessions"),
+          ...getDiscoveryPaths(this.userConfig),
           path2.join(home, ".agentflow/traces")
         ];
         for (const p of commonPaths) {
@@ -2622,18 +3023,10 @@ var DashboardServer = class {
     this.app.get("/ready", (_req, res) => {
       res.json({ status: "ready" });
     });
-    this.app.get("/v1/*", (_req, res) => {
-      const legacyIndex = path2.join(__dirname, "../public/index.html");
-      if (fs2.existsSync(legacyIndex)) {
-        res.sendFile(legacyIndex);
-      } else {
-        res.status(404).send("Legacy dashboard not found");
-      }
-    });
     this.app.get("*", (_req, res) => {
-      const clientIndex = path2.join(__dirname, "../dist/client/index.html");
-      if (fs2.existsSync(clientIndex)) {
-        res.sendFile(clientIndex);
+      const clientIndex2 = path2.join(__dirname, "../dist/client/index.html");
+      if (fs2.existsSync(clientIndex2)) {
+        res.sendFile(clientIndex2);
       } else {
         res.status(404).send("Dashboard not found - public files may not be built");
       }
@@ -2659,6 +3052,41 @@ var DashboardServer = class {
       });
     });
   }
+  /** Watch soma-report.json for changes and broadcast updates via WebSocket. */
+  setupSomaReportWatcher() {
+    const somaVault = this.config.somaVault;
+    if (!somaVault) return;
+    const reportPath = path2.join(somaVault, "..", "soma-report.json");
+    const reportDir = path2.dirname(reportPath);
+    if (!fs2.existsSync(reportDir)) return;
+    let debounceTimer = null;
+    const watcher = import_chokidar2.default.watch(reportPath, {
+      ignoreInitial: true,
+      persistent: true,
+      awaitWriteFinish: { stabilityThreshold: 500 }
+    });
+    watcher.on("change", () => {
+      if (debounceTimer) clearTimeout(debounceTimer);
+      debounceTimer = setTimeout(() => {
+        var _a, _b;
+        try {
+          const report = JSON.parse(fs2.readFileSync(reportPath, "utf-8"));
+          this.broadcast({ type: "soma-report-updated", data: report });
+          if (report.generatedAt) {
+            this.broadcast({
+              type: "soma-activity",
+              data: {
+                action: "report-updated",
+                description: `Report updated: ${((_a = report.totals) == null ? void 0 : _a.agents) ?? 0} agents, ${((_b = report.totals) == null ? void 0 : _b.insights) ?? 0} insights`,
+                timestamp: report.generatedAt
+              }
+            });
+          }
+        } catch {
+        }
+      }, 500);
+    });
+  }
   /**
    * Filter an agent's traces to valid ExecutionGraphs and convert via loadGraph().
    * Returns only traces with proper nodes (Map or non-empty object), skipping session-only traces.
@@ -2880,24 +3308,49 @@ var DashboardServer = class {
     });
   }
   async start() {
-    return new Promise((resolve4) => {
+    return new Promise((resolve5) => {
       const host = this.config.host || "localhost";
       this.server.listen(this.config.port, host, () => {
         console.log(`AgentFlow Dashboard running at http://${host}:${this.config.port}`);
         console.log(`Watching traces in: ${this.config.tracesDir}`);
-        resolve4();
+        resolve5();
       });
     });
   }
+  /** Check if any src/client file is newer than the built bundle. */
+  isClientStale(srcDir, distDir) {
+    try {
+      const distIndex = path2.join(distDir, "index.html");
+      if (!fs2.existsSync(distIndex)) return true;
+      const distMtime = fs2.statSync(distIndex).mtimeMs;
+      const check = (dir) => {
+        for (const entry of fs2.readdirSync(dir, { withFileTypes: true })) {
+          const full = path2.join(dir, entry.name);
+          if (entry.isDirectory()) {
+            if (check(full)) return true;
+          } else if (fs2.statSync(full).mtimeMs > distMtime) {
+            return true;
+          }
+        }
+        return false;
+      };
+      return check(srcDir);
+    } catch {
+      return false;
+    }
+  }
   async stop() {
-    return new Promise((resolve4) => {
+    return new Promise((resolve5) => {
       this.watcher.stop();
       this.server.close(() => {
         console.log("Dashboard server stopped");
-        resolve4();
+        resolve5();
       });
     });
   }
+  getConfigPath() {
+    return this.configPath;
+  }
   getStats() {
     return this.stats.getGlobalStats();
   }
@@ -2910,7 +3363,7 @@ if (import_meta.url === `file://${process.argv[1]}`) {
 }
 
 // src/cli.ts
-var VERSION = "0.4.0";
+var VERSION = "0.8.0";
 function getLanAddress() {
   const interfaces = os.networkInterfaces();
   for (const name of Object.keys(interfaces)) {
@@ -2922,7 +3375,7 @@ function getLanAddress() {
   }
   return null;
 }
-function printBanner(config, traceCount, stats) {
+function printBanner(config, traceCount, stats, configPath) {
   var _a;
   const lan = getLanAddress();
   const host = config.host || "localhost";
@@ -2938,26 +3391,25 @@ function printBanner(config, traceCount, stats) {
 
   See your agents think.
 
-  \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510              \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510              \u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
-  \u2502  \u{1F916} Agents          \u2502  TRACE FILES \u2502  \u{1F4CA} AgentFlow      \u2502  SHOWS YOU   \u2502  \u{1F310} Your browser   \u2502
-  \u2502  Execute tasks,   \u2502 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500> \u2502  Reads traces,    \u2502 \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500> \u2502  Interactive      \u2502
-  \u2502  write JSON       \u2502              \u2502  builds graphs,  \u2502              \u2502  graph, timeline, \u2502
-  \u2502  trace files.     \u2502              \u2502  serves dashboard.\u2502              \u2502  metrics, health. \u2502
-  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518              \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518              \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
-
-  Runs locally. Your data never leaves your machine.
-
-  Tabs: \u{1F3AF} Graph \xB7 \u23F1\uFE0F  Timeline \xB7 \u{1F4CA} Metrics \xB7 \u{1F6E0}\uFE0F  Process Health \xB7 \u26A0\uFE0F  Errors
-
   Traces:     ${config.tracesDir}${((_a = config.dataDirs) == null ? void 0 : _a.length) ? `
   Data dirs:  ${config.dataDirs.join("\n              ")}` : ""}
   Loaded:     ${traceCount} traces \xB7 ${stats.totalAgents} agents \xB7 ${stats.totalExecutions} executions
   Success:    ${stats.globalSuccessRate.toFixed(1)}%${stats.activeAgents > 0 ? ` \xB7 ${stats.activeAgents} active now` : ""}
+  Config:     ${configPath ?? "none (using defaults)"}
   CORS:       ${config.enableCors ? "enabled" : "disabled"}
   WebSocket:  live updates enabled
+  Window:     ${process.env.AGENTFLOW_TRACE_WINDOW_HOURS ?? "48"}h (set AGENTFLOW_TRACE_WINDOW_HOURS to change)
 
   \u2192 http://localhost:${port}${isPublic && lan ? `
   \u2192 http://${lan}:${port}  (LAN)` : ""}
+
+  Pages:  Agents \xB7 SOMA
+  Agent:  Profile \xB7 Execution Detail
+  SOMA:   Intelligence \xB7 Review \xB7 Policies \xB7 Knowledge \xB7 Activity
+  Tabs:   Flame Chart \xB7 Agent Flow \xB7 Metrics \xB7 Dependencies
+          State Machine \xB7 Summary \xB7 Transcript
+
+  Runs locally. Your data never leaves your machine.
 `);
 }
 async function startDashboard() {
@@ -2995,6 +3447,12 @@ async function startDashboard() {
       case "--collector-token":
         config.collectorAuthToken = args[++i];
         break;
+      case "--soma-vault":
+        config.somaVault = args[++i];
+        break;
+      case "--config":
+        config.configPath = args[++i];
+        break;
       case "--help":
         printHelp();
         process.exit(0);
@@ -3006,6 +3464,9 @@ async function startDashboard() {
   if (process.env.AGENTFLOW_NO_COLLECTOR === "true") {
     config.enableCollector = false;
   }
+  if (!config.somaVault && process.env.SOMA_VAULT) {
+    config.somaVault = process.env.SOMA_VAULT;
+  }
   const tracesPath = path3.resolve(config.tracesDir);
   if (!fs3.existsSync(tracesPath)) {
     fs3.mkdirSync(tracesPath, { recursive: true });
@@ -3027,7 +3488,7 @@ async function startDashboard() {
     setTimeout(() => {
       const stats = dashboard.getStats();
       const traces = dashboard.getTraces();
-      printBanner(config, traces.length, stats);
+      printBanner(config, traces.length, stats, dashboard.getConfigPath());
     }, 1500);
   } catch (error) {
     console.error("\u274C Failed to start dashboard:", error);
@@ -3036,7 +3497,7 @@ async function startDashboard() {
 }
 function printHelp() {
   console.log(`
-\u{1F4CA} AgentFlow Dashboard v${VERSION} \u2014 See your agents think.
+AgentFlow Dashboard v${VERSION} \u2014 See your agents think.
 
 Usage:
   agentflow-dashboard [options]
@@ -3047,22 +3508,34 @@ Options:
   -t, --traces <path>     Traces directory (default: ./traces)
   -h, --host <address>    Host address (default: localhost)
   --data-dir <path>       Extra data directory for process discovery (repeatable)
+  --config <path>         Path to agentflow.config.json (aliases, skip files, etc.)
+  --soma-vault <path>     SOMA vault directory for intelligence data
   --cors                  Enable CORS headers
   --no-collector          Disable OTLP trace collector (POST /v1/traces)
   --collector-token <tok> Require auth token for collector (or set AGENTFLOW_COLLECTOR_TOKEN)
   --help                  Show this help message
 
-Examples:
-  agentflow-dashboard --traces ./traces --host 0.0.0.0 --cors
-  agentflow-dashboard -p 8080 -t /var/log/agentflow
-  agentflow-dashboard --traces ./traces --data-dir ./workers --data-dir ./cron
+Config file:
+  The dashboard loads agentflow.config.json for agent aliases, skip files,
+  discovery paths, and systemd services. Resolution order:
+    1. --config flag
+    2. AGENTFLOW_CONFIG env var
+    3. ./agentflow.config.json
+    4. ~/.config/agentflow/config.json
+
+  See agentflow.config.example.json for a complete reference.
 
-Tabs:
-  \u{1F3AF} Graph            Interactive Cytoscape.js execution graph
-  \u23F1\uFE0F  Timeline          Waterfall view of node durations
-  \u{1F4CA} Metrics           Success rates, durations, node breakdown
-  \u{1F6E0}\uFE0F  Process Health    PID files, systemd, workers, orphans
-  \u26A0\uFE0F  Errors            Failed and hung nodes with metadata
+Environment:
+  AGENTFLOW_CONFIG               Path to config file
+  AGENTFLOW_TRACE_WINDOW_HOURS   Max age of traces to load (default: 48)
+  AGENTFLOW_COLLECTOR_TOKEN      Auth token for OTLP collector
+  AGENTFLOW_NO_COLLECTOR=true    Disable OTLP collector
+  SOMA_VAULT                     SOMA vault directory
+
+Examples:
+  agentflow-dashboard --traces ./traces --host 0.0.0.0
+  agentflow-dashboard --traces ./traces --config ./agentflow.config.json
+  agentflow-dashboard -p 8080 -t /var/log/agentflow --cors
 `);
 }
 // Annotate the CommonJS export names for ESM import in node: