chore: release v1.11.0 — exec, run, ls-remote, resolve, unload, cache clear, tab completion, --no-use flag

Author: Thavarshan

CHANGELOG.md

@@ -2,6 +2,39 @@
 
 ## [Unreleased]
 
+## [v1.11.0](https://github.com/Thavarshan/phpvm/compare/v1.10.0...v1.11.0) - 2026-04-13
+
+### Added
+
+- **`exec` command:** Run a command with a specific PHP version without globally switching. Executes in a subshell to isolate PATH changes from the current shell. Usage: `phpvm exec <version> <command> [args...]`.
+- **`run` command:** Sugar for `phpvm exec <version> php <script>`. Usage: `phpvm run <version> [script] [args...]`.
+- **`ls-remote` command:** List available PHP versions from system package manager repositories (Homebrew, apt, dnf, yum, pacman). Supports optional pattern filtering (e.g., `phpvm ls-remote 8.2`).
+- **`resolve` command:** Resolve a version descriptor, alias, or keyword to a locally installed version number. Usage: `phpvm resolve <version|alias|keyword>`.
+- **`unload` command:** Remove phpvm from the current shell session — deactivates, removes cd hooks, unsets all phpvm functions and variables. Only works when sourced (matches nvm behaviour).
+- **`cache clear` command:** Clear the phpvm cache directory. Replaces the previous stub.
+- **`--no-use` flag on source:** `source phpvm.sh --no-use` loads functions without auto-switching or registering the cd hook. Useful for lazy-loading setups.
+- **Bash tab completion:** New `completions/phpvm.bash` file with context-aware completions for commands, installed versions, and alias names. Auto-sourced when phpvm is loaded.
+- **Auto-set `default` alias on first install:** When no `default` alias exists, the first `phpvm install` automatically sets it (matches nvm behaviour).
+- **`PHPVM_BIN` export:** After every version switch, `PHPVM_BIN` is exported with the active PHP binary directory. Unset on deactivate.
+- **XDG_CONFIG_HOME fallback:** `PHPVM_DIR` now respects `$XDG_CONFIG_HOME/phpvm` when `XDG_CONFIG_HOME` is set and `PHPVM_DIR` is not.
+
+### Fixed
+
+- **`hash -r` after version switch:** Added `command hash -r` to `switch_to_version_php()`, `switch_to_system_php()`, and `phpvm_deactivate()` to invalidate the bash command hash table. Prevents stale binary resolution after switching versions.
+- **`phpvm_current` uses `printf` instead of `echo`:** Consistent with project conventions; avoids potential `-n`/`-e` misinterpretation.
+- **Auto-default alias works in test mode:** The auto-default alias logic now fires for both real and mock installations.
+
+### Changed
+
+- **`list` output formatting:** Active version is marked with a `->` arrow prefix and green colouring. Versions matching the `default` alias show a `(default)` annotation.
+- **Help text updated:** Removed "Planned Features" section; all commands now shown as implemented with examples.
+
+### Internal
+
+- **Version bump:** Updated to v1.11.0.
+- **New tests:** 30 BATS tests covering exec, run, ls-remote, resolve, cache clear, list formatting, auto-default alias, and help text. Replaced 5 obsolete stub tests.
+- **All tests passing:** 78 BATS tests pass.
+
 ## [v1.10.0](https://github.com/Thavarshan/phpvm/compare/v1.9.4...v1.10.0) - 2026-03-28
 
 ### Added

completions/phpvm.bash

@@ -0,0 +1,80 @@
+#!/usr/bin/env bash
+# Bash/Zsh tab completion for phpvm
+# Source this file or place it in your completions directory
+
+_phpvm_completions() {
+    local cur prev commands
+    cur="${COMP_WORDS[COMP_CWORD]}"
+    prev="${COMP_WORDS[COMP_CWORD - 1]}"
+
+    commands="install uninstall use current which list ls ls-remote alias unalias exec run resolve cache deactivate system auto info version help unload"
+
+    case "$prev" in
+    use | uninstall | which | exec | run | resolve)
+        # Complete with installed versions + aliases
+        local versions=""
+        local phpvm_dir="${PHPVM_DIR:-$HOME/.phpvm}"
+
+        # Installed versions from active_version tracking
+        if [ -d "$phpvm_dir/alias" ]; then
+            local alias_file
+            for alias_file in "$phpvm_dir/alias"/*; do
+                [ -f "$alias_file" ] && versions="$versions ${alias_file##*/}"
+            done
+        fi
+
+        # Try to get installed versions from package manager
+        if command -v brew > /dev/null 2>&1; then
+            local formula
+            while IFS= read -r formula; do
+                local ver="${formula#php@}"
+                [ "$formula" = "php" ] && continue
+                versions="$versions $ver"
+            done < <(brew list --formula 2> /dev/null | command grep -E '^php(@[0-9]+\.[0-9]+)?$')
+        fi
+
+        versions="$versions system"
+        # shellcheck disable=SC2207  # Intentional: word splitting for COMPREPLY
+        COMPREPLY=($(compgen -W "$versions" -- "$cur"))
+        return
+        ;;
+    alias)
+        # Complete with alias subcommands or existing aliases
+        if [ "$COMP_CWORD" -eq 2 ]; then
+            # shellcheck disable=SC2207
+            COMPREPLY=($(compgen -W "default" -- "$cur"))
+        fi
+        return
+        ;;
+    unalias)
+        # Complete with existing alias names
+        local aliases=""
+        local phpvm_dir="${PHPVM_DIR:-$HOME/.phpvm}"
+        if [ -d "$phpvm_dir/alias" ]; then
+            local alias_file
+            for alias_file in "$phpvm_dir/alias"/*; do
+                [ -f "$alias_file" ] && aliases="$aliases ${alias_file##*/}"
+            done
+        fi
+        # shellcheck disable=SC2207
+        COMPREPLY=($(compgen -W "$aliases" -- "$cur"))
+        return
+        ;;
+    cache)
+        # shellcheck disable=SC2207
+        COMPREPLY=($(compgen -W "clear" -- "$cur"))
+        return
+        ;;
+    phpvm)
+        # shellcheck disable=SC2207
+        COMPREPLY=($(compgen -W "$commands" -- "$cur"))
+        return
+        ;;
+    esac
+
+    # Default: complete commands
+    # shellcheck disable=SC2207
+    COMPREPLY=($(compgen -W "$commands" -- "$cur"))
+}
+
+complete -F _phpvm_completions phpvm