eagle-mem 1.0.0

package/README.md

@@ -0,0 +1,227 @@
+```
+███████╗ █████╗  ██████╗ ██╗     ███████╗
+██╔════╝██╔══██╗██╔════╝ ██║     ██╔════╝
+█████╗  ███████║██║  ██╗ ██║     █████╗
+██╔══╝  ██╔══██║██║  ╚██╗██║     ██╔══╝
+███████╗██║  ██║╚██████╔╝███████╗███████╗
+╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚══════╝╚══════╝
+           ███╗   ███╗███████╗███╗   ███╗
+           ████╗ ████║██╔════╝████╗ ████║
+           ██╔████╔██║█████╗  ██╔████╔██║
+           ██║╚██╔╝██║██╔══╝  ██║╚██╔╝██║
+           ██║ ╚═╝ ██║███████╗██║ ╚═╝ ██║
+           ╚═╝     ╚═╝╚══════╝╚═╝     ╚═╝
+```
+
+# Eagle Mem
+
+Lightweight persistent memory for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Inspired by [claude-mem](https://github.com/thedotmack/claude-mem) but without the resource-heavy Chroma DB + Bun daemon architecture that consumed 300-600MB per instance.
+
+**Zero per-instance overhead.** No daemon, no vector DB, no MCP server. Just bash scripts, sqlite3, and jq.
+
+## Install
+
+```bash
+npm install -g eagle-mem
+eagle-mem install
+```
+
+The installer checks prerequisites and offers to install missing ones:
+
+```
+Eagle Mem  Install
+─────��───────────────────────────────
+
+Checking prerequisites...
+
+✓  sqlite3 (3.39.5)
+✓  FTS5 support
+✗  jq not found
+?  Install jq? [y/N] y
+→  Running: brew install jq
+✓  jq installed (1.7.1)
+✓  Claude Code (~/.claude/)
+
+Installing Eagle Mem...
+
+✓  Files copied to ~/.eagle-mem
+✓  Database ready
+✓  SessionStart hook
+✓  Stop hook
+✓  PostToolUse hook
+✓  SessionEnd hook
+✓  UserPromptSubmit hook
+✓  Skill: eagle-mem-overview
+✓  Skill: eagle-mem-search
+✓  Skill: eagle-mem-tasks
+
+Eagle Mem installed successfully.
+```
+
+Start a new Claude Code session — Eagle Mem activates automatically.
+
+## Commands
+
+| Command | What it does |
+|---------|-------------|
+| `eagle-mem install` | First-time setup: checks prerequisites, deploys hooks, creates database, installs skills |
+| `eagle-mem update` | Re-deploys hooks/lib files and runs pending database migrations |
+| `eagle-mem scan .` | Analyze a project and generate an overview (auto-injected at session start) |
+| `eagle-mem index .` | Index source files into FTS5-searchable chunks (incremental via mtime) |
+| `eagle-mem uninstall` | Removes hooks from settings.json and optionally deletes data |
+| `eagle-mem help` | Shows usage, commands, and available skills |
+| `eagle-mem version` | Shows current version |
+
+## Why
+
+Claude Code sessions lose context on `/compact` and between sessions. Eagle Mem solves this with:
+
+- **Automatic session summaries** saved to a shared SQLite database
+- **TaskAware Compact Loop** for breaking complex work into subtasks that survive compaction
+- **FTS5 full-text search** across all sessions and projects
+- **Contextual memory injection** — relevant past sessions surfaced when you ask related questions
+- **Privacy controls** — `<private>` tags strip sensitive content before storage
+- **Observation deduplication** — prevents DB bloat from repeated tool calls
+- **Project overviews** — persistent one-paragraph project summaries injected at session start
+- **Concurrent-safe** WAL mode with busy timeout — runs fine across 4-5 simultaneous sessions
+- **Codebase scanning** — auto-generates project overviews from structure analysis
+- **Code indexing** — FTS5-searchable source chunks with incremental re-indexing
+
+## How It Works
+
+### Hook Lifecycle
+
+| Hook | Fires When | What It Does |
+|------|-----------|--------------|
+| **SessionStart** | startup, resume, clear, compact | Queries DB for project overview, recent summaries, and pending tasks. Injects context via stdout. |
+| **UserPromptSubmit** | user sends a message | Searches FTS5 for memories relevant to the user's prompt. Injects matching context. |
+| **Stop** | Claude's turn ends | Parses `<eagle-summary>` from transcript (strips `<private>` tags first). Heuristic fallback extracts user prompt + file paths. Saves summary to DB. |
+| **PostToolUse** | after Read/Write/Edit/Bash | Captures lightweight observations with deduplication (5-second window). |
+| **SessionEnd** | session closes | Marks session as completed with timestamp. |
+
+### Summary Extraction
+
+Eagle Mem injects instructions for Claude to emit an `<eagle-summary>` block before its final response:
+
+```
+<eagle-summary>
+request: What the user asked for
+investigated: Key files/areas explored
+learned: Non-obvious discoveries
+completed: What was accomplished
+next_steps: What should happen next
+files_read: [list of files read]
+files_modified: [list of files modified]
+</eagle-summary>
+```
+
+The Stop hook parses this from the transcript. If Claude doesn't emit one, a heuristic fallback captures the first user prompt and files touched via tool calls.
+
+### Privacy
+
+Wrap sensitive content in `<private>` tags and it will be stripped before storage:
+
+```
+<private>
+API_KEY=sk-secret-123
+DB_PASSWORD=hunter2
+</private>
+```
+
+The Stop hook removes `<private>` blocks at the edge — before any data reaches the database.
+
+### TaskAware Compact Loop
+
+For complex multi-step work:
+
+1. **Plan** — Break the work into subtasks stored in the DB
+2. **Execute** — Work on one task at a time
+3. **Compact** — Run `/compact` when context fills up
+4. **Resume** — SessionStart re-injects memory + the next pending task
+
+This prevents context bloat and hallucination on long tasks.
+
+## Database
+
+Single shared SQLite database at `~/.eagle-mem/memory.db` with a `project` column on every table for filtering.
+
+### Tables
+
+- **sessions** — Track active/completed sessions per project
+- **observations** — Per-tool-use records with deduplication (files read/modified)
+- **summaries** — Per-session summaries with FTS5 search
+- **tasks** — Subtasks for the TaskAware Compact Loop with FTS5 search
+- **overviews** — One rolling overview per project (injected at session start)
+- **code_chunks** — FTS5-indexed source file chunks for code-level search
+
+### Key Design Choices
+
+- **WAL mode** for concurrent readers across sessions
+- **busy_timeout=5000** to retry on write contention instead of failing
+- **FTS5 content-sync** with auto-triggers to keep search indexes in sync
+- **trusted_schema=ON** required for FTS5 virtual tables
+- PRAGMAs set on every connection (they're connection-scoped, not persistent)
+
+## Skills
+
+Eagle Mem ships with three skills for use inside Claude Code sessions:
+
+- **eagle-mem-search** — 3-layer search: compact FTS5 search, timeline view, full observations
+- **eagle-mem-tasks** — TaskAware Compact Loop: create, view, complete, and manage subtasks
+- **eagle-mem-overview** — Generate and update a persistent project overview
+
+## Architecture
+
+```
+Package (npm)                   Runtime (~/.eagle-mem/)
+├── bin/eagle-mem   CLI         ├── memory.db         SQLite + FTS5
+├── scripts/                    ├── eagle-mem.log     Debug log
+│   ├── style.sh                ├── hooks/
+│   ├── install.sh              │   ├── session-start.sh
+│   ├── uninstall.sh            │   ├── user-prompt-submit.sh
+│   ├── update.sh               │   ├── stop.sh
+│   ├── scan.sh                 │   ├── post-tool-use.sh
+│   ├── index.sh                │   └── session-end.sh
+│   └── help.sh                ├── lib/
+├── hooks/          Source      │   ├── common.sh
+├── lib/            Source      │   └── db.sh
+│   ├── common.sh              └── db/
+│   └── db.sh                      ├── migrate.sh
+├── db/             Source          ├── schema.sql
+│   ├── migrate.sh                 ├── 002_overviews.sql
+│   ├── schema.sql                 └── 003_code_chunks.sql
+│   ├── 002_overviews.sql
+│   └── 003_code_chunks.sql
+└── skills/         Symlinked → ~/.claude/skills/
+```
+
+## Uninstall
+
+```bash
+eagle-mem uninstall
+```
+
+Removes hooks from `~/.claude/settings.json` and skill symlinks. Optionally deletes `~/.eagle-mem/` (prompts for confirmation).
+
+To also remove the npm package:
+
+```bash
+npm uninstall -g eagle-mem
+```
+
+## Prerequisites
+
+- `sqlite3` with FTS5 support (ships with macOS; the installer offers to install if missing)
+- `jq` (the installer offers to install if missing)
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed (`~/.claude/` must exist)
+
+## Roadmap
+
+- [ ] **v2**: sqlite-vec embeddings for semantic code search
+- [ ] Integration into [Eagle Skills](https://github.com/eagleisbatman/eagle-skills)
+- [ ] Timeline report skill (narrative project history from pure SQL)
+- [ ] GitHub Pages site (matching Eagle Skills)
+
+## License
+
+MIT

package/bin/eagle-mem

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SOURCE="${BASH_SOURCE[0]}"
+while [ -L "$SOURCE" ]; do
+  DIR="$(cd "$(dirname "$SOURCE")" && pwd)"
+  SOURCE="$(readlink "$SOURCE")"
+  [[ $SOURCE != /* ]] && SOURCE="$DIR/$SOURCE"
+done
+PACKAGE_DIR="$(cd "$(dirname "$SOURCE")/.." && pwd)"
+SCRIPTS_DIR="$PACKAGE_DIR/scripts"
+
+. "$SCRIPTS_DIR/style.sh"
+
+command="${1:-help}"
+shift 2>/dev/null || true
+
+case "$command" in
+    install)    bash "$SCRIPTS_DIR/install.sh" "$PACKAGE_DIR" "$@" ;;
+    uninstall)  bash "$SCRIPTS_DIR/uninstall.sh" "$@" ;;
+    update)     bash "$SCRIPTS_DIR/update.sh" "$PACKAGE_DIR" "$@" ;;
+    scan)       bash "$SCRIPTS_DIR/scan.sh" "$@" ;;
+    index)      bash "$SCRIPTS_DIR/index.sh" "$@" ;;
+    help|--help|-h)
+                bash "$SCRIPTS_DIR/help.sh" ;;
+    version|--version|-v|-V)
+                version=$(node -e "console.log(require('$PACKAGE_DIR/package.json').version)" 2>/dev/null || echo "unknown")
+                echo -e "  ${BOLD}Eagle Mem${RESET} v${version}"
+                ;;
+    *)
+                eagle_err "Unknown command: $command"
+                echo ""
+                bash "$SCRIPTS_DIR/help.sh"
+                exit 1
+                ;;
+esac

package/db/002_overviews.sql

@@ -0,0 +1,16 @@
+-- ═══════════════════════════════════════════════════════════
+-- Eagle Mem — Migration 002: Project overviews
+-- One rolling overview per project for quick context injection
+-- ═══════════════════════════════════════════════════════════
+
+-- NOTE: PRAGMAs are connection-scoped, set in lib/db.sh
+PRAGMA foreign_keys = ON;
+
+CREATE TABLE IF NOT EXISTS overviews (
+    id         INTEGER PRIMARY KEY AUTOINCREMENT,
+    project    TEXT NOT NULL UNIQUE,
+    content    TEXT NOT NULL,
+    updated_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_overviews_project ON overviews(project);

package/db/003_code_chunks.sql

@@ -0,0 +1,46 @@
+-- ═══════════════════════════════════════════════════════════
+-- Eagle Mem — Migration 003: Code chunks for source indexing
+-- FTS5 searchable chunks of source files
+-- ═══════════════════════════════════════════════════════════
+
+PRAGMA foreign_keys = ON;
+
+CREATE TABLE IF NOT EXISTS code_chunks (
+    id          INTEGER PRIMARY KEY AUTOINCREMENT,
+    project     TEXT NOT NULL,
+    file_path   TEXT NOT NULL,
+    language    TEXT,
+    start_line  INTEGER NOT NULL,
+    end_line    INTEGER NOT NULL,
+    content     TEXT NOT NULL,
+    mtime       INTEGER NOT NULL,
+    indexed_at  TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_chunks_project ON code_chunks(project);
+CREATE INDEX IF NOT EXISTS idx_chunks_file ON code_chunks(project, file_path);
+
+-- FTS5 for searching code content
+CREATE VIRTUAL TABLE IF NOT EXISTS code_chunks_fts USING fts5(
+    file_path,
+    content,
+    content='code_chunks',
+    content_rowid='id'
+);
+
+CREATE TRIGGER IF NOT EXISTS chunks_ai AFTER INSERT ON code_chunks BEGIN
+    INSERT INTO code_chunks_fts(rowid, file_path, content)
+    VALUES (new.id, new.file_path, new.content);
+END;
+
+CREATE TRIGGER IF NOT EXISTS chunks_ad AFTER DELETE ON code_chunks BEGIN
+    INSERT INTO code_chunks_fts(code_chunks_fts, rowid, file_path, content)
+    VALUES ('delete', old.id, old.file_path, old.content);
+END;
+
+CREATE TRIGGER IF NOT EXISTS chunks_au AFTER UPDATE ON code_chunks BEGIN
+    INSERT INTO code_chunks_fts(code_chunks_fts, rowid, file_path, content)
+    VALUES ('delete', old.id, old.file_path, old.content);
+    INSERT INTO code_chunks_fts(rowid, file_path, content)
+    VALUES (new.id, new.file_path, new.content);
+END;

package/db/migrate.sh

@@ -0,0 +1,47 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════
+# Eagle Mem — Database migration runner
+# Idempotent: safe to run multiple times
+# ═══════════════════════════════════════════════════════════
+set -euo pipefail
+
+EAGLE_MEM_DIR="${EAGLE_MEM_DIR:-$HOME/.eagle-mem}"
+DB="$EAGLE_MEM_DIR/memory.db"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+
+mkdir -p "$EAGLE_MEM_DIR"
+
+run_migration() {
+    local name="$1"
+    local file="$2"
+
+    local already_applied
+    already_applied=$(sqlite3 "$DB" "SELECT COUNT(*) FROM _migrations WHERE name = '$name';" 2>/dev/null || echo "0")
+
+    if [ "$already_applied" = "0" ]; then
+        sqlite3 "$DB" < "$file"
+        sqlite3 "$DB" "INSERT INTO _migrations (name) VALUES ('$name');"
+        echo "  applied: $name"
+    fi
+}
+
+# Ensure _migrations table exists (bootstrap)
+sqlite3 "$DB" "CREATE TABLE IF NOT EXISTS _migrations (
+    id         INTEGER PRIMARY KEY,
+    name       TEXT    NOT NULL UNIQUE,
+    applied_at TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))
+);"
+
+# Set PRAGMAs (these must be set on every connection)
+sqlite3 "$DB" "PRAGMA journal_mode = WAL; PRAGMA synchronous = NORMAL; PRAGMA busy_timeout = 5000; PRAGMA foreign_keys = ON;"
+
+# ─── Migration 001: Initial schema ─────────────────────────
+run_migration "001_initial_schema" "$SCRIPT_DIR/schema.sql"
+
+# ─── Migration 002: Project overviews ──────────────────────
+run_migration "002_overviews" "$SCRIPT_DIR/002_overviews.sql"
+
+# ─── Migration 003: Code chunks ───────────────────────────
+run_migration "003_code_chunks" "$SCRIPT_DIR/003_code_chunks.sql"
+
+echo "  Eagle Mem database ready: $DB"

package/db/schema.sql

@@ -0,0 +1,154 @@
+-- ═══════════════════════════════════════════════════════════
+-- Eagle Mem — Schema v1
+-- Single shared SQLite database at ~/.eagle-mem/memory.db
+-- ═══════════════════════════════════════════════════════════
+
+-- NOTE: PRAGMAs are connection-scoped and do NOT persist.
+-- These only apply during migration. Runtime PRAGMAs are set
+-- in lib/db.sh EAGLE_DB_SETUP on every connection.
+PRAGMA journal_mode = WAL;
+PRAGMA synchronous = NORMAL;
+PRAGMA foreign_keys = ON;
+PRAGMA temp_store = memory;
+
+-- ─── Migration tracking ────────────────────────────────────
+
+CREATE TABLE IF NOT EXISTS _migrations (
+    id         INTEGER PRIMARY KEY,
+    name       TEXT    NOT NULL UNIQUE,
+    applied_at TEXT    NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))
+);
+
+-- ─── Sessions ──────────────────────────────────────────────
+
+CREATE TABLE IF NOT EXISTS sessions (
+    id              TEXT PRIMARY KEY,
+    project         TEXT NOT NULL,
+    cwd             TEXT,
+    model           TEXT,
+    source          TEXT,
+    started_at      TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    ended_at        TEXT,
+    status          TEXT NOT NULL DEFAULT 'active' CHECK (status IN ('active', 'completed', 'abandoned'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_sessions_project ON sessions(project);
+CREATE INDEX IF NOT EXISTS idx_sessions_status ON sessions(status);
+
+-- ─── Observations ──────────────────────────────────────────
+-- Lightweight per-tool-use records: what files were touched
+
+CREATE TABLE IF NOT EXISTS observations (
+    id              INTEGER PRIMARY KEY AUTOINCREMENT,
+    session_id      TEXT NOT NULL REFERENCES sessions(id),
+    project         TEXT NOT NULL,
+    tool_name       TEXT NOT NULL,
+    tool_input_summary TEXT,
+    files_read      TEXT DEFAULT '[]',
+    files_modified  TEXT DEFAULT '[]',
+    created_at      TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_observations_session ON observations(session_id);
+CREATE INDEX IF NOT EXISTS idx_observations_project ON observations(project);
+
+-- ─── Summaries ─────────────────────────────────────────────
+-- Per-session summaries: what was accomplished
+
+CREATE TABLE IF NOT EXISTS summaries (
+    id              INTEGER PRIMARY KEY AUTOINCREMENT,
+    session_id      TEXT NOT NULL REFERENCES sessions(id),
+    project         TEXT NOT NULL,
+    request         TEXT,
+    investigated    TEXT,
+    learned         TEXT,
+    completed       TEXT,
+    next_steps      TEXT,
+    files_read      TEXT DEFAULT '[]',
+    files_modified  TEXT DEFAULT '[]',
+    notes           TEXT,
+    created_at      TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_summaries_session ON summaries(session_id);
+CREATE INDEX IF NOT EXISTS idx_summaries_project ON summaries(project);
+
+-- ─── Tasks (TaskAware Compact Loop) ───────────────────────
+-- Subtasks for multi-step work with compaction between each
+
+CREATE TABLE IF NOT EXISTS tasks (
+    id              INTEGER PRIMARY KEY AUTOINCREMENT,
+    project         TEXT NOT NULL,
+    session_id      TEXT REFERENCES sessions(id),
+    parent_id       INTEGER REFERENCES tasks(id),
+    title           TEXT NOT NULL,
+    instructions    TEXT,
+    context_snapshot TEXT,
+    status          TEXT NOT NULL DEFAULT 'pending' CHECK (status IN ('pending', 'active', 'done', 'blocked', 'cancelled')),
+    ordinal         INTEGER NOT NULL DEFAULT 0,
+    created_at      TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%fZ', 'now')),
+    started_at      TEXT,
+    completed_at    TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_tasks_project ON tasks(project);
+CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status);
+CREATE INDEX IF NOT EXISTS idx_tasks_parent ON tasks(parent_id);
+
+-- ─── FTS5: Full-text search on summaries ───────────────────
+
+CREATE VIRTUAL TABLE IF NOT EXISTS summaries_fts USING fts5(
+    request,
+    investigated,
+    learned,
+    completed,
+    next_steps,
+    notes,
+    content='summaries',
+    content_rowid='id'
+);
+
+-- Triggers to keep FTS in sync
+CREATE TRIGGER IF NOT EXISTS summaries_ai AFTER INSERT ON summaries BEGIN
+    INSERT INTO summaries_fts(rowid, request, investigated, learned, completed, next_steps, notes)
+    VALUES (new.id, new.request, new.investigated, new.learned, new.completed, new.next_steps, new.notes);
+END;
+
+CREATE TRIGGER IF NOT EXISTS summaries_ad AFTER DELETE ON summaries BEGIN
+    INSERT INTO summaries_fts(summaries_fts, rowid, request, investigated, learned, completed, next_steps, notes)
+    VALUES ('delete', old.id, old.request, old.investigated, old.learned, old.completed, old.next_steps, old.notes);
+END;
+
+CREATE TRIGGER IF NOT EXISTS summaries_au AFTER UPDATE ON summaries BEGIN
+    INSERT INTO summaries_fts(summaries_fts, rowid, request, investigated, learned, completed, next_steps, notes)
+    VALUES ('delete', old.id, old.request, old.investigated, old.learned, old.completed, old.next_steps, old.notes);
+    INSERT INTO summaries_fts(rowid, request, investigated, learned, completed, next_steps, notes)
+    VALUES (new.id, new.request, new.investigated, new.learned, new.completed, new.next_steps, new.notes);
+END;
+
+-- ─── FTS5: Full-text search on tasks ──────────────────────
+
+CREATE VIRTUAL TABLE IF NOT EXISTS tasks_fts USING fts5(
+    title,
+    instructions,
+    context_snapshot,
+    content='tasks',
+    content_rowid='id'
+);
+
+CREATE TRIGGER IF NOT EXISTS tasks_ai AFTER INSERT ON tasks BEGIN
+    INSERT INTO tasks_fts(rowid, title, instructions, context_snapshot)
+    VALUES (new.id, new.title, new.instructions, new.context_snapshot);
+END;
+
+CREATE TRIGGER IF NOT EXISTS tasks_ad AFTER DELETE ON tasks BEGIN
+    INSERT INTO tasks_fts(tasks_fts, rowid, title, instructions, context_snapshot)
+    VALUES ('delete', old.id, old.title, old.instructions, old.context_snapshot);
+END;
+
+CREATE TRIGGER IF NOT EXISTS tasks_au AFTER UPDATE ON tasks BEGIN
+    INSERT INTO tasks_fts(tasks_fts, rowid, title, instructions, context_snapshot)
+    VALUES ('delete', old.id, old.title, old.instructions, old.context_snapshot);
+    INSERT INTO tasks_fts(rowid, title, instructions, context_snapshot)
+    VALUES (new.id, new.title, new.instructions, new.context_snapshot);
+END;

package/hooks/post-tool-use.sh

@@ -0,0 +1,76 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════
+# Eagle Mem — PostToolUse hook
+# Fires after every tool use
+# Captures file read/write operations as lightweight observations
+# ═══════════════════════════════════════════════════════════
+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
+
+session_id=$(echo "$input" | jq -r '.session_id // empty')
+cwd=$(echo "$input" | jq -r '.cwd // empty')
+tool_name=$(echo "$input" | jq -r '.tool_name // empty')
+
+[ -z "$session_id" ] || [ -z "$tool_name" ] && exit 0
+
+# Only track file-related tools
+case "$tool_name" in
+    Read|Write|Edit|Bash) ;;
+    *) exit 0 ;;
+esac
+
+[ ! -f "$EAGLE_MEM_DB" ] && exit 0
+
+project=$(eagle_project_from_cwd "$cwd")
+
+files_read="[]"
+files_modified="[]"
+tool_summary=""
+
+case "$tool_name" in
+    Read)
+        fp=$(echo "$input" | jq -r '.tool_input.file_path // empty')
+        [ -n "$fp" ] && files_read="[\"$fp\"]"
+        tool_summary="Read $fp"
+        ;;
+    Write)
+        fp=$(echo "$input" | jq -r '.tool_input.file_path // empty')
+        [ -n "$fp" ] && files_modified="[\"$fp\"]"
+        tool_summary="Write $fp"
+        ;;
+    Edit)
+        fp=$(echo "$input" | jq -r '.tool_input.file_path // empty')
+        [ -n "$fp" ] && files_modified="[\"$fp\"]"
+        tool_summary="Edit $fp"
+        ;;
+    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')
+        tool_summary="Bash: $cmd"
+        ;;
+esac
+
+# Deduplicate: skip if exact same observation within last 5 seconds
+dup_count=$(eagle_observation_exists "$session_id" "$tool_name" "$tool_summary")
+if [ "$dup_count" != "0" ]; then
+    exit 0
+fi
+
+eagle_insert_observation "$session_id" "$project" "$tool_name" "$tool_summary" "$files_read" "$files_modified"
+
+exit 0

package/hooks/session-end.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════
+# Eagle Mem — SessionEnd hook
+# Fires when the Claude Code session ends
+# Marks the session as completed
+# ═══════════════════════════════════════════════════════════
+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
+
+session_id=$(echo "$input" | jq -r '.session_id // empty')
+[ -z "$session_id" ] && exit 0
+[ ! -f "$EAGLE_MEM_DB" ] && exit 0
+
+eagle_end_session "$session_id"
+eagle_log "INFO" "SessionEnd: session=$session_id marked completed"
+
+exit 0