| | |
| | | ## Project |
| | | |
| | | - Product: Wails v3 / Go desktop dictation app. |
| | | - Git root: `/Users/ar/Projects/PrivateVoice2/03-O`. |
| | | - Source root: `/Users/ar/Projects/PrivateVoice2/03-O/C1.source/privatevoice.src`. |
| | | - Git root: `/Users/ar/Projects/PrivateVoice/03-O`. |
| | | - Source root: `/Users/ar/Projects/PrivateVoice/03-O/C1.source/privatevoice.src`. |
| | | - Current branch purpose: Round 6 Cantonese language version real-user test package based on `v2.2.0-build20260702.0303`. |
| | | - Protected behavior: existing macOS App Store, local DMG, Monterey compatibility, Windows preview, model download safety, and paste/clipboard protection must not be changed without a scoped task and QA plan. |
| | | |
| | | ## Automatic Codebase Memory |
| | | |
| | | - Status: `enabled`. |
| | | - Tool: `codebase-memory-mcp` 0.8.1. |
| | | - Current project name after path unification: `Users-ar-Projects-PrivateVoice-03-O`. |
| | | - Existing artifact note: `.codebase-memory/artifact.json` may still record legacy project name `Users-ar-Projects-PrivateVoice2-03-O` until the graph is regenerated. |
| | | - Shared artifact: `.codebase-memory/graph.db.zst`; metadata: `.codebase-memory/artifact.json`. |
| | | - Scope: `/Users/ar/Projects/PrivateVoice/03-O`. |
| | | - Refresh command: `codebase-memory-mcp cli index_repository '{"repo_path":"/Users/ar/Projects/PrivateVoice/03-O"}'`. |
| | | - Current `indexed_at`, commit, node count, and edge count are recorded in `.codebase-memory/artifact.json`. |
| | | - Excluded by indexer: `.git`, `K3.运营与发布资料/legacy-运营资料/PrivateVoice-26.0604上架`, `K3.运营与发布资料/legacy-运营资料/运营文档`, `C1.source/privatevoice.src/frontend/dist`, `C1.source/privatevoice.src/frontend/node_modules`. |
| | | - Query example after regenerating graph from Git root: `codebase-memory-mcp cli search_graph '{"project":"Users-ar-Projects-PrivateVoice-03-O","query":"model registry","limit":5}'`. |
| | | - This automatic graph is an exploration aid only; it does not replace source reading, tests, QA evidence, or this `CODEGRAPH.md`. |
| | | - Refresh rule: regenerate `.codebase-memory/` before each source freeze, version freeze, formal rollback-capable test package, or release package; daily Coder work-in-progress changes do not force a refresh. |
| | | - Freeze record requirement: record the refresh command, `.codebase-memory/artifact.json` path, indexed commit, freeze commit, and whether the two commits match or differ only by `.codebase-memory/` artifact updates. |
| | | |
| | | ## Core Entrypoints |
| | | |
| | | - `C1.source/privatevoice.src/main.go`: process startup, data migration, logger, single-instance guard. |