# [ v. alpha ] 2026.10.15
## FIXED
* **Cue Delay Countdown**: The CD cell now counts down from the configured delay immediately, the next cue starts after exactly `cueDelay` seconds (previously one second later), and the configured value is restored afterwards; negative delays keep their configured value and cannot trigger twice. The narrow CD column no longer clips values.
* **Auto-Collapse Groups**: Groups collapse only when every cue played to its natural end, and re-expand when one of their cues restarts.
* **Demo Hotkeys**: Demo hotkeys no longer clash with the built-in 1-9 number-key shortcuts.
## ADDED
* **Master Stereo Position**: Added a left/right slider with a center button to the control panel; it pans the whole mix, leaves cue volumes unchanged, and is recorded in session exports.: Moved LOCK, MUTE, and STOP from the header into a bottom-right panel beside the shorter log panes, and added a large green GO button that starts the next cue in the list.
* **Auto-Collapse Played Groups**: Added opt-in `curtainCallOptions.autoCollapsePlayedGroups` to collapse a cue group once all its cues have finished; STOP/Escape expands all groups. Enabled in the demo.
* **Collapsible Cue Groups**: Each run of cues sharing a `group` now has a header row that collapses or expands them; hidden cues stay loaded and playable.
* **Cue Groups**: Added optional per-cue `group` (act or scene); cues in the same group share a muted row background from the preset `curtainCall.groupColors` palette. Disabled in high-contrast mode; demo cues grouped by act.
* **Windows Local Launcher**: Added `run-local.bat` and a built-in PowerShell TCP server with MP3 byte-range support, free-port selection, and automatic browser launch; no Python or administrator URL reservation is required.
* **Local Launcher**: Added a Python 3 availability check to the Linux launcher, with an install prompt when missing; Windows uses the built-in PowerShell launcher and requires no Python.
* **Repeat Crossfades**: Added per-cue `crossfadeDuration` for loops and multi-play cues; configured 5-second overlaps on the demo's repeated cues.
* **Master Mute**: Added a header control to mute or unmute all cues without changing cue playback, levels, or fade behavior; session exports record the master mute state.
* **Per-Cue Mute**: Added an independent mute toggle to each cue row; it preserves cue volume and fade behavior and records each cue's mute state in session exports.
* **Audio Ducking**: Added stable cue IDs, per-cue ducking settings, `all`/`*` target shortcuts, and a down-arrow-to-bar button in the FLAGS column that opens the configured ducking JSON; targets default to none, and the demo phone-warning cue lowers ambience with a timed release.
## UPDATED
* **Markdown Instructions**: Converted the standalone instructions to Markdown and updated the app link and offline cache to use the Markdown guide.
* **Control Tooltips**: Added direct action tooltips to header, dialog, and cue controls, including volume, mute, boost, fade/next, and ducking-settings actions.
* **File URL Audio Preflight**: Skip fetch-based HEAD checks on `file://` pages and report cue reachability as unverified instead of falsely marking every cue unavailable.
* **File URL Service Worker Handling**: Skip service-worker registration on `file://` pages and log that offline support requires HTTP/HTTPS, avoiding a misleading registration error.
* **Explicit Cue Options**: Added `crossfadeDuration` and `audioDucking` to every cue, using zero/empty targets where the options are unused.
* **Audio Test Formats**: Converted audio-folder M4A assets to MP3, switched the demo cue references and configuration example to MP3, and removed the original M4A files.
* **Fade-Out/Next Control**: Replaced the fade-out button symbol with `⏭` and added an accessible action label; playback behavior is unchanged.
* **ID and Hotkey Columns**: Set the cue ID and hotkey columns to matching compact widths while keeping two-digit cue numbers on one line.
* **Cue Flags Dialog**: Made the cue ID column compact and moved the ducking-source down-arrow-to-bar symbol into its own FLAGS column after HK; selecting it opens the cue's ducking settings.
* **Show Configuration Validation**: Validate required show metadata and cue fields before enabling playback, report all field-specific errors, and distinguish configuration validity from cue-file reachability.
* **Instructions Accuracy**: Aligned the guide with the current page layout, active show metadata and cue order, generated hotkeys, and implemented fullscreen behavior.
* **Emergency Stop and Reset**: Added a visible STOP control and made it share Escape's reset path; track and cancel app-owned timers, restore cue state, and reject stale play events so a stopped cue cannot restart or advance the show.
* **Log Pane Styling**: Added persistent pane labels, narrower contained scrollbars, clearer entry separation, and stronger severity emphasis for cue and console logs.
* **Verbose Log Export**: Added application/show metadata, a per-cue runtime/configuration snapshot, severity labels, and complete cue/console entries while excluding pane labels and empty-state UI.
* **Export Control**: Replaced the floppy-disk emoji with a simple download arrow to match the interface's monochrome controls.
* **High-Contrast Option**: Added `curtainCallOptions.highContrast`, disabled by default, and restored visible keyboard focus indicators.
* **Global Operator Lock**: Added a full-screen control lock that leaves active audio untouched, blocks app controls and shortcuts, and provides deliberate unlock and confirmed emergency-stop actions.

