diff --git a/qet-bench/CITATION.cff b/qet-bench/CITATION.cff index e331299..4359508 100644 --- a/qet-bench/CITATION.cff +++ b/qet-bench/CITATION.cff @@ -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" diff --git a/qet-bench/docs/blocker_ledger.md b/qet-bench/docs/blocker_ledger.md index df664ed..6a66fd9 100644 --- a/qet-bench/docs/blocker_ledger.md +++ b/qet-bench/docs/blocker_ledger.md @@ -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 | -| 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 | +| 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. | | | 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` | diff --git a/qet-bench/docs/release_validation.md b/qet-bench/docs/release_validation.md index 20dd7f5..957c61b 100644 --- a/qet-bench/docs/release_validation.md +++ b/qet-bench/docs/release_validation.md @@ -10,11 +10,19 @@ Hosted CI status: - Workflow: `.github/workflows/ci.yml` - Passing run: - + - 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: +- Software Heritage snapshot: + `swh:1:snp:9636ad3f493c249270cba77ae4810908dce45834` +- Software Heritage save request: + + Local CI mirror: | Python | Environment | Commands | Result | diff --git a/qet-bench/docs/research_roadmap.md b/qet-bench/docs/research_roadmap.md index 6496c6f..4871614 100644 --- a/qet-bench/docs/research_roadmap.md +++ b/qet-bench/docs/research_roadmap.md @@ -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 | +| 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 | | 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 | +| 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 | | 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 c487888..cf11388 100644 --- a/qet-bench/paper/README.md +++ b/qet-bench/paper/README.md @@ -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 . | | 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. | @@ -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: -. +. ## Venue Fit diff --git a/qet-bench/paper/paper.md b/qet-bench/paper/paper.md index 0deba1e..1857ca5 100644 --- a/qet-bench/paper/paper.md +++ b/qet-bench/paper/paper.md @@ -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