eagle-mem 3.2.0 → 4.0.0

package/hooks/session-start.sh

@@ -13,6 +13,7 @@ SCRIPTS_DIR="$SCRIPT_DIR/../scripts"
 . "$LIB_DIR/common.sh"
 . "$LIB_DIR/db.sh"
 . "$LIB_DIR/provider.sh"
+. "$LIB_DIR/hooks-sessionstart.sh"
 
 eagle_ensure_db
 
@@ -27,8 +28,6 @@ model=$(echo "$input" | jq -r '.model // empty')
 [ -z "$session_id" ] && exit 0
 
 project=$(eagle_project_from_cwd "$cwd")
-
-# Skip ephemeral directories (tmp, Downloads, etc.) — no tracking
 [ -z "$project" ] && exit 0
 
 p_esc=$(eagle_sql_escape "$project")
@@ -36,32 +35,18 @@ p_esc=$(eagle_sql_escape "$project")
 eagle_log "INFO" "SessionStart: session=$session_id project=$project source=$source_type"
 
 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_abandon_stale_sessions "$session_id"
 
-# ─── Auto-curate trigger (background, non-blocking) ──────────
-# Moved here from SessionEnd because SessionEnd rarely fires in long-lived sessions.
-# SessionStart fires on every new session, resume, and compaction — reliable trigger.
-curator_schedule=$(eagle_config_get "curator" "schedule" "manual")
-if [ "$curator_schedule" = "auto" ]; then
-    _curator_provider=$(eagle_config_get "provider" "type" "none")
-    if [ "$_curator_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" "SessionStart: 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
+# ─── Background automation (non-blocking) ────────────────
 
-# ─── Version check (non-blocking) ────────────────────────────
+eagle_sessionstart_auto_provision "$project" "$cwd" "$SCRIPTS_DIR"
+eagle_sessionstart_auto_prune "$project" "$SCRIPTS_DIR" "$(eagle_db "SELECT COUNT(*) FROM observations WHERE session_id IN (SELECT id FROM sessions WHERE project='$p_esc');")"
+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 &
+
+# ─── Version check (non-blocking) ────────────────────────
 
 update_notice=""
 version_file="$EAGLE_MEM_DIR/.version"
@@ -89,7 +74,7 @@ if [ -f "$version_file" ] && [ -s "$version_file" ]; then
     fi
 fi
 
-# ─── Gather stats ───────────────────────────────────────────
+# ─── Gather stats ────────────────────────────────────────
 
 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
@@ -113,7 +98,8 @@ while IFS='|' read -r key val; do
     esac
 done <<< "$(eagle_get_project_stats "$project")"
 
-# Build task summary line
+# ─── Build compressed banner (elide zero-value lines) ────
+
 task_parts=""
 [ "$stat_tasks_progress" -gt 0 ] && task_parts="${stat_tasks_progress} in progress"
 if [ "$stat_tasks_pending" -gt 0 ]; then
@@ -124,27 +110,26 @@ if [ "$stat_tasks_done" -gt 0 ]; then
     [ -n "$task_parts" ] && task_parts+=", "
     task_parts+="${stat_tasks_done} completed"
 fi
-[ -z "$task_parts" ] && task_parts="none"
 
-# Truncate last summary for display
 stat_last_display="${stat_last_summary:0:60}"
 [ ${#stat_last_summary} -gt 60 ] && stat_last_display+="..."
-[ -z "$stat_last_display" ] && stat_last_display="(no sessions yet)"
-
-# ─── Build context injection ────────────────────────────────
 
 eagle_banner="======================================
        Eagle Mem Loaded
 ======================================
  Project      | $project
- Sessions     | $stat_sessions total ($stat_with_summaries with summaries)
- Memories     | $stat_memories stored
- Plans        | $stat_plans saved
- Tasks        | $task_parts
- Code Index   | $stat_chunks chunks indexed
- Observations | $stat_observations captured
- Last Active  | $stat_last_active
- Last Work    | $stat_last_display
+ Sessions     | $stat_sessions ($stat_with_summaries with summaries)"
+[ "$stat_memories" -gt 0 ] && eagle_banner+="
+ Memories     | $stat_memories stored"
+[ "$stat_plans" -gt 0 ] && eagle_banner+="
+ Plans        | $stat_plans saved"
+[ -n "$task_parts" ] && eagle_banner+="
+ Tasks        | $task_parts"
+[ "$stat_chunks" -gt 0 ] && eagle_banner+="
+ Code Index   | $stat_chunks chunks"
+[ -n "$stat_last_display" ] && eagle_banner+="
+ Last Work    | $stat_last_display"
+eagle_banner+="
 ======================================"
 
 context="$eagle_banner
@@ -156,22 +141,33 @@ if [ -n "$update_notice" ]; then
 "
 fi
 
-# Project overview
+# ─── Project overview (capped at 500 chars) ──────────────
+
 overview=$(eagle_get_overview "$project")
 if [ -n "$overview" ]; then
+    if [ ${#overview} -gt 500 ]; then
+        overview="${overview:0:497}..."
+    fi
     context+="
-=== Project Overview ===
+=== Overview ===
 $overview
 "
 else
     context+="
-=== Action Required ===
-No overview exists for '$project'. Run /eagle-mem-overview to build one.
+=== New Project ===
+No overview yet — auto-scan is running. Run /eagle-mem-overview for a richer briefing.
 "
 fi
 
-# Recent summaries for this project (last 5 sessions)
-recent=$(eagle_get_recent_summaries "$project" 5)
+# ─── Recent sessions (1 on compact, 3 on startup) ────────
+
+if [ "$source_type" = "compact" ] || [ "$source_type" = "clear" ]; then
+    _summary_limit=1
+else
+    _summary_limit=3
+fi
+
+recent=$(eagle_get_recent_summaries "$project" "$_summary_limit")
 
 if [ -n "$recent" ]; then
     context+="
@@ -200,7 +196,7 @@ Next steps: $next_steps"
 "
 fi
 
-# ─── Mirrored Claude memories (with age) ─────────────────
+# ─── Memories (skip if none) ─────────────────────────────
 
 memories=$(eagle_db "SELECT memory_name, memory_type, description, file_path, updated_at,
     CAST(julianday('now') - julianday(updated_at) AS INTEGER) as days_ago
@@ -229,7 +225,7 @@ if [ -n "$memories" ]; then
     done <<< "$memories"
 fi
 
-# ─── Mirrored Claude plans ────────────────────────────────
+# ─── Plans (skip if none) ────────────────────────────────
 
 plans=$(eagle_list_claude_plans "$project" 3)
 if [ -n "$plans" ]; then
@@ -243,7 +239,7 @@ if [ -n "$plans" ]; then
     done <<< "$plans"
 fi
 
-# ─── Claude Code tasks ───────────────────────────────────
+# ─── Tasks (skip if none) ────────────────────────────────
 
 synced_tasks=$(eagle_db "SELECT subject, status, blocked_by FROM claude_tasks
     WHERE project = '$p_esc'
@@ -268,39 +264,27 @@ if [ -n "$synced_tasks" ]; then
     done <<< "$synced_tasks"
 fi
 
-# ─── Instructions (full on startup, minimal on compact) ──
+# ─── Instructions (compressed) ───────────────────────────
 
 if [ "$source_type" = "compact" ] || [ "$source_type" = "clear" ]; then
     context+="
-=== Eagle Mem (compact reload) ===
-Persistent memory active. Attribute recalled context to Eagle Mem. Do not revert past decisions surfaced by PostToolUse without asking the user. Emit <eagle-summary> before your final response.
+=== Eagle Mem ===
+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 ===
-Persistent memory active for '$project'. Attribute recalled context: \"Eagle Mem recalls:\" When PostToolUse surfaces past decisions about a file, do not revert without explicit user request. Never include raw secrets in eagle-summary fields. If you change something that contradicts a loaded memory, update that memory file.
-
-Emit an <eagle-summary> block before your FINAL response:
+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:
 <eagle-summary>
-request: [what the user asked for]
-investigated: [file paths read or explored]
-learned: [non-obvious discoveries a future session couldn't guess from code]
-completed: [what shipped — be specific]
-next_steps: [concrete actions for next session]
-decisions:
-  - [choice] Why: [reason]
-gotchas:
-  - [what failed or surprised — \"X doesn't work because Y\"]
-key_files:
-  - [path] — [role in this work]
-files_read: [file1, file2]
-files_modified: [file1, file2]
+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>
 "
 fi
 
-# Output context (plain text stdout = additionalContext for SessionStart)
 if [ -n "$context" ]; then
     echo "$context"
 fi

package/lib/db-observations.sh

@@ -52,7 +52,8 @@ eagle_get_command_rule() {
         WHERE enabled = 1
         AND (project = '$project' OR project = '')
         AND ('$cmd' LIKE pattern OR '$cmd' = pattern)
-        ORDER BY CASE WHEN project != '' THEN 0 ELSE 1 END
+        ORDER BY CASE WHEN project != '' THEN 0 ELSE 1 END,
+            LENGTH(pattern) DESC
         LIMIT 1;"
 }
 

package/lib/db-sessions.sh

@@ -15,9 +15,9 @@ eagle_upsert_session() {
     eagle_db "INSERT INTO sessions (id, project, cwd, model, source, last_activity_at)
               VALUES ('$session_id', '$project', '$cwd', '$model', '$source', strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))
               ON CONFLICT(id) DO UPDATE SET
-                  cwd = COALESCE(excluded.cwd, sessions.cwd),
-                  model = COALESCE(excluded.model, sessions.model),
-                  source = COALESCE(excluded.source, sessions.source),
+                  cwd = COALESCE(NULLIF(excluded.cwd, ''), sessions.cwd),
+                  model = COALESCE(NULLIF(excluded.model, ''), sessions.model),
+                  source = COALESCE(NULLIF(excluded.source, ''), sessions.source),
                   status = 'active',
                   last_activity_at = strftime('%Y-%m-%dT%H:%M:%fZ', 'now');"
 }

package/lib/hooks-sessionstart.sh

@@ -0,0 +1,89 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════
+# Eagle Mem — SessionStart extracted automation
+# Source from hooks/session-start.sh after common.sh + db.sh
+# ═══════════════════════════════════════════════════════════
+[ -n "${_EAGLE_HOOKS_SESSIONSTART_LOADED:-}" ] && return 0
+_EAGLE_HOOKS_SESSIONSTART_LOADED=1
+
+_state_dir="$EAGLE_MEM_DIR/state"
+
+_eagle_state_fresh() {
+    local key="$1" project="$2" max_age_days="${3:-1}"
+    local state_file="$_state_dir/${key}-${project}"
+    [ -f "$state_file" ] && [ -z "$(find "$state_file" -mtime +${max_age_days} 2>/dev/null)" ]
+}
+
+_eagle_state_touch() {
+    local key="$1" project="$2"
+    mkdir -p "$_state_dir" 2>/dev/null
+    touch "$_state_dir/${key}-${project}"
+}
+
+eagle_sessionstart_auto_provision() {
+    local project="$1" cwd="$2" scripts_dir="$3"
+    local needs_scan=false needs_index=false
+
+    # Auto-scan: no overview exists
+    local overview
+    overview=$(eagle_get_overview "$project")
+    if [ -z "$overview" ] && ! _eagle_state_fresh "scan" "$project" 1; then
+        needs_scan=true
+    fi
+
+    # Auto-index: 0 chunks or stale > 7 days
+    local chunk_count
+    chunk_count=$(eagle_db "SELECT COUNT(*) FROM code_chunks WHERE project = '$(eagle_sql_escape "$project")';" 2>/dev/null)
+    chunk_count=${chunk_count:-0}
+    if [ "$chunk_count" -eq 0 ] && ! _eagle_state_fresh "index" "$project" 1; then
+        needs_index=true
+    elif [ "$chunk_count" -gt 0 ] && ! _eagle_state_fresh "index" "$project" 7; then
+        needs_index=true
+    fi
+
+    if [ "$needs_scan" = true ] && [ "$needs_index" = true ]; then
+        eagle_log "INFO" "SessionStart: first-session provision — scan then index"
+        _eagle_state_touch "scan" "$project"
+        _eagle_state_touch "index" "$project"
+        nohup bash -c "bash '$scripts_dir/scan.sh' '$cwd' >> '$EAGLE_MEM_LOG' 2>&1; bash '$scripts_dir/index.sh' '$cwd' >> '$EAGLE_MEM_LOG' 2>&1" &
+    elif [ "$needs_scan" = true ]; then
+        eagle_log "INFO" "SessionStart: auto-scan triggered"
+        _eagle_state_touch "scan" "$project"
+        nohup bash "$scripts_dir/scan.sh" "$cwd" >> "$EAGLE_MEM_LOG" 2>&1 &
+    elif [ "$needs_index" = true ]; then
+        eagle_log "INFO" "SessionStart: auto-index triggered"
+        _eagle_state_touch "index" "$project"
+        nohup bash "$scripts_dir/index.sh" "$cwd" >> "$EAGLE_MEM_LOG" 2>&1 &
+    fi
+}
+
+eagle_sessionstart_auto_prune() {
+    local project="$1" scripts_dir="$2" observation_count="$3"
+    if [ "${observation_count:-0}" -gt 10000 ] && ! _eagle_state_fresh "prune" "$project" 1; then
+        eagle_log "INFO" "SessionStart: auto-prune triggered (${observation_count} observations)"
+        _eagle_state_touch "prune" "$project"
+        nohup bash "$scripts_dir/prune.sh" -p "$project" >> "$EAGLE_MEM_LOG" 2>&1 &
+    fi
+}
+
+eagle_sessionstart_auto_curate() {
+    local project="$1" scripts_dir="$2"
+    local curator_schedule
+    curator_schedule=$(eagle_config_get "curator" "schedule" "manual")
+    if [ "$curator_schedule" = "auto" ]; then
+        local _provider
+        _provider=$(eagle_config_get "provider" "type" "none")
+        if [ "$_provider" != "none" ]; then
+            local _min_sessions _last_curated _since _sessions_since
+            _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" "SessionStart: 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
+}

package/lib/hooks.sh

@@ -11,7 +11,15 @@ eagle_patch_hook() {
     local command="$4"
     local description="${5:-}"
 
-    if jq -e ".hooks.${event}[]? | select(.hooks[]?.command == \"$command\")" "$settings" &>/dev/null; then
+    # Check both command AND matcher to avoid skipping entries with different matchers
+    # (e.g. PreToolUse with "Bash" vs "Read" matcher using the same script)
+    local match_query
+    if [ -n "$matcher" ]; then
+        match_query=".hooks.${event}[]? | select(.matcher == \"$matcher\" and (.hooks[]?.command == \"$command\"))"
+    else
+        match_query=".hooks.${event}[]? | select(.matcher == null and (.hooks[]?.command == \"$command\"))"
+    fi
+    if jq -e "$match_query" "$settings" &>/dev/null; then
         [ -n "$description" ] && eagle_ok "$description ${DIM}(already registered)${RESET}"
         return 0
     fi

package/lib/provider.sh

@@ -151,8 +151,8 @@ model = "claude-haiku-4-5-20251001"
 model = "gpt-4o-mini"
 
 [curator]
-# "auto" = triggers at session end after min_sessions; "manual" = CLI only
-schedule = "manual"
+# "auto" = triggers at session start after min_sessions; "manual" = CLI only
+schedule = "auto"
 min_sessions = 5
 
 [redaction]

package/package.json

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

package/scripts/curate.sh

@@ -222,6 +222,13 @@ If no rules needed, output: NONE"
                             eagle_log "WARN" "Curator: skipping RULE with invalid strategy '$strategy'"
                             continue
                         ;; esac
+                        # Guard: reject dangerous LLM-generated patterns that match everything
+                        # Require at least 2 literal characters (not just wildcards)
+                        _literal_chars=$(printf '%s' "$pattern" | sed 's/[%_]//g')
+                        if [ ${#_literal_chars} -lt 2 ]; then
+                            eagle_log "WARN" "Curator: skipping overly broad pattern '$pattern' (needs >=2 literal chars)"
+                            continue
+                        fi
 
                         [ "$max_lines" = "-" ] && max_lines=""
 

package/scripts/help.sh

@@ -16,38 +16,26 @@ echo -e "  ${BOLD}Eagle Mem${RESET} ${DIM}v${version}${RESET}"
 echo -e "  ${DIM}Persistent memory for Claude Code${RESET}"
 echo ""
 echo -e "  ${BOLD}Commands:${RESET}"
-echo -e "    ${CYAN}search${RESET}      Search past sessions, memories, and code"
-echo -e "    ${CYAN}overview${RESET}    View or set project overview"
-echo -e "    ${CYAN}scan${RESET}        Analyze codebase structure"
-echo -e "    ${CYAN}index${RESET}       Index source files for FTS5 code search"
-echo -e "    ${CYAN}memories${RESET}    View/sync mirrored Claude Code memories"
-echo -e "    ${CYAN}tasks${RESET}       View mirrored Claude Code tasks"
-echo -e "    ${CYAN}refresh${RESET}     Full project sync: scan (if needed) + index + memories"
-echo -e "    ${CYAN}prune${RESET}       Remove old observations and orphaned chunks"
-echo -e "    ${CYAN}config${RESET}      View or change LLM provider settings"
-echo -e "    ${CYAN}curate${RESET}      Run the self-learning curator (LLM-powered analysis)"
-echo -e "    ${CYAN}feature${RESET}     Manage feature graph (list/show/verify/add)"
-echo -e "    ${CYAN}health${RESET}      Diagnose self-learning pipeline health"
 echo -e "    ${CYAN}install${RESET}     First-time setup: hooks, database, skills"
 echo -e "    ${CYAN}update${RESET}      Re-deploy hooks and run migrations"
 echo -e "    ${CYAN}uninstall${RESET}   Remove hooks and optionally delete data"
+echo -e "    ${CYAN}search${RESET}      Search past sessions, memories, and code"
+echo -e "    ${CYAN}health${RESET}      Diagnose pipeline health and background automation"
+echo -e "    ${CYAN}config${RESET}      View or change LLM provider settings"
 echo ""
 echo -e "  ${BOLD}Examples:${RESET}"
-echo -e "    ${DIM}\$${RESET} eagle-mem search \"auth bug\"  ${DIM}# keyword search${RESET}"
-echo -e "    ${DIM}\$${RESET} eagle-mem search --timeline  ${DIM}# recent sessions${RESET}"
-echo -e "    ${DIM}\$${RESET} eagle-mem refresh             ${DIM}# full project sync${RESET}"
-echo -e "    ${DIM}\$${RESET} eagle-mem overview           ${DIM}# view overview${RESET}"
-echo -e "    ${DIM}\$${RESET} eagle-mem prune --dry-run    ${DIM}# preview cleanup${RESET}"
 echo -e "    ${DIM}\$${RESET} eagle-mem install            ${DIM}# first-time setup${RESET}"
+echo -e "    ${DIM}\$${RESET} eagle-mem search \"auth bug\"  ${DIM}# keyword search${RESET}"
+echo -e "    ${DIM}\$${RESET} eagle-mem health              ${DIM}# check pipeline${RESET}"
 echo ""
 echo -e "  ${BOLD}Skills${RESET} ${DIM}(inside Claude Code sessions):${RESET}"
 echo -e "    ${CYAN}/eagle-mem-search${RESET}      Search memory and past sessions"
 echo -e "    ${CYAN}/eagle-mem-overview${RESET}    Build or update project overview"
-echo -e "    ${CYAN}/eagle-mem-scan${RESET}        Analyze codebase structure"
-echo -e "    ${CYAN}/eagle-mem-index${RESET}       Index source files for code search"
 echo -e "    ${CYAN}/eagle-mem-memories${RESET}    View/sync Claude Code memories"
 echo -e "    ${CYAN}/eagle-mem-tasks${RESET}       TaskAware Compact Loop for multi-step work"
-echo -e "    ${CYAN}/eagle-mem-prune${RESET}       Clean up stale data"
+echo ""
+echo -e "  ${DIM}Everything else is automatic — scan, index, prune, and${RESET}"
+echo -e "  ${DIM}curator all run in the background via hooks.${RESET}"
 echo ""
 echo -e "  ${DIM}https://github.com/eagleisbatman/eagle-mem${RESET}"
 echo ""

package/scripts/install.sh

@@ -186,7 +186,11 @@ eagle_patch_hook "$SETTINGS" "UserPromptSubmit" "" \
 
 eagle_patch_hook "$SETTINGS" "PreToolUse" "Bash" \
     "$EAGLE_MEM_DIR/hooks/pre-tool-use.sh" \
-    "PreToolUse hook"
+    "PreToolUse hook (Bash)"
+
+eagle_patch_hook "$SETTINGS" "PreToolUse" "Read" \
+    "$EAGLE_MEM_DIR/hooks/pre-tool-use.sh" \
+    "PreToolUse hook (Read)"
 
 # ─── Install skills ────────────────────────────────────────
 

package/scripts/update.sh

@@ -76,6 +76,7 @@ if [ -f "$SETTINGS" ] && command -v jq &>/dev/null; then
     eagle_patch_hook "$SETTINGS" "SessionEnd" "" "$EAGLE_MEM_DIR/hooks/session-end.sh"
     eagle_patch_hook "$SETTINGS" "UserPromptSubmit" "" "$EAGLE_MEM_DIR/hooks/user-prompt-submit.sh"
     eagle_patch_hook "$SETTINGS" "PreToolUse" "Bash" "$EAGLE_MEM_DIR/hooks/pre-tool-use.sh"
+    eagle_patch_hook "$SETTINGS" "PreToolUse" "Read" "$EAGLE_MEM_DIR/hooks/pre-tool-use.sh"
 
     eagle_ok "Hooks registered"
 fi

package/skills/eagle-mem-overview/SKILL.md

@@ -17,11 +17,12 @@ description: >
 ## Judgment
 
 **Build an overview when:**
-- SessionStart says "No overview exists" — build on the user's first prompt
-- The current overview reads like scan metadata (file counts, directory listings) — upgrade it
+- SessionStart shows a scan-generated overview (file counts, directory listings) — upgrade it to a rich briefing
 - The user asks: "update overview", "summarize this project", "what is this project"
 - The project has changed significantly since the last overview (new major feature, architecture shift)
 
+Note: New projects are auto-scanned at SessionStart. The scan produces structural metadata. This skill upgrades that into a briefing with intent, architecture, and current state.
+
 **Don't rebuild when:**
 - The overview is already rich and current — just use it
 - The user needs help with a specific task — do the task first, update overview after if needed
@@ -64,11 +65,7 @@ If the output is empty or doesn't match what you wrote, the save failed. Retry o
 
 ### 4. Fallback for empty repos
 
-If no readable source files exist (fresh repo, no README), run a structural scan as a starting point:
-```bash
-eagle-mem scan .
-```
-Then tell the user: "I've generated a structural overview from scan. Once you add a README or source code, re-run `/eagle-mem-overview` for a richer briefing."
+If no readable source files exist (fresh repo, no README), Eagle Mem's auto-scan has already generated a structural overview in the background. Tell the user: "Auto-scan has captured the project structure. Once you add a README or source code, re-run `/eagle-mem-overview` for a richer briefing."
 
 ## What makes a good overview
 
@@ -86,6 +83,10 @@ A good overview lets a fresh Claude Code context window give useful answers with
 **Bad:**
 > eagle-mem: Node.js project (42 files, ~5k lines). Structure: bin/ (1), db/ (10), hooks/ (5), lib/ (3), scripts/ (13), skills/ (7). Entry: bin/eagle-mem. No tests detected.
 
+## How automation works
+
+Eagle Mem v4.0 auto-scans new projects at SessionStart — no user action needed. This skill exists to *upgrade* that scan into a rich, multi-paragraph briefing that captures intent, architecture, and current state.
+
 ## Reference
 
 ```bash
@@ -93,5 +94,4 @@ eagle-mem overview              # view current overview
 eagle-mem overview set "..."    # save new overview
 eagle-mem overview list         # all projects with overviews
 eagle-mem overview delete       # remove current project's overview
-eagle-mem scan .                # structural scan (fallback only)
 ```

package/skills/eagle-mem-index/SKILL.md

@@ -1,120 +0,0 @@
----
-name: eagle-mem-index
-description: >
-  Index source files into FTS5-searchable chunks. Use when: 'eagle index', 'index this project',
-  'make code searchable', 'reindex', 'update index', 'index after pull',
-  'code search setup'. Uses the eagle-mem CLI.
----
-
-# Eagle Mem — Index
-
-## Purpose
-
-**For the user:** Claude Code can find code they wrote weeks ago -- across sessions, without needing to remember which file it was in. Every prompt automatically surfaces relevant code chunks from the index, so past work stays accessible.
-
-**For you (Claude Code):** The UserPromptSubmit hook searches `code_chunks` on every user prompt and injects matching file references into your context. You don't call a search command for this -- it happens automatically. But the index must exist and be current for it to work. That's what this skill manages.
-
-## Judgment
-
-**Index when:**
-- First time setting up Eagle Mem on a project (`eagle-mem index .`)
-- After a `git pull` or branch switch that brought in significant changes
-- After a major refactor (renamed files, moved directories, new modules)
-- The user says "index this project" or "make code searchable"
-- You notice the UserPromptSubmit hook isn't surfacing relevant code -- the index may be stale
-
-**Don't index when:**
-- You just need to read a specific file -- use Read directly
-- The project was recently indexed and no files changed (mtime dedup handles this, but don't waste time running it)
-- You're in the middle of a task -- index at session boundaries, not mid-work
-
-**Decision rule:** Index is a maintenance task, not a search tool. Run it to *prepare* the database, then rely on the automatic hook to *use* it. If the hook isn't surfacing what you expect, the index is stale -- re-run.
-
-## Steps
-
-### 1. Run the indexer
-
-```bash
-eagle-mem index .
-```
-Indexes the current directory. The script:
-- Collects source files (respects `.gitignore`, skips binaries/lockfiles)
-- Filters to known source extensions (sh, js, ts, py, go, rs, java, etc.)
-- Skips files over 1MB
-- Compares mtime against stored mtime -- only re-indexes changed files
-- Chunks each file into segments (default 80 lines) and inserts into `code_chunks` with FTS5
-
-The mtime check makes re-running cheap. On a project with 200 files where 5 changed, it processes only those 5.
-
-### 2. Understand chunk size
-
-Default: 80 lines per chunk. Override with:
-```bash
-EAGLE_MEM_CHUNK_SIZE=40 eagle-mem index .
-```
-
-**Smaller chunks (30-50):** More precise search matches. Better for codebases with many small, distinct functions. Produces more chunks -- larger DB.
-
-**Larger chunks (100-150):** More context per match. Better for files with long, cohesive blocks. Fewer chunks -- smaller DB.
-
-**When to change:** If the hook is surfacing irrelevant matches (chunks too big, mixing unrelated code), shrink. If matches lack context (cutting functions in half), grow. The default of 80 works well for most projects.
-
-### 3. Know what gets indexed
-
-The indexer processes files matching these extensions:
-`sh bash zsh js jsx mjs cjs ts tsx mts py rb go rs java kt kts swift c h cpp cc cxx hpp cs php sql html htm css scss vue svelte dart ex exs zig lua r scala yaml yml toml json md`
-
-Silently skipped: images, binaries, lockfiles (`package-lock.json` etc. are over 1MB), `.git/` contents, anything in `.gitignore`.
-
-### 4. Understand how indexed code reaches the user
-
-The flow is:
-1. You run `eagle-mem index .` -- code is chunked and stored in `code_chunks` table
-2. User submits a prompt in any future session
-3. UserPromptSubmit hook extracts keywords from the prompt
-4. Hook searches `code_chunks` FTS5 index for matches
-5. Matching file paths + line ranges are injected into your context as "EAGLE MEM — Relevant Code"
-
-There is no manual "search code" CLI command. The index feeds the hook, and the hook feeds you. Your job is to keep the index current.
-
-### 5. Verify the index
-
-After indexing, confirm it worked:
-```bash
-eagle-mem search --stats
-```
-Check the "Code chunks" count. For a typical project:
-- 50-file project ~ 200-500 chunks
-- 200-file project ~ 800-2000 chunks
-- 0 chunks after indexing = something went wrong (check file extensions, directory path)
-
-Also verify the hook is using it: on the next user prompt with 3+ words, you should see "EAGLE MEM — Relevant Code" injected if any chunks match.
-
-### 6. When indexing gets stale
-
-The index reflects the state of files *when you last ran it*. It goes stale when:
-- `git pull` brings in changes from others
-- `git checkout` switches branches (different file contents, possibly different files)
-- A major refactor renames or moves files (old paths stay in the index, new paths are missing)
-- Dependencies are updated and source files regenerate
-
-**After any of these, re-run `eagle-mem index .`** The mtime check ensures only changed files are re-processed. Old chunks for unchanged files are kept. Chunks for changed files are atomically replaced (DELETE + INSERT in a transaction).
-
-## What makes a good indexing practice
-
-**Good:**
-> Indexed the project after pulling the team's changes from main. Stats show 1,247 chunks across 189 files. The UserPromptSubmit hook should now surface the new API routes the team added.
-
-**Bad:**
-> Indexed once when Eagle Mem was installed and never again. The hook keeps surfacing stale code from deleted files, and misses the 30 new files added over the past month.
-
-## Reference
-
-| Command / Flag | What it does |
-|---|---|
-| `eagle-mem index .` | Index current directory (incremental via mtime) |
-| `eagle-mem index /path/to/dir` | Index a specific directory |
-| `EAGLE_MEM_CHUNK_SIZE=N` | Override chunk size (default: 80 lines) |
-| `eagle-mem search --stats` | Verify chunk count after indexing |
-| Max file size | 1MB (larger files silently skipped) |
-| Dedup | mtime-based -- re-running is cheap and safe |