UnifiedQuantum 0.0.17 — Release Candidate Validation

Verdict

RELEASE CANDIDATE READY. All local and remote release gates pass for the validated runtime commit 8b3f554. The work intentionally stops before tag or publication.

Candidate

  • Main repository branch: fix/v0.0.17-stabilization

  • Validated runtime commit: 8b3f554

  • Skill repository branch: fix/v0.0.17-stabilization

  • Skill validation commit: 9e53ec9

  • Local package version after editable rebuild: 0.0.17.dev20

  • Release boundary: committed and pushed release candidate only; no tag, GitHub Release, PyPI upload, or Skill publication

  • Validation boundary: offline, dummy, mock, local simulator, and CI; no real quantum-cloud task was submitted

Post-Validation Delta

HEAD at tagging time differs from the validated runtime commit 8b3f554 only by documentation restructuring (d6e7ad2, 2ec12ff), removal of a temporary risk report (07f8c33), 25 lines of dead code dropped from uniqc/circuit_builder/originir_spec.py, and the changelog release entry. There are no functional changes beyond the validated candidate.

Stabilization Results

Area

Result

Full offline pytest

2338 passed, 240 skipped, 31 deselected, 0 failed

First-party warning gate

2309 passed, 240 skipped, 31 deselected

Public gate oracle

204 passed across matrix, dense statevector/density, official decomposition, MPS, QuTiP high-risk gates, and PyTorch where supported

Task lifecycle matrix

16 passed across post-persistence failures, partial shards, deadline resolution, and restart recovery

Local docs examples

51 pass, 6 valid skip, 0 fail

Strict Sphinx

PASS with -W --keep-going on clean Python 3.12 and Python 3.14 environments

Local docs links / log freshness

PASS; 233 files checked and all source hashes current

Ruff

PASS (ruff check .); the repository-wide format sweep remains deferred

Frontend

PASS; TypeScript + Vite production build, 2216 modules

[pytorch] resolution

PASS for 15 Linux/Windows/macOS × Python 3.10–3.14 resolver combinations

Clean [pytorch] install

PASS on Python 3.14, including native expectation and TorchQuantum smoke

Skill structure/parity/runtime

PASS; 14 Skill definitions validated, 79 Markdown files checked, 13/13 runtime smokes passed

Cross-repository parity

PASS for version, Python/CMake, extras, cache/config paths, backend grammar, CLI flags, cloud-test defaults, and the 0.1.0 deprecation cliff

GitHub Build-and-test

PASS, 20/20 jobs — Linux GCC/Clang, Windows MSVC, and macOS Clang across Python 3.10–3.14 (run 29933548284)

GitHub docs

PASS (run 29933550027)

GitHub Skill validation

PASS (run 29933078952)

GitHub cross-repository parity

PASS (run 29929142977)

Correctness and Reliability Changes

  • Established a capability-aware oracle for every public unitary gate.

  • Unified UU15, XY, ECR, and PHASE2Q across direct dense, density, decomposition, MPS, QuTiP, and PyTorch paths where supported.

  • Fixed PyTorch 3+ qubit and non-adjacent 2q application, plus U2/U3 and ISWAP dagger behavior.

  • Fixed HEA mixed-rotation scheduling and implemented a numerically verified arbitrary-state VQD swap test that honors custom qubits.

  • Replaced the broken state-preparation helper with exact complex-amplitude unitary synthesis.

  • Added Python and native control-qubit bounds, and ensured Circuit width includes explicit controls.

  • Added one persisted FAILED transition path for backend resolution, availability, adaptation, submission, and shard persistence.

  • Made deadline queries shard-aware and restored OriginQ native-batch result shape after process restart.

  • Prevented WebSocket reconnect after hook disposal.

  • Added OpenQASM 2 whole-register measurement support and made CLI output tolerant of legacy Windows encodings.

Documentation, Packaging, and Skill Gates

  • [pytorch] and [all] now install torchquantum-ng with torch.

  • Fixed active docs links and MyST labels; strict Sphinx no longer relies on broad missing-reference suppression.

  • Restored Torch API documentation by installing [pytorch] in docs CI while mocking only the external TorchQuantum module during autodoc.

  • Added per-example source hashes, a blocking local-link checker, blocking Ruff, and a precise first-party warning gate.

  • Updated cache paths and documented dummy:virtual:<name> plus ThermalRelaxation across the Skill repository.

  • Skill smoke aggregation now exits nonzero on FAIL, allows valid optional SKIP, and emits JSON.

Intentionally Deferred to the 0.1.0 Preparation Cycle

  • Full generated/shared gate registry.

  • Full explicit task state machine and transition-history schema.

  • Full machine-readable cross-repository contract manifest.

  • Repository-wide ruff format normalization.

These are structural follow-ups, not accepted correctness failures in the v0.0.17 release candidate.