nexo-brain 4.0.0 → 4.0.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "4.0.0",
+  "version": "4.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,7 +87,7 @@ 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 `4.0.0` closes the next memory-surface gap:
+Version `4.0.1` keeps the 4.0 release aligned across channels while preserving the next memory-surface gap closure:
 
 - non-text artifacts now have a first-class multimodal reference layer instead of living outside the memory model
 - pre-compaction auto-flush now persists actionable session state before context compression can erase it

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "4.0.0",
+  "version": "4.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/cognitive/_trust.py

@@ -1,7 +1,7 @@
 """NEXO Cognitive — Trust scoring, sentiment, dissonance."""
 import re
 import numpy as np
-from datetime import UTC, datetime, timedelta
+from datetime import datetime, timedelta, timezone
 from cognitive._core import _get_db, embed, cosine_similarity, _blob_to_array
 from cognitive._core import POSITIVE_SIGNALS, NEGATIVE_SIGNALS, URGENCY_SIGNALS
 
@@ -412,7 +412,7 @@ def adjust_trust(event: str, context: str = "", custom_delta: float = None) -> d
 def get_trust_history(days: int = 7) -> dict:
     """Get trust score history and sentiment summary."""
     db = _get_db()
-    cutoff = (datetime.now(UTC) - timedelta(days=days)).isoformat()
+    cutoff = (datetime.now(timezone.utc) - timedelta(days=days)).isoformat()
 
     # Trust events
     events = db.execute(

package/src/hook_guardrails.py

@@ -16,6 +16,28 @@ WRITE_LIKE_TOOLS = {"Edit", "MultiEdit", "Write"}
 DELETE_LIKE_TOOLS = {"Delete"}
 NEXO_CODE_ROOT = Path(os.environ.get("NEXO_CODE", str(Path(__file__).resolve().parent))).expanduser().resolve()
 LIVE_REPO_ROOT = NEXO_CODE_ROOT.parent if NEXO_CODE_ROOT.name == "src" else NEXO_CODE_ROOT
+PUBLIC_REPO_DIRS = {
+    ".claude-plugin",
+    ".github",
+    "bin",
+    "clawhub-skill",
+    "community",
+    "docs",
+    "hooks",
+    "openclaw-plugin",
+    "src",
+    "templates",
+    "tests",
+}
+PUBLIC_REPO_FILES = {
+    ".mcp.json",
+    "CHANGELOG.md",
+    "LICENSE",
+    "README.md",
+    "docker-compose.yml",
+    "package-lock.json",
+    "package.json",
+}
 
 
 def _operation_kind(tool_name: str) -> str:
@@ -54,11 +76,31 @@ def _automation_live_repo_guard_enabled() -> bool:
     )
 
 
+def _has_git_marker(root: Path) -> bool:
+    return (root / ".git").exists()
+
+
+def _is_public_repo_surface(candidate: Path) -> bool:
+    try:
+        relative = candidate.relative_to(LIVE_REPO_ROOT)
+    except ValueError:
+        return False
+
+    parts = relative.parts
+    if not parts:
+        return False
+    if parts[0] in PUBLIC_REPO_DIRS:
+        return True
+    return len(parts) == 1 and parts[0] in PUBLIC_REPO_FILES
+
+
 def _is_live_repo_path(path: str) -> bool:
     if not str(path or "").strip():
         return False
     try:
-        return _is_relative_to(_resolve_runtime_path(path), LIVE_REPO_ROOT)
+        if not _has_git_marker(LIVE_REPO_ROOT):
+            return False
+        return _is_public_repo_surface(_resolve_runtime_path(path))
     except Exception:
         return False
 

package/src/tools_sessions.py

@@ -542,6 +542,17 @@ def handle_heartbeat(sid: str, task: str, context_hint: str = '') -> str:
         except Exception:
             pass  # guard_log table may not exist in older installs
 
+    if context_hint and _hint_suggests_correction(context_hint):
+        try:
+            if not _recent_learning_capture_exists(conn, sid, window_seconds=300):
+                parts.append("")
+                parts.append(
+                    "⚠ LEARNING REMINDER: This looks like a user correction and no recent learning was captured. "
+                    "If it revealed a reusable pattern, write `nexo_learning_add` NOW."
+                )
+        except Exception:
+            pass  # Best-effort reminder only
+
     return "\n".join(parts)
 
 
