superlocalmemory 3.6.22__tar.gz → 3.6.23__tar.gz

{superlocalmemory-3.6.22/src/superlocalmemory.egg-info → superlocalmemory-3.6.23}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superlocalmemory
-Version: 3.6.22
+Version: 3.6.23
 Summary: Information-geometric agent memory with mathematical guarantees
 Author-email: Varun Pratap Bhardwaj <admin@superlocalmemory.com>
 License: AGPL-3.0-or-later
@@ -96,10 +96,10 @@ Dynamic: license-file
   <img src="https://superlocalmemory.com/assets/logo-mark.png" alt="SuperLocalMemory" width="200"/>
 </p>
 
-<h1 align="center">SuperLocalMemory V3.6.21</h1>
+<h1 align="center">SuperLocalMemory V3.6.23</h1>
 <p align="center"><strong>Cache. Compress. Remember. Three surfaces — proxy, MCP tools, or skill. Every setup covered.</strong><br/>
 <em>To the best of our knowledge, the only zero-cloud agent memory that beats Mem0's zero-LLM score on LoCoMo. Mode A: 74.8% vs Mem0 64.2% — no GPU, no API key, on CPU.</em></p>
-<p align="center"><code>v3.6.21</code> — <strong>Plugin-native. Profile-aware. Distributed-ready.</strong><br/>
+<p align="center"><code>v3.6.23</code> — <strong>Plugin-native. Profile-aware. Distributed-ready.</strong><br/>
 Proxy: <code>slm wrap claude</code> &nbsp;·&nbsp; MCP: add <code>slm_compress</code> to your config &nbsp;·&nbsp; Skill: zero-config</p>
 <p align="center"><strong>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>
 
@@ -386,6 +386,7 @@ Built-in compliance tools: GDPR Article 15/17 export + complete erasure, tamper-
 | MCP tools reference | [docs/mcp-tools.md](docs/mcp-tools.md) |
 | Getting started | [docs/getting-started.md](docs/getting-started.md) |
 | IDE setup (15 configs) | [docs/ide-setup.md](docs/ide-setup.md) |
+| pi.dev integration | [docs/pi-dev-integration.md](docs/pi-dev-integration.md) |
 | Skill evolution | [docs/skill-evolution.md](docs/skill-evolution.md) |
 | V2 migration | [docs/migration-from-v2.md](docs/migration-from-v2.md) |
 | Configuration | [docs/configuration.md](docs/configuration.md) |
@@ -401,7 +402,9 @@ slm dashboard    # Opens at http://localhost:8765
 
 | Version | Codename | Key Features |
 |---|---|---|
