nexo-brain 3.0.0 → 3.0.1

package/.claude-plugin/plugin.json

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

@@ -50,7 +50,7 @@ That means NEXO now manages not only the shared runtime and MCP wiring, but also
 
 Versions `2.6.14` through `2.7.0` established the practical shared-brain baseline: managed Claude/Codex bootstrap, Codex config sync, transcript-aware Deep Sleep, 60-day long-horizon analysis, weekly/monthly summary artifacts, retrieval auto-mode, and the first measured engineering loop.
 
-Version `3.0.0` closes the next execution gap:
+Versions `3.0.0` and `3.0.1` close the next execution gap:
 
 - protocol discipline is now a runtime contract, not just instructions:
   - `nexo_task_open`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "3.0.0",
+  "version": "3.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/agent_runner.py

@@ -9,9 +9,13 @@ import shutil
 import subprocess
 import tempfile
 import time
-import tomllib
 from pathlib import Path
 
+try:
+    import tomllib
+except ModuleNotFoundError:  # Python < 3.11
+    import tomli as tomllib
+
 from client_preferences import (
     BACKEND_NONE,
     CLIENT_CLAUDE_CODE,

package/src/client_preferences.py

@@ -5,9 +5,13 @@ from __future__ import annotations
 import os
 import shutil
 import sys
-import tomllib
 from pathlib import Path
 
+try:
+    import tomllib
+except ModuleNotFoundError:  # Python < 3.11
+    import tomli as tomllib
+
 from runtime_power import load_schedule_config, save_schedule_config
 
 

package/src/client_sync.py

@@ -10,9 +10,13 @@ import shlex
 import shutil
 import subprocess
 import sys
-import tomllib
 from pathlib import Path
 
+try:
+    import tomllib
+except ModuleNotFoundError:  # Python < 3.11
+    import tomli as tomllib
+
 from bootstrap_docs import sync_client_bootstrap
 
 try:

package/src/dashboard/app.py

@@ -30,7 +30,7 @@ if _PARENT not in sys.path:
 
 from agent_runner import AgentRunnerError, build_followup_terminal_shell_command
 
-app = FastAPI(title="NEXO Brain Dashboard", version="3.0.0")
+app = FastAPI(title="NEXO Brain Dashboard", version="3.0.1")
 
 TEMPLATES_DIR = Path(__file__).resolve().parent / "templates"
 STATIC_DIR = Path(__file__).resolve().parent / "static"

package/src/db/_workflow.py

@@ -4,7 +4,7 @@ from __future__ import annotations
 import json
 import secrets
 import time
-from datetime import UTC, datetime
+from datetime import datetime, timezone
 
 from db._core import get_db
 
@@ -48,7 +48,7 @@ def _workflow_goal_id() -> str:
 
 
 def _now_sql() -> str:
-    return datetime.now(UTC).strftime("%Y-%m-%d %H:%M:%S")
+    return datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M:%S")
 
 
 def _as_json(value, default):

package/src/doctor/providers/boot.py

@@ -148,37 +148,63 @@ def check_python_runtime() -> DoctorCheck:
     )
 
 
+CRITICAL_CONFIG_FILES = (
+    ("schedule.json", ("config", "schedule.json")),
+    ("optionals.json", ("config", "optionals.json")),
+    ("crons/manifest.json", ("crons", "manifest.json")),
+)
+
+
 def check_config_parse() -> DoctorCheck:
-    """Check schedule.json parses correctly if present."""
-    schedule_file = NEXO_HOME / "config" / "schedule.json"
-    if not schedule_file.exists():
+    """Validate that critical JSON config files parse correctly."""
+    import json
+
+    errors: list[str] = []
+    checked: list[str] = []
+
+    for label, relative in CRITICAL_CONFIG_FILES:
+        path = NEXO_HOME.joinpath(*relative)
+        if not path.exists():
+            continue
+        try:
+            data = json.loads(path.read_text())
+        except Exception as exc:
+            errors.append(f"{label}: {exc}")
+            continue
+        if not isinstance(data, dict):
+            errors.append(f"{label}: expected JSON object, got {type(data).__name__}")
+            continue
+        checked.append(label)
+
+    if errors:
         return DoctorCheck(
             id="boot.config_parse",
             tier="boot",
-            status="healthy",
-            severity="info",
-            summary="No schedule.json (using defaults)",
+            status="degraded",
+            severity="warn",
+            summary=f"{len(errors)} config file parse error" + ("s" if len(errors) != 1 else ""),
+            evidence=errors,
+            repair_plan=["Fix JSON syntax in the listed config files, or delete them to fall back to defaults"],
         )
-    try:
-        import json
-        json.loads(schedule_file.read_text())
+
+    if not checked:
         return DoctorCheck(
             id="boot.config_parse",
             tier="boot",
             status="healthy",
             severity="info",
-            summary="schedule.json parses OK",
-        )
-    except Exception as e:
-        return DoctorCheck(
-            id="boot.config_parse",
-            tier="boot",
-            status="degraded",
-            severity="warn",
-            summary=f"schedule.json parse error: {e}",
-            repair_plan=["Fix JSON syntax in schedule.json or delete to use defaults"],
+            summary="No config files present (using defaults)",
         )
 
+    return DoctorCheck(
+        id="boot.config_parse",
+        tier="boot",
+        status="healthy",
+        severity="info",
+        summary=f"{len(checked)} config file" + ("s" if len(checked) != 1 else "") + " parse OK",
+        evidence=checked,
+    )
+
 
 def run_boot_checks(fix: bool = False) -> list[DoctorCheck]:
     """Run all boot-tier checks."""

package/src/doctor/providers/runtime.py

@@ -12,9 +12,13 @@ import sqlite3
 import subprocess
 import sys
 import time
-import tomllib
 from pathlib import Path
 
+try:
+    import tomllib
+except ModuleNotFoundError:  # Python < 3.11
+    import tomli as tomllib
+
 from client_preferences import (
     detect_installed_clients,
     normalize_client_preferences,
@@ -738,7 +742,7 @@ def _parse_timestamp(value: str) -> dt.datetime | None:
     except ValueError:
         return None
     if parsed.tzinfo is None:
-        parsed = parsed.replace(tzinfo=dt.UTC)
+        parsed = parsed.replace(tzinfo=dt.timezone.utc)
     return parsed
 
 
@@ -2470,7 +2474,7 @@ def check_state_watchers() -> DoctorCheck:
             generated_dt = dt.datetime.fromisoformat(str(generated_at).replace("Z", "+00:00"))
         except Exception:
             generated_dt = None
-    if not generated_dt or (dt.datetime.now(dt.UTC) - generated_dt).total_seconds() > 36 * 3600:
+    if not generated_dt or (dt.datetime.now(dt.timezone.utc) - generated_dt).total_seconds() > 36 * 3600:
         status = "degraded"
         severity = "warn"
         repair_plan.append("Refresh state watchers daily so repo/API/expiry drift stays explicit")

package/src/requirements.txt

@@ -11,3 +11,4 @@ fastapi
 uvicorn
 pydantic
 jinja2
+tomli; python_version < "3.11"

package/src/state_watchers_runtime.py

@@ -5,7 +5,7 @@ import json
 import os
 import sqlite3
 import subprocess
-from datetime import UTC, datetime, timedelta
+from datetime import datetime, timedelta, timezone
 from pathlib import Path
 from urllib import error, request
 
@@ -30,7 +30,7 @@ def _manifest_file() -> Path:
 
 
 def _now_iso() -> str:
-    return datetime.now(UTC).strftime("%Y-%m-%d %H:%M:%S")
+    return datetime.now(timezone.utc).strftime("%Y-%m-%d %H:%M:%S")
 
 
 def _parse_dt(value: str | None) -> datetime | None:
@@ -41,13 +41,13 @@ def _parse_dt(value: str | None) -> datetime | None:
     for candidate in (normalized, normalized + "T00:00:00+00:00"):
         try:
             parsed = datetime.fromisoformat(candidate)
-            return parsed if parsed.tzinfo else parsed.replace(tzinfo=UTC)
+            return parsed if parsed.tzinfo else parsed.replace(tzinfo=timezone.utc)
         except Exception:
             continue
     for fmt in ("%Y-%m-%d", "%Y-%m-%d %H:%M:%S"):
         try:
             parsed = datetime.strptime(text, fmt)
-            return parsed.replace(tzinfo=UTC)
+            return parsed.replace(tzinfo=timezone.utc)
         except Exception:
             continue
     return None
@@ -150,7 +150,7 @@ def _evaluate_cron_drift(watcher: dict) -> dict:
     last_run = _load_last_cron_run(cron_id)
     if not last_run:
         return {"health": "critical", "summary": f"cron {cron_id} has never run", "evidence": [f"threshold_seconds={threshold}"]}
-    age = (datetime.now(UTC) - last_run).total_seconds()
+    age = (datetime.now(timezone.utc) - last_run).total_seconds()
     if age > threshold * 2:
         health = "critical"
     elif age > threshold:
@@ -218,7 +218,7 @@ def _evaluate_expiry(watcher: dict) -> dict:
         return {"health": "critical", "summary": f"expiry watcher missing due_at: {watcher.get('watcher_id')}", "evidence": []}
     warn_days = int(config.get("warn_days") or 21)
     critical_days = int(config.get("critical_days") or 7)
-    remaining = due_at - datetime.now(UTC)
+    remaining = due_at - datetime.now(timezone.utc)
     days = remaining.total_seconds() / 86400
     if days <= critical_days:
         health = "critical"

package/src/tools_sessions.py

@@ -6,7 +6,7 @@ import os
 import time
 import secrets
 import threading
-from datetime import datetime, UTC
+from datetime import datetime, timezone
 from pathlib import Path
 from db import (
     register_session, update_session, complete_session,
@@ -133,7 +133,7 @@ def _session_portability_bundle(sid: str = "") -> dict:
     ]
     return {
         "ok": True,
-        "generated_at": datetime.now(UTC).isoformat(),
+        "generated_at": datetime.now(timezone.utc).isoformat(),
         "session": {
             "sid": session_id,
             "task": session_row["task"],