Skip to content

L2 GUI BASELINE LOCK — aligned CH1–10/MASTER faders, left-rail layers, three-tab workspace #176

Closed as not planned

Description

@masarray

Owner-approved L2 mixer layout — preserve across threads

2026-10-30 user acceptance: "OKE SUDAH MULAI RAPI -> REKONSILIASI PROGRESS AGAR PERBAIKAN INI TIDAK HILANG!!!!"

This is a durable cross-thread regression contract, not a fresh feature request. Do not revert, replace or cosmetically redesign these decisions when implementing ADR R5 mono/stereo (#172), G3 sends (#168), G4 hardware outputs (#143), FX/Rack, or UI performance work.

Exact audited provenance

Non-negotiable L2 layout invariants

  1. One vertical geometry, all ELEVEN strips. CH1–10 + MASTER must share seven explicit rows: header, mode-switched upper bank, controls, MUTE/SOLO, dB readout, flexible fader+VU+rulers, bottom identity. The MASTER must never independently shrink, move up/down, or use shorter meter/fader travel because upper content differs.
  2. All shrink/grow together. Upper FX/ROUTE/SENDS area uses shared mode-specific height; fader flexible row uses same track. Switching modes, resizing windows, enabling master mono or channel stereo, and adding sends must not cause asymmetric fader lengths; keep exact fader PNG detent, calibrated dB scales and stationary LED colors.
  3. Left rail owns FX / ROUTE / SENDS layer toggle, not upper workbench toolbar. Keep existing mixer-io controller subtree and active bank context, don't add a second 36px strip above mixer.
  4. Top is one segmented, concise workspace navigation: MIXER | FX RACK | PATCH. MY SOUNDS, PLUGINS, SETUP, SIGNAL CHECK belong in left-rail utilities (with working existing handlers). Presets/snapshots remain usable; no extra nav clutter or duplicate owner.
  5. No DSP regressions. Keep actual CH1 live native multi-insert VST3/Orbit, G3 four AUX send rows + focused inspector with PRE/POST/LEVEL/PAN (not fake widgets), device-bound I/O, accepted routes and muted native ACK. web/mixer-io.js/css are owned by G3. L2 is layout shell, not a second graph.
  6. Hotplug fail-closed. window.__arMixRouteView is a side-effect-free snapshot; the native status handler is sole owner of draftEpoch hydration/invalidation. Device changes must invalidate stale ports/accepted route and repaint the patch matrix. Never auto-unmute.
  7. Standalone / WebView2 parity: scripts/build_ui_css.py maintains embedded mixer-io and mixer-layout CSS/JS in canonical standalone source. CMake and WebView2 static resource provider include both modules. Avoid independent divergent preview.
  8. No expensive GUI tricks: preserve original BTN-180, no composited blur / fake glow / per-hover geometry work, no extra RAF or RT callback modifications. eMotion LV1 is workflow inspiration, no proprietary artwork/source copying.

Mandatory acceptance for any later mixer PR

  • python scripts/build_ui_css.py --check.
  • node --test tests/mixer_shell_contract_test.mjs.
  • python tests/mixer_shell_geometry_smoke.py, python tests/ui_smoke.py, python tests/mixer_io_smoke.py.
  • Automated bound comparison of header, upper bank, control, MUTE/SOLO, dB display, fader/VU/scales, identity for all 11 strips, tolerance <=1.1px at four widths × three modes, including renderMixer() and returning to FX. Ensure full six FX slots remain visible.
  • For native code/packaged EXE, Windows MSVC/CTest/package and live hardware FAT gates separately. P0 — Crackling with 0 VST3: diagnose WASAPI clock/input/output buffering before engine expansion #15 zero-FX crackle remains unqualified until actual ASIO/WASAPI testing.

Reconciliation with ADR R5 and future features

ADR R5 introduces independently typed physical source / processing channel / bus and future format flip with full native ACK. Its UI additions must occupy existing CHANNEL focus, PATCH editor, or shared upper bank rather than add new independent height to a strip. Mono/stereo flip must keep identical lower strip geometry and not make MASTER smaller. R5 structural work may legitimately require new code and new UI states, but changes to any L2 invariant need explicit owner review, updated geometry tests, and before/after screenshots—not silent styling/feature rewrites.

Release/merge status bookkeeping

  • When L2: aligned CH1–10/MASTER fader grid + LV1-inspired left-rail mixer modes #171's final exact-head Windows run passes, reconcile branch against current main without force-push; merge only with green CI, then amend README + AGENTS.md with link to this issue and the merged SHA.
  • Keep this issue as a permanent baseline reference after merge. No need to close the preservation contract until successor milestones consistently pass it.
  • This issue does not claim ArSonMix parity with eMotion LV1, physical AUX outputs, native mono/stereo reform completion, or hardware crackle FAT.

Activity

  1. masarray commented on Oct 30, 2026

    @masarray
    OwnerAuthor

    Rekonsiliasi FINAL — 2026-10-30

    ✅ L2 PR #171 MERGED to main as 2ddd434ebb7bfa1b98d9396ff15c79ba857ca12b, after exact-head Chromium 40976822422 and native Windows MSVC/CTest/package 40976822381 both SUCCESS. The native package verification ran successfully; PR workflow did not publish a downloadable ZIP artifact (upload step skipped). Don't claim availability of a downloadable package from that run.

    ✅ Cross-thread MANDATORY REPOSITORY ENTRYPOINT now committed directly on main, docs-only reconciliation SHA 8251bd6e35af9768a35b0df19ad5f111052eade7 (optimizes CI instead of opening another redundant PR):

    ✅ Latest concurrent architecture #172 and orchestration #177 were preserved; they edit different files. No historical stale PR merge, no force-push, no DSP callback modification.

    Ongoing contract: future work on R5 MS1/2/3 or other mixer/FX/route UI MUST preserve this baseline and rerun geometry/route ACK tests. Real audio FAT issue #15 stays open. This issue remains open intentionally as an evergreen review/regression reference.

  2. masarray commented on Nov 2, 2026

    @masarray
    OwnerAuthor

    Closed as superseded legacy L2 GUI layout contract at the owner's request (2026-11-03). The old left-rail, three-tab MIXER/FX RACK/PATCH and fixed 10CH+MASTER workspace are not the current product baseline. New owner-approved one-window operator console is #271 with design source #278 and integration gates #192/#270. Any reusable fader/meter alignment, standalone parity and safety test must be preserved within the new GUI's own acceptance criteria; this issue's old UI topology must not block or override the new design. Closed as superseded, not as evidence of native audio certification.

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions