nexo-brain 0.8.0 → 0.8.2

package/README.md

@@ -332,7 +332,7 @@ That's it. No need to run `claude` manually. Atlas will greet you immediately
 | Component | What | Where |
 |-----------|------|-------|
 | Cognitive engine | Python: fastembed, numpy, vector search | pip packages |
-| MCP server | 105+ tools for memory, cognition, learning, guard | ~/.nexo/ |
+| MCP server | 109+ tools for memory, cognition, learning, guard | ~/.nexo/ |
 | Plugins | Guard, episodic memory, cognitive memory, entities, preferences | ~/.nexo/plugins/ |
 | Hooks (5) | SessionStart briefing, Stop post-mortem, PostToolUse capture, PreCompact checkpoint, Caffeinate | ~/.nexo/hooks/ |
 | Reflection engine | Processes session buffer, extracts patterns, updates user model | ~/.nexo/scripts/ |
@@ -345,7 +345,7 @@ That's it. No need to run `claude` manually. Atlas will greet you immediately
 
 - **macOS, Linux, or Windows**
 - **Node.js 18+** (for the installer)
-- **Claude Opus (latest version) strongly recommended.** NEXO Brain provides 109+ MCP tools across 17 categories. This cognitive load requires a top-tier model with large context window. Smaller models (Haiku, Sonnet) may struggle with tool selection and produce inconsistent results. Opus handles all 105+ tools without hesitation.
+- **Claude Opus (latest version) strongly recommended.** NEXO Brain provides 109+ MCP tools across 19 categories. This cognitive load requires a top-tier model with large context window. Smaller models (Haiku, Sonnet) may struggle with tool selection and produce inconsistent results. Opus handles all 109+ tools without hesitation.
 - Python 3, Homebrew, and Claude Code are installed automatically if missing.
 
 ## Architecture
@@ -372,7 +372,7 @@ That's it. No need to run `claude` manually. Atlas will greet you immediately
 | Agents | 5 | get, create, update, delete, list | Agent delegation registry |
 | Backup | 3 | now, list, restore | SQLite data safety |
 | Evolution | 5 | propose, approve, reject, status, history | Self-improvement proposals |
-| Adaptive & Somatic (4) | nexo_adaptive_weights, nexo_adaptive_override, nexo_somatic_check, nexo_somatic_stats |
+| Adaptive & Somatic | 4 | adaptive_weights, adaptive_override, somatic_check, somatic_stats | Learned signal weights + pain memory per file |
 | Knowledge Graph | 4 | kg_query, kg_path, kg_neighbors, kg_stats | Bi-temporal entity-relationship graph |
 
 ### Plugin System
