superlocalmemory 3.4.5 → 3.4.8

package/src/superlocalmemory/code_graph/communities.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory v3.4 — CodeGraph Module
 
 """CommunityDetector — file-based community detection.

package/src/superlocalmemory/code_graph/config.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory v3.4 — CodeGraph Module
 
 """Configuration for the CodeGraph module.

package/src/superlocalmemory/code_graph/database.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory v3.4 — CodeGraph Module
 
 """Database manager for code_graph.db.

package/src/superlocalmemory/code_graph/extractors/__init__.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory v3.4 — CodeGraph Module
 
 """Base extractor ABC for language-specific AST extraction.

package/src/superlocalmemory/code_graph/extractors/python.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory v3.4 — CodeGraph Module
 
 """Python-specific AST extractor using tree-sitter S-expression queries.

package/src/superlocalmemory/code_graph/extractors/typescript.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory v3.4 — CodeGraph Module
 
 """TypeScript/JavaScript AST extractor using tree-sitter.

package/src/superlocalmemory/code_graph/flows.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory v3.4 — CodeGraph Module
 
 """FlowDetector — entry point detection and execution flow tracing.

package/src/superlocalmemory/code_graph/git_hooks.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory v3.4 — CodeGraph Module
 
 """Git post-commit hook for automatic code graph updates.

package/src/superlocalmemory/code_graph/graph_engine.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory v3.4 — CodeGraph Module
 
 """GraphEngine — rustworkx in-memory directed graph.

package/src/superlocalmemory/code_graph/graph_store.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory v3.4 — CodeGraph Module
 
 """GraphStore — thin graph-specific layer over CodeGraphDatabase.

package/src/superlocalmemory/code_graph/incremental.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory v3.4 — CodeGraph Module
 
 """IncrementalUpdater — hash-based change detection + dependent tracing.

package/src/superlocalmemory/code_graph/models.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory v3.4 — CodeGraph Module
 
 """Data models for the CodeGraph module.

package/src/superlocalmemory/code_graph/parser.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory v3.4 — CodeGraph Module
 
 """Multi-language tree-sitter parser with parallel execution.

package/src/superlocalmemory/code_graph/resolver.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory v3.4 — CodeGraph Module
 
 """Cross-file import resolution with heuristic fallback.

package/src/superlocalmemory/code_graph/search.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory v3.4 — CodeGraph Module
 
 """HybridSearch — FTS5 + vec0 + Reciprocal Rank Fusion.

package/src/superlocalmemory/code_graph/service.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory v3.4 — CodeGraph Module
 
 """CodeGraphService — the main orchestrator.

package/src/superlocalmemory/code_graph/watcher.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory v3.4 — CodeGraph Module
 
 """CodeGraphWatcher — file system watcher with debounce.

package/src/superlocalmemory/compliance/abac.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Attribute-Based Access Control for memory operations.

package/src/superlocalmemory/compliance/audit.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Tamper-proof hash-chain audit log for compliance.

package/src/superlocalmemory/compliance/eu_ai_act.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """SuperLocalMemory V3 — EU AI Act Compliance Verification.

package/src/superlocalmemory/compliance/gdpr.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """SuperLocalMemory V3 — GDPR Compliance.

package/src/superlocalmemory/compliance/lifecycle.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """SuperLocalMemory V3 — Memory Lifecycle Management.

package/src/superlocalmemory/compliance/retention.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Named retention rules engine for compliance (GDPR, HIPAA, custom).

package/src/superlocalmemory/compliance/scheduler.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Background scheduler that periodically enforces retention rules.

package/src/superlocalmemory/core/config.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """SuperLocalMemory V3 — Configuration.

package/src/superlocalmemory/core/consolidation_engine.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Sleep-time consolidation engine (Phase 5).
@@ -127,6 +127,57 @@ class ConsolidationEngine:
                 )
                 # Step 7: Cognitive Consolidation Quantization (Phase E)
                 results["ccq"] = self._step7_ccq(profile_id)
+
+                # Step 8 (v3.4.7): Mine behavioral assertions from tool events.
+                try:
+                    from superlocalmemory.learning.assertion_miner import AssertionMiner
+                    miner = AssertionMiner(self._db.db_path)
+                    results["assertions"] = miner.mine(profile_id)
+                except Exception as exc:
+                    logger.debug("Assertion mining (non-fatal): %s", exc)
+                    results["assertions"] = {"error": str(exc)}
+
+                # Step 9 (v3.4.7): Generate soft prompts from patterns + assertions.
+                # Previously the AutoParameterizeHook was never wired.
+                try:
+                    from superlocalmemory.parameterization.pattern_extractor import PatternExtractor
+                    from superlocalmemory.parameterization.soft_prompt_generator import SoftPromptGenerator
+                    from superlocalmemory.parameterization.prompt_injector import PromptInjector
+                    from superlocalmemory.parameterization.prompt_lifecycle import PromptLifecycleManager
+                    from superlocalmemory.learning.behavioral import BehavioralPatternStore
+                    # cross_project and workflow_miner may not exist yet — stub them
+                    try:
+                        from superlocalmemory.parameterization.cross_project import CrossProjectAggregator
+                    except ImportError:
+                        class CrossProjectAggregator:
+                            def __init__(self, db): pass
+                            def get_preferences(self, *a, **kw): return {}
+                    try:
+                        from superlocalmemory.parameterization.workflow_miner import WorkflowMiner
+                    except ImportError:
+                        class WorkflowMiner:
+                            def __init__(self, db): pass
+                            def mine(self, *a, **kw): return []
+                    from superlocalmemory.hooks.auto_parameterize import AutoParameterizeHook
+                    from superlocalmemory.core.config import ParameterizationConfig
+                    from pathlib import Path as _Path
+
+                    p_config = getattr(self._slm_config, "parameterization", ParameterizationConfig())
+                    learning_db = str(_Path.home() / ".superlocalmemory" / "learning.db")
+                    beh_store = BehavioralPatternStore(learning_db)
+                    cross_proj = CrossProjectAggregator(self._db)
+                    wf_miner = WorkflowMiner(self._db)
+                    extractor = PatternExtractor(self._db, beh_store, cross_proj, wf_miner, p_config)
+                    generator = SoftPromptGenerator(p_config)
+                    injector = PromptInjector(self._db, generator, p_config)
+                    lifecycle = PromptLifecycleManager(self._db, p_config)
+                    hook = AutoParameterizeHook(extractor, generator, injector, lifecycle, p_config)
+                    sp_result = hook.on_consolidation_complete(profile_id)
+                    results["soft_prompts"] = sp_result
+                except Exception as exc:
+                    logger.debug("Soft prompt generation (non-fatal): %s", exc)
+                    results["soft_prompts"] = {"error": str(exc)}
+
             results["success"] = True
         except Exception as exc:
             logger.warning(

package/src/superlocalmemory/core/embedding_worker.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Subprocess embedding worker — isolates PyTorch memory from main process.

package/src/superlocalmemory/core/embeddings.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """SuperLocalMemory V3 — Embedding Service (Subprocess-Isolated).

package/src/superlocalmemory/core/engine.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """SuperLocalMemory V3 — Main Memory Engine (Facade).
@@ -125,6 +125,20 @@ class MemoryEngine:
         except Exception as exc:
             logger.debug("V3.4.3 schema migration: %s", exc)
 
+        # V3.4.6: Apply "Connected Brain" mesh enhancements (broadcast, project routing, offline queue)
+        try:
+            from superlocalmemory.storage.schema_v343 import apply_v346_schema
+            apply_v346_schema(str(self._db.db_path))
+        except Exception as exc:
+            logger.debug("V3.4.6 schema migration: %s", exc)
+
+        # V3.4.7: Apply "Learning Brain" schema (tool_events, behavioral_assertions)
+        try:
+            from superlocalmemory.storage.schema_v347 import apply_v347_schema
+            apply_v347_schema(str(self._db.db_path))
+        except Exception as exc:
+            logger.debug("V3.4.7 schema migration: %s", exc)
+
         self._embedder = init_embedder(self._config)
 
         if self._caps.llm_fact_extraction:
@@ -199,6 +213,8 @@ class MemoryEngine:
             temporal_validator=self._temporal_validator,
             summarizer=summarizer,
             behavioral_store=None,
+            embedder=self._embedder,  # v3.4.7: for CCQ worker
+            llm=getattr(self, "_llm", None),  # v3.4.7: for CCQ worker
         )
 
         # V3.3: Check for embedding model migration on mode switch

package/src/superlocalmemory/core/engine_wiring.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Engine wiring — extracted free functions for MemoryEngine initialization.
@@ -330,10 +330,29 @@ def _init_consolidation(
     temporal_validator: Any,
     summarizer: Any,
     behavioral_store: Any,
+    embedder: Any = None,
+    llm: Any = None,
 ) -> Any | None:
     """Create ConsolidationEngine for Phase 5 sleep-time consolidation."""
     try:
         from superlocalmemory.core.consolidation_engine import ConsolidationEngine
+
+        # v3.4.7: Create CCQWorker so Step 7 (cognitive consolidation) actually runs.
+        # Previously, ccq_worker was always None → Step 7 returned {"enabled": False}.
+        ccq_worker = None
+        try:
+            from superlocalmemory.core.config import CCQConfig
+            from superlocalmemory.encoding.cognitive_consolidator import CognitiveConsolidator
+            from superlocalmemory.learning.consolidation_quantization_worker import CCQWorker
+            ccq_config = getattr(config, "ccq", CCQConfig())
+            consolidator = CognitiveConsolidator(
+                db=db, embedder=embedder, llm=llm, config=ccq_config,
+            )
+            ccq_worker = CCQWorker(consolidator=consolidator, config=ccq_config)
+            logger.info("CCQ worker initialized (enabled=%s)", ccq_config.enabled)
+        except Exception as exc:
+            logger.debug("CCQ worker init failed (non-fatal): %s", exc)
+
         return ConsolidationEngine(
             db=db,
             config=config.consolidation,
@@ -343,6 +362,7 @@ def _init_consolidation(
             graph_analyzer=graph_analyzer,
             temporal_validator=temporal_validator,
             slm_config=config,
+            ccq_worker=ccq_worker,
         )
     except Exception as exc:
         logger.debug("ConsolidationEngine init failed: %s", exc)

package/src/superlocalmemory/core/graph_analyzer.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3
 
 """Graph structural analysis -- PageRank, community detection, centrality.
@@ -438,4 +438,18 @@ class GraphAnalyzer:
         except Exception as exc:
             logger.debug("association_edges read failed: %s", exc)
 
+        # v3.4.7: Add ALL facts as nodes so isolated facts get base PageRank.
+        # Previously, facts without edges were invisible to graph analysis.
+        try:
+            all_facts = self._db.execute(
+                "SELECT fact_id FROM atomic_facts WHERE profile_id = ?",
+                (profile_id,),
+            )
+            for row in all_facts:
+                fact_id = dict(row)["fact_id"]
+                if fact_id not in g:
+                    g.add_node(fact_id)
+        except Exception as exc:
+            logger.debug("Failed to add isolated fact nodes: %s", exc)
+
         return g

package/src/superlocalmemory/core/health_monitor.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Enterprise-grade health monitoring for the SLM Unified Daemon.

package/src/superlocalmemory/core/hooks.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Engine lifecycle hooks -- pre/post operation dispatch.

