eagle-mem 4.9.5 → 4.9.7

package/scripts/doctor.sh

@@ -0,0 +1,262 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════
+# Eagle Mem — Doctor
+# Read-only trust and install footprint checks.
+# ═══════════════════════════════════════════════════════════
+set -euo pipefail
+
+PACKAGE_DIR="${1:-.}"
+shift 2>/dev/null || true
+
+SCRIPTS_DIR="$(cd "$(dirname "$0")" && pwd)"
+LIB_DIR="$SCRIPTS_DIR/../lib"
+
+. "$SCRIPTS_DIR/style.sh"
+. "$LIB_DIR/common.sh"
+
+mode="install-footprint"
+json_output=false
+
+while [ $# -gt 0 ]; do
+    case "$1" in
+        --json|-j) json_output=true; shift ;;
+        --help|-h)
+            echo -e "  ${BOLD}eagle-mem doctor${RESET} — Trust and install diagnostics"
+            echo ""
+            echo -e "  ${BOLD}Usage:${RESET}"
+            echo -e "    eagle-mem doctor"
+            echo -e "    eagle-mem doctor install-footprint"
+            echo ""
+            echo -e "  ${BOLD}Options:${RESET}"
+            echo -e "    ${CYAN}-j, --json${RESET}  Output structured JSON"
+            exit 0
+            ;;
+        install-footprint|footprint)
+            mode="$1"
+            shift
+            ;;
+        *) shift ;;
+    esac
+done
+
+case "$mode" in
+    install-footprint|footprint|"") ;;
+    *)
+        eagle_err "Unknown doctor check: $mode"
+        eagle_dim "Run: eagle-mem doctor --help"
+        exit 1
+        ;;
+esac
+
+package_version=$(jq -r .version "$PACKAGE_DIR/package.json" 2>/dev/null || echo "unknown")
+installed_version=$(tr -d '[:space:]' < "$EAGLE_MEM_DIR/.version" 2>/dev/null || true)
+[ -z "$installed_version" ] && installed_version="not installed"
+
+sqlite_bin=$(eagle_sqlite_path)
+sqlite_version=$(eagle_sqlite_version)
+sqlite_fts5=false
+if eagle_sqlite_supports_fts5; then
+    sqlite_fts5=true
+fi
+
+runtime_exists=false
+db_exists=false
+[ -d "$EAGLE_MEM_DIR" ] && runtime_exists=true
+[ -f "$EAGLE_MEM_DB" ] && db_exists=true
+
+doctor_compare_group() {
+    local group="$1"
+    local checked=0 missing=0 drift=0
+    local src dst
+    for src in "$PACKAGE_DIR/$group"/*; do
+        [ -f "$src" ] || continue
+        case "$group" in
+            db) ;;
+            *)
+                case "$src" in
+                    *.sh|*/eagle-mem) ;;
+                    *) continue ;;
+                esac
+                ;;
+        esac
+        checked=$((checked + 1))
+        dst="$EAGLE_MEM_DIR/$group/$(basename "$src")"
+        if [ ! -f "$dst" ]; then
+            missing=$((missing + 1))
+        elif ! cmp -s "$src" "$dst"; then
+            drift=$((drift + 1))
+        fi
+    done
+    printf '%s|%s|%s\n' "$checked" "$missing" "$drift"
+}
+
+hooks_cmp=$(doctor_compare_group hooks)
+lib_cmp=$(doctor_compare_group lib)
+db_cmp=$(doctor_compare_group db)
+scripts_cmp=$(doctor_compare_group scripts)
+manifest_path=$(eagle_runtime_manifest_path)
+manifest_check=$(eagle_runtime_manifest_check)
+manifest_status="${manifest_check%%|*}"
+manifest_checked=$(printf '%s' "$manifest_check" | cut -d'|' -f2)
+manifest_missing=$(printf '%s' "$manifest_check" | cut -d'|' -f3)
+manifest_drift=$(printf '%s' "$manifest_check" | cut -d'|' -f4)
+manifest_version=$(eagle_runtime_manifest_field '.package.version' 2>/dev/null || true)
+manifest_action=$(eagle_runtime_manifest_field '.action' 2>/dev/null || true)
+manifest_generated_at=$(eagle_runtime_manifest_field '.generated_at' 2>/dev/null || true)
+manifest_package_dir=$(eagle_runtime_manifest_field '.package.dir' 2>/dev/null || true)
+
+sum_missing=0
+sum_drift=0
+for row in "$hooks_cmp" "$lib_cmp" "$db_cmp" "$scripts_cmp"; do
+    IFS='|' read -r _checked missing drift <<< "$row"
+    sum_missing=$((sum_missing + missing))
+    sum_drift=$((sum_drift + drift))
+done
+
+claude_hooks="not found"
+if [ -f "$EAGLE_SETTINGS" ] && command -v jq >/dev/null 2>&1; then
+    if jq -e '.. | objects | .command? // empty | select(test("eagle-mem|\\.eagle-mem"))' "$EAGLE_SETTINGS" >/dev/null 2>&1; then
+        claude_hooks="registered"
+    else
+        claude_hooks="not registered"
+    fi
+fi
+
+codex_hooks="not found"
+if [ -f "$EAGLE_CODEX_HOOKS" ] && command -v jq >/dev/null 2>&1; then
+    if jq -e '.. | objects | .command? // empty | select(test("eagle-mem|\\.eagle-mem"))' "$EAGLE_CODEX_HOOKS" >/dev/null 2>&1; then
+        codex_hooks="registered"
+    else
+        codex_hooks="not registered"
+    fi
+fi
+
+statusline_state="not configured"
+statusline_command=""
+if [ -f "$EAGLE_SETTINGS" ] && command -v jq >/dev/null 2>&1; then
+    statusline_command=$(jq -r '.statusLine.command // .statusline.command // empty' "$EAGLE_SETTINGS" 2>/dev/null)
+    if [ -n "$statusline_command" ]; then
+        if printf '%s' "$statusline_command" | grep -qE 'eagle-mem|\.eagle-mem'; then
+            statusline_state="registered"
+        else
+            sl_file=$(eagle_statusline_script_from_command "$statusline_command" 2>/dev/null || true)
+            if [ -n "$sl_file" ] && grep -qE 'eagle_mem_statusline|\.eagle-mem/scripts/statusline-em' "$sl_file" 2>/dev/null; then
+                statusline_state="registered"
+            else
+                statusline_state="custom"
+            fi
+        fi
+    fi
+fi
+
+overall="Healthy"
+if [ "$runtime_exists" != true ] || [ "$db_exists" != true ]; then
+    overall="Not installed"
+elif [ "$sqlite_fts5" != true ] || [ "$sum_missing" -gt 0 ] || [ "$sum_drift" -gt 0 ] || [ "$manifest_status" != "ok" ]; then
+    overall="Needs attention"
+fi
+
+if [ "$json_output" = true ]; then
+    jq -nc \
+        --arg overall "$overall" \
+        --arg package_dir "$PACKAGE_DIR" \
+        --arg runtime_dir "$EAGLE_MEM_DIR" \
+        --arg db "$EAGLE_MEM_DB" \
+        --arg package_version "$package_version" \
+        --arg installed_version "$installed_version" \
+        --arg sqlite_bin "${sqlite_bin:-}" \
+        --arg sqlite_version "${sqlite_version:-}" \
+        --argjson sqlite_fts5 "$sqlite_fts5" \
+        --arg claude_hooks "$claude_hooks" \
+        --arg codex_hooks "$codex_hooks" \
+        --arg statusline "$statusline_state" \
+        --arg hooks_cmp "$hooks_cmp" \
+        --arg lib_cmp "$lib_cmp" \
+        --arg db_cmp "$db_cmp" \
+        --arg scripts_cmp "$scripts_cmp" \
+        --arg manifest_path "$manifest_path" \
+        --arg manifest_status "$manifest_status" \
+        --argjson manifest_checked "${manifest_checked:-0}" \
+        --argjson manifest_missing "${manifest_missing:-0}" \
+        --argjson manifest_drift "${manifest_drift:-0}" \
+        --arg manifest_version "${manifest_version:-}" \
+        --arg manifest_action "${manifest_action:-}" \
+        --arg manifest_generated_at "${manifest_generated_at:-}" \
+        --arg manifest_package_dir "${manifest_package_dir:-}" \
+        '{overall:$overall, package_dir:$package_dir, runtime_dir:$runtime_dir, db:$db,
+          versions:{package:$package_version, installed:$installed_version},
+          sqlite:{path:$sqlite_bin, version:$sqlite_version, fts5:$sqlite_fts5},
+          hooks:{claude:$claude_hooks, codex:$codex_hooks, statusline:$statusline},
+          runtime_drift:{hooks:$hooks_cmp, lib:$lib_cmp, db:$db_cmp, scripts:$scripts_cmp},
+          manifest:{path:$manifest_path, status:$manifest_status, checked:$manifest_checked,
+                    missing:$manifest_missing, drift:$manifest_drift, version:$manifest_version,
+                    action:$manifest_action, generated_at:$manifest_generated_at,
+                    package_dir:$manifest_package_dir}}'
+    exit 0
+fi
+
+eagle_header "Doctor"
+echo -e "  ${BOLD}Overall:${RESET} $overall"
+echo ""
+echo -e "  ${BOLD}Install footprint${RESET}"
+eagle_kv "Package:" "$PACKAGE_DIR"
+eagle_kv "Runtime:" "$EAGLE_MEM_DIR"
+eagle_kv "Database:" "$EAGLE_MEM_DB"
+eagle_kv "Version:" "package $package_version, installed $installed_version"
+echo ""
+
+echo -e "  ${BOLD}SQLite${RESET}"
+if [ -n "$sqlite_bin" ]; then
+    eagle_kv "Binary:" "$sqlite_bin"
+    eagle_kv "Version:" "${sqlite_version:-unknown}"
+    if [ "$sqlite_fts5" = true ]; then
+        eagle_ok "FTS5 available"
+    else
+        eagle_fail "FTS5 unavailable"
+    fi
+else
+    eagle_fail "SQLite not found"
+fi
+echo ""
+
+echo -e "  ${BOLD}Hooks${RESET}"
+eagle_kv "Claude Code:" "$claude_hooks"
+eagle_kv "Codex:" "$codex_hooks"
+eagle_kv "Statusline:" "$statusline_state"
+echo ""
+
+echo -e "  ${BOLD}Install manifest${RESET}"
+eagle_kv "Path:" "$manifest_path"
+if [ "$manifest_status" = "ok" ]; then
+    eagle_ok "${manifest_checked:-0} files match manifest"
+else
+    eagle_warn "status=$manifest_status, checked=${manifest_checked:-0}, missing=${manifest_missing:-0}, drift=${manifest_drift:-0}"
+fi
+[ -n "$manifest_version" ] && eagle_kv "Version:" "$manifest_version"
+[ -n "$manifest_action" ] && eagle_kv "Action:" "$manifest_action"
+[ -n "$manifest_generated_at" ] && eagle_kv "Generated:" "$manifest_generated_at"
+echo ""
+
+echo -e "  ${BOLD}Runtime drift${RESET}"
+for label_row in "hooks:$hooks_cmp" "lib:$lib_cmp" "db:$db_cmp" "scripts:$scripts_cmp"; do
+    label="${label_row%%:*}"
+    row="${label_row#*:}"
+    IFS='|' read -r checked missing drift <<< "$row"
+    if [ "$missing" -eq 0 ] && [ "$drift" -eq 0 ] 2>/dev/null; then
+        eagle_ok "$label: $checked checked, no drift"
+    else
+        eagle_warn "$label: $checked checked, $missing missing, $drift drifted"
+    fi
+done
+echo ""
+
+echo -e "  ${BOLD}Next${RESET}"
+if [ "$overall" = "Healthy" ]; then
+    eagle_ok "Installed runtime matches this package."
+else
+    [ "$runtime_exists" != true ] && eagle_info "Run: eagle-mem install"
+    [ "$manifest_status" != "ok" ] && eagle_info "Run: eagle-mem update to refresh the install manifest."
+    [ "$sum_missing" -gt 0 ] || [ "$sum_drift" -gt 0 ] && eagle_info "Run: eagle-mem update"
+    [ "$sqlite_fts5" != true ] && eagle_info "Set EAGLE_SQLITE_BIN to an FTS5-capable sqlite3."
+fi
+echo ""

