fix(guide): resolve upgrade detection and platform issues

- Fix false "version unchanged" warning when tool already at target
- Add is_wsl() helper to common.sh for platform detection
- Docker: skip 20s WSL wait, start service manually (no systemd)
- Ruby: update ruby-build definitions before installing new versions
- Compose: add requires dependency on docker for proper ordering

Author: CybotTM

catalog/compose.json

@@ -8,5 +8,6 @@
   "binary_name": "docker",
   "plugin_name": "compose",
   "version_command": "docker compose version 2>&1 | head -1",
+  "requires": ["docker"],
   "notes": "Docker Compose v2 is a plugin for Docker CLI. Can be installed separately as a plugin or bundled with Docker Desktop."
 }

scripts/guide.sh

@@ -237,11 +237,13 @@ process_tool() {
 
       # Check if upgrade succeeded by comparing versions
       local new_installed="$(json_field "$tool" installed)"
-      if [ "$upgrade_success" = "0" ] || [ "$new_installed" = "$installed" ]; then
-        # Upgrade failed or version didn't change
-        printf "
-    ⚠️  Upgrade did not succeed (version unchanged)
-"
+      if [ "$upgrade_success" = "0" ]; then
+        # Install script failed
+        printf "\n    ⚠️  Upgrade failed (install script error)\n"
+        prompt_pin_version "$tool" "$installed"
+      elif [ "$new_installed" = "$installed" ] && [ "$new_installed" != "$latest" ]; then
+        # Version didn't change and not at target
+        printf "\n    ⚠️  Upgrade did not succeed (version unchanged)\n"
         prompt_pin_version "$tool" "$installed"
       else
         # Upgrade succeeded - remove any existing pin to avoid stale pins
@@ -274,7 +276,10 @@ process_tool() {
 
       # Check if upgrade succeeded
       local new_installed_a="$(json_field "$tool" installed)"
-      if [ "$upgrade_success_a" = "0" ] || [ "$new_installed_a" = "$installed" ]; then
+      if [ "$upgrade_success_a" = "0" ]; then
+        printf "\n    ⚠️  Upgrade failed (install script error)\n"
+        printf "    Auto-update is still enabled - will try again next time.\n"
+      elif [ "$new_installed_a" = "$installed" ] && [ "$new_installed_a" != "$latest" ]; then
         printf "\n    ⚠️  Upgrade did not succeed (version unchanged)\n"
         printf "    Auto-update is still enabled - will try again next time.\n"
       else

scripts/install_docker.sh

@@ -12,7 +12,22 @@ if have apt-get; then
   echo "[docker] current: $(before)"
   # Remove legacy docker.io if present
   apt_purge_if_present docker.io docker-doc docker-compose podman-docker containerd runc || true
-  curl -fsSL https://get.docker.com | sh
+
+  if is_wsl; then
+    echo "[docker] WSL detected - installing Docker Engine (skipping 20s wait)..."
+    echo "[docker] Note: Docker Desktop for Windows is also available."
+    echo "[docker] See: https://docs.docker.com/desktop/wsl/"
+    # Download script and remove the sleep to skip 20-second wait
+    curl -fsSL https://get.docker.com -o /tmp/get-docker.sh
+    sed -i 's/sleep 20/sleep 0/' /tmp/get-docker.sh
+    sudo sh /tmp/get-docker.sh
+    rm -f /tmp/get-docker.sh
+    # Start service manually (no systemd in WSL)
+    sudo service docker start || echo "[docker] Run 'sudo service docker start' to start Docker"
+  else
+    curl -fsSL https://get.docker.com | sh
+  fi
+
   sudo usermod -aG docker "$USER" || true
   echo "[docker] updated: $(after)"
   exit 0

scripts/install_ruby.sh

@@ -8,6 +8,14 @@ ACTION="${1:-reconcile}"
 # Target Ruby version (default: latest stable)
 RUBY_VERSION="${RUBY_VERSION:-3.3.6}"
 
+update_ruby_build() {
+  local ruby_build_dir="$HOME/.rbenv/plugins/ruby-build"
+  if [ -d "$ruby_build_dir/.git" ]; then
+    echo "[ruby] Updating ruby-build definitions..."
+    git -C "$ruby_build_dir" pull --quiet || true
+  fi
+}
+
 ensure_rbenv() {
   if [ ! -d "$HOME/.rbenv" ]; then
     echo "Installing rbenv..."
@@ -19,6 +27,9 @@ ensure_rbenv() {
   if [ ! -d "$HOME/.rbenv/plugins/ruby-build" ]; then
     echo "Installing ruby-build plugin..."
     git clone https://github.com/rbenv/ruby-build.git "$HOME/.rbenv/plugins/ruby-build"
+  else
+    # Update ruby-build to get latest version definitions
+    update_ruby_build
   fi
 
   ensure_rbenv_loaded
@@ -35,7 +46,14 @@ ensure_rbenv_loaded() {
 get_latest_ruby_version() {
   ensure_rbenv
   # Get latest stable Ruby version from rbenv (MRI Ruby only, excludes jruby/mruby/truffleruby)
-  rbenv install --list 2>/dev/null | grep -E '^\s*[0-9]+\.[0-9]+\.[0-9]+$' | tail -1 | tr -d ' ' || echo "4.0.0"
+  local latest
+  latest=$(rbenv install --list 2>/dev/null | grep -E '^\s*[0-9]+\.[0-9]+\.[0-9]+$' | tail -1 | tr -d ' ')
+  if [ -z "$latest" ]; then
+    # Fallback to known stable version if list fails
+    echo "${RUBY_VERSION:-3.3.6}"
+  else
+    echo "$latest"
+  fi
 }
 
 install_ruby() {

scripts/lib/common.sh

@@ -82,4 +82,9 @@ prefers_rbenv_ruby() {
   is_path_under "$p" "$HOME/.rbenv" || return 1
 }
 
+# WSL detection
+is_wsl() {
+  grep -qi microsoft /proc/version 2>/dev/null
+}
+