From 5d9713fa9303badd0b3324daac356837faafb631 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Sat, 31 Oct 2026 10:10:43 +0700 Subject: [PATCH] docs(audio): reconcile DEVICE1 merged native software with remaining hardware FAT --- AGENTS.md | 2 +- docs/ARD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md | 2 +- docs/ARD_HARDWARE_AUDIO_IO_MATRIX_20261030.md | 2 +- docs/HANDOFF_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md | 2 +- docs/PRD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md | 2 +- docs/PRD_HARDWARE_AUDIO_IO_MATRIX_20261030.md | 2 +- docs/PRODUCT_TRUTH_CROSS_THREAD_20261031.md | 2 +- 7 files changed, 7 insertions(+), 7 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index c0c620e2b..783a86f13 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,4 +1,4 @@ -> **CUSTOM DEVICE SETUP DESIGN LOCK (2026-10-31) — IMPLEMENTATION PENDING:** Read [PRD](docs/PRD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md), [ARD](docs/ARD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md) and [per-file handoff](docs/HANDOFF_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md) before touching AUDIO DEVICE / DEVICE-DRIVER / ASIO / WASAPI. Existing WebView2 Audio I/O Matrix must become the SINGLE real device setup UI: backend, actual capture/playback endpoints, sample rate, buffer, enabled pins, APPLY with verified JUCE readback, fail-closed muted rollback. Keep ONE existing AudioDeviceManager, native routing epoch/ACK, MAIN/MONITOR/OUTPUT1/FX and #15 gate. Currently the DEVICE tab remains inventory-only and opens native AudioDeviceSelectorComponent; this feature is NOT YET IMPLEMENTED. Driver scans/opens may block vendor code: don't claim async bridge eliminates freeze; audit pinned JUCE thread affinity and instrument physical hangs. No second hardware setup UI, manager, audio graph or naive per-dropdown device restart. +> **DEVICE1 CUSTOM DEVICE SETUP MERGED #228 (2026-10-31) — CI PASS, PHYSICAL FAT PENDING:** Read [PRD](docs/PRD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md), [ARD](docs/ARD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md) and [per-file handoff](docs/HANDOFF_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md) before touching AUDIO DEVICE / DEVICE-DRIVER / ASIO / WASAPI. Existing WebView2 Audio I/O Matrix must become the SINGLE real device setup UI: backend, actual capture/playback endpoints, sample rate, buffer, enabled pins, APPLY with verified JUCE readback, fail-closed muted rollback. Keep ONE existing AudioDeviceManager, native routing epoch/ACK, MAIN/MONITOR/OUTPUT1/FX and #15 gate. Now DEVICE/DRIVER in the existing WebView2 matrix selects actual JUCE-reported ASIO/WASAPI/DirectSound backend, input/output endpoints, rate, buffer and verified pin masks; its native APPLY, muted rollback, readback and requestId ACK were merged in #228 at e0eaeafe88b9fdc997f3f6e7856331679db1ba7b. The old AudioDeviceSelectorComponent remains only a C++ engineering fallback and is NOT the normal UI. Physical MAONO/WASAPI FAT, vendor driver hangs and #15 0FX crackle remain UNQUALIFIED. Driver scans/opens may block vendor code: don't claim async bridge eliminates freeze; audit pinned JUCE thread affinity and instrument physical hangs. No second hardware setup UI, manager, audio graph or naive per-dropdown device restart. > **SOURCE1 + SETUP1 — 2026-10-31:** See [source/real-device integrated milestone](docs/SOURCE1_NATIVE_MUTED_FAST_COMMIT_20261031.md). 64-pin real JUCE ASIO/WASAPI/DirectSound selector; current hardware Input→CH from MIX ROUTE auto-submits via ONE native routingDryApply/ACK only if outputs already MUTED and no other drafts. Armed output fails closed, no auto-mute/unmute; true RT clickless source crossfade and persistent named aliases are NOT IMPLEMENTED. Preserve #223 AUX live, MAIN/MONITOR/OUTPUT1, L2/RAIL3, VST/Show and physical #15 gate.\n\n> **M1 LIVE AUX POST FADER (2026-10-31):** [Native implementation & FAT contract](docs/M1_LIVE_AUX_SEND_FADER_20261031.md). Ordinary gain on an EXISTING native CH→AUX POST edge is a realtime atomic target with callback-only <=64-sample smoothing. Control write via `routingAuxSendGain` is fenced by actual device epoch, published routing revision, existing edge, 0..1 value and native ACK. It does NOT MUTE outputs, recompile topology, detach, instantiate plugins or change MAIN fader. New send/return enable, PRE/PAN and physical I/O remain structural DRAFT→MUTE→APPLY→native ACK. No fake dynamic CH11, Master FX or hardware crackle certification. Preserve source and standalone mixer-io JS parity, L2/RAIL3, DYN1B, OUTPUT1, factory lock and P0 hardware #15. diff --git a/docs/ARD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md b/docs/ARD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md index bcbdbf260..b596c2a9b 100644 --- a/docs/ARD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md +++ b/docs/ARD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md @@ -1,6 +1,6 @@ # ARD — Custom WebView2 Audio Device Setup backed by the existing JUCE manager -**Revision:** 2026-10-31 · **Status:** DESIGN / NOT YET IMPLEMENTED +**Revision:** 2026-10-31 · **Status:** DEVICE1 baseline implemented in #228 (native build + CTest PASS); original architectural hardening items and physical FAT remain open **Companion:** [PRD](PRD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md) · [handoff](HANDOFF_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md) · [PATCH2 ARD](ARD_HARDWARE_AUDIO_IO_MATRIX_20261030.md) · [product truth](PRODUCT_TRUTH_CROSS_THREAD_20261031.md). ## A. Current source reality and change boundary diff --git a/docs/ARD_HARDWARE_AUDIO_IO_MATRIX_20261030.md b/docs/ARD_HARDWARE_AUDIO_IO_MATRIX_20261030.md index 6b93684a8..a3fac77f7 100644 --- a/docs/ARD_HARDWARE_AUDIO_IO_MATRIX_20261030.md +++ b/docs/ARD_HARDWARE_AUDIO_IO_MATRIX_20261030.md @@ -1,4 +1,4 @@ -> **DEVICE SETUP OWNER LOCK (2026-10-31):** PATCH2 maintains the same one native route controller. Complete the pre-existing DEVICE / DRIVER tab via [custom JUCE device ARD](ARD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md), [PRD](PRD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md), [handoff](HANDOFF_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md). ONE AudioDeviceManager, one WebView2 matrix, validated driver/endpoint/pin APPLY, native readback, muted rollback. Custom hardware setup is still **NOT IMPLEMENTED**; do not treat inventory cards or native JUCE popup as completion. +> **DEVICE SETUP OWNER LOCK (2026-10-31):** PATCH2 maintains the same one native route controller. Complete the pre-existing DEVICE / DRIVER tab via [custom JUCE device ARD](ARD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md), [PRD](PRD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md), [handoff](HANDOFF_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md). ONE AudioDeviceManager, one WebView2 matrix, validated driver/endpoint/pin APPLY, native readback, muted rollback. Custom hardware setup is IMPLEMENTED in #228 (custom device dropdowns + native readback/ACK); physical FAT and hardening remain open. # ArSonMiX — Audio Source/Patch Architecture Decision (PATCH2 ARD) diff --git a/docs/HANDOFF_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md b/docs/HANDOFF_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md index dedb6be69..90f12e507 100644 --- a/docs/HANDOFF_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md +++ b/docs/HANDOFF_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md @@ -1,6 +1,6 @@ # HANDOFF — Implement Custom Device Setup in the existing ArSonMiX Audio I/O Matrix -**Revision:** 2026-10-31 · **Execution handoff, NOT code completion** +**Revision:** 2026-10-31 · **Execution handoff: DEVICE1 core implemented in #228; complete remaining hardware FAT, regression and follow-up hardening** **Start from current merged main, not an old PR branch.** Read in order: [product truth](PRODUCT_TRUTH_CROSS_THREAD_20261031.md), [PRD](PRD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md), [ARD](ARD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md), [PATCH2 ARD](ARD_HARDWARE_AUDIO_IO_MATRIX_20261030.md), [SOURCE1/#224](SOURCE1_NATIVE_MUTED_FAST_COMMIT_20261031.md), `AGENTS.md`. ## 0. Product and source lock diff --git a/docs/PRD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md b/docs/PRD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md index 2ad0bea20..b04f14694 100644 --- a/docs/PRD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md +++ b/docs/PRD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md @@ -1,6 +1,6 @@ # PRD — Custom Audio Device Setup inside the existing ArSonMiX I/O Matrix -**Revision:** 2026-10-31 · **Status:** PROPOSED IMPLEMENTATION CONTRACT / NOT YET CODED · **Scope:** Windows realtime mixer, no DAW/editor. +**Revision:** 2026-10-31 · **Status:** DEVICE1 custom GUI + native APPLY merged (#228); Windows and Chromium CI PASS; physical FAT / full parity NOT YET VERIFIED · **Scope:** Windows realtime mixer, no DAW/editor. **Read with:** [ARD](ARD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md) and [handoff](HANDOFF_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md). Existing [PATCH2 PRD](PRD_HARDWARE_AUDIO_IO_MATRIX_20261030.md), [PATCH2 ARD](ARD_HARDWARE_AUDIO_IO_MATRIX_20261030.md), [product truth](PRODUCT_TRUTH_CROSS_THREAD_20261031.md), and #224 are authoritative for routing/engine constraints. ## 1. Problem proven from the repository diff --git a/docs/PRD_HARDWARE_AUDIO_IO_MATRIX_20261030.md b/docs/PRD_HARDWARE_AUDIO_IO_MATRIX_20261030.md index 6e396afd7..e7f2d1a87 100644 --- a/docs/PRD_HARDWARE_AUDIO_IO_MATRIX_20261030.md +++ b/docs/PRD_HARDWARE_AUDIO_IO_MATRIX_20261030.md @@ -1,4 +1,4 @@ -> **DEVICE SETUP INTEGRATION (2026-10-31):** This PATCH2 PRD governs routine SOURCE selection and patch behavior. For the separate *real ASIO/WASAPI device/driver/rate/buffer and enabled-pin configuration inside the existing matrix*, see [Custom Device PRD](PRD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md), [ARD](ARD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md) and [handoff](HANDOFF_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md). Native JUCE popup remains the current fallback; custom device APPLY is still **NOT IMPLEMENTED**. +> **DEVICE SETUP INTEGRATION (2026-10-31):** This PATCH2 PRD governs routine SOURCE selection and patch behavior. For the separate *real ASIO/WASAPI device/driver/rate/buffer and enabled-pin configuration inside the existing matrix*, see [Custom Device PRD](PRD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md), [ARD](ARD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md) and [handoff](HANDOFF_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md). Custom device APPLY merged #228. Native JUCE selector is now a hidden engineering fallback, not a primary GUI; physical FAT remains open. # ArSonMiX — Professional Audio Source & Patch UX PRD (PATCH2) diff --git a/docs/PRODUCT_TRUTH_CROSS_THREAD_20261031.md b/docs/PRODUCT_TRUTH_CROSS_THREAD_20261031.md index c736c4567..88d1f3a74 100644 --- a/docs/PRODUCT_TRUTH_CROSS_THREAD_20261031.md +++ b/docs/PRODUCT_TRUTH_CROSS_THREAD_20261031.md @@ -1,4 +1,4 @@ -> **LATEST DEVICE SETUP DESIGN (2026-10-31, not shipped):** Cross-thread decision: keep JUCE as the only device/DSP backend while replacing the current inventory-only DEVICE tab/native JUCE setup popup with a working custom WebView2 Audio I/O panel. See [PRD](PRD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md), [ARD](ARD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md), [handoff](HANDOFF_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md). No separate audio manager or source controller; fail-closed muted device APPLY, actual hardware readback; physical #15 remains unresolved. +> **DEVICE1 CUSTOM HARDWARE SETUP CODE MERGED #228 (2026-10-31) — SOFTWARE CI PASS / PHYSICAL FAT PENDING:** Cross-thread decision: keep JUCE as the only device/DSP backend while replacing the current inventory-only DEVICE tab/native JUCE setup popup with a working custom WebView2 Audio I/O panel. See [PRD](PRD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md), [ARD](ARD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md), [handoff](HANDOFF_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md). No separate audio manager or source controller; fail-closed muted device APPLY, actual hardware readback; physical #15 remains unresolved. # ArSonMiX — Single Product Truth & Cross-Thread Reconciliation 31 October 2026 | reconciled against `main@4acc88e2674561a9a3059ebff0c80c58c96c5269` | canonical decision record, **not** a claimed live release.