release(v0.5.0): integrate shared host runtime and source-location fixes

.github/workflows/book.yml

@@ -15,7 +15,8 @@ on:
   # only ever built after merge, so a PR that broke it could not be caught by
   # review or by CI.
   pull_request:
-    branches: [main]
+    # Include release PRs and stacks targeting prerequisite copy-pr-bot mirrors.
+    branches: [main, "release/v*", "pull-request/[0-9]+"]
     paths:
       - 'cuda-oxide/cuda-oxide-book/**'
       - 'cutile-rs/cutile-book/**'

.github/workflows/ci.yml

@@ -12,17 +12,20 @@ on:
       - 'cuda-bindings/**'
       - 'cuda-core/**'
       - 'cuda-core-derive/**'
+      - 'cuda-repr/**'
       - 'cuda-async/**'
       - 'Cargo.toml'
       - 'Cargo.lock'
       - '.github/workflows/**'
   pull_request:
-    branches: [main]
+    # Include release PRs and stacks targeting prerequisite copy-pr-bot mirrors.
+    branches: [main, "release/v*", "pull-request/[0-9]+"]
     paths:
       - 'cuda-oxide/**'
       - 'cuda-bindings/**'
       - 'cuda-core/**'
       - 'cuda-core-derive/**'
+      - 'cuda-repr/**'
       - 'cuda-async/**'
       - 'Cargo.toml'
       - 'Cargo.lock'

.github/workflows/clippy.yml

@@ -37,7 +37,7 @@ jobs:
         working-directory: cuda-oxide
         run: cargo clippy --workspace --all-targets -- -D warnings
 
-      # `rustc-codegen-cuda` and each example under examples/ are their own
+      # `rustc-codegen-cuda`, the standard and CuTe examples, and CuTe models have
       # standalone workspaces (the codegen backend is swapped in via
       # RUSTFLAGS, so they can't live in the root [workspace]). That's 60+
       # cargo invocations from different workspace roots. By default each
@@ -60,18 +60,25 @@ jobs:
         working-directory: cuda-oxide/crates/rustc-codegen-cuda
         run: cargo clippy --all-targets -- -D warnings
 
-      - name: Run clippy (rustc-codegen-cuda examples)
+      - name: Run clippy (standard and CuTe examples and models)
         env:
           CUDA_TOOLKIT_PATH: ${{ steps.cuda-toolkit.outputs.CUDA_PATH }}
           CARGO_TARGET_DIR: ${{ runner.temp }}/clippy-shared-target
         run: |
           set -e
-          for ex in cuda-oxide/crates/rustc-codegen-cuda/examples/*/; do
-            if [ ! -f "$ex/Cargo.toml" ]; then continue; fi
-            name=$(basename "$ex")
-            echo "::group::clippy: $name"
-            (cd "$ex" && cargo clippy --all-targets -- -D warnings)
-            echo "::endgroup::"
+          example_roots=(
+            cuda-oxide/crates/rustc-codegen-cuda/examples
+            cuda-oxide/cute-rs-preview/examples
+            cuda-oxide/cute-rs-preview/models
+          )
+          for example_root in "${example_roots[@]}"; do
+            for ex in "$example_root"/*/; do
+              if [ ! -f "$ex/Cargo.toml" ]; then continue; fi
+              name=$(basename "$ex")
+              echo "::group::clippy: $name"
+              (cd "$ex" && cargo clippy --all-targets -- -D warnings)
+              echo "::endgroup::"
+            done
           done
 
           # The loop above is one level deep. A few examples nest a second
@@ -97,11 +104,11 @@ jobs:
                grep -q "\"${sub}\""; then
               continue
             fi
-            echo "::group::clippy: ${dir#cuda-oxide/crates/rustc-codegen-cuda/examples/}"
+            echo "::group::clippy: ${dir#cuda-oxide/}"
             (cd "${dir}" && cargo clippy --locked --all-targets -- -D warnings)
             echo "::endgroup::"
           done < <(
-            find cuda-oxide/crates/rustc-codegen-cuda/examples -mindepth 3 -name Cargo.toml \
+            find "${example_roots[@]}" -mindepth 3 -name Cargo.toml \
               -not -path '*/target/*' | sort
           )
 

.github/workflows/codeql.yml

@@ -15,7 +15,8 @@ on:
       - '**/*.sh'
       - '**/*.py'
   pull_request:
-    branches: [main]
+    # Include release PRs and stacks targeting prerequisite copy-pr-bot mirrors.
+    branches: [main, "release/v*", "pull-request/[0-9]+"]
     paths:
       - '**/*.rs'
       - '**/Cargo.toml'

.github/workflows/cutile-rs.yml

@@ -64,6 +64,7 @@ jobs:
               - 'cuda-bindings/**'
               - 'cuda-core/**'
               - 'cuda-core-derive/**'
+              - 'cuda-repr/**'
               - 'cuda-async/**'
               - 'Cargo.toml'
               - 'Cargo.lock'
@@ -288,7 +289,7 @@ jobs:
 
       - name: Native f16 DeviceCopy
         working-directory: ${{ github.workspace }}
-        run: cargo test -p cuda-core --features f16 --test simt_device_copy_impls
+        run: cargo test -p cuda-core --features f16 --test device_copy_impls
 
       - name: loom model check (interleavings + weak memory)
         working-directory: ${{ github.workspace }}

.github/workflows/docs.yml

@@ -10,17 +10,20 @@ on:
       - 'cuda-bindings/**'
       - 'cuda-core/**'
       - 'cuda-core-derive/**'
+      - 'cuda-repr/**'
       - 'cuda-async/**'
       - 'Cargo.toml'
       - 'Cargo.lock'
       - '.github/workflows/**'
   pull_request:
-    branches: [main]
+    # Include release PRs and stacks targeting prerequisite copy-pr-bot mirrors.
+    branches: [main, "release/v*", "pull-request/[0-9]+"]
     paths:
       - 'cuda-oxide/**'
       - 'cuda-bindings/**'
       - 'cuda-core/**'
       - 'cuda-core-derive/**'
+      - 'cuda-repr/**'
       - 'cuda-async/**'
       - 'Cargo.toml'
       - 'Cargo.lock'

.github/workflows/examples-compile.yml

@@ -10,17 +10,20 @@ on:
       - 'cuda-bindings/**'
       - 'cuda-core/**'
       - 'cuda-core-derive/**'
+      - 'cuda-repr/**'
       - 'cuda-async/**'
       - 'Cargo.toml'
       - 'Cargo.lock'
       - '.github/workflows/**'
   pull_request:
-    branches: [main]
+    # Include release PRs and stacks targeting prerequisite copy-pr-bot mirrors.
+    branches: [main, "release/v*", "pull-request/[0-9]+"]
     paths:
       - 'cuda-oxide/**'
       - 'cuda-bindings/**'
       - 'cuda-core/**'
       - 'cuda-core-derive/**'
+      - 'cuda-repr/**'
       - 'cuda-async/**'
       - 'Cargo.toml'
       - 'Cargo.lock'

.github/workflows/fmt.yml

@@ -43,13 +43,17 @@ jobs:
         run: cargo fmt --all -- --check
         working-directory: cuda-oxide/crates/cuda-macros/tests/device-only
 
-      - name: Check example crate formatting
+      - name: Check example and model crate formatting
         run: |
           set -euo pipefail
           # `cargo fmt --all` also formats local path dependencies. Running it
           # per example repeatedly reformats the large shared workspaces.
           shopt -s globstar nullglob
