Migrate qBraid Target in CUDAQ to qBraid v2

.claude/skills/cudaq-guide/SKILL.md

@@ -3,13 +3,13 @@ name: "cudaq-guide"
 title: "Cuda Quantum"
 description: "CUDA-Q onboarding guide for installation, test programs, GPU simulation, QPU hardware, and quantum applications."
 version: "1.0.0"
-author: "Sachin Pisal <spisal@nvidia.com>"
+author: "CUDA-Q"
 tags: [cuda-quantum, quantum-computing, onboarding, getting-started, nvidia]
 tools: [Read, Glob, Grep, Bash]
 license: "Apache License 2.0"
 compatibility: "Python 3.10+, C++ 20"
 metadata:
-    author: "Sachin Pisal <spisal@nvidia.com>"
+    author: "CUDA-Q"
     tags:
         - cuda-quantum
         - quantum-computing

.github/nv-slack-bot.yaml

@@ -0,0 +1,117 @@
+$schema: https://public.gha-runners.nvidia.com/nv-slack-bot/schemas/config-v1.json
+enabled: true
+notifications:
+  - name: "Publishing workflow failed"
+    event: workflow_run
+    slack:
+      nvidia:
+        channels:
+          - id: C0AT93CK1B9 # nvqpp-cudaq-notifications
+    match: workflow_run.name = "Publishing" and workflow_run.conclusion = "failure"
+    message:
+      body: |
+        <{{url}}|Publishing workflow> failed on `{{branch}}` (commit <{{commitUrl}}|{{sha}}>)
+      vars:
+        url: workflow_run.html_url
+        branch: workflow_run.head_branch
+        sha: $substring(workflow_run.head_sha, 0, 7)
+        commitUrl: workflow_run.head_repository.html_url & "/commit/" & workflow_run.head_sha
+    show_webhook_payload_on_error: false
+
+  - name: "Stable publishing workflow failed"
+    event: workflow_run
+    slack:
+      nvidia:
+        channels:
+          - id: C0AT93CK1B9 # nvqpp-cudaq-notifications
+    match: workflow_run.name = "Push stable release" and workflow_run.conclusion = "failure"
+    message:
+      body: |
+        <{{url}}|Push stable release workflow> failed on `{{branch}}` (commit <{{commitUrl}}|{{sha}}>)
+      vars:
+        url: workflow_run.html_url
+        branch: workflow_run.head_branch
+        sha: $substring(workflow_run.head_sha, 0, 7)
+        commitUrl: workflow_run.head_repository.html_url & "/commit/" & workflow_run.head_sha
+    show_webhook_payload_on_error: false
+
+  - name: "Deployments workflow failed"
+    event: workflow_run
+    slack:
+      nvidia:
+        channels:
+          - id: C0AT93CK1B9 # nvqpp-cudaq-notifications
+    match: workflow_run.name = "Deployments" and workflow_run.conclusion = "failure"
+    message:
+      body: |
+        <{{url}}|Deployments workflow> failed on `{{branch}}` (commit <{{commitUrl}}|{{sha}}>)
+      vars:
+        url: workflow_run.html_url
+        branch: workflow_run.head_branch
+        sha: $substring(workflow_run.head_sha, 0, 7)
+        commitUrl: workflow_run.head_repository.html_url & "/commit/" & workflow_run.head_sha
+    show_webhook_payload_on_error: false
+
+  - name: "Merge queue CI failed"
+    event: workflow_run
+    slack:
+      nvidia:
+        channels:
+          - id: C0AT93CK1B9 # nvqpp-cudaq-notifications
+    match: workflow_run.name = "CI" and workflow_run.event = "merge_group" and workflow_run.conclusion = "failure"
+    message:
+      body: |
+        <{{url}}|Merge queue CI> failed on `{{branch}}` (commit <{{commitUrl}}|{{sha}}>)
+      vars:
+        url: workflow_run.html_url
+        branch: workflow_run.head_branch
+        sha: $substring(workflow_run.head_sha, 0, 7)
+        commitUrl: workflow_run.head_repository.html_url & "/commit/" & workflow_run.head_sha
+    show_webhook_payload_on_error: false
+
+  - name: "Daily CI failed"
+    event: workflow_run
+    slack:
+      nvidia:
+        channels:
+          - id: C0AT93CK1B9 # nvqpp-cudaq-notifications
+    match: workflow_run.name = "CI" and workflow_run.event = "schedule" and workflow_run.conclusion = "failure"
+    message:
+      body: |
+        <{{url}}|Daily CI> failed on `{{branch}}` (commit <{{commitUrl}}|{{sha}}>)
+      vars:
+        url: workflow_run.html_url
+        branch: workflow_run.head_branch
+        sha: $substring(workflow_run.head_sha, 0, 7)
+        commitUrl: workflow_run.head_repository.html_url & "/commit/" & workflow_run.head_sha
+    show_webhook_payload_on_error: false
+
+  - name: "Issue opened"
+    event: issues
+    slack:
+      nvidia:
+        channels:
+          - id: C0AT93CK1B9 # nvqpp-cudaq-notifications
+    match: action = "opened"
+    message:
+      body: |
+        New issue opened: <{{url}}|{{title}}>
+      vars:
+        url: issue.html_url
+        title: issue.title
+    show_webhook_payload_on_error: false
+
+  - name: "Stale issue (no update in over a week)"
+    event: repository_dispatch
+    slack:
+      nvidia:
+        channels:
+          - id: C0AT93CK1B9 # nvqpp-cudaq-notifications
+    match: action = "stale-issue"
+    message:
+      body: |
+        Issue has had no activity in over a week: <{{url}}|{{title}}>
+      vars:
+        url: client_payload.url
+        title: client_payload.title
+    show_webhook_payload_on_error: false

