Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
@@ -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.

Expand Down
2 changes: 1 addition & 1 deletion docs/ARD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/ARD_HARDWARE_AUDIO_IO_MATRIX_20261030.md
Original file line number Diff line number Diff line change
@@ -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)
Expand Down
2 changes: 1 addition & 1 deletion docs/HANDOFF_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/PRD_CUSTOM_AUDIO_DEVICE_SETUP_20261031.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/PRD_HARDWARE_AUDIO_IO_MATRIX_20261030.md
Original file line number Diff line number Diff line change
@@ -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)
Expand Down
2 changes: 1 addition & 1 deletion docs/PRODUCT_TRUTH_CROSS_THREAD_20261031.md
Original file line number Diff line number Diff line change
@@ -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.
Expand Down