Repository navigation
Description
Milestone B verified triage — 2026-11-17:
checkpoint/architecture/checkpoint/archived. Classification ≠ completion of product feature or physical FAT.Scope / release boundary: Completed cross-thread safety ledger; no live code change requested.
Exit criteria:
- Preserve documented approved GAIN GUI blobs and exact cross-thread provenance.
- Close issue as historical documentation; retain its discussion, links and immutable source references.
Canonical issue ledger. Preserve historical evidence below; no speculative merging or rewriting approved audio.
Post-reconciliation verification: Documentation-only PR #700 merged into
main@1edee2bd55655efefec3a35d8b4724737e6eec70. Accepted GAIN GUIindex.htmlblobc2375e846bdbbc6112ecb3a4cbfd725e22a4c466, GAIN CSS32b30ddd29f193ea9ff78e517daeb4a0a9a64881, and native bridgea4be7ab5e83fb059be09c9a74fca4497e2a6558eremain byte-identical to the audited baseline. Only AGENTS.md changed; no new GUI deployment or physical audio test was needed.
Cross-thread non-destructive reconciliation checkpoint — 2026-11-14
This is an evidence ledger, not a new owner-approval gate, product integration branch, merge instruction, or assertion that draft audio features are release-qualified. It exists because overlapping older PRs can silently resurrect preapproved mixer GUI and native input GAIN behavior. Use LIVE GitHub refs again whenever continuing; this exact snapshot becomes historical as soon as another commit lands.
1. Current public/accepted baseline, verified on GitHub
- At audit:
main = a01fe350468519d88ad3ac2cfecadb4187b0cd6d, merged #698 (compact GUI), following #696 (safe click/drag, stronger zero), #694 (stacking, recessed LCD), and #690 (metal asset, LED pointer). - Current full Chromium main gate SUCCESS; Pages publish build+deploy SUCCESS at exact SHA. Public product GUI is /preview/ only. /preview-prod/ remains the prior reference.
- Accepted GAIN operator contract: 58px dial, 84×25px black/green inset LCD on normal desktop; height-aware compact fallback 52px/80×23 and 44px/76×21; 30-LED segmented green 270° indicator behind fixed steel PNG and shadow; only green needle rotates; vertically labeled GAIN rail; GAIN↔FX RACK and SOF retain state.
- Important behavior: a simple click does NOT seek/change GAIN; relative drag arms after 6px; 0 dB detent captures ±1.6dB, holds to ±3.2dB, escape allowed with fine keyboard/Shift/Alt/wheel; native source
SET_INPUT_GAINmust be admitted with ACK + accepted readback. Do not replace this with an older range-in-label. - Source owners:
site/preview-v2/index.html,site/preview-v2/assets/mixer-section-controls.css,site/preview-v2/assets/mixer-gain-knob-brushed-steel.png,web/approved-native-bridge.js,scripts/build_pages.py,tests/sof_contextual_console_smoke.py,.github/workflows/ui-smoke.yml.site/preview-v2is an internal source directory, never a second public /preview-v2/ product.
2. Active independent work observed — preserve, don't forcibly reconcile
At audit, 26 PRs OPEN, mostly drafts, across SonKu (many stacked branch-to-branch), Guitar FX, LMS, mixer native PRE/POST, GUI, ASIO/Harmonice, and maintainability. They are not all ready and must not be batch-merged, closed, rebased or force-pushed as part of a GAIN UX reconciliation.
| Workstream (sample current PRs) | What remains independent | Collision/risk |
|---|---|---|
| #661 P0 GUI/SonKu/caption/SOF integration | Draft with 101 changed files on old GUI ancestry | CRITICAL: modifies all six sensitive paths (HTML, GAIN CSS, native bridge, SOF browser test, Pages builder, UI workflow); branch lacks approved latest GAIN tokens/needle/zero gesture. Must integrate ONLY owned hunks onto fresh main, never replace whole files. |
| #649 integrated SonKu M4 | Draft acoustic+GUI candidate (57 files) | CRITICAL: similarly edits GAIN HTML/CSS/native bridge/test/UI workflow; branch contains older GUI. Do not blindly merge or replay an old seed. |
| #635 LMS five-workspace | Draft (47 files) | Pages assembler + CI workflow overlap; retain approved GAIN runtime bundle and exact current publisher behavior. No second GUI/PCM graph. |
| #688, #689, #693, #695, #697 | SonKu physical/phase-safe/room research chain | Branch dependencies are not all main-based; keep P7.4 physical concerns and P7.5/P8 experiments distinct. Green CI is NOT physical speaker/headphone FAT, and proposed spatial DSP must not silently change current sound. |
| #668 Guitar FX hardware | Visual/native JUCE draft | Keep its approved geometry/asset and C++ state independent of GAIN UI. |
| #614 native GAIN + PRE/POST + SEND | Draft PCM/EdgeId graph change | Must preserve authoritative ChannelId/EdgeId native ACK/graph, and not confuse GUI mock with native audio qualification. |
| #660, #512, #521 | Caption press, native audio recovery, Harmonice work | Some touch native bridge and shared UI workflow; retain all verified advances, avoid resurrecting older preview or device startup behavior. |
| #680, #686, #527 | ArSon Player, release/hardware QA, maintainability | Latest player M1–M6 commits are already in main (precede GAIN series). Do not reset them or let GUI-only reconciliation modify virtual audio/FX/ASIO/session. |
The other open SonKu stacked branches (#674/#678/#679/#681/#685/#687/#691/#692, etc.) remain their own draft chain; do NOT merge each ancestor separately after a more advanced descendant.
3. Binding non-destructive continuation rules
- Re-fetch main HEAD + PR base/head SHA + relevant current files at the moment of work. This ledger and historical SHAs are NOT authority to check out a stale branch. Never reuse an outdated merge commit as a blanket substitute for latest main.
- Reconcile at owning hunks, never whole files from old PRs. For every overlapping file, compare current main versus changed feature seam and include only intentional changes. Preservation of accepted GAIN GUI/gesture/native readback is a regression requirement, not an invitation to cherry-pick GUI: compact brushed-steel GAIN knob, 30 LED segments and black/green LCD #690–GUI polish: harmonize compact GAIN knob and LCD proportions #698 again.
- Preserve 1 approved /preview/ GUI, 1 JUCE/native PCM callback/graph, stable ChannelId/EdgeId identities, FX/Player/WIRE/device/session content, and accepted native ACK/readback. No new fake WebAudio path or legacy M4 graph.
- Do not modify, close, merge or force-update another thread's PR/branch in a cosmetic GAIN task. Stacked SonKu PRs are experiments until their own acoustic & physical tests are approved.
- Run the lowest-cost targeted checks: existing quick GUI owner/bundle checks and
tests/sof_contextual_console_smoke.pyafter GAIN, native/PCM tests only for engine changes, physical FAT only for real devices. Before publishing new GUI, verify compiled Pages and exact revision; keep /preview-prod/ unchanged. - Before any feature merge, verify main has not advanced. Record explicit target SHA, exact changed files, focused diffs, CI evidence, and any PENDING physical test. Do not equate draft existence or a passed browser simulation with a finished audio feature.
4. Actual reconciliation disposition
✅ GAIN is already integrated in current main and deployed. No re-merge or code rewrite is needed.
✅ Branch PRs inspected by file names and key source markers; #661/#649 contain older GAIN implementations than current main.
✅ No unrelated branch was merged/reset/closed/force-pushed in this checkpoint.
⏳ Future cross-thread audio/Guitar FX/LMS feature integration requires its own current-main hunk-level reconciliation, focused tests and owner-accepted physical FAT where applicable.
This issue is a handoff and collision warning, not a universal freeze on independent work or a new release process.
Activity
docs: preserve approved GAIN GUI across concurrent PR integrations (#699
docs: preserve approved GAIN progress in cross-thread integration gui…
masarray commentedon Nov 14, 2026
Post-GAIN reliability checkpoint — 2026-11-14
Approved GUI hardening PR #702 was squash-merged at exact main@727dbce8a4c1963e37df572cdba7494e1829dcdd.