Module wave 

DreamWaveController — decoherence-based observer representation.

The observer exists as a coherent wave form (particle cloud) that decoheres into zone-specific classical forms (humanoid, vehicle, fluid) when entering decoherence fields. The transition uses the quantum decoherence kernel:

coherence(t) = exp(-Gamma * t)

where Gamma is the zone’s decoherence rate. This is not metaphor — it is the same exponential decay that governs off-diagonal density matrix elements in open quantum systems (Lindblad master equation).

Clean Compute: all state is inline arrays. Zero allocation per frame. Pre-allocated bone target buffer reused every frame.

Structs

Complex

Complex number for density matrix operations. No external deps.

DecoherenceField

A spatial decoherence field attached to a Zone or POI. When the observer enters the field radius, the wave form begins collapsing into the target form at rate gamma.

DecoherenceState

Tracks the observer’s current decoherence state. This is the density matrix diagonal — how “collapsed” the wave form is.

DensityMatrix5

5x5 density matrix for the locomotion Hilbert space H_loc = C^5. Basis: |I>=Idle, |M>=Moving, |J>=Jumping, |L>=Landing, |S>=Sprinting.

DreamWaveController

DreamWaveController — the observer’s wave form representation. Wraps ParticleController with zone-driven decoherence transitions.

InterferenceKernels

Interference kernel kappa_{n,ij} in C^3 for particle n between modes i and j. Controls how off-diagonal coherence rho_{ij} affects particle geometry.

LocomotionHamiltonian

Locomotion Hamiltonian H_loc = H_bias + H_input + H_couple + H_phase. Generates the unitary U_tick = exp(-iHdt/hbar_eff) each frame.

QuantumLocomotionState

Full quantum locomotion state — wraps density matrix, Hamiltonian, kernels. This is the quantum simulation subsystem that satisfies QUANTUM.md S11.

Enums

DecoherenceTagValue

Parsed result from a decoherence PropertyTag string.

WaveForm

The observer’s physical representation form. Transitions between forms are governed by DecoherenceFields on zones.

Functions

parse_decoherence_tag

Parse a decoherence PropertyTag string. Format: “decohere:form[:clip]” or “gamma:rate” Examples: “decohere:humanoid:climb_stairs” -> (Humanoid, “climb_stairs”) “decohere:fluid” -> (Fluid, “”) “gamma:4.0” -> Gamma(4.0)