superlocalmemory 3.4.64 → 3.5.0

package/src/superlocalmemory/storage/migration_runner.py

@@ -50,6 +50,7 @@ from superlocalmemory.storage.migrations import (
     M012_shadow_observations as _M012,
     M013_bi_temporal_columns as _M013,
     M014_v345_scale_ready as _M014,
+    M015_add_pinned_column as _M015,
 )
 
 # Map migration name → module (used for the optional ``verify(conn)`` hook
@@ -69,6 +70,7 @@ _MODULES = {
     _M012.NAME: _M012,
     _M013.NAME: _M013,
     _M014.NAME: _M014,
+    _M015.NAME: _M015,
 }
 
 logger = logging.getLogger(__name__)
@@ -130,6 +132,8 @@ DEFERRED_MIGRATIONS: list[Migration] = [
     # as M011.
     Migration(name=_M013.NAME, db_target="memory", ddl=_M013.DDL),
     Migration(name=_M014.NAME, db_target="memory", ddl=_M014.DDL),
+    # M015 adds pinned column to atomic_facts (v3.4.65 core-memory pins).
+    Migration(name=_M015.NAME, db_target="memory", ddl=_M015.DDL),
 ]
 
 

package/src/superlocalmemory/storage/migrations/M015_add_pinned_column.py

@@ -0,0 +1,40 @@
+# Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
+# Licensed under AGPL-3.0-or-later - see LICENSE file
+# Part of SuperLocalMemory v3.4.65 — Context Injection v2
+
+"""M015 — add `pinned` column to atomic_facts (v3.4.65, core-memory explicit pins).
+
+Additive only — ALTER TABLE ADD COLUMN, default 0. No data loss, no type
+changes. Idempotent via verify() + migration_log. Mirrors M001 pattern.
+
+Backward-compat: old code that doesn't know about the column simply gets
+DEFAULT 0 on SELECT *, which is the safe "not-pinned" state.
+"""
+
+from __future__ import annotations
+
+import sqlite3
+
+NAME = "M015_add_pinned_column"
+DB_TARGET = "memory"
+
+_REQUIRED_COLS = frozenset({"pinned"})
+
+
+def verify(conn: sqlite3.Connection) -> bool:
+    try:
+        cols = {r[1] for r in conn.execute(
+            "PRAGMA table_info(atomic_facts)"
+        ).fetchall()}
+    except sqlite3.Error:
+        return False
+    return _REQUIRED_COLS <= cols
+
+
+DDL = """
+BEGIN IMMEDIATE;
+ALTER TABLE atomic_facts ADD COLUMN pinned INTEGER NOT NULL DEFAULT 0;
+CREATE INDEX IF NOT EXISTS idx_facts_pinned
+    ON atomic_facts(profile_id, pinned);
+COMMIT;
+"""

package/src/superlocalmemory/storage/migrations/__init__.py

@@ -23,6 +23,7 @@ from . import (
     M003_migration_log,
     M004_cross_platform_sync_log,
     M005_bandit_tables,
+    M015_add_pinned_column,
 )
 
 # ---------------------------------------------------------------------------

package/src/superlocalmemory/storage/models.py

@@ -178,6 +178,9 @@ class AtomicFact:
     # Signal type (V2 compatible)
     signal_type: SignalType = SignalType.FACTUAL
 
+    # v3.4.65: Core Memory Block explicit pin (M015)
+    pinned: bool = False
+
     created_at: str = field(default_factory=_now)
 
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superlocalmemory
-Version: 3.4.64
+Version: 3.5.0
 Summary: Information-geometric agent memory with mathematical guarantees
 Author-email: Varun Pratap Bhardwaj <admin@superlocalmemory.com>
 License: AGPL-3.0-or-later
@@ -69,6 +69,8 @@ Provides-Extra: ui
 Requires-Dist: fastapi[all]>=0.135.1; extra == "ui"
 Requires-Dist: uvicorn>=0.42.0; extra == "ui"
 Requires-Dist: python-multipart<1.0.0,>=0.0.6; extra == "ui"
+Provides-Extra: injection
+Requires-Dist: tiktoken>=0.8.0; extra == "injection"
 Provides-Extra: learning
 Requires-Dist: lightgbm>=4.0.0; extra == "learning"
 Provides-Extra: performance
@@ -79,7 +81,7 @@ Requires-Dist: google-auth-oauthlib>=1.2.0; extra == "ingestion"
 Requires-Dist: google-api-python-client>=2.100.0; extra == "ingestion"
 Requires-Dist: icalendar>=6.0.0; extra == "ingestion"
 Provides-Extra: full
-Requires-Dist: superlocalmemory[ingestion,learning,performance,search,ui]; extra == "full"
+Requires-Dist: superlocalmemory[ingestion,injection,learning,performance,search,ui]; extra == "full"
 Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.1; extra == "dev"

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

@@ -86,6 +86,7 @@ src/superlocalmemory/core/graph_analyzer.py
 src/superlocalmemory/core/graph_pruner.py
 src/superlocalmemory/core/health_monitor.py
 src/superlocalmemory/core/hooks.py
+src/superlocalmemory/core/injection.py
 src/superlocalmemory/core/loop_watchdog.py
 src/superlocalmemory/core/maintenance.py
 src/superlocalmemory/core/maintenance_scheduler.py
@@ -377,6 +378,7 @@ src/superlocalmemory/storage/migrations/M011_archive_and_merge.py
 src/superlocalmemory/storage/migrations/M012_shadow_observations.py
 src/superlocalmemory/storage/migrations/M013_bi_temporal_columns.py
 src/superlocalmemory/storage/migrations/M014_v345_scale_ready.py
+src/superlocalmemory/storage/migrations/M015_add_pinned_column.py
 src/superlocalmemory/storage/migrations/__init__.py
 src/superlocalmemory/trust/__init__.py
 src/superlocalmemory/trust/gate.py
@@ -452,6 +454,7 @@ tests/test_final_locomo_mini.py
 tests/test_hook_handlers.py
 tests/test_ide_connector.py
 tests/test_infra.py
+tests/test_injection.py
 tests/test_learning_advanced.py
 tests/test_learning_collectors.py
 tests/test_llm_provider.py

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

@@ -36,7 +36,7 @@ pytest-asyncio>=0.21
 sqlite-vec>=0.1.6
 
 [full]
-superlocalmemory[ingestion,learning,performance,search,ui]
+superlocalmemory[ingestion,injection,learning,performance,search,ui]
 
 [ingestion]
 keyring>=25.0.0
@@ -44,6 +44,9 @@ google-auth-oauthlib>=1.2.0
 google-api-python-client>=2.100.0
 icalendar>=6.0.0
 
+[injection]
+tiktoken>=0.8.0
+
 [learning]
 lightgbm>=4.0.0