Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
3 changes: 3 additions & 0 deletions .github/workflows/ui-smoke.yml
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ on:
- '!tests/test_platform_portability.py'
- '!tests/test_release_catalog.py'
- '!tests/test_release_setup_zip.py'
- 'tests/live_routing_ui_contract_test.mjs'
- 'tests/gui_workflow_contract_test.mjs'
- 'tests/*gui*contract*.mjs'
- 'tests/native_ui_contract_test.mjs'
Expand All @@ -44,6 +45,7 @@ on:
- '!tests/test_platform_portability.py'
- '!tests/test_release_catalog.py'
- '!tests/test_release_setup_zip.py'
- 'tests/live_routing_ui_contract_test.mjs'
- 'tests/gui_workflow_contract_test.mjs'
- 'tests/*gui*contract*.mjs'
- 'tests/native_ui_contract_test.mjs'
Expand Down Expand Up @@ -133,6 +135,7 @@ jobs:
node tests/wire_graph_canonical_model.test.cjs
node tests/wire_main_native_handoff_contract.test.cjs
node --test tests/approved_gain_native_readback_contract.test.cjs
node --test tests/live_routing_ui_contract_test.mjs
- name: Verify single published /preview/ source offline
run: |
python scripts/build_pages.py --out dist-pages --sha "${{ github.event_name == 'workflow_dispatch' && inputs.expected_sha != '' && inputs.expected_sha || github.sha }}" --branch main
Expand Down
4 changes: 3 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@

