diff --git a/.github/workflows/ui-smoke.yml b/.github/workflows/ui-smoke.yml index 2b992c697..aaa21d5ad 100644 --- a/.github/workflows/ui-smoke.yml +++ b/.github/workflows/ui-smoke.yml @@ -58,6 +58,7 @@ jobs: node --check web/plugin-ui.js node --check web/mixer-io.js node --check web/mixer-layout.js + node --check web/hardware-keys.js node --test tests/gui_workflow_contract_test.mjs tests/plugin_ui_contract_test.mjs tests/ci_workflow_efficiency_test.mjs tests/fx_drag_reorder_contract_test.mjs tests/mixer_io_operator_contract_test.mjs tests/mixer_shell_contract_test.mjs - name: Validate approved GUI checkpoint and single publisher run: python tests/gui_baseline_lock_test.py @@ -78,6 +79,8 @@ jobs: run: python tests/mixer_shell_geometry_smoke.py - name: Verify native accepted WIRE-pot SVG, pointer gesture and ACK run: python tests/operator_console_v6_smoke.py + - name: Verify V5 masked backlit hardware controls in WebView and standalone + run: python tests/hardware_key_v5_smoke.py - name: Run mixer UI smoke tests run: python tests/ui_smoke.py - name: Verify G1/G2 LIVE mixer bank and native I/O transaction @@ -112,6 +115,8 @@ jobs: fader-ui-smoke.png toolbar-global-btn180-pad.png device-green-on-palette-review.png + mixer-backlit-v5-native-1680.png + mixer-backlit-v5-native-ON-1680.png mixer-design-review.png mixer-design-review-1440.png native-input-patch-review-1680.png diff --git a/AGENTS.md b/AGENTS.md index e54757014..82ebae383 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,3 +1,9 @@ +> **USER APPROVED CONSOLE DESIGN LOCK (2026-11-01):** Normative [PRD v5.2 §9](docs/PRD_ARSONMIX_OPERATOR_FIRST_LIVE_MIXER_V5_20261101.md#9-normative-v52-product-design-lock--user-approved-pr-278-mixer-workflow) + [ARD v5.2 §K](docs/ARD_ARSONMIX_UNIVERSAL_REALTIME_CONSOLE_V5_20261101.md#k-normative-v52-design-to-native-execution-contract--pr-278-reference). [PR #278](https://github.com/masarray/arsonmix/pull/278) at `design-references/audition-mixer-study/index.html` is the **owner-selected one-Console geometry/workflow NORTH STAR**. GUI #271 must reproduce its dense direct IN/OUT→FX→SEND→EQ/TRIM/PAN→MUTE/SOLO→FADER/METER workflow using native snapshot/ACK; ENGINE #266 supplies real operations; FAT #270 tests it on one actual Windows build. Strip out DAW automation/record, mock meters/FX, fake pins. Distinguish LINK FADERS from DSP GROUP BUS. This UX decision overrides older workbench, multi-tab setup and modal-first interpretations; v8 ABI and realtime safety remain inviolable. No alternate design study or customer partial UAT. + +> **MANDATORY CURRENT AUTHORITIES — 2026-11-01:** [Product PRD v5.1](docs/PRD_ARSONMIX_OPERATOR_FIRST_LIVE_MIXER_V5_20261101.md#8-mandatory-v51-product-delivery-amendment--puzzle-socket-v8), [Architecture ARD v5.1](docs/ARD_ARSONMIX_UNIVERSAL_REALTIME_CONSOLE_V5_20261101.md#j-mandatory-v51-abi-and-module-boundary-amendment--puzzle-socket-v8), [shared puzzle socket v8](docs/PUZZLE_INTEGRATION_CONTRACT_V8_20261101.md), [machine-required fields](contracts/console-puzzle-v8.json), and binding owner packets [ENGINE #266](docs/workstreams/ENGINE_PUZZLE_V8.md), [GUI #271](docs/workstreams/GUI_PUZZLE_V8.md), [INTEGRATION #270](docs/workstreams/FAT_PUZZLE_V8.md). **This v8 override supersedes historical v6/v7 priority/sequence**, preserves realtime safety, and bans three separately green PRs from being called one mixer. A real native-producer fixture, same-schema consumer, exact combined SHA and internal QA are required. Review/CI fail-closed; no user UAT until feature-complete S3. + +> **ACTIVE RELEASE ORCHESTRATION v7 (2026-11-01):** [ONE PRODUCT RELEASE TRAIN](docs/RELEASE_TRAIN_UNIVERSAL_CONSOLE_V7_20261101.md) and owner packets [ENGINE](docs/workstreams/ENGINE_DELIVERY_V7.md), [GUI](docs/workstreams/GUI_DELIVERY_V7.md), [INTEGRATION/RELEASE](docs/workstreams/INTEGRATION_RELEASE_DELIVERY_V7.md). Complete one real feature-parity Windows mixer BEFORE requesting owner/customer UAT. PRD/ARD v5 remain normative product/architecture; v7 supersedes older v6 delivery sequencing, not v6 realtime safety. #274/#275 are GUI patch sources and #276 is partial staging, not a final user build. + # ArSonMix — SINGLE EXECUTION AUTHORITY (v6 / 2026-11-01) **READ FIRST:** [PRD v5](docs/PRD_ARSONMIX_OPERATOR_FIRST_LIVE_MIXER_V5_20261101.md) + [ARD v5](docs/ARD_ARSONMIX_UNIVERSAL_REALTIME_CONSOLE_V5_20261101.md) + [EXECUTION LOCK v6](docs/EXECUTION_LOCK_UNIVERSAL_LIVE_CONSOLE_V6_20261101.md). Workstream handoffs: [ENGINE](docs/workstreams/ENGINE_UNIVERSAL_CONSOLE_V6.md), [GUI](docs/workstreams/GUI_OPERATOR_CONSOLE_V6.md), [INTEGRATION/FAT](docs/workstreams/INTEGRATION_FAT_CONSOLE_V6.md). @@ -30,3 +36,12 @@ At verified `main@bb6dff6b`: native [Windows CTest/package #41263965810](https:/ - Older 2026-10-25–31 R5/L2/G1/G2/BTN-180 or alternate 'LATEST' instructions in Git history are **historical**, not active strategy; use v5 specs and this v6 lock for priorities. Approved visual details may be reused without overriding operator-first function. **There are no unattended background coding agents merely because a GitHub issue/branch exists. Separate developer sessions must explicitly be started with the linked workstream handoffs.** + +## Historical diagnostics and visual references (NOT active execution authority) + +Retained for traceable physical hardware diagnostics under [#15](https://github.com/masarray/arsonmix/issues/15): +- [Smart Audio Engine ARD — archival render/device-clock analysis](docs/ARD_SMART_AUDIO_ENGINE_V1_2026-10-25.md). +- [Smart Audio Engine Implementation Blueprint — archival ASIO/WASAPI FAT details](docs/SMART_AUDIO_ENGINE_IMPLEMENTATION_BLUEPRINT.md). +- [Original approved GUI baseline — archival visual comparison](docs/GUI_BASELINE_LOCK_2026-10-25.md). + +These explain prior device-clock evidence and fader/LED design. For **current feature architecture, priority and execution**, the PRD/ARD v5 and execution lock v6 at the top of this document take precedence. The historical specs do not override native ChannelId admission or justify an extra render callback. diff --git a/AR-MIX-Live-FX-Host-Standalone-v0.3.html b/AR-MIX-Live-FX-Host-Standalone-v0.3.html index 3085897e1..cf4109f8a 100644 --- a/AR-MIX-Live-FX-Host-Standalone-v0.3.html +++ b/AR-MIX-Live-FX-Host-Standalone-v0.3.html @@ -1448,6 +1448,163 @@ background-clip:content-box;border:0;box-shadow:none; } #app #mixer .meter .clip-led.latched{box-shadow:none!important} +/* Owner-approved V5 graphite hardware keys, production native/legacy console. + ONE SVG cutout legend, ONE white edge shine, asymmetric occluded leakage. + No hover repaint, SVG filters, blur, infinite animation, or fake audio state. + This module is LAST in the deterministic CSS build, replacing BTN-180 only + on opt-in tactile mixer buttons. Navigation, routing pins, meters, faders, + editor launchers, dropdowns and ordinary dialog actions are NOT backlit. */ +#app button.mx-hw-key { + --mx-hw-led:210,225,234; + position:relative!important; + display:inline-block!important; + box-sizing:border-box!important; + min-width:0!important; + padding:2px!important; + overflow:hidden!important; + isolation:isolate!important; + border:1px solid #0c151b!important; + border-radius:5px!important; + background:linear-gradient(180deg,#0b141b,#25343d)!important; + box-shadow:inset 0 2px 4px #03080db5!important; + color:transparent!important; + text-shadow:none!important; + letter-spacing:0!important; + line-height:normal!important; + filter:none!important; + backdrop-filter:none!important; + -webkit-backdrop-filter:none!important; + transform:none!important; + transition:none!important; + text-align:center!important; + cursor:pointer; + touch-action:manipulation; +} +#app button.mx-hw-key.mx-hw-mute {--mx-hw-led:255,64,85} +#app button.mx-hw-key.mx-hw-solo {--mx-hw-led:255,208,44} +#app button.mx-hw-key.mx-hw-cue {--mx-hw-led:90,200,231} +#app button.mx-hw-key.mx-hw-processing {--mx-hw-led:87,211,189} +#app button.mx-hw-key.mx-hw-phase {--mx-hw-led:243,164,81} +#app button.mx-hw-key.mx-hw-link {--mx-hw-led:163,141,235} +#app button.mx-hw-key.mx-hw-neutral {--mx-hw-led:210,225,234} +/* V5 leakage strategy: four tiny STATIC gradients only in the closest + 1–2px gap, unequal sides, lower-center stronger; top almost occluded. */ +#app button.mx-hw-key::before { + content:""!important; + display:block!important; + position:absolute!important; + inset:1px!important; + border:0!important; + border-radius:4px!important; + width:auto!important;height:auto!important; + transform:none!important; + pointer-events:none!important; + z-index:2!important; + opacity:0!important; + box-shadow:none!important; + background: + linear-gradient(90deg,transparent 0%,rgba(var(--mx-hw-led),.035) 18%, + rgba(var(--mx-hw-led),.16) 33%,rgba(var(--mx-hw-led),.46) 49%, + rgba(var(--mx-hw-led),.27) 63%,rgba(var(--mx-hw-led),.07) 80%,transparent 100%) + center bottom / calc(100% - 12px) 2px no-repeat, + linear-gradient(180deg,transparent 0%,transparent 30%, + rgba(var(--mx-hw-led),.045) 50%,rgba(var(--mx-hw-led),.21) 75%, + rgba(var(--mx-hw-led),.1) 88%,transparent 100%) + left bottom / 2px 100% no-repeat, + linear-gradient(180deg,transparent 0%,transparent 44%, + rgba(var(--mx-hw-led),.075) 65%,rgba(var(--mx-hw-led),.17) 85%, + transparent 100%) + right bottom / 2px 100% no-repeat, + linear-gradient(90deg,transparent 0%,transparent 34%, + rgba(var(--mx-hw-led),.055) 50%,transparent 67%,transparent 100%) + center top / calc(100% - 18px) 1px no-repeat!important; +} +#app button.mx-hw-key::after{content:none!important;display:none!important} +#app button.mx-hw-key[aria-pressed="true"]::before, +#app button.mx-hw-key.active::before, +#app button.mx-hw-key.selected::before, +#app button.mx-hw-key.power-on::before, +#app button.mx-hw-key[data-mx-hw-on="true"]::before {opacity:1!important} +#app button.mx-hw-key > svg.mx-hw-face { + position:absolute!important; + z-index:1!important; + top:2px!important;right:2px!important;bottom:2px!important;left:2px!important; + width:calc(100% - 4px)!important; + height:calc(100% - 4px)!important; + display:block!important; + min-height:0!important; + overflow:hidden!important; + pointer-events:none!important; + transform:translateY(0)!important; + transition:none!important; + filter:none!important; +} +#app button.mx-hw-key svg .mx-hw-lamp {opacity:0!important} +#app button.mx-hw-key[aria-pressed="true"] svg .mx-hw-lamp, +#app button.mx-hw-key.active svg .mx-hw-lamp, +#app button.mx-hw-key.selected svg .mx-hw-lamp, +#app button.mx-hw-key.power-on svg .mx-hw-lamp, +#app button.mx-hw-key[data-mx-hw-on="true"] svg .mx-hw-lamp {opacity:1!important} +#app button.mx-hw-key[aria-pressed="true"] > svg.mx-hw-face, +#app button.mx-hw-key.active > svg.mx-hw-face, +#app button.mx-hw-key[data-mx-hw-on="true"] > svg.mx-hw-face { + transform:translateY(1px)!important; +} +#app button.mx-hw-key > .mx-hw-screen-reader{ + position:absolute!important; + width:1px!important;height:1px!important; + margin:-1px!important;padding:0!important; + border:0!important;overflow:hidden!important; + clip-path:inset(50%)!important; + white-space:nowrap!important; +} +#app button.mx-hw-key:hover:not(:disabled){ + filter:none!important; + background:linear-gradient(180deg,#0b141b,#25343d)!important; + box-shadow:inset 0 2px 4px #03080db5!important; +} +#app button.mx-hw-key:active:not(:disabled){ + transform:none!important; + background:linear-gradient(180deg,#0b141b,#25343d)!important; + box-shadow:inset 0 2px 4px #03080db5!important; +} +#app button.mx-hw-key:active:not(:disabled) > svg.mx-hw-face{ + transform:translateY(1px)!important; +} +#app button.mx-hw-key:focus-visible{ + outline:2px solid #9bbecd!important; + outline-offset:2px!important; +} +#app button.mx-hw-key:disabled { + cursor:not-allowed!important; + opacity:.47!important; + filter:none!important; +} +#app button.mx-hw-key:disabled::before{opacity:0!important} +#app button.mx-hw-key:disabled svg .mx-hw-lamp{opacity:0!important} +/* Keep target strip geometry intact, bypassing the legacy BTN-180 face. */ +#app #mixer .channel-actions button.mx-hw-key, +#app #mixer .utility-row button.mx-hw-key { + flex:1 1 0; +} +/* The legacy MASTER MUTE was sized only by .candy. Own its 29px geometry + explicitly after replacing that obsolete class, matching every strip. */ +#app #masterLeft .master-actions button.mx-hw-key, +#app #masterMute.mx-hw-key{ + height:29px!important; + min-height:29px!important; + max-height:29px!important; + align-self:center!important; +} +#app #mixer [data-channel-format-toggle].mx-hw-key{ + min-width:20px!important; +} +#app .arV6Controls button.mx-hw-key{width:28px!important;height:28px!important;padding:2px!important} +#app .arV6FxSlot button.mx-hw-key{min-width:27px!important;min-height:22px!important;padding:2px!important} +#app .arV6Send button.mx-hw-key{min-width:34px!important;min-height:20px!important;padding:2px!important} +@media(prefers-reduced-motion:reduce){ + #app button.mx-hw-key,#app button.mx-hw-key > svg.mx-hw-face{transition:none!important} +}