# Changelog All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [Unreleased] ## [0.3.0] - 2025-11-20 ### Added - **Pattern Scheduler** - High-precision continuous pattern playback - Cycle-based timing model (like TidalCycles) - Look-ahead scheduling with 10ms tick interval - Pattern hot-swapping without stopping playback - Multiple concurrent patterns - `PatternScheduler.schedule_pattern/2` - Start a looping pattern - `PatternScheduler.update_pattern/2` - Change pattern while playing - `PatternScheduler.stop_pattern/1` - Stop a specific pattern - `PatternScheduler.set_cps/1` - Adjust tempo (cycles per second) - `PatternScheduler.hush/0` - Emergency stop all patterns - MapSet-based deduplication prevents event double-triggering - No drift over time using monotonic clock and cycle arithmetic - **SuperDirt OSC Bundle Support** - Messages now sent with timestamps for precise scheduling - All `/dirt/play` messages wrapped in OSC bundles with timestamps - Configurable latency (default 20ms) for scheduling stability - New `SuperDirt.set_latency/1` to adjust scheduling latency - New `SuperDirt.get_latency/0` to query current latency - Enables look-ahead scheduling for pattern engines - Foundation for precise pattern timing in KinoSpaetzle ### Changed - Replaced Sonic Pi server info mechanism with standard SuperCollider `/status` command - Removed internal `sonic-pi-server-info` synth and `/sonic-pi/server-info` OSC path - Now uses standard `/status` and `/status.reply` messages for server capabilities - ServerInfo module simplified to use SuperCollider defaults for bus/buffer counts - More portable and standard SuperCollider integration - **BREAKING**: Renamed `OSC.load_synthdefs/0` to `OSC.load_synthdef_dir/1` - Now requires explicit path argument - No longer auto-loads built-in synthdefs on startup - Users must define or load their own synth definitions - **BREAKING**: Simplified `OSC.Group` API - removed stack-based group management - Changed from per-process group stacks to single group per process - Removed `activate_synth_group/2` and `restore_synth_group/1` functions - Added simpler `set_process_group/2` and `get_process_group/1` functions - `synth_group/1` remains as backwards-compatible alias - Still monitors processes and automatically cleans up on process death - Reduces complexity while maintaining essential functionality - Added platform-specific sclang path detection - `Lang` module now detects macOS, Linux, and Windows installations - Same platform detection as `mix waveform.doctor` task - Falls back to sensible defaults for each platform ### Removed - Sonic Pi-specific server information gathering - Internal node/group allocation for server info queries - All built-in Sonic Pi synth definitions (~90 .scsyndef files) - Users should define synths in SuperCollider directly - Or use SuperDirt for TidalCycles-style live coding - Or load custom synthdefs from their own directory - `OSC.save_synthdef/2` function (use standard file operations instead) - `OSC.load_user_synthdefs/0` function (use `load_synthdef_dir/1` instead) - `Waveform.AudioBus` module - automatic bus allocation removed - Not needed for basic synth triggering - Users can manage bus numbers directly in synth parameters if needed - Simplifies supervision tree (6 processes instead of 7) ## [0.2.0] - 2025-11-19 ### Fixed - **CRITICAL**: Fixed unlinked spawn in OSC UDP receiver - now uses supervised Task - **MEMORY LEAK**: Fixed unbounded list growth in Node tracking - now uses maps with periodic pruning - **MEMORY LEAK**: Fixed per-process group tracking leak - added process monitors to clean up dead processes - Fixed hardcoded magic node IDs that could conflict with user nodes - now uses high IDs (1M+) for system nodes - Added comprehensive error handling to UDP receive loop with graceful degradation - Moved synchronous calls out of OSC init to prevent startup deadlocks ### Changed - **BREAKING**: Removed macro-based synth definition system (`Waveform.Synth.Def`) - The complex DSL for defining synths has been removed - Users should define synths directly in SuperCollider instead - This simplifies the library to focus on OSC transport - **BREAKING**: Removed `Waveform.Beat` and `Waveform.Track` modules - High-level sequencing features removed - Library now focuses on low-level OSC messaging - Users can build their own sequencing on top of the OSC API - **BREAKING**: Removed `Waveform.Synth.Manager` and `Waveform.Synth.FX` - SonicPi-specific synth name mappings removed - Effects routing removed - Library is now synth-engine agnostic - **BREAKING**: Simplified `Waveform.Synth` API - New `trigger/3` function for straightforward synth triggering - Simplified `play/2` function for note-based synthesis - Removed chord and progression helpers (use Harmony library directly if needed) - Made `Harmony` dependency optional - Note name support is now opt-in - MIDI numbers work without any dependencies ### Added - Comprehensive documentation for all public modules - Package metadata for Hex publishing - MIT License - This changelog ### Removed - SmartCell integration (will be handled by dedicated packages like KinoSpaetzle) - 20+ UGen definition modules - SonicPi synth definitions - Beat/Track sequencing macros - Utility modules no longer needed ## [0.1.0] - 2024-01-30 ### Changed - Moved music theory code to separate `harmony` library - Updated README for Livebook usage - Switched from Porcelain to ExExec for process management ### Added - Initial SuperCollider OSC communication - Node and group management - Audio bus allocation - Basic synth triggering API - Macro-based synth definitions (later removed in 0.2.0) [0.3.0]: https://github.com/rpmessner/waveform/compare/v0.2.0...v0.3.0 [0.2.0]: https://github.com/rpmessner/waveform/compare/v0.1.0...v0.2.0 [0.1.0]: https://github.com/rpmessner/waveform/releases/tag/v0.1.0