nexo-brain 3.1.0 → 3.1.2

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "3.1.0",
+  "version": "3.1.2",
   "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/package.json

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

@@ -1198,6 +1198,7 @@ def _backup_runtime_tree(dest: Path = NEXO_HOME) -> str:
         "evolution_cycle.py", "migrate_embeddings.py", "auto_close_sessions.py",
         "client_sync.py",
         "client_preferences.py", "agent_runner.py", "bootstrap_docs.py",
+        "hook_guardrails.py", "protocol_settings.py", "public_evolution_queue.py",
         "auto_update.py", "tools_sessions.py", "tools_coordination.py",
         "tools_reminders.py", "tools_reminders_crud.py", "tools_learnings.py",
         "tools_credentials.py", "tools_task_history.py", "tools_menu.py",
@@ -1248,6 +1249,7 @@ def _copy_runtime_from_source(src_dir: Path, repo_dir: Path, dest: Path = NEXO_H
         "evolution_cycle.py", "migrate_embeddings.py", "auto_close_sessions.py",
         "client_sync.py",
         "client_preferences.py", "agent_runner.py", "bootstrap_docs.py",
+        "hook_guardrails.py", "protocol_settings.py", "public_evolution_queue.py",
         "auto_update.py", "tools_sessions.py", "tools_coordination.py",
         "tools_reminders.py", "tools_reminders_crud.py", "tools_learnings.py",
         "tools_credentials.py", "tools_task_history.py", "tools_menu.py",

package/src/cron_recovery.py

@@ -6,6 +6,8 @@ import os
 import plistlib
 import sqlite3
 import contextlib
+import hashlib
+import socket
 from datetime import datetime, timedelta, timezone
 from pathlib import Path
 
@@ -31,6 +33,55 @@ def _load_json(path: Path, default):
     return default
 
 
+def _schedule_machine_id() -> str:
+    schedule = _load_json(SCHEDULE_FILE, {})
+    if isinstance(schedule, dict):
+        public = schedule.get("public_contribution")
+        if isinstance(public, dict):
+            candidate = str(public.get("machine_id") or "").strip().lower()
+            if candidate:
+                return candidate
+    candidate = socket.gethostname().strip().lower()
+    return candidate or "nexo-machine"
+
+
+def _stable_schedule_bucket(key: str, modulo: int) -> int:
+    if modulo <= 0:
+        return 0
+    digest = hashlib.sha256(f"{_schedule_machine_id()}::{key}".encode("utf-8")).digest()
+    return int.from_bytes(digest[:8], "big") % modulo
+
+
+def resolve_declared_schedule(cron: dict) -> dict:
+    schedule = cron.get("schedule")
+    if not isinstance(schedule, dict):
+        return {}
+
+    resolved = dict(schedule)
+    strategy = str(cron.get("schedule_strategy") or resolved.pop("strategy", "")).strip().lower()
+    if strategy != "machine_weekly_spread":
+        return resolved
+
+    if not {"hour", "minute", "weekday"} <= resolved.keys():
+        return resolved
+
+    total_week_minutes = 7 * 24 * 60
+    base_total = (
+        (int(resolved.get("weekday", 0)) % 7) * 1440
+        + (int(resolved.get("hour", 0)) % 24) * 60
+        + (int(resolved.get("minute", 0)) % 60)
+    )
+    offset = _stable_schedule_bucket(str(cron.get("id") or "cron"), total_week_minutes)
+    slot_total = (base_total + offset) % total_week_minutes
+    weekday, minute_of_day = divmod(slot_total, 1440)
+    hour, minute = divmod(minute_of_day, 60)
+    return {
+        "weekday": weekday,
+        "hour": hour,
+        "minute": minute,
+    }
+
+
 def load_enabled_crons() -> list[dict]:
     manifest_candidates = [
         NEXO_HOME / "crons" / "manifest.json",
@@ -215,7 +266,7 @@ def effective_schedule(cron: dict) -> dict:
         return {
             "source": "manifest",
             "schedule_type": "calendar",
-            "calendar": cron["schedule"],
+            "calendar": resolve_declared_schedule(cron),
             "run_at_load": should_run_at_load(cron),
         }
     return {

package/src/crons/manifest.json

@@ -107,6 +107,7 @@
     {
       "id": "evolution",
       "script": "scripts/nexo-evolution-run.py",
+      "schedule_strategy": "machine_weekly_spread",
       "schedule": {"hour": 5, "minute": 0, "weekday": 0},
       "description": "Weekly self-improvement cycle — propose and evaluate changes",
       "core": true,

package/src/crons/sync.py

@@ -31,7 +31,7 @@ _runtime_root = Path(os.environ.get("NEXO_CODE", str(_DEFAULT_RUNTIME_ROOT)))
 if str(_runtime_root) not in sys.path:
     sys.path.insert(0, str(_runtime_root))
 
-from cron_recovery import should_run_at_load
+from cron_recovery import resolve_declared_schedule, should_run_at_load
 
 NEXO_HOME = Path(os.environ.get("NEXO_HOME", str(Path.home() / ".nexo")))
 SOURCE_ROOT = Path(os.environ.get("NEXO_CODE", str(Path(__file__).resolve().parent.parent)))
@@ -242,7 +242,7 @@ def build_plist(cron: dict) -> dict:
         plist["StartInterval"] = cron["interval_seconds"]
     elif "schedule" in cron and not cron.get("keep_alive"):
         cal = {}
-        s = cron["schedule"]
+        s = resolve_declared_schedule(cron)
         if "hour" in s:
             cal["Hour"] = s["hour"]
         if "minute" in s:
@@ -443,7 +443,7 @@ StandardError=append:{stderr_log}
         elif "interval_seconds" in cron:
             timer_spec = f"OnUnitActiveSec={cron['interval_seconds']}s\nOnBootSec=60s"
         elif "schedule" in cron:
-            s = cron["schedule"]
+            s = resolve_declared_schedule(cron)
             h, m = s.get("hour", 0), s.get("minute", 0)
             if "weekday" in s:
                 # Manifest weekday uses launchd convention: 0=Sunday … 6=Saturday (7=Sunday alias)

package/src/db/_personal_scripts.py

@@ -62,8 +62,8 @@ def _safe_slug(value: str) -> str:
 
 def _ensure_script_id(conn, name: str, path: str) -> str:
     existing = conn.execute(
-        "SELECT id FROM personal_scripts WHERE path = ? OR name = ? ORDER BY path = ? DESC LIMIT 1",
-        (path, name, path),
+        "SELECT id FROM personal_scripts WHERE path = ? LIMIT 1",
+        (path,),
     ).fetchone()
     if existing:
         return existing["id"]

package/src/doctor/providers/runtime.py

@@ -24,7 +24,7 @@ from client_preferences import (
     normalize_client_preferences,
     resolve_client_runtime_profile,
 )
-from cron_recovery import should_run_at_load
+from cron_recovery import resolve_declared_schedule, should_run_at_load
 from doctor.models import DoctorCheck, safe_check
 
 NEXO_HOME = Path(os.environ.get("NEXO_HOME", str(Path.home() / ".nexo")))
@@ -865,7 +865,7 @@ def _launchagent_schedule_expectations() -> dict[str, dict]:
             expected["RunAtLoad"] = True if should_run_at_load(cron) else None
             expected["schedule_configured"] = True
         elif "schedule" in cron:
-            schedule = cron.get("schedule") or {}
+            schedule = resolve_declared_schedule(cron)
             cal = {}
             if "hour" in schedule:
                 cal["Hour"] = schedule["hour"]

package/src/tools_learnings.py

@@ -376,6 +376,18 @@ def handle_learning_add(category: str, title: str, content: str, reasoning: str
         if "error" in superseded:
             return f"ERROR: Learning #{new_id} created but supersede failed: {superseded['error']}"
 
+    # Post-insert verification: confirm the learning actually persisted
+    verify_conn = get_db()
+    verified = verify_conn.execute(
+        "SELECT id, title, category FROM learnings WHERE id = ? AND status = 'active'",
+        (result["id"],)
+    ).fetchone()
+    if not verified:
+        return (
+            f"⚠ PERSISTENCE FAILURE: Learning #{result['id']} was inserted but NOT found on verification read. "
+            f"Retry nexo_learning_add or investigate DB integrity."
+        )
+
     meta = []
     if prevention:
         meta.append("with prevention")
@@ -384,7 +396,7 @@ def handle_learning_add(category: str, title: str, content: str, reasoning: str
     if supersedes_id:
         meta.append(f"supersedes={int(supersedes_id)}")
     meta_str = f" ({', '.join(meta)})" if meta else ""
-    return f"Learning #{result['id']} added in {category}: {title}{meta_str}{repetition_msg}"
+    return f"Learning #{result['id']} added in {category}: {title}{meta_str} ✓verified{repetition_msg}"
 
 
 def handle_learning_search(query: str, category: str = '') -> str:

package/templates/launchagents/README.md

@@ -104,7 +104,7 @@ These agents power NEXO's learning and memory systems. Strongly recommended.
 
 | File | Schedule | What it does |
 |------|----------|-------------|
-| `com.nexo.evolution.plist` | Sundays 05:00 | Reviews the week's patterns and proposes improvements to NEXO's own configuration. Proposals are staged for user approval — nothing is applied autonomously. |
+| `com.nexo.evolution.plist` | Machine-staggered weekly (managed installs) | Reviews the week's patterns and proposes improvements to NEXO's own configuration. Managed installs spread each machine across the week to avoid PR spikes; the static plist template is only a manual fallback. |
 | `com.nexo.followup-hygiene.plist` | Sundays 05:00 | Cleans up stale followups and reminders. Archives long-pending items and deduplicates entries. Keeps the operational database noise-free. |
 
 ### Optional

package/templates/launchagents/com.nexo.evolution.plist

@@ -1,11 +1,10 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- com.nexo.evolution
-     Runs nexo-evolution-run.py every Sunday at 05:00 to perform a weekly
-     evolution cycle. Reviews patterns from the past week, proposes
-     improvements to NEXO's own behavior and configuration, and stages
-     them as pending proposals for the user to approve. This is NEXO's
-     self-improvement mechanism — it cannot apply changes autonomously,
-     only propose them.
+     Static fallback template for the weekly evolution cycle.
+     Managed installs now derive a machine-staggered weekly slot from the
+     cron manifest to avoid bunching public evolution PRs on Sunday.
+     If you install this plist manually, customize Weekday/Hour/Minute
+     yourself instead of assuming the managed stagger applies here.
 -->
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">