crazy-macs/private-voice.git

			@@ -3,7 +3,7 @@
			## Project

			- Product: Wails v3 / Go desktop dictation app.
			- Current branch purpose: Windows technical preview based on `v2.1.38-build20260629.2014-diagnostic`.
			- Current branch purpose: Round 6 Cantonese language version real-user test package based on `v2.2.0-build20260702.0303`.
			- Protected macOS behavior: existing macOS App Store / local DMG build lines are not changed by this branch.

			## Core Entrypoints
			@@ -11,6 +11,17 @@
			- `privatevoice.src/main.go`: process startup, data migration, logger, single-instance guard.
			- `privatevoice.src/app.go`: Wails app wiring, settings window, tray, recorder, hotkey loop, ASR init, paste orchestration.
			- `privatevoice.src/embed.go`: embeds frontend assets and app/tray icons.

			## Language And Model Registry

			- `privatevoice.src/internal/model/profile.go`: model and language IDs, model profile shape, install status types.
			- `privatevoice.src/internal/model/registry.go`: language profile order, model profiles, language profiles, and normalization.
			- `privatevoice.src/internal/modelselection/selection.go`: resolves current language and model, including manual-model fallback.
			- Round 6 Cantonese path:
			- Language ID: `yue-HK`, displayed as `粤语`.
			- Default model: `sensevoice-yue-2025-09-09`.
			- Backend: SenseVoice with `LanguageParam="yue"`.
			- The Cantonese language profile intentionally has no upgrade models, so Qwen3-ASR and X-ASR are not shown as Cantonese-specific options.

			## Platform Modules

			@@ -26,6 +37,8 @@
			- ASR engine:
			- macOS: `privatevoice.src/internal/engine/engine_darwin.go`
			- Windows: `privatevoice.src/internal/engine/engine_windows.go`
			- Linux: `privatevoice.src/internal/engine/engine_linux.go`
			- SenseVoice profiles may set `Profile.LanguageParam`; Cantonese uses `yue`.
			- Overlay:
			- macOS: `privatevoice.src/internal/overlay/overlay_darwin.go`
			- Windows: `privatevoice.src/internal/overlay/overlay_windows.go`
			@@ -35,6 +48,7 @@
			- Windows preview supports `SenseVoice` only.
			- Non-SenseVoice models remain visible in settings but are disabled through `model.IsModelSupportedInCurrentBuild`.
			- Windows unsupported reason: `windows_preview_unsupported`.
			- Windows overlay remains native Win32/GDI+, with a larger translucent spectrum-style capsule indicator for recording states.
			- Build script: `privatevoice.src/scripts/build-windows-preview.sh`.
			- Evidence verifier: `privatevoice.src/scripts/verify-windows-qa-evidence.sh`.
			- Runtime package includes:
			@@ -42,8 +56,20 @@
			- `onnxruntime.dll`
			- `sherpa-onnx-c-api.dll`
			- `sherpa-onnx-cxx-api.dll`
			- `RUN-WINDOWS-QA.cmd`
			- `QA-WINDOWS-PREVIEW.ps1`
			- `README-WINDOWS-PREVIEW.txt`

			## macOS Local Package Scope

			- Local DMG script: `privatevoice.src/scripts/build-local-macos.sh`.
			- Universal DMG script: `privatevoice.src/scripts/build-local-macos-universal.sh`.
			- Local macOS package set for this branch:
			- `arm64` DMG for Apple Silicon.
			- `x86_64` DMG for Intel Mac.
			- `universal` DMG for Intel + Apple Silicon.
			- Mainline macOS local packages keep `LSMinimumSystemVersion=14.0` and the default Qwen3-capable dependency line.
			- Monterey-compatible packages remain a separate build line through `privatevoice.src/scripts/build-local-macos-monterey.sh`.

			## Standard Verification Commands

			@@ -54,13 +80,16 @@
			go test ./...
			GOOS=windows GOARCH=amd64 CGO_ENABLED=1 CC=x86_64-w64-mingw32-gcc CXX=x86_64-w64-mingw32-g++ go test -exec=/usr/bin/true ./...
			./scripts/build-windows-preview.sh
			./scripts/build-local-macos.sh arm64
			./scripts/build-local-macos.sh x86_64
			./scripts/build-local-macos-universal.sh
			./scripts/verify-windows-qa-evidence.sh /path/to/qa-evidence-YYYYMMDD-HHMMSS.zip
			```

			## Known Gaps

			- Windows runtime QA must still be performed on Windows 10/11 hardware.
			- Run `QA-WINDOWS-PREVIEW.ps1` from the extracted preview package to collect startup, engine, recording, recognition, paste, and Notepad target text evidence.
			- Run `RUN-WINDOWS-QA.cmd` from the extracted preview package to collect WebView2/audio preflight, startup, engine, recording, recognition, paste, and Notepad target text evidence.
			- After evidence is returned, run `verify-windows-qa-evidence.sh` and require `WINDOWS_QA_EVIDENCE_PASS` before claiming the goal complete.
			- The Windows preview zip is unsigned and not an installer.
			- SmartScreen / Defender prompts are expected for local testing.