nexo-brain 5.10.2 → 6.0.0

package/hooks/hooks.json

@@ -10,18 +10,8 @@
           },
           {
             "type": "command",
-            "command": "mkdir -p \"${CLAUDE_PLUGIN_DATA}/operations\" && date +%s > \"${CLAUDE_PLUGIN_DATA}/operations/.session-start-ts\"",
-            "timeout": 2
-          },
-          {
-            "type": "command",
-            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" bash \"${CLAUDE_PLUGIN_ROOT}/src/hooks/daily-briefing-check.sh\"",
-            "timeout": 5
-          },
-          {
-            "type": "command",
-            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" bash \"${CLAUDE_PLUGIN_ROOT}/src/hooks/session-start.sh\"",
-            "timeout": 35
+            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" python3 \"${CLAUDE_PLUGIN_ROOT}/src/hooks/session_start.py\"",
+            "timeout": 40
           }
         ]
       }
@@ -32,87 +22,67 @@
         "hooks": [
           {
             "type": "command",
-            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" bash \"${CLAUDE_PLUGIN_ROOT}/src/hooks/session-stop.sh\"",
-            "timeout": 10
+            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" python3 \"${CLAUDE_PLUGIN_ROOT}/src/hooks/stop.py\"",
+            "timeout": 15
           }
         ]
       }
     ],
