Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,6 @@
> **M2 UNIFIED FX CONSOLE / BUS WORKFLOW 2026-10-31 (BRANCH IN VALIDATION):** Read docs/M2_UNIFIED_CONSOLE_BUS_WORKFLOW_20261031.md before editing FX Rack/bus routing. Current branch unifies CH1–10 FX Rack UI using one presenter and offers real +BUS/+FX BUS using an otherwise unused native 10CH lane and existing muted native ACK. It intentionally does NOT remove CH1's legacy vendor VST3 lease, create dynamic CH11, implement native MASTER FX/PDC, or certify physical #15 FAT. Protect device + SOURCE PR #228/#231/#232/#233, Show/Orbit, one JUCE callback, epoch revision ACK, and AGENTS product truth. The next major engine milestone is real per-ChannelId FxRack/Show migration, not another cosmetic branch.
> **LATEST PRODUCT/ENGINE CONTRACT 2026-10-31: M3 REAL DYNAMIC STUDIO CONSOLE.** Read [PRD v3](docs/PRD_STUDIO_CONSOLE_DYNAMIC_LIVE_V3_20261031.md), [ARD v3](docs/ARD_STUDIO_CONSOLE_DYNAMIC_LIVE_V3_20261031.md), [M3–M5 handoff](docs/HANDOFF_STUDIO_CONSOLE_M3_M5_20261031.md) BEFORE modifying channel, routing, bus, FX, Show or GUI. Studio One operator parity: real Add Channel, Add Bus for Selected Channels, Add FX Channel, permanent IN / primary OUT / parallel SEND and BUS source-count + selected highlight. A BUS is a NEW independent stable ChannelId, NEVER CH10 borrowed. ONE prepared native DSP graph, ONE JUCE callback, independently owned VST3 lease for CH1..N/Bus/Main, epoch/revision-fenced native ACK, zero unnecessary runtime allocations. Existing M2B and DEVICE4 MUST be preserved. Current M3 control-thread bus batch and PCM tests are NOT yet live GUI/ASIO features. No fake JS channels, no new timeline editor, no OBS-only routing, no absolute zero-millisecond latency promises. Preserve L2 compact premium brushed gunmetal faders/meter alignment, no blur/glow, low-end pointer performance and #15 0-VST crackle FAT gate. This CURRENT directive supersedes historical 10CH milestone priority/status, not the safety invariants.

> **M2 UNIFIED FX CONSOLE / BUS WORKFLOW 2026-10-31 (MERGED HISTORICAL BASELINE):** Read docs/M2_UNIFIED_CONSOLE_BUS_WORKFLOW_20261031.md before editing FX Rack/bus routing. Current branch unifies CH1–10 FX Rack UI using one presenter and offers real +BUS/+FX BUS using an otherwise unused native 10CH lane and existing muted native ACK. It intentionally does NOT remove CH1's legacy vendor VST3 lease, create dynamic CH11, implement native MASTER FX/PDC, or certify physical #15 FAT. Protect device + SOURCE PR #228/#231/#232/#233, Show/Orbit, one JUCE callback, epoch revision ACK, and AGENTS product truth. The next major engine milestone is real per-ChannelId FxRack/Show migration, not another cosmetic branch.

