fpf-cli 1.6.15 → 1.6.16

package/fpf

@@ -3,16 +3,24 @@
 set -euo pipefail
 
 SCRIPT_NAME="fpf"
-SCRIPT_VERSION="1.6.15"
+SCRIPT_VERSION="1.6.16"
 TMP_ROOT="${TMPDIR:-/tmp}/fpf"
 SESSION_TMP_ROOT=""
 HELP_FILE=""
 KBINDS_FILE=""
+CACHE_FORMAT_VERSION="1"
+CACHE_ROOT=""
 
 ACTION="search"
 MANAGER_OVERRIDE=""
+IPC_MANAGER_OVERRIDE=""
+IPC_FALLBACK_FILE=""
 declare -a QUERY_PARTS=()
 
+query_cache_flags() {
+    printf "%s" "query_limit=${FPF_QUERY_RESULT_LIMIT:-0};per_manager_limit=${FPF_QUERY_PER_MANAGER_LIMIT:-40};no_query_limit=${FPF_NO_QUERY_RESULT_LIMIT:-120};no_query_npm_limit=${FPF_NO_QUERY_NPM_LIMIT:-120}"
+}
+
 log() {
     printf "%s\n" "$*" >&2
 }
@@ -30,16 +38,672 @@ ensure_tmp_root() {
     mkdir -p "${TMP_ROOT}"
 }
 