# [ v. alpha ] 2026.10.14
## UPDATED
* **Instructions File**: Moved interface instructions into `assets/html/instructions.html` as a standalone document.
* **Offline Support**: Added the instructions file to the versioned service-worker cache.
* **Asset Organization**: Grouped HTML content in `assets/html/`.
* **Standalone Instructions**: Opened the instructions document in a separate browser tab from the toolbar and F1 shortcut; removed the in-page overlay.
* **Verified Instructions**: Expanded the standalone guide with app-checked interface shortcuts, cue behavior, configuration fields, and accurate timing/hotkey details.
* **Complete Reference Guide**: Added the linked page's configuration examples, venue notes, and demo-audio usage guidance.
* **Usage Notice Consolidation**: Moved the active audio folder's usage notice into the standalone instructions and removed the duplicate README.
* **Consistency Review**: Corrected numeric shortcut guidance, product update metadata, repository ownership notes, and the audio license summary; marked working notes as historical reference.
* **Dark Instructions**: Applied a self-contained dark color palette to the standalone guide.
* **Markdown Log Formatting**: Standardized all release entries with consistent Markdown headings, categories, and bold labels.

# [ v. alpha ] 2026.03.31.3
## ADDED
* **Show Duration Tracking**: Added a live timer in the header that starts with the first cue and ends with the last, showing elapsed performance time.
* **Log Export Utility**: Added export of on-screen cue and console logs as a text file for post-show review.
## UPDATED
* **Playback Engine Refinement**: Improved `fadeAudioOut` logic for `nextCue` countdowns during the final play of a loop or sequence.
* **Global Reset**: Updated Escape to reset the show timer, stop audio, and clear playback states.
## FIXED
* **UI Feedback Restoration**: Corrected `setPlaybackState` and element targeting so colors and status updates work regardless of DOM insertion timing.
* **Logging Reliability**: Fixed the `console.log` override for multiple argument signatures and on-screen mirroring.
* **Service Worker Error**: Filtered non-GET requests to fix unsupported HEAD request errors.

# [ v. alpha ] 2026.03.31
## UPDATED
* **Timing Precision**: Migrated the audio engine to the Web Audio API and `linearRampToValueAtTime` for sample-accurate scheduling.
* **Audio Stability**: Migrated playback to `AudioContext`, `GainNode`, and `MediaElementSourceNode`.
* **State Management**: Implemented a playback state machine: `Idle`, `Loading`, `Playing`, `Fading`, `Error`, and `Elapsed`.
* **Project Structure**: Reorganized CSS and JavaScript into `assets/` and moved application logic out of the main HTML file.
* **Modernization**: Refactored to ES6+ syntax and improved code modularity.
* **Offline Support**: Added a service worker with versioned caching and network-first strategies for show data.
* **Pre-flight Validation**: Added `validateShow()` to check configured audio files before performance.
* **UI Improvements**: Added a global status indicator and sandbox/portal detection.
* **AI-Driven Improvements**: Used AI for code refactoring, structural reorganization, and core issue identification.

# [ v. alpha ] 2025.09.09
## UPDATED
* **Interface Refinement**: Improved the interface for more intuitive use.

# [ v. alpha ] 2023.10.20
## UPDATED
* **Color Palette**: Improved the interface color palette.
* **Console Logging**: Restored native console logging.
* **Header Visibility**: Made headers consistently visible.
* **Unit Consistency**: Replaced `em` units with `rem` units.

# [ v. alpha ] 2023.09.03
## UPDATED
* **Help Section**: Cleaned up the help section; open it with F1.

# [ v. alpha ] 2023.08.16
## UPDATED
* **Help Section**: Cleaned up user guidance; open it with F1.

# [ v. alpha ] 2023.08.08
## FIXED
* **Archive Constructor**: Fixed the archive constructor.
## UPDATED
* **Configuration Cleanup**: Removed unnecessary configuration variables.
* **Version Display**: Added the application version and updated date to the interface.

# [ v. alpha ] 2023.07.25
## ADDED
* **Version Log**: Added a release log for tracking project changes.
