nexo-brain 7.20.15 → 7.20.17

package/README.md

@@ -18,7 +18,11 @@
 
 [Watch the overview video](https://nexo-brain.com/watch/) · [Watch on YouTube](https://www.youtube.com/watch?v=i2lkGhKyVqI) · [Open the infographic](https://nexo-brain.com/assets/nexo-brain-infographic-v5.png)
 
-Version `7.20.15` is the current packaged-runtime line. Patch release over v7.20.14 — Brain update/recovery paths now fail closed when the DB guard is missing or stale, and backup validation rejects any replacement that loses Local Memory tables.
+Version `7.20.17` is the current packaged-runtime line. Patch release over v7.20.16 — validated DB backups now tolerate tiny live-write growth from the Local Memory indexer while still rejecting real protected-table loss.
+
+Previously in `7.20.16`: patch release over v7.20.15 — packaged updates keep the `local_context` runtime shim importable and rollback code-tree snapshots safely when compatibility directories are symlinks.
+
+Previously in `7.20.15`: patch release over v7.20.14 — Brain update/recovery paths now fail closed when the DB guard is missing or stale, and backup validation rejects any replacement that loses Local Memory tables.
 
 Previously in `7.20.14`: patch release over v7.20.13 — Brain protects Local Memory during update/recovery paths, rotates runtime backup families to the latest 5 entries, keeps first-indexing status stable, and exposes bounded indexing speed profiles for Desktop.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "7.20.15",
+  "version": "7.20.17",
   "mcpName": "io.github.wazionapps/nexo",
   "description": "NEXO Brain — Shared brain for AI agents. Persistent memory, semantic RAG, natural forgetting, metacognitive guard, trust scoring, 150+ MCP tools. Works with Claude Code, Codex, Claude Desktop & any MCP client. 100% local, free.",
   "homepage": "https://nexo-brain.com",

package/src/auto_update.py

@@ -2440,6 +2440,7 @@ def _f06_legacy_shim_map() -> list[tuple[str, Path]]:
         ("plugins", core_root / "plugins"),
         ("hooks", core_root / "hooks"),
         ("rules", core_root / "rules"),
+        ("local_context", core_root / "local_context"),
         ("data", NEXO_HOME / "runtime" / "data"),
         ("logs", NEXO_HOME / "runtime" / "logs"),
         ("operations", NEXO_HOME / "runtime" / "operations"),
@@ -2508,6 +2509,7 @@ def _f06_live_legacy_paths() -> list[Path]:
             "plugins",
             "hooks",
             "rules",
+            "local_context",
             "db",
             "dashboard",
             "skills-core",
@@ -2593,6 +2595,7 @@ def _promote_packaged_runtime_code_to_core() -> None:
         ("cognitive", core_root / "cognitive"),
         ("doctor", core_root / "doctor"),
         ("dashboard", core_root / "dashboard"),
+        ("local_context", core_root / "local_context"),
         ("skills-core", core_root / "skills"),
     ]
 
@@ -4325,6 +4328,7 @@ def _backup_runtime_tree(dest: Path = NEXO_HOME) -> str:
         "db",
         "cognitive",
         "dashboard",
+        "local_context",
         "rules",
         "crons",
         "scripts",

package/src/db_guard.py

@@ -455,13 +455,28 @@ def validate_backup_matches_source(
         if s is not None and d is None:
             discrepancies.append(f"{table}: source={s} backup=missing")
             continue
-        if s is not None and d is not None and d < s:
+        if s is not None and d is not None and d < s and not _backup_drift_is_safe(s, d):
             discrepancies.append(f"{table}: source={s} backup={d}")
     if discrepancies:
         return False, "; ".join(discrepancies)
     return True, None
 
 
+def _backup_drift_is_safe(source_count: int, backup_count: int) -> bool:
+    """Allow tiny live-write drift while still rejecting real backup data loss.
+
+    `sqlite3.backup()` creates a consistent snapshot, but NEXO's background
+    memory service can add rows immediately after the snapshot. Comparing the
+    backup with the live DB after that growth must not abort an update. Small
+    tables stay exact because a 1-row loss there can be meaningful.
+    """
+    if backup_count <= 0 or source_count < 1000:
+        return False
+    drift = source_count - backup_count
+    allowed = max(25, int(source_count * 0.005))
+    return 0 < drift <= allowed
+
+
 def _quote_identifier(identifier: str) -> str:
     if identifier not in PROTECTED_TABLES:
         raise ValueError(f"refusing unsafe table identifier: {identifier!r}")

package/src/plugins/update.py

@@ -908,6 +908,7 @@ def _backup_code_tree() -> tuple[str | None, str | None]:
         "db",
         "cognitive",
         "dashboard",
+        "local_context",
         "rules",
         "crons",
         "scripts",
@@ -952,7 +953,9 @@ def _restore_code_tree(backup_dir: str) -> str | None:
         for item in bdir.iterdir():
             dest = NEXO_HOME / item.name
             if item.is_dir():
-                if dest.is_dir():
+                if dest.is_symlink():
+                    dest.unlink()
+                elif dest.is_dir():
                     shutil.rmtree(dest)
                 shutil.copytree(item, dest)
             elif item.is_file():