Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions qet-bench/CITATION.cff
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,10 @@ license: MIT
abstract: "A reproducible benchmark suite for minimal two-qubit Quantum Energy Teleportation with explicit ground-state energy accounting."
repository-code: "https://github.com/lucent-lab/qet-bench"
url: "https://github.com/lucent-lab/qet-bench"
identifiers:
- type: swh
value: "swh:1:snp:9636ad3f493c249270cba77ae4810908dce45834"
description: "Software Heritage archived snapshot for the v0.2.0 review release."
preferred-citation:
type: software
title: "qet-bench: Reproducible exact two-qubit Quantum Energy Teleportation benchmarks"
Expand Down
4 changes: 2 additions & 2 deletions qet-bench/docs/blocker_ledger.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,8 +31,8 @@ Current release identity:
| Missing exact benchmark implementation and regression fixtures | Without exact values, the package cannot serve as a reproducible QET benchmark. | Closed | Core software | Implemented exact Hamiltonian, ground state, QET ledger, benchmark CSV, figures, and regression tests. | `v0.1.0` |
| No explicit no-free-energy accounting guardrail | QET is easy to overstate if Alice injection and global accounting are omitted. | Closed | Scientific framing | README, docs, tests, and paper state that Bob extraction is paid for by Alice measurement/control resources and check `E_A >= E_B` for the exact benchmark. | `v0.1.0` |
| Missing artifact provenance | Reviewers need to know which script generated each CSV/figure and what each artifact validates. | Closed | Reproducibility | Added artifact manifest mapping outputs to generators, validation coverage, and supported claims. | `v0.1.0` |
| Hosted CI unavailable because of quota | Hosted CI gives reviewers an independent, visible validation path; local-only validation is weaker. | Closed | Review infrastructure | Repository visibility was changed to public and GitHub Actions passed on Python 3.11 and 3.12. | hosted run <https://github.com/lucent-lab/qet-bench/actions/runs/24507308274> |
| Release archive DOI or Software Heritage ID missing | A GitHub tag is useful, but archival review generally needs a persistent citation target. | Open | Publication metadata | Archive the selected review snapshot, then update `CITATION.cff`, `paper.md`, `paper/README.md`, `research_roadmap.md`, and this ledger. | pending |
| Hosted CI unavailable because of quota | Hosted CI gives reviewers an independent, visible validation path; local-only validation is weaker. | Closed | Review infrastructure | Repository visibility was changed to public and GitHub Actions passed on Python 3.11 and 3.12. | hosted run <https://github.com/lucent-lab/qet-bench/actions/runs/24507440880> |
| Release archive DOI or Software Heritage ID missing | A GitHub tag is useful, but archival review generally needs a persistent citation target. | Closed | Publication metadata | Software Heritage archived the public repository after the `v0.2.0` GitHub release. A Zenodo DOI can still be added later if the GitHub-Zenodo integration is enabled. | `swh:1:snp:9636ad3f493c249270cba77ae4810908dce45834` |
| Repository access for external review | Reviewers cannot inspect a private repository unless explicit access is granted. | Closed | Review logistics | Repository visibility is public and the root README now points to package docs, validation records, and manuscript sources. | <https://github.com/lucent-lab/qet-bench> |
| Placeholder software citation metadata | Citation metadata must identify a real citable artifact and author record. | Mitigated | Publication metadata | Replaced placeholder contributor author with provisional author metadata and added preferred software citation fields. Add DOI once archived. | `v0.2.0-paper-review` |
| Manuscript venue ambiguity | Trying to satisfy JOSS, ReScience, and SoftwareX simultaneously weakens the paper. | Mitigated | Manuscript | Reframed `paper.md` as JOSS-style source and moved ReScience/SoftwareX notes to build/readiness documentation. | `v0.2.0-paper-review` |
Expand Down
10 changes: 9 additions & 1 deletion qet-bench/docs/release_validation.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,19 @@ Hosted CI status:

