eagle-mem 4.1.1 → 4.2.0

package/hooks/session-start.sh

@@ -37,6 +37,18 @@ eagle_log "INFO" "SessionStart: session=$session_id project=$project source=$sou
 eagle_upsert_session "$session_id" "$project" "$cwd" "$model" "$source_type"
 eagle_abandon_stale_sessions "$session_id"
 
+# ─── Reset turn counter on compact/clear ─────────────────
+
+case "$source_type" in
+    compact|clear)
+        echo "0" > "$EAGLE_MEM_DIR/.turn-counter.${session_id}" 2>/dev/null
+        rm -f "$EAGLE_MEM_DIR/.context-pressure" 2>/dev/null
+        ;;
+    startup)
+        echo "0" > "$EAGLE_MEM_DIR/.turn-counter.${session_id}" 2>/dev/null
+        ;;
+esac
+
 # ─── Background automation (non-blocking) ────────────────
 
 eagle_sessionstart_auto_provision "$project" "$cwd" "$SCRIPTS_DIR"
@@ -46,6 +58,7 @@ eagle_sessionstart_auto_curate "$project" "$SCRIPTS_DIR"
 find "$EAGLE_MEM_DIR/read-tracker" -type f -mtime +1 -delete 2>/dev/null &
 find "$EAGLE_MEM_DIR/mod-tracker" -type f -mtime +1 -delete 2>/dev/null &
 find "$EAGLE_MEM_DIR/edit-tracker" -type f -mtime +1 -delete 2>/dev/null &
+find "$EAGLE_MEM_DIR" -name ".turn-counter.*" -mtime +1 -delete 2>/dev/null &
 
 # ─── Version check (non-blocking) ────────────────────────
 

package/hooks/stop.sh

@@ -127,6 +127,12 @@ fi
 # ─── LLM enrichment: fill in decisions/gotchas/key_files ─────
 # Check both local vars (from eagle-summary block) AND existing DB enrichment.
 # Skip LLM call if either source already has enrichment data.
+# Exception: under context pressure, force re-enrichment for richest summary.
+
+context_pressure=0
+if [ -f "$EAGLE_MEM_DIR/.context-pressure" ]; then
+    context_pressure=1
+fi
 
 existing_enrichment=""
 if [ -z "$decisions" ] && [ -z "$gotchas" ] && [ -z "$key_files" ]; then
@@ -134,7 +140,7 @@ if [ -z "$decisions" ] && [ -z "$gotchas" ] && [ -z "$key_files" ]; then
     existing_enrichment=$(eagle_db "SELECT decisions||gotchas||key_files FROM summaries WHERE session_id='$s_esc';")
 fi
 
-if [ -z "$decisions" ] && [ -z "$gotchas" ] && [ -z "$key_files" ] && [ -z "$existing_enrichment" ]; then
+if [ -z "$decisions" ] && [ -z "$gotchas" ] && [ -z "$key_files" ] && { [ -z "$existing_enrichment" ] || [ "$context_pressure" -eq 1 ]; }; then
     provider=$(eagle_config_get "provider" "type" "none" 2>/dev/null)
     if [ "$provider" != "none" ] && [ -n "$text_content" ]; then
         excerpt=$(echo "$text_content" | tail -c 2000)

package/hooks/user-prompt-submit.sh

@@ -87,6 +87,35 @@ if [ "${has_chunks:-0}" -gt 0 ]; then
     fi
 fi
 
+# ─── Context pressure detection (turn counter since last compact) ──
+
+if [ -n "$session_id" ] && eagle_validate_session_id "$session_id"; then
+    counter_file="$EAGLE_MEM_DIR/.turn-counter.${session_id}"
+    turn_count=0
+    [ -f "$counter_file" ] && turn_count=$(cat "$counter_file" 2>/dev/null | tr -d '[:space:]')
+    turn_count=${turn_count:-0}
+    turn_count=$((turn_count + 1))
+    echo "$turn_count" > "$counter_file" 2>/dev/null
+
+    if [ "$turn_count" -ge 30 ]; then
+        context+="
+=== EAGLE MEM — Context Pressure: CRITICAL ($turn_count turns since compact) ===
+IMMEDIATELY emit a detailed <eagle-summary> covering ALL work this session.
+Tell the user to run /compact NOW to avoid losing context.
+"
+        echo "$turn_count" > "$EAGLE_MEM_DIR/.context-pressure"
+    elif [ "$turn_count" -ge 20 ]; then
+        context+="
+=== EAGLE MEM — Context Pressure: HIGH ($turn_count turns since compact) ===
+Include a thorough <eagle-summary> in your next response — capture all decisions, gotchas, and learned context before compaction.
+Suggest the user run /compact to free context for continued work.
+"
+        echo "$turn_count" > "$EAGLE_MEM_DIR/.context-pressure"
+    else
+        rm -f "$EAGLE_MEM_DIR/.context-pressure" 2>/dev/null
+    fi
+fi
+
 [ -z "$context" ] && exit 0
 
 context+="

package/lib/common.sh

@@ -157,3 +157,42 @@ eagle_collect_files() {
             | sed 's|^\./||') > "$output_file"
     fi
 }
+
+eagle_patch_claude_md() {
+    local claude_md="$HOME/.claude/CLAUDE.md"
+    local marker="## Eagle Mem — Persistent Memory"
+
+    if [ -f "$claude_md" ] && grep -qF "$marker" "$claude_md" 2>/dev/null; then
+        return 1
+    fi
+
+    mkdir -p "$HOME/.claude"
+
+    cat >> "$claude_md" << 'EAGLE_MD'
+
+---
+
+## Eagle Mem — Persistent Memory
+
+Eagle Mem hooks are active in every project. SessionStart injects context (overview, recent sessions, memories, tasks, core files). Stop captures session summaries. PostToolUse mirrors memories/plans/tasks.
+
+**Rule:** Before your final response in every session, emit an `<eagle-summary>` block so the Stop hook can capture a rich summary instead of just heuristics.
+
+```
+<eagle-summary>
+request: [what user asked] | completed: [what shipped] | learned: [non-obvious discoveries]
+next_steps: [concrete actions] | decisions: [choice — why] | gotchas: [what surprised]
+key_files: [path — role] | files_read: [...] | files_modified: [...]
+</eagle-summary>
+```
+
+**Why:** Without this block, summaries degrade to "(auto-captured)" with no decisions, gotchas, or learned context. Rich summaries are what make future sessions useful.
+
+**How to apply:**
+- Emit `<eagle-summary>` before your final text response, every session
+- When Eagle Mem injects context at SessionStart, attribute it: "Eagle Mem recalls:"
+- Do not revert decisions surfaced by PostToolUse without asking the user
+- Never put raw secrets in the summary — Eagle Mem redacts but defense in depth
+- If you contradict a loaded memory, update the memory file
+EAGLE_MD
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eagle-mem",
-  "version": "4.1.1",
+  "version": "4.2.0",
   "description": "Persistent memory for Claude Code — SQLite + FTS5, no daemon, no bloat",
   "bin": {
     "eagle-mem": "bin/eagle-mem"

package/scripts/install.sh

@@ -271,6 +271,14 @@ else
     eagle_ok "Config ${DIM}(already exists)${RESET}"
 fi
 
+# ─── Patch CLAUDE.md with Eagle Mem instructions ─────────
+
+if eagle_patch_claude_md; then
+    eagle_ok "CLAUDE.md ${DIM}(eagle-summary instructions added)${RESET}"
+else
+    eagle_ok "CLAUDE.md ${DIM}(already has Eagle Mem section)${RESET}"
+fi
+
 # ─── Save installed version ───────────────────────────────
 
 version=$(jq -r .version "$PACKAGE_DIR/package.json" 2>/dev/null || echo "unknown")

package/scripts/update.sh

@@ -114,6 +114,14 @@ else
     eagle_ok "Project names up to date"
 fi
 
+# ─── Patch CLAUDE.md with Eagle Mem instructions ─────────
+
+if eagle_patch_claude_md; then
+    eagle_ok "CLAUDE.md updated ${DIM}(eagle-summary instructions added)${RESET}"
+else
+    eagle_ok "CLAUDE.md up to date"
+fi
+
 # ─── Save installed version ───────────────────────────────
 
 version=$(jq -r .version "$PACKAGE_DIR/package.json" 2>/dev/null || echo "unknown")