eagle-mem 4.0.1 → 4.0.2

package/README.md

@@ -36,17 +36,30 @@ Everything is automatic from here. Eagle Mem scans your codebase, indexes source
 
 ## Commands
 
-Six commands. Three for lifecycle, three for when you need to look something up or troubleshoot.
+Six commands. Three for lifecycle, three for lookup and troubleshooting.
 
 | Command | What it does |
 |---------|-------------|
 | `eagle-mem install` | First-time setup: hooks, database, skills |
 | `eagle-mem update` | Re-deploy hooks and run migrations after `npm update` |
 | `eagle-mem uninstall` | Remove hooks and optionally delete data |
-| `eagle-mem search "query"` | Search past sessions, memories, and code (FTS5) |
+| `eagle-mem search` | Single lookup command — see modes below |
 | `eagle-mem health` | Diagnose pipeline health and background automation |
 | `eagle-mem config` | View or change LLM provider settings |
 
+### Search modes
+
+| Mode | What it does |
+|------|-------------|
+| `eagle-mem search "query"` | FTS5 keyword search across session summaries |
+| `eagle-mem search --timeline` | Recent sessions in chronological order |
+| `eagle-mem search --overview` | View project overview |
+| `eagle-mem search --memories` | Mirrored Claude Code memories |
+| `eagle-mem search --tasks` | In-flight tasks (pending/in-progress) |
+| `eagle-mem search --files` | Most frequently modified files |
+| `eagle-mem search --stats` | Project statistics (counts) |
+| `eagle-mem search --session <id>` | Full observation trail for one session |
+
 ## Skills (inside Claude Code)
 
 | Skill | What it does |

package/package.json

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

package/scripts/help.sh

@@ -23,10 +23,14 @@ 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 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 -e "  ${BOLD}Search modes:${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 search --overview     ${DIM}# project overview${RESET}"
+echo -e "    ${DIM}\$${RESET} eagle-mem search --memories     ${DIM}# mirrored memories${RESET}"
+echo -e "    ${DIM}\$${RESET} eagle-mem search --tasks        ${DIM}# in-flight tasks${RESET}"
+echo -e "    ${DIM}\$${RESET} eagle-mem search --files        ${DIM}# hot files${RESET}"
+echo -e "    ${DIM}\$${RESET} eagle-mem search --stats        ${DIM}# project stats${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"

package/scripts/search.sh

@@ -25,6 +25,9 @@ show_help() {
     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 -e "    eagle-mem search ${CYAN}--overview${RESET}                ${DIM}# project overview${RESET}"
+    echo -e "    eagle-mem search ${CYAN}--memories${RESET}               ${DIM}# mirrored Claude memories${RESET}"
+    echo -e "    eagle-mem search ${CYAN}--tasks${RESET}                  ${DIM}# in-flight tasks${RESET}"
     echo ""
     echo -e "  ${BOLD}Options:${RESET}"
     echo -e "    ${CYAN}-p, --project${RESET} <name>    Project name (default: current dir)"
@@ -51,6 +54,9 @@ while [ $# -gt 0 ]; do
         --session|-s)        mode="session"; session_id="$2"; shift 2 ;;
         --files|-f)          mode="files"; shift ;;
         --stats)             mode="stats"; shift ;;
+        --overview|-o)       mode="overview"; shift ;;
+        --memories|-m)       mode="memories"; shift ;;
+        --tasks)             mode="tasks"; shift ;;
         --project|-p)        project="$2"; shift 2 ;;
         --limit|-n)          limit="$2"; shift 2 ;;
         --all|-a)            cross_project=true; shift ;;
@@ -280,6 +286,211 @@ search_stats() {
     echo ""
 }
 
