Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
23 commits
Select commit Hold shift + click to select a range
ab5411f
docs: establish ArSonEQ PRD, ARD, migration audit and staged roadmap
masarray Oct 29, 2026
35f94ca
feat(dsp): introduce portable 24-band C++ EQ core and headless test h…
masarray Oct 29, 2026
5c3c50f
feat(vst3): add JUCE 9 host adapter, automation/state and compact nat…
masarray Oct 29, 2026
f612d19
fix(ci,dsp): use CTest -C and skip inactive biquad stages at runtime
masarray Oct 29, 2026
4d87fb7
ci: one targeted Windows Release VST3 compile and test-only artifact
masarray Oct 29, 2026
2226397
fix(build): enable C language required by JUCE 9 configuration
masarray Oct 29, 2026
71693ae
feat(M1.5): real-time safe topology fades and cached stereo FFT analyzer
masarray Oct 29, 2026
c758d43
feat(M2): port MaSonKuPik EQ interaction to lightweight embedded WebV…
masarray Oct 29, 2026
d579962
fix(M2): WebView lifecycle safety, binary-data types and bridge smoke…
masarray Oct 29, 2026
8d209f6
feat(M2.1): compact full-canvas EQ with ArSonMix chrome and contextua…
masarray Oct 29, 2026
b478cbb
feat(M2.1): tactile rotary EQ popup, gated analyzer and deterministic…
masarray Oct 29, 2026
c679358
feat(M2.2): build native Standalone EXE and VST3 in one Windows Relea…
masarray Oct 29, 2026
ce164aa
feat(M2.3): unobstructed EQ graph, bottom studio control deck, gold r…
masarray Oct 29, 2026
a354f44
fix(M2.3): prevent pointer-drag reflow and resolve axis label collisions
masarray Oct 29, 2026
30c0308
style(M2.3): reserve HUD clearance from upper response dB labels
masarray Oct 29, 2026
c6a81c1
docs(M2.4): Pro-Q 3 gap audit, stereo analyzer correctness, measurabl…
masarray Oct 29, 2026
9bfa326
feat(M2.4): stereo-correct spectrum FFT, calibrated power, compact qu…
masarray Oct 29, 2026
9b0127a
fix(M2.4): stereo-correct native fallback FFT and precompute Hann onc…
masarray Oct 29, 2026
751316a
feat(M2.5): flicker-free floating EQ inspector, grouped precision edi…
masarray Oct 29, 2026
f304712
feat(M3): native factory/user EQ presets, 9 filter shapes, realtime d…
masarray Oct 30, 2026
ed355eb
feat(M3.1): live native dynamic EQ graph, dark controls, compact insp…
masarray Oct 30, 2026
1f9513d
test(M3.1): validate dynamic RMS release against actual power-envelop…
masarray Oct 30, 2026
8a75337
ci: export pinned passing Windows VST3 binary for SC220 without rebui…
masarray Nov 3, 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
50 changes: 50 additions & 0 deletions .github/workflows/dsp.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
name: Fast headless DSP checks
on:
pull_request:
paths:
- "Source/DSP/**"
- "WebUI/**"
- "tests/**"
- "CMakeLists.txt"
- ".github/workflows/dsp.yml"
workflow_dispatch:
permissions:
contents: read
concurrency:
group: dsp-${{ github.event.pull_request.number || github.ref }}
cancel-in-progress: true
jobs:
dsp-linux:
runs-on: ubuntu-latest
timeout-minutes: 8
steps:
- uses: actions/checkout@v4
- name: Configure native core (no JUCE download)
run: cmake -S . -B build -DARSONEQ_BUILD_PLUGIN=OFF -DARSONEQ_BUILD_TESTS=ON -DCMAKE_BUILD_TYPE=Release
- name: Compile native tests
run: cmake --build build --config Release --parallel 2
- name: Test DSP, transitions, analyzer queue
run: ctest --test-dir build -C Release --output-on-failure
- name: JS syntax + offline UI bridge smoke (no npm needed)
run: |
node --check WebUI/app.js
node WebUI/smoke.test.cjs
- name: Capture 900x535 editor visual QA (no JUCE build)
shell: bash
run: |
node WebUI/visual-qa.cjs
CHROME=$(command -v google-chrome || command -v chromium || true)
if [[ -z "$CHROME" ]]; then
echo "Chromium unavailable; skipping image snapshot"
exit 0
fi
mkdir -p visual-qa
"$CHROME" --headless --no-sandbox --disable-gpu --hide-scrollbars --virtual-time-budget=1200 --window-size=900,535 --screenshot="$PWD/visual-qa/ArSonEQ-M3-1-900x535.png" "file://$PWD/WebUI/visual-qa.generated.html"
test -s visual-qa/ArSonEQ-M3-1-900x535.png
- name: Publish actual browser rendering for UI review
uses: actions/upload-artifact@v4
with:
name: ArSonEQ-M3-1-GUI-Visual-QA
path: visual-qa/ArSonEQ-M3-1-900x535.png
if-no-files-found: warn
retention-days: 7
74 changes: 74 additions & 0 deletions .github/workflows/sc220-vst3-export.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,74 @@
name: SC220 integration VST3 reproducible binary export
on:
push:
branches: ['feat/initial-vst3-eq-architecture']
paths: ['.github/workflows/sc220-vst3-export.yml']
workflow_dispatch:

