agentflow-dashboard 0.8.0 → 0.8.2

package/dist/{chunk-NZFXRZYU.js → chunk-EG254FLY.js}

@@ -10,7 +10,7 @@ import { execSync } from "child_process";
 import * as fs3 from "fs";
 import { createServer } from "http";
 import * as path3 from "path";
-import { fileURLToPath } from "url";
+import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/config.ts
 import { existsSync, readFileSync } from "fs";
@@ -94,6 +94,7 @@ import {
   getBottlenecks,
   loadGraph as loadGraph2
 } from "agentflow-core";
+import chokidar2 from "chokidar";
 import express from "express";
 import { WebSocketServer } from "ws";
 
@@ -868,7 +869,7 @@ var TraceWatcher = class _TraceWatcher extends EventEmitter {
       ...getSkipFiles(this.userConfig)
     ]);
     this.userSkipDirs = new Set(getSkipDirectories(this.userConfig));
-    this.allWatchDirs = [this.tracesDir, ...this.dataDirs];
+    this.allWatchDirs = [...new Set([this.tracesDir, ...this.dataDirs].map((d) => path.resolve(d)))];
     this.ensureTracesDir();
     this.loadExistingFiles();
     this.archiveOldTraces();
@@ -2049,8 +2050,8 @@ var TraceWatcher = class _TraceWatcher extends EventEmitter {
       return (b.lastModified || b.startTime) - (a.lastModified || a.startTime);
     });
   }
