eagle-mem 2.0.6 → 3.0.0

package/README.md

@@ -1,6 +1,7 @@
 ```
-█▀▀ ▄▀█ █▀▀ █   █▀▀   █▀▄▀█ █▀▀ █▀▄▀█
-██▄ █▀█ █▄█ █▄▄ ██▄   █ ▀ █ ██▄ █ ▀ █
+======================================
+Eagle Mem
+======================================
 ```
 
 # Eagle Mem
@@ -21,12 +22,19 @@ eagle-mem install
 **2. Open Claude Code** in any project directory. Eagle Mem activates and shows what it loaded:
 
 ```
-█▀▀ ▄▀█ █▀▀ █   █▀▀   █▀▄▀█ █▀▀ █▀▄▀█
-██▄ █▀█ █▄█ █▄▄ ██▄   █ ▀ █ ██▄ █ ▀ █
-
-Project: my-app
-Sessions: 5 recent | Memories: 3 | Tasks: 2 pending
-Last: Added auth middleware with JWT validation
+======================================
+       Eagle Mem Loaded
+======================================
+ Project      | my-app
+ Sessions     | 42 total (18 with summaries)
+ Memories     | 7 stored
+ Plans        | 2 saved
+ Tasks        | 1 in progress, 3 pending, 12 completed
+ Code Index   | 156 chunks indexed
+ Observations | 340 captured
+ Last Active  | 2026-04-28
+ Last Work    | Added auth middleware with JWT validation
+======================================
 ```
 
 From here, everything is automatic. You don't run any commands — Eagle Mem captures session summaries, mirrors Claude's memories and tasks, and re-injects context after every `/compact` or new session.

package/bin/eagle-mem

@@ -27,6 +27,9 @@ case "$command" in
     refresh)    bash "$SCRIPTS_DIR/refresh.sh" "$@" ;;
     prune)      bash "$SCRIPTS_DIR/prune.sh" "$@" ;;
     memories)   bash "$SCRIPTS_DIR/memories.sh" "$@" ;;
+    config)     bash "$SCRIPTS_DIR/config.sh" "$@" ;;
+    curate)     bash "$SCRIPTS_DIR/curate.sh" "$@" ;;
+    feature)    bash "$SCRIPTS_DIR/feature.sh" "$@" ;;
     help|--help|-h)
                 bash "$SCRIPTS_DIR/help.sh" ;;
     version|--version|-v|-V)

package/db/012_enriched_summaries.sql

@@ -0,0 +1,51 @@
+-- Migration 012: Add decisions, gotchas, key_files columns to summaries
+-- These capture WHY choices were made, WHAT went wrong, and WHERE to start reading.
+-- Also adds them to FTS5 so they're searchable across sessions.
+
+-- Add new columns
+ALTER TABLE summaries ADD COLUMN decisions TEXT;
+ALTER TABLE summaries ADD COLUMN gotchas TEXT;
+ALTER TABLE summaries ADD COLUMN key_files TEXT;
+
+-- Rebuild FTS5 to include new columns
+DROP TRIGGER IF EXISTS summaries_ai;
+DROP TRIGGER IF EXISTS summaries_ad;
+DROP TRIGGER IF EXISTS summaries_au;
+
+DROP TABLE IF EXISTS summaries_fts;
+
+CREATE VIRTUAL TABLE summaries_fts USING fts5(
+    request,
+    investigated,
+    learned,
+    completed,
+    next_steps,
+    notes,
+    decisions,
+    gotchas,
+    key_files,
+    content='summaries',
+    content_rowid='id'
+);
+
+-- Backfill FTS from existing data
+INSERT INTO summaries_fts(rowid, request, investigated, learned, completed, next_steps, notes, decisions, gotchas, key_files)
+SELECT id, request, investigated, learned, completed, next_steps, notes, decisions, gotchas, key_files FROM summaries;
+
+-- Recreate content-sync triggers with new columns
+CREATE TRIGGER summaries_ai AFTER INSERT ON summaries BEGIN
+    INSERT INTO summaries_fts(rowid, request, investigated, learned, completed, next_steps, notes, decisions, gotchas, key_files)
+    VALUES (new.id, new.request, new.investigated, new.learned, new.completed, new.next_steps, new.notes, new.decisions, new.gotchas, new.key_files);
+END;
+
+CREATE TRIGGER summaries_ad AFTER DELETE ON summaries BEGIN
+    INSERT INTO summaries_fts(summaries_fts, rowid, request, investigated, learned, completed, next_steps, notes, decisions, gotchas, key_files)
+    VALUES ('delete', old.id, old.request, old.investigated, old.learned, old.completed, old.next_steps, old.notes, old.decisions, old.gotchas, old.key_files);
+END;
+
+CREATE TRIGGER summaries_au AFTER UPDATE ON summaries BEGIN
+    INSERT INTO summaries_fts(summaries_fts, rowid, request, investigated, learned, completed, next_steps, notes, decisions, gotchas, key_files)
+    VALUES ('delete', old.id, old.request, old.investigated, old.learned, old.completed, old.next_steps, old.notes, old.decisions, old.gotchas, old.key_files);
+    INSERT INTO summaries_fts(rowid, request, investigated, learned, completed, next_steps, notes, decisions, gotchas, key_files)
+    VALUES (new.id, new.request, new.investigated, new.learned, new.completed, new.next_steps, new.notes, new.decisions, new.gotchas, new.key_files);
+END;

