eagle-mem 4.6.0 → 4.6.1

package/README.md

@@ -1,11 +1,14 @@
 ```
 ======================================
        Eagle Mem
+  context that survives /compact
 ======================================
 ```
 
 # Eagle Mem
 
+**Context that survives `/compact`.**
+
 ## The Problem
 
 Claude Code starts every session with amnesia. It doesn't remember what you built yesterday, what decisions you made, what files matter, or what broke last time. Every `/compact` wipes context. Every new session is a cold start. You waste tokens re-explaining your project, re-reading files, and watching Claude repeat mistakes you already corrected.
@@ -14,13 +17,13 @@ The longer you work with Claude Code, the worse this gets. Projects accumulate h
 
 ## The Solution
 
-Eagle Mem gives Claude Code persistent memory. Every session starts with context from previous sessions — summaries, decisions, memories, tasks, project overviews, and relevant code — injected automatically via hooks. No commands to run, no prompts to write. It just works.
+Eagle Mem is a recall layer for Claude Code. Every session starts with context from previous sessions — summaries, decisions, memories, tasks, project overviews, and relevant code — injected automatically via hooks. No commands to run, no prompts to write. It just works.
 
 **Zero per-instance overhead.** No daemon, no vector DB, no MCP server. Just bash scripts, sqlite3 (WAL mode, FTS5 full-text search), and jq.
 
 ```
 ======================================
-       Eagle Mem Loaded
+       Eagle Mem Recall Ready
 ======================================
  Project      | my-app
  Sessions     | 42 (18 with summaries)
@@ -57,7 +60,7 @@ Six hooks fire automatically at different points in Claude Code's lifecycle:
 | **SessionStart** | startup, resume, clear, compact | Injects overview, summaries, memories, tasks, core files, working set. Auto-provisions new projects (scan, index). |
 | **PreToolUse** | before Bash, Read, Edit, Write | Surfaces guardrails and decisions before edits. Rewrites noisy commands (learned rules). Detects redundant reads, nudges co-edit partners, detects stuck loops. |
 | **UserPromptSubmit** | user sends a message | FTS5 search across past sessions and indexed code for relevant context |
-| **PostToolUse** | after tool calls | Records file touches, mirrors memory/plan/task writes, surfaces decision history on reads |
+| **PostToolUse** | after tool calls | Records file touches, mirrors memory/plan/task writes, surfaces decision history and feature impacts on reads, stale memory warnings on edits |
 | **Stop** | Claude's turn ends | Extracts `<eagle-summary>` blocks for rich session summaries |
 | **SessionEnd** | session closes | Re-syncs tasks, marks session completed |
 
@@ -91,6 +94,7 @@ Eagle Mem prevents Claude from repeating past mistakes:
 - **Guardrails** — file-level rules (manual or curator-discovered) that fire before every Edit/Write
 - **Feature verification** — tracks features with smoke tests and dependencies; reminds you to verify on `git push`
 - **Gotcha surfacing** — past surprises and gotchas are surfaced when editing related files
+- **Stale memory detection** — warns when edits may contradict stored memories
 
 ## Commands
 
@@ -148,7 +152,10 @@ Single SQLite database at `~/.eagle-mem/memory.db` (WAL mode, FTS5 full-text sea
 | `command_rules` | Curator-learned command output rules |
 | `file_hints` | Curator-learned file access patterns (co-edit pairs, hot files) |
 | `guardrails` | File-level regression rules (manual or curator-discovered) |
-| `features` | Feature tracking with smoke tests and dependencies |
+| `features` | Feature tracking with names and descriptions |
+| `feature_files` | Files belonging to each feature |
+| `feature_dependencies` | Inter-feature dependency relationships |
+| `feature_smoke_tests` | Smoke test definitions for feature verification |
 | `eagle_meta` | Internal metadata (last scan, last curate, etc.) |
 | `claude_memories` | Mirror of Claude Code auto-memories |
 | `claude_plans` | Mirror of Claude Code plans |

package/hooks/pre-tool-use.sh

@@ -80,7 +80,7 @@ Bash)
                     done <<< "$changed_files"
 
                     if [ -n "$context" ]; then
-                        context="=== Eagle Mem ===
+                        context="=== Eagle Mem: Feature Guardrail ===
 This push affects the following features. After deploy, verify each works and run 'eagle-mem feature verify <name>'.
 ${context}================"
                     fi
@@ -101,19 +101,19 @@ ${context}================"
                 if [ -n "$max_lines" ] && [ "$max_lines" -gt 0 ] 2>/dev/null; then
                     case "$cmd" in
                         *"&&"*|*"||"*|*";"*)
-                            context+="Eagle Mem: '${base_cmd}' produces long output (${reason}). Consider: | head -${max_lines}"
+                            context+="Eagle Mem command rule: '${base_cmd}' produces long output (${reason}). Consider: | head -${max_lines}"
                             ;;
                         *"| head"*|*"| tail"*|*"| wc"*|*"| grep"*|*">"*|*">>"*)
                             ;;
                         *)
                             updated_input=$(echo "$input" | jq --arg cmd "${cmd} | head -${max_lines}" '.tool_input + {"command":$cmd}')
-                            context+="Eagle Mem: '${base_cmd}' output is typically long (${reason}). Piped through head -${max_lines}."
+                            context+="Eagle Mem command rule: '${base_cmd}' output is typically long (${reason}). Piped through head -${max_lines}."
                             ;;
                     esac
                 fi
                 ;;
             summary)
-                context+="Eagle Mem: '${base_cmd}' is typically noisy (${reason}). Consider piping through tail or checking exit code only."
+                context+="Eagle Mem command rule: '${base_cmd}' is typically noisy (${reason}). Consider piping through tail or checking exit code only."
                 ;;
         esac
     fi
@@ -147,12 +147,12 @@ Edit|Write)
                     while IFS= read -r ctx_line; do
                         case "$ctx_line" in
                             GR:*)  gr_block+="  - ${ctx_line#GR:}"$'\n' ;;
-                            DEC:*) context+="=== Eagle Mem ==="$'\n'"Decisions for '${fname}': ${ctx_line#DEC:} — Do not revert without asking."$'\n'"================"$'\n' ;;
-                            GOT:*) context+="=== Eagle Mem ==="$'\n'"Gotchas for '${fname}': ${ctx_line#GOT:}"$'\n'"================"$'\n' ;;
+                            DEC:*) context+="=== Eagle Mem: Decision Recall ==="$'\n'"${fname}: ${ctx_line#DEC:} — Do not revert without asking."$'\n'"================"$'\n' ;;
+                            GOT:*) context+="=== Eagle Mem: Gotcha Recall ==="$'\n'"${fname}: ${ctx_line#GOT:}"$'\n'"================"$'\n' ;;
                         esac
                     done <<< "$edit_ctx"
                     if [ -n "$gr_block" ]; then
-                        context+="=== Eagle Mem ==="$'\n'"Guardrails for '${fname}':"$'\n'"${gr_block}================"$'\n'
+                        context+="=== Eagle Mem: Guardrail ==="$'\n'"${fname}:"$'\n'"${gr_block}================"$'\n'
                     fi
                 fi
                 ;;
@@ -165,9 +165,9 @@ Edit|Write)
                 edit_count=$(grep -cFx -- "$fp" "$edit_tracker" 2>/dev/null)
                 edit_count=${edit_count:-0}
                 if [ "$edit_count" -ge 8 ]; then
-                    context+="Eagle Mem: '$(basename "$fp")' has been edited ${edit_count} times this session. You may be stuck — consider stepping back to rethink your approach before making more changes. "
+                    context+="Eagle Mem warning: '$(basename "$fp")' has been edited ${edit_count} times this session. You may be stuck — consider stepping back to rethink your approach before making more changes. "
                 elif [ "$edit_count" -ge 5 ]; then
-                    context+="Eagle Mem: '$(basename "$fp")' has been edited ${edit_count} times this session. If the changes aren't converging, consider a different approach. "
+                    context+="Eagle Mem warning: '$(basename "$fp")' has been edited ${edit_count} times this session. If the changes aren't converging, consider a different approach. "
                 fi
             fi
         fi
@@ -186,7 +186,7 @@ Edit|Write)
                 [ -n "$co_file" ] && partners+="$(basename "$co_file"), "
             done
             partners=${partners%, }
-            context+="Eagle Mem: When you change '$(basename "$fp")' you usually also touch: $partners"
+            context+="Eagle Mem recall: when you change '$(basename "$fp")' you usually also touch: $partners"
         fi
     fi
     ;;
@@ -198,7 +198,7 @@ Read)
         # ─── Read-after-modify detection ──────────────────────
         mod_file="$EAGLE_MEM_DIR/mod-tracker/${session_id}"
         if [ -f "$mod_file" ] && grep -qFx -- "$fp" "$mod_file" 2>/dev/null; then
-            context+="Eagle Mem: '$(basename "$fp")' was just edited/written — the diff is already in context from the tool output. "
+            context+="Eagle Mem recall: '$(basename "$fp")' was just edited/written — the diff is already in context from the tool output. "
         fi
 
         # ─── Read dedup tracker (soft nudge) ──────────────────
@@ -209,7 +209,7 @@ Read)
         read_count=$(grep -cFx -- "$fp" "$tracker_file" 2>/dev/null)
         read_count=${read_count:-0}
         if [ "$read_count" -ge 3 ]; then
-            context+="Eagle Mem: '$(basename "$fp")' has been read ${read_count} times this session. Its contents are likely already in context."
+            context+="Eagle Mem recall: '$(basename "$fp")' has been read ${read_count} times this session. Its contents are likely already in context."
         fi
     fi
     ;;

package/hooks/session-start.sh

@@ -129,7 +129,7 @@ stat_last_display="${stat_last_summary:0:60}"
 [ ${#stat_last_summary} -gt 60 ] && stat_last_display+="..."
 
 eagle_banner="======================================
-       Eagle Mem Loaded
+       Eagle Mem Recall Ready
 ======================================
  Project      | $project
  Sessions     | $stat_sessions ($stat_with_summaries with summaries)"
@@ -151,7 +151,8 @@ context="$eagle_banner
 
 if [ -n "$update_notice" ]; then
     context+="
-=== $update_notice ===
+=== Eagle Mem: Update Available ===
+$update_notice
 "
 fi
 
@@ -163,12 +164,12 @@ if [ -n "$overview" ]; then
         overview="${overview:0:497}..."
     fi
     context+="
-=== Overview ===
+=== Eagle Mem: Project Overview ===
 $overview
 "
 else
     context+="
-=== New Project ===
+=== Eagle Mem: New Project ===
 No overview yet — auto-scan is running. Run /eagle-mem-overview for a richer briefing.
 "
 fi
@@ -185,7 +186,7 @@ recent=$(eagle_get_recent_summaries "$project" "$_summary_limit")
 
 if [ -n "$recent" ]; then
     context+="
-=== Recent Sessions ===
+=== Eagle Mem: Recent Recall ===
 "
     while IFS='|' read -r request completed learned next_steps created_at decisions gotchas key_files; do
         [ -z "$request" ] && [ -z "$completed" ] && continue
@@ -220,7 +221,7 @@ memories=$(eagle_db "SELECT memory_name, memory_type, description, file_path, up
     LIMIT 5;")
 if [ -n "$memories" ]; then
     context+="
-=== Memories ===
+=== Eagle Mem: Stored Memories ===
 "
     while IFS='|' read -r mname mtype mdesc _fpath _updated days_ago; do
         [ -z "$mname" ] && continue
@@ -244,7 +245,7 @@ fi
 plans=$(eagle_list_claude_plans "$project" 3)
 if [ -n "$plans" ]; then
     context+="
-=== Plans ===
+=== Eagle Mem: Plans ===
 "
     while IFS='|' read -r ptitle _pproj _fpath _updated; do
         [ -z "$ptitle" ] && continue
@@ -265,7 +266,7 @@ synced_tasks=$(eagle_db "SELECT subject, status, blocked_by FROM claude_tasks
     LIMIT 10;")
 if [ -n "$synced_tasks" ]; then
     context+="
-=== Tasks ===
+=== Eagle Mem: Tasks ===
 "
     while IFS='|' read -r tsubject tstatus tblocked; do
         [ -z "$tsubject" ] && continue
@@ -283,7 +284,8 @@ fi
 hot_files=$(eagle_get_hot_files "$project")
 if [ -n "$hot_files" ]; then
     context+="
-=== Core Files (frequently read — re-read sparingly if unchanged) ===
+=== Eagle Mem: Core Files ===
+Frequently read — re-read sparingly if unchanged.
 "
     IFS=',' read -ra hf_arr <<< "$hot_files"
     for hf in "${hf_arr[@]}"; do
@@ -298,7 +300,8 @@ if [ "$source_type" = "compact" ] || [ "$source_type" = "clear" ]; then
     working_set=$(eagle_get_working_set "$session_id")
     if [ -n "$working_set" ]; then
         context+="
-=== Working Set (files you were modifying before compact) ===
+=== Eagle Mem: Working Set ===
+Files you were modifying before compact.
 "
         while IFS='|' read -r ws_path ws_edits; do
             [ -z "$ws_path" ] && continue
@@ -312,12 +315,12 @@ fi
 
 if [ "$source_type" = "compact" ] || [ "$source_type" = "clear" ]; then
     context+="
-=== Eagle Mem ===
+=== Eagle Mem: Active ===
 Memory active. Attribute recalled context to Eagle Mem. Do not revert PostToolUse-surfaced decisions without asking. Emit <eagle-summary> before final response.
 "
 else
     context+="
-=== Eagle Mem ===
+=== Eagle Mem: Active ===
 Memory active for '$project'. Scan, index, prune, and self-learning run automatically — never ask the user to run these. Attribute recalled context: \"Eagle Mem recalls:\" Do not revert PostToolUse-surfaced decisions without user request. No raw secrets in summaries. If you contradict a loaded memory, update the memory file.
 
 Before your final response, emit:

package/hooks/user-prompt-submit.sh

@@ -41,14 +41,14 @@ if [ -n "$session_id" ] && eagle_validate_session_id "$session_id"; then
 
     if [ "$turn_count" -ge 30 ]; then
         context+="
-=== EAGLE MEM — Context Pressure: CRITICAL ($turn_count turns since compact) ===
+=== 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) ===
+=== 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.
 "
@@ -81,7 +81,7 @@ fts_query=$(echo "$user_prompt" | tr -cs '[:alnum:]' ' ' | tr '[:upper:]' '[:low
 results=$(eagle_search_summaries "$fts_query" "$project" 3)
 
 if [ -n "$results" ]; then
-    context+="=== Eagle Mem — Relevant Memory ===
+    context+="=== Eagle Mem: Relevant Recall ===
 "
     while IFS='|' read -r req completed learned _next_steps created_at _proj decisions gotchas key_files; do
         [ -z "$req" ] && [ -z "$completed" ] && continue
@@ -106,7 +106,7 @@ if [ "${has_chunks:-0}" -gt 0 ]; then
     code_results=$(eagle_search_code_chunks "$fts_query" "$project" 5)
 
     if [ -n "$code_results" ]; then
-        context+="=== Eagle Mem — Relevant Code ===
+        context+="=== Eagle Mem: Relevant Code ===
 "
         while IFS='|' read -r fpath sline eline lang; do
             [ -z "$fpath" ] && continue
@@ -123,7 +123,7 @@ fi
 context+="
 IMPORTANT: When Eagle Mem finds relevant memories or code for the user's prompt, briefly mention it at the start of your response: \"Eagle Mem recalled N relevant sessions\" or \"Eagle Mem found related code in [files]\". One line max — then proceed with the answer.
 
-=== Eagle Mem (persistent memory across sessions) ===
+=== Eagle Mem: Persistent Memory ===
 "
 
 echo "$context"

package/lib/hooks-posttool.sh

@@ -75,7 +75,7 @@ eagle_posttool_stale_hint() {
                                 local stale_hit
                                 stale_hit=$(eagle_search_stale_memories "$project" "$fts_query")
                                 if [ -n "$stale_hit" ]; then
-                                    local stale_msg="=== Eagle Mem ===
+                                    local stale_msg="=== Eagle Mem: Memory Check ===
 Memory '${stale_hit}' may reference '${fname}'. If your edit contradicts it, update the memory.
 ================"
                                     jq -nc --arg ctx "$stale_msg" '{"hookSpecificOutput":{"hookEventName":"PostToolUse","additionalContext":$ctx}}'
@@ -108,8 +108,8 @@ eagle_posttool_decision_surface() {
                                 local decision_hit
                                 decision_hit=$(eagle_search_decisions_for_file "$project" "$fts_query")
                                 if [ -n "$decision_hit" ]; then
-                                    read_context+="=== Eagle Mem ===
-Decision history for '${fname}': ${decision_hit} — Do not revert without explicit user request.
+                                    read_context+="=== Eagle Mem: Decision Recall ===
+${fname}: ${decision_hit} — Do not revert without explicit user request.
 ================
 "
                                 fi
@@ -121,7 +121,7 @@ Decision history for '${fname}': ${decision_hit} — Do not revert without expli
                         if [ -n "$feature_hit" ]; then
                             while IFS='|' read -r feat_name feat_desc feat_verified _role feat_deps feat_other_files feat_smoke; do
                                 [ -z "$feat_name" ] && continue
-                                read_context+="=== Eagle Mem ===
+                                read_context+="=== Eagle Mem: Feature Guardrail ===
 '${fname}' is part of feature '${feat_name}'"
                                 [ -n "$feat_desc" ] && read_context+=" ($feat_desc)"
                                 read_context+="."

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "eagle-mem",
-  "version": "4.6.0",
-  "description": "Persistent memory for Claude Code — SQLite + FTS5, no daemon, no bloat",
+  "version": "4.6.1",
+  "description": "Context that survives /compact for Claude Code — SQLite + FTS5, no daemon, no bloat",
   "bin": {
     "eagle-mem": "bin/eagle-mem"
   },

package/scripts/help.sh

@@ -13,7 +13,7 @@ version=$(jq -r .version "$PACKAGE_DIR/package.json" 2>/dev/null || echo "unknow
 eagle_banner
 
 echo -e "  ${BOLD}Eagle Mem${RESET} ${DIM}v${version}${RESET}"
-echo -e "  ${DIM}Persistent memory for Claude Code${RESET}"
+echo -e "  ${DIM}Context that survives /compact for Claude Code${RESET}"
 echo ""
 echo -e "  ${BOLD}Commands:${RESET}"
 echo -e "    ${CYAN}install${RESET}     First-time setup: hooks, database, skills"

package/scripts/install.sh

@@ -250,17 +250,11 @@ else
         eagle_dim "  Statusline detected: $sl_file"
         eagle_dim "  To add Eagle Mem, add this snippet before your ASSEMBLE section:"
         echo ""
-        eagle_dim "    # ── EAGLE MEM ──"
+        eagle_dim "    # ── Eagle Mem ──"
         eagle_dim "    em_section=\"\""
-        eagle_dim "    em_db=\"\$HOME/.eagle-mem/memory.db\""
-        eagle_dim "    if [ -f \"\$em_db\" ]; then"
-        eagle_dim "      em_proj=\$(basename \"\$project_dir\" | sed \"s/'/''/g\")"
-        eagle_dim "      em_cnt=\$(echo \".headers off"
-        eagle_dim "    SELECT COUNT(*) FROM sessions WHERE project = '\${em_proj}';\" | sqlite3 \"\$em_db\" 2>/dev/null | tr -d '[:space:]')"
-        eagle_dim "      em_mem=\$(echo \".headers off"
-        eagle_dim "    SELECT COUNT(*) FROM claude_memories WHERE project = '\${em_proj}';\" | sqlite3 \"\$em_db\" 2>/dev/null | tr -d '[:space:]')"
-        eagle_dim "      em_cnt=\${em_cnt:-0}; em_mem=\${em_mem:-0}"
-        eagle_dim "      em_section=\$(printf \"%bEagle Mem%b %b%s%b ses %b%s%b mem\" \"\$CYAN\" \"\$R\" \"\$WHT\" \"\$em_cnt\" \"\$DIM\" \"\$WHT\" \"\$em_mem\" \"\$R\")"
+        eagle_dim "    if [ -f \"\$HOME/.eagle-mem/scripts/statusline-em.sh\" ]; then"
+        eagle_dim "      source \"\$HOME/.eagle-mem/scripts/statusline-em.sh\""
+        eagle_dim "      em_section=\$(eagle_mem_statusline \"\$project_dir\")"
         eagle_dim "    fi"
         echo ""
         eagle_ok "Statusline ${DIM}(manual patch needed — instructions above)${RESET}"

package/scripts/style.sh

@@ -17,11 +17,13 @@ TICK="${GREEN}✓${RESET}"
 CROSS="${RED}✗${RESET}"
 ARROW="${CYAN}→${RESET}"
 DOT="${DIM}·${RESET}"
+EAGLE_RULE="======================================"
+EAGLE_TAGLINE="context that survives /compact"
 
 eagle_header() {
     echo ""
-    echo -e "  ${BOLD}Eagle Mem${RESET}  ${DIM}$1${RESET}"
-    echo -e "  ${DIM}─────────────────────────────────────${RESET}"
+    echo -e "  ${CYAN}${BOLD}Eagle Mem${RESET}  ${DIM}$1${RESET}"
+    echo -e "  ${CYAN}${EAGLE_RULE}${RESET}"
     echo ""
 }
 
@@ -43,9 +45,10 @@ eagle_footer() {
 }
 
 eagle_banner() {
-    echo -e "  ${CYAN}======================================${RESET}"
+    echo -e "  ${CYAN}${EAGLE_RULE}${RESET}"
     echo -e "  ${CYAN}${BOLD}       Eagle Mem${RESET}"
-    echo -e "  ${CYAN}======================================${RESET}"
+    echo -e "  ${DIM}       ${EAGLE_TAGLINE}${RESET}"
+    echo -e "  ${CYAN}${EAGLE_RULE}${RESET}"
     echo ""
 }