v0.6.2 — lite-flip deprecation notice

Pre-flip release. All v0.6.x install behaviour is unchanged in this release — but import qiskit_metal now emits a FutureWarning letting you know v0.7.0 will move several dependencies out of the base install into opt-in extras (pyside6, qdarkstyle, pyaedt, pyEPR-quantum, gmsh → [gui] / [ansys] / [fem] / [full]).

What to do

• If you use MetalGUI, HFSS / Q3D, or gmsh / Elmer: run pip install --upgrade "quantum-metal[full]" before upgrading to v0.7.0 to keep the current install behaviour.
• If you only use designs + qm.view() + GDS export + pure-Python analyses: nothing to do. The base install will be smaller and faster in v0.7.0.
• Silence the warning with QISKIT_METAL_SUPPRESS_LITE_FLIP_WARNING=1.

See docs/migration-to-v0.7.0.rst and ROADMAP.md for the full picture.

Lite-flip prep

• Vendored pyEPR's Josephson math into qiskit_metal.analyses.quantization.constants. LOManalysis, extract_transmon_coupled_Noscillator, and the LOM-core analyses no longer carry a runtime pyEPR dependency. New explicit physics-validation tests lock the meaning of every constant against textbook values. (#1078)
• Lazified pyEPR and pyaedt in all HFSS / Q3D renderer modules. Renderer constructors now raise a clear ImportError: ... pip install 'quantum-metal[ansys]' when the heavy deps are absent; the _start_renderers skip-and-log path catches it cleanly. (#1078)
• Lazified gmsh in renderer_gmsh/. Same pattern; QGmshRenderer.__init__ raises a clear [fem] install hint. (#1080)
• gmsh pin tightened: gmsh>=4.11.1 → gmsh>=4.15.0,<5. Matches the floor already shipping in the dev env; upper bound caps before any future gmsh 5.

Deprecation warning

• New FutureWarning on import qiskit_metal, once per process. Visible by default via the metal logger; also raised through warnings.warn so test suites and programmatic callers can catch it.

Docs

• docs/migration-to-v0.7.0.rst — per-persona migration recipes (GUI user / HFSS user / FEM user / AI orchestrator) + common-error fixes. (#1075)
• ROADMAP.md at repo root — v0.7.0 lite-flip, AI-orchestration profile, and open-FEM-stack (gmsh + Elmer + AWS Palace) research arcs. Linked from the README. (#1072)
• Refreshed README.md Quick Start ([gui] callout), docs/installation.rst (extras matrix), docs/faq.rst (Qt-error scoping), CONTRIBUTING.md (correct CLA URL — now qiskit-community/qiskit-metal), and README_Gmsh_Elmer.md (v0.6 vs v0.7 install split). (#1076)
• Recorded the wirebond E712 audit caveat in .claude/context/lessons-learned.md. (#1073)
• Full v0.6.0 + v0.6.1 changelog entries added to changelog.md (they'd been missing from the scratchpad). (#1075)

Hygiene

• Resolved the 13 deferred ruff findings in HFSS / _gui/ zones via a community ruff sweep by @PositroniumJS. (#1070)
• Security: idna 3.11 → 3.15 (CVE-2026-45409, quadratic-time DoS fix). (#1071)
• CI: docs workflow now runs on PRs (build-only) — catches Sphinx errors before merge. (#1082)
• Removed unused imports and resolved github-code-quality bot findings.

Compatibility matrix

Tested on:

| Python | Ubuntu 24.04 | macOS 15 | Windows 2025 | |---|---|---|---| | 3.10 | ✅ | ✅ | ✅ | | 3.11 | ✅ | ✅ | ✅ | | 3.12 | ✅ | ✅ | ✅ |

Test count: 458 passing (up from 447 in v0.6.1; the +11 are explicit physics-validation tests in test_quantization_constants.py).

Known issues

• HFSS / Q3D runtime path not validated in CI (no AEDT license). The HFSS renderer lazification in #1078 shipped on best-effort review. If you hit a regression on a real HFSS workflow, see issue #1079 for the validation checklist and one-line revert path.

Contributors

Thanks to @PositroniumJS for the ruff sweep (#1070), plus the usual maintainer pipeline.

What's Changed

• chore: tier-0 maintenance — contributing guide, ruff triage, env drift gate, docs warnings by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1057
• test + ci: tier-1 — coverage reporting, make() idempotency, pin sanity by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1058
• test + docs: expand qlibrary test coverage, add renderer-protocol audit + Qt-optional callout by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1059
• tier 2: standalone qm.view() — Qt-free design rendering for Jupyter/Colab/Binder by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1060
• tutorials: discoverability + CI gate for the headless rendering path by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1061
• test + types + tutorials: options audit, pin-direction sanity, return types, 2-folder callouts by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1062
• docs(agents): add CLAUDE.md + .claude/ repo know-how for future agents by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1063
• tutorials: complete no-Qt callout rollout (65 notebooks) + verify qutip5/pyEPR sync by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1064
• fix(about): make qm.about() work without PySide6 (lite-mode crash) by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1066
• chore(deps): bump pygments from 2.19.2 to 2.20.0 by @dependabot[bot] in https://github.com/qiskit-community/qiskit-metal/pull/1065
• chore(deps): bump the uv group across 1 directory with 11 updates by @dependabot[bot] in https://github.com/qiskit-community/qiskit-metal/pull/1068
• chore(deps-dev): bump jupyterlab from 4.5.1 to 4.5.7 by @dependabot[bot] in https://github.com/qiskit-community/qiskit-metal/pull/1067
• docs(conf): QT_API hint + archive working RTD config for future revival by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1069
• docs: add ROADMAP.md (lite-by-default flip, AI orchestration, open FEM stack) by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1072
• Ruff linting by @PositroniumJS in https://github.com/qiskit-community/qiskit-metal/pull/1070
• lite-flip: lazify pyEPR imports in analyses/ by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1074
• docs(lessons-learned): record PR #1070 wirebond E712 caveat by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1073
• chore(deps): bump idna from 3.11 to 3.15 in the uv group across 1 directory by @dependabot[bot] in https://github.com/qiskit-community/qiskit-metal/pull/1071
• docs: add v0.6.0/v0.6.1/v0.7.0 changelog entries + v0.7.0 migration guide by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1075
• docs(sweep): make existing README + install + FAQ docs lite-by-default aware by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1076
• docs(roadmap): add gmsh version audit research bullet by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1077
• lite-flip: vendor pyEPR math + lazify pyEPR/pyaedt in renderers (A+B+C) by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1078
• v0.6.2: deprecation notice + gmsh lazification (pre-flip for v0.7.0) by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1080
• chore: bump uv.lock to quantum-metal 0.6.2 (required pre-tag) by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1081
• ci(docs): build on PRs too; only deploy on push-to-main (unblocks auto-merge) by @zlatko-minev in https://github.com/qiskit-community/qiskit-metal/pull/1082

New Contributors

• @dependabot[bot] made their first contribution in https://github.com/qiskit-community/qiskit-metal/pull/1065

Full Changelog: https://github.com/qiskit-community/qiskit-metal/compare/v0.6.1...v0.6.2