-    "PreToolUse": [
+    "UserPromptSubmit": [
       {
-        "matcher": "Edit|MultiEdit|Write|Delete",
+        "matcher": "*",
         "hooks": [
           {
             "type": "command",
-            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" bash \"${CLAUDE_PLUGIN_ROOT}/src/hooks/protocol-pretool-guardrail.sh\"",
+            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" python3 \"${CLAUDE_PLUGIN_ROOT}/src/hooks/auto_capture.py\"",
             "timeout": 5
           }
         ]
       }
     ],
-    "UserPromptSubmit": [
+    "PostToolUse": [
       {
         "matcher": "*",
         "hooks": [
           {
             "type": "command",
-            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" bash \"${CLAUDE_PLUGIN_ROOT}/src/hooks/heartbeat-user-msg.sh\"",
-            "timeout": 3
+            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" python3 \"${CLAUDE_PLUGIN_ROOT}/src/hooks/post_tool_use.py\"",
+            "timeout": 20
           }
         ]
       }
     ],
-    "PostToolUse": [
+    "PreCompact": [
       {
         "matcher": "*",
         "hooks": [
           {
             "type": "command",
-            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" bash \"${CLAUDE_PLUGIN_ROOT}/src/hooks/capture-tool-logs.sh\"",
-            "timeout": 5
-          },
-          {
-            "type": "command",
-            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" bash \"${CLAUDE_PLUGIN_ROOT}/src/hooks/capture-session.sh\"",
-            "timeout": 3
-          },
-          {
-            "type": "command",
-            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" bash \"${CLAUDE_PLUGIN_ROOT}/src/hooks/inbox-hook.sh\"",
-            "timeout": 5
-          },
-          {
-            "type": "command",
-            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" bash \"${CLAUDE_PLUGIN_ROOT}/src/hooks/protocol-guardrail.sh\"",
-            "timeout": 5
-          },
-          {
-            "type": "command",
-            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" bash \"${CLAUDE_PLUGIN_ROOT}/src/hooks/heartbeat-posttool.sh\"",
-            "timeout": 3
+            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" python3 \"${CLAUDE_PLUGIN_ROOT}/src/hooks/pre_compact.py\"",
+            "timeout": 15
           }
         ]
       }
     ],
-    "PreCompact": [
+    "Notification": [
       {
         "matcher": "*",
         "hooks": [
           {
             "type": "command",
-            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" bash \"${CLAUDE_PLUGIN_ROOT}/src/hooks/pre-compact.sh\"",
-            "timeout": 10
+            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" python3 \"${CLAUDE_PLUGIN_ROOT}/src/hooks/notification.py\"",
+            "timeout": 3
           }
         ]
       }
     ],
-    "PostCompact": [
+    "SubagentStop": [
       {
         "matcher": "*",
         "hooks": [
           {
             "type": "command",
-            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" bash \"${CLAUDE_PLUGIN_ROOT}/src/hooks/post-compact.sh\"",
+            "command": "NEXO_HOME=\"${CLAUDE_PLUGIN_DATA}\" NEXO_CODE=\"${CLAUDE_PLUGIN_ROOT}/src\" python3 \"${CLAUDE_PLUGIN_ROOT}/src/hooks/subagent_stop.py\"",
             "timeout": 10
           }
         ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "5.10.2",
+  "version": "6.0.0",
   "mcpName": "io.github.wazionapps/nexo",
   "description": "NEXO Brain \u2014 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",
@@ -76,6 +76,8 @@
     "bin/postinstall.js",
     "scripts/sync_release_artifacts.py",
     "src/",
+    "src/resonance_tiers.json",
+    "src/hooks/manifest.json",
     "community/",
     "!src/**/__pycache__",
     "!src/**/*.pyc",

package/src/auto_update.py

@@ -2894,6 +2894,26 @@ def _run_runtime_post_sync(dest: Path = NEXO_HOME, progress_fn=None) -> tuple[bo
     except Exception as exc:
         actions.append(f"profile-bootstrap-warning:{exc.__class__.__name__}")
 
+    # v6.0.0 purge — drop legacy fields that moved elsewhere in v6.
+    # client_runtime_profiles.*.{model,reasoning_effort} → resonance_tiers.json.
+    # preferences.protocol_strictness → TTY/no-TTY detection.
+    # preferences.show_pending_at_start → NEXO Desktop electron-store.
+    # Never re-raises: the update must finish even if purge fails.
+    try:
+        _emit_progress(progress_fn, "Applying v6.0.0 calibration purge...")
+        from calibration_migration import apply_v6_purge
+        v6_result = apply_v6_purge(nexo_home=dest)
+        if v6_result.get("calibration_changed"):
+            actions.append("v6-purge:calibration")
+        if v6_result.get("schedule_changed"):
+            actions.append("v6-purge:schedule")
+        if v6_result.get("seeded_default_resonance"):
+            actions.append("v6-purge:seeded-default-resonance-alto")
+        if v6_result.get("status") == "noop":
+            actions.append("v6-purge:noop")
+    except Exception as exc:
+        actions.append(f"v6-purge-warning:{exc.__class__.__name__}")
+
     _emit_progress(progress_fn, "Verifying runtime imports...")
     verify = subprocess.run(
         [sys.executable, "-c", "import server"],

package/src/calibration_migration.py

@@ -240,3 +240,137 @@ def revert(
     except Exception as exc:
         return {"status": "error", "reason": f"copy failed: {exc}", "path": str(target)}
     return {"status": "reverted", "from": str(backup), "path": str(target)}
+
+
+# ---------------------------------------------------------------------------
+# v6.0.0 purge
+# ---------------------------------------------------------------------------
+# v6.0.0 removed three user-facing knobs whose state now lives elsewhere:
+#   - ``client_runtime_profiles.{claude_code,codex}.{model,reasoning_effort}``
+#     in schedule.json → replaced by resonance_tiers.json (tier is the only
+#     input, model+effort are resolved from the JSON).
+#   - ``preferences.protocol_strictness`` in calibration.json → replaced by
+#     the TTY/no-TTY detection in protocol_settings.py.
+#   - ``preferences.show_pending_at_start`` in calibration.json → moved to
+#     NEXO Desktop's electron-store; Brain no longer reads or writes it.
+#
+# The update path calls ``apply_v6_purge(nexo_home)`` exactly once per
+# upgrade. It never maps legacy values to new ones (that would re-create
+# learning #398, the reasoning_effort=max → maximo footgun) — legacy
+# fields are dropped silently and callers fall back to the canonical
+# defaults (strict or lenient via TTY, tier=alto).
+
+_V6_LEGACY_RUNTIME_KEYS = ("model", "reasoning_effort")
+_V6_LEGACY_PREFS_KEYS = ("protocol_strictness", "show_pending_at_start")
+_V6_DEFAULT_TIER = "alto"
+
+
+def _prune_client_runtime_profiles(schedule: dict) -> bool:
+    """Remove model/reasoning_effort from every client_runtime_profile.
+
+    Leaves the enclosing dict shape intact so downstream schedule.json
+    readers that still iterate ``client_runtime_profiles`` do not need a
+    guard — they just see an empty-ish profile for each client.
+    """
+    changed = False
+    profiles = schedule.get("client_runtime_profiles")
+    if not isinstance(profiles, dict):
+        return False
+    for client, profile in list(profiles.items()):
+        if not isinstance(profile, dict):
+            continue
+        for key in _V6_LEGACY_RUNTIME_KEYS:
+            if key in profile:
+                profile.pop(key, None)
+                changed = True
+    return changed
+
+
+def _prune_calibration_preferences(cal: dict) -> bool:
+    """Drop protocol_strictness and show_pending_at_start from calibration."""
+    changed = False
+    # Pref dict may be absent or non-dict on pathological payloads.
+    prefs = cal.get("preferences")
+    if isinstance(prefs, dict):
+        for key in _V6_LEGACY_PREFS_KEYS:
+            if key in prefs:
+                prefs.pop(key, None)
+                changed = True
+    # Some early v5.x installs wrote protocol_strictness at the top level.
+    for key in _V6_LEGACY_PREFS_KEYS:
+        if key in cal:
+            cal.pop(key, None)
+            changed = True
+    return changed
+
+
+def _ensure_default_resonance(cal: dict) -> bool:
+    """Seed preferences.default_resonance='alto' when the user has none.
+
+    Never overwrites an existing value — respecting a non-default choice
+    is the whole point of making this idempotent.
+    """
+    prefs = cal.setdefault("preferences", {})
+    if not isinstance(prefs, dict):
+        # Reset to a sane shape without losing the rest of the payload.
+        cal["preferences"] = prefs = {}
+    current = str(prefs.get("default_resonance") or "").strip().lower()
+    if current:
+        return False
+    prefs["default_resonance"] = _V6_DEFAULT_TIER
+    return True
+
+
+def apply_v6_purge(
+    nexo_home: Path | None = None,
+    *,
+    dry_run: bool = False,
+) -> dict:
+    """Perform the v6.0.0 migration against an on-disk NEXO_HOME.
+
+    Returns a dict describing what changed. Never raises — the update
+    flow appends the result to the actions trail and keeps going.
+    """
+    home = Path(nexo_home) if nexo_home else Path(
+        __import__("os").environ.get("NEXO_HOME", str(Path.home() / ".nexo"))
+    )
+    result: dict[str, Any] = {
+        "status": "noop",
+        "home": str(home),
+        "calibration_changed": False,
+        "schedule_changed": False,
+        "seeded_default_resonance": False,
+    }
+
+    cal_path = home / "brain" / "calibration.json"
+    sched_path = home / "config" / "schedule.json"
+
+    # --- calibration.json ---
+    if cal_path.is_file():
+        try:
+            cal = json.loads(cal_path.read_text())
+        except Exception:
+            cal = None
+        if isinstance(cal, dict):
+            pruned = _prune_calibration_preferences(cal)
+            seeded = _ensure_default_resonance(cal)
+            if (pruned or seeded) and not dry_run:
+                cal_path.write_text(json.dumps(cal, ensure_ascii=False, indent=2))
+            result["calibration_changed"] = bool(pruned or seeded)
+            result["seeded_default_resonance"] = bool(seeded)
+
+    # --- schedule.json ---
+    if sched_path.is_file():
+        try:
+            sched = json.loads(sched_path.read_text())
+        except Exception:
+            sched = None
+        if isinstance(sched, dict):
+            pruned = _prune_client_runtime_profiles(sched)
+            if pruned and not dry_run:
+                sched_path.write_text(json.dumps(sched, ensure_ascii=False, indent=2))
+            result["schedule_changed"] = bool(pruned)
+
+    if any([result["calibration_changed"], result["schedule_changed"]]):
+        result["status"] = "migrated"
+    return result

package/src/hook_observability.py

@@ -123,6 +123,30 @@ def record_hook_run(
         return 0
 
 
+def record_activity(
+    *,
+    session_id: str = "",
+    activity_type: str = "notification",
+    metadata: dict | None = None,
+) -> int:
+    """Record a lightweight "session is alive" signal.
+
+    Consumed by the Notification hook (added in v6.0.0) and by any other
+    entry point that wants to tell auto_close_sessions "this session is
+    actively doing something, don't prune it". Internally it stores a row
+    in hook_runs with hook_name=f'activity:{activity_type}' so the same
+    observability surface that renders hook health also shows activity
+    pings without needing a second table.
+    """
+    hook_tag = f"activity:{(activity_type or 'generic').strip().lower()}"[:120]
+    return record_hook_run(
+        hook_tag,
+        session_id=session_id,
+        summary=f"{activity_type or 'generic'} activity",
+        metadata=metadata or {"type": activity_type or "generic"},
+    )
+
+
 def list_recent_hook_runs(
     *,
     hours: int = 24,