[nihalpasham]

Summary

Update remaining references to a pinned nightly toolchain across the root README.md, umbrella docs/index.md, cuda-oxide-book, crate READMEs, and comments, and fix cargo oxide doctor step 1 so it does not reject stable rustc 1.99.1:

Before: README.md / docs/index.md / crate READMEs say "Pinned nightly";
        `cargo oxide doctor` fails step 1 with "expected nightly, got: rustc 1.99.1"
After:  Docs and comments reflect the pinned stable Rust toolchain (`1.99.1`);
        `cargo oxide doctor` passes step 1 and verifies the pin in step 2

Changes

• Root & umbrella documentation (README.md, docs/index.md, Cargo.toml, rust-toolchain.toml):
  • Update the "Picking a model" table, SIMT overview, and Contributing section from Pinned nightly to Pinned stable Rust (1.99.1), managed by cargo oxide.
• cuda-oxide book & crate READMEs:
  • Update appendix/building-from-source.md, gpu-programming/error-handling-and-debugging.md, crates/cargo-oxide/README.md, crates/cuda-oxide-codegen/README.md, and cute-rs-preview/{cute-rs,ctm-rs,cute-layout}/README.md.
• cargo oxide doctor (crates/cargo-oxide/src/commands/doctor.rs, src/backend.rs):
  • Drop the version.contains("nightly") gate in doctor step 1 (step 2's doctor_report_toolchain_pin already checks that the active toolchain matches rust-toolchain.toml and has all required components), and update the mismatch string in backend.rs.
• Comments (cuda-oxide/Cargo.toml, rustc-codegen-cuda/Cargo.toml, cuda-host/src/lib.rs, cuda-oxide-codegen/src/lib.rs, CI workflows, and scripts):
  • Replace leftover "pinned nightly" comments with "pinned toolchain".

Validation

• cargo run -p cargo-oxide -- doctor
• cargo test -p cargo-oxide
• just fmt-check
• just check-guards
• just book

Checklist

• All commits signed off (git commit -s)

Python reference environment (cute-rs examples and models)

One setup for every CuTeDSL comparison, the same three lines in each README:

cargo oxide toolchain install cutlass
python3 -m venv cute-rs-preview/.venv
cute-rs-preview/.venv/bin/pip install -r cute-rs-preview/requirements.txt

• cute-rs-preview/requirements.txt: shared pins for the DSL 4.7.0 family; the per-example requirements.txt files include it. The blockscale references keep their own DSL pins.
• Runners: one lookup order everywhere: --python where it exists, CUDA_OXIDE_CUTE_PYTHON, the example's .venv, the shared cute-rs-preview/.venv, then python3. The SM100 runners no longer look for the fp16_gemm venv; fp16_gemm's automatic setup now creates the shared environment.
• Fail fast: each compare.py checks for numpy, torch, cutlass and cuda before any GPU work and prints the setup commands instead of a traceback after the Rust build.
• READMEs: every example and model README names its setup inline; the Rust-only ones name cargo oxide toolchain install cutlass. The devcontainer installs python3-venv.

Validation: cargo fmt --check, cargo clippy --all-targets -- -D warnings and cargo test for the three edited example crates; python3 -m unittest public_reference.test_setup; the status-guard scripts.

[copy-pr-bot]

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.