nexo-brain 1.5.2 → 1.5.3

package/README.md

@@ -130,10 +130,22 @@ Like a human brain, NEXO Brain has automated processes that run while you're not
 |------|---------|---------------|
 | 03:00 | Decay + memory consolidation + merge duplicates + dreaming | Deep sleep consolidation |
 | 04:00 | Clean expired data, prune redundant memories | Synaptic pruning |
+| 04:30 | **Deep Sleep** — analyze full session transcripts for uncaptured corrections, protocol violations, missed commitments | REM sleep review |
 | 07:00 | Self-audit, health checks, metrics | Waking up + orientation |
 | 23:30 | Process day's events, extract patterns | Pre-sleep reflection |
 | Boot | Catch-up: run anything missed while computer was off | -- |
 
+#### Deep Sleep (v1.5.2)
+
+Deep Sleep reads your **complete session transcripts** (not just the diary summary) and finds what the agent missed during the day:
+
+- **Uncaptured corrections** — user corrections the agent didn't save as learnings
+- **Protocol violations** — guard_check skipped, trust not adjusted, change_log omitted
+- **Missed commitments** — things mentioned but never tracked as followups
+- **Quality issues** — agent declaring "done" when work wasn't complete
+
+Uses Claude CLI in `--bare` mode (no hooks, no CLAUDE.md interference). Catch-up system re-runs yesterday if the Mac was off.
+
 If your Mac was asleep during any scheduled process, NEXO Brain catches up in order when it wakes.
 
 ## Cognitive Cortex

package/package.json

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

package/src/scripts/nexo-deep-sleep.sh

@@ -1,14 +1,13 @@
 #!/bin/bash
-# NEXO Deep Sleep — Complete overnight session transcript analysis
-# Reads ALL Claude Code session transcripts from the day, analyzes with
-# Claude CLI (bare mode), and applies findings as feedback memories.
+# NEXO Deep Sleep — Complete overnight session analysis
+# Runs at 4:30 AM via LaunchAgent
+# Reads ALL session transcripts from the day, analyzes with Claude CLI,
+# and applies findings (learnings, feedbacks, followups, trust adjustments)
 #
 # Features:
 # - Catch-up: if yesterday was missed (Mac off/asleep), runs it first
-# - Uses --bare mode to avoid loading NEXO hooks during analysis
-# - Requires ANTHROPIC_API_KEY env var or ~/.claude/anthropic-api-key.txt
-#
-# Install: Add as LaunchAgent for daily execution (recommended: 4:30 AM)
+# - Logs to ~/claude/logs/deep-sleep.log
+# - Marks completion in .last-run for watchdog monitoring
 
 set -euo pipefail
 
@@ -26,9 +25,11 @@ run_analysis() {
     local DATE="$1"
     log "=== Deep Sleep starting for $DATE ==="
 
+    # Step 1: Collect transcripts
     log "Step 1: Collecting transcripts for $DATE..."
     python3 "$SCRIPT_DIR/deep-sleep/collect_transcripts.py" "$DATE" 2>&1 | tee -a "$LOG_DIR/deep-sleep.log"
 
+    # Check if transcripts were found
     if [ ! -f "$DEEP_SLEEP_DIR/$DATE-transcripts.json" ]; then
         log "No transcripts file generated for $DATE. Skipping."
         return 0
@@ -40,6 +41,7 @@ run_analysis() {
         return 0
     fi
 
+    # Step 2: Analyze with Claude CLI
     log "Step 2: Analyzing $SESSIONS sessions with Claude CLI..."
     python3 "$SCRIPT_DIR/deep-sleep/analyze_session.py" "$DATE" 2>&1 | tee -a "$LOG_DIR/deep-sleep.log"
 
@@ -48,6 +50,7 @@ run_analysis() {
         return 1
     fi
 
+    # Step 3: Apply findings
     log "Step 3: Applying findings for $DATE..."
     python3 "$SCRIPT_DIR/deep-sleep/apply_findings.py" "$DATE" 2>&1 | tee -a "$LOG_DIR/deep-sleep.log"
 
@@ -55,22 +58,24 @@ run_analysis() {
     return 0
 }
 
-# --- Catch-up: check if yesterday was missed ---
+# --- Catch-up: check if the day before yesterday was missed ---
 YESTERDAY=$(date -v-1d +%Y-%m-%d 2>/dev/null || date -d "yesterday" +%Y-%m-%d 2>/dev/null)
+DAY_BEFORE=$(date -v-2d +%Y-%m-%d 2>/dev/null || date -d "2 days ago" +%Y-%m-%d 2>/dev/null)
 LAST_RUN=""
 if [ -f "$LAST_RUN_FILE" ]; then
     LAST_RUN=$(cat "$LAST_RUN_FILE")
 fi
 
-if [ -n "$YESTERDAY" ] && [ "$LAST_RUN" != "$YESTERDAY" ] && [ "$LAST_RUN" != "$TODAY" ]; then
-    if [ ! -f "$DEEP_SLEEP_DIR/$YESTERDAY-analysis.json" ]; then
-        log "*** CATCH-UP: $YESTERDAY was missed. Running now. ***"
-        run_analysis "$YESTERDAY" || log "Catch-up for $YESTERDAY failed."
+if [ -n "$DAY_BEFORE" ] && [ "$LAST_RUN" != "$DAY_BEFORE" ] && [ "$LAST_RUN" != "$YESTERDAY" ]; then
+    # Day before yesterday wasn't analyzed — catch up
+    if [ ! -f "$DEEP_SLEEP_DIR/$DAY_BEFORE-analysis.json" ]; then
+        log "*** CATCH-UP: $DAY_BEFORE was missed. Running now. ***"
+        run_analysis "$DAY_BEFORE" || log "Catch-up for $DAY_BEFORE failed."
     fi
 fi
 
-# --- Run today's analysis ---
-run_analysis "$TODAY"
+# --- Run yesterday's analysis (main task — at 4:30 AM, today has no sessions yet) ---
+run_analysis "$YESTERDAY"
 
-# Mark completion
-echo "$TODAY" > "$LAST_RUN_FILE"
+# Mark completion with yesterday's date (what we actually analyzed)
+echo "$YESTERDAY" > "$LAST_RUN_FILE"