eagle-mem 3.0.1 → 3.1.0

package/bin/eagle-mem

@@ -30,6 +30,7 @@ case "$command" in
     config)     bash "$SCRIPTS_DIR/config.sh" "$@" ;;
     curate)     bash "$SCRIPTS_DIR/curate.sh" "$@" ;;
     feature)    bash "$SCRIPTS_DIR/feature.sh" "$@" ;;
+    health)     bash "$SCRIPTS_DIR/health.sh" "$@" ;;
     help|--help|-h)
                 bash "$SCRIPTS_DIR/help.sh" ;;
     version|--version|-v|-V)

package/db/016_eagle_meta.sql

@@ -0,0 +1,8 @@
+-- Eagle meta key-value store for system state (curator timestamps, etc.)
+CREATE TABLE IF NOT EXISTS eagle_meta (
+    key TEXT NOT NULL,
+    project TEXT,
+    value TEXT NOT NULL,
+    updated_at TEXT DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    UNIQUE(key, project)
+);

package/hooks/post-tool-use.sh

@@ -2,7 +2,7 @@
 # ═══════════════════════════════════════════════════════════
 # Eagle Mem — PostToolUse hook
 # Fires after every tool use
-# Captures file read/write operations as lightweight observations
+# Captures observations + dispatches to extracted responsibilities
 # ═══════════════════════════════════════════════════════════
 set +e
 
@@ -11,6 +11,7 @@ LIB_DIR="$SCRIPT_DIR/../lib"
 
 . "$LIB_DIR/common.sh"
 . "$LIB_DIR/db.sh"
+. "$LIB_DIR/hooks-posttool.sh"
 
 input=$(eagle_read_stdin)
 [ -z "$input" ] && exit 0
@@ -30,11 +31,15 @@ esac
 [ ! -f "$EAGLE_MEM_DB" ] && exit 0
 
 project=$(eagle_project_from_cwd "$cwd")
+[ -z "$project" ] && exit 0
 
 # Ensure session row exists before inserting observations (FK constraint).
 # PostToolUse can race SessionStart — the session row might not exist yet.
 eagle_upsert_session "$session_id" "$project" "$cwd" "" ""
 
+# ─── Extract observation data from tool call ──────────────
+
+fp=""
 files_read="[]"
 files_modified="[]"
 tool_summary=""
@@ -63,14 +68,12 @@ case "$tool_name" in
         cmd=$(echo "$cmd" | eagle_redact)
         tool_summary="Bash: $cmd"
 
-        # Output metrics
         tool_output=$(echo "$input" | jq -r '.tool_result.stdout // empty' 2>/dev/null)
         if [ -n "$tool_output" ]; then
             output_bytes=${#tool_output}
             output_lines=$(echo "$tool_output" | wc -l | tr -d ' ')
         fi
 
-        # Command category extraction
         first_word=$(echo "$cmd" | awk '{print $1}' | sed 's|.*/||')
         case "$first_word" in
             git|gh) command_category="git" ;;
@@ -95,151 +98,14 @@ case "$tool_name" in
         ;;
 esac
 
