Skip to content

P0 SonKu M4 integrated release candidate: native SPACE + Guitar FX + WIRE + Windows field qualification - #655

Merged
203 commits merged into
mainfrom
integration/sonku-m4-guitar-fx-main-20261113
Nov 13, 2026
Merged

203 commits merged into
mainfrom
integration/sonku-m4-guitar-fx-main-20261113

Conversation

@masarray

@masarray masarray commented Nov 13, 2026 •

Copy link
Copy Markdown
Owner

Canonical SonKu M4 integration: main Guitar FX + WIRE + updater + field-build CI

Exact reconciled commit: d162ae0516e70b6524cea4df02d76af8fbcb874e, a real two-parent Git commit:

Source-level merge proof

  • Compare merge-base 1f77b89f8f78eb2475322170546a6dce47ef2557 to main: 46 changed paths.
  • 39 paths untouched on P0 integrated SonKu: reconciled native SPACE DSP + GUI + musical A/B release qualification #649 relative to the merge-base were copied by their exact latest-main blob SHA, including 12 original Guitar FX PNG assets, build/CI scripts and WIRE tests. No text reconstruction or loss of binary assets.
  • 7 intersecting files: five GitHub unified patches were replayed hunk-by-hunk. Each patch also reproduced exact latest-main bytes when applied to the merge base, and each hunk matched one unique anchor on the SonKu candidate. Two non-overlapping insertions inside the same registries were resolved explicitly:
    • src/NativeBuiltInFx.h: preserve SonKu and add compiled GuitarRigProcessor catalog + include.
    • web/approved-native-bridge.js: preserve SonKu picker/editor and real Guitar FX picker discovery.
  • Included latest main src/Main.cpp startup foreground and CMakeLists.txt original Guitar artwork embedded binary data without losing existing SonKu dispatcher and HRTF code.
  • Base tree is exact P0 integrated SonKu: reconciled native SPACE DSP + GUI + musical A/B release qualification #649 tree; assembled merge tree has 1,056 entries; both complete Git parent histories retained; no force push, no extra routing authority or fallback WebAudio graph.

SonKu features retained

Native binaural KEMAR + approved 7.2×7.2m Square + ROOM OFF/SQUARE/CHAMBER/LARGE, distance, ambient FDN presets with callback-bounded preparation, acknowledged typed control with v1→v2 state restore and actual Chromium UI. User-approved Square checkpoint is untouched.

Qualification / release gate

  • Fast native/PCM, UI/contract and targeted actual Chromium SonKu plus Guitar FX and WIRE tests on exact reconciled SHA.
  • After focused green, use ONE Windows field portable build from main's owner dispatcher for hands-on ASIO/FX tests; keep FULL Windows CTest/installer FAT distinct.
  • Hardware ASIO p95/p99/XRun + device reconnect, multi-instance, save/reopen .smix and direct headphone A/B must be field-verified before claiming public release.
  • Do NOT release a public installer or merge unrelated drafts simply because Linux/Chromium CI is green.

This PR now targets main as the single exact-SHA integrated release-qualification candidate. It remains DRAFT with no public installer until Windows source/ASIO field and headphone gates pass. Earlier #649 is a provenance parent, not a second release lane.

Field-tested SonKu editor / loudness P0 (2026-11-13)

Integrated exact source: 58a67ee58de0dc0331492b4fd835268df57c0b01. Tested scoped PR #659 is now merged into this feature integration branch (not into main). This supersedes the older field preview before the operator's screenshot; use only the new SHA for any real listening claim.

  • Fixed native snapshot feedback resetting a held SOURCE DISTANCE mouse/keyboard thumb; emit exactly one typed native edit on release.
  • The source orbit stage now uses requestAnimationFrame visual interpolation with bounded drift correction to the native JUCE azimuth readback rather than ~4fps HTML redraw.
  • Speaker icons physically paint behind the person's head when at REAR and in front at FRONT via two actual SVG layers. No mirror/reorientation of HRIR coordinates.
  • ROOM ON distance uses bounded monitoring loudness compensation plus a gentle 180Hz binaural low shelf and sample-smoothed parameter updates. Legacy ROOM OFF / offline V2–V3 path remains exact. SPSC/PCM device graph unchanged.
  • Native-space PCM 44.1/48k regression passed, including distance edit during running tone, output sample peak guard, and stereo partition invariance.
  • Real Chromium desktop + 390px editor FAT PASSED on run 43399316480: held distance drag under stale native snapshot, 60fps movement between native polls, rear icon painter occlusion. Editor screenshots and new direct-native music/headphone audio. These do NOT establish subjective/headphone acceptance.
  • Owner exact-source Windows Field Preview request for 58a67ee... submitted. Only release a portable field preview after verification, not a public installer.

Before public release: physical ASIO loudness/clip/XRun + two-channel/mono checks, stereo phase/outcome on headphones, visually smooth front/rear orbit under Windows WebView2, .smix restore and rapid room/distance changes. Contrast matched-level processed and dry tracks; no unproven claim of dearVR acoustic equivalence.

P1 sound/room presence + GAIN verification (2026-11-13)

Operator accepted smooth orbit; remaining defects were low gain and inaudible wet ER/FDN. Acoustic PR #662 was fast-forward integrated to exact source 95a46ac386f0c5b8df115d6f1a971f47bd405070 without touching main or approved checkpoint.

  • Official dearVR PRO 2 documentation separates direct, reflection, diffuse reverb and output gain. We follow independently controllable D/R ratio, not proprietary algorithm duplication.
  • OUTPUT GAIN -24..+12 dB is a real native linear outputTrim field that can now exceed 1.0 with control validation 0..4. Existing v1/v2 saved state bytes unchanged. Default old state .75 = about -2.5dB displayed; operator can select +6/+12 dB. For newly boosted state and ROOM on, GAIN is final full-output gain (dry+wet) with linked 0.98 sample peak safety; older ROOM OFF <=unity PCM arithmetic intentionally retained.
  • REFLECTIONS 0..100% now exposes existing roomAmount; REVERB exposes previously named AMBIENCE ambience. Accepted native ACK/readback on actual GUI. Independent realtime wet returns receive bounded presence gain with 30ms smoothing; ROOM OFF and offline V2/V3 references unchanged; FDN feedback/RT60 not modified.
  • C++ sonku PCM at 44.1/48 kHz: independent settled first-reflection and late FDN energy relative to direct binaural impulse; boost >=+6dB affects dry MIX=0 and never exceeds stereo ceiling on near full-scale input. Measurement explicitly waits for fade-in smoothing instead of judging the initial unprimed impulse.
  • Fast UI + native SonKu Chromium FAT PASSED on run 43404360736, including 1366px/390px dB +6, reflections 85%, reverb 70%, native ACK/readback and actual image packaging.
  • New operator editor screenshots; same-engine headphone A/B WAVs. Tests prove measurable PCM presence, NOT perceptual dearVR equivalence.
  • Exact-source owner Windows FIELD command submitted. Wait for completed independent verified ZIP run before publishing a field download link.
    Do NOT tag public installer/merge main before ASIO physical p95/p99/XRun, operator headphone comparisons matched source loudness and direct/reverb balance, peak meter gain reduction checks, multiple channels, device-reopen and .smix persisted gain.