+resolve_cache_root() {
+    local os
+    os="$(uname -s)"
+
+    if [[ -n "${FPF_CACHE_DIR:-}" ]]; then
+        printf "%s" "${FPF_CACHE_DIR}"
+        return
+    fi
+
+    case "${os}" in
+        Darwin)
+            printf "%s" "${HOME}/Library/Caches/fpf"
+            ;;
+        Linux)
+            if [[ -n "${XDG_CACHE_HOME:-}" ]]; then
+                printf "%s" "${XDG_CACHE_HOME}/fpf"
+            else
+                printf "%s" "${HOME}/.cache/fpf"
+            fi
+            ;;
+        MINGW*|MSYS*|CYGWIN*|Windows_NT)
+            if [[ -n "${LOCALAPPDATA:-}" ]]; then
+                printf "%s" "${LOCALAPPDATA}/fpf"
+            elif [[ -n "${APPDATA:-}" ]]; then
+                printf "%s" "${APPDATA}/fpf"
+            else
+                printf "%s" "${HOME}/.cache/fpf"
+            fi
+            ;;
+        *)
+            printf "%s" "${HOME}/.cache/fpf"
+            ;;
+    esac
+}
+
+initialize_cache_root() {
+    if [[ -n "${CACHE_ROOT}" ]]; then
+        return
+    fi
+
+    CACHE_ROOT="$(resolve_cache_root)"
+    mkdir -p "${CACHE_ROOT}"
+}
+
+normalize_cache_query() {
+    printf "%s" "$1" |
+        awk '{
+            line=$0
+            gsub(/^[[:space:]]+|[[:space:]]+$/, "", line)
+            gsub(/[[:space:]]+/, " ", line)
+            print tolower(line)
+        }'
+}
+
+platform_cache_token() {
+    uname -s | tr '[:upper:]' '[:lower:]'
+}
+
+cache_fingerprint() {
+    local manager="$1"
+    local query="$2"
+    local flags="$3"
+    local normalized_query
+
+    normalized_query="$(normalize_cache_query "${query}")"
+    printf "%s|%s|%s|%s|%s" "${CACHE_FORMAT_VERSION}" "${manager}" "$(platform_cache_token)" "${normalized_query}" "${flags}"
+}
+
+cache_cksum() {
+    local input="$1"
+    printf "%s" "${input}" | cksum | awk '{ print $1 }'
+}
+
+cache_catalog_key() {
+    local manager="$1"
+    printf "catalog/%s.tsv" "${manager}"
+}
+
+cache_search_catalog_fingerprint() {
+    local manager="$1"
+    local command_path=""
+    local extra_token=""
+
+    case "${manager}" in
+        apt)
+            command_path="$(command -v apt-cache 2>/dev/null || printf "missing")"
+            if [[ "${FPF_TEST_FIXTURES:-0}" == "1" ]]; then
+                extra_token="|fixtures=${FPF_TEST_FIXTURE_DIR:-enabled}"
+            fi
+            ;;
+        brew)
+            command_path="$(command -v brew 2>/dev/null || printf "missing")"
+            if [[ "${FPF_TEST_FIXTURES:-0}" == "1" ]]; then
+                extra_token="|fixtures=${FPF_TEST_FIXTURE_DIR:-enabled}"
+            fi
+            ;;
+        *)
+            command_path="n/a"
+            ;;
+    esac
+
+    printf "%s|cmd=%s%s" "$(cache_fingerprint "${manager}" "" "search-catalog")" "${command_path}" "${extra_token}"
+}
+
+cache_search_catalog_key() {
+    local manager="$1"
+    local fingerprint="$2"
+    local checksum
+
+    checksum="$(cache_cksum "${fingerprint}")"
+    printf "search-catalog/%s/%s.tsv" "${manager}" "${checksum}"
+}
+
+cache_query_key() {
+    local manager="$1"
+    local query="$2"
+    local flags="$3"
+    local fingerprint
+    local checksum
+
+    fingerprint="$(cache_fingerprint "${manager}" "${query}" "${flags}")"
+    checksum="$(cache_cksum "${fingerprint}")"
+    printf "query/%s/%s.tsv" "${manager}" "${checksum}"
+}
+
+cache_meta_key() {
+    local key="$1"
+    printf "meta/%s.meta" "${key}"
+}
+
+cache_path_for_key() {
+    local key="$1"
+    printf "%s/%s" "${CACHE_ROOT}" "${key}"
+}
+
+cache_atomic_write_from_file() {
+    local source_file="$1"
+    local destination_file="$2"
+    local destination_dir
+    local destination_base
+    local temp_file
+
+    destination_dir="$(dirname "${destination_file}")"
+    destination_base="$(basename "${destination_file}")"
+
+    mkdir -p "${destination_dir}"
+    temp_file="$(mktemp "${destination_dir}/.${destination_base}.tmp.XXXXXX")"
+    cp "${source_file}" "${temp_file}"
+    mv "${temp_file}" "${destination_file}"
+}
+
+cache_write_meta() {
+    local key="$1"
+    local fingerprint="$2"
+    local item_count="$3"
+    local refresh_status="${4:-}"
+    local generation="${5:-}"
+    local last_error_at="${6:-}"
+    local last_error="${7:-}"
+    local created_at
+    local created_epoch
+    local meta_key
+    local meta_file
+    local temp_meta
+
+    created_at="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+    created_epoch="$(date +%s)"
+    meta_key="$(cache_meta_key "${key}")"
+    meta_file="$(cache_path_for_key "${meta_key}")"
+    temp_meta="$(mktemp "${SESSION_TMP_ROOT}/meta.XXXXXX")"
+
+    {
+        printf "format_version=%s\n" "${CACHE_FORMAT_VERSION}"
+        printf "created_at=%s\n" "${created_at}"
+        printf "created_epoch=%s\n" "${created_epoch}"
+        printf "fingerprint=%s\n" "${fingerprint}"
+        printf "item_count=%s\n" "${item_count}"
+        if [[ -n "${refresh_status}" ]]; then
+            printf "refresh_status=%s\n" "${refresh_status}"
+        fi
+        if [[ -n "${generation}" ]]; then
+            printf "generation=%s\n" "${generation}"
+        fi
+        if [[ -n "${last_error_at}" ]]; then
+            printf "last_error_at=%s\n" "${last_error_at}"
+        fi
+        if [[ -n "${last_error}" ]]; then
+            printf "last_error=%s\n" "${last_error}"
+        fi
+    } >"${temp_meta}"
+
+    cache_atomic_write_from_file "${temp_meta}" "${meta_file}"
+    rm -f "${temp_meta}"
+}
+
+cache_store_key_from_file() {
+    local key="$1"
+    local fingerprint="$2"
+    local source_file="$3"
+    local refresh_status="${4:-}"
+    local generation="${5:-}"
+    local last_error_at="${6:-}"
+    local last_error="${7:-}"
+    local cache_file
+    local item_count
+
+    cache_file="$(cache_path_for_key "${key}")"
+    item_count="$(awk 'END { print NR + 0 }' "${source_file}")"
+
+    cache_atomic_write_from_file "${source_file}" "${cache_file}"
+    cache_write_meta "${key}" "${fingerprint}" "${item_count}" "${refresh_status}" "${generation}" "${last_error_at}" "${last_error}"
+}
+
+cache_meta_value_for_key() {
+    local key="$1"
+    local field_name="$2"
+    local meta_file
+
+    meta_file="$(cache_path_for_key "$(cache_meta_key "${key}")")"
+    if [[ ! -r "${meta_file}" ]]; then
+        return 1
+    fi
+
+    awk -F'=' -v key="${field_name}" '$1 == key { value=substr($0, index($0, "=") + 1); print value; exit }' "${meta_file}"
+}
+
+cache_is_fresh_with_ttl() {
+    local key="$1"
+    local ttl_seconds="$2"
+    local created_epoch
+    local now_epoch
+    local age_seconds
+
+    if ! [[ "${ttl_seconds}" =~ ^[0-9]+$ ]]; then
+        return 1
+    fi
+
+    if [[ "${ttl_seconds}" -eq 0 ]]; then
+        return 1
+    fi
+
+    created_epoch="$(cache_meta_value_for_key "${key}" "created_epoch" 2>/dev/null || true)"
+    if ! [[ "${created_epoch}" =~ ^[0-9]+$ ]]; then
+        return 1
+    fi
+
+    now_epoch="$(date +%s)"
+    if ! [[ "${now_epoch}" =~ ^[0-9]+$ ]]; then
+        return 1
+    fi
+
+    age_seconds=$((now_epoch - created_epoch))
+    if [[ "${age_seconds}" -lt 0 ]]; then
+        return 1
+    fi
+
+    [[ "${age_seconds}" -lt "${ttl_seconds}" ]]
+}
+
+cache_emit_query_rows_if_valid() {
+    local cache_file="$1"
+
+    [[ -s "${cache_file}" ]] || return 1
+
+    if ! awk -F'\t' 'NF >= 2 && $1 != "" { next } { exit 1 } END { if (NR == 0) exit 1 }' "${cache_file}" >/dev/null 2>&1; then
+        return 1
+    fi
+
+    awk -F'\t' 'NF >= 2 && $1 != "" { desc=$2; if (desc == "") desc="-"; print $1 "\t" desc }' "${cache_file}"
+}
+
+bun_generation_state_key() {
+    local key="$1"
+    printf "state/%s.generation" "${key}"
+}
+
+bun_generation_read() {
+    local key="$1"
+    local state_file
+    local current="0"
+
+    state_file="$(cache_path_for_key "$(bun_generation_state_key "${key}")")"
+    if [[ -r "${state_file}" ]]; then
+        current="$(awk 'NR == 1 { print $1; exit }' "${state_file}")"
+    fi
+
+    if ! [[ "${current}" =~ ^[0-9]+$ ]]; then
+        current="0"
+    fi
+
+    printf "%s" "${current}"
+}
+
+bun_generation_write() {
+    local key="$1"
+    local generation="$2"
+    local state_key
+    local state_file
+    local temp_file
+
+    state_key="$(bun_generation_state_key "${key}")"
+    state_file="$(cache_path_for_key "${state_key}")"
+    temp_file="$(mktemp "${SESSION_TMP_ROOT}/bun-generation.XXXXXX")"
+    printf "%s\n" "${generation}" >"${temp_file}"
+    cache_atomic_write_from_file "${temp_file}" "${state_file}"
+    rm -f "${temp_file}"
+}
+
+bun_generation_next() {
+    local key="$1"
+    local current
+    local next
+
+    current="$(bun_generation_read "${key}")"
+    next=$((current + 1))
+    bun_generation_write "${key}" "${next}"
+    printf "%s" "${next}"
+}
+
+bun_refresh_idle_seconds() {
+    local idle_seconds="${FPF_BUN_REFRESH_IDLE:-0.12}"
+    if ! [[ "${idle_seconds}" =~ ^[0-9]+(\.[0-9]+)?$ ]]; then
+        idle_seconds="0.12"
+    fi
+    printf "%s" "${idle_seconds}"
+}
+
+bun_emit_refresh_failure_meta() {
+    local key="$1"
+    local fingerprint="$2"
+    local generation="$3"
+    local last_error="$4"
+    local cache_file
+    local item_count="0"
+    local last_error_at
+
+    cache_file="$(cache_path_for_key "${key}")"
+    if [[ -s "${cache_file}" ]]; then
+        item_count="$(awk 'END { print NR + 0 }' "${cache_file}")"
+    fi
+
+    last_error_at="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+    cache_write_meta "${key}" "${fingerprint}" "${item_count}" "error" "${generation}" "${last_error_at}" "${last_error}"
+}
+
+bun_try_hot_reload_after_refresh() {
+    local query="$1"
+
+    if [[ -n "${FPF_BUN_REFRESH_MANAGER_OVERRIDE:-}" || -n "${FPF_BUN_REFRESH_FALLBACK_FILE:-}" ]]; then
+        FPF_BUN_SKIP_REFRESH_SCHEDULE=1 \
+            FPF_IPC_MANAGER_OVERRIDE="${FPF_BUN_REFRESH_MANAGER_OVERRIDE:-}" \
+            FPF_IPC_FALLBACK_FILE="${FPF_BUN_REFRESH_FALLBACK_FILE:-}" \
+            run_ipc_reload_action "${query}" || true
+    fi
+
+    if [[ -n "${FPF_TEST_CACHE_REFRESH_SIGNAL_FILE:-}" ]] && command_exists fpf-refresh-signal; then
+        fpf-refresh-signal >/dev/null 2>&1 || true
+    fi
+}
+
+bun_run_refresh_worker() {
+    local manager="$1"
+    local query="$2"
+    local flags="$3"
+    local key="$4"
+    local fingerprint="$5"
+    local generation="$6"
+    local output_tmp
+
+    sleep "$(bun_refresh_idle_seconds)"
+
+    if [[ "${generation}" != "$(bun_generation_read "${key}")" ]]; then
+        return 0
+    fi
+
+    output_tmp="$(mktemp "${SESSION_TMP_ROOT}/bun-refresh.XXXXXX")"
+    if ! manager_bun_search_entries_strict "${query}" >"${output_tmp}"; then
+        rm -f "${output_tmp}"
+        bun_emit_refresh_failure_meta "${key}" "${fingerprint}" "${generation}" "bun_search_failed"
+        send_fzf_prompt_action "Search> " || true
+        return 1
+    fi
+
+    if [[ "${generation}" != "$(bun_generation_read "${key}")" ]]; then
+        rm -f "${output_tmp}"
+        return 0
+    fi
+
+    cache_store_key_from_file "${key}" "${fingerprint}" "${output_tmp}" "success" "${generation}"
+    rm -f "${output_tmp}"
+    bun_try_hot_reload_after_refresh "${query}"
+    return 0
+}
+
+start_bun_refresh_worker_async() {
+    local manager="$1"
+    local query="$2"
+    local flags="$3"
+    local key="$4"
+    local fingerprint="$5"
+    local generation="$6"
+    local fallback_file="$7"
+    local manager_override="$8"
+    local script_path="${BASH_SOURCE[0]}"
+
+    if [[ "${script_path}" != /* ]]; then
+        script_path="$(pwd)/${script_path}"
+    fi
+
+    FPF_BUN_REFRESH_FLAGS="${flags}" \
+        FPF_BUN_REFRESH_KEY="${key}" \
+        FPF_BUN_REFRESH_FINGERPRINT="${fingerprint}" \
+        FPF_BUN_REFRESH_GENERATION="${generation}" \
+        FPF_BUN_REFRESH_FALLBACK_FILE="${fallback_file}" \
+        FPF_BUN_REFRESH_MANAGER_OVERRIDE="${manager_override}" \
+        "${script_path}" --bun-refresh-worker --manager "${manager}" -- "${query}" >/dev/null 2>&1 &
+}
+
+build_apt_catalog_entries() {
+    apt-cache dumpavail 2>/dev/null |
+        awk '
+            function flush_entry() {
+                if (pkg == "") {
+                    return
+                }
+                desc_out = desc
+                gsub(/^[[:space:]]+|[[:space:]]+$/, "", desc_out)
+                if (desc_out == "") {
+                    desc_out = "-"
+                }
+                print pkg "\t" desc_out
+            }
+
+            /^Package:[[:space:]]*/ {
+                flush_entry()
+                pkg = $0
+                sub(/^Package:[[:space:]]*/, "", pkg)
+                desc = ""
+                next
+            }
+
+            /^Description:[[:space:]]*/ {
+                desc = $0
+                sub(/^Description:[[:space:]]*/, "", desc)
+                next
+            }
+
+            /^[[:space:]]+/ {
+                if (desc != "") {
+                    line = $0
+                    sub(/^[[:space:]]+/, "", line)
+                    if (line != "") {
+                        desc = desc " " line
+                    }
+                }
+                next
+            }
+
+            /^$/ {
+                flush_entry()
+                pkg = ""
+                desc = ""
+                next
+            }
+
+            END {
+                flush_entry()
+            }
+        ' |
+        awk -F'\t' 'NF >= 1 && $1 != "" { if ($2 == "") $2 = "-"; print $1 "\t" $2 }' |
+        awk -F'\t' '!seen[$1]++'
+}
+
+build_brew_catalog_entries() {
+    {
+        brew formulae 2>/dev/null || true
+        brew casks 2>/dev/null || true
+    } |
+        awk 'NF >= 1 && $1 != "" { print $1 "\t-" }' |
+        awk -F'\t' '!seen[$1]++'
+}
+
+ensure_search_catalog_cache() {
+    local manager="$1"
+    local cache_fingerprint_value
+    local cache_key
+    local cache_file
+    local output_tmp
+
+    initialize_cache_root
+
+    cache_fingerprint_value="$(cache_search_catalog_fingerprint "${manager}")"
+    cache_key="$(cache_search_catalog_key "${manager}" "${cache_fingerprint_value}")"
+    cache_file="$(cache_path_for_key "${cache_key}")"
+
+    if [[ -s "${cache_file}" ]]; then
+        return 0
+    fi
+
+    output_tmp="$(mktemp "${SESSION_TMP_ROOT}/search-catalog.XXXXXX")"
+
+    case "${manager}" in
+        apt)
+            build_apt_catalog_entries >"${output_tmp}" || true
+            ;;
+        brew)
+            build_brew_catalog_entries >"${output_tmp}" || true
+            ;;
+        *)
+            rm -f "${output_tmp}"
+            return 1
+            ;;
+    esac
+
+    if [[ -s "${output_tmp}" ]]; then
+        cache_store_key_from_file "${cache_key}" "${cache_fingerprint_value}" "${output_tmp}"
+        rm -f "${output_tmp}"
+        return 0
+    fi
+
+    rm -f "${output_tmp}"
+    return 1
+}
+
+search_entries_from_catalog_cache() {
+    local manager="$1"
+    local query="$2"
+    local cache_fingerprint_value
+    local cache_key
+    local cache_file
+
+    initialize_cache_root
+
+    cache_fingerprint_value="$(cache_search_catalog_fingerprint "${manager}")"
+    cache_key="$(cache_search_catalog_key "${manager}" "${cache_fingerprint_value}")"
+    cache_file="$(cache_path_for_key "${cache_key}")"
+
+    if [[ ! -s "${cache_file}" ]]; then
+        return 1
+    fi
+
+    awk -F'\t' -v query="${query}" '
+        BEGIN {
+            normalized = tolower(query)
+            token_count = split(normalized, raw_tokens, /[[:space:]]+/)
+            token_index = 0
+            for (i = 1; i <= token_count; i++) {
+                if (raw_tokens[i] != "") {
+                    token_index++
+                    tokens[token_index] = raw_tokens[i]
+                }
+            }
+        }
+        {
+            haystack = tolower($1 " " $2)
+            matched = 1
+            for (i = 1; i <= token_index; i++) {
+                if (index(haystack, tokens[i]) == 0) {
+                    matched = 0
+                    break
+                }
+            }
+            if (matched) {
+                desc = $2
+                if (desc == "") {
+                    desc = "-"
+                }
+                print $1 "\t" desc
+            }
+        }
+    ' "${cache_file}" || return 1
+}
+
 initialize_session_tmp_root() {
     if [[ -n "${SESSION_TMP_ROOT}" ]]; then
         return
     fi
 
-    SESSION_TMP_ROOT="$(mktemp -d "${TMP_ROOT}/session.XXXXXX")"
+    if [[ -n "${FPF_SESSION_TMP_ROOT:-}" ]]; then
+        SESSION_TMP_ROOT="${FPF_SESSION_TMP_ROOT}"
+        mkdir -p "${SESSION_TMP_ROOT}"
+    else
+        SESSION_TMP_ROOT="$(mktemp -d "${TMP_ROOT}/session.XXXXXX")"
+    fi
     HELP_FILE="${SESSION_TMP_ROOT}/help"
     KBINDS_FILE="${SESSION_TMP_ROOT}/keybinds"
 }
 
