fix(scripts): improve dedicated install scripts

- install_python.sh: rewrite for proper uv python management
- install_node.sh: add install_strategy.sh and refresh_snapshot
- install_ruby.sh: minor improvements

Author: CybotTM

scripts/install_node.sh

@@ -3,6 +3,7 @@ set -euo pipefail
 
 DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 . "$DIR/lib/common.sh"
+. "$DIR/lib/install_strategy.sh"
 
 ACTION="${1:-install}"
 # Channel: 'node' (current latest) or 'lts'. Default to 'node' to match audit latest
@@ -78,6 +79,8 @@ reconcile_node() {
   printf "[%s] before: %s\n" "node" "${before:-<none>}"
   printf "[%s] after:  %s\n"  "node" "${after:-<none>}"
   if [ -n "$path" ]; then printf "[%s] path:   %s\n" "node" "$path"; fi
+
+  refresh_snapshot "node"
 }
 
 case "$ACTION" in

scripts/install_python.sh

@@ -3,6 +3,7 @@ set -euo pipefail
 
 DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 . "$DIR/lib/common.sh"
+. "$DIR/lib/install_strategy.sh"
 
 ACTION="${1:-install}"
 
@@ -12,34 +13,45 @@ ensure_python_distro() {
   if ! have python3 && have apt-get; then sudo apt-get update && sudo apt-get install -y python3 python3-pip; fi
 }
 
+# Get current Python version managed by uv
+get_uv_python_version() {
+  if command -v uv >/dev/null 2>&1; then
+    # Get the highest installed Python version
+    uv python list --only-installed 2>/dev/null | grep -E "^cpython-[0-9]" | head -1 | sed 's/cpython-\([0-9.]*\).*/\1/' || true
+  fi
+}
+
+# Install or upgrade Python via uv
+uv_install_python() {
+  local PY_SPEC="${UV_PYTHON_SPEC:-3}"
+
+  echo "[python] Installing Python $PY_SPEC via uv..." >&2
+
+  # Install the requested Python version
+  if ! uv python install "$PY_SPEC" 2>&1; then
+    # If exact version fails, try without patch version
+    local ALT_SPEC="${PY_SPEC%.*}"
+    if [ "$ALT_SPEC" != "$PY_SPEC" ]; then
+      echo "[python] Trying $ALT_SPEC..." >&2
+      uv python install "$ALT_SPEC" 2>&1 || true
+    fi
+  fi
+}
+
 # Create/update a default dev venv using uv if available
 uv_setup_default_venv() {
   if command -v uv >/dev/null 2>&1; then
-    # Select Python spec: default to latest 3.x; allow override via UV_PYTHON_SPEC (e.g., 3.13)
-    local PY_SPEC
-    PY_SPEC="${UV_PYTHON_SPEC:-3}"
-    # If a fully pinned X.Y.Z isn't available, fall back to X.Y
-    local ALT_SPEC
-    ALT_SPEC="$PY_SPEC"
+    local PY_SPEC="${UV_PYTHON_SPEC:-3}"
+    local ALT_SPEC="$PY_SPEC"
     case "$PY_SPEC" in
       *.*.*) ALT_SPEC="${PY_SPEC%.*}" ;;
-      *) ALT_SPEC="$PY_SPEC" ;;
     esac
-    # Resolve the exact interpreter path, allowing pre-releases when stable is not yet available
+
+    # Find the interpreter
     local PY_PATH
-    PY_PATH="$(uv python find "$PY_SPEC" 2>/dev/null || true)"
-    if [ -z "$PY_PATH" ]; then
-      PY_PATH="$(uv python find "$ALT_SPEC" 2>/dev/null || true)"
-    fi
-    if [ -z "$PY_PATH" ]; then
-      uv python install "$PY_SPEC" >/dev/null 2>&1 || uv python install "$ALT_SPEC" >/dev/null 2>&1 || true
-      PY_PATH="$(uv python find "$PY_SPEC" 2>/dev/null || true)"
-      if [ -z "$PY_PATH" ]; then
-        PY_PATH="$(uv python find "$ALT_SPEC" 2>/dev/null || true)"
-      fi
-    fi
+    PY_PATH="$(uv python find "$PY_SPEC" 2>/dev/null || uv python find "$ALT_SPEC" 2>/dev/null || true)"
+
     mkdir -p "$HOME/.venvs" || true
-    # Recreate the default venv to ensure it uses the requested interpreter
     if [ -n "$PY_PATH" ] && [ -x "$PY_PATH" ]; then
       uv venv --python "$PY_PATH" --clear "$HOME/.venvs/dev" >/dev/null 2>&1 || true
     else
@@ -82,15 +94,39 @@ install_or_update_py_cli() {
 }
 
 install_py_stack() {
+  local before after path
+  before="$(get_uv_python_version)"
+
   ensure_uv || true
+  uv_install_python || true
   uv_setup_default_venv || true
   install_or_update_py_cli install
+
+  after="$(get_uv_python_version)"
+  path="$(command -v python3 2>/dev/null || true)"
+  printf "[%s] before: %s\n" "python" "${before:-<none>}"
+  printf "[%s] after:  %s\n" "python" "${after:-<none>}"
+  if [ -n "$path" ]; then printf "[%s] path:   %s\n" "python" "$path"; fi
+
+  refresh_snapshot "python"
 }
 
 update_py_stack() {
+  local before after path
+  before="$(get_uv_python_version)"
+
   ensure_uv || true
+  uv_install_python || true
   uv_setup_default_venv || true
   install_or_update_py_cli upgrade
+
+  after="$(get_uv_python_version)"
+  path="$(command -v python3 2>/dev/null || true)"
+  printf "[%s] before: %s\n" "python" "${before:-<none>}"
+  printf "[%s] after:  %s\n" "python" "${after:-<none>}"
+  if [ -n "$path" ]; then printf "[%s] path:   %s\n" "python" "$path"; fi
+
+  refresh_snapshot "python"
 }
 
 uninstall_py_tools() {
@@ -112,6 +148,4 @@ case "$ACTION" in
   *) echo "Usage: $0 {install|update|uninstall|reconcile}" ; exit 2 ;;
 esac
 
-echo "python: $ACTION complete (or attempted)."
-
 

scripts/install_ruby.sh

@@ -47,7 +47,19 @@ install_ruby() {
   fi
 
   echo "Installing Ruby $RUBY_VERSION via rbenv..."
-  rbenv install --skip-existing "$RUBY_VERSION" || true
+  if ! rbenv install --skip-existing "$RUBY_VERSION"; then
+    echo "[ruby] Error: Failed to install Ruby $RUBY_VERSION" >&2
+    echo "[ruby] You may need to install build dependencies:" >&2
+    echo "[ruby]   sudo apt install build-essential libssl-dev libreadline-dev zlib1g-dev libyaml-dev libffi-dev" >&2
+    return 1
+  fi
+
+  # Verify the version is actually installed before continuing
+  if ! rbenv versions --bare | grep -q "^${RUBY_VERSION}$"; then
+    echo "[ruby] Error: Ruby $RUBY_VERSION not found after install" >&2
+    return 1
+  fi
+
   rbenv global "$RUBY_VERSION" || true
   rbenv rehash || true