superlocalmemory 3.0.1 → 3.0.2

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-All notable changes to SuperLocalMemory V2 will be documented in this file.
+All notable changes to SuperLocalMemory V3 will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
@@ -12,7 +12,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 **Varun Pratap Bhardwaj**
 *Solution Architect*
 
-SuperLocalMemory V2 - Intelligent local memory system for AI coding assistants.
+SuperLocalMemory V3 - Intelligent local memory system for AI coding assistants.
 
 ---
 
@@ -302,7 +302,7 @@ SuperLocalMemory now works across 16+ IDEs and CLI tools.
 
 ### Initial Release — Complete Rewrite
 
-SuperLocalMemory V2 represents a complete architectural rewrite with intelligent knowledge graphs, pattern learning, and enhanced organization.
+SuperLocalMemory V3 represents a complete architectural rewrite with intelligent knowledge graphs, pattern learning, and enhanced organization.
 
 ### Added
 - **4-Layer Architecture** — Storage, Hierarchical Index, Knowledge Graph, Pattern Learning
@@ -329,7 +329,7 @@ We use [Semantic Versioning](https://semver.org/):
 
 ## License
 
-SuperLocalMemory V2 is released under the [MIT License](LICENSE).
+SuperLocalMemory V3 is released under the [MIT License](LICENSE).
 
 ---
 

package/docs/v2-archive/ACCESSIBILITY.md

@@ -282,7 +282,7 @@ var lastFocusedElement = null;         // For modal focus return
 
 If you encounter accessibility issues, please report them:
 
-- **GitHub Issues:** https://github.com/varun369/SuperLocalMemoryV2/issues
+- **GitHub Issues:** https://github.com/qualixar/superlocalmemory/issues
 - **Label:** Use `accessibility` tag
 - **Include:** Browser, screen reader (if applicable), and steps to reproduce
 

package/docs/v2-archive/ARCHITECTURE.md

@@ -867,8 +867,8 @@ SuperLocalMemory V2's architecture provides:
 - [CLI Commands Reference](CLI-COMMANDS-REFERENCE.md)
 - [MCP Troubleshooting](MCP-TROUBLESHOOTING.md)
 - [Universal Integration Guide](UNIVERSAL-INTEGRATION.md)
-- [Wiki: Knowledge Graph Guide](https://github.com/varun369/SuperLocalMemoryV2/wiki/Knowledge-Graph-Guide)
-- [Wiki: Pattern Learning](https://github.com/varun369/SuperLocalMemoryV2/wiki/Pattern-Learning-Explained)
+- [Wiki: Knowledge Graph Guide](https://github.com/qualixar/superlocalmemory/wiki/Knowledge-Graph-Guide)
+- [Wiki: Pattern Learning](https://github.com/qualixar/superlocalmemory/wiki/Pattern-Learning-Explained)
 
 ---
 

package/docs/v2-archive/FRAMEWORK-INTEGRATIONS.md

@@ -287,8 +287,8 @@ superlocalmemoryv2-profile create work
 
 ## Learn More
 
-- **[LangChain Wiki Guide](https://github.com/varun369/SuperLocalMemoryV2/wiki/LangChain-Integration)** — Full integration tutorial
-- **[LlamaIndex Wiki Guide](https://github.com/varun369/SuperLocalMemoryV2/wiki/LlamaIndex-Integration)** — Complete setup guide
+- **[LangChain Wiki Guide](https://github.com/qualixar/superlocalmemory/wiki/LangChain-Integration)** — Full integration tutorial
+- **[LlamaIndex Wiki Guide](https://github.com/qualixar/superlocalmemory/wiki/LlamaIndex-Integration)** — Complete setup guide
 - **[API Reference](API-REFERENCE.md)** — Python API documentation
 - **[Profiles Guide](PROFILES-GUIDE.md)** — Multi-context management
 

package/docs/v2-archive/MCP-MANUAL-SETUP.md

@@ -764,8 +764,8 @@ Plus **2 MCP prompts** and **6 MCP resources** for advanced use.
 
 1. **Check logs:** Most IDEs have MCP server logs in their developer tools
 2. **Test manually:** Run `python3 ~/.claude-memory/mcp_server.py` to see errors
-3. **GitHub Issues:** https://github.com/varun369/SuperLocalMemoryV2/issues
-4. **Documentation:** https://github.com/varun369/SuperLocalMemoryV2
+3. **GitHub Issues:** https://github.com/qualixar/superlocalmemory/issues
+4. **Documentation:** https://github.com/qualixar/superlocalmemory
 
 ---
 

package/docs/v2-archive/MCP-TROUBLESHOOTING.md

@@ -119,7 +119,7 @@ ls -la ~/.claude-memory/pattern_learner.py
 **Fix:**
 1. Verify installation:
    ```bash
-   cd ~/path/to/SuperLocalMemoryV2
+   cd ~/path/to/superlocalmemory
    ./install.sh
    ```
 
@@ -298,7 +298,7 @@ ls -la ~/.claude-memory/*.py
 
 **If files missing:**
 ```bash
-cd ~/path/to/SuperLocalMemoryV2-repo
+cd ~/path/to/superlocalmemory-repo
 ./install.sh
 ```
 
@@ -714,7 +714,7 @@ If auto-configuration fails completely, manually add to your IDE's config:
 2. ✅ **Test server manually:** `python3 ~/.claude-memory/mcp_server.py`
 3. ✅ **Verify config is valid JSON**
 4. ✅ **Try manual configuration** (see above)
-5. ✅ **Search existing issues:** https://github.com/varun369/SuperLocalMemoryV2/issues
+5. ✅ **Search existing issues:** https://github.com/qualixar/superlocalmemory/issues
 
 ### Opening an Issue
 

package/docs/v2-archive/SEARCH-ENGINE-V2.2.0.md

@@ -744,6 +744,6 @@ MIT License - See [LICENSE](../LICENSE) file
 
 ---
 
-**Project:** [SuperLocalMemory V2](https://github.com/varun369/SuperLocalMemoryV2)
-**Documentation:** [Full Docs](https://github.com/varun369/SuperLocalMemoryV2/wiki)
-**Issues:** [Report Issues](https://github.com/varun369/SuperLocalMemoryV2/issues)
+**Project:** [SuperLocalMemory V2](https://github.com/qualixar/superlocalmemory)
+**Documentation:** [Full Docs](https://github.com/qualixar/superlocalmemory/wiki)
+**Issues:** [Report Issues](https://github.com/qualixar/superlocalmemory/issues)

package/docs/v2-archive/SEARCH-INTEGRATION-GUIDE.md

@@ -494,7 +494,7 @@ pip install scikit-learn numpy
 - [API Reference](API-REFERENCE.md)
 - [Main README](../README.md)
 
-**Issues:** [GitHub Issues](https://github.com/varun369/SuperLocalMemoryV2/issues)
+**Issues:** [GitHub Issues](https://github.com/qualixar/superlocalmemory/issues)
 
 ---
 

package/docs/v2-archive/UNIVERSAL-INTEGRATION.md

@@ -16,8 +16,8 @@ SuperLocalMemory V2 now works across **16+ IDEs and CLI tools** with automatic d
 
 ### Step 1: Install
 ```bash
-git clone https://github.com/varun369/SuperLocalMemoryV2.git
-cd SuperLocalMemoryV2
+git clone https://github.com/qualixar/superlocalmemory.git
+cd superlocalmemory
 ./install.sh
 ```
 
@@ -481,7 +481,7 @@ python3 ~/.claude-memory/mcp_server.py --transport http --port 8001
 
 ---
 
-**Questions?** Open an issue: https://github.com/varun369/SuperLocalMemoryV2/issues
+**Questions?** Open an issue: https://github.com/qualixar/superlocalmemory/issues
 
 **Version:** 2.4.1
 **Author:** Varun Pratap Bhardwaj

package/docs/v2-archive/V2.2.0-OPTIONAL-SEARCH.md

@@ -656,8 +656,8 @@ index = HNSWIndex(
 ## Support
 
 For issues, questions, or contributions:
-- **GitHub Issues:** https://github.com/varun369/SuperLocalMemoryV2/issues
-- **Documentation:** https://github.com/varun369/SuperLocalMemoryV2/wiki
+- **GitHub Issues:** https://github.com/qualixar/superlocalmemory/issues
+- **Documentation:** https://github.com/qualixar/superlocalmemory/wiki
 
 ---
 

package/ide/integrations/langchain/README.md

@@ -1,13 +1,13 @@
 # langchain-superlocalmemory
 
-LangChain chat message history backed by [SuperLocalMemory V2](https://github.com/varun369/SuperLocalMemoryV2) -- 100% local, zero cloud.
+LangChain chat message history backed by [SuperLocalMemory V2](https://github.com/qualixar/superlocalmemory) -- 100% local, zero cloud.
 
 Every message stays on your machine in a SQLite database. No API keys, no subscriptions, no telemetry.
 
 ## Prerequisites
 
 - Python 3.10+
-- [SuperLocalMemory V2](https://github.com/varun369/SuperLocalMemoryV2) installed (`~/.claude-memory/` must exist)
+- [SuperLocalMemory V2](https://github.com/qualixar/superlocalmemory) installed (`~/.claude-memory/` must exist)
 - `langchain-core >= 1.0.0`
 
 ## Installation
@@ -101,6 +101,6 @@ MIT -- see [LICENSE](../../LICENSE) for details.
 
 ## Links
 
-- [SuperLocalMemory V2 Repository](https://github.com/varun369/SuperLocalMemoryV2)
+- [SuperLocalMemory V2 Repository](https://github.com/qualixar/superlocalmemory)
 - [Documentation](https://superlocalmemory.com/)
 - [LangChain Documentation](https://python.langchain.com/)

package/ide/integrations/langchain/langchain_superlocalmemory/chat_message_history.py

@@ -61,7 +61,7 @@ def _ensure_slm_imported():
     except ImportError as exc:
         raise ImportError(
             "SuperLocalMemory V2 is not installed. "
-            "Run the installer from https://github.com/varun369/SuperLocalMemoryV2 "
+            "Run the installer from https://github.com/qualixar/superlocalmemory "
             "or ensure ~/.claude-memory/memory_store_v2.py exists."
         ) from exc
 

package/ide/integrations/llamaindex/README.md

@@ -1,6 +1,6 @@
 # LlamaIndex Chat Store — SuperLocalMemory V2
 
-A LlamaIndex `BaseChatStore` implementation backed by [SuperLocalMemory V2](https://github.com/varun369/SuperLocalMemoryV2). All chat history stays **100% local** on your machine — zero cloud calls, zero telemetry, zero API keys.
+A LlamaIndex `BaseChatStore` implementation backed by [SuperLocalMemory V2](https://github.com/qualixar/superlocalmemory). All chat history stays **100% local** on your machine — zero cloud calls, zero telemetry, zero API keys.
 
 ## Prerequisites
 
@@ -9,7 +9,7 @@ A LlamaIndex `BaseChatStore` implementation backed by [SuperLocalMemory V2](http
 
 ```bash
 # Install SuperLocalMemory V2 (one-time)
-curl -fsSL https://raw.githubusercontent.com/varun369/SuperLocalMemoryV2/main/install.sh | bash
+curl -fsSL https://raw.githubusercontent.com/qualixar/superlocalmemory/main/install.sh | bash
 ```
 
 ## Installation
@@ -76,6 +76,6 @@ chat_store = SuperLocalMemoryChatStore(db_path="/path/to/custom/memory.db")
 
 ## Links
 
-- [SuperLocalMemory V2](https://github.com/varun369/SuperLocalMemoryV2)
+- [SuperLocalMemory V2](https://github.com/qualixar/superlocalmemory)
 - [LlamaIndex Documentation](https://docs.llamaindex.ai/)
 - [LlamaIndex Chat Stores Guide](https://docs.llamaindex.ai/en/stable/module_guides/storing/chat_stores/)

package/ide/integrations/llamaindex/llama_index/storage/chat_store/superlocalmemory/base.py

@@ -39,8 +39,8 @@ try:
 except ImportError as exc:
     raise ImportError(
         "SuperLocalMemory V2 is not installed. "
-        "Run: curl -fsSL https://raw.githubusercontent.com/varun369/SuperLocalMemoryV2/main/install.sh | bash\n"
-        "Or visit: https://github.com/varun369/SuperLocalMemoryV2"
+        "Run: curl -fsSL https://raw.githubusercontent.com/qualixar/superlocalmemory/main/install.sh | bash\n"
+        "Or visit: https://github.com/qualixar/superlocalmemory"
     ) from exc
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superlocalmemory",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "Information-geometric agent memory with mathematical guarantees. 4-channel retrieval, Fisher-Rao similarity, zero-LLM mode, EU AI Act compliant. Works with Claude, Cursor, Windsurf, and 17+ AI tools.",
   "keywords": [
     "ai-memory",

package/scripts/postinstall.js

@@ -1,126 +1,60 @@
 #!/usr/bin/env node
 /**
- * SuperLocalMemory V2 - NPM Postinstall Script
+ * SuperLocalMemory V3 - NPM Postinstall Script
  *
- * Copyright (c) 2026 Varun Pratap Bhardwaj
- * Solution Architect & Original Creator
- *
- * Licensed under MIT License (see LICENSE file)
- * Repository: https://github.com/varun369/SuperLocalMemoryV2
- *
- * ATTRIBUTION REQUIRED: This notice must be preserved in all copies.
+ * Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
+ * Licensed under MIT License
+ * Repository: https://github.com/qualixar/superlocalmemory
  */
 
-const { spawnSync } = require('child_process');
 const path = require('path');
 const os = require('os');
 const fs = require('fs');
 
 console.log('\n════════════════════════════════════════════════════════════');
-console.log('  SuperLocalMemory V2 - Post-Installation');
-console.log('  by Varun Pratap Bhardwaj');
-console.log('  https://github.com/varun369/SuperLocalMemoryV2');
+console.log('  SuperLocalMemory V3 - Post-Installation');
+console.log('  by Varun Pratap Bhardwaj / Qualixar');
+console.log('  https://github.com/qualixar/superlocalmemory');
 console.log('════════════════════════════════════════════════════════════\n');
 
-// Detect if this is a global install
-const isGlobal = process.env.npm_config_global === 'true' ||
-                 process.env.npm_config_global === true ||
-                 (process.env.npm_config_prefix && !process.env.npm_config_prefix.includes('node_modules'));
-
-if (!isGlobal) {
-    console.log('📦 Local installation detected.');
-    console.log('   SuperLocalMemory is designed for global installation.');
-    console.log('   Run: npm install -g superlocalmemory');
-    console.log('');
-    console.log('⏩ Skipping system installation for local install.');
-    console.log('');
-    process.exit(0);
-}
-
-console.log('🌍 Global installation detected. Running system setup...\n');
-
-// Find the package root (where install.sh/install.ps1 lives)
-const packageRoot = path.join(__dirname, '..');
-const installScript = os.platform() === 'win32'
-    ? path.join(packageRoot, 'scripts', 'install.ps1')
-    : path.join(packageRoot, 'scripts', 'install.sh');
-
-// Check if install script exists
-if (!fs.existsSync(installScript)) {
-    console.error('❌ Error: Install script not found at ' + installScript);
-    console.error('   Package may be corrupted. Please reinstall:');
-    console.error('   npm uninstall -g superlocalmemory');
-    console.error('   npm install -g superlocalmemory');
-    process.exit(1);
-}
-
-// Run the appropriate install script
-console.log('Running installer: ' + path.basename(installScript));
-console.log('This will:');
-console.log('  • Copy files to ~/.claude-memory/');
-console.log('  • Configure MCP for 16+ AI tools');
-console.log('  • Install universal skills');
-console.log('  • Set up CLI commands\n');
-
-let result;
+// V3 data directory
+const SLM_HOME = path.join(os.homedir(), '.superlocalmemory');
+const V2_HOME = path.join(os.homedir(), '.claude-memory');
 
-if (os.platform() === 'win32') {
-    // Windows: Run PowerShell script
-    console.log('Platform: Windows (PowerShell)\n');
-    result = spawnSync('powershell', [
-        '-ExecutionPolicy', 'Bypass',
-        '-File', installScript,
-        '--non-interactive'
-    ], {
-        stdio: 'inherit',
-        cwd: packageRoot
-    });
+// Ensure V3 data directory exists
+if (!fs.existsSync(SLM_HOME)) {
+    fs.mkdirSync(SLM_HOME, { recursive: true });
+    console.log('✓ Created data directory: ' + SLM_HOME);
 } else {
-    // Mac/Linux: Run bash script
-    console.log('Platform: ' + (os.platform() === 'darwin' ? 'macOS' : 'Linux') + ' (Bash)\n');
-    result = spawnSync('bash', [installScript, '--non-interactive'], {
-        stdio: 'inherit',
-        cwd: packageRoot
-    });
+    console.log('✓ Data directory exists: ' + SLM_HOME);
 }
 
-if (result.error) {
-    console.error('\n❌ Installation failed with error:', result.error.message);
-    console.error('\nPlease run the install script manually:');
-    if (os.platform() === 'win32') {
-        console.error('  powershell -ExecutionPolicy Bypass -File "' + installScript + '"');
-    } else {
-        console.error('  bash "' + installScript + '"');
-    }
-    process.exit(1);
-}
-
-if (result.status !== 0) {
-    console.error('\n❌ Installation script exited with code ' + result.status);
-    console.error('\nPlease run the install script manually:');
-    if (os.platform() === 'win32') {
-        console.error('  powershell -ExecutionPolicy Bypass -File "' + installScript + '"');
-    } else {
-        console.error('  bash "' + installScript + '"');
-    }
-    process.exit(result.status);
+// Detect V2 installation
+if (fs.existsSync(V2_HOME) && fs.existsSync(path.join(V2_HOME, 'memory.db'))) {
+    console.log('');
+    console.log('╔══════════════════════════════════════════════════════════╗');
+    console.log('║  V2 Installation Detected                                ║');
+    console.log('╚══════════════════════════════════════════════════════════╝');
+    console.log('');
+    console.log('  Found V2 data at: ' + V2_HOME);
+    console.log('  Your memories are safe and will NOT be deleted.');
+    console.log('');
+    console.log('  To migrate V2 data to V3, run:');
+    console.log('    slm migrate');
+    console.log('');
+    console.log('  Read the migration guide:');
+    console.log('    https://github.com/qualixar/superlocalmemory/wiki/Migration-from-V2');
+    console.log('');
 }
 
-console.log('\n════════════════════════════════════════════════════════════');
-console.log('  ✅ SuperLocalMemory V2 installed successfully!');
+console.log('════════════════════════════════════════════════════════════');
+console.log('  ✓ SuperLocalMemory V3 installed successfully!');
+console.log('');
+console.log('  Quick start:');
+console.log('    slm setup          # First-time configuration');
+console.log('    slm status         # Check system status');
+console.log('    slm remember "..." # Store a memory');
+console.log('    slm recall "..."   # Search memories');
+console.log('');
+console.log('  Documentation: https://github.com/qualixar/superlocalmemory/wiki');
 console.log('════════════════════════════════════════════════════════════\n');
-
-console.log('Quick Start:');
-console.log('  slm remember "Your first memory"');
-console.log('  slm recall "search query"');
-console.log('  slm status');
-console.log('  slm help\n');
-
-console.log('Documentation:');
-console.log('  README: https://github.com/varun369/SuperLocalMemoryV2');
-console.log('  Wiki: https://github.com/varun369/SuperLocalMemoryV2/wiki');
-console.log('  Local: ~/.claude-memory/\n');
-
-console.log('MCP Integration:');
-console.log('  Auto-configured for: Claude Desktop, Cursor, Windsurf, etc.');
-console.log('  Restart your AI tool to activate.\n');

package/scripts/preuninstall.js

@@ -6,7 +6,7 @@
  * Solution Architect & Original Creator
  *
  * Licensed under MIT License (see LICENSE file)
- * Repository: https://github.com/varun369/SuperLocalMemoryV2
+ * Repository: https://github.com/qualixar/superlocalmemory
  *
  * ATTRIBUTION REQUIRED: This notice must be preserved in all copies.
  */

package/src/superlocalmemory.egg-info/PKG-INFO

@@ -0,0 +1,304 @@
+Metadata-Version: 2.4
+Name: superlocalmemory
+Version: 3.0.0
+Summary: Information-geometric agent memory with mathematical guarantees
+Author-email: Varun Pratap Bhardwaj <admin@superlocalmemory.com>
+License: MIT
+Project-URL: Homepage, https://superlocalmemory.com
+Project-URL: Repository, https://github.com/qualixar/superlocalmemory
+Project-URL: Documentation, https://github.com/qualixar/superlocalmemory/wiki
+Project-URL: Issues, https://github.com/qualixar/superlocalmemory/issues
+Keywords: ai-memory,mcp-server,local-first,agent-memory,information-geometry,privacy-first,eu-ai-act
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+License-File: AUTHORS.md
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: numpy<3.0.0,>=1.26.0
+Requires-Dist: scipy<2.0.0,>=1.12.0
+Requires-Dist: networkx>=3.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: python-dateutil>=2.9.0.post0
+Requires-Dist: rank-bm25>=0.2.2
+Requires-Dist: vadersentiment>=3.3.2
+Provides-Extra: search
+Requires-Dist: sentence-transformers<4.0.0,>=2.5.0; extra == "search"
+Requires-Dist: torch>=2.2.0; extra == "search"
+Requires-Dist: scikit-learn<2.0.0,>=1.3.0; extra == "search"
+Requires-Dist: geoopt>=0.5.0; extra == "search"
+Provides-Extra: ui
+Requires-Dist: fastapi<1.0.0,>=0.109.0; extra == "ui"
+Requires-Dist: uvicorn[standard]<1.0.0,>=0.27.0; extra == "ui"
+Requires-Dist: python-multipart<1.0.0,>=0.0.6; extra == "ui"
+Provides-Extra: learning
+Requires-Dist: lightgbm<5.0.0,>=4.0.0; extra == "learning"
+Provides-Extra: performance
+Requires-Dist: diskcache<6.0.0,>=5.6.0; extra == "performance"
+Requires-Dist: orjson<4.0.0,>=3.9.0; extra == "performance"
+Provides-Extra: full
+Requires-Dist: superlocalmemory[learning,performance,search,ui]; extra == "full"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+  <img src="https://superlocalmemory.com/assets/logo-mark.png" alt="SuperLocalMemory" width="200"/>
+</p>
+
+<h1 align="center">SuperLocalMemory V3</h1>
+<p align="center"><strong>Information-Geometric Agent Memory with Mathematical Guarantees</strong></p>
+
+<p align="center">
+  The first agent memory system with mathematically grounded retrieval, lifecycle management, and consistency verification. Four-channel hybrid retrieval. Three operating modes. EU AI Act compliant.
+</p>
+
+<p align="center">
+  <a href="https://superlocalmemory.com"><img src="https://img.shields.io/badge/Website-superlocalmemory.com-ff6b35?style=for-the-badge" alt="Website"/></a>
+  <a href="https://arxiv.org/abs/2603.02240"><img src="https://img.shields.io/badge/arXiv-2603.02240-b31b1b?style=for-the-badge&logo=arxiv&logoColor=white" alt="arXiv Paper"/></a>
+  <a href="https://zenodo.org/records/19038659"><img src="https://img.shields.io/badge/DOI-10.5281%2Fzenodo.19038659-blue?style=for-the-badge&logo=doi&logoColor=white" alt="V3 DOI"/></a>
+</p>
+
+<p align="center">
+  <a href="https://www.python.org/downloads/"><img src="https://img.shields.io/badge/python-3.11+-3776AB?style=flat-square&logo=python&logoColor=white" alt="Python 3.11+"/></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="MIT License"/></a>
+  <a href="#three-operating-modes"><img src="https://img.shields.io/badge/EU_AI_Act-Compliant-brightgreen?style=flat-square" alt="EU AI Act"/></a>
+  <a href="#"><img src="https://img.shields.io/badge/tests-1400+-brightgreen?style=flat-square" alt="1400+ Tests"/></a>
+  <a href="#"><img src="https://img.shields.io/badge/platform-Mac_|_Linux_|_Windows-blue?style=flat-square" alt="Cross Platform"/></a>
+  <a href="https://github.com/qualixar/superlocalmemory/wiki"><img src="https://img.shields.io/badge/Wiki-Documentation-blue?style=flat-square" alt="Wiki"/></a>
+</p>
+
+---
+
+## What is SuperLocalMemory?
+
+SuperLocalMemory gives AI assistants persistent, structured memory that survives across sessions. Unlike simple vector stores, V3 uses **information geometry** to provide mathematically grounded retrieval, automatic contradiction detection, and self-organizing memory lifecycle management.
+
+**Works with:** Claude, Cursor, Windsurf, VS Code Copilot, Continue, Cody, ChatGPT Desktop, Gemini CLI, JetBrains, Zed, and 17+ AI tools via MCP.
+
+> **Upgrading from V2 (2.8.6)?** V3 is a complete architectural reinvention — new mathematical engine, new retrieval pipeline, new storage schema. Your existing data is preserved but requires migration. After installing V3, run `slm migrate` to upgrade your data. Read the [Migration Guide](docs/migration-from-v2.md) before upgrading. Backup is created automatically.
+
+### Key Results
+
+| Metric | Score | Context |
+|:-------|:-----:|:--------|
+| LoCoMo (Mode A, zero-LLM) | **62.3%** | Highest zero-LLM score. No cloud dependency. |
+| LoCoMo (Mode C, full) | **~78%** | Competitive with funded systems ($10M+) |
+| Math layer improvement | **+12.7pp** | Average gain from mathematical foundations |
+| Multi-hop improvement | **+12pp** | 50% vs 38% (math on vs off) |
+
+---
+
+## Three Operating Modes
+
+| Mode | What | LLM Required? | EU AI Act | Best For |
+|:----:|:-----|:-------------:|:---------:|:---------|
+| **A** | Local Guardian | No | Compliant | Privacy-first, air-gapped, enterprise |
+| **B** | Smart Local | Local only (Ollama) | Compliant | Enhanced quality, data stays local |
+| **C** | Full Power | Cloud (optional) | Partial | Maximum accuracy, research |
+
+**Mode A** is the only agent memory that operates with **zero cloud dependency** while achieving competitive retrieval accuracy. All data stays on your device. No API keys required.
+
+---
+
+## Architecture
+
+```
+Query  ──►  Strategy Classifier  ──►  4 Parallel Channels:
+                                       ├── Semantic (Fisher-Rao graduated similarity)
+                                       ├── BM25 (keyword matching, k1=1.2, b=0.75)
+                                       ├── Entity Graph (spreading activation, 3 hops)
+                                       └── Temporal (date-aware retrieval)
+                                                    │
+                                       RRF Fusion (k=60)
+                                                    │
+                                       Scene Expansion + Bridge Discovery
+                                                    │
+                                       Cross-Encoder Reranking
+                                                    │
+                                       ◄── Top-K Results with channel scores
+```
+
+### Mathematical Foundations (Novel Contributions)
+
+1. **Fisher-Rao Retrieval Metric** — Similarity scoring derived from the Fisher information structure of diagonal Gaussian families. Graduated ramp from cosine to Fisher-information-weighted scoring over the first 10 accesses per memory.
+
+2. **Sheaf Cohomology for Consistency** — Algebraic topology detects contradictions between facts by computing coboundary norms on the knowledge graph. Non-trivial restriction maps amplify disagreements along discriminative subspaces.
+
+3. **Riemannian Langevin Lifecycle** — Memory positions evolve on the Poincare ball via a discretized Langevin SDE. Frequently accessed memories stay near the origin (ACTIVE); neglected memories diffuse toward the boundary (ARCHIVED). The potential is modulated by access frequency, age, and importance.
+
+---
+
+## Quick Start
+
+### Install via npm (recommended)
+
+```bash
+npm install -g superlocalmemory
+slm setup
+```
+
+### Install via pip
+
+```bash
+pip install superlocalmemory
+# or with all features:
+pip install "superlocalmemory[full]"
+```
+
+### First Use
+
+```bash
+# Store a memory
+slm remember "Alice works at Google as a Staff Engineer"
+
+# Recall
+slm recall "What does Alice do?"
+
+# Check status
+slm status
+
+# Switch modes
+slm mode a   # Zero-LLM (default)
+slm mode b   # Local Ollama
+slm mode c   # Full power
+```
+
+### MCP Integration (Claude, Cursor, etc.)
+
+Add to your IDE's MCP config:
+
+```json
+{
+  "mcpServers": {
+    "superlocalmemory": {
+      "command": "slm",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+24 MCP tools available: `remember`, `recall`, `search`, `fetch`, `list_recent`, `get_status`, `build_graph`, `switch_profile`, `health`, `consistency_check`, `recall_trace`, and more.
+
+---
+
+## V3 Engine Features
+
+### Retrieval (4-Channel Hybrid)
+- Semantic similarity with Fisher-Rao information geometry
+- BM25 keyword matching (persisted tokens, survives restart)
+- Entity graph with spreading activation (3-hop, decay=0.7)
+- Temporal date-aware retrieval with interval support
+- RRF fusion (k=60) + cross-encoder reranking
+
+### Intelligence
+- 11-step ingestion pipeline (entity resolution, fact extraction, emotional tagging, scene building, sheaf consistency)
+- Adaptive learning with LightGBM-based ranking (3-phase bootstrap)
+- Behavioral pattern detection (query habits, entity preferences, active hours)
+- Outcome tracking for retrieval feedback loops
+
+### Trust & Compliance
+- Bayesian Beta distribution trust scoring (per-agent, per-fact)
+- Trust gates (block low-trust agents from writing/deleting)
+- ABAC (Attribute-Based Access Control) with DB-persisted policies
+- GDPR Article 15/17 compliance (full export + complete erasure)
+- EU AI Act data sovereignty (Mode A: zero cloud, data stays local)
+- Tamper-proof hash-chain audit trail (SHA-256 linked entries)
+- Data provenance tracking (who created what, when, from where)
+
+### Infrastructure
+- 17-tab web dashboard (trust visualization, math health, recall lab)
+- 17+ IDE integrations with pre-built configs
+- Profile isolation (16+ independent memory spaces)
+- V2 to V3 migration tool (zero data loss, rollback support)
+- Auto-capture and auto-recall hooks for Claude Code
+
+---
+
+## Benchmarks
+
+Evaluated on the [LoCoMo benchmark](https://arxiv.org/abs/2402.09714) (Long Conversation Memory):
+
+### Mode A Ablation (conv-30, 81 questions, zero-LLM)
+
+| Configuration | Micro Avg | Multi-Hop | Open Domain |
+|:-------------|:---------:|:---------:|:-----------:|
+| Full (all layers) | **62.3%** | **50%** | **78%** |
+| Math layers off | 59.3% | 38% | 70% |
+| Entity channel off | 56.8% | 38% | 73% |
+| BM25 channel off | 53.2% | 23% | 71% |
+| Cross-encoder off | 31.8% | 17% | — |
+
+### Competitive Landscape
+
+| System | Score | LLM Required | Open Source | EU AI Act |
+|:-------|:-----:|:------------:|:-----------:|:---------:|
+| EverMemOS | 92.3% | Yes | No | No |
+| MemMachine | 91.7% | Yes | No | No |
+| Hindsight | 89.6% | Yes | No | No |
+| **SLM V3 Mode C** | **~78%** | Optional | **Yes** | Partial |
+| **SLM V3 Mode A** | **62.3%** | **No** | **Yes** | **Yes** |
+| Mem0 ($24M) | 34.2% F1 | Yes | Partial | No |
+
+*SLM V3 is the only system offering a fully local mode with mathematical guarantees and EU AI Act compliance.*
+
+---
+
+## Research Papers
+
+### V3: Information-Geometric Foundations
+> **SuperLocalMemory V3: Information-Geometric Foundations for Zero-LLM Enterprise Agent Memory**
+> Varun Pratap Bhardwaj (2026)
+> [Zenodo DOI: 10.5281/zenodo.19038659](https://zenodo.org/records/19038659)
+
+### V2: Architecture & Engineering
+> **SuperLocalMemory: A Structured Local Memory Architecture for Persistent AI Agent Context**
+> Varun Pratap Bhardwaj (2026)
+> [arXiv:2603.02240](https://arxiv.org/abs/2603.02240) | [Zenodo DOI: 10.5281/zenodo.18709670](https://zenodo.org/records/18709670)
+
+---
+
+## Project Structure
+
+```
+superlocalmemory/
+├── src/superlocalmemory/     # Python package (17 sub-packages)
+│   ├── core/                 # Engine, config, modes, profiles
+│   ├── retrieval/            # 4-channel retrieval + fusion + reranking
+│   ├── math/                 # Fisher-Rao, Sheaf, Langevin
+│   ├── encoding/             # 11-step ingestion pipeline
+│   ├── storage/              # SQLite with WAL, FTS5, migrations
+│   ├── trust/                # Bayesian scoring, gates, provenance
+│   ├── compliance/           # GDPR, EU AI Act, ABAC, audit chain
+│   ├── learning/             # Adaptive ranking, behavioral patterns
+│   ├── mcp/                  # MCP server (24 tools, 6 resources)
+│   ├── cli/                  # CLI with setup wizard
+│   └── server/               # Dashboard API + UI server
+├── tests/                    # 1400+ tests
+├── ui/                       # 17-tab web dashboard
+├── ide/                      # IDE configs for 17+ tools
+├── docs/                     # Documentation
+└── pyproject.toml            # Modern Python packaging
+```
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT License. See [LICENSE](LICENSE).
+
+## Attribution
+
+Part of [Qualixar](https://qualixar.com) | Author: [Varun Pratap Bhardwaj](https://varunpratap.com)
+
+---
+
+<p align="center">
+  <sub>Built with mathematical rigor. Not in the race — here to help everyone build better AI memory systems.</sub>
+</p>

package/src/superlocalmemory.egg-info/SOURCES.txt

@@ -0,0 +1,158 @@
+AUTHORS.md
+LICENSE
+NOTICE
+README.md
+pyproject.toml
+src/superlocalmemory/__init__.py
+src/superlocalmemory.egg-info/PKG-INFO
+src/superlocalmemory.egg-info/SOURCES.txt
+src/superlocalmemory.egg-info/dependency_links.txt
+src/superlocalmemory.egg-info/entry_points.txt
+src/superlocalmemory.egg-info/requires.txt
+src/superlocalmemory.egg-info/top_level.txt
+src/superlocalmemory/attribution/__init__.py
+src/superlocalmemory/attribution/mathematical_dna.py
+src/superlocalmemory/attribution/signer.py
+src/superlocalmemory/attribution/watermark.py
+src/superlocalmemory/cli/__init__.py
+src/superlocalmemory/cli/commands.py
+src/superlocalmemory/cli/main.py
+src/superlocalmemory/cli/migrate_cmd.py
+src/superlocalmemory/cli/post_install.py
+src/superlocalmemory/cli/setup_wizard.py
+src/superlocalmemory/compliance/__init__.py
+src/superlocalmemory/compliance/abac.py
+src/superlocalmemory/compliance/audit.py
+src/superlocalmemory/compliance/eu_ai_act.py
+src/superlocalmemory/compliance/gdpr.py
+src/superlocalmemory/compliance/lifecycle.py
+src/superlocalmemory/compliance/retention.py
+src/superlocalmemory/compliance/scheduler.py
+src/superlocalmemory/core/__init__.py
+src/superlocalmemory/core/config.py
+src/superlocalmemory/core/embeddings.py
+src/superlocalmemory/core/engine.py
+src/superlocalmemory/core/hooks.py
+src/superlocalmemory/core/maintenance.py
+src/superlocalmemory/core/modes.py
+src/superlocalmemory/core/profiles.py
+src/superlocalmemory/core/registry.py
+src/superlocalmemory/dynamics/__init__.py
+src/superlocalmemory/dynamics/fisher_langevin_coupling.py
+src/superlocalmemory/encoding/__init__.py
+src/superlocalmemory/encoding/consolidator.py
+src/superlocalmemory/encoding/emotional.py
+src/superlocalmemory/encoding/entity_resolver.py
+src/superlocalmemory/encoding/entropy_gate.py
+src/superlocalmemory/encoding/fact_extractor.py
+src/superlocalmemory/encoding/foresight.py
+src/superlocalmemory/encoding/graph_builder.py
+src/superlocalmemory/encoding/observation_builder.py
+src/superlocalmemory/encoding/scene_builder.py
+src/superlocalmemory/encoding/signal_inference.py
+src/superlocalmemory/encoding/temporal_parser.py
+src/superlocalmemory/encoding/type_router.py
+src/superlocalmemory/hooks/__init__.py
+src/superlocalmemory/hooks/auto_capture.py
+src/superlocalmemory/hooks/auto_recall.py
+src/superlocalmemory/hooks/ide_connector.py
+src/superlocalmemory/hooks/rules_engine.py
+src/superlocalmemory/infra/__init__.py
+src/superlocalmemory/infra/auth_middleware.py
+src/superlocalmemory/infra/backup.py
+src/superlocalmemory/infra/cache_manager.py
+src/superlocalmemory/infra/event_bus.py
+src/superlocalmemory/infra/rate_limiter.py
+src/superlocalmemory/infra/webhook_dispatcher.py
+src/superlocalmemory/learning/__init__.py
+src/superlocalmemory/learning/adaptive.py
+src/superlocalmemory/learning/behavioral.py
+src/superlocalmemory/learning/behavioral_listener.py
+src/superlocalmemory/learning/bootstrap.py
+src/superlocalmemory/learning/cross_project.py
+src/superlocalmemory/learning/database.py
+src/superlocalmemory/learning/engagement.py
+src/superlocalmemory/learning/features.py
+src/superlocalmemory/learning/feedback.py
+src/superlocalmemory/learning/outcomes.py
+src/superlocalmemory/learning/project_context.py
+src/superlocalmemory/learning/ranker.py
+src/superlocalmemory/learning/source_quality.py
+src/superlocalmemory/learning/workflows.py
+src/superlocalmemory/llm/__init__.py
+src/superlocalmemory/llm/backbone.py
+src/superlocalmemory/math/__init__.py
+src/superlocalmemory/math/fisher.py
+src/superlocalmemory/math/langevin.py
+src/superlocalmemory/math/sheaf.py
+src/superlocalmemory/mcp/__init__.py
+src/superlocalmemory/mcp/resources.py
+src/superlocalmemory/mcp/server.py
+src/superlocalmemory/mcp/tools.py
+src/superlocalmemory/mcp/tools_core.py
+src/superlocalmemory/mcp/tools_v28.py
+src/superlocalmemory/mcp/tools_v3.py
+src/superlocalmemory/retrieval/__init__.py
+src/superlocalmemory/retrieval/agentic.py
+src/superlocalmemory/retrieval/ann_index.py
+src/superlocalmemory/retrieval/bm25_channel.py
+src/superlocalmemory/retrieval/bridge_discovery.py
+src/superlocalmemory/retrieval/engine.py
+src/superlocalmemory/retrieval/entity_channel.py
+src/superlocalmemory/retrieval/fusion.py
+src/superlocalmemory/retrieval/profile_channel.py
+src/superlocalmemory/retrieval/reranker.py
+src/superlocalmemory/retrieval/semantic_channel.py
+src/superlocalmemory/retrieval/strategy.py
+src/superlocalmemory/retrieval/temporal_channel.py
+src/superlocalmemory/server/__init__.py
+src/superlocalmemory/server/api.py
+src/superlocalmemory/server/security_middleware.py
+src/superlocalmemory/server/ui.py
+src/superlocalmemory/server/routes/__init__.py
+src/superlocalmemory/server/routes/agents.py
+src/superlocalmemory/server/routes/backup.py
+src/superlocalmemory/server/routes/behavioral.py
+src/superlocalmemory/server/routes/compliance.py
+src/superlocalmemory/server/routes/data_io.py
+src/superlocalmemory/server/routes/events.py
+src/superlocalmemory/server/routes/helpers.py
+src/superlocalmemory/server/routes/learning.py
+src/superlocalmemory/server/routes/lifecycle.py
+src/superlocalmemory/server/routes/memories.py
+src/superlocalmemory/server/routes/profiles.py
+src/superlocalmemory/server/routes/stats.py
+src/superlocalmemory/server/routes/v3_api.py
+src/superlocalmemory/server/routes/ws.py
+src/superlocalmemory/storage/__init__.py
+src/superlocalmemory/storage/access_control.py
+src/superlocalmemory/storage/database.py
+src/superlocalmemory/storage/migrations.py
+src/superlocalmemory/storage/models.py
+src/superlocalmemory/storage/schema.py
+src/superlocalmemory/storage/v2_migrator.py
+src/superlocalmemory/trust/__init__.py
+src/superlocalmemory/trust/gate.py
+src/superlocalmemory/trust/provenance.py
+src/superlocalmemory/trust/scorer.py
+src/superlocalmemory/trust/signals.py
+tests/test_auto_hooks.py
+tests/test_behavioral_full.py
+tests/test_cli.py
+tests/test_compliance_full.py
+tests/test_config_system.py
+tests/test_engine_hooks.py
+tests/test_event_bus.py
+tests/test_features.py
+tests/test_final_locomo_mini.py
+tests/test_ide_connector.py
+tests/test_infra.py
+tests/test_learning_advanced.py
+tests/test_learning_collectors.py
+tests/test_llm_provider.py
+tests/test_mcp_server.py
+tests/test_migration.py
+tests/test_post_install.py
+tests/test_ranker.py
+tests/test_trust_full.py
+tests/test_v3_api.py

package/src/superlocalmemory.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

package/src/superlocalmemory.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+slm = superlocalmemory.cli.main:main

package/src/superlocalmemory.egg-info/requires.txt

@@ -0,0 +1,33 @@
+httpx>=0.24.0
+numpy<3.0.0,>=1.26.0
+scipy<2.0.0,>=1.12.0
+networkx>=3.0
+mcp>=1.0.0
+python-dateutil>=2.9.0.post0
+rank-bm25>=0.2.2
+vadersentiment>=3.3.2
+
+[dev]
+pytest>=8.0
+pytest-cov>=4.1
+
+[full]
+superlocalmemory[learning,performance,search,ui]
+
+[learning]
+lightgbm<5.0.0,>=4.0.0
+
+[performance]
+diskcache<6.0.0,>=5.6.0
+orjson<4.0.0,>=3.9.0
+
+[search]
+sentence-transformers<4.0.0,>=2.5.0
+torch>=2.2.0
+scikit-learn<2.0.0,>=1.3.0
+geoopt>=0.5.0
+
+[ui]
+fastapi<1.0.0,>=0.109.0
+uvicorn[standard]<1.0.0,>=0.27.0
+python-multipart<1.0.0,>=0.0.6

package/src/superlocalmemory.egg-info/top_level.txt

@@ -0,0 +1 @@
+superlocalmemory