fpf-cli 1.6.29 → 1.6.31

package/README.md

@@ -74,6 +74,7 @@ Live reload is enabled by default, with a minimum query length and debounce to r
 - `-R, --remove` remove selected packages
 - `-U, --update` run update/upgrade flow
 - `--refresh` refresh package catalogs only
+- `-y, --yes` skip confirmation prompts
 - `-v, --version` print version and exit
 - `-h, --help` show help
 
@@ -90,12 +91,14 @@ Installed packages are marked with `*` in the result list.
 ## Notes
 
 - Requires: `bash` + `fzf`
-- If `fzf` is missing, `fpf` auto-installs it using a compatible detected manager.
+- If `fzf` is missing, `fpf` auto-installs it using a compatible detected manager, then falls back to a release binary download if manager bootstrap fails.
 - Root managers (`apt`, `dnf`, `pacman`, `zypper`, `emerge`, `snap`) use `sudo` when needed.
 - If Flatpak is detected and Flathub is missing, `fpf` attempts `flatpak remote-add --if-not-exists --user flathub ...` automatically.
+- Set `FPF_ASSUME_YES=1` to bypass confirmation prompts in non-interactive flows.
 - `FPF_DYNAMIC_RELOAD`: `always` (default), `single`, or `never`
 - Live reload uses `change:reload` by default for reliability (`ctrl-r` uses the same reload command).
 - Set `FPF_DYNAMIC_RELOAD_TRANSPORT=ipc` to opt into `--listen` + IPC query notifications on supported `fzf` builds.
 - `FPF_RELOAD_MIN_CHARS`: minimum query length before live reload (default `2`)
 - `FPF_RELOAD_DEBOUNCE`: reload debounce seconds (default `0.12`)
 - `FPF_DISABLE_INSTALLED_CACHE=1` disables installed-package marker cache
+- `FPF_INSTALLED_CACHE_TTL`: installed-package marker cache freshness window in seconds (default `300`, set `0` to always refresh)

package/fpf

@@ -3,7 +3,7 @@
 set -euo pipefail
 
 SCRIPT_NAME="fpf"
-SCRIPT_VERSION="1.6.29"
+SCRIPT_VERSION="1.6.31"
 TMP_ROOT="${TMPDIR:-/tmp}/fpf"
 SESSION_TMP_ROOT=""
 HELP_FILE=""
@@ -15,7 +15,9 @@ ACTION="search"
 MANAGER_OVERRIDE=""
 IPC_MANAGER_OVERRIDE=""
 IPC_FALLBACK_FILE=""
+ASSUME_YES="0"
 declare -a QUERY_PARTS=()
+FPF_LIBRARIES_LOADED="0"
 
 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}"
@@ -34,6 +36,74 @@ command_exists() {
     command -v "$1" >/dev/null 2>&1
 }
 
