nexo-brain 5.4.7 → 5.4.9

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "5.4.7",
+  "version": "5.4.9",
   "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,7 +18,7 @@
 
 [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.4.7` is the current packaged-runtime line: tool-enforcement-map.json for Protocol Enforcer — canonical map of all 247 tools with enforcement metadata, plus verify script.
+Version `5.4.9` is the current packaged-runtime line: headless Protocol Enforcer — all crons get enforcement rules automatically.
 
 Previously in `5.4.6`: runtime dependency management in `nexo update` + daily auto-update cron.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "5.4.7",
+  "version": "5.4.9",
   "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",
@@ -61,7 +61,11 @@
     "postinstall": "node bin/postinstall.js"
   },
   "runtimeDependencies": [
-    {"name": "@anthropic-ai/claude-code", "type": "npm-global", "optional": false}
+    {
+      "name": "@anthropic-ai/claude-code",
+      "type": "npm-global",
+      "optional": false
+    }
   ],
   "engines": {
     "node": ">=18"

package/src/agent_runner.py

@@ -56,7 +56,6 @@ class TerminalClientUnavailableError(AgentRunnerError):
 class AutomationBackendUnavailableError(AgentRunnerError):
     """Raised when the configured automation backend is unavailable."""
 
-
 def _canonical_pricing_model(model: str) -> str:
     lowered = str(model or "").strip().lower()
     lowered = lowered.split("[", 1)[0]
@@ -533,6 +532,63 @@ def _build_codex_prompt(
     return prompt
 
 
+def _build_enforcement_system_prompt() -> str:
+    """Build a system prompt fragment from tool-enforcement-map.json for headless sessions.
+
+    Reads the map and generates concise enforcement rules that the model must follow.
+    Only includes 'must' and 'should' level tools — 'none' tools are omitted.
+    """
+    map_path = NEXO_HOME / "tool-enforcement-map.json"
+    if not map_path.exists():
+        for candidate in [
+            Path(__file__).parent.parent / "tool-enforcement-map.json",
+        ]:
+            if candidate.exists():
+                map_path = candidate
+                break
+        else:
+            return ""
+    try:
+        data = json.loads(map_path.read_text())
+    except Exception:
+        return ""
+
+    lines = ["[PROTOCOL ENFORCEMENT — these rules are mandatory]"]
+    must_rules = []
+    should_rules = []
+
+    for tool_name, tool in data.get("tools", {}).items():
+        enf = tool.get("enforcement", {})
+        level = enf.get("level", "none")
+        if level == "none":
+            continue
+        rules = enf.get("rules", [])
+        rule_descs = [r.get("description", "") for r in rules if r.get("description")]
+        notes = enf.get("notes", "")
+        if rule_descs:
+            desc = f"{tool_name}: {'; '.join(rule_descs)}"
+        elif notes:
+            desc = f"{tool_name}: {notes[:120]}"
+        else:
+            rule_types = [r.get("type", "") for r in rules]
+            desc = f"{tool_name} ({', '.join(rule_types)})" if rule_types else tool_name
+        if level == "must":
+            must_rules.append(desc)
+        elif level == "should":
+            should_rules.append(desc)
+
+    if must_rules:
+        lines.append("MUST (violation creates protocol debt):")
+        for r in must_rules:
+            lines.append(f"  - {r}")
+    if should_rules:
+        lines.append("SHOULD (recommended, check if relevant):")
+        for r in should_rules:
+            lines.append(f"  - {r}")
+
+    return "\n".join(lines) if (must_rules or should_rules) else ""
+
+
 def run_automation_prompt(
     prompt: str,
     *,
@@ -562,6 +618,13 @@ def run_automation_prompt(
             reasoning_effort = profile["reasoning_effort"]
     selected_backend = _resolve_available_backend(selected_backend, preferences=prefs)
 
+    enforcement_fragment = _build_enforcement_system_prompt()
+    if enforcement_fragment:
+        if append_system_prompt:
+            append_system_prompt = append_system_prompt + "\n\n" + enforcement_fragment
+        else:
+            append_system_prompt = enforcement_fragment
+
     cwd_path = Path(cwd).expanduser().resolve() if cwd else Path.cwd()
     run_env = _headless_env(env)
     extra_args = list(extra_args or [])