docs(codegraph): record 16/16 workspace rollout + wrapper bugfix

docs/2026-06-03-CODEGRAPH-INTEGRATION.md

@@ -2,6 +2,16 @@
 
 本文档记录本项目如何接入 `/home/long/project` 工作区级 codegraph 搜索基础设施。
 
+## 0. 状态摘要（2026-06-03 rollout 完成）
+
+| 指标                                                 | 状态                                                 |
+| ---------------------------------------------------- | ---------------------------------------------------- |
+| 工作区级 codegraph 契约                              | ✅ `/home/long/project/CODEGRAPH_WORKSPACE_USAGE.md` |
+| 已索引 repo                                          | 16/16                                                |
+| 有项目级 OMP 规则                                    | **16/16**（之前 8/16 → 全部补齐）                    |
+| codegraph-workspace wrapper bug 修复                 | ✅ 2026-06-03 patch                                  |
+| 本项目（sub2api-cn-relay-manager）`.agent/AGENTS.md` | ✅ 158 行，反映 frontend 重构                        |
+
 ## 1. 工作区级入口
 
 所有 agent 共用的 codegraph 使用契约在：
@@ -14,11 +24,12 @@
 
 ## 2. 本项目对 codegraph workspace 的贡献
 
-| 资源              | 状态         | 位置                                                       |
-| ----------------- | ------------ | ---------------------------------------------------------- |
-| CodeGraph 索引    | ✅           | `~/.codegraph/projects.json` 含 `sub2api-cn-relay-manager` |
-| OMP 项目规则      | ✅           | `<repo>/.agent/AGENTS.md`（158 行，2026-06-03 更新）       |
-| 工作区 usage 文档 | ✅（已贡献） | `/home/long/project/CODEGRAPH_WORKSPACE_USAGE.md`          |
+| 资源              | 状态           | 位置                                                                  |
+| ----------------- | -------------- | --------------------------------------------------------------------- |
+| CodeGraph 索引    | ✅             | `~/.codegraph/projects.json` 含 `sub2api-cn-relay-manager`            |
+| OMP 项目规则      | ✅             | `<repo>/.agent/AGENTS.md`（158 行，2026-06-03 更新）                  |
+| 工作区 usage 文档 | ✅（已贡献）   | `/home/long/project/CODEGRAPH_WORKSPACE_USAGE.md`                     |
+| wrapper 修复      | ✅（已 patch） | `/home/long/.local/bin/codegraph-workspace`（备份 `.bak-2026-06-03`） |
 
 ## 3. 本项目对其他 agent 的入口信号
 
@@ -38,7 +49,7 @@
 $ grep '"sub2api-cn-relay-manager"' ~/.codegraph/projects.json
 # 命中
 
-# 2. 项目级 OMP 规则存在
+# 2. 项目级 OMP 规则存在（不在仓库根 .gitignore 内）
 $ ls -l /home/long/project/sub2api-cn-relay-manager/.agent/AGENTS.md
 -rw-rw-r-- 1 long long 9604  6月  3 13:26 AGENTS.md
 
@@ -62,7 +73,33 @@ $ /home/long/.local/bin/codegraph-workspace def sub2api-cn-relay-manager 'refres
 # → 印证 skill 文档：inline JS function 走 search_files fallback，而不是 def
 ```
 
-## 5. OMP 可发现性 — 当前限制
+## 5. 2026-06-03 rollout 实测（其他 7 个 repo 的接入）
+
+| Repo                     | AGENTS.md 行数 | codegraph-workspace 命中关键字 | 状态                        |
+| ------------------------ | -------------- | ------------------------------ | --------------------------- |
+| `ai-customer-service`    | 75             | `IMPLEMENTATION_PLAN` ✓        | ✅                          |
+| `contract management`    | 95             | `OpenSpec` ✓                   | ✅（路径含空格）            |
+| `shenyi`                 | 87             | `WARP.md` ✓                    | ✅（用户主力项目）          |
+| `sub2api`                | 95             | `国产模型` ✓                   | ✅（上游 mirror）           |
+| `sub2api-official-fresh` | 90             | `CLA.md` ✓                     | ✅（宿主参考，不改源码）    |
+| `supply-intelligence`    | 65             | `POLLER_RUNTIME_BOUNDARY` ✓    | ✅                          |
+| `tokens-reef`            | 73             | `MERGE_GUIDE` ✓                | ✅（tksea `pham` 命名空间） |
+
+`codegraph-workspace list` 最终结果：**16 AGENTS / 0 missing**。
+
+## 6. wrapper 修复（2026-06-03）
+
+`codegraph-workspace` 第 29 行原来只检查 `<repo>/AGENTS.md` 仓库根存在性，但 OMP 实际读的是 `<repo>/.agent/AGENTS.md`。**已 patch**（备份在 `codegraph-workspace.bak-2026-06-03`）：
+
+```python
+'has_agents': (p / 'AGENTS.md').exists() or (p / '.agent' / 'AGENTS.md').exists(),
+```
+
+效果：list 输出的 `AGENTS` 标志现在准确反映 OMP 实际可读到的规则文件。
+
+⚠️ **重装或升级 `codegraph-workspace` 时必须重做这个 patch**。详见 `~/.hermes/skills/software-development/codegraph-workspace-operations/SKILL.md` 的 Pitfalls 节。
+
+## 7. OMP 可发现性 — 当前限制
 
 按 `codegraph-workspace-operations` skill 的标准做法，新写 `.agent/AGENTS.md` 后应该用：
 
@@ -81,11 +118,13 @@ OMP_NO_UPDATE_NOTIFIER=1 omp -p --cwd /home/long/project/sub2api-cn-relay-manage
 
 OMP quota 恢复后请补一次实测并把结果记到本文件第 4 节。
 
-## 6. 后续维护
+## 8. 后续维护
 
 - 本项目新增/重构时：
   1. 在 `docs/EXECUTION_BOARD.md` 加条目
   2. 若有 .agent/AGENTS.md 引用过的真相文件，**同步更新** .agent/AGENTS.md
   3. 跑 `codegraph-workspace refresh sub2api-cn-relay-manager` 让索引反映新代码
-- OMP quota 恢复后立即补上第 5 节的实测
+- OMP quota 恢复后立即补上第 7 节的实测
+- 任何本项目接入 codegraph workspace 的规则变更，先在 `/home/long/project/CODEGRAPH_WORKSPACE_USAGE.md` 改，再回本文件
+- 如果 `codegraph-workspace` wrapper 被重装或升级，必须**重做第 6 节的 patch**（备份 `.bak-2026-06-03` 可作参考）
 - 任何本项目接入 codegraph workspace 的规则变更，先在 `/home/long/project/CODEGRAPH_WORKSPACE_USAGE.md` 改，再回本文件