Warn of upcoming `sample` and `observe` changes by khalatepradnya · Pull Request #5334 · NVIDIA/cuda-quantum

khalatepradnya · 2026-08-31T21:37:17Z

Summary

Add a temporary advance notice for upcoming changes to the CUDA-Q sample and observe algorithmic primitives.
Python displays the notice on import cudaq. The nvq++ driver displays it when compiling or linking input.
Both messages link to a version-neutral documentation page.

Notify users at Python import and nvq++ compile entry points before the algorithmic primitives change, without modifying compiler or runtime workflows. Added a blank docs page; details TBD. Signed-off-by: Pradnya Khalate <pkhalate@nvidia.com> Co-authored-by: Cursor <cursoragent@cursor.com>

github-actions · 2026-08-31T22:15:23Z

CI Summary (`push`) — ✅ passed

Run #33449138683 · ✅ 7 · ⏩ 7 · ❌ 0 · ⛔ 0

Top-level jobs (14)

Job	Result
`binaries`	⏩ skipped
`build_and_test`	✅ success
`changes`	✅ success
`config_devdeps`	✅ success
`config_source_build`	⏩ skipped
`config_wheeldeps`	✅ success
`devdeps`	✅ success
`docker_image`	⏩ skipped
`gen_code_coverage`	⏩ skipped
`metadata`	✅ success
`python_metapackages`	⏩ skipped
`python_wheels`	⏩ skipped
`source_build`	⏩ skipped
`wheeldeps`	✅ success

⏩ Skipped jobs (7) — intentionally skipped on PR builds; run on merge_group / workflow_dispatch

Job
`binaries`
`config_source_build`
`docker_image`
`gen_code_coverage`
`python_metapackages`
`python_wheels`
`source_build`

All sub-jobs (43) — every matrix leg, with links

Job	Status	Link
Build and test (amd64, gcc12, openmpi) / Dev environment (Debug)	✅ success	view
Build and test (amd64, gcc12, openmpi) / Dev environment (Python)	✅ success	view
Build and test (amd64, llvm, openmpi) / Dev environment (Debug)	✅ success	view
Build and test (amd64, llvm, openmpi) / Dev environment (Python)	✅ success	view
Build and test (arm64, llvm, openmpi) / Dev environment (Debug)	✅ success	view
Build and test (arm64, llvm, openmpi) / Dev environment (Python)	✅ success	view
CI Summary	❔ in_progress	view
Check for stable CUDA-Q changes	✅ success	view
Configure build (devdeps)	✅ success	view
Configure build (source_build)	⏩ skipped	view
Configure build (wheeldeps)	✅ success	view
Create CUDA Quantum installer	⏩ skipped	view
Create Docker images	⏩ skipped	view
Create Python metapackages	⏩ skipped	view
Create Python wheels	⏩ skipped	view
Gen code coverage	⏩ skipped	view
Load dependencies (amd64, gcc12) / Caching	✅ success	view
Load dependencies (amd64, gcc12) / Finalize	✅ success	view
Load dependencies (amd64, gcc12) / Metadata	✅ success	view
Load dependencies (amd64, llvm) / Caching	✅ success	view
Load dependencies (amd64, llvm) / Finalize	✅ success	view
Load dependencies (amd64, llvm) / Metadata	✅ success	view
Load dependencies (arm64, gcc12) / Caching	✅ success	view
Load dependencies (arm64, gcc12) / Finalize	✅ success	view
Load dependencies (arm64, gcc12) / Metadata	✅ success	view
Load dependencies (arm64, llvm) / Caching	✅ success	view
Load dependencies (arm64, llvm) / Finalize	✅ success	view
Load dependencies (arm64, llvm) / Metadata	✅ success	view
Load source build cache	⏩ skipped	view
Load wheel dependencies (amd64, 12.6) / Caching	✅ success	view
Load wheel dependencies (amd64, 12.6) / Finalize	✅ success	view
Load wheel dependencies (amd64, 12.6) / Metadata	✅ success	view
Load wheel dependencies (amd64, 13.0) / Caching	✅ success	view
Load wheel dependencies (amd64, 13.0) / Finalize	✅ success	view
Load wheel dependencies (amd64, 13.0) / Metadata	✅ success	view
Load wheel dependencies (arm64, 12.6) / Caching	✅ success	view
Load wheel dependencies (arm64, 12.6) / Finalize	✅ success	view
Load wheel dependencies (arm64, 12.6) / Metadata	✅ success	view
Load wheel dependencies (arm64, 13.0) / Caching	✅ success	view
Load wheel dependencies (arm64, 13.0) / Finalize	✅ success	view
Load wheel dependencies (arm64, 13.0) / Metadata	✅ success	view
Prepare cache clean-up	❔ in_progress	view
Retrieve PR info	✅ success	view

✅ Required checks (6/6) — declared in .github/required-checks.yml for push

Required check	Status	Link
Build and test (amd64, llvm, openmpi) / Dev environment (Debug)	✅ success	view
Build and test (amd64, llvm, openmpi) / Dev environment (Python)	✅ success	view
Build and test (arm64, llvm, openmpi) / Dev environment (Debug)	✅ success	view
Build and test (arm64, llvm, openmpi) / Dev environment (Python)	✅ success	view
Build and test (amd64, gcc12, openmpi) / Dev environment (Debug)	✅ success	view
Build and test (amd64, gcc12, openmpi) / Dev environment (Python)	✅ success	view

Signed-off-by: Pradnya Khalate <pkhalate@nvidia.com>

sacpis

LGTM. Thanks @khalatepradnya.

Signed-off-by: Pradnya Khalate <pkhalate@nvidia.com>

sacpis

Seeing repeated text Upcoming changes to sample and observe

khalatepradnya · 2026-08-31T23:02:00Z

Seeing repeated text Upcoming changes to sample and observe

I get this -

Note it is still local!

Signed-off-by: Pradnya Khalate <pkhalate@nvidia.com>

sacpis · 2026-08-31T23:18:17Z

Seeing repeated text Upcoming changes to sample and observe

I get this -

Note it is still local!

Yeah, I built the docs locally and checked it. I see the above (same as you) if I directly go to the link.

But when I search for migration in the search bar on the left, it shows me the text which I pasted before.

khalatepradnya · 2026-09-01T01:04:05Z

Seeing repeated text Upcoming changes to sample and observe

Note it is still local!

Yeah, I built the docs locally and checked it. I see the above (same as you) if I directly go to the link.

But when I search for migration in the search bar on the left, it shows me the text which I pasted before.

Noted. It could be an artifact of the page being orphan (for now) or the search feature or local docs. I will revisit once this makes into the official docs.

github-actions · 2026-09-01T01:31:47Z

CI Summary (`merge_group`) — ✅ passed

Run #33456890714 · ✅ 5 · ⏩ 9 · ❌ 0 · ⛔ 0

⚡ Fast merge queue — only the llvm dev-environment build+test legs ran.
Wheels, metapackages, installers, Docker images, and the gcc12 legs were skipped.
Set the repository variable MERGE_QUEUE_FAST to false to restore the full matrix.

Top-level jobs (14)

Job	Result
`binaries`	⏩ skipped
`build_and_test`	✅ success
`changes`	✅ success
`config_devdeps`	✅ success
`config_source_build`	⏩ skipped
`config_wheeldeps`	⏩ skipped
`devdeps`	✅ success
`docker_image`	⏩ skipped
`gen_code_coverage`	⏩ skipped
`metadata`	✅ success
`python_metapackages`	⏩ skipped
`python_wheels`	⏩ skipped
`source_build`	⏩ skipped
`wheeldeps`	⏩ skipped

⏩ Skipped jobs (9) — intentionally skipped on PR builds; run on merge_group / workflow_dispatch

Job
`binaries`
`config_source_build`
`config_wheeldeps`
`docker_image`
`gen_code_coverage`
`python_metapackages`
`python_wheels`
`source_build`
`wheeldeps`

All sub-jobs (24) — every matrix leg, with links

Job	Status	Link
Build and test (amd64, llvm, openmpi) / Dev environment (Debug)	✅ success	view
Build and test (amd64, llvm, openmpi) / Dev environment (Python)	✅ success	view
Build and test (arm64, llvm, openmpi) / Dev environment (Debug)	✅ success	view
Build and test (arm64, llvm, openmpi) / Dev environment (Python)	✅ success	view
CI Summary	❔ in_progress	view
Check for stable CUDA-Q changes	✅ success	view
Configure build (devdeps)	✅ success	view
Configure build (source_build)	⏩ skipped	view
Configure build (wheeldeps)	⏩ skipped	view
Create CUDA Quantum installer	⏩ skipped	view
Create Docker images	⏩ skipped	view
Create Python metapackages	⏩ skipped	view
Create Python wheels	⏩ skipped	view
Gen code coverage	⏩ skipped	view
Load dependencies (amd64, llvm) / Caching	✅ success	view
Load dependencies (amd64, llvm) / Finalize	✅ success	view
Load dependencies (amd64, llvm) / Metadata	✅ success	view
Load dependencies (arm64, llvm) / Caching	✅ success	view
Load dependencies (arm64, llvm) / Finalize	✅ success	view
Load dependencies (arm64, llvm) / Metadata	✅ success	view
Load source build cache	⏩ skipped	view
Load wheel dependencies	⏩ skipped	view
Prepare cache clean-up	❔ in_progress	view
Retrieve PR info	✅ success	view

✅ Required checks (4/4) — declared in .github/required-checks.yml for merge_group_fast

Required check	Status	Link
Build and test (amd64, llvm, openmpi) / Dev environment (Debug)	✅ success	view
Build and test (amd64, llvm, openmpi) / Dev environment (Python)	✅ success	view
Build and test (arm64, llvm, openmpi) / Dev environment (Debug)	✅ success	view
Build and test (arm64, llvm, openmpi) / Dev environment (Python)	✅ success	view

github-actions Bot added documentation Improvements or additions to documentation python-lang Anything related to the Python CUDA Quantum language implementation driver (nvq++) The nvq++ compiler driver core compiler labels Aug 31, 2026

khalatepradnya requested review from atgeller, bettinaheim and sacpis August 31, 2026 21:37

schweitzpgi reviewed Aug 31, 2026

View reviewed changes

Comment thread cudaq/test/NVQPP/advance_notice.cpp Outdated

schweitzpgi reviewed Aug 31, 2026

View reviewed changes

Comment thread cudaq/tools/nvq++/nvq++.in Outdated

Addressing review comments

e596bd7

Signed-off-by: Pradnya Khalate <pkhalate@nvidia.com>

github-actions Bot added the c++ bridge CUDA-Q in C++ bridge to MLIR compiler label Aug 31, 2026

sacpis approved these changes Aug 31, 2026

View reviewed changes

Add a test

134d235

Signed-off-by: Pradnya Khalate <pkhalate@nvidia.com>

sacpis reviewed Aug 31, 2026

View reviewed changes

Make clang-formatter happy

20eee32

Signed-off-by: Pradnya Khalate <pkhalate@nvidia.com>

khalatepradnya enabled auto-merge September 1, 2026 00:57

khalatepradnya added this pull request to the merge queue Sep 1, 2026

Merged via the queue into NVIDIA:main with commit 756fe8a Sep 1, 2026
75 checks passed

khalatepradnya deleted the future-warning branch September 1, 2026 01:49

github-actions Bot pushed a commit that referenced this pull request Sep 1, 2026

Cleaning up docs preview for PR #5334.

f1deee9

Navigation Menu

Uh oh!

Warn of upcoming `sample` and `observe` changes - #5334

Warn of upcoming `sample` and `observe` changes#5334
khalatepradnya merged 4 commits into
NVIDIA:mainfrom
khalatepradnya:future-warning

khalatepradnya commented Aug 31, 2026

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Aug 31, 2026 •

edited

Loading

Uh oh!

sacpis left a comment

Uh oh!

sacpis left a comment

Uh oh!

khalatepradnya commented Aug 31, 2026 •

edited

Loading

Uh oh!

sacpis commented Aug 31, 2026 •

edited

Loading

Uh oh!

khalatepradnya commented Sep 1, 2026

Uh oh!

github-actions Bot commented Sep 1, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

khalatepradnya commented Aug 31, 2026

Summary

Uh oh!

Uh oh!

Uh oh!

github-actions Bot commented Aug 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

CI Summary (push) — ✅ passed

Uh oh!

sacpis left a comment

Choose a reason for hiding this comment

Uh oh!

sacpis left a comment

Choose a reason for hiding this comment

Uh oh!

khalatepradnya commented Aug 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

sacpis commented Aug 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

khalatepradnya commented Sep 1, 2026

Uh oh!

github-actions Bot commented Sep 1, 2026

CI Summary (merge_group) — ✅ passed

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

github-actions Bot commented Aug 31, 2026 •

edited

Loading

CI Summary (`push`) — ✅ passed

khalatepradnya commented Aug 31, 2026 •

edited

Loading

sacpis commented Aug 31, 2026 •

edited

Loading

CI Summary (`merge_group`) — ✅ passed