-          manifests=(cuda-oxide/crates/rustc-codegen-cuda/examples/**/Cargo.toml)
+          manifests=(
+            cuda-oxide/crates/rustc-codegen-cuda/examples/**/Cargo.toml
+            cuda-oxide/cute-rs-preview/examples/**/Cargo.toml
+            cuda-oxide/cute-rs-preview/models/**/Cargo.toml
+          )
           ((${#manifests[@]} > 0))
           for manifest in "${manifests[@]}"; do
             example_dir="$(dirname "$manifest")"

.github/workflows/naming-guard.yml

@@ -16,7 +16,8 @@ on:
       - 'cuda-oxide/scripts/check-reserved-prefixes.sh'
       - '.github/workflows/naming-guard.yml'
   pull_request:
-    branches: [main]
+    # Include release PRs and stacks targeting prerequisite copy-pr-bot mirrors.
+    branches: [main, "release/v*", "pull-request/[0-9]+"]
     paths:
       - 'cuda-oxide/crates/**'
       - 'cuda-oxide/scripts/check-reserved-prefixes.sh'

.github/workflows/status-guard.yml

@@ -5,7 +5,8 @@ on:
   push:
     branches: [main]
   pull_request:
-    branches: [main]
+    # Include release PRs and stacks targeting prerequisite copy-pr-bot mirrors.
+    branches: [main, "release/v*", "pull-request/[0-9]+"]
 
 # Each commit on main gets its own group, so it starts at once. Any other ref
 # still shares one group and cancels the older run.

.github/workflows/unit-tests.yml

@@ -55,6 +55,18 @@ jobs:
           - package: dialect-mir
           - package: dialect-nvvm
           - package: mir-importer
+          # CuTe types, semantic IR, and MLIR export need no CUDA toolkit.
+          # Facade macro tests also compile host metadata via cuda-host.
+          - package: cute-layout
+          - package: cute-rs
+            needs_cuda: true
+          - package: ctm-rs
+            needs_cuda: true
+          - package: ctm-rs
+            test_args: --all-targets --features host
+            needs_cuda: true
+          - package: dialect-cute
+          - package: cuda-oxide-mlir-export
           # Includes a real llc -> ptxas spine-kernel validation.
           - package: cuda-oxide-codegen
             needs_cuda: true

AGENTS.md

@@ -105,6 +105,9 @@ Run `nix develop` from the relevant component.
   notice plus `Apache-2.0`, in the form shown under "License Headers" in
   `CONTRIBUTING.md`. Preserve existing and third-party notices.
   `cuda-oxide/scripts/check-spdx-headers.sh` enforces the policy.
+- **Create new branches from the user's fork of this repository.** Synchronize
+  the fork's `main` with upstream before branching. For stacked work, base the
+  next branch on the preceding feature branch in that same fork.
 - **Never push to the canonical upstream repository, `NVIDIA/cuda-rust`.
   Treat it as read-only.** Branch and push to a fork. Before pushing, run
   `git remote -v` and confirm the push remote is a fork of the base, comparing

Cargo.toml

@@ -8,6 +8,8 @@ members = [
     "cuda-core",
     "cuda-core-derive",
     "cuda-async",
+    # no_std representation contracts shared by host and device crates.
+    "cuda-repr",
 ]
 # Nested workspaces. Without these, Cargo treats crates under them as part of
 # this workspace and `edition.workspace = true` in cuda-device (etc.) looks at

README.md

@@ -67,6 +67,7 @@ cuda-rust/
 ├── cuda-bindings/      runtime — CUDA driver API bindings
 ├── cuda-core/          runtime — contexts, streams, memory, modules, events, launch
 ├── cuda-core-derive/   runtime — derive macros for cuda-core
+├── cuda-repr/          shared no_std host/device representation contracts
 ├── cuda-async/         runtime — lazy ops, futures, streams, graphs
 ├── cuda-oxide/         SIMT model — compiler, device crates, cuda-oxide-book
 └── cutile-rs/          Tile model — compiler, tile crates, cutile-book

cuda-async/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "cuda-async"
-version = "0.4.0"
+version = "0.5.0"
 edition = "2021"
 rust-version = "1.89"
 license = "Apache-2.0"
@@ -11,9 +11,9 @@ description = "Safe Async CUDA support via Async Rust."
 
 [dependencies]
 # Sibling paths, not the root workspace entries; see cuda-core/Cargo.toml.
-cuda-core = { version = "=0.4.0", path = "../cuda-core" }
+cuda-core = { version = "=0.5.0", path = "../cuda-core" }
 rustc-hash = "2.0"
-cuda-bindings = { version = "=0.4.0", path = "../cuda-bindings" }
+cuda-bindings = { version = "=0.5.0", path = "../cuda-bindings" }
 half = { version = "2" }
 futures = "0.3"
 anyhow = "1"