superlocalmemory 2.7.6 → 2.8.1

package/mcp_server.py

@@ -1,12 +1,9 @@
 #!/usr/bin/env python3
-"""
-SuperLocalMemory V2 - MCP Server
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 SuperLocalMemory (superlocalmemory.com)
+"""SuperLocalMemory V2 - MCP Server
 Universal memory access for all MCP-compatible tools (Cursor, Windsurf, Claude Desktop, Continue.dev)
 
-Copyright (c) 2026 Varun Pratap Bhardwaj
-Licensed under MIT License
-Repository: https://github.com/varun369/SuperLocalMemoryV2
-
 IMPORTANT: This is an ADDITION to existing skills, not a replacement.
            Skills in Claude Code continue to work unchanged.
 
@@ -24,7 +21,6 @@ Usage:
     # Run as HTTP MCP server (for remote access)
     python3 mcp_server.py --transport http --port 8001
 """
-
 from mcp.server.fastmcp import FastMCP, Context
 from mcp.types import ToolAnnotations
 import sys
@@ -564,6 +560,36 @@ def _maybe_passive_decay() -> None:
         pass
 
 
+# ============================================================================
+# Eager initialization — ensure schema migration runs at startup (v2.8)
+# ============================================================================
+
+def _eager_init():
+    """Initialize all engines at startup. Ensures schema migration runs."""
+    try:
+        get_store()  # Triggers MemoryStoreV2._init_db() which creates v2.8 columns
+    except Exception:
+        pass  # Don't block server startup
+    try:
+        from lifecycle.lifecycle_engine import LifecycleEngine
+        LifecycleEngine()  # Triggers _ensure_columns()
+    except Exception:
+        pass
+    try:
+        from behavioral.outcome_tracker import OutcomeTracker
+        OutcomeTracker(str(Path.home() / ".claude-memory" / "learning.db"))
+    except Exception:
+        pass
+    try:
+        from compliance.audit_db import AuditDB
+        AuditDB(str(Path.home() / ".claude-memory" / "audit.db"))
+    except Exception:
+        pass
+
+# Run once at module load
+_eager_init()
+
+
 # ============================================================================
 # MCP TOOLS (Functions callable by AI)
 # ============================================================================
@@ -589,7 +615,7 @@ async def remember(
     Args:
         content: The content to remember (required)
         tags: Comma-separated tags (optional, e.g. "python,api,backend")
-        project: Project name (optional, groups related memories)
+        project: Project name to scope the memory
         importance: Importance score 1-10 (default 5)
 
     Returns:
@@ -1349,6 +1375,84 @@ async def fetch(id: str) -> dict:
         raise ValueError(f"Failed to fetch memory {id}: {_sanitize_error(e)}")
 
 
+# ============================================================================
+# v2.8 MCP TOOLS — Lifecycle, Behavioral Learning, Compliance
+# ============================================================================
+
+try:
+    from mcp_tools_v28 import (
+        report_outcome as _report_outcome,
+        get_lifecycle_status as _get_lifecycle_status,
+        set_retention_policy as _set_retention_policy,
+        compact_memories as _compact_memories,
+        get_behavioral_patterns as _get_behavioral_patterns,
+        audit_trail as _audit_trail,
+    )
+
+    V28_AVAILABLE = True
+
+    @mcp.tool(annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False))
+    async def report_outcome(
+        memory_ids: list,
+        outcome: str,
+        action_type: str = "other",
+        context: str = None,
+        agent_id: str = "user",
+        project: str = None,
+    ) -> dict:
+        """Record action outcome for behavioral learning. Outcomes: success/failure/partial."""
+        return await _report_outcome(memory_ids, outcome, action_type, context, agent_id, project)
+
+    @mcp.tool(annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False))
+    async def get_lifecycle_status(memory_id: int = None) -> dict:
+        """Get memory lifecycle status — state distribution or single memory state."""
+        return await _get_lifecycle_status(memory_id)
+
+    @mcp.tool(annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False))
+    async def set_retention_policy(
+        name: str,
+        framework: str,
+        retention_days: int,
+        action: str = "retain",
+        applies_to_tags: list = None,
+        applies_to_project: str = None,
+    ) -> dict:
+        """Create a retention policy (GDPR, HIPAA, EU AI Act)."""
+        return await _set_retention_policy(
+            name, framework, retention_days, action, applies_to_tags, applies_to_project
+        )
+
+    @mcp.tool(annotations=ToolAnnotations(readOnlyHint=False, destructiveHint=False))
+    async def compact_memories(dry_run: bool = True, profile: str = None) -> dict:
+        """Evaluate and compact stale memories through lifecycle transitions. dry_run=True by default.
+
+        Args:
+            dry_run: If True (default), show what would happen without changes.
+            profile: Profile name to filter.
+        """
+        return await _compact_memories(dry_run, profile)
+
+    @mcp.tool(annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False))
+    async def get_behavioral_patterns(
+        min_confidence: float = 0.0, project: str = None
+    ) -> dict:
+        """Get learned behavioral patterns from outcome analysis."""
+        return await _get_behavioral_patterns(min_confidence, project)
+
+    @mcp.tool(annotations=ToolAnnotations(readOnlyHint=True, destructiveHint=False))
+    async def audit_trail(
+        event_type: str = None,
+        actor: str = None,
+        limit: int = 50,
+        verify_chain: bool = False,
+    ) -> dict:
+        """Query compliance audit trail with optional hash chain verification."""
+        return await _audit_trail(event_type, actor, limit, verify_chain)
+
+except ImportError:
+    V28_AVAILABLE = False  # v2.8 tools unavailable — graceful degradation
+
+
 # ============================================================================
 # MCP RESOURCES (Data endpoints)
 # ============================================================================
@@ -1580,12 +1684,19 @@ if __name__ == "__main__":
     print("  - list_recent(limit)", file=sys.stderr)
     print("  - get_status()", file=sys.stderr)
     print("  - build_graph()", file=sys.stderr)
-    print("  - switch_profile(name)", file=sys.stderr)
+    print("  - switch_profile(name)   [Project/Profile switch]", file=sys.stderr)
     print("  - backup_status()        [Auto-Backup]", file=sys.stderr)
     if LEARNING_AVAILABLE:
         print("  - memory_used(memory_id, query, usefulness)  [v2.7 Learning]", file=sys.stderr)
         print("  - get_learned_patterns(min_confidence, category) [v2.7 Learning]", file=sys.stderr)
         print("  - correct_pattern(pattern_id, correct_value) [v2.7 Learning]", file=sys.stderr)
+    if V28_AVAILABLE:
+        print("  - report_outcome(memory_ids, outcome)         [v2.8 Behavioral]", file=sys.stderr)
+        print("  - get_lifecycle_status(memory_id)              [v2.8 Lifecycle]", file=sys.stderr)
+        print("  - set_retention_policy(name, framework, days)  [v2.8 Compliance]", file=sys.stderr)
+        print("  - compact_memories(dry_run)                    [v2.8 Lifecycle]", file=sys.stderr)
+        print("  - get_behavioral_patterns(min_confidence)      [v2.8 Behavioral]", file=sys.stderr)
+        print("  - audit_trail(event_type, verify_chain)        [v2.8 Compliance]", file=sys.stderr)
     print("", file=sys.stderr)
     print("MCP Resources Available:", file=sys.stderr)
     print("  - memory://recent/{limit}", file=sys.stderr)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superlocalmemory",
-  "version": "2.7.6",
+  "version": "2.8.1",
   "description": "Your AI Finally Remembers You - Local-first intelligent memory system for AI assistants. Works with Claude, Cursor, Windsurf, VS Code/Copilot, Codex, and 17+ AI tools. 100% local, zero cloud dependencies.",
   "keywords": [
     "ai-memory",
@@ -94,13 +94,6 @@
       "url": "https://github.com/varun369"
     }
   ],
-  "attribution": {
-    "creator": "Varun Pratap Bhardwaj",
-    "role": "Solution Architect & Original Creator",
-    "year": "2026",
-    "github": "https://github.com/varun369",
-    "required": "Attribution notice must be preserved in all copies and derivative works"
-  },
   "dependencies": {
     "docx": "^9.5.1"
   }

package/scripts/generate-thumbnails.py

@@ -1,8 +1,7 @@
 #!/usr/bin/env python3
-"""
-SuperLocalMemory V2 - Thumbnail Generator
-Copyright (c) 2026 Varun Pratap Bhardwaj
-Licensed under MIT License
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 SuperLocalMemory (superlocalmemory.com)
+"""SuperLocalMemory V2 - Thumbnail Generator
 
 Generates optimized thumbnail versions of all screenshots.
 - Size: 320×180px (16:9 ratio)
@@ -10,7 +9,6 @@ Generates optimized thumbnail versions of all screenshots.
 - Quality: High enough to recognize content
 - File size: < 50KB per thumbnail
 """
