fpf-cli 1.6.25 → 1.6.27

package/README.md

@@ -30,6 +30,9 @@ fpf -R
 
 # Update packages
 fpf -U
+
+# Refresh package catalogs only
+fpf --refresh
 ```
 
 By default, `fpf` auto-detects your package manager.
@@ -70,6 +73,7 @@ Live reload is enabled by default, with a minimum query length and debounce to r
 - `-l, --list-installed` list installed packages
 - `-R, --remove` remove selected packages
 - `-U, --update` run update/upgrade flow
+- `--refresh` refresh package catalogs only
 - `-v, --version` print version and exit
 - `-h, --help` show help
 
@@ -88,6 +92,7 @@ Installed packages are marked with `*` in the result list.
 - Requires: `bash` + `fzf`
 - If `fzf` is missing, `fpf` auto-installs it using a compatible detected manager.
 - 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.
 - `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.

package/fpf

@@ -3,7 +3,7 @@
 set -euo pipefail
 
 SCRIPT_NAME="fpf"
-SCRIPT_VERSION="1.6.25"
+SCRIPT_VERSION="1.6.27"
 TMP_ROOT="${TMPDIR:-/tmp}/fpf"
 SESSION_TMP_ROOT=""
 HELP_FILE=""
@@ -834,6 +834,50 @@ flatpak_has_any_remotes() {
     return 1
 }
 
+flatpak_has_flathub_remote() {
+    if ! manager_command_ready flatpak; then
+        return 1
+    fi
+
+    if flatpak remotes --columns=name 2>/dev/null | awk '{
+        name=tolower($1)
+        if (name == "flathub") {
+            found=1
+            exit
+        }
+    } END { exit (found ? 0 : 1) }'; then
+        return 0
+    fi
+
+    if flatpak remote-list --columns=name 2>/dev/null | awk '{
+        name=tolower($1)
+        if (name == "flathub") {
+            found=1
+            exit
+        }
+    } END { exit (found ? 0 : 1) }'; then
+        return 0
+    fi
+
+    return 1
+}
+
+ensure_flatpak_flathub_remote() {
+    if ! manager_command_ready flatpak; then
+        return 1
+    fi
+
+    if flatpak_has_flathub_remote; then
+        return 0
+    fi
+
+    flatpak remote-add --if-not-exists --user flathub https://flathub.org/repo/flathub.flatpakrepo 2>/dev/null ||
+        run_as_root flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo 2>/dev/null ||
+        return 1
+
+    flatpak_has_flathub_remote
+}
+
 winget_has_default_source() {
     if ! manager_command_ready winget; then
         return 1
@@ -909,7 +953,10 @@ manager_no_query_setup_message() {
 
     case "${manager}" in
         flatpak)
-            if ! flatpak_has_any_remotes; then
+            if ! flatpak_has_flathub_remote; then
+                ensure_flatpak_flathub_remote >/dev/null 2>&1 || true
+            fi
+            if ! flatpak_has_flathub_remote; then
                 printf "%s" "Flatpak has no remotes configured. Add Flathub with: flatpak remote-add --if-not-exists --user flathub https://flathub.org/repo/flathub.flatpakrepo"
                 return 0
             fi
@@ -1269,6 +1316,7 @@ Action options:
   -l, --list-installed   Fuzzy-search installed packages and show details
   -R, --remove           Fuzzy-search installed packages and remove selected
   -U, --update           Run manager update/upgrade flow
+  --refresh              Refresh manager package catalogs only
   -v, --version          Print version and exit
   -h, --help             Show this help
 
@@ -1343,6 +1391,9 @@ parse_args() {
             -U|--update)
                 ACTION="update"
                 ;;
+            --refresh)
+                ACTION="refresh"
+                ;;
             --feed-search)
                 ACTION="feed-search"
                 ;;
@@ -1877,6 +1928,7 @@ manager_search_entries_uncached() {
                 '
             ;;
         flatpak)