package/src/superlocalmemory/core/maintenance.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """SuperLocalMemory V3 — Background Math Maintenance.

package/src/superlocalmemory/core/maintenance_scheduler.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """SuperLocalMemory V3 — Background Maintenance Scheduler.

package/src/superlocalmemory/core/modes.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """SuperLocalMemory V3 — Mode System.

package/src/superlocalmemory/core/ollama_embedder.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Ollama Embedding Provider — lightweight HTTP-based embeddings.

package/src/superlocalmemory/core/profiles.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """SuperLocalMemory V3 — Profile Management.

package/src/superlocalmemory/core/recall_pipeline.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Recall pipeline — extracted free functions for MemoryEngine.recall().
@@ -230,10 +230,23 @@ def run_recall(
     # singletons to avoid creating new objects per recall (was causing
     # object accumulation across 304 benchmark recalls).
     try:
+        # v3.4.7: Extract entities from results for behavioral tracking.
+        # Was passing wrong param (result_count instead of entities) → TypeError.
+        entities: list[str] = []
+        for r in response.results[:10]:
+            rd = r if isinstance(r, dict) else (dict(r) if hasattr(r, "keys") else {})
+            ents_json = rd.get("canonical_entities_json", "")
+            if ents_json:
+                try:
+                    import json as _json
+                    entities.extend(_json.loads(ents_json))
+                except (ValueError, TypeError):
+                    pass
         _get_behavioral_tracker(db).record_query(
-            profile_id=profile_id, query=query,
+            query=query,
             query_type=response.query_type,
-            result_count=len(response.results),
+            entities=entities[:20],
+            profile_id=profile_id,
         )
     except Exception as exc:
         logger.debug("Behavioral tracking: %s", exc)

package/src/superlocalmemory/core/recall_worker.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Subprocess recall worker — runs the full recall pipeline in isolation.

package/src/superlocalmemory/core/registry.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Agent registry — multi-agent profile isolation.

package/src/superlocalmemory/core/reranker_worker.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Subprocess reranker worker — isolates PyTorch/ONNX from main process.

package/src/superlocalmemory/core/store_pipeline.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Store pipeline — extracted free functions for MemoryEngine.store().

package/src/superlocalmemory/core/summarizer.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Summarizer — Mode A heuristic + Mode B Ollama + Mode C OpenRouter.

package/src/superlocalmemory/core/worker_pool.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Recall worker pool — manages subprocess lifecycle for all callers.

package/src/superlocalmemory/dynamics/activation_guided_quantization.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3
 
 """Spreading Activation-Guided Quantization (SAGQ) engine.

package/src/superlocalmemory/dynamics/eap_scheduler.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3
 
 """EAP Scheduler -- Embedding-Aware Precision.

package/src/superlocalmemory/dynamics/ebbinghaus_langevin_coupling.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Ebbinghaus-Langevin coupling — forgetting drift in dynamics.

package/src/superlocalmemory/dynamics/fisher_langevin_coupling.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Fisher-Langevin Coupling: information-dynamic lifecycle for memory.

package/src/superlocalmemory/encoding/auto_linker.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3
 
 """A-MEM-inspired automatic edge creation between related facts.

package/src/superlocalmemory/encoding/cognitive_consolidator.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """Cognitive Consolidation Quantization (CCQ) — Phase E.

package/src/superlocalmemory/encoding/consolidator.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """SuperLocalMemory V3 — Memory Consolidator.

package/src/superlocalmemory/encoding/context_generator.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3.2 | https://qualixar.com
 
 """Generate contextual descriptions for facts (A-MEM pattern).

package/src/superlocalmemory/encoding/emotional.py

@@ -1,5 +1,5 @@
 # Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
-# Licensed under the Elastic License 2.0 - see LICENSE file
+# Licensed under AGPL-3.0-or-later - see LICENSE file
 # Part of SuperLocalMemory V3 | https://qualixar.com | https://varunpratap.com
 
 """SuperLocalMemory V3 — Emotional Tagging (VADER).