eagle-mem 4.8.3 → 4.8.5

package/README.md

@@ -11,7 +11,7 @@
 
 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.3 ships Codex output and communication polish:** Codex final replies now stay clean by default instead of printing large `<eagle-summary>` capture blocks, installer/update output uses clean-output wording, and the GitHub Pages homepage now has a clearer hero plus explicit installer/orchestrator sections.
+**v4.8.5 hardens first-run setup:** `eagle-mem config init` now falls through cleanly when Ollama is not running, and DB-backed commands fail loudly when the active `sqlite3` lacks FTS5 support.
 
 **Website:** [Product](https://eagleisbatman.github.io/eagle-mem/) |
 [Architecture](https://eagleisbatman.github.io/eagle-mem/architecture.html) |
@@ -149,6 +149,14 @@ 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.5 Patch
+
+First-run configuration no longer exits silently when Ollama is not listening on `localhost:11434`; Eagle Mem falls through to the installed Codex/Claude CLI provider or API-key providers. SQLite/FTS5 failures are now surfaced before DB-backed commands run, including the exact `sqlite3` binary being used and PATH guidance for common macOS Android SDK shadowing. Worker worktree paths are also canonicalized back to the main project key so backfill cannot move feature guardrails into disposable orchestration worktrees.
+
+### v4.8.4 Patch
+
+The orchestration handoff path is now Bash 3.2-safe, so `eagle-mem orchestrate handoff` works even when no lane options are present. This patch was verified with a real Codex coordinator -> Claude Code worker proof lane using `claude-opus-4-7` at `xhigh`; the completed lane is visible through `eagle-mem orchestrate --json`, `eagle-mem tasks completed`, and the generated handoff output. Release-boundary detection also ignores Eagle Mem's own `feature verify`/`waive` commands, so verification notes can mention dry-run checks without blocking themselves.
+
 ### v4.8.3 Patch
 
 GitHub Pages now keeps hero text readable over the terminal background and the homepage explicitly explains installer-created/updated `CLAUDE.md` and `AGENTS.md` sections plus orchestrator/worker mode. Installer/update output also uses the new clean-output Codex wording instead of saying it added eagle-summary instructions.

package/db/migrate.sh

@@ -9,6 +9,20 @@ EAGLE_MEM_DIR="${EAGLE_MEM_DIR:-$HOME/.eagle-mem}"
 DB="$EAGLE_MEM_DIR/memory.db"
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
 
+COMMON_SH="$SCRIPT_DIR/../lib/common.sh"
+if [ -f "$COMMON_SH" ]; then
+    . "$COMMON_SH"
+    eagle_require_sqlite_fts5 || exit 1
+else
+    sqlite_path=$(command -v sqlite3 2>/dev/null || true)
+    if [ -z "$sqlite_path" ] || ! sqlite3 :memory: "CREATE VIRTUAL TABLE eagle_mem_fts5_probe USING fts5(value);" >/dev/null 2>&1; then
+        echo "Eagle Mem requires SQLite FTS5, but the active sqlite3 does not support it." >&2
+        [ -n "$sqlite_path" ] && echo "Detected sqlite3: $sqlite_path" >&2
+        echo "Fix PATH so an FTS5-capable sqlite3 is first, then re-run the command." >&2
+        exit 1
+    fi
+fi
+
 # Restrict permissions: DB and config contain session data and may contain
 # residual secrets despite redaction. Owner-only access (700 dir, 600 files).
 umask 077

package/lib/common.sh

@@ -20,6 +20,47 @@ EAGLE_CODEX_SKILLS_DIR="${EAGLE_CODEX_SKILLS_DIR:-$EAGLE_CODEX_DIR/skills}"
 EAGLE_CODEX_MEMORIES_DIR="${EAGLE_CODEX_MEMORIES_DIR:-$EAGLE_CODEX_DIR/memories}"
 EAGLE_RAW_BASH_UNLOCK="${EAGLE_RAW_BASH_UNLOCK:-/tmp/eagle-mem-raw-bash-unlock}"
 
+eagle_sqlite_path() {
+    command -v sqlite3 2>/dev/null || true
+}
+
+eagle_sqlite_version() {
+    sqlite3 --version 2>/dev/null | awk '{print $1}'
+}
+
+eagle_sqlite_supports_fts5() {
+    command -v sqlite3 >/dev/null 2>&1 || return 1
+    sqlite3 :memory: "CREATE VIRTUAL TABLE eagle_mem_fts5_probe USING fts5(value);" >/dev/null 2>&1
+}
+
+eagle_print_sqlite_fts5_error() {
+    local sqlite_path sqlite_version probe_error
+    sqlite_path=$(eagle_sqlite_path)
+    sqlite_version=$(eagle_sqlite_version)
+    probe_error=$(sqlite3 :memory: "CREATE VIRTUAL TABLE eagle_mem_fts5_probe USING fts5(value);" 2>&1 >/dev/null || true)
+
+    printf '%s\n' "Eagle Mem requires SQLite FTS5, but the active sqlite3 does not support it." >&2
+    if [ -n "$sqlite_path" ]; then
+        printf '%s\n' "Detected sqlite3: $sqlite_path" >&2
+    else
+        printf '%s\n' "Detected sqlite3: not found on PATH" >&2
+    fi
+    [ -n "$sqlite_version" ] && printf '%s\n' "SQLite version: $sqlite_version" >&2
+    [ -n "$probe_error" ] && printf '%s\n' "SQLite error: $probe_error" >&2
+    printf '%s\n' "Fix: put an FTS5-capable sqlite3 earlier in PATH, then re-run the command." >&2
+    printf '%s\n' "macOS: check 'command -v sqlite3'; /usr/bin/sqlite3 usually has FTS5. If Android SDK platform-tools is first, move it later in PATH." >&2
+    printf '%s\n' "Homebrew: install sqlite and prepend its bin directory, for example: export PATH=\"/opt/homebrew/opt/sqlite/bin:\$PATH\"" >&2
+    printf '%s\n' "Linux: install a sqlite3 package compiled with ENABLE_FTS5." >&2
+}
+
+eagle_require_sqlite_fts5() {
+    if eagle_sqlite_supports_fts5; then
+        return 0
+    fi
+    eagle_print_sqlite_fts5_error
+    return 1
+}
+
 eagle_log() {
     local level="$1"
     shift
@@ -51,6 +92,23 @@ eagle_project_from_cwd() {
         "$HOME/Desktop"|"$HOME/Desktop/"*) echo ""; return ;;
     esac
 
+    # Eagle Mem worker lanes run in sibling git worktrees under
+    # <parent>/.eagle-worktrees/<repo>/<lane>. Keep their observations attached
+    # to the real project, not to the disposable worktree path.
+    case "$resolved" in
+        "$HOME"/*/.eagle-worktrees/*)
+            local worktree_parent worktree_tail worktree_repo worktree_project
+            worktree_parent="${resolved%%/.eagle-worktrees/*}"
+            worktree_tail="${resolved#"$worktree_parent/.eagle-worktrees/"}"
+            worktree_repo="${worktree_tail%%/*}"
+            worktree_project="$worktree_parent/$worktree_repo"
+            if [ -n "$worktree_repo" ] && [ -d "$worktree_project" ]; then
+                echo "${worktree_project#$HOME/}"
+                return
+            fi
+            ;;
+    esac
+
     local target_dir
     local git_root
     git_root=$(git -C "$cwd" rev-parse --show-toplevel 2>/dev/null)
@@ -378,6 +436,10 @@ eagle_is_release_boundary_command() {
             function has_dry_run_flag(line) {
                 return line ~ /(^|[[:space:]])--dry-run([[:space:]]|$|=([Tt][Rr][Uu][Ee]|1|[Yy][Ee][Ss])([[:space:]]|$))/
             }
+            function is_eagle_feature_command(line) {
+                return line ~ /(^|[[:space:]])([^[:space:]]*\/)?eagle-mem[[:space:]]+feature[[:space:]]+(verify|waive|pending|list)([[:space:]]|$)/
+            }
+            is_eagle_feature_command($0) { next }
             /(^|[[:space:]])gh[[:space:]]+pr[[:space:]]+create([[:space:]]|$)/ ||
             /(^|[[:space:]])npm[[:space:]]+publish([[:space:]]|$)/ ||
             /(^|[[:space:]])pnpm[[:space:]]+publish([[:space:]]|$)/ ||
@@ -399,6 +461,10 @@ eagle_is_release_boundary_command() {
             function has_dry_run_flag(line) {
                 return line ~ /(^|[[:space:]])--dry-run([[:space:]]|$|=([Tt][Rr][Uu][Ee]|1|[Yy][Ee][Ss])([[:space:]]|$))/
             }
+            function is_eagle_feature_command(line) {
+                return line ~ /(^|[[:space:]])([^[:space:]]*\/)?eagle-mem[[:space:]]+feature[[:space:]]+(verify|waive|pending|list)([[:space:]]|$)/
+            }
+            is_eagle_feature_command($0) { next }
             /(^|[[:space:]])git[[:space:]]+push([[:space:]]|$)/ {
                 if (!has_dry_run_flag($0)) found = 1
             }

package/lib/db-core.sh

@@ -57,6 +57,8 @@ eagle_db_json() {
 }
 
 eagle_ensure_db() {
+    eagle_require_sqlite_fts5 || return 1
+
     if [ ! -f "$EAGLE_MEM_DB" ]; then
         local script_dir
         script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")/../db" && pwd)"

package/lib/provider.sh

@@ -124,10 +124,10 @@ eagle_config_init() {
     local ollama_model="mistral"
 
     local ollama_response
-    ollama_response=$(eagle_detect_ollama "$ollama_url")
+    ollama_response=$(eagle_detect_ollama "$ollama_url" || true)
     if [ -n "$ollama_response" ]; then
         provider="ollama"
-        model=$(eagle_ollama_best_model "$ollama_url")
+        model=$(eagle_ollama_best_model "$ollama_url" || true)
         ollama_model="$model"
     elif command -v codex &>/dev/null || command -v claude &>/dev/null; then
         provider="agent_cli"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eagle-mem",
-  "version": "4.8.3",
+  "version": "4.8.5",
   "description": "Shared memory, release guardrails, RTK token protection, and worker lanes for Claude Code and Codex",
   "bin": {
     "eagle-mem": "bin/eagle-mem"

package/scripts/install.sh

@@ -81,12 +81,19 @@ 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"
+    sqlite_path=$(eagle_sqlite_path)
+    if eagle_sqlite_supports_fts5; then
+        eagle_ok "FTS5 support ${DIM}($sqlite_path)${RESET}"
     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"
+        eagle_dim "Detected sqlite3: $sqlite_path"
+        sqlite_version=$(eagle_sqlite_version)
+        [ -n "$sqlite_version" ] && eagle_dim "SQLite version: $sqlite_version"
+        eagle_dim "Run: command -v sqlite3"
+        eagle_dim "Fix PATH so an FTS5-capable sqlite3 is first."
+        eagle_dim "macOS: /usr/bin/sqlite3 usually has FTS5; move Android SDK platform-tools later if it shadows sqlite3."
+        eagle_dim "Homebrew: brew install sqlite, then prepend /opt/homebrew/opt/sqlite/bin or /usr/local/opt/sqlite/bin."
+        eagle_dim "Linux: install a sqlite3 package compiled with ENABLE_FTS5."
         prereqs_ok=false
     fi
 fi

package/scripts/orchestrate.sh

@@ -452,7 +452,11 @@ parse_lane_options() {
         esac
         i=$((i + 1))
     done
-    args=("${parsed[@]}")
+    if [ "${#parsed[@]}" -gt 0 ]; then
+        args=("${parsed[@]}")
+    else
+        args=()
+    fi
 }
 
 lane_add() {
@@ -758,7 +762,11 @@ parse_spawn_options() {
         esac
         i=$((i + 1))
     done
-    args=("${parsed[@]}")
+    if [ "${#parsed[@]}" -gt 0 ]; then
+        args=("${parsed[@]}")
+    else
+        args=()
+    fi
 }
 
 orchestrate_worker_run_script() {