v0.6.5: mypy clean, test imports fixed, API consistency

- Fixed 8 mypy errors across decode_mmap.py, decoder_pool.py, belief_matching.py
- Fixed test_comprehensive_suite.py import path for new v0.6.4+ APIs
- PredecodedDecoder backend validation accepts canonical 'union_find'
- Version bump to 0.6.5 across all metadata (Cargo.toml, pyproject.toml, __init__.py, CITATION.cff, codemeta.json)
- CHANGELOG.md updated

Author: qectorlab

CHANGELOG.md

@@ -7,6 +7,17 @@ environment so report figures trace back to a specific build.
 
 ## [Unreleased]
 
+## [0.6.5] - 2026-07-10
+
+### Fixed
+- **mypy clean**: Resolved all 8 type errors across `decode_mmap.py`, `decoder_pool.py`, and `belief_matching.py` — strict type checking now passes on the full Python layer.
+- **Test imports**: `test_comprehensive_suite.py` now correctly imports `DecoderPool`, `get_decoder`, `clear_decoder_cache`, `get_decoder_pool` from the local source.
+- **CI resilience**: Ensured v0.6.5 Python layer matches the Rust source — no more version skew between wheel metadata and runtime API.
+- **API consistency**: Fixed `PredecodedDecoder` backend validation to accept `"union_find"` (with underscore) matching the canonical decoder names.
+
+### Changed
+- Bumped package, crate, runtime fallback, citation, and metadata versions to `0.6.5` across `pyproject.toml`, `Cargo.toml`, `python/qector_decoder_v3/__init__.py`, `CITATION.cff`, `codemeta.json`, `README.md`, `PYPI_README.md`, docs, and examples.
+
 ## [0.6.4] - 2026-07-10
 
 ### Fixed

CITATION.cff

@@ -6,7 +6,7 @@ authors:
   - family-names: Lessard
     given-names: Guillaume
     affiliation: iD01t Productions
-version: 0.6.4
+version: 0.6.5
 date-released: 2026-07-10
 url: https://www.qector.store
 repository-code: https://github.com/GuillaumeLessard/qector-decoder

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "qector_decoder_v3"
-version = "0.6.4"
+version = "0.6.5"
 edition = "2021"
 authors = ["Guillaume Lessard / iD01t Productions <guiliguili2705@gmail.com>"]
 description = "Source-available Rust QEC decoder core (Union-Find, exact polynomial MWPM/Blossom, Sparse Blossom, BP-OSD) with CPU/CUDA/OpenCL batch decoding and PyO3 bindings"

Cargo.toml

@@ -1 +1 @@
-{"@context":"https://doi.org/10.5063/schema/codemeta-2.0","@type":"SoftwareSourceCode","name":"QECTOR Decoder v3","version":"0.6.4","description":"Source-available Rust and Python quantum error correction decoder package for QEC research, PyMatching-compatible validation, belief-matching, BP-OSD and qLDPC workflows, CPU/GPU batch decoding, and reproducible benchmark evidence.","codeRepository":"https://github.com/GuillaumeLessard/qector-decoder","url":"https://www.qector.store","downloadUrl":"https://pypi.org/project/qector-decoder-v3/","identifier":"https://doi.org/10.5281/zenodo.20825980","license":"https://www.qector.store/license.html","programmingLanguage":["Python","Rust"],"runtimePlatform":["CPython 3.9","CPython 3.10","CPython 3.11","CPython 3.12","CPython 3.13","Linux x86_64","Windows x64","macOS arm64"],"keywords":["quantum error correction","QEC","quantum computing","quantum decoder","MWPM","PyMatching","Stim","Sinter","LDPC","qLDPC","BP-OSD","belief matching","union find decoder","surface code","Rust","Python","PyO3","maturin","QECTOR"],"author":{"@type":"Person","givenName":"Guillaume","familyName":"Lessard","affiliation":"iD01t Productions"},"publisher":{"@type":"Organization","name":"iD01t Productions"}}
+{"@context":"https://doi.org/10.5063/schema/codemeta-2.0","@type":"SoftwareSourceCode","name":"QECTOR Decoder v3","version":"0.6.5","description":"Source-available Rust and Python quantum error correction decoder package for QEC research, PyMatching-compatible validation, belief-matching, BP-OSD and qLDPC workflows, CPU/GPU batch decoding, and reproducible benchmark evidence.","codeRepository":"https://github.com/GuillaumeLessard/qector-decoder","url":"https://www.qector.store","downloadUrl":"https://pypi.org/project/qector-decoder-v3/","identifier":"https://doi.org/10.5281/zenodo.20825980","license":"https://www.qector.store/license.html","programmingLanguage":["Python","Rust"],"runtimePlatform":["CPython 3.9","CPython 3.10","CPython 3.11","CPython 3.12","CPython 3.13","Linux x86_64","Windows x64","macOS arm64"],"keywords":["quantum error correction","QEC","quantum computing","quantum decoder","MWPM","PyMatching","Stim","Sinter","LDPC","qLDPC","BP-OSD","belief matching","union find decoder","surface code","Rust","Python","PyO3","maturin","QECTOR"],"author":{"@type":"Person","givenName":"Guillaume","familyName":"Lessard","affiliation":"iD01t Productions"},"publisher":{"@type":"Organization","name":"iD01t Productions"}}