@@ -816,6 +827,64 @@ def _hint_suggests_code_edit(hint: str) -> bool:
     return any(signal in hint_lower for signal in edit_signals)
 
 
+def _hint_suggests_correction(hint: str) -> bool:
+    """Detect explicit user correction signals in a heartbeat context hint."""
+    hint_lower = hint.lower()
+    correction_signals = [
+        "that's wrong",
+        "that is wrong",
+        "wrong approach",
+        "not like that",
+        "fix this",
+        "fix it",
+        "está mal",
+        "esta mal",
+        "mal hecho",
+        "incorrecto",
+        "te equivocas",
+        "te has equivocado",
+        "lo hiciste mal",
+        "no era eso",
+        "corrige esto",
+        "corrígelo",
+        "corrigelo",
+        "ya te dije",
+        "otra vez el mismo",
+        "de nuevo el mismo",
+        "no deberías",
+        "no deberias",
+        "shouldn't have",
+        "should not have",
+    ]
+    return any(signal in hint_lower for signal in correction_signals)
+
+
+def _recent_learning_capture_exists(conn, sid: str, window_seconds: int = 300) -> bool:
+    """Check whether a recent learning was captured manually or via protocol task close."""
+    cutoff_epoch = time.time() - window_seconds
+
+    row = conn.execute(
+        "SELECT 1 FROM learnings WHERE created_at >= ? LIMIT 1",
+        (cutoff_epoch,),
+    ).fetchone()
+    if row:
+        return True
+
+    row = conn.execute(
+        """
+        SELECT 1
+        FROM protocol_tasks
+        WHERE session_id = ?
+          AND learning_id IS NOT NULL
+          AND closed_at IS NOT NULL
+          AND CAST(strftime('%s', closed_at) AS INTEGER) >= ?
+        LIMIT 1
+        """,
+        (sid, int(cutoff_epoch)),
+    ).fetchone()
+    return bool(row)
+
+
 def _toolbox_summary(conn) -> str:
     """Quick count of available skills and behavioral learnings for startup reminder."""
     try:

package/src/user_state_model.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 """Inspectable user-state model built from multiple NEXO signals."""
 
 import json
-from datetime import UTC, datetime, timedelta
+from datetime import datetime, timedelta, timezone
 
 import cognitive
 from db import get_db
@@ -32,7 +32,7 @@ def init_tables() -> None:
 
 
 def _recent_correction_count(days: int) -> int:
-    cutoff = (datetime.now(UTC) - timedelta(days=days)).isoformat()
+    cutoff = (datetime.now(timezone.utc) - timedelta(days=days)).isoformat()
     row = cognitive._get_db().execute(
         "SELECT COUNT(*) FROM memory_corrections WHERE created_at >= ?",
         (cutoff,),
@@ -41,7 +41,7 @@ def _recent_correction_count(days: int) -> int:
 
 
 def _recent_trust_event_count(days: int, event_name: str) -> int:
-    cutoff = (datetime.now(UTC) - timedelta(days=days)).isoformat()
+    cutoff = (datetime.now(timezone.utc) - timedelta(days=days)).isoformat()
     row = cognitive._get_db().execute(
         "SELECT COUNT(*) FROM trust_score WHERE created_at >= ? AND event = ?",
         (cutoff, event_name),
@@ -50,7 +50,7 @@ def _recent_trust_event_count(days: int, event_name: str) -> int:
 
 
 def _recent_diary_signal_count(days: int) -> int:
-    cutoff = (datetime.now(UTC) - timedelta(days=days)).isoformat(timespec="seconds")
+    cutoff = (datetime.now(timezone.utc) - timedelta(days=days)).isoformat(timespec="seconds")
     row = get_db().execute(
         "SELECT COUNT(*) FROM session_diary WHERE created_at >= ? AND user_signals != ''",
         (cutoff,),
@@ -157,7 +157,7 @@ def list_user_state_snapshots(limit: int = 20) -> list[dict]:
 
 def user_state_stats(days: int = 30) -> dict:
     init_tables()
-    cutoff = (datetime.now(UTC) - timedelta(days=days)).isoformat(timespec="seconds")
+    cutoff = (datetime.now(timezone.utc) - timedelta(days=days)).isoformat(timespec="seconds")
     rows = get_db().execute(
         "SELECT state_label, COUNT(*) AS cnt FROM user_state_snapshots WHERE created_at >= ? GROUP BY state_label",
         (cutoff,),