+# ─── Overview ────────────────────────────────────────────
+
+search_overview() {
+    local p; p=$(eagle_sql_escape "$project")
+
+    if [ "$json_output" = true ]; then
+        eagle_db_json "SELECT project, content, source, updated_at FROM overviews WHERE project = '$p';"
+        return
+    fi
+
+    local content
+    content=$(eagle_db "SELECT content FROM overviews WHERE project = '$p';")
+
+    if [ -z "$content" ]; then
+        eagle_dim "No overview for project '$project'"
+        eagle_dim "  Auto-scan runs on first session, or use /eagle-mem-overview for a rich briefing"
+        return
+    fi
+
+    echo ""
+    echo -e "  ${BOLD}Overview${RESET} ${DIM}($project)${RESET}"
+    echo -e "  ${DIM}─────────────────────────────────────${RESET}"
+    echo ""
+    echo "  $content"
+    echo ""
+
+    if [ -n "$query" ]; then
+        echo -e "  ${DIM}To update: eagle-mem search --overview set \"new overview text\"${RESET}"
+    fi
+}
+
+# ─── Memories ────────────────────────────────────────────
+
+search_memories() {
+    local p; p=$(eagle_sql_escape "$project")
+
+    local where_project=""
+    if [ "$cross_project" = false ]; then
+        where_project="WHERE project = '$p'"
+    fi
+
+    if [ -n "$query" ]; then
+        local q; q=$(eagle_sql_escape "$(eagle_fts_sanitize "$query")")
+        local where_match="WHERE claude_memories_fts MATCH '$q'"
+        if [ "$cross_project" = false ]; then
+            where_match="$where_match AND m.project = '$p'"
+        fi
+
+        if [ "$json_output" = true ]; then
+            eagle_db_json "SELECT m.memory_name, m.memory_type, m.description, m.project, m.updated_at
+                           FROM claude_memories m
+                           JOIN claude_memories_fts f ON f.rowid = m.id
+                           $where_match
+                           ORDER BY rank
+                           LIMIT $limit;"
+            return
+        fi
+
+        local results
+        results=$(eagle_db "SELECT m.memory_name, m.memory_type, m.description, m.project, m.updated_at
+                            FROM claude_memories m
+                            JOIN claude_memories_fts f ON f.rowid = m.id
+                            $where_match
+                            ORDER BY rank
+                            LIMIT $limit;")
+
+        if [ -z "$results" ]; then
+            eagle_dim "No memories matching '$query'"
+            return
+        fi
+
+        echo ""
+        while IFS='|' read -r mname mtype mdesc mproj mupdated; do
+            [ -z "$mname" ] && continue
+            echo -e "  ${BOLD}$mname${RESET}  ${DIM}[$mtype]${RESET}"
+            [ "$cross_project" = true ] && echo -e "  ${DIM}project:${RESET} $mproj"
+            [ -n "$mdesc" ] && echo -e "  $mdesc"
+            echo ""
+        done <<< "$results"
+        return
+    fi
+
+    if [ "$json_output" = true ]; then
+        eagle_db_json "SELECT memory_name, memory_type, description, project, updated_at
+                       FROM claude_memories $where_project
+                       ORDER BY updated_at DESC LIMIT $limit;"
+        return
+    fi
+
+    local results
+    results=$(eagle_db "SELECT memory_name, memory_type, description, updated_at
+                        FROM claude_memories $where_project
+                        ORDER BY updated_at DESC LIMIT $limit;")
+
+    if [ -z "$results" ]; then
+        eagle_dim "No memories found"
+        return
+    fi
+
+    echo ""
+    echo -e "  ${BOLD}Memories${RESET} ${DIM}($project)${RESET}"
+    echo -e "  ${DIM}─────────────────────────────────────${RESET}"
+    echo ""
+
+    while IFS='|' read -r mname mtype mdesc mupdated; do
+        [ -z "$mname" ] && continue
+        echo -e "  ${CYAN}[$mtype]${RESET} ${BOLD}$mname${RESET}"
+        [ -n "$mdesc" ] && echo -e "         ${DIM}$mdesc${RESET}"
+    done <<< "$results"
+    echo ""
+}
+
+# ─── Tasks ───────────────────────────────────────────────
+
+search_tasks() {
+    local p; p=$(eagle_sql_escape "$project")
+
+    local where_project=""
+    if [ "$cross_project" = false ]; then
+        where_project="AND project = '$p'"
+    fi
+
+    if [ -n "$query" ]; then
+        local q; q=$(eagle_sql_escape "$(eagle_fts_sanitize "$query")")
+
+        if [ "$json_output" = true ]; then
+            eagle_db_json "SELECT t.subject, t.status, t.project, t.updated_at
+                           FROM claude_tasks t
+                           JOIN claude_tasks_fts f ON f.rowid = t.id
+                           WHERE claude_tasks_fts MATCH '$q'
+                           ${where_project/AND/AND t.}
+                           ORDER BY rank
+                           LIMIT $limit;"
+            return
+        fi
+
+        local results
+        results=$(eagle_db "SELECT t.subject, t.status, t.project, t.updated_at
+                            FROM claude_tasks t
+                            JOIN claude_tasks_fts f ON f.rowid = t.id
+                            WHERE claude_tasks_fts MATCH '$q'
+                            ${where_project/AND/AND t.}
+                            ORDER BY rank
+                            LIMIT $limit;")
+
+        if [ -z "$results" ]; then
+            eagle_dim "No tasks matching '$query'"
+            return
+        fi
+
+        echo ""
+        while IFS='|' read -r tsubject tstatus tproj tupdated; do
+            [ -z "$tsubject" ] && continue
+            local color="$DIM"
+            case "$tstatus" in
+                in_progress) color="$YELLOW" ;;
+                completed) color="$GREEN" ;;
+                pending) color="$CYAN" ;;
+            esac
+            echo -e "  ${color}[$tstatus]${RESET} $tsubject"
+        done <<< "$results"
+        echo ""
+        return
+    fi
+
+    if [ "$json_output" = true ]; then
+        eagle_db_json "SELECT subject, status, project, updated_at
+                       FROM claude_tasks
+                       WHERE status IN ('in_progress', 'pending')
+                       $where_project
+                       ORDER BY CASE status WHEN 'in_progress' THEN 0 ELSE 1 END, updated_at DESC
+                       LIMIT $limit;"
+        return
+    fi
+
+    local results
+    results=$(eagle_db "SELECT subject, status, updated_at
+                        FROM claude_tasks
+                        WHERE status IN ('in_progress', 'pending')
+                        $where_project
+                        ORDER BY CASE status WHEN 'in_progress' THEN 0 ELSE 1 END, updated_at DESC
+                        LIMIT $limit;")
+
+    if [ -z "$results" ]; then
+        eagle_dim "No active tasks for project '$project'"
+        return
+    fi
+
+    echo ""
+    echo -e "  ${BOLD}Tasks${RESET} ${DIM}($project)${RESET}"
+    echo -e "  ${DIM}─────────────────────────────────────${RESET}"
+    echo ""
+
+    while IFS='|' read -r tsubject tstatus tupdated; do
+        [ -z "$tsubject" ] && continue
+        local color="$DIM"
+        case "$tstatus" in
+            in_progress) color="$YELLOW" ;;
+            pending) color="$CYAN" ;;
+        esac
+        echo -e "  ${color}[$tstatus]${RESET} $tsubject"
+    done <<< "$results"
+    echo ""
+}
+
 # ─── Dispatch ─────────────────────────────────────────────
 
 case "$mode" in
@@ -295,4 +506,7 @@ case "$mode" in
     session)     search_session ;;
     files)       search_files ;;
     stats)       search_stats ;;
+    overview)    search_overview ;;
+    memories)    search_memories ;;
+    tasks)       search_tasks ;;
 esac