-  getTrace(filename) {
-    const candidates = [];
+  getTrace(filename, agentId) {
+    let candidates = [];
     const exact = this.traces.get(filename);
     if (exact) candidates.push(exact);
     if (filename.includes("::")) {
@@ -2075,6 +2076,13 @@ var TraceWatcher = class _TraceWatcher extends EventEmitter {
     }
     if (candidates.length === 0) return void 0;
     if (candidates.length === 1) return candidates[0];
+    if (agentId) {
+      const agentMatches = candidates.filter((c) => c.agentId === agentId);
+      if (agentMatches.length > 0) {
+        candidates = agentMatches;
+      }
+    }
+    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++) {
@@ -2132,7 +2140,9 @@ var TraceWatcher = class _TraceWatcher extends EventEmitter {
 import * as fs2 from "fs";
 import * as os from "os";
 import * as path2 from "path";
-var VERSION = "0.8.0";
+import { fileURLToPath } from "url";
+var __cliDirname = path2.dirname(fileURLToPath(import.meta.url));
+var VERSION = JSON.parse(fs2.readFileSync(path2.resolve(__cliDirname, "../package.json"), "utf-8")).version;
 function getLanAddress() {
   const interfaces = os.networkInterfaces();
   for (const name of Object.keys(interfaces)) {
@@ -2172,7 +2182,9 @@ function printBanner(config, traceCount, stats, configPath) {
   \u2192 http://localhost:${port}${isPublic && lan ? `
   \u2192 http://${lan}:${port}  (LAN)` : ""}
 
-  Views:  Agent Profile \xB7 Execution Detail \xB7 Governance
+  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
 
@@ -2307,7 +2319,7 @@ Examples:
 }
 
 // src/server.ts
-var __filename = fileURLToPath(import.meta.url);
+var __filename = fileURLToPath2(import.meta.url);
 var __dirname = path3.dirname(__filename);
 function serializeTrace(trace) {
   if (!trace) return trace;
@@ -2357,6 +2369,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);
@@ -2412,6 +2425,10 @@ var DashboardServer = class {
     if (fs3.existsSync(clientDir)) {
       this.app.use(express.static(clientDir));
     }
+    const pkgVersion = JSON.parse(fs3.readFileSync(path3.resolve(__dirname, "../package.json"), "utf-8")).version;
+    this.app.get("/api/version", (_req, res) => {
+      res.json({ version: pkgVersion });
+    });
     this.app.get("/api/traces", (req, res) => {
       try {
         const limit = Math.min(Math.max(parseInt(req.query.limit, 10) || 50, 1), 200);
@@ -2431,7 +2448,8 @@ var DashboardServer = class {
     });
     this.app.get("/api/traces/:filename", (req, res) => {
       try {
-        const trace = this.watcher.getTrace(req.params.filename);
+        const agentId = typeof req.query.agent === "string" ? req.query.agent : void 0;
+        const trace = this.watcher.getTrace(req.params.filename, agentId);
         if (!trace) {
           return res.status(404).json({ error: "Trace not found" });
         }
@@ -2715,6 +2733,27 @@ 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 = path3.join(somaVault, "..", "soma-report.json");
+        if (!fs3.existsSync(reportPath)) {
+          return res.json({ tier: "free", somaVault: true, governanceAvailable: false });
+        }
+        const report = JSON.parse(fs3.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) {
@@ -2811,6 +2850,118 @@ var DashboardServer = class {
         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 = path3.join(somaVault, "..", "soma-report.json");
+        if (!fs3.existsSync(reportPath)) return res.json({ policies: [] });
+        const report = JSON.parse(fs3.readFileSync(reportPath, "utf-8"));
+        res.json({ policies: report.policies ?? [] });
+      } catch {
+        res.json({ policies: [] });
+      }
+    });
+    this.app.post("/api/soma/policies", express.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 = 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 = 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 = path3.join(somaVault, "..", "soma-report.json");
+        if (!fs3.existsSync(reportPath)) return res.json({ entities: [], total: 0 });
+        const report = JSON.parse(fs3.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 = path3.join(somaVault, "..", "soma-report.json");
+        const report = JSON.parse(fs3.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 {
@@ -2914,11 +3065,11 @@ var DashboardServer = class {
           }
         } catch {
         }
-        const watched = [
+        const watched = [...new Set([
           this.config.tracesDir,
           ...this.config.dataDirs || [],
           ...extraDirs
-        ];
+        ].map((w) => path3.resolve(w)))];
         const discovered = [];
         const svcNames = getSystemdServices(this.userConfig);
         if (svcNames.length > 0) {
@@ -3072,6 +3223,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 = path3.join(somaVault, "..", "soma-report.json");
+    const reportDir = path3.dirname(reportPath);
+    if (!fs3.existsSync(reportDir)) return;
+    let debounceTimer = null;
+    const watcher = chokidar2.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(fs3.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.

package/dist/cli.cjs

@@ -35,6 +35,7 @@ module.exports = __toCommonJS(cli_exports);
 var fs3 = __toESM(require("fs"), 1);
 var os = __toESM(require("os"), 1);
 var path3 = __toESM(require("path"), 1);
+var import_node_url2 = require("url");
 
 // src/server.ts
 var import_node_child_process = require("child_process");
@@ -116,6 +117,7 @@ function getProcessPreference(config) {
 
 // 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");
 
@@ -890,7 +892,7 @@ var TraceWatcher = class _TraceWatcher extends import_node_events.EventEmitter {
       ...getSkipFiles(this.userConfig)
     ]);
     this.userSkipDirs = new Set(getSkipDirectories(this.userConfig));
-    this.allWatchDirs = [this.tracesDir, ...this.dataDirs];
+    this.allWatchDirs = [...new Set([this.tracesDir, ...this.dataDirs].map((d) => path.resolve(d)))];
     this.ensureTracesDir();
     this.loadExistingFiles();
     this.archiveOldTraces();
@@ -2071,8 +2073,8 @@ var TraceWatcher = class _TraceWatcher extends import_node_events.EventEmitter {
       return (b.lastModified || b.startTime) - (a.lastModified || a.startTime);
     });
   }
-  getTrace(filename) {
-    const candidates = [];
+  getTrace(filename, agentId) {
+    let candidates = [];
     const exact = this.traces.get(filename);
     if (exact) candidates.push(exact);
     if (filename.includes("::")) {
@@ -2097,6 +2099,13 @@ var TraceWatcher = class _TraceWatcher extends import_node_events.EventEmitter {
     }
     if (candidates.length === 0) return void 0;
     if (candidates.length === 1) return candidates[0];
+    if (agentId) {
+      const agentMatches = candidates.filter((c) => c.agentId === agentId);
+      if (agentMatches.length > 0) {
+        candidates = agentMatches;
+      }
+    }
+    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++) {
@@ -2202,6 +2211,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);
@@ -2257,6 +2267,10 @@ var DashboardServer = class {
     if (fs2.existsSync(clientDir)) {
       this.app.use(import_express.default.static(clientDir));
     }
+    const pkgVersion = JSON.parse(fs2.readFileSync(path2.resolve(__dirname, "../package.json"), "utf-8")).version;
+    this.app.get("/api/version", (_req, res) => {
+      res.json({ version: pkgVersion });
+    });
     this.app.get("/api/traces", (req, res) => {
       try {
         const limit = Math.min(Math.max(parseInt(req.query.limit, 10) || 50, 1), 200);
@@ -2276,7 +2290,8 @@ var DashboardServer = class {
     });
     this.app.get("/api/traces/:filename", (req, res) => {
       try {
-        const trace = this.watcher.getTrace(req.params.filename);
+        const agentId = typeof req.query.agent === "string" ? req.query.agent : void 0;
+        const trace = this.watcher.getTrace(req.params.filename, agentId);
         if (!trace) {
           return res.status(404).json({ error: "Trace not found" });
         }
@@ -2560,6 +2575,27 @@ 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) {
@@ -2656,6 +2692,118 @@ var DashboardServer = class {
         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 {
@@ -2759,11 +2907,11 @@ var DashboardServer = class {
           }
         } catch {
         }
-        const watched = [
+        const watched = [...new Set([
           this.config.tracesDir,
           ...this.config.dataDirs || [],
           ...extraDirs
-        ];
+        ].map((w) => path2.resolve(w)))];
         const discovered = [];
         const svcNames = getSystemdServices(this.userConfig);
         if (svcNames.length > 0) {
@@ -2917,6 +3065,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.
@@ -3193,7 +3376,9 @@ if (import_meta.url === `file://${process.argv[1]}`) {
 }
 
 // src/cli.ts
-var VERSION = "0.8.0";
+var import_meta2 = {};
+var __cliDirname = path3.dirname((0, import_node_url2.fileURLToPath)(import_meta2.url));
+var VERSION = JSON.parse(fs3.readFileSync(path3.resolve(__cliDirname, "../package.json"), "utf-8")).version;
 function getLanAddress() {
   const interfaces = os.networkInterfaces();
   for (const name of Object.keys(interfaces)) {
@@ -3233,7 +3418,9 @@ function printBanner(config, traceCount, stats, configPath) {
   \u2192 http://localhost:${port}${isPublic && lan ? `
   \u2192 http://${lan}:${port}  (LAN)` : ""}
 
-  Views:  Agent Profile \xB7 Execution Detail \xB7 Governance
+  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
 

package/dist/cli.js

@@ -1,6 +1,6 @@
 import {
   startDashboard
-} from "./chunk-NZFXRZYU.js";
+} from "./chunk-EG254FLY.js";
 export {
   startDashboard
 };