# 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
```powershell
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`):
```powershell
# 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
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/`
```powershell
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)
```powershell
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
```powershell
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.