eagle-mem 4.2.1 → 4.6.0

package/scripts/guard.sh

@@ -0,0 +1,160 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════
+# Eagle Mem — Guardrails management
+# eagle-mem guard [add|list|remove]
+# ═══════════════════════════════════════════════════════════
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+LIB_DIR="$SCRIPT_DIR/../lib"
+
+. "$LIB_DIR/common.sh"
+. "$LIB_DIR/db.sh"
+. "$SCRIPT_DIR/style.sh"
+
+eagle_ensure_db
+
+project=$(eagle_project_from_cwd "$(pwd)")
+if [ -z "$project" ]; then
+    eagle_err "Not in a recognized project directory"
+    exit 1
+fi
+
+eagle_header "Guardrails"
+
+subcommand="${1:-list}"
+shift 2>/dev/null || true
+
+case "$subcommand" in
+    add)
+        rule="${1:-}"
+        if [ -z "$rule" ]; then
+            eagle_err "Usage: eagle-mem guard add \"rule text\" [--file pattern]"
+            eagle_info "Examples:"
+            eagle_info "  eagle-mem guard add \"PRAGMA busy_timeout must precede synchronous\" --file \"db-core.sh\""
+            eagle_info "  eagle-mem guard add \"Never manually copy files to ~/.eagle-mem\""
+            eagle_info "  eagle-mem guard add \"Always validate session IDs\" --file \"*.sh\""
+            exit 1
+        fi
+        shift
+
+        file_pattern=""
+        while [ $# -gt 0 ]; do
+            case "$1" in
+                --file|-f)
+                    if [ $# -lt 2 ] || [ -z "${2:-}" ]; then
+                        eagle_err "--file requires a pattern argument"
+                        exit 1
+                    fi
+                    file_pattern="$2"
+                    shift 2
+                    ;;
+                *)
+                    shift
+                    ;;
+            esac
+        done
+
+        eagle_add_guardrail "$project" "$rule" "$file_pattern" "manual"
+        eagle_ok "Guardrail added for project: $project"
+        if [ -n "$file_pattern" ]; then
+            eagle_info "File pattern: $file_pattern"
+        else
+            eagle_info "Scope: project-wide"
+        fi
+        eagle_dim "Rule: $rule"
+        ;;
+
+    list|ls)
+        results=$(eagle_list_guardrails "$project")
+        if [ -z "$results" ]; then
+            eagle_info "No guardrails for project: $project"
+            eagle_dim "Add one: eagle-mem guard add \"rule\" [--file pattern]"
+            exit 0
+        fi
+
+        echo -e "  ${BOLD}ID   File Pattern         Rule                                     Source   Active${RESET}"
+        echo -e "  ${DIM}──── ──────────────────── ──────────────────────────────────────── ──────── ──────${RESET}"
+
+        while IFS='|' read -r id pat rule source active _created; do
+            [ -z "$id" ] && continue
+            pat="${pat:-(all)}"
+            rule_display="${rule:0:40}"
+            [ ${#rule} -gt 40 ] && rule_display="${rule_display}..."
+            if [ "$active" = "1" ]; then
+                active_display="${GREEN}yes${RESET}"
+            else
+                active_display="${DIM}no${RESET}"
+            fi
+            printf "  %-4s %-20s %-40s %-8s %b\n" "$id" "$pat" "$rule_display" "$source" "$active_display"
+        done <<< "$results"
+        echo ""
+        ;;
+
+    remove|rm|delete)
+        id="${1:-}"
+        if [ -z "$id" ]; then
+            eagle_err "Usage: eagle-mem guard remove <id>"
+            exit 1
+        fi
+        case "$id" in
+            *[!0-9]*)
+                eagle_err "Invalid ID: '$id' (must be numeric)"
+                exit 1
+                ;;
+        esac
+        eagle_remove_guardrail "$id"
+        eagle_ok "Guardrail #$id removed"
+        ;;
+
+    sync)
+        eagle_info "Syncing rules from CLAUDE.md files..."
+
+        # Collect rules first, then delete+insert in a single transaction
+        # to prevent data loss if interrupted mid-sync
+        sync_sql=""
+        synced=0
+        p_esc=$(eagle_sql_escape "$project")
+
+        for claude_md in "$HOME/.claude/CLAUDE.md" ".claude/CLAUDE.md" "CLAUDE.md"; do
+            [ ! -f "$claude_md" ] && continue
+            eagle_dim "  Reading: $claude_md"
+
+            # Extract lines that look like imperative rules
+            while IFS= read -r line; do
+                # Strip markdown formatting
+                clean=$(printf '%s\n' "$line" | sed 's/^[[:space:]]*[-*>]*[[:space:]]*//' | sed 's/\*\*//g' | sed 's/`//g')
+                [ -z "$clean" ] && continue
+                # Skip headings, short lines, and non-rule content
+                [ ${#clean} -lt 15 ] && continue
+                case "$clean" in \#*) continue ;; esac
+
+                # Cap rule length
+                [ ${#clean} -gt 2048 ] && clean="${clean:0:2048}"
+                rule_esc=$(eagle_sql_escape "$clean")
+                sync_sql+="INSERT OR IGNORE INTO guardrails (project, file_pattern, rule, source) VALUES ('$p_esc', '', '$rule_esc', 'claude-md');"$'\n'
+                synced=$((synced + 1))
+            done < <(grep -iE '^[[:space:]]*[-*>]*[[:space:]]*(never |always |do not |don'\''t |must |rule:|important:)' "$claude_md" 2>/dev/null)
+        done
+
+        # Atomic: always delete stale + insert new in one transaction
+        # Even when synced=0, DELETE must run to clear removed rules
+        eagle_db_pipe <<SQL
+BEGIN;
+DELETE FROM guardrails WHERE project = '$p_esc' AND source = 'claude-md';
+$sync_sql
+COMMIT;
+SQL
+        if [ "$synced" -gt 0 ]; then
+            eagle_ok "$synced rules synced from CLAUDE.md"
+        else
+            eagle_info "No imperative rules found in CLAUDE.md files (stale rules cleared)"
+        fi
+        ;;
+
+    *)
+        eagle_err "Unknown guard command: $subcommand"
+        eagle_info "Usage: eagle-mem guard [add|list|remove|sync]"
+        exit 1
+        ;;
+esac

package/scripts/health.sh

@@ -54,8 +54,8 @@ max_score=$((max_score + 25))
 
 total_sessions=$(eagle_db "SELECT COUNT(*) FROM sessions WHERE project = '$p_esc';")
 total_summaries=$(eagle_db "SELECT COUNT(*) FROM summaries WHERE project = '$p_esc';")
-heuristic_summaries=$(eagle_db "SELECT COUNT(*) FROM summaries WHERE project = '$p_esc' AND completed = '(auto-captured)';")
-enriched_summaries=$(eagle_db "SELECT COUNT(*) FROM summaries WHERE project = '$p_esc' AND (decisions IS NOT NULL AND decisions != '' OR gotchas IS NOT NULL AND gotchas != '' OR key_files IS NOT NULL AND key_files != '');")
+heuristic_summaries=$(eagle_db "SELECT COUNT(*) FROM summaries WHERE project = '$p_esc' AND (decisions IS NULL OR decisions = '') AND (gotchas IS NULL OR gotchas = '');")
+enriched_summaries=$(eagle_db "SELECT COUNT(*) FROM summaries WHERE project = '$p_esc' AND (decisions IS NOT NULL AND decisions != '' OR gotchas IS NOT NULL AND gotchas != '');")
 
 if [ "${total_sessions:-0}" -eq 0 ]; then
     capture_pct=0
@@ -92,7 +92,7 @@ fi
 
 if [ "${total_summaries:-0}" -gt 0 ]; then
     if [ "$enrich_pct" -ge 50 ]; then
-        eagle_ok "Enriched: ${enriched_summaries}/${total_summaries} (${enrich_pct}%) have decisions/gotchas/key_files"
+        eagle_ok "Enriched: ${enriched_summaries}/${total_summaries} (${enrich_pct}%) have decisions/gotchas"
         score=$((score + 25))
     elif [ "$enrich_pct" -ge 20 ]; then
         eagle_warn "Enriched: ${enriched_summaries}/${total_summaries} (${enrich_pct}%) — LLM extraction may need tuning"
@@ -101,9 +101,9 @@ if [ "${total_summaries:-0}" -gt 0 ]; then
     elif [ "${enriched_summaries:-0}" -gt 0 ]; then
         eagle_fail "Enriched: ${enriched_summaries}/${total_summaries} (${enrich_pct}%)"
         score=$((score + 5))
-        issues+=("${enrich_pct}% enrichment. Decisions/gotchas/key_files mostly missing.")
+        issues+=("${enrich_pct}% enrichment. Decisions/gotchas mostly missing.")
     else
-        eagle_fail "Enriched: 0/${total_summaries} — no summaries have decisions/gotchas/key_files"
+        eagle_fail "Enriched: 0/${total_summaries} — no summaries have decisions/gotchas"
         issues+=("Zero enrichment. Check provider config: eagle-mem config")
     fi
 else

package/scripts/help.sh

@@ -22,6 +22,13 @@ 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 -e "    ${CYAN}guard${RESET}       Manage regression guardrails for files"
+echo -e "    ${CYAN}overview${RESET}    Build or view project overview"
+echo -e "    ${CYAN}memories${RESET}    View/sync Claude Code memories"
+echo -e "    ${CYAN}tasks${RESET}       View mirrored tasks"
+echo -e "    ${CYAN}curate${RESET}      Run curator (co-edits, hot files, guardrails)"
+echo -e "    ${CYAN}feature${RESET}     Track and verify features"
+echo -e "    ${CYAN}prune${RESET}       Clean old sessions and stale data"
 echo ""
 echo -e "  ${BOLD}Search modes:${RESET}"
 echo -e "    ${DIM}\$${RESET} eagle-mem search \"auth bug\"    ${DIM}# keyword search${RESET}"

package/scripts/install.sh

@@ -176,6 +176,14 @@ eagle_patch_hook "$SETTINGS" "PostToolUse" "Read|Write|Edit|Bash|TaskCreate|Task
     "$EAGLE_MEM_DIR/hooks/post-tool-use.sh" \
     "PostToolUse hook"
 
+eagle_patch_hook "$SETTINGS" "TaskCreated" "" \
+    "$EAGLE_MEM_DIR/hooks/post-tool-use.sh" \
+    "TaskCreated hook"
+
+eagle_patch_hook "$SETTINGS" "TaskCompleted" "" \
+    "$EAGLE_MEM_DIR/hooks/post-tool-use.sh" \
+    "TaskCompleted hook"
+
 eagle_patch_hook "$SETTINGS" "SessionEnd" "" \
     "$EAGLE_MEM_DIR/hooks/session-end.sh" \
     "SessionEnd hook"

package/scripts/memories.sh

@@ -16,8 +16,12 @@ eagle_ensure_db
 
 # ─── Parse arguments ──────────────────────────────────────
 
-action="${1:-list}"
-shift 2>/dev/null || true
+action="list"
+case "${1:-}" in
+    -*)  ;; # flags parsed below
+    "")  ;;
+    *)   action="$1"; shift ;;
+esac
 
 project=""
 limit=20