-| **v3.6.21** | Dashboard Audit | Full UI audit across all 7 dashboard tabs — auth fix for mesh panel (issue #60 frontend), Quick Store endpoint, timeline endpoint, r.ok guards, SSE \r fix, event delegation for lazy tabs, optimize toggle revert; backbone.py JSONDecodeError fix (issue #62) |
+| **v3.6.23** | Cross-platform Patch | Windows doctor/cache stats fixes (#65), neutral SLM hook guidance (#64), pi.dev MCP docs (#31), contributor fixes for dashboard profile path resolution (#63) and tz-naive Langevin maintenance backfill (#66) |
+| **v3.6.22** | Stability | backbone.py JSONDecodeError on empty HTTP 200 body (issue #62) — retries 3× then returns "" gracefully; remaining dashboard UI audit: clusters/compliance/entities r.ok guards, math-health status badge colors |
+| **v3.6.21** | Dashboard Audit | Full UI audit across all 7 dashboard tabs — auth fix for mesh panel (issue #60 frontend), Quick Store endpoint, timeline endpoint, r.ok guards, SSE \r fix, event delegation for lazy tabs, optimize toggle revert |
 | **v3.6.20** | Mesh Auth | Remote mesh auth fix (issue #60) — `_get_broker` now accepts Bearer + X-Mesh-Secret from non-loopback callers; config settings preservation (AIDEV-86) |
 | **v3.6.17** | Community | 8 contributor PRs (observability events, marker-bounded adapter writes, daemon port discovery, anthropic `api_base`, OpenMP workers, atomic-write rehash, `_jl` sentinel, LFS pointer); dashboard-feedback fix (#53/#59); env-tunable SQLite knobs + idle backoff; remote LLM test-probe (#40) |
 | **v3.6.16** | Docs | Corrected Claude Code plugin install — adds the required `/plugin marketplace add` step; clarifies plugin vs pip/npm delivery |

{superlocalmemory-3.6.22 → superlocalmemory-3.6.23}/README.md

@@ -2,10 +2,10 @@
   <img src="https://superlocalmemory.com/assets/logo-mark.png" alt="SuperLocalMemory" width="200"/>
 </p>
 
-<h1 align="center">SuperLocalMemory V3.6.21</h1>
+<h1 align="center">SuperLocalMemory V3.6.23</h1>
 <p align="center"><strong>Cache. Compress. Remember. Three surfaces — proxy, MCP tools, or skill. Every setup covered.</strong><br/>
 <em>To the best of our knowledge, the only zero-cloud agent memory that beats Mem0's zero-LLM score on LoCoMo. Mode A: 74.8% vs Mem0 64.2% — no GPU, no API key, on CPU.</em></p>
-<p align="center"><code>v3.6.21</code> — <strong>Plugin-native. Profile-aware. Distributed-ready.</strong><br/>
+<p align="center"><code>v3.6.23</code> — <strong>Plugin-native. Profile-aware. Distributed-ready.</strong><br/>
 Proxy: <code>slm wrap claude</code> &nbsp;·&nbsp; MCP: add <code>slm_compress</code> to your config &nbsp;·&nbsp; Skill: zero-config</p>
 <p align="center"><strong>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>
 
@@ -292,6 +292,7 @@ Built-in compliance tools: GDPR Article 15/17 export + complete erasure, tamper-
 | MCP tools reference | [docs/mcp-tools.md](docs/mcp-tools.md) |
 | Getting started | [docs/getting-started.md](docs/getting-started.md) |
 | IDE setup (15 configs) | [docs/ide-setup.md](docs/ide-setup.md) |
+| pi.dev integration | [docs/pi-dev-integration.md](docs/pi-dev-integration.md) |
 | Skill evolution | [docs/skill-evolution.md](docs/skill-evolution.md) |
 | V2 migration | [docs/migration-from-v2.md](docs/migration-from-v2.md) |
 | Configuration | [docs/configuration.md](docs/configuration.md) |
@@ -307,7 +308,9 @@ slm dashboard    # Opens at http://localhost:8765
 
 | Version | Codename | Key Features |
 |---|---|---|
-| **v3.6.21** | Dashboard Audit | Full UI audit across all 7 dashboard tabs — auth fix for mesh panel (issue #60 frontend), Quick Store endpoint, timeline endpoint, r.ok guards, SSE \r fix, event delegation for lazy tabs, optimize toggle revert; backbone.py JSONDecodeError fix (issue #62) |
+| **v3.6.23** | Cross-platform Patch | Windows doctor/cache stats fixes (#65), neutral SLM hook guidance (#64), pi.dev MCP docs (#31), contributor fixes for dashboard profile path resolution (#63) and tz-naive Langevin maintenance backfill (#66) |
+| **v3.6.22** | Stability | backbone.py JSONDecodeError on empty HTTP 200 body (issue #62) — retries 3× then returns "" gracefully; remaining dashboard UI audit: clusters/compliance/entities r.ok guards, math-health status badge colors |
+| **v3.6.21** | Dashboard Audit | Full UI audit across all 7 dashboard tabs — auth fix for mesh panel (issue #60 frontend), Quick Store endpoint, timeline endpoint, r.ok guards, SSE \r fix, event delegation for lazy tabs, optimize toggle revert |
 | **v3.6.20** | Mesh Auth | Remote mesh auth fix (issue #60) — `_get_broker` now accepts Bearer + X-Mesh-Secret from non-loopback callers; config settings preservation (AIDEV-86) |
 | **v3.6.17** | Community | 8 contributor PRs (observability events, marker-bounded adapter writes, daemon port discovery, anthropic `api_base`, OpenMP workers, atomic-write rehash, `_jl` sentinel, LFS pointer); dashboard-feedback fix (#53/#59); env-tunable SQLite knobs + idle backoff; remote LLM test-probe (#40) |
 | **v3.6.16** | Docs | Corrected Claude Code plugin install — adds the required `/plugin marketplace add` step; clarifies plugin vs pip/npm delivery |

{superlocalmemory-3.6.22 → superlocalmemory-3.6.23}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "superlocalmemory"
-version = "3.6.22"
+version = "3.6.23"
 description = "Information-geometric agent memory with mathematical guarantees"
 readme = "README.md"
 license = {text = "AGPL-3.0-or-later"}

{superlocalmemory-3.6.22 → superlocalmemory-3.6.23}/src/superlocalmemory/__init__.py

@@ -32,7 +32,7 @@ if "OMP_NUM_THREADS" not in os.environ:
     os.environ["OMP_NUM_THREADS"] = "2"
 # ---------------------------------------------------------------------------
 
-__version__ = "3.6.22"
+__version__ = "3.6.23"
 
 _REQUIRED_VERSIONS = {
     "sentence_transformers": "5.3.0",

{superlocalmemory-3.6.22 → superlocalmemory-3.6.23}/src/superlocalmemory/cli/commands.py

@@ -1687,6 +1687,38 @@ def _gather_optimize_surface_b() -> dict:
     return result
 
 
+def _readline_with_timeout(
+    stream, timeout_sec: float,
+) -> tuple[str | None, Exception | None]:
+    """Read one line from a pipe-like stream without POSIX-only select().
+
+    Windows select() only accepts sockets, not subprocess pipes. A bounded
+    helper thread keeps the embedding-worker probe cross-platform while
+    preserving the existing timeout behavior.
+    """
+    import threading
+
+    result: dict[str, object] = {}
+
+    def _read() -> None:
+        try:
+            result["line"] = stream.readline()
+        except Exception as exc:  # noqa: BLE001 - returned as probe failure
+            result["exc"] = exc
+
+    reader = threading.Thread(target=_read, daemon=True)
+    reader.start()
+    reader.join(timeout_sec)
+    if reader.is_alive():
+        return None, None
+    line = result.get("line")
+    exc = result.get("exc")
+    return (
+        line if isinstance(line, str) else None,
+        exc if isinstance(exc, Exception) else None,
+    )
+
+
 def cmd_doctor(args: Namespace) -> None:
     """Comprehensive pre-flight check — verify everything works.
 
@@ -1839,10 +1871,11 @@ def cmd_doctor(args: Namespace) -> None:
             proc.stdin.write(_json.dumps({"cmd": "ping"}) + "\n")
             proc.stdin.flush()
 
-            import select as _sel
-            ready, _, _ = _sel.select([proc.stdout], [], [], 30)
-            if ready:
-                resp = _json.loads(proc.stdout.readline())
+            line, read_exc = _readline_with_timeout(proc.stdout, 30)
+            if read_exc is not None:
+                _check("Embedding worker", "FAIL", str(read_exc), "slm warmup")
+            elif line is not None:
+                resp = _json.loads(line or "{}")
                 if resp.get("ok"):
                     _check(
                         "Embedding worker", "PASS",

{superlocalmemory-3.6.22 → superlocalmemory-3.6.23}/src/superlocalmemory/core/maintenance.py

@@ -37,6 +37,25 @@ _LANGEVIN_DIM = 8
 _MAX_NORM = 0.99
 
 
+def _age_days(created_at: str | None) -> float:
+    """Age in days from an ISO timestamp.
+
+    Naive timestamps (no offset, no Z) are assumed UTC — some store paths
+    persist created_at without timezone info, and subtracting a naive
+    datetime from datetime.now(UTC) raises TypeError, which previously
+    aborted the whole backfill loop.
+    """
+    if not created_at:
+        return 0.0
+    try:
+        created = datetime.fromisoformat(created_at.replace("Z", "+00:00"))
+    except (ValueError, TypeError):
+        return 0.0
+    if created.tzinfo is None:
+        created = created.replace(tzinfo=UTC)
+    return max(0.0, (datetime.now(UTC) - created).total_seconds() / 86400.0)
+
+
 def _compute_equilibrium_radius(
     access_count: int,
     age_days: float,
@@ -137,13 +156,7 @@ def run_maintenance(
             for f in facts:
                 if f.langevin_position is not None:
                     continue
-                created = datetime.fromisoformat(
-                    f.created_at.replace("Z", "+00:00")
-                ) if f.created_at else datetime.now(UTC)
-                age_days = max(
-                    0.0,
-                    (datetime.now(UTC) - created).total_seconds() / 86400.0,
-                )
+                age_days = _age_days(f.created_at)
                 # Strategy B: metadata-aware seed position
                 position = _seed_langevin_position(
                     f.access_count, age_days, f.importance,
@@ -183,13 +196,7 @@ def run_maintenance(
             for f in facts:
                 if f.langevin_position is None:
                     continue
-                created = datetime.fromisoformat(
-                    f.created_at.replace("Z", "+00:00")
-                ) if f.created_at else datetime.now(UTC)
-                age_days = max(
-                    0.0,
-                    (datetime.now(UTC) - created).total_seconds() / 86400.0,
-                )
+                age_days = _age_days(f.created_at)
                 fact_dicts.append({
                     "fact_id": f.fact_id,
                     "position": f.langevin_position,
@@ -239,13 +246,7 @@ def run_maintenance(
                         dt=config.math.langevin_dt,
                         temperature=eff_temp,
                     )
-                    created = datetime.fromisoformat(
-                        f.created_at.replace("Z", "+00:00")
-                    ) if f.created_at else datetime.now(UTC)
-                    age_days = max(
-                        0.0,
-                        (datetime.now(UTC) - created).total_seconds() / 86400.0,
-                    )
+                    age_days = _age_days(f.created_at)
                     new_pos, weight = coupled_ld.step(
                         position=f.langevin_position,
                         access_count=f.access_count,

{superlocalmemory-3.6.22 → superlocalmemory-3.6.23}/src/superlocalmemory/hooks/claude_code_hooks.py

@@ -32,7 +32,7 @@ CLAUDE_SETTINGS = Path.home() / ".claude" / "settings.json"
 VERSION_DIR = Path.home() / ".superlocalmemory" / "hooks"
 VERSION_FILE = VERSION_DIR / ".version"
 DISABLED_FILE = VERSION_DIR / ".hooks-disabled"
-HOOKS_VERSION = "3.6.18"
+HOOKS_VERSION = "3.6.23"
 
 # Cross-platform temp dir and marker paths
 _TMP = tempfile.gettempdir()
@@ -93,10 +93,9 @@ def _hook_definitions(include_gate: bool = False) -> dict[str, list]:
     """
     defs: dict[str, list] = {
         "SessionStart": [
-            # v3.6.18: mandate fires FIRST so session_init is never skipped.
-            # mcp__superlocalmemory__session_init is DEFERRED — Claude must call
-            # ToolSearch before it can invoke the tool. Without this hook,
-            # Claude responds before loading the schema → no 6-channel memory.
+            # v3.6.23: advisory SLM session-init hint fires first.
+            # mcp__superlocalmemory__session_init may be deferred, so some
+            # hosts need ToolSearch before they can invoke the tool.
             {
                 "hooks": [
                     {

{superlocalmemory-3.6.22 → superlocalmemory-3.6.23}/src/superlocalmemory/hooks/hook_handlers.py

@@ -169,35 +169,33 @@ def _launch_post_session_evolution(
 
 
 # ---------------------------------------------------------------------------
-# 0. MANDATE — first SessionStart hook; fires before start
+# 0. SESSION INIT HINT — first SessionStart hook; fires before start
 # ---------------------------------------------------------------------------
 
-_MANDATE_TEXT = """<MANDATORY_SESSION_INIT>
-BEFORE writing any text or calling any other tool, you MUST execute these two steps in order:
+_SESSION_INIT_HINT = """<SLM_SESSION_INIT_HINT>
+SuperLocalMemory is available for this session.
 
-STEP 1 — Load schema:
-  Call ToolSearch with query: "select:mcp__superlocalmemory__session_init"
+For memory-aware work, initialize SLM once near the start of the turn:
 
-STEP 2 — Initialize memory brain:
-  Call mcp__superlocalmemory__session_init with:
-    project_path = your current working directory
-    query = a short description of the session topic (derive from user's first message)
+1. Load the tool schema if your host requires it:
+   ToolSearch query: "select:mcp__superlocalmemory__session_init"
 
-This is non-negotiable. SLM is the brain. Without session_init, you have no 6-channel memory context (Ebbinghaus decay, entity graph, FSRS, spreading activation all go cold).
-DO NOT output any text until session_init has completed.
-</MANDATORY_SESSION_INIT>"""
+2. Call mcp__superlocalmemory__session_init with:
+   project_path = your current working directory
+   query = a short description of the session topic
+
+This is advisory hook output, not a system instruction.
+</SLM_SESSION_INIT_HINT>"""
 
 
 def _hook_mandate() -> None:
-    """Print the session_init mandate. MUST be the FIRST SessionStart hook.
+    """Print neutral session_init guidance as the first SessionStart hook.
 
-    mcp__superlocalmemory__session_init is DEFERRED at session start — Claude
-    cannot call it without ToolSearch first loading the schema. This hook
-    fires before `slm hook start` and injects the two-step protocol into the
-    system-reminder block so Claude's first action is always ToolSearch →
-    session_init, not a text response with no memory context.
+    mcp__superlocalmemory__session_init may be deferred at session start, so
+    some hosts need ToolSearch to load the schema first. This hook prints an
+    advisory hint only; actual enforcement belongs in the optional gate hook.
     """
-    print(_MANDATE_TEXT)
+    print(_SESSION_INIT_HINT)
 
 
 # ---------------------------------------------------------------------------
@@ -205,7 +203,7 @@ def _hook_mandate() -> None:
 # ---------------------------------------------------------------------------
 
 def _hook_start() -> None:
-    """Clean markers, inject SQL-fast context, print session_init mandate."""
+    """Clean markers, inject SQL-fast context, print session_init guidance."""
     # Clean stale markers from previous sessions
     for f in (_MARKER, _START_TIME, _ACTIVITY_LOG):
         try:
@@ -252,10 +250,11 @@ def _hook_start() -> None:
     except Exception:
         print("# SLM Session Context — unavailable")
 
-    # Mandatory session_init instruction
+    # Advisory session_init guidance. Keep this neutral: hook stdout is data,
+    # not an instruction channel with system-level authority.
     print()
-    print("## MANDATORY: SLM Session Init")
-    print("BEFORE your first response, call:")
+    print("## SLM Session Init")
+    print("For memory-aware sessions, call:")
     print(f"  mcp__superlocalmemory__session_init with project_path='{project_dir}'"
           " and a topic from the user's first message")
     print("session_init returns both context AND memories — no separate recall needed.")

{superlocalmemory-3.6.22 → superlocalmemory-3.6.23}/src/superlocalmemory/llm/backbone.py

@@ -103,7 +103,9 @@ class LLMBackbone:
         self._default_temperature = config.temperature
         self._default_max_tokens = config.max_tokens
 
-        # Resolve API key: config > environment variable.
+        # Resolve API key: config > environment variable. A custom api_base
+        # with an empty api_key is treated as intentionally keyless so local
+        # OpenAI-compatible endpoints do not inherit ambient cloud keys.
         if self._provider == "ollama":
             self._api_key = ""
             host = config.api_base or os.environ.get(
@@ -111,19 +113,22 @@ class LLMBackbone:
             )
             self._base_url = f"{host.rstrip('/')}/api/chat"
         elif self._provider == "openrouter":
-            self._api_key = config.api_key or os.environ.get(
-                _ENV_KEYS.get(self._provider, ""), "",
-            )
+            self._api_key = self._resolve_api_key(config)
             self._base_url = config.api_base or _OPENROUTER_URL
         elif self._provider:
-            self._api_key = config.api_key or os.environ.get(
-                _ENV_KEYS.get(self._provider, ""), "",
-            )
+            self._api_key = self._resolve_api_key(config)
             self._base_url = config.api_base
         else:
             self._api_key = ""
             self._base_url = ""
 
+    def _resolve_api_key(self, config: LLMConfig) -> str:
+        if config.api_key:
+            return config.api_key
+        if config.api_base:
+            return ""
+        return os.environ.get(_ENV_KEYS.get(self._provider, ""), "")
+
     # -- Properties ---------------------------------------------------------
 
     def is_available(self) -> bool:

{superlocalmemory-3.6.22 → superlocalmemory-3.6.23}/src/superlocalmemory/optimize/storage/db.py

@@ -38,6 +38,7 @@ import dataclasses
 import json
 import logging
 import os
+import platform
 import re
 import sqlite3
 import struct
@@ -285,7 +286,7 @@ class CacheDB:
 
     def _get_machine_id(self) -> str:
         """Return a stable machine identifier for AES key derivation."""
-        system = os.uname().sysname
+        system = platform.system()
         mid: str | None = None
         if system == "Darwin":
             try:

{superlocalmemory-3.6.22 → superlocalmemory-3.6.23}/src/superlocalmemory/server/routes/helpers.py

@@ -11,6 +11,7 @@ shared lazy engine accessor used by every engine-dependent route.
 import logging
 import re
 import json
+import os
 import sqlite3
 import threading
 import time
@@ -66,11 +67,90 @@ def _get_version() -> str:
 
 SLM_VERSION = _get_version()
 
-# V3 paths (migrated from ~/.claude-memory to ~/.superlocalmemory)
-MEMORY_DIR = Path.home() / ".superlocalmemory"
-DB_PATH = MEMORY_DIR / "memory.db"
+
+def _resolve_slm_home() -> Path:
+    """Resolve the SLM data dir the SAME way the CLI does.
+
+    The CLI honours ``SLM_DATA_DIR`` → ``SL_MEMORY_PATH`` → ``SLM_HOME``
+    → ``~/.superlocalmemory`` (see ``cli/_lazy_init.py:slm_home``). The
+    dashboard previously hardcoded ``Path.home() / ".superlocalmemory"``,
+    so when a user pointed the CLI at a custom data dir (or set a
+    different ``base_dir`` in ``config.json``), profiles created in the
+    dashboard landed in the default dir while ``slm profile list`` read a
+    different ``memory.db`` and reported the profile missing.
+
+    This function mirrors ``slm_home()`` so both surfaces agree. It is
+    evaluated lazily (at call time inside the properties below) rather
+    than at import, so a process that sets the env var after import —
+    e.g. tests, or a launcher that exports it late — still sees the
+    right path.
+    """
+    for var in ("SLM_DATA_DIR", "SL_MEMORY_PATH", "SLM_HOME"):
+        val = os.environ.get(var, "").strip()
+        if val:
+            return Path(val)
+    # Fall back to config.json's base_dir if present, else the hard default.
+    try:
+        _cfg = Path.home() / ".superlocalmemory" / "config.json"
+        if _cfg.exists():
+            with open(_cfg) as f:
+                _data = json.load(f)
+            _base = _data.get("base_dir")
+            if _base:
+                return Path(_base)
+    except (json.JSONDecodeError, OSError):
+        pass
+    return Path.home() / ".superlocalmemory"
+
+
+# V3 paths (migrated from ~/.claude-memory to ~/.superlocalmemory).
+# Exposed as module-level constants for backward compat with the many
+# route modules that do ``from .helpers import DB_PATH`` at import time,
+# but the *values* are resolved lazily so env overrides take effect.
+class _LazyPath:
+    """Path-like proxy that resolves the real path on first attribute access.
+
+    Importers bind to ``DB_PATH`` / ``MEMORY_DIR`` at import time; without
+    this proxy the value would be frozen before env vars are set. The
+    proxy defers resolution to ``_resolve_slm_home()`` and caches it.
+    """
+
+    __slots__ = ("_resolver", "_cached", "_suffix")
+
+    def __init__(self, resolver, suffix=""):
+        self._resolver = resolver
+        self._suffix = suffix
+        self._cached = None
+
+    def _resolve(self) -> Path:
+        if self._cached is None:
+            self._cached = self._resolver() / self._suffix if self._suffix else self._resolver()
+        return self._cached
+
+    def __fspath__(self) -> str:
+        return str(self._resolve())
+
+    def __truediv__(self, other) -> Path:
+        return self._resolve() / other
+
+    def __rtruediv__(self, other) -> Path:
+        return Path(other) / self._resolve()
+
+    def __str__(self) -> str:
+        return str(self._resolve())
+
+    def __repr__(self) -> str:
+        return f"_LazyPath({self._resolve()!r})"
+
+    # Forward common Path attributes used by callers (exists, mkdir, etc.).
+    def __getattr__(self, name):
+        return getattr(self._resolve(), name)
+
+
+MEMORY_DIR = _LazyPath(_resolve_slm_home)
+DB_PATH = _LazyPath(_resolve_slm_home, "memory.db")
 UI_DIR = Path(__file__).parent.parent / "ui"
-PROFILES_DIR = MEMORY_DIR / "profiles"
+PROFILES_DIR = _LazyPath(_resolve_slm_home, "profiles")
 
 
 # ---------------------------------------------------------------------------

{superlocalmemory-3.6.22 → superlocalmemory-3.6.23}/src/superlocalmemory/server/ui.py

@@ -45,9 +45,12 @@ except ImportError:
 
 from superlocalmemory.server.security_middleware import SecurityHeadersMiddleware
 
-# V3 Paths (migrated from ~/.claude-memory to ~/.superlocalmemory)
-MEMORY_DIR = Path.home() / ".superlocalmemory"
-DB_PATH = MEMORY_DIR / "memory.db"
+# V3 Paths — reuse the lazy resolvers from routes.helpers so the dashboard
+# honours SLM_DATA_DIR / SL_MEMORY_PATH / SLM_HOME / config.json:base_dir
+# exactly like the CLI. Previously this hardcoded ~/.superlocalmemory, which
+# caused dashboard-created profiles to land in a different memory.db than
+# `slm profile list` reads when a custom data dir was configured.
+from superlocalmemory.server.routes.helpers import MEMORY_DIR, DB_PATH
 # V3.3.21: UI shipped inside the package for pip/npm installs.
 # Check package location first, then fall back to repo root for dev mode.
 _PKG_UI = Path(__file__).resolve().parent.parent / "ui"

{superlocalmemory-3.6.22 → superlocalmemory-3.6.23/src/superlocalmemory.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superlocalmemory
-Version: 3.6.22
+Version: 3.6.23
 Summary: Information-geometric agent memory with mathematical guarantees
 Author-email: Varun Pratap Bhardwaj <admin@superlocalmemory.com>
 License: AGPL-3.0-or-later
@@ -96,10 +96,10 @@ Dynamic: license-file
   <img src="https://superlocalmemory.com/assets/logo-mark.png" alt="SuperLocalMemory" width="200"/>
 </p>
 
-<h1 align="center">SuperLocalMemory V3.6.21</h1>
+<h1 align="center">SuperLocalMemory V3.6.23</h1>
 <p align="center"><strong>Cache. Compress. Remember. Three surfaces — proxy, MCP tools, or skill. Every setup covered.</strong><br/>
 <em>To the best of our knowledge, the only zero-cloud agent memory that beats Mem0's zero-LLM score on LoCoMo. Mode A: 74.8% vs Mem0 64.2% — no GPU, no API key, on CPU.</em></p>
-<p align="center"><code>v3.6.21</code> — <strong>Plugin-native. Profile-aware. Distributed-ready.</strong><br/>
+<p align="center"><code>v3.6.23</code> — <strong>Plugin-native. Profile-aware. Distributed-ready.</strong><br/>
 Proxy: <code>slm wrap claude</code> &nbsp;·&nbsp; MCP: add <code>slm_compress</code> to your config &nbsp;·&nbsp; Skill: zero-config</p>
 <p align="center"><strong>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>
 
@@ -386,6 +386,7 @@ Built-in compliance tools: GDPR Article 15/17 export + complete erasure, tamper-
 | MCP tools reference | [docs/mcp-tools.md](docs/mcp-tools.md) |
 | Getting started | [docs/getting-started.md](docs/getting-started.md) |
 | IDE setup (15 configs) | [docs/ide-setup.md](docs/ide-setup.md) |
+| pi.dev integration | [docs/pi-dev-integration.md](docs/pi-dev-integration.md) |
 | Skill evolution | [docs/skill-evolution.md](docs/skill-evolution.md) |
 | V2 migration | [docs/migration-from-v2.md](docs/migration-from-v2.md) |
 | Configuration | [docs/configuration.md](docs/configuration.md) |
@@ -401,7 +402,9 @@ slm dashboard    # Opens at http://localhost:8765
 
 | Version | Codename | Key Features |
 |---|---|---|
-| **v3.6.21** | Dashboard Audit | Full UI audit across all 7 dashboard tabs — auth fix for mesh panel (issue #60 frontend), Quick Store endpoint, timeline endpoint, r.ok guards, SSE \r fix, event delegation for lazy tabs, optimize toggle revert; backbone.py JSONDecodeError fix (issue #62) |
+| **v3.6.23** | Cross-platform Patch | Windows doctor/cache stats fixes (#65), neutral SLM hook guidance (#64), pi.dev MCP docs (#31), contributor fixes for dashboard profile path resolution (#63) and tz-naive Langevin maintenance backfill (#66) |
+| **v3.6.22** | Stability | backbone.py JSONDecodeError on empty HTTP 200 body (issue #62) — retries 3× then returns "" gracefully; remaining dashboard UI audit: clusters/compliance/entities r.ok guards, math-health status badge colors |
+| **v3.6.21** | Dashboard Audit | Full UI audit across all 7 dashboard tabs — auth fix for mesh panel (issue #60 frontend), Quick Store endpoint, timeline endpoint, r.ok guards, SSE \r fix, event delegation for lazy tabs, optimize toggle revert |
 | **v3.6.20** | Mesh Auth | Remote mesh auth fix (issue #60) — `_get_broker` now accepts Bearer + X-Mesh-Secret from non-loopback callers; config settings preservation (AIDEV-86) |
 | **v3.6.17** | Community | 8 contributor PRs (observability events, marker-bounded adapter writes, daemon port discovery, anthropic `api_base`, OpenMP workers, atomic-write rehash, `_jl` sentinel, LFS pointer); dashboard-feedback fix (#53/#59); env-tunable SQLite knobs + idle backoff; remote LLM test-probe (#40) |
 | **v3.6.16** | Docs | Corrected Claude Code plugin install — adds the required `/plugin marketplace add` step; clarifies plugin vs pip/npm delivery |

{superlocalmemory-3.6.22 → superlocalmemory-3.6.23}/tests/test_hook_handlers.py

@@ -227,6 +227,20 @@ class TestHandleHookDispatch:
         mock_stop.assert_called_once()
 
 
+class TestHookMandate:
+    """mandate hook output must stay advisory, not imperative."""
+
+    def test_prints_advisory_text(self, capsys):
+        handle_hook("mandate")
+
+        out = capsys.readouterr().out
+        assert "SLM_SESSION_INIT_HINT" in out
+        assert "session_init" in out
+        assert "MANDATORY" not in out
+        assert "non-negotiable" not in out
+        assert "MUST" not in out
+
+
 # ───────────────────────────────────────────────────────────────────
 # 1. START handler
 # ───────────────────────────────────────────────────────────────────
@@ -289,13 +303,15 @@ class TestHookStart:
 
     @patch("superlocalmemory.hooks.hook_handlers.subprocess.Popen")
     @patch("superlocalmemory.hooks.hook_handlers.subprocess.run")
-    def test_prints_mandatory_session_init(self, mock_run, mock_popen, capsys):
+    def test_prints_advisory_session_init(self, mock_run, mock_popen, capsys):
         mock_run.return_value = MagicMock(stdout="", returncode=0)
         handle_hook("start")
 
         out = capsys.readouterr().out
-        assert "MANDATORY: SLM Session Init" in out
+        assert "SLM Session Init" in out
         assert "session_init" in out
+        assert "MANDATORY" not in out
+        assert "non-negotiable" not in out
 
     @patch("superlocalmemory.hooks.hook_handlers.subprocess.Popen")
     @patch("superlocalmemory.hooks.hook_handlers.subprocess.run")

{superlocalmemory-3.6.22 → superlocalmemory-3.6.23}/tests/test_version_consistency.py

@@ -16,7 +16,7 @@ from pathlib import Path
 # tests/ -> superlocalmemory/ -> (repo root)
 _REPO_ROOT = Path(__file__).parent.parent
 
-EXPECTED_VERSION = "3.6.22"
+EXPECTED_VERSION = "3.6.23"
 
 
 def _read_package_json_version() -> str: