prism-mcp-server 6.5.1 → 6.5.3

package/README.md

@@ -6,7 +6,7 @@
 [![Smithery](https://img.shields.io/badge/Smithery-listed-6B4FBB)](https://smithery.ai)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
-[![Node.js](https://img.shields.io/badge/Node.js-18+-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
+[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
 
 **Your AI agent forgets everything between sessions. Prism fixes that.**
 
@@ -33,7 +33,7 @@ Works with **Claude Desktop · Claude Code · Cursor · Windsurf · Cline · Gem
 - [Architecture](#architecture)
 - [Scientific Foundation](#-scientific-foundation)
 - [Product Roadmap](#-product-roadmap)
-- [Limitations](#limitations)
+- [Troubleshooting FAQ](#-troubleshooting-faq)
 
 ---
 
@@ -391,10 +391,29 @@ Soft/hard delete (Art. 17), full export in JSON, Markdown, or Obsidian vault `.z
 
 **Morning Briefings** — After 4+ hours away, Prism auto-synthesizes a 3-bullet action plan from your last sessions.
 
+### Claude Code: Parallel Explore Agent Workflows
+
+When you need to quickly map a large auth system, launch multiple `Explore` subagents in parallel and merge their findings:
+
+```text
+Run 3 Explore agents in parallel.
+1) Map auth architecture
+2) List auth API endpoints
+3) Find auth test coverage gaps
+Research only, no code changes.
+Return a merged summary.
+```
+
+Then continue a specific thread with a follow-up message to the selected agent, such as deeper refresh-token edge-case analysis.
+
 ---
 
 ## 🆕 What's New
 
+### v6.5.1 — Dashboard Project-Load Hotfix ✅
+- 🩹 **Project Selector Recovery** — Fixed a startup path where the dashboard selector could stay stuck on "Loading projects..." when Supabase env vars were unresolved placeholders.
+- 🔄 **Safe Backend Fallback** — If Supabase is requested but env is invalid/unresolved, Prism now auto-falls back to local SQLite so `/api/projects` and dashboard boot remain operational.
+
 ### v6.5 — HDC Cognitive Routing ✅
 > **Current stable release.** The Mind Palace gains a brain-inspired routing engine.
 
@@ -743,9 +762,21 @@ Full Superposed Memory (SDM) + Hyperdimensional Computing (HDC/VSA) becomes the
 - **v7.x: Affect-Tagged Memory** — Recall prioritization improves by weighting memories with affective/contextual valence, making surfaced context more behaviorally useful.
 - **v8+: Zero-Search Retrieval** — Direct vector-addressed recall (“just ask the vector”) reduces retrieval indirection and moves Prism toward truly native associative memory.
 
----
 
-## Limitations
+## ❓ Troubleshooting FAQ
+
+**Q: Why is the dashboard project selector stuck on "Loading projects..."?**
+A: This usually means Supabase env values are unresolved placeholders (for example `${SUPABASE_URL}`) or invalid. As of v6.5.1 Prism auto-falls back to local SQLite, but you should still fix env values for cloud mode.
+
+**Q: Why is semantic search quality weak or inconsistent?**
+A: Check embedding provider configuration and key availability. Missing embedding credentials reduce semantic recall quality and can shift behavior toward keyword-heavy matches.
+
+**Q: How do I delete a bad memory entry?**
+A: Use `session_forget_memory` for targeted soft/hard deletion. For manual cleanup and merge workflows, use the dashboard graph editor.
+
+**Q: How do I verify the install quickly?**
+A: Run `npm run build && npm test`, then open the Mind Palace dashboard (`localhost:3000`) and confirm projects load plus Graph Health renders.
+
 
 - **LLM-dependent features require an API key.** Semantic search, Morning Briefings, auto-compaction, and VLM captioning need a `GOOGLE_API_KEY` (Gemini) or equivalent provider key. Without one, Prism falls back to keyword-only search (FTS5).
 - **Auto-load is model- and client-dependent.** Session auto-loading relies on both the LLM following system prompt instructions *and* the MCP client completing tool registration before the model's first turn. Prism provides platform-specific [Setup Guides](#-setup-guides) and a server-side fallback (v5.2.1) that auto-pushes context after 10 seconds.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prism-mcp-server",
-  "version": "6.5.1",
+  "version": "6.5.3",
   "mcpName": "io.github.dcostenco/prism-mcp",
   "description": "The Mind Palace for AI Agents — persistent memory (SQLite/Supabase), behavioral learning & IDE rules sync, multimodal VLM image captioning, pluggable LLM providers (OpenAI/Anthropic/Gemini/Ollama), OpenTelemetry distributed tracing, GDPR export, multi-agent Hivemind sync, time travel, visual Mind Palace dashboard. Zero-config local mode.",
   "module": "index.ts",