@jungjaehoon/mama-server 1.10.0 → 1.11.0

package/README.md

@@ -231,7 +231,7 @@ Interactive visualization of your reasoning graph.
 ## Technical Details
 
 - **Database:** SQLite + pure-TS cosine similarity
-- **Embeddings:** Transformers.js (Xenova/multilingual-e5-small, 384-dim)
+- **Embeddings:** Transformers.js (Xenova/multilingual-e5-large, 1024-dim)
 - **Transport:** stdio-based MCP protocol (default) + optional HTTP embedding server (port 3849)
 - **Storage:** ~/.claude/mama-memory.db (configurable via MAMA_DB_PATH)
 - **Port File:** ~/.mama-embedding-port (for client discovery)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jungjaehoon/mama-server",
-  "version": "1.10.0",
+  "version": "1.11.0",
   "description": "MAMA MCP Server - Memory-Augmented MCP Assistant for Claude Code & Desktop",
   "main": "src/server.js",
   "bin": {

package/src/db/migrations/001-initial-decision-graph.sql

@@ -119,7 +119,7 @@ CREATE INDEX IF NOT EXISTS idx_sessions_last_active ON sessions(last_active_at);
 -- because sqlite-vss requires extension loading first
 --
 -- CREATE VIRTUAL TABLE vss_memories USING vss0(
---   embedding(384)                    -- multilingual-e5-small embeddings
+--   embedding(1024)                   -- multilingual-e5-large embeddings
 -- );
 
 -- ══════════════════════════════════════════════════════════════

package/src/db/migrations/002-add-error-patterns.sql

@@ -33,7 +33,7 @@ CREATE TABLE IF NOT EXISTS error_patterns (
   first_seen INTEGER NOT NULL,     -- First occurrence timestamp
 
   -- Vector Embedding (for semantic matching)
-  embedding BLOB,                  -- 384-dim embedding (multilingual-e5-small)
+  embedding BLOB,                  -- 1024-dim embedding (multilingual-e5-large)
 
   -- Metadata
   created_at INTEGER DEFAULT (unixepoch()),

package/src/mama/transparency-banner.js

@@ -56,7 +56,7 @@ const FIX_INSTRUCTIONS = {
     steps: [
       '1. Install Transformers.js: npm install @xenova/transformers',
       '2. Configure model in ~/.mama/config.json:',
-      '   { "embeddingModel": "Xenova/multilingual-e5-small" }',
+      '   { "embeddingModel": "Xenova/multilingual-e5-large" }',
       '3. Restart Claude Code to reload configuration',
     ],
     impact: 'Without embeddings, MAMA falls back to keyword search (30% less accurate)',

package/src/server.js

@@ -28,9 +28,9 @@ const {
 } = require('@modelcontextprotocol/sdk/types.js');
 const path = require('path');
 
-// Import MAMA tools - Simplified to 4 core tools (2025-11-25 refactor)
-// Rationale: LLM can infer relationships from search results, fewer tools = more flexibility
-const { loadCheckpointTool } = require('./tools/checkpoint-tools.js');
+// Import all MAMA tools from src/tools/ — single source of truth for tool definitions
+const { createMemoryTools } = require('./tools/index.js');
+const memoryTools = createMemoryTools();
 const mama = require('@jungjaehoon/mama-core/mama-api');
 
 // Import core modules from mama-core
@@ -248,6 +248,28 @@ type='checkpoint': session state for resumption (ALSO requires search first!)`,
                 minimum: 0,
                 maximum: 1,
               },
+              // Scope & temporal fields
+              scopes: {
+                type: 'array',
+                items: {
+                  type: 'object',
+                  properties: {
+                    kind: {
+                      type: 'string',
+                      enum: ['global', 'user', 'channel', 'project'],
+                    },
+                    id: { type: 'string' },
+                  },
+                  required: ['kind', 'id'],
+                },
+                description:
+                  '[Decision] Memory scopes for isolation. Example: [{"kind": "project", "id": "/path/to/project"}]',
+              },
+              event_date: {
+                type: 'string',
+                description:
+                  '[Decision] ISO 8601 date when the event occurred (e.g., "2024-01-15"). Defaults to now.',
+              },
               // Checkpoint fields
               summary: {
                 type: 'string',
@@ -311,6 +333,21 @@ When presenting search results to the user or agent, include a brief **Reasoning
                 type: 'number',
                 description: 'Maximum results. Default: 10',
               },
+              scopes: {
+                type: 'array',
+                items: {
+                  type: 'object',
+                  properties: {
+                    kind: {
+                      type: 'string',
+                      enum: ['global', 'user', 'channel', 'project'],
+                    },
+                    id: { type: 'string' },
+                  },
+                  required: ['kind', 'id'],
+                },
+                description: 'Filter search results by scope.',
+              },
             },
           },
         },
@@ -409,6 +446,14 @@ Returns: summary (4-section), next_steps (DoD + commands), open_files
             properties: {},
           },
         },
+        // === v2 tools from src/tools/ ===
+        ...Object.values(memoryTools)
+          .filter((t) => t.name && t.inputSchema)
+          .map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: t.inputSchema,
+          })),
       ],
     }));
 
@@ -435,10 +480,15 @@ Returns: summary (4-section), next_steps (DoD + commands), open_files
             result = await this.handleSearchDecisionsAndContracts(args);
             break;
           case 'load_checkpoint':
-            result = await loadCheckpointTool.handler(args);
+            result = await memoryTools.load_checkpoint.handler(args);
             break;
           default:
-            throw new Error(`Unknown tool: ${name}`);
+            // Route to src/tools/ handlers
+            if (memoryTools[name] && typeof memoryTools[name].handler === 'function') {
+              result = await memoryTools[name].handler(args);
+            } else {
+              throw new Error(`Unknown tool: ${name}`);
+            }
         }
 
         const shouldInjectLegacyNotice =
@@ -490,11 +540,19 @@ Returns: summary (4-section), next_steps (DoD + commands), open_files
     const { type } = args;
 
     if (type === 'decision') {
-      const { topic, decision, reasoning, confidence = 0.5 } = args;
+      const { topic, decision, reasoning, confidence = 0.5, scopes, event_date } = args;
       if (!topic || !decision || !reasoning) {
         return { success: false, message: '❌ Decision requires: topic, decision, reasoning' };
       }
-      const id = await mama.save({ type: 'user_decision', topic, decision, reasoning, confidence });
+      const id = await mama.save({
+        type: 'user_decision',
+        topic,
+        decision,
+        reasoning,
+        confidence,
+        ...(scopes && { scopes }),
+        ...(event_date && { event_date }),
+      });
       return {
         success: true,
         id,
@@ -524,7 +582,7 @@ Returns: summary (4-section), next_steps (DoD + commands), open_files
    * Handle unified search (decisions + checkpoints)
    */
   async handleSearch(args) {
-    const { query, type = 'all', limit = 10 } = args;
+    const { query, type = 'all', limit = 10, scopes } = args;
 
     const results = [];
 
@@ -532,12 +590,13 @@ Returns: summary (4-section), next_steps (DoD + commands), open_files
     if (type === 'all' || type === 'decision') {
       let decisions;
       if (query) {
-        // suggest() returns { results: [...] } object or null
-        // Note: suggest() takes options object as second parameter
-        const suggestResult = await mama.suggest(query, { limit });
+        const suggestResult = await mama.suggest(query, {
+          limit,
+          ...(scopes && { scopes }),
+        });
         decisions = suggestResult?.results || [];
       } else {
-        decisions = await mama.list(limit);
+        decisions = await mama.list({ limit, ...(scopes && { scopes }) });
       }
       // Ensure decisions is an array
       if (Array.isArray(decisions)) {
@@ -564,9 +623,13 @@ Returns: summary (4-section), next_steps (DoD + commands), open_files
       );
     }
 
-    // Sort by time (newest first) and limit
-    results.sort((a, b) => (b.created_at || 0) - (a.created_at || 0));
-    const limited = results.slice(0, limit);
+    // Decisions are already sorted by similarity from suggest().
+    // Only sort checkpoints by time. Keep decisions first (relevance), checkpoints after (recency).
+    const decisions = results.filter((r) => r._type === 'decision');
+    const checkpoints = results
+      .filter((r) => r._type === 'checkpoint')
+      .sort((a, b) => (b.created_at || 0) - (a.created_at || 0));
+    const limited = [...decisions, ...checkpoints].slice(0, limit);
 
     return {
       success: true,