codemeta.json

@@ -4,7 +4,7 @@ build-backend = "maturin"
 
 [project]
 name = "qector-decoder-v3"
-version = "0.6.4"
+version = "0.6.5"
 description = "Source-available Rust/Python QEC R&D platform: PyMatching-compatible validation, belief-matching, BP-OSD (LDPC/qLDPC), CPU/GPU batch decoding, and artifact-hashed benchmark evidence"
 readme = {file = "PYPI_README.md", content-type = "text/markdown"}
 requires-python = ">=3.9"

pyproject.toml

@@ -98,7 +98,7 @@ def _rust_opencl_is_available():
 # wheel). We never overwrite a real compiled ``__version__`` with it — doing so
 # would falsely claim a version the loaded binary is not — so after a version bump
 # ``__version__`` keeps reporting the *built* value until the Rust wheel is rebuilt.
-__fallback_version__ = "0.6.4"
+__fallback_version__ = "0.6.5"
 
 try:
     __version__ = _native_module.__version__

python/qector_decoder_v3/__init__.py

@@ -208,10 +208,17 @@ def from_numpy_h(cls, H, error_rate: float = 0.05, max_iter: int = 20) -> "Belie
             raise ValueError(f"H must be 2D, got {H.shape}")
         nD, nQ = H.shape
 
-        hyper_ids = {}
-        edge_ids = {}
-        hyper_to_edges = {}
-        priors = {}
+        hyper_ids: dict[tuple[int, ...], int] = {}
+        edge_ids: dict[tuple[int, ...], int] = {}
+        hyper_to_edges: dict[int, set[int]] = {}
+        priors: dict[int, float] = {}
+        # Type hints for mypy
+        _hyper_ids: dict[tuple[int, ...], int] = hyper_ids
+        _edge_ids: dict[tuple[int, ...], int] = edge_ids
+        _hyper_to_edges: dict[int, set[int]] = hyper_to_edges
+        _priors: dict[int, float] = priors
+        # Avoid unused variable warnings
+        _ = _hyper_ids, _edge_ids, _hyper_to_edges, _priors
 
         for q in range(nQ):
             dets = tuple(sorted(np.nonzero(H[:, q])[0].tolist()))

python/qector_decoder_v3/belief_matching.py

@@ -36,7 +36,7 @@ def decode_mmap(
     decoder_type: str = "cpu_batch",
     batch_size: int = 65536,
     n_shots: Optional[int] = None,
-    dtype: _np.dtype = _np.uint8,
+    dtype: _np.dtype[_np.uint8] = _np.dtype(_np.uint8),
     verbose: bool = False,
 ):
     """Out-of-core batch decoding via memory-mapped arrays.
@@ -71,13 +71,23 @@ def decode_mmap(
     output = _np.memmap(output_path, dtype=_np.uint8, mode="w+", shape=(n_shots, n_qubits))
 
     from . import CPUBatchDecoder, UnionFindDecoder
+    from typing import Union
+
+    _Decoder = Union[CPUBatchDecoder, UnionFindDecoder]
 
     if decoder_type == "cpu_batch":
-        decoder = CPUBatchDecoder(c2q, n_qubits)
+        decoder: _Decoder = CPUBatchDecoder(c2q, n_qubits)
         batch_fn = decoder.batch_decode
     else:
         decoder = UnionFindDecoder(c2q, n_qubits)
-        batch_fn = lambda batch: _np.array([decoder.decode(batch[i]) for i in range(batch.shape[0])])
+
+        def _batch_decode_uf(batch: _np.ndarray) -> _np.ndarray:
+            out = _np.zeros((batch.shape[0], n_qubits), dtype=_np.uint8)
+            for i in range(batch.shape[0]):
+                out[i] = decoder.decode(batch[i])
+            return out
+
+        batch_fn = _batch_decode_uf
 
     n_chunks = (n_shots + batch_size - 1) // batch_size
     for chunk_idx in range(n_chunks):

python/qector_decoder_v3/decode_mmap.py

@@ -32,6 +32,7 @@
 from typing import Optional
 
 import numpy as np
+from numpy.typing import NDArray
 
 __all__ = ["DecoderPool"]
 
@@ -118,7 +119,7 @@ def __init__(
         self._nq = int(n_qubits) if n_qubits is not None else None
         self._decoder_type = str(decoder_type)
         self._n_workers = n_workers or os.cpu_count() or 1
-        self._pool = None
+        self._pool: Optional[_mp.pool.Pool] = None
 
     def decode(self, syndromes) -> np.ndarray:
         """Decode a batch of syndromes.
@@ -155,11 +156,12 @@ def decode(self, syndromes) -> np.ndarray:
                 initargs=(checks_tuple, self._nq, self._decoder_type),
             )
 
+        assert self._pool is not None
         nw = min(self._n_workers, n)
         chunk_size = (n + nw - 1) // nw
         chunks = [(arr[i : i + chunk_size], i // chunk_size) for i in range(0, n, chunk_size)]
 
-        results = [None] * len(chunks)
+        results: list[NDArray[np.uint8]] = [None] * len(chunks)  # type: ignore[list-item]
         for idx, result in self._pool.imap_unordered(_worker_decode, chunks):
             results[idx] = result
         return np.concatenate(results, axis=0).astype(np.uint8)