superlocalmemory 2.7.5 → 2.8.0

package/install.sh

@@ -164,6 +164,27 @@ if [ -d "${REPO_DIR}/src/learning" ]; then
     echo "✓ Learning modules copied"
 fi
 
+# Copy lifecycle modules (v2.8+)
+if [ -d "${REPO_DIR}/src/lifecycle" ]; then
+    mkdir -p "${INSTALL_DIR}/lifecycle"
+    cp -r "${REPO_DIR}/src/lifecycle/"* "${INSTALL_DIR}/lifecycle/"
+    echo "✓ Lifecycle modules copied"
+fi
+
+# Copy behavioral modules (v2.8+)
+if [ -d "${REPO_DIR}/src/behavioral" ]; then
+    mkdir -p "${INSTALL_DIR}/behavioral"
+    cp -r "${REPO_DIR}/src/behavioral/"* "${INSTALL_DIR}/behavioral/"
+    echo "✓ Behavioral modules copied"
+fi
+
+# Copy compliance modules (v2.8+)
+if [ -d "${REPO_DIR}/src/compliance" ]; then
+    mkdir -p "${INSTALL_DIR}/compliance"
+    cp -r "${REPO_DIR}/src/compliance/"* "${INSTALL_DIR}/compliance/"
+    echo "✓ Compliance modules copied"
+fi
+
 # Copy hooks
 echo "Copying hooks..."
 mkdir -p "${INSTALL_DIR}/hooks"
@@ -230,8 +251,41 @@ mkdir -p "${INSTALL_DIR}/profiles"
 mkdir -p "${INSTALL_DIR}/vectors"
 mkdir -p "${INSTALL_DIR}/cold-storage"
 mkdir -p "${INSTALL_DIR}/jobs"
+mkdir -p "${INSTALL_DIR}/policies"
 echo "✓ Directories created"
 
+# Initialize audit database (v2.8+ — compliance engine)
+if [ ! -f "${INSTALL_DIR}/audit.db" ]; then
+    python3 -c "
+import sqlite3
+from pathlib import Path
+audit_path = Path.home() / '.claude-memory' / 'audit.db'
+conn = sqlite3.connect(audit_path)
+cursor = conn.cursor()
+cursor.execute('''CREATE TABLE IF NOT EXISTS audit_events (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    event_type TEXT NOT NULL,
+    actor TEXT,
+    target TEXT,
+    action TEXT,
+    detail TEXT,
+    hash TEXT,
+    prev_hash TEXT,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+)''')
+cursor.execute('''CREATE TABLE IF NOT EXISTS retention_policies (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    policy_name TEXT UNIQUE NOT NULL,
+    retention_days INTEGER,
+    auto_delete INTEGER DEFAULT 0,
+    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+)''')
+conn.commit()
+conn.close()
+print('Audit database ready')
+" 2>/dev/null && echo "✓ Audit database initialized (v2.8)" || echo "○ Audit database skipped (optional)"
+fi
+
 # Make Python scripts executable
 chmod +x "${INSTALL_DIR}/"*.py 2>/dev/null || true
 
@@ -799,6 +853,11 @@ echo "Learning System (v2.7+):"
 echo "  slm learning status              - Check learning system"
 echo "  slm engagement                   - View engagement metrics"
 echo ""
+echo "Lifecycle & Compliance (v2.8+):"
+echo "  slm lifecycle-status             - View memory lifecycle states"
+echo "  slm compact --dry-run            - Preview lifecycle transitions"
+echo "  slm behavioral-patterns          - View learned patterns"
+echo ""
 # Optional: Offer to install optional features
 if [ "$NON_INTERACTIVE" = true ]; then
     INSTALL_CHOICE="N"

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
@@ -1349,6 +1345,79 @@ 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."""
+        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)
 # ============================================================================
@@ -1586,6 +1655,13 @@ if __name__ == "__main__":
         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.5",
+  "version": "2.8.0",
   "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",
@@ -26,7 +26,7 @@
   ],
   "author": {
     "name": "Varun Pratap Bhardwaj",
-    "email": "varun369@users.noreply.github.com",
+    "email": "admin@superlocalmemory.com",
     "url": "https://github.com/varun369"
   },
   "license": "MIT",
@@ -90,17 +90,10 @@
   "maintainers": [
     {
       "name": "Varun Pratap Bhardwaj",
-      "email": "varun369@users.noreply.github.com",
+      "email": "admin@superlocalmemory.com",
       "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

@@ -342,7 +342,7 @@ date
 
 **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

@@ -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

@@ -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

@@ -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,
+    }