Patch Notes 0.2.1

Descriptor Binding Source Dispatch Crash

A missing break after the NODE source type case in DescriptorBindingsProcessor::update_descriptor_from_node caused fallthrough into the AUDIO_BUFFER branch. Any binding with a node source would attempt a dynamic_pointer_cast on a null buffer and crash.

The function has been refactored into a dispatcher with three focused handlers: update_from_node, update_from_buffer, and update_from_network. Each handler validates its input on entry before proceeding.

NodeNetwork Audio Buffer Data Race

m_last_audio_buffer in ModalNetwork, WaveguideNetwork, and ResonatorNetwork was filled incrementally via push_back with no synchronisation between the audio thread writing and the graphics thread reading via get_audio_buffer. The read window was proportional to fill duration, making torn reads probable under normal async operation.

Each process_batch override now fills into a thread_local scratch vector, then acquires an atomic_flag spinlock to assign into m_last_audio_buffer and run apply_output_scale before releasing. get_audio_buffer acquires the same lock before copying. The lock is held only for the assign and scale pass, not during the fill. The clear + reserve + push_back pattern is replaced with assign throughout, eliminating reallocation risk on the shared buffer.

SoundFileBridge Incomplete Initialisation

SoundFileBridge::setup_processors was not calling initialize() before constructing SoundStreamWriter, leaving the bridge in an incomplete state. The missing call is inserted.

BufferOperation ROUTE Semantics

route_to_buffer and route_to_container now document that ROUTE is a batch operation for post-accumulation output, not live per-cycle routing. Live routing is handled by supply, clone, and per-buffer processing chains.

Availability

• Platforms: Windows, macOS, Linux
• Distribution: GitHub releases, Launchpad PPA, COPR, AUR
• Version: 0.2.1

No migration steps required.