@jungjaehoon/mama-server 1.10.0 → 1.10.1

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.10.1",
   "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

@@ -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.',
+              },
             },
           },
         },
@@ -490,11 +527,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 +569,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 +577,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)) {