@sdsrs/code-graph 0.73.1 → 0.74.1

package/claude-plugin/scripts/session-init.js

@@ -33,17 +33,17 @@ function computeQuietHooks({ env = {} } = {}) {
 // SessionStart project-map injection gate. Beyond the (already default-quiet)
 // verbose opt-in, the map is now also ADOPTED-ONLY: cross-project measurement
 // (memory cross-project-interference) found the ≈2 KB dump is zero-referenced
-// in projects the user hasn't adopted into their MEMORY.md workflow, so it only
-// earns its standing-context cost for adopted projects. Unadopted projects get
-// no map even under CODE_GRAPH_VERBOSE_HOOKS / legacy QUIET_HOOKS=0.
+// in projects the user hasn't adopted (no code-graph block in CLAUDE.md), so it
+// only earns its standing-context cost for adopted projects. Unadopted projects
+// get no map even under CODE_GRAPH_VERBOSE_HOOKS / legacy QUIET_HOOKS=0.
 function shouldInjectMap({ available, quietHooks, adopted } = {}) {
   return !!(available && !quietHooks && adopted);
 }
 
 // v0.63 — SessionStart "live context": the recent-change blast radius from the
 // AST index. UNLIKE injectProjectMap (default-OFF because the static module map
-// duplicates MEMORY.md + the on-demand project_map tool), this is git-delta-
-// derived — it changes every session and MEMORY.md cannot carry it, so it earns
+// duplicates the CLAUDE.md block + the on-demand project_map tool), this is git-delta-
+// derived — it changes every session and the static CLAUDE.md block cannot carry it, so it earns
 // being ON by default for adopted projects. It is the graph-unique, actionable
 // counterpart to mem's SessionStart dashboard (which pushes recent activity to
 // create engagement). Selectivity is automatic: a session with no recently
@@ -455,19 +455,27 @@ function runSessionInit({ source } = {}) {
   const autoUpdateLaunched = launchBackgroundAutoUpdate();
   const indexFreshness = binaryCheck.available ? ensureIndexFresh() : 'skipped';
 
-  // v0.9.0 C' 上下文感知默认：插件模式下首次 SessionStart 自动 adopt。
-  // v0.11.0: 已 adopt 的项目如果 shipped template 漂移也会触发一次刷新。
-  // 两种情况都发一次 stderr 提示，让用户知道发生了什么 + 如何回退。
+  // 上下文感知默认：插件模式下首次 SessionStart 自动安装（创建/注入 CLAUDE.md 块 +
+  // .claude/ detail 文件），并清理旧 memory-dir 制品（升级自动迁移）。shipped 漂移
+  // 时刷新。三种情况发一次 stderr 提示，让用户知道发生了什么 + 如何回退。
   const autoAdopt = isRelic ? { attempted: false, result: null } : maybeAutoAdopt({ scriptPath: __dirname });
+  const migrated = autoAdopt.migrated || {};
+  if (migrated.memoryIndexPruned || migrated.legacyDetailRemoved) {
+    process.stderr.write(
+      '[code-graph] Migrated to CLAUDE.md steering — cleaned legacy memory-dir artifacts\n' +
+      '            (MEMORY.md sentinel + detail file). Your other memories are untouched.\n'
+    );
+  }
   if (autoAdopt.attempted && autoAdopt.result && autoAdopt.result.ok) {
     if (autoAdopt.reason === 'refreshed') {
       process.stderr.write(
-        '[code-graph] Refreshed decision table to latest shipped version.\n' +
+        '[code-graph] Refreshed CLAUDE.md decision block to latest shipped version.\n' +
         '            Lock file:  CODE_GRAPH_NO_TEMPLATE_REFRESH=1 in ~/.claude/settings.json env\n'
       );
     } else {
       process.stderr.write(
-        '[code-graph] Auto-adopted into project MEMORY.md (plugin install → knowing consent).\n' +
+        '[code-graph] Installed code-graph block into project CLAUDE.md (plugin install → knowing consent).\n' +
+        '            Detail table: .claude/plugin_code_graph_mcp.md (generated; safe to gitignore)\n' +
         '            Opt out:    CODE_GRAPH_NO_AUTO_ADOPT=1 in ~/.claude/settings.json env\n' +
         '            Reverse:    code-graph-mcp unadopt\n'
       );

package/claude-plugin/templates/plugin_code_graph_mcp.md

@@ -5,15 +5,18 @@ type: reference
 ---
 # code-graph-mcp 插件契约
 
-> Invited-memory 模式：MCP `instructions` 仅留指针，决策细则集中在此。
+> 本文件是 code-graph 工具调度细则。项目根 `CLAUDE.md` 里有一个精炼的 managed
+> 块（sentinel 包裹）做路由摘要 + 指针；本完整决策表按需打开，不每会话常驻。
 >
-> **v0.9.0 起**：插件（`/plugin install`）模式下首次 SessionStart 自动 adopt，
-> 本文件自动写入到项目 memory 目录。
+> **v0.74 起**：插件（`/plugin install`）模式下首次 SessionStart 自动安装——
+> 在项目根 `CLAUDE.md` 注入/创建 managed 块，并把本文件写到 `.claude/plugin_code_graph_mcp.md`。
+> 旧版（≤v0.73）写到 `~/.claude/projects/<slug>/memory/`（MEMORY.md sentinel + 本文件），
+> 升级后首次 SessionStart 自动清理那些遗留制品（你的其它 memory 不受影响）。
 > 退出：`CODE_GRAPH_NO_AUTO_ADOPT=1` 阻止，`code-graph-mcp unadopt` 回退。
 >
-> **v0.11.0 起**：已 adopt 的项目在下次 SessionStart 会自动对齐到插件 shipped
-> 的最新决策表（本文件 SHA 与 template 差异时覆盖）。手动编辑会被覆盖——
-> 要锁定自己的版本，设 `CODE_GRAPH_NO_TEMPLATE_REFRESH=1`（不影响首次 adopt）。
+> 已安装的项目在下次 SessionStart 会自动对齐到插件 shipped 的最新决策表
+> （本文件 / CLAUDE.md 块与 shipped 差异时覆盖）。手动编辑会被覆盖——
+> 要锁定自己的版本，设 `CODE_GRAPH_NO_TEMPLATE_REFRESH=1`（不影响首次安装）。
 >
 > **Hook 默认值（两个 hook，默认不同 —— 故意的）**：
 > - **SessionStart `project_map` 注入：默认 OFF**（v0.17.0 起）。本文件 + 7 个
@@ -139,9 +142,9 @@ code-graph-mcp health-check              # 索引健康
 
 ## 卸载 / 回退
 
-- `code-graph-mcp unadopt` — 精确移除 sentinel 段 + 本文件。
-- `CODE_GRAPH_NO_AUTO_ADOPT=1`（`~/.claude/settings.json` env） — 阻止未来自动 adopt，不影响已 adopted 状态。
-- `CODE_GRAPH_NO_TEMPLATE_REFRESH=1`（v0.11.0+） — 锁定本文件不随插件升级刷新；允许手动编辑长久保留。
+- `code-graph-mcp unadopt` — 精确移除 CLAUDE.md 里的 managed 块 + `.claude/plugin_code_graph_mcp.md`（块移光后若 CLAUDE.md 只剩我们的内容则连文件一起删，否则保留你的正文）；并清理任何遗留 memory-dir 制品。
+- `CODE_GRAPH_NO_AUTO_ADOPT=1`（`~/.claude/settings.json` env） — 阻止未来自动安装，不影响已安装状态。
+- `CODE_GRAPH_NO_TEMPLATE_REFRESH=1` — 锁定 CLAUDE.md 块 + 本文件不随插件升级刷新；允许手动编辑长久保留。
 - `CODE_GRAPH_VERBOSE_HOOKS=1`（v0.17.0+） — opt in 到 SessionStart `project_map` 注入（默认 OFF）。
 - `CODE_GRAPH_QUIET_HOOKS=1` — UserPromptSubmit context push 的 escape hatch（默认 ON）；同时强制 SessionStart `project_map` quiet。
 - `CODE_GRAPH_QUIET_HOOKS=0` — 强制恢复 SessionStart `project_map` 注入（向后兼容路径）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdsrs/code-graph",
-  "version": "0.73.1",
+  "version": "0.74.1",
   "description": "MCP server that indexes codebases into an AST knowledge graph with semantic search, call graph traversal, and HTTP route tracing",
   "license": "MIT",
   "repository": {
@@ -35,10 +35,10 @@
     "node": ">=16"
   },
   "optionalDependencies": {
-    "@sdsrs/code-graph-linux-x64": "0.73.1",
-    "@sdsrs/code-graph-linux-arm64": "0.73.1",
-    "@sdsrs/code-graph-darwin-x64": "0.73.1",
-    "@sdsrs/code-graph-darwin-arm64": "0.73.1",
-    "@sdsrs/code-graph-win32-x64": "0.73.1"
+    "@sdsrs/code-graph-linux-x64": "0.74.1",
+    "@sdsrs/code-graph-linux-arm64": "0.74.1",
+    "@sdsrs/code-graph-darwin-x64": "0.74.1",
+    "@sdsrs/code-graph-darwin-arm64": "0.74.1",
+    "@sdsrs/code-graph-win32-x64": "0.74.1"
   }
 }