eagle-mem 4.8.0 → 4.8.1

package/README.md

@@ -1,16 +1,29 @@
 ```
 ======================================
        Eagle Mem
-  context that survives /compact
+ shared memory | guardrails | lanes
 ======================================
 ```
 
 # Eagle Mem
 
-**Context that survives `/compact`.**
+**Shared memory, release guardrails, and worker lanes for Claude Code and Codex.**
 
-**v4.8.0 ships first-class cross-agent orchestration, compact Codex hook recall, enforced anti-regression checks, and configurable RTK token guardrails.**
-Claude Code and Codex can now share the same local Eagle Mem database, while every captured row records which agent created it.
+Eagle Mem turns AI coding sessions into compounding project knowledge. It gives Claude Code and Codex the same local memory, labels which agent created each memory, blocks risky release commands until affected features are verified, and lets broad work split into durable worker lanes.
+
+**v4.8.1 ships the communication refresh for the new architecture:** cross-agent orchestration, compact Codex hook recall, enforced anti-regression checks, configurable RTK token guardrails, and a memory-sync fix for large memory files.
+
+**Website:** [Product](https://eagleisbatman.github.io/eagle-mem/) |
+[Architecture](https://eagleisbatman.github.io/eagle-mem/architecture.html) |
+[About](https://eagleisbatman.github.io/eagle-mem/about.html)
+
+## Why People Install It
+
+- **Start warmer** - every new session can recall project overviews, decisions, gotchas, summaries, hot files, mirrored memories, plans, and tasks.
+- **Ship safer** - feature-mapped changes create pending verification records, and release-boundary commands stay blocked until the current diff is verified or waived.
+- **Waste fewer tokens** - Eagle Mem injects compact context, nudges duplicate reads, and can route noisy shell output through RTK.
+- **Coordinate agents** - Codex and Claude Code can share one project memory while worker lanes record owner, model, effort, worktree, logs, validation, and handoff.
+- **Stay local** - no daemon, no hosted memory service, no vector database. The core is hooks plus SQLite/FTS5.
 
 ## The Problem
 
@@ -18,9 +31,17 @@ Claude Code and Codex start every session with amnesia. They don't remember what
 
 The longer you work with Claude Code, the worse this gets. Projects accumulate history — decisions, gotchas, architectural patterns, feature dependencies — and none of it survives across sessions.
 
-## The Solution
+## The Product
 
-Eagle Mem is a recall and regression-control layer for Claude Code and Codex. Every session starts with context from previous sessions — summaries, decisions, memories, tasks, project overviews, and relevant code — injected automatically via hooks. Both agents share the same SQLite database at `~/.eagle-mem/memory.db`, and captured rows are source-attributed as `Claude Code` or `Codex`.
+Eagle Mem is a local runtime layer for AI coding agents. It adds three things that ordinary agent sessions do not have by default:
+
+| Layer | What users feel | What Eagle Mem does |
+|-------|-----------------|---------------------|
+| **Recall** | "The agent remembers this repo." | Loads project overviews, summaries, decisions, memories, tasks, plans, and relevant indexed code. |
+| **Guardrails** | "The agent cannot casually undo known decisions or push unverified feature changes." | Surfaces decisions before edits and enforces feature verification on push, PR, and publish boundaries. |
+| **Lanes** | "A big task can survive compaction and split across agents." | Persists orchestrations, worker lanes, worktrees, logs, validation commands, and handoffs. |
+
+Both agents share the same SQLite database at `~/.eagle-mem/memory.db`, and captured rows are source-attributed as `Claude Code` or `Codex`.
 
 **Zero per-instance overhead.** No daemon, no vector DB, no MCP server. Just bash scripts, sqlite3 (WAL mode, FTS5 full-text search), and jq.
 
@@ -128,6 +149,10 @@ Eagle Mem prevents Claude from repeating past mistakes:
 | `eagle-mem scan` | Scan codebase and generate overview |
 | `eagle-mem index` | Index source files for FTS5 code search |
 
+### v4.8.1 Patch
+
+`eagle-mem memories sync` is now safe on large Claude Code/Codex memory files. The memory mirror parser no longer uses early-exit pipelines under `pipefail`, avoiding exit `141` during sync.
+
 ### Search Modes
 
 ```bash

package/lib/db-mirrors.sh

@@ -23,7 +23,7 @@ eagle_capture_agent_memory() {
         body=$(cat "$file_path")
     fi
 
-    _fm_field() { printf '%s\n' "$fm" | awk -F': *' -v k="$1" '$1==k{sub(/^[^:]+: */,""); gsub(/^"|"$/,""); print; exit}'; }
+    _fm_field() { awk -F': *' -v k="$1" '$1==k{sub(/^[^:]+: */,""); gsub(/^"|"$/,""); print; exit}' <<< "$fm"; }
 
     local mname mdesc mtype morigin
     mname=$(_fm_field "name")
@@ -41,7 +41,14 @@ eagle_capture_agent_memory() {
     fi
     [ -z "$mtype" ] && mtype="$agent"
     if [ -z "$mdesc" ]; then
-        mdesc=$(printf '%s\n' "$body" | sed '/^[[:space:]]*$/d' | head -1 | cut -c1-200)
+        mdesc=$(awk '
+            /^[[:space:]]*$/ { next }
+            {
+                line = substr($0, 1, 200)
+                print line
+                exit
+            }
+        ' <<< "$body")
     fi
 
     local fp_sql proj_sql name_sql desc_sql type_sql content_sql hash_sql origin_sql agent_sql

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "eagle-mem",
-  "version": "4.8.0",
-  "description": "Context that survives /compact for Claude Code and Codex — SQLite + FTS5, no daemon, no bloat",
+  "version": "4.8.1",
+  "description": "Shared memory, release guardrails, RTK token protection, and worker lanes for Claude Code and Codex",
   "bin": {
     "eagle-mem": "bin/eagle-mem"
   },

package/scripts/help.sh

@@ -13,24 +13,35 @@ version=$(jq -r .version "$PACKAGE_DIR/package.json" 2>/dev/null || echo "unknow
 eagle_banner
 
 echo -e "  ${BOLD}Eagle Mem${RESET} ${DIM}v${version}${RESET}"
-echo -e "  ${DIM}Context that survives /compact for Claude Code and Codex${RESET}"
+echo -e "  ${DIM}Shared memory, release guardrails, RTK token protection, and worker lanes${RESET}"
+echo -e "  ${DIM}for Claude Code and Codex.${RESET}"
 echo ""
-echo -e "  ${BOLD}Commands:${RESET}"
+echo -e "  ${BOLD}Core commands:${RESET}"
 echo -e "    ${CYAN}install${RESET}     First-time setup: hooks, database, skills"
 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}config${RESET}      View or change provider and token-guard settings"
-echo -e "    ${CYAN}guard${RESET}       Manage regression guardrails for files"
 echo -e "    ${CYAN}overview${RESET}    Build or view project overview"
 echo -e "    ${CYAN}memories${RESET}    View/sync agent memories"
 echo -e "    ${CYAN}tasks${RESET}       View mirrored tasks"
-echo -e "    ${CYAN}orchestrate${RESET} Durable worker-lane coordination"
+echo ""
+echo -e "  ${BOLD}Safety and token controls:${RESET}"
+echo -e "    ${CYAN}feature${RESET}     Track, verify, and unblock feature changes"
+echo -e "    ${CYAN}guard${RESET}       Manage regression guardrails for files"
+echo -e "    ${CYAN}config${RESET}      View/change providers, RTK, and token guard settings"
+echo ""
+echo -e "  ${BOLD}Automation and coordination:${RESET}"
 echo -e "    ${CYAN}curate${RESET}      Run curator (co-edits, hot files, guardrails)"
-echo -e "    ${CYAN}feature${RESET}     Track, verify, and unblock features"
+echo -e "    ${CYAN}orchestrate${RESET} Durable worker-lane coordination"
 echo -e "    ${CYAN}prune${RESET}       Clean old sessions and stale data"
 echo ""
+echo -e "  ${BOLD}What it protects:${RESET}"
+echo -e "    ${DIM}Recall${RESET}       Project overview, summaries, memories, plans, tasks, code index"
+echo -e "    ${DIM}Guardrails${RESET}   Decisions, gotchas, feature verification, stale memory warnings"
+echo -e "    ${DIM}Tokens${RESET}       Compact hook recall and optional RTK shell-output routing"
+echo -e "    ${DIM}Lanes${RESET}        Cross-agent worker status, worktrees, logs, validation, handoffs"
+echo ""
 echo -e "  ${BOLD}Search modes:${RESET}"
 echo -e "    ${DIM}\$${RESET} eagle-mem search \"auth bug\"    ${DIM}# keyword search${RESET}"
 echo -e "    ${DIM}\$${RESET} eagle-mem search --timeline     ${DIM}# recent sessions${RESET}"

package/scripts/style.sh

@@ -18,7 +18,7 @@ CROSS="${RED}✗${RESET}"
 ARROW="${CYAN}→${RESET}"
 DOT="${DIM}·${RESET}"
 EAGLE_RULE="======================================"
-EAGLE_TAGLINE="context that survives /compact"
+EAGLE_TAGLINE="shared memory | guardrails | lanes"
 
 eagle_header() {
     echo ""