+run_preview_manager_output() {
+    local manager="$1"
+    local package="$2"
+
+    case "${manager}" in
+        apt)
+            apt-cache show "${package}" 2>/dev/null || true
+            printf "\n"
+            dpkg -L "${package}" 2>/dev/null || true
+            ;;
+        dnf)
+            dnf info "${package}" 2>/dev/null || true
+            printf "\n"
+            rpm -ql "${package}" 2>/dev/null || true
+            ;;
+        pacman)
+            pacman -Si "${package}" 2>/dev/null || true
+            printf "\n"
+            pacman -Fl "${package}" 2>/dev/null | awk '{print $2}' || true
+            ;;
+        zypper)
+            zypper --non-interactive info "${package}" 2>/dev/null || true
+            ;;
+        emerge)
+            emerge --search --color=n "${package}" 2>/dev/null || true
+            ;;
+        brew)
+            brew info "${package}" 2>/dev/null || true
+            ;;
+        winget)
+            winget show --id "${package}" --exact --source winget --accept-source-agreements --disable-interactivity 2>/dev/null || true
+            ;;
+        choco)
+            choco info "${package}" 2>/dev/null || true
+            ;;
+        scoop)
+            scoop info "${package}" 2>/dev/null || true
+            ;;
+        snap)
+            snap info "${package}" 2>/dev/null || true
+            ;;
+        flatpak)
+            flatpak info "${package}" 2>/dev/null || flatpak remote-info flathub "${package}" 2>/dev/null || true
+            ;;
+        npm)
+            npm view "${package}" 2>/dev/null || true
+            ;;
+        bun)
+            bun info "${package}" 2>/dev/null || npm view "${package}" 2>/dev/null || true
+            ;;
+    esac
+}
+
+run_preview_item_action() {
+    local manager="$1"
+    local package="$2"
+    local cache_dir="${SESSION_TMP_ROOT}/preview-cache"
+    local cache_key=""
+    local cache_file=""
+    local temp_file=""
+
+    [[ -n "${manager}" && -n "${package}" ]] || return 0
+
+    mkdir -p "${cache_dir}"
+    cache_key="$(cache_cksum "${manager}|${package}")"
+    cache_file="${cache_dir}/${manager}.${cache_key}.txt"
+
+    if [[ -f "${cache_file}" ]]; then
+        cat "${cache_file}"
+        return 0
+    fi
+
+    temp_file="$(mktemp "${SESSION_TMP_ROOT}/preview.XXXXXX")"
+    run_preview_manager_output "${manager}" "${package}" >"${temp_file}"
+    mv -f "${temp_file}" "${cache_file}"
+    cat "${cache_file}"
+}
+
 cleanup_session_tmp_root() {
     if [[ -n "${SESSION_TMP_ROOT}" && -d "${SESSION_TMP_ROOT}" ]]; then
         rm -rf "${SESSION_TMP_ROOT}"
@@ -124,6 +788,22 @@ manager_command_ready() {
     esac
 }
 
+flatpak_has_any_remotes() {
+    if ! manager_command_ready flatpak; then
+        return 1
+    fi
+
+    if flatpak remotes --columns=name 2>/dev/null | awk 'NF > 0 { found=1; exit } END { exit (found ? 0 : 1) }'; then
+        return 0
+    fi
+
+    if flatpak remote-list --columns=name 2>/dev/null | awk 'NF > 0 { found=1; exit } END { exit (found ? 0 : 1) }'; then
+        return 0
+    fi
+
+    return 1
+}
+
 manager_can_install_fzf() {
     local manager="$1"
     case "${manager}" in
@@ -214,7 +894,7 @@ ensure_fzf() {
     local candidates=()
     local manager
 
-    if command_exists fzf; then
+    if [[ "${FPF_TEST_FORCE_FZF_MISSING:-0}" != "1" ]] && command_exists fzf; then
         return
     fi
 
@@ -533,6 +1213,18 @@ parse_args() {
             --feed-search)
                 ACTION="feed-search"
                 ;;
+            --ipc-reload)
+                ACTION="ipc-reload"
+                ;;
+            --ipc-query-notify)
+                ACTION="ipc-query-notify"
+                ;;
+            --preview-item)
+                ACTION="preview-item"
+                ;;
+            --bun-refresh-worker)
+                ACTION="bun-refresh-worker"
+                ;;
             -ap|--apt)
                 MANAGER_OVERRIDE="apt"
                 ;;
