eagle-mem 4.10.4 → 4.10.6

package/scripts/curate.sh

@@ -25,12 +25,32 @@ DRY_RUN=0
 FULL=0
 project=""
 
+show_help() {
+    cat <<EOF
+Usage: eagle-mem curate [options]
+
+Options:
+  -h, --help           Show this help message and exit
+  --dry-run            Analyze gotchas, decisions, features, and memories without saving to db
+  --full               Run full session compression and historical curation (slower)
+  -p, --project <dir>  Target project directory (defaults to auto-detected cwd)
+EOF
+}
+
 while [ $# -gt 0 ]; do
     case "$1" in
+        -h|--help)
+            show_help
+            exit 0
+            ;;
         --dry-run) DRY_RUN=1; shift ;;
         --full) FULL=1; shift ;;
         -p|--project) project="$2"; shift 2 ;;
-        *) shift ;;
+        *)
+            echo "Unknown option: $1" >&2
+            echo "Run with -h or --help for usage details." >&2
+            exit 1
+            ;;
     esac
 done
 
@@ -78,7 +98,7 @@ Only promote gotchas that are:
 
 If none qualify, output: NONE"
 
-    gotcha_result=$(eagle_llm_call "$gotcha_prompt" "You analyze software development patterns. Be concise. Only output PROMOTE lines or NONE." 512)
+    gotcha_result=$(eagle_llm_call "$gotcha_prompt" "You analyze software development patterns. Be concise. Only output PROMOTE lines or NONE." 512 || true)
 
     if [ -n "$gotcha_result" ] && ! echo "$gotcha_result" | grep -q "^NONE$"; then
         promoted=0
@@ -126,7 +146,7 @@ SUPERSEDED: <old decision> → <new decision> | file: <affected file if known>
 
 If none are superseded, output: NONE"
 
-    decision_result=$(eagle_llm_call "$decision_prompt" "You detect contradicting software decisions. Be precise." 512)
+    decision_result=$(eagle_llm_call "$decision_prompt" "You detect contradicting software decisions. Be precise." 512 || true)
 
     if [ -n "$decision_result" ] && ! echo "$decision_result" | grep -q "^NONE$"; then
         superseded=0
@@ -208,7 +228,7 @@ Where:
 
 If no rules needed, output: NONE"
 
-        cmd_result=$(eagle_llm_call "$cmd_prompt" "You optimize CLI output for AI assistants. Be conservative — only suggest rules for genuinely noisy commands." 512)
+        cmd_result=$(eagle_llm_call "$cmd_prompt" "You optimize CLI output for AI assistants. Be conservative — only suggest rules for genuinely noisy commands." 512 || true)
 
         if [ -n "$cmd_result" ] && ! echo "$cmd_result" | grep -q "^NONE$"; then
             rules_count=0
@@ -305,7 +325,7 @@ Rules:
 - Don't re-discover existing features
 - If no new features found, output: NONE"
 
-    feature_result=$(eagle_llm_call "$feature_prompt" "You identify software features from development session data. Be specific and evidence-based." 512)
+    feature_result=$(eagle_llm_call "$feature_prompt" "You identify software features from development session data. Be specific and evidence-based." 512 || true)
 
     if [ -n "$feature_result" ] && ! echo "$feature_result" | grep -q "^NONE$"; then
         features_count=0
@@ -428,7 +448,7 @@ if [ -n "$co_edit_data" ]; then
 
     if [ "$DRY_RUN" -eq 1 ]; then
         printf '%s\n' "$co_map_output" | while IFS='|' read -r f partners; do
-            [ -z "$f" ] && continue
+            if [ -z "$f" ]; then continue; fi
             eagle_info "    $(basename "$f") → $partners"
         done
     else
@@ -436,7 +456,7 @@ if [ -n "$co_edit_data" ]; then
             echo "BEGIN;"
             echo "DELETE FROM file_hints WHERE project = '$(eagle_sql_escape "$project")' AND hint_type = 'co_edit';"
             printf '%s\n' "$co_map_output" | while IFS='|' read -r f partners; do