package/scripts/feature.sh

@@ -18,6 +18,7 @@ eagle_header "Features"
 project=$(eagle_project_from_cwd "$(pwd)")
 subcommand="${1:-list}"
 shift 2>/dev/null || true
+raw_output=false
 
 case "$subcommand" in
     list|ls)
@@ -73,28 +74,53 @@ case "$subcommand" in
         ;;
 
     pending)
+        limit=50
+        while [ $# -gt 0 ]; do
+            case "$1" in
+                --raw|--debug) raw_output=true; shift ;;
+                --limit|-n) limit="$2"; shift 2 ;;
+                --project|-p) project="$2"; shift 2 ;;
+                *) shift ;;
+            esac
+        done
+        limit=$(eagle_sql_int "$limit")
+        [ "$limit" -eq 0 ] && limit=50
         results=$(eagle_list_pending_feature_verifications "$project" 50)
         if [ -z "$results" ]; then
             eagle_ok "No pending feature verifications for '$project'"
             exit 0
         fi
 
-        echo -e "  ${BOLD}ID   Feature                        File                         Trigger   Diff${RESET}"
-        echo -e "  ${DIM}──── ────────────────────────────── ──────────────────────────── ───────── ────────────${RESET}"
+        pending_count=$(printf '%s\n' "$results" | sed '/^[[:space:]]*$/d' | wc -l | tr -d ' ')
+        echo -e "  ${BOLD}Pending verification${RESET} ${DIM}($project)${RESET}"
+        echo -e "  ${DIM}${pending_count} check(s) must be verified or waived before release-boundary commands.${RESET}"
+        echo ""
+
+        shown=0
         while IFS='|' read -r id feat file reason trigger created smoke fingerprint; do
             [ -z "$id" ] && continue
