release: prepare v4.0.3 with tray startup, limiter brickwall, and docs

Author: LiveTrack-X

.github/workflows/build.yml

@@ -16,10 +16,24 @@ env:
   BUILD_TYPE: Release
 
 jobs:
+  text-integrity:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.x"
+
+      - name: Check UTF-8 text integrity
+        run: python tools/check_text_integrity.py --repo-root .
   # ═══════════════════════════════════════════
   # Windows — DirectPipe.exe + Receiver VST2/VST3
   # ═══════════════════════════════════════════
   build-windows:
+    needs: [text-integrity]
     runs-on: windows-latest
     timeout-minutes: 45
 
@@ -100,6 +114,7 @@ jobs:
   # macOS — DirectPipe.app + Receiver VST2/VST3/AU (Universal Binary)
   # ═══════════════════════════════════════════
   build-macos:
+    needs: [text-integrity]
     runs-on: macos-14
     timeout-minutes: 45
 
@@ -174,6 +189,7 @@ jobs:
   # Linux — DirectPipe + Receiver VST2/VST3
   # ═══════════════════════════════════════════
   build-linux:
+    needs: [text-integrity]
     runs-on: ubuntu-24.04
     timeout-minutes: 45
 
@@ -248,6 +264,7 @@ jobs:
   # Stream Deck Plugin — cross-platform Node.js package
   # ═══════════════════════════════════════════
   build-streamdeck:
+    needs: [text-integrity]
     runs-on: ubuntu-latest
     timeout-minutes: 15
 

CHANGELOG.md

@@ -1,14 +1,25 @@
 # Changelog
 
-All notable changes to DirectPipe will be documented in this file.
+Major notable changes to DirectPipe (maintained in this repository era, including v3.4.0+) are documented in this file.
 
 ---
 
 ## [Unreleased]
 
+---
+
+## [4.0.3] - 2026-03-22
+
+### Added
+- **Startup behavior option (tray launch)**: Added `Start Minimized to Tray` toggle to both Settings > Application and tray right-click menu, backed by `settings.dppreset` persistence so both entry points stay in sync.
+
 ### Changed
 - **Auto-start label (cross-platform UI consistency)**: Unified tray menu and Settings toggle to use a single platform label source via `Platform::getAutoStartLabel()` (`Open at Login` on macOS, `Start with System` on others), removing Windows-specific hardcoded wording from the Settings toggle path.
 
+### Fixed
+- **Safety Limiter brickwall behavior (v4)**: Reworked limiter to look-ahead brickwall style (2ms look-ahead, instant attack, release smoothing) and added a hard per-sample ceiling clamp so output does not exceed configured ceiling on fast transients.
+- **ASIO channel selection reset on driver/device switch**: Preserved per-driver input/output channel masks in `DriverTypeSnapshot` and restored them during driver type changes. ASIO device reselection now keeps existing channel routing instead of always resetting to channels 1-2.
+
 ---
 
 ## [4.0.2] - 2026-03-19

CMakeLists.txt

@@ -1,5 +1,5 @@
 cmake_minimum_required(VERSION 3.22)
-project(DirectPipe VERSION 4.0.2 LANGUAGES C CXX)
+project(DirectPipe VERSION 4.0.3 LANGUAGES C CXX)
 
 set(CMAKE_CXX_STANDARD 17)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)

CONTRIBUTING.md

@@ -21,16 +21,18 @@ DirectPipe에 기여해 주셔서 감사합니다! / Thank you for contributing
 2. 커밋 메시지: `type: description` 형식 (예: `feat:`, `fix:`, `docs:`, `refactor:`, `test:`) / Commit message format: `type: description`
 3. 테스트 통과 확인 / Verify tests pass:
    ```bash
+   cmake -B build -DCMAKE_BUILD_TYPE=Release
    cmake --build build --config Release
    ctest --test-dir build -C Release --output-on-failure
    ```