-                [ -z "$f" ] && continue
+                if [ -z "$f" ]; then continue; fi
                 local_f=$(eagle_sql_escape "$f")
                 local_v=$(eagle_sql_escape "$partners")
                 echo "INSERT INTO file_hints (project, hint_type, file_path, hint_value) VALUES ('$(eagle_sql_escape "$project")', 'co_edit', '$local_f', '$local_v') ON CONFLICT(project, hint_type, file_path) DO UPDATE SET hint_value = excluded.hint_value, updated_at = strftime('%Y-%m-%dT%H:%M:%fZ', 'now');"
@@ -492,7 +512,7 @@ if [ -n "$hot_file_data" ]; then
     hot_count=0
 
     while IFS='|' read -r hf_path hf_reads hf_sessions hf_rps; do
-        [ -z "$hf_path" ] && continue
+        if [ -z "$hf_path" ]; then continue; fi
         if [ -n "$hot_files" ]; then
             hot_files+=","
         fi
@@ -529,7 +549,7 @@ eagle_info "Executing Dream Cycle (Knowledge Graph & Memory Consolidation)..."
 if [ -n "$co_edit_data" ]; then
     co_wire_count=0
     while IFS='|' read -r f1 f2 co_sessions; do
-        [ -z "$f1" ] || [ -z "$f2" ] && continue
+        if [ -z "$f1" ] || [ -z "$f2" ]; then continue; fi
         f1_id=$(eagle_graph_get_node_id "$project" "file" "$f1")
         f2_id=$(eagle_graph_get_node_id "$project" "file" "$f2")
         if [ -n "$f1_id" ] && [ -n "$f2_id" ]; then
@@ -543,41 +563,12 @@ if [ -n "$co_edit_data" ]; then
 fi
 
 # 7.2 Wire session nodes and access edges
-recent_sessions=$(eagle_db "SELECT id, started_at, model FROM sessions WHERE project = '$p_esc' ORDER BY started_at DESC LIMIT 15;")
+recent_sessions=$(eagle_db "SELECT id FROM sessions WHERE project = '$p_esc' ORDER BY started_at DESC LIMIT 15;")
 if [ -n "$recent_sessions" ]; then
-    session_wire_count=0
-    while IFS='|' read -r sid sstart smodel; do
-        [ -z "$sid" ] && continue
-        if [ "$DRY_RUN" -eq 0 ]; then
-            eagle_graph_add_node "$project" "session" "$sid" "Session run on $sstart using $smodel" ""
-            sid_node=$(eagle_graph_get_node_id "$project" "session" "$sid")
-            if [ -n "$sid_node" ]; then
-                # Find read/modified files in this session from observations
-                session_files=$(eagle_db "SELECT files_read, files_modified FROM observations WHERE session_id = '$(eagle_sql_escape "$sid")';")
-                if [ -n "$session_files" ]; then
-                    while IFS='|' read -r f_read f_mod; do
-                        # Parse files_read JSON list
-                        if [ -n "$f_read" ] && [ "$f_read" != "[]" ]; then
-                            echo "$f_read" | grep -oE '"[^"]+"' | tr -d '"' | while read -r rf; do
-                                [ -z "$rf" ] && continue
-                                rfid=$(eagle_graph_get_node_id "$project" "file" "$rf")
-                                [ -n "$rfid" ] && eagle_graph_add_edge "$project" "$sid_node" "$rfid" "read" 1.0
-                            done
-                        fi
-                        # Parse files_modified JSON list
-                        if [ -n "$f_mod" ] && [ "$f_mod" != "[]" ]; then
-                            echo "$f_mod" | grep -oE '"[^"]+"' | tr -d '"' | while read -r mf; do
-                                [ -z "$mf" ] && continue
-                                mfid=$(eagle_graph_get_node_id "$project" "file" "$mf")
-                                [ -n "$mfid" ] && eagle_graph_add_edge "$project" "$sid_node" "$mfid" "modified" 2.0
-                            done
-                        fi
-                    done <<< "$session_files"
-                fi
-            fi
-        fi
-        session_wire_count=$((session_wire_count + 1))
-    done <<< "$recent_sessions"
+    session_wire_count=$(printf '%s\n' "$recent_sessions" | awk 'NF {count++} END {print count + 0}')
+    if [ "$DRY_RUN" -eq 0 ]; then
+        session_wire_count=$(eagle_graph_wire_recent_session_edges "$project" 15)
+    fi
     eagle_ok "Wired $session_wire_count recent session nodes and edges"
 fi
 
