@sdsrs/code-graph 0.8.4 → 0.9.1

package/bin/cli.js

@@ -7,6 +7,17 @@ const path = require("path");
 // and detect dev mode from bin/ → repo root (one level up)
 process.env._FIND_BINARY_ROOT = path.resolve(__dirname, "..");
 
+// Intercept adopt / unadopt before forwarding — they're node-only concerns
+// (write to ~/.claude/projects/<slug>/memory/) and have no Rust counterpart.
+// Lets `code-graph-mcp adopt` / `unadopt` work uniformly across plugin / npm / npx.
+const sub = process.argv[2];
+if (sub === "adopt" || sub === "unadopt") {
+  const { adopt, unadopt, formatResult } = require("../claude-plugin/scripts/adopt");
+  const result = sub === "unadopt" ? unadopt() : adopt();
+  process.stdout.write(formatResult(sub, result) + "\n");
+  process.exit(result.ok === false ? 1 : 0);
+}
+
 const { findBinary } = require("../claude-plugin/scripts/find-binary");
 
 const binary = findBinary();

package/claude-plugin/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "sdsrs"
   },
-  "version": "0.8.4",
+  "version": "0.9.1",
   "keywords": [
     "code-graph",
     "ast",

package/claude-plugin/scripts/adopt.js

@@ -9,7 +9,11 @@ const os = require('os');
 
 const SENTINEL_BEGIN = '<!-- code-graph-mcp:begin v1 -->';
 const SENTINEL_END = '<!-- code-graph-mcp:end -->';
-const INDEX_LINE = '- [code-graph-mcp](plugin_code_graph_mcp.md) — "谁调 X / 改 X 炸啥 / 模块结构" → `get_call_graph` / `impact_analysis` / `module_overview`，替代多步 Grep/Read';
+const INDEX_LINE = [
+  '- [code-graph-mcp](plugin_code_graph_mcp.md) — 代码理解 12 工具（替代 Grep/Read 多步）：',
+  '  - 问"谁调/改动/模块/概念/HTTP/相似" → `get_call_graph`/`impact_analysis`/`module_overview`/`semantic_code_search`/`trace_http_chain`/`find_similar_code`',
+  '  - 问"返回型/引用/死码/依赖/架构/看签名" → `ast_search`/`find_references`/`find_dead_code`/`dependency_graph`/`project_map`/`get_ast_node`',
+].join('\n');
 const TEMPLATE_PATH = path.resolve(__dirname, '..', 'templates', 'plugin_code_graph_mcp.md');
 const TARGET_NAME = 'plugin_code_graph_mcp.md';
 
@@ -87,6 +91,43 @@ function adopt({ cwd, home, templatePath } = {}) {
   return { ok: true, target, indexPath, indexed: true, healed };
 }
 
+// v0.9.0 — "已 adopt" 判定：template 文件在 + MEMORY.md 内有我们的 sentinel 块。
+// 用在 maybeAutoAdopt 里做幂等门，也用在 session-init 里推导 quietHooks。
+function isAdopted({ cwd, home } = {}) {
+  const dir = memoryDir(cwd, home);
+  const target = path.join(dir, TARGET_NAME);
+  const indexPath = path.join(dir, 'MEMORY.md');
+  if (!fs.existsSync(target) || !fs.existsSync(indexPath)) return false;
+  const index = fs.readFileSync(indexPath, 'utf8');
+  return index.includes(SENTINEL_BEGIN) && index.includes(SENTINEL_END);
+}
+
+// 检测脚本是否从 Claude Code 插件 cache 运行。
+// 走 __dirname 而非 CLAUDE_PLUGIN_ROOT — 后者在多插件共存时会互相污染
+// （见 feedback_plugin_env_isolation.md）。
+function isPluginModeInstall(scriptPath = __dirname) {
+  const sep = path.sep;
+  return scriptPath.includes(`${sep}.claude${sep}plugins${sep}`);
+}
+
+// C' 上下文感知默认（v0.9.0）：插件模式下首次 SessionStart 静默 adopt。
+// /plugin install 本身已构成知情同意；npm / npx / 裸 checkout 保持 opt-in。
+// 退出：CODE_GRAPH_NO_AUTO_ADOPT=1。
+function maybeAutoAdopt({ cwd, home, env, scriptPath } = {}) {
+  env = env || process.env;
+  if (env.CODE_GRAPH_NO_AUTO_ADOPT === '1') {
+    return { attempted: false, reason: 'opted-out' };
+  }
+  if (!isPluginModeInstall(scriptPath || __dirname)) {
+    return { attempted: false, reason: 'not-plugin-mode' };
+  }
+  if (isAdopted({ cwd, home })) {
+    return { attempted: false, reason: 'already-adopted' };
+  }
+  const result = adopt({ cwd, home });
+  return { attempted: true, reason: 'adopted', result };
+}
+
 function unadopt({ cwd, home } = {}) {
   const blocked = platformGuard();
   if (blocked) return blocked;
@@ -132,7 +173,9 @@ function formatResult(action, result) {
     if (result.healed) lines.push(`[code-graph] Healed malformed sentinel block → ${result.indexPath}`);
     else if (result.indexed) lines.push(`[code-graph] Indexed → ${result.indexPath}`);
     else lines.push(`[code-graph] Index already up-to-date — no write`);
-    lines.push('[code-graph] Activate: set CODE_GRAPH_QUIET_HOOKS=1 in ~/.claude/settings.json env');
+    // v0.9.0: adoption auto-implies quietHooks; no env var needed for the common case.
+    lines.push('[code-graph] Active — quietHooks auto-enabled via adopted state.');
+    lines.push('[code-graph] Force inject:  CODE_GRAPH_QUIET_HOOKS=0   Force silent: =1');
     return lines.join('\n');
   }
   if (action === 'unadopt') {
@@ -154,5 +197,6 @@ if (require.main === module) {
 
 module.exports = {
   adopt, unadopt, memoryDir, formatResult, stripSentinelBlock,
+  isAdopted, isPluginModeInstall, maybeAutoAdopt,
   SENTINEL_BEGIN, SENTINEL_END, INDEX_LINE, TEMPLATE_PATH, TARGET_NAME,
 };

package/claude-plugin/scripts/adopt.test.js

@@ -6,6 +6,7 @@ const path = require('path');
 const os = require('os');
 const {
   adopt, unadopt, memoryDir, stripSentinelBlock,
+  isAdopted, isPluginModeInstall, maybeAutoAdopt,
   SENTINEL_BEGIN, SENTINEL_END, INDEX_LINE, TEMPLATE_PATH,
 } = require('./adopt');
 
@@ -213,6 +214,140 @@ test('unadopt heals malformed sentinel (orphan BEGIN)', () => {
   } finally { sb.cleanup(); }
 });
 
+// ──────────────────────────────────────────────────────────────────────────
+// v0.9.0 — C' context-aware auto-adopt
+// ──────────────────────────────────────────────────────────────────────────
+
+test('isAdopted returns false on fresh project (no files)', () => {
+  const sb = makeSandbox();
+  try {
+    assert.strictEqual(isAdopted({ cwd: sb.cwd, home: sb.home }), false);
+  } finally { sb.cleanup(); }
+});
+
+test('isAdopted returns true after adopt()', () => {
+  const sb = makeSandbox();
+  try {
+    adopt({ cwd: sb.cwd, home: sb.home });
+    assert.strictEqual(isAdopted({ cwd: sb.cwd, home: sb.home }), true);
+  } finally { sb.cleanup(); }
+});
+
+test('isAdopted returns false after unadopt()', () => {
+  const sb = makeSandbox();
+  try {
+    adopt({ cwd: sb.cwd, home: sb.home });
+    unadopt({ cwd: sb.cwd, home: sb.home });
+    assert.strictEqual(isAdopted({ cwd: sb.cwd, home: sb.home }), false);
+  } finally { sb.cleanup(); }
+});
+
+test('isAdopted returns false when target file exists but index has no sentinel', () => {
+  const sb = makeSandbox();
+  try {
+    const indexPath = path.join(sb.dir, 'MEMORY.md');
+    fs.writeFileSync(indexPath, '# Memory Index\n- [foo.md](foo.md) — unrelated\n');
+    fs.writeFileSync(path.join(sb.dir, 'plugin_code_graph_mcp.md'), 'stale copy');
+    assert.strictEqual(isAdopted({ cwd: sb.cwd, home: sb.home }), false);
+  } finally { sb.cleanup(); }
+});
+
+test('isPluginModeInstall recognizes ~/.claude/plugins/... paths', () => {
+  const pluginPath = '/home/user/.claude/plugins/cache/code-graph-mcp@0.9.0/scripts';
+  assert.strictEqual(isPluginModeInstall(pluginPath), true);
+});
+
+test('isPluginModeInstall rejects npm global install paths', () => {
+  const npmPath = '/usr/local/lib/node_modules/@sdsrs/code-graph/claude-plugin/scripts';
+  assert.strictEqual(isPluginModeInstall(npmPath), false);
+});
+
+test('isPluginModeInstall rejects dev-checkout paths', () => {
+  const devPath = '/mnt/data_ssd/dev/projects/code-graph-mcp/claude-plugin/scripts';
+  assert.strictEqual(isPluginModeInstall(devPath), false);
+});
+
+test('isPluginModeInstall rejects npx cache paths', () => {
+  const npxPath = '/tmp/npx-abc123/node_modules/@sdsrs/code-graph/claude-plugin/scripts';
+  assert.strictEqual(isPluginModeInstall(npxPath), false);
+});
+
+test('maybeAutoAdopt skips when CODE_GRAPH_NO_AUTO_ADOPT=1', () => {
+  const sb = makeSandbox();
+  try {
+    const res = maybeAutoAdopt({
+      cwd: sb.cwd, home: sb.home,
+      scriptPath: '/home/u/.claude/plugins/cache/code-graph-mcp/scripts',
+      env: { CODE_GRAPH_NO_AUTO_ADOPT: '1' },
+    });
+    assert.strictEqual(res.attempted, false);
+    assert.strictEqual(res.reason, 'opted-out');
+    assert.strictEqual(isAdopted({ cwd: sb.cwd, home: sb.home }), false);
+  } finally { sb.cleanup(); }
+});
+
+test('maybeAutoAdopt skips when not plugin-mode (npm install)', () => {
+  const sb = makeSandbox();
+  try {
+    const res = maybeAutoAdopt({
+      cwd: sb.cwd, home: sb.home,
+      scriptPath: '/usr/local/lib/node_modules/@sdsrs/code-graph/claude-plugin/scripts',
+      env: {},
+    });
+    assert.strictEqual(res.attempted, false);
+    assert.strictEqual(res.reason, 'not-plugin-mode');
+    assert.strictEqual(isAdopted({ cwd: sb.cwd, home: sb.home }), false);
+  } finally { sb.cleanup(); }
+});
+
+test('maybeAutoAdopt skips when already adopted (idempotent)', () => {
+  const sb = makeSandbox();
+  try {
+    adopt({ cwd: sb.cwd, home: sb.home });
+    const res = maybeAutoAdopt({
+      cwd: sb.cwd, home: sb.home,
+      scriptPath: '/home/u/.claude/plugins/cache/code-graph-mcp/scripts',
+      env: {},
+    });
+    assert.strictEqual(res.attempted, false);
+    assert.strictEqual(res.reason, 'already-adopted');
+  } finally { sb.cleanup(); }
+});
+
+test('maybeAutoAdopt runs adopt when plugin-mode + unadopted + no opt-out', () => {
+  const sb = makeSandbox();
+  try {
+    const res = maybeAutoAdopt({
+      cwd: sb.cwd, home: sb.home,
+      scriptPath: '/home/u/.claude/plugins/cache/code-graph-mcp/scripts',
+      env: {},
+    });
+    assert.strictEqual(res.attempted, true);
+    assert.strictEqual(res.result.ok, true);
+    assert.strictEqual(res.result.indexed, true);
+    assert.strictEqual(isAdopted({ cwd: sb.cwd, home: sb.home }), true);
+  } finally { sb.cleanup(); }
+});
+
+test('maybeAutoAdopt returns no-memory-dir when project memory missing', () => {
+  const home = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-adopt-home-'));
+  const cwd = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-adopt-cwd-'));
+  try {
+    const res = maybeAutoAdopt({
+      cwd, home,
+      scriptPath: '/home/u/.claude/plugins/cache/code-graph-mcp/scripts',
+      env: {},
+    });
+    // Plugin-mode + not adopted + no opt-out → attempt runs, but adopt() fails gracefully
+    assert.strictEqual(res.attempted, true);
+    assert.strictEqual(res.result.ok, false);
+    assert.strictEqual(res.result.reason, 'no-memory-dir');
+  } finally {
+    fs.rmSync(home, { recursive: true, force: true });
+    fs.rmSync(cwd, { recursive: true, force: true });
+  }
+});
+
 test('Windows platform is rejected with clear reason', { skip: process.platform === 'win32' }, () => {
   const orig = process.platform;
   Object.defineProperty(process, 'platform', { value: 'win32', configurable: true });

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

@@ -9,6 +9,16 @@ const {
   cleanupDisabledStatusline, isPluginInactive, readJson, CACHE_DIR,
 } = require('./lifecycle');
 const { readBinaryVersion, isDevMode, getNewestMtime } = require('./version-utils');
+const { maybeAutoAdopt, isAdopted } = require('./adopt');
+
+// v0.9.0 — quietHooks 推导：显式 env override > adopted 状态。
+// CODE_GRAPH_QUIET_HOOKS='0' 强制 noisy；'1' 强制 quiet；未设 → 跟随 adopted。
+function computeQuietHooks({ adopted, env = {} } = {}) {
+  const envQuiet = env.CODE_GRAPH_QUIET_HOOKS;
+  if (envQuiet === '0') return false;
+  if (envQuiet === '1') return true;
+  return !!adopted;
+}
 
 function launchBackgroundAutoUpdate(spawnFn = spawn, env = process.env) {
   try {
@@ -247,9 +257,23 @@ function runSessionInit() {
 
   const autoUpdateLaunched = launchBackgroundAutoUpdate();
   const indexFreshness = binaryCheck.available ? ensureIndexFresh() : 'skipped';
-  // CODE_GRAPH_QUIET_HOOKS=1 → skip the 60-line project-map injection; rely
-  // on MEMORY.md pointer + on-demand `project_map` tool call instead.
-  const quietHooks = process.env.CODE_GRAPH_QUIET_HOOKS === '1';
+
+  // v0.9.0 C' 上下文感知默认：插件模式下首次 SessionStart 自动 adopt。
+  // 仅一次 stderr 提示（采纳成功时），让用户知道发生了什么 + 如何回退。
+  const autoAdopt = maybeAutoAdopt({ scriptPath: __dirname });
+  if (autoAdopt.attempted && autoAdopt.result && autoAdopt.result.ok) {
+    process.stderr.write(
+      '[code-graph] Auto-adopted into project MEMORY.md (plugin install → knowing consent).\n' +
+      '            Opt out:    CODE_GRAPH_NO_AUTO_ADOPT=1 in ~/.claude/settings.json env\n' +
+      '            Reverse:    code-graph-mcp unadopt\n'
+    );
+  }
+
+  // quietHooks: adopted → quiet by default (rely on MEMORY.md pointer + on-demand
+  // project_map tool); env '1'/'0' overrides for explicit control.
+  const adopted = isAdopted();
+  const quietHooks = computeQuietHooks({ adopted, env: process.env });
+
   const mapInjected = binaryCheck.available && !quietHooks ? injectProjectMap() : false;
   const consistencyIssues = binaryCheck.available
     ? consistencyCheck(binaryCheck.binary)
@@ -257,7 +281,7 @@ function runSessionInit() {
   return {
     inactive: false, lifecycle,
     autoUpdateLaunched, indexFreshness, mapInjected, binaryCheck, consistencyIssues,
-    quietHooks,
+    quietHooks, adopted, autoAdopted: autoAdopt.attempted,
   };
 }
 
@@ -298,6 +322,7 @@ module.exports = {
   verifyBinary,
   consistencyCheck,
   runSessionInit,
+  computeQuietHooks,
 };
 
 if (require.main === module) {

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

@@ -4,7 +4,7 @@ const assert = require('node:assert/strict');
 const fs = require('fs');
 const path = require('path');
 
-const { launchBackgroundAutoUpdate, syncLifecycleConfig, ensureIndexFresh, verifyBinary } = require('./session-init');
+const { launchBackgroundAutoUpdate, syncLifecycleConfig, ensureIndexFresh, verifyBinary, computeQuietHooks } = require('./session-init');
 
 test('syncLifecycleConfig is exported as a callable helper', () => {
   assert.equal(typeof syncLifecycleConfig, 'function');
@@ -83,6 +83,30 @@ test('consistencyCheck returns empty array when binary version matches plugin',
   assert.ok(Array.isArray(result));
 });
 
+// ──────────────────────────────────────────────────────────────────────────
+// v0.9.0 — quietHooks inference from adopted state
+// ──────────────────────────────────────────────────────────────────────────
+
+test('computeQuietHooks: env "0" forces noisy regardless of adoption', () => {
+  assert.equal(computeQuietHooks({ adopted: true, env: { CODE_GRAPH_QUIET_HOOKS: '0' } }), false);
+  assert.equal(computeQuietHooks({ adopted: false, env: { CODE_GRAPH_QUIET_HOOKS: '0' } }), false);
+});
+
+test('computeQuietHooks: env "1" forces quiet regardless of adoption', () => {
+  assert.equal(computeQuietHooks({ adopted: true, env: { CODE_GRAPH_QUIET_HOOKS: '1' } }), true);
+  assert.equal(computeQuietHooks({ adopted: false, env: { CODE_GRAPH_QUIET_HOOKS: '1' } }), true);
+});
+
+test('computeQuietHooks: env unset → follows adopted state', () => {
+  assert.equal(computeQuietHooks({ adopted: true, env: {} }), true);
+  assert.equal(computeQuietHooks({ adopted: false, env: {} }), false);
+});
+
+test('computeQuietHooks: env unset, no env arg → follows adopted state', () => {
+  assert.equal(computeQuietHooks({ adopted: true }), true);
+  assert.equal(computeQuietHooks({ adopted: false }), false);
+});
+
 test('consistencyCheck returns version-mismatch when versions differ', (t) => {
   const os = require('os');
   const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'cc-'));

package/claude-plugin/templates/plugin_code_graph_mcp.md

@@ -6,7 +6,11 @@ type: reference
 # code-graph-mcp 插件契约
 
 > Invited-memory 模式：MCP `instructions` 仅留指针，决策细则集中在此。
-> 启用条件：`CODE_GRAPH_QUIET_HOOKS=1`（在 `~/.claude/settings.json` 的 `env` 中设置）。
+>
+> **v0.9.0 起**：插件（`/plugin install`）模式下首次 SessionStart 自动 adopt，
+> 本文件自动写入，自动切换 quietHooks（跳过每次 project_map 注入）。
+> 退出：`CODE_GRAPH_NO_AUTO_ADOPT=1` 阻止，`code-graph-mcp unadopt` 回退。
+> 手动强控：`CODE_GRAPH_QUIET_HOOKS=0` 强制注入 / `=1` 强制静默（覆盖 adoption 推导）。
 
 ## 何时调用 MCP/CLI（替代多步 Grep/Read）
 
@@ -27,9 +31,9 @@ type: reference
 
 ## 不要替代
 
-- 精确字符串 / 常量 / 正则 → 仍用 `Grep`
-- 非代码文件（README/JSON/log） → 仍用 `Grep`
-- 即将编辑的具体文件 → 仍用 `Read`
+- 非代码文件（README/JSON/log） → 用内置 `Grep`
+- 代码里查常量/函数名/字符串首选 `code-graph-mcp grep "pattern" [path]`（每个命中带 containing function/module 上下文，结构化）；只做纯文本匹配且不关心上下文时用内置 `Grep`
+- 即将编辑的具体文件 → 用 `Read`（`overview <file>` 看概览，`show SYMBOL` 看某符号）
 
 ## 工作流惯例
 
@@ -65,6 +69,8 @@ code-graph-mcp health-check              # 索引健康
 - `impact` 在 `--change-type signature` 时返回最严格的破坏面
 - 索引陈旧 → SessionStart 自带 `ensureIndexFresh`；手动跑 `incremental-index`
 
-## 卸载
+## 卸载 / 回退
 
-`code-graph-mcp unadopt` 精确移除 sentinel 段 + 本文件；或取消 `CODE_GRAPH_QUIET_HOOKS` 即恢复原注入。
+- `code-graph-mcp unadopt` — 精确移除 sentinel 段 + 本文件，quietHooks 自动回到 false（下次 SessionStart 恢复 project_map 注入）。
+- `CODE_GRAPH_NO_AUTO_ADOPT=1`（`~/.claude/settings.json` env） — 阻止未来自动 adopt，不影响已 adopted 状态。
+- `CODE_GRAPH_QUIET_HOOKS=0` — 强制恢复 project_map 注入（即使已 adopted）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdsrs/code-graph",
-  "version": "0.8.4",
+  "version": "0.9.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": {
@@ -34,10 +34,10 @@
     "node": ">=16"
   },
   "optionalDependencies": {
-    "@sdsrs/code-graph-linux-x64": "0.8.4",
-    "@sdsrs/code-graph-linux-arm64": "0.8.4",
-    "@sdsrs/code-graph-darwin-x64": "0.8.4",
-    "@sdsrs/code-graph-darwin-arm64": "0.8.4",
-    "@sdsrs/code-graph-win32-x64": "0.8.4"
+    "@sdsrs/code-graph-linux-x64": "0.9.1",
+    "@sdsrs/code-graph-linux-arm64": "0.9.1",
+    "@sdsrs/code-graph-darwin-x64": "0.9.1",
+    "@sdsrs/code-graph-darwin-arm64": "0.9.1",
+    "@sdsrs/code-graph-win32-x64": "0.9.1"
   }
 }