superlocalmemory 3.4.48 → 3.4.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. package/CHANGELOG.md +46 -0
  2. package/README.md +43 -1
  3. package/package.json +1 -1
  4. package/pyproject.toml +1 -1
  5. package/src/superlocalmemory/__init__.py +1 -1
  6. package/src/superlocalmemory/cli/commands.py +7 -2
  7. package/src/superlocalmemory/cli/main.py +10 -0
  8. package/src/superlocalmemory/core/backend_orchestrator.py +365 -0
  9. package/src/superlocalmemory/core/pruning_engine.py +216 -0
  10. package/src/superlocalmemory/core/recall_pipeline.py +26 -2
  11. package/src/superlocalmemory/core/store_pipeline.py +21 -0
  12. package/src/superlocalmemory/core/tier_manager.py +124 -0
  13. package/src/superlocalmemory/graph/__init__.py +9 -0
  14. package/src/superlocalmemory/graph/cozo_backend.py +527 -0
  15. package/src/superlocalmemory/llm/backbone.py +1 -12
  16. package/src/superlocalmemory/mcp/_pool_adapter.py +2 -0
  17. package/src/superlocalmemory/mcp/tools_active.py +41 -1
  18. package/src/superlocalmemory/retrieval/engine.py +15 -3
  19. package/src/superlocalmemory/retrieval/entity_channel.py +50 -1
  20. package/src/superlocalmemory/retrieval/reranker.py +15 -0
  21. package/src/superlocalmemory/server/unified_daemon.py +3 -1
  22. package/src/superlocalmemory/storage/migration_runner.py +3 -0
  23. package/src/superlocalmemory/storage/migrations/M014_v345_scale_ready.py +45 -0
  24. package/src/superlocalmemory/storage/schema_v345.py +109 -0
  25. package/src/superlocalmemory/vector/__init__.py +9 -0
  26. package/src/superlocalmemory/vector/lancedb_backend.py +299 -0
  27. package/src/superlocalmemory.egg-info/PKG-INFO +44 -2
  28. package/src/superlocalmemory.egg-info/SOURCES.txt +8 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: superlocalmemory
3
- Version: 3.4.48
3
+ Version: 3.4.51
4
4
  Summary: Information-geometric agent memory with mathematical guarantees
5
5
  Author-email: Varun Pratap Bhardwaj <admin@superlocalmemory.com>
6
6
  License: AGPL-3.0-or-later
@@ -93,7 +93,7 @@ Dynamic: license-file
93
93
 
94
94
  <h1 align="center">SuperLocalMemory V3.4</h1>
95
95
  <p align="center"><strong>Every other AI forgets. Yours won't.</strong><br/><em>Infinite memory for Claude Code, Cursor, Windsurf, and any MCP-compatible AI client.</em></p>
96
- <p align="center"><code>v3.4.48</code> — Install once. Every session remembers the last. Automatically.<br><strong>Now with multi-machine agent mesh M4 and M5 coordinate as one.</strong></p>
96
+ <p align="center"><code>v3.4.51 "Recency Intelligence"</code> — <strong>Session context is now time-aware.</strong><br>Stale memories from old projects no longer surface. Ebbinghaus decay + FSRS stability. One command: <code>pip install -U superlocalmemory && slm restart</code></p>
97
97
  <p align="center"><strong>Backed by 3 published research papers</strong> (arXiv preprints + Zenodo-archived) · <a href="https://arxiv.org/abs/2603.02240">arXiv:2603.02240</a> · <a href="https://arxiv.org/abs/2603.14588">arXiv:2603.14588</a> · <a href="https://arxiv.org/abs/2604.04514">arXiv:2604.04514</a></p>
98
98
 
99
99
  <p align="center">
@@ -272,6 +272,30 @@ slm warmup # Pre-download embedding model (~500MB, optional)
272
272
  pip install superlocalmemory
273
273
  ```
274
274
 
275
+ ### Upgrading to v3.4.5 "Scale-Ready"
276
+
277
+ **Migration is automatic.** Upgrade your package, restart the daemon, and your database migrates silently.
278
+
279
+ ```bash
280
+ # pip users
281
+ pip install -U superlocalmemory
282
+ slm restart
283
+
284
+ # npm users
285
+ npm update -g superlocalmemory
286
+ slm restart
287
+
288
+ # Verify migration
289
+ slm doctor
290
+ ```
291
+
292
+ No manual commands. No data loss. Your database upgrades in-place with zero downtime. The daemon auto-detects the old version and applies the migration on first start.
293
+
294
+ **New capabilities after upgrade:**
295
+ - Tiered storage: memories auto-classified as active/warm/cold/archived
296
+ - Graph pruning: redundant edges removed, queries stay fast at 1M+ connections
297
+ - Optional: `pip install superlocalmemory[cozo,lancedb]` for graph + vector acceleration
298
+
275
299
  ### First Use
276
300
 
277
301
  ```bash
@@ -499,6 +523,23 @@ Every recall generates learning signals. Over time, the system adapts to your pa
499
523
 
500
524
  Auto-capture hooks: `slm hooks install` + `slm observe` + `slm session-context`. MCP tools: `session_init`, `observe`, `report_feedback`.
501
525
 
