From 490d60bbc90a4f407d2d9111e0da70e7efe6995a Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Mon, 13 Jul 2026 11:54:48 +0800
Subject: [PATCH] docs: define independent auto-insert architecture
---
CODEGRAPH.md | 26 +++++++++++++++++++++-----
1 files changed, 21 insertions(+), 5 deletions(-)
diff --git a/CODEGRAPH.md b/CODEGRAPH.md
index 91cfda1..2ccf054 100644
--- a/CODEGRAPH.md
+++ b/CODEGRAPH.md
@@ -3,10 +3,26 @@
## 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`.
-- Current branch purpose: Round 6 Cantonese language version real-user test package based on `v2.2.0-build20260702.0303`.
+- Git root: `/Users/ar/Projects/PrivateVoice/03-O`.
+- Source root: `/Users/ar/Projects/PrivateVoice/03-O/C1.source/privatevoice.src`.
+- Current branch purpose: R221 recovery freeze for `2.2.2 build20260703.0335`, restoring reviewed `2.2.1` fixes into the current active source and producing four real-user test candidate packages.
- 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`.
+- Current artifact note: `.codebase-memory/artifact.json` must record project `Users-ar-Projects-PrivateVoice-03-O` before each freeze / release package.
+- 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-2.2.1-recovered.src`, `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
@@ -78,6 +94,6 @@
## Known Gaps
- Windows runtime QA must still be performed on Windows 10/11 hardware before calling Windows stable.
-- macOS 2.2.0 real-user test DMGs are locally signed and not notarized.
-- Monterey compatibility was not revalidated for the 2.2.0 package set.
+- macOS 2.2.2 real-user test DMGs are locally signed and not notarized.
+- Monterey compatibility was not revalidated for the 2.2.2 package set.
- Independent-site sales still need Developer ID release packaging, download page, authorization/activation, update strategy, support path, release manifest, and rollback policy.
--
Gitblit v1.9.3