From 5df683eba7c103010a7c110d97a5fd808b39fe46 Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Thu, 02 Jul 2026 01:47:41 +0800
Subject: [PATCH] Fix local universal macOS package assembly

---
 CODEGRAPH.md |   23 +++++++++++++++++++++--
 1 files changed, 21 insertions(+), 2 deletions(-)

diff --git a/CODEGRAPH.md b/CODEGRAPH.md
index 2bbef54..c25f132 100644
--- a/CODEGRAPH.md
+++ b/CODEGRAPH.md
@@ -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: cross-platform local package handoff based on `v2.1.40-build20260702.0143`.
 - Protected macOS behavior: existing macOS App Store / local DMG build lines are not changed by this branch.
 
 ## Core Entrypoints
@@ -35,14 +35,28 @@
 - 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:
   - `PrivateVoice Dictation.exe`
   - `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
 
@@ -53,11 +67,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.

--
Gitblit v1.9.3