permissions:
actions: read
contents: write

concurrency:
group: sc220-arsoneq-export
cancel-in-progress: false

jobs:
export-reproducible-vst3:
runs-on: ubuntu-24.04
timeout-minutes: 10
steps:
- uses: actions/checkout@v4
with:
persist-credentials: false
- name: Pin previous successful Windows CI artifact
env:
GH_TOKEN: ${{ github.token }}
shell: bash
run: |
set -euo pipefail
run_status=$(gh api repos/masarray/arson-eq/actions/runs/40983590331 --jq '.conclusion')
run_sha=$(gh api repos/masarray/arson-eq/actions/runs/40983590331 --jq '.head_sha')
[[ "$run_status" == "success" ]] || { echo "Original VST3 build was not successful"; exit 1; }
[[ "$run_sha" == "1f9513d75faea306e06bafd7b68119d4b8bef276" ]] || { echo "Source changed; rebuild required"; exit 1; }
gh run download 40983590331 --repo masarray/arson-eq --name 'ArSonEQ-M3-1-Windows-x64-VST3-Standalone-TEST' --dir from-audited-ci
- name: Verify actual VST3 module, package exact binary and AGPL notice
shell: bash
run: |
set -euo pipefail
bundle='from-audited-ci/VST3/ArSonEQ.vst3'
test -d "$bundle"
module=$(find "$bundle" -type f -iname '*.vst3' -print -quit)
test -n "$module"
test "$(stat -c '%s' "$module")" -gt 100000
mkdir -p stage
cp -a "$bundle" 'stage/ArSonEQ.vst3'
cp LICENSE 'stage/AGPL-3.0-LICENSE.txt'
cat > stage/PROVENANCE.txt <<EOF
Plugin: ArSonEQ (independent AGPL-3.0 VST3)
Source repository: https://github.com/masarray/arson-eq
Binary build commit: 1f9513d75faea306e06bafd7b68119d4b8bef276
Binary Windows CI run: https://github.com/masarray/arson-eq/actions/runs/40983590331
Artifact: ArSonEQ-M3-1-Windows-x64-VST3-Standalone-TEST
Windows: x64
SC220 Live host integration: optional separate plugin, not embedded into the host executable.
The SC220 Live host remains under its own terms; do not assume licence compatibility without review.
EOF
(cd stage && zip -qr ../ArSonEQ-v0.1.0-M3.1-Windows-x64-VST3.zip .)
sha256sum 'ArSonEQ-v0.1.0-M3.1-Windows-x64-VST3.zip' > SHA256SUMS.txt
test -s 'ArSonEQ-v0.1.0-M3.1-Windows-x64-VST3.zip'
unzip -tq 'ArSonEQ-v0.1.0-M3.1-Windows-x64-VST3.zip'
- name: Publish version-pinned public engineering VST3 binary without mutating stable tags
env:
GH_TOKEN: ${{ github.token }}
shell: bash
run: |
set -euo pipefail
if gh release view 'v0.1.0-m3.1-sc220-test' --repo 'masarray/arson-eq' >/dev/null 2>&1; then
echo "Immutable integration release exists; refusing to replace binaries."
exit 1
fi
gh release create 'v0.1.0-m3.1-sc220-test' 'ArSonEQ-v0.1.0-M3.1-Windows-x64-VST3.zip' SHA256SUMS.txt \
--repo 'masarray/arson-eq' --target '1f9513d75faea306e06bafd7b68119d4b8bef276' --prerelease \
--title 'ArSonEQ - SC220 Integration VST3 (M3.1 engineering)' \
--notes 'Independently licensed AGPL-3.0 Windows x64 VST3 exported from an already-passing Windows build. Includes source/run provenance, corresponding GitHub source commit, licence and checksums. Intended as an engineering test asset, not a claim of SC220+ASIO hardware approval.'
76 changes: 76 additions & 0 deletions .github/workflows/vst3-windows.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,76 @@
name: Windows VST3 + Standalone Release
on:
pull_request:
paths:
- "Source/**"
- "WebUI/index.html"
- "WebUI/style.css"
- "WebUI/app.js"
- "tests/**"
- "CMakeLists.txt"
- ".github/workflows/vst3-windows.yml"
workflow_dispatch:
permissions:
contents: read
concurrency:
group: windows-dual-${{ github.event.pull_request.number || github.ref }}
cancel-in-progress: true
jobs:
windows-dual:
runs-on: windows-latest
timeout-minutes: 35
steps:
- uses: actions/checkout@v4
- name: Cache pinned WebView2 SDK
uses: actions/cache@v4
id: webview2
with:
path: ${{ runner.temp }}/arsoneq-nuget
key: webview2-sdk-1.0.3485.44
- name: Install WebView2 SDK (build-time only)
if: steps.webview2.outputs.cache-hit != 'true'
shell: pwsh
run: nuget install Microsoft.Web.WebView2 -Version 1.0.3485.44 -OutputDirectory "$env:RUNNER_TEMP/arsoneq-nuget" -NonInteractive
- name: Configure pinned JUCE 9.0.4 and all tests
shell: pwsh
run: cmake -S . -B build-vst -DARSONEQ_BUILD_PLUGIN=ON -DARSONEQ_BUILD_TESTS=ON "-DJUCE_WEBVIEW2_PACKAGE_LOCATION=$env:RUNNER_TEMP/arsoneq-nuget"
- name: Build BOTH Windows Release formats + native tests
run: cmake --build build-vst --config Release --target ArSonEQ_VST3 ArSonEQ_Standalone arson_eq_core_tests arson_eq_rt_tests arson_eq_analyzer_tests --parallel 2
- name: Run 3 native DSP suites
run: ctest --test-dir build-vst -C Release --output-on-failure
- name: Package verified VST3 and Standalone EXE together
shell: pwsh
run: |
$ErrorActionPreference = 'Stop'
$root = "build-vst/ArSonEQ_artefacts/Release"
$vst = Join-Path $root "VST3/ArSonEQ.vst3"
$standaloneDir = Join-Path $root "Standalone"
if (!(Test-Path $vst -PathType Container)) { throw "Missing VST3 bundle: $vst" }
$exe = Get-ChildItem $standaloneDir -Filter "ArSonEQ.exe" -File -ErrorAction Stop | Select-Object -First 1
if ($null -eq $exe) { throw "Missing Standalone EXE in $standaloneDir" }
if ($exe.Length -lt 100000) { throw "Unexpectedly small Standalone EXE" }
$dll = Get-ChildItem $vst -Recurse -File -Filter "*.vst3" | Select-Object -First 1
if ($null -eq $dll -or $dll.Length -lt 100000) { throw "Missing compiled VST3 module" }
$out = "dist/ArSonEQ-M3-1-Windows-x64"
New-Item -ItemType Directory -Force "$out/VST3","$out/Standalone" | Out-Null
Copy-Item -Path $vst -Destination "$out/VST3/" -Recurse -Force
Copy-Item -Path $exe.FullName -Destination "$out/Standalone/ArSonEQ.exe" -Force
Copy-Item -Path "packaging/README_WINDOWS_TEST.txt" -Destination "$out/README_WINDOWS_TEST.txt" -Force
Set-Content -Path "$out/BUILD.txt" -Value @(
"Project: ArSonEQ M3 native stereo FFT + quick editor engineering test"
"Commit: ${{ github.sha }}"
"Windows: x64 / Release"
"Targets: VST3 + Standalone"
"JUCE: 9.0.4; GUI: bundled offline WebView2"
"VST3 module bytes: $($dll.Length)"
"Standalone exe bytes: $($exe.Length)"
"Both produced by a single CI run."
) -Encoding utf8
Get-ChildItem $out -Recurse | Select-Object FullName,Length
- name: Upload combined VST3 + Standalone test package
uses: actions/upload-artifact@v4
with:
name: ArSonEQ-M3-1-Windows-x64-VST3-Standalone-TEST
path: dist/ArSonEQ-M3-1-Windows-x64/
if-no-files-found: error
retention-days: 14
83 changes: 83 additions & 0 deletions CMakeLists.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@
cmake_minimum_required(VERSION 3.24)
project(ArSonEQ VERSION 0.1.0 LANGUAGES C CXX)

