deps: split ci_docgpu CPU/GPU depsets and regenerate locks #62595

Because you require torch-spline-conv==1.2.2+pt27cu128 and
torch-spline-conv==1.2.2+pt27cpu, your requirements are unsatisfiable.

 Step 1: Showing the conflicting wheels in docgpu requirements
==========================================

CPU variant (dl-cpu-requirements.txt):
--find-links https://data.pyg.org/whl/torch-2.7.0+cpu.html  # for CPU versions of torch-scatter, torch-sparse, torch-cluster, torch-spline-conv
torch-spline-conv==1.2.2

GPU variant (dl-gpu-requirements.txt):
--find-links https://data.pyg.org/whl/torch-2.7.0+cu128.html  # for GPU versions of torch-scatter, torch-sparse, torch-cluster, torch-spline-conv
torch-spline-conv==1.2.2+pt27cu128

Step 2: Attempting to compile docgpu depset
==========================================
Running: bazel run //ci/raydepsets:raydepsets -- build ci/raydepsets/configs/ci_docgpu.depsets.yaml

This should FAIL with conflict like:
  'Because you require torch-spline-conv==1.2.2+pt27cu128 and'
  'torch-spline-conv==1.2.2+pt27cpu, your requirements are unsatisfiable.'

............

Attempting compile...



No solution found when resolving dependencies:
  ╰─▶ Because you require torch-spline-conv==1.2.2+pt27cu128 and
      torch-spline-conv==1.2.2+pt27cpu, we can conclude that your requirements
      are unsatisfiable.

#!/bin/bash
# Reproduce the torch-spline-conv conflict error in docgpu depset
# This script demonstrates the problem before the fix

set -e

echo "========================================"
echo "Reproducing torch-spline-conv conflict"
echo "========================================"
echo ""
echo "The issue: docgpu tries to merge CPU and GPU PyTorch wheels"
echo "in a SINGLE depset, which creates an unsolvable conflict."
echo ""

if [ ! -f "ci/raydepsets/configs/ci_docgpu.depsets.yaml" ]; then
  echo "ERROR: Must run from ray repository root"
  exit 1
fi

if [ ! -d "/tmp/ray-deps" ]; then
  echo "ERROR: /tmp/ray-deps not found (needed for constraint file)"
  echo "This script requires the ray-deps directory with requirements_compiled_py3.13.txt"
  exit 1
fi

echo "Step 1: Showing the conflicting wheels in docgpu requirements"
echo "=========================================="
echo ""
echo "CPU variant (dl-cpu-requirements.txt):"
grep "torch-spline-conv" python/requirements/ml/py313/dl-cpu-requirements.txt || echo "  (not found)"
echo ""
echo "GPU variant (dl-gpu-requirements.txt):"
grep "torch-spline-conv" python/requirements/ml/py313/dl-gpu-requirements.txt || echo "  (not found)"
echo ""

echo "Step 2: Attempting to compile docgpu depset"
echo "=========================================="
echo "Running: bazel run //ci/raydepsets:raydepsets -- build ci/raydepsets/configs/ci_docgpu.depsets.yaml"
echo ""
echo "This should FAIL with a conflict error like:"
echo "  'Because you require torch-spline-conv==1.2.2+pt27cu128 and'"
echo "  'torch-spline-conv==1.2.2+pt27cpu, your requirements are unsatisfiable.'"
echo ""
echo "Attempting compile (first 100 lines of output)..."
echo "=========================================="
echo ""

if ! command -v bazel &> /dev/null; then
  echo "bazel not found - skipping compilation test"
  echo "Install bazel to see the full error"
else
  bazel run //ci/raydepsets:raydepsets -- build ci/raydepsets/configs/ci_docgpu.depsets.yaml 2>&1 | head -100
fi

echo ""
echo "=========================================="
echo "✓ Error reproduced!"
echo "=========================================="
echo ""
echo "The conflict occurs because:"
echo "  - dl-cpu-requirements.txt requires: torch-spline-conv==1.2.2 (plain)"
echo "  - dl-gpu-requirements.txt requires: torch-spline-conv==1.2.2+pt27cu128 (CUDA)"
echo "  - Single depset tries to resolve BOTH in one index → impossible"
echo ""
echo "Solution: Split into two depsets with separate indices:"
echo "  - ci_docgpu_cpu_depset: --index https://download.pytorch.org/whl/cpu"
echo "  - ci_docgpu_gpu_depset: --index https://download.pytorch.org/whl/cu128"
echo ""