nexo-brain 5.4.0 → 5.4.1

package/.claude-plugin/plugin.json

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

@@ -18,9 +18,9 @@
 
 [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.4.0` is the current packaged-runtime line: runtime event bus at `~/.nexo/runtime/events.ndjson`, `nexo notify` for one-shot proactive events, `nexo health --json` for a rolled-up subsystem snapshot, `nexo logs --tail --json` for structured log access, and a safe flat→nested migration for `calibration.json` on older installs.
+Version `5.4.1` is the current packaged-runtime line: hook hygiene fix — the PostToolUse `capture-session.sh` hook had been reading a nonexistent env var since 2026-04-12, silently writing `"tool":"unknown"` to the Sensory Register for 48 hours. v5.4.1 parses the tool name from stdin JSON, removes the filter that was hiding `Bash`, and purges pre-fix entries from the buffer on update.
 
-Previously in `5.3.30`: four read-only CLI commands (`nexo schema`, `nexo identity`, `nexo onboard`, `nexo scan-profile`) let external UIs auto-adapt to the editable schema, identity, onboarding wizard, and profile heuristics.
+Previously in `5.4.0`: runtime event bus at `~/.nexo/runtime/events.ndjson`, `nexo notify`, `nexo health --json`, `nexo logs --tail --json`, and a safe flat→nested migration for `calibration.json`.
 
 Start here:
 - [5-minute quickstart](docs/quickstart-5-minutes.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "5.4.0",
+  "version": "5.4.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/cli.py

@@ -935,6 +935,27 @@ def _update(args):
     except Exception:
         pass
 
+    # v5.4.1 one-time hygiene: purge pre-fix "tool":"unknown" entries from
+    # the sensory-register buffer. Keeps a .pre-v5.4.1.bak backup the first
+    # time it runs on a given host.
+    try:
+        buf = NEXO_HOME / "brain" / "session_buffer.jsonl"
+        marker = buf.with_suffix(".jsonl.pre-v5.4.1.bak")
+        if buf.is_file() and not marker.is_file():
+            raw = buf.read_text(errors="ignore").splitlines()
+            unknown = sum(1 for ln in raw if '"tool":"unknown"' in ln)
+            if unknown > 0:
+                buf.rename(marker)
+                cleaned = "\n".join(ln for ln in raw if '"tool":"unknown"' not in ln)
+                if cleaned:
+                    cleaned += "\n"
+                buf.write_text(cleaned)
+                if not args.json:
+                    print(f"[NEXO] session_buffer.jsonl: purged {unknown} legacy "
+                          f"\"tool\":\"unknown\" entries (backup: {marker.name})", flush=True)
+    except Exception:
+        pass
+
     return 0 if result.get("ok") else 1
 
 

package/src/hooks/capture-session.sh

@@ -1,21 +1,43 @@
 #!/bin/bash
 # NEXO PostToolUse hook — captures tool usage to session_buffer.jsonl
-# This feeds the Sensory Register (Atkinson-Shiffrin Layer 1)
+# Feeds the Sensory Register (Atkinson-Shiffrin Layer 1).
+#
+# IMPORTANT: Claude Code passes the tool name in a JSON payload over stdin,
+# NOT as the $CLAUDE_TOOL_NAME env var. Earlier revisions of this hook
+# assumed the env var existed and always wrote "unknown", masking the
+# entire sensory-register stream. Do not reintroduce that pattern.
+
+set -uo pipefail
 
 NEXO_HOME="${NEXO_HOME:-$HOME/.nexo}"
 BUFFER="$NEXO_HOME/brain/session_buffer.jsonl"
-
 mkdir -p "$NEXO_HOME/brain"
 
-# Capture basic event: timestamp + tool name
-# Read stdin (Claude Code passes JSON via stdin for PostToolUse hooks)
 INPUT=$(cat 2>/dev/null || true)
-TOOL_NAME="${CLAUDE_TOOL_NAME:-unknown}"
-TS=$(date -u +"%Y-%m-%dT%H:%M:%S")
+[ -z "$INPUT" ] && exit 0
+
+# Extract tool_name from the stdin JSON payload. Fall back to env var for
+# compatibility with any platform that still sets it; final fallback is an
+# empty string, in which case we exit without writing so "unknown" noise
+# never reaches the buffer.
+TOOL_NAME=$(echo "$INPUT" \
+    | python3 -c "import sys,json; print(json.load(sys.stdin).get('tool_name',''))" 2>/dev/null \
+    || true)
+if [ -z "$TOOL_NAME" ]; then
+    TOOL_NAME="${CLAUDE_TOOL_NAME:-}"
+fi
+[ -z "$TOOL_NAME" ] && exit 0
 
-# Only log meaningful tool calls (skip reads, globs, greps)
+# Skip high-frequency read-only tools: they add noise without signal.
+# Bash / Write / Edit / MultiEdit / Task / MCP tools ARE kept — that is
+# where real state change happens and where the sensory register matters.
 case "$TOOL_NAME" in
-    Read|Glob|Grep|LS|Bash) exit 0 ;;
+    Read|Glob|Grep|LS|Skill|ToolSearch|TodoWrite) exit 0 ;;
 esac
 
-echo "{\"ts\":\"$TS\",\"tool\":\"$TOOL_NAME\",\"source\":\"hook\"}" >> "$BUFFER"
+TS=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+# Escape embedded quotes / special chars in tool names (MCP names can be
+# long and contain colons, underscores, and dashes).
+ESCAPED_NAME=$(printf '%s' "$TOOL_NAME" \
+    | python3 -c "import sys,json; print(json.dumps(sys.stdin.read().strip()))")
+echo "{\"ts\":\"$TS\",\"tool\":$ESCAPED_NAME,\"source\":\"hook\"}" >> "$BUFFER"