nexo-brain 2.3.0 → 2.3.1

package/README.md

@@ -755,7 +755,7 @@ If NEXO Brain is useful to you, consider:
 - **Auto-resolve followups**: Change log entries automatically cross-reference and complete matching open followups.
 - **Free-form learning categories**: No more hardcoded category validation — use any category name.
 - **CLAUDE.md template rewrite**: 494 to 127 lines, compact procedural format with full heartbeat signal reactions.
-- **Complete sanitization**: All hardcoded paths use `NEXO_HOME` env var. Zero personal data in the repo.
+- **Complete sanitization**: All hardcoded paths use `NEXO_HOME` env var. No credentials or personal data in the distributed package. Migration scripts and maintainer tooling use configurable paths.
 
 ### v1.6.0 — Nervous System + Dashboard v2 (2026-03-30)
 - **Nervous System**: 11 autonomous scripts (decay, deep sleep, self-audit, catchup, evolution, followup hygiene, immune, watchdog, github monitor, learning validator)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "mcpName": "io.github.wazionapps/nexo",
   "description": "NEXO — Cognitive co-operator for Claude Code. Memory, emotional intelligence, overnight learning (Deep Sleep), cron management, trust scoring, and adaptive calibration.",
   "bin": {
@@ -56,8 +56,11 @@
     "bin/nexo-brain.js",
     "bin/postinstall.js",
     "src/",
+    "!src/**/__pycache__",
+    "!src/**/*.pyc",
+    "!src/**/*.pyo",
     "templates/",
-    "scripts/",
-    "tests/"
+    "README.md",
+    "LICENSE"
   ]
 }

package/src/auto_update.py

@@ -1,3 +1,4 @@
+from __future__ import annotations
 """NEXO Auto-Update — lightweight startup check for git updates and file-based migrations.
 
 Called once per server startup. Respects a 1-hour cooldown to avoid redundant checks.

package/src/crons/sync.py

@@ -46,8 +46,7 @@ def _copy_script_to_nexo_home(src: Path) -> Path:
     """Copy a script from NEXO_CODE to NEXO_HOME/scripts/ for Sandbox compatibility.
 
     macOS Sandbox blocks LaunchAgents from executing scripts in ~/Documents/.
-    We copy scripts to NEXO_HOME/scripts/ which is typically ~/claude/scripts/
-    or ~/.nexo/scripts/ — both outside the Sandbox restricted paths.
+    We copy scripts to NEXO_HOME/scripts/ which is outside the Sandbox restricted paths.
     """
     dest_dir = NEXO_HOME / "scripts"
     dest_dir.mkdir(parents=True, exist_ok=True)

package/src/db/_core.py

@@ -1,3 +1,4 @@
+from __future__ import annotations
 """SQLite database for NEXO session coordination."""
 
 import sqlite3

package/src/db/_entities.py

@@ -1,3 +1,4 @@
+from __future__ import annotations
 """NEXO DB — Entities module."""
 import time
 from db._core import get_db, _multi_word_like

package/src/db/_episodic.py

@@ -1,3 +1,4 @@
+from __future__ import annotations
 """NEXO DB — Episodic module."""
 import datetime, time, json
 from db._core import get_db, now_epoch, _multi_word_like

package/src/db/_learnings.py

@@ -1,3 +1,4 @@
+from __future__ import annotations
 """NEXO DB — Learnings module."""
 import re, time
 from db._core import get_db, now_epoch

package/src/db/_reminders.py

@@ -1,3 +1,4 @@
+from __future__ import annotations
 """NEXO DB — Reminders module."""
 import sqlite3, time, datetime
 from datetime import timedelta

package/src/db/_sessions.py

@@ -1,3 +1,4 @@
+from __future__ import annotations
 """NEXO DB — Sessions module."""
 import time, secrets, string, sqlite3
 from datetime import datetime

package/src/db/_skills.py

@@ -1,3 +1,4 @@
+from __future__ import annotations
 """NEXO DB — Skills module.
 
 Skill Auto-Creation system: reusable procedures extracted from complex tasks.

package/src/plugin_loader.py

@@ -1,3 +1,4 @@
+from __future__ import annotations
 """Dynamic plugin loader for NEXO MCP server."""
 
 import importlib

package/src/plugins/update.py

@@ -1,3 +1,4 @@
+from __future__ import annotations
 """Update plugin — pull latest code, backup DBs, run migrations, verify."""
 import json
 import os

package/src/scripts/deep-sleep/apply_findings.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+from __future__ import annotations
 """
 Deep Sleep v2 -- Phase 4: Apply synthesized findings.
 

package/src/scripts/deep-sleep/collect.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+from __future__ import annotations
 """
 Deep Sleep v2 -- Phase 1: Collect all context for overnight analysis.
 

package/src/scripts/deep-sleep/extract.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+from __future__ import annotations
 """
 Deep Sleep v2 -- Phase 2: Extract findings from each session using Claude CLI.
 

package/src/scripts/deep-sleep/synthesize.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+from __future__ import annotations
 """
 Deep Sleep v2 -- Phase 3: Synthesize extractions into actionable findings.
 

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

@@ -1,4 +1,5 @@
 #!/usr/bin/env python3
+from __future__ import annotations
 """NEXO Learning Housekeeping — Nightly dedup, weight adjustment, and review.
 
 Runs daily. Adjusts learning weights based on usage (guard_hits),

package/src/scripts/nexo-watchdog.sh

@@ -115,9 +115,14 @@ PERSONAL_MONITORS=(
 MONITORS+=("${PERSONAL_MONITORS[@]+"${PERSONAL_MONITORS[@]}"}")
 
 # Cron jobs to check (NAME|SCRIPT|CHECK_PATH|MAX_STALE_SECS|SCHEDULE)
-CRON_MONITORS=(
-  "Backup Cron|$NEXO_DIR/backup_cron.sh|$NEXO_DIR/backups/|7200|Hourly"
-)
+# Core cron monitors are loaded from manifest above.
+# Maintainer-only monitors go here (guarded by NEXO_MAINTAINER env var).
+CRON_MONITORS=()
+if [ "${NEXO_MAINTAINER:-}" = "1" ]; then
+  CRON_MONITORS+=(
+    "Backup|$NEXO_DIR/scripts/nexo-backup.sh|$NEXO_DIR/backups/|7200|Hourly"
+  )
+fi
 
 # Error patterns to search in stderr logs (last 50 lines)
 ERROR_PATTERNS="Traceback|Error:|CRITICAL|FATAL|ModuleNotFoundError|PermissionError|FileNotFoundError|ConnectionRefused|Errno"
@@ -287,16 +292,18 @@ try_verify_repair() {
 }
 
 try_repair_backup() {
-  local backup_script="$NEXO_DIR/backup_cron.sh"
+  # Use the core backup script (nexo-backup.sh)
+  local backup_script="$NEXO_DIR/scripts/nexo-backup.sh"
+  [ ! -x "$backup_script" ] && backup_script="$SCRIPT_DIR/nexo-backup.sh"
   if [ -x "$backup_script" ]; then
-    "$backup_script" 2>/dev/null
+    bash "$backup_script" 2>/dev/null
     sleep 1
     local newest
     newest=$(ls -t "$NEXO_DIR/backups/nexo-"*.db 2>/dev/null | head -1)
     if [ -n "$newest" ]; then
       if $IS_MACOS; then local age=$(( TS_EPOCH - $(stat -f %m "$newest") )); else local age=$(( TS_EPOCH - $(stat -c %Y "$newest") )); fi
       if [ "$age" -lt 60 ]; then
-        log_repair "backup_cron.sh: ran successfully, fresh backup created"
+        log_repair "nexo-backup.sh: ran successfully, fresh backup created"
         return 0
       fi
     fi
@@ -828,12 +835,12 @@ ${STDOUT_TAIL}
       log "Launching NEXO Level 2 repair..."
 
       # Build propagation instructions if core services failed
-      # Only the origin maintainer (user) propagates fixes to the public repo
+      # Only runs when NEXO_MAINTAINER=1 and NEXO_PUBLIC_REPO is configured
       PROPAGATE_BLOCK=""
-      # If you maintain a public NEXO repo, configure propagation here
-      NEXO_PUBLIC_REPO="${NEXO_PUBLIC_REPO:-}"
-      if $HAS_CORE_FAILS && [ -n "$NEXO_PUBLIC_REPO" ] && [ -d "$NEXO_PUBLIC_REPO/.git" ]; then
-        PROPAGATE_BLOCK="
+      if [ "${NEXO_MAINTAINER:-}" = "1" ]; then
+        NEXO_PUBLIC_REPO="${NEXO_PUBLIC_REPO:-}"
+        if $HAS_CORE_FAILS && [ -n "$NEXO_PUBLIC_REPO" ] && [ -d "$NEXO_PUBLIC_REPO/.git" ]; then
+          PROPAGATE_BLOCK="
 PROPAGATION (for [core] fixes ONLY):
 If your fix modifies a file under $NEXO_HOME/ (server.py, db/, plugins/, scripts/):
 1. Commit the fix locally with a descriptive message
@@ -842,6 +849,7 @@ If your fix modifies a file under $NEXO_HOME/ (server.py, db/, plugins/, scripts
 4. Commit + push
 5. Create a GitHub release with gh release create
 Do NOT propagate fixes for [personal] services — those stay local only."
+        fi
       fi
 
       # Write prompt to temp file (avoids heredoc quoting issues in subshell)

package/src/server.py

@@ -1,3 +1,4 @@
+from __future__ import annotations
 """NEXO MCP Server — Phase 4: Hot-Reload Plugin System."""
 
 import os

package/src/tools_coordination.py

@@ -1,3 +1,4 @@
+from __future__ import annotations
 """Coordination tools: file tracking, messaging, Q&A."""
 
 from db import (

package/src/tools_sessions.py

@@ -1,3 +1,4 @@
+from __future__ import annotations
 """Session management tools: startup, heartbeat, status."""
 
 import time