package/scripts/overview.sh

@@ -16,8 +16,12 @@ eagle_ensure_db
 
 # ─── Parse arguments ──────────────────────────────────────
 
-action="${1:-show}"
-shift 2>/dev/null || true
+action="show"
+case "${1:-}" in
+    -*)  ;; # flags parsed below
+    "")  ;;
+    *)   action="$1"; shift ;;
+esac
 
 project=""
 json_output=false
@@ -36,7 +40,7 @@ show_help() {
     echo -e "    ${CYAN}-p, --project${RESET} <name>    Project name (default: current dir)"
     echo -e "    ${CYAN}-j, --json${RESET}              Output as JSON"
     echo ""
-    echo -e "  ${BOLD}Tip:${RESET} Use ${CYAN}eagle-mem scan${RESET} to auto-generate an overview from code."
+    echo -e "  ${BOLD}Tip:${RESET} Overviews are auto-generated during ${CYAN}eagle-mem install${RESET} and background scans."
     echo ""
     exit 0
 }
@@ -66,7 +70,7 @@ overview_show() {
 
     if [ -z "$content" ]; then
         eagle_dim "No overview for project '$project'"
-        eagle_dim "Run 'eagle-mem scan' or 'eagle-mem overview set <text>' to create one"
+        eagle_dim "Use 'eagle-mem overview set <text>' to create one, or run install/update to auto-generate"
         return
     fi
 

package/scripts/search.sh

@@ -78,7 +78,13 @@ limit=$(eagle_sql_int "$limit")
 # ─── Keyword search ──────────────────────────────────────
 
 search_keyword() {
-    local q; q=$(eagle_sql_escape "$(eagle_fts_sanitize "$query")")
+    local sanitized_q
+    sanitized_q=$(eagle_fts_sanitize "$query")
+    if [ -z "$sanitized_q" ]; then
+        eagle_err "Search query contains no valid search terms"
+        exit 1
+    fi
+    local q; q=$(eagle_sql_escape "$sanitized_q")
     local p; p=$(eagle_sql_escape "$project")
 
     local where_project=""
@@ -328,7 +334,13 @@ search_memories() {
     fi
 
     if [ -n "$query" ]; then
-        local q; q=$(eagle_sql_escape "$(eagle_fts_sanitize "$query")")
+        local sanitized_mq
+        sanitized_mq=$(eagle_fts_sanitize "$query")
+        if [ -z "$sanitized_mq" ]; then
+            eagle_err "Search query contains no valid search terms"
+            exit 1
+        fi
+        local q; q=$(eagle_sql_escape "$sanitized_mq")
         local where_match="WHERE claude_memories_fts MATCH '$q'"
         if [ "$cross_project" = false ]; then
             where_match="$where_match AND m.project = '$p'"
@@ -409,7 +421,13 @@ search_tasks() {
     fi
 
     if [ -n "$query" ]; then
-        local q; q=$(eagle_sql_escape "$(eagle_fts_sanitize "$query")")
+        local sanitized_tq
+        sanitized_tq=$(eagle_fts_sanitize "$query")
+        if [ -z "$sanitized_tq" ]; then
+            eagle_err "Search query contains no valid search terms"
+            exit 1
+        fi
+        local q; q=$(eagle_sql_escape "$sanitized_tq")
 
         if [ "$json_output" = true ]; then
             eagle_db_json "SELECT t.subject, t.status, t.project, t.updated_at

package/scripts/statusline-em.sh

@@ -8,12 +8,14 @@ eagle_mem_statusline() {
     local em_db="$HOME/.eagle-mem/memory.db"
     [ -f "$em_db" ] || return
 
+    local SCRIPT_DIR; SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+    . "$SCRIPT_DIR/../lib/common.sh"
+
     local proj
-    proj=$(basename "$project_dir")
+    proj=$(eagle_project_from_cwd "$project_dir")
     [ -z "$proj" ] && return
 
-    # Escape single quotes for safe SQL interpolation
-    proj=$(printf '%s' "$proj" | sed "s/'/''/g")
+    proj=$(eagle_sql_escape "$proj")
 
     local cnt mem
     cnt=$(echo ".headers off

package/scripts/tasks.sh

@@ -17,8 +17,12 @@ eagle_ensure_db
 
 # ─── Parse arguments ──────────────────────────────────────
 
-action="${1:-pending}"
-shift 2>/dev/null || true
+action="pending"
+case "${1:-}" in
+    -*)  ;; # flags parsed below
+    "")  ;;
+    *)   action="$1"; shift ;;
+esac
 
 project=""
 json_output=false
@@ -123,9 +127,15 @@ tasks_search() {
         exit 1
     fi
 
+    local sanitized_query
+    sanitized_query=$(eagle_fts_sanitize "$query")
+    if [ -z "$sanitized_query" ]; then
+        eagle_err "Search query contains no valid search terms"
+        exit 1
+    fi
+
     if [ "$json_output" = true ]; then
-        local query_sql; query_sql=$(eagle_fts_sanitize "$query")
-        query_sql=$(eagle_sql_escape "$query_sql")
+        local query_sql; query_sql=$(eagle_sql_escape "$sanitized_query")
         eagle_db_json "SELECT t.source_task_id, t.subject, t.status, t.description, t.updated_at
                        FROM claude_tasks t
                        JOIN claude_tasks_fts f ON f.rowid = t.id
@@ -137,8 +147,7 @@ tasks_search() {
     fi
 
     local results
-    local query_sql; query_sql=$(eagle_fts_sanitize "$query")
-    query_sql=$(eagle_sql_escape "$query_sql")
+    local query_sql; query_sql=$(eagle_sql_escape "$sanitized_query")
     results=$(eagle_db "SELECT t.source_task_id, t.subject, t.status, t.description
                         FROM claude_tasks t
                         JOIN claude_tasks_fts f ON f.rowid = t.id

package/scripts/update.sh

@@ -73,6 +73,8 @@ if [ -f "$SETTINGS" ] && command -v jq &>/dev/null; then
     eagle_patch_hook "$SETTINGS" "SessionStart" "" "$EAGLE_MEM_DIR/hooks/session-start.sh"
     eagle_patch_hook "$SETTINGS" "Stop" "" "$EAGLE_MEM_DIR/hooks/stop.sh"
     eagle_patch_hook "$SETTINGS" "PostToolUse" "Read|Write|Edit|Bash|TaskCreate|TaskUpdate" "$EAGLE_MEM_DIR/hooks/post-tool-use.sh"
+    eagle_patch_hook "$SETTINGS" "TaskCreated" "" "$EAGLE_MEM_DIR/hooks/post-tool-use.sh"
+    eagle_patch_hook "$SETTINGS" "TaskCompleted" "" "$EAGLE_MEM_DIR/hooks/post-tool-use.sh"
     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"