diff --git a/docs/RECONCILED_PROGRESS_STUDIO_CONSOLE_20261031.md b/docs/RECONCILED_PROGRESS_STUDIO_CONSOLE_20261031.md index 573a55d9a..3930fca46 100644 --- a/docs/RECONCILED_PROGRESS_STUDIO_CONSOLE_20261031.md +++ b/docs/RECONCILED_PROGRESS_STUDIO_CONSOLE_20261031.md @@ -1,48 +1,54 @@ -# ArSonMiX — authoritative progress reconciliation (31 Oct 2026, ~21:10 WIB) +# ArSonMiX — canonical engineering progress reconciliation (31 Oct 2026; post 21:59 WIB physical evidence) -**Read-first factual snapshot — not a physical release certification.** -Audited GitHub `main@d638fa5e8fed165cb7b2eb1c1bf849a25aa774f2` after merged M3 #242 and P0 capture diagnostics #241. Product: one Windows-first realtime LIVE digital mixer for karaoke, stage, podcast, radio and arbitrary operator-selected physical/software playback endpoints. **Not** a timeline editor, DAW, WebAudio DSP experiment, OBS-only host, or zero-millisecond end-to-end latency promise. +> **Status snapshot, not live-ready certification.** Verified against GitHub `main@2b581a37b6b4dff1e26d4d030e0d15cd8a23029f` (merged #246 M3C following #245 Product v4), issue #15 physical FAT evidence dated 2026-10-31 21:59 WIB, and active PR #246/#247. Refresh HEAD, PR SHA and CI when work resumes. This file supersedes its own older 21:10 WIB snapshot (which incorrectly said #243 was still open). For product/architecture/UI execution, **PRD/ARD/GUI/HANDOFF v4** is authoritative; v3 documents are historical. -This ledger supersedes *status snapshots* older than this head, including the top-of-file “after #234 / #235 OPEN” paragraph in AGENTS and docs/RECONCILED_PROGRESS_M1_M2_20261031.md. It **does not** supersede engineering safety rules or the current [PRD v3](PRD_STUDIO_CONSOLE_DYNAMIC_LIVE_V3_20261031.md), [ARD v3](ARD_STUDIO_CONSOLE_DYNAMIC_LIVE_V3_20261031.md), [M3–M5 handoff](HANDOFF_STUDIO_CONSOLE_M3_M5_20261031.md). +## Nonnegotiable product direction -## Verified main capabilities vs live limits +**ArSonMiX is a native real-time LIVE digital mixer + user-chosen VST3 host**, for live stage/karaoke, podcasts, broadcast/streaming, hardware and user-selected virtual/physical destinations. Target Studio One/Fender Studio Pro **Console** feature parity, not timeline editing, arrangement/recording or copied proprietary code/GUI. No OBS/virtual-cable dependency, no fake output pins, no unbounded active-lane claims or measured-zero-millisecond round trip. Keep premium compact steel GUI, stable fader geometry, low-end iGPU interaction and ONE JUCE output mix callback; no second WebAudio DSP graph. -| Domain | Actually merged / source-verified | Still absent or unqualified | -| --- | --- | --- | -| Native mixer | **ONE** JUCE AudioDeviceManager, one audio callback, fixed **10 physical input lanes + 4 internal AUX returns**, MAIN, independent physical MONITOR and optional clock-bridged secondary playback destination. Native route epoch/revision ACK and guarded MUTE/DISARM on topology changes. | Live runtime-added CH11+, arbitrary numbers of independent buses, general multidevice input capture, professional physical loopback/FAT. | -| Live controls | #223 real smoothed (<=64 samples) existing CH→AUX POST send gain; #231 AUX return master gain; #238 unified live changes in focused SEND editor; #236 coalesced live AUX drag; source switch where already patched and same-format. | Creating/deleting sends, channel format, physical patches, topology edits still require MUTE→APPLY→native ACK. No unrestricted live graph edits. | -| Studio I/O | #228 custom backend/device/rate/buffer/pin apply; #234 cached inventory with guarded rescan; #239 ASIO vs Windows Audio + actual M/L/R crosspoint; #240 DEVICE4 named mono/stereo logical input **aliases** bound to real reported device pins; #241 truthful RAW input PCM diagnosis while output muted. | “64 pins” is **hardware pin selection capacity**, not 64 native channels; named aliases are not actual new PCM channels; independent Windows capture devices cannot be silently combined. | -| FX and existing buses | #235 unified CH1–10 FX rack presentation, real bounded +BUS / +FX BUS routing by borrowing an unused live strip; current VST3 native ownership and Show must be preserved. | No independent **live** arbitrary GROUP/FX nodes beyond 10CH; CH1 legacy VST lease remains special, MASTER native FX/PDC/sidechain parity incomplete; no full LV1 DCA/MATRIX/CUE. | -| Dynamic Studio bus foundation | **#242 merged**: `DynamicChannelRoster::createBusForSelected`, exclusive `primaryOutput`, distinct parallel sends and real two-input PCM Group/FX Return regression on offline `DynamicPreparedMixerBlock`. Invalid selection, revision and budget fail closed; migration avoids doubled direct MAIN. | **OFFLINE CONTROL + PCM ONLY**. Not wired to production `LiveDryRoutingLab` callback, not a working user-facing ADD BUS/ADD CHANNEL menu, and not independently persisted live Show/plugin state. | -| User interface | Pinned MASTER, L2/RAIL3 aligned faders/meters, device-first I/O matrix, focused SOURCE→FX→SENDS→OUTPUT, one routing authority, native-ACKed SEND control. | Comprehensive low-end integrated-GPU pointer and long-run Windows FAT still not established. | +## Verified merged main: actual capabilities versus development-only foundations -## Current development / CI ledger +| Domain | Merged/live | Limits; NOT production-ready claims | +| --- | --- | --- | +| Hardware and First Sound | #228/#234/#239 verified ASIO/Windows Audio setup with driver port identity, rates/buffers; #240 named mono/stereo software capture aliases mapped to real enabled pins; #241 raw capture evidence while MUTE; **#243 FAST1** explicit one-click START AUDIO performs pending INPUT PATCH native ACK then output ARM ACK with epoch/revision guards and emergency MUTE. | Aliases live in browser storage, not portable Show I/O configuration. ARMED and accepted route do not prove audible signal. Driver return and patch changes still fail-closed. | +| Current LIVE DSP | Single native `LiveAudioEngine` callback calls `LiveDryRoutingLab`: fixed **10 physical-source channels + 4 internal FX AUX**, verified native MAIN/MONITOR output pins, secondary optional render, native epoch/revision ACK. Channel source, PRE/POST AUX sends and return master have true accepted DSP actions (#223/#231/#238); selected same-format input can switch live. | Not 16 independently creatable **live** lanes. #235 +BUS/FX BUS temporarily consumes an unused fixed CH lane, NOT a new independent Group/FX node. Current Show schema fixed and CH1 vendor FX/Orbit lease is special; no complete native Master FX, PDC, Listen/PFL/Cue, dynamic Scenes/VCA. | +| Dynamic control/PCM foundation | #242 M3 native `DynamicChannelRoster::createBusForSelected` with exclusive primary OUT, parallel SEND, Group/FX PCM tests; **#244 M3B** `DynamicNativeSessionPublisher`, immutable ChannelId publication, 16-lane C++ PCM/epoch/rollback tests; **#246 M3C MERGED** dynamic-graph ChannelId fader/PAN/PRE-POST sends and accepted native Console Bus routing snapshot. | **OFFLINE / CALLBACK-READY ONLY**. Production callback still renders legacy `LiveDryRoutingLab`; native ADD CHANNEL/ADD BUS beyond the fixed 10CH is NOT available. No duplicate parallel native callback. | +| Product architecture | **#245 merged** v4 realtime Console PRD/ARD/GUI/Handoff/traceability matrix and AGENTS guidance. | These are specifications/benchmarks, NOT shipped GUI, dynamics, native Master processing or a parity certification. | +| Factory FX | Existing VST3 import/host and native per-channel FX work are real. | `config/factoryfx-approved-releases.json` still has `"plugins": []`; old-base PR #225/#229 overlap and must NOT be bulk merged; no approved factory plugin bundle proven. | -- **Main** at audit: [d638fa5e](https://github.com/masarray/arsonmix/commit/d638fa5e8fed165cb7b2eb1c1bf849a25aa774f2) = merged [#242](https://github.com/masarray/arsonmix/pull/242). Chromium main [#41208906041](https://github.com/masarray/arsonmix/actions/runs/41208906041) **SUCCESS** at audit; Windows main [#41208906032](https://github.com/masarray/arsonmix/actions/runs/41208906032) **IN PROGRESS** at audit; check final run state before claiming exact-main package qualified. -- Last earlier combined main baseline **19ebb466** after [#241](https://github.com/masarray/arsonmix/pull/241): Chromium [#41204771543](https://github.com/masarray/arsonmix/actions/runs/41204771543) and Windows native [#41204771528](https://github.com/masarray/arsonmix/actions/runs/41204771528) both **SUCCESS**. This does not qualify #242 head. -- **OPEN [#243 FAST1](https://github.com/masarray/arsonmix/pull/243)**: one-click First Sound (verified native input patch ACK → explicit output ARM ACK + panic MUTE, and factual signal status), not yet on main. Its **PR head `50cb526b`** passes [Chromium #41205403390](https://github.com/masarray/arsonmix/actions/runs/41205403390) and [Windows #41205403498](https://github.com/masarray/arsonmix/actions/runs/41205403498). **DO NOT equate PR-head green with integration onto latest main**: compare shows diverged (22 ahead / 13 behind main), GitHub currently calls it mergeable. Rebase/reconcile narrow changes to current main, protect #242 roster, #241 raw capture, DEVICE4, live send gain, then exact integrated CI before merge. This FAST1 feature explicitly ARM-requests only after user clicks and native graph ACK; never auto-unmute on device reconnect/Show. -- **OPEN old-base [#229](https://github.com/masarray/arsonmix/pull/229) and [#225](https://github.com/masarray/arsonmix/pull/225)** FactoryFX/ArSonComp sources overlap. Do not merge both wholesale. `config/factoryfx-approved-releases.json` still has `"plugins":[]`: no approved bundled factory binary. A source/binary is not factory-qualified simply because its sibling CI passed. -- Remaining older open PRs are historical/stale or alternate architectural prototypes; retain their history but do not bulk-merge old `Main.cpp`, `monitor.js` and audio callbacks. +## Exact tested build, not a theoretical release -## P0 release blockers / product truth +- **Last native executable baseline with both software CI gates green:** `main@6022a4fc0218decac694568d73c772a634eba37a` (FAST1 #243 + M3B #244 included). +- Windows/MSVC native build, CTest and ZIP verification: [run 41210427151](https://github.com/masarray/arsonmix/actions/runs/41210427151) SUCCESS. +- Chromium UI smoke: [run 41210427286](https://github.com/masarray/arsonmix/actions/runs/41210427286) SUCCESS; GUI publish [41210546933](https://github.com/masarray/arsonmix/actions/runs/41210546933) SUCCESS. +- Artifact `ArSonMix-GUI10CH-P012-Verified-Hardware-FAT-Windows-x64` (ID `13046511716`) attached to that exact Windows run; **4,413,396 byte** GitHub artifact archive. Its provenance records `6022a4fc...`. This is a real Windows test candidate, **not** hardware FAT PASS. +- `main@150842ef...` #245 was docs-only; `main@2b581a37...` #246 M3C is a NEW native baseline. Exact-main Chromium [41214237250](https://github.com/masarray/arsonmix/actions/runs/41214237250) SUCCESS; Windows [41214237384](https://github.com/masarray/arsonmix/actions/runs/41214237384) **IN PROGRESS at audit**. Therefore last verified packaged Windows executable remains `6022a4fc...` until new native CI passes. Older #243 merge Windows run was cancelled by a newer build, not a compiler failure. -1. **[Issue #15](https://github.com/masarray/arsonmix/issues/15)** hardware crackling **with 0 VST3** is still OPEN. Last physical evidence predates recent fixes; software CI, simulated PCM vectors and callback CPU usage cannot establish crackle-free output or actual round-trip latency. #241 raw PCM under MUTE helps isolate silence vs output gate, but does NOT solve physical audio or crackle by itself. -2. First audible customer flow must be tested on real Windows ASIO and WASAPI devices: select verified capture device, prove raw PCM is present, patch MIC/virtual input to CH, receive native route ACK, explicit hardware ARM, hear MAIN L/R; investigate virtual cable direction, master and output mute, xrun/clock starvation, rearm and reconnect. Start with **0 FX**, 44.1/48 kHz, known buffer configurations and lower monitoring level. -3. Maintain honest measurable **near-zero extra mixer DSP latency** goal, not blanket 0 ms physical latency; secondary independent-clock path necessarily adds buffering/ASRC. +## P0 physical field evidence — audible sound exists; crackle persists with 0 FX -## Next meaningful milestone order (no duplicate engines / CI waste) +[Issue #15](https://github.com/masarray/arsonmix/issues/15) is **OPEN**. New real Windows report at 21:59 WIB: +- Capture: `CABLE Output (VB-Audio Virtual Cable)`; render: `Maono HP Out 1/2 (2- Maono ProStudio 2x2)`; Windows Audio/WASAPI 48 kHz, 480-frame/10 ms nominal device callback; `chainCount=0`, routed `fxCount=0`; output hardware ARMED, master unmuted. +- Native CH1/CH2→MAIN accepted, actual capture and routed MAIN PCM measured: `inputPeak=0.0739899`, `postFxPeak=peak=0.0184975`, `captureSignalBlocks=3341`. This **supersedes** the older screenshots showing OUTPUT MUTED/silence as the dominant current test state. +- 8,126 callbacks/~81 seconds; DSP worst 375 µs (~3.75% of nominal block deadline); over-budget=0, late starts=0; **113 WASAPI capture discontinuity flags** (`WASAPI_CAPTURE_DISCONTINUITIES_ONLY`). Audible user-marked crackle windows coincide with 4–6 capture flags in nearby 4–5 second windows. **Not proof of exact missing PCM samples or hardware render underrun**: render underrun remains unobservable through current JUCE API. +- `SMART_CLOCK_FAIL` was due to existing fail-safe `CLEAR PATCH and MUTE OUTPUT before changing device clock`; experimental independent ASRC was **not engaged** and has NOT been qualified as a workaround. Different capture and render devices need clock-domain investigation; no speculation that GUI hover, CPU worker or VST3 is root cause. +- Hardware release gate: A/B 0FX on single-interface MAONO ASIO/duplex path vs VB-Cable→MAONO WASAPI path, retain user glitch mark windows + real capture diagnostics, 44.1/48 kHz, proper output-only isolation where safe, and ≥30-minute clean supported wired route FAT. Keep native output mute and epoch safety, no silent automatic hardware reopen/unmute. -**Gate A — FAST1 integration + first audible field-test path:** reconcile #243 on current main; exact integrated Chromium + Windows native CTest/ZIP, then user physical INPUT→CH→MAIN/OUTPUT and 0FX #15 FAT. Keep one native route ownership and ARM safety. Never display LIVE from JS intent alone. +## Active PR ledger — refresh exact SHAs before merge -**Gate B — M3-LIVE single prepared ChannelId graph cutover:** migrate 10CH+4 AUX+MAIN/MONITOR into `DynamicPreparedMixerBlock` inside **the existing one JUCE callback**, with real FX instance leases and CH1/Orbit/editor/vendor Show preservation; validate legacy PCM A/B, gain smoothing, pending VST state and epoch/revision/rollback. Do not graft a parallel callback. +- [#247 — P0 capture continuity evidence](https://github.com/masarray/arsonmix/pull/247) **OPEN, not a crackle fix**. Head at audit `7aabec5405c77406b0a037c60a1b141948ccf9a7`, originally based on `150842ef` (must reconcile with merged M3C main): `CaptureBoundaryEvidence` counts candidate capture zero-prefix frames without a second PCM pass, status counters, native 100k-block test + Windows integration. Earlier Windows run `41213975060` was cancelled after newer commits; latest run `41214046305` was **IN PROGRESS** at audit. No merge until exact-head MSVC/CTest success and regression review. Zero-prefix is a **heuristic**, not confirmed xrun. +- [#246 — M3C native ChannelId parameters / accepted Console snapshot](https://github.com/masarray/arsonmix/pull/246) **MERGED** as `main@2b581a37b6b4dff1e26d4d030e0d15cd8a23029f`: native dynamic-graph realtime fader/PAN/PRE-POST sends and Bus fan-in/primary OUT/sends snapshot, **still outside production `LiveDryRoutingLab` callback**. PR-head Windows [41213222600](https://github.com/masarray/arsonmix/actions/runs/41213222600) SUCCESS; exact-main Windows [41214237384](https://github.com/masarray/arsonmix/actions/runs/41214237384) running at audit. No code/file overlap was seen with #247 at earlier reviewed heads; still reconcile latest origin. Next is **M3D single native callback cutover with legacy FX/PCM parity**. +- Historical open prototypes/FactoryFX branches #225/#229/#59/#128/#117/#115 etc must NOT be blindly merged; relevant work should be selectively ported only after current-main comparison. -**Gate C — true Studio Console Add Channel / Add Bus / Add FX Channel:** after Gate B, wire atomic #242 control roster/batch to native session ACK, then provide selected-channel multi-select/right-click, independent named bus strip, explicit IN/primary OUT/parallel SEND, source fan-in popover, virtualized bank, and independent FX rack. No borrowing CH10 in the final product. +## Sequenced meaningful execution — no repeat work, no wasted native CI -**Gate D — production FX, Show, performance:** per-ChannelId VST3/MASTER leases + PDC, safe live editor/reorder, factory legally approved SHA/UID locked binary packaging, full Show/Recall Safe, low-end GPU profiling and hardware soak. +1. **P0 first:** qualify #247 as *evidence only* (one exact-head Windows native/CTest gate) and run a controlled hardware A/B before changing drivers/clock or audio engine. If evidence pinpoints capture reservoir shortages, make one measured bounded capture-path fix; if it points elsewhere, don't guess. Never close #15 based on synthetic vectors. +2. **M3D dynamic callback cutover:** consume merged #246 ChannelId controls/snapshot, then replace `LiveDryRoutingLab::process` with one verified prepared ChannelId renderer **inside existing callback** while preserving 10CH+4AUX PCM, vendor CH1 FX/Orbit/editor lease, MAIN/MONITOR, secondary output and Show. Use golden PCM and native lifecycle/rollback tests. No second graph, duplicate PCM processing or auto-ARM. +3. **Studio Console operator milestone:** after live native ChannelId ACK and dynamic capability are real, add channel/bus/FX channel as independent IDs, multi-select Add Bus for Selected, canonical IN/OUT and SEND assignment, Group fan-in, role strips and dynamic scene state. Retire borrowed-CH workaround only with migrator. Keep named HW source identity and rapid FAST1 workflow. +4. **Professional live quality:** native Master FX, plugin PDC/sidechain, Listen/PFL/AFL/Cue, scoped Show/Scenes/VCA, audited first-party FX import/release policy; physical low-latency field FAT + iGPU hover/meter/fader resilience. -## Ownership and rules for next agent +## Engineering safety and authority -- Start from current main and active PR heads; compare ancestry and file ownership before touching source. Old docs/AGENTS milestones below this snapshot are history, not instructions to reset the current architecture. -- Keep single JUCE device owner, one callback, immutable off-RT prepared graph; no RT heap, blocking mutex, JSON/device scan or VST instantiation. Use preallocated data and bounded epoch/revision ACK publication. -- Preserve compact premium gunmetal mixer appearance; no blur/filter mouse-hover workload, no fader geometry change without evidence. Product is audio-reactive **real-time** digital mixer, not DAW. -- CI economy: prefer ONE exact integrated Windows build/CTest/ZIP + Chromium per meaningful milestone after cheap local syntax/source-contract tests. Never count green old-head CI as release qualified. Physical FAT is independent. +- One native PCM owner, one prepared graph active per callback, device epoch/revision/request ACK, output MUTE can never be blocked. No RT allocation/locks/driver scans/GUI/VST construction or releases. Preserve true device pin masks and physical output routing. +- First Sound is **one explicit operator START action** but never implicit output arming on reopen/Show; physical volume safety. Source selection and hardware patch must have real native ACK and truthful input/output PCM signals; don't equate graph READY to audible sound. +- Documentation source of truth: [PRD v4](PRD_ARSONMIX_LIVE_STUDIO_CONSOLE_PARITY_V4_20261031.md), [ARD v4](ARD_ARSONMIX_LIVE_STUDIO_CONSOLE_PARITY_V4_20261031.md), [GUI v4](GUI_ARSONMIX_STUDIO_CONSOLE_V4_20261031.md), [handoff v4](HANDOFF_ARSONMIX_STUDIO_CONSOLE_V4_20261031.md), [v4 feature ledger](STUDIO_CONSOLE_PARITY_MATRIX_V4_20261031.md). +- For every milestone: compare current HEAD and open PR owners; cheap local targeted contract/source tests → ONE exact SHA Windows native/CTest/ZIP + Chromium smoke if UI changes → physical FAT. No heavy workflows for docs-only corrections. No claims of "0ms", "fully Studio One", "16 live channels", "no crackle" without proof.