option(ARSONEQ_BUILD_PLUGIN "Build JUCE VST3 plugin and native Standalone application" OFF)
option(ARSONEQ_BUILD_TESTS "Build standalone DSP unit tests" ON)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_EXTENSIONS OFF)

add_library(arson_eq_dsp INTERFACE)
target_include_directories(arson_eq_dsp INTERFACE "${CMAKE_CURRENT_SOURCE_DIR}/Source")
target_compile_features(arson_eq_dsp INTERFACE cxx_std_17)

if(ARSONEQ_BUILD_TESTS)
enable_testing()
add_executable(arson_eq_core_tests tests/eq_core_tests.cpp)
target_link_libraries(arson_eq_core_tests PRIVATE arson_eq_dsp)
if(MSVC)
target_compile_options(arson_eq_core_tests PRIVATE /W4)
else()
target_compile_options(arson_eq_core_tests PRIVATE -Wall -Wextra -Wpedantic)
endif()
add_test(NAME arson_eq_core COMMAND arson_eq_core_tests)
add_executable(arson_eq_rt_tests tests/eq_rt_tests.cpp)
target_link_libraries(arson_eq_rt_tests PRIVATE arson_eq_dsp)
add_test(NAME arson_eq_rt COMMAND arson_eq_rt_tests)
find_package(Threads REQUIRED)
add_executable(arson_eq_analyzer_tests tests/eq_analyzer_tests.cpp)
target_link_libraries(arson_eq_analyzer_tests PRIVATE arson_eq_dsp Threads::Threads)
add_test(NAME arson_eq_analyzer COMMAND arson_eq_analyzer_tests)
endif()

