superlocalmemory 3.3.13 → 3.3.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superlocalmemory",
-  "version": "3.3.13",
+  "version": "3.3.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.3.13"
+version = "3.3.14"
 description = "Information-geometric agent memory with mathematical guarantees"
 readme = "README.md"
 license = {text = "MIT"}

package/src/superlocalmemory/retrieval/engine.py

@@ -301,11 +301,16 @@ class RetrievalEngine:
     def _load_facts(
         self, fused: list[FusionResult], profile_id: str,
     ) -> dict[str, AtomicFact]:
-        needed = {fr.fact_id for fr in fused}
+        """Load facts by ID — targeted query, not full-table scan.
+
+        V3.3.13: Was loading ALL facts (O(n) memory) then filtering.
+        Now uses get_facts_by_ids() for O(k) where k = pool size (~60).
+        """
+        needed = [fr.fact_id for fr in fused]
         if not needed:
             return {}
-        all_facts = self._db.get_all_facts(profile_id)
-        return {f.fact_id: f for f in all_facts if f.fact_id in needed}
+        facts = self._db.get_facts_by_ids(needed, profile_id)
+        return {f.fact_id: f for f in facts}
 
     # -- Cross-encoder rerank -----------------------------------------------
 

package/src/superlocalmemory/storage/database.py

@@ -250,12 +250,20 @@ class DatabaseManager:
         )
         return [self._row_to_fact(r) for r in rows]
 
+    _MAX_FACTS_PER_ENTITY_LOOKUP: int = 100
+
     def get_facts_by_entity(self, entity_id: str, profile_id: str) -> list[AtomicFact]:
-        """Facts whose canonical_entities JSON array contains *entity_id*."""
+        """Facts whose canonical_entities JSON array contains *entity_id*.
+
+        V3.3.14: LIMIT to _MAX_FACTS_PER_ENTITY_LOOKUP (100) to prevent
+        unbounded memory growth during ingestion. Previously loaded ALL
+        facts for popular entities (500+) causing 17GB+ memory usage.
+        Ordered by created_at DESC so newest facts are always included.
+        """
         rows = self.execute(
             "SELECT * FROM atomic_facts WHERE profile_id = ? AND canonical_entities_json LIKE ? "
-            "ORDER BY created_at DESC",
-            (profile_id, f'%"{entity_id}"%'),
+            "ORDER BY created_at DESC LIMIT ?",
+            (profile_id, f'%"{entity_id}"%', self._MAX_FACTS_PER_ENTITY_LOOKUP),
         )
         return [self._row_to_fact(r) for r in rows]