526
+ **`session_init` MCP parameters:**
527
+ | Parameter | Type | Default | Description |
528
+ |---|---|---|---|
529
+ | `project_path` | string | `""` | Working directory — used to derive search query |
530
+ | `query` | string | `""` | Override search query |
531
+ | `max_results` | int | `10` | Max memories to return |
532
+ | `max_age_days` | int | `30` | Suppress memories older than N days (0 = disabled). Memories with score ≥ 0.70 always surface regardless of age. |
533
+
534
+ **`slm session-context` CLI flags** (consistent with MCP):
535
+ ```bash
536
+ slm session-context # fast path, 30-day window (default)
537
+ slm session-context --max-age-days 7 # only last 7 days
538
+ slm session-context --max-age-days 0 # no age filter
539
+ slm session-context "my query" --full # full engine path (slow, requires Ollama)
540
+ slm session-context --json # agent-native JSON output
541
+ ```
542
+
502
543
  **No competitor learns at zero token cost.**
503
544
 
504
545
  </details>
@@ -637,6 +678,7 @@ All 8 mesh tools work seamlessly across machines:
637
678
  | `slm hooks install` | Wire auto-memory into Claude Code hooks |
638
679
  | `slm profile list/create/switch` | Profile management |
639
680
  | `slm decay` | Run memory lifecycle review |
681
+ | `slm session-context [query]` | Print session context (for hooks). Flags: `--max-age-days N` (default 30), `--full`, `--json` |
640
682
  | `slm quantize` | Run smart compression cycle |
641
683
  | `slm consolidate --cognitive` | Extract patterns from memory clusters |
642
684
  | `slm soft-prompts` | View auto-learned patterns |
@@ -66,6 +66,7 @@ src/superlocalmemory/compliance/lifecycle.py
66
66
  src/superlocalmemory/compliance/retention.py
67
67
  src/superlocalmemory/compliance/scheduler.py
68
68
  src/superlocalmemory/core/__init__.py
69
+ src/superlocalmemory/core/backend_orchestrator.py
69
70
  src/superlocalmemory/core/clock_monitor.py
70
71
  src/superlocalmemory/core/config.py
71
72
  src/superlocalmemory/core/consolidation_engine.py
@@ -93,6 +94,7 @@ src/superlocalmemory/core/ollama_embedder.py
93
94
  src/superlocalmemory/core/platform_utils.py
94
95
  src/superlocalmemory/core/priority_queue.py
95
96
  src/superlocalmemory/core/profiles.py
97
+ src/superlocalmemory/core/pruning_engine.py
96
98
  src/superlocalmemory/core/queue_consumer.py
97
99
  src/superlocalmemory/core/queue_dispatcher.py
98
100
  src/superlocalmemory/core/ram_lock.py
@@ -144,6 +146,8 @@ src/superlocalmemory/evolution/mutation_generator.py
144
146
  src/superlocalmemory/evolution/skill_evolver.py
145
147
  src/superlocalmemory/evolution/triggers.py
146
148
  src/superlocalmemory/evolution/types.py
149
+ src/superlocalmemory/graph/__init__.py
150
+ src/superlocalmemory/graph/cozo_backend.py
147
151
  src/superlocalmemory/hooks/__init__.py
148
152
  src/superlocalmemory/hooks/_outcome_common.py
149
153
  src/superlocalmemory/hooks/adapter_base.py
@@ -357,6 +361,7 @@ src/superlocalmemory/storage/schema_v32.py
357
361
  src/superlocalmemory/storage/schema_v3410.py
358
362
  src/superlocalmemory/storage/schema_v3411.py
359
363
  src/superlocalmemory/storage/schema_v343.py
364
+ src/superlocalmemory/storage/schema_v345.py
360
365
  src/superlocalmemory/storage/schema_v347.py
361
366
  src/superlocalmemory/storage/v2_migrator.py
362
367
  src/superlocalmemory/storage/migrations/M001_add_signal_features_columns.py
@@ -371,6 +376,7 @@ src/superlocalmemory/storage/migrations/M010_evolution_config.py
371
376
  src/superlocalmemory/storage/migrations/M011_archive_and_merge.py
372
377
  src/superlocalmemory/storage/migrations/M012_shadow_observations.py
373
378
  src/superlocalmemory/storage/migrations/M013_bi_temporal_columns.py
379
+ src/superlocalmemory/storage/migrations/M014_v345_scale_ready.py
374
380
  src/superlocalmemory/storage/migrations/__init__.py
375
381
  src/superlocalmemory/trust/__init__.py
376
382
  src/superlocalmemory/trust/gate.py
@@ -428,6 +434,8 @@ src/superlocalmemory/ui/vendor/bootstrap-icons/fonts/bootstrap-icons.woff2
428
434
  src/superlocalmemory/ui/vendor/inter-ui/inter-variable.min.css
429
435
  src/superlocalmemory/ui/vendor/inter-ui/variable/InterVariable-Italic.woff2
430
436
  src/superlocalmemory/ui/vendor/inter-ui/variable/InterVariable.woff2
437
+ src/superlocalmemory/vector/__init__.py
438
+ src/superlocalmemory/vector/lancedb_backend.py
431
439
  tests/test_auto_hooks.py
432
440
  tests/test_before_web_hook.py
433
441
  tests/test_behavioral_full.py