+            ensure_flatpak_flathub_remote >/dev/null 2>&1 || true
             if [[ -z "${effective_query}" ]]; then
                 {
                     flatpak remote-ls --app --columns=application,description flathub 2>/dev/null ||
@@ -1926,6 +1978,7 @@ manager_search_entries() {
     local query="$2"
     local query_cache_enabled="${FPF_ENABLE_QUERY_CACHE:-0}"
     local bun_cache_ttl="${FPF_BUN_QUERY_CACHE_TTL:-900}"
+    local bypass_query_cache="${FPF_BYPASS_QUERY_CACHE:-0}"
     local flags
     local key
     local fingerprint
@@ -1942,15 +1995,22 @@ manager_search_entries() {
         bun_cache_ttl=900
     fi
 
-    if [[ "${manager}" == "bun" ]]; then
-        query_cache_enabled="1"
-    fi
+    case "${bypass_query_cache}" in
+        1|true|yes|on)
+            query_cache_enabled="0"
+            ;;
+        *)
+            if [[ "${manager}" == "bun" ]]; then
+                query_cache_enabled="1"
+            fi
+            ;;
+    esac
 
     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 [[ "${manager}" == "bun" && "${query_cache_enabled}" == "1" && ( "${ACTION}" == "feed-search" || "${ACTION}" == "ipc-query-notify" ) ]]; then
         if [[ -s "${cache_file}" ]]; then
             cache_emit_query_rows_if_valid "${cache_file}" || true
         fi
@@ -2367,9 +2427,9 @@ 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 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}"
+        printf 'q={q}; if [ ${#q} -lt %s ]; then cat %q; else sleep %s; FPF_SKIP_INSTALLED_MARKERS=1 FPF_BYPASS_QUERY_CACHE=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}"
+        printf 'q={q}; if [ ${#q} -lt %s ]; then cat %q; else sleep %s; FPF_SKIP_INSTALLED_MARKERS=1 FPF_BYPASS_QUERY_CACHE=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
 }
 
@@ -2399,9 +2459,9 @@ build_dynamic_reload_command_for_query() {
     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}"
+        printf 'sleep %s; FPF_SKIP_INSTALLED_MARKERS=1 FPF_BYPASS_QUERY_CACHE=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}"
+        printf 'sleep %s; FPF_SKIP_INSTALLED_MARKERS=1 FPF_BYPASS_QUERY_CACHE=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
 }
 
@@ -2783,6 +2843,53 @@ manager_update() {
     esac
 }
 
+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
+}
+
 confirm_action() {
     local prompt="$1"
     local reply=""
@@ -2846,11 +2953,13 @@ run_fuzzy_selector() {
         fzf_args+=(--listen=0)
         fzf_args+=(--bind="change:execute-silent:${reload_ipc_cmd}")
         if [[ -n "${reload_cmd}" ]]; then
-            fzf_args+=(--bind="ctrl-r:reload:${reload_cmd}")
+            fzf_args+=(--bind="ctrl-r:change-prompt(Loading> )+reload:${reload_cmd}")
+            fzf_args+=(--bind="result:change-prompt(Search> )")
         fi
     elif [[ -n "${reload_cmd}" ]]; then
-        fzf_args+=(--bind="change:reload:${reload_cmd}")
-        fzf_args+=(--bind="ctrl-r:reload:${reload_cmd}")
+        fzf_args+=(--bind="change:change-prompt(Loading> )+reload:${reload_cmd}")
+        fzf_args+=(--bind="ctrl-r:change-prompt(Loading> )+reload:${reload_cmd}")
+        fzf_args+=(--bind="result:change-prompt(Search> )")
     fi
 
     if [[ -n "${fzf_shell}" ]]; then
@@ -2977,6 +3086,18 @@ main() {
         exit 0
     fi
 
+    if [[ "${ACTION}" == "refresh" ]]; then
+        if confirm_action "Refresh package catalogs for ${manager_display}?"; then
+            for manager in "${managers[@]-}"; do
+                log "Refreshing catalogs with $(manager_label "${manager}")"
+                manager_refresh "${manager}"
+            done
+        else
+            log "Refresh canceled"
+        fi
+        exit 0
+    fi
+
     local display_file
     display_file="$(mktemp "${SESSION_TMP_ROOT}/display.XXXXXX")"
     : >"${display_file}"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fpf-cli",
-  "version": "1.6.25",
+  "version": "1.6.27",
   "description": "Cross-platform fuzzy package finder powered by fzf",
   "bin": {
     "fpf": "fpf"