Skip to content

Commit 1cc08b7

Browse files
sylvesterkaczmareksylvesterkaczmarek
committed
Rebuild as CUDA-Q execution guardrail toolkit
1 parent 6d950bf commit 1cc08b7

37 files changed

Lines changed: 1887 additions & 472 deletions

‎.github/workflows/ci.yml‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
name: CI
2+
3+
on:
4+
push:
5+
pull_request:
6+
7+
jobs:
8+
unit:
9+
runs-on: ubuntu-latest
10+
strategy:
11+
matrix:
12+
python-version: ["3.11", "3.12", "3.13"]
13+
steps:
14+
- uses: actions/checkout@v4
15+
- uses: actions/setup-python@v5
16+
with:
17+
python-version: ${{ matrix.python-version }}
18+
cache: pip
19+
- name: Install
20+
run: |
21+
python -m pip install --upgrade pip
22+
python -m pip install -e ".[dev]"
23+
- name: Compile
24+
run: python -m compileall -q src tests examples
25+
- name: Test
26+
run: python -m pytest
27+
- name: Build package
28+
if: matrix.python-version == '3.12'
29+
run: python -m build
30+
31+
cudaq-smoke:
32+
runs-on: ubuntu-latest
33+
timeout-minutes: 25
34+
steps:
35+
- uses: actions/checkout@v4
36+
- uses: actions/setup-python@v5
37+
with:
38+
python-version: "3.12"
39+
cache: pip
40+
- name: Install CUDA-Q
41+
run: |
42+
python -m pip install --upgrade pip
43+
python -m pip install -e ".[cudaq,dev]"
44+
- name: Diagnose
45+
run: cudaq-guard doctor --json
46+
- name: CPU simulator smoke test
47+
run: |
48+
cudaq-guard run ghz --policy policies/local-safe.toml --target qpp-cpu --qubits 3 --shots 256 --seed 7 --audit /tmp/cudaq-guard-audit.jsonl
49+
cudaq-guard audit verify /tmp/cudaq-guard-audit.jsonl
50+
- name: VQE smoke test
51+
run: cudaq-guard run vqe --policy policies/local-safe.toml --target qpp-cpu --steps 7 --seed 7 --audit /tmp/cudaq-guard-audit.jsonl

‎.gitignore‎

Lines changed: 10 additions & 202 deletions
Original file line numberDiff line numberDiff line change
@@ -1,207 +1,15 @@
1-
# Byte-compiled / optimized / DLL files
21
__pycache__/
3-
*.py[codz]
4-
*$py.class
5-
6-
# C extensions
2+
*.py[cod]
73
*.so
8-
9-
# Distribution / packaging
10-
.Python
11-
build/
12-
develop-eggs/
13-
dist/
14-
downloads/
15-
eggs/
16-
.eggs/
17-
lib/
18-
lib64/
19-
parts/
20-
sdist/
21-
var/
22-
wheels/
23-
share/python-wheels/
244
*.egg-info/
25-
.installed.cfg
26-
*.egg
27-
MANIFEST
28-
29-
# PyInstaller
30-
# Usually these files are written by a python script from a template
31-
# before PyInstaller builds the exe, so as to inject date/other infos into it.
32-
*.manifest
33-
*.spec
34-
35-
# Installer logs
36-
pip-log.txt
37-
pip-delete-this-directory.txt
38-
39-
# Unit test / coverage reports
40-
htmlcov/
41-
.tox/
42-
.nox/
43-
.coverage
44-
.coverage.*
45-
.cache
46-
nosetests.xml
47-
coverage.xml
48-
*.cover
49-
*.py.cover
50-
.hypothesis/
515
.pytest_cache/
52-
cover/
53-
54-
# Translations
55-
*.mo
56-
*.pot
57-
58-
# Django stuff:
59-
*.log
60-
local_settings.py
61-
db.sqlite3
62-
db.sqlite3-journal
63-
64-
# Flask stuff:
65-
instance/
66-
.webassets-cache
67-
68-
# Scrapy stuff:
69-
.scrapy
70-
71-
# Sphinx documentation
72-
docs/_build/
73-
74-
# PyBuilder
75-
.pybuilder/
76-
target/
77-
78-
# Jupyter Notebook
79-
.ipynb_checkpoints
80-
81-
# IPython
82-
profile_default/
83-
ipython_config.py
84-
85-
# pyenv
86-
# For a library or package, you might want to ignore these files since the code is
87-
# intended to run in multiple environments; otherwise, check them in:
88-
# .python-version
89-
90-
# pipenv
91-
# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
92-
# However, in case of collaboration, if having platform-specific dependencies or dependencies
93-
# having no cross-platform support, pipenv may install dependencies that don't work, or not
94-
# install all needed dependencies.
95-
#Pipfile.lock
96-
97-
# UV
98-
# Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
99-
# This is especially recommended for binary packages to ensure reproducibility, and is more
100-
# commonly ignored for libraries.
101-
#uv.lock
102-
103-
# poetry
104-
# Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
105-
# This is especially recommended for binary packages to ensure reproducibility, and is more
106-
# commonly ignored for libraries.
107-
# https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
108-
#poetry.lock
109-
#poetry.toml
110-
111-
# pdm
112-
# Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
113-
# pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
114-
# https://pdm-project.org/en/latest/usage/project/#working-with-version-control
115-
#pdm.lock
116-
#pdm.toml
117-
.pdm-python
118-
.pdm-build/
119-
120-
# pixi
121-
# Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
122-
#pixi.lock
123-
# Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
124-
# in the .venv directory. It is recommended not to include this directory in version control.
125-
.pixi
126-
127-
# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
128-
__pypackages__/
129-
130-
# Celery stuff
131-
celerybeat-schedule
132-
celerybeat.pid
133-
134-
# SageMath parsed files
135-
*.sage.py
136-
137-
# Environments
138-
.env
139-
.envrc
140-
.venv
141-
env/
6+
.venv/
1427
venv/
143-
ENV/
144-
env.bak/
145-
venv.bak/
146-
147-
# Spyder project settings
148-
.spyderproject
149-
.spyproject
150-
151-
# Rope project settings
152-
.ropeproject
153-
154-
# mkdocs documentation
155-
/site
156-
157-
# mypy
158-
.mypy_cache/
159-
.dmypy.json
160-
dmypy.json
161-
162-
# Pyre type checker
163-
.pyre/
164-
165-
# pytype static type analyzer
166-
.pytype/
167-
168-
# Cython debug symbols
169-
cython_debug/
170-
171-
# PyCharm
172-
# JetBrains specific template is maintained in a separate JetBrains.gitignore that can
173-
# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
174-
# and can be added to the global gitignore or merged into this file. For a more nuclear
175-
# option (not recommended) you can uncomment the following to ignore the entire idea folder.
176-
#.idea/
177-
178-
# Abstra
179-
# Abstra is an AI-powered process automation framework.
180-
# Ignore directories containing user credentials, local state, and settings.
181-
# Learn more at https://abstra.io/docs
182-
.abstra/
183-
184-
# Visual Studio Code
185-
# Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
186-
# that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
187-
# and can be added to the global gitignore or merged into this file. However, if you prefer,
188-
# you could uncomment the following to ignore the entire vscode folder
189-
# .vscode/
190-
191-
# Ruff stuff:
192-
.ruff_cache/
193-
194-
# PyPI configuration file
195-
.pypirc
196-
197-
# Cursor
198-
# Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
199-
# exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
200-
# refer to https://docs.cursor.com/context/ignore-files
201-
.cursorignore
202-
.cursorindexingignore
203-
204-
# Marimo
205-
marimo/_static/
206-
marimo/_lsp/
207-
__marimo__/
8+
dist/
9+
build/
10+
.DS_Store
11+
.idea/
12+
.vscode/
13+
*.log
14+
runs/
15+
*.jsonl

‎CITATION.cff‎

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,25 @@
11
cff-version: 1.2.0
2-
title: NVIDIA Quantum Hybrid
3-
message: "If you use this repository, please cite it."
2+
title: NVIDIA CUDA-Q Quantum Guard
3+
message: "If you use or adapt this software, please cite it."
4+
type: software
5+
version: 0.4.0
46
authors:
57
- family-names: Kaczmarek
68
given-names: Sylvester
79
orcid: https://orcid.org/0000-0002-0393-228X
8-
doi: 10.5281/zenodo.17502919
9-
date-released: 2025-11-01
10-
url: https://github.com/sylvesterkaczmarek/nvidia-quantum-hybrid
1110
license: MIT
12-
type: software
11+
doi: 10.5281/zenodo.17502919
12+
url: https://github.com/sylvesterkaczmarek/nvidia-cudaq-quantum-guard
13+
repository-code: https://github.com/sylvesterkaczmarek/nvidia-cudaq-quantum-guard
1314
preferred-citation:
14-
type: article
15-
title: NVIDIA Quantum Hybrid
15+
type: software
16+
title: NVIDIA CUDA-Q Quantum Guard
1617
authors:
1718
- family-names: Kaczmarek
1819
given-names: Sylvester
1920
orcid: https://orcid.org/0000-0002-0393-228X
2021
year: 2025
22+
publisher:
23+
name: Zenodo
2124
doi: 10.5281/zenodo.17502919
25+
url: https://doi.org/10.5281/zenodo.17502919

‎CONTRIBUTING.md‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Contributing
2+
3+
Contributions are welcome when they improve practical CUDA-Q execution control, diagnostics, provenance, or reproducibility.
4+
5+
## Development setup
6+
7+
```bash
8+
python -m venv .venv
9+
source .venv/bin/activate
10+
python -m pip install -e ".[dev]"
11+
python -m pytest
12+
```
13+
14+
For real CUDA-Q smoke tests:
15+
16+
```bash
17+
python -m pip install -e ".[cudaq,dev]"
18+
cudaq-guard doctor
19+
make smoke
20+
```
21+
22+
## Design rules
23+
24+
- fail closed rather than silently changing target or policy
25+
- keep credentials out of logs and fixtures
26+
- do not claim a security property that the code does not enforce
27+
- keep core policy/audit code usable without a CUDA-Q installation
28+
- add regression tests for policy semantics and execution adapters
29+
- keep provider-specific assumptions behind explicit configuration
30+
31+
If a change alters the audit schema or policy semantics, document the compatibility impact in the pull request.

‎LICENSE‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
MIT License
22

3-
Copyright (c) 2025 Sylvester Kaczmarek
3+
Copyright (c) 2026 Sylvester Kaczmarek
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

‎Makefile‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
.PHONY: install install-cudaq test smoke doctor build clean
2+
3+
install:
4+
python -m pip install -e ".[dev]"
5+
6+
install-cudaq:
7+
python -m pip install -e ".[cudaq,dev]"
8+
9+
test:
10+
python -m pytest
11+
12+
smoke:
13+
cudaq-guard run ghz --policy policies/local-safe.toml --target qpp-cpu --qubits 3 --shots 256 --seed 7 --audit /tmp/cudaq-guard-audit.jsonl
14+
cudaq-guard audit verify /tmp/cudaq-guard-audit.jsonl
15+
16+
doctor:
17+
cudaq-guard doctor
18+
19+
build:
20+
python -m build
21+
22+
clean:
23+
rm -rf build dist *.egg-info .pytest_cache

0 commit comments

Comments
 (0)