- Workflow: `.github/workflows/ci.yml`
- Passing run:
<https://github.com/lucent-lab/qet-bench/actions/runs/24507308274>
<https://github.com/lucent-lab/qet-bench/actions/runs/24507440880>
- Result: Python 3.11 and Python 3.12 jobs passed. GitHub emitted a
non-blocking Node.js 20 deprecation warning for `actions/checkout@v4` and
`actions/setup-python@v5`.

Archive status:

- GitHub release: <https://github.com/lucent-lab/qet-bench/releases/tag/v0.2.0>
- Software Heritage snapshot:
`swh:1:snp:9636ad3f493c249270cba77ae4810908dce45834`
- Software Heritage save request:
<https://archive.softwareheritage.org/api/1/origin/save/2305260/>

Local CI mirror:

| Python | Environment | Commands | Result |
Expand Down
7 changes: 4 additions & 3 deletions qet-bench/docs/research_roadmap.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,15 +30,16 @@ Current release identity:
| Stage | Status | Reproduction Or New Territory | Deliverable | Reference |
|---|---|---|---|---|
| Exact two-qubit QET benchmark package | Done | Reproduction | Minimal exact simulator, Hamiltonians, ledgers, null tests, count estimators, deterministic benchmark scripts, generated artifacts, artifact manifest. | `v0.1.0` |
| Repository hygiene and local CI path | Done | Reproduction hardening | `.gitignore`, GitHub Actions workflow, pinned requirements lock, local CI recipe for Python 3.11 and 3.12, and hosted CI workflow. | `v0.1.0`; hosted run <https://github.com/lucent-lab/qet-bench/actions/runs/24507308274> |
| Repository hygiene and local CI path | Done | Reproduction hardening | `.gitignore`, GitHub Actions workflow, pinned requirements lock, local CI recipe for Python 3.11 and 3.12, and hosted CI workflow. | `v0.1.0`; hosted run <https://github.com/lucent-lab/qet-bench/actions/runs/24507440880> |
| Controller accounting extension | Done | Accounting extension; not new microscopic physics | Conservative nonnegative controller-cost ledger and documentation. Reports diagnostic net battery gain without claiming a hardware battery model. | `v0.1.0` |
| Manuscript release provenance | Done | Publication hardening | Paper build notes, release-provenance wording, local verification record, and submission-risk notes. | `v0.2.0-manuscript` |
| Independent pure-Python reference branch | Done | Reproduction cross-check | Branch-amplitude implementation independent of the NumPy matrix propagation path, with benchmark and branch-audit artifacts. | `v0.2.0-manuscript` |
| Optional Qiskit/Aer interoperability bridge | Done | Reproduction/interoperability | Lazy optional Qiskit/Aer adapter, count-key canonicalizer, branch-resolved ideal-circuit script, docs, and tests that pass without Qiskit installed. | `v0.2.0-qiskit-bridge` |
| Fixed-protocol noise-survival atlas | Done | New simulation diagnostic; not a universal threshold result | Anchor-aware survival curves and summaries across a predeclared `(h, k)` set, interval-averaged survival ratios, and small-multiples figures. | `v0.2.0-noise-atlas` |
| JOSS-style manuscript hardening | Done | Publication hardening | JOSS-shaped `paper.md`, stricter venue notes, claim-to-artifact map, quality-control table, expanded citation metadata, and contribution guidelines. | `v0.2.0-paper-review` |
| Public archive and DOI | Processing | Publication hardening | Archive the chosen review snapshot with Zenodo, Software Heritage, or equivalent; update `CITATION.cff`, `paper.md`, and this register with DOI/SWHID. | pending |
| Hosted CI revalidation | Done | Reproduction hardening | GitHub Actions passed on Python 3.11 and 3.12 after the repository was made public; `release_validation.md` records the hosted and local validation details. | hosted run <https://github.com/lucent-lab/qet-bench/actions/runs/24507308274> |
| Public Software Heritage archive | Done | Publication hardening | Archived the public repository after the `v0.2.0` GitHub release and recorded the snapshot identifier in citation and manuscript metadata. | `swh:1:snp:9636ad3f493c249270cba77ae4810908dce45834` |
| Zenodo DOI | Processing | Publication hardening | Enable the Zenodo GitHub integration for `lucent-lab/qet-bench` if a DOI is required in addition to the Software Heritage identifier. | pending |
| Hosted CI revalidation | Done | Reproduction hardening | GitHub Actions passed on Python 3.11 and 3.12 after the repository was made public; `release_validation.md` records the hosted and local validation details. | hosted run <https://github.com/lucent-lab/qet-bench/actions/runs/24507440880> |
| Optional Aer smoke artifact with Qiskit installed | Processing | Reproduction/interoperability | Local Python 3.12.8 smoke passed with `qiskit==2.3.1` and `qiskit-aer==0.17.2`; document the generated comparison artifact and close after merge/tag. | pending |
| ReScience-style reproducibility package | Processing | Reproduction publication | `paper/rescience.md` frames the work as an exact reproduction of the two-qubit QET benchmark with validation artifacts and bounded novelty claims; close after merge/tag and final author metadata confirmation. | pending |
| Full microscopic controller/environment ledger | Not done | New methods territory | Replace conservative bookkeeping diagnostics with an explicit modeled controller, memory reset, pulse, and environment exchange ledger. | none |
Expand Down
6 changes: 3 additions & 3 deletions qet-bench/paper/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,10 +47,10 @@ The paper text is not yet a final submission. The hard blockers are:
| Area | Required before submission |
|---|---|
| Author metadata | Confirm author list, affiliations, ORCID identifiers, and corresponding author. |
| Archival DOI | Archive the target release with Zenodo, Software Heritage, or equivalent and update the paper metadata. |
| Archival identifier | Closed for Software Heritage: `swh:1:snp:9636ad3f493c249270cba77ae4810908dce45834`. A Zenodo DOI can be added later if required. |
| Repository access | Closed: the GitHub repository is public at <https://github.com/lucent-lab/qet-bench>. |
| Public history | JOSS currently screens for sustained public development history and research impact; submit to JOSS only after those signals exist. |
| Hosted CI | Re-run GitHub Actions when quota is available, or clearly document local CI as the validation record for a reproducibility venue. |
| Hosted CI | Closed: GitHub Actions passed on Python 3.11 and 3.12 for the `v0.2.0` tag. |
| Community guidelines | Keep `../CONTRIBUTING.md` current and make sure issue reporting and contribution workflow are visible from the repository root. |
| Funding/COI | Replace the draft acknowledgement with explicit funding and conflict statements. |
| AI disclosure | Human author must verify the AI usage disclosure is complete and accurate. |
Expand All @@ -69,7 +69,7 @@ python scripts/make_all_figures.py
These commands were run locally on Python 3.11 and Python 3.12. Hosted GitHub
Actions passed on Python 3.11 and Python 3.12 after the repository was made
public:
<https://github.com/lucent-lab/qet-bench/actions/runs/24507308274>.
<https://github.com/lucent-lab/qet-bench/actions/runs/24507440880>.

## Venue Fit

Expand Down
3 changes: 3 additions & 0 deletions qet-bench/paper/paper.md
Original file line number Diff line number Diff line change
Expand Up @@ -133,6 +133,9 @@ earlier clean reproducibility baseline is tagged as `v0.1.0`. Generated
artifacts are tracked for reviewer convenience, but the source of truth is the
package code, tests, scripts, lock file, and artifact manifest.

The public repository has been archived by Software Heritage with snapshot
identifier `swh:1:snp:9636ad3f493c249270cba77ae4810908dce45834`.

The local reproduction path is:

```bash
Expand Down
Loading