onq-v0.5.0

Release Notes: onq v0.5.0

The Isotropic Vector Matrix Update

onq v0.5.0 represents the most significant architectural leap in the history of the project. We have fundamentally deprecated standard quantum mechanics emulators—and the massive $O(2^N)$ memory wall they require—in favor of a localized, geometrically constrained physics engine built strictly from first principles.

onq is now a true structural physics simulator, running complex algorithms with $O(1)$ memory efficiency.

🚀 Major Architectural Shifts

• The Isotropic Vector Matrix (IVM): The flat global state array has been completely removed. The ONQ Virtual Machine now initializes a 3D geometric grid comprising 64 physical nodes (the 64 Tetrahedron Grid).
• The $2^N$ Memory Wall is Dead: Computation is now handled via a Projected Entangled Pair State (PEPS) tensor network. Quantum operations are calculated strictly locally ($O(1)$ complexity).
• The Locality Rule: Spooky action at a distance is now prohibited by the engine. Operations that entangle QDUs (like RelationalLock and ControlledInteraction) will instantly throw a Topological Error if the target nodes are not physically adjacent on the tetrahedral grid. Algorithms must physically route information across structural pathways.
• Deterministic Phase Coherence: We have removed random number generators (RNG) from the measurement process. The Stabilize operation now collapses wavefunctions deterministically using the Golden Ratio ($1/\phi \approx 0.618$) as a strict coherence threshold.

🛠 Engine & VM Improvements

• Flawless Teleportation Routing: The vm_teleportation example has been validated on the new physical grid. Because of the new Locality Rule, teleportation is no longer just a mathematical trick; it successfully acts as a necessary bridge, routing state transfers down an adjacent wire of QDUs where direct entanglement is physically impossible.
• Geometric Validation Suite: The src/validation/ module has been rewritten to measure internal phase alignment of active local tensors, rather than iterating across global probabilities. Validation now executes in near-zero time.
• Deterministic Initialization: The VM now strictly sorts QDU IDs before mapping them to the IVM, ensuring that node layout is perfectly contiguous, predictable, and reproducible across different hardware runs.

🔄 New Paradigm: SWAP Routing (Real-World Topology)

With the introduction of the Locality Rule, onq now mirrors the spatial constraints of real-world physical quantum hardware (such as superconducting heavy-hex lattices). You can no longer run a two-QDU gate between non-adjacent nodes (e.g., QDU 0 and QDU 2).

To execute algorithms that require long-distance interaction, developers must now implement SWAP Routing. By chaining three QualityFlip (CNOT) operations, you can temporarily swap states down the contiguous physical wire of the matrix, execute your target interaction on adjacent nodes, and swap the states back to their original origin.

Note: The teleportation.ipynb notebook and teleportation.rs example have been updated to demonstrate SWAP routing. Other tutorial notebooks have intentionally been left "broken" under the new physics engine to serve as hands-on routing exercises for developers learning the Isotropic Vector Matrix!

⚠️ Breaking Changes

• The PotentialityState::new(vec![...]) constructor has been removed. State arrays are no longer supported. Use PotentialityState::new() to initialize the baseline geometric tensor network.
• SimulationEngine::init now strictly enforces a maximum hardware limit of 64 QDUs to map to the 64 available nodes of the Isotropic Vector Matrix.
• Several legacy matrix application methods (apply_single_qdu_gate, apply_two_qdu_gate, project_onto_subspace_state) have been purged from the core engine.

Full Changelog: v0.4.0...v0.5.0

onq-v0.4.0

Release Notes

• patch project_onto_subspace() logic
• add projection teleportation notebook

Full Changelog: v0.3.0...v0.4.0

onq-v0.3.0

Release Notes

• remove phase coherence check from stablize()
• add Bernstein-Vazirani notebook

Full Changelog: v0.2.0...v0.3.0

onq-v0.2.0

Release Notes

• add ONQ-VM
• update RelationalLock

Full Changelog: v0.1.2...v0.2.0

onq-v0.1.2

Release Notes

• fix a bug in apply_two_qdu_gate
• add teleportation example

Full Changelog: v0.1.1...v0.1.2

onq-v0.1.1

Release Notes

Update S(k).

This directly combines the measure of phase coherence and the measure of potentiality (amplitude). States must pass the filter (> 0.618), and among those that pass, those with higher coherence and higher amplitude are favored proportionally. It avoids the potentially excessive weighting of amplitude seen with |c_k|^4.

Full Changelog: v0.1.0...v0.1.1

onq-v0.1.0

Release Notes

Initial Release for testing.

Full Changelog: https://github.com/kn0sys/onq/commits/v0.1.0