+resolve_script_dir() {
+    local script_path="${BASH_SOURCE[0]}"
+    local script_dir=""
+
+    if command_exists readlink; then
+        while [[ -L "${script_path}" ]]; do
+            script_dir="$(cd -P "$(dirname "${script_path}")" && pwd)"
+            script_path="$(readlink "${script_path}")"
+            if [[ "${script_path}" != /* ]]; then
+                script_path="${script_dir}/${script_path}"
+            fi
+        done
+    fi
+
+    if [[ "${script_path}" != /* ]]; then
+        script_path="$(pwd)/${script_path}"
+    fi
+
+    script_dir="$(cd -P "$(dirname "${script_path}")" && pwd)"
+    printf "%s" "${script_dir}"
+}
+
+load_fpf_libraries() {
+    local script_dir=""
+    local manager_actions_lib=""
+
+    if [[ "${FPF_LIBRARIES_LOADED}" == "1" ]]; then
+        return
+    fi
+
+    script_dir="$(resolve_script_dir)"
+    manager_actions_lib="${script_dir}/lib/fpf/manager-actions.sh"
+
+    if [[ ! -r "${manager_actions_lib}" ]]; then
+        die "Required library file not found: ${manager_actions_lib}"
+    fi
+
+    # shellcheck disable=SC1090
+    source "${manager_actions_lib}"
+    FPF_LIBRARIES_LOADED="1"
+}
+
+fzf_command_available() {
+    if [[ "${FPF_TEST_FORCE_FZF_MISSING:-0}" == "1" ]]; then
+        if [[ -n "${FPF_TEST_MOCK_BIN:-}" && -x "${FPF_TEST_MOCK_BIN}/fzf" ]]; then
+            return 0
+        fi
+        return 1
+    fi
+
+    command_exists fzf
+}
+
+assume_yes_enabled() {
+    if [[ "${ASSUME_YES}" == "1" ]]; then
+        return 0
+    fi
+
+    case "${FPF_ASSUME_YES:-0}" in
+        1|true|TRUE|yes|YES|on|ON)
+            return 0
+            ;;
+        *)
+            return 1
+            ;;
+    esac
+}
+
 ensure_tmp_root() {
     mkdir -p "${TMP_ROOT}"
 }
@@ -146,30 +216,127 @@ cache_catalog_key() {
     printf "catalog/%s.tsv" "${manager}"
 }
 
+catalog_fixture_checksum() {
+    local fixture_name="$1"
+    local fixture_path=""
+
+    if [[ "${FPF_TEST_FIXTURES:-0}" != "1" ]]; then
+        return 1
+    fi
+
+    if [[ -z "${FPF_TEST_FIXTURE_DIR:-}" ]]; then
+        return 1
+    fi
+
+    fixture_path="${FPF_TEST_FIXTURE_DIR}/${fixture_name}"
+    [[ -r "${fixture_path}" ]] || return 1
+    cksum "${fixture_path}" | awk '{ print $1 }'
+}
+
+apt_catalog_state_token() {
+    local fixture_checksum=""
+    local lists_dir="/var/lib/apt/lists"
+    local listing=""
+    local listing_checksum=""
+    local policy_checksum=""
+
+    fixture_checksum="$(catalog_fixture_checksum "apt-dumpavail.txt" 2>/dev/null || true)"
+    if [[ -n "${fixture_checksum}" ]]; then
+        printf "fixture=%s" "${fixture_checksum}"
+        return
+    fi
+
+    if [[ -d "${lists_dir}" ]]; then
+        listing="$(find "${lists_dir}" -maxdepth 1 -type f \( -name '*_Packages' -o -name '*_Sources' -o -name '*InRelease' -o -name '*Release' \) -printf '%f|%s|%T@\n' 2>/dev/null | LC_ALL=C sort || true)"
+        if [[ -n "${listing}" ]]; then
+            listing_checksum="$(printf "%s" "${listing}" | cksum | awk '{ print $1 }')"
+            printf "lists=%s" "${listing_checksum}"
+            return
+        fi
+    fi
+
+    if command_exists apt-cache; then
+        policy_checksum="$(apt-cache policy 2>/dev/null | cksum | awk '{ print $1 }' || true)"
+        if [[ -n "${policy_checksum}" ]]; then
+            printf "policy=%s" "${policy_checksum}"
+            return
+        fi
+    fi
+
+    printf "state=unknown"
+}
+
+brew_catalog_state_token() {
+    local formula_fixture_checksum=""
+    local cask_fixture_checksum=""
+    local formula_repo=""
+    local cask_repo=""
+    local formula_head=""
+    local cask_head=""
+    local brew_version=""
+
+    formula_fixture_checksum="$(catalog_fixture_checksum "brew-formulae.txt" 2>/dev/null || true)"
+    cask_fixture_checksum="$(catalog_fixture_checksum "brew-casks.txt" 2>/dev/null || true)"
+    if [[ -n "${formula_fixture_checksum}" || -n "${cask_fixture_checksum}" ]]; then
+        printf "fixture=formula=%s;cask=%s" "${formula_fixture_checksum:-missing}" "${cask_fixture_checksum:-missing}"
+        return
+    fi
+
+    if command_exists brew; then
+        formula_repo="$(brew --repository 2>/dev/null || true)"
+        cask_repo="$(brew --repository homebrew/cask 2>/dev/null || true)"
+    fi
+
+    if command_exists git; then
+        if [[ -n "${formula_repo}" && -d "${formula_repo}/.git" ]]; then
+            formula_head="$(git -C "${formula_repo}" rev-parse HEAD 2>/dev/null || true)"
+        fi
+        if [[ -n "${cask_repo}" && -d "${cask_repo}/.git" ]]; then
+            cask_head="$(git -C "${cask_repo}" rev-parse HEAD 2>/dev/null || true)"
+        fi
+    fi
+
+    if [[ -n "${formula_head}" || -n "${cask_head}" ]]; then
+        printf "repos=formula:%s;cask:%s" "${formula_head:-missing}" "${cask_head:-missing}"
+        return
+    fi
+
+    if [[ -n "${formula_repo}" || -n "${cask_repo}" ]]; then
+        printf "repo-paths=formula:%s;cask:%s" "${formula_repo:-missing}" "${cask_repo:-missing}"
+        return
+    fi
+
+    if command_exists brew; then
+        brew_version="$(brew --version 2>/dev/null | awk 'NR == 1 { print $0; exit }' || true)"
+        if [[ -n "${brew_version}" ]]; then
+            printf "version=%s" "${brew_version}"
+            return
+        fi
+    fi
+
+    printf "state=unknown"
+}
+
 cache_search_catalog_fingerprint() {
     local manager="$1"
     local command_path=""
-    local extra_token=""
+    local state_token="state=unknown"
 
     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
+            state_token="$(apt_catalog_state_token)"
             ;;
         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
+            state_token="$(brew_catalog_state_token)"
             ;;
         *)
             command_path="n/a"
             ;;
     esac
 
-    printf "%s|cmd=%s%s" "$(cache_fingerprint "${manager}" "" "search-catalog")" "${command_path}" "${extra_token}"
+    printf "%s|cmd=%s|%s" "$(cache_fingerprint "${manager}" "" "search-catalog")" "${command_path}" "${state_token}"
 }
 
 cache_search_catalog_key() {
@@ -660,53 +827,7 @@ 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
+    manager_show_info "${manager}" "${package}" || true
 }
 
 run_preview_item_action() {
@@ -999,6 +1120,10 @@ manager_can_install_fzf() {
 install_fzf_with_manager() {
     local manager="$1"
 
+    if [[ "${FPF_TEST_FZF_MANAGER_INSTALL_FAIL:-0}" == "1" ]]; then
+        return 1
+    fi
+
     case "${manager}" in
         apt)
             run_as_root apt-get install -y fzf
@@ -1037,6 +1162,105 @@ install_fzf_with_manager() {
     esac
 }
 
+detect_fzf_release_asset() {
+    local os=""
+    local arch=""
+
+    os="$(uname -s)"
+    arch="$(uname -m)"
+
+    case "${os}" in
+        Linux)
+            case "${arch}" in
+                x86_64|amd64) printf "linux_amd64.tar.gz" ;;
+                aarch64|arm64) printf "linux_arm64.tar.gz" ;;
+                armv7l|armv7*) printf "linux_armv7.tar.gz" ;;
+                armv6l|armv6*) printf "linux_armv6.tar.gz" ;;
+                *) return 1 ;;
+            esac
+            ;;
+        Darwin)
+            case "${arch}" in
+                x86_64|amd64) printf "darwin_amd64.tar.gz" ;;
+                arm64|aarch64) printf "darwin_arm64.tar.gz" ;;
+                *) return 1 ;;
+            esac
+            ;;
+        *)
+            return 1
+            ;;
+    esac
+}
+
+resolve_fzf_release_url() {
+    local asset_suffix="$1"
+    local api_url="https://api.github.com/repos/junegunn/fzf/releases/latest"
+    local api_payload=""
+    local asset_url=""
+
+    if [[ -n "${FPF_FZF_BOOTSTRAP_URL:-}" ]]; then
+        printf "%s" "${FPF_FZF_BOOTSTRAP_URL}"
+        return 0
+    fi
+
+    command_exists curl || return 1
+    api_payload="$(curl --silent --show-error --fail --location "${api_url}" 2>/dev/null || true)"
+    [[ -n "${api_payload}" ]] || return 1
+
+    asset_url="$(printf "%s" "${api_payload}" | awk -F'"' -v suffix="${asset_suffix}" '
+        $2 == "browser_download_url" {
+            needle = "-" suffix
+            if (index($4, needle) > 0) {
+                print $4
+                exit
+            }
+        }
+    ')"
+
+    [[ -n "${asset_url}" ]] || return 1
+    printf "%s" "${asset_url}"
+}
+
+install_fzf_from_release_fallback() {
+    local asset_suffix=""
+    local asset_url=""
+    local archive_file=""
+    local install_dir=""
+
+    if [[ "${FPF_TEST_BOOTSTRAP_FZF_FALLBACK:-0}" == "1" ]]; then
+        if [[ -n "${FPF_TEST_MOCKCMD_PATH:-}" && -n "${FPF_TEST_MOCK_BIN:-}" ]]; then
+            ln -sf "${FPF_TEST_MOCKCMD_PATH}" "${FPF_TEST_MOCK_BIN}/fzf"
+            return 0
+        fi
+        return 1
+    fi
+
+    asset_suffix="$(detect_fzf_release_asset)" || return 1
+    asset_url="$(resolve_fzf_release_url "${asset_suffix}")" || return 1
+    archive_file="$(mktemp "${SESSION_TMP_ROOT}/fzf-bootstrap.XXXXXX.tar.gz")"
+    install_dir="${SESSION_TMP_ROOT}/fzf-bootstrap/bin"
+
+    mkdir -p "${install_dir}"
+
+    if ! curl --silent --show-error --fail --location --output "${archive_file}" "${asset_url}"; then
+        rm -f "${archive_file}"
+        return 1
+    fi
+
+    if ! tar -xzf "${archive_file}" -C "${install_dir}"; then
+        rm -f "${archive_file}"
+        return 1
+    fi
+
+    rm -f "${archive_file}"
+    chmod +x "${install_dir}/fzf" 2>/dev/null || true
+    [[ -x "${install_dir}/fzf" ]] || return 1
+
+    PATH="${install_dir}:${PATH}"
+    export PATH
+    return 0
+}
+
 build_fzf_bootstrap_candidates() {
     local seen=""
     local manager
@@ -1074,7 +1298,7 @@ ensure_fzf() {
     local candidates=()
     local manager
 
-    if [[ "${FPF_TEST_FORCE_FZF_MISSING:-0}" != "1" ]] && command_exists fzf; then
+    if fzf_command_available; then
         return
     fi
 
@@ -1095,12 +1319,17 @@ ensure_fzf() {
     for manager in "${candidates[@]-}"; do
         log "Attempting fzf install with $(manager_label "${manager}")"
         if install_fzf_with_manager "${manager}"; then
-            if command_exists fzf; then
+            if fzf_command_available; then
                 return
             fi
         fi
     done
 
+    log "Package-manager bootstrap did not provide fzf. Trying release binary fallback."
+    if install_fzf_from_release_fallback && fzf_command_available; then
+        return
+    fi
+
     die "Failed to auto-install fzf. Install fzf manually and rerun."
 }
 
@@ -1317,6 +1546,7 @@ Action options:
   -R, --remove           Fuzzy-search installed packages and remove selected
   -U, --update           Run manager update/upgrade flow
   --refresh              Refresh manager package catalogs only
+  -y, --yes              Assume yes for confirmation prompts
   -v, --version          Print version and exit
   -h, --help             Show this help
 
@@ -1394,6 +1624,9 @@ parse_args() {
             --refresh)
                 ACTION="refresh"
                 ;;
+            -y|--yes)
+                ASSUME_YES="1"
+                ;;
             --feed-search)
                 ACTION="feed-search"
                 ;;
@@ -1570,6 +1803,7 @@ rank_display_rows_by_query() {
             }
         }
         {
+            mgr = lower($1)
             pkg = $2
             desc = $3
 
@@ -2241,23 +2475,101 @@ manager_installed_names() {
     manager_installed_entries "${manager}" | awk -F'\t' 'NF > 0 { print $1 }'
 }
 
+installed_cache_ttl_seconds() {
+    local ttl_seconds="${FPF_INSTALLED_CACHE_TTL:-300}"
+
+    if ! [[ "${ttl_seconds}" =~ ^[0-9]+$ ]]; then
+        ttl_seconds="300"
+    fi
+
+    printf "%s" "${ttl_seconds}"
+}
+
+installed_cache_fingerprint() {
+    local manager="$1"
+    local command_path=""
+    local extra_token=""
+
+    case "${manager}" in
+        apt)
+            command_path="$(command -v dpkg-query 2>/dev/null || printf "missing")"
+            ;;
+        dnf)
+            command_path="$(command -v dnf 2>/dev/null || printf "missing")"
+            ;;
+        pacman)
+            command_path="$(command -v pacman 2>/dev/null || printf "missing")"
+            ;;
+        zypper)
+            command_path="$(command -v zypper 2>/dev/null || printf "missing")"
+            ;;
+        emerge)
+            if command_exists qlist; then
+                command_path="$(command -v qlist 2>/dev/null || printf "missing")"
+                extra_token="|mode=qlist"
+            else
+                command_path="/var/db/pkg"
+                extra_token="|mode=vardb"
+            fi
+            ;;
+        brew)
+            command_path="$(command -v brew 2>/dev/null || printf "missing")"
+            ;;
+        winget)
+            command_path="$(command -v winget 2>/dev/null || printf "missing")"
+            ;;
+        choco)
+            command_path="$(command -v choco 2>/dev/null || printf "missing")"
+            ;;
+        scoop)
+            command_path="$(command -v scoop 2>/dev/null || printf "missing")"
+            ;;
+        snap)
+            command_path="$(command -v snap 2>/dev/null || printf "missing")"
+            ;;
+        flatpak)
+            command_path="$(command -v flatpak 2>/dev/null || printf "missing")"
+            ;;
+        npm)
+            command_path="$(command -v npm 2>/dev/null || printf "missing")"
+            ;;
+        bun)
+            command_path="$(command -v bun 2>/dev/null || printf "missing")"
+            if command_exists npm; then
+                extra_token="|npm=$(command -v npm 2>/dev/null || printf "missing")"
+            fi
+            ;;
+        *)
+            command_path="unknown"
+            ;;
+    esac
+
+    printf "%s|cmd=%s%s" "$(cache_fingerprint "${manager}" "" "installed")" "${command_path}" "${extra_token}"
+}
+
 manager_installed_names_cached() {
     local manager="$1"
     local output_file="$2"
     local cache_enabled="${FPF_DISABLE_INSTALLED_CACHE:-0}"
+    local cache_ttl_seconds
     local cache_key
     local cache_file
     local cache_fingerprint_value
+    local cached_fingerprint=""
 
     initialize_cache_root
 
     cache_key="$(cache_catalog_key "${manager}")"
     cache_file="$(cache_path_for_key "${cache_key}")"
-    cache_fingerprint_value="$(cache_fingerprint "${manager}" "" "installed")"
+    cache_ttl_seconds="$(installed_cache_ttl_seconds)"
+    cache_fingerprint_value="$(installed_cache_fingerprint "${manager}")"
 
     if [[ "${cache_enabled}" != "1" && -s "${cache_file}" ]]; then
-        cp "${cache_file}" "${output_file}"
-        return
+        cached_fingerprint="$(cache_meta_value_for_key "${cache_key}" "fingerprint" 2>/dev/null || true)"
+        if [[ "${cached_fingerprint}" == "${cache_fingerprint_value}" ]] && cache_is_fresh_with_ttl "${cache_key}" "${cache_ttl_seconds}"; then
+            cp "${cache_file}" "${output_file}"
+            return
+        fi
     fi
 
     manager_installed_names "${manager}" >"${output_file}" 2>/dev/null || true
@@ -2544,24 +2856,26 @@ send_fzf_listen_action() {
     payload_size="$(printf "%s" "${action_payload}" | wc -c | tr -d '[:space:]')"
 
     if command_exists curl; then
-        curl --silent --show-error --fail --max-time 2 \
+        if 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
+            "http://${host}:${port}" >/dev/null 2>&1; then
+            return 0
+        fi
     fi
 
     if command_exists nc; then
-        {
+        if {
             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
+        } | nc -w 2 "${host}" "${port}" >/dev/null 2>&1; then
+            return 0
+        fi
     fi
 
     if exec 9<>"/dev/tcp/${host}/${port}" 2>/dev/null; then
@@ -2653,265 +2967,49 @@ run_ipc_query_notify_action() {
     run_ipc_reload_action "${query}" || send_fzf_prompt_action "Search> " || true
 }
 
+manager_dispatch_action() {
+    local manager="$1"
+    local action="$2"
+    shift 2 || true
+    manager_execute_action "${manager}" "${action}" "$@"
+}
+
 manager_install() {
     local manager="$1"
     shift
-
-    case "${manager}" in
-        apt)
-            run_as_root apt-get install -y "$@"
-            ;;
-        dnf)
-            run_as_root dnf install -y "$@"
-            ;;
-        pacman)
-            run_as_root pacman -S --needed "$@"
-            ;;
-        zypper)
-            run_as_root zypper --non-interactive install --auto-agree-with-licenses "$@"
-            ;;
-        emerge)
-            run_as_root emerge --ask=n --verbose "$@"
-            ;;
-        brew)
-            brew install "$@"
-            ;;
-        winget)
-            local pkg
-            for pkg in "$@"; do
-                winget install --id "${pkg}" --exact --source winget --accept-package-agreements --accept-source-agreements --disable-interactivity
-            done
-            ;;
-        choco)
-            choco install "$@" -y
-            ;;
-        scoop)
-            scoop install "$@"
-            ;;
-        snap)
-            local pkg
-            for pkg in "$@"; do
-                run_as_root snap install "${pkg}" 2>/dev/null || run_as_root snap install --classic "${pkg}"
-            done
-            ;;
-        flatpak)
-            local pkg
-            for pkg in "$@"; do
-                flatpak install -y --user flathub "${pkg}" 2>/dev/null ||
-                    flatpak install -y --user "${pkg}" 2>/dev/null ||
-                    run_as_root flatpak install -y flathub "${pkg}" 2>/dev/null ||
-                    run_as_root flatpak install -y "${pkg}"
-            done
-            ;;
-        npm)
-            npm install -g "$@"
-            ;;
-        bun)
-            bun add -g "$@"
-            ;;
-    esac
+    manager_dispatch_action "${manager}" "install" "$@"
 }
 
 manager_remove() {
     local manager="$1"
     shift
-
-    case "${manager}" in
-        apt)
-            run_as_root apt-get remove -y "$@"
-            ;;
-        dnf)
-            run_as_root dnf remove -y "$@"
-            ;;
-        pacman)
-            run_as_root pacman -Rsn "$@"
-            ;;
-        zypper)
-            run_as_root zypper --non-interactive remove "$@"
-            ;;
-        emerge)
-            run_as_root emerge --ask=n --deselect "$@"
-            run_as_root emerge --ask=n --depclean "$@"
-            ;;
-        brew)
-            brew uninstall "$@"
-            ;;
-        winget)
-            local pkg
-            for pkg in "$@"; do
-                winget uninstall --id "${pkg}" --exact --source winget --disable-interactivity
-            done
-            ;;
-        choco)
-            choco uninstall "$@" -y
-            ;;
-        scoop)
-            scoop uninstall "$@"
-            ;;
-        snap)
-            run_as_root snap remove "$@"
-            ;;
-        flatpak)
-            flatpak uninstall -y --user "$@" 2>/dev/null || run_as_root flatpak uninstall -y "$@"
-            ;;
-        npm)
-            npm uninstall -g "$@"
-            ;;
-        bun)
-            bun remove --global "$@"
-            ;;
-    esac
+    manager_execute_action "${manager}" "remove" "$@"
 }
 
 manager_show_info() {
     local manager="$1"
     local package="$2"
-
-    case "${manager}" in
-        apt)
-            cat <(apt-cache show "${package}" 2>/dev/null) <(printf "\n") <(dpkg -L "${package}" 2>/dev/null)
-            ;;
-        dnf)
-            cat <(dnf info "${package}" 2>/dev/null) <(printf "\n") <(rpm -ql "${package}" 2>/dev/null)
-            ;;
-        pacman)
-            cat <(pacman -Qi "${package}" 2>/dev/null || pacman -Si "${package}" 2>/dev/null) <(printf "\n") <(pacman -Ql "${package}" 2>/dev/null)
-            ;;
-        zypper)
-            zypper --non-interactive info "${package}" 2>/dev/null
-            ;;
-        emerge)
-            emerge --search --color=n "${package}" 2>/dev/null
-            ;;
-        brew)
-            brew info "${package}" 2>/dev/null
-            ;;
-        winget)
-            winget show --id "${package}" --exact --source winget --accept-source-agreements --disable-interactivity 2>/dev/null
-            ;;
-        choco)
-            choco info "${package}" 2>/dev/null
-            ;;
-        scoop)
-            scoop info "${package}" 2>/dev/null
-            ;;
-        snap)
-            snap info "${package}" 2>/dev/null
-            ;;
-        flatpak)
-            flatpak info "${package}" 2>/dev/null || flatpak remote-info flathub "${package}" 2>/dev/null
-            ;;
-        npm)
-            npm view "${package}" 2>/dev/null
-            ;;
-        bun)
-            bun info "${package}" 2>/dev/null || npm view "${package}" 2>/dev/null
-            ;;
-    esac
+    manager_execute_action "${manager}" "show_info" "${package}"
 }
 
 manager_update() {
     local manager="$1"
-
-    case "${manager}" in
-        apt)
-            run_as_root apt-get update
-            run_as_root apt-get upgrade -y
-            ;;
-        dnf)
-            run_as_root dnf upgrade -y
-            ;;
-        pacman)
-            run_as_root pacman -Syu
-            ;;
-        zypper)
-            run_as_root zypper --non-interactive refresh
-            run_as_root zypper --non-interactive update
-            ;;
-        emerge)
-            run_as_root emerge --sync
-            run_as_root emerge --ask=n --update --deep --newuse @world
-            ;;
-        brew)
-            brew update
-            brew upgrade
-            ;;
-        winget)
-            winget upgrade --all --source winget --accept-package-agreements --accept-source-agreements --disable-interactivity
-            ;;
-        choco)
-            choco upgrade all -y
-            ;;
-        scoop)
-            scoop update
-            scoop update "*"
-            ;;
-        snap)
-            run_as_root snap refresh
-            ;;
-        flatpak)
-            flatpak update -y --user 2>/dev/null || run_as_root flatpak update -y
-            ;;
-        npm)
-            npm update -g
-            ;;
-        bun)
-            bun update --global
-            ;;
-    esac
+    manager_execute_action "${manager}" "update"
 }
 
 manager_refresh() {
     local manager="$1"
-
-    case "${manager}" in
-        apt)
-            run_as_root apt-get update
-            ;;
-        dnf)
-            run_as_root dnf makecache
-            ;;
-        pacman)
-            run_as_root pacman -Sy
-            ;;
-        zypper)
-            run_as_root zypper --non-interactive refresh
-            ;;
-        emerge)
-            run_as_root emerge --sync
-            ;;
-        brew)
-            brew update
-            ;;
-        winget)
-            winget source update --name winget --accept-source-agreements --disable-interactivity
-            ;;
-        choco)
-            choco source list --limit-output >/dev/null
-            ;;
-        scoop)
-            scoop update
-            ;;
-        snap)
-            run_as_root snap refresh --list
-            ;;
-        flatpak)
-            ensure_flatpak_flathub_remote >/dev/null 2>&1 || true
-            flatpak update -y --appstream --user 2>/dev/null || run_as_root flatpak update -y --appstream
-            ;;
-        npm)
-            npm cache verify
-            ;;
-        bun)
-            bun pm cache >/dev/null
-            ;;
-    esac
+    manager_execute_action "${manager}" "refresh"
 }
 
 confirm_action() {
     local prompt="$1"
     local reply=""
 
+    if assume_yes_enabled; then
+        return 0
+    fi
+
     printf "%s [y/N]: " "${prompt}" >&2
     read -r reply || true
 
@@ -2932,6 +3030,9 @@ run_fuzzy_selector() {
     local reload_cmd="${4:-}"
     local reload_ipc_cmd="${5:-}"
     local script_path="${BASH_SOURCE[0]}"
+    local quoted_script_path=""
+    local quoted_help_file=""
+    local quoted_kbinds_file=""
     local preview_cmd
     local fzf_shell
 
@@ -2939,7 +3040,11 @@ run_fuzzy_selector() {
         script_path="$(pwd)/${script_path}"
     fi
 
-    preview_cmd="FPF_SESSION_TMP_ROOT=$(printf '%q' "${SESSION_TMP_ROOT}") ${script_path} --preview-item --manager {1} -- {2}"
+    printf -v quoted_script_path "%q" "${script_path}"
+    printf -v quoted_help_file "%q" "${HELP_FILE}"
+    printf -v quoted_kbinds_file "%q" "${KBINDS_FILE}"
+
+    preview_cmd="FPF_SESSION_TMP_ROOT=$(printf '%q' "${SESSION_TMP_ROOT}") ${quoted_script_path} --preview-item --manager {1} -- {2}"
     if command_exists bash; then
         fzf_shell="bash"
     else
@@ -2961,8 +3066,8 @@ run_fuzzy_selector() {
         --margin="2%,1%,2%,1%" \
         --cycle \
         --tiebreak=begin,chunk,length \
-        --bind=ctrl-k:preview:"cat ${KBINDS_FILE}" \
-        --bind=ctrl-h:preview:"cat ${HELP_FILE}" \
+        --bind="ctrl-k:preview:cat ${quoted_kbinds_file}" \
+        --bind="ctrl-h:preview:cat ${quoted_help_file}" \
         --bind='ctrl-/:change-preview-window(hidden|)' \
         --bind=ctrl-n:next-selected,ctrl-b:prev-selected \
         --bind='focus:transform-preview-label:echo [{1}] {2}')
@@ -2999,6 +3104,7 @@ run_fuzzy_selector() {
 main() {
     ensure_tmp_root
     initialize_session_tmp_root
+    load_fpf_libraries
     if [[ -z "${FPF_SESSION_TMP_ROOT:-}" ]]; then
         trap cleanup_session_tmp_root EXIT
     fi

package/lib/fpf/manager-actions.sh

@@ -0,0 +1,330 @@
+manager_execute_action() {
+    local manager="$1"
+    local action="$2"
+    shift 2
+    local package=""
+    local pkg=""
+
+    case "${manager}" in
+        apt)
+            case "${action}" in
+                install)
+                    run_as_root apt-get install -y "$@"
+                    ;;
+                remove)
+                    run_as_root apt-get remove -y "$@"
+                    ;;
+                show_info)
+                    package="${1:-}"
+                    cat <(apt-cache show "${package}" 2>/dev/null) <(printf "\n") <(dpkg -L "${package}" 2>/dev/null)
+                    ;;
+                update)
+                    run_as_root apt-get update
+                    run_as_root apt-get upgrade -y
+                    ;;
+                refresh)
+                    run_as_root apt-get update
+                    ;;
+                *)
+                    return 1
+                    ;;
+            esac
+            ;;
+        dnf)
+            case "${action}" in
+                install)
+                    run_as_root dnf install -y "$@"
+                    ;;
+                remove)
+                    run_as_root dnf remove -y "$@"
+                    ;;
+                show_info)
+                    package="${1:-}"
+                    cat <(dnf info "${package}" 2>/dev/null) <(printf "\n") <(rpm -ql "${package}" 2>/dev/null)
+                    ;;
+                update)
+                    run_as_root dnf upgrade -y
+                    ;;
+                refresh)
+                    run_as_root dnf makecache
+                    ;;
+                *)
+                    return 1
+                    ;;
+            esac
+            ;;
+        pacman)
+            case "${action}" in
+                install)
+                    run_as_root pacman -S --needed "$@"
+                    ;;
+                remove)
+                    run_as_root pacman -Rsn "$@"
+                    ;;
+                show_info)
+                    package="${1:-}"
+                    cat <(pacman -Qi "${package}" 2>/dev/null || pacman -Si "${package}" 2>/dev/null) <(printf "\n") <(pacman -Ql "${package}" 2>/dev/null)
+                    ;;
+                update)
+                    run_as_root pacman -Syu
+                    ;;
+                refresh)
+                    run_as_root pacman -Sy
+                    ;;
+                *)
+                    return 1
+                    ;;
+            esac
+            ;;
+        zypper)
+            case "${action}" in
+                install)
+                    run_as_root zypper --non-interactive install --auto-agree-with-licenses "$@"
+                    ;;
+                remove)
+                    run_as_root zypper --non-interactive remove "$@"
+                    ;;
+                show_info)
+                    package="${1:-}"
+                    zypper --non-interactive info "${package}" 2>/dev/null
+                    ;;
+                update)
+                    run_as_root zypper --non-interactive refresh
+                    run_as_root zypper --non-interactive update
+                    ;;
+                refresh)
+                    run_as_root zypper --non-interactive refresh
+                    ;;
+                *)
+                    return 1
+                    ;;
+            esac
+            ;;
+        emerge)
+            case "${action}" in
+                install)
+                    run_as_root emerge --ask=n --verbose "$@"
+                    ;;
+                remove)
+                    run_as_root emerge --ask=n --deselect "$@"
+                    run_as_root emerge --ask=n --depclean "$@"
+                    ;;
+                show_info)
+                    package="${1:-}"
+                    emerge --search --color=n "${package}" 2>/dev/null
+                    ;;
+                update)
+                    run_as_root emerge --sync
+                    run_as_root emerge --ask=n --update --deep --newuse @world
+                    ;;
+                refresh)
+                    run_as_root emerge --sync
+                    ;;
+                *)
+                    return 1
+                    ;;
+            esac
+            ;;
+        brew)
+            case "${action}" in
+                install)
+                    brew install "$@"
+                    ;;
+                remove)
+                    brew uninstall "$@"
+                    ;;
+                show_info)
+                    package="${1:-}"
+                    brew info "${package}" 2>/dev/null
+                    ;;
+                update)
+                    brew update
+                    brew upgrade
+                    ;;
+                refresh)
+                    brew update
+                    ;;
+                *)
+                    return 1
+                    ;;
+            esac
+            ;;
+        winget)
+            case "${action}" in
+                install)
+                    for pkg in "$@"; do
+                        winget install --id "${pkg}" --exact --source winget --accept-package-agreements --accept-source-agreements --disable-interactivity
+                    done
+                    ;;
+                remove)
+                    for pkg in "$@"; do
+                        winget uninstall --id "${pkg}" --exact --source winget --disable-interactivity
+                    done
+                    ;;
+                show_info)
+                    package="${1:-}"
+                    winget show --id "${package}" --exact --source winget --accept-source-agreements --disable-interactivity 2>/dev/null
+                    ;;
+                update)
+                    winget upgrade --all --source winget --accept-package-agreements --accept-source-agreements --disable-interactivity
+                    ;;
+                refresh)
+                    winget source update --name winget --accept-source-agreements --disable-interactivity
+                    ;;
+                *)
+                    return 1
+                    ;;
+            esac
+            ;;
+        choco)
+            case "${action}" in
+                install)
+                    choco install "$@" -y
+                    ;;
+                remove)
+                    choco uninstall "$@" -y
+                    ;;
+                show_info)
+                    package="${1:-}"
+                    choco info "${package}" 2>/dev/null
+                    ;;
+                update)
+                    choco upgrade all -y
+                    ;;
+                refresh)
+                    choco source list --limit-output >/dev/null
+                    ;;
+                *)
+                    return 1
+                    ;;
+            esac
+            ;;
+        scoop)
+            case "${action}" in
+                install)
+                    scoop install "$@"
+                    ;;
+                remove)
+                    scoop uninstall "$@"
+                    ;;
+                show_info)
+                    package="${1:-}"
+                    scoop info "${package}" 2>/dev/null
+                    ;;
+                update)
+                    scoop update
+                    scoop update "*"
+                    ;;
+                refresh)
+                    scoop update
+                    ;;
+                *)
+                    return 1
+                    ;;
+            esac
+            ;;
+        snap)
+            case "${action}" in
+                install)
+                    for pkg in "$@"; do
+                        run_as_root snap install "${pkg}" 2>/dev/null || run_as_root snap install --classic "${pkg}"
+                    done
+                    ;;
+                remove)
+                    run_as_root snap remove "$@"
+                    ;;
+                show_info)
+                    package="${1:-}"
+                    snap info "${package}" 2>/dev/null
+                    ;;
+                update)
+                    run_as_root snap refresh
+                    ;;
+                refresh)
+                    run_as_root snap refresh --list
+                    ;;
+                *)
+                    return 1
+                    ;;
+            esac
+            ;;
+        flatpak)
+            case "${action}" in
+                install)
+                    for pkg in "$@"; do
+                        flatpak install -y --user flathub "${pkg}" 2>/dev/null ||
+                            flatpak install -y --user "${pkg}" 2>/dev/null ||
+                            run_as_root flatpak install -y flathub "${pkg}" 2>/dev/null ||
+                            run_as_root flatpak install -y "${pkg}"
+                    done
+                    ;;
+                remove)
+                    flatpak uninstall -y --user "$@" 2>/dev/null || run_as_root flatpak uninstall -y "$@"
+                    ;;
+                show_info)
+                    package="${1:-}"
+                    flatpak info "${package}" 2>/dev/null || flatpak remote-info flathub "${package}" 2>/dev/null
+                    ;;
+                update)
+                    flatpak update -y --user 2>/dev/null || run_as_root flatpak update -y
+                    ;;
+                refresh)
+                    ensure_flatpak_flathub_remote >/dev/null 2>&1 || true
+                    flatpak update -y --appstream --user 2>/dev/null || run_as_root flatpak update -y --appstream
+                    ;;
+                *)
+                    return 1
+                    ;;
+            esac
+            ;;
+        npm)
+            case "${action}" in
+                install)
+                    npm install -g "$@"
+                    ;;
+                remove)
+                    npm uninstall -g "$@"
+                    ;;
+                show_info)
+                    package="${1:-}"
+                    npm view "${package}" 2>/dev/null
+                    ;;
+                update)
+                    npm update -g
+                    ;;
+                refresh)
+                    npm cache verify
+                    ;;
+                *)
+                    return 1
+                    ;;
+            esac
+            ;;
+        bun)
+            case "${action}" in
+                install)
+                    bun add -g "$@"
+                    ;;
+                remove)
+                    bun remove --global "$@"
+                    ;;
+                show_info)
+                    package="${1:-}"
+                    bun info "${package}" 2>/dev/null || npm view "${package}" 2>/dev/null
+                    ;;
+                update)
+                    bun update --global
+                    ;;
+                refresh)
+                    bun pm cache >/dev/null
+                    ;;
+                *)
+                    return 1
+                    ;;
+            esac
+            ;;
+        *)
+            return 1
+            ;;
+    esac
+}

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "fpf-cli",
-  "version": "1.6.29",
+  "version": "1.6.31",
   "description": "Cross-platform fuzzy package finder powered by fzf",
   "bin": {
     "fpf": "fpf"
   },
   "files": [
     "fpf",
+    "lib/fpf/*.sh",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "fpf.png"
   ],
   "keywords": [
     "fzf",