Skip to content

P0 SonKu: FRONT-up human + 25Hz coalesced live PCM slider/knob/source gestures - #665

Merged
masarray merged 8 commits into
integration/sonku-m4-guitar-fx-main-20261113from
fix/sonku-front-up-live-gesture-20261113
Nov 13, 2026
Merged

masarray merged 8 commits into
integration/sonku-m4-guitar-fx-main-20261113from
fix/sonku-front-up-live-gesture-20261113

Conversation

@masarray

Copy link
Copy Markdown
Owner

SonKu checkpoint-oriented P0 native gesture + orientation fix

Operator accepted smooth orbital animation and improved native audio from exact 95a46ac386f0c5b8df115d6f1a971f47bd405070 but requested listener-facing anatomical orientation FRONT at stage TOP and reported every slider/rotary only changes heard PCM after pointer release.

Preserved immutable approved checkpoint checkpoint/sonku-p1-audio-smooth-orbit-approved-20261113 at 95a46ac.... This PR is stacked atop draft #655; NO direct main merge/release or acoustic core changes.

Root cause and architecture

  • Native source mixer-native-sonku.js listens for input but only updates visual draft; it queues nativeSonKuSet at change / pointerup. This is the source of non-live sound; not a JUCE PCM callback bug.
  • Now one bounded continuous gesture publisher for all SonKu's 3 SPACE sliders, 4 rotary dials, keyboard changes, and speaker drag. Live input sends native PCM requests at max 25Hz. One SPSC native edit in-flight; extra input coalesces latest value only (no unbounded 250Hz command flood), flushed only after real PCM APPLIED ACK and matching accepted state snapshot. Final release always wins. Browser-only visual mode cannot claim DSP; no second WebAudio graph.
  • Local control retains ownership until release so delayed readback cannot reset slider. Control side persists v2 .smix exactly; DSP still sample-smooths continuous gain/distance/wet edits and keeps 0.98 peak ceiling.
  • TOP=FRONT (0°), SCREEN RIGHT=+90°, REAR=180° at BOTTOM, LEFT=-90° from original JS projection and inverse pointer mapping; native HRIR coordinate signs/pan and rotation direction unchanged. Custom original SVG top-down/back-of-head shaded vector, anatomy oriented up. Front source rail and icons truly over listener, rear physically below silhouette. No upside-down facial photo.

Acceptance

  • Actual compiled /preview/ Chromium 1366px and 390px: right/left/front/rear acoustic anchors and text; back-of-head vector; occlusion order; role=slider access.
  • Mouse held on SOURCE DISTANCE, source icon, rotary: native intent before pointerup, one in-flight, no jump on stale readback, final value emitted after ACK+readback.
  • 30 rapid REVERB inputs emit at most one in flight; final 71% submitted after ACK, not lost. Also verify controls still convey +6dB GAIN, independent reflections/reverb and persist typed ACK contract.
  • Focused C++/JS fast CI, targeted real Chromium screenshots. Windows field preview only after green; no public tag/installer and no physical ASIO quality claim.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 13, 2026 •

Copy link
Copy Markdown

Deploying arsonmix with  Cloudflare Pages  Cloudflare Pages

Latest commit: 5b56736
Status: ✅  Deploy successful!
Preview URL: https://3c3be1e9.arsonmix.pages.dev
Branch Preview URL: https://fix-sonku-front-up-live-gest.arsonmix.pages.dev

View logs

@masarray
masarray merged commit c3a212b into integration/sonku-m4-guitar-fx-main-20261113 Nov 13, 2026
7 of 8 checks passed

Copy link
Copy Markdown
Owner Author

Repository-wide continuous-control audit (scope and evidence)

Reviewed currently integrated native built-in editors in site/preview-v2/assets before selecting a publisher design:

  • SonKu (this PR): SOURCE DISTANCE, REFLECTIONS, REVERB horizontal ranges; REVOLUTION, SPREAD, SPATIAL MIX, OUTPUT GAIN tactile knobs; SVG speaker drag. All 8 gesture surfaces use one bounded liveInput + commitInput policy, single native pending + latest-wins, exact DSP ACK/readback. Tests include 30-event burst, stale snapshot during held drag, input-only knobs and preserved orientation.
  • Compressor: existing input handler calls changeValue, native send throttled by ~130ms or delayed state, pointer drag also uses it. This is already a partially live path and must not be blanket-replaced.
  • Harmonice vocal harmony: sliders.forEach(input) already calls edit on input; change semantics are different and need to preserve guide/preset logic.
  • Parametric EQ: rotary pointer movement calls change(...,true), with deferred commit and typed band SPSC. Requires separate tests for accepted band state; not safe to blindly patch based on DOM events alone.
  • ArSon Vocal Throw: physical rotary deliberately sends nativeThrowSet only at pointer release; wheel 95ms batching, keyboard immediate; a separate release-only UX policy exists. If requested for real-time sweeps, upgrade under its own typed contract with regression/ASIO checks, not by copying this SonKu function.

General rule: UI input must update the visible control immediately and, where live audio modulation is intended, schedule an ACK-bound native state edit. change/pointerup commits terminal value; always coalesce at UI message thread, never do work in the PCM callback. A single cross-FX utility is a later maintainability refactor after every editor's existing presets/bypass/typed ACK contracts are characterized. No other plugin's DSP or GUI touched by this SonKu P0.

No new UI-wide modes, CSS owner, or timer jobs. SonKu's fixed-rate single-flight transport is proved by Chromium; actual ASIO latency remains an operator field acceptance item.

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.
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