superlocalmemory 2.3.6 → 2.3.7

package/CHANGELOG.md

@@ -16,6 +16,30 @@ SuperLocalMemory V2 - Intelligent local memory system for AI coding assistants.
 
 ---
 
+## [2.3.7] - 2026-02-09
+
+### Added
+- **--full flag**: Show complete memory content without truncation in search/list/recent/cluster commands
+- **Smart truncation**: Memories <5000 chars shown in full, ≥5000 chars truncated to 2000 chars (previously always truncated at 200 chars)
+- **Help text**: Added --full flag documentation to CLI help output
+
+### Fixed
+- **CLI bug**: Fixed `get` command error - `get_memory()` → `get_by_id()` method call
+- **Content display**: Recall now shows full content for short/medium memories instead of always truncating at 200 chars
+- **User experience**: Agents and users can now see complete memory content by default for most memories
+
+### Changed
+- **Truncation logic**: 200 char limit → 2000 char preview for memories ≥5000 chars
+- **Node.js wrappers**: memory-recall-skill.js and memory-list-skill.js updated to pass --full flag through
+
+### Technical Details
+- Added `format_content()` helper function in memory_store_v2.py (line 918)
+- Updated search/list/recent/cluster commands to use smart truncation
+- Backward compatible: same output structure, MCP/API calls unaffected
+- All 74+ existing memories tested: short memories show full, long memories truncate intelligently
+
+---
+
 ## [2.3.5] - 2026-02-09
 
 ### Added

package/hooks/memory-list-skill.js

@@ -34,6 +34,7 @@ Options:
                          • recent: Latest created first (default)
                          • accessed: Most recently accessed
                          • importance: Highest importance first
+  --full                 Show complete content without truncation
 
 Examples:
   memory-list
@@ -42,17 +43,17 @@ Examples:
 
   memory-list --sort importance
 
-  memory-list --limit 10 --sort accessed
+  memory-list --limit 10 --sort accessed --full
 
 Output Format:
-  • ID, Content (truncated), Tags, Importance
+  • ID, Content (smart truncated), Tags, Importance
   • Creation timestamp
   • Access count and last accessed time
 
 Notes:
   • Default shows last 20 memories
