From beffe51127002d37bca104118d1b4a1998b5a7e3 Mon Sep 17 00:00:00 2001 From: Francois Date: Thu, 16 Apr 2026 20:07:38 +0900 Subject: [PATCH 1/6] Add vacuum investigation roadmap --- qet-bench/README.md | 7 +- qet-bench/docs/research_roadmap.md | 5 +- .../docs/vacuum_investigation_roadmap.md | 313 ++++++++++++++++++ 3 files changed, 322 insertions(+), 3 deletions(-) create mode 100644 qet-bench/docs/vacuum_investigation_roadmap.md diff --git a/qet-bench/README.md b/qet-bench/README.md index 9b33326..a5dab4b 100644 --- a/qet-bench/README.md +++ b/qet-bench/README.md @@ -45,8 +45,11 @@ See [docs/artifact_manifest.md](docs/artifact_manifest.md) for the full CSV/figure provenance table. See [docs/research_roadmap.md](docs/research_roadmap.md) for the maintained roadmap table that separates reproduction work from new research territory and -records milestone tags. See [docs/blocker_ledger.md](docs/blocker_ledger.md) -for the maintained review/submission blocker ledger. +records milestone tags. See +[docs/vacuum_investigation_roadmap.md](docs/vacuum_investigation_roadmap.md) +for the step-by-step path from QET benchmarks toward deeper vacuum-energy +accounting audits. See [docs/blocker_ledger.md](docs/blocker_ledger.md) for +the maintained review/submission blocker ledger. ## Optional Qiskit/Aer Bridge diff --git a/qet-bench/docs/research_roadmap.md b/qet-bench/docs/research_roadmap.md index be23100..2722a4a 100644 --- a/qet-bench/docs/research_roadmap.md +++ b/qet-bench/docs/research_roadmap.md @@ -4,7 +4,9 @@ This register tracks the project roadmap at publication granularity. It should be updated whenever a stage changes status, a release tag is cut, or an archive DOI becomes available. -For review risks and submission blockers, see `blocker_ledger.md`. +For the step-by-step path from the QET benchmark into broader void/vacuum +energy-accounting work, see `vacuum_investigation_roadmap.md`. For review risks +and submission blockers, see `blocker_ledger.md`. Status values: @@ -35,6 +37,7 @@ Reference policy: | 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 | | Many-qubit QET extension | Not done | New physics/simulation territory | Extend beyond two qubits to chains or network geometries, with explicit local-energy partitions and finite-size/scaling diagnostics. | none | | Finite-temperature or mixed-state QET | Not done | New physics/simulation territory | Study thermal or mixed resource states and compare extraction/accounting behavior against the pure ground-state benchmark. | none | +| DCE/Casimir/ultrastrong-coupling audit module | Not done | New vacuum-mechanism audit territory | Add a separate module that tracks pump, switching, reset, and environment work for one non-QET vacuum-adjacent mechanism. | none | | Hardware or hardware-faithful execution | Not done | New experimental/hardware-simulation territory | Define a circuit/backend protocol, calibration assumptions, count-processing path, and bounded interpretation for real or hardware-faithful execution. | none | ## Maintenance Checklist diff --git a/qet-bench/docs/vacuum_investigation_roadmap.md b/qet-bench/docs/vacuum_investigation_roadmap.md new file mode 100644 index 0000000..ed5bc6a --- /dev/null +++ b/qet-bench/docs/vacuum_investigation_roadmap.md @@ -0,0 +1,313 @@ +# Vacuum-Investigation Roadmap + +This document explains how `qet-bench` can grow from an exact two-qubit QET +benchmark into a broader void/vacuum energy-accounting research program without +turning into a collection of overbroad claims. + +The organizing rule is: + +```text +Every stage must define the system, controller, environment, memory/reset path, +load or battery, cycle condition, and net energy ledger. +``` + +The project should not claim autonomous vacuum power unless a closed cyclic +protocol returns every non-load degree of freedom to its initial state while a +load ends with net positive stored energy. Nothing in the current repository +claims that. + +## Stage 0: Exact QET Benchmark Foundation + +**Status:** done. + +**Purpose:** establish a minimal, auditable model where ground-state +correlations enable Bob-side local energy extraction after Alice measurement and +classical feedforward. + +**Current deliverables:** + +- exact two-qubit Hamiltonian and analytic ground state, +- Alice measurement and Bob conditional rotation, +- unconditional branch averaging with no postselection, +- ledger terms `E_A`, `H1`, `V`, `E1`, `E_B`, and `E_A - E_B`, +- null tests, noise diagnostics, count estimators, reproducible artifacts, +- independent pure-Python reference branch, +- optional Qiskit/Aer interoperability bridge. + +**Done criteria:** + +- local and CI-style tests pass, +- benchmark CSV values reproduce the documented numbers, +- figure scripts regenerate deterministic artifacts, +- documentation states clearly that QET is not a free-energy source. + +**Failure modes to keep blocked:** + +- postselection, +- hidden sign or bit-ordering errors, +- presenting `E_B > 0` without `E_A - E_B`, +- describing this as direct vacuum-power extraction. + +## Stage 1: Publication and Archive Hardening + +**Status:** processing. + +**Purpose:** make the foundation citable and reviewable before adding more +physics surface area. + +**Deliverables:** + +- archived release snapshot with DOI or Software Heritage identifier, +- hosted CI revalidation or documented local substitute, +- JOSS/ReScience/SoftwareX-style manuscript package, +- complete artifact manifest and blocker ledger, +- clear repository description that says this is ground-state energy-accounting + research, with QET as the first deliverable. + +**Done criteria:** + +- `CITATION.cff`, manuscript, and roadmap register point at the archive, +- generated artifacts match the release scripts, +- unresolved blockers are either closed or explicitly carried forward. + +**Why this comes before more vacuum work:** publication hardening makes the +project's accounting discipline inspectable. Without this baseline, later +vacuum-mechanism modules would inherit uncertainty about conventions, +reproducibility, and overclaiming. + +## Stage 2: Controller-Inclusive QET Ledger + +**Status:** partially started; current module is conservative bookkeeping, not a +microscopic controller model. + +**Purpose:** deepen from protocol-level accounting to apparatus-level +accounting. + +**Question:** + +```text +After measurement, feedforward, pulse generation, memory, reset, and +controller overheads are counted, what is the net battery/load balance? +``` + +**Minimum model elements:** + +- Alice measurement cost or injected energy, +- classical memory and reset cost, +- communication/feedforward control cost, +- Bob pulse/control cost, +- bath or refrigeration cost if reset/cooling is assumed, +- explicit nonnegative overhead terms, +- diagnostic `net_battery_gain = E_B - E_A - overhead`. + +**Done criteria:** + +- ledger schema is documented, +- all overhead terms have units and sign conventions, +- null tests show that turning off entanglement or scrambling the bit removes + the QET-specific signal, +- no result is described as a closed hardware battery unless a physical battery + model exists. + +**What would count as new territory:** a clean controller-inclusive inequality +or reusable accounting framework that can compare QET variants without hiding +measurement, reset, or pulse costs. + +## Stage 3: Explicit Battery-Coupled QET + +**Status:** not done. + +**Purpose:** replace bookkeeping-only `net_battery_gain` diagnostics with an +actual load or battery degree of freedom. + +**Question:** + +```text +Can Bob's local extraction be deposited into an explicit load while the full +system-controller-battery ledger remains thermodynamically consistent? +``` + +**Candidate models:** + +- two-level battery coupled locally to Bob, +- harmonic-oscillator load, +- explicit time-dependent Bob coupling pulse, +- open-system reset model for Alice and the controller. + +**Required outputs:** + +- final battery energy, +- controller work, +- reset/bath exchange, +- leakage/cross-talk diagnostics, +- comparison to the original two-qubit exact ledger. + +**Done criteria:** + +- the battery model is explicit in the Hamiltonian or master equation, +- the cycle condition is stated, +- `net_battery_gain` is computed from modeled terms rather than placeholders, +- entanglement-off and feedforward-scrambled null tests fail as expected. + +**What would count as new territory:** a reproducible battery-coupled QET model +that separates local work storage from measurement/controller resources. + +## Stage 4: Many-Body, Distance, and Finite-Temperature QET + +**Status:** not done. + +**Purpose:** test whether the two-qubit effect survives more realistic +ground-state structure, separation, noise, and imperfect initialization. + +**Questions:** + +- How does `E_B` scale with Alice-Bob distance? +- Which local-energy partition is being measured? +- How do finite temperature and mixed states change the ledger? +- Does controller cost dominate faster than extractable local energy grows? + +**Candidate implementations:** + +- exact diagonalization for small chains, +- tensor-network methods for larger one-dimensional systems, +- finite-temperature density matrices for small systems, +- equalized-noise comparisons across sizes and distances. + +**Done criteria:** + +- the two-qubit benchmark remains a regression anchor, +- local Hamiltonian terms and energy partitions are documented, +- distance and temperature sweeps include null tests, +- claims are about scaling diagnostics, not free energy. + +**What would count as new territory:** a scaling law, bound, or negative result +that explains when QET-style local extraction is practically suppressed. + +## Stage 5: Vacuum-Mechanism Audit Modules + +**Status:** not done. + +**Purpose:** move beyond QET into other vacuum-adjacent mechanisms while keeping +the same ledger discipline. + +Each module should be separate from the exact QET core and should have its own +artifact manifest, null tests, and no-free-energy statement. + +### Dynamical Casimir Effect Audit + +**Question:** when photons are produced from an initial vacuum by a time-varying +boundary or coupling, does the pump/controller work account for the emitted +energy? + +**Required ledger:** + +```text +W_controller, E_field, losses, reset cost, final pump/controller state +``` + +**Done criteria:** photon production tracks the drive work; no output is +described as vacuum-alone energy. + +### Casimir or Material-Switching Audit + +**Question:** can a material, geometry, or boundary-switching cycle extract net +work after switching and reset costs are included? + +**Required ledger:** + +```text +mechanical work, material switching/free-energy cost, dissipation, reset work +``` + +**Done criteria:** the model distinguishes one-shot relaxation from a closed +cycle. + +### Ultrastrong-Coupling Discharge Audit + +**Question:** can dressed ground-state excitations be released after a coupling +quench, and is the output explained by coupling-switch work? + +**Required ledger:** + +```text +coupling-switch work, emitted excitation energy, dissipation, re-dressing cost +``` + +**Done criteria:** output is compared against the full switching protocol, not +against the field vacuum alone. + +**What would count as new territory:** a reusable audit showing exactly where +candidate vacuum-energy mechanisms get their energy under closed-cycle +bookkeeping. + +## Stage 6: Hardware-Faithful or Experimental Work + +**Status:** not done. + +**Purpose:** validate a narrow protocol or audit method against realistic +control, noise, and measurement constraints. + +**Required before starting:** + +- exact model passes, +- controller/battery ledger is explicit, +- bit-order and count-processing conventions are tested, +- hardware-independent null tests are defined, +- acceptable interpretation limits are written before looking at data. + +**Candidate targets:** + +- Qiskit/Aer noisy simulation, +- IBM-style small-QPU reproduction, +- superconducting-circuit QET or DCE-inspired model, +- quantum Hall or edge-channel QET-inspired model. + +**Done criteria:** + +- calibration and uncertainty assumptions are documented, +- direct leakage and cross-talk baselines are included, +- entanglement-off and scrambled-control nulls are included, +- the result is described as hardware validation or falsification, not proof of + autonomous vacuum power. + +## Closed-Cycle Acceptance Criterion + +For any future vacuum-energy claim, the acceptance criterion is: + +```text +net_load_gain = + load_energy_gain + - controller_work + - measurement_and_reset_cost + - switching_or_boundary_work + - bath_or_refrigeration_cost + - leakage_and_calibration_allowances +``` + +A claim only enters "possible vacuum-energy work extraction" territory if all of +these are true: + +1. `net_load_gain > 0` with uncertainty bounds. +2. The protocol is cyclic for every non-load degree of freedom. +3. Entanglement-off, no-drive, scrambled-control, and classical-leakage nulls + fail to explain the signal. +4. The source of energy cannot be attributed to a pump, controller, prepared + non-passive state, thermal bath, reset process, or boundary switching. + +The expected outcome under known physics is that candidate mechanisms fail this +criterion. A well-documented failure is still a valid research output because it +identifies exactly which resource pays. + +## Recommended Next Sequence + +1. Finish archive/DOI and hosted CI revalidation for the current QET benchmark. +2. Promote the controller-cost ledger from conservative bookkeeping to an + explicit controller/environment model. +3. Build an explicit battery-coupled QET model. +4. Add many-body, distance, and finite-temperature QET studies only after the + battery ledger is clear. +5. Start a separate DCE pump-work audit or Casimir switching-work audit as the + first non-QET vacuum-mechanism module. +6. Treat hardware work as validation after the ledger and null tests are + already specified. + From 14914c4d3bb1e60ea1a9396fd3537a8f2fdda5e5 Mon Sep 17 00:00:00 2001 From: Francois Date: Thu, 16 Apr 2026 20:11:26 +0900 Subject: [PATCH 2/6] Reconcile v0.2.0 publication metadata --- README.md | 43 ++++++++++++++++++++++++++++ qet-bench/CITATION.cff | 10 +++---- qet-bench/README.md | 2 ++ qet-bench/docs/artifact_manifest.md | 4 +-- qet-bench/docs/blocker_ledger.md | 4 +-- qet-bench/docs/qiskit_interop.md | 15 ++++++++++ qet-bench/docs/release_validation.md | 37 ++++++++++++++++++++++++ qet-bench/docs/research_roadmap.md | 9 +++--- qet-bench/paper/README.md | 12 +++++--- qet-bench/paper/paper.md | 23 ++++++++------- qet-bench/pyproject.toml | 4 +-- qet-bench/src/qet_bench/__init__.py | 2 +- 12 files changed, 134 insertions(+), 31 deletions(-) create mode 100644 README.md create mode 100644 qet-bench/docs/release_validation.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..7529db3 --- /dev/null +++ b/README.md @@ -0,0 +1,43 @@ +# qet-bench + +This repository hosts `qet-bench`, a reproducible benchmark suite for the +minimal two-qubit Quantum Energy Teleportation (QET) protocol. + +The package lives in [`qet-bench/`](qet-bench/). It implements the exact +Hamiltonian model, Alice measurement, classical feedforward, Bob rotation, +energy ledger, null tests, count estimators, deterministic artifact scripts, +an independent pure-Python reference branch, and an optional Qiskit/Aer +interoperability bridge. + +The scientific scope is intentionally narrow: `qet-bench` demonstrates +Bob-side local energy extraction from ground-state correlations while keeping +the global ledger explicit. It does not claim autonomous vacuum power or a +hardware energy source. + +## Quickstart + +```bash +cd qet-bench +python -m pip install -e ".[dev]" -c requirements-lock.txt +python -m pytest +python scripts/reproduce_benchmarks.py +python scripts/make_all_figures.py +``` + +Optional Qiskit/Aer smoke check: + +```bash +cd qet-bench +python -m pip install -e ".[qiskit]" -c requirements-lock.txt +python scripts/run_qiskit_bridge.py +``` + +## Review Materials + +- [Package README](qet-bench/README.md) +- [Artifact manifest](qet-bench/docs/artifact_manifest.md) +- [Release validation log](qet-bench/docs/release_validation.md) +- [Research roadmap register](qet-bench/docs/research_roadmap.md) +- [Blocker ledger](qet-bench/docs/blocker_ledger.md) +- [Manuscript draft](qet-bench/paper/paper.md) +- [Manuscript build notes](qet-bench/paper/README.md) diff --git a/qet-bench/CITATION.cff b/qet-bench/CITATION.cff index a4b467a..e331299 100644 --- a/qet-bench/CITATION.cff +++ b/qet-bench/CITATION.cff @@ -1,20 +1,20 @@ cff-version: 1.2.0 message: "If you use qet-bench, please cite this software." -title: "qet-bench: Exact two-qubit Quantum Energy Teleportation benchmarks" -version: "0.2.0-noise-atlas" +title: "qet-bench: Reproducible exact two-qubit Quantum Energy Teleportation benchmarks" +version: "0.2.0" date-released: 2026-04-16 authors: - family-names: "Gueguen" given-names: "Francois" affiliation: "Lucent Lab" license: MIT -abstract: "A reproducible benchmark suite for minimal two-qubit Quantum Energy Teleportation with explicit energy accounting." +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" preferred-citation: type: software - title: "qet-bench: Exact two-qubit Quantum Energy Teleportation benchmarks" - version: "0.2.0-noise-atlas" + title: "qet-bench: Reproducible exact two-qubit Quantum Energy Teleportation benchmarks" + version: "0.2.0" date-released: 2026-04-16 authors: - family-names: "Gueguen" diff --git a/qet-bench/README.md b/qet-bench/README.md index a5dab4b..c0e6c3b 100644 --- a/qet-bench/README.md +++ b/qet-bench/README.md @@ -46,6 +46,8 @@ CSV/figure provenance table. See [docs/research_roadmap.md](docs/research_roadmap.md) for the maintained roadmap table that separates reproduction work from new research territory and records milestone tags. See +[docs/release_validation.md](docs/release_validation.md) for the current local +validation log while hosted GitHub Actions runners are unavailable. See [docs/vacuum_investigation_roadmap.md](docs/vacuum_investigation_roadmap.md) for the step-by-step path from QET benchmarks toward deeper vacuum-energy accounting audits. See [docs/blocker_ledger.md](docs/blocker_ledger.md) for diff --git a/qet-bench/docs/artifact_manifest.md b/qet-bench/docs/artifact_manifest.md index aee320a..08a7a67 100644 --- a/qet-bench/docs/artifact_manifest.md +++ b/qet-bench/docs/artifact_manifest.md @@ -10,8 +10,8 @@ except `benchmarks.csv`, which is generated by ## Generated-Artifact Policy The committed `results/` files are release artifacts for reviewer convenience: -they are generated outputs, but they are intentionally tracked in the `v0.1.0` -snapshot so the benchmark values and figures can be inspected without rerunning +they are generated outputs, but they are intentionally tracked in release +snapshots so the benchmark values and figures can be inspected without rerunning the package. The source of truth remains the Python package, scripts, tests, and pinned install path. Regenerating the artifacts with the commands below should produce no git diff: diff --git a/qet-bench/docs/blocker_ledger.md b/qet-bench/docs/blocker_ledger.md index 3955438..0596da7 100644 --- a/qet-bench/docs/blocker_ledger.md +++ b/qet-bench/docs/blocker_ledger.md @@ -25,7 +25,7 @@ Reference policy: | 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. | Open | Review infrastructure | Re-run GitHub Actions when quota permits and record the run URL or badge. Keep local Python 3.11/3.12 CI as the interim validation record. | pending | +| Hosted CI unavailable because of quota | Hosted CI gives reviewers an independent, visible validation path; local-only validation is weaker. | Open | Review infrastructure | Hosted jobs currently fail before execution because account billing/spending limit blocks runners. Re-run GitHub Actions when quota permits and record the successful run URL or badge. Keep local Python 3.11/3.12 CI as the interim validation record. | blocked run | | 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 | | Repository access for external review | Reviewers cannot inspect a private repository unless explicit access is granted. | Open | Review logistics | Make the repository public or grant reviewer access before submission. | pending | | 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` | @@ -38,7 +38,7 @@ Reference policy: | Noise-survival wording could imply universal thresholds | Fixed-protocol simulated diagnostics are not theorem-level thresholds or hardware phase boundaries. | Mitigated | Noise diagnostics | Added anchor-aware atlas wording, interval-average definitions, and repeated non-universal/fixed-protocol language. | `v0.2.0-noise-atlas` | | Roadmap status was not maintained in a single table | Without a maintained status table, reproduction work and new research territory blur over time. | Closed | Project management | Added `research_roadmap.md` with stage status, classification, deliverable, and release reference. | `v0.2.0-roadmap-register` | | Blockers were only reported in chat, not tracked in-repo | Chat-only blocker lists are easy to lose and cannot be audited per release. | Processing | Project management | Maintain this blocker ledger and update it when a blocker changes status or is resolved by a tag, commit, DOI, run URL, or paper reference. | pending | -| Optional Aer smoke artifact with Qiskit installed missing | The optional bridge has no positive-path artifact unless Qiskit/Aer is installed and run. | Processing | Interoperability | Run the optional Qiskit extra in a disposable environment and add or document the smoke artifact if stable. | pending | +| Optional Aer smoke artifact with Qiskit installed missing | The optional bridge has no positive-path artifact unless Qiskit/Aer is installed and run. | Mitigated | Interoperability | Local Python 3.12.8 smoke passed with `qiskit==2.3.1` and `qiskit-aer==0.17.2`; `qiskit_interop.md` records the generated CSV path and observed absolute `E_B` errors. Decide during archival whether to force-add optional generated artifacts. | pending merge/tag | | JOSS public-history / external-impact evidence is thin | Some venues screen for sustained public development and evidence of research use. | Open | Venue fit | Prefer ReScience-style reproducibility review first, or wait for public history/adoption before JOSS submission. | pending | | ReScience-specific reproduced-result framing missing | ReScience-style review needs a crisp statement of the original result being reproduced. | Processing | Manuscript | Adapt the JOSS-style source into a ReScience-oriented submission package naming the reproduced QET benchmark and artifacts. | pending | | Full microscopic controller/environment ledger missing | Conservative bookkeeping is not a microscopic hardware or thermodynamic environment model. | Open | New methods research | Design and implement an explicit controller, memory, pulse, reset, and environment ledger before making stronger thermodynamic claims. | none | diff --git a/qet-bench/docs/qiskit_interop.md b/qet-bench/docs/qiskit_interop.md index 72dfc80..bec85b8 100644 --- a/qet-bench/docs/qiskit_interop.md +++ b/qet-bench/docs/qiskit_interop.md @@ -47,3 +47,18 @@ The optional Aer script is therefore a simulator-interoperability diagnostic, not a replacement for the exact ledger and not a hardware execution protocol. As in the rest of the package, no result is interpreted as free energy: Bob's local extraction is reported against the Alice-side measurement/control ledger. + +## Local Smoke Record + +For the `0.2.0` review target, the optional bridge was smoke-tested locally on +Python 3.12.8 with `qiskit==2.3.1` and `qiskit-aer==0.17.2`: + +```bash +python -m pip install -e ".[qiskit]" -c requirements-lock.txt +python scripts/run_qiskit_bridge.py +``` + +The script wrote `results/data/qiskit_bridge_benchmarks.csv` with absolute +`E_B` errors of approximately `0.01553` for `(h=1, k=0.5)` and `0.00279` for +`(h=1, k=1)`. This CSV is generated under the ignored `results/` tree unless a +future release deliberately archives optional interoperability artifacts. diff --git a/qet-bench/docs/release_validation.md b/qet-bench/docs/release_validation.md new file mode 100644 index 0000000..8eb440c --- /dev/null +++ b/qet-bench/docs/release_validation.md @@ -0,0 +1,37 @@ +# Release Validation Log + +This log records local validation for review snapshots while hosted GitHub +Actions jobs are unavailable. Hosted CI remains the preferred independent +validation path once account billing/quota allows runners to start. + +## v0.2.0 Review Target + +Date: 2026-04-16 + +Hosted CI status: + +- Workflow: `.github/workflows/ci.yml` +- Latest hosted run checked: + +- Result: jobs did not start because the account billing/spending limit blocked + hosted runners. + +Local CI mirror: + +| Python | Environment | Commands | Result | +|---|---|---|---| +| 3.11.6 | `/tmp/qet-bench-py311` | `pip install -e ".[dev]" -c requirements-lock.txt`; `pytest`; `scripts/reproduce_benchmarks.py`; `scripts/make_all_figures.py` | `40 passed, 1 skipped`; benchmark and figure scripts completed with no tracked artifact diff. | +| 3.12.8 | `.venv` | `pip install -e ".[dev,qiskit]" -c requirements-lock.txt`; `pytest`; `scripts/reproduce_benchmarks.py`; `scripts/make_all_figures.py`; `scripts/run_qiskit_bridge.py`; Pandoc citation smoke build | `39 passed, 2 skipped`; benchmark and figure scripts completed with no tracked artifact diff; optional Qiskit/Aer bridge completed; Pandoc wrote `/tmp/qet-bench-manuscript.html`. | + +Optional Qiskit/Aer bridge: + +- `qiskit==2.3.1` +- `qiskit-aer==0.17.2` +- Generated file: `results/data/qiskit_bridge_benchmarks.csv` +- Absolute `E_B` errors: + - `(h=1, k=0.5)`: approximately `0.01553` + - `(h=1, k=1)`: approximately `0.00279` + +The optional bridge artifact lives under the ignored `results/` tree unless a +future release deliberately force-adds optional interoperability outputs. + diff --git a/qet-bench/docs/research_roadmap.md b/qet-bench/docs/research_roadmap.md index 2722a4a..49b9595 100644 --- a/qet-bench/docs/research_roadmap.md +++ b/qet-bench/docs/research_roadmap.md @@ -6,7 +6,8 @@ DOI becomes available. For the step-by-step path from the QET benchmark into broader void/vacuum energy-accounting work, see `vacuum_investigation_roadmap.md`. For review risks -and submission blockers, see `blocker_ledger.md`. +and submission blockers, see `blocker_ledger.md`. For the current local +validation record while hosted CI is unavailable, see `release_validation.md`. Status values: @@ -23,7 +24,7 @@ Reference policy: | 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. Hosted CI remains quota-blocked until re-run. | `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. Hosted CI remains billing/quota-blocked until re-run. | `v0.1.0` | | 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` | @@ -31,8 +32,8 @@ Reference policy: | 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 | Processing | Reproduction hardening | Re-run GitHub Actions once quota permits; record the run URL or badge target in README/paper notes. | pending | -| Optional Aer smoke artifact with Qiskit installed | Processing | Reproduction/interoperability | Run `pip install -e ".[qiskit]"` in a disposable environment and save or document the Aer bridge comparison artifact if the dependency stack is stable. | pending | +| Hosted CI revalidation | Processing | Reproduction hardening | Re-run GitHub Actions once billing/quota permits; latest hosted jobs were blocked before execution, so `release_validation.md` records the local Python 3.11/3.12 validation substitute. | pending; blocked run | +| 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 | Adapt the manuscript to a ReScience/comparable reproducibility venue, explicitly naming the reproduced prior result and artifact bundle. | 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 | | Many-qubit QET extension | Not done | New physics/simulation territory | Extend beyond two qubits to chains or network geometries, with explicit local-energy partitions and finite-size/scaling diagnostics. | none | diff --git a/qet-bench/paper/README.md b/qet-bench/paper/README.md index 90af4e9..c357a08 100644 --- a/qet-bench/paper/README.md +++ b/qet-bench/paper/README.md @@ -6,10 +6,12 @@ remaining usable as a source for ReScience C or SoftwareX adaptation. Current review targets: - Repository: -- Current review snapshot: `v0.2.0-noise-atlas` +- Current review target: `v0.2.0` +- Latest pre-candidate checkpoint: `v0.2.0-blocker-ledger` - Clean reproducibility baseline: `v0.1.0` - Citation metadata: `../CITATION.cff` - Artifact manifest: `../docs/artifact_manifest.md` +- Release validation log: `../docs/release_validation.md` - Bibliography source: `references.bib` ## Local Build @@ -50,7 +52,7 @@ The paper text is not yet a final submission. The hard blockers are: | AI disclosure | Human author must verify the AI usage disclosure is complete and accurate. | | Venue template | ReScience C and SoftwareX require their own article templates and metadata; this file is the JOSS-style source, not the final template for those venues. | -Verification record for `v0.1.0`: +Verification record for the `v0.2.0` review target: ```bash python -m pip install --upgrade -c requirements-lock.txt pip setuptools wheel @@ -61,8 +63,10 @@ python scripts/make_all_figures.py ``` These commands were run locally on Python 3.11 and Python 3.12. Hosted GitHub -Actions is configured, but hosted jobs were blocked by organization runner -quota at the time this note was written. +Actions is configured, but hosted jobs were blocked before execution by the +account billing/spending limit at the time this note was written. The latest +blocked hosted run was +. ## Venue Fit diff --git a/qet-bench/paper/paper.md b/qet-bench/paper/paper.md index f8e98e2..8abcd22 100644 --- a/qet-bench/paper/paper.md +++ b/qet-bench/paper/paper.md @@ -104,10 +104,10 @@ guards, and fixed-protocol noise-survival diagnostics. The local quality gate installs the pinned dependency set and regenerates benchmark and figure artifacts: -| Python | Commands | +| Environment | Commands | |---|---| -| 3.11 | `pytest`; `reproduce_benchmarks.py`; `make_all_figures.py`; `run_qiskit_bridge.py` | -| 3.12 | `pytest`; `reproduce_benchmarks.py`; `make_all_figures.py`; `run_qiskit_bridge.py` | +| Python 3.11 and 3.12 base path | `pytest`; `reproduce_benchmarks.py`; `make_all_figures.py` | +| Python 3.12 optional bridge | `pip install -e ".[qiskit]"`; `run_qiskit_bridge.py` | # Research impact statement @@ -126,11 +126,12 @@ a mature community package with demonstrated external adoption. # Availability and reproducibility The software repository is -. The current review snapshot is tagged -as `v0.2.0-noise-atlas`; the 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 current review target is version +`0.2.0`; the latest pre-candidate project-management checkpoint is tagged as +`v0.2.0-blocker-ledger`, and the 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 local reproduction path is: @@ -141,9 +142,9 @@ python scripts/reproduce_benchmarks.py python scripts/make_all_figures.py ``` -Hosted GitHub Actions CI is configured, but hosted jobs were blocked by the -organization runner quota at the time of this draft. Local CI is therefore the -current validation record. +Hosted GitHub Actions CI is configured, but hosted jobs were blocked before +execution by the account billing/spending limit at the time of this draft. Local +CI is therefore the current validation record. # Limitations diff --git a/qet-bench/pyproject.toml b/qet-bench/pyproject.toml index 01f9ee8..ff35bbf 100644 --- a/qet-bench/pyproject.toml +++ b/qet-bench/pyproject.toml @@ -4,13 +4,13 @@ build-backend = "setuptools.build_meta" [project] name = "qet-bench" -version = "0.1.0" +version = "0.2.0" description = "Reproducible exact benchmarks for minimal two-qubit Quantum Energy Teleportation." readme = "README.md" requires-python = ">=3.11" license = { file = "LICENSE" } authors = [ - { name = "qet-bench contributors" } + { name = "Francois Gueguen" } ] dependencies = [ "numpy", diff --git a/qet-bench/src/qet_bench/__init__.py b/qet-bench/src/qet_bench/__init__.py index 151fadb..d8acba2 100644 --- a/qet-bench/src/qet_bench/__init__.py +++ b/qet-bench/src/qet_bench/__init__.py @@ -14,7 +14,7 @@ "qet_ledger_with_noise", ] -__version__ = "0.1.0" +__version__ = "0.2.0" def __getattr__(name: str) -> object: From a1af33ef18569557f849f7a1c33963365d2207a3 Mon Sep 17 00:00:00 2001 From: Francois Date: Thu, 16 Apr 2026 20:13:08 +0900 Subject: [PATCH 3/6] Add ReScience reproducibility manuscript --- README.md | 1 + qet-bench/docs/blocker_ledger.md | 2 +- qet-bench/docs/research_roadmap.md | 2 +- qet-bench/paper/README.md | 11 ++- qet-bench/paper/rescience.md | 134 +++++++++++++++++++++++++++++ 5 files changed, 144 insertions(+), 6 deletions(-) create mode 100644 qet-bench/paper/rescience.md diff --git a/README.md b/README.md index 7529db3..b24bd9a 100644 --- a/README.md +++ b/README.md @@ -40,4 +40,5 @@ python scripts/run_qiskit_bridge.py - [Research roadmap register](qet-bench/docs/research_roadmap.md) - [Blocker ledger](qet-bench/docs/blocker_ledger.md) - [Manuscript draft](qet-bench/paper/paper.md) +- [ReScience-oriented manuscript](qet-bench/paper/rescience.md) - [Manuscript build notes](qet-bench/paper/README.md) diff --git a/qet-bench/docs/blocker_ledger.md b/qet-bench/docs/blocker_ledger.md index 0596da7..a3b14da 100644 --- a/qet-bench/docs/blocker_ledger.md +++ b/qet-bench/docs/blocker_ledger.md @@ -40,7 +40,7 @@ Reference policy: | Blockers were only reported in chat, not tracked in-repo | Chat-only blocker lists are easy to lose and cannot be audited per release. | Processing | Project management | Maintain this blocker ledger and update it when a blocker changes status or is resolved by a tag, commit, DOI, run URL, or paper reference. | pending | | Optional Aer smoke artifact with Qiskit installed missing | The optional bridge has no positive-path artifact unless Qiskit/Aer is installed and run. | Mitigated | Interoperability | Local Python 3.12.8 smoke passed with `qiskit==2.3.1` and `qiskit-aer==0.17.2`; `qiskit_interop.md` records the generated CSV path and observed absolute `E_B` errors. Decide during archival whether to force-add optional generated artifacts. | pending merge/tag | | JOSS public-history / external-impact evidence is thin | Some venues screen for sustained public development and evidence of research use. | Open | Venue fit | Prefer ReScience-style reproducibility review first, or wait for public history/adoption before JOSS submission. | pending | -| ReScience-specific reproduced-result framing missing | ReScience-style review needs a crisp statement of the original result being reproduced. | Processing | Manuscript | Adapt the JOSS-style source into a ReScience-oriented submission package naming the reproduced QET benchmark and artifacts. | pending | +| ReScience-specific reproduced-result framing missing | ReScience-style review needs a crisp statement of the original result being reproduced. | Mitigated | Manuscript | Added `paper/rescience.md`, which names the reproduced two-qubit QET result, artifact bundle, reproduction commands, and interpretation limits. Final author metadata and public repository access remain separate blockers. | pending merge/tag | | Full microscopic controller/environment ledger missing | Conservative bookkeeping is not a microscopic hardware or thermodynamic environment model. | Open | New methods research | Design and implement an explicit controller, memory, pulse, reset, and environment ledger before making stronger thermodynamic claims. | none | ## Maintenance Checklist diff --git a/qet-bench/docs/research_roadmap.md b/qet-bench/docs/research_roadmap.md index 49b9595..1a81971 100644 --- a/qet-bench/docs/research_roadmap.md +++ b/qet-bench/docs/research_roadmap.md @@ -34,7 +34,7 @@ Reference policy: | 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 | Processing | Reproduction hardening | Re-run GitHub Actions once billing/quota permits; latest hosted jobs were blocked before execution, so `release_validation.md` records the local Python 3.11/3.12 validation substitute. | pending; blocked run | | 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 | Adapt the manuscript to a ReScience/comparable reproducibility venue, explicitly naming the reproduced prior result and artifact bundle. | 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 | | Many-qubit QET extension | Not done | New physics/simulation territory | Extend beyond two qubits to chains or network geometries, with explicit local-energy partitions and finite-size/scaling diagnostics. | none | | Finite-temperature or mixed-state QET | Not done | New physics/simulation territory | Study thermal or mixed resource states and compare extraction/accounting behavior against the pure ground-state benchmark. | none | diff --git a/qet-bench/paper/README.md b/qet-bench/paper/README.md index c357a08..956aebd 100644 --- a/qet-bench/paper/README.md +++ b/qet-bench/paper/README.md @@ -1,7 +1,8 @@ # Manuscript Build Target -The manuscript is now shaped for a JOSS-style research-software paper while -remaining usable as a source for ReScience C or SoftwareX adaptation. +The manuscript set now contains a JOSS-style research-software source and a +ReScience-oriented reproducibility source. SoftwareX would still require a +separate template adaptation. Current review targets: @@ -12,6 +13,8 @@ Current review targets: - Citation metadata: `../CITATION.cff` - Artifact manifest: `../docs/artifact_manifest.md` - Release validation log: `../docs/release_validation.md` +- JOSS-style source: `paper.md` +- ReScience-oriented source: `rescience.md` - Bibliography source: `references.bib` ## Local Build @@ -50,7 +53,7 @@ The paper text is not yet a final submission. The hard blockers are: | 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. | -| Venue template | ReScience C and SoftwareX require their own article templates and metadata; this file is the JOSS-style source, not the final template for those venues. | +| Venue template | ReScience C now has a dedicated source file; SoftwareX still requires its own article template and metadata. | Verification record for the `v0.2.0` review target: @@ -72,6 +75,6 @@ blocked hosted run was | Venue | Fit | Main risk | |---|---|---| -| ReScience C or comparable reproducibility venue | Strongest near-term fit if framed as exact reproduction plus validation suite. | Must clearly identify the reproduced prior result and keep novelty claims bounded. | +| ReScience C or comparable reproducibility venue | Strongest near-term fit; `rescience.md` frames the work as exact reproduction plus validation suite. | Must keep novelty claims bounded and ensure the repository is public before submission. | | JOSS | Good format fit after public-history and impact signals mature. | Immediate submission risks desk rejection if public development history and adoption evidence are insufficient. | | SoftwareX | Possible if expanded into the required template and impact/reuse narrative. | SoftwareX expects a descriptive paper plus an open-source distribution and stronger reuse framing. | diff --git a/qet-bench/paper/rescience.md b/qet-bench/paper/rescience.md new file mode 100644 index 0000000..49701ae --- /dev/null +++ b/qet-bench/paper/rescience.md @@ -0,0 +1,134 @@ +--- +title: "Reproducing an exact two-qubit Quantum Energy Teleportation benchmark with qet-bench" +tags: + - Python + - quantum information + - quantum energy teleportation + - reproducibility + - scientific software +authors: + - name: Francois Gueguen + affiliation: 1 + corresponding: true +affiliations: + - name: "Lucent Lab" + index: 1 +date: 16 April 2026 +bibliography: references.bib +--- + +# Summary + +`qet-bench` is a small Python reproduction package for the minimal two-qubit +Quantum Energy Teleportation (QET) benchmark. It implements the exact +Hamiltonian model, Alice's local measurement, classical feedforward, Bob's local +rotation, and the energy ledger used to evaluate Bob-side local energy +extraction. The package is designed to be rerun without a quantum SDK, cloud +backend, hardware account, or proprietary software. + +# Reproduced result + +The reproduced result is the two-qubit QET effect: after Alice performs a local +measurement on an entangled ground state and communicates the outcome, Bob can +apply an outcome-conditioned local operation that yields positive local energy +extraction on his side [@hotta2008measurement; @hotta2009spin]. The package also +reproduces the corresponding no-free-energy accounting used in +hardware-oriented presentations of the protocol [@ikeda2023hardware]: Bob's +local extraction is bounded by Alice's measurement and control resources, and +the exact ground-state ledger satisfies $E_A \ge E_B$. + +For the canonical anchors, `qet-bench` reproduces: + +| $h$ | $k$ | $E_A$ | $E_B$ | $E_A-E_B$ | +|---:|---:|---:|---:|---:| +| 1.0 | 0.5 | 0.8944271909999154 | 0.0725727758732213 | 0.8218544151266941 | +| 1.0 | 1.0 | 0.7071067811865467 | 0.1147476339401475 | 0.5923591472463992 | + +The replication target is intentionally narrow. It is not a new QET theorem, a +many-body simulation, or a hardware demonstration. Its value is an auditable +software reproduction of the exact benchmark, its branch averaging conventions, +and its energy-accounting interpretation. + +# Implementation + +The package uses explicit NumPy/SciPy density-matrix calculations for the main +exact ledger and keeps the benchmark independent of quantum-framework version +drift. An independent pure-Python branch-amplitude implementation cross-checks +the same benchmark values without using the main NumPy propagation path. + +The generated artifact set includes exact benchmark CSV files, parameter +sweeps, null-test figures, fixed-protocol noise diagnostics, count-estimator +convention examples, and an artifact manifest mapping each output to the script +and tests that support it. Optional Qiskit/Aer interoperability is implemented +as a branch-resolved simulator smoke check and count-key convention bridge; it +is not part of the base reproduction path. + +# Reproducibility + +The base reproduction path is: + +```bash +python -m pip install -e ".[dev]" -c requirements-lock.txt +python -m pytest +python scripts/reproduce_benchmarks.py +python scripts/make_all_figures.py +``` + +The optional Qiskit/Aer bridge can be checked with: + +```bash +python -m pip install -e ".[qiskit]" -c requirements-lock.txt +python scripts/run_qiskit_bridge.py +``` + +The `0.2.0` review target was locally validated on Python 3.11 and Python 3.12. +Hosted GitHub Actions is configured, but hosted jobs were blocked before +execution by the account billing/spending limit at the time of this draft. The +current local validation record is maintained in +`docs/release_validation.md`. + +# Reproduction checks + +The reproduction is guarded by: + +- exact regression tests for the two canonical benchmark points, +- final-state trace checks, +- global accounting tests for $E_A \ge E_B$, +- zero-coupling and scrambled-feedforward null tests, +- Bob-angle convention scans, +- count bit-ordering tests, +- optional Qiskit/Aer import guards and smoke checks. + +Generated artifacts are intentionally reviewable but not authoritative by +themselves. The source of truth remains the package code, tests, scripts, +lockfile, and artifact manifest. + +# Interpretation limits + +The reproduced QET benchmark demonstrates local energy extraction enabled by +ground-state correlations, measurement, and classical feedforward. It does not +describe an autonomous energy source. Alice's measurement and control resources +are part of the ledger, and the package keeps that no-free-energy interpretation +visible in the README, tests, manuscript, roadmap, and blocker ledger. + +The controller/battery accounting extension is conservative bookkeeping rather +than a microscopic detector, pulse, memory, reset, or environment model. Future +many-body, finite-temperature, hardware-faithful, or vacuum-mechanism audits +should be treated as new research territory rather than as part of this +reproduction package. + +# AI usage disclosure + +Generative AI assistance from OpenAI Codex models, including GPT-5-class models +and GPT-5.4 Mini review agents, was used for implementation, refactoring, +testing, documentation, manuscript drafting, and adversarial review. AI-assisted +changes were checked through exact benchmark regressions, an independent +pure-Python branch implementation, local test suites, artifact regeneration, and +human review before acceptance. + +# Acknowledgements + +No external funding is declared. + +# References + From 86b455dfc847ca7151443e71528da3fd29ef7ae5 Mon Sep 17 00:00:00 2001 From: Francois Date: Thu, 16 Apr 2026 20:14:36 +0900 Subject: [PATCH 4/6] Clarify v0.2.0 review identity --- .gitignore | 4 +++- qet-bench/docs/blocker_ledger.md | 6 ++++++ qet-bench/docs/qiskit_interop.md | 2 +- qet-bench/docs/research_roadmap.md | 6 ++++++ qet-bench/paper/README.md | 1 + qet-bench/paper/paper.md | 12 ++++++------ qet-bench/paper/rescience.md | 5 ++--- 7 files changed, 25 insertions(+), 11 deletions(-) diff --git a/.gitignore b/.gitignore index 6437b45..c02b5fc 100644 --- a/.gitignore +++ b/.gitignore @@ -23,8 +23,10 @@ dist/ # Generated benchmark artifacts qet-bench/results/ +# Private planning notes outside the publishable package tree +/docs/ + # Editor and OS noise .DS_Store .idea/ .vscode/ - diff --git a/qet-bench/docs/blocker_ledger.md b/qet-bench/docs/blocker_ledger.md index a3b14da..8643009 100644 --- a/qet-bench/docs/blocker_ledger.md +++ b/qet-bench/docs/blocker_ledger.md @@ -20,6 +20,12 @@ Reference policy: - Prefer DOI, Software Heritage ID, hosted CI run URL, or paper DOI when available. +Current release identity: + +- `v0.2.0` is the active publication-hardening review target. +- `0.2.0` is the package and citation metadata version. +- Earlier `v0.2.0-*` references are historical milestone tags. + | Blocker | Why it matters | Status | Scope | Resolution / Next Action | Reference | |---|---|---|---|---|---| | 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` | diff --git a/qet-bench/docs/qiskit_interop.md b/qet-bench/docs/qiskit_interop.md index bec85b8..a0575d0 100644 --- a/qet-bench/docs/qiskit_interop.md +++ b/qet-bench/docs/qiskit_interop.md @@ -50,7 +50,7 @@ local extraction is reported against the Alice-side measurement/control ledger. ## Local Smoke Record -For the `0.2.0` review target, the optional bridge was smoke-tested locally on +For the `v0.2.0` review target, the optional bridge was smoke-tested locally on Python 3.12.8 with `qiskit==2.3.1` and `qiskit-aer==0.17.2`: ```bash diff --git a/qet-bench/docs/research_roadmap.md b/qet-bench/docs/research_roadmap.md index 1a81971..8800376 100644 --- a/qet-bench/docs/research_roadmap.md +++ b/qet-bench/docs/research_roadmap.md @@ -21,6 +21,12 @@ Reference policy: - Add an archive DOI, Software Heritage ID, or paper DOI when available. - For active work without a tag, use "pending" and replace it when merged. +Current release identity: + +- `v0.2.0` is the active publication-hardening review target. +- `0.2.0` is the package and citation metadata version. +- Earlier `v0.2.0-*` entries in the table are historical milestone tags. + | 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` | diff --git a/qet-bench/paper/README.md b/qet-bench/paper/README.md index 956aebd..1c0a297 100644 --- a/qet-bench/paper/README.md +++ b/qet-bench/paper/README.md @@ -8,6 +8,7 @@ Current review targets: - Repository: - Current review target: `v0.2.0` +- Package/CFF version: `0.2.0` - Latest pre-candidate checkpoint: `v0.2.0-blocker-ledger` - Clean reproducibility baseline: `v0.1.0` - Citation metadata: `../CITATION.cff` diff --git a/qet-bench/paper/paper.md b/qet-bench/paper/paper.md index 8abcd22..212294f 100644 --- a/qet-bench/paper/paper.md +++ b/qet-bench/paper/paper.md @@ -126,12 +126,12 @@ a mature community package with demonstrated external adoption. # Availability and reproducibility The software repository is -. The current review target is version -`0.2.0`; the latest pre-candidate project-management checkpoint is tagged as -`v0.2.0-blocker-ledger`, and the 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 current review target is +`v0.2.0` with package and citation version `0.2.0`; the latest pre-candidate +project-management checkpoint is tagged as `v0.2.0-blocker-ledger`, and the +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 local reproduction path is: diff --git a/qet-bench/paper/rescience.md b/qet-bench/paper/rescience.md index 49701ae..3a83a77 100644 --- a/qet-bench/paper/rescience.md +++ b/qet-bench/paper/rescience.md @@ -81,11 +81,11 @@ python -m pip install -e ".[qiskit]" -c requirements-lock.txt python scripts/run_qiskit_bridge.py ``` -The `0.2.0` review target was locally validated on Python 3.11 and Python 3.12. +The `v0.2.0` review target was locally validated on Python 3.11 and Python 3.12. Hosted GitHub Actions is configured, but hosted jobs were blocked before execution by the account billing/spending limit at the time of this draft. The current local validation record is maintained in -`docs/release_validation.md`. +`../docs/release_validation.md`. # Reproduction checks @@ -131,4 +131,3 @@ human review before acceptance. No external funding is declared. # References - From 112d24cb8e5dffe20d231d4c13fadc5cbb945e63 Mon Sep 17 00:00:00 2001 From: Francois Date: Thu, 16 Apr 2026 20:15:39 +0900 Subject: [PATCH 5/6] Record latest blocked hosted CI run --- qet-bench/docs/blocker_ledger.md | 2 +- qet-bench/docs/release_validation.md | 2 +- qet-bench/docs/research_roadmap.md | 2 +- qet-bench/paper/README.md | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/qet-bench/docs/blocker_ledger.md b/qet-bench/docs/blocker_ledger.md index 8643009..f914043 100644 --- a/qet-bench/docs/blocker_ledger.md +++ b/qet-bench/docs/blocker_ledger.md @@ -31,7 +31,7 @@ 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. | Open | Review infrastructure | Hosted jobs currently fail before execution because account billing/spending limit blocks runners. Re-run GitHub Actions when quota permits and record the successful run URL or badge. Keep local Python 3.11/3.12 CI as the interim validation record. | blocked run | +| Hosted CI unavailable because of quota | Hosted CI gives reviewers an independent, visible validation path; local-only validation is weaker. | Open | Review infrastructure | Hosted jobs currently fail before execution because account billing/spending limit blocks runners. Re-run GitHub Actions when quota permits and record the successful run URL or badge. Keep local Python 3.11/3.12 CI as the interim validation record. | blocked run | | 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 | | Repository access for external review | Reviewers cannot inspect a private repository unless explicit access is granted. | Open | Review logistics | Make the repository public or grant reviewer access before submission. | pending | | 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` | diff --git a/qet-bench/docs/release_validation.md b/qet-bench/docs/release_validation.md index 8eb440c..67bc2a0 100644 --- a/qet-bench/docs/release_validation.md +++ b/qet-bench/docs/release_validation.md @@ -12,7 +12,7 @@ Hosted CI status: - Workflow: `.github/workflows/ci.yml` - Latest hosted run checked: - + - Result: jobs did not start because the account billing/spending limit blocked hosted runners. diff --git a/qet-bench/docs/research_roadmap.md b/qet-bench/docs/research_roadmap.md index 8800376..e69ecc6 100644 --- a/qet-bench/docs/research_roadmap.md +++ b/qet-bench/docs/research_roadmap.md @@ -38,7 +38,7 @@ Current release identity: | 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 | Processing | Reproduction hardening | Re-run GitHub Actions once billing/quota permits; latest hosted jobs were blocked before execution, so `release_validation.md` records the local Python 3.11/3.12 validation substitute. | pending; blocked run | +| Hosted CI revalidation | Processing | Reproduction hardening | Re-run GitHub Actions once billing/quota permits; latest hosted jobs were blocked before execution, so `release_validation.md` records the local Python 3.11/3.12 validation substitute. | pending; blocked run | | 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 | diff --git a/qet-bench/paper/README.md b/qet-bench/paper/README.md index 1c0a297..736d557 100644 --- a/qet-bench/paper/README.md +++ b/qet-bench/paper/README.md @@ -70,7 +70,7 @@ These commands were run locally on Python 3.11 and Python 3.12. Hosted GitHub Actions is configured, but hosted jobs were blocked before execution by the account billing/spending limit at the time this note was written. The latest blocked hosted run was -. +. ## Venue Fit From 3e23e35dc3e0fcacd34c0560902f30ad25bc99ff Mon Sep 17 00:00:00 2001 From: Francois Date: Thu, 16 Apr 2026 20:16:09 +0900 Subject: [PATCH 6/6] Avoid chasing hosted CI run ids --- qet-bench/docs/release_validation.md | 2 +- qet-bench/docs/research_roadmap.md | 2 +- qet-bench/paper/README.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/qet-bench/docs/release_validation.md b/qet-bench/docs/release_validation.md index 67bc2a0..bb2281a 100644 --- a/qet-bench/docs/release_validation.md +++ b/qet-bench/docs/release_validation.md @@ -11,7 +11,7 @@ Date: 2026-04-16 Hosted CI status: - Workflow: `.github/workflows/ci.yml` -- Latest hosted run checked: +- Representative hosted run checked: - Result: jobs did not start because the account billing/spending limit blocked hosted runners. diff --git a/qet-bench/docs/research_roadmap.md b/qet-bench/docs/research_roadmap.md index e69ecc6..d698330 100644 --- a/qet-bench/docs/research_roadmap.md +++ b/qet-bench/docs/research_roadmap.md @@ -38,7 +38,7 @@ Current release identity: | 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 | Processing | Reproduction hardening | Re-run GitHub Actions once billing/quota permits; latest hosted jobs were blocked before execution, so `release_validation.md` records the local Python 3.11/3.12 validation substitute. | pending; blocked run | +| Hosted CI revalidation | Processing | Reproduction hardening | Re-run GitHub Actions once billing/quota permits; recent hosted jobs were blocked before execution, so `release_validation.md` records the local Python 3.11/3.12 validation substitute. | pending; blocked run | | 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 | diff --git a/qet-bench/paper/README.md b/qet-bench/paper/README.md index 736d557..4c22c8a 100644 --- a/qet-bench/paper/README.md +++ b/qet-bench/paper/README.md @@ -68,7 +68,7 @@ python scripts/make_all_figures.py These commands were run locally on Python 3.11 and Python 3.12. Hosted GitHub Actions is configured, but hosted jobs were blocked before execution by the -account billing/spending limit at the time this note was written. The latest +account billing/spending limit at the time this note was written. A representative blocked hosted run was .