eagle-mem 1.1.0 → 1.3.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

@@ -62,11 +62,13 @@ while [ $# -gt 0 ]; do
 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 "$query")
+    local q; q=$(eagle_sql_escape "$(eagle_fts_sanitize "$query")")
     local p; p=$(eagle_sql_escape "$project")
 
     local where_project=""
@@ -158,10 +160,12 @@ search_timeline() {
 # ─── 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 = '$session_id'
+                       WHERE o.session_id = '$sid_sql'
                        ORDER BY o.created_at ASC;"
         return
     fi
@@ -169,7 +173,7 @@ search_session() {
     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 = '$session_id'
+                        WHERE o.session_id = '$sid_sql'
                         ORDER BY o.created_at ASC;")
 
     if [ -z "$results" ]; then
@@ -250,8 +254,13 @@ search_stats() {
     chunks=$(eagle_db "SELECT COUNT(*) FROM code_chunks WHERE project = '$p';")
 
     if [ "$json_output" = true ]; then
-        printf '{"project":"%s","sessions":%s,"summaries":%s,"observations":%s,"tasks":%s,"code_chunks":%s}\n' \
-            "$project" "${sessions:-0}" "${summaries:-0}" "${observations:-0}" "${tasks:-0}" "${chunks:-0}"
+        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
 

package/scripts/tasks.sh

@@ -16,7 +16,7 @@ eagle_ensure_db
 
 # ─── Parse arguments ──────────────────────────────────────
 
-action="${1:-list}"
+action="${1:-pending}"
 shift 2>/dev/null || true
 
 project=""
@@ -123,14 +123,14 @@ tasks_add() {
     max_ord=$(eagle_db "SELECT COALESCE(MAX(ordinal), 0) FROM tasks WHERE project = '$project_sql';")
     local next_ord=$((max_ord + 1))
 
-    eagle_db "INSERT INTO tasks (project, title, instructions, ordinal)
-              VALUES ('$project_sql', '$title_sql', '$instr_sql', $next_ord);"
-
     local new_id
-    new_id=$(eagle_db "SELECT last_insert_rowid();")
+    new_id=$(eagle_db "INSERT INTO tasks (project, title, instructions, ordinal)
+              VALUES ('$project_sql', '$title_sql', '$instr_sql', $next_ord);
+              SELECT last_insert_rowid();")
 
     if [ "$json_output" = true ]; then
-        printf '{"id":%s,"title":"%s","ordinal":%s}\n' "$new_id" "$title" "$next_ord"
+        jq -nc --arg id "$new_id" --arg title "$title" --argjson ord "$next_ord" \
+            '{id: ($id | tonumber), title: $title, ordinal: $ord}'
         return
     fi
 
@@ -147,14 +147,26 @@ tasks_done() {
         exit 1
     fi
 
-    eagle_db "UPDATE tasks SET status = 'done', completed_at = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
-              WHERE id = $task_id AND project = '$project_sql';"
+    if ! [[ "$task_id" =~ ^[0-9]+$ ]]; then
+        eagle_err "Task ID must be a number, got: $task_id"
+        exit 1
+    fi
+
+    local changed
+    changed=$(eagle_db "UPDATE tasks SET status = 'done', completed_at = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')
+              WHERE id = $task_id AND project = '$project_sql';
+              SELECT changes();")
+
+    if [ "${changed:-0}" -eq 0 ]; then
+        eagle_err "Task #$task_id not found in project '$project'"
+        exit 1
+    fi
 
     local title
-    title=$(eagle_db "SELECT title FROM tasks WHERE id = $task_id;")
+    title=$(eagle_db "SELECT title FROM tasks WHERE id = $task_id AND project = '$project_sql';")
 
     if [ "$json_output" = true ]; then
-        printf '{"id":%s,"status":"done"}\n' "$task_id"
+        jq -nc --arg id "$task_id" '{id: ($id | tonumber), status: "done"}'
         return
     fi
 
@@ -171,10 +183,22 @@ tasks_block() {
         exit 1
     fi
 
-    eagle_db "UPDATE tasks SET status = 'blocked' WHERE id = $task_id AND project = '$project_sql';"
+    if ! [[ "$task_id" =~ ^[0-9]+$ ]]; then
+        eagle_err "Task ID must be a number, got: $task_id"
+        exit 1
+    fi
+
+    local changed
+    changed=$(eagle_db "UPDATE tasks SET status = 'blocked' WHERE id = $task_id AND project = '$project_sql';
+              SELECT changes();")
+
+    if [ "${changed:-0}" -eq 0 ]; then
+        eagle_err "Task #$task_id not found in project '$project'"
+        exit 1
+    fi
 
     if [ "$json_output" = true ]; then
-        printf '{"id":%s,"status":"blocked"}\n' "$task_id"
+        jq -nc --arg id "$task_id" '{id: ($id | tonumber), status: "blocked"}'
         return
     fi
 
@@ -192,11 +216,23 @@ tasks_context() {
         exit 1
     fi
 
+    if ! [[ "$task_id" =~ ^[0-9]+$ ]]; then
+        eagle_err "Task ID must be a number, got: $task_id"
+        exit 1
+    fi
+
     local snap_sql; snap_sql=$(eagle_sql_escape "$snapshot")
-    eagle_db "UPDATE tasks SET context_snapshot = '$snap_sql' WHERE id = $task_id AND project = '$project_sql';"
+    local changed
+    changed=$(eagle_db "UPDATE tasks SET context_snapshot = '$snap_sql' WHERE id = $task_id AND project = '$project_sql';
+              SELECT changes();")
+
+    if [ "${changed:-0}" -eq 0 ]; then
+        eagle_err "Task #$task_id not found in project '$project'"
+        exit 1
+    fi
 
     if [ "$json_output" = true ]; then
-        printf '{"id":%s,"context_snapshot":true}\n' "$task_id"
+        jq -nc --arg id "$task_id" '{id: ($id | tonumber), context_snapshot: true}'
         return
     fi
 
@@ -212,7 +248,7 @@ tasks_clear() {
     eagle_db "DELETE FROM tasks WHERE project = '$project_sql' AND status = 'done';"
 
     if [ "$json_output" = true ]; then
-        printf '{"cleared":%s}\n' "${count:-0}"
+        jq -nc --argjson cleared "${count:-0}" '{cleared: $cleared}'
         return
     fi
 
@@ -230,7 +266,22 @@ case "$action" in
     context)    tasks_context ;;
     clear)      tasks_clear ;;
     --help|-h)
-        echo -e "  Run ${CYAN}eagle-mem tasks --help${RESET} for usage"
+        echo -e "  ${BOLD}eagle-mem tasks${RESET} — Manage tracked tasks"
+        echo ""
+        echo -e "  ${BOLD}Usage:${RESET}"
+        echo -e "    eagle-mem tasks                           ${DIM}# list pending tasks${RESET}"
+        echo -e "    eagle-mem tasks ${CYAN}list${RESET}                      ${DIM}# list all tasks${RESET}"
+        echo -e "    eagle-mem tasks ${CYAN}add${RESET} <title> [instructions] ${DIM}# add a task${RESET}"
+        echo -e "    eagle-mem tasks ${CYAN}done${RESET} <id>                 ${DIM}# mark task complete${RESET}"
+        echo -e "    eagle-mem tasks ${CYAN}block${RESET} <id>                ${DIM}# mark task blocked${RESET}"
+        echo -e "    eagle-mem tasks ${CYAN}context${RESET} <id> <snapshot>    ${DIM}# set task context${RESET}"
+        echo -e "    eagle-mem tasks ${CYAN}clear${RESET}                     ${DIM}# remove all done tasks${RESET}"
+        echo ""
+        echo -e "  ${BOLD}Options:${RESET}"
+        echo -e "    ${CYAN}-p, --project${RESET} <name>    Project name (default: current dir)"
+        echo -e "    ${CYAN}-j, --json${RESET}              Output as JSON"
+        echo ""
+        exit 0
         ;;
     *)
         eagle_err "Unknown action: $action"

package/scripts/uninstall.sh

@@ -6,12 +6,12 @@
 set -euo pipefail
 
 SCRIPTS_DIR="$(cd "$(dirname "$0")" && pwd)"
+LIB_DIR="$SCRIPTS_DIR/../lib"
 
 . "$SCRIPTS_DIR/style.sh"
+. "$LIB_DIR/common.sh"
 
-EAGLE_MEM_DIR="${EAGLE_MEM_DIR:-$HOME/.eagle-mem}"
-SETTINGS="$HOME/.claude/settings.json"
-SKILLS_DIR="$HOME/.claude/skills"
+SETTINGS="$EAGLE_SETTINGS"
 
 eagle_header "Uninstall"
 
@@ -35,9 +35,9 @@ fi
 
 # ─── Remove skill symlinks ────────────────────────────────
 
-if [ -d "$SKILLS_DIR" ]; then
+if [ -d "$EAGLE_SKILLS_DIR" ]; then
     for skill in eagle-mem-search eagle-mem-tasks eagle-mem-overview; do
-        target="$SKILLS_DIR/$skill"
+        target="$EAGLE_SKILLS_DIR/$skill"
         if [ -L "$target" ]; then
             rm "$target"
             eagle_ok "Skill removed: $skill"

package/scripts/update.sh

@@ -7,11 +7,12 @@ set -euo pipefail
 
 PACKAGE_DIR="${1:-.}"
 SCRIPTS_DIR="$(cd "$(dirname "$0")" && pwd)"
+LIB_DIR="$SCRIPTS_DIR/../lib"
 
 . "$SCRIPTS_DIR/style.sh"
+. "$LIB_DIR/common.sh"
 
-EAGLE_MEM_DIR="${EAGLE_MEM_DIR:-$HOME/.eagle-mem}"
-SETTINGS="$HOME/.claude/settings.json"
+SETTINGS="$EAGLE_SETTINGS"
 
 eagle_header "Update"
 
@@ -78,7 +79,12 @@ if [ -f "$SETTINGS" ] && command -v jq &>/dev/null; then
 
     patch_hook "SessionStart" "" "$EAGLE_MEM_DIR/hooks/session-start.sh"
     patch_hook "Stop" "" "$EAGLE_MEM_DIR/hooks/stop.sh"
-    patch_hook "PostToolUse" "Read|Write|Edit|Bash" "$EAGLE_MEM_DIR/hooks/post-tool-use.sh"
+    # Update PostToolUse matcher if it has the old value (pre-v1.3.0)
+    if jq -e '.hooks.PostToolUse[]? | select(.matcher == "Read|Write|Edit|Bash")' "$SETTINGS" &>/dev/null; then
+        _tmp=$(mktemp)
+        jq '(.hooks.PostToolUse[] | select(.matcher == "Read|Write|Edit|Bash")).matcher = "Read|Write|Edit|Bash|TaskCreate|TaskUpdate"' "$SETTINGS" > "$_tmp" && mv "$_tmp" "$SETTINGS"
+    fi
+    patch_hook "PostToolUse" "Read|Write|Edit|Bash|TaskCreate|TaskUpdate" "$EAGLE_MEM_DIR/hooks/post-tool-use.sh"
     patch_hook "SessionEnd" "" "$EAGLE_MEM_DIR/hooks/session-end.sh"
     patch_hook "UserPromptSubmit" "" "$EAGLE_MEM_DIR/hooks/user-prompt-submit.sh"
 
@@ -87,13 +93,12 @@ fi
 
 # ─── Update skill symlinks ────────────────────────────────
 
-SKILLS_DIR="$HOME/.claude/skills"
 if [ -d "$PACKAGE_DIR/skills" ]; then
-    mkdir -p "$SKILLS_DIR"
+    mkdir -p "$EAGLE_SKILLS_DIR"
     for skill_dir in "$PACKAGE_DIR"/skills/*/; do
         [ ! -d "$skill_dir" ] && continue
         skill_name=$(basename "$skill_dir")
-        dst="$SKILLS_DIR/$skill_name"
+        dst="$EAGLE_SKILLS_DIR/$skill_name"
         [ -L "$dst" ] && rm "$dst"
         ln -sf "$skill_dir" "$dst"
     done