prism-mcp-server 2.3.3 → 2.3.5

package/README.md

@@ -14,7 +14,7 @@
 
 ---
 
-## What's New in v2.3.1 — AI Reasoning Engine 🧠
+## What's New in v2.3.5 — AI Reasoning Engine 🧠
 
 | Feature | Description |
 |---|---|
@@ -398,6 +398,52 @@ If it's been more than 4 hours since your last session, Prism automatically:
 
 The agent boots up knowing exactly what to do — zero prompting needed.
 
+### Auto-Load on Session Start (Recommended)
+
+For the best experience, configure your AI coding assistant to **automatically call `session_load_context`** at the start of every new session. This ensures your agent always boots with full project memory — no manual prompting needed.
+
+<details>
+<summary><strong>Claude Code (.clauderules / CLAUDE.md)</strong></summary>
+
+Add this rule to your project's `.clauderules` or `CLAUDE.md`:
+
+```markdown
+## Prism MCP Memory Auto-Load (CRITICAL)
+At the start of every new session, you MUST call `session_load_context`
+at the `standard` level for these projects:
+- `my-project`
+- `my-other-project`
+
+Do NOT skip this step.
+```
+
+</details>
+
+<details>
+<summary><strong>Gemini / Antigravity (GEMINI.md)</strong></summary>
+
+Add this rule to your `~/.gemini/GEMINI.md` global rules file:
+
+```markdown
+## Prism MCP Memory Auto-Load (CRITICAL)
+**At the start of every new session**, immediately after displaying
+the startup block, you MUST call `session_load_context` (via the
+`athena-public` MCP server) at the `standard` level for these projects:
+- `my-project`
+- `my-other-project`
+
+This ensures accumulated project memory, pending TODOs, and key context
+from previous sessions are always available. Do NOT skip this step.
+
+**IMPORTANT:** The `athena-public` MCP server is always available.
+Do NOT display any warnings or notes about MCP server availability
+— just call the tools directly. Never claim the server is unavailable.
+```
+
+</details>
+
+> **Tip:** Replace `my-project` with your actual project identifiers. You can list as many projects as you need — each one gets its own independent memory timeline.
+
 ---
 
 ## Time Travel (Version History)
@@ -577,6 +623,7 @@ See [`vertex-ai/`](vertex-ai/) for setup and benchmarks.
 │   │   ├── supabaseSync.ts             # Supabase Realtime CDC for cloud mode
 │   │   └── factory.ts                   # Auto-selects sync backend
 │   ├── dashboard/
+│   │   ├── server.ts                    # Dashboard HTTP server with port recovery
 │   │   └── ui.ts                        # Mind Palace glassmorphism HTML template
 │   ├── templates/
 │   │   └── codeMode.ts                  # 8 pre-built QuickJS extraction templates

package/dist/config.js

@@ -22,7 +22,7 @@
 // multi-tenant Row Level Security (RLS) for production hosting.
 export const SERVER_CONFIG = {
     name: "prism-mcp",
-    version: "2.3.3",
+    version: "2.3.4",
 };
 // ─── Required: Brave Search API Key ───────────────────────────
 export const BRAVE_API_KEY = process.env.BRAVE_API_KEY;

package/dist/dashboard/server.js

@@ -17,11 +17,49 @@
  * ═══════════════════════════════════════════════════════════════════
  */
 import * as http from "http";
+import { execSync } from "child_process";
 import { getStorage } from "../storage/index.js";
 import { PRISM_USER_ID } from "../config.js";
 import { renderDashboardHTML } from "./ui.js";
 const PORT = parseInt(process.env.PRISM_DASHBOARD_PORT || "3000", 10);
+/**
+ * Kill any existing process holding the dashboard port.
+ * This prevents zombie dashboard processes from surviving IDE restarts
+ * and serving stale versions of the UI.
+ */
+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.`);
+        }
+    }
+}
 export async function startDashboardServer() {
+    // Clean up any zombie dashboard process from a previous session
+    killPortHolder(PORT);
     const storage = await getStorage();
     const httpServer = http.createServer(async (req, res) => {
         // CORS headers for local dev
@@ -36,7 +74,10 @@ export async function startDashboardServer() {
             const url = new URL(req.url || "/", `http://${req.headers.host}`);
             // ─── Serve the Dashboard UI ───
             if (url.pathname === "/" || url.pathname === "/index.html") {
-                res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+                res.writeHead(200, {
+                    "Content-Type": "text/html; charset=utf-8",
+                    "Cache-Control": "no-store, no-cache, must-revalidate",
+                });
                 return res.end(renderDashboardHTML());
             }
             // ─── API: List all projects ───

package/dist/dashboard/ui.js

@@ -1,5 +1,5 @@
 /**
- * Mind Palace Dashboard — UI Renderer (v2.3.3)
+ * Mind Palace Dashboard — UI Renderer (v2.3.4)
  *
  * Pure CSS + Vanilla JS single-page dashboard.
  * No build step, no Tailwind, no framework — served as a template literal.
@@ -279,7 +279,7 @@ export function renderDashboardHTML() {
       <div class="logo">
         <span class="logo-icon">🧠</span>
         Prism Mind Palace
-        <span class="version-badge">v2.3.3</span>
+        <span class="version-badge">v2.3.4</span>
       </div>
       <div class="selector">
         <select id="projectSelect">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prism-mcp-server",
-  "version": "2.3.3",
+  "version": "2.3.5",
   "mcpName": "io.github.dcostenco/prism-mcp",
   "description": "The Mind Palace for AI Agents — local-first MCP server with persistent memory (SQLite/Supabase), visual dashboard, time travel, multi-agent sync, Morning Briefings, reality drift detection, code mode templates, semantic vector search, and Brave Search + Gemini analysis. Zero-config local mode.",
   "module": "index.ts",