Repository navigation
Description
ArSonMix Production Routing — native-first matrix, no operator LAB
Decision / product-owner direction (2026-10-29). Replace the operator-facing experimental "Routing LAB" workflow with one integrated, immediately accessible ROUTING / PATCH workspace modeled on the proven interaction principles of Waves eMotion LV1. Do not copy Waves source code, logos, icons or proprietary graphics. Preserve ArSonMix premium brushed-metal console, native DSP SSOT, lightweight UI, plugin rack/Orbit, hardware protection and portable Studio.
0. Repository reconciliation — verified before implementation
- Baseline
main@81c892f39996689c63b5704dcc060a9c42f0339d(2026-10-29). Latest-main Chromium 40805612151 PASS; Windows MSVC/CTest and verified artifact 40805612139 PASS; main Pages publisher 40805722543 PASS. - GUI PR #140 merged (
b9fd300f7c075e5aefbfde3986d9bcc2cda6f95c), black LCD and lightweight splash; meter PR #142 merged (81c892f39996689c63b5704dcc060a9c42f0339d). Protect their GUI/meters, source CSS/standalone parity and user-approved 10CH+MASTER skin. - #141 OPEN, head
1267acc682146c01d091defc10e1933845ae17af, branch diverged 2 commits from current main; its final Windows 40799637002 and Chromium 40799637034 PASS on old base only. It adds useful native Show store browser/DRY recall, mono-master and SSOT master sync but still exposes LAB UI and alterssrc/Main.cpp,web/monitor.js,web/bridge.js. DO NOT bulk merge without reconciling against P0 UI: universal black LCD VU glass and paint-first lightweight native splash #140/P1K: measured native MASTER 48k LUFS-I and 4x intersample dBTP #142 and this product direction. Salvage useful native components and tests; remove/translate the LAB-specific operator UX. No claim that DRY recall equals full VST3 scene recall. - Legacy #128 still open and overlaps GUI/native; not a source to overwrite current main.
- P0 #15 OPEN: zero-FX crackle on real WASAPI hardware not yet physically resolved. CI green != live audio FAT.
Verified current architecture / product gap
- JUCE
LiveAudioEnginehas two separate paths: legacy CH1 VST3 production graph and an opt-inLiveDryRoutingLabgraph (10 inputs + 4 actual stereo AUX). The latter only becomes active onroutingDryApply, requires the legacy CH1 FX graph to be empty, androutingDryStopreactivates CH1; ordinary CH2..10 can be UI-only preview. Removing/renaming the LAB button alone would be a product defect. NativeDryRouteCommand::decode+RealtimeRoutePublisher+PreparedMixerBlocksupport bounded native 10CH / 4AUX, channel MONO/STEREO/BUS/NONE, physical input port masks, CH->CH and CH->AUX PRE/POST and MAIN mix, ACK/epoch/revision fences, graph retirement and zero-callback I/O/JSON/allocation.web/monitor.jscurrently renders a 760px scrollingLive Input Routing LABoverlay with per-CH MONO/STEREO/input-L/input-R/FX dropdowns, four AUX rows, and a separate send list.web/app.jsSIGNAL FLOW is an abstract 4-node diagram linking to this panel. There is no native arbitrary physical OUTPUT PATCH matrix; the live DSP currently operates primarily on one stereo L/R hardware output pair.- Even current vendor state handling and
#141DRY Shows do not support complete 10CH+4AUX VST3/Orbit capture/restore, latency compensation, separate per-AUX hardware outputs, professional recall safes.
1. Product contract (non-negotiable)
A. Opening ArSonMix immediately shows the real integrated mixer: 10 INPUT + 4 independent AUX + MASTER represented truthfully (no fake FX/meter previews in native). ROUTING is a primary workspace, not a LAB, no separate START/STOP LAB operation, no user-visible switch back to an incompatible CH1 mode. Device is selected explicitly in AUDIO SETUP; disconnected channels stay silent until patched, never auto-assign random ports.
B. One canonical native topology engine & one routing SSOT. Migrate the legacy CH1 FX/rack/Orbit into unified graph ownership without losing third-party processor identity or VST3 state. Do not instantiate a second audio engine, duplicate callback, or retain an unbounded parallel code path. Keep vendor lifetime/prepare/release off RT. Callbacks must remain allocation-/lock-/I/O-/JSON-free. Preserve existing nonblocking graph swap, bounded retirement, device DIRECT/epoch/ASIO identity fences, and fail-silent behavior. Keep a compatibility adapter temporarily for old JS/native command names, but remove user-visible LAB and ultimately dead code only after parity tests.
C. Waves-inspired routing UX, original ArSonMix artwork: compact 3-tab workspace INPUT PATCH | INTERNAL ROUTING | OUTPUT PATCH; main matrix axes left mixer destinations, top physical input port channels for Input Patch; Internal rows source CH1..10, columns CH bus returns, AUX1..4 and MAIN with visually separated tap/gain; Output Patch reserved for real selectable hardware outputs only after backend capability exists. Do not show unsupported GROUP/DCA/MATRIX/CUE network/device-to-device as functional. No fake grid cells on preview.
D. Tiny, readable matrix: fixed 10 rows; physical-port columns from actual active mask, horizontally scrollable/pageable when many (e.g. 8-16 visible); pinned channel labels, zebra separators, per-cell 24–30px for mouse with optional compact/large touch target, keyboard focus/arrows/Space, tooltip CH03 L ← Input 5. Mono rows one source; stereo paired L and R with atomic draft validation; patching one physical source to multiple strips allowed if backend permits. Empty connection=graph disconnected; device missing/stale=clear "UNAVAILABLE". Label port by native device name where supplied; no inference from same pin numbers across PCs.
E. Status semantics: neutral OFF, subtle hover (only CSS background/border color; no blur, filter, large shadow, transform, or rAF loop), turquoise ACK LIVE, amber unsaved DRAFT, red REJECTED/UNAVAILABLE, gray INAPPLICABLE, visible legend. Row/column hover emphasis is static via CSS or a single delegated pointer event, not a full reactive matrix rerender every 12Hz. Do not mutate audio on hover. Grid has one delegated click handler; never attach hundreds of listeners. No auto apply per click. Keep native revision token and committed-vs-draft SSOT distinct. Native ACK/error must identify affected cell and explain the reason. UI opens from top SIGNAL FLOW/ROUTING without an engineering modal round trip.
F. Interactions: a click toggles a draft connection; existing destination input side replaced deterministically, avoid accidental duplicate assignments. Stereo L/R edit keeps valid pair or explicit deliberate disconnection; no silent conversion. PRE/POST tap shown per connected internal send with gain and pan inspector. Graph cycle and capacity preflight on control thread and authoritative native validator; invalid route blocked, never silently clamped. APPLY ROUTING previews changed patches, demands OUTPUT MUTE only for unsafe structural operations, and never automatically unmutes. User must intentionally re-enable live output. CANCEL/REVERT restores from last accepted native route. Device epoch/hotplug clears or marks stale draft, never restores to a different microphone by identical integer pin.
G. No fake feature parity: MAIN stereo output only until OutputPatchPlan supports real physical pin mapping. Output tab can display accurate read-only MAIN L/R current pin mapping if known; disable otherwise. Physical AUX/CUE/record outputs become interactive only on backend support with hardware mask/epoch and anti-feedback validation. Shows: native snapshot of real graph, vendor VST3 state and Orbit only after safe quiescence; legacy browser localStorage scenes remain explicitly UI-only until migrated.
2. PR implementation ladder — no docs-only PRs, each must deliver running/tested product increment
R0 — Reconcile native live topology (P0). Keep main@81c892 and parallel approved GUI fresh. Make single default 10CH+4AUX real native processor graph; port CH1 existing VST3 chain/editor/Orbit into the one physical CH1 lane without dropping saved state or hot-routing independently; retire explicit LAB start/stop from product action path. Smoke: app boot, no device, device attach, CH1 FX/Orbit state, CH2..10 independent live controls/meters/FX and 4 AUX; no fallback to preview as "live"; no auto-unmute. Do not merge before offline state and MSVC/CTest tests. If transition needs staged work, keep a guarded internal compatibility adapter but never represent it as complete product mode.
R1 — Production INPUT PATCH matrix (P0/P1). Replace old web/monitor.js LAB overlay with web/routing-patch.js component and source-owned lightweight web/styles-src/..-routing-patch.css; bind to native status and ACK (NOT localStorage). Keyboard/hover/touch, port paging and legacy draft migration tests. Render from snapshot only on open/ACK/port change, not per telemetry tick. One state model shared by Input/Internal tabs.
R2 — INTERNAL routing matrix (P1). CH->CH bus, CH->AUX1..4, MAIN, 32 bounded sends, PRE/POST + gain/pan inspector and clear cell conflict/cycle reason. Preserve SEND levels and per-channel fader state when structural patch changes. Native readback and exact comparison to ACK. SENDS ON FADERS requires separate live send-gain control lane so fader movements do not recompile whole graph or require MUTE per sample; do not fake this on the normal channel fader.
R3 — OUTPUT hardware patch (P1/P2). Implement bounded immutable OutputPatchPlan for actual enabled ASIO/WASAPI output pins; MAIN L/R first, then AUX physical outs, explicit stereo pairing/monitor, device epoch and output mask checks. Use prepared multi-output render buffers + one RT publisher; maintain audible safety on layout/hotplug. Hide or disable unsupported device-to-device/record/cue routes.
R4 — Production Shows + FX + hardware FAT. Selectively reconcile #141 storage/preflight/mono/master fixes with newer main; full scene/VST3/Orbit/recall safe require vendor-specific thread affinity and safe capture/restore. P0 #15 external hardware FAT, sample rates, 128/256/480 frames, 1/2/10 CH, callback budget, click/dropout and full recovery.
3. Evidence and CI budget
- Primary WAVES sources: LV1 Patch Window Overview, Using Patch Window, v17 UI, v17.3 October 26 2026 fixes. Reuse interaction patterns, not branded pixels.
- R0–R4 PRs must be based on latest main and compare open P4 stage 4: browse and recall native DRY Shows with current-device ACK + muted graph publication #141/P0: gray OFF/green ON toolbar, stable JUCE Audio Setup, snapshot manager + native Show ARD #128 before every Main.cpp, bridge, monitor or CSS change. No cherry-pick of stale full files, no overwrite of P0 UI: universal black LCD VU glass and paint-first lightweight native splash #140 splash or P1K: measured native MASTER 48k LUFS-I and 4x intersample dBTP #142 measured master meters.
- Static tests:
node --checkon modules, unit tests for route draft/fanout/stereo/duplicates/cycle/epoch, native message-thread ACK integration, CSS source/standalone byte parity, Chromium 1680x920 and 1440x820, pointer sweep on onboard graphics, no per-telemetry full matrix repaint. Windows MSVC native CTest/embedded ZIP only after scope ready. One PR/one intentional full CI run per milestone, no docs-only build; postmerge build may run automatically. Live hardware FAT is a separate physical gate.
4. Definition of DONE
User can boot ArSonMix, select an actual audio device, press top-level ROUTING/PATCH, click CH01 x actual Input 1 (or CH01 L/R on a verified stereo device), optionally send CH01 to AUX1 PRE and MAIN, see DRAFT, confirm MUTE, APPLY, receive native ACK highlighted LIVE, then intentionally UNMUTE and hear actual sound on the authorized stereo output. GUI has no LAB mode or LAB start/stop and no preview-only channels misrepresented as native. Restart/remap never routes silently to another physical device. Controls stay responsive on low-end GPUs. Separate physical QA required to call it reliable live production.
Decision: do not implement a cosmetic Waves matrix over the old LAB toggle as a final product. Reconcile the production engine ownership first; UI is a trustworthy projection of it.
Activity
masarray commentedon Oct 29, 2026
R0A implementation checkpoint — 2026-10-29 (in-progress, NOT R0 complete)
Actual source branch PR #144, latest head
7f726a119de5346f643071431ed9caf9228a7724(basemain@81c892f39996689c63b5704dcc060a9c42f0339d). CH1 existing multi-insert VST3 rack now executes INSIDE native 10CH+4AUX PRE/POST send graph with a callback-scopedLiveGraphHandofflease (no second FX instances, plugin/Orbit identity preserved). Native graph duplicate CH1 VST3 rejected; latent CH1 FX including bypassed are rejected before apply; latent bypass cannot be reenabled while native routing active. DRY-only Show capture now checks independent CH1 vendor rack count (fail-closed) and CTest covers borrowed CH1 DSP/no callback allocation + Show rejection.Automatic review issues latency bypass and DRY Show missing FX fixed on later head; reviewer replies posted. Chromium exact-head run 40829677043 succeeded. Windows exact-head run 40829676912 is pending build validation; no merge or hardware qualification claim until PASS.
Still required for R0B: move default production source to unified real 10CH graph with explicit port patch/zero auto-unmute; safe CH1 structural FX ADD/REMOVE/MOVE and snapshot/Orbit edits without routine callback detach/device epoch loss; eliminate operator START/STOP LAB and dual-mode fallback. R1 Waves-inspired PATCH matrix only after R0B; no UI-only rename permitted. Product remains not FAT-qualified (#15).
masarray commentedon Oct 29, 2026
R0A MERGED AND VERIFIED — R0B is still open (2026-10-29)
Native milestone PR #144 squash MERGED to
main@798df72e58b5ce916328134795250a9182bcbcbd. Exact PR head7f726a119de5346f643071431ed9caf9228a7724passed Windows MSVC + 49/49 CTest and embedded GUI FAT_RELEASE_ACCEPTED, plus Chromium; reviewed P2 latency/DRY Show issues fixed and review threads resolved. No real hardware sound FAT, P0 #15 open.Implemented in native code: real existing CH1 multistage vendor VST3 chain and its Orbit identity now process as an externally leased lane inside the real 10CH+4AUX graph. No duplicate vendor object, no second output mix. Reuses existing zero-alloc RT control snapshot. Uncompensated latent CH1 slots (even bypassed) and duplicate native CH1 insert fail closed; unsafe DRY Show save with borrowed CH1 FX fails closed. Regression test covers real in-memory audio pass through CH1 external -> PRE/BUS and zero host RT heap allocation.
P0 engineering discovery for R0B:
LiveAudioEngine::audioDeviceIOCallbackWithContextnative branch currently returns early beforehandoff_.endCycle(cycle)(the legacy branch does finish it). This is safe ONLY becauseaddVst3/removeAt/moveSlot/restoreSnapshotare currently barred while native routing is active. Before unifying plugin structural edits, implement corresponding native callback graph-swap ACK and full-output fade at exact block boundaries; otherwise staged graph will never retire.Graph::Slotowns vendor plugins viaunique_ptr, so shallow-copying live plugin pointers into a new graph for ADD/REMOVE would be unsafe. R0B must introduce a carefully designed shared lifetime (e.g. one control-thread-owned processor registry with immutable graph read leases), ensuring vendorreleaseResourcesexecutes only after the last RT lease, never in callback. Preserve existing FX slot identities, bypass envelopes and Orbit, and never double-prepare or reinitialize unchanged vendor FX.routingDryStopand CH1 fallback only AFTER the above passes. Verify independent Clock Direct fences, safe structural silence/ACK and existing CH1 preset/Orbit/FX order controls. Rendering 10CH when unconfigured must remain fail-silent.Postmerge main Chromium 40830728262 PASS, GUI Pages publisher 40830844160 PASS, main Windows 40830728158 in progress at comment time.
masarray commentedon Oct 29, 2026
R1 INPUT PATCH shipped to main — 2026-10-29 (verified browser; Windows postmerge pending)
PR #146 SQUASH MERGED as
main@3ab35d3f3a8f8afef2a5909de531ab98618d61ba. Exact PR head854700021a74d0df57145a52170655749f0bce73Chromium SUCCESS, including native-mock routing matrix tests and 1680×920 / 1440×820 visual screenshots (artifact archive). Latest GUI baseline main369c2a9preserved, app.js restored byte-exact to approved standalone; new UI lives in native monitor.js, no CSS source drift.Product behavior: native toolbar ROUTING opens matrix in one click; 10 channel rows × 8 fixed-sized physical input ports/page (unused columns disabled), actual JUCE active port mask, explicit MONO/STEREO L+R/BUS/NONE, immutable device epoch draft, native revision, safe duplicate/incomplete port preflight, amber DRAFT versus green ACK LIVE versus removed-until-APPLY, REVERT native acceptedRoute. No route change on click/hover, no automatic unmute, no CSS filter/blur or telemetry-dependent redraw. The same existing
routingDryApplyandarMixRoutingLabAckbridge remain; no new engine or callbacks. INTERNAL/SENDS retains current native CH/AUX editing (R2 matrix unfinished); OUTPUT is truthful read-only active MAIN L/R (R3 physical patch unfinished).R0B product gate remains OPEN: legacy CH1 structural FX lifecycle and opt-in routing path are not yet one always-live native default, despite R0A #144 preserved CH1 multi-insert FX/Orbit render in the 10CH graph. Do not claim complete removal of dual-mode internals or all 10 strips active without native ACK. No vendor full Shows/Orbit recall or physical zero-FX crackle FAT (#15) is certified. Backend
dryRoutingLabaction names remain as compatibility but not presented as a user-facing LAB.Postmerge CI running: Windows MSVC/native tests 40849670196, Chromium main 40849670131. Confirm exact main Windows PASS and downloadable FAT ZIP before declaring Windows artifact ready.
Code audit/contract documentation:
docs/R1_NATIVE_INPUT_PATCH_MATRIX_20261029.md. Next milestones: R0B engine lifecycle; R2 internal SEND matrix; R3 physical output routing. No docs-only PRs or duplicated work.docs(orchestration): link MS1 MS2 MS3 and correct closed #143 status