-4. 새 Action 추가 시 테스트/문서 동기화 체크리스트를 함께 갱신하세요 (`TESTING.md`, `docs/ReleaseNote.md`) / When adding new Actions, update test/doc sync checklists (`TESTING.md`, `docs/ReleaseNote.md`)
-5. 문서 업데이트도 포함해 주세요 (해당 시) / Include documentation updates when applicable
+4. Action/API/상태 모델 변경 시 동기화 문서를 함께 갱신하세요 (`README.md`, `docs/USER_GUIDE.md`, `docs/PRODUCT_SPEC.md`, `docs/CONTROL_API.md`, `docs/ReleaseNote.md`, `TESTING.md`) / When changing Action/API/state model behavior, update sync docs (`README.md`, `docs/USER_GUIDE.md`, `docs/PRODUCT_SPEC.md`, `docs/CONTROL_API.md`, `docs/ReleaseNote.md`, `TESTING.md`)
+5. 유지보수 기준 문서인 `docs/MAINTENANCE_RULES.md`의 Behavior Sync Checklist를 기준으로 검토하세요 / Use `docs/MAINTENANCE_RULES.md` Behavior Sync Checklist as source of truth
+6. 문서 업데이트도 포함해 주세요 (해당 시) / Include documentation updates when applicable
 
 ## 테스트 / Testing
 
 - Google Test 기반 295 테스트 / 295 tests
-- `tools/pre-release-test.sh` — 빌드 + 단위 테스트 + API 테스트 / Build + unit tests + API tests
+- `tools/pre-release-test.sh` — 빌드 + 단위 테스트 + API 테스트 / Build + unit tests + API tests (Windows Git Bash 환경 기준)
 - `tools/pre-release-dashboard.html` — 수동 테스트 대시보드 / Manual test dashboard
 
 ## 버그 리포트 / Bug Reports

README.md

@@ -4,7 +4,7 @@
 
 <p align="center">
   <img src="https://img.shields.io/badge/platform-Windows%20|%20macOS%20|%20Linux-0078d4?style=flat-square" alt="Platform">
-  <img src="https://img.shields.io/badge/latest-v4.0.2-4fc3f7?style=flat-square" alt="Latest">
+  <img src="https://img.shields.io/badge/latest-v4.0.3-4fc3f7?style=flat-square" alt="Latest">
   <img src="https://img.shields.io/badge/C%2B%2B17-JUCE%207-00599C?style=flat-square&logo=cplusplus" alt="C++17">
   <img src="https://img.shields.io/badge/license-GPL--3.0-green?style=flat-square" alt="License">
   <img src="https://img.shields.io/badge/VST2%20%2B%20VST3%20%2B%20AU-supported-ff6f00?style=flat-square" alt="VST">
@@ -21,7 +21,7 @@
 
 ## 다운로드 / Download
 
