# CodeGraph 版本号统一升级 0.9.3 -> 1.5.0

- **时间**：20260725163909
- **关联 Issue**：#IK3YMP（采纳）、#IK3YMQ（关闭/本轮不处理）
- **分支**：evolve/codegraph-version-bump
- **commit**：（后填）

## 动机

Issue #IK3YMP：`@colbymchenry/codegraph` npm 最新为 `1.5.0`，但插件示例与文档硬编码 `0.9.3`。新业务仓 `/kb-init` 复制出的 `.mcp.json` 直接是过旧版本，用户需手动改。1.5.0 的 `serve --mcp --path .` 子命令已验证兼容。

## 提案处置

| 提案 | 主题 | 处置 |
|------|------|------|
| P1 | CodeGraph 版本号统一升级 0.9.3 -> 1.5.0 | 采纳 |
| P2 | kb-codegraph.md §1.1 补充 pi 宿主接入路径 | 关闭（用户决定本轮不处理） |
| P3 | SKILL.md §项目级 MCP 描述同步 pi 宿主 | 关闭（用户决定本轮不处理） |

Issue #IK3YMQ（pi 无原生 MCP、硬门禁阻断）由用户决定本轮关闭，不在本批处置；后续如需文档化 pi 扩展桥接接入路径，另开轮次。

## EvoMap 网络路径

- `kb-evomap.mjs status`：enabled=true，publish=true
- 检索 query 1「codegraph MCP version pinning drift npm package upgrade」命中 10 条，最高分 `gene_dependency_confusion_attack_prevention`（score 74.64，供应链攻击防护，与本主题非同主题）
- 检索 query 2「pi coding agent does not support MCP mcp.json codegraph hard gate fallback CLI」命中 5 条，最高分 OpenCode CLI（score 57.53，不相关）
- **结论**：EvoMap 命中均不相关，未采用任何 asset

| evomap_asset_ids | 采用情况 |
|------------------|----------|
| — | 未采用（命中均不相关） |

## 改动文件

| 文件 | 改动 |
|------|------|
| `bootstrap/examples/mcp/claude.mcp.json` | L7 `@0.9.3` -> `@1.5.0`（1 处） |
| `bootstrap/examples/mcp/cursor.mcp.json` | L7 `@0.9.3` -> `@1.5.0`（1 处） |
| `bootstrap/examples/mcp/README.md` | L25/L26 init/index 示例 `@0.9.3` -> `@1.5.0`（2 处） |
| `skills/kb-workflow/references/kb-codegraph.md` | L44 launcher 说明、L53 init 命令、L54 index 命令 `@0.9.3` -> `@1.5.0`（3 处） |

合计 7 处替换，覆盖 4 个文件。

## 白名单扩展说明

`bootstrap/examples/mcp/README.md` 不在写入白名单明列路径（`prompts/**`/`skills/kb-workflow/**`/`agents/**`/`schema/**`/`scripts/**`/`docs/evolution/**`/根 README/CHANGELOG/package.json）内。经用户当轮确认（选 A）临时纳入，理由：示例 README 与 `.mcp.json` 版本须一致，否则 Issue #IK3YMP 处置不完整。

## 验证

- `grep -rn "0\.9\.3" bootstrap/examples/mcp/ skills/kb-workflow/references/kb-codegraph.md` -> 0 命中
- `package-lock.json` 存在分支切出前的未提交改动，本轮**未触碰**，提交时排除

## 后续

- 合入 master 后 bump / publish；业务仓 `pi update` 后重新 `/kb-init` 即得 1.5.0 示例。
- Issue #IK3YMQ 的 pi 宿主 MCP 接入文档化若需推进，另开轮次。