@@ -431,7 +431,7 @@ NEXO Brain is designed as an MCP server. Claude Code is the primary supported cl
 npx nexo-brain
 ```
 
-All 105+ tools are available immediately after installation. The installer configures Claude Code's `~/.claude/settings.json` automatically.
+All 109+ tools are available immediately after installation. The installer configures Claude Code's `~/.claude/settings.json` automatically.
 
 ### OpenClaw
 

package/bin/nexo-brain.js

@@ -211,27 +211,37 @@ async function main() {
     }
   }
 
-  // Find or install Homebrew (needed for Python)
-  let hasBrew = run("which brew");
-  if (!hasBrew) {
-    log("Homebrew not found. Installing...");
-    spawnSync("/bin/bash", ["-c", '$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)'], {
-      stdio: "inherit",
-    });
-    hasBrew = run("which brew") || run("eval $(/opt/homebrew/bin/brew shellenv) && which brew");
-  }
-
-  // Find or install Python
+  // Find or install Python (platform-aware)
   let python = run("which python3");
   if (!python) {
-    if (hasBrew) {
-      log("Python 3 not found. Installing via Homebrew...");
-      spawnSync("brew", ["install", "python3"], { stdio: "inherit" });
+    if (platform === "darwin") {
+      // macOS: use Homebrew
+      let hasBrew = run("which brew");
+      if (!hasBrew) {
+        log("Homebrew not found. Installing...");
+        spawnSync("/bin/bash", ["-c", '$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)'], {
+          stdio: "inherit",
+        });
+        hasBrew = run("which brew") || run("eval $(/opt/homebrew/bin/brew shellenv) && which brew");
+      }
+      if (hasBrew) {
+        log("Python 3 not found. Installing via Homebrew...");
+        spawnSync("brew", ["install", "python3"], { stdio: "inherit" });
+        python = run("which python3");
+      }
+    } else if (platform === "linux") {
+      // Linux: try apt or yum
+      log("Python 3 not found. Attempting install...");
+      if (run("which apt-get")) {
+        spawnSync("sudo", ["apt-get", "install", "-y", "python3", "python3-pip", "python3-venv"], { stdio: "inherit" });
+      } else if (run("which yum")) {
+        spawnSync("sudo", ["yum", "install", "-y", "python3", "python3-pip"], { stdio: "inherit" });
+      }
       python = run("which python3");
     }
     if (!python) {
       log("Python 3 not found and couldn't install automatically.");
-      log("Install it manually: brew install python3");
+      log(platform === "darwin" ? "Install it: brew install python3" : "Install it: sudo apt install python3");
       process.exit(1);
     }
   }
@@ -242,13 +252,20 @@ async function main() {
   let claudeInstalled = run("which claude");
   if (!claudeInstalled) {
     log("Claude Code not found. Installing...");
-    const npmInstall = spawnSync("npm", ["install", "-g", "@anthropic-ai/claude-code"], {
-      stdio: "inherit",
-    });
-    claudeInstalled = run("which claude");
+    // Try npx first (no sudo needed), then npm -g as fallback
+    spawnSync("npx", ["-y", "@anthropic-ai/claude-code", "--version"], { stdio: "pipe", timeout: 60000 });
+    claudeInstalled = run("which claude") || run("npx -y @anthropic-ai/claude-code --version");
+    if (!claudeInstalled) {
+      // Fallback: npm -g (may need sudo on Linux)
+      const npmCmd = platform === "linux" ? "sudo" : "npm";
+      const npmArgs = platform === "linux" ? ["npm", "install", "-g", "@anthropic-ai/claude-code"] : ["install", "-g", "@anthropic-ai/claude-code"];
+      spawnSync(npmCmd, npmArgs, { stdio: "inherit" });
+      claudeInstalled = run("which claude");
+    }
     if (!claudeInstalled) {
       log("Could not install Claude Code automatically.");
       log("Install it manually: npm install -g @anthropic-ai/claude-code");
+      log("(On Linux you may need: sudo npm install -g @anthropic-ai/claude-code)");
       process.exit(1);
     }
     log("Claude Code installed successfully.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "mcpName": "io.github.wazionapps/nexo",
   "description": "NEXO — Cognitive co-operator for Claude Code. Atkinson-Shiffrin memory, semantic RAG, trust scoring, and metacognitive error prevention.",
   "bin": {

package/src/plugins/agents.py

@@ -4,7 +4,7 @@ from db import create_agent, get_agent, list_agents, update_agent, delete_agent
 def handle_agent_get(id: str) -> str:
     """Get an agent's full profile by ID."""
     a = get_agent(id)
-    if not a: return f"Agente '{id}' no encontrado."
+    if not a: return f"Agent '{id}' not found."
     lines = [f"AGENTE: {a['name']} ({a['id']})", f"  Especialización: {a['specialization']}", f"  Modelo: {a['model']}"]
     if a["tools"]: lines.append(f"  Tools: {a['tools']}")
     if a["context_files"]: lines.append(f"  Contexto: {a['context_files']}")
@@ -15,7 +15,7 @@ def handle_agent_create(id: str, name: str, specialization: str, model: str = "s
                         tools: str = "", context_files: str = "", rules: str = "") -> str:
     """Register a new agent in the registry."""
     create_agent(id, name, specialization, model, tools, context_files, rules)
-    return f"Agente '{id}' ({name}) registrado. Modelo: {model}"
+    return f"Agent '{id}' ({name}) registered. Model: {model}"
 
 def handle_agent_update(id: str, name: str = "", specialization: str = "", model: str = "",
                         tools: str = "", context_files: str = "", rules: str = "") -> str:
@@ -26,12 +26,12 @@ def handle_agent_update(id: str, name: str = "", specialization: str = "", model
         if v: kwargs[k] = v
     if not kwargs: return "Nada que actualizar."
     update_agent(id, **kwargs)
-    return f"Agente '{id}' actualizado."
+    return f"Agent '{id}' updated."
 
 def handle_agent_list() -> str:
     """List all registered agents."""
     agents = list_agents()
-    if not agents: return "Sin agentes registrados."
+    if not agents: return "No agents registered."
     lines = ["AGENTES REGISTRADOS:"]
     for a in agents:
         lines.append(f"  {a['id']} — {a['name']} ({a['model']}) — {a['specialization'][:60]}")
@@ -40,8 +40,8 @@ def handle_agent_list() -> str:
 def handle_agent_delete(id: str) -> str:
     """Remove an agent from the registry."""
     if not delete_agent(id):
-        return f"ERROR: Agente '{id}' no encontrado."
-    return f"Agente '{id}' eliminado."
+        return f"ERROR: Agent '{id}' not found."
+    return f"Agent '{id}' deleted."
 
 TOOLS = [
     (handle_agent_get, "nexo_agent_get", "Get an agent's full profile"),

package/src/plugins/backup.py

@@ -56,7 +56,7 @@ def handle_backup_restore(filename: str) -> str:
     """
     src = os.path.join(BACKUP_DIR, filename)
     if not os.path.isfile(src):
-        return f"Backup no encontrado: {filename}"
+        return f"Backup not found: {filename}"
 
     # Create safety backup first
     safety = os.path.join(BACKUP_DIR, f"nexo-pre-restore-{time.strftime('%Y%m%d%H%M%S')}.db")

package/src/plugins/episodic_memory.py

@@ -101,7 +101,7 @@ def handle_decision_search(query: str = '', domain: str = '', days: int = 30) ->
     results = search_decisions(query, domain, days)
     if not results:
         scope = f"'{query}'" if query else domain or 'todas'
-        return f"Sin decisiones encontradas para {scope} en {days} días."
+        return f"Sin decisiones encontradas para {scope} in {days} days."
 
     lines = [f"DECISIONES ({len(results)}):"]
     for d in results:
@@ -312,7 +312,7 @@ def handle_change_search(query: str = '', files: str = '', days: int = 30) -> st
     results = search_changes(query, files, days)
     if not results:
         scope = f"'{query}'" if query else files or 'todos'
-        return f"Sin cambios encontrados para {scope} en {days} días."
+        return f"No changes found for {scope} in {days} days."
 
     lines = [f"CAMBIOS ({len(results)}):"]
     for c in results:

package/src/scripts/nexo-sleep.py

@@ -618,17 +618,17 @@ Reporta cuantos registros eliminaste.""")
 
     tasks_str = "\n\n".join(tasks)
 
-    return f"""Eres NEXO Sleep System. Tu trabajo es PODAR la memoria.
-NO eres interactivo. NO esperas input. Ejecuta las siguientes tareas y sal.
-
-REGLAS ABSOLUTAS:
-- NUNCA borres credenciales, tokens, IDs de cuentas, API endpoints, claves, secrets.
-- NUNCA borres reglas operativas marcadas como "CRITICO" o "MAXIMA PRIORIDAD".
-- NUNCA borres informacion sobre infraestructura (servidores, repos, deploys).
-- SI puedes fusionar secciones redundantes.
-- SI puedes eliminar informacion tecnica obsoleta (arreglada hace >30 dias y nunca referenciada despues).
-- SI puedes comprimir parrafos largos en bullets concisos.
-- Cada linea que elimines debe tener una razon clara. En caso de duda, NO borres.
+    return f"""You are NEXO Sleep System. Your job is to PRUNE memory.
+You are NOT interactive. Do NOT wait for input. Execute the following tasks and exit.
+
+ABSOLUTE RULES:
+- NEVER delete credentials, tokens, account IDs, API endpoints, keys, secrets.
+- NEVER delete operational rules marked as "CRITICAL" or "HIGHEST PRIORITY".
+- NEVER delete information about infrastructure (servers, repos, deploys).
+- You CAN merge redundant sections.
+- You CAN remove obsolete technical information (fixed >30 days ago and never referenced since).
+- You CAN compress long paragraphs into concise bullets.
+- Every line you remove must have a clear reason. When in doubt, do NOT delete.
 
 {tasks_str}
 

package/src/tools_learnings.py

@@ -24,7 +24,7 @@ def handle_learning_add(category: str, title: str, content: str, reasoning: str
     """
     if category not in VALID_CATEGORIES:
         valid = ", ".join(sorted(VALID_CATEGORIES))
-        return f"ERROR: Categoría '{category}' inválida. Válidas: {valid}"
+        return f"ERROR: Category '{category}' invalid. Valid: {valid}"
     result = create_learning(
         category, title, content, reasoning=reasoning
     )
@@ -142,7 +142,7 @@ def handle_learning_update(id: int, title: str = '', content: str = '', category
     if category:
         if category not in VALID_CATEGORIES:
             valid = ", ".join(sorted(VALID_CATEGORIES))
-            return f"ERROR: Categoría '{category}' inválida. Válidas: {valid}"
+            return f"ERROR: Category '{category}' invalid. Valid: {valid}"
         kwargs["category"] = category
     if reasoning:
         kwargs["reasoning"] = reasoning
@@ -183,7 +183,7 @@ def handle_learning_delete(id: int) -> str:
     """Delete a learning entry by ID."""
     deleted = delete_learning(id)
     if not deleted:
-        return f"ERROR: Learning #{id} no encontrado."
+        return f"ERROR: Learning #{id} not found."
     return f"Learning #{id} eliminado."
 
 

package/src/tools_reminders_crud.py

@@ -14,15 +14,15 @@ from db import (
 def handle_reminder_create(id: str, description: str, date: str = '', category: str = 'general') -> str:
     """Create a new reminder. id must start with 'R'."""
     if not id.startswith('R'):
-        return f"ERROR: El ID del recordatorio debe empezar por 'R' (recibido: '{id}')."
+        return f"ERROR: Reminder ID must start with 'R' (received: '{id}')."
 
     result = create_reminder(id=id, description=description, date=date or None, category=category)
     if not result or "error" in result:
-        error_msg = result.get("error", "desconocido") if isinstance(result, dict) else "desconocido"
+        error_msg = result.get("error", "unknown") if isinstance(result, dict) else "unknown"
         return f"ERROR: {error_msg}"
 
-    fecha_str = date if date else 'sin fecha'
-    return f"Recordatorio {id} creado. Fecha: {fecha_str}. Categoría: {category}."
+    date_str = date if date else 'no date'
+    return f"Reminder {id} created. Date: {date_str}. Category: {category}."
 
 
 def handle_reminder_update(id: str, description: str = '', date: str = '', status: str = '', category: str = '') -> str:
@@ -38,32 +38,32 @@ def handle_reminder_update(id: str, description: str = '', date: str = '', statu
         fields['category'] = category
 
     if not fields:
-        return f"ERROR: No se especificó ningún campo a actualizar para {id}."
+        return f"ERROR: No fields specified to update for {id}."
 
     result = update_reminder(id=id, **fields)
     if not result:
-        return f"ERROR: Recordatorio {id} no encontrado."
+        return f"ERROR: Reminder {id} not found."
 
     changed = ', '.join(fields.keys())
-    return f"Recordatorio {id} actualizado: {changed}."
+    return f"Reminder {id} updated: {changed}."
 
 
 def handle_reminder_complete(id: str) -> str:
     """Mark a reminder as completed."""
     result = complete_reminder(id=id)
     if not result or "error" in result:
-        return f"ERROR: Recordatorio {id} no encontrado."
+        return f"ERROR: Reminder {id} not found."
 
-    return f"Recordatorio {id} marcado COMPLETADO."
+    return f"Reminder {id} marked COMPLETED."
 
 
 def handle_reminder_delete(id: str) -> str:
     """Delete a reminder permanently."""
     result = delete_reminder(id=id)
     if not result:
-        return f"ERROR: Recordatorio {id} no encontrado."
+        return f"ERROR: Reminder {id} not found."
 
-    return f"Recordatorio {id} eliminado."
+    return f"Reminder {id} deleted."
 
 
 # ── Followups ──────────────────────────────────────────────────────────────────
@@ -81,16 +81,16 @@ def handle_followup_create(id: str, description: str, date: str = '', verificati
                     When completed, auto-creates the next occurrence.
     """
     if not id.startswith('NF'):
-        return f"ERROR: El ID del followup debe empezar por 'NF' (recibido: '{id}')."
+        return f"ERROR: Followup ID must start with 'NF' (received: '{id}')."
 
     result = create_followup(id=id, description=description, date=date or None, verification=verification, reasoning=reasoning, recurrence=recurrence or None)
     if not result or "error" in result:
-        error_msg = result.get("error", "desconocido") if isinstance(result, dict) else "desconocido"
+        error_msg = result.get("error", "unknown") if isinstance(result, dict) else "unknown"
         return f"ERROR: {error_msg}"
 
-    fecha_str = date if date else 'sin fecha'
-    rec_str = f" Recurrencia: {recurrence}." if recurrence else ""
-    return f"Followup {id} creado. Fecha: {fecha_str}.{rec_str}"
+    date_str = date if date else 'no date'
+    rec_str = f" Recurrence: {recurrence}." if recurrence else ""
+    return f"Followup {id} created. Date: {date_str}.{rec_str}"
 
 
 def handle_followup_update(id: str, description: str = '', date: str = '', verification: str = '', status: str = '') -> str:
@@ -106,14 +106,14 @@ def handle_followup_update(id: str, description: str = '', date: str = '', verif
         fields['status'] = status
 
     if not fields:
-        return f"ERROR: No se especificó ningún campo a actualizar para {id}."
+        return f"ERROR: No fields specified to update for {id}."
 
     result = update_followup(id=id, **fields)
     if not result:
-        return f"ERROR: Followup {id} no encontrado."
+        return f"ERROR: Followup {id} not found."
 
     changed = ', '.join(fields.keys())
-    return f"Followup {id} actualizado: {changed}."
+    return f"Followup {id} updated: {changed}."
 
 
 def handle_followup_complete(id: str, result: str = '') -> str:
@@ -128,22 +128,22 @@ def handle_followup_complete(id: str, result: str = '') -> str:
 
     db_result = complete_followup(id=id, result=result)
     if not db_result or "error" in db_result:
-        return f"ERROR: Followup {id} no encontrado."
+        return f"ERROR: Followup {id} not found."
 
     # Auto-link: find decisions whose context_ref matches this followup ID
-    msg = f"Followup {id} marcado COMPLETADO."
+    msg = f"Followup {id} marked COMPLETED."
     if has_recurrence:
         # The new one was auto-created by complete_followup
         new_row = conn.execute("SELECT date FROM followups WHERE id = ?", (id,)).fetchone()
         if new_row:
-            msg += f" ♻️ Siguiente auto-creado para {new_row['date']}."
+            msg += f" Next auto-created for {new_row['date']}."
     linked_decisions = find_decisions_by_context_ref(id)
     if linked_decisions:
-        outcome_text = result if result else f"Followup {id} completado"
+        outcome_text = result if result else f"Followup {id} completed"
         for dec in linked_decisions:
             update_decision_outcome(dec['id'], outcome_text)
         dec_ids = ', '.join(f"#{d['id']}" for d in linked_decisions)
-        msg += f" Decision(s) {dec_ids} actualizada(s) con outcome automático."
+        msg += f" Decision(s) {dec_ids} updated with automatic outcome."
 
     return msg
 
@@ -152,6 +152,6 @@ def handle_followup_delete(id: str) -> str:
     """Delete a followup permanently."""
     result = delete_followup(id=id)
     if not result:
-        return f"ERROR: Followup {id} no encontrado."
+        return f"ERROR: Followup {id} not found."
 
-    return f"Followup {id} eliminado."
+    return f"Followup {id} deleted."