nexo-brain 7.9.7 → 7.9.9

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "7.9.7",
+  "version": "7.9.9",
   "description": "Local cognitive runtime for Claude Code \u2014 persistent memory, overnight learning, doctor diagnostics, personal scripts, recovery-aware jobs, startup preflight, and optional dashboard/power helper.",
   "author": {
     "name": "NEXO Brain",

package/README.md

@@ -18,7 +18,7 @@
 
 [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.9.7` is the current packaged-runtime line. Patch release that hardens the installed-user MCP/update path after live Desktop validation: Brain now normalizes managed runtime configs back to the stable `~/.nexo/core` root instead of leaving clients pinned to versioned snapshots, mirrors Claude Code MCP config into `~/.claude/mcp-cortex.json`, stamps the active MCP client in generated configs, and disables the FastMCP wrapped `output_schema` that was making Claude Code reject plain-text `nexo_*` tool results. Coordinated Desktop v0.28.8 consumes the same contract so archive/reopen/app-quit flows recover cleanly without reviving stale sessions.
+Version `7.9.9` is the current packaged-runtime line. Hotfix release over `7.9.8`: after the packaged updater fix, the installer now also repairs installs whose metadata already says the new version but whose active runtime still points to an older `~/.nexo/core/current -> versions/<old>`. Running `nexo-brain --yes` or the postinstall path now recopies the packaged runtime, re-activates `core/current`, and leaves installed users on the real new code instead of a stale snapshot. Coordinated Desktop v0.28.11 bundles the matching quit-path fix.
 
 Previously in `7.9.5`: patch release that fixes canonical diary confirmation for Desktop: Brain resolves the Desktop/Claude session UUID through NEXO SID aliases before checking `session_diary`, so archive/delete/app-exit can confirm diaries written by `nexo_session_diary_write` under the active `nexo-...` SID. Verification: `pytest tests/test_lifecycle_events.py` (28 passing) plus coordinated Desktop v0.28.6 shutdown/archive/delete/app-exit checks.
 

package/bin/nexo-brain.js

@@ -684,6 +684,59 @@ function finalizeF06Layout(python, nexoHome = NEXO_HOME) {
   }
 }
 
+function readRuntimeVersionFrom(basePath) {
+  if (!basePath) return "";
+  for (const candidate of [
+    path.join(basePath, "version.json"),
+    path.join(basePath, "package.json"),
+  ]) {
+    try {
+      if (!fs.existsSync(candidate)) continue;
+      const payload = JSON.parse(fs.readFileSync(candidate, "utf8"));
+      const version = String(payload.version || "").trim();
+      if (version) return version;
+    } catch (_) {}
+  }
+  return "";
+}
+
+function readActiveRuntimeSnapshotVersion(nexoHome = NEXO_HOME) {
+  return readRuntimeVersionFrom(path.join(nexoHome, "core", "current"));
+}
+
+function activateVersionedRuntimeSnapshot(python, nexoHome = NEXO_HOME, version = "") {
+  try {
+    const srcDir = path.join(__dirname, "..", "src");
+    const inline = [
+      "import json, os, pathlib, sys",
+      `sys.path.insert(0, ${JSON.stringify(srcDir)})`,
+      "from runtime_versioning import activate_versioned_runtime_snapshot",
+      "home = pathlib.Path(os.environ['NEXO_HOME'])",
+      `result = activate_versioned_runtime_snapshot(source_root=home / 'core', version=${JSON.stringify(version)})`,
+      "print(json.dumps(result))",
+    ].join("; ");
+    const result = spawnSync(python, ["-c", inline], {
+      cwd: nexoHome,
+      env: {
+        ...process.env,
+        NEXO_HOME: nexoHome,
+      },
+      encoding: "utf8",
+    });
+    if (result.status !== 0) {
+      const detail = (result.stderr || result.stdout || "").trim();
+      throw new Error(detail || "activation command failed");
+    }
+    const payload = JSON.parse(String(result.stdout || "{}").trim() || "{}");
+    if (!payload || payload.ok !== true) {
+      throw new Error(payload && payload.error ? payload.error : "activation returned not-ok");
+    }
+    return payload;
+  } catch (err) {
+    return { ok: false, error: String((err && err.message) || err) };
+  }
+}
+
 function getCoreRuntimeFlatFiles(srcDir = path.join(__dirname, "..", "src")) {
   const staticFiles = [
     "server.py",
@@ -2296,10 +2349,17 @@ async function runSetup() {
       const currentPkg = readPackageJson();
       const installedVersion = installed.version || "0.0.0";
       const currentVersion = currentPkg.version;
-
-      if (installedVersion !== currentVersion) {
-        log(`Existing installation detected: v${installedVersion} → v${currentVersion}`);
-        log("Running auto-migration...");
+      const activeRuntimeVersion = readActiveRuntimeSnapshotVersion(NEXO_HOME);
+      const needsRuntimeRepair = activeRuntimeVersion !== currentVersion;
+
+      if (installedVersion !== currentVersion || needsRuntimeRepair) {
+        if (installedVersion !== currentVersion) {
+          log(`Existing installation detected: v${installedVersion} → v${currentVersion}`);
+          log("Running auto-migration...");
+        } else {
+          log(`Existing installation detected: metadata v${installedVersion}, runtime core/current v${activeRuntimeVersion || "missing"}`);
+          log("Repairing active runtime snapshot...");
+        }
 
         // Recursive copy helper (skips __pycache__, .pyc, .db files)
         const srcDir = path.join(__dirname, "..", "src");
@@ -2469,6 +2529,9 @@ async function runSetup() {
           installed_at: installed.installed_at,
           updated_at: new Date().toISOString(),
           migrated_from: installedVersion,
+          ...(installedVersion === currentVersion && activeRuntimeVersion && activeRuntimeVersion !== currentVersion
+            ? { runtime_repaired_from: activeRuntimeVersion }
+            : {}),
         }, null, 2));
         syncRuntimePackageMetadata(path.join(__dirname, ".."), NEXO_HOME);
         log("Finalizing F0.6 runtime layout...");
@@ -2476,6 +2539,11 @@ async function runSetup() {
         if (!migLayoutFinalize.ok) {
           throw new Error(`F0.6 layout finalization failed: ${migLayoutFinalize.error}`);
         }
+        const migActivation = activateVersionedRuntimeSnapshot(migPython, NEXO_HOME, currentVersion);
+        if (!migActivation.ok) {
+          throw new Error(`Runtime activation failed: ${migActivation.error}`);
+        }
+        log(`  Runtime activation: core/current -> versions/${currentVersion}`);
 
         // Keep the rendered template in-memory for version tracking, but do
         // not drop a loose reference file in NEXO_HOME root.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "7.9.7",
+  "version": "7.9.9",
   "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

@@ -3956,6 +3956,13 @@ UPDATE_HISTORY_FILE = paths.logs_dir() / "update-history.jsonl"
 def _resolve_sync_source() -> tuple[Path | None, Path | None]:
     dest = NEXO_HOME
 
+    def _is_relative_to(path: Path, parent: Path) -> bool:
+        try:
+            path.relative_to(parent)
+            return True
+        except Exception:
+            return False
+
     def _runtime_version_source() -> Path | None:
         for version_file in (NEXO_HOME / "version.json", NEXO_HOME / "core" / "version.json"):
             if not version_file.is_file():
@@ -3974,16 +3981,21 @@ def _resolve_sync_source() -> tuple[Path | None, Path | None]:
 
     try:
         runtime_core = (dest / "core").resolve()
+        runtime_versions = (runtime_core / "versions").resolve(strict=False)
         code_resolved = NEXO_CODE.resolve()
     except Exception:
         runtime_core = dest / "core"
+        runtime_versions = runtime_core / "versions"
         code_resolved = NEXO_CODE
 
     # Packaged/runtime-only installs resolve the launcher to ``~/.nexo/core``.
     # Those must use the packaged updater path instead of treating the managed
-    # runtime itself as a mutable source repository. Only a recorded external
-    # source repo in ``version.json`` should reactivate source-sync mode.
-    if code_resolved == runtime_core:
+    # runtime itself as a mutable source repository. That also applies once the
+    # launcher resolves through ``core/current`` into ``core/versions/X.Y.Z``:
+    # the active snapshot is still managed runtime state, not a dev checkout.
+    # Only a recorded external source repo in ``version.json`` should
+    # reactivate source-sync mode.
+    if code_resolved == runtime_core or _is_relative_to(code_resolved, runtime_versions):
         version_source = _runtime_version_source()
         if version_source:
             return version_source / "src", version_source