if(ARSONEQ_BUILD_PLUGIN)
# Local JUCE checkout for offline builds; otherwise fetch a pinned release.
if(DEFINED JUCE_SOURCE_DIR AND EXISTS "${JUCE_SOURCE_DIR}/CMakeLists.txt")
add_subdirectory("${JUCE_SOURCE_DIR}" "${CMAKE_BINARY_DIR}/juce")
else()
include(FetchContent)
FetchContent_Declare(juce
GIT_REPOSITORY https://github.com/juce-framework/JUCE.git
GIT_TAG 9.0.4
GIT_SHALLOW TRUE)
FetchContent_MakeAvailable(juce)
endif()

juce_add_plugin(ArSonEQ
COMPANY_NAME "ArSon Audio"
BUNDLE_ID "com.arsonaudio.arsoneq"
PLUGIN_MANUFACTURER_CODE ArsN
PLUGIN_CODE ArEQ
# One shared processor/editor implementation for both deliverables.
# Standalone is a native Windows executable, NOT a web page.
FORMATS VST3 Standalone
VST3_CATEGORIES Fx EQ
IS_SYNTH FALSE
NEEDS_MIDI_INPUT FALSE
NEEDS_MIDI_OUTPUT FALSE
IS_MIDI_EFFECT FALSE
COPY_PLUGIN_AFTER_BUILD FALSE
PRODUCT_NAME "ArSonEQ"
NEEDS_WEBVIEW2 TRUE)
target_sources(ArSonEQ PRIVATE
Source/PluginProcessor.cpp
Source/PluginEditor.cpp)
if(WIN32)
# Browser UI is plain static HTML/CSS/JS embedded in BOTH formats.
# No Node/React/vite/npm at runtime and no local web server.
juce_add_binary_data(ArSonEQWebAssets SOURCES
WebUI/index.html WebUI/style.css WebUI/app.js)
target_sources(ArSonEQ PRIVATE Source/WebEditor.cpp)
target_link_libraries(ArSonEQ PRIVATE ArSonEQWebAssets)
endif()
target_link_libraries(ArSonEQ PRIVATE arson_eq_dsp
juce::juce_audio_utils juce::juce_gui_extra juce::juce_dsp
juce::juce_recommended_config_flags
juce::juce_recommended_warning_flags
juce::juce_recommended_lto_flags)
target_compile_definitions(ArSonEQ PRIVATE
JUCE_WEB_BROWSER=1 JUCE_USE_CURL=0 JUCE_VST3_CAN_REPLACE_VST2=0)
if(WIN32)
target_compile_definitions(ArSonEQ PRIVATE JUCE_USE_WIN_WEBVIEW2=1)
endif()
endif()
Loading
Loading