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
2 changes: 1 addition & 1 deletion .github/workflows/pages.yml
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ jobs:
shell: bash
run: |
set -euo pipefail
release="repos/$GITHUB_REPOSITORY/releases/tags/v0.2.0-rc.1"
release="repos/$GITHUB_REPOSITORY/releases/tags/v0.2.0"
gh api "$release" --jq '.assets[].name' | sort > /tmp/arson-release-assets.txt
for name in \
ArSonComp-0.2.0-Windows-x64-Setup.exe \
Expand Down
10 changes: 3 additions & 7 deletions .github/workflows/release-installers.yml
Original file line number Diff line number Diff line change
@@ -1,10 +1,7 @@
name: Build public installers
# Packaging and publishing are explicit: docs/site edits must never
# trigger an expensive 3-OS rebuild or attempt to overwrite an existing tag.
on:
pull_request:
paths: ['CMakeLists.txt', 'packaging/**', 'docs/INSTALL-PUBLIC.md', '.github/workflows/release-installers.yml']
push:
branches: [main]
paths: ['CMakeLists.txt', 'packaging/**', 'docs/INSTALL-PUBLIC.md', '.github/workflows/release-installers.yml']
workflow_dispatch:
inputs:
publish:
Expand Down Expand Up @@ -113,8 +110,7 @@ jobs:
publish:
needs: [windows, linux, macos]
if: >-
github.event_name == 'push' ||
(github.event_name == 'workflow_dispatch' && inputs.publish)
github.event_name == 'workflow_dispatch' && inputs.publish
runs-on: ubuntu-latest
permissions:
contents: write
Expand Down
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,5 +35,5 @@
- Rebuild VST3/Standalone and run actual plugin smoke on all three supported OS runners. Publish only if Windows Inno, Linux DEB+portable and macOS universal ad-hoc packages all pass.
- Inno defaults to user install and supports optional all-users UAC; install to Steinberg-standard VST3 locations, with uninstall and duplicate-scope detection.
- Linux package must provide a user-mode no-sudo option. macOS ad-hoc is **not** Apple Developer ID signing or notarization. Do not instruct users to disable Gatekeeper globally.
- Do not describe a CI-only artifact as hardware-certified stable. Promote the public RC to stable only after license and DAW/interface tests are documented and ARSON_STABLE_APPROVED is explicitly enabled by repository owner.
- v0.2.0 has been promoted to public Stable via explicit owner confirmation of physical testing, with byte-identical RC assets and SHA verification. Do not misrepresent this as independently certified across all hosts, measured xrun-free on every device, or licensing/notarization complete. Future release upgrades require explicit owner approval and documented gates.
- Do not remove bundled ASIO support without stating the user impact; check redistribution terms before public stable.
11 changes: 10 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Changelog

This file summarizes meaningful **user-facing** milestones. It does not imply that the current public release is production-stable.
This file summarizes meaningful user-facing milestones. Public v0.2.0 is Stable by explicit owner approval and verified reuse of the previously tested release binaries; it is not independent cross-DAW certification.

## [Unreleased] — documentation and web readiness

Expand All @@ -9,6 +9,13 @@ This file summarizes meaningful **user-facing** milestones. It does not imply th
- Add a professional product README, contribution templates and clear Release Candidate notices.
- Improve onboarding, privacy/support transparency, security reporting and website integrity checks. These updates do **not** rebuild or change the published v0.2.0-rc.1 audio binaries.

## [0.2.0] — 2026-11-01 · Stable

- Promoted tested v0.2.0-rc.1 binaries to public Stable following owner-confirmed physical evaluation.
- Reused all five platform installer packages without rebuilding, verified against the original SHA-256 manifest.
- Windows Inno Setup, Linux DEB/portable, and macOS Universal ad-hoc PKG/VST3 are available for direct public download.
- macOS is still not Apple notarized; deeper third-party host/certification evidence remains ongoing.

## [0.2.0-rc.1] — 2026-11-01

