nexo-brain 7.30.33 → 7.31.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "7.30.33",
+  "version": "7.31.0",
   "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,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.30.33` is the current packaged-runtime line. 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.
+Version `7.31.0` is the current packaged-runtime line. Minor release over v7.30.33 - the recommended Claude Code model moves from Opus 4.8 to Fable 5 with max reasoning (`claude-fable-5`) across all four main resonance tiers (the `muy_bajo` tier keeps Haiku for cheap internal classifiers and Codex stays on GPT-5.5), existing installs riding NEXO defaults auto-migrate on update while customized models are respected, and learning housekeeping no longer aborts when the embedding backend is missing.
+
+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.
 
 Previously in `7.30.32`: patch release over v7.30.31 - packaged update/doctor now repair npm/npx wrapper drift, archive stale personal script backups, validate observable automation health contracts, and block legacy Claude/Codex project memory writes.
 

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-opus-4-7[1m]", reasoning_effort: "max", display_name: "Opus 4.7 with 1M context" },
+    claude_code: { model: "claude-fable-5", reasoning_effort: "max", display_name: "Fable 5 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.30.33",
+  "version": "7.31.0",
   "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")
+    old_prefixes = ("claude-opus-4-6", "claude-opus-4-7", "claude-opus-4-8")
 
     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-opus-4-8")
+                claude["model"] = str(source_claude.get("model") or "claude-fable-5")
                 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-opus-4-7[1m]", "reasoning_effort": "max"},
+            "claude_code": {"model": "claude-fable-5", "reasoning_effort": "max"},
             "codex": {"model": "gpt-5.5", "reasoning_effort": "xhigh"},
         }
         return dict(defaults.get(client, {}))

package/src/model_defaults.json

@@ -1,11 +1,11 @@
 {
   "schema_version": 1,
   "claude_code": {
-    "model": "claude-opus-4-8",
+    "model": "claude-fable-5",
     "reasoning_effort": "max",
-    "display_name": "Opus 4.8 with max reasoning",
-    "recommendation_version": 3,
-    "previous_defaults": ["claude-opus-4-7[1m]", "claude-opus-4-7", "claude-opus-4-6[1m]"]
+    "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]"]
   },
   "codex": {
     "model": "gpt-5.5",

package/src/model_defaults.py

@@ -20,11 +20,11 @@ from typing import Any
 _FALLBACK: dict[str, Any] = {
     "schema_version": 1,
     "claude_code": {
-        "model": "claude-opus-4-8",
+        "model": "claude-fable-5",
         "reasoning_effort": "max",
-        "display_name": "Opus 4.8 with max reasoning",
-        "recommendation_version": 3,
-        "previous_defaults": ["claude-opus-4-7[1m]", "claude-opus-4-7", "claude-opus-4-6[1m]"],
+        "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]"],
     },
     "codex": {
         "model": "gpt-5.5",
@@ -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_DEFAULT_PREFIXES = ("claude-opus-4-6", "claude-opus-4-7", "claude-opus-4-8")
 
 
 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-opus-4-8", "effort": "max" },
+      "claude_code": { "model": "claude-fable-5", "effort": "max" },
       "codex":       { "model": "gpt-5.5",             "effort": "xhigh" }
     },
     "alto": {
-      "claude_code": { "model": "claude-opus-4-8", "effort": "xhigh" },
+      "claude_code": { "model": "claude-fable-5", "effort": "xhigh" },
       "codex":       { "model": "gpt-5.5",             "effort": "high" }
     },
     "medio": {
-      "claude_code": { "model": "claude-opus-4-8", "effort": "high" },
+      "claude_code": { "model": "claude-fable-5", "effort": "high" },
       "codex":       { "model": "gpt-5.5",             "effort": "medium" }
     },
     "bajo": {
-      "claude_code": { "model": "claude-opus-4-8", "effort": "medium" },
+      "claude_code": { "model": "claude-fable-5", "effort": "medium" },
       "codex":       { "model": "gpt-5.5",             "effort": "low" }
     },
     "muy_bajo": {

package/src/scripts/nexo-learning-housekeep.py

@@ -158,10 +158,21 @@ def detect_duplicates(conn):
     if len(learnings) < 2:
         return []
 
-    model = build_fastembed_embedding("bge-base-embeddings")
-    texts = [f"{l['title']}: {l['content'][:300]}" for l in learnings]
-    embeddings = list(model.embed(texts))
-    embeddings = np.array(embeddings)
+    # build_fastembed_embedding() lazily imports fastembed inside its body, so a
+    # missing backend raises ModuleNotFoundError HERE, not at the import guard
+    # above (which only resolves the helper symbol). Without this guard the whole
+    # housekeeping run crashes with exit 1 whenever there are >=2 learnings to
+    # compare and fastembed is absent. Degrade exactly like the "not available"
+    # branch instead of aborting decay/prioritization/archival.
+    try:
+        model = build_fastembed_embedding("bge-base-embeddings")
+        texts = [f"{l['title']}: {l['content'][:300]}" for l in learnings]
+        embeddings = list(model.embed(texts))
+        embeddings = np.array(embeddings)
+    except Exception as exc:
+        print(f"[{ts}] Dedup skipped: embedding backend unavailable "
+              f"({type(exc).__name__}: {exc})")
+        return []
 
     # Normalize
     norms = np.linalg.norm(embeddings, axis=1, keepdims=True)