package/db/013_features.sql

@@ -0,0 +1,69 @@
+-- Migration 013: Feature graph for deployment regression prevention
+-- Features are persistent entities with lifecycle, dependencies, files, and smoke tests.
+-- Auto-discovered by curator from accumulated session data (tasks, key_files, decisions).
+
+CREATE TABLE IF NOT EXISTS features (
+    id INTEGER PRIMARY KEY,
+    project TEXT NOT NULL,
+    name TEXT NOT NULL,
+    description TEXT,
+    status TEXT DEFAULT 'active',
+    last_verified_at TIMESTAMP,
+    last_verified_notes TEXT,
+    created_at TIMESTAMP DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    updated_at TIMESTAMP DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    UNIQUE(project, name)
+);
+
+CREATE TABLE IF NOT EXISTS feature_dependencies (
+    id INTEGER PRIMARY KEY,
+    feature_id INTEGER NOT NULL,
+    kind TEXT NOT NULL,
+    target TEXT NOT NULL,
+    name TEXT NOT NULL,
+    notes TEXT,
+    FOREIGN KEY (feature_id) REFERENCES features(id) ON DELETE CASCADE,
+    UNIQUE(feature_id, kind, target, name)
+);
+
+CREATE TABLE IF NOT EXISTS feature_files (
+    id INTEGER PRIMARY KEY,
+    feature_id INTEGER NOT NULL,
+    file_path TEXT NOT NULL,
+    role TEXT,
+    FOREIGN KEY (feature_id) REFERENCES features(id) ON DELETE CASCADE,
+    UNIQUE(feature_id, file_path)
+);
+
+CREATE TABLE IF NOT EXISTS feature_smoke_tests (
+    id INTEGER PRIMARY KEY,
+    feature_id INTEGER NOT NULL,
+    command TEXT NOT NULL,
+    description TEXT,
+    FOREIGN KEY (feature_id) REFERENCES features(id) ON DELETE CASCADE
+);
+
+-- FTS5 for feature search
+CREATE VIRTUAL TABLE IF NOT EXISTS features_fts USING fts5(
+    name,
+    description,
+    content='features',
+    content_rowid='id'
+);
+
+CREATE TRIGGER IF NOT EXISTS features_ai AFTER INSERT ON features BEGIN
+    INSERT INTO features_fts(rowid, name, description)
+    VALUES (new.id, new.name, new.description);
+END;
+
+CREATE TRIGGER IF NOT EXISTS features_ad AFTER DELETE ON features BEGIN
+    INSERT INTO features_fts(features_fts, rowid, name, description)
+    VALUES ('delete', old.id, old.name, old.description);
+END;
+
+CREATE TRIGGER IF NOT EXISTS features_au AFTER UPDATE ON features BEGIN
+    INSERT INTO features_fts(features_fts, rowid, name, description)
+    VALUES ('delete', old.id, old.name, old.description);
+    INSERT INTO features_fts(rowid, name, description)
+    VALUES (new.id, new.name, new.description);
+END;

