Skip to content

chore(cuda-oxide): update flake.lock for 1.99.1, scaffold config, and clean up docs - #1616

Merged
nihalpasham merged 1 commit into
NVIDIA:mainfrom
nihalpasham:chore/post-1609-cleanup-and-book
Oct 23, 2026
Merged

nihalpasham merged 1 commit into
NVIDIA:mainfrom
nihalpasham:chore/post-1609-cleanup-and-book

Conversation

@nihalpasham

@nihalpasham nihalpasham commented Oct 23, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

Follow-up cleanup after moving cuda-oxide to stable Rust 1.99.1 (#1609) and landing cute-rs-preview (#1598):

1. cuda-oxide/flake.lock + flake.nix   -> bump rust-overlay for Stable 1.99.1 + set RUSTC_BOOTSTRAP=1
2. cargo oxide new (scaffold.rs)       -> write .cargo/config.toml with RUSTC_BOOTSTRAP = "1"
3. check-toolchain-parity.sh           -> verify flake.lock's rust-overlay rev has the pinned manifest
4. .github/workflows/unit-tests.yml    -> drop unused apt llvm-21 install (sysroot llvm-tools provides LLVM 23)
5. CONTRIBUTING / AGENTS / README / book -> update remaining nightly wording + clean up book backticks & SVG

Changes

  • Nix flake (cuda-oxide/flake.lock, cuda-oxide/flake.nix):
    • Bump oxalica/rust-overlay from c1cfa7a2c8 (2026-10-11, two days before 1.99.1 was published) to 5f267b7f32 (2026-10-22) so nix develop finds Stable 1.99.1.
    • Set RUSTC_BOOTSTRAP = "1" in flake.nix (cargoOxideCommonArgs and devShells.default.shellHook).
    • Use a deterministic per-user directory (${XDG_RUNTIME_DIR:-/tmp}/cuda-oxide-nvidia-driver-$(id -u)) for non-NixOS driver symlinks so nix develop --command does not leak /tmp/nix-nvidia-driver.XXXXXX directories.
  • Project scaffold (crates/cargo-oxide/src/commands/scaffold.rs):
    • Write .cargo/config.toml ([env]\nRUSTC_BOOTSTRAP = "1"\n) in cargo oxide new so plain cargo check, cargo build, and rust-analyzer work out of the box in standalone projects on stable 1.99.1.
  • Toolchain parity guard (scripts/check-toolchain-parity.sh):
    • Verify via an HTTP HEAD check that the oxalica/rust-overlay revision locked in cuda-oxide/flake.lock actually contains manifests/stable/<channel>.nix (or manifests/nightly/...), and document the nix flake update rust-overlay step in check-toolchain-parity.sh and compiler/rustc-public.md.
  • CI workflow (.github/workflows/unit-tests.yml, .github/workflows/status-guard.yml):
    • Remove the redundant Install LLVM 21 step on cuda-oxide-codegen (LlvmToolchain::resolve already selects the Rust sysroot's LLVM 23 llc/opt from llvm-tools).
    • Update the status-guard.yml comments to match the current single SIMT stable pin and flake.lock check.
  • Contributor, agent, and book docs (CONTRIBUTING.md, AGENTS.md, cuda-oxide/README.md, cuda-oxide-book/):
    • Replace remaining "nightly toolchain" wording in CONTRIBUTING.md, AGENTS.md (CLAUDE.md), cuda-oxide/README.md, getting-started/installation.md, and getting-started/hello-gpu.md.
    • Remove backticks from # sidebar page titles, ## / ### section headings, and prose crate/tool names across the cute/ chapter and compiler/rustc-public.md.
    • Scale bar widths in models/qwen3_8b_cute/svg/03-rtx5090-benchmark-comparison.svg so the right-hand throughput labels fit inside the panel with >=45px margin.

Validation

  • cargo test -p cargo-oxide scaffold
  • bash cuda-oxide/scripts/check-toolchain-parity.sh
  • just fmt-check
  • just check-guards
  • just book (Sphinx HTML build with -W)

Checklist

  • All commits signed off (git commit -s)

@nihalpasham nihalpasham added documentation Improvements or additions to documentation build-related Build scripts, toolchain discovery, or compilation setup labels Oct 23, 2026
@nihalpasham
nihalpasham requested a review from rparolin as a code owner October 23, 2026 06:34
@nihalpasham nihalpasham added cuda-oxide SIMT programming model: rustc backend, cargo oxide, cuda-device, cuda-host, book ci GitHub Actions workflows, runners, and CI configuration labels Oct 23, 2026
… clean up docs

- Update `rust-overlay` in `cuda-oxide/flake.lock` so `nix develop` resolves
  stable Rust `1.99.1`, export `RUSTC_BOOTSTRAP=1` in `flake.nix`, and use a
  deterministic per-user driver symlink directory instead of leaking `/tmp`
  directories under `nix develop --command`.
- Have `cargo oxide new` scaffold `.cargo/config.toml` with
  `RUSTC_BOOTSTRAP = "1"` so plain `cargo check` and `rust-analyzer` work out
  of the box on stable `1.99.1`.
- Verify in `check-toolchain-parity.sh` that the `oxalica/rust-overlay`
  revision locked in `cuda-oxide/flake.lock` serves the manifest for the
  pinned toolchain channel.
- Remove the unused `Install LLVM 21` step from `.github/workflows/unit-tests.yml`
  (`cuda-oxide-codegen` uses the Rust sysroot's LLVM 23 `llvm-tools` component).
- Update remaining nightly wording in `CONTRIBUTING.md`, `AGENTS.md`,
  `cuda-oxide/README.md`, `getting-started/installation.md`,
  `getting-started/hello-gpu.md`, and `.github/workflows/status-guard.yml`.
- Remove backtick styling from book sidebar titles, section headings, and prose
  crate/tool names across the `cute/` and `compiler/rustc-public.md` pages, and
  fix right-edge bar label clipping in `03-rtx5090-benchmark-comparison.svg`.

Signed-off-by: nihalpasham <nihalp@nvidia.com>
@nihalpasham
nihalpasham force-pushed the chore/post-1609-cleanup-and-book branch from c2c0117 to e9acc33 Compare October 23, 2026 06:46
@nihalpasham nihalpasham changed the title chore(cuda-oxide): update flake.lock for 1.99.1, drop CI llvm-21 step, and clean up docs chore(cuda-oxide): update flake.lock for 1.99.1, scaffold config, and clean up docs Oct 23, 2026
@nihalpasham nihalpasham added the cargo-oxide The `cargo oxide` subcommand and build automation label Oct 23, 2026
@nihalpasham
nihalpasham merged commit 9e75d77 into NVIDIA:main Oct 23, 2026
70 checks passed
@nihalpasham
nihalpasham deleted the chore/post-1609-cleanup-and-book branch October 23, 2026 07:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

build-related Build scripts, toolchain discovery, or compilation setup cargo-oxide The `cargo oxide` subcommand and build automation ci GitHub Actions workflows, runners, and CI configuration cuda-oxide SIMT programming model: rustc backend, cargo oxide, cuda-device, cuda-host, book documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant