chore(mise): update configs and add cleanup script documentation

Update tooling configs, shell settings, and editor configurations
as part of the mise migration. Add companion documentation for the
cleanup-old-version-managers script and remove unused fish completions.

config/exports

@@ -18,7 +18,11 @@
 [ -z "${EDITOR:-}" ] && export EDITOR="nvim"
 [ -z "${VISUAL:-}" ] && export VISUAL="code"
 
-export PATH="$XDG_BIN_HOME:$DOTFILES/local/bin:$XDG_DATA_HOME/cargo/bin:/opt/homebrew/bin:/usr/local/bin:$PATH"
+# Bootstrap: ensure local/bin is on PATH so x-path is available
+PATH="$DOTFILES/local/bin:$PATH"
+# Use x-path to deduplicate PATH entries
+PATH="$(x-path prepend "$XDG_BIN_HOME" "$DOTFILES/local/bin" "$XDG_DATA_HOME/cargo/bin" "/opt/homebrew/bin" "/usr/local/bin")"
+export PATH
 
 if ! command -v msg &> /dev/null; then
   # Function to print messages if VERBOSE is enabled

config/fish/alias.fish

@@ -114,9 +114,10 @@ end
 # cd to git root directory
 function cdgr --description 'cd to git root'
     if git rev-parse --is-inside-work-tree &>/dev/null
-        cd (git rev-parse --show-toplevel)
+        cd (git rev-parse --show-toplevel); or return $status
     else
         echo >&2 "Not in a git repository"
+        return 1
     end
 end
 

config/fish/completions/kubectl.fish

@@ -1 +0,0 @@
-/Applications/OrbStack.app/Contents/MacOS/../Resources/completions/fish/kubectl.fish

config/fish/completions/orbctl.fish

@@ -1 +0,0 @@
-/Applications/OrbStack.app/Contents/MacOS/../Resources/completions/fish/orbctl.fish

config/mise/config.toml

@@ -12,7 +12,7 @@ rust = "stable"
 "ubi:ClementTsang/bottom" = "latest"
 "ubi:ajeetdsouza/zoxide" = "latest"
 "ubi:tree-sitter/tree-sitter" = "latest"
-"ubi:neovim/neovim" = "latest"
+"ubi:neovim/neovim" = "latest" # Neovim editor binary
 "ubi:dandavison/delta" = "latest"
 
 # Cargo-based tools (no pre-built binary available)
@@ -32,7 +32,7 @@ rust = "stable"
 # npm-based tools
 "npm:editorconfig-checker" = "latest"
 "npm:github-release-notes" = "latest"
-"npm:neovim" = "latest"
+"npm:neovim" = "latest" # Node.js client for Neovim's RPC API (required by plugins)
 "npm:corepack" = "latest"
 
 # Python tools (via pipx backend)

config/nvim/lua/utils.lua

@@ -102,4 +102,4 @@ function GetIntelephenseLicense()
   f:close()
   local stripped = string.gsub(content, '%s+', '')
   return stripped == '' and nil or stripped
-end
+end

config/vim/vimrc

@@ -5,7 +5,7 @@
 " vint: +ProhibitAbbreviationOption +ProhibitSetNoCompatible
 
 " mise — add shims to PATH for tool discovery
-let $PATH = $HOME . '/.local/share/mise/shims:' . $PATH
+let $PATH = $HOME . '/.local/bin:' . $HOME . '/.local/share/mise/shims:' . $PATH
 "*****************************************************************************
 "" Vim-Plug core
 "*****************************************************************************

config/zsh/p10k.zsh

@@ -61,7 +61,7 @@
     vcs                       # git status
     # command_execution_time    # previous command duration
     go
-    mise
+    asdf
     aws
     # =========================[ Line #2 ]=========================
     newline                   # \n