-            feat_display="${feat:0:30}"
-            file_display="${file:0:28}"
-            trigger_display="${trigger:-hook}"
-            fingerprint_display="${fingerprint:-unknown}"
-            printf "  %-4s %-30s %-28s %-9s %-12s\n" "$id" "$feat_display" "$file_display" "$trigger_display" "$fingerprint_display"
-            [ -n "$reason" ] && echo -e "       ${DIM}${reason}${RESET}"
-            [ -n "$smoke" ] && echo -e "       ${CYAN}smoke:${RESET} $smoke"
-            [ -n "$created" ] && echo -e "       ${DIM}created: $created${RESET}"
+            [ "$shown" -ge "$limit" ] && break
+            shown=$((shown + 1))
+            echo -e "  ${BOLD}${shown}. ${feat}${RESET} ${DIM}#${id}${RESET}"
+            [ -n "$file" ] && echo -e "     ${DIM}File:${RESET} $file"
+            [ -n "$reason" ] && echo -e "     ${DIM}Why:${RESET} $reason"
+            [ -n "$smoke" ] && echo -e "     ${CYAN}Smoke:${RESET} $smoke"
+            if [ "$raw_output" = true ]; then
+                [ -n "$trigger" ] && echo -e "     ${DIM}Trigger:${RESET} $trigger"
+                [ -n "$fingerprint" ] && echo -e "     ${DIM}Diff:${RESET} $fingerprint"
+                [ -n "$created" ] && echo -e "     ${DIM}Created:${RESET} $created"
+            fi
+            echo ""
         done <<< "$results"
