Release v1.2.0

.github/workflows/ci.yml

@@ -22,6 +22,20 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+  clang-format:
+    name: clang-format
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install clang-format
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y clang-format
+      - name: Check formatting
+        run: |
+          git ls-files -z -- '*.h' '*.hpp' '*.c' '*.cpp' ':!:third_party/**' |
+            xargs -0 clang-format --dry-run --Werror
+
   lint:
     runs-on: ubuntu-latest
     defaults:
@@ -40,6 +54,61 @@ jobs:
       - run: yarn lint
 
   build-and-test:
+    name: Native C++ (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install Linux dependencies
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y cmake build-essential libeigen3-dev
+      - name: Configure
+        run: cmake -B build -DCMAKE_BUILD_TYPE=Debug -DBUILD_TESTING=ON -DBUILD_CLI=OFF -DSONARE_WITH_FFMPEG=OFF
+      - name: Build
+        run: cmake --build build --parallel
+      - name: Test
+        run: ctest --test-dir build --output-on-failure --parallel
+
+  sanitizer:
+    name: ASan/UBSan (ubuntu-latest)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y cmake clang build-essential libeigen3-dev
+      - name: Configure with sanitizers
+        env:
+          CC: clang
+          CXX: clang++
+        run: |
+          cmake -B build-sanitize \
+            -DCMAKE_BUILD_TYPE=Debug \
+            -DBUILD_TESTING=ON \
+            -DBUILD_CLI=OFF \
+            -DSONARE_WITH_FFMPEG=OFF \
+            -DCMAKE_C_FLAGS="-fsanitize=address,undefined -fno-omit-frame-pointer" \
+            -DCMAKE_CXX_FLAGS="-fsanitize=address,undefined -fno-omit-frame-pointer" \
+            -DCMAKE_EXE_LINKER_FLAGS="-fsanitize=address,undefined" \
+            -DCMAKE_SHARED_LINKER_FLAGS="-fsanitize=address,undefined"
+      - name: Build
+        run: cmake --build build-sanitize --parallel
+      - name: Test
+        env:
+          ASAN_OPTIONS: detect_leaks=1:strict_string_checks=1
+          UBSAN_OPTIONS: print_stacktrace=1
+        run: ctest --test-dir build-sanitize --output-on-failure --parallel
+      # Windows is intentionally excluded: MSVC sanitizer coverage differs from
+      # Clang/GCC ASan+UBSan and would make this gate inconsistent across OSes.
+
+  coverage-wasm:
+    name: Coverage + WASM
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -101,6 +170,30 @@ jobs:
       - name: Run C++ tests
         run: ctest --test-dir build --output-on-failure --parallel
 
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Audit optional fixture manifests
+        run: |
+          python -m py_compile \
+            tests/fixtures/json_safe.py \
+            tests/fixtures/audit_manifests.py \
+            tests/fixtures/run_optional_fixture_report.py \
+            tests/fixtures/evaluate_optional_fixture_targets.py \
+            tests/fixtures/compare_optional_fixture_reports.py
+          python tests/fixtures/audit_manifests.py
+      - name: Type-check Python stubs
+        working-directory: bindings/python
+        run: |
+          python -m pip install -e . mypy
+          python -m mypy --strict ../../tests/typing/python_smoke.py
+
+      - name: Type-check Node preset literals
+        working-directory: bindings/node
+        run: |
+          yarn install --immutable
+          yarn tsc --noEmit --ignoreConfig --strict --module NodeNext --moduleResolution NodeNext --target ES2022 --types node ../../tests/typing/node_smoke.ts
+
       - name: Generate coverage report
         run: |
           mkdir -p build/coverage
@@ -125,3 +218,44 @@ jobs:
       - name: Test WASM binding
         working-directory: bindings/wasm
         run: yarn test
+      - name: Report WASM size
+        run: |
+          mkdir -p build/reports
+          baseline_args=()
+          if [ -n "${WASM_BASELINE:-}" ]; then
+            baseline_args=(--wasm-baseline "$WASM_BASELINE")
+          fi
+          python tests/fixtures/run_optional_fixture_report.py \
+            --suite music \
+            --sonare-tests build/bin/sonare_tests \
+            --include-wasm-size \
+            --wasm-current bindings/wasm/dist/sonare.wasm \
+            "${baseline_args[@]}" \
+            --output build/reports/wasm-size-report.json
+          python - <<'PY'
+          import json
+          from pathlib import Path
+
+          report = json.loads(Path("build/reports/wasm-size-report.json").read_text())
+          observations = [
+              item
+              for run in report["runs"]
+              for item in run.get("observations", [])
+              if item.get("metric") == "wasm_size"
+          ]
+          if len(observations) != 1:
+              raise SystemExit("expected exactly one wasm_size observation")
+          print(json.dumps(observations[0], sort_keys=True))
+          PY
+          if [ -n "${WASM_BASELINE:-}" ]; then
+            python tests/fixtures/evaluate_optional_fixture_targets.py \
+              build/reports/wasm-size-report.json \
+              --metrics wasm_size \
+              --require-metrics \
+              --output build/reports/wasm-size-evaluation.json
+          fi
+      - name: Upload WASM size report
+        uses: actions/upload-artifact@v4
+        with:
+          name: wasm-size-report
+          path: build/reports/wasm-size-*.json

.github/workflows/develop-ci.yml

@@ -0,0 +1,74 @@
+name: Develop CI
+
+# Fast feedback for day-to-day work on develop: formatting, linting, and a
+# single-platform (Linux/Debug) build + test. The heavy, thorough validation
+# (multi-OS native, ASan/UBSan, coverage, WASM) runs as the pre-release gate in
+# ci.yml on pull requests to main and pushes to main.
+on:
+  push:
+    branches: [develop]
+    tags-ignore: ['**']
+    paths-ignore:
+      - '**.md'
+      - 'docs/**'
+      - 'LICENSE'
+      - 'NOTICE'
+  pull_request:
+    branches: [develop]
+    paths-ignore:
+      - '**.md'
+      - 'docs/**'
+      - 'LICENSE'
+      - 'NOTICE'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  clang-format:
+    name: clang-format
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install clang-format
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y clang-format
+      - name: Check formatting
+        run: |
+          git ls-files -z -- '*.h' '*.hpp' '*.c' '*.cpp' ':!:third_party/**' |
+            xargs -0 clang-format --dry-run --Werror
+
+  lint:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: bindings/wasm
+    steps:
+      - uses: actions/checkout@v4
+      - run: corepack enable
+        working-directory: .
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: yarn
+          cache-dependency-path: bindings/wasm/yarn.lock
+      - run: yarn install --immutable
+      - run: yarn lint
+
+  build-and-test:
+    name: Native C++ (ubuntu-latest)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install Linux dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y cmake build-essential libeigen3-dev
+      - name: Configure
+        run: cmake -B build -DCMAKE_BUILD_TYPE=Debug -DBUILD_TESTING=ON -DBUILD_CLI=OFF -DSONARE_WITH_FFMPEG=OFF
+      - name: Build
+        run: cmake --build build --parallel
+      - name: Test
+        run: ctest --test-dir build --output-on-failure --parallel

.github/workflows/publish.yml

@@ -41,7 +41,7 @@ jobs:
         run: |
           cmake -B build -DCMAKE_BUILD_TYPE=Debug -DBUILD_TESTING=ON
           cmake --build build --parallel
-          ctest --test-dir build --output-on-failure
+          ctest --test-dir build --output-on-failure --parallel
 
       - name: Install Node deps (WASM binding)
         working-directory: bindings/wasm

.gitignore

@@ -45,6 +45,9 @@ backup/
 *.flac
 *.mp3
 *.ogg
+*.m4a
+*.aac
+*.jams
 
 # Test outputs (CMake CTest output directory)
 /Testing/
@@ -56,6 +59,27 @@ output.json
 output.mid
 analysis.json
 
+# Optional external fixture data and local-only fixture workflows
+tests/fixtures/local/
+tests/fixtures/local_eval/
+tests/fixtures/reports/
+tests/fixtures/music_eval/FSL10K/
+tests/fixtures/music_eval/annotation/
+tests/fixtures/music_eval/annotations/
+tests/fixtures/music_eval/audio/
+tests/fixtures/music_eval/audio_*/
+tests/fixtures/music_eval/babyslakh*/
+tests/fixtures/music_eval/slakh/
+tests/fixtures/music_eval/Slakh*/
+tests/fixtures/music_eval/Flakh*/
+tests/fixtures/music_eval/guitarset_annotations/
+tests/fixtures/music_eval/midi_annotations/
+tests/fixtures/music_eval/local_annotations/
+tests/fixtures/**/*.tar.gz
+tests/fixtures/**/*.zip
+tests/fixtures/**/*.pdf
+tests/fixtures/**/*.json
+
 # Binaries (in build directory only)
 /build
 *.exe

CHANGELOG.md

@@ -0,0 +1,66 @@
+# Changelog
+
+## Unreleased
+
+## v1.2.0 (2026-05-26)
+
+### Mixing engine
+
+- Added the mixing engine surface: channel strips, pan modes, width controls,
+  sends, FX buses, goniometer/true-peak metering, JSON scene presets, and
+  offline stereo rendering.
+- Added channel-strip input trim, insert gain scale/output gain/pan controls,
+  external sidechain parameters, bus insert hosting, graph PDC, and scene-loaded
+  persistent mixer APIs.
+- Added hold and s-curve automation shapes plus per-target insert/send lanes.
+- Added automation lanes, scene/preset API, and an AudioWorklet bridge.
+- Added a native mixing benchmark target and expanded CI coverage for macOS and
+  Windows native builds.
+- Added mixing QA coverage for golden hashes, no-allocation process checks,
+  graph routing/PDC integration, meter/goniometer snapshots, and CLI/binding
+  smoke tests.
+
+### Mastering engine
+
+- Added a monitor bus output with automation telemetry diagnostics and
+  sample-accurate, bind-feedback automation routing.
+- Made the dynamics processors real-time-safe via channel pre-allocation, with a
+  centralised channel preallocation limit.
+- Resolved loudness targets per streaming platform and honoured platform
+  normalisation.
+- Registered ducking and loudnessOptimize processors and added a de-esser
+  bandpass Q with stereo preservation.
+- Added assistant/profile/streaming-preview JSON output and a configurable
+  speech mono-maker amount.
+
+### Analysis & features
+
+- Added a cosine-similarity mode to the tempogram.
+- Derived streaming-retune grain size from the sample rate.
+- Improved DSP correctness for iSTFT windowing, chroma folding, K-weighting,
+  spectral/VQT/iirt/melody/CQT features, and percentile interpolation (now
+  matching NumPy's linear interpolation).
+
+### Bindings & API
+
+- Exposed mixing presets and rendering through C, Python, Node, WASM, and CLI
+  APIs.
+- Exposed mastering assistant/profile/preview, ducking, streaming chord/pattern
+  progression, stream window/output-format config, and inverse Mel/MFCC
+  reconstruction across the C, Node, and WASM bindings.
+
+### Fixes
+
+- Preserved per-channel mastering state on channel-count change and tightened
+  config validation.
+- Made engine counters and smoothing atomic and excluded shared strips.
+- Fixed exact cumulative sample counting and bounded chroma history in the
+  streaming analyzer.
+- Dropped the spurious sidechain reset in the Node streaming equalizer.
+
+### Internal
+
+- Centralised numeric constants in `util/constants.h` and routed IIR,
+  crossover, and mastering filters through shared biquad/loudness helpers.
+- Fixed the stale `SONARE_VERSION_*` macros in `sonare.h` so the runtime
+  `version()` reports the correct value.