**[Download the latest verified ArSonMix release](https://masarray.github.io/arsonmix/#download)** from the official landing page and choose your operating system. The Windows card always selects the newest verified public Windows installer; on Windows 10/11 x64, click **Download installer ZIP**, extract it, then run Setup. No GitHub account or visit to the GitHub Releases UI is needed.

**Latest published Windows alpha as of 17 November 2026:** [v0.5.0-alpha.25 — Download installer ZIP](https://github.com/masarray/arsonmix/releases/download/v0.5.0-alpha.25/ArSonMix-v0.5.0-alpha.25-Windows-x64-Setup.zip) · [portable ZIP](https://github.com/masarray/arsonmix/releases/download/v0.5.0-alpha.25/ArSonMix-v0.5.0-alpha.25-Windows-x64-Portable.zip) · [SHA-256 checksums](https://github.com/masarray/arsonmix/releases/download/v0.5.0-alpha.25/SHA256SUMS.txt) · [release notes](docs/releases/v0.5.0-alpha.25.md). These are pinned alpha.25 hotfix links; for future verified releases, use the official version-aware landing page.
**Latest published Windows alpha as of 17 November 2026:** [v0.5.0-alpha.26 — Download installer ZIP](https://github.com/masarray/arsonmix/releases/download/v0.5.0-alpha.26/ArSonMix-v0.5.0-alpha.26-Windows-x64-Setup.zip) · [portable ZIP](https://github.com/masarray/arsonmix/releases/download/v0.5.0-alpha.26/ArSonMix-v0.5.0-alpha.26-Windows-x64-Portable.zip) · [SHA-256 checksums](https://github.com/masarray/arsonmix/releases/download/v0.5.0-alpha.26/SHA256SUMS.txt) · [release notes](docs/releases/v0.5.0-alpha.26.md). These are pinned alpha.26 links; the official landing page always selects the newest verified release.

The download cards show the newest verified package available for each platform, including its version and size. Windows previews are published independently of Linux and macOS builds, so their version numbers may differ.

Expand All @@ -30,6 +30,8 @@ The download cards show the newest verified package available for each platform,

**Alpha.25 hotfix:** ImmerSIB now opens its real native JUCE concert window; switching to dearVR or other VST3 editor no longer closes the ImmerSIB window, and clicking the same insert refocuses it. False “Effect settings updated” editor-open toast is removed. No spatial DSP/preset changes. Existing alpha.24 features remain. Experimental Guitar FX redesign or unmerged branches are **not** shipped. See the [alpha.25 release notes](docs/releases/v0.5.0-alpha.25.md) and [alpha.24 baseline](docs/releases/v0.5.0-alpha.24.md) for compatibility and limitations.

**Alpha.26 licensing:** The native desktop app now includes a compact offline **More > About & Licenses** panel containing full AGPLv3 and bundled third-party notices. Setup and portable folders no longer scatter loose legal files; in-place upgrades clean only exact known old notices while preserving user Studio and `.smix` data. This is a licensing/distribution update, not an audio-engine change. See [alpha.26 release notes](docs/releases/v0.5.0-alpha.26.md).

## Get started

1. Download the Windows installer ZIP from the [official landing page](https://masarray.github.io/arsonmix/#download), extract it, run Setup, and start ArSonMix. A supported audio driver and Windows WebView2 runtime may be required.
Expand Down
26 changes: 26 additions & 0 deletions docs/releases/v0.5.0-alpha.26.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
# ArSonMix v0.5.0-alpha.26 — Embedded AGPL and clean native distribution (Windows alpha)

**Scope:** Distribution and legal UX milestone built on the approved v0.5.0-alpha.25 Windows alpha. This release retains its ImmerSIB native editor lifetime hotfix and the previously verified mixer/FX sound engines. It does not alter PCM routing, effect voicing, session format, SonKu presets, ImmerSIB sound, or the approved mixer canvas.

## New in alpha.26

- **Offline About & Licenses:** one understated native-only command at **More → About & Licenses**, with scrollable full GNU Affero General Public License v3, scope notice, MIT KEMAR/HRIR and Signalsmith texts, Inter OFL, and the optional VB-CABLE vendor notice. The original full documents are compiled into the JUCE executable, not downloaded at runtime.
- **Exact versioned source:** **View source** opens the GitHub tree for the embedded build SHA. The canonical repository `LICENSE` remains unchanged and freely accessible. Third-party rights and attribution remain separate.
- **Clean Windows installation and portable distribution:** no loose top-level AGPL/LICENSE/NOTICE files. Inno contains legal texts inside Setup and removes only seven explicitly named historical top-level documentation files during in-place upgrade; never deletes user Studio, `.smix`, preset or project files.
- **Fail-closed release qualification:** packaging scans the real compiled executable for all seven exact original document byte sequences; source, manifest, and EXE hashes must match. Windows installer and in-place upgrade regression coverage, Chromium 1680×900 and 1100×650 legal UI, native JUCE build and FX tests are gated.

## Preserved from alpha.25

- ImmerSIB floating JUCE concert editor reliably opens, stays alive alongside VST3 editor windows and is safely retired with its processor lease.
- SonKu P9.9 acoustic checkpoint, native ImmerSIB scenes, WIRE/BUS/MAIN mixer, Harmonice, Vocal Delay, EQ, Compressor, Guitar FX, VST3 hosting, ArSon Player, and `.smix` Save/Open remain unchanged.
- VB-CABLE continues to use its independently verified official vendor package; FactoryFX/VST3 plugins retain their own licenses and permissions. No unapproved third-party plugins are bundled.

## Installation

Get the newest verified Windows x64 Setup ZIP from the [official download page](https://masarray.github.io/arsonmix/#download). Extract it, run Setup, and upgrade in place; previous Studio and user session files must remain untouched. Open the desktop app, select **More → About & Licenses**, and verify all documents work with internet disconnected. Use **View source** only when you want the precise published source commit.

## Verification and limitations

Implementation: [PR #741](https://github.com/masarray/arsonmix/pull/741), merged to main at `815f2f39153b8944d7de1bbacc01c93bc1a40f63`. On the integrated candidate `47da72d522167a5b0928def6ffa254d22ab242e9`, all 11 GitHub checks succeeded, including production-shaped Windows JUCE GUI compilation, source-exact portable packaging, native FX/SonKu compatibility, the real Chromium legal dialog and Inno smoke tests. Independent inspection of the candidate ZIP confirmed an EXE of 30,892,032 bytes with a matching SHA-256 manifest and no loose top-level license/notice files.

The alpha.26 public publisher **must rebuild from this immutable release-branch SHA**, re-run native Setup installation/upgrade/uninstall verification, and attach checksummed artifacts before creating its GitHub prerelease. This note does not claim those alpha.26 artifacts already exist. Hardware ASIO/WASAPI field monitoring and macOS/Linux public notarized packages remain outside this distribution milestone. Back up private shows and sessions; no critical live-performance certification is claimed.
5 changes: 4 additions & 1 deletion tests/live_routing_ui_contract_test.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -298,7 +298,10 @@ test("G5E native Shows browse and hash-verified FX recall are worker-backed and
assert.match(main,/applyDryRoutingLab\(\s*command,selections,&restores\)/);
assert.match(main,/result\.loadedStates/);
assert.match(main,/entry->uid!=ref\.uid/);
// Show recall invalidates both editor leases (vendor VST3 and ImmerSIB)\n // before graph replacement; a single-window close is no longer sufficient.\n assert.match(main,/safe->closeAllPluginEditors\(\);\\s*error=safe->engine_\\.applyDryRoutingLab\(/);
// Both the generic VST3 editor and the dedicated ImmerSIB editor must
// retire before a restored native Show replaces its processor lease.
assert.match(main,/safe->closeAllPluginEditors\(\)/);
assert.match(main,/void closeAllPluginEditors\(\) noexcept \{\s*closePluginEditor\(\);\s*closeImmerSIBEditor\(\);/);
assert.match(main,/setMasterGainLinear\(/);
assert.match(main,/if \(arm && \(nativeShowBusy_ \|\| studioBackupBusy_\)\)/);
assert.match(main,/engine_\.liveOutputArmFault\(\)/);
Expand Down
Loading