@@ -603,7 +594,7 @@ CONSOLIDATE: <original memory name 1>, <original memory name 2> -> <new consolid
 
 If no memories need consolidation, output: NONE"
 
-    consolidation_result=$(eagle_llm_call "$consolidation_prompt" "You consolidate software development memories into a single compiled truth. Be precise. Output CONSOLIDATE lines or NONE." 1024)
+    consolidation_result=$(eagle_llm_call "$consolidation_prompt" "You consolidate software development memories into a single compiled truth. Be precise. Output CONSOLIDATE lines or NONE." 1024 || true)
 
     if [ -n "$consolidation_result" ] && ! echo "$consolidation_result" | grep -q "^NONE$"; then
         cons_count=0
@@ -620,7 +611,7 @@ If no memories need consolidation, output: NONE"
                     desc_part=$(echo "$rest_part" | grep -oE "description:[[:space:]]*[^|]+" | sed 's/description:[[:space:]]*//')
                     val_part=$(echo "$rest_part" | grep -oE "value:[[:space:]]*.+" | sed 's/value:[[:space:]]*//')
                     
-                    [ -z "$new_name" ] || [ -z "$names_part" ] && continue
+                    if [ -z "$new_name" ] || [ -z "$names_part" ]; then continue; fi
                     
                     if [ "$DRY_RUN" -eq 1 ]; then
                         eagle_info "  Would consolidate: $names_part → $new_name"
@@ -633,7 +624,7 @@ If no memories need consolidation, output: NONE"
                         IFS=',' read -ra name_arr <<< "$names_part"
                         for old_n in "${name_arr[@]}"; do
                             old_n=$(echo "$old_n" | sed 's/^[[:space:]]*//;s/[[:space:]]*$//')
-                            [ -z "$old_n" ] && continue
+                            if [ -z "$old_n" ]; then continue; fi
                             old_node_id=$(eagle_graph_get_node_id "$project" "memory" "$old_n")
                             if [ -n "$old_node_id" ] && [ -n "$new_node_id" ]; then
                                 eagle_graph_add_edge "$project" "$new_node_id" "$old_node_id" "supersedes" 1.0

package/scripts/help.sh

@@ -14,7 +14,7 @@ eagle_banner
 
 echo -e "  ${BOLD}Eagle Mem${RESET} ${DIM}v${version}${RESET}"
 echo -e "  ${DIM}Shared memory, release guardrails, RTK token protection, and worker lanes${RESET}"
-echo -e "  ${DIM}for Claude Code, Codex, and Grok.${RESET}"
+echo -e "  ${DIM}for Claude Code, Codex, Grok, and Google Antigravity.${RESET}"
 echo ""
 echo -e "  ${BOLD}Core commands:${RESET}"
 echo -e "    ${CYAN}install${RESET}     First-time setup: hooks, database, skills"
@@ -28,6 +28,7 @@ echo -e "    ${CYAN}overview${RESET}    Build or view project overview"
 echo -e "    ${CYAN}session${RESET}     Save a manual session summary"
 echo -e "    ${CYAN}memories${RESET}    View/sync agent memories"
 echo -e "    ${CYAN}tasks${RESET}       View mirrored tasks"
+echo -e "    ${CYAN}graph${RESET}       View, query, or rebuild the codebase knowledge graph"
 echo ""
 echo -e "  ${BOLD}Safety and token controls:${RESET}"
 echo -e "    ${CYAN}feature${RESET}       Track, verify, and unblock feature changes"
@@ -59,6 +60,8 @@ echo -e "    ${DIM}\$${RESET} eagle-mem search --tasks        ${DIM}# in-flight
 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 -e "    ${DIM}\$${RESET} eagle-mem session save --summary \"fixed auth\""
+echo -e "    ${DIM}\$${RESET} eagle-mem graph rebuild       ${DIM}# rebuild code graph + chunks${RESET}"
+echo -e "    ${DIM}\$${RESET} eagle-mem index --force       ${DIM}# force source chunk/declaration indexing${RESET}"
 echo ""
 echo -e "  ${BOLD}Anti-regression:${RESET}"
 echo -e "    ${DIM}\$${RESET} eagle-mem feature pending       ${DIM}# pending release blockers${RESET}"

package/scripts/index.sh