@@ -806,7 +1498,59 @@ exact_match_entry() {
     done < <(exact_query_candidates "${query}" | awk '!seen[$0]++')
 }
 
-manager_search_entries() {
+manager_bun_search_entries_strict() {
+    local query="$1"
+    local effective_query="${query}"
+    local line_limit=0
+    local query_line_limit=40
+    local effective_limit=0
+    local bun_search_file
+
+    if [[ -z "${query}" ]]; then
+        line_limit="${FPF_NO_QUERY_RESULT_LIMIT:-120}"
+    else
+        query_line_limit="${FPF_QUERY_PER_MANAGER_LIMIT:-40}"
+    fi
+
+    if ! [[ "${line_limit}" =~ ^[0-9]+$ ]]; then
+        line_limit=0
+    fi
+
+    if ! [[ "${query_line_limit}" =~ ^[0-9]+$ ]]; then
+        query_line_limit=40
+    fi
+
+    if [[ "${line_limit}" -gt 0 ]]; then
+        effective_limit="${line_limit}"
+    else
+        effective_limit="${query_line_limit}"
+    fi
+
+    if [[ -z "${effective_query}" ]]; then
+        effective_query="aa"
+    fi
+
+    bun_search_file="$(mktemp "${SESSION_TMP_ROOT}/bun-search-strict.XXXXXX")"
+    if ! bun search "${effective_query}" >"${bun_search_file}" 2>/dev/null; then
+        rm -f "${bun_search_file}"
+        return 1
+    fi
+
+    {
+        awk 'NR > 1 && NF > 0 { name=$1; $1=""; sub(/^[[:space:]]+/, "", $0); if ($0 == "") $0="-"; print name "\t" $0 }' "${bun_search_file}"
+        exact_match_entry "bun" "${query}"
+    } | awk -F'\t' 'NF >= 1 { if ($2 == "") $2 = "-"; print $1 "\t" $2 }' | awk -F'\t' '!seen[$1]++' | {
+        if [[ "${effective_limit}" -gt 0 ]]; then
+            awk -v limit="${effective_limit}" 'NR <= limit'
+        else
+            cat
+        fi
+    }
+
+    rm -f "${bun_search_file}"
+}
+
+manager_search_entries_uncached() {
     local manager="$1"
     local query="$2"
     local effective_query="${query}"
@@ -856,8 +1600,12 @@ manager_search_entries() {
 
     case "${manager}" in
         apt)
-            apt-cache search -- "${effective_query}" 2>/dev/null |
-                awk -F' - ' '{ name=$1; desc=$2; gsub(/^[[:space:]]+|[[:space:]]+$/, "", name); if (desc == "") desc="-"; print name "\t" desc }'
+            if ensure_search_catalog_cache "${manager}"; then
+                search_entries_from_catalog_cache "${manager}" "${effective_query}" || true
+            else
+                apt-cache search -- "${effective_query}" 2>/dev/null |
+                    awk -F' - ' '{ name=$1; desc=$2; gsub(/^[[:space:]]+|[[:space:]]+$/, "", name); if (desc == "") desc="-"; print name "\t" desc }'
+            fi
             ;;
         dnf)
             local pattern="*"
@@ -914,11 +1662,18 @@ manager_search_entries() {
                 '
             ;;
         brew)
-            {
-                brew search "${effective_query}" 2>/dev/null |
-                    awk 'NF > 0 && $1 != "==>" { print $1 "\t-" }'
-                exact_match_entry "${manager}" "${query}"
-            }
+            if ensure_search_catalog_cache "${manager}"; then
+                {
+                    search_entries_from_catalog_cache "${manager}" "${effective_query}" || true
+                    exact_match_entry "${manager}" "${query}"
+                }
+            else
+                {
+                    brew search "${effective_query}" 2>/dev/null |
+                        awk 'NF > 0 && $1 != "==>" { print $1 "\t-" }'
+                    exact_match_entry "${manager}" "${query}"
+                }
+            fi
             ;;
         winget)
             winget search "${effective_query}" --source winget --accept-source-agreements --disable-interactivity 2>/dev/null |
@@ -1017,6 +1772,83 @@ manager_search_entries() {
     } || true
 }
 
