nexo-brain 5.0.0 → 5.0.1

package/.claude-plugin/plugin.json

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

@@ -87,6 +87,12 @@ 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.0.1` hardens the live 5.0 upgrade path:
+
+- managed Claude Code hooks are now cleaned up when an older release left obsolete core-managed entries behind
+- upgrades no longer preserve the stale `heartbeat-guard.sh` path that could create warning storms and fake "hung" symptoms after `nexo update`
+- the corrected path has been revalidated on a real install with `nexo clients sync`, Codex/Claude Code headless runtime access, email-monitor recovery, and a full `nexo update`
+
 Version `5.0.0` closes the loop between memory, decisions, outcomes, and reusable behavior:
 
 - goal profiles are now explicit and auditable instead of living as hidden heuristics
@@ -702,7 +708,7 @@ The installer handles everything and syncs the same `nexo` MCP brain into Claude
     - Node.js project detected
   Configuring MCP server...
   Setting up nervous system...
-    13 core recovery-aware jobs configured.
+    15 core recovery-aware jobs configured.
     Dashboard configured at localhost:6174.
   Caffeinate enabled.
   Generating operator instructions...

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "5.0.0",
+  "version": "5.0.1",
   "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/client_sync.py

@@ -386,6 +386,32 @@ CORE_HOOK_SPECS = [
     },
 ]
 
+LEGACY_CORE_HOOK_IDENTITIES_BY_EVENT = {
+    "PostToolUse": {
+        "heartbeat-guard.sh",
+    },
+}
+
+
+def _current_core_hook_identities_by_event() -> dict[str, set[str]]:
+    identities: dict[str, set[str]] = {}
+    for spec in CORE_HOOK_SPECS:
+        identities.setdefault(spec["event"], set()).add(spec["identity"])
+    return identities
+
+
+CURRENT_CORE_HOOK_IDENTITIES_BY_EVENT = _current_core_hook_identities_by_event()
+
+
+def _managed_core_hook_identities_by_event() -> dict[str, set[str]]:
+    managed = {event: set(identities) for event, identities in CURRENT_CORE_HOOK_IDENTITIES_BY_EVENT.items()}
+    for event, identities in LEGACY_CORE_HOOK_IDENTITIES_BY_EVENT.items():
+        managed.setdefault(event, set()).update(identities)
+    return managed
+
+
+MANAGED_CORE_HOOK_IDENTITIES_BY_EVENT = _managed_core_hook_identities_by_event()
+
 
 def _resolve_hook_source_dir(runtime_root: Path) -> Path:
     direct = runtime_root / "hooks"
@@ -450,6 +476,25 @@ def _merge_core_hooks(existing_hooks, *, runtime_root: Path, nexo_home: Path) ->
     hooks_dir = _resolve_hook_source_dir(runtime_root)
     managed_count = 0
 
+    for event, managed_identities in MANAGED_CORE_HOOK_IDENTITIES_BY_EVENT.items():
+        sections = _normalize_hook_sections(hooks_payload.get(event))
+        desired_identities = CURRENT_CORE_HOOK_IDENTITIES_BY_EVENT.get(event, set())
+        cleaned_sections: list[dict] = []
+        for section in sections:
+            cleaned_hooks = []
+            for hook in section["hooks"]:
+                identity = _hook_identity(hook.get("command", ""))
+                if identity in managed_identities and identity not in desired_identities:
+                    continue
+                cleaned_hooks.append(hook)
+            cleaned_sections.append(
+                {
+                    "matcher": section.get("matcher", "*") or "*",
+                    "hooks": cleaned_hooks,
+                }
+            )
+        hooks_payload[event] = cleaned_sections
+
     for spec in CORE_HOOK_SPECS:
         event = spec["event"]
         sections = _normalize_hook_sections(hooks_payload.get(event))