@@ -15,7 +15,28 @@ LIB_DIR="$SCRIPTS_DIR/../lib"
 
 eagle_ensure_db
 
-TARGET_DIR="${1:-.}"
+force=false
+args=()
+
+show_help() {
+    echo -e "  ${BOLD}eagle-mem index${RESET} — Index source files and wire code graph declarations"
+    echo ""
+    echo -e "  ${BOLD}Usage:${RESET}"
+    echo -e "    eagle-mem index [path]              ${DIM}# incrementally index changed files${RESET}"
+    echo -e "    eagle-mem index ${CYAN}--force${RESET} [path]      ${DIM}# rebuild chunks and static code graph edges${RESET}"
+    echo ""
+    exit 0
+}
+
+while [ $# -gt 0 ]; do
+    case "$1" in
+        --force|-f) force=true; shift ;;
+        --help|-h) show_help ;;
+        *) args+=("$1"); shift ;;
+    esac
+done
+
+TARGET_DIR="${args[0]:-.}"
 TARGET_DIR="$(cd "$TARGET_DIR" && pwd)"
 PROJECT=$(eagle_project_from_cwd "$TARGET_DIR")
 
@@ -106,10 +127,20 @@ NEEDS_INDEX="$TMPDIR_IDX/needs_index"
 
 skipped_count=0
 
+if [ "$force" = true ]; then
+    eagle_info "Force rebuild requested: clearing chunks, declarations, and import edges"
+    eagle_graph_clear_index_state "$PROJECT"
+fi
+
 while IFS= read -r file; do
     full_path="$TARGET_DIR/$file"
     current_mtime=$(stat -f '%m' "$full_path" 2>/dev/null || stat -c '%Y' "$full_path" 2>/dev/null || echo "0")
 
+    if [ "$force" = true ]; then
+        echo "$file"
+        continue
+    fi
+
     stored_mtime=$(eagle_db "SELECT MAX(mtime) FROM code_chunks WHERE project = '$project_sql' AND file_path = '$(eagle_sql_escape "$file")';")
 
     if [ -n "$stored_mtime" ] && [ "$stored_mtime" = "$current_mtime" ]; then
@@ -180,16 +211,26 @@ COMMIT;"
 
     # Static syntax relation extraction & graph wiring
     # Wire node & edge static parser
+    overview=$(eagle_get_overview "$PROJECT" 2>/dev/null || true)
+    eagle_graph_add_node "$PROJECT" "project" "$PROJECT" "$overview" ""
+    project_node_id=$(eagle_graph_get_node_id "$PROJECT" "project" "$PROJECT")
+    eagle_graph_add_node "$PROJECT" "file" "$file" "" "$full_path"
     file_node_id=$(eagle_graph_get_node_id "$PROJECT" "file" "$file")
     if [ -n "$file_node_id" ]; then
+        if [ -n "$project_node_id" ]; then
+            eagle_graph_add_edge "$PROJECT" "$project_node_id" "$file_node_id" "contains" 1.0 >/dev/null || true
+        fi
+        eagle_graph_reset_file_static_edges "$PROJECT" "$file" "$file_node_id"
+
         # 1. Parse function/class declarations
         # e.g., "def name", "class name", "fn name", "function name", "func name"
         declarations=$(grep -oE '\<(class|struct|function|def|fn|func)[[:space:]]+[A-Za-z0-9_]+' "$full_path" 2>/dev/null | awk '{print $1 ":" $2}' | sort -u || true)
         if [ -n "$declarations" ]; then
             while IFS=':' read -r dtype dname; do
                 [ -z "$dname" ] && continue
-                eagle_graph_add_node "$PROJECT" "$dtype" "$dname" "Declared in $file" "$file"
-                decl_node_id=$(eagle_graph_get_node_id "$PROJECT" "$dtype" "$dname")
+                decl_node_name=$(eagle_graph_declaration_node_name "$file" "$dname")
+                eagle_graph_add_node "$PROJECT" "$dtype" "$decl_node_name" "Declared $dname in $file" "$file"
+                decl_node_id=$(eagle_graph_get_node_id "$PROJECT" "$dtype" "$decl_node_name")
                 if [ -n "$decl_node_id" ]; then
                     eagle_graph_add_edge "$PROJECT" "$file_node_id" "$decl_node_id" "declares" 1.0
                 fi