> **LATEST CROSS-THREAD STATUS (2026-10-31, main after #234):** Read [M1/M2 & release reconciliation](docs/RECONCILED_PROGRESS_M1_M2_20261031.md) FIRST. DEVICE2+SOURCE2 are merged together in #234 (`7db4ab70`); #232 closed superseded, never merge its old head. #235 M2 FX/BUS is OPEN with Chromium regressions and not production; #229/#225 FactoryFX overlap and need selective reconcile. The native Windows FAT ZIP from `main@a7fb6151` predates #234; use a newer successful main artifact when published. No MAONO/WASAPI hardware FAT or #15 zero-VST crackle clearance, and FactoryFX approved lock still empty. Older AGENTS milestones below are historical if they conflict. Preserve one JUCE device owner, one native graph/route authority, stable L2/RAIL3, and explicit native ACK / output safety.

Expand Down
2 changes: 2 additions & 0 deletions docs/ARD_PRD_MIXER_IO_AUX_BUS_REFORM_20261030.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
> **SUPERSEDED AS CURRENT PRIORITY BY STUDIO CONSOLE v3 (2026-10-31):** [PRD v3](PRD_STUDIO_CONSOLE_DYNAMIC_LIVE_V3_20261031.md) · [ARD v3](ARD_STUDIO_CONSOLE_DYNAMIC_LIVE_V3_20261031.md) · [implementation handoff v3](HANDOFF_STUDIO_CONSOLE_M3_M5_20261031.md). This earlier file remains historical detail. Existing 10CH native M2B and DEVICE4 are merged; live dynamic CH/BUS and common CH1 vendor lifecycle are NOT complete. Read v3 and current main before acting. Safety/Show/zero-FX hardware requirements here still apply.

# ArSonMix — ARD v2.0: Unified Mixer, Native Hardware I/O, FX Rack and AUX/Bus Routing

**2026-10-30 native-connected hardware matrix implementation:** [implementation ARD](ARD_HARDWARE_AUDIO_IO_MATRIX_20261030.md), [operator PRD](PRD_HARDWARE_AUDIO_IO_MATRIX_20261030.md), [handoff](HANDOFF_HARDWARE_IO_MATRIX_20261030.md). Matrix crosspoints use existing `monitor.js` staging and the native ASIO/WASAPI route controller. UI-only incomplete stereo cannot publish audio; MAIN physical output requires ACK. Still fixed 10 live sources+4 AUX; MS3B MONITOR and DYN2 expansion are separate; #15 hardware FAT is open.
Expand Down
28 changes: 28 additions & 0 deletions docs/ARD_STUDIO_CONSOLE_DYNAMIC_LIVE_V3_20261031.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
# ArSonMix ARD v3.0 — Single ChannelId Graph and Studio-style Bus Workflow
Date: 31 October 2026 · Technical architecture for #192, #95, #174 and #15

## Non-negotiable architecture
ONE JUCE AudioDeviceManager / input callback, ONE native immutable prepared audio routing graph, ONE authoritative session ChannelId roster and FX lease map. Do not add another WebAudio/JS DSP, plugin host, standby render graph or second callback. ArSonMix must remain a REAL-TIME mixer, not an audio editor. Use existing DynamicChannelRoster.h, DynamicPreparedMixerBlock.h and LegacyLiveGraphMigration.h, rather than rewriting a naive mixer from scratch.

## Domain / persistent state
- Stable uint64 ChannelId identifies each actual audio lane independently of display ordering and physical I/O pins. Roles: INPUT, GROUP, FX RETURN, MAIN and MONITOR. A VCA/DCA is a separate controller, NOT a signal-summing Bus.
- Channel: role, name, mono/stereo PROCESSING FORMAT, separately verified SOURCE binding, signed gain/pan/mute/solo, VST3 catalog refs + independently created native instance leases, primary OutputDestination, and zero-or-more parallel SEND edges PRE/POST with send gain, pan and enabled state. Naming source format vs processing format vs physical pin count must remain independent.
- The V3 control-roster implementation tags primaryOutput on a ChannelSendRef to preserve current DynamicPreparedMixerBlock edge ABI; the single primary OUT edge is distinct from other parallel sends. OUT NONE removes only primary output. DSP graph compiler must prevent cycles, duplicate graph edges, invalid destinations, format mismatches and accidental dry duplication.

## Atomic Studio transaction
- Add Bus for Selected Channels accepts expected session revision + a set of unique source ChannelIds, creates a NEW independent GROUP ChannelId, replaces each selected channel's primary OUT with new Bus, adds Bus's primary OUT → MAIN, and leaves all parallel SENDs unchanged. One action/one validated candidate, no half-routed intermediate session and no stale index references.
- Add FX Channel for selected channels creates new FX RETURN, keeps source primary OUT as-is, adds parallel POST SEND(s) at selected send gain, and connects FX return to MAIN. Separate empty BUS/FX commands create new nodes without sources; source can be assigned later. Rename/reorder/delete/copy/duplicate use the stable ID.
- Stage off RT, validate resource budget and compiled topological DAG, prepare channel scratch and VST instances off callback, then only publish live after approved device-epoch / route-revision / MUTE and native ACK. Failures leave accepted audio byte-identical, no hidden unmute or auto hardware switch.

## DSP and GUI wiring plan
1. DYN0 stable ChannelId roster and DYN1A/B preallocated PCM graph already exist. DYN1C control-thread createBusForSelected / setPrimaryOutput plus two-mic PCM tests are now implemented in the M3 candidate PR, NOT live user actions.
2. Migrate current 10 CH + 4 AUX + MAIN + independent MONITOR/secondary output Show to ChannelIds, matching old exact PCM and preserving sparse ASIO callback ordinal translation, channel mode, fader smoothing, solo closure, mono MASTER after FX, vendor Orbit, native CH1 Show chunks, editor identity and VST3 sidechain.
3. Resolve legacy CH1 special-case FX ownership. Key per-ChannelId native lease through single immutable audio schedule. No second processing/render or per-callback heap/mutex/JSON, no copying plugin object while busy. Prewarm/prepare/destroy in quiescent control thread with bounded fade/retirement.
4. Expose one native ACKed SessionSnapshot containing IDs/order, accepted sources, primary destinations and sends, fan-in count, plugin instances, meter IDs, and epoch/revision. JS app/bridge/mixer-io/monitor are projections of that same snapshot. Draft state is separate overlay; no placeholder Groups or parallel JS 10CH registry.
5. Render same compact strip component regardless of role; only source-specific controls (no physical preamp on BUS) are semantically hidden. Highlight relations from accepted graph on selection changes, not animated per audio buffer. Auto-bank/virtualize N strips at 1366px, preserve pinned MASTER and all L2 geometry.

## Reliability / vetoes
- Real-time callback: bounded preallocated buffers, no allocations/locks/device enumerate/VST lifecycle/graph sort/JS IPC. The renderer's prepared graph owns mono/stereo input, external FX callbacks via stable id, PRE/POST sends and physical MAIN/MONITOR split. Topology compile remains O(V+E) control-side with memory and CPU admission; do NOT promise unlimited active channels.
- MUTE→APPLY→native revision ACK governs structural changes; continuity and crackle must be tested physically. Realtime fader/pan/mute/send gain changes use smoothed RT-safe parameters, not graph rebuild.
- Regresion gates: old 10CH/4AUX/CH1 Orbital native state and Show, all M1/M2B and DEVICE4 source/device switching, master/monitor/secondary output route, independent streams and factory FX provenance, low-end GUI.
- 0-VST crackle issue #15 and true roundtrip ASIO/WASAPI measured latency are NOT solved by green Windows CI. Refuse to mark hardware FAT complete without real audio.
2 changes: 2 additions & 0 deletions docs/EXECUTION_HANDOFF_ARSONMIX_MIXER_REFORM_20261030.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
> **SUPERSEDED AS CURRENT PRIORITY BY STUDIO CONSOLE v3 (2026-10-31):** [PRD v3](PRD_STUDIO_CONSOLE_DYNAMIC_LIVE_V3_20261031.md) · [ARD v3](ARD_STUDIO_CONSOLE_DYNAMIC_LIVE_V3_20261031.md) · [implementation handoff v3](HANDOFF_STUDIO_CONSOLE_M3_M5_20261031.md). This earlier file remains historical detail. Existing 10CH native M2B and DEVICE4 are merged; live dynamic CH/BUS and common CH1 vendor lifecycle are NOT complete. Read v3 and current main before acting. Safety/Show/zero-FX hardware requirements here still apply.

# ARSONMIX — 2026-10-30 NEXT-THREAD EXECUTION HANDOFF (CANONICAL)

**R6 override (2026-10-30):** This historical G1/G2 handoff is NOT the current work queue. [Audited R6 architecture/current status](R6_CURRENT_STATE_ARCHITECTURE_EXECUTION_20261030.md), [operator UX contract](R6_OPERATOR_WORKFLOW_CONTRACT_20261030.md) and #176 L2 shell supersede it. Main@8251bd6e includes G1/G2, G3 and L2; next milestone #173 native mono/stereo, then #174 typed FX/group buses, #175 multi-hardware outputs, #95 FX/PDC and parallel #15. Keep all 11 faders linked, original VST CH1 Orbit, native ACK/MUTE, and existing left rail. Treat old statements below as historical for their date.
Expand Down
30 changes: 30 additions & 0 deletions docs/HANDOFF_STUDIO_CONSOLE_M3_M5_20261031.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# Handoff v3 — implement true Studio-style ArSonMix Console
Date: 31 October 2026 · Engineering execution / physical FAT

## Product directive and read-first order
Read AGENTS.md, PRD_STUDIO_CONSOLE_DYNAMIC_LIVE_V3_20261031.md, ARD_STUDIO_CONSOLE_DYNAMIC_LIVE_V3_20261031.md, DYN1B_LEGACY_PARITY_BRIDGE_20261031.md, then latest main branch, PR ledger, exact source and CI.
The app is a flexible realtime mixer for karaoke/live/podcast/broadcast; mirror Studio One CONSOLE operator actions (not arrangement/timeline editing), keep original ArSonMix material beauty, optimize for low-spec PCs and do not assume OBS/virtual cable.
Official sources: https://fenderstudiopromanual.fender.com/en/Content/Mixing_Topics/The_Console.htm ; https://fenderstudiopromanual.fender.com/en/Content/Mixing_Topics/Effects_Signal_Routing.htm

## Accurate baseline and concurrent owners
At original audit main 22e4fdf: M2B #235 merged with 10CH capacity and BUS borrowing an unused strip; DEVICE4 named ASIO/WASAPI source matrix merged; CH1 special legacy VST and native 10CH+4 AUX renderer unchanged. DYN0 and DYN1B are offline; DO NOT pretend live ADD TRACK. #192 = ChannelId graph owner, #95 native FX/PDC, #170 product, #174 bus, #15 hardware 0FX crackle. Older unmerged #115/#117/#225/#229 PRs may conflict; do not bulk merge.
This PR adds a real CONTROL-THREAD group/parallel-FX batch operation plus one deterministic PCM regression. It does NOT expose new live channels yet.

## M3 — one meaningful native live feature milestone, not tiny UX PRs
- Keep exactly ONE callback and graph. Start by compiling actual incumbent routing (10 CH, 4 AUX, monitor, MAIN, source aliases, device/epoch/revision) into ChannelId-based PCM and comparing native sampled audio plus plugin order. Freeze Show compatibility and plugin instance lifetimes; CH1 vendor Orbit and editor must not be orphaned.
- New control API supports ADD BUS FOR SELECTED CHANNELS: unique source IDs, new GROUP ID, source exclusive OUT to Group, Group OUT MAIN, preserve existing sends. ADD FX CHANNEL: same new node but sources keep their OUT and gain-controlled parallel sends. OUT NONE is silent on primary but independent sends can continue.
- Add real native command/ACK with stale revision, cycles, device epoch, full budget and malformed input rejection; prepare VSTs off RT, bounded ramp handoff and memory retirement safe. No new physical pins, duplicate graph, callback allocations or uncontrolled structural change while output armed.
- Gate: two physical inputs to genuinely new Group + FX Channel (not CH10), correct FX insert/process and meter, positive native ACK, rollback preserving old audio and old Show, old 10CH golden PCM, build + package green. No fake GUI +BUTTON until this passes.

## M4 — integrated premium Studio Console GUI
- Full Ctrl/Shift multi-select and right-click Add Bus for Selected Channels in one action. Empty ADD CHANNEL, ADD BUS, ADD FX CHANNEL; rename/duplicate/delete/reorder and saved user Strip/FX state. Safe 1366px banked UI and pinned MAIN.
- Every common strip shows IN verified alias (or BUS IN source count), OUT primary MAIN/BUS/NONE, parallel sends PRE/POST levels. BUS input count opens source list with Select All and Hide/Show Sources; select a BUS highlights its sources and destinations; optional Signal Flow selected map solid primary vs dashed parallel. Show live accepted state distinct from DRAFT.
- No tooltip clutter, blur/glow or huge cards; preserve exact fader PNG, knob feel, 11-strip L2 grid and fast native/WebView2 pointer. Do not re-run routing graph based on hover or per-buffer meter paints.

## M5 — hardening, PDC, true physical FAT and distribution
- Equal CH1..N/FX/MAIN insert lease and editor, native MASTER FX/PDC policy with intentional zero-FX fast path, full VST3 vendor chunks on Show Save/Recall, correct physical and monitor buses.
- Native golden/negative tests (2 mic submix, parallel FX, OUT NONE, nested bus/no feedback, resource budget, stale device, editor lease, plugin failure rollback), Chromium 1366/1440/1680, Windows exact-SHA MSVC/CTest + integrity-verified ZIP, then physical Windows ASIO/WASAPI 44.1/48/96k at 64/128/256 frames, measured latency/xruns, 30-minute soak, #15 0FX crackle, vendor driver unplug/hotplug and low-end iGPU.
- Save exact source SHA, device driver, patch, buffer, log/spectrogram/loopback and evidence. Hardware FAT cannot be marked PASS from CI screenshots. Do NOT promise absolute 0ms latency, unbounded active channels or third-party plugin licenses.

## Merge and efficiency rules
One integrated M3 code gate per meaningful delivery; no repeated commits that run Windows CI for docs-only changes. Refresh main and PR head before merging. Never destroy M2B/DEVICE4/FX lease; reject unsafe operation and retain previous accepted graph. Keep product decision, ADR/PRD/HANDOFF synchronized through versioned docs, not contradictory stale historical handoffs.
2 changes: 2 additions & 0 deletions docs/PRD_ARSONMIX_PRO_MIXER_WORKSPACE_ROUTING_20261030.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
> **SUPERSEDED AS CURRENT PRIORITY BY STUDIO CONSOLE v3 (2026-10-31):** [PRD v3](PRD_STUDIO_CONSOLE_DYNAMIC_LIVE_V3_20261031.md) · [ARD v3](ARD_STUDIO_CONSOLE_DYNAMIC_LIVE_V3_20261031.md) · [implementation handoff v3](HANDOFF_STUDIO_CONSOLE_M3_M5_20261031.md). This earlier file remains historical detail. Existing 10CH native M2B and DEVICE4 are merged; live dynamic CH/BUS and common CH1 vendor lifecycle are NOT complete. Read v3 and current main before acting. Safety/Show/zero-FX hardware requirements here still apply.

# ArSonMix — PRD v2.0: Pro Digital Mixer, Channel Modes, Hardware I/O and AUX/BUS

**2026-10-30 hardware setup implementation addendum:** [crosspoint PRD](PRD_HARDWARE_AUDIO_IO_MATRIX_20261030.md) adds real verified-pin M/L/R input and MAIN output matrices reusing the existing native epoch/revision ACK controller. This is a focused operator UX milestone, not a second DSP engine or completion of physical MONITOR/DYN2/zero-FX hardware FAT. The existing descriptions below are architectural goals and may reflect earlier implementation states.
Expand Down
Loading
Loading