package/db/014_command_intelligence.sql

@@ -0,0 +1,25 @@
+-- Migration 014: Command intelligence — output size tracking + command rules
+-- Adds output metrics to observations for adaptive command filtering.
+
+ALTER TABLE observations ADD COLUMN output_bytes INTEGER;
+ALTER TABLE observations ADD COLUMN output_lines INTEGER;
+ALTER TABLE observations ADD COLUMN command_category TEXT;
+
+-- Command rules table — populated by curator, consumed by PreToolUse hook
+CREATE TABLE IF NOT EXISTS command_rules (
+    id INTEGER PRIMARY KEY,
+    project TEXT,
+    pattern TEXT NOT NULL,
+    strategy TEXT NOT NULL DEFAULT 'summary',
+    max_lines INTEGER,
+    reason TEXT,
+    times_seen INTEGER DEFAULT 0,
+    avg_output_bytes INTEGER DEFAULT 0,
+    enabled INTEGER DEFAULT 1,
+    created_at TIMESTAMP DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    updated_at TIMESTAMP DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    UNIQUE(project, pattern)
+);
+
+CREATE INDEX IF NOT EXISTS idx_command_rules_pattern ON command_rules(pattern);
+CREATE INDEX IF NOT EXISTS idx_observations_category ON observations(command_category);

package/hooks/post-tool-use.sh

@@ -34,6 +34,9 @@ project=$(eagle_project_from_cwd "$cwd")
 files_read="[]"
 files_modified="[]"
 tool_summary=""
+output_bytes=""
+output_lines=""
+command_category=""
 
 case "$tool_name" in
     Read)
@@ -53,24 +56,34 @@ case "$tool_name" in
         ;;
     Bash)
         cmd=$(echo "$input" | jq -r '.tool_input.command // empty' | cut -c1-200)
-        # Redact common secret patterns before storing
-        cmd=$(echo "$cmd" | sed -E \
-            -e 's/(Bearer )[^ ]*/\1[REDACTED]/gi' \
-            -e 's/(api[_-]?key[= :])[^ ]*/\1[REDACTED]/gi' \
-            -e 's/(password[= :])[^ ]*/\1[REDACTED]/gi' \
-            -e 's/(secret[= :])[^ ]*/\1[REDACTED]/gi' \
-            -e 's/(token[= :])[^ ]*/\1[REDACTED]/gi' \
-            -e 's/(Authorization: )[^ ]*/\1[REDACTED]/gi' \
-            -e 's/sk_live_[A-Za-z0-9]+/[REDACTED]/g' \
-            -e 's/sk_test_[A-Za-z0-9]+/[REDACTED]/g' \
-            -e 's/AKIA[A-Z0-9]{16}/[REDACTED]/g' \
-            -e 's/ghp_[A-Za-z0-9]{36}/[REDACTED]/g' \
-            -e 's/gho_[A-Za-z0-9]{36}/[REDACTED]/g' \
-            -e 's/sk-ant-[A-Za-z0-9_-]+/[REDACTED]/g' \
-            -e 's/sk-[A-Za-z0-9]{20,}/[REDACTED]/g' \
-            -e 's/(ANTHROPIC_API_KEY[= :])[^ ]*/\1[REDACTED]/g' \
-            -e 's/(OPENAI_API_KEY[= :])[^ ]*/\1[REDACTED]/g')
+        cmd=$(echo "$cmd" | eagle_redact)
         tool_summary="Bash: $cmd"