-# ─── Claude memory + plan mirror ─────────────────────────
-# Intercept writes to Claude Code's auto-memory and plan files
-case "$tool_name" in
-    Write|Edit)
-        if [ -n "$fp" ]; then
-            # Reject path traversal: bash case `*` matches `/`, so
-            # patterns like projects/*/memory/*.md would match paths
-            # containing /../ segments. Block any path with `..` first.
-            case "$fp" in
-                *..*) ;; # path traversal — skip
-                "$HOME/.claude/projects"/*/memory/*.md)
-                    mem_base=$(basename "$fp")
-                    if [ "$mem_base" != "MEMORY.md" ] && [ -f "$fp" ]; then
-                        eagle_capture_claude_memory "$fp" "$session_id" "$project"
-                    fi
-                    ;;
-                "$HOME/.claude/plans/"*.md)
-                    if [ -f "$fp" ]; then
-                        eagle_capture_claude_plan "$fp" "$session_id" "$project"
-                    fi
-                    ;;
-            esac
-        fi
-        ;;
-esac
-
-# ─── Claude task mirror ─────────────────────────────────
-# Intercept TaskCreate/TaskUpdate and capture the resulting JSON files
-case "$tool_name" in
-    TaskCreate|TaskUpdate)
-        if eagle_validate_session_id "$session_id"; then
-            task_dir="$HOME/.claude/tasks/$session_id"
-            if [ -d "$task_dir" ]; then
-                task_id=$(echo "$input" | jq -r '.tool_input.id // empty')
-                if [ -z "$task_id" ]; then
-                    newest=$(ls -t "$task_dir"/*.json 2>/dev/null | head -1)
-                    [ -n "$newest" ] && [ -f "$newest" ] && eagle_capture_claude_task "$newest" "$session_id" "$project"
-                elif eagle_validate_session_id "$task_id"; then
-                    task_json="$task_dir/$task_id.json"
-                    [ -f "$task_json" ] && eagle_capture_claude_task "$task_json" "$session_id" "$project"
-                fi
-            fi
-        fi
-        ;;
-esac
+# ─── Dispatch to extracted responsibilities ───────────────
 
-# ─── Stale memory hint ──────────────────────────────────
-# After editing a project file, FTS5-search memories for the filename.
-# If a memory mentions this file, remind Claude to check for staleness.
-case "$tool_name" in
-    Write|Edit)
-        if [ -n "$fp" ]; then
-            fname=$(basename "$fp")
-            fname_stem="${fname%.*}"
-            case "$fp" in
-                "$HOME/.claude/"*) ;; # skip Claude config files
-                *)
-                    if [ ${#fname_stem} -ge 3 ]; then
-                        fts_query=$(eagle_fts_sanitize "$fname_stem")
-                        if [ -n "$fts_query" ]; then
-                            fts_esc=$(eagle_sql_escape "$fts_query")
-                            p_esc=$(eagle_sql_escape "$project")
-                            stale_hit=$(eagle_db "SELECT m.memory_name
-                                FROM claude_memories m
-                                JOIN claude_memories_fts f ON f.rowid = m.id
-                                WHERE claude_memories_fts MATCH '$fts_esc'
-                                AND m.project = '$p_esc'
-                                LIMIT 1;")
-                            if [ -n "$stale_hit" ]; then
-                                stale_msg="Eagle Mem: 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}}'
-                            fi
-                        fi
-                    fi
-                    ;;
-            esac
-        fi
-        ;;
-esac
+eagle_posttool_mirror_writes "$tool_name" "$fp" "$session_id" "$project"
+eagle_posttool_mirror_tasks "$tool_name" "$session_id" "$project" "$input"
+eagle_posttool_stale_hint "$tool_name" "$fp" "$project"
+eagle_posttool_decision_surface "$tool_name" "$fp" "$project"
 
-# ─── Decision + feature surfacing on Read ──────────────────
-# When Claude reads a file, surface past decisions and feature pipeline context.
-case "$tool_name" in
-    Read)
-        if [ -n "$fp" ]; then
-            fname=$(basename "$fp")
-            fname_stem="${fname%.*}"
-            read_context=""
-            case "$fp" in
-                "$HOME/.claude/"*) ;; # skip Claude config files
-                *)
-                    p_esc=$(eagle_sql_escape "$project")
-
-                    # Decision history from summaries
-                    if [ ${#fname_stem} -ge 3 ]; then
-                        fts_query=$(eagle_fts_sanitize "$fname_stem")
-                        if [ -n "$fts_query" ]; then
-                            fts_esc=$(eagle_sql_escape "$fts_query")
-                            decision_hit=$(eagle_db "SELECT s.decisions
-                                FROM summaries s
-                                JOIN summaries_fts f ON f.rowid = s.id
-                                WHERE summaries_fts MATCH '$fts_esc'
-                                AND s.project = '$p_esc'
-                                AND s.decisions IS NOT NULL
-                                AND s.decisions != ''
-                                ORDER BY s.created_at DESC
-                                LIMIT 1;")
-                            if [ -n "$decision_hit" ]; then
-                                read_context+="Eagle Mem decision history for '${fname}': ${decision_hit} — Do not revert without explicit user request. "
-                            fi
-                        fi
-                    fi
-
-                    # Feature pipeline context
-                    feature_hit=$(eagle_find_features_for_file "$project" "$fp")
-                    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: '${fname}' is part of feature '${feat_name}'"
-                            [ -n "$feat_desc" ] && read_context+=" ($feat_desc)"
-                            read_context+="."
-                            if [ -n "$feat_verified" ]; then
-                                read_context+=" Last verified: ${feat_verified}."
-                            fi
-                            if [ -n "$feat_deps" ]; then
-                                read_context+=" Dependencies: ${feat_deps}."
-                            fi
-                            if [ -n "$feat_other_files" ]; then
-                                read_context+=" Other files in pipeline: ${feat_other_files}."
-                            fi
-                            if [ -n "$feat_smoke" ]; then
-                                read_context+=" Smoke tests: ${feat_smoke}."
-                            fi
-                            read_context+=" Changes require re-testing after deploy. "
-                        done <<< "$feature_hit"
-                    fi
-
-                    if [ -n "$read_context" ]; then
-                        jq -nc --arg ctx "$read_context" '{"hookSpecificOutput":{"hookEventName":"PostToolUse","additionalContext":$ctx}}'
-                    fi
-                    ;;
-            esac
-        fi
-        ;;
-esac
+# ─── Record observation ──────────────────────────────────
 
 if ! eagle_insert_observation "$session_id" "$project" "$tool_name" "$tool_summary" "$files_read" "$files_modified" "$output_bytes" "$output_lines" "$command_category"; then
     eagle_log "ERROR" "PostToolUse: observation insert failed for session=$session_id tool=$tool_name"

package/hooks/pre-tool-use.sh

@@ -27,7 +27,7 @@ cmd=$(echo "$input" | jq -r '.tool_input.command // empty')
 session_id=$(echo "$input" | jq -r '.session_id // empty')
 cwd=$(echo "$input" | jq -r '.cwd // empty')
 project=$(eagle_project_from_cwd "$cwd")
-p_esc=$(eagle_sql_escape "$project")
+[ -z "$project" ] && exit 0
 
 context=""
 
@@ -35,7 +35,7 @@ context=""
 
 case "$cmd" in
     *"git push"*|*"gh pr create"*)
-        has_features=$(eagle_db "SELECT COUNT(*) FROM features WHERE project = '$p_esc' AND status = 'active';")
+        has_features=$(eagle_count_active_features "$project")
         if [ "${has_features:-0}" -gt 0 ]; then
             changed_files=""
             if [ -n "$cwd" ] && [ -d "$cwd" ]; then
@@ -49,19 +49,8 @@ case "$cmd" in
                     [ -z "$changed_file" ] && continue
                     fname=$(basename "$changed_file")
                     fname_esc=$(eagle_sql_escape "$fname")
-                    fname_like=$(eagle_like_escape "$fname_esc")
-
-                    feature_hits=$(eagle_db "SELECT DISTINCT f.name,
-                        (SELECT GROUP_CONCAT(fst.command, '; ')
-                         FROM feature_smoke_tests fst WHERE fst.feature_id = f.id) as smoke,
-                        (SELECT GROUP_CONCAT(fd.target || ':' || fd.name, ', ')
-                         FROM feature_dependencies fd WHERE fd.feature_id = f.id) as deps,
-                        f.last_verified_at
-                        FROM features f
-                        JOIN feature_files ff ON ff.feature_id = f.id
-                        WHERE f.project = '$p_esc'
-                        AND f.status = 'active'
-                        AND (ff.file_path LIKE '%$fname_like' ESCAPE '\\' OR ff.file_path LIKE '%$fname_like%' ESCAPE '\\');")
+
+                    feature_hits=$(eagle_find_feature_for_push "$project" "$fname_esc")
 
                     while IFS='|' read -r feat_name feat_smoke feat_deps feat_verified; do
                         [ -z "$feat_name" ] && continue
@@ -93,16 +82,8 @@ esac
 
 # Extract the base command for rule matching
 base_cmd=$(echo "$cmd" | awk '{print $1}' | sed 's|.*/||')
