eagle-mem 1.0.3 → 1.2.0

package/scripts/prune.sh

@@ -0,0 +1,154 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════
+# Eagle Mem — Prune
+# Removes old observations and orphaned code chunks
+# to keep the database lean
+# ═══════════════════════════════════════════════════════════
+set -euo pipefail
+
+SCRIPTS_DIR="$(cd "$(dirname "$0")" && pwd)"
+LIB_DIR="$SCRIPTS_DIR/../lib"
+
+. "$SCRIPTS_DIR/style.sh"
+. "$LIB_DIR/common.sh"
+. "$LIB_DIR/db.sh"
+
+eagle_ensure_db
+
+# ─── Parse arguments ──────────────────────────────────────
+
+days=90
+project=""
+dry_run=false
+
+while [ $# -gt 0 ]; do
+    case "$1" in
+        --days|-d)      days="$2"; shift 2 ;;
+        --project|-p)   project="$2"; shift 2 ;;
+        --dry-run|-n)   dry_run=true; shift ;;
+        --help|-h)
+            echo -e "  ${BOLD}eagle-mem prune${RESET} — Clean up old data"
+            echo ""
+            echo -e "  ${BOLD}Usage:${RESET}"
+            echo -e "    eagle-mem prune                     ${DIM}# prune observations > 90 days${RESET}"
+            echo -e "    eagle-mem prune ${CYAN}--days 30${RESET}           ${DIM}# prune observations > 30 days${RESET}"
+            echo -e "    eagle-mem prune ${CYAN}--dry-run${RESET}           ${DIM}# show what would be pruned${RESET}"
+            echo ""
+            echo -e "  ${BOLD}What gets pruned:${RESET}"
+            echo -e "    ${DOT} Observations older than --days (default: 90)"
+            echo -e "    ${DOT} Code chunks for files that no longer exist"
+            echo ""
+            echo -e "  ${BOLD}What is preserved:${RESET}"
+            echo -e "    ${DOT} All sessions and summaries (your session history)"
+            echo -e "    ${DOT} All tasks"
+            echo -e "    ${DOT} Project overviews"
+            echo ""
+            echo -e "  ${BOLD}Options:${RESET}"
+            echo -e "    ${CYAN}-d, --days${RESET} <N>        Age threshold (default: 90)"
+            echo -e "    ${CYAN}-p, --project${RESET} <name>  Only prune for this project"
+            echo -e "    ${CYAN}-n, --dry-run${RESET}         Show counts without deleting"
+            echo ""
+            exit 0
+            ;;
+        *)
+            eagle_err "Unknown option: $1"
+            exit 1
+            ;;
+    esac
+done
+
+if ! [[ "$days" =~ ^[0-9]+$ ]]; then
+    eagle_err "Days must be a number, got: $days"
+    exit 1
+fi
+
+eagle_header "Prune"
+
+# ─── Count before ────────────────────────────────────────
+
+total_obs=$(eagle_db "SELECT COUNT(*) FROM observations;")
+total_chunks=$(eagle_db "SELECT COUNT(*) FROM code_chunks;")
+eagle_info "Database: ${total_obs:-0} observations, ${total_chunks:-0} chunks"
+echo ""
+
+# ─── Old observations ───────────────────────────────────
+
+obs_project_filter=""
+if [ -n "$project" ]; then
+    obs_project_filter="AND session_id IN (SELECT id FROM sessions WHERE project = '$(eagle_sql_escape "$project")')"
+fi
+
+old_obs_count=$(eagle_db "SELECT COUNT(*) FROM observations WHERE created_at < strftime('%Y-%m-%dT%H:%M:%fZ', 'now', '-$days days') $obs_project_filter;")
+
+if [ "${old_obs_count:-0}" -gt 0 ]; then
+    if [ "$dry_run" = true ]; then
+        eagle_dim "Would prune $old_obs_count observations older than $days days"
+    else
+        eagle_prune_observations "$days" "$project"
+        eagle_ok "Pruned $old_obs_count observations older than $days days"
+    fi
+else
+    eagle_ok "No observations older than $days days"
+fi
+
+# ─── Orphaned code chunks ───────────────────────────────
+
+if [ -n "$project" ]; then
+    projects="$project"
+else
+    projects=$(eagle_db "SELECT DISTINCT project FROM code_chunks;")
+fi
+
+orphan_total=0
+if [ -n "$projects" ]; then
+    while IFS= read -r proj; do
+        [ -z "$proj" ] && continue
+
+        # Try to find the project directory
+        proj_cwd=$(eagle_db "SELECT cwd FROM sessions WHERE project = '$(eagle_sql_escape "$proj")' ORDER BY started_at DESC LIMIT 1;")
+
+        if [ -n "$proj_cwd" ] && [ -d "$proj_cwd" ]; then
+            if [ "$dry_run" = true ]; then
+                orphan_count=$(eagle_db "SELECT COUNT(DISTINCT file_path) FROM code_chunks WHERE project = '$(eagle_sql_escape "$proj")';")
+                # Count files that no longer exist
+                orphans=0
+                paths=$(eagle_db "SELECT DISTINCT file_path FROM code_chunks WHERE project = '$(eagle_sql_escape "$proj")';")
+                while IFS= read -r fpath; do
+                    [ -z "$fpath" ] && continue
+                    [ ! -f "$proj_cwd/$fpath" ] && orphans=$((orphans + 1))
+                done <<< "$paths"
+                if [ "$orphans" -gt 0 ]; then
+                    eagle_dim "Would prune $orphans orphaned files from '$proj'"
+                    orphan_total=$((orphan_total + orphans))
+                fi
+            else
+                removed=$(eagle_prune_orphan_chunks "$proj" "$proj_cwd")
+                if [ "${removed:-0}" -gt 0 ]; then
+                    eagle_ok "Pruned $removed orphaned files from '$proj'"
+                    orphan_total=$((orphan_total + removed))
+                fi
+            fi
+        fi
+    done <<< "$projects"
+fi
+
+if [ "$orphan_total" -eq 0 ]; then
+    eagle_ok "No orphaned code chunks found"
+fi
+
+# ─── Summary ────────────────────────────────────────────
+
+new_obs=$(eagle_db "SELECT COUNT(*) FROM observations;")
+new_chunks=$(eagle_db "SELECT COUNT(*) FROM code_chunks;")
+
+echo ""
+if [ "$dry_run" = true ]; then
+    eagle_footer "Dry run complete (no changes made)."
+else
+    eagle_footer "Prune complete."
+fi
+
+eagle_kv "Observations:" "${new_obs:-0} (was ${total_obs:-0})"
+eagle_kv "Code chunks:" "${new_chunks:-0} (was ${total_chunks:-0})"
+eagle_kv "Database:" "$EAGLE_MEM_DB"
+echo ""