-        echo ""
+        if [ "$pending_count" -gt "$shown" ] 2>/dev/null; then
+            eagle_dim "$((pending_count - shown)) more pending; run with --limit $pending_count to show all."
+            echo ""
+        fi
         eagle_info "Verify after testing: eagle-mem feature verify <name> --notes \"what passed\""
         eagle_info "Waive intentionally: eagle-mem feature waive <id> --reason \"why safe\""
+        if [ "$raw_output" = false ]; then
+            eagle_dim "Run with --raw to show trigger, diff fingerprint, and created timestamp."
+        fi
         ;;
 
     waive)

package/scripts/health.sh

@@ -1,8 +1,8 @@
 #!/usr/bin/env bash
-# ════════��══════════��═══════════════════════════════════════
+# ═══════════════════════════════════════════════════════════
 # Eagle Mem — Health Check
 # Diagnoses how well the self-learning pipeline is working
-# ════════���══════════════════════════════════════════════════
+# ═══════════════════════════════════════════════════════════
 set -euo pipefail
 
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
@@ -51,7 +51,7 @@ score=0
 max_score=0
 issues=()
 
-# ─��─ 1. Summary capture rate (25 pts) ───────────────────
+# ─── 1. Summary capture rate (25 pts) ───────────────────
 
 max_score=$((max_score + 25))
 