.github/pre-commit/spelling_allowlist.txt

@@ -108,6 +108,8 @@ Photonics
 PyPI
 Pygments
 QAOA
+QASM
+QBRAID
 QCI
 QCaaS
 QEC
@@ -128,6 +130,7 @@ QuTiP
 Quake
 Quantinuum
 RDMA
+REPL
 RHEL
 RPC
 RSA
@@ -168,6 +171,7 @@ amongst
 ancilla
 ansatz
 ansatzes
+api
 archiver
 arity
 auxillary
@@ -227,6 +231,7 @@ dependence
 dependences
 deserialization
 deserialize
+deserializes
 destructor
 detuning
 deutsch
@@ -300,17 +305,20 @@ lossy
 lvalue
 macOS
 makefiles
+measurementCounts
 merchantability
 mps
 multinomial
 multithreaded
 mutex
 namespace
 namespaces
+nanobind
 natively
 normalization
 nullary
 nvcc
+nvq
 observables
 optimizer
 optimizers
@@ -332,21 +340,26 @@ preprocessor
 probability
 programmatically
 pybind
+qBraid
 qaoa
+qbraid
 qed
 qio
+qrn
 quantize
 quantized
 qubit
 qubits
 qudit
 qudits
+queryable
 qumode
 qumodes
 reStructuredText
 realtime
 reconfigurable
 reproducibility
+resultData
 reusability
 runtime
 runtimes

.github/required-checks.yml