package/scripts/search.sh

@@ -0,0 +1,294 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════
+# Eagle Mem — Search
+# CLI wrapper for memory search (replaces raw SQL in skills)
+# ═══════════════════════════════════════════════════════════
+set -euo pipefail
+
+SCRIPTS_DIR="$(cd "$(dirname "$0")" && pwd)"
+LIB_DIR="$SCRIPTS_DIR/../lib"
+
+. "$SCRIPTS_DIR/style.sh"
+. "$LIB_DIR/common.sh"
+. "$LIB_DIR/db.sh"
+
+eagle_ensure_db
+
+# ─── Parse arguments ──────────────────────────────────────
+
+mode="keyword"
+project=""
+limit=10
+session_id=""
+json_output=false
+query=""
+cross_project=false
+
+while [ $# -gt 0 ]; do
+    case "$1" in
+        --timeline|-t)      mode="timeline"; shift ;;
+        --session|-s)        mode="session"; session_id="$2"; shift 2 ;;
+        --files|-f)          mode="files"; shift ;;
+        --stats)             mode="stats"; shift ;;
+        --project|-p)        project="$2"; shift 2 ;;
+        --limit|-n)          limit="$2"; shift 2 ;;
+        --all|-a)            cross_project=true; shift ;;
+        --json|-j)           json_output=true; shift ;;
+        --help|-h)
+            echo -e "  ${BOLD}eagle-mem search${RESET} — Search persistent memory"
+            echo ""
+            echo -e "  ${BOLD}Usage:${RESET}"
+            echo -e "    eagle-mem search ${CYAN}<query>${RESET}                   ${DIM}# keyword search${RESET}"
+            echo -e "    eagle-mem search ${CYAN}--timeline${RESET}               ${DIM}# recent sessions${RESET}"
+            echo -e "    eagle-mem search ${CYAN}--session <id>${RESET}            ${DIM}# session details${RESET}"
+            echo -e "    eagle-mem search ${CYAN}--files${RESET}                  ${DIM}# frequently modified files${RESET}"
+            echo -e "    eagle-mem search ${CYAN}--stats${RESET}                  ${DIM}# project statistics${RESET}"
+            echo ""
+            echo -e "  ${BOLD}Options:${RESET}"
+            echo -e "    ${CYAN}-p, --project${RESET} <name>    Project name (default: current dir)"
+            echo -e "    ${CYAN}-n, --limit${RESET} <N>         Max results (default: 10)"
+            echo -e "    ${CYAN}-a, --all${RESET}               Search across all projects"
+            echo -e "    ${CYAN}-j, --json${RESET}              Output as JSON"
+            echo ""
+            exit 0
+            ;;
+        -*)
+            eagle_err "Unknown option: $1"
+            exit 1
+            ;;
+        *)
+            query="$1"; shift ;;
+    esac
+done
+
+[ -z "$project" ] && project=$(eagle_project_from_cwd "$(pwd)")
+limit=$(eagle_sql_int "$limit")
+[ "$limit" -eq 0 ] && limit=10
+
+# ─── Keyword search ──────────────────────────────────────
+
+search_keyword() {
+    local q; q=$(eagle_sql_escape "$(eagle_fts_sanitize "$query")")
+    local p; p=$(eagle_sql_escape "$project")
+
+    local where_project=""
+    if [ "$cross_project" = false ]; then
+        where_project="AND s.project = '$p'"
+    fi
+
+    if [ "$json_output" = true ]; then
+        eagle_db_json "SELECT s.id, s.project, s.request, s.completed, s.learned, s.created_at
+                       FROM summaries s
+                       JOIN summaries_fts f ON f.rowid = s.id
+                       WHERE summaries_fts MATCH '$q'
+                       $where_project
+                       ORDER BY rank
+                       LIMIT $limit;"
+        return
+    fi
+
+    local results
+    results=$(eagle_db "SELECT s.id, s.project, s.request, s.completed, s.learned, s.created_at
+                        FROM summaries s
+                        JOIN summaries_fts f ON f.rowid = s.id
+                        WHERE summaries_fts MATCH '$q'
+                        $where_project
+                        ORDER BY rank
+                        LIMIT $limit;")
+
+    if [ -z "$results" ]; then
+        eagle_dim "No results for '$query'"
+        return
+    fi
+
+    echo ""
+    while IFS='|' read -r sid sproj req completed learned created_at; do
+        [ -z "$sid" ] && continue
+        echo -e "  ${BOLD}#$sid${RESET}  ${DIM}$created_at${RESET}"
+        if [ "$cross_project" = true ]; then
+            echo -e "  ${DIM}project:${RESET} $sproj"
+        fi
+        [ -n "$req" ] && echo -e "  ${CYAN}Request:${RESET} $req"
+        [ -n "$completed" ] && echo -e "  ${GREEN}Done:${RESET} $completed"
+        [ -n "$learned" ] && echo -e "  ${YELLOW}Learned:${RESET} $learned"
+        echo ""
+    done <<< "$results"
+}
+
+# ─── Timeline ────────────────────────────────────────────
+
+search_timeline() {
+    local p; p=$(eagle_sql_escape "$project")
+
+    if [ "$json_output" = true ]; then
+        eagle_db_json "SELECT s.id, s.request, s.completed, s.learned, s.next_steps, s.created_at
+                       FROM summaries s
+                       WHERE s.project = '$p'
+                       ORDER BY s.created_at DESC
+                       LIMIT $limit;"
+        return
+    fi
+
+    local results
+    results=$(eagle_db "SELECT s.id, s.request, s.completed, s.learned, s.next_steps, s.created_at
+                        FROM summaries s
+                        WHERE s.project = '$p'
+                        ORDER BY s.created_at DESC
+                        LIMIT $limit;")
+
+    if [ -z "$results" ]; then
+        eagle_dim "No sessions found for project '$project'"
+        return
+    fi
+
+    echo ""
+    echo -e "  ${BOLD}Recent sessions${RESET} ${DIM}($project)${RESET}"
+    echo -e "  ${DIM}─────────────────────────────────────${RESET}"
+    echo ""
+
+    while IFS='|' read -r sid req completed learned next_steps created_at; do
+        [ -z "$sid" ] && continue
+        echo -e "  ${BOLD}#$sid${RESET}  ${DIM}$created_at${RESET}"
+        [ -n "$req" ] && echo -e "  ${CYAN}Request:${RESET} $req"
+        [ -n "$completed" ] && echo -e "  ${GREEN}Done:${RESET} $completed"
+        [ -n "$learned" ] && echo -e "  ${YELLOW}Learned:${RESET} $learned"
+        [ -n "$next_steps" ] && echo -e "  ${DIM}Next:${RESET} $next_steps"
+        echo ""
+    done <<< "$results"
+}
+
+# ─── Session details ──────────────────────────────────────
+
+search_session() {
+    local sid_sql; sid_sql=$(eagle_sql_escape "$session_id")
+
+    if [ "$json_output" = true ]; then
+        eagle_db_json "SELECT o.tool_name, o.tool_input_summary, o.files_read, o.files_modified, o.created_at
+                       FROM observations o
+                       WHERE o.session_id = '$sid_sql'
+                       ORDER BY o.created_at ASC;"
+        return
+    fi
+
+    local results
+    results=$(eagle_db "SELECT o.tool_name, o.tool_input_summary, o.files_read, o.files_modified, o.created_at
+                        FROM observations o
+                        WHERE o.session_id = '$sid_sql'
+                        ORDER BY o.created_at ASC;")
+
+    if [ -z "$results" ]; then
+        eagle_dim "No observations found for session '$session_id'"
+        return
+    fi
+
+    echo ""
+    echo -e "  ${BOLD}Session${RESET} ${DIM}$session_id${RESET}"
+    echo -e "  ${DIM}─────────────────────────────────────${RESET}"
+    echo ""
+
+    while IFS='|' read -r tool_name summary files_r files_m created_at; do
+        [ -z "$tool_name" ] && continue
+        local icon="$DOT"
+        case "$tool_name" in
+            Read) icon="${CYAN}R${RESET}" ;;
+            Write) icon="${GREEN}W${RESET}" ;;
+            Edit) icon="${YELLOW}E${RESET}" ;;
+            Bash) icon="${BLUE}\$${RESET}" ;;
+        esac
+        echo -e "  ${icon}  ${DIM}$created_at${RESET}  $summary"
+    done <<< "$results"
+    echo ""
+}
+
+# ─── Frequently modified files ────────────────────────────
+
+search_files() {
+    local p; p=$(eagle_sql_escape "$project")
+
+    if [ "$json_output" = true ]; then
+        eagle_db_json "SELECT json_each.value as file, COUNT(*) as times
+                       FROM observations, json_each(observations.files_modified)
+                       WHERE observations.project = '$p'
+                       GROUP BY json_each.value
+                       ORDER BY times DESC
+                       LIMIT $limit;"
+        return
+    fi
+
+    local results
+    results=$(eagle_db "SELECT json_each.value as file, COUNT(*) as times
+                        FROM observations, json_each(observations.files_modified)
+                        WHERE observations.project = '$p'
+                        GROUP BY json_each.value
+                        ORDER BY times DESC
+                        LIMIT $limit;")
+
+    if [ -z "$results" ]; then
+        eagle_dim "No file history for project '$project'"
+        return
+    fi
+
+    echo ""
+    echo -e "  ${BOLD}Frequently modified files${RESET} ${DIM}($project)${RESET}"
+    echo -e "  ${DIM}─────────────────────────────────────${RESET}"
+    echo ""
+
+    while IFS='|' read -r filepath count; do
+        [ -z "$filepath" ] && continue
+        printf "  ${GREEN}%3s×${RESET}  %s\n" "$count" "$filepath"
+    done <<< "$results"
+    echo ""
+}
+
+# ─── Stats ────────────────────────────────────────────────
+
+search_stats() {
+    local p; p=$(eagle_sql_escape "$project")
+
+    local sessions summaries observations tasks
+    sessions=$(eagle_db "SELECT COUNT(*) FROM sessions WHERE project = '$p';")
+    summaries=$(eagle_db "SELECT COUNT(*) FROM summaries WHERE project = '$p';")
+    observations=$(eagle_db "SELECT COUNT(*) FROM observations o JOIN sessions s ON s.id = o.session_id WHERE s.project = '$p';")
+    tasks=$(eagle_db "SELECT COUNT(*) FROM tasks WHERE project = '$p';")
+    local chunks
+    chunks=$(eagle_db "SELECT COUNT(*) FROM code_chunks WHERE project = '$p';")
+
+    if [ "$json_output" = true ]; then
+        jq -nc --arg project "$project" \
+            --argjson sessions "${sessions:-0}" \
+            --argjson summaries "${summaries:-0}" \
+            --argjson observations "${observations:-0}" \
+            --argjson tasks "${tasks:-0}" \
+            --argjson code_chunks "${chunks:-0}" \
+            '{project: $project, sessions: $sessions, summaries: $summaries, observations: $observations, tasks: $tasks, code_chunks: $code_chunks}'
+        return
+    fi
+
+    echo ""
+    echo -e "  ${BOLD}Stats${RESET} ${DIM}($project)${RESET}"
+    echo -e "  ${DIM}─────────────────────────────────────${RESET}"
+    echo ""
+    eagle_kv "Sessions:" "${sessions:-0}"
+    eagle_kv "Summaries:" "${summaries:-0}"
+    eagle_kv "Observations:" "${observations:-0}"
+    eagle_kv "Tasks:" "${tasks:-0}"
+    eagle_kv "Code chunks:" "${chunks:-0}"
+    echo ""
+}
+
+# ─── Dispatch ─────────────────────────────────────────────
+
+case "$mode" in
+    keyword)
+        if [ -z "$query" ]; then
+            eagle_err "Usage: eagle-mem search <query>"
+            eagle_dim "  Run 'eagle-mem search --help' for options"
+            exit 1
+        fi
+        search_keyword
+        ;;
+    timeline)    search_timeline ;;
+    session)     search_session ;;
+    files)       search_files ;;
+    stats)       search_stats ;;
+esac