# Roadmap

## Completed

### v0.1.0 (February 2026)
- Core modules: qsnn, phase, control, bridge, qec, hardware
- 88 tests, 6 examples, hardware validation on ibm_fez
- VQE 0.05% error, 12-point decoherence curve, 16-layer UPDE snapshot

### v0.2.0 (February 2026)
- ZNE + dynamical decoupling error mitigation
- Heron r2 noise model, Trotter error analysis, ansatz benchmarking
- 10 hardware experiments added (total 17)

### v0.3.0 (February 2026)
- README rewrite with Kuramoto-XY derivation
- Expanded mypy coverage (27 → 30 files)
- GitHub Pages docs (MkDocs Material)

### v0.4.0 (February 2026)
- 4 Jupyter notebooks, 14 property-based tests (hypothesis)
- Integration + regression test suites
- Test count: 208 → 254 → 408

### v0.5.0 (February 2026)
- 3 crypto hardware experiments: Bell test, correlator, QKD QBER
- 20 total experiments in registry, 411 tests

### v0.6.0 (February 2026)
- ZNE error mitigation on kuramoto_4osc
- VQE 8-qubit on hardware (56 CZ gates, within coherence)
- DD on full 16-layer UPDE
- Noise baseline repeat for calibration drift tracking

### v0.7.0 (March 2026) — current
- PEP 561 `py.typed` marker
- Fixed crypto exports (callable symbols instead of module names)
- Seeded RNG in `QuantumDenseLayer`, `inf` → `nan` in PhaseVQE
- Named constants in percolation, pip cache in CI, dependency upper bounds
- 456 tests, 99%+ line coverage

### v0.6.4 (March 2026)
- All 4 notebooks executed with outputs committed
- Knm heatmap figure (`figures/knm_heatmap.png`)
- Zenodo DOI published (10.5281/zenodo.18821929)
- PyPI package published
- 442 tests, 99%+ line coverage
- v0.6.3: coverage gate, mitigation API docs, notebook table
- v0.6.4: LICENSE fix, codecov fix, issue templates, dependabot pip, SECURITY.md, README tree

## v0.8.0 (Completed)

- Shot-noise error bars on all 20 hardware experiments
- Property-based tests (Hamiltonian Hermiticity, crypto round-trips, QEC invariants)
- Input validation guards (K/omega shape, ZNE data points, DD qubit range, ODE solver status)
- Named constants consolidation (`_constants.py`)
- 21 mypy `no-any-return` fixes across 13 source files
- 483 tests, 99%+ line coverage

## v0.9.0 (Completed)

- 100% line coverage (19 uncovered lines closed)
- Security scanning in CI (bandit + pip-audit)
- CODEOWNERS, TYPE_CHECKING coverage exclusion
- Input validation on QuantumPetriNet, QLiF (dt/n_shots), QAOA_MPC (p_layers)
- Magic number consolidation (WEIGHT_SPARSITY_EPS)
- ZNE R_std propagation, VQE energy_std
- Runner job timeout + persistence (jobs.json)
- Crypto Bell test + dynamical decoupling examples
- Crypto & entanglement notebook
- Shared test fixtures, tightened assertions
- Production/Stable classifier
- ~505 tests, 100% coverage

## v1.0.0 (Q3 2026)

- PEC (probabilistic error cancellation) integration
- Trapped-ion backend support (IonQ / Quantinuum)
- Quantum advantage benchmark: quantum Kuramoto vs classical ODE at N=20+
- arXiv preprint submission

## Future

- Fault-tolerant UPDE simulation (surface code logical qubits; post-2030, hardware-dependent)
- QSNN training loop on hardware (parameter-shift STDP)
- Quantum disruption classifier trained on ITER disruption database
- Integration with SCPN SSGF geometry engine
