Skip to content

P0 PRODUCT ROUTING: replace LAB with unified native live mixer + eMotion-LV1-inspired INPUT/INTERNAL/OUTPUT patch matrix #143

Closed

Description

@masarray

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 alters src/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 LiveAudioEngine has two separate paths: legacy CH1 VST3 production graph and an opt-in LiveDryRoutingLab graph (10 inputs + 4 actual stereo AUX). The latter only becomes active on routingDryApply, requires the legacy CH1 FX graph to be empty, and routingDryStop reactivates CH1; ordinary CH2..10 can be UI-only preview. Removing/renaming the LAB button alone would be a product defect.
  • NativeDryRouteCommand::decode + RealtimeRoutePublisher + PreparedMixerBlock support 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.js currently renders a 760px scrolling Live Input Routing LAB overlay with per-CH MONO/STEREO/input-L/input-R/FX dropdowns, four AUX rows, and a separate send list. web/app.js SIGNAL 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 #141 DRY 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

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

  1. masarray commented on Oct 29, 2026

    @masarray
    OwnerAuthor

    R0A implementation checkpoint — 2026-10-29 (in-progress, NOT R0 complete)

    Actual source branch PR #144, latest head 7f726a119de5346f643071431ed9caf9228a7724 (base main@81c892f39996689c63b5704dcc060a9c42f0339d). CH1 existing multi-insert VST3 rack now executes INSIDE native 10CH+4AUX PRE/POST send graph with a callback-scoped LiveGraphHandoff lease (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).

  2. masarray commented on Oct 29, 2026

    @masarray
    OwnerAuthor

    R0A MERGED AND VERIFIED — R0B is still open (2026-10-29)

    Native milestone PR #144 squash MERGED to main@798df72e58b5ce916328134795250a9182bcbcbd. Exact PR head 7f726a119de5346f643071431ed9caf9228a7724 passed 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::audioDeviceIOCallbackWithContext native branch currently returns early before handoff_.endCycle(cycle) (the legacy branch does finish it). This is safe ONLY because addVst3/removeAt/moveSlot/restoreSnapshot are 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.
    • Legacy Graph::Slot owns vendor plugins via unique_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 vendor releaseResources executes 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.
    • Must implement truthful startup routing and new native device mapping behavior (no invented microphone assignments), eliminate routingDryStop and 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.
    • Do not make a tiny cosmetic UI PR or rename LAB before the real engine split is gone. GUI source is approved 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 R1 matrix on P0 PRODUCT ROUTING: replace LAB with unified native live mixer + eMotion-LV1-inspired INPUT/INTERNAL/OUTPUT patch matrix #143 follows. One scoped CI validation after substantial R0B implementation.

    Postmerge main Chromium 40830728262 PASS, GUI Pages publisher 40830844160 PASS, main Windows 40830728158 in progress at comment time.

  3. masarray commented on Oct 29, 2026

    @masarray
    OwnerAuthor

    R1 INPUT PATCH shipped to main — 2026-10-29 (verified browser; Windows postmerge pending)

    PR #146 SQUASH MERGED as main@3ab35d3f3a8f8afef2a5909de531ab98618d61ba. Exact PR head 854700021a74d0df57145a52170655749f0bce73 Chromium SUCCESS, including native-mock routing matrix tests and 1680×920 / 1440×820 visual screenshots (artifact archive). Latest GUI baseline main 369c2a9 preserved, 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 routingDryApply and arMixRoutingLabAck bridge 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 dryRoutingLab action 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.

  4. added a commit that references this issue on Oct 30, 2026
    e8cc90b
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions