SonicForgeStudio/TASKS_WINDOWS_AUDIO_NORMALIZE.md

TASKS WINDOWS — Chuẩn hóa luồng audio lossless (SonicForgeStudio)

Branch: standalone-shm-bridge — Pull code mới nhất trước khi làm.

Bối cảnh

Linux đã hoàn tất chuẩn hóa luồng audio theo skill lossless-audio-compliance (Float32 nội bộ, WAV IEEE Float32 khi render/export, TPDF dither chỉ ở bước lượng tử cuối, resample Kaiser ≥130dB, null-test gate). Code C++/Python/JS đã sửa trên Linux và commit sẵn — phần còn lại trên Windows chỉ là BUILD lại binary, COPY vào install/, VERIFY, COMMIT.

Đã sửa (kèm theo branch này)

File	Thay đổi
native_bridge/src/RenderJob.cpp, RenderFxJob.cpp	WAV writer: 16-bit PCM (truncate, không dither) → IEEE Float32 (format 3, 32-bit)
app/core/render_engine.py, app/api/v1/audio.py, app/api/v1/plugins.py	sf.write(...) → subtype="FLOAT" (4 chỗ)
app/core/audio_features.py, app/core/render_engine.py	resample_poly → window=("kaiser", 16) (stopband ≥130dB)
app/static/js/app.jsx + app.precompiled.js (đã build trên Linux)	Encoder client → Float32 mặc định; TPDF dither cho 16/24/8-bit; sửa bug 24-bit ghi nhầm 8-bit; UI thêm "32 float"
app/templates/index.html	bump cache ?v=20260818
tests/test_lossless_compliance.py (mới)	Null-test gate (Rule 6) + assert float32 WAV (Rule 7) + bridge render deterministic
native_bridge/tests/test_offline_render.py	read_wav hiểu cả IEEE float32 lẫn PCM 16-bit
Dockerfile	fix git clone --branch v1.2.3 (tag không tồn tại) → clone default

Tasks trên Windows (theo thứ tự)

1. Pull code mới nhất

cd C:\Users\locpham\SonicForgeStudio
git checkout standalone-shm-bridge
git pull origin standalone-shm-bridge

2. Build lại daw_vst_bridge.exe (WAV writer float32)

Bridge build bằng CMake + vcpkg (fluidsynth) + sfizz-src (xem native_bridge/CMakeLists.txt, build/_sfizz.bat):

# sfizz từ source nếu chưa có (native_bridge/sfizz-src)
# vcpkg install fluidsynth
cmake -S native_bridge -B build/bridge-win -DCMAKE_BUILD_TYPE=Release `
  -DCMAKE_TOOLCHAIN_FILE=<vcpkg-root>\scripts\buildsystems\vcpkg.cmake
cmake --build build/bridge-win --target daw_vst_bridge --config Release
Copy-Item build/bridge-win/Release/daw_vst_bridge.exe install/daw_vst_bridge.exe -Force

Nếu có script build sẵn dùng script đó; bắt buộc copy đè install/daw_vst_bridge.exe.

3. Build lại engine + app (build_windows.ps1)

powershell -ExecutionPolicy Bypass -File build_windows.ps1

(Lưu ý: app.precompiled.js đã build sẵn trên Linux — bước [2/6] chỉ cần chạy lại nếu bạn sửa app.jsx.)

4. Copy binary mới vào install/

Copy-Item src-tauri\target\release\sonicforge-daw.exe install\sonicforge-daw.exe -Force
# hoặc từ NSIS/MSI output tùy quy trình hiện tại

5. Verify (null-test gate + định dạng float32)

python tests\test_lossless_compliance.py
python native_bridge\tests\test_offline_render.py

Kỳ vọng:

• bridge output IEEE float32 (tag 3) PASS — WAV render ra format 3, 32-bit
• bridge render deterministic (byte-identical) PASS
• null test ... bit-exact PASS
• test_offline_render.py 3 test đầu PASS với read_wav mới

6. Commit + push

git add install/daw_vst_bridge.exe install/sonicforge-daw.exe
git commit -m "feat(audio): lossless float32 WAV render/export (bridge + engine) — chuẩn hóa luồng audio"
git push origin standalone-shm-bridge

Lưu ý

• Không đổi lại WAV writer sang 16-bit: render nội bộ phải là IEEE Float32 (skill Rule 4/7); dither TPDF chỉ áp dụng ở bước export cuối (client 16/24-bit).
• install/daw_vst_bridge (ELF Linux) không commit — chỉ commit .exe.
• Nếu sonicforge-daw.exe bundle cũ vẫn dùng app.precompiled.js cũ: xóa cache trình duyệt / dùng ?v= mới đã bump.