Skip to content

SonKu P7.3: typed native v2/v3 GUI bridge + capability-gated measured XYZ elevation - #687

Closed
masarray wants to merge 7 commits into
feat/sonku-p72-native-xyz-ack-state-20261114from
feat/sonku-p73-xyz-gui-bridge-contract-20261114
Closed

masarray wants to merge 7 commits into
feat/sonku-p72-native-xyz-ack-state-20261114from
feat/sonku-p73-xyz-gui-bridge-contract-20261114

Conversation

@masarray

Copy link
Copy Markdown
Owner

P7.3 native GUI–bridge contract (research only)

Stacked on P7.2 #685 → P7.1 #681 → P7 #679 → P6 #678 → P0–P5 #674. OFF by default.

P7.2 experimentally accepted native 3D elevation, but src/Main.cpp still hardcoded snapshot schema v2 and manually parsed UI JSON without XYZ. Native WebView GUI only described horizontal 0°. P7.3 introduces one reusable typed src/SonKuNativeBridgeContract.h used by the actual Main dispatcher to decode UI intent and produce accepted-state snapshots.

  • Production default: exact schema v2, 46-byte state, unexpected XYZ rejected rather than falsely ACKed. GUI is unchanged.
  • Research enabled: schema v3 and validated directElevationDegrees in the existing ROOM/distance SPSC edit, JUCE PCM applied ACK and native v3 FX binary. Legacy intent/FX v1/v2 restore defaults to 0°.
  • The same approved SonKu WebView editor reveals a compact source elevation slider only after an identity-bound native v3 snapshot; min/max are based on measured bank + physical room clearance. Old 2D azimuth projection is preserved, with no browser audio authority or duplicated DSP.
  • Existing 25Hz bounded SPSC publisher, coalescing and audio-applied ACK/readback remain; stale device/graph snapshots cannot establish native XYZ capability. CSS hidden guard prevents public UI size changes.
  • Scoped Node geometry, Python assembly, and actual Windows JUCE typed codec v2/v3 corruption/restore plus P7.2 native PCM tests.

No full ARMixConsole Windows binary/real physical ASIO or live WIRE/VST3/GUI-click .smix proof yet. Keep all stacked PRs DRAFT and release gates tracked in #683. Do not merge or ship as dearVR-equivalent without evidence.

Details: docs/SONKU_P73_NATIVE_GUI_BRIDGE_CONTRACT_20261114.md.

@cloudflare-workers-and-pages

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

Copy link
Copy Markdown

Deploying arsonmix with  Cloudflare Pages  Cloudflare Pages

Latest commit: cf34921
Status: ✅  Deploy successful!
Preview URL: https://2b2487e6.arsonmix.pages.dev
Branch Preview URL: https://feat-sonku-p73-xyz-gui-bridg.arsonmix.pages.dev

View logs

Copy link
Copy Markdown
Owner Author

P7.3 source/GUI bridge milestone CLOSED — 14 November 2026

Exact immutable HEAD: cf34921d471836559713b52828b77ba3eb44474b; draft stacked PR #687 → P7.2 #685 → P7.1 #681 → P7 #679 → P6 #678 → P0–P5 #674. Public product/installer remain unaffected.

Code completed

  • Consolidated exact native SonKu typed v2/v3 WebView JSON codec in src/SonKuNativeBridgeContract.h. The existing src/Main.cpp action dispatcher uses this one codec for nativeSonKuSet validation and authoritative nativeSonKuSnapshot accepted settings. No second DSP graph, worker, WebAudio panner, callback heap/clock, or new plugin catalog identity.
  • Experimental ARMIX_SONKU_EXPERIMENTAL_NATIVE_XYZ_RT=ON advertises schema v3 and accepts directElevationDegrees as part of the same existing native SPSC ROOM/distance edit and PCM ACK from P7.2; older v1/v2 JSON clients default elevation 0. Production builds remain schema v2 and explicitly reject unsupported XYZ fields, preserving 46-byte native FX state.
  • Reused the approved SonKu WebView editor; compact SOURCE ELEVATION slider is hidden by default and only visible after exact native v3 readback. Valid elevation min/max fits actual room height, listener clearance and radial distance. ROOM/distance gestures fit elevation rather than silently leaving invalid requests; the control is keyboard accessible and uses the existing <=25Hz coalesced edit mechanism.
  • Hardened snapshot ownership: ChannelId, insert instance, device epoch AND graph revision must match before the v3 capability and readback can be trusted. User-visible DSP success requires both AUDIO ACK and matching appliedRequestId in an accepted snapshot.
  • CSS honors hidden despite legacy grid !important; public v2 SonKu visuals and asset geometry are preserved. No other FX, WIRE, Player or Guitar UI code touched.

Exact-source PASS evidence

  • P7.3 + P7.2 scoped source/JUCE #43562470667 — SUCCESS at exact HEAD cf34921d471836559713b52828b77ba3eb44474b. Linux Node checks actual JS syntax and physical 3D GUI projection, Python approved GUI/native source regression, P6/P7.1 PCM, P7.2 moving-source PCM: all PASS.
  • Same exact SHA Windows MSVC JUCE 8.0.15 native build: 3/3 Release CTests PASS (0 failed), including P6 v1/v2 ACK, live P7.2 XYZ PCM and v3 native ACK/state. Test source includes actual typed v2/v3 bridge codec positive and fail-atomic invalid fields, NaN, wrong types, incompatible ROOM, and legacy missing-elevation fallback. This did not compile the entire 7k+ line ARMixConsole app or operate actual ASIO hardware.
  • UI smoke Chromium #43562470661 — SUCCESS: Fast UI contracts plus actual approved native 8D-SonKu insert/editor FAT (desktop and narrow), exact source. These browser checks run ordinary v2 UI; opt-in v3 physical clicks require an experimental host binary.
  • P6 native Windows #43562470659 — SUCCESS: default/opt-in state regression.
  • ArSonMix AUTO PR0 #43562470646 — SUCCESS: existing orchestration checks.

Remaining gate — NOT closed, and not a dearVR parity claim

Issue #683 remains OPEN for experimental full ARMixConsole Windows compile, full production GUI→Main→JUCE→.smix save/open and concurrent WIRE/VST3 plus real ASIO 64/128/256 samples and device restarts, loudness-matched blind headphone/dearVR musical evaluation, host budgeting, licensing and safe merge reconciliation with moving main. Research P7.3 is not public and must remain OFF by default.

Conclusion: the P7.3 scoped native bridge + capability-gated GUI milestone is complete and this development thread may close. Keep PR #687 and all ancestors DRAFT and UNMERGED.

Copy link
Copy Markdown
Owner Author

MILESTONE A: closed WITHOUT MERGE — historical audio research. This P7/P8 version was a private opt-in SonKu research stage, superseded as an active product review by selected owner-approved P9.9 #733. Production #733 selectively ported the accepted latest sound, not the full chain. Preserved original source: feat/sonku-p73-xyz-gui-bridge-contract-20261114 @ cf34921d471836559713b52828b77ba3eb44474b; original target feat/sonku-p72-native-xyz-ack-state-20261114. All 47 PR heads are recorded in docs/governance/MILESTONE_A_PR_BRANCH_RECONCILIATION_20261117.md (chore/milestone-a-pr-history-20261117). No source branch or checkpoint deletion, no DSP changes, no retroactive claim of listening acceptance. New work may reopen via scoped approval.

@masarray masarray closed this Nov 17, 2026
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