@@ -0,0 +1,58 @@
+# Required sub-job names per event type for the `CI` workflow.
+#
+# `CI Summary` fails if any name listed here did not complete with
+# `conclusion: success`. This guards against accidentally adding a matrix
+# leg / reusable-workflow job to CI but forgetting to add it as a required
+# check, and against silent regressions where a leg stops running.
+#
+# An empty list (or missing key) for an event type disables enforcement
+# for that event — useful for bootstrapping.
+merge_group: &full_matrix
+- Build and test (amd64, llvm, openmpi) / Dev environment (Debug)
+- Build and test (amd64, llvm, openmpi) / Dev environment (Python)
+- Build and test (arm64, llvm, openmpi) / Dev environment (Debug)
+- Build and test (arm64, llvm, openmpi) / Dev environment (Python)
+- Build and test (amd64, gcc12, openmpi) / Dev environment (Debug)
+- Build and test (amd64, gcc12, openmpi) / Dev environment (Python)
+- Build and test (arm64, gcc12, openmpi) / Dev environment (Debug)
+- Build and test (arm64, gcc12, openmpi) / Dev environment (Python)
+- Create CUDA Quantum installer (amd64, 12.6) / Build CUDA Quantum assets
+- Create CUDA Quantum installer (amd64, 12.6) / Minimal OpenMPI installation
+- Create CUDA Quantum installer (amd64, 12.6) / Validate installer (debian:12)
+- Create CUDA Quantum installer (amd64, 12.6) / Validate installer (fedora:42)
+- Create CUDA Quantum installer (amd64, 12.6) / Validate installer (opensuse/leap:15.5)
+- Create CUDA Quantum installer (amd64, 12.6) / Validate installer (redhat/ubi9:9.6)
+- Create CUDA Quantum installer (amd64, 12.6) / Validate installer (ubuntu:22.04)
+- Create CUDA Quantum installer (arm64, 12.6) / Build CUDA Quantum assets
+- Create CUDA Quantum installer (arm64, 12.6) / Minimal OpenMPI installation
+- Create CUDA Quantum installer (arm64, 12.6) / Validate installer (redhat/ubi9:9.6)
+- Create CUDA Quantum installer (arm64, 12.6) / Validate installer (ubuntu:22.04)
+- Create Docker images (amd64) / Documentation
+- Create Docker images (amd64) / Validation
+- Create Docker images (arm64) / Validation
+- Create Python metapackages / Build Python metapackages
+- Create Python metapackages / Test Python metapackages (3.11)
+- Create Python metapackages / Test Python metapackages (3.13)
+- Create Python metapackages / Test Python metapackages (12.6, 3.11)
+- Create Python metapackages / Test Python metapackages (12.6, 3.13)
+- Create Python wheels (amd64, 3.11, 12.6) / Validate wheel (debian:12, --user)
+- Create Python wheels (amd64, 3.11, 12.6) / Validate wheel (debian:12)
+- Create Python wheels (amd64, 3.11, 12.6) / Validate wheel (fedora:42, --user)
+- Create Python wheels (amd64, 3.11, 12.6) / Validate wheel (fedora:42)
+- Create Python wheels (amd64, 3.11, 12.6) / Validate wheel (redhat/ubi8:8.10, --user)
+- Create Python wheels (amd64, 3.11, 12.6) / Validate wheel (redhat/ubi8:8.10)
+- Create Python wheels (arm64, 3.11, 12.6) / Validate wheel (debian:12, --user)
+- Create Python wheels (arm64, 3.11, 12.6) / Validate wheel (debian:12)
+- Create Python wheels (arm64, 3.11, 12.6) / Validate wheel (fedora:42, --user)
+- Create Python wheels (arm64, 3.11, 12.6) / Validate wheel (fedora:42)
+- Create Python wheels (arm64, 3.11, 12.6) / Validate wheel (redhat/ubi8:8.10, --user)
+- Create Python wheels (arm64, 3.11, 12.6) / Validate wheel (redhat/ubi8:8.10)
+push:
+- Build and test (amd64, llvm, openmpi) / Dev environment (Debug)
+- Build and test (amd64, llvm, openmpi) / Dev environment (Python)
+- Build and test (arm64, llvm, openmpi) / Dev environment (Debug)
+- Build and test (arm64, llvm, openmpi) / Dev environment (Python)
+- Build and test (amd64, gcc12, openmpi) / Dev environment (Debug)
+- Build and test (amd64, gcc12, openmpi) / Dev environment (Python)
+workflow_dispatch: *full_matrix
+schedule: *full_matrix

.github/workflows/build_package_sources.yml

@@ -67,7 +67,7 @@ jobs:
           else
             # cudaqx: devcontainer base, cudaqx target
             cu_tag=$(echo "${{ matrix.cuda }}" | tr -d .)
-            echo "base_image=ghcr.io/nvidia/cuda-quantum-devcontainer:amd64-cu${{ matrix.cuda }}-gcc11-main" | tee -a $GITHUB_OUTPUT
+            echo "base_image=ghcr.io/nvidia/cuda-quantum-devcontainer:amd64-cu${{ matrix.cuda }}-llvm-main" | tee -a $GITHUB_OUTPUT
             echo "target_image=ghcr.io/nvidia/cudaqx:cu${cuda_major}-latest" | tee -a $GITHUB_OUTPUT
           fi