prism-mcp-server 2.5.1 → 3.0.0

package/README.md

@@ -14,7 +14,7 @@
 
 ## Table of Contents
 
-- [What's New (v2.5.0)](#whats-new-in-v250---enterprise-memory-)
+- [What's New (v3.0.0)](#whats-new-in-v300---agent-hivemind-)
 - [How Prism Compares](#how-prism-compares)
 - [Quick Start](#quick-start-zero-config--local-mode)
 - [Mind Palace Dashboard](#-the-mind-palace-dashboard)
@@ -24,6 +24,7 @@
 - [Tool Reference](#tool-reference)
 - [LangChain / LangGraph Integration](#langchain--langgraph-integration)
 - [Environment Variables](#environment-variables)
+- [Boot Settings (Restart Required)](#-boot-settings-restart-required)
 - [Progressive Context Loading](#progressive-context-loading)
 - [Time Travel](#time-travel-version-history)
 - [Agent Telepathy](#agent-telepathy-multi-client-sync)
@@ -37,7 +38,20 @@
 
 ---
 
-## What's New in v2.5.0 — Enterprise Memory 🏗️
+## What's New in v3.0.0 — Agent Hivemind 🐝
+
+| Feature | Description |
+|---|---|
+| 🐝 **Role-Scoped Memory** | Optional `role` parameter on ledger, handoff, and context loading — each agent role (dev, qa, pm, lead, security, ux) gets its own isolated memory lane within a project. Defaults to `'global'` for full backward compatibility. |
+| 👥 **Agent Registry** | New `agent_register`, `agent_heartbeat`, `agent_list_team` tools — agents announce their presence, pulse their status, and discover who else is working on the team. Stale agents are auto-pruned after 30 minutes. |
+| 🎯 **Team Roster Injection** | When loading context with a role, Prism automatically injects a "Team Roster" showing active teammates, their roles, current tasks, and last heartbeat — true multi-agent awareness without extra tool calls. |
+| ⚙️ **Dashboard Settings** | New Settings modal with runtime toggles (auto-capture, theme, context depth) backed by a persistent `system_settings` key-value store. Environment variables override DB settings for safety. |
+| 📡 **Hivemind Radar** | New dashboard widget showing active agents, their roles (with icons), current tasks, and heartbeat timestamps — a real-time team coordination dashboard. |
+| 🔒 **Conditional Tool Registration** | `PRISM_ENABLE_HIVEMIND` env var gates Hivemind tools — users who don't need multi-agent features keep the same lean tool count as v2.x. |
+| ✅ **Test Suite** | 58 tests across 4 suites (storage, tools, dashboard, load) with Vitest — includes concurrent write stress tests, role isolation verification, and 0.2ms/write performance benchmarks. |
+
+<details>
+<summary><strong>What's in v2.5.0 — Enterprise Memory 🏗️</strong></summary>
 
 | Feature | Description |
 |---|---|
@@ -46,6 +60,8 @@
 | 🔗 **LangChain Integration (Phase 3)** | `PrismMemoryRetriever` and `PrismKnowledgeRetriever` — async-first `BaseRetriever` subclasses that wrap Prism MCP's traced search endpoints. Trace metadata flows automatically into `Document.metadata["trace"]` for LangSmith visibility. |
 | 🧩 **LangGraph Research Agent** | Full example in `examples/langgraph-agent/` — a 5-node agentic research loop with MCP bridge, persistent memory, and `EnsembleRetriever` hybrid search. |
 
+</details>
+
 <details>
 <summary><strong>What's in v2.5.1 — Version Sync & Embedding Safety</strong></summary>
 
@@ -528,7 +544,8 @@ The retrievers use `_aget_relevant_documents` as the primary path with `asyncio.
 | Variable | Required | Description |
 |----------|----------|-------------|
 | `BRAVE_API_KEY` | No | Brave Search Pro API key (enables web/local search tools) |
-| `PRISM_STORAGE` | No | `"local"` (default) or `"supabase"` |
+| `PRISM_STORAGE` | No | `"local"` (default) or `"supabase"` — **requires restart** |
+| `PRISM_ENABLE_HIVEMIND` | No | Set `"true"` to enable multi-agent Hivemind tools — **requires restart** |
 | `GOOGLE_API_KEY` | No | Google AI / Gemini — enables paper analysis, Morning Briefings, compaction |
 | `BRAVE_ANSWERS_API_KEY` | No | Separate Brave Answers key for AI-grounded answers |
 | `SUPABASE_URL` | If cloud mode | Supabase project URL |
@@ -540,6 +557,39 @@ The retrievers use `_aget_relevant_documents` as the primary path with `asyncio.
 
 ---
 
+## ⚡ Boot Settings (Restart Required)
+
+Some settings affect how Prism **initializes at startup** and cannot be changed at runtime. Prism stores these in a lightweight, dedicated SQLite database (`~/.prism-mcp/prism-config.db`) that is read **before** the main storage backend is selected — solving the chicken-and-egg problem of needing config before the config store is ready.
+
+> **⚠️ You must restart the Prism MCP server after changing any Boot Setting.** The Mind Palace dashboard labels these with a **"Restart Required"** badge.
+
+| Setting | Dashboard Control | Environment Override | Description |
+|---------|------------------|---------------------|-------------|
+| `PRISM_STORAGE` | ⚙️ Storage Backend dropdown | `PRISM_STORAGE=supabase` | Switch between `local` (SQLite) and `supabase` (cloud) |
+| `PRISM_ENABLE_HIVEMIND` | ⚙️ Hivemind Mode toggle | `PRISM_ENABLE_HIVEMIND=true` | Enable/disable multi-agent coordination tools |
+
+### How Boot Settings Work
+
+1. **Dashboard saves the setting** → written to `~/.prism-mcp/prism-config.db` immediately
+2. **You restart the MCP server** → server reads the config DB at startup, selects backend/features
+3. **Environment variables always win** → if `PRISM_STORAGE` is set in your MCP config JSON, it overrides the dashboard value
+
+```
+Priority: env var in MCP config JSON  >  Dashboard (prism-config.db)  >  default (local)
+```
+
+### Runtime Settings (no restart needed)
+
+These settings take effect immediately without a restart:
+
+| Setting | Description |
+|---------|-------------|
+| Dashboard Theme | Visual theme for the Mind Palace (`dark`, `midnight`, `purple`) |
+| Context Depth | Default level for `session_load_context` (`quick`, `standard`, `deep`) |
+| Auto-Capture HTML | Snapshot local dev server HTML on every handoff save |
+
+---
+
 ## Progressive Context Loading
 
 Load only what you need — saves tokens and speeds up boot:
@@ -880,6 +930,7 @@ See [`vertex-ai/`](vertex-ai/) for setup and benchmarks.
 │   │   ├── interface.ts                 # StorageBackend abstraction (+ GDPR delete methods)
 │   │   ├── sqlite.ts                    # SQLite local storage (libSQL + F32_BLOB + deleted_at migration)
 │   │   ├── supabase.ts                  # Supabase cloud storage (+ soft/hard delete)
+│   │   ├── configStorage.ts             # Boot config micro-DB (~/.prism-mcp/prism-config.db)
 │   │   └── index.ts                     # Backend factory (auto-selects based on PRISM_STORAGE)
 │   ├── sync/
 │   │   ├── interface.ts                 # SyncBus abstraction (Telepathy)
@@ -928,6 +979,10 @@ See [`vertex-ai/`](vertex-ai/) for setup and benchmarks.
 
 > **[View the full project board →](https://github.com/users/dcostenco/projects/1/views/1)**
 
+### ✅ v3.0 — Agent Hivemind (Shipped!)
+
+See [What's New in v3.0.0](#whats-new-in-v300---agent-hivemind-) above.
+
 ### 🚀 Future Ideas
 
 | Feature | Issue | Description |

package/dist/config.js

@@ -106,6 +106,14 @@ export const PRISM_CAPTURE_PORTS = (process.env.PRISM_CAPTURE_PORTS || "3000,300
 // Optionally enable verbose output (stderr) for Prism initialization,
 // memory indexing, and background tasks.
 export const PRISM_DEBUG_LOGGING = process.env.PRISM_DEBUG_LOGGING === "true";
+// ─── v3.0: Agent Hivemind Feature Flag ───────────────────────
+// When enabled, registers 3 additional MCP tools for multi-agent
+// coordination: agent_register, agent_heartbeat, agent_list_team.
+// The role parameter on existing tools (session_save_ledger, etc.)
+// is always available regardless of this flag — adding a parameter
+// doesn't increase tool count.
+// Set PRISM_ENABLE_HIVEMIND=true to unlock the Agent Registry tools.
+export const PRISM_ENABLE_HIVEMIND = process.env.PRISM_ENABLE_HIVEMIND === "true";
 if (PRISM_AUTO_CAPTURE) {
     // Use console.error instead of debugLog here to prevent circular dependency
     if (PRISM_DEBUG_LOGGING) {

package/dist/dashboard/server.js

@@ -17,54 +17,69 @@
  * ═══════════════════════════════════════════════════════════════════
  */
 import * as http from "http";
-import { execSync } from "child_process";
+import { exec } from "child_process";
 import { getStorage } from "../storage/index.js";
 import { PRISM_USER_ID, SERVER_CONFIG } from "../config.js";
 import { renderDashboardHTML } from "./ui.js";
 const PORT = parseInt(process.env.PRISM_DASHBOARD_PORT || "3000", 10);
+/** Read HTTP request body as string */
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        let data = "";
+        req.on("data", chunk => { data += chunk; });
+        req.on("end", () => resolve(data));
+        req.on("error", reject);
+    });
+}
 /**
  * Kill any existing process holding the dashboard port.
  * This prevents zombie dashboard processes from surviving IDE restarts
  * and serving stale versions of the UI.
+ *
+ * CRITICAL: Uses async exec() instead of execSync() to avoid blocking
+ * the Node.js event loop. Blocking during startup prevents the MCP
+ * stdio transport from responding to the initialize handshake in time,
+ * causing Antigravity to report MCP_SERVER_INIT_ERROR.
  */
-function killPortHolder(port) {
-    try {
-        // lsof returns PIDs listening on the port; -t gives terse (PID-only) output
-        const pids = execSync(`lsof -ti tcp:${port}`, { encoding: "utf-8" })
-            .trim()
-            .split("\n")
-            .filter(Boolean);
-        if (pids.length === 0)
-            return;
-        // Don't kill ourselves
-        const myPid = String(process.pid);
-        const stalePids = pids.filter(p => p !== myPid);
-        if (stalePids.length > 0) {
-            console.error(`[Dashboard] Killing stale process(es) on port ${port}: ${stalePids.join(", ")}`);
-            execSync(`kill ${stalePids.join(" ")}`, { encoding: "utf-8" });
-            // Brief pause to let the OS release the port
-            execSync("sleep 0.3");
-        }
-    }
-    catch (err) {
-        // lsof exits with code 1 when no matches found — that's expected.
-        // Any other failure (lsof missing, permission denied, etc.) gets a warning.
-        const isNoMatch = err instanceof Error &&
-            "status" in err &&
-            err.status === 1;
-        if (!isNoMatch) {
-            console.error(`[Dashboard] killPortHolder: could not check port ${port} (lsof may not be installed) — skipping.`);
-        }
-    }
+async function killPortHolder(port) {
+    return new Promise((resolve) => {
+        exec(`lsof -ti tcp:${port}`, { encoding: "utf-8" }, (err, stdout) => {
+            if (err) {
+                // lsof exits with code 1 when no matches found — that's expected.
+                // Any other failure (lsof missing, permission denied, etc.) gets a warning.
+                const isNoMatch = err.code === 1;
+                if (!isNoMatch) {
+                    console.error(`[Dashboard] killPortHolder: could not check port ${port} (lsof may not be installed) — skipping.`);
+                }
+                return resolve();
+            }
+            const pids = stdout.trim().split("\n").filter(Boolean);
+            if (pids.length === 0)
+                return resolve();
+            // Don't kill ourselves
+            const myPid = String(process.pid);
+            const stalePids = pids.filter(p => p !== myPid);
+            if (stalePids.length > 0) {
+                console.error(`[Dashboard] Killing stale process(es) on port ${port}: ${stalePids.join(", ")}`);
+                exec(`kill ${stalePids.join(" ")}`, () => {
+                    // Brief pause to let the OS release the port
+                    setTimeout(resolve, 300);
+                });
+            }
+            else {
+                resolve();
+            }
+        });
+    });
 }
 export async function startDashboardServer() {
     // Clean up any zombie dashboard process from a previous session
-    killPortHolder(PORT);
+    await killPortHolder(PORT);
     const storage = await getStorage();
     const httpServer = http.createServer(async (req, res) => {
         // CORS headers for local dev
         res.setHeader("Access-Control-Allow-Origin", "*");
-        res.setHeader("Access-Control-Allow-Methods", "GET, OPTIONS");
+        res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
         res.setHeader("Access-Control-Allow-Headers", "Content-Type");
         if (req.method === "OPTIONS") {
             res.writeHead(204);
@@ -193,6 +208,55 @@ export async function startDashboardServer() {
                 res.writeHead(200, { "Content-Type": "application/json" });
                 return res.end(JSON.stringify({ nodes, edges }));
             }
+            // ─── API: Hivemind Team Roster (v3.0) ───
+            if (url.pathname === "/api/team") {
+                const projectName = url.searchParams.get("project");
+                if (!projectName) {
+                    res.writeHead(400, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify({ error: "Missing ?project= parameter" }));
+                }
+                try {
+                    const team = await storage.listTeam(projectName, PRISM_USER_ID);
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify({ team }));
+                }
+                catch {
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify({ team: [] }));
+                }
+            }
+            // ─── API: Settings — GET (v3.0 Dashboard Settings) ───
+            if (url.pathname === "/api/settings" && req.method === "GET") {
+                try {
+                    const { getAllSettings } = await import("../storage/configStorage.js");
+                    const settings = await getAllSettings();
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify({ settings }));
+                }
+                catch {
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify({ settings: {} }));
+                }
+            }
+            // ─── API: Settings — POST (v3.0 Dashboard Settings) ───
+            if (url.pathname === "/api/settings" && req.method === "POST") {
+                try {
+                    const body = await readBody(req);
+                    const parsed = JSON.parse(body);
+                    if (parsed.key && parsed.value !== undefined) {
+                        const { setSetting } = await import("../storage/configStorage.js");
+                        await setSetting(parsed.key, String(parsed.value));
+                        res.writeHead(200, { "Content-Type": "application/json" });
+                        return res.end(JSON.stringify({ ok: true, key: parsed.key, value: parsed.value }));
+                    }
+                    res.writeHead(400, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify({ error: "Missing key or value" }));
+                }
+                catch (err) {
+                    res.writeHead(400, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify({ error: "Invalid JSON body" }));
+                }
+            }
             // ─── 404 ───
             res.writeHead(404, { "Content-Type": "text/plain" });
             res.end("Not found");

package/dist/dashboard/ui.js

@@ -27,7 +27,8 @@ export function renderDashboardHTML(version) {
   <style>
     *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
 
-    :root {
+    /* ─── Theme: Dark (Default) ─── */
+    :root, [data-theme="dark"] {
       --bg-primary: #0a0e1a;
       --bg-secondary: #111827;
       --bg-glass: rgba(17, 24, 39, 0.6);
@@ -49,6 +50,44 @@ export function renderDashboardHTML(version) {
       --font-mono: 'JetBrains Mono', 'Fira Code', monospace;
     }
 
+    /* ─── Theme: Midnight — deeper blacks, blue-shifted accents ─── */
+    [data-theme="midnight"] {
+      --bg-primary: #020617;
+      --bg-secondary: #0f172a;
+      --bg-glass: rgba(2, 6, 23, 0.7);
+      --border-glass: rgba(59, 130, 246, 0.15);
+      --border-glow: rgba(59, 130, 246, 0.35);
+      --text-primary: #e2e8f0;
+      --text-secondary: #94a3b8;
+      --text-muted: #475569;
+      --accent-purple: #818cf8;
+      --accent-blue: #60a5fa;
+      --accent-cyan: #22d3ee;
+      --accent-green: #34d399;
+      --accent-amber: #fbbf24;
+      --accent-rose: #fb7185;
+      --gradient-hero: linear-gradient(135deg, #818cf8 0%, #60a5fa 50%, #22d3ee 100%);
+    }
+
+    /* ─── Theme: Purple Haze — warm violet tones ─── */
+    [data-theme="purple"] {
+      --bg-primary: #0c0515;
+      --bg-secondary: #1a0a2e;
+      --bg-glass: rgba(26, 10, 46, 0.65);
+      --border-glass: rgba(168, 85, 247, 0.2);
+      --border-glow: rgba(168, 85, 247, 0.4);
+      --text-primary: #f5f3ff;
+      --text-secondary: #c4b5fd;
+      --text-muted: #7c3aed;
+      --accent-purple: #a855f7;
+      --accent-blue: #7c3aed;
+      --accent-cyan: #c084fc;
+      --accent-green: #a78bfa;
+      --accent-amber: #e879f9;
+      --accent-rose: #f472b6;
+      --gradient-hero: linear-gradient(135deg, #a855f7 0%, #7c3aed 50%, #c084fc 100%);
+    }
+
     body {
       background: var(--bg-primary);
       color: var(--text-primary);
@@ -270,6 +309,87 @@ export function renderDashboardHTML(version) {
       transition: color 0.2s;
     }
     .refresh-btn:hover { color: var(--accent-purple); }
+
+    /* ─── Settings Modal (v3.0) ─── */
+    .settings-btn {
+      background: none; border: 1px solid var(--border-glass);
+      color: var(--text-secondary); cursor: pointer; font-size: 1.1rem;
+      padding: 0.4rem 0.7rem; border-radius: var(--radius-sm);
+      transition: all 0.2s;
+    }
+    .settings-btn:hover { border-color: var(--border-glow); color: var(--accent-purple); }
+    .modal-overlay {
+      display: none; position: fixed; inset: 0; z-index: 100;
+      background: rgba(0,0,0,0.6); backdrop-filter: blur(4px);
+      justify-content: center; align-items: center;
+    }
+    .modal-overlay.active { display: flex; }
+    .modal {
+      background: var(--bg-secondary); border: 1px solid var(--border-glow);
+      border-radius: var(--radius); padding: 2rem; width: 480px; max-width: 90vw;
+      max-height: 85vh; overflow-y: auto; position: relative;
+    }
+    .modal h2 { font-size: 1.1rem; margin-bottom: 1.5rem; display: flex; align-items: center; gap: 0.5rem; }
+    .modal-close {
+      position: absolute; top: 1rem; right: 1rem; background: none;
+      border: none; color: var(--text-muted); cursor: pointer; font-size: 1.25rem;
+    }
+    .modal-close:hover { color: var(--text-primary); }
+    .setting-row {
+      display: flex; justify-content: space-between; align-items: center;
+      padding: 0.75rem 0; border-bottom: 1px solid rgba(255,255,255,0.05);
+    }
+    .setting-row:last-child { border-bottom: none; }
+    .setting-label { font-size: 0.85rem; color: var(--text-secondary); }
+    .setting-desc { font-size: 0.7rem; color: var(--text-muted); margin-top: 0.2rem; }
+    .toggle {
+      position: relative; width: 44px; height: 24px;
+      background: rgba(100,116,139,0.3); border-radius: 12px;
+      cursor: pointer; transition: background 0.3s; flex-shrink: 0;
+    }
+    .toggle.active { background: var(--accent-purple); }
+    .toggle::after {
+      content: ''; position: absolute; top: 2px; left: 2px;
+      width: 20px; height: 20px; border-radius: 50%;
+      background: white; transition: transform 0.3s;
+    }
+    .toggle.active::after { transform: translateX(20px); }
+    .setting-select {
+      background: var(--bg-primary); border: 1px solid var(--border-glass);
+      color: var(--text-primary); padding: 0.4rem 0.6rem;
+      border-radius: 6px; font-size: 0.8rem; font-family: var(--font-sans);
+    }
+    .setting-section {
+      font-size: 0.7rem; font-weight: 600; text-transform: uppercase;
+      letter-spacing: 0.1em; color: var(--accent-purple); margin: 1rem 0 0.5rem;
+    }
+    .setting-saved {
+      font-size: 0.75rem; color: var(--accent-green); opacity: 0;
+      transition: opacity 0.3s; margin-left: 0.5rem;
+    }
+    .setting-saved.show { opacity: 1; }
+    .boot-badge {
+      font-size: 0.6rem; padding: 0.15rem 0.5rem; border-radius: 4px;
+      background: rgba(245,158,11,0.15); color: var(--accent-amber);
+      font-weight: 600; text-transform: uppercase;
+    }
+
+    /* ─── Hivemind Radar (v3.0) ─── */
+    .team-list { list-style: none; padding: 0; }
+    .team-item {
+      display: flex; align-items: center; gap: 0.75rem;
+      padding: 0.6rem 0; border-bottom: 1px solid rgba(255,255,255,0.05);
+      font-size: 0.85rem;
+    }
+    .team-item:last-child { border-bottom: none; }
+    .team-role { font-weight: 600; color: var(--text-primary); min-width: 60px; }
+    .team-task { color: var(--text-secondary); flex: 1; }
+    .team-heartbeat { font-size: 0.7rem; color: var(--text-muted); font-family: var(--font-mono); }
+    .pulse-dot {
+      width: 8px; height: 8px; border-radius: 50%; background: var(--accent-green);
+      flex-shrink: 0; animation: pulseDot 2s ease-in-out infinite;
+    }
+    @keyframes pulseDot { 0%,100% { opacity: 1; } 50% { opacity: 0.3; } }
   </style>
 </head>
 <body>
@@ -286,6 +406,7 @@ export function renderDashboardHTML(version) {
           <option value="">Loading projects...</option>
         </select>
         <button onclick="loadProject()">Inspect</button>
+        <button class="settings-btn" onclick="openSettings()" title="Settings">⚙️</button>
       </div>
     </header>
 
@@ -367,6 +488,84 @@ export function renderDashboardHTML(version) {
           <div class="card-title"><span class="dot" style="background:var(--accent-amber)"></span> Session Ledger</div>
           <div class="timeline" id="ledgerTimeline"></div>
         </div>
+        </div>
+
+        <!-- Hivemind Radar (v3.0) -->
+        <div class="card" id="hivemindCard" style="display:none">
+          <div class="card-title">
+            <span class="dot" style="background:var(--accent-cyan)"></span>
+            Hivemind Radar 🐝
+            <button onclick="loadTeam()" class="refresh-btn">↻</button>
+          </div>
+          <ul class="team-list" id="teamList">
+            <li style="color:var(--text-muted);font-size:0.85rem;text-align:center;padding:1rem">
+              No active agents. Set PRISM_ENABLE_HIVEMIND=true to enable.
+            </li>
+          </ul>
+        </div>
+      </div>
+    </div>
+
+    <!-- Settings Modal (v3.0) -->
+    <div class="modal-overlay" id="settingsModal">
+      <div class="modal">
+        <button class="modal-close" onclick="closeSettings()">✕</button>
+        <h2>⚙️ Settings</h2>
+
+        <div class="setting-section">Runtime Settings</div>
+
+        <div class="setting-row">
+          <div>
+            <div class="setting-label">Auto-Capture HTML</div>
+            <div class="setting-desc">Capture local dev server UI on handoff save</div>
+          </div>
+          <div class="toggle" id="toggle-auto-capture" onclick="toggleSetting('auto_capture', this)"></div>
+        </div>
+
+        <div class="setting-row">
+          <div>
+            <div class="setting-label">Dashboard Theme</div>
+            <div class="setting-desc">Visual theme for Mind Palace</div>
+          </div>
+          <select class="setting-select" id="select-theme" onchange="saveSetting('dashboard_theme', this.value)">
+            <option value="dark">Dark (Default)</option>
+            <option value="midnight">Midnight</option>
+            <option value="purple">Purple Haze</option>
+          </select>
+        </div>
+
+        <div class="setting-row">
+          <div>
+            <div class="setting-label">Context Depth</div>
+            <div class="setting-desc">Default level for session_load_context</div>
+          </div>
+          <select class="setting-select" id="select-context-depth" onchange="saveSetting('default_context_depth', this.value)">
+            <option value="standard">Standard (~200 tokens)</option>
+            <option value="quick">Quick (~50 tokens)</option>
+            <option value="deep">Deep (~1000+ tokens)</option>
+          </select>
+        </div>
+
+        <div class="setting-section">Boot Settings <span class="boot-badge">Restart Required</span></div>
+
+        <div class="setting-row">
+          <div>
+            <div class="setting-label">Hivemind Mode</div>
+            <div class="setting-desc">Multi-agent coordination (PRISM_ENABLE_HIVEMIND)</div>
+          </div>
+          <div class="toggle" id="toggle-hivemind" onclick="toggleBootSetting('hivemind_enabled', this)"></div>
+        </div>
+        <div class="setting-row">
+          <div>
+            <div class="setting-label">Storage Backend</div>
+            <div class="setting-desc">Switch between SQLite and Supabase</div>
+          </div>
+          <select id="storageBackendSelect" onchange="window.saveBootSetting('PRISM_STORAGE', this.value)" style="padding: 0.2rem 0.4rem; background: var(--bg-hover); color: var(--text-primary); border: 1px solid var(--border-color); border-radius: 4px; font-size: 0.85rem; font-family: var(--font-mono); cursor: pointer;">
+            <option value="local">SQLite</option>
+            <option value="supabase">Supabase</option>
+          </select>
+        </div>
+        <span class="setting-saved" id="savedToast">Saved ✓</span>
       </div>
     </div>
   </div>
@@ -528,6 +727,7 @@ export function renderDashboardHTML(version) {
 
         document.getElementById('content').className = 'grid grid-main fade-in';
         document.getElementById('content').style.display = 'grid';
+        loadTeam(); // v3.0: auto-load Hivemind team
       } catch(e) {
         alert('Failed to load project data: ' + e.message);
       } finally {
@@ -618,6 +818,127 @@ export function renderDashboardHTML(version) {
 
     // Initialize the graph on page load
     loadGraph();
+
+    // ─── Settings Modal (v3.0) ───
+    function openSettings() {
+      document.getElementById('settingsModal').classList.add('active');
+      loadSettings();
+    }
+    function closeSettings() {
+      document.getElementById('settingsModal').classList.remove('active');
+    }
+    // Close on overlay click
+    document.getElementById('settingsModal').addEventListener('click', function(e) {
+      if (e.target === this) closeSettings();
+    });
+
+      async function loadSettings() {
+      try {
+        var res = await fetch('/api/settings');
+        var data = await res.json();
+        var s = data.settings || {};
+        // Runtime toggles
+        if (s.auto_capture === 'true') document.getElementById('toggle-auto-capture').classList.add('active');
+        else document.getElementById('toggle-auto-capture').classList.remove('active');
+        // Context depth
+        if (s.default_context_depth) document.getElementById('select-context-depth').value = s.default_context_depth;
+        // Theme
+        if (s.dashboard_theme) {
+          document.getElementById('select-theme').value = s.dashboard_theme;
+          applyTheme(s.dashboard_theme);
+        }
+        // Boot toggles
+        if (s.hivemind_enabled === 'true') document.getElementById('toggle-hivemind').classList.add('active');
+        else document.getElementById('toggle-hivemind').classList.remove('active');
+        
+        // Storage Backend
+        if (s.PRISM_STORAGE) {
+          document.getElementById('storageBackendSelect').value = s.PRISM_STORAGE;
+        }
+      } catch(e) { console.warn('Settings load failed:', e); }
+    }
+
+    function toggleSetting(key, el) {
+      var isActive = el.classList.toggle('active');
+      saveSetting(key, isActive ? 'true' : 'false');
+    }
+    function toggleBootSetting(key, el) {
+      var isActive = el.classList.toggle('active');
+      saveSetting(key, isActive ? 'true' : 'false');
+      showToast('Saved. Restart your AI client for this to take effect.');
+    }
+    function saveBootSetting(key, value) {
+      saveSetting(key, value);
+      showToast('Saved. Restart your AI client for this to take effect.');
+    }
+
+    async function saveSetting(key, value) {
+      try {
+        await fetch('/api/settings', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({ key: key, value: value })
+        });
+        // Apply theme instantly on change
+        if (key === 'dashboard_theme') applyTheme(value);
+        showToast('Saved ✓');
+      } catch(e) { console.error('Setting save failed:', e); }
+    }
+
+    /**
+     * applyTheme — sets the data-theme attribute on <html>
+     * CSS custom properties in [data-theme="..."] blocks
+     * override :root defaults instantly, no page reload needed.
+     */
+    function applyTheme(theme) {
+      document.documentElement.setAttribute('data-theme', theme || 'dark');
+    }
+
+    function showToast(msg) {
+      var toast = document.getElementById('savedToast');
+      toast.textContent = msg || 'Saved ✓';
+      toast.classList.add('show');
+      setTimeout(function() { toast.classList.remove('show'); }, 2000);
+    }
+
+    // ─── Hivemind Radar (v3.0) ───
+    async function loadTeam() {
+      var project = document.getElementById('projectSelect').value;
+      if (!project) return;
+      var card = document.getElementById('hivemindCard');
+      try {
+        var res = await fetch('/api/team?project=' + encodeURIComponent(project));
+        var data = await res.json();
+        var team = data.team || [];
+        var list = document.getElementById('teamList');
+        if (team.length > 0) {
+          var roleIcons = {dev:'🛠️',qa:'🔍',pm:'📋',lead:'🏗️',security:'🔒',ux:'🎨',cmo:'📢'};
+          list.innerHTML = team.map(function(a) {
+            var icon = roleIcons[a.role] || '🤖';
+            var ago = a.last_heartbeat ? timeAgo(a.last_heartbeat) : '?';
+            return '<li class="team-item">' +
+              '<span class="pulse-dot"></span>' +
+              '<span class="team-role">' + icon + ' ' + escapeHtml(a.role) + '</span>' +
+              '<span class="team-task">' + escapeHtml(a.current_task || 'idle') + '</span>' +
+              '<span class="team-heartbeat">' + ago + '</span></li>';
+          }).join('');
+          card.style.display = 'block';
+        } else {
+          list.innerHTML = '<li style="color:var(--text-muted);font-size:0.85rem;text-align:center;padding:1rem">No active agents on this project.</li>';
+          card.style.display = 'block';
+        }
+      } catch(e) {
+        console.warn('Team load failed:', e);
+      }
+    }
+
+    function timeAgo(iso) {
+      var diff = Date.now() - new Date(iso).getTime();
+      var mins = Math.floor(diff / 60000);
+      if (mins < 1) return 'just now';
+      if (mins < 60) return mins + 'm ago';
+      return Math.floor(mins/60) + 'h ago';
+    }
   </script>
 </body>
 </html>`;