superlocalmemory 3.0.12 → 3.0.14

package/LICENSE

@@ -14,8 +14,9 @@ copies or substantial portions of the Software.
 
 ATTRIBUTION NOTICE:
 This software contains novel mathematical methods described in:
+- arXiv:2603.14588 (SuperLocalMemory V3 — Information-Geometric Foundations)
 - arXiv:2603.02240 (SuperLocalMemory V2 — Bayesian Trust Defense)
-- Zenodo DOI: 10.5281/zenodo.19038659 (SuperLocalMemory V3 — Information-Geometric Foundations)
+- Zenodo DOI: 10.5281/zenodo.19038659 (SuperLocalMemory V3)
 
 Academic use MUST cite the relevant paper.
 Commercial use MUST retain this notice, the NOTICE file, and visible attribution.

package/NOTICE

@@ -42,7 +42,7 @@ PUBLICATIONS
 - V3 Paper: "SuperLocalMemory V3: Information-Geometric Foundations for
   Zero-LLM Enterprise Agent Memory"
   Zenodo DOI: 10.5281/zenodo.19038659
-  arXiv: Submitted March 2026 (cs.AI, cs.IR, cs.LG)
+  arXiv: 2603.14588 (cs.AI, cs.IR, cs.LG)
 
 - V2 Paper: "SuperLocalMemory: Privacy-Preserving Multi-Agent Memory with
   Bayesian Trust Defense Against Memory Poisoning"

package/README.md

@@ -11,7 +11,7 @@
 
 <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://arxiv.org/abs/2603.14588"><img src="https://img.shields.io/badge/arXiv-2603.14588-b31b1b?style=for-the-badge&logo=arxiv&logoColor=white" alt="arXiv V3 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>
 