-
 import os
 import json
 from pathlib import Path

package/skills/slm-build-graph/SKILL.md

@@ -417,7 +417,7 @@ Each profile has separate graph
 
 **Created by:** [Varun Pratap Bhardwaj](https://github.com/varun369) (Solution Architect)
 **Project:** SuperLocalMemory V2
-**License:** MIT with attribution requirements (see [ATTRIBUTION.md](../../ATTRIBUTION.md))
+**License:** MIT (see [LICENSE](../../LICENSE))
 **Repository:** https://github.com/varun369/SuperLocalMemoryV2
 
 *Open source doesn't mean removing credit. Attribution must be preserved per MIT License terms.*

package/skills/slm-list-recent/SKILL.md

@@ -336,13 +336,13 @@ date
 - `slm remember` - Save a new memory
 - `slm recall` - Search memories by relevance
 - `slm status` - Check memory count and stats
-- `slm switch-profile` - View different project's memories
+- `slm switch-profile` - View different profile's memories
 
 ---
 
 **Created by:** [Varun Pratap Bhardwaj](https://github.com/varun369) (Solution Architect)
 **Project:** SuperLocalMemory V2
-**License:** MIT with attribution requirements (see [ATTRIBUTION.md](../../ATTRIBUTION.md))
+**License:** MIT (see [LICENSE](../../LICENSE))
 **Repository:** https://github.com/varun369/SuperLocalMemoryV2
 
 *Open source doesn't mean removing credit. Attribution must be preserved per MIT License terms.*

package/skills/slm-recall/SKILL.md

@@ -320,7 +320,7 @@ slm recall "query" --format csv
 
 **Created by:** [Varun Pratap Bhardwaj](https://github.com/varun369) (Solution Architect)
 **Project:** SuperLocalMemory V2
-**License:** MIT with attribution requirements (see [ATTRIBUTION.md](../../ATTRIBUTION.md))
+**License:** MIT (see [LICENSE](../../LICENSE))
 **Repository:** https://github.com/varun369/SuperLocalMemoryV2
 
 *Open source doesn't mean removing credit. Attribution must be preserved per MIT License terms.*

package/skills/slm-remember/SKILL.md

@@ -157,7 +157,7 @@ slm remember "Commit: $commit_msg (${commit_hash:0:7})" \
 - **Cross-tool sync:** All AI tools access same database (Cursor, ChatGPT, Claude, etc.)
 - **Unlimited:** No memory limits, no quotas
 - **Privacy:** Your data stays on your computer
-- **Profiles:** Use `slm switch-profile` for project isolation
+- **Profiles:** Use `slm switch-profile` for profile isolation
 
 ## Related Commands
 
@@ -188,7 +188,7 @@ slm remember "Commit: $commit_msg (${commit_hash:0:7})" \
 
 **Created by:** [Varun Pratap Bhardwaj](https://github.com/varun369) (Solution Architect)
 **Project:** SuperLocalMemory V2
-**License:** MIT with attribution requirements (see [ATTRIBUTION.md](../../ATTRIBUTION.md))
+**License:** MIT (see [LICENSE](../../LICENSE))
 **Repository:** https://github.com/varun369/SuperLocalMemoryV2
 
 *Open source doesn't mean removing credit. Attribution must be preserved per MIT License terms.*

package/skills/slm-show-patterns/SKILL.md

@@ -218,7 +218,7 @@ slm engagement
 
 **Created by:** [Varun Pratap Bhardwaj](https://github.com/varun369) (Solution Architect)
 **Project:** SuperLocalMemory V2
-**License:** MIT with attribution requirements (see [ATTRIBUTION.md](../../ATTRIBUTION.md))
+**License:** MIT (see [LICENSE](../../LICENSE))
 **Repository:** https://github.com/varun369/SuperLocalMemoryV2
 
 *Open source doesn't mean removing credit. Attribution must be preserved per MIT License terms.*

package/skills/slm-status/SKILL.md

@@ -155,7 +155,7 @@ Corrupted Entries:       0 found
 - **Last Used:** Last access timestamp
 
 **Profiles allow:**
-- Project isolation
+- Profile isolation
 - Context switching
 - Separate memory spaces
 
@@ -357,7 +357,7 @@ slm build-graph
 
 **Created by:** [Varun Pratap Bhardwaj](https://github.com/varun369) (Solution Architect)
 **Project:** SuperLocalMemory V2
-**License:** MIT with attribution requirements (see [ATTRIBUTION.md](../../ATTRIBUTION.md))
+**License:** MIT (see [LICENSE](../../LICENSE))
 **Repository:** https://github.com/varun369/SuperLocalMemoryV2
 
 *Open source doesn't mean removing credit. Attribution must be preserved per MIT License terms.*

package/skills/slm-switch-profile/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: slm-switch-profile
-description: Switch between memory profiles for project isolation and context management. Use when the user wants to change project context, separate work/personal memories, or manage multiple independent memory spaces. Each profile has its own database, graph, and patterns.
+description: Switch between memory profiles for context isolation and management. Use when the user wants to change profile context, separate work/personal memories, or manage multiple independent memory spaces. Each profile has its own database, graph, and patterns.
 version: "2.1.0"
 license: MIT
 compatibility: "Requires SuperLocalMemory V2 installed at ~/.claude-memory/"
@@ -26,8 +26,8 @@ slm switch-profile <name> [--create]
 
 Each profile has its own:
 - ✅ **Separate database** - Zero context bleeding
-- ✅ **Independent knowledge graph** - Project-specific relationships
-- ✅ **Unique patterns** - Different coding preferences per project
+- ✅ **Independent knowledge graph** - Profile-specific relationships
+- ✅ **Unique patterns** - Different coding preferences per profile
 - ✅ **Isolated history** - No cross-contamination
 
 **Think of profiles as workspaces:**
@@ -436,7 +436,7 @@ slm list-profiles
 
 **Created by:** [Varun Pratap Bhardwaj](https://github.com/varun369) (Solution Architect)
 **Project:** SuperLocalMemory V2
-**License:** MIT with attribution requirements (see [ATTRIBUTION.md](../../ATTRIBUTION.md))
+**License:** MIT (see [LICENSE](../../LICENSE))
 **Repository:** https://github.com/varun369/SuperLocalMemoryV2
 
 *Open source doesn't mean removing credit. Attribution must be preserved per MIT License terms.*

package/src/agent_registry.py

@@ -1,22 +1,12 @@
 #!/usr/bin/env python3
-"""
-SuperLocalMemory V2 - Agent Registry
-Copyright (c) 2026 Varun Pratap Bhardwaj
-Licensed under MIT License
-
-Repository: https://github.com/varun369/SuperLocalMemoryV2
-Author: Varun Pratap Bhardwaj (Solution Architect)
-
-NOTICE: This software is protected by MIT License.
-Attribution must be preserved in all copies or derivatives.
-"""
-
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 SuperLocalMemory (superlocalmemory.com)
 """
 AgentRegistry — Tracks which AI agents connect to SuperLocalMemory,
 what they write, when, and via which protocol.
 
-Every MCP client (Claude, Cursor, Windsurf), CLI call, REST API request,
-and future A2A agent gets registered here. This powers:
+Every MCP client (Claude, Cursor, Windsurf), CLI call, and REST API request
+gets registered here. This powers:
     - Dashboard "Connected Agents" panel
     - Trust scoring input (v2.5 silent collection)
     - Provenance tracking (who created which memory)
@@ -31,7 +21,6 @@ Protocols:
     cli     — Command-line interface (slm command, bin/ scripts)
     rest    — REST API (api_server.py)
     python  — Direct Python import
-    a2a     — Agent-to-Agent Protocol (v2.7+)
 """
 
 import json
@@ -155,7 +144,7 @@ class AgentRegistry:
         Args:
             agent_id: Unique identifier (e.g., "mcp:claude-desktop")
             agent_name: Human-readable name (e.g., "Claude Desktop")
-            protocol: Connection protocol (mcp, cli, rest, python, a2a)
+            protocol: Connection protocol (mcp, cli, rest, python)
             metadata: Additional agent info (version, capabilities, etc.)
 
         Returns:
@@ -164,7 +153,7 @@ class AgentRegistry:
         if not agent_id or not isinstance(agent_id, str):
             raise ValueError("agent_id must be a non-empty string")
 
-        valid_protocols = ("mcp", "cli", "rest", "python", "a2a")
+        valid_protocols = ("mcp", "cli", "rest", "python")
         if protocol not in valid_protocols:
             raise ValueError(f"Invalid protocol: {protocol}. Must be one of {valid_protocols}")
 
@@ -283,7 +272,7 @@ class AgentRegistry:
         List registered agents with optional filtering.
 
         Args:
-            protocol: Filter by protocol (mcp, cli, rest, python, a2a)
+            protocol: Filter by protocol (mcp, cli, rest, python)
             limit: Max agents to return
             active_since_hours: Only agents seen within N hours
 

package/src/auth_middleware.py

@@ -1,14 +1,12 @@
 #!/usr/bin/env python3
-"""
-SuperLocalMemory V2 - Optional API Key Authentication
-Copyright (c) 2026 Varun Pratap Bhardwaj
-Licensed under MIT License
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 SuperLocalMemory (superlocalmemory.com)
+"""SuperLocalMemory V2 - Optional API Key Authentication
 
 Opt-in API key authentication for dashboard and API endpoints.
 When ~/.claude-memory/api_key file exists, write endpoints require
 X-SLM-API-Key header. Read endpoints remain open for backward compatibility.
 """
-
 import os
 import hashlib
 import logging

package/src/auto_backup.py

@@ -1,10 +1,7 @@
 #!/usr/bin/env python3
-"""
-SuperLocalMemory V2 - Auto Backup System
-Copyright (c) 2026 Varun Pratap Bhardwaj
-Licensed under MIT License
-
-Repository: https://github.com/varun369/SuperLocalMemoryV2
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 SuperLocalMemory (superlocalmemory.com)
+"""SuperLocalMemory V2 - Auto Backup System
 
 Automated backup system for memory.db:
 - Configurable interval: 24h (daily) or 7 days (weekly, default)
@@ -13,7 +10,6 @@ Automated backup system for memory.db:
 - Auto-triggers on memory operations when backup is due
 - Manual backup via CLI
 """
-
 import sqlite3
 import shutil
 import json

package/src/behavioral/__init__.py

@@ -0,0 +1,49 @@
+# SPDX-License-Identifier: MIT
+# Copyright (c) 2026 SuperLocalMemory (superlocalmemory.com)
+"""SLM v2.8 Behavioral Learning Engine — Action Outcome Learning.
+
+Tracks what happens AFTER memories are recalled (success/failure/partial).
+Extracts behavioral patterns. Transfers across projects (privacy-safe).
+All local, zero-LLM.
+
+Graceful degradation: if this module fails to import,
+adaptive ranking continues with v2.7 features only.
+"""
+import threading
+from pathlib import Path
+from typing import Optional, Dict, Any
+
+BEHAVIORAL_AVAILABLE = False
+_init_error = None
+
+try:
+    from .outcome_tracker import OutcomeTracker
+    from .behavioral_patterns import BehavioralPatternExtractor
+    BEHAVIORAL_AVAILABLE = True
+except ImportError as e:
+    _init_error = str(e)
+
+_outcome_tracker: Optional["OutcomeTracker"] = None
+_tracker_lock = threading.Lock()
+
+
+def get_outcome_tracker(db_path: Optional[Path] = None) -> Optional["OutcomeTracker"]:
+    """Get or create the outcome tracker singleton."""
+    global _outcome_tracker
+    if not BEHAVIORAL_AVAILABLE:
+        return None
+    with _tracker_lock:
+        if _outcome_tracker is None:
+            try:
+                _outcome_tracker = OutcomeTracker(db_path)
+            except Exception:
+                return None
+        return _outcome_tracker
+
+
+def get_status() -> Dict[str, Any]:
+    return {
+        "behavioral_available": BEHAVIORAL_AVAILABLE,
+        "init_error": _init_error,
+        "tracker_active": _outcome_tracker is not None,
+    }