@@ -263,10 +263,10 @@ else
     issues+=("Run: eagle-mem curate --dry-run")
 fi
 
-# ─── Score ───────���────────────────────────────────────────
+# ─── Score ────────────────────────────────────────────────
 
 echo ""
-echo -e "  ${DIM}────���────────────────────────────────${RESET}"
+echo -e "  ${DIM}─────────────────────────────────────${RESET}"
 
 pct=$((score * 100 / max_score))
 if [ "$pct" -ge 80 ]; then
@@ -280,14 +280,17 @@ else
     grade="Unhealthy"
 fi
 
-echo -e "  ${BOLD}Score: ${color}${score}/${max_score} (${pct}%)${RESET}  ${color}${grade}${RESET}"
+echo -e "  ${BOLD}Overall:${RESET} ${color}${grade}${RESET}  ${DIM}${score}/${max_score} (${pct}%)${RESET}"
 
 if [ ${#issues[@]} -gt 0 ]; then
     echo ""
-    echo -e "  ${BOLD}Issues:${RESET}"
+    echo -e "  ${BOLD}Next:${RESET}"
     for issue in "${issues[@]}"; do
         echo -e "    ${YELLOW}!${RESET} $issue"
     done
+else
+    echo ""
+    eagle_ok "No immediate action needed."
 fi
 
 eagle_footer "Health check complete."

package/scripts/help.sh

@@ -22,6 +22,7 @@ echo -e "    ${CYAN}update${RESET}      Re-deploy hooks and run migrations"
 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}doctor${RESET}      Show install footprint, hooks, SQLite, manifest, and runtime drift"
 echo -e "    ${CYAN}updates${RESET}     Auto-update status and policy"
 echo -e "    ${CYAN}overview${RESET}    Build or view project overview"
 echo -e "    ${CYAN}session${RESET}     Save a manual session summary"

package/scripts/install.sh

@@ -180,6 +180,8 @@ if [ "$prereqs_ok" = false ]; then
     exit 1
 fi
 
+eagle_runtime_change_plan "install" "$PACKAGE_DIR" "$claude_found" "$codex_found"
+
 echo ""
 
 # ─── Copy files to ~/.eagle-mem/ ───────────────────────────
@@ -334,8 +336,7 @@ WRAPPER
                 eagle_dim "    # ── Eagle Mem ──"
                 eagle_dim "    em_section=\"\""
                 eagle_dim "    if [ -f \"\$HOME/.eagle-mem/scripts/statusline-em.sh\" ]; then"
-                eagle_dim "      source \"\$HOME/.eagle-mem/scripts/statusline-em.sh\""
-                eagle_dim "      em_section=\$(eagle_mem_statusline \"\$project_dir\" \"\$session_id\" \"\$input\")"
+                eagle_dim "      em_section=\$(printf '%s' \"\$input\" | bash \"\$HOME/.eagle-mem/scripts/statusline-em.sh\" --hud)"
                 eagle_dim "    fi"
                 echo ""
                 eagle_ok "Statusline ${DIM}(manual patch needed — instructions above)${RESET}"
@@ -365,7 +366,7 @@ eagle_ok "Auto-updates ${DIM}(mode=$(eagle_update_config_mode), allow=$(eagle_up
 
 if [ "$claude_found" = true ]; then
     if eagle_patch_claude_md; then
-        eagle_ok "CLAUDE.md ${DIM}(eagle-summary instructions added)${RESET}"
+  eagle_ok "CLAUDE.md ${DIM}(Eagle Mem guidance added)${RESET}"
     else
         eagle_ok "CLAUDE.md ${DIM}(already has Eagle Mem section)${RESET}"
     fi
@@ -384,6 +385,11 @@ fi
 version=$(jq -r .version "$PACKAGE_DIR/package.json" 2>/dev/null || echo "unknown")
 echo "$version" > "$EAGLE_MEM_DIR/.version"
 echo "$version" > "$EAGLE_MEM_DIR/.latest-version"
+if eagle_runtime_manifest_write "$PACKAGE_DIR" "install"; then
+    eagle_ok "Install manifest written"
+else
+    eagle_warn "Install manifest could not be written"
+fi
 
 # ─── Summary ───────────────────────────────────────────────