+
+        # Output metrics
+        tool_output=$(echo "$input" | jq -r '.tool_result.stdout // empty' 2>/dev/null)
+        if [ -n "$tool_output" ]; then
+            output_bytes=${#tool_output}
+            output_lines=$(echo "$tool_output" | wc -l | tr -d ' ')
+        fi
+
+        # Command category extraction
+        first_word=$(echo "$cmd" | awk '{print $1}' | sed 's|.*/||')
+        case "$first_word" in
+            git|gh) command_category="git" ;;
+            npm|npx|pnpm|yarn|bun) command_category="js" ;;
+            pip|pip3|python|python3|uv) command_category="python" ;;
+            cargo|rustc) command_category="rust" ;;
+            go) command_category="go" ;;
+            docker|docker-compose|podman) command_category="docker" ;;
+            kubectl|helm|k9s) command_category="k8s" ;;
+            aws|gcloud|az) command_category="cloud" ;;
+            make|cmake|ninja) command_category="build" ;;
+            grep|find|ls|cat|head|tail|wc|sort|sed|awk) command_category="files" ;;
+            curl|wget|http) command_category="http" ;;
+            *test*|jest|pytest|vitest|mocha) command_category="test" ;;
+            *lint*|eslint|ruff|golangci-lint) command_category="lint" ;;
+            *) command_category="other" ;;
+        esac
         ;;
     TaskCreate|TaskUpdate)
         task_subject=$(echo "$input" | jq -r '.tool_input.subject // empty')
@@ -124,6 +137,106 @@ case "$tool_name" in
         ;;
 esac
 
-eagle_insert_observation "$session_id" "$project" "$tool_name" "$tool_summary" "$files_read" "$files_modified"
+# ─── Stale memory hint ──────────────────────────────────
+# After editing a project file, FTS5-search memories for the filename.
+# If a memory mentions this file, remind Claude to check for staleness.
+case "$tool_name" in
+    Write|Edit)
+        if [ -n "$fp" ]; then
+            fname=$(basename "$fp")
+            fname_stem="${fname%.*}"
+            case "$fp" in
+                "$HOME/.claude/"*) ;; # skip Claude config files
+                *)
+                    if [ ${#fname_stem} -ge 3 ]; then
+                        fts_query=$(eagle_fts_sanitize "$fname_stem")
+                        if [ -n "$fts_query" ]; then
+                            fts_esc=$(eagle_sql_escape "$fts_query")
+                            p_esc=$(eagle_sql_escape "$project")
+                            stale_hit=$(eagle_db "SELECT m.memory_name
+                                FROM claude_memories m
+                                JOIN claude_memories_fts f ON f.rowid = m.id
+                                WHERE claude_memories_fts MATCH '$fts_esc'
+                                AND m.project = '$p_esc'
+                                LIMIT 1;")
+                            if [ -n "$stale_hit" ]; then
+                                stale_msg="Eagle Mem: Memory '${stale_hit}' may reference '${fname}'. If your edit contradicts it, update the memory."
+                                jq -nc --arg ctx "$stale_msg" '{"hookSpecificOutput":{"hookEventName":"PostToolUse","additionalContext":$ctx}}'
+                            fi
+                        fi
+                    fi
+                    ;;
+            esac
+        fi
+        ;;
+esac
+
+# ─── Decision + feature surfacing on Read ──────────────────
+# When Claude reads a file, surface past decisions and feature pipeline context.
+case "$tool_name" in
+    Read)
+        if [ -n "$fp" ]; then
+            fname=$(basename "$fp")
+            fname_stem="${fname%.*}"
+            read_context=""
+            case "$fp" in
+                "$HOME/.claude/"*) ;; # skip Claude config files
+                *)
+                    p_esc=$(eagle_sql_escape "$project")
+
+                    # Decision history from summaries
+                    if [ ${#fname_stem} -ge 3 ]; then
+                        fts_query=$(eagle_fts_sanitize "$fname_stem")
+                        if [ -n "$fts_query" ]; then
+                            fts_esc=$(eagle_sql_escape "$fts_query")
+                            decision_hit=$(eagle_db "SELECT s.decisions
+                                FROM summaries s
+                                JOIN summaries_fts f ON f.rowid = s.id
+                                WHERE summaries_fts MATCH '$fts_esc'
+                                AND s.project = '$p_esc'
+                                AND s.decisions IS NOT NULL
+                                AND s.decisions != ''
+                                ORDER BY s.created_at DESC
+                                LIMIT 1;")
+                            if [ -n "$decision_hit" ]; then
+                                read_context+="Eagle Mem decision history for '${fname}': ${decision_hit} — Do not revert without explicit user request. "
+                            fi
+                        fi
+                    fi
+
+                    # Feature pipeline context
+                    feature_hit=$(eagle_find_features_for_file "$project" "$fp")
+                    if [ -n "$feature_hit" ]; then
+                        while IFS='|' read -r feat_name feat_desc feat_verified _role feat_deps feat_other_files feat_smoke; do
+                            [ -z "$feat_name" ] && continue
+                            read_context+="Eagle Mem: '${fname}' is part of feature '${feat_name}'"
+                            [ -n "$feat_desc" ] && read_context+=" ($feat_desc)"
+                            read_context+="."
+                            if [ -n "$feat_verified" ]; then
+                                read_context+=" Last verified: ${feat_verified}."
+                            fi
+                            if [ -n "$feat_deps" ]; then
+                                read_context+=" Dependencies: ${feat_deps}."
+                            fi
+                            if [ -n "$feat_other_files" ]; then
+                                read_context+=" Other files in pipeline: ${feat_other_files}."
+                            fi
+                            if [ -n "$feat_smoke" ]; then
+                                read_context+=" Smoke tests: ${feat_smoke}."
+                            fi
+                            read_context+=" Changes require re-testing after deploy. "
+                        done <<< "$feature_hit"
+                    fi
+
+                    if [ -n "$read_context" ]; then
+                        jq -nc --arg ctx "$read_context" '{"hookSpecificOutput":{"hookEventName":"PostToolUse","additionalContext":$ctx}}'
+                    fi
+                    ;;
+            esac
+        fi
+        ;;
+esac
+
+eagle_insert_observation "$session_id" "$project" "$tool_name" "$tool_summary" "$files_read" "$files_modified" "$output_bytes" "$output_lines" "$command_category"
 
 exit 0

package/hooks/pre-tool-use.sh

@@ -0,0 +1,124 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════
+# Eagle Mem — PreToolUse hook
+# Fires before every Bash tool use
+# 1. Surfaces feature verification checklists before git push
+# 2. Applies learned command filtering rules (RTK-style adaptive)
+# ═══════════════════════════════════════════════════════════
+set +e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+LIB_DIR="$SCRIPT_DIR/../lib"
+
+. "$LIB_DIR/common.sh"
+. "$LIB_DIR/db.sh"
+
+input=$(eagle_read_stdin)
+[ -z "$input" ] && exit 0
+
+tool_name=$(echo "$input" | jq -r '.tool_name // empty')
+[ "$tool_name" != "Bash" ] && exit 0
+
+[ ! -f "$EAGLE_MEM_DB" ] && exit 0
+
+cmd=$(echo "$input" | jq -r '.tool_input.command // empty')
+[ -z "$cmd" ] && exit 0
+
+session_id=$(echo "$input" | jq -r '.session_id // empty')
+cwd=$(echo "$input" | jq -r '.cwd // empty')
+project=$(eagle_project_from_cwd "$cwd")
+p_esc=$(eagle_sql_escape "$project")
+
+context=""
+
+# ─── Feature verification on git push ─────────────────────
+
+case "$cmd" in
+    *"git push"*|*"gh pr create"*)
+        has_features=$(eagle_db "SELECT COUNT(*) FROM features WHERE project = '$p_esc' AND status = 'active';")
+        if [ "${has_features:-0}" -gt 0 ]; then
+            changed_files=""
+            if [ -n "$cwd" ] && [ -d "$cwd" ]; then
+                changed_files=$(git -C "$cwd" diff --name-only HEAD 2>/dev/null)
+                [ -z "$changed_files" ] && changed_files=$(git -C "$cwd" diff --cached --name-only 2>/dev/null)
+            fi
+
+            if [ -n "$changed_files" ]; then
+                seen_features=""
+                while IFS= read -r changed_file; do
+                    [ -z "$changed_file" ] && continue
+                    fname=$(basename "$changed_file")
+                    fname_esc=$(eagle_sql_escape "$fname")
+
+                    feature_hits=$(eagle_db "SELECT DISTINCT f.name,
+                        (SELECT GROUP_CONCAT(fst.command, '; ')
+                         FROM feature_smoke_tests fst WHERE fst.feature_id = f.id) as smoke,
+                        (SELECT GROUP_CONCAT(fd.target || ':' || fd.name, ', ')
+                         FROM feature_dependencies fd WHERE fd.feature_id = f.id) as deps,
+                        f.last_verified_at
+                        FROM features f
+                        JOIN feature_files ff ON ff.feature_id = f.id
+                        WHERE f.project = '$p_esc'
+                        AND f.status = 'active'
+                        AND (ff.file_path LIKE '%$fname_esc' OR ff.file_path LIKE '%$fname_esc%');")
+
+                    while IFS='|' read -r feat_name feat_smoke feat_deps feat_verified; do
+                        [ -z "$feat_name" ] && continue
+                        case "$seen_features" in *"|$feat_name|"*) continue ;; esac
+                        seen_features+="|$feat_name|"
+
+                        context+="  - $feat_name"
+                        [ -n "$feat_smoke" ] && context+=" | smoke: $feat_smoke"
+                        [ -n "$feat_deps" ] && context+=" | deps: $feat_deps"
+                        if [ -n "$feat_verified" ]; then
+                            context+=" | last verified: $feat_verified"
+                        else
+                            context+=" | never verified"
+                        fi
+                        context+=$'\n'
+                    done <<< "$feature_hits"
+                done <<< "$changed_files"
+
+                if [ -n "$context" ]; then
+                    context="Eagle Mem: This push affects the following features. After deploy, verify each works and run 'eagle-mem feature verify <name>'.
+${context}"
+                fi
+            fi
+        fi
+        ;;
+esac
+
+# ─── Command output filtering (learned rules) ─────────────
+
+# Extract the base command for rule matching
+base_cmd=$(echo "$cmd" | awk '{print $1}' | sed 's|.*/||')
+cmd_esc=$(eagle_sql_escape "$base_cmd")
+
+rule=$(eagle_db "SELECT strategy, max_lines, reason
+    FROM command_rules
+    WHERE enabled = 1
+    AND (project = '$p_esc' OR project IS NULL)
+    AND ('$cmd_esc' LIKE pattern OR '$cmd_esc' = pattern)
+    ORDER BY
+        CASE WHEN project IS NOT NULL THEN 0 ELSE 1 END
+    LIMIT 1;")
+
+if [ -n "$rule" ]; then
+    IFS='|' read -r strategy max_lines reason <<< "$rule"
+    case "$strategy" in
+        summary)
+            context+="Eagle Mem command hint: '${base_cmd}' output is typically noisy (${reason}). Consider piping through 'tail -5' or checking exit code only."
+            ;;
+        truncate)
+            if [ -n "$max_lines" ] && [ "$max_lines" -gt 0 ] 2>/dev/null; then
+                context+="Eagle Mem command hint: '${base_cmd}' produces long output (${reason}). Consider: ${cmd} | head -${max_lines}"
+            fi
+            ;;
+    esac
+fi
+
+[ -z "$context" ] && exit 0
+
+jq -nc --arg ctx "$context" '{"hookSpecificOutput":{"hookEventName":"PreToolUse","additionalContext":$ctx}}'
+
+exit 0