diff --git a/.github/workflows/pages-publish.yml b/.github/workflows/pages-publish.yml
index 9bde7d038..4e80f6eed 100644
--- a/.github/workflows/pages-publish.yml
+++ b/.github/workflows/pages-publish.yml
@@ -1,15 +1,11 @@
name: Publish ArSonMix GUI (main dispatcher)
on:
- push:
- branches: [main]
- paths:
- - '.github/workflows/pages-publish.yml'
workflow_dispatch:
workflow_run:
workflows: ["UI smoke (Chromium)"]
types: [completed]
- branches: [fix/fader-thumb-symmetry-polish]
+ branches: [main]
permissions:
contents: read
@@ -23,21 +19,24 @@ jobs:
if: ${{ github.event_name != 'workflow_run' || github.event.workflow_run.conclusion == 'success' }}
runs-on: ubuntu-latest
steps:
- - name: Checkout approved GUI preview source
+ - name: Checkout exact qualified main GUI revision
uses: actions/checkout@v4
with:
- ref: fix/fader-thumb-symmetry-polish
+ ref: ${{ github.event_name == 'workflow_run' && github.event.workflow_run.head_sha || 'main' }}
persist-credentials: false
- uses: actions/setup-python@v5
with:
python-version: '3.12'
- - name: Build static landing and exact mixer preview
+ - name: Build static landing and approved mixer preview
run: |
SOURCE_SHA="$(git rev-parse HEAD)"
- python scripts/build_pages.py --out dist-pages --sha "$SOURCE_SHA" --branch fix/fader-thumb-symmetry-polish
+ node --check web/app.js
+ python tests/gui_baseline_lock_test.py
+ python scripts/build_pages.py --out dist-pages --sha "$SOURCE_SHA" --branch main
cmp AR-MIX-Live-FX-Host-Standalone-v0.3.html dist-pages/preview/mixer.html
python tests/button_asset_test.py
python tests/fader_asset_test.py
+ python tests/pan_button_asset_test.py
- name: Configure GitHub Pages
uses: actions/configure-pages@v5
- name: Upload site bundle
@@ -55,6 +54,6 @@ jobs:
name: github-pages
url: ${{ steps.deployment.outputs.page_url }}
steps:
- - name: Publish site from default branch workflow
+ - name: Publish site from main
id: deployment
uses: actions/deploy-pages@v4
diff --git a/.github/workflows/ui-smoke.yml b/.github/workflows/ui-smoke.yml
index 570d7dd86..b17e02cf2 100644
--- a/.github/workflows/ui-smoke.yml
+++ b/.github/workflows/ui-smoke.yml
@@ -1,6 +1,19 @@
name: UI smoke (Chromium)
on:
+ push:
+ branches: [main]
+ paths:
+ - 'web/**'
+ - 'site/**'
+ - 'AR-MIX-Live-FX-Host-Standalone-v0.3.html'
+ - 'scripts/build_pages.py'
+ - 'tests/**'
+ - '.github/workflows/ui-smoke.yml'
+ - '.github/workflows/pages-publish.yml'
+ - 'README.md'
+ - 'AGENTS.md'
+ - 'docs/GUI_BASELINE_LOCK_2026-10-25.md'
pull_request:
workflow_dispatch:
@@ -19,6 +32,8 @@ jobs:
python-version: "3.12"
- name: Validate JavaScript syntax
run: node --check web/app.js
+ - name: Validate approved GUI checkpoint and single publisher
+ run: python tests/gui_baseline_lock_test.py
- name: Install Chromium testing dependencies
run: |
python -m pip install --upgrade pip
@@ -32,15 +47,16 @@ jobs:
run: python tests/pan_button_asset_test.py
- name: Run mixer UI smoke tests
run: python tests/ui_smoke.py
- - name: Attach visual regression screenshot
+ - name: Attach visual regression screenshots
if: always()
uses: actions/upload-artifact@v4
with:
- name: ar-mix-fader-smoke
+ name: arsonmix-gui-baseline-smoke
path: |
fader-ui-smoke.png
mixer-design-review.png
mixer-design-review-1440.png
mixer-master-clip-review.png
mixer-pro-view-review.png
+ mixer-master-dual-metric-left-rail.png
if-no-files-found: ignore
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 000000000..43e2264d4
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,21 @@
+# Repository instructions — ArSonMix (all future threads and AI coding agents)
+
+**MANDATORY: Read [docs/GUI_BASELINE_LOCK_2026-10-25.md](docs/GUI_BASELINE_LOCK_2026-10-25.md) before editing UI or reconciling VST3 engine PRs.**
+
+## Approved visual contract
+- GUI v0.8 approved by the product owner on 2026-10-25. Original exact source commit: `343692fc9b702661a8455cca30f0ffd108907324`; merged to `main` via PR #2 (merge `aff95a7c811a3817edf61303e1f24ef31e53d11d`).
+- Permanent recovery reference: `checkpoint/gui-v0.8-approved-20261025` (never update or delete it). New contributions start from latest `main`.
+- Maintain a 12-input + 1 master aligned strip console; 6 visible FX slots on each; master FX, PAN and stereo L/R; one top toolbar; compact left rail; fixed MUTE label; live insert power state; no-jump fader drag; contextual, realistically shaded controls and clear selected border.
+- The streaming analyzer has **only LUFS-I and dBTP**. In the browser label values as simulated; do not invent actual DSP meter readings.
+- Never copy stale UI files from the native branch over the approved GUI. Native integration must adapt the engine events and visuals to this baseline **without regressing GUI or changing its design without user request**.
+- Source modules: `web/index.html`, `web/styles.css`, `web/app.js`. Self-contained offline distributable: `AR-MIX-Live-FX-Host-Standalone-v0.3.html` (historical name). Keep CSS/JS/HTML byte-for-byte synchronized with the standalone. `site/` supplies landing and review shell; `scripts/build_pages.py` copies the standalone.
+- No universal button CSS override; preserve the original file assets and physical sizes. Native GUI changes must preserve layout and usability at 1680x920 and 1440x820.
+- Run `node --check web/app.js`, all PNG/standalone asset checks, `python tests/gui_baseline_lock_test.py`, and `python tests/ui_smoke.py` before merging a GUI PR.
+- GitHub Pages production deploys **from `main` after a green main Chromium smoke**. Do not create a competing preview-branch publisher.
+- Native JUCE/VST3 PRs #1 and #3–#11 were **not** validated or merged by GUI PR #2. Do not mark them done or close them until native hardware, RT safety, actual meter/bypass and plugin tests pass. Reconciliation PR #11 is built from an older GUI and must be rebased/reworked against this lock.
+
+## If you are a future ChatGPT thread
+1. Fetch live repository `main`, this file and the lock document. Cite approved commit and deployment metadata accurately.
+2. Check current native PRs / base graph before cherry-picking; do not accidentally erase more recent GUI or engine work.
+3. Propose and implement only the requested incremental changes, validate actual behavior, and capture new checkpoints if another GUI revision is approved.
+4. Distinguish *GUI-preview simulation* from *live native audio* in reports and releases.
diff --git a/README.md b/README.md
index c44b857b5..cae6950da 100644
--- a/README.md
+++ b/README.md
@@ -1,56 +1,61 @@
-# AR MIX Studio — Open-Source Live FX Host (v0.3 UI & Architecture)
+# ArSonMix — Live Mixer & VST3 Host
-**Status: interactive UI prototype + C++ real-time messaging primitives. No audio engine yet.**
+**Project status (25 October 2026):** the premium **GUI v0.8** has been visually approved and merged into `main`. The browser preview remains a **UI prototype with simulated audio/meters**. The native Windows/JUCE/VST3 engine is progressing separately through stacked draft PRs; those builds and hardware paths are **not** certified by the GUI merge.
-AR MIX Studio targets live vocal processing for karaoke performers and livestream creators. It is VST3-first: the principal activity is building a beautiful, low-friction FX chain with a digital-console look. The core engine is planned as C++20/JUCE with Windows ASIO/WASAPI; the frontend is a self-contained HTML/CSS/SVG UI embedded in JUCE WebView2.
+> **GUI SOURCE OF TRUTH — LOCKED:** [GUI v0.8 baseline](docs/GUI_BASELINE_LOCK_2026-10-25.md) · approved commit `343692fc9b702661a8455cca30f0ffd108907324` · merged in [PR #2](https://github.com/masarray/arsonmix/pull/2) · preserved as `checkpoint/gui-v0.8-approved-20261025`. **Do not restore the previous GUI from native-engine branches.**
-## Public website and interactive GUI preview
+ArSonMix is a Windows-first digital mixer and low-latency live VST3 host project for live vocals, karaoke and livestreaming. Its interface emphasizes fast **FX Rack / insert power**, tactile console controls, accurate channel identification and uncluttered mixing.
-- **Landing website:** https://masarray.github.io/arsonmix/
-- **Review the actual mixer GUI:** https://masarray.github.io/arsonmix/preview/
-- **Open mixer full-screen:** https://masarray.github.io/arsonmix/preview/mixer.html
+## Open the approved mixer
-GitHub Pages publishes the current **GUI development branch** through [the main-branch Pages workflow](.github/workflows/pages-publish.yml), after UI smoke tests pass. This preview is intentionally separate from the stable `main` code and from the native audio engine work. It is a **browser GUI prototype with simulated meters**, not a functioning VST audio host.
+- **Landing:** https://masarray.github.io/arsonmix/
+- **Interactive mixer:** https://masarray.github.io/arsonmix/preview/
+- **Standalone full-screen GUI:** https://masarray.github.io/arsonmix/preview/mixer.html
+- **Deployed commit:** https://masarray.github.io/arsonmix/preview/build.json
-## Try the current prototype now
+**Pages builds the canonical standalone GUI from `main`, after the main-branch Chromium smoke test succeeds.** The last visual sign-off is GUI v0.8; a later change must preserve the accepted design or obtain another explicit review.
-Open `AR-MIX-Live-FX-Host-Standalone-v0.3.html` in a current Chrome or Edge browser. No installation or internet access is required. The meters are intentionally **simulated**. Clicking `FX RACK` opens a chain editor: add a *demo* plugin, bypass/reorder/remove it; `MIX` offers faders, pan and MUTE/SOLO; `SIGNAL FLOW` describes the path; `SETUP` previews the driver wizard; `EASY VIEW` toggles Pro controls. Save a local FX chain preset or Mixer Snapshot, and export/import a JSON session file.
+## Approved GUI v0.8 features
-**Important:** catalog entries are visual demo effects, not installed VST3 binaries. Nothing will process live audio or activate your mic in this version. The Windows JUCE shell is source-only and has not been compiled/validated on Windows in this environment.
+- 12 color-coded input strips plus aligned stereo **MASTER strip #13**; full-height amber selected-strip highlight.
+- 6 visible FX inserts per strip and master; independent compact on/off bypass for occupied inserts and separate open/edit action.
+- Mirror-symmetric silver metal faders, distinct red master fader, relative no-jump pointer drag.
+- Compact horizontal PAN with L/C/R values, restrained illuminated fill and noticeable center detent; master PAN included.
+- Fixed hardware legend **MUTE** (red = muted); SOLO yellow, HPF green. Context-specific supplied metal button families, without global restyling.
+- Stereo master L/R display with peak holds and clip latches; two streaming reference readouts only: **LUFS-I** and **dBTP**.
+- Channel name/color/icon editor, quick-sound presets, mixer snapshots, explicit **SAVE SNAPSHOT / SAVE FX / EXPORT** actions.
+- One application toolbar, organized left rail, and GitHub Pages preview with SHA-aware reload.
-## Build JUCE WebView2 shell (Windows)
+**Accuracy boundary:** The browser's LUFS-I, dBTP, peak and VU values are illustrative. They are **not ITU-R BS.1770 measurements** and do not prove audio loss, clipping or real-world latency. When integrating the native engine, use authentic DSP data and never mix fake demo metering into the live audio UI.
-Prerequisites: Visual Studio 2022 with C++, CMake >=3.22, a local compatible JUCE 8/9 source checkout, and WebView2 runtime. See licenses before distribution.
+## Working on the project / handing off to another thread
-```powershell
-.\build_windows.ps1 -JuceRoot C:\dev\JUCE
-```
-
-CMake example:
+**Start by reading [AGENTS.md](AGENTS.md) and [docs/GUI_BASELINE_LOCK_2026-10-25.md](docs/GUI_BASELINE_LOCK_2026-10-25.md).** The approved GUI is in `main`; do not use the historical GUI branch as the source for new designs. If working on native VST3, apply the engine to the new GUI contract rather than replacing `web/app.js`, `web/styles.css` or the standalone HTML with a stale copy.
-```powershell
-cmake -S . -B build -G "Visual Studio 17 2022" -A x64 -DJUCE_ROOT="C:/dev/JUCE"
-cmake --build build --config Release
-```
+The native PR chain [#1](https://github.com/masarray/arsonmix/pull/1), [#3–#10](https://github.com/masarray/arsonmix/pulls) and reconciliation PR [#11](https://github.com/masarray/arsonmix/pull/11) represent **separate in-progress engineering work**. Merge only after native build/test qualification, user hardware FAT and UI baseline parity; do not close these unfinished PRs just to tidy the issue list.
-The shell embeds the same UI through JUCE BinaryData and uses `WebBrowserComponent::withResourceProvider`. `withEventListener("arMixParameter")` only logs events on the **JUCE message thread**. Implement the typed control dispatcher + RT backend before making it process audio. `JUCE_ASIO=1` is **not yet enabled** in this shell; check GPLv3 ASIO SDK compatibility and driver setup as specified in the ARD.
+## Local preview and tests
-## C++20 realtime primitives test
+Open `AR-MIX-Live-FX-Host-Standalone-v0.3.html` with Chrome/Edge for an offline GUI trial. The standalone's filename is historical; its content is the **approved v0.8 GUI**.
```bash
-g++ -std=c++20 -O2 -Wall -Wextra -pedantic -pthread tests/realtime_control_test.cpp -o rt_tests
-./rt_tests
+node --check web/app.js
+python tests/button_asset_test.py
+python tests/fader_asset_test.py
+python tests/pan_button_asset_test.py
+python tests/gui_baseline_lock_test.py
+python tests/ui_smoke.py
+python scripts/build_pages.py --out dist-pages --branch main
```
-## Files
+The Chromium smoke test needs Playwright Chromium installed. `.github/workflows/ui-smoke.yml` runs it for pull requests and relevant `main` changes. The single `.github/workflows/pages-publish.yml` publisher runs **after successful main GUI smoke**. See [Pages runbook](docs/GITHUB_PAGES_PREVIEW.md).
+
+## Windows native host
+
+`src/`, `engine/`, `CMakeLists.txt`, and `build_windows.ps1` in `main` are the original scaffold and reusable real-time primitives; evolving native versions are held in separate PR branches. Use Visual Studio 2022/CMake/JUCE and suitable ASIO/WASAPI drivers for native development. Browser-only UI acceptance is **not** proof of native VST3 load, FabFilter/RX compatibility, audio callback reliability, interop or full-fidelity plugin state.
-- `docs/ARD_AR_MIX_LIVE_FX_HOST_v0.3.md` — full product/technical architecture, RT rules, UX flows, benchmarks, roadmap and risk register.
-- `docs/UI_AUDIT_AND_QA_v0.3.md` — source UI audit, fixes and executed smoke test.
-- `web/{index.html,styles.css,app.js}` — maintainable UI frontend.
-- `AR-MIX-Live-FX-Host-Standalone-v0.3.html` — complete single-file offline trial.
-- `src/Main.cpp`, `CMakeLists.txt`, `build_windows.ps1` — native UI host scaffold.
-- `engine/core/RealtimeControl.h`, `tests/realtime_control_test.cpp` — tested sample real-time control patterns, not complete DSP.
+See the historical [architecture & roadmap](docs/ARD_AR_MIX_LIVE_FX_HOST_v0.3.md) and [GUI checkpoint](docs/GUI_BASELINE_LOCK_2026-10-25.md) for current precedence.
-## Licensing
+## License and assets
-Code in this trial is authored for the project and provided under AGPL-3.0-only to align with JUCE open-source licensing. JUCE, ASIO SDK and VST3 SDK have their own notices and obligations; check exact version and dependency licensing before publishing binaries. No third-party VST binaries or proprietary mixer UI graphics are included.
+The repository contains project code and user-supplied visual PNG artwork. Retain notices and verify redistribution permission for every external visual asset, VST3 binary, JUCE/ASIO/VST3 SDK and third-party dependency before public binary release. The GUI milestone is **not a native product release**.
diff --git a/docs/GITHUB_PAGES_PREVIEW.md b/docs/GITHUB_PAGES_PREVIEW.md
index 328bc5167..d855e6db5 100644
--- a/docs/GITHUB_PAGES_PREVIEW.md
+++ b/docs/GITHUB_PAGES_PREVIEW.md
@@ -1,45 +1,37 @@
-# GitHub Pages GUI preview — production workflow
+# ArSonMix public Pages — approved GUI v0.8 runbook
-**Live and deployed** (GitHub Actions run [40147158731](https://github.com/masarray/arsonmix/actions/runs/40147158731)):
+**The approved GUI lives in `main`**, merged via [PR #2](https://github.com/masarray/arsonmix/pull/2); original approved commit: `343692fc9b702661a8455cca30f0ffd108907324`.
- Landing: https://masarray.github.io/arsonmix/
-- Interactive mixer review: https://masarray.github.io/arsonmix/preview/
-- Full-screen standalone mixer: https://masarray.github.io/arsonmix/preview/mixer.html
-- Current served GUI revision: https://masarray.github.io/arsonmix/preview/build.json
+- Live mixer: https://masarray.github.io/arsonmix/preview/
+- Full-screen mixer: https://masarray.github.io/arsonmix/preview/mixer.html
+- Deployed SHA: https://masarray.github.io/arsonmix/preview/build.json
-## Architecture: safe GUI mirror without merging PR
+## Publishing pipeline after approval
-**The publishing workflow lives in the default branch:** `.github/workflows/pages-publish.yml` in `main`.
+1. Contributions to GUI files on `main` trigger `.github/workflows/ui-smoke.yml`.
+2. Only a successful **`main` UI smoke** triggers `.github/workflows/pages-publish.yml`.
+3. Pages publisher checks out the **exact successful smoke-run head SHA**, not a mutable stale GUI branch or an untested newer commit. A manual dispatch builds current `main`.
+4. `scripts/build_pages.py` copies `site/` and the canonical single-file standalone to `preview/mixer.html`, then writes `build.json` with SHA/branch.
+5. Preview shell automatically reloads when idle and a newer SHA is deployed; it does not add a second application header.
-The workflow **checks out `fix/fader-thumb-symmetry-polish`** to build the site, so GitHub Pages environment controls are satisfied without merging unapproved UI code into `main`.
+Only one production Pages workflow is authoritative. Do not introduce a parallel branch-local publisher or restore checkout of `fix/fader-thumb-symmetry-polish`.
-Whenever UI smoke CI passes for the preview branch, `workflow_run` on `main` automatically triggers production Pages deployment. You may also use **Actions → Publish ArSonMix GUI (main dispatcher) → Run workflow** for manual republishing, running the workflow on **main**.
-
-The prior branch-local `.github/workflows/pages-preview.yml` was removed because the `github-pages` environment blocked deployment from a non-default-branch workflow (build/upload succeeded but the deployment job could not start). Do not reintroduce a competing branch publisher.
-
-## Build parity
-
-`scripts/build_pages.py` copies:
-- `site/index.html` → site landing;
-- `site/preview/index.html` → review shell;
-- `AR-MIX-Live-FX-Host-Standalone-v0.3.html` → `preview/mixer.html`;
-- `preview/build.json` → deployed GUI git SHA + source branch.
-
-The preview shell checks `build.json` every 60 seconds and reloads automatically if a new build is available **and the user is idle**. Otherwise, it displays a reload notice. Click **Reload GUI** to force a refresh; **Full Screen** opens the mixer independently.
-
-## Local validation
+## Local tests
```bash
-python tests/button_asset_test.py
+node --check web/app.js
python tests/fader_asset_test.py
-python scripts/build_pages.py --out dist-pages
+python tests/button_asset_test.py
+python tests/pan_button_asset_test.py
+python tests/gui_baseline_lock_test.py
+python tests/ui_smoke.py
+python scripts/build_pages.py --out dist-pages --sha local --branch main
python -m http.server 8000 --directory dist-pages
```
-Then open `http://localhost:8000/` and `http://localhost:8000/preview/`.
-
-The browser version is a **GUI prototype** with simulated meters; it does not capture/process real audio. Real engine work is separate.
+Open `http://localhost:8000/preview/` and compare against [GUI baseline lock](GUI_BASELINE_LOCK_2026-10-25.md).
-## Future promotion
+## Scope / honesty
-After final GUI visual approval and merge to `main`, update the checkout ref and trigger branch settings in `.github/workflows/pages-publish.yml` to publish from `main` instead. This is intentionally not done until GUI changes are approved.
+The GitHub Pages console remains a **browser UI prototype**. VU meter animation, LUFS-I and dBTP are simulated, not authentic native DSP readings. It does not enumerate or process installed VST3 plugins. Native integration is a separate, unmerged engineering stage and requires Windows hardware/latency and plugin verification.
diff --git a/docs/GUI_BASELINE_LOCK_2026-10-25.md b/docs/GUI_BASELINE_LOCK_2026-10-25.md
new file mode 100644
index 000000000..409e76112
--- /dev/null
+++ b/docs/GUI_BASELINE_LOCK_2026-10-25.md
@@ -0,0 +1,52 @@
+# APPROVED GUI BASELINE — ArSonMix v0.8
+
+**Status: LOCKED / APPROVED by product owner — 2026-10-25.**
+
+This is the canonical cross-thread, cross-branch GUI checkpoint. It is a **visual/interaction design baseline**, not a Windows-native VST3 release or audio conformance statement.
+
+| Reference | Value |
+| --- | --- |
+| Approved design commit | `343692fc9b702661a8455cca30f0ffd108907324` |
+| GUI implementation PR | [#2 — merged](https://github.com/masarray/arsonmix/pull/2) |
+| Merge commit into `main` | `aff95a7c811a3817edf61303e1f24ef31e53d11d` |
+| Archived reference branch | `checkpoint/gui-v0.8-approved-20261025` |
+| Canonical integration base | **Latest `main`** (never the old preview branch) |
+| Preview | https://masarray.github.io/arsonmix/preview/ |
+| Published revision metadata | https://masarray.github.io/arsonmix/preview/build.json |
+| Verification | [Chromium UI smoke green](https://github.com/masarray/arsonmix/actions/runs/40166477815) |
+| Native VST3 integration | **SEPARATE / NOT QUALIFIED BY GUI MERGE** |
+
+## Locked user-approved appearance and interactions
+
+1. **Composition:** one title/device/action toolbar only, no redundant preview header. Left rail compact, clear channel list, sound presets, snapshots and readable SAVE SNAPSHOT / SAVE FX / EXPORT actions. No empty buttons or large dead space.
+2. **Main surface:** 12 colored source strips + stereo red **MASTER as the thirteenth aligned strip**, one uninterrupted selection outline through each channel. Channel header, fader start and footer baselines match on EASY and PRO at tested sizes. Click channel identity to rename/change icon/color.
+3. **Primary workflow:** six **visible** compact VST FX inserts on every input and master strip. Separate power/bypass control and FX-name editor action; readable names, no `◉` insert status clutter or repeated +.
+4. **Hardware feel:** source metallic silver fader caps, distinct red master cap, true relative drag without click-jumps, no unprofessional glow, control responsiveness, contextual metal button artwork (small toggle vs nav vs preset). MUTE text never changes; red MUTE state is semantic.
+5. **PAN:** metallic horizontal slider with L/current/R text and center snap, including master. No redundant PAN heading; restrained green center-to-thumb indicator.
+6. **Meters:** per-channel peak hold/clip latch, distinct master L/R meters with peak hold. Compact master streaming reference values: **LUFS-I + dBTP only**, with legible numerals and **SIM** status in preview.
+
+## Source and parity
+
+`web/app.js`, `web/styles.css`, `web/index.html`, `web/assets/`, `AR-MIX-Live-FX-Host-Standalone-v0.3.html`, `site/`, and `tests/ui_smoke.py` from approved commit are the visual implementation. The standalone filename `v0.3` is an inherited path (not the approved GUI version). Avoid renaming until the native embedded resource path is migrated and tested.
+
+**Do not overwrite files wholesale from an older engine branch.** Pick up fresh `main`, make narrowly-scoped adapters and preserve CSS artwork, strip geometry, routing controls and state restoration. If tests or a screenshot from a native PR looks different, it must be reconciled to the approved baseline, not treated as a new approved design.
+
+CI required for any GUI merge:
+- JavaScript syntax validation.
+- Asset byte/dimension and standalone parity tests.
+- Playwright Chromium smoke for the 13-strip master, 6 FX slots, readouts, PAN/fader behavior, channel naming, mute/solo, clip state and FX bypass.
+- Visual QA at 1680×920 and 1440×820. Test additional Windows DPI 125%/150% before treating a native WebView2 build as production-ready.
+- No fabricated assertions about native processing; hand off bridge events to actual DSP.
+
+## Engine/native reconciliation ledger — DO NOT accidentally close unfinished work
+
+Native stack PRs [#1](https://github.com/masarray/arsonmix/pull/1), [#3](https://github.com/masarray/arsonmix/pull/3), [#4](https://github.com/masarray/arsonmix/pull/4), [#5](https://github.com/masarray/arsonmix/pull/5), [#6](https://github.com/masarray/arsonmix/pull/6), [#7](https://github.com/masarray/arsonmix/pull/7), [#8](https://github.com/masarray/arsonmix/pull/8), [#9](https://github.com/masarray/arsonmix/pull/9), and [#10](https://github.com/masarray/arsonmix/pull/10) are sequential native engine changes, many drafted against other feature branches. Integration [#11](https://github.com/masarray/arsonmix/pull/11) still references **older GUI v0.5/commit `7d489203`**, not this approved GUI. PR #11 must switch the visual source of truth to merged `main` and keep authentic audio behavior (no fake VU, actual FX bypass/PAN/native chain/routing, protected audio callback and proper plugin state). Merge the engine stack **only after** independent Windows CI and real-device checks. Merely closing PRs without merging validated changes would silently discard work.
+
+## How future threads should proceed
+
+1. Read `README.md`, `AGENTS.md`, this document, `docs/GITHUB_PAGES_PREVIEW.md`, and the current PR/CI state.
+2. Work from new `main`; reference this checkpoint branch to compare against regressions. GUI improvements require explicit user approval before changing the locked visual language.
+3. For native integration, diff by function instead of overwriting `web/app.js/styles.css`; keep both native WebView2 control-contract tests and GUI Chromium tests in CI, plus Windows hardware evidence.
+4. Publish Pages from main and verify that deployed `build.json.sha` matches the **tested** commit (not a stale branch).
+
+**Acceptance statement:** the owner said the GUI was already "rapi dan bagus" and requested this progress be locked and merged. These exact visuals and interactions are the default for every subsequent thread.
diff --git a/tests/gui_baseline_lock_test.py b/tests/gui_baseline_lock_test.py
new file mode 100644
index 000000000..0d7c31983
--- /dev/null
+++ b/tests/gui_baseline_lock_test.py
@@ -0,0 +1,30 @@
+"""Prevents resurrecting pre-v0.8 GUI or publishing stale preview branches."""
+from pathlib import Path
+import re
+root=Path(__file__).resolve().parents[1]
+app=(root/'web/app.js').read_text(encoding='utf8')
+css=(root/'web/styles.css').read_text(encoding='utf8')
+standalone=(root/'AR-MIX-Live-FX-Host-Standalone-v0.3.html').read_text(encoding='utf8')
+page=(root/'.github/workflows/pages-publish.yml').read_text(encoding='utf8')
+ui=(root/'.github/workflows/ui-smoke.yml').read_text(encoding='utf8')
+readme=(root/'README.md').read_text(encoding='utf8')
+agents=(root/'AGENTS.md').read_text(encoding='utf8')
+lock=(root/'docs/GUI_BASELINE_LOCK_2026-10-25.md').read_text(encoding='utf8')
+assert '343692fc9b702661a8455cca30f0ffd108907324' in lock
+assert 'checkpoint/gui-v0.8-approved-20261025' in lock
+assert 'docs/GUI_BASELINE_LOCK_2026-10-25.md' in readme
+assert 'docs/GUI_BASELINE_LOCK_2026-10-25.md' in agents
+assert "ref: fix/fader-thumb-symmetry-polish" not in page
+assert "branches: [main]" in page and "head_sha" in page
+assert "branches: [main]" in ui and "pull_request:" in ui
+assert 'masterPeakDb' not in app
+assert 'data-master-tab' not in app
+assert 'masterLufs' in app and 'masterDbtp' in app
+assert '' in standalone
+assert '' in standalone
+assert 'i<12' not in app or 'master' in app
+assert 'masterLeft' in app and 'data-fxpower' in app
+assert 'saveFxPreset' in standalone and 'menuScene' in standalone
+assert (root/'site/preview/index.html').is_file()
+assert 'fix/fader-thumb-symmetry-polish' not in page
+print('PASS: approved GUI contract, exactly qualified Pages main source, offline parity')