node-version-bridge 0.5.0 → 0.6.1

package/README.md

@@ -31,7 +31,24 @@ Aliases like `lts/*`, `lts/iron`, `node`, `stable`, and `latest` are automatical
 
 ## Installation
 
-### Quick install (recommended)
+### npm (recommended)
+
+```bash
+npm install -g node-version-bridge
+nvb setup
+```
+
+This installs the `nvb` command globally and configures the shell hook automatically.
+
+### GitHub Releases
+
+Download the latest release from [GitHub Releases](https://github.com/Marcosreuquen/node-version-bridge/releases), extract it, and run:
+
+```bash
+bash install.sh
+```
+
+### From source
 
 ```bash
 git clone https://github.com/marcosreuquen/node-version-bridge.git
@@ -58,13 +75,13 @@ Then add the hook to your shell config:
 **Zsh** — add to `~/.zshrc`:
 
 ```bash
-source /path/to/node-version-bridge/hooks/nvb.zsh
+eval "$(nvb init zsh)"
 ```
 
 **Bash** — add to `~/.bashrc`:
 
 ```bash
-source /path/to/node-version-bridge/hooks/nvb.bash
+eval "$(nvb init bash)"
 ```
 
 ### Verify installation
@@ -87,13 +104,16 @@ This removes installed files, the shell hook from your config, and the cache.
 
 ### Manual
 
-1. Remove the `source ...nvb.zsh` (or `nvb.bash`) line from your `.zshrc`/`.bashrc`
+1. Remove the nvb lines from your `.zshrc`/`.bashrc` (`eval "$(nvb init ...)"` or `source ...nvb.zsh`/`nvb.bash`)
 2. Delete the install directory: `rm -rf ~/.local/share/nvb`
 3. Optional — delete the cache: `rm -rf ~/.cache/node-version-bridge`
 
 ## Usage
 
 ```bash
+# Configure shell hook (run once after install)
+nvb setup
+
 # Show resolved version vs active version
 nvb current
 
@@ -156,18 +176,8 @@ bash test/run.sh
 - No need to commit manager-specific files when `.nvmrc`/`.node-version` already exists.
 - Works with any popular Node version manager.
 
----
-
-## Documentation
-
-- [Product concept](./docs/concept.md)
-- [Technical design](./docs/technical-design.md)
-- [Roadmap](./docs/roadmap.md)
-- [Implementation plan](./docs/implementation-plan.md)
-- [Changelog](./CHANGELOG.md)
-
 ## Status
 
-v0.5.0 — partial version resolution for asdf/mise, config file support, and auto-install. See [Changelog](./CHANGELOG.md).
+v0.6.1 — automatic shell hook setup, `nvb setup` and `nvb init` commands. See [Changelog](./CHANGELOG.md).
 
 **[Full Documentation](https://marcosreuquen.github.io/node-version-bridge/)**

package/bin/nvb

@@ -5,7 +5,7 @@
 
 set -euo pipefail
 
-NVB_VERSION="0.5.0"
+NVB_VERSION="0.6.1"
 
 # Resolve script location (handles symlinks on macOS/Linux)
 _nvb_resolve_root() {
@@ -46,8 +46,8 @@ nvb_cmd_refresh() {
     return 0
   fi
 
-  # Check cache — skip if nothing changed
-  if nvb_cache_is_current "$PWD" "$resolved_version" "$resolved_source"; then
+  # Check cache — skip if nothing changed (bypass with NVB_FORCE_REFRESH=1)
+  if [[ "${NVB_FORCE_REFRESH:-}" != "1" ]] && nvb_cache_is_current "$PWD" "$resolved_version" "$resolved_source"; then
     nvb_log debug "Cache hit: ${resolved_version} from ${resolved_source}"
     return 0
   fi
@@ -230,6 +230,94 @@ nvb_cmd_config() {
   esac
 }
 
+nvb_cmd_init() {
+  local shell_name="${1:-}"
+
+  if [[ -z "$shell_name" ]]; then
+    # Auto-detect from parent shell
+    shell_name="$(basename "${SHELL:-}")"
+  fi
+
+  case "$shell_name" in
+    zsh)
+      cat <<'HOOK'
+_nvb_hook() {
+  [[ "${_NVB_LAST_DIR:-}" == "$PWD" ]] && return
+  _NVB_LAST_DIR="$PWD"
+  eval "$(nvb refresh 2>/dev/null)"
+}
+autoload -U add-zsh-hook
+add-zsh-hook chpwd _nvb_hook
+eval "$(NVB_FORCE_REFRESH=1 nvb refresh 2>/dev/null)"
+_NVB_LAST_DIR="$PWD"
+HOOK
+      ;;
+    bash)
+      cat <<'HOOK'
+_nvb_hook() {
+  [[ "${_NVB_LAST_DIR:-}" == "$PWD" ]] && return
+  _NVB_LAST_DIR="$PWD"
+  eval "$(nvb refresh 2>/dev/null)"
+}
+if [[ ";${PROMPT_COMMAND:-};" != *";_nvb_hook;"* ]]; then
+  PROMPT_COMMAND="_nvb_hook;${PROMPT_COMMAND:-}"
+fi
+eval "$(NVB_FORCE_REFRESH=1 nvb refresh 2>/dev/null)"
+_NVB_LAST_DIR="$PWD"
+HOOK
+      ;;
+    *)
+      echo "Unknown shell: ${shell_name}. Supported: zsh, bash" >&2
+      return 1
+      ;;
+  esac
+}
+
+nvb_cmd_setup() {
+  local shell_name
+  shell_name="$(basename "${SHELL:-}")"
+
+  if [[ "$shell_name" != "zsh" && "$shell_name" != "bash" ]]; then
+    echo "[nvb] Could not detect shell (got: ${shell_name}). Supported: zsh, bash" >&2
+    echo "[nvb] Add manually to your shell config:" >&2
+    # shellcheck disable=SC2016
+    echo '  eval "$(nvb init zsh)"   # for zsh' >&2
+    # shellcheck disable=SC2016
+    echo '  eval "$(nvb init bash)"  # for bash' >&2
+    return 1
+  fi
+
+  local rc_file
+  case "$shell_name" in
+    zsh)  rc_file="${ZDOTDIR:-$HOME}/.zshrc" ;;
+    bash) rc_file="$HOME/.bashrc" ;;
+  esac
+
+  # shellcheck disable=SC2016
+  local hook_line='eval "$(nvb init '"${shell_name}"')"'
+  local marker="# node-version-bridge:hook"
+
+  # Check if already configured (new or legacy format)
+  if [[ -f "$rc_file" ]]; then
+    if grep -qF "nvb init" "$rc_file" || grep -qF "$marker" "$rc_file"; then
+      echo "[nvb] Shell hook already configured in ${rc_file}"
+      return 0
+    fi
+  fi
+
+  echo "[nvb] Adding shell hook to ${rc_file}..."
+  {
+    echo ""
+    echo "$marker"
+    echo "$hook_line"
+  } >> "$rc_file"
+
+  echo "[nvb] Done! Restart your shell or run:"
+  echo ""
+  echo "  source ${rc_file}"
+  echo ""
+}
+
 nvb_cmd_help() {
   cat <<EOF
 node-version-bridge v${NVB_VERSION}
@@ -240,6 +328,8 @@ using your preferred version manager.
 Usage: nvb <command> [options]
 
 Commands:
+  setup       Auto-configure shell hook (run once after install)
+  init        Output shell hook code for eval (used in shell config)
   refresh     Detect version and output shell commands to apply it (for eval)
   current     Show resolved version, source, and active Node version
   doctor      Check available managers and configuration
@@ -257,9 +347,10 @@ Config examples:
 Supported version files: .nvmrc, .node-version, .tool-versions, package.json (engines.node)
 Supported managers: nvm, fnm, mise, asdf, n
 
-Shell integration (add to your shell config):
-  Zsh:   source <path-to-nvb>/hooks/nvb.zsh
-  Bash:  source <path-to-nvb>/hooks/nvb.bash
+Shell integration:
+  nvb setup                    Auto-configure (recommended, run once)
+  eval "$(nvb init zsh)"       Manual — add to ~/.zshrc
+  eval "$(nvb init bash)"      Manual — add to ~/.bashrc
 
 Environment variables:
   NVB_MANAGER          Force a specific version manager (nvm, fnm, mise, asdf, n)
@@ -276,6 +367,8 @@ EOF
 # --- Main dispatch ---
 
 case "${1:-help}" in
+  setup)       nvb_cmd_setup ;;
+  init)        shift; nvb_cmd_init "$@" ;;
   refresh)     nvb_cmd_refresh ;;
   current)     nvb_cmd_current ;;
   doctor)      nvb_cmd_doctor ;;