-cmd_esc=$(eagle_sql_escape "$base_cmd")
-
-rule=$(eagle_db "SELECT strategy, max_lines, reason
-    FROM command_rules
-    WHERE enabled = 1
-    AND (project = '$p_esc' OR project IS NULL)
-    AND ('$cmd_esc' LIKE pattern OR '$cmd_esc' = pattern)
-    ORDER BY
-        CASE WHEN project IS NOT NULL THEN 0 ELSE 1 END
-    LIMIT 1;")
+
+rule=$(eagle_get_command_rule "$project" "$base_cmd")
 
 if [ -n "$rule" ]; then
     IFS='|' read -r strategy max_lines reason <<< "$rule"

package/hooks/session-end.sh

@@ -2,15 +2,17 @@
 # ═══════════════════════════════════════════════════════════
 # Eagle Mem — SessionEnd hook
 # Fires when the Claude Code session ends
-# Marks the session as completed
+# Marks the session as completed + triggers auto-curate
 # ═══════════════════════════════════════════════════════════
 set +e
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 LIB_DIR="$SCRIPT_DIR/../lib"
+SCRIPTS_DIR="$SCRIPT_DIR/../scripts"
 
 . "$LIB_DIR/common.sh"
 . "$LIB_DIR/db.sh"
+. "$LIB_DIR/provider.sh"
 
 input=$(eagle_read_stdin)
 [ -z "$input" ] && exit 0
@@ -21,11 +23,12 @@ session_id=$(echo "$input" | jq -r '.session_id // empty')
 
 cwd=$(echo "$input" | jq -r '.cwd // empty')
 project=$(eagle_project_from_cwd "$cwd")
+[ -z "$project" ] && exit 0
 
 # Final sweep: re-capture all task files to catch status changes
 # Claude Code may update task status without triggering PostToolUse
 if eagle_validate_session_id "$session_id"; then
-    task_dir="$HOME/.claude/tasks/$session_id"
+    task_dir="$EAGLE_CLAUDE_TASKS_DIR/$session_id"
     if [ -d "$task_dir" ]; then
         for task_file in "$task_dir"/*.json; do
             [ ! -f "$task_file" ] && continue
@@ -41,4 +44,23 @@ eagle_log "INFO" "SessionEnd: session=$session_id marked completed"
 # Prune observations older than 90 days (keeps DB size bounded)
 eagle_prune_observations 90 "$project"
 
+# ─── Auto-curate trigger ─────────────────────────────────
+curator_schedule=$(eagle_config_get "curator" "schedule" "manual")
+if [ "$curator_schedule" = "auto" ]; then
+    provider=$(eagle_config_get "provider" "type" "none")
+    if [ "$provider" != "none" ]; then
+        min_sessions=$(eagle_config_get "curator" "min_sessions" "5")
+        min_sessions=$(eagle_sql_int "$min_sessions")
+
+        last_curated=$(eagle_meta_get "last_curated_at" "$project")
+        since="${last_curated:-1970-01-01T00:00:00Z}"
+
+        sessions_since=$(eagle_count_sessions_since "$project" "$since")
+        if [ "${sessions_since:-0}" -ge "$min_sessions" ]; then
+            eagle_log "INFO" "SessionEnd: auto-curate triggered (${sessions_since} sessions since last curate)"
+            nohup bash "$SCRIPTS_DIR/curate.sh" -p "$project" >> "$EAGLE_MEM_LOG" 2>&1 &
+        fi
+    fi
+fi
+
 exit 0

package/hooks/session-start.sh

@@ -26,6 +26,9 @@ model=$(echo "$input" | jq -r '.model // empty')
 
 project=$(eagle_project_from_cwd "$cwd")
 
+# Skip ephemeral directories (tmp, Downloads, etc.) — no tracking
+[ -z "$project" ] && exit 0
+
 eagle_log "INFO" "SessionStart: session=$session_id project=$project source=$source_type"
 
 eagle_upsert_session "$session_id" "$project" "$cwd" "$model" "$source_type"
@@ -33,10 +36,7 @@ eagle_upsert_session "$session_id" "$project" "$cwd" "$model" "$source_type"
 # ─── Sweep stuck sessions (no activity for 7 days) ─────────
 # Uses last_activity_at (updated by trigger on every observation insert)
 # so long-lived sessions with regular compactions aren't falsely abandoned
-eagle_db "UPDATE sessions SET status = 'abandoned'
-    WHERE status = 'active'
-    AND id != '$(eagle_sql_escape "$session_id")'
-    AND COALESCE(last_activity_at, started_at) < strftime('%Y-%m-%dT%H:%M:%fZ', 'now', '-7 days');"
+eagle_abandon_stale_sessions "$session_id"
 
 # ─── Version check (non-blocking) ────────────────────────────
 
@@ -68,30 +68,27 @@ fi
 
 # ─── Gather stats ───────────────────────────────────────────
 
-p_esc=$(eagle_sql_escape "$project")
-
-stat_sessions=$(eagle_db "SELECT COUNT(*) FROM sessions WHERE project = '$p_esc';")
-stat_summaries=$(eagle_db "SELECT COUNT(*) FROM summaries WHERE project = '$p_esc';")
-stat_memories=$(eagle_db "SELECT COUNT(*) FROM claude_memories WHERE project = '$p_esc';")
-stat_tasks_pending=$(eagle_db "SELECT COUNT(*) FROM claude_tasks WHERE project = '$p_esc' AND status = 'pending';")
-stat_tasks_progress=$(eagle_db "SELECT COUNT(*) FROM claude_tasks WHERE project = '$p_esc' AND status = 'in_progress';")
-stat_tasks_done=$(eagle_db "SELECT COUNT(*) FROM claude_tasks WHERE project = '$p_esc' AND status = 'completed';")
-stat_chunks=$(eagle_db "SELECT COUNT(*) FROM code_chunks WHERE project = '$p_esc';")
-stat_observations=$(eagle_db "SELECT COUNT(*) FROM observations WHERE session_id IN (SELECT id FROM sessions WHERE project = '$p_esc');")
-stat_plans=$(eagle_db "SELECT COUNT(*) FROM claude_plans WHERE project = '$p_esc';")
-stat_last_active=$(eagle_db "SELECT COALESCE(MAX(date(COALESCE(last_activity_at, started_at))), 'never') FROM sessions WHERE project = '$p_esc';")
-stat_last_summary=$(eagle_db "SELECT request FROM summaries WHERE project = '$p_esc' ORDER BY created_at DESC LIMIT 1;")
-
-# Trim to defaults
-stat_sessions="${stat_sessions:-0}"
-stat_summaries="${stat_summaries:-0}"
-stat_memories="${stat_memories:-0}"
-stat_tasks_pending="${stat_tasks_pending:-0}"
-stat_tasks_progress="${stat_tasks_progress:-0}"
-stat_tasks_done="${stat_tasks_done:-0}"
-stat_chunks="${stat_chunks:-0}"
-stat_observations="${stat_observations:-0}"
-stat_plans="${stat_plans:-0}"
+stat_sessions=0; stat_summaries=0; stat_with_summaries=0; stat_memories=0
+stat_tasks_pending=0; stat_tasks_progress=0; stat_tasks_done=0
+stat_chunks=0; stat_observations=0; stat_plans=0
+stat_last_active="never"; stat_last_summary=""
+
+while IFS='|' read -r key val; do
+    case "$key" in
+        sessions)        stat_sessions="$val" ;;
+        summaries)       stat_summaries="$val" ;;
+        with_summaries)  stat_with_summaries="$val" ;;
+        memories)        stat_memories="$val" ;;
+        plans)           stat_plans="$val" ;;
+        tasks_pending)   stat_tasks_pending="$val" ;;
+        tasks_progress)  stat_tasks_progress="$val" ;;
+        tasks_done)      stat_tasks_done="$val" ;;
+        chunks)          stat_chunks="$val" ;;
+        observations)    stat_observations="$val" ;;
+        last_active)     stat_last_active="$val" ;;
+        last_summary)    stat_last_summary="$val" ;;
+    esac
+done <<< "$(eagle_get_project_stats "$project")"
 
 # Build task summary line
 task_parts=""
@@ -117,7 +114,7 @@ eagle_banner="======================================
        Eagle Mem Loaded
 ======================================
  Project      | $project
- Sessions     | $stat_sessions total ($stat_summaries with summaries)
+ Sessions     | $stat_sessions total ($stat_with_summaries with summaries)
  Memories     | $stat_memories stored
  Plans        | $stat_plans saved
  Tasks        | $task_parts
@@ -140,6 +137,15 @@ if [ -n "$update_notice" ]; then
 "
 fi
 
+# Nudge if last session lacked enrichment
+last_enriched=$(eagle_last_session_enriched "$project")
+if [ "${last_enriched:-1}" = "0" ] && [ "$stat_with_summaries" -gt 0 ]; then
+    context+="=== EAGLE MEM — Enrichment Reminder ===
+The previous session's summary did NOT include decisions, gotchas, or key_files. These fields power Eagle Mem's self-learning (feature discovery, anti-regression, command intelligence). Please emit an <eagle-summary> block at the end of this session with these fields populated.
+
+"
+fi
+
 # Project overview
 overview=$(eagle_get_overview "$project")
 if [ -n "$overview" ]; then

package/hooks/stop.sh

@@ -12,6 +12,7 @@ LIB_DIR="$SCRIPT_DIR/../lib"
 
 . "$LIB_DIR/common.sh"
 . "$LIB_DIR/db.sh"
+. "$LIB_DIR/provider.sh"
 
 eagle_ensure_db
 
@@ -29,6 +30,7 @@ agent_type=$(echo "$input" | jq -r '.agent_type // empty')
 [ -n "$agent_type" ] && [ "$agent_type" != "main" ] && exit 0
 
 project=$(eagle_project_from_cwd "$cwd")
+[ -z "$project" ] && exit 0
 
 eagle_log "INFO" "Stop: session=$session_id project=$project transcript=$transcript_path"
 
@@ -111,21 +113,25 @@ if [ -n "$summary_block" ]; then
     eagle_log "INFO" "Stop: parsed eagle-summary block"
 fi
 
-# ─── Heuristic fallback: extract from tool calls ───────────
+# ─── Guard: skip fallback work if summary already exists ──
+# Stop fires every assistant turn. Without this, the heuristic and LLM
+# enrichment blocks fire on turn 2+ — wasting tokens and producing
+# empty inserts that get rejected.
 
-if [ -z "$request" ] && [ -n "$transcript_path" ] && [ -f "$transcript_path" ]; then
-    # Skip heuristic if we already have a summary for this session.
-    # Stop fires every turn -- without this guard, each turn creates a duplicate row.
-    existing_count=$(eagle_db "SELECT COUNT(*) FROM summaries WHERE session_id = '$(eagle_sql_escape "$session_id")';")
-    if [ "${existing_count:-0}" -gt 0 ]; then
-        eagle_log "INFO" "Stop: skipping heuristic — summary already exists for session=$session_id (count=$existing_count)"
-    else
+existing_count=0
+if [ -z "$summary_block" ] && [ -n "$transcript_path" ] && [ -f "$transcript_path" ]; then
+    existing_count=$(eagle_count_session_summaries "$session_id")
+fi
+
+if [ -z "$summary_block" ] && [ "${existing_count:-0}" -eq 0 ]; then
+
+    # ─── Heuristic fallback: extract from tool calls ───────────
+
+    if [ -z "$request" ] && [ -n "$transcript_path" ] && [ -f "$transcript_path" ]; then
         eagle_log "INFO" "Stop: no eagle-summary found, using heuristic fallback"
 
-        # Extract first user prompt as "request"
         request=$(jq -r 'select(.type == "user") | .message.content | if type == "string" then . elif type == "array" then [.[] | select(.type == "text") | .text] | join(" ") else "" end' "$transcript_path" 2>/dev/null | head -1 | cut -c1-500)
 
-        # Extract files from Read/Write/Edit tool calls
         heuristic_reads=$(jq -r 'select(.type == "assistant") | .message.content[]? | select(.type == "tool_use") | select(.name == "Read") | .input.file_path // empty' "$transcript_path" 2>/dev/null | sort -u | head -20)
         heuristic_writes=$(jq -r 'select(.type == "assistant") | .message.content[]? | select(.type == "tool_use") | select(.name == "Write" or .name == "Edit") | .input.file_path // empty' "$transcript_path" 2>/dev/null | sort -u | head -20)
 
@@ -138,6 +144,52 @@ if [ -z "$request" ] && [ -n "$transcript_path" ] && [ -f "$transcript_path" ];
 
         completed="(auto-captured from tool usage)"
     fi
+
+    # ─── LLM enrichment: extract decisions/gotchas/key_files ──
+
+    if [ -z "$decisions" ] && [ -z "$gotchas" ] && [ -z "$key_files" ]; 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)
+
+            enrich_prompt="Extract from this Claude Code session excerpt:
+1. DECISIONS: architectural or design choices made (with WHY). One per line.
+2. GOTCHAS: non-obvious pitfalls, bugs found, things that surprised. One per line.
+3. KEY_FILES: important files that were central to the work. One per line.
+
+SESSION EXCERPT:
+$excerpt
+
+Output EXACTLY this format (omit sections with nothing to report):
+DECISIONS:
+- <decision> — why: <reason>
+GOTCHAS:
+- <gotcha>
+KEY_FILES:
+- <filepath>"
+
+            enrich_result=$(eagle_llm_call "$enrich_prompt" "Extract structured facts from development sessions. Be concise. Only include items with clear evidence." 512 2>/dev/null) || true
+
+            if [ -n "$enrich_result" ]; then
+                extract_section() {
+                    local result="$1" header="$2"
+                    echo "$result" | awk -v h="$header:" '
+                        $0 == h || $0 ~ "^"h { found=1; next }
+                        found && /^[A-Z_]+:/ { exit }
+                        found && /^- / { sub(/^- /, ""); lines[++n] = $0 }
+                        END { for (i=1; i<=n; i++) { printf "%s", lines[i]; if (i<n) printf "; " } }
+                    '
+                }
+                decisions=$(extract_section "$enrich_result" "DECISIONS")
+                gotchas=$(extract_section "$enrich_result" "GOTCHAS")
+                key_files=$(extract_section "$enrich_result" "KEY_FILES")
+                [ -n "$decisions" ] || [ -n "$gotchas" ] || [ -n "$key_files" ] && eagle_log "INFO" "Stop: LLM enrichment extracted for session=$session_id"
+            fi
+        fi
+    fi
+
+elif [ -z "$summary_block" ] && [ "${existing_count:-0}" -gt 0 ]; then
+    eagle_log "INFO" "Stop: skipping fallback — summary already exists for session=$session_id (count=$existing_count)"
 fi
 
 # ─── Redact secrets from all text fields before storage ────

package/lib/common.sh

@@ -9,6 +9,9 @@ EAGLE_MEM_DB="$EAGLE_MEM_DIR/memory.db"
 EAGLE_MEM_LOG="$EAGLE_MEM_DIR/eagle-mem.log"
 EAGLE_SETTINGS="${EAGLE_SETTINGS:-$HOME/.claude/settings.json}"
 EAGLE_SKILLS_DIR="$HOME/.claude/skills"
+EAGLE_CLAUDE_PROJECTS_DIR="$HOME/.claude/projects"
+EAGLE_CLAUDE_PLANS_DIR="$HOME/.claude/plans"
+EAGLE_CLAUDE_TASKS_DIR="$HOME/.claude/tasks"
 
 eagle_log() {
     local level="$1"
@@ -22,6 +25,18 @@ eagle_log() {
 
 eagle_project_from_cwd() {
     local cwd="${1:-$(pwd)}"
+    local resolved="$cwd"
+
+    # Resolve /private/tmp → /tmp on macOS
+    case "$resolved" in /private/tmp*) resolved="/tmp${resolved#/private/tmp}" ;; esac
+
+    # Skip ephemeral directories — return empty so hooks early-exit
+    case "$resolved" in
+        /tmp|/tmp/*|/var/tmp|/var/tmp/*) echo ""; return ;;
+        "$HOME/Downloads"|"$HOME/Downloads/"*) echo ""; return ;;
+        "$HOME/Desktop"|"$HOME/Desktop/"*) echo ""; return ;;
+    esac
+
     local git_root
     git_root=$(git -C "$cwd" rev-parse --show-toplevel 2>/dev/null)
     if [ -n "$git_root" ]; then