3D top-rear listener checkpoint — 2026-11-13 (#669 merged)

Current exact integration HEAD: c7a660ab100775b81209d7159f1452473e7e5cb0. PR #669 is merged into this draft integration only, not main. This supersedes prior UI/asset checkpoints #666/#667; transparent cyan rear-view source PNG remains unmodified.

  • Corrected FRONT=far/upper behind head and REAR=near/lower above back for the actual top-rear camera. Lowered PNG rectangle to y=90 to preserve visibility of distant front speakers. Two live source nodes are independently depth-sorted around real PNG alpha: smooth .76→1.16 view scale, far/near opacity and restrained shadows; orientation and physical HRTF azimuth (0°/90°/180°/-90°) are identical to the native core.
  • Performance: cache two SVG source/tether and layer refs; no duplicate canvas/WebAudio/PCM graph. Maintains source pointer/keyboard interaction, SPSC typed native intent/ACK/readback, approved orbit rAF interpolation, and all WIRE/Guitar/Harmony work.
  • Exact-source Fast UI + real Chromium SonKu PASS on run 43423390176 at scoped PR SHA 56e5bd9f9b05e1b378429bae3ac06857e298f848, before merge-equivalent squash; source scope compared: five GUI/CI/tests files, no native DSP change. Validates FRONT/REAR/LEFT/RIGHT, depth crossing at 89°→91° with no size jump, L/R on opposite painter planes, live drag/ACK and 1366/390 viewports.
  • Actual rendered Chromium FRONT / REAR / split-depth screenshots: 8 PNGs including full editor desktop and narrow; explicitly not a Windows WebView2 physical-ASIO acceptance claim.
  • CI discovery now covers feat/sonku-* GUI PRs. Depth-only branch executes the one relevant Chromium SonKu editor FAT rather than recompiling unrelated SOF/WIRE and native offline audio benches. One current approved WebView2 GUI owner; no public release or installer triggered.

Remaining gate remains unchanged: owner Windows WebView2 + physical headphone ASIO, multiple instances, .smix reopen, device reconnect and loudness/clip/XRun FAT. Do not merge this draft integration into main solely because browser visuals passed.

Copy link
Copy Markdown
Owner Author

/arsonmix-ci field c3a212b

Copy link
Copy Markdown
Owner Author

P0 CHECKPOINT + FRONT-up UX and realtime native gesture — integrated c3a212b

Immutable baseline: checkpoint/sonku-p1-audio-smooth-orbit-approved-20261113 @ 95a46ac386f0c5b8df115d6f1a971f47bd405070. Original native binaural PCM, gain/ER/FDN, .smix v2 and smooth rAF orbit are unchanged. Scoped draft PR #665 was fast-forward integrated to PR #655 only, NOT main.

Front-up original vector: Real listener back-of-head and shoulders drawn with SVG gradients (not upside-down former face PNG). FRONT=top, +90° anatomical RIGHT=screen right, REAR=bottom, LEFT=screen left, with actual inverse pointer map and original front/rear occlusion; native KEMAR angular signs untouched. The old PNG remains in the approved resource bundle/checkpoint but is not drawn in the new editor.

Native live controls: Three acoustic horizontal sliders + four rotary dials + keyboard edits + source icon drag now use one 40ms bound UI publisher. A single outstanding SPSC edit and latest-wins coalescing, after native audio APPLIED ACK plus matching exact-instance accepted readback. Final release value wins. GUI does not falsely claim PCM application. Local dragging thumb never snaps back to stale accepted values; no new WebAudio or callback allocations.

Scoped tests: run 43409061142 Fast UI PASS, actual 1366/390 Chromium SonKu PASS. Tests prove an audio-native message leaves before pointer release for rotary, speaker and SOURCE DISTANCE; 30 REVERB input events produce one in-flight edit and one coalesced final; independent input-only tests for REVOLUTION/SPREAD/SPATIAL MIX/OUTPUT GAIN and deduped final change; all four acoustic direction anchors/3D paint layering. Actual editor screenshots #14028128657 and offline WAV baseline #14027864375.

Qualification: One owner-signed exact-source Windows Field Preview command posted here. Do not cite Windows success until the new run independently verifies compiled PE, GUI bytes, ZIP provenance and artifact. Real ASIO/driver and headphone checks remain manual. Draft PR. No public installer or release.

masarray added a commit that referenced this pull request Nov 13, 2026
…st safety into consolidated UX candidate

Reconcile latest #665 FRONT-up and bounded 25 Hz live native SonKu gestures plus #663 guitar art validation and click material, preserving approved caption #660, SonKu SPACE #655, LMS #635, SOF, WIRE and canonical GUI. One combined exact SHA for qualified CI; no public release.

Copy link
Copy Markdown
Owner Author

✅ FINAL SonKu FRONT-up + live gesture checkpoint — Windows FIELD verified

Exact source: c3a212bb308a15da6caec27b6827074b3a705768, now protected at two independent branch checkpoints:

  • Prior operator-approved acoustics and smooth orbit: checkpoint/sonku-p1-audio-smooth-orbit-approved-20261113 @ 95a46ac386f0c5b8df115d6f1a971f47bd405070.
  • New FRONT-up and realtime native UI: checkpoint/sonku-front-up-live-gesture-verified-20261113 @ c3a212bb308a15da6caec27b6827074b3a705768.

Verified evidence

Operator manual validation: Drag SOURCE DISTANCE (in SQUARE/CHAMBER/LARGE), REFLECTIONS, REVERB and rotary REVOLUTION/SPREAD/MIX/GAIN with audio playing; sound should respond DURING drag, not only after release, with bounded native ACK rate. Verify FRONT visually above head (+90 on listener RIGHT), front/rear occlusion, speaker drag, .smix reopen and ASIO device stability. Assess fast sweeps for audible zipper and XRuns; the existing JUCE Main timer polls ACK at 12Hz, so this UI publisher is live but is not sample-accurate automation. Scope and other native FX audit at PR #665.

No public release, tag or installer action has been triggered.

Copy link
Copy Markdown
Owner Author

/arsonmix-ci field 0fe2a73

Copy link
Copy Markdown
Owner Author

SonKu operator image: exact user-directed vertical flip installed

  • Operator supplied and approved original cyan top-view figure, then requested vertical flip, alpha PNG, and replacement of prior editor human.
  • Pixel-transposed original 1254px RGBA delivered as conversation asset. Bundled optimized 256×256 indexed PNG with 8-bit alpha transparency at site/preview-v2/assets/sonku-listener-top.png (7,393 bytes). Git blob 3225ec58f3b02851ed4ff7fca8e5dc4627bf48c4; exact SHA256 e4fa2f75a541615448dd2d2b0bcbbf7955428900b3bdba8ad45c1ff7374fefc8.
  • Native SonKu editor now renders <image id="skListenerArt" href="assets/sonku-listener-top.png" data-orientation="front-up-flipped"> instead of the provisional human vector, retaining rear source layer → listener PNG → front source layer, stage FRONT-up/RIGHT-right, and 25Hz live-gesture controls. No native PCM/DSP code modified.
  • Scoped PR #666 fast-forward integrated into draft PR P0 SonKu M4 integrated release candidate: native SPACE + Guitar FX + WIRE + Windows field qualification #655 at exact 0fe2a73057891dba2e782c18ba84120fc5312e99.
  • Fast UI and real 1366/390px Chromium editor FAT PASS. Screenshot artifact #14031680705. Tests assert PNG hash, alpha tRNS, bundled image load (including Chromium file://), and speaker occlusion.
  • Windows FIELD exact-SHA run 43415165543 dispatched, result pending as of this comment. Do not claim field artifact or physical ASIO certified before it passes.
  • Previous approved audio/orbit and FRONT-up/live-gesture checkpoints remain intact. main unchanged; no public installer/release.

…667)

* feat(sonku-ui): use cyan rear-view listener PNG with alpha and verified orientation

* ci(sonku): run scoped Chromium listener FAT for rear-view asset PRs
…ion (#669)

Correct FRONT far / REAR near perspective around listener PNG; smooth stereo speaker scale/opacity and cached rAF nodes; prove real Chromium perspective screenshots and native ACK/drag; scope CI to 8D visuals without unrelated hardware FAT.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant