lacy 1.8.11 → 1.8.13

package/lib/core/constants.sh

@@ -0,0 +1,366 @@
+#!/usr/bin/env bash
+
+# Lacy Shell Constants — shared across Bash 4+ and ZSH
+# Sourced by lib/zsh/init.zsh and lib/bash/init.bash
+
+# === Runtime State ===
+LACY_SHELL_ENABLED=true
+LACY_SHELL_DEFER_QUIT=false
+
+# === Shell Type (set by entry point before sourcing) ===
+# LACY_SHELL_TYPE — "zsh" or "bash"
+# _LACY_ARR_OFFSET — 1 for ZSH (1-based), 0 for Bash (0-based)
+
+# === Paths ===
+: "${LACY_SHELL_HOME:="${HOME}/.lacy"}"
+
+: "${LACY_SHELL_CONFIG_FILE:="${LACY_SHELL_HOME}/config.yaml"}"
+
+: "${LACY_SHELL_MODE_FILE:="${LACY_SHELL_HOME}/current_mode"}"
+
+: "${LACY_SHELL_CONVERSATION_FILE:="${LACY_SHELL_HOME}/conversation.log"}"
+
+: "${LACY_SHELL_MCP_DIR:="${LACY_SHELL_HOME}/mcp"}"
+
+# === Defaults ===
+: "${LACY_SHELL_DEFAULT_MODE:="auto"}"
+
+: "${LACY_SHELL_DEFAULT_INDICATOR_STYLE:="top"}"
+
+: "${LACY_SHELL_DEFAULT_CONFIDENCE_THRESHOLD:="0.7"}"
+
+: "${LACY_SHELL_DEFAULT_PROVIDER:="openai"}"
+
+: "${LACY_SHELL_DEFAULT_MODEL:="gpt-4o-mini"}"
+
+# === Timeouts (in milliseconds) ===
+: "${LACY_SHELL_EXIT_TIMEOUT_MS:=1000}"
+
+: "${LACY_SHELL_EXIT_TIMEOUT_SEC:="1.0"}"
+
+: "${LACY_SHELL_MESSAGE_DURATION_SEC:="1.0"}"
+
+: "${LACY_SHELL_MCP_TIMEOUT_SEC:=5}"
+
+# === UI ===
+: "${LACY_SHELL_TOP_BAR_HEIGHT:=1}"
+
+# === Preheat ===
+: "${LACY_PREHEAT_EAGER:="false"}"
+: "${LACY_PREHEAT_SERVER_PORT:="4096"}"
+
+# === Colors (256-color palette) ===
+LACY_COLOR_SHELL=34        # Green - shell commands
+LACY_COLOR_AGENT=200       # Magenta - agent queries
+LACY_COLOR_AUTO=75         # Blue - auto mode
+LACY_COLOR_NEUTRAL=238     # Dark gray - neutral/dim
+LACY_COLOR_SHIMMER=(255 219 213 200 141)  # Spinner shimmer gradient
+
+# === Detection ===
+# (LACY_HARD_AGENT_INDICATORS removed — replaced by LACY_AGENT_WORDS below)
+
+# Shell reserved words — pass `command -v` but are never valid standalone commands.
+# Used by Layer 1 of natural language detection (see docs/NATURAL_LANGUAGE_DETECTION.md).
+LACY_SHELL_RESERVED_WORDS=("do" "done" "then" "else" "elif" "fi" "esac" "in" "select" "function" "coproc" "{" "}" "!" "[[")
+
+# Agent words — common English words that always route to agent, even as
+# single-word input. Some (yes, nice, cancel) exist as real commands but are
+# almost never typed standalone intentionally.
+# Kept in sync with lash plugin/shell-mode/command-check.ts AGENT_WORDS.
+LACY_AGENT_WORDS=(
+    # affirmations
+    "yes" "yeah" "yep" "yup" "sure" "ok" "okay" "alright"
+    "absolutely" "definitely" "certainly" "indeed" "correct" "right" "exactly"
+    "perfect" "agreed" "affirmative" "totally" "clearly" "obviously" "lgtm"
+    "roger" "understood" "acknowledged" "gotcha"
+    # negations
+    "no" "nope" "nah" "never" "wrong" "disagree" "nay" "meh"
+    # gratitude
+    "thanks" "thank" "thx" "ty" "cheers" "appreciated" "kudos" "congrats" "bravo"
+    # reactions
+    "great" "good" "nice" "cool" "awesome" "amazing" "wonderful" "brilliant"
+    "excellent" "fantastic" "sweet" "neat" "beautiful" "gorgeous" "impressive"
+    "incredible" "outstanding" "superb" "marvelous" "magnificent" "stellar"
+    "phenomenal" "terrific" "splendid" "fine" "solid" "dope" "sick" "fire" "lit" "rad" "legit"
+    "noice" "yay" "hooray" "woah"
+    # greetings/closings
+    "hey" "hi" "hello" "howdy" "sup" "yo" "bye" "goodbye" "cya" "later"
+    # conversational
+    "please" "sorry" "pardon" "hmm" "huh" "wow" "whoa" "oops" "ugh" "yikes"
+    "damn" "dang" "shoot" "welp" "well" "anyway" "anyways" "regardless"
+    "meanwhile" "honestly" "basically" "literally" "actually" "really"
+    "seriously" "hopefully" "unfortunately" "apparently"
+    "supposedly" "probably" "maybe" "perhaps" "possibly"
+    "sheesh" "geez" "oof" "ouch" "bummer" "duh"
+    # internet/chat shorthand
+    "lol" "haha" "heh" "omg" "wtf" "idk" "fyi" "btw" "imho" "imo" "tbh" "pls" "plz"
+    # action/intent
+    "stop" "hold" "pause" "cancel" "abort" "skip" "continue" "proceed"
+    "next" "again" "redo" "undo" "retry"
+    "explain" "elaborate" "clarify" "summarize" "describe" "show" "tell"
+    "suggest" "recommend" "consider" "imagine" "suppose"
+    # question words
+    "why" "how" "what" "when" "where" "who" "which" "whom" "whose"
+    "can" "could" "would" "should" "will" "shall" "may" "might" "must"
+    "does" "did" "is" "are" "was" "were" "has" "have" "had"
+    # programming verbs used conversationally (not valid commands on common systems)
+    "refactor" "optimize" "scaffold" "debug" "deploy" "implement"
+    "migrate" "lint" "render" "integrate" "iterate"
+    "diagnose" "troubleshoot" "hotfix" "rollback" "revert"
+)
+
+# Natural language markers — common English words unusual as shell arguments.
+# Used by has_nl_markers (reroute candidates) and Layer 2 detection.
+# Kept in sync with lash plugin/shell-mode/natural-language.ts.
+LACY_NL_MARKERS=(
+    # articles/determiners
+    "a" "an" "the" "this" "that" "these" "those" "my" "our" "your" "its" "their" "his" "her"
+    # pronouns
+    "i" "we" "you" "it" "they" "me" "us" "him" "her" "them"
+    "myself" "yourself" "itself" "ourselves" "themselves"
+    # prepositions
+    "to" "of" "about" "with" "from" "for" "into" "through" "between" "after" "before"
+    "during" "without" "within" "against" "above" "below" "under" "upon" "across"
+    "toward" "towards" "beside" "besides" "beyond" "except" "inside" "outside"
+    "behind" "near" "among" "along" "around"
+    # conjunctions
+    "and" "but" "or" "so" "because" "since" "although" "though" "unless" "while"
+    "whereas" "whether" "however" "therefore" "moreover" "furthermore"
+    "nevertheless" "otherwise" "instead"
+    # verbs
+    "is" "are" "was" "were" "be" "been" "being" "have" "has" "had" "having"
+    "can" "could" "would" "should" "will" "shall" "may" "might" "must" "need" "want"
+    "know" "think" "believe" "understand" "remember" "forget" "seem" "appear"
+    "look" "feel" "sound" "mean" "try" "keep" "let" "begin" "start" "stop"
+    "continue" "happen" "work" "run" "give" "take" "bring" "send" "put" "get"
+    "got" "went" "going" "done" "doing" "made" "making"
+    # adverbs
+    "not" "already" "also" "just" "still" "even" "really" "actually" "probably" "maybe"
+    "perhaps" "always" "never" "sometimes" "often" "usually" "only" "very" "too"
+    "enough" "quite" "rather" "pretty" "almost" "nearly" "completely" "entirely"
+    "definitely" "certainly" "obviously" "clearly" "honestly" "basically" "literally"
+    "seriously" "hopefully" "unfortunately" "apparently" "absolutely" "simply" "merely"
+    "exactly" "roughly"
+    # question words
+    "how" "what" "when" "where" "why" "who" "which" "whom" "whose"
+    # other common sentence words
+    "if" "there" "here" "all" "any" "some" "every" "no" "each"
+    "does" "do" "did" "sure" "out" "up" "down" "ahead" "back" "over" "away" "off"
+    "on" "now" "then" "again" "once" "twice" "first" "last" "next"
+    "new" "old" "same" "other" "another" "both" "either" "neither"
+    "much" "many" "more" "most" "less" "least" "few" "several" "own" "such" "whole" "entire"
+    # conversational/reactions
+    "please" "thanks" "thank" "sorry" "yes" "yeah" "yep" "ok" "okay" "alright"
+    "right" "correct" "wrong" "perfect" "great" "good" "nice" "cool" "awesome"
+    "amazing" "wonderful" "excellent" "fantastic" "brilliant" "fine"
+    "terrible" "horrible" "awful" "bad" "worse" "worst" "better" "best"
+    # indefinite pronouns
+    "anyone" "someone" "everyone" "anything" "something" "everything"
+    "nobody" "nothing" "nowhere" "wherever" "whatever" "whoever" "whenever" "however"
+    # common nouns used in conversation
+    "way" "thing" "things" "stuff" "part" "place" "point" "fact"
+    "issue" "problem" "question" "answer" "idea" "reason" "example"
+    "change" "error" "bug" "fix" "feature" "code" "file" "files" "repo" "project" "app" "test" "tests"
+)
+
+# Error patterns that suggest the shell tried to interpret natural language.
+# Case-insensitive matching. Used by Layer 2 detection.
+# Kept in sync with lash plugin/shell-mode/natural-language.ts.
+LACY_SHELL_ERROR_PATTERNS=(
+    "parse error"
+    "syntax error"
+    "unexpected token"
+    "unexpected end of file"
+    "command not found"
+    "no such file or directory"
+    "invalid option"
+    "unrecognized option"
+    "illegal option"
+    "unknown option"
+    "no rule to make target"
+    "unknown primary or operator"
+    "missing argument to"
+    "invalid regular expression"
+    "is not a git command"
+    "unknown command"
+    "no such command"
+)
+
+LACY_SHELL_OPERATORS=('|' '&&' '||' ';' '>')
+
+# === Interrupt State (shared by ZSH + Bash keybindings) ===
+LACY_SHELL_LAST_INTERRUPT_TIME=0
+LACY_SHELL_QUITTING=false
+LACY_SHELL_INPUT_TYPE=""
+
+# === UI ===
+LACY_INDICATOR_CHAR="▌"
+LACY_SPINNER_FRAMES='⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏'
+: "${LACY_SPINNER_STYLE:="random"}"
+LACY_SPINNER_TEXT='Thinking'
+
+# === Tool List (canonical order for detection and display) ===
+LACY_TOOL_LIST=(lash claude opencode gemini codex hermes copilot goose amp aider)
+
+# === URLs ===
+LACY_DOCS_URL="https://lacy.sh/docs"
+
+# === User-Facing Messages ===
+LACY_MSG_QUIT="Exiting Lacy Shell..."
+LACY_MSG_CTRL_C_HINT="Press Ctrl-C again to quit"
+LACY_MSG_NO_TOOL="  No AI tool found. Install one to get started:"
+LACY_MSG_INSTALL_HINT="    npm install -g lashcode   (lash — recommended)"
+LACY_MSG_INSTALL_HINT2="    brew install claude       (Claude Code CLI)"
+LACY_MSG_INSTALL_HINT3="    brew install opencode     (OpenCode CLI)"
+LACY_MSG_INSTALL_HINT4="    npm install -g @openai/codex"
+LACY_MSG_CONFIGURE_HINT="  Run \`lacy setup\` to configure after installing."
+LACY_MSG_RECOVERY_TOOL="  Try: tool set <name>    Switch to a different tool"
+LACY_MSG_RECOVERY_ASK='       ask "your query"   Send directly to agent'
+LACY_MSG_RECOVERY_DOCTOR="       lacy doctor        Diagnose issues"
+LACY_MSG_CONVERSATION_CLEARED="Conversation history cleared"
+LACY_MSG_NO_CONVERSATION="No conversation history found"
+
+# Mode descriptions
+LACY_MSG_MODE_SHELL="SHELL mode - all commands execute directly"
+LACY_MSG_MODE_AGENT="AGENT mode - all input goes to AI"
+LACY_MSG_MODE_AUTO="AUTO mode - smart detection"
+LACY_MSG_MODE_SHELL_SHORT="SHELL mode"
+LACY_MSG_MODE_AGENT_SHORT="AGENT mode"
+LACY_MSG_MODE_AUTO_SHORT="AUTO mode"
+LACY_MSG_COLOR_SHELL="Green  = shell command"
+LACY_MSG_COLOR_AGENT="Magenta = agent query"
+
+# === Gemini ===
+LACY_GEMINI_CONTEXT="[Context: headless mode (-p). Available tools: grep_search, cli_help, read_file. Shell execution (run_shell_command) is NOT available — answer from context instead. cwd: {cwd}]"
+
+# === API URLs ===
+LACY_API_URL_OPENAI="https://api.openai.com/v1/chat/completions"
+LACY_API_URL_ANTHROPIC="https://api.anthropic.com/v1/messages"
+
+# === timing (seconds) ===
+LACY_HEALTH_CHECK_TIMEOUT_SYNC=0.3
+LACY_HEALTH_CHECK_TIMEOUT_ASYNC=0.5
+
+LACY_SPINNER_FRAME_DELAY=0.05
+LACY_TERMINAL_FLUSH_DELAY=0.02
+LACY_HEALTH_CHECK_ATTEMPTS=30
+LACY_HEALTH_CHECK_INTERVAL=0.1
+LACY_SESSION_CREATE_TIMEOUT=10
+LACY_SESSION_MESSAGE_TIMEOUT=120
+
+# === Thresholds ===
+LACY_SIGNAL_EXIT_THRESHOLD=128  # Exit codes >= this are signal-based
+
+# === API Models (fallback only) ===
+LACY_API_MODEL_OPENAI="gpt-4o-mini"
+LACY_API_MODEL_ANTHROPIC="claude-3-5-sonnet-20241022"
+
+# === Dangerous Commands ===
+LACY_DANGEROUS_PATTERNS=("rm -rf" "sudo rm" "mkfs" "dd if=" ">" "truncate")
+
+# === Performance Optimization: Caching ===
+LACY_CONFIG_CACHE_VALID=false
+declare -A LACY_CACHED_CONFIG 2>/dev/null || true
+: "${LACY_SHELL_CONFIG_CACHE_FILE:="${LACY_SHELL_HOME}/.config_cache"}"
+
+# Async health check cache
+LACY_PREHEAT_HEALTH_CACHE=false
+LACY_PREHEAT_HEALTH_CHECK_PID=""
+: "${LACY_SHELL_HEALTH_CACHE_FILE:="${LACY_SHELL_HOME}/.health_cache"}"
+
+# === Portable Helpers ===
+
+# Print colored text — dispatches to shell-appropriate method
+# Usage: lacy_print_color <color_code> <text>
+lacy_print_color() {
+    local color="$1"
+    shift
+    if [[ "$LACY_SHELL_TYPE" == "zsh" ]]; then
+        print -P "%F{${color}}$*%f"
+    else
+        printf '\e[38;5;%dm%s\e[0m\n' "$color" "$*"
+    fi
+}
+
+# Print colored text without trailing newline
+# Usage: lacy_print_color_n <color_code> <text>
+lacy_print_color_n() {
+    local color="$1"
+    shift
+    if [[ "$LACY_SHELL_TYPE" == "zsh" ]]; then
+        print -Pn "%F{${color}}$*%f"
+    else
+        printf '\e[38;5;%dm%s\e[0m' "$color" "$*"
+    fi
+}
+
+# Check if a value is in a list (portable array membership)
+# Usage: _lacy_in_list "value" "item1" "item2" ...
+_lacy_in_list() {
+    local needle="$1"
+    shift
+    local item
+    for item in "$@"; do
+        [[ "$item" == "$needle" ]] && return 0
+    done
+    return 1
+}
+
+# Portable lowercase — works in Bash 4+, ZSH, and falls back to tr
+# Usage: result=$(_lacy_lowercase "STRING")
+_lacy_lowercase() {
+    if [[ "$LACY_SHELL_TYPE" == "zsh" ]]; then
+        echo "${1:l}"
+    elif (( BASH_VERSINFO[0] >= 4 )) 2>/dev/null; then
+        echo "${1,,}"
+    else
+        # Bash 3 fallback (macOS default) — only used in test/core contexts
+        echo "$1" | tr '[:upper:]' '[:lower:]'
+    fi
+}
+
+# Portable pipe status — get exit code of first command in pipeline
+# Must be called immediately after a pipeline
+# Usage: local exit_code=$(_lacy_pipe_status)
+_lacy_pipe_status() {
+    if [[ "$LACY_SHELL_TYPE" == "zsh" ]]; then
+        echo "${pipestatus[1]}"
+    else
+        echo "${PIPESTATUS[0]}"
+    fi
+}
+
+# Portable job control off/on
+_lacy_jobctl_off() {
+    if [[ "$LACY_SHELL_TYPE" == "zsh" ]]; then
+        [[ -o monitor ]] && LACY_JOBCTL_WAS_SET=1 || LACY_JOBCTL_WAS_SET=""
+        setopt NO_MONITOR 2>/dev/null
+    else
+        LACY_JOBCTL_WAS_SET=""
+        case "$-" in *m*) LACY_JOBCTL_WAS_SET=1 ;; esac
+        set +m 2>/dev/null
+    fi
+}
+
+_lacy_jobctl_on() {
+    if [[ -n "$LACY_JOBCTL_WAS_SET" ]]; then
+        if [[ "$LACY_SHELL_TYPE" == "zsh" ]]; then
+            setopt MONITOR 2>/dev/null
+        else
+            set -m 2>/dev/null
+        fi
+        LACY_JOBCTL_WAS_SET=""
+    fi
+}
+
+# Escape a string for safe JSON embedding — handles \, ", and control chars.
+# Usage: escaped=$(_lacy_json_escape_str "$value")
+_lacy_json_escape_str() {
+    local s="$1"
+    s="${s//\\/\\\\}"   # \ → \\
+    s="${s//\"/\\\"}"   # " → \"
+    s="${s//$'\n'/\\n}" # newline → \n
+    s="${s//$'\r'/\\r}" # carriage return → \r
+    s="${s//$'\t'/\\t}" # tab → \t
+    printf '%s' "$s"
+}

package/lib/core/context.sh

@@ -0,0 +1,260 @@
+#!/usr/bin/env bash
+
+# Terminal context for agent queries — delta-based, token-efficient
+# Only sends what changed since the last agent query.
+# Shared across Bash 4+ and ZSH.
+
+# === State: Delta Tracking ===
+_LACY_CTX_LAST_CWD=""
+_LACY_CTX_LAST_GIT=""
+_LACY_CTX_CMDS_SINCE_QUERY=0
+_LACY_CTX_LAST_EXIT_CODE=0
+_LACY_CTX_REAL_CMD=false
+
+# Command ring buffer — explicit array avoids agent queries leaking from fc/history
+_LACY_CTX_CMD_BUFFER=()
+_LACY_CTX_CMD_BUFFER_MAX=10
+
+# === State: Terminal Output Capture ===
+_LACY_CTX_TERMINAL_CAPTURE_CMD=""   # Detected at load time; empty = unsupported
+_LACY_CTX_OUTPUT_ENABLED=true       # Toggled via config (context.output)
+_LACY_CTX_OUTPUT_MAX_LINES=50       # Configurable cap (context.output_lines)
+
+# ============================================================================
+# Terminal Detection (called once at source time)
+# ============================================================================
+
+# Detect terminal/multiplexer API for screen capture.
+# Sets _LACY_CTX_TERMINAL_CAPTURE_CMD to a command string (or function name),
+# or empty if unsupported. Checked once at source time.
+#
+# Priority: tmux > screen > iTerm2 > Terminal.app
+# Multiplexers are checked first because terminal emulator APIs return wrong
+# content when running inside a multiplexer.
+_lacy_ctx_detect_terminal() {
+    _LACY_CTX_TERMINAL_CAPTURE_CMD=""
+
+    # 1. tmux: native pane capture (takes priority over terminal APIs)
+    if [[ -n "${TMUX:-}" ]]; then
+        if command -v tmux >/dev/null 2>&1; then
+            _LACY_CTX_TERMINAL_CAPTURE_CMD="tmux capture-pane -p"
+            return
+        fi
+    fi
+
+    # 2. screen: hardcopy to temp file
+    if [[ -n "${STY:-}" ]]; then
+        if command -v screen >/dev/null 2>&1; then
+            _LACY_CTX_TERMINAL_CAPTURE_CMD="_lacy_ctx_screen_capture"
+            return
+        fi
+    fi
+
+    # 3-4. macOS: AppleScript for iTerm2 and Terminal.app
+    if [[ "$(uname -s 2>/dev/null)" == "Darwin" ]]; then
+        if [[ "${TERM_PROGRAM:-}" == "iTerm.app" ]]; then
+            _LACY_CTX_TERMINAL_CAPTURE_CMD="_lacy_ctx_iterm2_capture"
+            return
+        fi
+        if [[ "${TERM_PROGRAM:-}" == "Apple_Terminal" ]]; then
+            _LACY_CTX_TERMINAL_CAPTURE_CMD="_lacy_ctx_terminal_app_capture"
+            return
+        fi
+    fi
+}
+
+# ============================================================================
+# Capture Helpers (multi-step captures that can't be a single command)
+# ============================================================================
+
+# screen: hardcopy writes to a file, not stdout
+_lacy_ctx_screen_capture() {
+    local tmpfile
+    tmpfile=$(mktemp) || return
+    screen -X hardcopy "$tmpfile" 2>/dev/null || { rm -f "$tmpfile"; return; }
+    cat "$tmpfile" 2>/dev/null
+    rm -f "$tmpfile" 2>/dev/null
+}
+
+# iTerm2: AppleScript to get current session contents
+_lacy_ctx_iterm2_capture() {
+    osascript -e 'tell application "iTerm2" to tell current session of current window to get contents' 2>/dev/null
+}
+
+# Terminal.app: AppleScript to get current tab contents
+_lacy_ctx_terminal_app_capture() {
+    osascript -e 'tell application "Terminal" to get contents of selected tab of front window' 2>/dev/null
+}
+
+# ============================================================================
+# Screen Capture (called lazily at query time)
+# ============================================================================
+
+# Capture visible terminal screen text, stripped of ANSI escapes.
+# Returns captured text on stdout, or empty if unavailable/disabled.
+_lacy_ctx_capture_screen() {
+    [[ "$_LACY_CTX_OUTPUT_ENABLED" != true ]] && return
+    [[ -z "$_LACY_CTX_TERMINAL_CAPTURE_CMD" ]] && return
+
+    local raw_output
+    raw_output=$(eval "$_LACY_CTX_TERMINAL_CAPTURE_CMD" 2>/dev/null) || return
+
+    # Strip ANSI escape sequences (SGR, cursor movement, etc.)
+    local cleaned
+    cleaned=$(printf '%s\n' "$raw_output" | sed $'s/\x1b\[[0-9;]*[a-zA-Z]//g')
+
+    # Remove trailing blank lines
+    while [[ "$cleaned" == *$'\n' ]]; do
+        cleaned="${cleaned%$'\n'}"
+    done
+
+    [[ -z "$cleaned" ]] && return
+
+    # Truncate from the top, keeping the last N lines (errors are at the bottom)
+    local max_lines="${_LACY_CTX_OUTPUT_MAX_LINES:-50}"
+    if (( max_lines > 0 )); then
+        local line_count
+        line_count=$(printf '%s\n' "$cleaned" | wc -l)
+        if (( line_count > max_lines )); then
+            cleaned=$(printf '%s\n' "$cleaned" | tail -n "$max_lines")
+        fi
+    fi
+
+    printf '%s' "$cleaned"
+}
+
+# ============================================================================
+# Hooks (called from accept-line and precmd)
+# ============================================================================
+
+# Called from accept-line when routing input to the shell.
+# Records the command text for inclusion in the next agent query context.
+# Usage: _lacy_ctx_mark_command "$BUFFER"   (ZSH)
+#        _lacy_ctx_mark_command "$READLINE_LINE"  (Bash)
+_lacy_ctx_mark_command() {
+    local cmd="$1"
+    _LACY_CTX_REAL_CMD=true
+
+    # Append to ring buffer, trim to max size
+    _LACY_CTX_CMD_BUFFER+=("$cmd")
+    if (( ${#_LACY_CTX_CMD_BUFFER[@]} > _LACY_CTX_CMD_BUFFER_MAX )); then
+        _LACY_CTX_CMD_BUFFER=("${_LACY_CTX_CMD_BUFFER[@]: -$_LACY_CTX_CMD_BUFFER_MAX}")
+    fi
+}
+
+# Called from precmd hooks. Captures exit code for real shell commands only.
+# Usage: _lacy_ctx_on_precmd $last_exit
+_lacy_ctx_on_precmd() {
+    local exit_code="$1"
+    if [[ "$_LACY_CTX_REAL_CMD" == true ]]; then
+        _LACY_CTX_LAST_EXIT_CODE=$exit_code
+        (( _LACY_CTX_CMDS_SINCE_QUERY++ ))
+        _LACY_CTX_REAL_CMD=false
+    fi
+}
+
+# ============================================================================
+# Context Builder (called at query time)
+# ============================================================================
+
+# Build delta-based context and prepend to query.
+# Sets _LACY_CTX_RESULT to the enriched query (avoids subshell so state resets
+# propagate to the parent). If nothing changed, result is the bare query.
+# Format: [cwd: /path] [git: branch] [exit: 1] [recent: cmd1 | cmd2] query
+# With output: ...context header...\n[terminal-output]\n...\n[/terminal-output]\nquery
+# Usage: _lacy_build_query_context "$query"; query="$_LACY_CTX_RESULT"
+_LACY_CTX_RESULT=""
+
+_lacy_build_query_context() {
+    local query="$1"
+    local ctx=""
+
+    # --- CWD (only if changed) ---
+    local cwd="${PWD}"
+    if [[ "$cwd" != "$_LACY_CTX_LAST_CWD" ]]; then
+        ctx+="[cwd: ${cwd}] "
+        _LACY_CTX_LAST_CWD="$cwd"
+    fi
+
+    # --- Git branch (only if changed) ---
+    local git_branch=""
+    if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+        git_branch=$(git rev-parse --abbrev-ref HEAD 2>/dev/null)
+        # Detached HEAD returns literal "HEAD" — fall back to short hash
+        if [[ "$git_branch" == "HEAD" ]]; then
+            git_branch=$(git rev-parse --short HEAD 2>/dev/null)
+        fi
+    fi
+    if [[ "$git_branch" != "$_LACY_CTX_LAST_GIT" ]]; then
+        if [[ -n "$git_branch" ]]; then
+            ctx+="[git: ${git_branch}] "
+        fi
+        _LACY_CTX_LAST_GIT="$git_branch"
+    fi
+
+    # --- Last exit code (only if non-zero AND a command ran since last query) ---
+    if (( _LACY_CTX_CMDS_SINCE_QUERY > 0 && _LACY_CTX_LAST_EXIT_CODE != 0 )); then
+        ctx+="[exit: ${_LACY_CTX_LAST_EXIT_CODE}] "
+    fi
+
+    # --- Recent commands since last query ---
+    if (( _LACY_CTX_CMDS_SINCE_QUERY > 0 )) && [[ ${#_LACY_CTX_CMD_BUFFER[@]} -gt 0 ]]; then
+        local cmds=""
+        local cmd
+        for cmd in "${_LACY_CTX_CMD_BUFFER[@]}"; do
+            # Truncate long commands to keep context compact
+            if (( ${#cmd} > 80 )); then
+                cmd="${cmd:0:77}..."
+            fi
+            if [[ -n "$cmds" ]]; then
+                cmds+=" | $cmd"
+            else
+                cmds="$cmd"
+            fi
+        done
+        ctx+="[recent: ${cmds}] "
+    fi
+
+    # --- Terminal screen output (lazy capture, only if commands ran) ---
+    local screen_output=""
+    if (( _LACY_CTX_CMDS_SINCE_QUERY > 0 )); then
+        screen_output=$(_lacy_ctx_capture_screen)
+    fi
+
+    # --- Reset counters ---
+    _LACY_CTX_CMDS_SINCE_QUERY=0
+    _LACY_CTX_LAST_EXIT_CODE=0
+    _LACY_CTX_CMD_BUFFER=()
+
+    # --- Set result ---
+    if [[ -n "$screen_output" ]]; then
+        _LACY_CTX_RESULT="${ctx}
+[terminal-output]
+${screen_output}
+[/terminal-output]
+${query}"
+    else
+        _LACY_CTX_RESULT="${ctx}${query}"
+    fi
+}
+
+# ============================================================================
+# Reset (called on /new session)
+# ============================================================================
+
+# Clear all context state so the next query sends full context.
+# Does NOT reset terminal detection or config — those are session-lifetime.
+_lacy_ctx_reset() {
+    _LACY_CTX_LAST_CWD=""
+    _LACY_CTX_LAST_GIT=""
+    _LACY_CTX_CMDS_SINCE_QUERY=0
+    _LACY_CTX_LAST_EXIT_CODE=0
+    _LACY_CTX_REAL_CMD=false
+    _LACY_CTX_CMD_BUFFER=()
+}
+
+# ============================================================================
+# Init (runs once when sourced)
+# ============================================================================
+
+_lacy_ctx_detect_terminal