eagle-mem 1.0.0

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "eagle-mem",
+  "version": "1.0.0",
+  "description": "Lightweight persistent memory for Claude Code — SQLite + FTS5, no daemon, no bloat",
+  "bin": {
+    "eagle-mem": "bin/eagle-mem"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    "hooks/",
+    "lib/",
+    "db/",
+    "skills/"
+  ],
+  "keywords": [
+    "claude-code",
+    "memory",
+    "sqlite",
+    "fts5",
+    "hooks",
+    "persistent-memory"
+  ],
+  "author": "eagleisbatman",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eagleisbatman/eagle-mem.git"
+  },
+  "homepage": "https://github.com/eagleisbatman/eagle-mem#readme"
+}

package/scripts/help.sh

@@ -0,0 +1,50 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════
+# Eagle Mem — Help
+# ═══════════════════════════════════════════════════════════
+
+SCRIPTS_DIR="$(cd "$(dirname "$0")" && pwd)"
+PACKAGE_DIR="$(cd "$SCRIPTS_DIR/.." && pwd)"
+
+. "$SCRIPTS_DIR/style.sh"
+
+version=$(node -e "console.log(require('$PACKAGE_DIR/package.json').version)" 2>/dev/null || echo "unknown")
+
+eagle_banner
+
+echo -e "  ${BOLD}Eagle Mem${RESET} ${DIM}v${version}${RESET}"
+echo -e "  ${DIM}Lightweight persistent memory for Claude Code${RESET}"
+echo ""
+echo -e "  ${BOLD}Usage:${RESET}"
+echo -e "    eagle-mem ${CYAN}<command>${RESET}"
+echo ""
+echo -e "  ${BOLD}Commands:${RESET}"
+echo -e "    ${CYAN}install${RESET}     Set up hooks, database, and skills"
+echo -e "    ${CYAN}uninstall${RESET}   Remove hooks and optionally delete data"
+echo -e "    ${CYAN}update${RESET}      Re-deploy hooks and run new migrations"
+echo -e "    ${CYAN}scan${RESET}        Analyze a project and generate an overview"
+echo -e "    ${CYAN}index${RESET}       Index source files for code-level search"
+echo -e "    ${CYAN}help${RESET}        Show this help message"
+echo -e "    ${CYAN}version${RESET}     Show version number"
+echo ""
+echo -e "  ${BOLD}Examples:${RESET}"
+echo -e "    ${DIM}\$${RESET} eagle-mem install       ${DIM}# First-time setup${RESET}"
+echo -e "    ${DIM}\$${RESET} eagle-mem update        ${DIM}# After npm update${RESET}"
+echo -e "    ${DIM}\$${RESET} eagle-mem scan .         ${DIM}# Scan current project${RESET}"
+echo -e "    ${DIM}\$${RESET} eagle-mem index .        ${DIM}# Index source files${RESET}"
+echo -e "    ${DIM}\$${RESET} eagle-mem uninstall     ${DIM}# Clean removal${RESET}"
+echo ""
+echo -e "  ${BOLD}What it does:${RESET}"
+echo -e "    ${DOT} Saves session summaries to a shared SQLite database"
+echo -e "    ${DOT} Injects relevant memory at session start"
+echo -e "    ${DOT} Searches past sessions when you ask related questions"
+echo -e "    ${DOT} Tracks file operations across sessions"
+echo -e "    ${DOT} Provides task management for complex multi-step work"
+echo ""
+echo -e "  ${BOLD}Skills${RESET} ${DIM}(available inside Claude Code):${RESET}"
+echo -e "    ${CYAN}/eagle-mem-search${RESET}    Search past sessions and observations"
+echo -e "    ${CYAN}/eagle-mem-tasks${RESET}     Break work into tracked subtasks"
+echo -e "    ${CYAN}/eagle-mem-overview${RESET}  Generate a persistent project summary"
+echo ""
+echo -e "  ${DIM}https://github.com/eagleisbatman/eagle-mem${RESET}"
+echo ""

package/scripts/index.sh

