Skip to content

M1: realtime AUX parity, 64-sample fader continuity and bounded graph lifetime - #287

Merged
masarray merged 6 commits into
milestone/m5-universal-channelid-vst3-lease-migration-20261101from
work/m1-realtime-stability-20261102
Nov 2, 2026
Merged

masarray merged 6 commits into
milestone/m5-universal-channelid-vst3-lease-migration-20261101from
work/m1-realtime-stability-20261102

Conversation

@masarray

@masarray masarray commented Nov 2, 2026

Copy link
Copy Markdown
Owner

M1 stacked engineering patch (parent: ENGINE #266)

Based on 40a059785993cc6a4bb593020bf9749de92746f9, preserving the existing full-fidelity M4→ChannelId migration work. This is real C++/CTest code, not a GUI mock.

Delivered

  • Correct PreparedMixerBlock: AUX PRE/POST and return gain's live automations do not contaminate legacy offline/static PCM when no realtime control bank is supplied. Fixes the exact failing TenStripStaticRoutingAndMaster case at mixer_routing_plan_test.cpp:803.
  • Live fader/PAN gain now persists its 64-sample ramp state across 4/16/32-frame audio callback blocks, including a target reversal; fixed-size scratch only, no extra DSP callback.
  • Add deterministic PCM regression for 4+16+32+12 and 4+60 sample ramps.
  • Add bounded retirement regression for RealtimeRoutePublisher: leased readers survive publication, saturated retired queue safely rejects, every prepared resource is reclaimed by control polling after reader release.
  • Consolidate documentation + remaining full-cutover gates in docs/M1_REALTIME_CORE_STABILIZATION_20261102.md.

Fail-closed / safety

  • No GUI, mock, WebAudio, background DSP worker, plugin recreation, or device restart.
  • Maintain one JUCE native callback; reuse existing native worker/control pathways for expensive operations and existing VST3 owner lifetime.
  • Do not merge or enable universal LIVE until [ENGINE SOLE OWNER] One native callback → full-fidelity ChannelId cutover (draft) #266 native callback cutover and Windows/physical FAT pass. Full CH1 external/Orbit, Show/editor, AUX/MONITOR, and hardware ownership parity are still unqualified.

Validation

masarray commented Nov 2, 2026

Copy link
Copy Markdown
Owner Author

M1 hardware-gate checkpoint — exact source 773fbddafdbc070831f496a1a6269230f96ce120

Previous MSVC build was successful but CTest had 52/54: native AUX standalone automation silently disabled if RealtimeStripControls* was null, and memory test undercounted the intentionally discarded rejected graph. Both have been corrected in one atomic C++ + contract/test patch. PreparedMixerBlock again keeps its native AUX control plane independent of the optional channel-fader plane, with an explicit fresh compiled graph test to catch stale state leaking on recall.

The same existing Windows workflow now allows uploading an ArSonMix-M1-EXPERIMENTAL-Hardware-FAT-Windows-x64 artifact for this single named PR branch, only after all 54 CTests, packaging and independent source/embedded GUI/PE/SHA256 verification pass. The updated packaged HARDWARE_FAT_GUIDE.md includes 0FX 30-min, channel motion, AUX+MONITOR, VST3/Show, hotplug and provenance acceptance criteria. This is deliberately not a public stable release and is still the true M4 10CH+4AUX callback, not an unverified live universal CH11.

Exact workflow: https://github.com/masarray/arsonmix/actions/runs/41483035937

Outstanding architectural milestone: admit all original CH1 external/Orbit+vendor FX instances and native Show/editor/verified output leases into the universal ChannelId engine, then switch the one JUCE callback atomically without second PCM. No fake LIVE capability until a real hardware FAT proves it.

masarray commented Nov 2, 2026

Copy link
Copy Markdown
Owner Author

Engine cleanup: one runtime authority, no competing GUI-era audio engines

Stacked M1 PR #287 now carries the ownership cleanup at 1e21bf0a0d8aff33b02b56cec5c2e5c328fd41d1 (base ENGINE #266). Its NativeRenderAuthority makes the actual JUCE callback select exactly one of: UNPATCHED=silence, accepted M4=native 10CH/4AUX, diagnostics=isolated 0FX. The unreachable old stereo VST3 renderer has been deleted, not hidden or duplicated. The test-only PreparedNativeMixerSession.h is no longer listed as an application target source; its dedicated tests remain.

docs/ENGINE_RUNTIME_AUTHORITY_20261103.md records one mapping: approved GUI #278/#285 → native GUI #271 → one JUCE callback; future ChannelId implementation #266 is prepared/offline until full native cutover, not a second live engine. Do NOT extend hardcoded M4 with new GUI product features. Keep M4 only as a safe compatibility adapter until CH1 vendor/Orbit/editor/Show/AUX/MONITOR parity + physical FAT is verified, then retire obsolete adapters in the SAME full-cutover PR. Do not prematurely close driver crackle #15 or workaround PR #251.

Contract tests were updated to reject VST processing in diagnostic fallback while confirming actual CH1 leased VST processing still exists. CI on exact SHA: https://github.com/masarray/arsonmix/actions/runs/41532805877 . No extra parallel Windows matrix. This is not a claim of universal CH11 or hardware FAT qualification.

@masarray
masarray merged commit 1e21bf0 into milestone/m5-universal-channelid-vst3-lease-migration-20261101 Nov 2, 2026
1 check passed

masarray commented Nov 2, 2026

Copy link
Copy Markdown
Owner Author

ENGINE OWNERSHIP RECONCILED (2026-11-03): every commit from this M1/stability branch was incorporated into the single canonical ENGINE branch via verified fast-forward, without rewriting/cherry-picking PCM or vendor FX ownership. The ENGINE #266 branch now contains this PR's final HEAD 1e21bf0a0d8aff33b02b56cec5c2e5c328fd41d1 as an ancestor plus the new one-owner architecture gate and runbook. To prevent two ENGINE implementation branches from diverging, this stacked PR is closed as superseded/absorbed, NOT falsely reported as a GitHub merged PR. All further ENGINE work, fixes and CI evidence belong exclusively to #266 (milestone/m5-universal-channelid-vst3-lease-migration-20261101). The one-owner runbook is docs/workstreams/ENGINE_SINGLE_OWNER_HANDOFF_20261103.md; Windows CI latest SHA: https://github.com/masarray/arsonmix/actions/runs/41534907348. Physical FAT and final universal callback cutover remain pending.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant