Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
44 commits
Select commit Hold shift + click to select a range
30224fb
research(sonku): add allocation-free music-first directional differen…
masarray Nov 14, 2026
15b58ca
test(sonku): actual native P82 and physical P83 PCM six-program music…
masarray Nov 14, 2026
a0053f8
docs(sonku): formalize dearVR-informed musical clarity strategy, evid…
masarray Nov 14, 2026
db4ee5d
ci(sonku): gate P8.4 music-first directional contrast without costly …
masarray Nov 14, 2026
49c8a44
test(sonku): retain full per-frequency evidence when P8.4 acoustic gu…
masarray Nov 14, 2026
ba8b33c
test(sonku): aggregate all program, room and spectral evidence before…
masarray Nov 14, 2026
24553ab
refine(sonku): constrain P8.4 coloration via measured 12 percent dire…
masarray Nov 14, 2026
f531324
test(sonku): add 1/3 octave measured impulse-response spectrum fideli…
masarray Nov 14, 2026
fe4f1c4
docs(sonku): record 1/3 octave impulse and room native source fidelit…
masarray Nov 14, 2026
9df390b
fix(gui): unify approved preview and native console visuals (#703)
masarray Nov 14, 2026
8fd84e5
feat(sonku): add bounded high-pass HRTF difference kernel fusion for …
masarray Nov 14, 2026
68e88f1
feat(sonku): fuse P8.4 music-preserving HRTF into one native 2x2 FIR …
masarray Nov 14, 2026
0afd154
test(sonku): one-core fused native P8.2 quality, impulse-band, yaw an…
masarray Nov 14, 2026
9e6a7e6
ci(sonku): independently gate P8.4 single native PCM graph and preser…
masarray Nov 14, 2026
f6ab705
fix(sonku): disabling isolated P8.4 fusion is an idempotent no-op for…
masarray Nov 14, 2026
43d8544
feat(sonku): keep world-fixed early reflection yaw aligned with P8.4 …
masarray Nov 14, 2026
176c4b1
perf(sonku): measure single-core P8.4 versus P8.2 at 44.1/48k 1-4 ins…
masarray Nov 14, 2026
528406a
test(sonku): verify P8.4 source and six-wall room orientation under w…
masarray Nov 14, 2026
98b96e9
ci(sonku): prove byte-identical P8.2 and benchmark P8.4 1-4 inserts b…
masarray Nov 14, 2026
541115e
test(sonku): quantify frontal rear ILD/IACC and world-fixed room impu…
masarray Nov 14, 2026
4f2e0ec
ci(sonku): gate real binaural ILD/IACC and early reflection motion so…
masarray Nov 14, 2026
af95320
test(sonku): correct offline yaw stimulus to use same 12 percent cont…
masarray Nov 14, 2026
56c5ce1
tool(sonku): render actual music WAV through P8.2 golden vs single-co…
masarray Nov 14, 2026
b132916
ci(sonku): smoke real stereo WAV music A/B with P82 golden and P84 fu…
masarray Nov 14, 2026
1d9f2d7
docs(sonku): reconcile real P8.4 single-core, CPU, binaural evidence …
masarray Nov 14, 2026
fa40eaa
fix(gui): eliminate IN/OUT/EXT clipping on shared Preview/native cons…
masarray Nov 14, 2026
63695e2
feat(sonku): reserve typed P8.4 native render mode 3 behind research …
masarray Nov 14, 2026
2efc15a
feat(sonku): realtime P8.4 mode 3 uses preserved P8.2 bass SIDE and o…
masarray Nov 14, 2026
6157ac3
feat(sonku): version 5 native FX state, safe v1-v4 restoration and ph…
masarray Nov 14, 2026
5345052
feat(sonku): truthful v5 control plane exposes only P8.2 golden and f…
masarray Nov 14, 2026
56c2244
fix(sonku): reject unqualified physical modes in native v5 state restore
masarray Nov 14, 2026
4ab7653
feat(sonku): native instance-bound P8.4 research capability in real m…
masarray Nov 14, 2026
f14e79a
feat(sonku): native v5 GUI A/B P8.2 golden vs P8.4 music fusion with …
masarray Nov 14, 2026
54b9968
build(sonku): opt-in P8.4 native v5 app with real JUCE and single-cor…
masarray Nov 14, 2026
5e275dc
test(sonku): real JUCE v5 single-core P8.4 A/B, PCM ACK and legacy v4…
masarray Nov 14, 2026
964f9f4
ci(sonku): gated native Windows x64 P8.4 v5 mixer portable research FAT
masarray Nov 14, 2026
d90ad33
merge(main): reconcile latest approved GUI to P8.4 research Windows f…
masarray Nov 14, 2026
775489d
test(sonku): gate real P8.4 v5 renderMode3 A/B and 64/128 native PCM …
masarray Nov 14, 2026
c7bd390
ci(sonku): verify P8.4 live mode 3 actual callback before Windows nat…
masarray Nov 14, 2026
c16666a
test(sonku): finalize JUCE MemoryOutputStream before checking legacy …
masarray Nov 14, 2026
6beb291
fix(sonku): quarantine legacy LF480 flags in all v4 sessions and reje…
masarray Nov 14, 2026
47d168a
fix(sonku): native v5 control-plane always rejects rejected P8.3 LF48…
masarray Nov 14, 2026
adcb4f0
test(sonku): verify old v4 P8.2 with stale LF480 flag sanitizes on v5…
masarray Nov 14, 2026
641b4ea
ci(sonku): fail-fast JUCE v5 state/ACK test before full Windows GUI c…
masarray Nov 14, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
168 changes: 168 additions & 0 deletions .github/workflows/sonku-p84-clarity-research.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,168 @@
name: SonKu P8.4 musical fidelity constrained research

on:
pull_request:
paths:
- 'engine/builtin_fx/sonku/SonKuP84ClarityAnchor.h'
- 'engine/builtin_fx/sonku/SonKuP84FusedMusicHrir.h'
- 'engine/builtin_fx/sonku/SonKuSpatialCore.h'
- 'tests/sonku_p84_clarity_candidate_test.cpp'
- 'tests/sonku_p84_fused_single_core_test.cpp'
- 'tests/sonku_p84_fused_hosted_cpu_benchmark.cpp'
- 'tests/sonku_p84_spatial_impulse_evidence_test.cpp'
- 'tests/sonku_p84_live_v5_modes_source_test.cpp'
- 'tools/sonku_p84_offline_audition.cpp'
- 'docs/SONKU_P84_CLARITY_FIRST_ARCHITECTURE_20261115.md'
- '.github/workflows/sonku-p84-clarity-research.yml'
workflow_dispatch:

permissions:
contents: read

jobs:
clarity-source:
runs-on: ubuntu-latest
timeout-minutes: 8
steps:
- uses: actions/checkout@v4
- name: Native source P82 reference versus physical P83, PCM music integrity and yaw
shell: bash
run: |
set -euo pipefail
g++ -std=c++20 -O2 -Wall -Wextra -Werror -pedantic \
-DSONKU_P7_MEASURED_ELEVATION_RESEARCH=1 \
-DSONKU_P71_DIRECT_XYZ_RESEARCH=1 \
-DSONKU_P72_NATIVE_XYZ_RT=1 \
-DSONKU_P75_MUSIC_SAFE_RESEARCH=1 \
-DSONKU_P80_TRANSPARENT_BASS_RESEARCH=1 \
-DSONKU_P82_MULTIBAND_ROOM_RESEARCH=1 \
-DSONKU_P83_PHYSICAL_SPEAKER_RESEARCH=1 \
tests/sonku_p84_clarity_candidate_test.cpp -o /tmp/sonku-p84
/tmp/sonku-p84 | tee /tmp/sonku-p84.log
grep -q '^PASS P84 RESEARCH:' /tmp/sonku-p84.log
- name: REAL one-PCM-graph 2x2 fused HRTF and P8.2 no-regression gate
shell: bash
run: |
set -euo pipefail
g++ -std=c++20 -O2 -Wall -Wextra -Werror -pedantic \
-DSONKU_P7_MEASURED_ELEVATION_RESEARCH=1 \
-DSONKU_P71_DIRECT_XYZ_RESEARCH=1 \
-DSONKU_P72_NATIVE_XYZ_RT=1 \
-DSONKU_P75_MUSIC_SAFE_RESEARCH=1 \
-DSONKU_P80_TRANSPARENT_BASS_RESEARCH=1 \
-DSONKU_P82_MULTIBAND_ROOM_RESEARCH=1 \
-DSONKU_P83_PHYSICAL_SPEAKER_RESEARCH=1 \
-DSONKU_P84_SINGLE_CORE_FUSION_RESEARCH=1 \
tests/sonku_p84_fused_single_core_test.cpp -o /tmp/sonku-p84-fused
/tmp/sonku-p84-fused | tee /tmp/sonku-p84-fused.log
grep -q '^PASS P84 SINGLE CORE:' /tmp/sonku-p84-fused.log
- name: Cross-build bit-exact P8.2 when P8.4 compiled OFF versus compiled ON
shell: bash
run: |
set -euo pipefail
COMMON="-std=c++20 -O2 -Wall -Wextra -Werror -pedantic -DSONKU_P7_MEASURED_ELEVATION_RESEARCH=1 -DSONKU_P71_DIRECT_XYZ_RESEARCH=1 -DSONKU_P72_NATIVE_XYZ_RT=1 -DSONKU_P75_MUSIC_SAFE_RESEARCH=1 -DSONKU_P80_TRANSPARENT_BASS_RESEARCH=1 -DSONKU_P82_MULTIBAND_ROOM_RESEARCH=1 -DSONKU_P83_PHYSICAL_SPEAKER_RESEARCH=1"
g++ $COMMON tests/sonku_p83_music_bed_byte_parity.cpp -o /tmp/p82-off
g++ $COMMON -DSONKU_P84_SINGLE_CORE_FUSION_RESEARCH=1 tests/sonku_p83_music_bed_byte_parity.cpp -o /tmp/p82-on
/tmp/p82-off /tmp/p82-reference.pcm
/tmp/p82-on /tmp/p82-fused-disabled.pcm
cmp -s /tmp/p82-reference.pcm /tmp/p82-fused-disabled.pcm
echo "PASS P84 BIT EXACT P82: 44.1/48k room OFF/ON mono/anti-phase bytewise identical"
- name: Source binaural orientation ILD IACC and early reflection evidence
shell: bash
run: |
set -euo pipefail
g++ -std=c++20 -O2 -Wall -Wextra -Werror -pedantic \
-DSONKU_P7_MEASURED_ELEVATION_RESEARCH=1 \
-DSONKU_P71_DIRECT_XYZ_RESEARCH=1 \
-DSONKU_P72_NATIVE_XYZ_RT=1 \
-DSONKU_P75_MUSIC_SAFE_RESEARCH=1 \
-DSONKU_P80_TRANSPARENT_BASS_RESEARCH=1 \
-DSONKU_P82_MULTIBAND_ROOM_RESEARCH=1 \
-DSONKU_P83_PHYSICAL_SPEAKER_RESEARCH=1 \
-DSONKU_P84_SINGLE_CORE_FUSION_RESEARCH=1 \
tests/sonku_p84_spatial_impulse_evidence_test.cpp -o /tmp/p84-spatial
/tmp/p84-spatial | tee /tmp/p84-spatial.log
grep -q '^PASS P84 SPATIAL SOURCE:' /tmp/p84-spatial.log
- name: Actual one-core WAV audition CLI, ROOM ON/OFF and four calibrated-input files
shell: bash
run: |
set -euo pipefail
g++ -std=c++20 -O2 -Wall -Wextra -Werror -pedantic \
-DSONKU_P7_MEASURED_ELEVATION_RESEARCH=1 \
-DSONKU_P71_DIRECT_XYZ_RESEARCH=1 \
-DSONKU_P72_NATIVE_XYZ_RT=1 \
-DSONKU_P75_MUSIC_SAFE_RESEARCH=1 \
-DSONKU_P80_TRANSPARENT_BASS_RESEARCH=1 \
-DSONKU_P82_MULTIBAND_ROOM_RESEARCH=1 \
-DSONKU_P83_PHYSICAL_SPEAKER_RESEARCH=1 \
-DSONKU_P84_SINGLE_CORE_FUSION_RESEARCH=1 \
tools/sonku_p84_offline_audition.cpp -o /tmp/p84-wav-audition
python3 - <<'PY'
import wave, struct, math
with wave.open('/tmp/p84-original.wav','wb') as o:
o.setnchannels(2);o.setsampwidth(2);o.setframerate(48000)
pcm=bytearray()
for i in range(8192):
t=i/48000
bass=.16*math.sin(2*math.pi*83*t)
vocal=.10*math.sin(2*math.pi*461*t)
side=.11*math.sin(2*math.pi*1703*t)
l=bass+vocal+side
r=bass+vocal-side
pcm+=struct.pack('<hh',int(l*32767),int(r*32767))
o.writeframes(pcm)
PY
/tmp/p84-wav-audition /tmp/p84-original.wav /tmp/p84-room-off --room=off
/tmp/p84-wav-audition /tmp/p84-original.wav /tmp/p84-room-on --room=on
python3 - <<'PY'
from pathlib import Path
import csv,struct,math
names=('P82_Golden','P84_FusedYaw0','P84_FusedYawPlus60','P84_FusedYawMinus60')
for room in ('off','on'):
directory=Path('/tmp/p84-room-'+room)
with (directory/'sonku_p84_music_audition_metrics.csv').open() as f:
rows=list(csv.DictReader(f))
assert len(rows)==4
assert {x['variant'] for x in rows}==set(names)
for row in rows:
assert math.isfinite(float(row['output_rms']))
assert float(row['output_peak'])<1.0
path=directory/(row['variant']+'.wav')
data=path.read_bytes()
assert data[:4]==b'RIFF' and data[8:12]==b'WAVE'
assert data[36:40]==b'fact'
assert len(data)==8192*8+56
assert abs(float(rows[0]['relative_rms_db_vs_p82']))<1e-12
print('PASS P84 REAL WAV CLI: PCM16 source, float32 fact, four same-input native variants, ROOM ON/OFF')
PY
- name: Explicit P8.4 v5 live mode 3 stereo PCM source equivalence
run: |
set -euo pipefail
g++ -std=c++20 -O2 -Wall -Wextra -Werror -pedantic \
-DSONKU_P7_MEASURED_ELEVATION_RESEARCH=1 \
-DSONKU_P71_DIRECT_XYZ_RESEARCH=1 \
-DSONKU_P72_NATIVE_XYZ_RT=1 \
-DSONKU_P75_MUSIC_SAFE_RESEARCH=1 \
-DSONKU_P80_TRANSPARENT_BASS_RESEARCH=1 \
-DSONKU_P82_MULTIBAND_ROOM_RESEARCH=1 \
-DSONKU_P83_PHYSICAL_SPEAKER_RESEARCH=1 \
-DSONKU_P84_SINGLE_CORE_FUSION_RESEARCH=1 \
tests/sonku_p84_live_v5_modes_source_test.cpp -o /tmp/p84-v5-mode
/tmp/p84-v5-mode | tee /tmp/p84-v5-mode.log
grep -q '^PASS P84 V5 NATIVE SOURCE:' /tmp/p84-v5-mode.log
- name: Hosted CPU 1-4 inserts 64-256 buffer research (not ASIO XRUN)
shell: bash
run: |
set -euo pipefail
g++ -std=c++20 -O2 -Wall -Wextra -Werror -pedantic \
-DSONKU_P7_MEASURED_ELEVATION_RESEARCH=1 \
-DSONKU_P71_DIRECT_XYZ_RESEARCH=1 \
-DSONKU_P72_NATIVE_XYZ_RT=1 \
-DSONKU_P75_MUSIC_SAFE_RESEARCH=1 \
-DSONKU_P80_TRANSPARENT_BASS_RESEARCH=1 \
-DSONKU_P82_MULTIBAND_ROOM_RESEARCH=1 \
-DSONKU_P83_PHYSICAL_SPEAKER_RESEARCH=1 \
-DSONKU_P84_SINGLE_CORE_FUSION_RESEARCH=1 \
tests/sonku_p84_fused_hosted_cpu_benchmark.cpp -o /tmp/p84-cpu
/tmp/p84-cpu | tee /tmp/p84-cpu.log
grep -q '^PASS P84 SINGLE CPU:' /tmp/p84-cpu.log
Loading
Loading