nexo-brain 5.3.3 → 5.3.5

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "5.3.3",
+  "version": "5.3.5",
   "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,6 +18,8 @@
 
 [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 `5.3.4` closes the last packaged-runtime core/personal leak from the hook migration work: legacy hook aliases stay out of the personal bucket, `nexo update` removes those retired aliases when the canonical hooks already exist, and both `nexo` and `nexo chat` now show latest vs installed version at a glance.
+
 Start here:
 - [5-minute quickstart](docs/quickstart-5-minutes.md)
 - [Workflow quickstart](docs/workflows-quickstart.md)
@@ -87,7 +89,7 @@ Versions `3.1.7` through `3.2.0` close the recent-memory gap:
 - when even that misses, NEXO now exposes raw transcript fallback tools for Claude Code and Codex session stores
 - NEXO can now inspect itself through a live system catalog derived from canonical sources instead of relying only on stale docs or operator memory
 
-Version `5.3.3` closes the remaining packaged-runtime doctor mismatch: the built-in hourly backup helper is now inventoried as a core LaunchAgent, so clean installs no longer get a false unknown-LaunchAgent warning. Version `5.3.2` already hardened the runtime boundary by persisting which runtime scripts/hooks are core product artifacts, keeping `nexo scripts` from mixing those into the personal bucket, and migrating the legacy Claude Code heartbeat wrappers into managed core hooks.
+Version `5.3.5` keeps CLI version visibility honest right after `nexo update`: if the cached npm version lags behind the runtime you just installed, `nexo` / `nexo chat` now clamp `Latest` to the installed version and refresh the cache instead of showing a stale older release. Version `5.3.4` already cleaned up legacy core alias leakage and added the version-status banner. Version `5.3.3` closed the remaining packaged-runtime doctor mismatch: the built-in hourly backup helper is now inventoried as a core LaunchAgent, so clean installs no longer get a false unknown-LaunchAgent warning. Version `5.3.2` already hardened the runtime boundary by persisting which runtime scripts/hooks are core product artifacts, keeping `nexo scripts` from mixing those into the personal bucket, and migrating the legacy Claude Code heartbeat wrappers into managed core hooks.
 
 Version `5.3.1` normalizes packaged npm installs so they behave like packaged npm installs: `nexo update` now keeps the runtime anchored to `~/.nexo`, refreshes packaged bootstrap/client artifacts after upgrade, avoids repo-only release-artifact drift in installed runtimes, and keeps personal scripts on the canonical packaged path.
 

package/package.json

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

@@ -364,6 +364,12 @@ def _cleanup_retired_runtime_files():
         NEXO_HOME / "scripts" / "heartbeat-user-msg.sh",
         NEXO_HOME / "hooks" / "heartbeat-guard.sh",
     ]
+    conditional_retired = [
+        (NEXO_HOME / "scripts" / "nexo-postcompact.sh", NEXO_HOME / "hooks" / "post-compact.sh"),
+        (NEXO_HOME / "scripts" / "nexo-memory-precompact.sh", NEXO_HOME / "hooks" / "pre-compact.sh"),
+        (NEXO_HOME / "scripts" / "nexo-memory-stop.sh", NEXO_HOME / "hooks" / "session-stop.sh"),
+        (NEXO_HOME / "scripts" / "nexo-session-briefing.sh", NEXO_HOME / "hooks" / "session-start.sh"),
+    ]
     for target in retired:
         try:
             if target.exists():
@@ -375,6 +381,13 @@ def _cleanup_retired_runtime_files():
                 _log(f"Removed retired runtime file: {target.name}")
         except Exception as e:
             _log(f"Retired runtime cleanup warning ({target.name}): {e}")
+    for target, canonical in conditional_retired:
+        try:
+            if target.exists() and canonical.exists():
+                target.unlink()
+                _log(f"Removed retired runtime alias: {target.name} (canonical: {canonical.name})")
+        except Exception as e:
+            _log(f"Retired runtime alias cleanup warning ({target.name}): {e}")
 
 
 def _sync_crons():

package/src/cli.py

@@ -38,6 +38,7 @@ import os
 import shutil
 import subprocess
 import sys
+import time
 from pathlib import Path
 
 from runtime_home import export_resolved_nexo_home
@@ -49,6 +50,8 @@ TERMINAL_CLIENT_LABELS = {
     "codex": "Codex",
 }
 TERMINAL_CLIENT_ORDER = ("claude_code", "codex")
+VERSION_STATUS_CACHE = NEXO_HOME / "config" / "cli-version-status.json"
+LATEST_NPM_PACKAGE = "nexo-brain"
 
 
 def _get_version() -> str:
@@ -67,6 +70,87 @@ def _get_version() -> str:
             continue
     return "?"
 
+
+def _load_latest_version_cache(max_age_seconds: int = 6 * 3600) -> str | None:
+    try:
+        payload = json.loads(VERSION_STATUS_CACHE.read_text())
+    except Exception:
+        return None
+    version = str(payload.get("latest", "")).strip()
+    checked_at = float(payload.get("checked_at", 0) or 0)
+    if not version:
+        return None
+    if checked_at and (time.time() - checked_at) > max_age_seconds:
+        return None
+    return version
+
+
+def _save_latest_version_cache(version: str) -> None:
+    VERSION_STATUS_CACHE.parent.mkdir(parents=True, exist_ok=True)
+    VERSION_STATUS_CACHE.write_text(json.dumps({
+        "latest": version,
+        "checked_at": time.time(),
+    }))
+
+
+def _fetch_latest_version(timeout_seconds: int = 2) -> str | None:
+    try:
+        result = subprocess.run(
+            ["npm", "view", LATEST_NPM_PACKAGE, "version"],
+            capture_output=True,
+            text=True,
+            timeout=timeout_seconds,
+        )
+    except Exception:
+        return None
+    if result.returncode != 0:
+        return None
+    latest = result.stdout.strip()
+    if not latest:
+        return None
+    try:
+        _save_latest_version_cache(latest)
+    except Exception:
+        pass
+    return latest
+
+
+def _should_refresh_latest_version() -> bool:
+    try:
+        return sys.stdout.isatty() or sys.stderr.isatty()
+    except Exception:
+        return False
+
+
+def _version_sort_key(raw: str) -> tuple[tuple[int, ...], int, str]:
+    value = str(raw or "").strip()
+    base, _, suffix = value.partition("-")
+    parts: list[int] = []
+    for piece in base.split("."):
+        try:
+            parts.append(int(piece))
+        except Exception:
+            parts.append(-1)
+    while len(parts) < 3:
+        parts.append(0)
+    return (tuple(parts), 1 if not suffix else 0, suffix)
+
+
+def _version_status_line() -> str:
+    installed = _get_version()
+    latest = _load_latest_version_cache()
+    if latest is None and _should_refresh_latest_version():
+        latest = _fetch_latest_version()
+    if latest and installed and _version_sort_key(latest) < _version_sort_key(installed):
+        latest = installed
+        try:
+            _save_latest_version_cache(installed)
+        except Exception:
+            pass
+    if latest:
+        return f"NEXO Latest: v{latest} | Installed: v{installed}"
+    return f"NEXO Installed: v{installed}"
+
 # Ensure src/ is on path for imports
 if str(NEXO_CODE) not in sys.path:
     sys.path.insert(0, str(NEXO_CODE))
@@ -1011,6 +1095,7 @@ def _prompt_for_terminal_client(
 def _chat(args):
     target = args.path or "."
     selected_client = getattr(args, "client", None)
+    print(f"[NEXO] {_version_status_line()}", file=sys.stderr)
 
     try:
         from auto_update import startup_preflight
@@ -1499,6 +1584,7 @@ def _uninstall(args):
 def _print_help():
     v = _get_version()
     print(f"""NEXO Runtime CLI v{v}
+{_version_status_line()}
 
 Commands:
   nexo chat [path] [--client claude_code|codex]      Launch a NEXO terminal client

package/src/script_registry.py

@@ -50,6 +50,10 @@ _LEGACY_CORE_RUNTIME_FILES = {
     "heartbeat-enforcement.py",
     "heartbeat-posttool.sh",
     "heartbeat-user-msg.sh",
+    "nexo-memory-precompact.sh",
+    "nexo-memory-stop.sh",
+    "nexo-postcompact.sh",
+    "nexo-session-briefing.sh",
 }
 
 # Forbidden patterns — direct DB access from personal scripts