@@ -0,0 +1,196 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════
+# Eagle Mem — Index
+# Chunks source files and indexes them for FTS5 code search
+# Incremental: only re-indexes files that changed since last run
+# ═══════════════════════════════════════════════════════════
+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
+
+TARGET_DIR="${1:-.}"
+TARGET_DIR="$(cd "$TARGET_DIR" && pwd)"
+PROJECT=$(eagle_project_from_cwd "$TARGET_DIR")
+
+CHUNK_SIZE="${EAGLE_MEM_CHUNK_SIZE:-80}"
+if ! [[ "$CHUNK_SIZE" =~ ^[0-9]+$ ]] || [ "$CHUNK_SIZE" -lt 1 ]; then
+    CHUNK_SIZE=80
+fi
+MAX_FILE_SIZE=1048576  # 1MB
+
+eagle_header "Index"
+eagle_info "Indexing ${BOLD}$PROJECT${RESET} at $TARGET_DIR"
+echo ""
+
+# ─── Source file extensions to index ───────────────────────
+
+SOURCE_EXTS="sh|bash|zsh|js|jsx|mjs|cjs|ts|tsx|mts|py|rb|go|rs|java|kt|kts|swift|c|h|cpp|cc|cxx|hpp|cs|php|sql|html|htm|css|scss|vue|svelte|dart|ex|exs|zig|lua|r|scala|yaml|yml|toml|json|md"
+
+ext_to_lang() {
+    case "$1" in
+        sh|bash|zsh) echo "Bash" ;;
+        js|jsx|mjs|cjs) echo "JavaScript" ;;
+        ts|tsx|mts) echo "TypeScript" ;;
+        py) echo "Python" ;;
+        rb) echo "Ruby" ;;
+        go) echo "Go" ;;
+        rs) echo "Rust" ;;
+        java) echo "Java" ;;
+        kt|kts) echo "Kotlin" ;;
+        swift) echo "Swift" ;;
+        c|h) echo "C" ;;
+        cpp|cc|cxx|hpp) echo "C++" ;;
+        cs) echo "C#" ;;
+        php) echo "PHP" ;;
+        sql) echo "SQL" ;;
+        html|htm) echo "HTML" ;;
+        css|scss|sass|less) echo "CSS" ;;
+        vue) echo "Vue" ;;
+        svelte) echo "Svelte" ;;
+        dart) echo "Dart" ;;
+        ex|exs) echo "Elixir" ;;
+        zig) echo "Zig" ;;
+        lua) echo "Lua" ;;
+        r) echo "R" ;;
+        scala) echo "Scala" ;;
+        yaml|yml) echo "YAML" ;;
+        toml) echo "TOML" ;;
+        json) echo "JSON" ;;
+        md) echo "Markdown" ;;
+        *) echo "" ;;
+    esac
+}
+
+# ─── Collect files ─────────────────────────────────────────
+
+TMPDIR_IDX=$(mktemp -d)
+trap 'rm -rf "$TMPDIR_IDX"' EXIT
+
+ALL_FILES="$TMPDIR_IDX/all_files"
+
+eagle_collect_files "$TARGET_DIR" "$ALL_FILES"
+
+# Filter to source files only, skip large files
+SOURCE_FILES="$TMPDIR_IDX/source_files"
+while IFS= read -r file; do
+    ext="${file##*.}"
+    [ "$ext" = "$file" ] && continue
+    ext=$(echo "$ext" | tr '[:upper:]' '[:lower:]')
+    echo "$ext" | grep -qE "^($SOURCE_EXTS)$" || continue
+    full_path="$TARGET_DIR/$file"
+    [ ! -f "$full_path" ] && continue
+    file_size=$(wc -c < "$full_path" 2>/dev/null | tr -d ' ')
+    [ "$file_size" -gt "$MAX_FILE_SIZE" ] && continue
+    echo "$file"
+done < "$ALL_FILES" > "$SOURCE_FILES"
+
+total_source=$(wc -l < "$SOURCE_FILES" | tr -d ' ')
+eagle_ok "$total_source source files found"
+
+if [ "$total_source" -eq 0 ]; then
+    eagle_info "Nothing to index"
+    exit 0
+fi
+
+# ─── Check which files need re-indexing ────────────────────
+
+project_sql=$(eagle_sql_escape "$PROJECT")
+NEEDS_INDEX="$TMPDIR_IDX/needs_index"
+
+indexed_count=0
+skipped_count=0
+
+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")
+
+    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
+        skipped_count=$((skipped_count + 1))
+        continue
+    fi
+
+    echo "$file"
+done < "$SOURCE_FILES" > "$NEEDS_INDEX"
+
+needs_count=$(wc -l < "$NEEDS_INDEX" | tr -d ' ')
+
+if [ "$skipped_count" -gt 0 ]; then
+    eagle_ok "$skipped_count files unchanged (skipped)"
+fi
+
+if [ "$needs_count" -eq 0 ]; then
+    eagle_ok "Index is up to date"
+    eagle_footer "Nothing to index."
+    exit 0
+fi
+
+eagle_info "$needs_count files to index"
+
+# ─── Chunk and index files ─────────────────────────────────
+
+echo ""
+
+chunk_count=0
+file_count=0
+
+while IFS= read -r file; do
+    full_path="$TARGET_DIR/$file"
+    ext="${file##*.}"
+    ext=$(echo "$ext" | tr '[:upper:]' '[:lower:]')
+    lang=$(ext_to_lang "$ext")
+    current_mtime=$(stat -f '%m' "$full_path" 2>/dev/null || stat -c '%Y' "$full_path" 2>/dev/null || echo "0")
+    file_sql=$(eagle_sql_escape "$file")
+    lang_sql=$(eagle_sql_escape "$lang")
+
+    eagle_db "DELETE FROM code_chunks WHERE project = '$project_sql' AND file_path = '$file_sql';"
+
+    total_lines=$(wc -l < "$full_path" 2>/dev/null | tr -d ' ')
+    [ "$total_lines" -eq 0 ] && continue
+
+    start=1
+    while [ "$start" -le "$total_lines" ]; do
+        end=$((start + CHUNK_SIZE - 1))
+        [ "$end" -gt "$total_lines" ] && end="$total_lines"
+
+        content=$(sed -n "${start},${end}p" "$full_path")
+        content_sql=$(eagle_sql_escape "$content")
+
+        eagle_db "INSERT INTO code_chunks (project, file_path, language, start_line, end_line, content, mtime)
+                  VALUES ('$project_sql', '$file_sql', '$lang_sql', $start, $end, '$content_sql', $current_mtime);"
+
+        chunk_count=$((chunk_count + 1))
+        start=$((end + 1))
+    done
+
+    file_count=$((file_count + 1))
+
+    if [ $((file_count % 10)) -eq 0 ]; then
+        printf "  \r  ${ARROW}  Indexed %d / %d files (%d chunks)..." "$file_count" "$needs_count" "$chunk_count"
+    fi
+done < "$NEEDS_INDEX"
+
+echo ""
+eagle_ok "Indexed $file_count files ($chunk_count chunks)"
+
+# ─── Summary ──────────────────────────────────────────────
+
+total_chunks=$(eagle_db "SELECT COUNT(*) FROM code_chunks WHERE project = '$project_sql';")
+total_indexed=$(eagle_db "SELECT COUNT(DISTINCT file_path) FROM code_chunks WHERE project = '$project_sql';")
+
+echo ""
+eagle_footer "Index complete."
+eagle_kv "Project:" "$PROJECT"
+eagle_kv "Files indexed:" "$total_indexed"
+eagle_kv "Total chunks:" "$total_chunks"
+eagle_kv "Chunk size:" "$CHUNK_SIZE lines"
+eagle_kv "Database:" "$EAGLE_MEM_DB"
+echo ""

package/scripts/install.sh

@@ -0,0 +1,238 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════
+# Eagle Mem — Install
+# Sets up hooks, database, and skills for Claude Code
+# ═══════════════════════════════════════════════════════════
+set -euo pipefail
+
+PACKAGE_DIR="${1:-.}"
+SCRIPTS_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+. "$SCRIPTS_DIR/style.sh"
+
+EAGLE_MEM_DIR="${EAGLE_MEM_DIR:-$HOME/.eagle-mem}"
+SETTINGS="$HOME/.claude/settings.json"
+
+eagle_banner
+eagle_header "Install"
+
+# ─── Detect platform ───────────────────────────────────────
+
+detect_pkg_manager() {
+    if command -v brew &>/dev/null; then
+        echo "brew"
+    elif command -v apt-get &>/dev/null; then
+        echo "apt"
+    elif command -v dnf &>/dev/null; then
+        echo "dnf"
+    elif command -v pacman &>/dev/null; then
+        echo "pacman"
+    else
+        echo ""
+    fi
+}
+
+install_package() {
+    local pkg="$1"
+    local mgr
+    mgr=$(detect_pkg_manager)
+
+    case "$mgr" in
+        brew)   eagle_info "Running: brew install $pkg"; brew install "$pkg" ;;
+        apt)    eagle_info "Running: sudo apt-get install -y $pkg"; sudo apt-get install -y "$pkg" ;;
+        dnf)    eagle_info "Running: sudo dnf install -y $pkg"; sudo dnf install -y "$pkg" ;;
+        pacman) eagle_info "Running: sudo pacman -S --noconfirm $pkg"; sudo pacman -S --noconfirm "$pkg" ;;
+        *)
+            eagle_fail "No package manager found. Install $pkg manually and re-run."
+            exit 1
+            ;;
+    esac
+}
+
+# ─── Check prerequisites ───────────────────────────────────
+
+echo -e "  ${BOLD}Checking prerequisites...${RESET}"
+echo ""
+
+prereqs_ok=true
+
+# sqlite3
+if command -v sqlite3 &>/dev/null; then
+    sqlite_version=$(sqlite3 --version 2>/dev/null | awk '{print $1}')
+    eagle_ok "sqlite3 ${DIM}($sqlite_version)${RESET}"
+else
+    eagle_fail "sqlite3 not found"
+    if eagle_confirm "Install sqlite3?"; then
+        install_package sqlite3
+        if command -v sqlite3 &>/dev/null; then
+            sqlite_version=$(sqlite3 --version 2>/dev/null | awk '{print $1}')
+            eagle_ok "sqlite3 installed ${DIM}($sqlite_version)${RESET}"
+        else
+            eagle_fail "sqlite3 installation failed"
+            prereqs_ok=false
+        fi
+    else
+        prereqs_ok=false
+    fi
+fi
+
+# FTS5 support
+if command -v sqlite3 &>/dev/null; then
+    if sqlite3 :memory: "SELECT sqlite_compileoption_used('ENABLE_FTS5');" 2>/dev/null | grep -q "1"; then
+        eagle_ok "FTS5 support"
+    else
+        eagle_fail "SQLite was compiled without FTS5 support"
+        eagle_dim "On macOS: brew install sqlite3 (system sqlite3 includes FTS5)"
+        eagle_dim "On Linux: install libsqlite3-dev or rebuild with --enable-fts5"
+        prereqs_ok=false
+    fi
+fi
+
+# jq
+if command -v jq &>/dev/null; then
+    jq_version=$(jq --version 2>/dev/null | sed 's/jq-//')
+    eagle_ok "jq ${DIM}($jq_version)${RESET}"
+else
+    eagle_fail "jq not found"
+    if eagle_confirm "Install jq?"; then
+        install_package jq
+        if command -v jq &>/dev/null; then
+            jq_version=$(jq --version 2>/dev/null | sed 's/jq-//')
+            eagle_ok "jq installed ${DIM}($jq_version)${RESET}"
+        else
+            eagle_fail "jq installation failed"
+            prereqs_ok=false
+        fi
+    else
+        prereqs_ok=false
+    fi
+fi
+
+# Claude Code
+if [ -d "$HOME/.claude" ]; then
+    eagle_ok "Claude Code ${DIM}(~/.claude/)${RESET}"
+else
+    eagle_fail "Claude Code not found (~/.claude/ does not exist)"
+    echo ""
+    eagle_dim "Install Claude Code first:"
+    eagle_dim "  npm install -g @anthropic-ai/claude-code"
+    eagle_dim "  https://docs.anthropic.com/en/docs/claude-code"
+    echo ""
+    exit 1
+fi
+
+if [ "$prereqs_ok" = false ]; then
+    echo ""
+    eagle_err "Prerequisites not met. Fix the issues above and re-run."
+    exit 1
+fi
+
+echo ""
+
+# ─── Copy files to ~/.eagle-mem/ ───────────────────────────
+
+echo -e "  ${BOLD}Installing Eagle Mem...${RESET}"
+echo ""
+
+mkdir -p "$EAGLE_MEM_DIR"/{hooks,lib,db}
+
+cp "$PACKAGE_DIR"/hooks/*.sh "$EAGLE_MEM_DIR/hooks/"
+cp "$PACKAGE_DIR"/lib/*.sh "$EAGLE_MEM_DIR/lib/"
+cp "$PACKAGE_DIR"/db/*.sh "$EAGLE_MEM_DIR/db/"
+cp "$PACKAGE_DIR"/db/*.sql "$EAGLE_MEM_DIR/db/"
+
+chmod +x "$EAGLE_MEM_DIR"/hooks/*.sh
+chmod +x "$EAGLE_MEM_DIR"/db/migrate.sh
+
+eagle_ok "Files copied to $EAGLE_MEM_DIR"
+
+# ─── Run migrations ────────────────────────────────────────
+
+"$EAGLE_MEM_DIR/db/migrate.sh" 2>/dev/null | grep -v -E '^(wal|5000|Eagle Mem database)$' > /dev/null
+eagle_ok "Database ready"
+
+# ─── Patch settings.json ───────────────────────────────────
+
+if [ ! -f "$SETTINGS" ]; then
+    echo '{}' > "$SETTINGS"
+fi
+
+patch_hook() {
+    local event="$1"
+    local matcher="$2"
+    local command="$3"
+    local description="$4"
+
+    if jq -e ".hooks.${event}[]? | select(.hooks[]?.command == \"$command\")" "$SETTINGS" &>/dev/null; then
+        eagle_ok "$description ${DIM}(already registered)${RESET}"
+        return
+    fi
+
+    local entry
+    if [ -n "$matcher" ]; then
+        entry="{\"matcher\": \"$matcher\", \"hooks\": [{\"type\": \"command\", \"command\": \"$command\"}]}"
+    else
+        entry="{\"hooks\": [{\"type\": \"command\", \"command\": \"$command\"}]}"
+    fi
+
+    local tmp
+    tmp=$(mktemp)
+    jq --argjson entry "$entry" ".hooks.${event} = ((.hooks.${event} // []) + [\$entry])" "$SETTINGS" > "$tmp" && mv "$tmp" "$SETTINGS"
+    eagle_ok "$description"
+}
+
+patch_hook "SessionStart" "" \
+    "$EAGLE_MEM_DIR/hooks/session-start.sh" \
+    "SessionStart hook"
+
+patch_hook "Stop" "" \
+    "$EAGLE_MEM_DIR/hooks/stop.sh" \
+    "Stop hook"
+
+patch_hook "PostToolUse" "Read|Write|Edit|Bash" \
+    "$EAGLE_MEM_DIR/hooks/post-tool-use.sh" \
+    "PostToolUse hook"
+
+patch_hook "SessionEnd" "" \
+    "$EAGLE_MEM_DIR/hooks/session-end.sh" \
+    "SessionEnd hook"
+
+patch_hook "UserPromptSubmit" "" \
+    "$EAGLE_MEM_DIR/hooks/user-prompt-submit.sh" \
+    "UserPromptSubmit hook"
+
+# ─── Install skills ────────────────────────────────────────
+
+SKILLS_DIR="$HOME/.claude/skills"
+if [ -d "$SKILLS_DIR" ] && [ -d "$PACKAGE_DIR/skills" ]; then
+    for skill_dir in "$PACKAGE_DIR"/skills/*/; do
+        [ ! -d "$skill_dir" ] && continue
+        skill_name=$(basename "$skill_dir")
+        dst="$SKILLS_DIR/$skill_name"
+        [ -L "$dst" ] && rm "$dst"
+        ln -sf "$skill_dir" "$dst"
+        eagle_ok "Skill: $skill_name"
+    done
+elif [ -d "$PACKAGE_DIR/skills" ]; then
+    mkdir -p "$SKILLS_DIR"
+    for skill_dir in "$PACKAGE_DIR"/skills/*/; do
+        [ ! -d "$skill_dir" ] && continue
+        skill_name=$(basename "$skill_dir")
+        dst="$SKILLS_DIR/$skill_name"
+        [ -L "$dst" ] && rm "$dst"
+        ln -sf "$skill_dir" "$dst"
+        eagle_ok "Skill: $skill_name"
+    done
+fi
+
+# ─── Summary ───────────────────────────────────────────────
+
+eagle_footer "Eagle Mem installed successfully."
+
+eagle_kv "Database:" "$EAGLE_MEM_DIR/memory.db"
+eagle_kv "Hooks:" "$EAGLE_MEM_DIR/hooks/"
+eagle_kv "Settings:" "$SETTINGS"
+
+echo ""
+eagle_dim "Start a new Claude Code session — Eagle Mem will activate automatically."
+echo ""