@@ -277,7 +277,7 @@ Evaluated on the [LoCoMo benchmark](https://arxiv.org/abs/2402.09714) (Long Conv
 ### 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)
+> [arXiv:2603.14588](https://arxiv.org/abs/2603.14588) | [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**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superlocalmemory",
-  "version": "3.0.12",
+  "version": "3.0.14",
   "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/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "superlocalmemory"
-version = "3.0.12"
+version = "3.0.14"
 description = "Information-geometric agent memory with mathematical guarantees"
 readme = "README.md"
 license = {text = "MIT"}

package/src/superlocalmemory/cli/commands.py

@@ -151,6 +151,7 @@ def cmd_forget(args: Namespace) -> None:
 
     config = SLMConfig.load()
     engine = MemoryEngine(config)
+    engine.initialize()
     facts = engine._db.get_all_facts(engine.profile_id)
     query_lower = args.query.lower()
     matches = [f for f in facts if query_lower in f.content.lower()]
@@ -191,6 +192,7 @@ def cmd_health(_args: Namespace) -> None:
 
     config = SLMConfig.load()
     engine = MemoryEngine(config)
+    engine.initialize()
     facts = engine._db.get_all_facts(engine.profile_id)
     fisher_count = sum(1 for f in facts if f.fisher_mean is not None)
     langevin_count = sum(1 for f in facts if f.langevin_position is not None)

package/src/superlocalmemory/storage/schema.py

@@ -216,6 +216,28 @@ CREATE INDEX IF NOT EXISTS idx_facts_interval
 # FTS5 virtual table on atomic_facts for full-text search
 # ---------------------------------------------------------------------------
 
+_SQL_V2_MIGRATION_CLEANUP: Final[str] = """
+-- Clean up stale V2 triggers that fire on active tables but reference
+-- renamed backup FTS tables. The V2→V3 migration renames tables via
+-- ALTER TABLE RENAME, which auto-updates trigger bodies to reference
+-- _v2_bak_* tables but leaves FTS5 delete-command column names stale.
+-- This causes: "table _v2_bak_*_fts has no column named *_fts"
+
+-- Drop V2-era triggers on memories table (memories_ai/ad/au)
+DROP TRIGGER IF EXISTS memories_ai;
+DROP TRIGGER IF EXISTS memories_ad;
+DROP TRIGGER IF EXISTS memories_au;
+
+-- Drop stale V3 triggers (may have been corrupted by V2 rename)
+DROP TRIGGER IF EXISTS atomic_facts_fts_insert;
+DROP TRIGGER IF EXISTS atomic_facts_fts_delete;
+DROP TRIGGER IF EXISTS atomic_facts_fts_update;
+
+-- Drop renamed V2 backup FTS virtual tables (and their shadow tables)
+DROP TABLE IF EXISTS "_v2_bak_atomic_facts_fts";
+DROP TABLE IF EXISTS "_v2_bak_memories_fts";
+"""
+
 _SQL_ATOMIC_FACTS_FTS: Final[str] = """
 CREATE VIRTUAL TABLE IF NOT EXISTS atomic_facts_fts
     USING fts5(
@@ -226,8 +248,11 @@ CREATE VIRTUAL TABLE IF NOT EXISTS atomic_facts_fts
     );
 
 -- Triggers to keep FTS in sync with atomic_facts.
+-- Always DROP+CREATE (not IF NOT EXISTS) to replace any stale triggers
+-- left by V2 migration.
+
 -- INSERT trigger
-CREATE TRIGGER IF NOT EXISTS atomic_facts_fts_insert
+CREATE TRIGGER atomic_facts_fts_insert
     AFTER INSERT ON atomic_facts
 BEGIN
     INSERT INTO atomic_facts_fts (rowid, fact_id, content)
@@ -235,7 +260,7 @@ BEGIN
 END;
 
 -- DELETE trigger
-CREATE TRIGGER IF NOT EXISTS atomic_facts_fts_delete
+CREATE TRIGGER atomic_facts_fts_delete
     AFTER DELETE ON atomic_facts
 BEGIN
     INSERT INTO atomic_facts_fts (atomic_facts_fts, rowid, fact_id, content)
@@ -243,7 +268,7 @@ BEGIN
 END;
 
 -- UPDATE trigger
-CREATE TRIGGER IF NOT EXISTS atomic_facts_fts_update
+CREATE TRIGGER atomic_facts_fts_update
     AFTER UPDATE OF content ON atomic_facts
 BEGIN
     INSERT INTO atomic_facts_fts (atomic_facts_fts, rowid, fact_id, content)
@@ -655,7 +680,9 @@ _DDL_ORDERED: Final[tuple[str, ...]] = (
     _SQL_COMPLIANCE_AUDIT,
     _SQL_BM25_TOKENS,
     _SQL_CONFIG,
-    # FTS5 must come after atomic_facts (content table)
+    # V2 migration cleanup — drop stale triggers/FTS before recreating
+    _SQL_V2_MIGRATION_CLEANUP,
+    # FTS5 must come after atomic_facts (content table) AND after cleanup
     _SQL_ATOMIC_FACTS_FTS,
 )
 

package/src/superlocalmemory/storage/v2_migrator.py

@@ -151,20 +151,33 @@ class V2Migrator:
         self._backup_db = self._v3_base / BACKUP_NAME
 
     def detect_v2(self) -> bool:
-        """Check if a V2 installation exists."""
+        """Check if a V2 installation exists.
+
+        Returns False if .claude-memory is a symlink (already migrated).
+        """
+        if self._v2_base.is_symlink():
+            return False
         return self._v2_db.exists() and self._v2_db.is_file()
 
     def is_already_migrated(self) -> bool:
-        """Check if migration has already been performed."""
+        """Check if migration has already been performed.
+
+        Detects migration by:
+        1. .claude-memory is a symlink to .superlocalmemory (definitive)
+        2. V3 schema tables exist in the V3 database
+        """
+        if self._v2_base.is_symlink():
+            return True
         if not self._v3_db.exists():
             return False
         try:
             conn = sqlite3.connect(str(self._v3_db))
             try:
-                tables = [r[0] for r in conn.execute(
+                tables = {r[0] for r in conn.execute(
                     "SELECT name FROM sqlite_master WHERE type='table'"
-                ).fetchall()]
-                return "semantic_facts" in tables and "v3_config" in tables
+                ).fetchall()}
+                # Check for actual V3 schema tables (not old migration markers)
+                return "atomic_facts" in tables and "canonical_entities" in tables
             finally:
                 conn.close()
         except Exception:
@@ -217,12 +230,12 @@ class V2Migrator:
 
         Returns dict with migration stats.
         """
-        if not self.detect_v2():
-            return {"success": False, "error": "No V2 installation found"}
-
         if self.is_already_migrated():
             return {"success": True, "message": "Already migrated"}
 
+        if not self.detect_v2():
+            return {"success": False, "error": "No V2 installation found"}
+
         stats = {"steps": []}
 
         try:
@@ -268,6 +281,19 @@ class V2Migrator:
             # Disable FK enforcement for migrated DBs (V2 schema is incompatible)
             conn.execute("PRAGMA foreign_keys=OFF")
 
+            # Drop ALL triggers before renaming tables.
+            # ALTER TABLE RENAME auto-updates trigger bodies but corrupts
+            # FTS5 delete-command column names, causing:
+            #   "table _v2_bak_*_fts has no column named *_fts"
+            v2_triggers = [r[0] for r in conn.execute(
+                "SELECT name FROM sqlite_master WHERE type='trigger'"
+            ).fetchall()]
+            for trigger in v2_triggers:
+                try:
+                    conn.execute(f'DROP TRIGGER IF EXISTS "{trigger}"')
+                except Exception:
+                    pass
+
             # Rename ALL tables with incompatible schemas (V2 + old alpha)
             # User data is in 'memories' table (already upgraded above)
             # Everything else is computed/derived and will be recreated by V3

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superlocalmemory
-Version: 3.0.12
+Version: 3.0.13
 Summary: Information-geometric agent memory with mathematical guarantees
 Author-email: Varun Pratap Bhardwaj <admin@superlocalmemory.com>
 License: MIT
@@ -58,7 +58,7 @@ Dynamic: license-file
 
 <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://arxiv.org/abs/2603.14588"><img src="https://img.shields.io/badge/arXiv-2603.14588-b31b1b?style=for-the-badge&logo=arxiv&logoColor=white" alt="arXiv V3 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>
 
@@ -324,7 +324,7 @@ Evaluated on the [LoCoMo benchmark](https://arxiv.org/abs/2402.09714) (Long Conv
 ### 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)
+> [arXiv:2603.14588](https://arxiv.org/abs/2603.14588) | [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**