prism-mcp-server 3.0.1 → 3.1.0

package/README.md

@@ -14,7 +14,7 @@
 
 ## Table of Contents
 
-- [What's New (v3.0.1)](#whats-new-in-v301---agent-identity--brain-clean-up-)
+- [What's New (v3.1.0)](#whats-new-in-v310---memory-lifecycle-)
 - [How Prism Compares](#how-prism-compares)
 - [Quick Start](#quick-start-zero-config--local-mode)
 - [Mind Palace Dashboard](#-the-mind-palace-dashboard)
@@ -39,7 +39,18 @@
 
 ---
 
-## What's New in v3.0.1 — Agent Identity & Brain Clean-up 🧹
+## What's New in v3.1.0 — Memory Lifecycle 🔄
+
+| Feature | Description |
+|---|---|
+| 📊 **Memory Analytics** | New **Memory Analytics** card in the dashboard — 14-day sparkline chart, active sessions count, rollup savings, and average context richness. Powered by `getAnalytics()` on both SQLite and Supabase backends. |
+| ⏳ **Automated Data Retention (TTL)** | Set a per-project data retention policy via `knowledge_set_retention` MCP tool or the dashboard **Lifecycle Controls** card. Entries older than the TTL are soft-deleted (GDPR-compliant `archived_at` tombstone) every 12 hours automatically. Rollups are never expired. Minimum 7 days to prevent accidental mass-delete. |
+| 🗜️ **Smart Auto-Compaction** | After every `session_save_ledger`, Prism runs a background health check and triggers compaction automatically if the brain is degraded or unhealthy — gated by `compaction_auto` setting and debounced per-project to prevent concurrent Gemini calls. **Compact Now** button also available in the dashboard. |
+| 📦 **PKM Export (Obsidian / Logseq)** | Export any project's full memory as a ZIP archive of Markdown files — one file per session with YAML-like frontmatter, TODOs, decisions, files-changed, and `#hashtag` keywords. Includes an `_index.md` with `[[wikilink]]` references. Click **Export ZIP** in the dashboard Lifecycle Controls card. |
+| 🧪 **Expanded Test Suite** | 37 new Vitest tests (95 total) — covers analytics queries, TTL soft-delete idempotency, rollup preservation, `activeCompactions` Set memory-leak prevention, type guards, export Markdown structure, and TTL sweep scheduler contracts. |
+
+<details>
+<summary><strong>What's in v3.0.1 — Agent Identity & Brain Clean-up 🧹</strong></summary>
 
 | Feature | Description |
 |---|---|
@@ -48,6 +59,8 @@
 | 📜 **Role-Scoped Skills** | Each agent role can have its own persistent skill/rules document stored in the dashboard (⚙️ Settings → Skills). It is automatically injected into every `session_load_context` response so the agent boots with its rules pre-loaded. |
 | 🔤 **Resource Formatting Fix** | `memory://{project}/handoff` resources now render as formatted plain text (Last Summary, TODOs, Keywords) instead of a raw JSON blob — readable in Claude Desktop's paperclip attach panel. |
 
+</details>
+
 <details>
 <summary><strong>What's in v3.0.0 — Agent Hivemind 🐝</strong></summary>
 
@@ -468,6 +481,12 @@ graph TB
 | `session_search_memory` | Vector similarity search across all sessions |
 | `session_compact_ledger` | Auto-compact old ledger entries via Gemini-powered summarization |
 
+### v3.1 Lifecycle Tools
+
+| Tool | Purpose |
+|------|---------|
+| `knowledge_set_retention` | Set a per-project TTL retention policy (0 = disabled, min 7 days). Immediately expires overdue entries. |
+
 ### v2.0 Advanced Memory Tools
 
 | Tool | Purpose |

package/dist/dashboard/server.js

@@ -21,7 +21,8 @@ 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";
-import { getAllSettings, setSetting } from "../storage/configStorage.js";
+import { getAllSettings, setSetting, getSetting } from "../storage/configStorage.js";
+import { compactLedgerHandler } from "../tools/compactionHandler.js";
 const PORT = parseInt(process.env.PRISM_DASHBOARD_PORT || "3000", 10);
 /** Read HTTP request body as string */
 function readBody(req) {
@@ -74,9 +75,24 @@ async function killPortHolder(port) {
     });
 }
 export async function startDashboardServer() {
-    // Clean up any zombie dashboard process from a previous session
-    await killPortHolder(PORT);
-    const storage = await getStorage();
+    // Fire-and-forget port cleanup — don't block server start.
+    // Previously awaiting this added 300ms+ delay from lsof + setTimeout,
+    // starving the MCP stdio transport during the init handshake.
+    killPortHolder(PORT).catch(() => { });
+    // Lazy storage accessor — returns null if storage isn't ready yet.
+    // API routes gracefully degrade with 503 instead of blocking startup.
+    let _storage = null;
+    const getStorageSafe = async () => {
+        if (_storage)
+            return _storage;
+        try {
+            _storage = await getStorage();
+            return _storage;
+        }
+        catch {
+            return null;
+        }
+    };
     const httpServer = http.createServer(async (req, res) => {
         // CORS headers for local dev
         res.setHeader("Access-Control-Allow-Origin", "*");
@@ -98,7 +114,12 @@ export async function startDashboardServer() {
             }
             // ─── API: List all projects ───
             if (url.pathname === "/api/projects") {
-                const projects = await storage.listProjects();
+                const s = await getStorageSafe();
+                if (!s) {
+                    res.writeHead(503, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify({ error: "Storage initializing..." }));
+                }
+                const projects = await s.listProjects();
                 res.writeHead(200, { "Content-Type": "application/json" });
                 return res.end(JSON.stringify({ projects }));
             }
@@ -109,15 +130,20 @@ export async function startDashboardServer() {
                     res.writeHead(400, { "Content-Type": "application/json" });
                     return res.end(JSON.stringify({ error: "Missing ?name= parameter" }));
                 }
-                const context = await storage.loadContext(projectName, "deep", PRISM_USER_ID);
-                const ledger = await storage.getLedgerEntries({
+                const s = await getStorageSafe();
+                if (!s) {
+                    res.writeHead(503, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify({ error: "Storage initializing..." }));
+                }
+                const context = await s.loadContext(projectName, "deep", PRISM_USER_ID);
+                const ledger = await s.getLedgerEntries({
                     project: `eq.${projectName}`,
                     order: "created_at.desc",
                     limit: "20",
                 });
                 let history = [];
                 try {
-                    history = await storage.getHistory(projectName, PRISM_USER_ID, 10);
+                    history = await s.getHistory(projectName, PRISM_USER_ID, 10);
                 }
                 catch {
                     // History may not exist for all projects
@@ -129,7 +155,12 @@ export async function startDashboardServer() {
             if (url.pathname === "/api/health" && req.method === "GET") {
                 try {
                     const { runHealthCheck } = await import("../utils/healthCheck.js");
-                    const stats = await storage.getHealthStats(PRISM_USER_ID);
+                    const s = await getStorageSafe();
+                    if (!s) {
+                        res.writeHead(503, { "Content-Type": "application/json" });
+                        return res.end(JSON.stringify({ error: "Storage initializing..." }));
+                    }
+                    const stats = await s.getHealthStats(PRISM_USER_ID);
                     const report = runHealthCheck(stats);
                     res.writeHead(200, { "Content-Type": "application/json" });
                     return res.end(JSON.stringify(report));
@@ -152,14 +183,19 @@ export async function startDashboardServer() {
             if (url.pathname === "/api/health/cleanup" && req.method === "POST") {
                 try {
                     const { runHealthCheck } = await import("../utils/healthCheck.js");
-                    const stats = await storage.getHealthStats(PRISM_USER_ID);
+                    const s = await getStorageSafe();
+                    if (!s) {
+                        res.writeHead(503, { "Content-Type": "application/json" });
+                        return res.end(JSON.stringify({ error: "Storage initializing..." }));
+                    }
+                    const stats = await s.getHealthStats(PRISM_USER_ID);
                     const report = runHealthCheck(stats);
                     // Collect orphaned handoff projects from the health issues
                     const orphaned = stats.orphanedHandoffs || [];
                     const cleaned = [];
                     for (const { project } of orphaned) {
                         try {
-                            await storage.deleteHandoff(project, PRISM_USER_ID);
+                            await s.deleteHandoff(project, PRISM_USER_ID);
                             cleaned.push(project);
                             console.error(`[Dashboard] Cleaned up orphaned handoff: ${project}`);
                         }
@@ -223,7 +259,12 @@ export async function startDashboardServer() {
             if (url.pathname === "/api/graph") {
                 // Fetch recent ledger entries to build the graph
                 // We look at the last 100 entries to keep the graph relevant but performant
-                const entries = await storage.getLedgerEntries({
+                const s = await getStorageSafe();
+                if (!s) {
+                    res.writeHead(503, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify({ error: "Storage initializing..." }));
+                }
+                const entries = await s.getLedgerEntries({
                     limit: "100",
                     order: "created_at.desc",
                     select: "project,keywords",
@@ -289,7 +330,12 @@ export async function startDashboardServer() {
                     return res.end(JSON.stringify({ error: "Missing ?project= parameter" }));
                 }
                 try {
-                    const team = await storage.listTeam(projectName, PRISM_USER_ID);
+                    const s = await getStorageSafe();
+                    if (!s) {
+                        res.writeHead(503, { "Content-Type": "application/json" });
+                        return res.end(JSON.stringify({ error: "Storage initializing..." }));
+                    }
+                    const team = await s.listTeam(projectName, PRISM_USER_ID);
                     res.writeHead(200, { "Content-Type": "application/json" });
                     return res.end(JSON.stringify({ team }));
                 }
@@ -330,6 +376,167 @@ export async function startDashboardServer() {
                     return res.end(JSON.stringify({ error: "Invalid JSON body" }));
                 }
             }
+            // ─── API: Memory Analytics (v3.1) ────────────────────
+            if (url.pathname === "/api/analytics" && req.method === "GET") {
+                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 s = await getStorageSafe();
+                    if (!s) {
+                        res.writeHead(503, { "Content-Type": "application/json" });
+                        return res.end(JSON.stringify({ error: "Storage initializing..." }));
+                    }
+                    const analytics = await s.getAnalytics(projectName, PRISM_USER_ID);
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify(analytics));
+                }
+                catch (err) {
+                    console.error("[Dashboard] Analytics error:", err);
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify({
+                        totalEntries: 0, totalRollups: 0, rollupSavings: 0,
+                        avgSummaryLength: 0, sessionsByDay: [],
+                    }));
+                }
+            }
+            // ─── API: Retention (TTL) Settings (v3.1) ──────────────
+            // GET /api/retention?project= → current TTL setting
+            // POST /api/retention → { project, ttl_days } → saves + runs sweep
+            if (url.pathname === "/api/retention") {
+                if (req.method === "GET") {
+                    const projectName = url.searchParams.get("project");
+                    if (!projectName) {
+                        res.writeHead(400, { "Content-Type": "application/json" });
+                        return res.end(JSON.stringify({ error: "Missing ?project= parameter" }));
+                    }
+                    const ttlRaw = await getSetting(`ttl:${projectName}`, "0");
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify({ project: projectName, ttl_days: parseInt(ttlRaw, 10) || 0 }));
+                }
+                if (req.method === "POST") {
+                    const body = await readBody(req);
+                    const { project, ttl_days } = JSON.parse(body || "{}");
+                    if (!project || ttl_days === undefined) {
+                        res.writeHead(400, { "Content-Type": "application/json" });
+                        return res.end(JSON.stringify({ error: "project and ttl_days required" }));
+                    }
+                    if (ttl_days > 0 && ttl_days < 7) {
+                        res.writeHead(400, { "Content-Type": "application/json" });
+                        return res.end(JSON.stringify({ error: "Minimum TTL is 7 days" }));
+                    }
+                    await setSetting(`ttl:${project}`, String(ttl_days));
+                    let expired = 0;
+                    if (ttl_days > 0) {
+                        const s = await getStorageSafe();
+                        if (!s) {
+                            res.writeHead(503, { "Content-Type": "application/json" });
+                            return res.end(JSON.stringify({ error: "Storage initializing..." }));
+                        }
+                        const result = await s.expireByTTL(project, ttl_days, PRISM_USER_ID);
+                        expired = result.expired;
+                    }
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify({ ok: true, project, ttl_days, expired }));
+                }
+            }
+            // ─── API: Compact Now (v3.1 — Dashboard button) ──────────
+            if (url.pathname === "/api/compact" && req.method === "POST") {
+                const body = await readBody(req);
+                const { project } = JSON.parse(body || "{}");
+                if (!project) {
+                    res.writeHead(400, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify({ error: "project required" }));
+                }
+                try {
+                    const result = await compactLedgerHandler({ project });
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify({ ok: true, result }));
+                }
+                catch (err) {
+                    console.error("[Dashboard] Compact error:", err);
+                    res.writeHead(500, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify({ ok: false, error: "Compaction failed" }));
+                }
+            }
+            // ─── API: PKM Export — Obsidian/Logseq ZIP (v3.1) ──────
+            if (url.pathname === "/api/export" && req.method === "GET") {
+                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 {
+                    // Lazy-import fflate to keep startup fast
+                    const { strToU8, zipSync } = await import("fflate");
+                    // Fetch all active ledger entries for this project
+                    const s = await getStorageSafe();
+                    if (!s) {
+                        res.writeHead(503, { "Content-Type": "application/json" });
+                        return res.end(JSON.stringify({ error: "Storage initializing..." }));
+                    }
+                    const entries = await s.getLedgerEntries({
+                        project: `eq.${projectName}`,
+                        order: "created_at.asc",
+                        limit: "1000",
+                    });
+                    const files = {};
+                    // One MD file per session
+                    for (const entry of entries) {
+                        const date = entry.created_at?.slice(0, 10) ?? "unknown";
+                        const id = entry.id?.slice(0, 8) ?? "xxxxxxxx";
+                        const filename = `${projectName}/${date}-${id}.md`;
+                        const todos = Array.isArray(entry.todos) ? entry.todos : [];
+                        const decisions = Array.isArray(entry.decisions) ? entry.decisions : [];
+                        const files_changed = Array.isArray(entry.files_changed) ? entry.files_changed : [];
+                        const tags = (Array.isArray(entry.keywords) ? entry.keywords : []).slice(0, 10);
+                        const content = [
+                            `# Session: ${date}`,
+                            ``,
+                            `**Project:** ${projectName}`,
+                            `**Date:** ${date}`,
+                            `**Role:** ${entry.role || "global"}`,
+                            tags.length ? `**Tags:** ${tags.map(t => `#${t.replace(/\s+/g, "_")}`).join(" ")}` : "",
+                            ``,
+                            `## Summary`,
+                            ``,
+                            entry.summary,
+                            ``,
+                            todos.length ? `## TODOs\n\n${todos.map(t => `- [ ] ${t}`).join("\n")}` : "",
+                            decisions.length ? `## Decisions\n\n${decisions.map(d => `- ${d}`).join("\n")}` : "",
+                            files_changed.length ? `## Files Changed\n\n${files_changed.map(f => `- \`${f}\``).join("\n")}` : "",
+                        ].filter(Boolean).join("\n");
+                        files[filename] = strToU8(content);
+                    }
+                    // Index file linking all sessions
+                    const indexLines = [
+                        `# ${projectName} — Session Index`,
+                        ``,
+                        `> Exported from Prism MCP on ${new Date().toISOString().slice(0, 10)}`,
+                        ``,
+                        ...entries.map(e => {
+                            const d = e.created_at?.slice(0, 10) ?? "unknown";
+                            const i = e.id?.slice(0, 8) ?? "xxxxxxxx";
+                            return `- [[${projectName}/${d}-${i}]]`;
+                        }),
+                    ];
+                    files[`${projectName}/_index.md`] = strToU8(indexLines.join("\n"));
+                    const zipped = zipSync(files, { level: 6 });
+                    res.writeHead(200, {
+                        "Content-Type": "application/zip",
+                        "Content-Disposition": `attachment; filename="prism-export-${projectName}-${Date.now()}.zip"`,
+                        "Content-Length": String(zipped.byteLength),
+                    });
+                    return res.end(Buffer.from(zipped));
+                }
+                catch (err) {
+                    console.error("[Dashboard] PKM export error:", err);
+                    res.writeHead(500, { "Content-Type": "application/json" });
+                    return res.end(JSON.stringify({ error: "Export failed" }));
+                }
+            }
             // ─── 404 ───
             res.writeHead(404, { "Content-Type": "text/plain" });
             res.end("Not found");
@@ -353,4 +560,31 @@ export async function startDashboardServer() {
     httpServer.listen(PORT, () => {
         console.error(`[Prism] 🧠 Mind Palace Dashboard → http://localhost:${PORT}`);
     });
+    // ─── v3.1: TTL Sweep — runs at startup + every 12 hours ───────────
+    async function runTtlSweep() {
+        try {
+            const allSettings = await getAllSettings();
+            for (const [key, val] of Object.entries(allSettings)) {
+                if (!key.startsWith("ttl:"))
+                    continue;
+                const project = key.replace("ttl:", "");
+                const ttlDays = parseInt(val, 10);
+                if (!ttlDays || ttlDays <= 0)
+                    continue;
+                const s = await getStorageSafe();
+                if (!s)
+                    continue;
+                const result = await s.expireByTTL(project, ttlDays, PRISM_USER_ID);
+                if (result.expired > 0) {
+                    console.error(`[Dashboard] TTL sweep: expired ${result.expired} entries for "${project}" (ttl=${ttlDays}d)`);
+                }
+            }
+        }
+        catch (err) {
+            console.error("[Dashboard] TTL sweep error (non-fatal):", err);
+        }
+    }
+    // Run immediately on startup, then every 12 hours
+    runTtlSweep().catch(() => { });
+    setInterval(() => { runTtlSweep().catch(() => { }); }, 12 * 60 * 60 * 1000);
 }

package/dist/dashboard/ui.js

@@ -444,6 +444,54 @@ export function renderDashboardHTML(version) {
       flex-shrink: 0; animation: pulseDot 2s ease-in-out infinite;
     }
     @keyframes pulseDot { 0%,100% { opacity: 1; } 50% { opacity: 0.3; } }
+
+    /* ─── Memory Analytics (v3.1) ─── */
+    .sparkline {
+      display: flex; align-items: flex-end; gap: 3px;
+      height: 48px; margin: 0.75rem 0 0.25rem;
+    }
+    .spark-bar {
+      flex: 1; background: rgba(139,92,246,0.35);
+      border-radius: 3px 3px 0 0; min-height: 3px;
+      transition: background 0.2s;
+    }
+    .spark-bar:hover { background: var(--accent-purple); }
+    .analytics-stats {
+      display: grid; grid-template-columns: 1fr 1fr; gap: 0.5rem;
+      margin-top: 0.75rem;
+    }
+    .astat {
+      background: rgba(15,23,42,0.5); border-radius: var(--radius-sm);
+      padding: 0.6rem 0.75rem; display: flex; flex-direction: column; gap: 0.15rem;
+    }
+    .astat-val { font-size: 1.1rem; font-weight: 700; color: var(--accent-purple); font-family: var(--font-mono); }
+    .astat-label { font-size: 0.7rem; color: var(--text-muted); text-transform: uppercase; letter-spacing: 0.05em; }
+
+    /* ─── Lifecycle Controls (v3.1) ─── */
+    .lc-row { display: flex; gap: 0.5rem; margin-bottom: 0.5rem; align-items: center; }
+    .lc-btn {
+      flex: 1; padding: 0.5rem 0.6rem; font-size: 0.8rem; font-weight: 600;
+      border-radius: var(--radius-sm); border: none; cursor: pointer;
+      transition: all 0.2s; display: flex; align-items: center; justify-content: center; gap: 0.4rem;
+    }
+    .lc-btn.compact { background: rgba(139,92,246,0.15); color: var(--accent-purple); border: 1px solid rgba(139,92,246,0.3); }
+    .lc-btn.compact:hover { background: rgba(139,92,246,0.3); }
+    .lc-btn.export { background: rgba(16,185,129,0.12); color: var(--accent-green); border: 1px solid rgba(16,185,129,0.3); }
+    .lc-btn.export:hover { background: rgba(16,185,129,0.25); }
+    .lc-btn:disabled { opacity: 0.5; cursor: not-allowed; }
+    .ttl-row { display: flex; align-items: center; gap: 0.5rem; margin-top: 0.5rem; }
+    .ttl-input {
+      width: 70px; background: var(--bg-secondary); border: 1px solid var(--border-glass);
+      color: var(--text-primary); border-radius: 6px; padding: 0.3rem 0.5rem;
+      font-size: 0.82rem; font-family: var(--font-mono); text-align: center;
+    }
+    .ttl-label { font-size: 0.8rem; color: var(--text-secondary); }
+    .ttl-save-btn {
+      margin-left: auto; padding: 0.3rem 0.75rem; font-size: 0.78rem; font-weight: 600;
+      background: rgba(245,158,11,0.15); color: var(--accent-amber);
+      border: 1px solid rgba(245,158,11,0.3); border-radius: 6px; cursor: pointer; transition: all 0.2s;
+    }
+    .ttl-save-btn:hover { background: rgba(245,158,11,0.3); }
   </style>
 </head>
 <body>
@@ -509,7 +557,42 @@ export function renderDashboardHTML(version) {
           <div class="health-issues" id="healthIssues"></div>
         </div>
 
-        <!-- Morning Briefing -->
+        <!-- Memory Analytics (v3.1) -->
+        <div class="card" id="analyticsCard" style="display:none">
+          <div class="card-title">
+            <span class="dot" style="background:var(--accent-purple)"></span>
+            Memory Analytics 📊
+          </div>
+          <div class="sparkline" id="sparkline" title="Sessions per day (last 14 days)"></div>
+          <div style="font-size:0.68rem;color:var(--text-muted);text-align:right">Sessions / day (14d)</div>
+          <div class="analytics-stats">
+            <div class="astat"><div class="astat-val" id="astat-entries">—</div><div class="astat-label">Active sessions</div></div>
+            <div class="astat"><div class="astat-val" id="astat-rollups">—</div><div class="astat-label">Rollups</div></div>
+            <div class="astat"><div class="astat-val" id="astat-savings">—</div><div class="astat-label">Entries saved</div></div>
+            <div class="astat"><div class="astat-val" id="astat-avglen">—</div><div class="astat-label">Avg summary chars</div></div>
+          </div>
+        </div>
+
+        <!-- Lifecycle Controls (v3.1) -->
+        <div class="card" id="lifecycleCard" style="display:none">
+          <div class="card-title"><span class="dot" style="background:var(--accent-amber)"></span> Lifecycle Controls ⚙️</div>
+          <div class="lc-row">
+            <button class="lc-btn compact" id="compactBtn" onclick="compactNow()">
+              🗜️ Compact Now
+            </button>
+            <button class="lc-btn export" id="exportBtn" onclick="exportPKM()">
+              📦 Export ZIP
+            </button>
+          </div>
+          <div class="ttl-row">
+            <span class="ttl-label">Auto-expire after</span>
+            <input type="number" class="ttl-input" id="ttlInput" min="0" max="3650" placeholder="0" title="Days. 0 = disabled">
+            <span class="ttl-label">days</span>
+            <button class="ttl-save-btn" onclick="saveTTL()">Save TTL</button>
+          </div>
+          <div style="font-size:0.7rem;color:var(--text-muted);margin-top:0.4rem">0 = disabled. Min 7 days. Rollups are never expired.</div>
+        </div>
+
         <div class="card" id="briefingCard" style="display:none">
           <div class="card-title"><span class="dot" style="background:var(--accent-amber)"></span> Morning Briefing 🌅</div>
           <div class="briefing-text" id="briefingText"></div>
@@ -894,6 +977,13 @@ Example:\n## Dev Rules\n- Always write tests first\n- Use TypeScript strict mode
 
         document.getElementById('content').className = 'grid grid-main fade-in';
         document.getElementById('content').style.display = 'grid';
+
+        // v3.1: Analytics + Lifecycle Controls
+        document.getElementById('analyticsCard').style.display = 'block';
+        document.getElementById('lifecycleCard').style.display = 'block';
+        loadAnalytics(project);
+        loadRetention(project);
+
         loadTeam(); // v3.0: auto-load Hivemind team
       } catch(e) {
         alert('Failed to load project data: ' + e.message);
@@ -902,6 +992,126 @@ Example:\n## Dev Rules\n- Always write tests first\n- Use TypeScript strict mode
       }
     }
 
+    // ─── v3.1: Memory Analytics ───────────────────────────────────────────────
+    async function loadAnalytics(project) {
+      try {
+        var res = await fetch('/api/analytics?project=' + encodeURIComponent(project));
+        var d = await res.json();
+
+        document.getElementById('astat-entries').textContent = (d.totalEntries || 0);
+        document.getElementById('astat-rollups').textContent = (d.totalRollups || 0);
+        document.getElementById('astat-savings').textContent = (d.rollupSavings || 0);
+        document.getElementById('astat-avglen').textContent = Math.round(d.avgSummaryLength || 0);
+
+        // Sparkline
+        var sparkEl = document.getElementById('sparkline');
+        var days = d.sessionsByDay || [];
+        if (days.length === 0) {
+          // Pad with 14 zero days
+          days = Array.from({length:14}, function(_, i) {
+            var dt = new Date(); dt.setDate(dt.getDate() - (13 - i));
+            return { date: dt.toISOString().slice(0,10), count: 0 };
+          });
+        }
+        var maxCount = Math.max.apply(null, days.map(function(x){return x.count || 0;})) || 1;
+        sparkEl.innerHTML = days.slice(-14).map(function(d) {
+          var pct = Math.max(4, Math.round(((d.count || 0) / maxCount) * 100));
+          return '<div class="spark-bar" style="height:' + pct + '%" title="' + d.date + ': ' + d.count + '"></div>';
+        }).join('');
+      } catch(e) {
+        console.warn('Analytics load failed:', e);
+      }
+    }
+
+    // ─── v3.1: TTL Retention ───────────────────────────────────────────────
+    async function loadRetention(project) {
+      try {
+        var res = await fetch('/api/retention?project=' + encodeURIComponent(project));
+        var d = await res.json();
+        var inp = document.getElementById('ttlInput');
+        if (inp) inp.value = d.ttl_days || 0;
+      } catch(e) {}
+    }
+
+    async function saveTTL() {
+      var project = document.getElementById('projectSelect').value;
+      if (!project) return;
+      var days = parseInt(document.getElementById('ttlInput').value, 10) || 0;
+      try {
+        var res = await fetch('/api/retention', {
+          method: 'POST',
+          headers: {'Content-Type':'application/json'},
+          body: JSON.stringify({ project, ttl_days: days })
+        });
+        var d = await res.json();
+        if (d.ok) {
+          showToast(days > 0 ? '✓ TTL saved: ' + days + 'd (expired ' + (d.expired || 0) + ')' : '✓ TTL disabled');
+        } else {
+          showToast('❌ ' + (d.error || 'Save failed'), true);
+        }
+      } catch(e) { showToast('❌ Cannot save TTL', true); }
+    }
+
+    // ─── v3.1: Compact Now ───────────────────────────────────────────────
+    async function compactNow() {
+      var project = document.getElementById('projectSelect').value;
+      if (!project) return;
+      var btn = document.getElementById('compactBtn');
+      btn.disabled = true;
+      btn.textContent = '🗜️ Compacting...';
+      try {
+        var res = await fetch('/api/compact', {
+          method: 'POST',
+          headers: {'Content-Type':'application/json'},
+          body: JSON.stringify({ project })
+        });
+        var d = await res.json();
+        if (d.ok) {
+          showToast('✓ Compaction done');
+          loadAnalytics(project); // refresh stats
+        } else {
+          showToast('❌ Compaction failed', true);
+        }
+      } catch(e) { showToast('❌ ' + e.message, true); }
+      finally {
+        btn.disabled = false;
+        btn.textContent = '🗜️ Compact Now';
+      }
+    }
+
+    // ─── v3.1: PKM Export (Obsidian / Logseq ZIP) ───────────────────────
+    async function exportPKM() {
+      var project = document.getElementById('projectSelect').value;
+      if (!project) return;
+      var btn = document.getElementById('exportBtn');
+      btn.disabled = true;
+      btn.textContent = '📦 Exporting...';
+      try {
+        var a = document.createElement('a');
+        a.href = '/api/export?project=' + encodeURIComponent(project);
+        a.download = 'prism-export-' + project + '.zip';
+        document.body.appendChild(a);
+        a.click();
+        document.body.removeChild(a);
+        showToast('↓ Download started');
+      } catch(e) { showToast('❌ Export failed', true); }
+      finally {
+        btn.disabled = false;
+        btn.textContent = '📦 Export ZIP';
+      }
+    }
+
+    function showToast(msg, isErr) {
+      var el = document.getElementById('fixedToast');
+      if (!el) return;
+      el.textContent = msg;
+      el.style.borderColor = isErr ? 'rgba(244,63,94,0.4)' : 'var(--border-glow)';
+      el.style.color = isErr ? 'var(--accent-rose)' : 'var(--text-primary)';
+      el.classList.add('show');
+      clearTimeout(el._t);
+      el._t = setTimeout(function(){ el.classList.remove('show'); }, 3000);
+    }
+
     function escapeHtml(str) {
       if (!str) return '';
       return String(str).replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;');