+manager_search_entries() {
+    local manager="$1"
+    local query="$2"
+    local query_cache_enabled="${FPF_ENABLE_QUERY_CACHE:-0}"
+    local bun_cache_ttl="${FPF_BUN_QUERY_CACHE_TTL:-900}"
+    local flags
+    local key
+    local fingerprint
+    local cache_file
+    local output_tmp
+    local generation
+    local should_async_refresh=0
+
+    initialize_cache_root
+
+    flags="$(query_cache_flags)"
+
+    if ! [[ "${bun_cache_ttl}" =~ ^[0-9]+$ ]]; then
+        bun_cache_ttl=900
+    fi
+
+    if [[ "${manager}" == "bun" ]]; then
+        query_cache_enabled="1"
+    fi
+
+    key="$(cache_query_key "${manager}" "${query}" "${flags}")"
+    fingerprint="$(cache_fingerprint "${manager}" "${query}" "${flags}")"
+    cache_file="$(cache_path_for_key "${key}")"
+
+    if [[ "${manager}" == "bun" && ( "${ACTION}" == "feed-search" || "${ACTION}" == "ipc-query-notify" ) ]]; then
+        if [[ -s "${cache_file}" ]]; then
+            cache_emit_query_rows_if_valid "${cache_file}" || true
+        fi
+
+        if cache_is_fresh_with_ttl "${key}" "${bun_cache_ttl}"; then
+            return
+        fi
+
+        generation="$(bun_generation_next "${key}")"
+        if [[ -n "${FZF_PORT:-}" && "${FPF_BUN_SKIP_REFRESH_SCHEDULE:-0}" != "1" ]]; then
+            should_async_refresh=1
+        fi
+
+        if [[ "${FPF_BUN_TEST_SYNC_REFRESH:-0}" == "1" ]]; then
+            should_async_refresh=0
+        fi
+
+        if [[ "${should_async_refresh}" -eq 1 ]]; then
+            start_bun_refresh_worker_async "${manager}" "${query}" "${flags}" "${key}" "${fingerprint}" "${generation}" "${FPF_IPC_FALLBACK_FILE:-}" "${FPF_IPC_MANAGER_OVERRIDE:-}"
+            return
+        fi
+
+        bun_run_refresh_worker "${manager}" "${query}" "${flags}" "${key}" "${fingerprint}" "${generation}" || true
+        if [[ -s "${cache_file}" ]]; then
+            cache_emit_query_rows_if_valid "${cache_file}" || true
+        fi
+        return
+    fi
+
+    if [[ "${query_cache_enabled}" == "1" && -s "${cache_file}" ]]; then
+        if [[ "${manager}" != "bun" ]] || cache_is_fresh_with_ttl "${key}" "${bun_cache_ttl}"; then
+            cat "${cache_file}"
+            return
+        fi
+    fi
+
+    output_tmp="$(mktemp "${SESSION_TMP_ROOT}/query-cache.XXXXXX")"
+    manager_search_entries_uncached "${manager}" "${query}" >"${output_tmp}" || true
+
+    if [[ "${query_cache_enabled}" == "1" ]]; then
+        cache_store_key_from_file "${key}" "${fingerprint}" "${output_tmp}"
+    fi
+
+    cat "${output_tmp}"
+    rm -f "${output_tmp}"
+}
+
 manager_installed_entries() {
     local manager="$1"
 
@@ -1137,34 +1969,35 @@ manager_installed_entries() {
             ;;
         bun)
             {
-                if bun pm ls --global >/dev/null 2>&1; then
-                    bun pm ls --global 2>/dev/null |
-                        awk '
-                            NR > 1 {
-                                line = $0
-                                gsub(/\r/, "", line)
-                                sub(/^[[:space:]]*[^[:alnum:]@]*/, "", line)
-                                sub(/^[[:space:]]+/, "", line)
-                                sub(/[[:space:]]+$/, "", line)
-
-                                if (line == "") next
-                                if (line ~ /[[:space:]]node_modules([[:space:]]|$)/) next
-
-                                split(line, fields, /[[:space:]]+/)
-                                pkg = fields[1]
-                                if (pkg == "") next
-
-                                pkg_copy = pkg
-                                at_count = gsub(/@/, "@", pkg_copy)
-                                if ((substr(pkg, 1, 1) == "@" && at_count >= 2) || (substr(pkg, 1, 1) != "@" && at_count >= 1)) {
-                                    sub(/@[^@[:space:]]*$/, "", pkg)
-                                }
+                local bun_pm_file
+                bun_pm_file="$(mktemp "${SESSION_TMP_ROOT}/bun-pm.XXXXXX")"
+                if bun pm ls --global >"${bun_pm_file}" 2>/dev/null; then
+                    awk '
+                        NR > 1 {
+                            line = $0
+                            gsub(/\r/, "", line)
+                            sub(/^[[:space:]]*[^[:alnum:]@]*/, "", line)
+                            sub(/^[[:space:]]+/, "", line)
+                            sub(/[[:space:]]+$/, "", line)
+
+                            if (line == "") next
+                            if (line ~ /[[:space:]]node_modules([[:space:]]|$)/) next
+
+                            split(line, fields, /[[:space:]]+/)
+                            pkg = fields[1]
+                            if (pkg == "") next
+
+                            pkg_copy = pkg
+                            at_count = gsub(/@/, "@", pkg_copy)
+                            if ((substr(pkg, 1, 1) == "@" && at_count >= 2) || (substr(pkg, 1, 1) != "@" && at_count >= 1)) {
+                                sub(/@[^@[:space:]]*$/, "", pkg)
+                            }
 
-                                if (pkg != "") {
-                                    print pkg "\tglobal"
-                                }
+                            if (pkg != "") {
+                                print pkg "\tglobal"
                             }
-                        '
+                        }
+                    ' "${bun_pm_file}"
                 elif command_exists npm; then
                     npm ls -g --depth=0 --parseable 2>/dev/null |
                         awk '
@@ -1188,6 +2021,7 @@ manager_installed_entries() {
                             }
                         '
                 fi
+                rm -f "${bun_pm_file}"
             } || true
             ;;
     esac | sort -u || true
@@ -1202,8 +2036,15 @@ manager_installed_names_cached() {
     local manager="$1"
     local output_file="$2"
     local cache_enabled="${FPF_DISABLE_INSTALLED_CACHE:-0}"
-    local cache_dir="${TMP_ROOT}/cache"
-    local cache_file="${cache_dir}/installed.${manager}"
+    local cache_key
+    local cache_file
+    local cache_fingerprint_value
+
+    initialize_cache_root
+
+    cache_key="$(cache_catalog_key "${manager}")"
+    cache_file="$(cache_path_for_key "${cache_key}")"
+    cache_fingerprint_value="$(cache_fingerprint "${manager}" "" "installed")"
 
     if [[ "${cache_enabled}" != "1" && -s "${cache_file}" ]]; then
         cp "${cache_file}" "${output_file}"
@@ -1213,47 +2054,82 @@ manager_installed_names_cached() {
     manager_installed_names "${manager}" >"${output_file}" 2>/dev/null || true
 
     if [[ "${cache_enabled}" != "1" && -s "${output_file}" ]]; then
-        mkdir -p "${cache_dir}"
-        cp "${output_file}" "${cache_file}"
+        cache_store_key_from_file "${cache_key}" "${cache_fingerprint_value}" "${output_file}"
     fi
 }
 
 mark_installed_packages() {
-    local manager="$1"
-    local source_file="$2"
-    local output_file="$3"
+    local source_file="$1"
+    local output_file="$2"
     local installed_file
+    local installed_map_file
+    local manager
 
     if [[ "${FPF_SKIP_INSTALLED_MARKERS:-0}" == "1" ]]; then
         awk -F'\t' '
             {
-                desc = $2
+                desc = $3
                 if (desc == "") desc = "-"
-                print $1 "\t  " desc
+                print $1 "\t" $2 "\t  " desc
             }
         ' "${source_file}" >"${output_file}"
         return
     fi
 
-    installed_file="$(mktemp "${SESSION_TMP_ROOT}/installed.XXXXXX")"
-    manager_installed_names_cached "${manager}" "${installed_file}"
+    installed_map_file="$(mktemp "${SESSION_TMP_ROOT}/installed-map.XXXXXX")"
+    : >"${installed_map_file}"
+
+    while IFS= read -r manager; do
+        [[ -n "${manager}" ]] || continue
+        installed_file="$(mktemp "${SESSION_TMP_ROOT}/installed.${manager}.XXXXXX")"
+        manager_installed_names_cached "${manager}" "${installed_file}"
+        if [[ -s "${installed_file}" ]]; then
+            awk -F'\t' -v mgr="${manager}" 'NF > 0 && $1 != "" { print mgr "\t" $1 }' "${installed_file}" >>"${installed_map_file}"
+        fi
+        rm -f "${installed_file}"
+    done < <(awk -F'\t' 'NF >= 1 && $1 != "" { print $1 }' "${source_file}" | awk '!seen[$0]++')
 
     awk -F'\t' '
         FILENAME == ARGV[1] {
-            if ($1 != "") {
-                installed[$1] = 1
+            key = $1 "\t" $2
+            if ($1 != "" && $2 != "") {
+                installed[key] = 1
             }
             next
         }
         {
-            mark = (installed[$1] ? "* " : "  ")
-            desc = $2
+            key = $1 "\t" $2
+            mark = (installed[key] ? "* " : "  ")
+            desc = $3
             if (desc == "") desc = "-"
-            print $1 "\t" mark desc
+            print $1 "\t" $2 "\t" mark desc
         }
-    ' "${installed_file}" "${source_file}" >"${output_file}"
+    ' "${installed_map_file}" "${source_file}" >"${output_file}"
+
+    rm -f "${installed_map_file}"
+}
+
+merge_search_display_rows() {
+    local source_file="$1"
+    local output_file="$2"
+
+    if [[ ! -s "${source_file}" ]]; then
+        : >"${output_file}"
+        return
+    fi
 
-    rm -f "${installed_file}"
+    sort -t $'\t' -k1,1 -k2,2 -k3,3 "${source_file}" |
+        awk -F'\t' '
+            NF >= 2 {
+                key = $1 "\t" $2
+                if (seen[key]++) {
+                    next
+                }
+                desc = $3
+                if (desc == "") desc = "-"
+                print $1 "\t" $2 "\t" desc
+            }
+        ' >"${output_file}"
 }
 
 collect_search_display_rows() {
@@ -1270,6 +2146,8 @@ collect_search_display_rows() {
     local manager
     local part_file
     local gather_pid
+    local merged_source_file
+    local merged_marked_file
 
     for manager in "${managers[@]-}"; do
         part_file="$(mktemp "${SESSION_TMP_ROOT}/part.XXXXXX")"
@@ -1277,19 +2155,17 @@ collect_search_display_rows() {
 
         (
             local_source_file="$(mktemp "${SESSION_TMP_ROOT}/source.XXXXXX")"
-            local_marked_file="$(mktemp "${SESSION_TMP_ROOT}/marked.XXXXXX")"
             manager_search_entries "${manager}" "${query}" >"${local_source_file}" || true
             if [[ -s "${local_source_file}" ]]; then
-                mark_installed_packages "${manager}" "${local_source_file}" "${local_marked_file}"
                 awk -F'\t' -v mgr="${manager}" '
                     NF >= 1 {
                         desc = $2
                         if (desc == "") desc = "-"
                         print mgr "\t" $1 "\t" desc
                     }
-                ' "${local_marked_file}" >"${part_file}"
+                ' "${local_source_file}" >"${part_file}"
             fi
-            rm -f "${local_source_file}" "${local_marked_file}"
+            rm -f "${local_source_file}"
         ) &
         gather_pids+=("$!")
     done
@@ -1298,15 +2174,19 @@ collect_search_display_rows() {
         wait "${gather_pid}" || true
     done
 
+    merged_source_file="$(mktemp "${SESSION_TMP_ROOT}/merged-source.XXXXXX")"
+    merged_marked_file="$(mktemp "${SESSION_TMP_ROOT}/merged-marked.XXXXXX")"
+
     for part_file in "${part_files[@]-}"; do
         if [[ -s "${part_file}" ]]; then
-            cat "${part_file}" >>"${output_file}"
+            cat "${part_file}" >>"${merged_source_file}"
         fi
         rm -f "${part_file}"
     done
 
-    if [[ -s "${output_file}" ]]; then
-        sort -u "${output_file}" -o "${output_file}"
+    if [[ -s "${merged_source_file}" ]]; then
+        merge_search_display_rows "${merged_source_file}" "${merged_marked_file}"
+        mark_installed_packages "${merged_marked_file}" "${output_file}"
         rank_display_rows_by_query "${query}" "${output_file}"
 
         if [[ -n "${query}" && "${query_limit}" =~ ^[0-9]+$ && "${query_limit}" -gt 0 ]]; then
@@ -1314,6 +2194,8 @@ collect_search_display_rows() {
             mv "${output_file}.limited" "${output_file}"
         fi
     fi
+
+    rm -f "${merged_source_file}" "${merged_marked_file}"
 }
 
 build_dynamic_reload_command() {
@@ -1336,10 +2218,195 @@ build_dynamic_reload_command() {
     fi
 
     if [[ -n "${manager_override}" ]]; then
-        printf 'q={q}; if [ ${#q} -lt %s ]; then cat %q; else sleep %s; FPF_SKIP_INSTALLED_MARKERS=1 %q --feed-search --manager %q -- "$q" 2>/dev/null || cat %q; fi' "${min_chars}" "${fallback_file}" "${reload_debounce}" "${script_path}" "${manager_override}" "${fallback_file}"
+        printf 'q={q}; if [ ${#q} -lt %s ]; then cat %q; else sleep %s; FPF_SKIP_INSTALLED_MARKERS=1 FPF_IPC_MANAGER_OVERRIDE=%q FPF_IPC_FALLBACK_FILE=%q %q --feed-search --manager %q -- "$q" 2>/dev/null || cat %q; fi' "${min_chars}" "${fallback_file}" "${reload_debounce}" "${manager_override}" "${fallback_file}" "${script_path}" "${manager_override}" "${fallback_file}"
+    else
+        printf 'q={q}; if [ ${#q} -lt %s ]; then cat %q; else sleep %s; FPF_SKIP_INSTALLED_MARKERS=1 FPF_IPC_MANAGER_OVERRIDE= FPF_IPC_FALLBACK_FILE=%q %q --feed-search -- "$q" 2>/dev/null || cat %q; fi' "${min_chars}" "${fallback_file}" "${reload_debounce}" "${fallback_file}" "${script_path}" "${fallback_file}"
+    fi
+}
+
+build_dynamic_reload_command_for_query() {
+    local manager_override="$1"
+    local fallback_file="$2"
+    local query_value="$3"
+    local script_path="${BASH_SOURCE[0]}"
+    local min_chars="${FPF_RELOAD_MIN_CHARS:-2}"
+    local reload_debounce="${FPF_RELOAD_DEBOUNCE:-0.12}"
+
+    if ! [[ "${min_chars}" =~ ^[0-9]+$ ]]; then
+        min_chars=2
+    fi
+
+    if ! [[ "${reload_debounce}" =~ ^[0-9]+(\.[0-9]+)?$ ]]; then
+        reload_debounce=0.12
+    fi
+
+    if [[ "${script_path}" != /* ]]; then
+        script_path="$(pwd)/${script_path}"
+    fi
+
+    if [[ ${#query_value} -lt ${min_chars} ]]; then
+        printf 'cat %q' "${fallback_file}"
+        return
+    fi
+
+    if [[ -n "${manager_override}" ]]; then
+        printf 'sleep %s; FPF_SKIP_INSTALLED_MARKERS=1 FPF_IPC_MANAGER_OVERRIDE=%q FPF_IPC_FALLBACK_FILE=%q %q --feed-search --manager %q -- %q 2>/dev/null || cat %q' "${reload_debounce}" "${manager_override}" "${fallback_file}" "${script_path}" "${manager_override}" "${query_value}" "${fallback_file}"
+    else
+        printf 'sleep %s; FPF_SKIP_INSTALLED_MARKERS=1 FPF_IPC_MANAGER_OVERRIDE= FPF_IPC_FALLBACK_FILE=%q %q --feed-search -- %q 2>/dev/null || cat %q' "${reload_debounce}" "${fallback_file}" "${script_path}" "${query_value}" "${fallback_file}"
+    fi
+}
+
+build_dynamic_reload_ipc_command() {
+    local manager_override="$1"
+    local fallback_file="$2"
+    local script_path="${BASH_SOURCE[0]}"
+
+    if [[ "${script_path}" != /* ]]; then
+        script_path="$(pwd)/${script_path}"
+    fi
+
+    printf 'FPF_IPC_MANAGER_OVERRIDE=%q FPF_IPC_FALLBACK_FILE=%q %q --ipc-reload -- "{q}"' "${manager_override}" "${fallback_file}" "${script_path}"
+}
+
+build_dynamic_query_notify_ipc_command() {
+    local manager_override="$1"
+    local fallback_file="$2"
+    local script_path="${BASH_SOURCE[0]}"
+
+    if [[ "${script_path}" != /* ]]; then
+        script_path="$(pwd)/${script_path}"
+    fi
+
+    printf 'FPF_IPC_MANAGER_OVERRIDE=%q FPF_IPC_FALLBACK_FILE=%q %q --ipc-query-notify -- "{q}"' "${manager_override}" "${fallback_file}" "${script_path}"
+}
+
+fzf_supports_listen() {
+    local fzf_help
+    fzf_help="$(fzf --help 2>&1 || true)"
+    [[ "${fzf_help}" == *"--listen"* ]]
+}
+
+send_fzf_listen_action() {
+    local action_payload="$1"
+    local port="${FZF_PORT:-}"
+    local host="127.0.0.1"
+    local payload_size
+
+    if ! [[ "${port}" =~ ^[0-9]+$ ]] || [[ "${port}" -le 0 || "${port}" -gt 65535 ]]; then
+        return 1
+    fi
+
+    payload_size="$(printf "%s" "${action_payload}" | wc -c | tr -d '[:space:]')"
+
+    if command_exists curl; then
+        curl --silent --show-error --fail --max-time 2 \
+            --request POST \
+            --header 'Content-Type: text/plain' \
+            --data-binary "${action_payload}" \
+            "http://${host}:${port}" >/dev/null 2>&1
+        return
+    fi
+
+    if command_exists nc; then
+        {
+            printf 'POST / HTTP/1.1\r\n'
+            printf 'Host: %s:%s\r\n' "${host}" "${port}"
+            printf 'Content-Type: text/plain\r\n'
+            printf 'Content-Length: %s\r\n' "${payload_size}"
+            printf '\r\n'
+            printf '%s' "${action_payload}"
+        } | nc -w 2 "${host}" "${port}" >/dev/null 2>&1
+        return
+    fi
+
+    if exec 9<>"/dev/tcp/${host}/${port}" 2>/dev/null; then
+        printf 'POST / HTTP/1.1\r\n' >&9
+        printf 'Host: %s:%s\r\n' "${host}" "${port}" >&9
+        printf 'Content-Type: text/plain\r\n' >&9
+        printf 'Content-Length: %s\r\n' "${payload_size}" >&9
+        printf '\r\n' >&9
+        printf '%s' "${action_payload}" >&9
+        exec 9>&-
+        return 0
+    fi
+
+    return 1
+}
+
+send_fzf_prompt_action() {
+    local prompt_text="$1"
+    local action_payload
+
+    action_payload="change-prompt(${prompt_text})"
+    send_fzf_listen_action "${action_payload}"
+}
+
+run_ipc_reload_action() {
+    local query="$1"
+    local manager_override="${FPF_IPC_MANAGER_OVERRIDE:-}"
+    local fallback_file="${FPF_IPC_FALLBACK_FILE:-}"
+    local reload_command
+    local action_payload
+
+    if [[ -z "${fallback_file}" || ! -r "${fallback_file}" ]]; then
+        return 1
+    fi
+
+    if [[ -n "${manager_override}" ]]; then
+        manager_override="$(normalize_manager "${manager_override}")"
+        manager_supported "${manager_override}" || return 1
+    fi
+
+    reload_command="$(build_dynamic_reload_command_for_query "${manager_override}" "${fallback_file}" "${query}")"
+    action_payload="reload(${reload_command})+change-prompt(Search> )"
+    send_fzf_listen_action "${action_payload}"
+}
+
+run_ipc_query_notify_action() {
+    local query="$1"
+    local manager_override="${FPF_IPC_MANAGER_OVERRIDE:-}"
+    local fallback_file="${FPF_IPC_FALLBACK_FILE:-}"
+    local min_chars="${FPF_RELOAD_MIN_CHARS:-2}"
+    local target_manager=""
+
+    if ! [[ "${min_chars}" =~ ^[0-9]+$ ]]; then
+        min_chars=2
+    fi
+
+    if [[ ${#query} -lt ${min_chars} ]]; then
+        send_fzf_prompt_action "Search> " || true
+        return 0
+    fi
+
+    if [[ -z "${fallback_file}" || ! -r "${fallback_file}" ]]; then
+        return 1
+    fi
+
+    if [[ -n "${manager_override}" ]]; then
+        manager_override="$(normalize_manager "${manager_override}")"
+        manager_supported "${manager_override}" || return 1
+        target_manager="${manager_override}"
     else
-        printf 'q={q}; if [ ${#q} -lt %s ]; then cat %q; else sleep %s; FPF_SKIP_INSTALLED_MARKERS=1 %q --feed-search -- "$q" 2>/dev/null || cat %q; fi' "${min_chars}" "${fallback_file}" "${reload_debounce}" "${script_path}" "${fallback_file}"
+        target_manager="bun"
+    fi
+
+    if [[ "${target_manager}" != "bun" ]]; then
+        send_fzf_prompt_action "Search> " || true
+        return 0
+    fi
+
+    if ! manager_command_ready bun; then
+        send_fzf_prompt_action "Search> " || true
+        return 0
     fi
+
+    send_fzf_prompt_action "Loading> " || true
+
+    FPF_IPC_MANAGER_OVERRIDE="${manager_override}" \
+        FPF_IPC_FALLBACK_FILE="${fallback_file}" \
+        manager_search_entries "bun" "${query}" >/dev/null 2>&1 || {
+        send_fzf_prompt_action "Search> " || true
+    }
 }
 
 manager_install() {
@@ -1572,9 +2639,15 @@ run_fuzzy_selector() {
     local input_file="$2"
     local header_line="$3"
     local reload_cmd="${4:-}"
+    local reload_ipc_cmd="${5:-}"
+    local script_path="${BASH_SOURCE[0]}"
     local preview_cmd
 
-    preview_cmd='bash -c '\''mgr="$1"; pkg="$2"; case "$mgr" in apt) apt-cache show "$pkg" 2>/dev/null; printf "\n"; dpkg -L "$pkg" 2>/dev/null ;; dnf) dnf info "$pkg" 2>/dev/null; printf "\n"; rpm -ql "$pkg" 2>/dev/null ;; pacman) pacman -Si "$pkg" 2>/dev/null; printf "\n"; pacman -Fl "$pkg" 2>/dev/null | awk "{print \$2}" ;; zypper) zypper --non-interactive info "$pkg" 2>/dev/null ;; emerge) emerge --search --color=n "$pkg" 2>/dev/null ;; brew) brew info "$pkg" 2>/dev/null ;; winget) winget show --id "$pkg" --exact --source winget --accept-source-agreements --disable-interactivity 2>/dev/null ;; choco) choco info "$pkg" 2>/dev/null ;; scoop) scoop info "$pkg" 2>/dev/null ;; snap) snap info "$pkg" 2>/dev/null ;; flatpak) flatpak info "$pkg" 2>/dev/null || flatpak remote-info flathub "$pkg" 2>/dev/null ;; npm) npm view "$pkg" 2>/dev/null ;; bun) bun info "$pkg" 2>/dev/null || npm view "$pkg" 2>/dev/null ;; esac'\'' _ {1} {2}'
+    if [[ "${script_path}" != /* ]]; then
+        script_path="$(pwd)/${script_path}"
+    fi
+
+    preview_cmd="FPF_SESSION_TMP_ROOT=$(printf '%q' "${SESSION_TMP_ROOT}") ${script_path} --preview-item --manager {1} -- {2}"
 
     local -a fzf_args=()
     fzf_args=(-q "${query}" -m \
@@ -1597,8 +2670,14 @@ run_fuzzy_selector() {
         --bind=ctrl-n:next-selected,ctrl-b:prev-selected \
         --bind='focus:transform-preview-label:echo [{1}] {2}')
 
-    if [[ -n "${reload_cmd}" ]]; then
-        fzf_args+=(--bind="change:reload:${reload_cmd}")
+    if [[ -n "${reload_ipc_cmd}" ]]; then
+        fzf_args+=(--listen=127.0.0.1:0)
+        fzf_args+=(--bind="change:execute-silent:${reload_ipc_cmd}")
+        if [[ -n "${reload_cmd}" ]]; then
+            fzf_args+=(--bind="ctrl-r:reload:${reload_cmd}")
+        fi
+    elif [[ -n "${reload_cmd}" ]]; then
+        fzf_args+=(--bind="ctrl-r:reload:${reload_cmd}")
     fi
 
     fzf "${fzf_args[@]}" <"${input_file}"
@@ -1607,10 +2686,54 @@ run_fuzzy_selector() {
 main() {
     ensure_tmp_root
     initialize_session_tmp_root
-    trap cleanup_session_tmp_root EXIT
+    if [[ -z "${FPF_SESSION_TMP_ROOT:-}" ]]; then
+        trap cleanup_session_tmp_root EXIT
+    fi
 
     parse_args "$@"
 
+    if [[ "${ACTION}" == "ipc-reload" ]]; then
+        run_ipc_reload_action "$(join_query)" || true
+        exit 0
+    fi
+
+    if [[ "${ACTION}" == "ipc-query-notify" ]]; then
+        run_ipc_query_notify_action "$(join_query)" || true
+        exit 0
+    fi
+
+    if [[ "${ACTION}" == "preview-item" ]]; then
+        local preview_manager="${MANAGER_OVERRIDE:-}"
+        local preview_package
+
+        preview_package="$(join_query)"
+        run_preview_item_action "${preview_manager}" "${preview_package}" || true
+        exit 0
+    fi
+
+    if [[ "${ACTION}" == "bun-refresh-worker" ]]; then
+        local worker_manager="${MANAGER_OVERRIDE:-bun}"
+        local worker_query
+        local worker_flags
+        local worker_key
+        local worker_fingerprint
+        local worker_generation
+
+        worker_query="$(join_query)"
+        worker_flags="${FPF_BUN_REFRESH_FLAGS:-$(query_cache_flags)}"
+        worker_key="${FPF_BUN_REFRESH_KEY:-$(cache_query_key "${worker_manager}" "${worker_query}" "${worker_flags}")}"
+        worker_fingerprint="${FPF_BUN_REFRESH_FINGERPRINT:-$(cache_fingerprint "${worker_manager}" "${worker_query}" "${worker_flags}")}"
+        worker_generation="${FPF_BUN_REFRESH_GENERATION:-0}"
+
+        if ! [[ "${worker_generation}" =~ ^[0-9]+$ ]] || [[ "${worker_generation}" -le 0 ]]; then
+            exit 0
+        fi
+
+        initialize_cache_root
+        bun_run_refresh_worker "${worker_manager}" "${worker_query}" "${worker_flags}" "${worker_key}" "${worker_fingerprint}" "${worker_generation}" || true
+        exit 0
+    fi
+
     if [[ "${ACTION}" == "version" ]]; then
         print_version
         exit 0
@@ -1739,6 +2862,13 @@ main() {
 
     if [[ ! -s "${display_file}" ]]; then
         rm -f "${display_file}"
+
+        if [[ "${ACTION}" == "search" && "${#managers[@]}" -eq 1 && "${managers[0]}" == "flatpak" ]]; then
+            if ! flatpak_has_any_remotes; then
+                die "Flatpak has no remotes configured. Add Flathub with: flatpak remote-add --if-not-exists --user flathub https://flathub.org/repo/flathub.flatpakrepo"
+            fi
+        fi
+
         if [[ -n "${query}" ]]; then
             die "No packages found for ${manager_display} matching '${query}'. Try a broader query or --manager."
         fi
@@ -1762,14 +2892,18 @@ main() {
     esac
 
     local reload_cmd=""
+    local reload_ipc_cmd=""
     if [[ "${ACTION}" == "search" && -z "${query}" ]]; then
         if dynamic_reload_enabled "${#managers[@]}"; then
             reload_cmd="$(build_dynamic_reload_command "${MANAGER_OVERRIDE}" "${display_file}")"
+            if fzf_supports_listen; then
+                reload_ipc_cmd="$(build_dynamic_query_notify_ipc_command "${MANAGER_OVERRIDE}" "${display_file}")"
+            fi
         fi
     fi
 
     local selected
-    selected="$(run_fuzzy_selector "${query}" "${display_file}" "${header}" "${reload_cmd}" || true)"
+    selected="$(run_fuzzy_selector "${query}" "${display_file}" "${header}" "${reload_cmd}" "${reload_ipc_cmd}" || true)"
 
     rm -f "${display_file}"
 
@@ -1824,7 +2958,7 @@ main() {
             if confirm_action "Install ${#selected_packages[@]} package(s) with ${selected_manager_display}?"; then
                 for manager in "${unique_managers[@]-}"; do
                     mgr_packages=()
-                    for idx in "${!selected_packages[@]-}"; do
+                    for idx in "${!selected_packages[@]}"; do
                         if [[ "${selected_managers[$idx]}" == "${manager}" ]]; then
                             mgr_packages+=("${selected_packages[$idx]}")
                         fi
@@ -1842,7 +2976,7 @@ main() {
             if confirm_action "Remove ${#selected_packages[@]} package(s) with ${selected_manager_display}?"; then
                 for manager in "${unique_managers[@]-}"; do
                     mgr_packages=()
-                    for idx in "${!selected_packages[@]-}"; do
+                    for idx in "${!selected_packages[@]}"; do
                         if [[ "${selected_managers[$idx]}" == "${manager}" ]]; then
                             mgr_packages+=("${selected_packages[$idx]}")
                         fi
@@ -1857,7 +2991,7 @@ main() {
             fi
             ;;
         list)
-            for idx in "${!selected_packages[@]-}"; do
+            for idx in "${!selected_packages[@]}"; do
                 printf "\n=== %s (%s) ===\n" "${selected_packages[$idx]}" "$(manager_label "${selected_managers[$idx]}")"
                 manager_show_info "${selected_managers[$idx]}" "${selected_packages[$idx]}" || true
             done