-- **Latest (최신)**: [v4.0.2 다운로드](https://github.com/LiveTrack-X/DirectPipe/releases/latest) — 크로스 플랫폼 / Cross-platform (Windows stable, macOS beta, Linux experimental)
+- **Latest (최신)**: [v4.0.3 다운로드](https://github.com/LiveTrack-X/DirectPipe/releases/latest) — 크로스 플랫폼 / Cross-platform (Windows stable, macOS beta, Linux experimental)
 
 > **참고**: Windows는 안정(Stable), macOS는 베타, Linux는 실험적입니다. macOS/Linux 빌드는 실기기 테스트가 제한적입니다.
 > **Note**: Windows is stable, macOS is beta, Linux is experimental. macOS/Linux builds have limited real-hardware testing.

SECURITY.md

@@ -39,14 +39,18 @@ All network services bind to **localhost (127.0.0.1) only**. No remote access is
 
 | 서비스 / Service | 포트 / Port | 프로토콜 / Protocol | 용도 / Purpose |
 |---|---|---|---|
-| WebSocket | 8765 | TCP | 실시간 상태 브로드캐스트 + 명령 수신 / Real-time state broadcast + command input |
-| HTTP REST API | 8766 | TCP | GET-only REST API (상태 조회, 명령 실행) / Status query, command execution |
+| WebSocket | 기본 8765 (설정값 실패 시 +1..+5 포트 자동 시도) / default 8765 (auto-tries +1..+5 on bind failure) | TCP | 실시간 상태 브로드캐스트 + 명령 수신 / Real-time state broadcast + command input |
+| HTTP REST API | 기본 8766 (설정값 실패 시 +1..+5 포트 자동 시도) / default 8766 (auto-tries +1..+5 on bind failure) | TCP | GET-only REST API (상태 조회, 명령 실행) / Status query, command execution |
 | UDP Discovery | 8767 | UDP | Stream Deck 플러그인 자동 감지 / Stream Deck plugin auto-discovery |
 
 **인증 없음 (No Authentication)**: localhost 전용이므로 인증을 요구하지 않습니다. 같은 PC의 모든 프로세스가 접근 가능합니다.
 
 **No authentication**: Since services are localhost-only, no auth is required. Any process on the same machine can access them.
 
+**알려진 제한사항 (WebSocket)**: 핸드셰이크에서 Origin 검증이나 토큰 인증을 수행하지 않습니다. localhost에서 접속 가능한 로컬 프로세스는 모두 명령 전송이 가능합니다.
+
+**Known limitation (WebSocket)**: The handshake does not enforce Origin validation or token auth. Any local process that can connect to localhost can send commands.
+
 **연결 제한 / Connection Limits**:
 - WebSocket: 최대 32개 동시 연결 (초과 시 거부) / Max 32 concurrent connections (excess rejected)
 - HTTP: 최대 64개 동시 핸들러 (초과 시 거부) / Max 64 concurrent handlers (excess rejected). HTTP는 Connection: close 방식이므로 각 요청이 수 ms 내에 완료됨 / HTTP uses Connection: close, each request completes in milliseconds
@@ -124,8 +128,16 @@ The auto-updater checks the GitHub Releases API for new versions and downloads b
 
 ### 설정 백업 보안 / Settings Backup Security
 
-- **크로스 OS 보호**: 백업 파일에 플랫폼 정보가 포함되어 있으며, 다른 OS에서 복원 시 차단됩니다
+- **크로스 OS 보호**: `platform` 필드가 포함된 백업은 다른 OS에서 복원 시 차단됩니다. 단, **레거시 백업(플랫폼 필드 없음)은 호환성 때문에 허용될 수 있습니다**
 - **파일 무결성**: 모든 설정/프리셋 저장은 `atomicWriteFile()` 패턴 (.tmp → .bak → rename)을 사용하여 전원 중단 시에도 파일이 손상되지 않습니다
 
-- **Cross-OS protection**: Backup files include platform info; restore is blocked on different OS
+- **Cross-OS protection**: Backups with a `platform` field are blocked on different OS. **Legacy backups without a platform field may still be accepted for backward compatibility**
 - **File integrity**: All settings/preset saves use `atomicWriteFile()` pattern (.tmp → .bak → rename) for crash-safe writes
+
+### 로그 보안 주의 / Logging Security Note
+
+- Audit Mode를 켜면 HTTP 응답 일부, WebSocket payload, 장치/플러그인 상세 상태가 로그에 더 많이 기록됩니다.
+- 공유 PC/공개 스트리밍 환경에서는 로그 파일 공유 전에 민감 정보를 검토/마스킹하세요.
+
+- With Audit Mode enabled, logs may include extra HTTP response excerpts, WebSocket payloads, and detailed device/plugin state.
+- In shared PCs or public support channels, review/mask sensitive parts before sharing logs.

TESTING.md

@@ -18,13 +18,13 @@ bash tools/pre-release-test.sh
 - API integration tests (앱 실행 중일 때)
 - Git status check
 
-옵션: `--skip-build`, `--skip-api`, `--version-only`
+옵션: `--skip-build`, `--skip-api`, `--api-only`, `--version-only`
 
 ### Step 2: GUI 대시보드 + AI 코드 리뷰
 
 **GUI 대시보드** — 브라우저에서 `tools/pre-release-dashboard.html` 열기:
-- API 자동 테스트 25개 (pre-release-dashboard.html 기준; test_api.js는 114개 체크 포함) / 25 auto API tests (from pre-release-dashboard.html; test_api.js contains 114 checks)
-- 수동 테스트 체크리스트 29개 (대시보드 체크박스; 전체 수동 테스트 목록은 하단 참조)
+- API 자동 테스트와 수동 체크리스트를 실행/기록 (개수는 대시보드 버전 및 테스트 스크립트 업데이트에 따라 달라질 수 있음) / Run and track API auto tests + manual checklist (counts may change with dashboard/script updates)
+- 현재 기준 개수는 대시보드 상단/섹션별 카운터를 우선 확인 / For current counts, trust dashboard counters first
 - 결과 JSON 내보내기 (Export Report → Claude에 전달 가능)
 - localStorage에 체크 상태 저장
 
@@ -67,7 +67,7 @@ node test_api.js
 
 ### 동작 방식
 1. 시작 시 현재 상태(볼륨, 슬롯, 뮤트, IPC, 바이패스 등) 스냅샷 저장
-2. 33개 섹션, 114개 체크 항목 순차 실행
+2. 섹션별 체크 항목을 순차 실행 (현재 `test_api.js` 기준 약 33개 섹션, 114개 체크)
 3. 테스트 완료 또는 에러 시 자동으로 원래 상태 복원 (`try/finally`)
 
 ### 테스트 섹션 (33개)
@@ -107,6 +107,10 @@ node test_api.js
 | 32 | Volume Precision | 2 |
 | 33 | Panic During Operations | 3 |
 
+> 참고: 위 숫자는 문서 작성 시점 기준입니다. 실제 실행에서는 환경(플러그인 유무, 장치 상태, SKIP 조건, 반복 실행 횟수)에 따라 PASS/SKIP 수치가 달라질 수 있습니다.
+>
+> Note: The numbers above reflect the document snapshot. Actual PASS/SKIP counts may vary by environment (plugin availability, device state, skip conditions, rerun loops).
+
 ### 주의사항
 - 플러그인이 로드된 상태(슬롯 A에 플러그인 있음)에서 실행해야 모든 항목이 PASS
 - 플러그인 없으면 관련 항목 SKIP 처리

THIRD_PARTY.md

@@ -1,9 +1,55 @@
-# Third-Party Licenses
+# Third-Party Licenses / 서드파티 라이선스
 
-## RNNoise — Noise Suppression
+DirectPipe에서 사용하는 주요 서드파티 구성요소와 라이선스 정보입니다.
+This document lists major third-party components used by DirectPipe and their licenses.
+
+## 1) Core/Host Build Dependencies
+
+### JUCE
+- **License**: GPL-3.0-or-later (DirectPipe is GPL-3.0)
+- **Source**: <https://github.com/juce-framework/JUCE>
+- **Version**: `7.0.12` (fetched by CMake FetchContent)
+- **Usage**: Host app UI/audio framework, plugin hosting, receiver plugin framework
+
+### GoogleTest
 - **License**: BSD-3-Clause
-- **Source**: https://github.com/xiph/rnnoise
-- **Usage**: Built-in noise removal processor (BuiltinNoiseRemoval)
+- **Source**: <https://github.com/google/googletest>
+- **Version**: `v1.14.0` (fetched by CMake FetchContent)
+- **Usage**: Unit/integration test framework
+
+### RNNoise
+- **License**: BSD-3-Clause
+- **Source**: <https://github.com/xiph/rnnoise>
+- **Usage**: Built-in Noise Removal processor (`BuiltinNoiseRemoval`)
 - **Files**: `thirdparty/rnnoise/`
+- **License text**: `thirdparty/rnnoise/COPYING`
+
+## 2) Optional SDKs (User-Provided)
+
+### Steinberg VST2 SDK (optional)
+- **License**: Steinberg VST2 license terms
+- **Source**: User-provided in `thirdparty/VST2_SDK/`
+- **Usage**: VST2 hosting + Receiver VST2 format build
+- **Note**: Not redistributed in this repository due licensing restrictions
+
+### Steinberg ASIO SDK (optional, Windows)
+- **License**: Steinberg ASIO SDK license terms
+- **Source**: User-provided in `thirdparty/asiosdk/`
+- **Usage**: ASIO driver support in host app
+- **Note**: Not redistributed in this repository
+
+## 3) Stream Deck Plugin (Node.js)
+
+Path: `com.directpipe.directpipe.sdPlugin/`
+
+### Runtime dependencies
+- `@elgato/streamdeck` (`^2.0.1`) — Elgato Stream Deck SDK bindings
+- `ws` (`^8.16.0`) — WebSocket client library
+
+### Dev/build dependencies
+- `rollup`, `@rollup/plugin-commonjs`, `@rollup/plugin-node-resolve` — bundling
+- `sharp` — icon generation (SVG -> PNG)
+- `eslint` — linting
 
-See `thirdparty/rnnoise/COPYING` for the full license text.
+각 npm 패키지의 상세 라이선스는 해당 패키지 레지스트리/저장소를 따릅니다.
+Each npm package follows its own upstream license in its registry/repository.

com.directpipe.directpipe.sdPlugin/manifest.json

@@ -8,7 +8,7 @@
   "Name": "DirectPipe",
   "Icon": "images/directpipe",
   "URL": "https://github.com/LiveTrack-X/DirectPipe",
-  "Version": "4.0.2.0",
+  "Version": "4.0.3.0",
   "OS": [
     {
       "Platform": "windows",
@@ -279,4 +279,4 @@
       }
     }
   ]
-}
+}

com.directpipe.directpipe.sdPlugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "directpipe-streamdeck",
-  "version": "4.0.2",
+  "version": "4.0.3",
   "description": "Stream Deck plugin for DirectPipe — Control VST bypass, volume, presets, and panic mute via WebSocket.",
   "main": "src/plugin.js",
   "scripts": {