@sdsrs/code-graph 0.8.3 → 0.9.0

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.3",
+  "version": "0.9.0",
   "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/auto-update.js

@@ -310,11 +310,18 @@ async function checkForUpdate() {
     if (isDevMode()) return null;
 
     const state = readState();
+    // manifest.version is authoritative — /plugin update writes it directly and
+    // bypasses auto-update.js, so re-sync state.installedVersion every call.
+    const installedVersion = readManifest().version || '0.0.0';
 
     // Time-based throttle
     if (!shouldCheck(state)) {
-      if (state.updateAvailable && state.latestVersion) {
-        return { updateAvailable: true, from: state.installedVersion, to: state.latestVersion };
+      if (state.installedVersion !== installedVersion) {
+        saveState({ ...state, installedVersion });
+      }
+      if (state.updateAvailable && state.latestVersion
+          && compareVersions(state.latestVersion, installedVersion) > 0) {
+        return { updateAvailable: true, from: installedVersion, to: state.latestVersion };
       }
       return null;
     }
@@ -322,21 +329,19 @@ async function checkForUpdate() {
     // Check GitHub for latest release
     const latest = await fetchLatestRelease();
     if (!latest) {
-      saveState({ ...state, lastCheck: new Date().toISOString() });
+      saveState({ ...state, installedVersion, lastCheck: new Date().toISOString() });
       return null;
     }
 
     // Compare versions
-    const manifest = readManifest();
-    const currentVersion = manifest.version || '0.0.0';
-    const hasUpdate = compareVersions(latest.version, currentVersion) > 0;
+    const hasUpdate = compareVersions(latest.version, installedVersion) > 0;
 
     if (hasUpdate) {
       const result = await downloadAndInstall(latest);
       const success = result.pluginUpdated;
       const newState = {
         lastCheck: new Date().toISOString(),
-        installedVersion: success ? latest.version : currentVersion,
+        installedVersion: success ? latest.version : installedVersion,
         latestVersion: latest.version,
         updateAvailable: !success,
         lastUpdate: success ? new Date().toISOString() : state.lastUpdate,
@@ -349,7 +354,7 @@ async function checkForUpdate() {
         updateAvailable: !success,
         updated: success,
         binaryUpdated: result.binaryUpdated,
-        from: currentVersion,
+        from: installedVersion,
         to: latest.version,
       };
     }
@@ -357,6 +362,7 @@ async function checkForUpdate() {
     // No update needed
     saveState({
       ...state,
+      installedVersion,
       lastCheck: new Date().toISOString(),
       latestVersion: latest.version,
       updateAvailable: false,

package/claude-plugin/scripts/auto-update.test.js

@@ -14,12 +14,14 @@ const {
   promoteVerifiedBinary,
 } = require('./auto-update');
 
-function mkDir(prefix) {
-  return fs.mkdtempSync(path.join(os.tmpdir(), prefix));
+function mkDir(t, prefix) {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
+  t.after(() => fs.rmSync(dir, { recursive: true, force: true }));
+  return dir;
 }
 
-test('getExtractedPluginVersion reads extracted plugin manifest version', () => {
-  const root = mkDir('code-graph-plugin-');
+test('getExtractedPluginVersion reads extracted plugin manifest version', (t) => {
+  const root = mkDir(t, 'code-graph-plugin-');
   const manifest = path.join(root, '.claude-plugin', 'plugin.json');
   fs.mkdirSync(path.dirname(manifest), { recursive: true });
   fs.writeFileSync(manifest, JSON.stringify({ version: '1.2.3' }, null, 2));
@@ -41,8 +43,8 @@ function writeFakeBinary(filePath, version) {
   fs.chmodSync(filePath, 0o755);
 }
 
-test('promoteVerifiedBinary accepts a runnable binary with the expected version', () => {
-  const dir = mkDir('code-graph-bin-');
+test('promoteVerifiedBinary accepts a runnable binary with the expected version', (t) => {
+  const dir = mkDir(t, 'code-graph-bin-');
   const tmp = path.join(dir, 'code-graph-mcp.tmp');
   const dst = path.join(dir, 'code-graph-mcp');
   writeFakeBinary(tmp, '1.2.3');
@@ -53,8 +55,8 @@ test('promoteVerifiedBinary accepts a runnable binary with the expected version'
   assert.equal(fs.existsSync(dst), true);
 });
 
-test('promoteVerifiedBinary rejects binaries with mismatched version', () => {
-  const dir = mkDir('code-graph-bin-');
+test('promoteVerifiedBinary rejects binaries with mismatched version', (t) => {
+  const dir = mkDir(t, 'code-graph-bin-');
   const tmp = path.join(dir, 'code-graph-mcp.tmp');
   const dst = path.join(dir, 'code-graph-mcp');
   writeFakeBinary(tmp, '1.2.2');

package/claude-plugin/scripts/lifecycle.e2e.test.js

@@ -12,8 +12,10 @@ const lifecycleCli = path.join(__dirname, 'lifecycle.js');
 const compositeCli = path.join(__dirname, 'statusline-composite.js');
 const currentVersion = JSON.parse(fs.readFileSync(path.join(repoRoot, 'package.json'), 'utf8')).version;
 
-function mkHome() {
-  return fs.mkdtempSync(path.join(os.tmpdir(), 'code-graph-e2e-'));
+function mkHome(t) {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'code-graph-e2e-'));
+  t.after(() => fs.rmSync(dir, { recursive: true, force: true }));
+  return dir;
 }
 
 function writeJson(filePath, value) {
@@ -38,8 +40,8 @@ function runScript(homeDir, scriptPath, args = [], options = {}) {
   }).toString();
 }
 
-test('lifecycle CLI handles install, disable self-heal, re-enable, and uninstall', () => {
-  const homeDir = mkHome();
+test('lifecycle CLI handles install, disable self-heal, re-enable, and uninstall', (t) => {
+  const homeDir = mkHome(t);
   const settingsPath = path.join(homeDir, '.claude', 'settings.json');
   const installedPath = path.join(homeDir, '.claude', 'plugins', 'installed_plugins.json');
   const registryPath = path.join(homeDir, '.cache', 'code-graph', 'statusline-registry.json');

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

@@ -9,8 +9,10 @@ const { execFileSync } = require('child_process');
 const lifecyclePath = path.join(__dirname, 'lifecycle.js');
 const statuslinePath = path.join(__dirname, 'statusline.js');
 
-function mkHome() {
-  return fs.mkdtempSync(path.join(os.tmpdir(), 'code-graph-home-'));
+function mkHome(t) {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'code-graph-home-'));
+  t.after(() => fs.rmSync(dir, { recursive: true, force: true }));
+  return dir;
 }
 
 function writeJson(filePath, value) {
@@ -48,8 +50,8 @@ function seedOrphanedComposite(homeDir) {
   return { settingsPath, registryPath };
 }
 
-test('cleanupDisabledStatusline restores previous statusline and removes registry', () => {
-  const homeDir = mkHome();
+test('cleanupDisabledStatusline restores previous statusline and removes registry', (t) => {
+  const homeDir = mkHome(t);
   const { settingsPath, registryPath } = seedDisabledComposite(homeDir);
 
   const out = execFileSync(process.execPath, ['-e', `
@@ -63,10 +65,11 @@ test('cleanupDisabledStatusline restores previous statusline and removes registr
   assert.equal(fs.existsSync(registryPath), false);
 });
 
-test('statusline exits cleanly and self-heals when plugin is disabled', () => {
-  const homeDir = mkHome();
+test('statusline exits cleanly and self-heals when plugin is disabled', (t) => {
+  const homeDir = mkHome(t);
   const { settingsPath, registryPath } = seedDisabledComposite(homeDir);
   const projectDir = fs.mkdtempSync(path.join(os.tmpdir(), 'code-graph-project-'));
+  t.after(() => fs.rmSync(projectDir, { recursive: true, force: true }));
   fs.mkdirSync(path.join(projectDir, '.code-graph'), { recursive: true });
   fs.writeFileSync(path.join(projectDir, '.code-graph', 'index.db'), '');
 
@@ -81,8 +84,8 @@ test('statusline exits cleanly and self-heals when plugin is disabled', () => {
   assert.equal(fs.existsSync(registryPath), false);
 });
 
-test('cleanupDisabledStatusline also heals orphaned statusline after uninstall', () => {
-  const homeDir = mkHome();
+test('cleanupDisabledStatusline also heals orphaned statusline after uninstall', (t) => {
+  const homeDir = mkHome(t);
   const { settingsPath, registryPath } = seedOrphanedComposite(homeDir);
 
   const out = execFileSync(process.execPath, ['-e', `
@@ -175,8 +178,8 @@ test('removeHooksFromSettings strips our entries but keeps unrelated hooks', ()
   assert.ok(!s.hooks.PostToolUse, 'empty event key should be deleted');
 });
 
-test('install() removes legacy code-graph hooks from settings.json without re-registering', () => {
-  const homeDir = mkHome();
+test('install() removes legacy code-graph hooks from settings.json without re-registering', (t) => {
+  const homeDir = mkHome(t);
   const settingsPath = path.join(homeDir, '.claude', 'settings.json');
   writeJson(settingsPath, {
     statusLine: { type: 'command', command: 'echo previous-status' },

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,9 +83,34 @@ test('consistencyCheck returns empty array when binary version matches plugin',
   assert.ok(Array.isArray(result));
 });
 
-test('consistencyCheck returns version-mismatch when versions differ', () => {
+// ──────────────────────────────────────────────────────────────────────────
+// 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-'));
+  t.after(() => fs.rmSync(dir, { recursive: true, force: true }));
   const bin = path.join(dir, 'code-graph-mcp');
   fs.writeFileSync(bin, [
     '#!/usr/bin/env bash',

package/claude-plugin/scripts/version-utils.test.js

@@ -5,15 +5,17 @@ const fs = require('fs');
 const os = require('os');
 const path = require('path');
 
-function mkDir(prefix) {
-  return fs.mkdtempSync(path.join(os.tmpdir(), prefix));
+function mkDir(t, prefix) {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
+  t.after(() => fs.rmSync(dir, { recursive: true, force: true }));
+  return dir;
 }
 
 // ── readBinaryVersion ──
 
-test('readBinaryVersion returns version from valid binary', () => {
+test('readBinaryVersion returns version from valid binary', (t) => {
   const { readBinaryVersion } = require('./version-utils');
-  const dir = mkDir('vu-');
+  const dir = mkDir(t, 'vu-');
   const bin = path.join(dir, 'code-graph-mcp');
   fs.writeFileSync(bin, [
     '#!/usr/bin/env bash',
@@ -32,9 +34,9 @@ test('readBinaryVersion returns null for non-existent binary', () => {
   assert.equal(readBinaryVersion('/tmp/does-not-exist-binary'), null);
 });
 
-test('readBinaryVersion returns null for binary with unexpected output', () => {
+test('readBinaryVersion returns null for binary with unexpected output', (t) => {
   const { readBinaryVersion } = require('./version-utils');
-  const dir = mkDir('vu-');
+  const dir = mkDir(t, 'vu-');
   const bin = path.join(dir, 'code-graph-mcp');
   fs.writeFileSync(bin, '#!/usr/bin/env bash\necho "something else"');
   fs.chmodSync(bin, 0o755);
@@ -56,9 +58,9 @@ test('getNewestMtime returns 0 for non-existent directory', () => {
   assert.equal(getNewestMtime('/tmp/no-such-dir-xyz'), 0);
 });
 
-test('getNewestMtime finds newest .rs file mtime', () => {
+test('getNewestMtime finds newest .rs file mtime', (t) => {
   const { getNewestMtime } = require('./version-utils');
-  const dir = mkDir('vu-mtime-');
+  const dir = mkDir(t, 'vu-mtime-');
   const sub = path.join(dir, 'sub');
   fs.mkdirSync(sub);
 
@@ -75,9 +77,9 @@ test('getNewestMtime finds newest .rs file mtime', () => {
   assert.equal(result, newerMtime, 'should return exactly the newest file mtime');
 });
 
-test('getNewestMtime ignores non-matching extensions', () => {
+test('getNewestMtime ignores non-matching extensions', (t) => {
   const { getNewestMtime } = require('./version-utils');
-  const dir = mkDir('vu-ext-');
+  const dir = mkDir(t, 'vu-ext-');
   fs.writeFileSync(path.join(dir, 'file.js'), 'hello');
   assert.equal(getNewestMtime(dir, '.rs'), 0);
 });

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.3",
+  "version": "0.9.0",
   "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.3",
-    "@sdsrs/code-graph-linux-arm64": "0.8.3",
-    "@sdsrs/code-graph-darwin-x64": "0.8.3",
-    "@sdsrs/code-graph-darwin-arm64": "0.8.3",
-    "@sdsrs/code-graph-win32-x64": "0.8.3"
+    "@sdsrs/code-graph-linux-x64": "0.9.0",
+    "@sdsrs/code-graph-linux-arm64": "0.9.0",
+    "@sdsrs/code-graph-darwin-x64": "0.9.0",
+    "@sdsrs/code-graph-darwin-arm64": "0.9.0",
+    "@sdsrs/code-graph-win32-x64": "0.9.0"
   }
 }