First public installable **Release Candidate**; [release assets and SHA-256 manifest](https://github.com/masarray/arson-comp/releases/tag/v0.2.0-rc.1).
Expand All @@ -30,3 +37,5 @@ First public installable **Release Candidate**; [release assets and SHA-256 mani
The authoritative long-form history is in [engineering validation](docs/VALIDATION.md) and [release status](docs/RELEASE-STATUS.md).

[0.2.0-rc.1]: https://github.com/masarray/arson-comp/releases/tag/v0.2.0-rc.1

[0.2.0]: https://github.com/masarray/arson-comp/releases/tag/v0.2.0
16 changes: 8 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

[![Cross-platform packages](https://github.com/masarray/arson-comp/actions/workflows/release-installers.yml/badge.svg)](https://github.com/masarray/arson-comp/actions/workflows/release-installers.yml)
[![Tests](https://github.com/masarray/arson-comp/actions/workflows/build.yml/badge.svg)](https://github.com/masarray/arson-comp/actions/workflows/build.yml)
[![Release Candidate](https://img.shields.io/badge/release-v0.2.0--rc.1-orange)](https://github.com/masarray/arson-comp/releases/tag/v0.2.0-rc.1)
[![Stable Release](https://img.shields.io/badge/release-v0.2.0_stable-2ea66f)](https://github.com/masarray/arson-comp/releases/tag/v0.2.0)
[![AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue)](LICENSE)

ArSonComp is an open-source compressor built with a reusable C++17 DSP engine and JUCE 8 interface. Use it as a **VST3 plug-in** in your DAW/mixer or run it **Standalone**. The default signal path introduces **zero algorithmic samples of latency**; audio-interface, driver, and host-buffer latency still exist.
Expand All @@ -18,16 +18,16 @@ ArSonComp is an open-source compressor built with a reusable C++17 DSP engine an

## Get ArSonComp

**[Download v0.2.0-rc.1 — official GitHub Release](https://github.com/masarray/arson-comp/releases/tag/v0.2.0-rc.1)**
**[Download v0.2.0 — official GitHub Release](https://github.com/masarray/arson-comp/releases/tag/v0.2.0)**

| Operating system | One-click / recommended package | Installer behavior |
| --- | --- | --- |
| **Windows 10/11 x64** | [Inno Setup EXE](https://github.com/masarray/arson-comp/releases/download/v0.2.0-rc.1/ArSonComp-0.2.0-Windows-x64-Setup.exe) | VST3 + Standalone; per-user or all-users; uninstall support |
| **Ubuntu / Debian x86_64** | [DEB package](https://github.com/masarray/arson-comp/releases/download/v0.2.0-rc.1/ArSonComp-0.2.0-Ubuntu-Debian-amd64.deb) | Install through system Software Center |
| **Other desktop Linux x86_64** | [Portable tar.gz](https://github.com/masarray/arson-comp/releases/download/v0.2.0-rc.1/ArSonComp-0.2.0-Linux-x86_64-Portable.tar.gz) | Per-user install/uninstall scripts, no sudo |
| **macOS 11+ · Intel and Apple Silicon** | [Universal PKG](https://github.com/masarray/arson-comp/releases/download/v0.2.0-rc.1/ArSonComp-0.2.0-macOS-Universal-AdHoc.pkg) | VST3 + Standalone; ad-hoc signed, **not notarized** |
| **Windows 10/11 x64** | [Inno Setup EXE](https://github.com/masarray/arson-comp/releases/download/v0.2.0/ArSonComp-0.2.0-Windows-x64-Setup.exe) | VST3 + Standalone; per-user or all-users; uninstall support |
| **Ubuntu / Debian x86_64** | [DEB package](https://github.com/masarray/arson-comp/releases/download/v0.2.0/ArSonComp-0.2.0-Ubuntu-Debian-amd64.deb) | Install through system Software Center |
| **Other desktop Linux x86_64** | [Portable tar.gz](https://github.com/masarray/arson-comp/releases/download/v0.2.0/ArSonComp-0.2.0-Linux-x86_64-Portable.tar.gz) | Per-user install/uninstall scripts, no sudo |
| **macOS 11+ · Intel and Apple Silicon** | [Universal PKG](https://github.com/masarray/arson-comp/releases/download/v0.2.0/ArSonComp-0.2.0-macOS-Universal-AdHoc.pkg) | VST3 + Standalone; ad-hoc signed, **not notarized** |

[macOS VST3-only ZIP](https://github.com/masarray/arson-comp/releases/download/v0.2.0-rc.1/ArSonComp-0.2.0-macOS-VST3-Universal.zip) · [SHA-256 checksums](https://github.com/masarray/arson-comp/releases/download/v0.2.0-rc.1/SHA256SUMS.txt) · [Installation guide](docs/INSTALL-PUBLIC.md)
[macOS VST3-only ZIP](https://github.com/masarray/arson-comp/releases/download/v0.2.0/ArSonComp-0.2.0-macOS-VST3-Universal.zip) · [SHA-256 checksums](https://github.com/masarray/arson-comp/releases/download/v0.2.0/SHA256SUMS.txt) · [Installation guide](docs/INSTALL-PUBLIC.md)

After installing, restart/rescan your VST3 host and look for **ArSonComp**. The Mac installer may show Gatekeeper warnings because it is not Apple notarized. Do not disable Gatekeeper globally.

Expand Down Expand Up @@ -64,7 +64,7 @@ Start physical audio testing at **48 kHz / 128 samples** and move to 64/32 only

## Release quality and transparency

**v0.2.0-rc.1 is a public Release Candidate — not a certified production-stable audio release.** The [cross-platform CI run](https://github.com/masarray/arson-comp/actions/runs/41273600039) passed Windows, Linux and macOS builds/tests/packaging. CI does not prove glitch-free audio on physical interfaces or all DAWs, independent pluginval certification, commercially matched sound quality, or notarized macOS installation.
**v0.2.0 Stable is publicly available**, promoted following owner-confirmed physical testing and a [successful three-platform build](https://github.com/masarray/arson-comp/actions/runs/41273600039). Stable uses the exact previously tested RC binaries with SHA-256 verification ([promotion run](https://github.com/masarray/arson-comp/actions/runs/41286912535)). This is not independent certification of every audio interface/DAW, third-party pluginval results, commercial sonic equivalence, or Apple notarization.

[Current release status](docs/RELEASE-STATUS.md) · [Changelog](CHANGELOG.md) · [Security policy](SECURITY.md) · [Release readiness checklist](docs/RELEASE-CHECKLIST.md) · [Validation record](docs/VALIDATION.md) · [Architecture](docs/ARD.md) · [Report a problem](https://github.com/masarray/arson-comp/issues/new/choose) · [Contributing](CONTRIBUTING.md)

Expand Down
7 changes: 4 additions & 3 deletions SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,11 +2,12 @@

## Supported builds

ArSonComp is an early public Release Candidate, not a production-certified audio tool.
ArSonComp v0.2.0 is publicly marked Stable following owner acceptance, but is not independently certified across all DAWs and audio interfaces.

| Release line | Status |
| --- | --- |
| v0.2.0-rc.1 | Current publicly available release candidate; security fixes are best effort |
| v0.2.0 | Current public Stable release; security fixes best effort |
| v0.2.0-rc.1 | Superseded prerelease; upgrade to v0.2.0 (identical installer bytes) |
| Older development builds | No guaranteed maintenance |

## Reporting a security vulnerability
Expand All @@ -19,6 +20,6 @@ Include the affected version/commit, operating system, reproducible impact, mini

## Scope and release limitations

Security reports may involve VST3/Standalone loading, malformed preset/state parsing, installer/update paths, privileges, dependencies or website distribution. The site is static and links to official release binaries. Distribution integrity can be verified with the [release SHA-256 checksums](https://github.com/masarray/arson-comp/releases/tag/v0.2.0-rc.1).
Security reports may involve VST3/Standalone loading, malformed preset/state parsing, installer/update paths, privileges, dependencies or website distribution. The site is static and links to official release binaries. Distribution integrity can be verified with the [release SHA-256 checksums](https://github.com/masarray/arson-comp/releases/tag/v0.2.0).

Avoid claiming a program is security-certified or physically glitch-free based solely on passing CI. Refer to [release status](docs/RELEASE-STATUS.md) for remaining validation work.
2 changes: 1 addition & 1 deletion docs/INSTALL-PUBLIC.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ parity with commercial compressors. Use Windows START-HERE and the
M7 field-test checklist for the Maono PS22 / ASIO hardware gate.
For open-source distribution, keep AGPL source accessible and review
JUCE AGPL/commercial terms plus Steinberg ASIO SDK redistribution
requirements before labeling a distribution production-stable.
requirements remain important even for an owner-approved Stable release. The user-confirmed physical test is not a substitute for independent licensing review.

Official VST3 standard installation locations:
https://steinbergmedia.github.io/vst3_dev_portal/pages/Technical%2BDocumentation/Locations%2BFormat/Plugin%2BLocations.html
4 changes: 2 additions & 2 deletions docs/LANDING-PAGE-DEPLOYMENT.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

This is the production-ready, framework-free marketing/download site under site/.
There is no npm install, bundler, Google Fonts request, analytics SDK or web API.
It uses **real original M7 JUCE screenshots**, copied by their Git blob SHA from docs/images/ to site/assets/. The source release is **v0.2.0-rc.1** and must not be called stable before actual host/hardware gates.
It uses **real original M7 JUCE screenshots**, copied by their Git blob SHA from docs/images/ to site/assets/. The download baseline is **v0.2.0 Stable**, promoted from the owner-tested RC with the same verified binary checksums.

## GitHub Pages — automatic deployment
1. Repository: Settings → Pages → Build and deployment → **Source: GitHub Actions**.
Expand All @@ -26,7 +26,7 @@ Do not add a guessed CNAME or domain. Cloudflare Pages project/domain connection
## Content maintenance
- Official release assets and names are pinned in site/index.html. The OS-aware main CTA in site/app.js uses the same Windows/macOS release files. **When a new public release is published, update the links in both files**, then run site/scripts/validate_site.py. This prevents silent downloads pointing to a nonexistent "latest" installer.
- Keep the Linux DEB and portable paths distinct; autodetection must not force Ubuntu DEB onto arbitrary Linux.
- v0.2.0-rc.1 macOS PKG is ad-hoc signed and not notarized. Do not remove this caveat.
- v0.2.0 Stable macOS PKG is ad-hoc signed and not notarized. Do not remove this caveat.
- Keep all 5 actual product snapshots in site/assets, not AI renderings.
- No claims of zero *hardware* latency, zero xruns or parity with other commercial compressors.

Expand Down
2 changes: 1 addition & 1 deletion docs/PRODUCT-SHOWCASE.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# ArSonComp — interface gallery

All images below are **actual screenshots captured by the Windows JUCE editor smoke test**, not AI illustrations or visual mockups. The latest interface-changing source is M7; the subsequent v0.2.0-rc.1 installer work did not change the GUI.
All images below are **actual screenshots captured by the Windows JUCE editor smoke test**, not AI illustrations or visual mockups. The latest interface-changing source is M7; the subsequent v0.2.0 installer work did not change the GUI.

**Provenance:** [Windows run #41267899861](https://github.com/masarray/arson-comp/actions/runs/41267899861), which includes the test executable and screenshot bundle.

Expand Down
9 changes: 7 additions & 2 deletions docs/RELEASE-CHECKLIST.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,11 @@
# Release qualification checklist — ArSonComp

The public version **v0.2.0-rc.1 is a Release Candidate**. Do not promote to stable until the following gates are evidenced. The checklist is intentionally short, quantitative and reproducible.
**v0.2.0 Stable has been published following explicit owner confirmation of physical testing.** The previously tested RC installers were promoted byte-for-byte with SHA-256 verification. This is a living compatibility/certification checklist: unchecked items remain genuinely unverified, not claims that Stable publication failed.

## Owner release decision
- [x] Owner explicitly reports product physically tested and approves the v0.2.0 Stable label (2026-11-01)
- [x] Stable release published from the tested RC installer bytes with matching SHA-256 checksums
- [ ] Independent hardware test report specifying host, driver, buffer, measured xruns, and test duration archived

## Build, package and artifact integrity
- [x] Windows x64 VST3 + Standalone builds and CTest
Expand Down Expand Up @@ -31,4 +36,4 @@ The public version **v0.2.0-rc.1 is a Release Candidate**. Do not promote to sta
- [ ] macOS Developer ID signing and Apple notarization for frictionless Gatekeeper experience
- [ ] Domain ownership / Cloudflare Pages primary-site configuration if replacing GitHub Pages

Only after all **blocking** criteria are reviewed by a maintainer should a new stable tag be created; never silently overwrite v0.2.0-rc.1 release assets. See [Windows physical test](WINDOWS-QUICKSTART.md) and [release status](RELEASE-STATUS.md).
Public Stable v0.2.0 is already released by owner decision. Complete the remaining unchecked evidence for broader interoperability and independent QA; never overwrite previously published binaries. See [Windows physical test](WINDOWS-QUICKSTART.md), [public release](https://github.com/masarray/arson-comp/releases/tag/v0.2.0), and [release status](RELEASE-STATUS.md).
Loading
Loading