nexo-brain 2.1.0 → 2.3.0

package/README.md

@@ -11,12 +11,12 @@
 **NEXO Brain transforms any MCP-compatible AI agent from a stateless assistant into a cognitive partner that remembers, learns, forgets, adapts, and builds a relationship with you over time.**
 
 <p align="center">
-  <a href="https://www.youtube.com/watch?v=J0hCWnYU4UY">
-    <img src="assets/nexo-brain-infographic-v4.png" alt="NEXO Brain Architecture" width="700">
+  <a href="https://www.youtube.com/watch?v=IBs7zh7ZMG0">
+    <img src="assets/nexo-brain-infographic-v5.png" alt="NEXO Brain Architecture" width="700">
   </a>
 </p>
 
-[Watch the 1-minute overview on YouTube](https://www.youtube.com/watch?v=J0hCWnYU4UY) · [Watch the full deep-dive](https://www.youtube.com/watch?v=-uvhicUhGTY)
+[Watch the overview on YouTube](https://www.youtube.com/watch?v=IBs7zh7ZMG0) · [Watch the full deep-dive](https://www.youtube.com/watch?v=bKAfowyyy5M)
 
 Every time you close a session, everything is lost. Your agent doesn't remember yesterday's decisions, repeats the same mistakes, and starts from zero. NEXO Brain fixes this with a cognitive architecture modeled after how human memory actually works.
 
@@ -283,13 +283,13 @@ NEXO Brain doesn't just respond — it runs 15 autonomous processes in the backg
 | **prevent-sleep** | Always (daemon) | Keeps machine awake for nocturnal processes (caffeinate/systemd-inhibit) |
 | **evolution** | Weekly (Sun) | Self-improvement proposals — NEXO suggests and applies enhancements |
 | **followup-hygiene** | Weekly (Sun) | Normalizes statuses, flags stale followups, cleans orphans |
+| **learning-housekeep** | 03:15 daily | Dedup learnings, adjust weights by usage, process overdue reviews, reconcile decision outcomes |
 | **immune** | Every 30 min | Quarantine processing, memory promotion/rejection, synaptic pruning |
-| **synthesis** | Every 2 hours | Memory synthesis — discovers cross-memory patterns |
-| **backup** | Every hour | SQLite database backups |
-| **watchdog** | Every 5 min | Monitors services, LaunchAgents, and infrastructure health |
+| **synthesis** | 06:00 daily | Memory synthesis — discovers cross-memory patterns |
+| **watchdog** | Every 30 min | Monitors services, LaunchAgents, and infrastructure health |
 | **auto-close-sessions** | Every 5 min | Cleans stale sessions |
 
-All processes are defined in `src/crons/manifest.json` and auto-synced to your system by `nexo_update`. On macOS they run via LaunchAgents; on Linux via systemd user timers (or crontab fallback). Personal crons (your own scripts) are never touched by the sync. If your Mac was asleep during a scheduled process, the catch-up script re-runs everything in order when it wakes.
+Core processes are defined in `src/crons/manifest.json` and auto-synced to your system by `nexo_update`. On macOS they run via LaunchAgents; on Linux via systemd user timers. `tcc-approve`, `prevent-sleep`, and `backup` are platform/personal helpers — not in the manifest but listed above for completeness. Personal crons (your own scripts) are never touched by the sync. If your Mac was asleep during a scheduled process, the catch-up script re-runs everything in order when it wakes.
 
 ## Deep Sleep v2 — Overnight Learning (v2.1.0)
 

package/bin/nexo-brain.js

@@ -54,7 +54,7 @@ function log(msg) {
 
 // ══════════════════════════════════════════════════════════════════════════════
 // CORE PROCESS & HOOK DEFINITIONS
-// All 13 nightly/periodic processes and all 7 core hooks that make NEXO functional.
+// All 13 nightly/periodic processes and all 8 core hooks that make NEXO functional.
 // ══════════════════════════════════════════════════════════════════════════════
 
 /**
@@ -105,33 +105,36 @@ const ALL_PROCESSES = [
 ];
 
 /**
- * Complete definition of all 7 core hooks.
+ * Complete definition of all 8 core hooks.
  * event: Claude Code hook event name
  * matcher: glob matcher for the hook
  * script: script filename inside NEXO_HOME/hooks/ (or a raw command template)
  * key: unique identifier to detect if already registered (avoids duplicates)
+ * timeout: seconds before Claude Code kills the hook (prevents hangs)
  */
 const ALL_CORE_HOOKS = [
   { event: "SessionStart", key: "session-start-ts", commandTemplate: (nexoHome) =>
       `date +%s > ${path.join(nexoHome, "operations", ".session-start-ts")}`,
-    purpose: "Session timing" },
+    timeout: 2, purpose: "Session timing" },
+  { event: "SessionStart", key: "daily-briefing-check.sh", script: "daily-briefing-check.sh",
+    timeout: 5, purpose: "Briefing schedule check" },
   { event: "SessionStart", key: "session-start.sh", script: "session-start.sh",
-    purpose: "Briefing + context" },
+    timeout: 35, purpose: "Briefing + context" },
   { event: "Stop", key: "session-stop.sh", script: "session-stop.sh",
-    purpose: "POSTMORTEM — the most important" },
+    timeout: 10, purpose: "POSTMORTEM — the most important" },
   { event: "PostToolUse", key: "capture-tool-logs.sh", script: "capture-tool-logs.sh",
-    purpose: "Operation capture" },
+    timeout: 5, purpose: "Operation capture" },
   { event: "PostToolUse", key: "inbox-hook.sh", script: "inbox-hook.sh",
-    purpose: "Inter-session messaging" },
+    timeout: 5, purpose: "Inter-session messaging" },
   { event: "PreCompact", key: "pre-compact.sh", script: "pre-compact.sh",
-    purpose: "Memory preservation" },
+    timeout: 10, purpose: "Memory preservation" },
   { event: "PostCompact", key: "post-compact.sh", script: "post-compact.sh",
-    purpose: "Memory restoration" },
+    timeout: 10, purpose: "Memory restoration" },
 ];
 
 /**
- * Register all 7 core hooks in settings.hooks.
- * Additive: adds missing hooks, never removes user's custom ones.
+ * Register all 8 core hooks in settings.hooks.
+ * Additive + auto-migrate: adds missing hooks, updates stale paths, never removes user's custom ones.
  */
 function registerAllCoreHooks(settings, hooksDir, nexoHome) {
   if (!settings.hooks) settings.hooks = {};
@@ -143,13 +146,7 @@ function registerAllCoreHooks(settings, hooksDir, nexoHome) {
   for (const hook of ALL_CORE_HOOKS) {
     if (!settings.hooks[hook.event]) settings.hooks[hook.event] = [];
 
-    // Check if this specific hook is already registered (by key)
-    const alreadyExists = settings.hooks[hook.event].some(
-      (h) => h.command && h.command.includes(hook.key)
-    );
-    if (alreadyExists) continue;
-
-    // Build the command
+    // Build the canonical command for this hook
     let command;
     if (hook.commandTemplate) {
       command = hook.commandTemplate(nexoHome);
@@ -157,10 +154,40 @@ function registerAllCoreHooks(settings, hooksDir, nexoHome) {
       command = `NEXO_HOME=${nexoHome} bash ${path.join(hooksDir, hook.script)}`;
     }
 
-    settings.hooks[hook.event].push({
-      type: "command",
-      command: command,
-    });
+    // Claude Code settings.hooks supports two formats:
+    //   Flat:   [{type:"command", command:"..."}]
+    //   Nested: [{matcher:"*", hooks:[{type:"command", command:"..."}]}]
+    // We need to search and update in both formats.
+    let found = false;
+
+    for (const entry of settings.hooks[hook.event]) {
+      if (entry.hooks && Array.isArray(entry.hooks)) {
+        // Nested format: {matcher, hooks: [...]}
+        const subIdx = entry.hooks.findIndex(
+          (h) => h.command && h.command.includes(hook.key)
+        );
+        if (subIdx !== -1) {
+          const existing = entry.hooks[subIdx];
+          if (existing.command !== command) existing.command = command;
+          if (hook.timeout && !existing.timeout) existing.timeout = hook.timeout;
+          found = true;
+          break;
+        }
+      } else if (entry.command && entry.command.includes(hook.key)) {
+        // Flat format: {type:"command", command:"..."}
+        if (entry.command !== command) entry.command = command;
+        if (hook.timeout && !entry.timeout) entry.timeout = hook.timeout;
+        found = true;
+        break;
+      }
+    }
+
+    if (!found) {
+      // Hook missing — add it in flat format (Claude Code accepts both)
+      const newEntry = { type: "command", command };
+      if (hook.timeout) newEntry.timeout = hook.timeout;
+      settings.hooks[hook.event].push(newEntry);
+    }
   }
 }
 
@@ -649,7 +676,7 @@ async function main() {
         }
         log("  Scripts updated.");
 
-        // Register ALL 7 core hooks in settings.json (additive — don't remove user's custom hooks)
+        // Register ALL 8 core hooks in settings.json (additive — don't remove user's custom hooks)
         let settings = {};
         if (fs.existsSync(CLAUDE_SETTINGS)) {
           try { settings = JSON.parse(fs.readFileSync(CLAUDE_SETTINGS, "utf8")); } catch {}
@@ -659,7 +686,7 @@ async function main() {
         registerAllCoreHooks(settings, migHooksDest, NEXO_HOME);
         fs.mkdirSync(path.dirname(CLAUDE_SETTINGS), { recursive: true });
         fs.writeFileSync(CLAUDE_SETTINGS, JSON.stringify(settings, null, 2));
-        log("  All 7 core hooks registered in Claude Code settings.");
+        log("  All 8 core hooks registered in Claude Code settings.");
 
         // Regenerate ALL 13 LaunchAgents / systemd timers
         const migSchedule = loadOrCreateSchedule(NEXO_HOME);
@@ -1741,7 +1768,7 @@ ${doScan ? `- Stack: ${Object.keys(profileData.code.languages || {}).slice(0, 5)
     },
   };
 
-  // Configure ALL 7 core hooks for session capture (Sensory Register)
+  // Configure ALL 8 core hooks for session capture (Sensory Register)
   if (!settings.hooks) settings.hooks = {};
 
   // Hook scripts already copied above — just reference the dest dir
@@ -1752,7 +1779,7 @@ ${doScan ? `- Stack: ${Object.keys(profileData.code.languages || {}).slice(0, 5)
   const settingsDir = path.dirname(CLAUDE_SETTINGS);
   fs.mkdirSync(settingsDir, { recursive: true });
   fs.writeFileSync(CLAUDE_SETTINGS, JSON.stringify(settings, null, 2));
-  log("MCP server + 7 core hooks configured in Claude Code settings.");
+  log("MCP server + 8 core hooks configured in Claude Code settings.");
 
   // Step 7: Create schedule.json (only on fresh install) and install ALL 13 processes
   log("Setting up automated processes...");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexo-brain",
-  "version": "2.1.0",
+  "version": "2.3.0",
   "mcpName": "io.github.wazionapps/nexo",
   "description": "NEXO — Cognitive co-operator for Claude Code. Memory, emotional intelligence, overnight learning (Deep Sleep), cron management, trust scoring, and adaptive calibration.",
   "bin": {