package/hooks/nvb.bash

@@ -16,3 +16,7 @@ _nvb_hook() {
 if [[ ";${PROMPT_COMMAND:-};" != *";_nvb_hook;"* ]]; then
   PROMPT_COMMAND="_nvb_hook;${PROMPT_COMMAND:-}"
 fi
+
+# Force refresh on shell start (cache may be stale from previous session)
+eval "$(NVB_FORCE_REFRESH=1 "${_NVB_BIN}" refresh 2>/dev/null)"
+_NVB_LAST_DIR="$PWD"

package/hooks/nvb.zsh

@@ -15,5 +15,6 @@ _nvb_hook() {
 autoload -U add-zsh-hook
 add-zsh-hook chpwd _nvb_hook
 
-# Run once on shell start
-_nvb_hook
+# Force refresh on shell start (cache may be stale from previous session)
+eval "$(NVB_FORCE_REFRESH=1 "${_NVB_BIN}" refresh 2>/dev/null)"
+_NVB_LAST_DIR="$PWD"

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "node-version-bridge",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "Detect Node.js version from project files and apply it via any version manager",
   "bin": {
     "nvb": "bin/nvb"
   },
+  "scripts": {
+    "postinstall": "echo '\\n  Run \"nvb setup\" to configure your shell hook.\\n'"
+  },
   "files": [
     "bin/",
     "lib/",