superlocalmemory 4.1.4__tar.gz → 4.1.6__tar.gz

{superlocalmemory-4.1.4/src/superlocalmemory.egg-info → superlocalmemory-4.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superlocalmemory
-Version: 4.1.4
+Version: 4.1.6
 Summary: Local-first agent memory with auditable hybrid retrieval
 Author-email: Varun Pratap Bhardwaj <admin@superlocalmemory.com>
 License-Expression: AGPL-3.0-or-later
@@ -108,7 +108,7 @@ Dynamic: license-file
   </picture>
 </p>
 
-<h1 align="center">SuperLocalMemory V4.1.4</h1>
+<h1 align="center">SuperLocalMemory V4.1.6</h1>
 
 <h2 align="center">Rent the LLM. Own the memory.</h2>
 
@@ -130,12 +130,12 @@ guarantee here is stated as a falsifiable invariant, tested under an adversarial
 negative control, and shipped with the harness that regenerates the evidence:
 <code>python benchmark/run_all.py --trials 200 --output-dir results/</code>. What each experiment
 does <em>not</em> exercise is stated too.</p>
-<p align="center"><code>v4.1.4</code> — one control plane: <strong>SLM-Mesh</strong> peer coordination · multi-scope memory (personal / shared / global) · profiles · Cache · Compress · 7-layer retrieval · code graph · Entity Explorer · skill evolution · Modes A/B/C · GDPR retention &amp; audit chain · bounded loops — across CLI, MCP, dashboard, the <strong>Claude plugin</strong>, the <strong>Codex add-on</strong>, and documented IDE integrations.<br/>
+<p align="center"><code>v4.1.6</code> — one control plane: <strong>SLM-Mesh</strong> peer coordination · multi-scope memory (personal / shared / global) · profiles · Cache · Compress · 7-layer retrieval · code graph · Entity Explorer · skill evolution · Modes A/B/C · GDPR retention &amp; audit chain · bounded loops — across CLI, MCP, dashboard, the <strong>Claude plugin</strong>, the <strong>Codex add-on</strong>, and documented IDE integrations.<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>Four public arXiv preprints</strong> · V4: <a href="https://arxiv.org/abs/2608.08253">arXiv:2608.08253</a> · companion archive: <a href="https://zenodo.org/records/21853302">Zenodo 21853302</a> (<a href="https://doi.org/10.5281/zenodo.21853302">DOI 10.5281/zenodo.21853302</a>) · prior preprints: <a href="https://arxiv.org/abs/2603.02240">2603.02240</a> · <a href="https://arxiv.org/abs/2603.14588">2603.14588</a> · <a href="https://arxiv.org/abs/2604.04514">2604.04514</a>.</p>
 
 <p align="center">
-  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/v4.1.4-Current_Release-2ea44f?style=for-the-badge&logo=checkmarx&logoColor=white" alt="v4.1.4 — Current Release"/></a>
+  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/v4.1.6-Current_Release-2ea44f?style=for-the-badge&logo=checkmarx&logoColor=white" alt="v4.1.6 — Current Release"/></a>
   <a href="https://arxiv.org/abs/2608.08253"><img src="https://img.shields.io/badge/arXiv-2608.08253-b31b1b?style=for-the-badge&logo=arxiv&logoColor=white" alt="SuperLocalMemory 4.0 paper on arXiv:2608.08253"/></a>
   <a href="https://zenodo.org/records/21853302"><img src="https://img.shields.io/badge/Zenodo-10.5281%2Fzenodo.21853302-1682D4?style=for-the-badge&logo=zenodo&logoColor=white" alt="V4 paper on Zenodo: 10.5281/zenodo.21853302"/></a>
   <a href="https://arxiv.org/abs/2603.14588"><img src="https://img.shields.io/badge/arXiv-2603.14588-b31b1b?style=for-the-badge&logo=arxiv&logoColor=white" alt="arXiv Paper"/></a>

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/README.md

@@ -5,7 +5,7 @@
   </picture>
 </p>
 
-<h1 align="center">SuperLocalMemory V4.1.4</h1>
+<h1 align="center">SuperLocalMemory V4.1.6</h1>
 
 <h2 align="center">Rent the LLM. Own the memory.</h2>
 
@@ -27,12 +27,12 @@ guarantee here is stated as a falsifiable invariant, tested under an adversarial
 negative control, and shipped with the harness that regenerates the evidence:
 <code>python benchmark/run_all.py --trials 200 --output-dir results/</code>. What each experiment
 does <em>not</em> exercise is stated too.</p>
-<p align="center"><code>v4.1.4</code> — one control plane: <strong>SLM-Mesh</strong> peer coordination · multi-scope memory (personal / shared / global) · profiles · Cache · Compress · 7-layer retrieval · code graph · Entity Explorer · skill evolution · Modes A/B/C · GDPR retention &amp; audit chain · bounded loops — across CLI, MCP, dashboard, the <strong>Claude plugin</strong>, the <strong>Codex add-on</strong>, and documented IDE integrations.<br/>
+<p align="center"><code>v4.1.6</code> — one control plane: <strong>SLM-Mesh</strong> peer coordination · multi-scope memory (personal / shared / global) · profiles · Cache · Compress · 7-layer retrieval · code graph · Entity Explorer · skill evolution · Modes A/B/C · GDPR retention &amp; audit chain · bounded loops — across CLI, MCP, dashboard, the <strong>Claude plugin</strong>, the <strong>Codex add-on</strong>, and documented IDE integrations.<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>Four public arXiv preprints</strong> · V4: <a href="https://arxiv.org/abs/2608.08253">arXiv:2608.08253</a> · companion archive: <a href="https://zenodo.org/records/21853302">Zenodo 21853302</a> (<a href="https://doi.org/10.5281/zenodo.21853302">DOI 10.5281/zenodo.21853302</a>) · prior preprints: <a href="https://arxiv.org/abs/2603.02240">2603.02240</a> · <a href="https://arxiv.org/abs/2603.14588">2603.14588</a> · <a href="https://arxiv.org/abs/2604.04514">2604.04514</a>.</p>
 
 <p align="center">
-  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/v4.1.4-Current_Release-2ea44f?style=for-the-badge&logo=checkmarx&logoColor=white" alt="v4.1.4 — Current Release"/></a>
+  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/v4.1.6-Current_Release-2ea44f?style=for-the-badge&logo=checkmarx&logoColor=white" alt="v4.1.6 — Current Release"/></a>
   <a href="https://arxiv.org/abs/2608.08253"><img src="https://img.shields.io/badge/arXiv-2608.08253-b31b1b?style=for-the-badge&logo=arxiv&logoColor=white" alt="SuperLocalMemory 4.0 paper on arXiv:2608.08253"/></a>
   <a href="https://zenodo.org/records/21853302"><img src="https://img.shields.io/badge/Zenodo-10.5281%2Fzenodo.21853302-1682D4?style=for-the-badge&logo=zenodo&logoColor=white" alt="V4 paper on Zenodo: 10.5281/zenodo.21853302"/></a>
   <a href="https://arxiv.org/abs/2603.14588"><img src="https://img.shields.io/badge/arXiv-2603.14588-b31b1b?style=for-the-badge&logo=arxiv&logoColor=white" alt="arXiv Paper"/></a>

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/plugin-src/rules/AGENTS.md

@@ -137,4 +137,4 @@ When the SLM MCP server is unavailable, use these CLI equivalents:
 - **slm-optimize-advisor** — context compression and KV cache
 - **slm-governance-advisor** — scope/role compliance, retention policies, GDPR
 
-SuperLocalMemory v4.1.4 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.1.6 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/plugin-src/skills/slm-cache/SKILL.md

@@ -145,4 +145,4 @@ These subcommands control daemon-level cache settings. They do not read or write
 
 ---
 
-SuperLocalMemory v4.1.4 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.1.6 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/plugin-src/skills/slm-compress/SKILL.md

@@ -147,4 +147,4 @@ Content over 1 MB (1 000 000 bytes UTF-8) is processed but `reversible` is force
 
 ---
 
-SuperLocalMemory v4.1.4 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.1.6 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/plugin-src/skills/slm-governance/SKILL.md

@@ -245,4 +245,4 @@ Before running any destructive operation (`forget`, `compact_memories`):
 
 ---
 
-*SuperLocalMemory v4.1.4 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.1.6 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/plugin-src/skills/slm-graph/SKILL.md

@@ -312,4 +312,4 @@ profile. See `slm-profile` for the full profile switching workflow.
 
 ---
 
-SuperLocalMemory v4.1.4 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.1.6 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/plugin-src/skills/slm-loop/SKILL.md

@@ -96,4 +96,4 @@ paused, name the approval needed; when errored, quote the short detail.
 
 ---
 
-SuperLocalMemory v4.1.4 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.1.6 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/plugin-src/skills/slm-mesh/SKILL.md

@@ -97,7 +97,7 @@ mesh_send(to=target_id, message="I'm starting work on auth/handler.py — please
 mesh_send(to="broadcast", message="Deploying to staging in 5 minutes")
 
 # Message all sessions working in the same project
-mesh_send(to="project:/Users/me/myproject", message="Tests are green on main")
+mesh_send(to="project:~/myproject", message="Tests are green on main")
 ```
 
 **4 KB message cap.** For large payloads (diffs, file contents), write to a file
@@ -279,4 +279,4 @@ mesh availability.
 
 ---
 
-*SuperLocalMemory v4.1.4 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.1.6 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/plugin-src/skills/slm-profile/SKILL.md

@@ -146,4 +146,4 @@ Name them differently in your MCP config (e.g. `superlocalmemory-personal` and
 
 ---
 
-*SuperLocalMemory v4.1.4 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.1.6 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/plugin-src/skills/slm-recall/SKILL.md

@@ -323,4 +323,4 @@ before recalling, then switch back. See `slm-profile` for workspace switching.
 
 ---
 
-*SuperLocalMemory v4.1.4 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.1.6 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/plugin-src/skills/slm-remember/SKILL.md

@@ -270,4 +270,4 @@ different workspace, use `switch_profile` first. See `slm-profile`.
 
 ---
 
-*SuperLocalMemory v4.1.4 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.1.6 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/plugin-src/skills/slm-scope/SKILL.md

@@ -173,4 +173,4 @@ to review the impact. See `slm-remember` for the full deletion discipline.
 
 ---
 
-*SuperLocalMemory v4.1.4 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.1.6 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/plugin-src/skills/slm-session/SKILL.md

@@ -52,7 +52,7 @@ recalls or remembers in that session.
 
 ```
 session_init(
-  project_path: str = "",  # working directory path, e.g. "/Users/me/projects/foo"
+  project_path: str = "",  # working directory path, e.g. "~/projects/foo"
   query: str = "",         # topic override; if omitted, derived from project_path
   max_results: int = 10,   # max memories to return (default: 10)
   max_age_days: int = 30,  # suppress memories older than N days unless score >= 0.7
@@ -253,4 +253,4 @@ explicitly and call `recall` with `include_global`/`include_shared` after
 
 ---
 
-*SuperLocalMemory v4.1.4 · Qualixar · AGPL-3.0-or-later*
+*SuperLocalMemory v4.1.6 · Qualixar · AGPL-3.0-or-later*

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/plugin-src/skills/slm-status/SKILL.md

@@ -163,4 +163,4 @@ multi-profile setup. To switch the active profile, see `slm-profile`.
 
 ---
 
-SuperLocalMemory v4.1.4 · Qualixar · AGPL-3.0-or-later
+SuperLocalMemory v4.1.6 · Qualixar · AGPL-3.0-or-later

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "superlocalmemory"
-version = "4.1.4"
+version = "4.1.6"
 description = "Local-first agent memory with auditable hybrid retrieval"
 readme = "README.md"
 license = "AGPL-3.0-or-later"

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/src/superlocalmemory/__init__.py

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

superlocalmemory-4.1.6/src/superlocalmemory/cli/diagnostics_cmd.py

@@ -0,0 +1,101 @@
+# Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
+# Licensed under AGPL-3.0-or-later - see LICENSE file
+
+"""Explicit manual export for local aggregate diagnostics."""
+
+from __future__ import annotations
+
+from argparse import Namespace
+
+
+def cmd_diagnostics(args: Namespace) -> None:
+    action = getattr(args, "diagnostics_command", None)
+    if action == "reliability":
+        _cmd_reliability(args)
+        return
+    if action != "export":
+        raise SystemExit("choose a diagnostics subcommand: export, reliability")
+
+    from superlocalmemory.cli.json_output import json_print
+    from superlocalmemory.infra.local_diagnostics import default_diagnostics
+
+    default_diagnostics().export_json(args.destination)
+    data = {"exported": True, "reporting": "manual_export_only"}
+    if bool(getattr(args, "json", False)):
+        json_print("diagnostics", data=data)
+        return
+    print("Local aggregate diagnostics exported by explicit request.")
+    print("No automatic reporting was enabled.")
+
+
+def _cmd_reliability(args: Namespace) -> None:
+    """Report whether wired mechanisms are effective, not merely present.
+
+    ``implemented``, ``reachable`` and ``effective`` are three different
+    questions. A grep answers the first and an import answers the second; only
+    querying this store answers the third. Both checks are read-only.
+    """
+    from superlocalmemory.cli.json_output import json_print
+    from superlocalmemory.infra.data_root import state_path
+    from superlocalmemory.reliability import (
+        DEFAULT_MIN_OBSERVATIONS,
+        check_beta_learners,
+        check_schema_guards,
+    )
+
+    floor = getattr(args, "min_observations", None) or DEFAULT_MIN_OBSERVATIONS
+    learners = check_beta_learners(state_path("learning.db"), min_observations=floor)
+    guards = check_schema_guards(state_path("memory.db"))
+
+    payload = {
+        "learners": [
+            {
+                "table": v.table,
+                "verdict": v.verdict,
+                "units": v.units,
+                "units_at_prior_mean": v.units_at_prior_mean,
+                "units_matching_neutral_identity": v.units_matching_neutral_identity,
+                "observations": v.observations,
+                "detail": v.detail,
+            }
+            for v in learners
+        ],
+        "schema_guards": [
+            {
+                "name": g.name,
+                "verdict": g.verdict,
+                "missing": list(g.missing),
+                "found_elsewhere": [
+                    {
+                        "table": tbl,
+                        "column": col,
+                        "populated_rows": n,
+                        # -1 when coverage over the guarded table could not be
+                        # measured. Populated rows alone overstate the remedy.
+                        "coverage_pct_of_guarded_table": cov,
+                    }
+                    for tbl, col, n, cov in g.found_elsewhere
+                ],
+                "detail": g.detail,
+            }
+            for g in guards
+        ],
+    }
+
+    if bool(getattr(args, "json", False)):
+        json_print("diagnostics-reliability", data=payload)
+        return
+
+    if not learners and not guards:
+        print("No Bayesian learners or schema-guarded paths found in this store.")
+        return
+
+    for v in learners:
+        print(f"[{v.verdict}] {v.table}")
+        print(f"    {v.detail}")
+    for g in guards:
+        print(f"[{g.verdict}] {g.name}")
+        print(f"    {g.detail}")
+
+
+__all__ = ["cmd_diagnostics"]

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/src/superlocalmemory/cli/main.py

@@ -875,6 +875,18 @@ def main() -> None:
         "export", help="Write a deterministic content-free JSON report",
     )
     diagnostics_export.add_argument("destination")
+    diagnostics_reliability = diagnostics_sub.add_parser(
+        "reliability",
+        help=(
+            "Ask whether wired mechanisms are actually effective: has each "
+            "Bayesian learner moved off its prior, and has each schema-guarded "
+            "path ever executed against this store"
+        ),
+    )
+    diagnostics_reliability.add_argument(
+        "--min-observations", type=int, default=None,
+        help="Observation floor below which an unmoved posterior is not reported",
+    )
     diagnostics_export.add_argument(
         "--json", action="store_true", help="Output structured JSON",
     )

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/src/superlocalmemory/core/maintenance_scheduler.py

@@ -77,11 +77,43 @@ class MaintenanceScheduler:
         )
         self._initial_metrics_timer.daemon = True
         self._initial_metrics_timer.start()
+        # M048's re-read pass is idempotent and safe to replay (see its
+        # verify() docstring), but the migration runner never replays a
+        # completed migration and the cycle above only reaches it every
+        # ``scheduler_interval_minutes`` (360 by default). A store that
+        # drifted since the last cycle stays blocking — ready=false,
+        # migrations=false — for up to that whole interval after every
+        # restart, not because the fix is slow, but because nothing asks
+        # for it sooner. Staggered behind the other two so none of the
+        # three one-shots contend for the write lock.
+        self._initial_reclassify_timer = threading.Timer(
+            210.0, self._initial_reclassify_upcoming,
+        )
+        self._initial_reclassify_timer.daemon = True
+        self._initial_reclassify_timer.start()
         logger.info(
             "Maintenance scheduler started (interval=%dm)",
             self._config.forgetting.scheduler_interval_minutes,
         )
 
+    def _initial_reclassify_upcoming(self) -> None:
+        """Best-effort one-shot M048 re-read shortly after boot.
+
+        Runs the same pass the periodic cycle already runs (see below) so a
+        store that drifted before this restart converges within seconds
+        instead of waiting up to a full maintenance interval with the
+        daemon reporting itself not ready.
+        """
+        if not self._running:
+            return
+        try:
+            from superlocalmemory.storage.migrations import (
+                M048_upcoming_holds_only_what_is_upcoming as _reclassify,
+            )
+            _reclassify.apply(open_connection=self._db.raw_connection)
+        except Exception as exc:
+            logger.debug("Startup plan re-read skipped: %s", exc)
+
     def _initial_cache_gc(self) -> None:
         """Best-effort one-shot activation-cache GC shortly after boot."""
         if not self._running:
@@ -133,6 +165,10 @@ class MaintenanceScheduler:
         if _metrics_timer is not None:
             _metrics_timer.cancel()
             self._initial_metrics_timer = None
+        _reclassify_timer = getattr(self, "_initial_reclassify_timer", None)
+        if _reclassify_timer is not None:
+            _reclassify_timer.cancel()
+            self._initial_reclassify_timer = None
         logger.info("Maintenance scheduler stopped")
 
     def _schedule_next(self) -> None:

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/src/superlocalmemory/core/remember_runtime.py

@@ -419,8 +419,19 @@ class CanonicalRememberRuntime:
             OwnershipRequiredError,
             WriteCoordinatorError,
         ) as exc:
