Add .ruby-version/.nvmrc support and enhance UX warnings

Based on final code review feedback:

**Version File Management:**
- Create .ruby-version for rvm users (enables auto-switching on cd)
- Create .nvmrc for nvm users (enables auto-switching on cd)
- Maintains .tool-versions for mise/asdf users
- Allows users to leverage each manager's native auto-switching features

**Improved Version Matching:**
- Fix rvm version check to avoid partial matches (3.2.8 won't match 3.2.80)
- Use word boundaries in grep pattern for exact version matching

**Enhanced User Warnings:**
- Make subshell limitation warnings more explicit and prominent
- Explain WHY versions don't persist (subshell vs. parent shell)
- Provide clear, actionable steps with two distinct options:
  1. Open new terminal (recommended)
  2. Source shell config files (with exact commands)
- Show appropriate sourcing commands based on version manager

**Documentation:**
- Add warning about not mixing version managers (mise + rvm, etc.)
- Explain version manager priority (mise > asdf > rvm+nvm)
- Clarify potential confusion from using multiple managers

These changes make the script more user-friendly by enabling native
auto-switching features and setting much clearer expectations about
how version changes work with rvm/nvm.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: justin808

SWITCHING_CI_CONFIGS.md

@@ -95,7 +95,10 @@ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
 # Add to shell config (the installer usually does this automatically)
 ```
 
-**Note:** If you only have rvm (no nvm) or only nvm (no rvm), the script will detect this and provide helpful error messages guiding you to install the missing manager or switch to mise/asdf.
+**Important Notes:**
+
+- If you only have rvm (no nvm) or only nvm (no rvm), the script will detect this and provide helpful error messages guiding you to install the missing manager or switch to mise/asdf.
+- **Do not mix version managers** (e.g., don't install both mise and rvm). The script prioritizes mise > asdf > rvm+nvm, so mise/asdf will always take precedence. Using multiple managers can cause confusion about which versions are active.
 
 ## Detailed Usage
 

bin/ci-switch-config

@@ -65,7 +65,8 @@ set_ruby_version() {
     rvm|rvm+nvm)
       print_header "Setting Ruby $version with rvm"
       # Check if version exists using rvm list rubies for consistent output
-      if ! rvm list rubies | grep -qE "(ruby-)?${version}"; then
+      # Use word boundaries to avoid matching partial versions (e.g., 3.2.8 shouldn't match 3.2.80)
+      if ! rvm list rubies | grep -qE "(ruby-)?${version}([[:space:]]|$)"; then
         print_warning "Ruby $version not installed. Installing..."
         if ! rvm install "$version"; then
           print_error "Failed to install Ruby $version with rvm"
@@ -225,14 +226,29 @@ switch_to_minimum() {
   fi
 
   # Set Ruby and Node versions
-  if [[ "$VERSION_MANAGER" == "mise" ]] || [[ "$VERSION_MANAGER" == "asdf" ]]; then
-    print_header "Setting runtime versions in .tool-versions"
-    cat > "$PROJECT_ROOT/.tool-versions" <<EOF
+  case "$VERSION_MANAGER" in
+    mise|asdf)
+      print_header "Setting runtime versions in .tool-versions"
+      cat > "$PROJECT_ROOT/.tool-versions" <<EOF
 ruby 3.2.8
 nodejs 20.18.1
 EOF
-    print_success "Created .tool-versions with Ruby 3.2.8 and Node 20.18.1"
-  fi
+      print_success "Created .tool-versions with Ruby 3.2.8 and Node 20.18.1"
+      ;;
+    rvm|rvm+nvm)
+      print_header "Creating .ruby-version for rvm"
+      echo "3.2.8" > "$PROJECT_ROOT/.ruby-version"
+      print_success "Created .ruby-version with Ruby 3.2.8"
+      ;;
+  esac
+
+  case "$VERSION_MANAGER" in
+    nvm|rvm+nvm)
+      print_header "Creating .nvmrc for nvm"
+      echo "20.18.1" > "$PROJECT_ROOT/.nvmrc"
+      print_success "Created .nvmrc with Node 20.18.1"
+      ;;
+  esac
 
   set_ruby_version "3.2.8" "$VERSION_MANAGER"
   set_node_version "20.18.1" "$VERSION_MANAGER"
@@ -290,12 +306,19 @@ EOF
 
   case "$VERSION_MANAGER" in
     rvm+nvm|rvm|nvm)
-      print_warning "Note: Version changes only affect this script's subshell."
-      print_warning "You may need to open a new terminal or source your shell config."
+      print_warning "IMPORTANT: Version changes in this script don't persist to your current shell."
+      print_warning "The rvm/nvm commands run in a subshell and cannot affect your terminal."
+      echo ""
+      print_warning "Choose one of these options to activate the new versions:"
+      echo "  Option 1 (Recommended): Open a new terminal and cd into the project"
+      echo "  Option 2: Source your shell config:"
+      [ "$VERSION_MANAGER" = "rvm" ] || [ "$VERSION_MANAGER" = "rvm+nvm" ] && echo "    source ~/.rvm/scripts/rvm"
+      [ "$VERSION_MANAGER" = "nvm" ] || [ "$VERSION_MANAGER" = "rvm+nvm" ] && echo "    source \$NVM_DIR/nvm.sh"
+      echo ""
       ;;
   esac
 
-  print_warning "Run these commands to reload your shell and verify:"
+  print_warning "After activating versions, verify with:"
   echo "  cd $PROJECT_ROOT"
   case "$VERSION_MANAGER" in
     mise)
@@ -341,14 +364,29 @@ restore_to_latest() {
   fi
 
   # Set Ruby and Node versions
-  if [[ "$VERSION_MANAGER" == "mise" ]] || [[ "$VERSION_MANAGER" == "asdf" ]]; then
-    print_header "Setting runtime versions in .tool-versions"
-    cat > "$PROJECT_ROOT/.tool-versions" <<EOF
+  case "$VERSION_MANAGER" in
+    mise|asdf)
+      print_header "Setting runtime versions in .tool-versions"
+      cat > "$PROJECT_ROOT/.tool-versions" <<EOF
 ruby 3.4.3
 nodejs 22.12.0
 EOF
-    print_success "Created .tool-versions with Ruby 3.4.3 and Node 22.12.0"
-  fi
+      print_success "Created .tool-versions with Ruby 3.4.3 and Node 22.12.0"
+      ;;
+    rvm|rvm+nvm)
+      print_header "Creating .ruby-version for rvm"
+      echo "3.4.3" > "$PROJECT_ROOT/.ruby-version"
+      print_success "Created .ruby-version with Ruby 3.4.3"
+      ;;
+  esac
+
+  case "$VERSION_MANAGER" in
+    nvm|rvm+nvm)
+      print_header "Creating .nvmrc for nvm"
+      echo "22.12.0" > "$PROJECT_ROOT/.nvmrc"
+      print_success "Created .nvmrc with Node 22.12.0"
+      ;;
+  esac
 
   set_ruby_version "3.4.3" "$VERSION_MANAGER"
   set_node_version "22.12.0" "$VERSION_MANAGER"
@@ -406,12 +444,19 @@ EOF
 
   case "$VERSION_MANAGER" in
     rvm+nvm|rvm|nvm)
-      print_warning "Note: Version changes only affect this script's subshell."
-      print_warning "You may need to open a new terminal or source your shell config."
+      print_warning "IMPORTANT: Version changes in this script don't persist to your current shell."
+      print_warning "The rvm/nvm commands run in a subshell and cannot affect your terminal."
+      echo ""
+      print_warning "Choose one of these options to activate the new versions:"
+      echo "  Option 1 (Recommended): Open a new terminal and cd into the project"
+      echo "  Option 2: Source your shell config:"
+      [ "$VERSION_MANAGER" = "rvm" ] || [ "$VERSION_MANAGER" = "rvm+nvm" ] && echo "    source ~/.rvm/scripts/rvm"
+      [ "$VERSION_MANAGER" = "nvm" ] || [ "$VERSION_MANAGER" = "rvm+nvm" ] && echo "    source \$NVM_DIR/nvm.sh"
+      echo ""
       ;;
   esac
 
-  print_warning "Run these commands to reload your shell and verify:"
+  print_warning "After activating versions, verify with:"
   echo "  cd $PROJECT_ROOT"
   case "$VERSION_MANAGER" in
     mise)