-  • Content is truncated to 100 chars for readability
-  • Use ID with memory-recall to see full content
+  • Smart truncation: full content if <5000 chars, preview if ≥5000 chars
+  • Use --full flag to always show complete content
   • Sort by 'accessed' to find frequently used memories
 `);
     return;
@@ -61,6 +62,7 @@ Notes:
   // Parse options
   let limit = 20;
   let sortBy = 'recent';
+  let showFull = false;
 
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
@@ -83,6 +85,8 @@ Notes:
         return;
       }
       i++;
+    } else if (arg === '--full') {
+      showFull = true;
     }
   }
 
@@ -97,6 +101,11 @@ Notes:
     pythonArgs = ['list', limit.toString()];
   }
 
+  // Add --full flag if requested
+  if (showFull) {
+    pythonArgs.push('--full');
+  }
+
   try {
     const { stdout, stderr } = await execFileAsync('python3', [memoryScript, ...pythonArgs]);
 

package/hooks/memory-recall-skill.js

@@ -33,13 +33,14 @@ Arguments:
 
 Options:
   --limit <n>            Maximum results to return (default: 10)
+  --full                 Show complete content without truncation
 
 Examples:
   memory-recall "authentication bug"
 
   memory-recall "API configuration" --limit 5
 
-  memory-recall "security best practices"
+  memory-recall "security best practices" --full
 
   memory-recall "user preferences"
 
@@ -47,6 +48,8 @@ Output Format:
   • Ranked by relevance (TF-IDF cosine similarity)
   • Shows: ID, Content, Tags, Importance, Timestamp
   • Higher scores = better matches
+  • Smart truncation: full content if <5000 chars, preview if ≥5000 chars
+  • Use --full flag to always show complete content
 
 Notes:
   • Uses local TF-IDF search (no external APIs)
@@ -67,6 +70,8 @@ Notes:
     if (arg === '--limit' && i + 1 < args.length) {
       // Note: V1 store doesn't support --limit in search, will truncate output instead
       i++; // Skip but don't add to pythonArgs
+    } else if (arg === '--full') {
+      pythonArgs.push('--full');
     } else if (!arg.startsWith('--') && query === null) {
       query = arg;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superlocalmemory",
-  "version": "2.3.6",
+  "version": "2.3.7",
   "description": "Your AI Finally Remembers You - Local-first intelligent memory system for AI assistants. Works with Claude, Cursor, Windsurf, VS Code/Copilot, Codex, and 16+ AI tools. 100% local, zero cloud dependencies.",
   "keywords": [
     "ai-memory",

package/src/memory_store_v2.py

@@ -915,6 +915,25 @@ class MemoryStoreV2:
         return ''.join(output)
 
 
+def format_content(content: str, full: bool = False, threshold: int = 5000, preview_len: int = 2000) -> str:
+    """
+    Smart content formatting with optional truncation.
+
+    Args:
+        content: Content to format
+        full: If True, always show full content
+        threshold: Max length before truncation (default 5000)
+        preview_len: Preview length when truncating (default 2000)
+
+    Returns:
+        Formatted content string
+    """
+    if full or len(content) < threshold:
+        return content
+    else:
+        return f"{content[:preview_len]}..."
+
+
 # CLI interface (V1 compatible + V2 extensions)
 if __name__ == "__main__":
     import sys
@@ -925,16 +944,18 @@ if __name__ == "__main__":
         print("MemoryStore V2 CLI")
         print("\nV1 Compatible Commands:")
         print("  python memory_store_v2.py add <content> [--project <path>] [--tags tag1,tag2]")
-        print("  python memory_store_v2.py search <query>")
-        print("  python memory_store_v2.py list [limit]")
+        print("  python memory_store_v2.py search <query> [--full]")
+        print("  python memory_store_v2.py list [limit] [--full]")
         print("  python memory_store_v2.py get <id>")
-        print("  python memory_store_v2.py recent [limit]")
+        print("  python memory_store_v2.py recent [limit] [--full]")
         print("  python memory_store_v2.py stats")
         print("  python memory_store_v2.py context <query>")
         print("  python memory_store_v2.py delete <id>")
         print("\nV2 Extensions:")
         print("  python memory_store_v2.py tree [parent_id]")
-        print("  python memory_store_v2.py cluster <cluster_id>")
+        print("  python memory_store_v2.py cluster <cluster_id> [--full]")
+        print("\nOptions:")
+        print("  --full    Show complete content (default: smart truncation at 5000 chars)")
         sys.exit(0)
 
     command = sys.argv[1]
@@ -954,6 +975,7 @@ if __name__ == "__main__":
 
     elif command == "cluster" and len(sys.argv) >= 3:
         cluster_id = int(sys.argv[2])
+        show_full = '--full' in sys.argv
         results = store.get_by_cluster(cluster_id)
 
         if not results:
@@ -962,7 +984,7 @@ if __name__ == "__main__":
             print(f"Cluster {cluster_id} - {len(results)} memories:")
             for r in results:
                 print(f"\n[{r['id']}] Importance: {r['importance']}")
-                print(f"  {r['content'][:200]}...")
+                print(f"  {format_content(r['content'], full=show_full)}")
 
     elif command == "stats":
         stats = store.get_stats()
@@ -996,10 +1018,11 @@ if __name__ == "__main__":
     elif command == "search":
         if len(sys.argv) < 3:
             print("Error: Search query required")
-            print("Usage: python memory_store_v2.py search <query>")
+            print("Usage: python memory_store_v2.py search <query> [--full]")
             sys.exit(1)
 
         query = sys.argv[2]
+        show_full = '--full' in sys.argv
         results = store.search(query, limit=5)
 
         if not results:
@@ -1011,11 +1034,18 @@ if __name__ == "__main__":
                     print(f"Project: {r['project_name']}")
                 if r.get('tags'):
                     print(f"Tags: {', '.join(r['tags'])}")
-                print(f"Content: {r['content'][:200]}...")
+                print(f"Content: {format_content(r['content'], full=show_full)}")
                 print(f"Created: {r['created_at']}")
 
     elif command == "recent":
-        limit = int(sys.argv[2]) if len(sys.argv) > 2 else 10
+        show_full = '--full' in sys.argv
+        # Parse limit (skip --full flag)
+        limit = 10
+        for i, arg in enumerate(sys.argv[2:], start=2):
+            if arg != '--full' and arg.isdigit():
+                limit = int(arg)
+                break
+
         results = store.get_recent(limit)
 
         if not results:
@@ -1027,17 +1057,24 @@ if __name__ == "__main__":
                     print(f"Project: {r['project_name']}")
                 if r.get('tags'):
                     print(f"Tags: {', '.join(r['tags'])}")
-                print(f"Content: {r['content'][:200]}...")
+                print(f"Content: {format_content(r['content'], full=show_full)}")
 
     elif command == "list":
-        limit = int(sys.argv[2]) if len(sys.argv) > 2 else 10
+        show_full = '--full' in sys.argv
+        # Parse limit (skip --full flag)
+        limit = 10
+        for i, arg in enumerate(sys.argv[2:], start=2):
+            if arg != '--full' and arg.isdigit():
+                limit = int(arg)
+                break
+
         results = store.get_recent(limit)
 
         if not results:
             print("No memories found.")
         else:
             for r in results:
-                print(f"[{r['id']}] {r['content'][:100]}...")
+                print(f"[{r['id']}] {format_content(r['content'], full=show_full)}")
 
     elif command == "get":
         if len(sys.argv) < 3:
@@ -1046,7 +1083,7 @@ if __name__ == "__main__":
             sys.exit(1)
 
         mem_id = int(sys.argv[2])
-        memory = store.get_memory(mem_id)
+        memory = store.get_by_id(mem_id)
 
         if not memory:
             print(f"Memory {mem_id} not found.")