nexo-brain 7.31.2 → 7.31.3

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "7.31.2",
+  "version": "7.31.3",
   "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 `7.31.2` is the current packaged-runtime line. Patch release over v7.31.1 - the session ID becomes a durable identity (sessions survive quiet work periods; physical cleanup at 24h), runtime residents are isolated per generation so two installs can never kill each other's resident, and obsolete residents retire themselves once clients disconnect.
+Version `7.31.3` is the current packaged-runtime line. Patch release over v7.31.2 - the recommended Claude Code model returns to Opus 4.8 with max reasoning (installs riding NEXO defaults migrate back automatically; customized models untouched), and the dead heartbeat-enforcement hook trio is removed from the source tree.
 
-Previously in `7.31.1`: patch release over v7.31.0 - headless automations pause and queue when the selected engine is unavailable (credits, rate limits, expired auth) and resume automatically with one operator notice in their language; protocol nudge shaping ships in shadow mode; and the client config push stops writing an invalid `mcp__*` permission rule to Claude Code settings.
+Previously in `7.31.2`: patch release over v7.31.1 - the session ID becomes a durable identity (sessions survive quiet work periods; physical cleanup at 24h), runtime residents are isolated per generation so two installs can never kill each other's resident, and obsolete residents retire themselves once clients disconnect.
 
 Previously in `7.30.33`: patch release over v7.30.32 - personal agent/script status now keeps the newest real run between manual executions and cron history, so a successful manual agent run cannot be hidden behind an older scheduled failure.
 

package/bin/nexo-brain.js

@@ -115,7 +115,7 @@ const PUBLIC_CONTRIBUTION_UPSTREAM = "wazionapps/nexo";
 const MODEL_DEFAULTS_PATH = path.join(__dirname, "..", "src", "model_defaults.json");
 function _loadModelDefaults() {
   const fallback = {
-    claude_code: { model: "claude-fable-5", reasoning_effort: "max", display_name: "Fable 5 with max reasoning" },
+    claude_code: { model: "claude-opus-4-8", reasoning_effort: "max", display_name: "Opus 4.8 with max reasoning" },
     codex: { model: "gpt-5.5", reasoning_effort: "xhigh", display_name: "GPT-5.5 with max reasoning" },
   };
   try {

package/package.json

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

@@ -2058,7 +2058,7 @@ def _refresh_resonance_tiers_model_defaults(dest: Path = NEXO_HOME) -> list[str]
         dest / "personal" / "brain" / "resonance_tiers.json",
         dest / "brain" / "resonance_tiers.json",
     ]
-    old_prefixes = ("claude-opus-4-6", "claude-opus-4-7", "claude-opus-4-8")
+    old_prefixes = ("claude-opus-4-6", "claude-opus-4-7", "claude-fable-5")
 
     for target_path in target_paths:
         try:
@@ -2089,7 +2089,7 @@ def _refresh_resonance_tiers_model_defaults(dest: Path = NEXO_HOME) -> list[str]
             model = str(claude.get("model") or "").strip()
             tier_changed = False
             if model and model.startswith(old_prefixes):
-                claude["model"] = str(source_claude.get("model") or "claude-fable-5")
+                claude["model"] = str(source_claude.get("model") or "claude-opus-4-8")
                 tier_changed = True
             if tier_changed and not str(claude.get("effort") or "").strip() and source_claude.get("effort"):
                 claude["effort"] = str(source_claude.get("effort"))

package/src/client_sync.py

@@ -83,7 +83,7 @@ except Exception:
 
     def resolve_client_runtime_profile(client: str, preferences: dict | None = None) -> dict:
         defaults = {
-            "claude_code": {"model": "claude-fable-5", "reasoning_effort": "max"},
+            "claude_code": {"model": "claude-opus-4-8", "reasoning_effort": "max"},
             "codex": {"model": "gpt-5.5", "reasoning_effort": "xhigh"},
         }
         return dict(defaults.get(client, {}))

package/src/model_defaults.json

@@ -1,17 +1,24 @@
 {
   "schema_version": 1,
   "claude_code": {
-    "model": "claude-fable-5",
+    "model": "claude-opus-4-8",
     "reasoning_effort": "max",
-    "display_name": "Fable 5 with max reasoning",
-    "recommendation_version": 4,
-    "previous_defaults": ["claude-opus-4-8", "claude-opus-4-7[1m]", "claude-opus-4-7", "claude-opus-4-6[1m]"]
+    "display_name": "Opus 4.8 with max reasoning",
+    "recommendation_version": 5,
+    "previous_defaults": [
+      "claude-fable-5",
+      "claude-opus-4-7[1m]",
+      "claude-opus-4-7",
+      "claude-opus-4-6[1m]"
+    ]
   },
   "codex": {
     "model": "gpt-5.5",
     "reasoning_effort": "xhigh",
     "display_name": "GPT-5.5 with max reasoning",
     "recommendation_version": 2,
-    "previous_defaults": ["gpt-5.4"]
+    "previous_defaults": [
+      "gpt-5.4"
+    ]
   }
 }

package/src/model_defaults.py

@@ -20,7 +20,7 @@ from typing import Any
 _FALLBACK: dict[str, Any] = {
     "schema_version": 1,
     "claude_code": {
-        "model": "claude-fable-5",
+        "model": "claude-opus-4-8",
         "reasoning_effort": "max",
         "display_name": "Fable 5 with max reasoning",
         "recommendation_version": 4,
@@ -99,7 +99,7 @@ def looks_like_claude_model(model: str) -> bool:
     return str(model or "").strip().lower().startswith(_CLAUDE_MODEL_PREFIXES)
 
 
-_CLAUDE_DEFAULT_PREFIXES = ("claude-opus-4-6", "claude-opus-4-7", "claude-opus-4-8")
+_CLAUDE_DEFAULT_PREFIXES = ("claude-opus-4-6", "claude-opus-4-7", "claude-opus-4-8", "claude-fable-5")
 
 
 def heal_runtime_profiles(profiles: dict) -> tuple[dict, list[str]]:

package/src/resonance_tiers.json

@@ -1,19 +1,19 @@
 {
   "tiers": {
     "maximo": {
-      "claude_code": { "model": "claude-fable-5", "effort": "max" },
+      "claude_code": { "model": "claude-opus-4-8", "effort": "max" },
       "codex":       { "model": "gpt-5.5",             "effort": "xhigh" }
     },
     "alto": {
-      "claude_code": { "model": "claude-fable-5", "effort": "xhigh" },
+      "claude_code": { "model": "claude-opus-4-8", "effort": "xhigh" },
       "codex":       { "model": "gpt-5.5",             "effort": "high" }
     },
     "medio": {
-      "claude_code": { "model": "claude-fable-5", "effort": "high" },
+      "claude_code": { "model": "claude-opus-4-8", "effort": "high" },
       "codex":       { "model": "gpt-5.5",             "effort": "medium" }
     },
     "bajo": {
-      "claude_code": { "model": "claude-fable-5", "effort": "medium" },
+      "claude_code": { "model": "claude-opus-4-8", "effort": "medium" },
       "codex":       { "model": "gpt-5.5",             "effort": "low" }
     },
     "muy_bajo": {

package/src/hooks/heartbeat-enforcement.py

@@ -1,103 +0,0 @@
-#!/usr/bin/env python3
-"""Heartbeat enforcement for NEXO sessions.
-
-Tracks user messages vs heartbeat calls. Emits a warning when more than two
-user messages pass without a heartbeat call.
-
-Modes:
-- HEARTBEAT_MODE=user_msg: increment counter on UserPromptSubmit
-- HEARTBEAT_MODE=post_tool: inspect PostToolUse payload, reset on heartbeat,
-  warn when other tools keep running without one
-"""
-
-from __future__ import annotations
-
-import json
-import os
-import sys
-import time
-from pathlib import Path
-
-try:
-    import paths
-except ModuleNotFoundError as exc:
-    if getattr(exc, "name", "") != "paths":
-        raise
-
-    class _PathsFallback:
-        @staticmethod
-        def operations_dir():
-            return Path(os.environ.get("NEXO_HOME", Path.home() / ".nexo")) / "operations"
-
-    paths = _PathsFallback()
-
-STATE_FILE = paths.operations_dir() / ".heartbeat-state.json"
-THRESHOLD = 2
-HEARTBEAT_TOOL = "nexo_heartbeat"
-SKIP_TOOLS = {"nexo_startup", "nexo_stop", "nexo_smart_startup"}
-
-
-def _read_state() -> dict:
-    try:
-        return json.loads(STATE_FILE.read_text())
-    except Exception:
-        return {"user_msgs": 0, "last_heartbeat_ts": 0.0, "last_user_msg_ts": 0.0}
-
-
-def _write_state(state: dict) -> None:
-    try:
-        STATE_FILE.parent.mkdir(parents=True, exist_ok=True)
-        STATE_FILE.write_text(json.dumps(state))
-    except Exception:
-        pass
-
-
-def handle_user_message() -> int:
-    state = _read_state()
-    state["user_msgs"] = state.get("user_msgs", 0) + 1
-    state["last_user_msg_ts"] = time.time()
-    _write_state(state)
-    return 0
-
-
-def handle_post_tool(payload: dict) -> int:
-    tool_name = str(payload.get("tool_name", "")).strip()
-    short_name = tool_name.rsplit("__", 1)[-1] if "__" in tool_name else tool_name
-    state = _read_state()
-
-    if short_name == HEARTBEAT_TOOL:
-        state["user_msgs"] = 0
-        state["last_heartbeat_ts"] = time.time()
-        _write_state(state)
-        return 0
-
-    if short_name in SKIP_TOOLS:
-        return 0
-
-    user_msgs = state.get("user_msgs", 0)
-    if user_msgs > THRESHOLD:
-        print(
-            f"\nWARNING: HEARTBEAT OVERDUE ({user_msgs} user messages without nexo_heartbeat). "
-            "Call nexo_heartbeat(sid=SID, task='...') before continuing."
-        )
-    return 0
-
-
-def main() -> int:
-    mode = os.environ.get("HEARTBEAT_MODE", "").strip()
-    if mode == "user_msg":
-        return handle_user_message()
-    if mode == "post_tool":
-        raw = sys.stdin.read()
-        if not raw.strip():
-            return 0
-        try:
-            payload = json.loads(raw)
-        except Exception:
-            return 0
-        return handle_post_tool(payload)
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())

package/src/hooks/heartbeat-posttool.sh

@@ -1,20 +0,0 @@
-#!/bin/bash
-# NEXO PostToolUse hook — heartbeat enforcement checker
-set -uo pipefail
-
-INPUT=$(cat || true)
-[ -z "$INPUT" ] && exit 0
-
-NEXO_HOME="${NEXO_HOME:-$HOME/.nexo}"
-HELPER=""
-if [ -n "${NEXO_CODE:-}" ] && [ -f "${NEXO_CODE%/}/hooks/heartbeat-enforcement.py" ]; then
-    HELPER="${NEXO_CODE%/}/hooks/heartbeat-enforcement.py"
-elif [ -f "$NEXO_HOME/core/hooks/heartbeat-enforcement.py" ]; then
-    HELPER="$NEXO_HOME/core/hooks/heartbeat-enforcement.py"
-elif [ -f "$NEXO_HOME/hooks/heartbeat-enforcement.py" ]; then
-    HELPER="$NEXO_HOME/hooks/heartbeat-enforcement.py"
-fi
-
-[ -z "$HELPER" ] && exit 0
-HEARTBEAT_MODE=post_tool python3 "$HELPER" <<< "$INPUT" 2>/dev/null || true
-exit 0

package/src/hooks/heartbeat-user-msg.sh

@@ -1,17 +0,0 @@
-#!/bin/bash
-# NEXO UserPromptSubmit hook — track user messages for heartbeat enforcement
-set -uo pipefail
-
-NEXO_HOME="${NEXO_HOME:-$HOME/.nexo}"
-HELPER=""
-if [ -n "${NEXO_CODE:-}" ] && [ -f "${NEXO_CODE%/}/hooks/heartbeat-enforcement.py" ]; then
-    HELPER="${NEXO_CODE%/}/hooks/heartbeat-enforcement.py"
-elif [ -f "$NEXO_HOME/core/hooks/heartbeat-enforcement.py" ]; then
-    HELPER="$NEXO_HOME/core/hooks/heartbeat-enforcement.py"
-elif [ -f "$NEXO_HOME/hooks/heartbeat-enforcement.py" ]; then
-    HELPER="$NEXO_HOME/hooks/heartbeat-enforcement.py"
-fi
-
-[ -z "$HELPER" ] && exit 0
-HEARTBEAT_MODE=user_msg python3 "$HELPER" 2>/dev/null || true
-exit 0