docs/gpu-build-fix.json

{
  "date": "2026-09-08",
  "reported_gpu_commit": "8a6fdf7",
  "evidence": "User-supplied build-log PDF, page 17",
  "failure": "Exclusive cu128 dependency resolution rejected typing_extensions wheel metadata and could not find flit_core for source-build fallback.",
  "fix": {
    "pip": "25.3 from PyPI",
    "cuda": "torch/torchaudio 2.8.0+cu128 wheels only; no dependency resolution in CUDA-index step",
    "dependencies": "Complete pinned lock installed with dependencies enabled from PyPI; pip check; exact CUDA version assertion"
  },
  "checks": {
    "pip_cuda_target_dry_run": "passed: CPython 3.10 Linux x86_64, exactly two CUDA wheels",
    "pip_typing_extensions_target_dry_run": "passed: 4.16.0 PyPI wheel, no source build",
    "linux_python310_lock_resolution": "passed: uv pip compile against PyPI",
    "cuda_metadata_dependency_audit": "all 21 active Linux Torch dependencies match the full lock",
    "container_build": "not run locally; Docker unavailable",
    "gpu_inference": "not run",
    "remote_upload": "not performed"
  }
}