nexo-brain 5.5.3 → 5.5.4

package/.claude-plugin/plugin.json

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

@@ -18,9 +18,9 @@
 
 [Watch the overview video](https://nexo-brain.com/watch/) · [Watch on YouTube](https://www.youtube.com/watch?v=i2lkGhKyVqI) · [Open the infographic](https://nexo-brain.com/assets/nexo-brain-infographic-v5.png)
 
-Version `5.5.3` is the current packaged-runtime line: CLAUDE.md CORE now teaches the model to trust the Protocol Enforcer, so aligned backends stop rejecting heartbeat, diary, and checkpoint injections as suspected prompt injection.
+Version `5.5.4` is the current packaged-runtime line: Deep Sleep no longer blocks on unparseable sessions — reduced retries, added a JSON escape hatch, and unified the automation subprocess timeout to 3h across all scripts via a single shared constant.
 
-Previously in `5.4.6`: runtime dependency management in `nexo update` + daily auto-update cron.
+Previously in `5.5.3`: CLAUDE.md CORE teaches the model to trust the Protocol Enforcer, so aligned backends stop rejecting heartbeat, diary, and checkpoint injections as suspected prompt injection.
 
 Start here:
 - [5-minute quickstart](docs/quickstart-5-minutes.md)

package/package.json

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

package/src/constants.py

@@ -0,0 +1,9 @@
+"""Shared constants for NEXO scripts and runtime."""
+from __future__ import annotations
+
+# Safety-net timeout (seconds) for Claude CLI / automation subprocess calls.
+# Applied across deep-sleep, synthesis, immune, evolution, catchup, and other
+# headless scripts that invoke the configured automation backend. Three hours
+# is long enough for legitimate long runs but short enough to prevent zombie
+# subprocesses from blocking the pipeline indefinitely.
+AUTOMATION_SUBPROCESS_TIMEOUT = 10800

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

@@ -26,6 +26,7 @@ if str(NEXO_CODE) not in sys.path:
     sys.path.insert(0, str(NEXO_CODE))
 
 from agent_runner import AutomationBackendUnavailableError, run_automation_prompt
+from constants import AUTOMATION_SUBPROCESS_TIMEOUT
 try:
     from client_preferences import resolve_user_model as _resolve_user_model
     _USER_MODEL = _resolve_user_model()
@@ -33,8 +34,9 @@ except Exception:
     _USER_MODEL = ""
 
 
-# No timeout -- headless automation can take as long as needed
-CLAUDE_TIMEOUT = 21600  # 3h safety net (prevents zombie processes)
+# 3h safety net for the Claude CLI subprocess. Prevents zombie processes while
+# still leaving enough headroom for legitimate long per-session extractions.
+CLAUDE_TIMEOUT = AUTOMATION_SUBPROCESS_TIMEOUT
 
 
 def extract_json_from_response(text: str) -> dict | None:
@@ -129,7 +131,11 @@ def analyze_session(
         JSON_SYSTEM_PROMPT = (
             "You are a JSON-only analyst. Your ENTIRE response must be a single valid JSON object. "
             "No text before it. No text after it. No markdown fences. No explanations. "
-            "If you want to summarize, put it inside the JSON fields. Start with { and end with }."
+            "If you want to summarize, put it inside the JSON fields. Start with { and end with }. "
+            "If for ANY reason you cannot comply with the requested schema (context too large, "
+            "file unreadable, ambiguous, uncertain), you MUST still return a JSON object shaped as "
+            '{"session_id":"<the id>","findings":[],"error":"cannot_comply","reason":"<short reason>"}. '
+            "NEVER return plain text, apology, markdown, or empty output."
         )
 
         result = run_automation_prompt(
@@ -249,7 +255,10 @@ def main():
     all_extractions = []
     total_findings = 0
     skipped = 0
-    MAX_RETRIES = 3
+    # Two attempts is enough: if a session's extraction fails twice, the cause is
+    # almost always deterministic (JSON parse, schema violation) rather than transient,
+    # so further retries just burn time. Skip and continue instead.
+    MAX_RETRIES = 2
 
     for i, session_id in enumerate(session_files):
         sid_safe = _safe_session_slug(session_id)[:40]

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

@@ -34,8 +34,9 @@ if str(NEXO_CODE) not in sys.path:
     sys.path.insert(0, str(NEXO_CODE))
 
 from agent_runner import AutomationBackendUnavailableError, run_automation_prompt
+from constants import AUTOMATION_SUBPROCESS_TIMEOUT
 
-CLAUDE_TIMEOUT = 21600  # 3h safety net (prevents zombie processes)
+CLAUDE_TIMEOUT = AUTOMATION_SUBPROCESS_TIMEOUT
 ACTION_VERBS = {"add", "implement", "create", "write", "build", "enforce", "automate", "validate", "guard", "fix", "review"}
 
 

package/src/scripts/nexo-agent-run.py

@@ -16,6 +16,7 @@ if str(NEXO_CODE) not in sys.path:
     sys.path.insert(0, str(NEXO_CODE))
 
 from agent_runner import AutomationBackendUnavailableError, run_automation_prompt
+from constants import AUTOMATION_SUBPROCESS_TIMEOUT
 
 
 def _read_text(path: str | None) -> str:
@@ -32,7 +33,7 @@ def main(argv: list[str] | None = None) -> int:
     parser.add_argument("--task-profile", default="", help="Automation task profile: default|fast|balanced|deep")
     parser.add_argument("--model", default="", help="Backend model hint")
     parser.add_argument("--reasoning-effort", default="", help="Backend reasoning effort/profile")
-    parser.add_argument("--timeout", type=int, default=21600, help="Timeout in seconds")
+    parser.add_argument("--timeout", type=int, default=AUTOMATION_SUBPROCESS_TIMEOUT, help="Timeout in seconds")
     parser.add_argument("--output-format", default="text", help="Requested output format")
     parser.add_argument("--allowed-tools", default="", help="Claude-style allowed tools contract")
     parser.add_argument("--append-system-prompt", default="", help="Extra system prompt text")

package/src/scripts/nexo-catchup.py

@@ -27,6 +27,7 @@ if str(_runtime_root) not in sys.path:
     sys.path.insert(0, str(_runtime_root))
 
 from agent_runner import AutomationBackendUnavailableError, probe_automation_backend, run_automation_prompt
+from constants import AUTOMATION_SUBPROCESS_TIMEOUT
 from cron_recovery import catchup_candidates
 
 HOME = Path.home()
@@ -175,7 +176,7 @@ def run_task(candidate: dict, state: dict) -> bool:
     try:
         result = subprocess.run(
             command,
-            capture_output=True, text=True, timeout=21600,
+            capture_output=True, text=True, timeout=AUTOMATION_SUBPROCESS_TIMEOUT,
             env={**os.environ, "HOME": str(HOME), "NEXO_CATCHUP": "1"}
         )
         if result.returncode == 0:
@@ -189,7 +190,7 @@ def run_task(candidate: dict, state: dict) -> bool:
                 log(f"    stderr: {result.stderr[:300]}")
             return False
     except subprocess.TimeoutExpired:
-        log(f"  TIMEOUT {name} (21600s)")
+        log(f"  TIMEOUT {name} ({AUTOMATION_SUBPROCESS_TIMEOUT}s)")
         return False
     except Exception as e:
         log(f"  ERROR {name}: {e}")
@@ -280,7 +281,7 @@ Format:
         result = run_automation_prompt(
             prompt,
             model=_USER_MODEL,
-            timeout=21600,
+            timeout=AUTOMATION_SUBPROCESS_TIMEOUT,
             output_format="text",
             allowed_tools="Read,Write,Edit,Glob,Grep,Bash,mcp__nexo__*",
         )

package/src/scripts/nexo-daily-self-audit.py

@@ -37,6 +37,7 @@ if str(NEXO_CODE) not in sys.path:
     sys.path.insert(0, str(NEXO_CODE))
 
 from agent_runner import AutomationBackendUnavailableError, run_automation_prompt
+from constants import AUTOMATION_SUBPROCESS_TIMEOUT
 import db as nexo_db
 from public_evolution_queue import queue_public_port_candidate
 
@@ -2050,7 +2051,7 @@ Also write the machine-readable summary to {LOG_DIR}/self-audit-summary.json.
         result = run_automation_prompt(
             prompt,
             model=_USER_MODEL,
-            timeout=21600,
+            timeout=AUTOMATION_SUBPROCESS_TIMEOUT,
             output_format="text",
             allowed_tools="Read,Write,Edit,Glob,Grep,Bash,mcp__nexo__*",
         )

package/src/scripts/nexo-evolution-run.py

@@ -179,6 +179,7 @@ def log(msg: str):
 # ── Import from evolution_cycle.py (lives in NEXO_CODE, i.e. src/) ──────
 sys.path.insert(0, str(NEXO_CODE))
 from agent_runner import probe_automation_backend, run_automation_prompt
+from constants import AUTOMATION_SUBPROCESS_TIMEOUT
 from evolution_cycle import (
     load_objective, save_objective, get_week_data, build_evolution_prompt,
     dry_run_restore_test, max_auto_changes, create_snapshot,
@@ -214,7 +215,7 @@ def set_consecutive_failures(count: int):
 
 
 # ── Automation backend call ──────────────────────────────────────────────
-CLI_TIMEOUT = 21600  # 3h safety net (prevents zombie processes)
+CLI_TIMEOUT = AUTOMATION_SUBPROCESS_TIMEOUT
 
 
 def verify_claude_cli() -> bool:

package/src/scripts/nexo-immune.py

@@ -38,6 +38,7 @@ if str(NEXO_CODE) not in sys.path:
     sys.path.insert(0, str(NEXO_CODE))
 
 from agent_runner import AutomationBackendUnavailableError, run_automation_prompt
+from constants import AUTOMATION_SUBPROCESS_TIMEOUT
 
 from urllib.request import Request, urlopen
 from urllib.error import URLError, HTTPError
@@ -916,7 +917,7 @@ Write the report. Be concise — max 40 lines."""
         result = run_automation_prompt(
             prompt,
             model=_USER_MODEL,
-            timeout=21600,
+            timeout=AUTOMATION_SUBPROCESS_TIMEOUT,
             output_format="text",
             allowed_tools="Read,Write,Edit,Glob,Grep,Bash,mcp__nexo__*",
         )

package/src/scripts/nexo-postmortem-consolidator.py

@@ -37,6 +37,7 @@ NEXO_CODE = Path(os.environ.get("NEXO_CODE", str(_repo_src) if (_repo_src / "ser
 sys.path.insert(0, str(NEXO_CODE))
 
 from agent_runner import AutomationBackendUnavailableError, run_automation_prompt
+from constants import AUTOMATION_SUBPROCESS_TIMEOUT
 
 try:
     from client_preferences import resolve_user_model as _resolve_user_model
@@ -255,7 +256,7 @@ Execute without asking."""
         result = run_automation_prompt(
             prompt,
             model=_USER_MODEL,
-            timeout=21600,
+            timeout=AUTOMATION_SUBPROCESS_TIMEOUT,
             output_format="text",
             allowed_tools="Read,Write,Edit,Glob,Grep,Bash,mcp__nexo__*",
         )

package/src/scripts/nexo-sleep.py

@@ -37,6 +37,7 @@ if str(NEXO_CODE) not in sys.path:
     sys.path.insert(0, str(NEXO_CODE))
 
 from agent_runner import AutomationBackendUnavailableError, run_automation_prompt
+from constants import AUTOMATION_SUBPROCESS_TIMEOUT
 try:
     from client_preferences import resolve_user_model as _resolve_user_model
     _USER_MODEL = _resolve_user_model()
@@ -446,7 +447,7 @@ Execute without asking."""
         result = run_automation_prompt(
             prompt,
             model=_USER_MODEL,
-            timeout=21600,
+            timeout=AUTOMATION_SUBPROCESS_TIMEOUT,
             output_format="text",
             allowed_tools="Read,Write,Edit,Glob,Grep,Bash,mcp__nexo__*",
         )

package/src/scripts/nexo-synthesis.py

@@ -34,6 +34,7 @@ if str(NEXO_CODE) not in sys.path:
     sys.path.insert(0, str(NEXO_CODE))
 
 from agent_runner import AutomationBackendUnavailableError, run_automation_prompt
+from constants import AUTOMATION_SUBPROCESS_TIMEOUT
 
 CLAUDE_DIR = NEXO_HOME
 COORD_DIR = CLAUDE_DIR / "coordination"
@@ -348,7 +349,7 @@ Execute without asking."""
         result = run_automation_prompt(
             prompt,
             model=_USER_MODEL,
-            timeout=21600,
+            timeout=AUTOMATION_SUBPROCESS_TIMEOUT,
             output_format="text",
             allowed_tools="Read,Write,Edit,Glob,Grep,Bash,mcp__nexo__*",
         )