+            # Name which of the three it was. They are not interchangeable and
+            # they call for different responses: an unavailable journal is I/O
+            # or lock contention and worth retrying, lost ownership means
+            # another writer holds the lease, and a coordinator error is the
+            # same type the generation fence raises to reject a stale epoch.
+            # Collapsing all three into one string makes a spurious fence
+            # rejection indistinguishable from a transient disk stall, for the
+            # operator reading a log and for a caller deciding whether to
+            # retry. Only the class name is included: it is the whole of the
+            # discriminating information and carries no request content.
             raise CanonicalRememberUnavailable(
-                "canonical remember is temporarily unavailable"
+                "canonical remember is temporarily unavailable "
+                f"({type(exc).__name__})"
             ) from exc
         finally:
             clear_admission_epoch(request.profile_id, request.idempotency_key)

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/src/superlocalmemory/encoding/fact_extractor.py

@@ -134,9 +134,13 @@ _SYSTEM_PROMPT = (
     "must name the subject explicitly.\n"
     "2. Each fact must be a COMPLETE, STANDALONE statement understandable "
     "without the original conversation.\n"
-    "3. Convert ALL relative time to ABSOLUTE dates when possible. "
-    "'Yesterday' with session date 2024-01-15 becomes '2024-01-14'. "
-    "'Next month' becomes the actual month and year.\n"
+    "3. Convert ALL relative time to ABSOLUTE dates when possible, using "
+    "ONLY the conversation date given in the user message below as your "
+    "reference point — never invent or assume a date. 'Yesterday' resolves "
+    "to one calendar day before that conversation date; 'next month' "
+    "resolves to the following calendar month of that same date. If no "
+    "conversation date is given, leave the date unresolved rather than "
+    "guessing one.\n"
     "4. Resolve ALL coreferences. 'He went there' must become "
     "'[Person name] went to [Place name]'.\n"
     "5. Extract relationships between people when mentioned.\n"

{superlocalmemory-4.1.4 → superlocalmemory-4.1.6}/src/superlocalmemory/mcp/session_binding.py

@@ -34,7 +34,13 @@ __all__ = ["resolve_session_id", "SESSION_ENV_VARS"]
 
 #: Checked in order. Hosts set one or the other; SLM's own takes precedence so a
 #: user can override a host that sets its variable to something unhelpful.
-SESSION_ENV_VARS = ("SLM_SESSION_ID", "CLAUDE_SESSION_ID")
+#: ``CLAUDE_CODE_SESSION_ID`` is the actual variable Claude Code's MCP
+#: subprocess environment carries — verified on a live daemon 2026-08-24,
+#: this pipeline settled 6013/6039 outcomes at the neutral 0.5 fallback
+#: because the old two-name list never matched it, and every recall fell
+#: through to the synthetic ``mcp:<agent_id>`` id that step 4 deliberately
+#: excludes from matching.
+SESSION_ENV_VARS = ("SLM_SESSION_ID", "CLAUDE_SESSION_ID", "CLAUDE_CODE_SESSION_ID")
 
 
 def resolve_session_id(

superlocalmemory-4.1.6/src/superlocalmemory/reliability/__init__.py

@@ -0,0 +1,45 @@
+# Copyright (c) 2026 Varun Pratap Bhardwaj / Qualixar
+# Licensed under AGPL-3.0-or-later - see LICENSE file
+# Part of SuperLocalMemory | https://qualixar.com | https://varunpratap.com
+
+"""Checks that ask whether a mechanism is *effective*, not merely present.
+
+Three questions get confused in a system this size:
+
+* **Implemented** — the code exists. A grep answers this.
+* **Reachable** — something calls it. A call-graph trace answers this.
+* **Effective** — it has actually changed an outcome against real data.
+  **Neither of the above answers this.** Only querying the store does.
+
+A mechanism can pass the first two questions for months and fail the third
+silently: a learner whose reward channel emits a constant still records plays,
+and a conditional path guarded by a missing column still appears in coverage.
+Nothing raises, nothing logs, and every file is present.
+
+The two checks here answer the third question directly.
+
+* :mod:`.prior_distance` — has a Bayesian learner's posterior actually moved
+  away from its prior?
+* :mod:`.join_liveness` — has a schema-guarded code path ever executed against
+  this store, and if not, which requirement is missing?
+
+Both are read-only, both are fail-soft, and neither is on a hot path.
+"""
+
+from superlocalmemory.reliability.join_liveness import (
+    GuardVerdict,
+    check_schema_guards,
+)
+from superlocalmemory.reliability.prior_distance import (
+    DEFAULT_MIN_OBSERVATIONS,
+    LearnerVerdict,
+    check_beta_learners,
+)
+
+__all__ = [
+    "DEFAULT_MIN_OBSERVATIONS",
+    "GuardVerdict",
+    "LearnerVerdict",
+    "check_beta_learners",
+    "check_schema_guards",
+]