prism-mcp-server 2.3.8 → 2.3.9

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.7",
+    version: "2.3.9",
 };
 // ─── Required: Brave Search API Key ───────────────────────────
 export const BRAVE_API_KEY = process.env.BRAVE_API_KEY;
@@ -50,10 +50,9 @@ if (!BRAVE_ANSWERS_API_KEY) {
 export const SUPABASE_URL = process.env.SUPABASE_URL;
 export const SUPABASE_KEY = process.env.SUPABASE_KEY;
 export const SESSION_MEMORY_ENABLED = !!(SUPABASE_URL && SUPABASE_KEY);
-if (SESSION_MEMORY_ENABLED) {
-    console.error("Session memory enabled (Supabase configured)");
-}
-else {
+// Note: debug() is defined at the bottom of this file; these lines
+// execute at import time after the full module is loaded by Node.
+if (!SESSION_MEMORY_ENABLED) {
     console.error("Info: Session memory disabled (set SUPABASE_URL + SUPABASE_KEY to enable)");
 }
 // ─── v2.0: Storage Backend Selection ─────────────────────────
@@ -64,7 +63,7 @@ else {
 // Set PRISM_STORAGE=local to use SQLite (once implemented).
 // Set PRISM_STORAGE=supabase to use Supabase REST API (default).
 export const PRISM_STORAGE = process.env.PRISM_STORAGE || "supabase";
-console.error(`Storage backend: ${PRISM_STORAGE}`);
+// Logged at debug level — see debug() at bottom of file
 // ─── Optional: Multi-Tenant User ID ──────────────────────────
 // REVIEWER NOTE: When multiple users share the same Supabase instance,
 // PRISM_USER_ID isolates their data. Each user sets a unique ID in their
@@ -76,9 +75,7 @@ console.error(`Storage backend: ${PRISM_STORAGE}`);
 // For enterprise: use a stable unique identifier (UUID, email hash, etc.)
 // For personal use: any unique string works (e.g., "alice", "bob")
 export const PRISM_USER_ID = process.env.PRISM_USER_ID || "default";
-if (PRISM_USER_ID !== "default") {
-    console.error(`Multi-tenant mode: user_id="${PRISM_USER_ID}"`);
-}
+// Multi-tenant info logged at debug level in startServer()
 // ─── v2.1: Auto-Capture Feature ─────────────────────────────
 // REVIEWER NOTE: Automatically captures HTML snapshots of local dev servers
 // when handoffs are saved. Prevents UI context loss between sessions.
@@ -91,3 +88,13 @@ export const PRISM_CAPTURE_PORTS = (process.env.PRISM_CAPTURE_PORTS || "3000,300
 if (PRISM_AUTO_CAPTURE) {
     console.error(`[AutoCapture] Enabled for ports: ${PRISM_CAPTURE_PORTS.join(", ")}`);
 }
+// ─── Debug Logging ──────────────────────────────────────────────
+// Set PRISM_DEBUG=true to enable verbose startup and operational logs.
+// When disabled (default), only warnings and errors are printed.
+export const PRISM_DEBUG = process.env.PRISM_DEBUG === "true";
+/** Conditional debug logger — only prints when PRISM_DEBUG=true. */
+export function debug(...args) {
+    if (PRISM_DEBUG) {
+        console.error(...args);
+    }
+}

package/dist/server.js

@@ -58,7 +58,7 @@ ListResourcesRequestSchema, ListResourceTemplatesRequestSchema, ReadResourceRequ
 // Claude Desktop that the attached resource has changed.
 // Without this, the paperclipped context becomes stale.
 SubscribeRequestSchema, UnsubscribeRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
-import { SERVER_CONFIG, SESSION_MEMORY_ENABLED, PRISM_USER_ID } from "./config.js";
+import { SERVER_CONFIG, SESSION_MEMORY_ENABLED, PRISM_USER_ID, debug } from "./config.js";
 import { getSyncBus } from "./sync/factory.js";
 import { startDashboardServer } from "./dashboard/server.js";
 // ─── v2.3.6 FIX: Use Storage Abstraction for Prompts/Resources ───
@@ -147,7 +147,7 @@ const activeSubscriptions = new Set();
 export function notifyResourceUpdate(project, server) {
     const uri = `memory://${project}/handoff`;
     if (activeSubscriptions.has(uri)) {
-        console.error(`[resource-subscription] Notifying update for ${uri}`);
+        debug(`[resource-subscription] Notifying update for ${uri}`);
         server.notification({
             method: "notifications/resources/updated",
             params: { uri },
@@ -165,8 +165,8 @@ export function notifyResourceUpdate(project, server) {
  *                with subscribe support for live refresh
  */
 export function createServer() {
-    console.error(`Creating Prism MCP server v${SERVER_CONFIG.version}`);
-    console.error(`Registering ${ALL_TOOLS.length} tools (${BASE_TOOLS.length} base + ${SESSION_MEMORY_ENABLED ? SESSION_MEMORY_TOOLS.length : 0} session memory)`);
+    debug(`Creating Prism MCP server v${SERVER_CONFIG.version}`);
+    debug(`Registering ${ALL_TOOLS.length} tools (${BASE_TOOLS.length} base + ${SESSION_MEMORY_ENABLED ? SESSION_MEMORY_TOOLS.length : 0} session memory)`);
     const server = new Server({
         name: SERVER_CONFIG.name,
         version: SERVER_CONFIG.version,
@@ -196,7 +196,7 @@ export function createServer() {
     // REVIEWER NOTE: The initialize handler is unchanged from v0.3.0
     // except that it now reports the expanded capabilities.
     server.setRequestHandler(InitializeRequestSchema, async (request) => {
-        console.error(`Client connected: ${request.params.clientInfo?.name || 'unknown'}`);
+        debug(`Client connected: ${request.params.clientInfo?.name || 'unknown'}`);
         return {
             protocolVersion: request.params.protocolVersion,
             serverInfo: {
@@ -214,7 +214,7 @@ export function createServer() {
     });
     // ── Handler: List Tools ──
     server.setRequestHandler(ListToolsRequestSchema, async () => {
-        console.error("Received list tools request");
+        debug("Received list tools request");
         return {
             tools: ALL_TOOLS,
         };
@@ -271,7 +271,7 @@ export function createServer() {
             }
             const project = promptArgs?.project || "default";
             const level = promptArgs?.level || "standard";
-            console.error(`[prompt:resume_session] Loading ${level} context for "${project}"`);
+            debug(`[prompt:resume_session] Loading ${level} context for "${project}"`);
             // v2.3.6 FIX: Use storage abstraction instead of direct supabaseRpc
             const storage = await getStorage();
             const result = await storage.loadContext(project, level, PRISM_USER_ID);
@@ -365,7 +365,7 @@ export function createServer() {
                 throw new Error(`Unknown resource URI: ${uri}. Expected format: memory://{project}/handoff`);
             }
             const project = decodeURIComponent(match[1]);
-            console.error(`[resource:read] Fetching handoff for "${project}"`);
+            debug(`[resource:read] Fetching handoff for "${project}"`);
             try {
                 // v2.3.6 FIX: Use storage abstraction instead of direct supabaseRpc
                 const storage = await getStorage();
@@ -404,13 +404,13 @@ export function createServer() {
         // for projects the client hasn't attached.
         server.setRequestHandler(SubscribeRequestSchema, async (request) => {
             const uri = request.params.uri;
-            console.error(`[resource-subscription] Client subscribed to ${uri}`);
+            debug(`[resource-subscription] Client subscribed to ${uri}`);
             activeSubscriptions.add(uri);
             return {};
         });
         server.setRequestHandler(UnsubscribeRequestSchema, async (request) => {
             const uri = request.params.uri;
-            console.error(`[resource-subscription] Client unsubscribed from ${uri}`);
+            debug(`[resource-subscription] Client unsubscribed from ${uri}`);
             activeSubscriptions.delete(uri);
             return {};
         });
@@ -422,13 +422,13 @@ export function createServer() {
     // The server reference is passed to sessionSaveHandoffHandler so it
     // can trigger resource update notifications on successful saves.
     server.setRequestHandler(CallToolRequestSchema, async (request) => {
-        console.error(`Tool call: ${request.params.name}`);
+        debug(`Tool call: ${request.params.name}`);
         try {
             const { name, arguments: args } = request.params;
             if (!args) {
                 throw new Error("No arguments provided");
             }
-            console.error(`Processing ${name} with arguments: ${JSON.stringify(args)}`);
+            debug(`Processing ${name} with arguments: ${JSON.stringify(args)}`);
             switch (name) {
                 // ── Search & Analysis Tools (always available) ──
                 case "brave_web_search":
@@ -595,11 +595,11 @@ export function createSandboxServer() {
  * responses to stdout. Log messages go to stderr.
  */
 export async function startServer() {
-    console.error("Initializing Prism MCP server...");
+    debug("Initializing Prism MCP server...");
     const server = createServer();
-    console.error("Creating stdio transport...");
+    debug("Creating stdio transport...");
     const transport = new StdioServerTransport();
-    console.error("Connecting server to transport...");
+    debug("Connecting server to transport...");
     await server.connect(transport);
     // ─── v2.0 Step 6: Initialize SyncBus (Telepathy) ───
     if (SESSION_MEMORY_ENABLED) {
@@ -607,7 +607,7 @@ export async function startServer() {
             const syncBus = await getSyncBus();
             await syncBus.startListening();
             syncBus.on("update", (event) => {
-                console.error(`[Telepathy] Memory for project '${event.project}' ` +
+                debug(`[Telepathy] Memory for project '${event.project}' ` +
                     `updated to v${event.version} by another agent!`);
                 // Send an MCP logging notification to the IDE
                 try {
@@ -622,7 +622,7 @@ export async function startServer() {
                     console.error(`[Telepathy] Failed to send notification: ${err}`);
                 }
             });
-            console.error("[Telepathy] SyncBus active — multi-client sync enabled");
+            debug("[Telepathy] SyncBus active — multi-client sync enabled");
         }
         catch (err) {
             console.error(`[Telepathy] SyncBus init failed (non-fatal): ${err}`);
@@ -632,7 +632,7 @@ export async function startServer() {
     startDashboardServer().catch(err => {
         console.error(`[Dashboard] Mind Palace startup failed (non-fatal): ${err}`);
     });
-    console.error(`Prism MCP Server v${SERVER_CONFIG.version} running on stdio`);
+    debug(`Prism MCP Server v${SERVER_CONFIG.version} running on stdio`);
     // Keep the process alive — without this, Node.js would exit
     // because there are no active event loop handles after the
     // synchronous setup completes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prism-mcp-server",
-  "version": "2.3.8",
+  "version": "2.3.9",
   "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",