@sdsrs/code-graph 0.16.9 → 0.17.1

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

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

package/claude-plugin/scripts/adopt.js

@@ -23,17 +23,17 @@ function readAdoptedBy(filePath) {
     return m ? m[1] : null;
   } catch { return null; }
 }
-const INDEX_LINE = [
-  '- [code-graph-mcp](plugin_code_graph_mcp.md) — v0.10.0 起 tools/list 默认 7 核心 + 5 隐藏可调（省启动 token）',
-  '  - 核心 7（默认暴露）：`get_call_graph`/`module_overview`/`semantic_code_search`/`ast_search`/`find_references`/`get_ast_node`/`project_map`',
-  '  - 进阶 5（隐藏按名可调）：`impact_analysis`/`trace_http_chain`/`dependency_graph`/`find_similar_code`/`find_dead_code`',
-  '  - 场景速查（优先于 Grep）：',
-  '    - 改 X 影响面 → `get_ast_node symbol=X include_impact=true`（或 CLI `code-graph-mcp impact X`）',
-  '    - 谁调用 X / X 被谁用 → `get_call_graph X` 或 `find_references X`',
-  '    - 看 X 源码 / 签名 → `get_ast_node symbol=X`',
-  '    - Y 模块长啥样 → `module_overview` 或 CLI `code-graph-mcp overview Y/`',
-  '    - 概念查询（不知精确名）→ `semantic_code_search "Z"`；字面匹配用 Grep',
-].join('\n');
+// One-liner per MEMORY.md spec ("each entry should be one line"). All routing
+// triggers from prior multi-line block preserved verbatim — collapsing to single
+// line is a structural fix, not a signal change. Decision table lives in the
+// linked plugin_code_graph_mcp.md; this line is the router. Tag syntax
+// `[tag1, tag2]` per spec for explicit keyword matching.
+const INDEX_LINE =
+  '- [code-graph-mcp](plugin_code_graph_mcp.md) ' +
+  '[impact, callgraph, refs, overview, semantic, ast-search, dead-code, similar, deps, trace] — ' +
+  '改 X 影响面/谁调用 X/X 被谁用/看 X 源码/Y 模块长啥样/概念查询 优先于 Grep；字面匹配走 Grep。' +
+  '核心 7（get_call_graph/module_overview/semantic_code_search/ast_search/find_references/get_ast_node/project_map）' +
+  '+ 进阶 5（impact_analysis/trace_http_chain/dependency_graph/find_similar_code/find_dead_code），决策表见全文';
 const TEMPLATE_PATH = path.resolve(__dirname, '..', 'templates', 'plugin_code_graph_mcp.md');
 const TARGET_NAME = 'plugin_code_graph_mcp.md';
 
@@ -266,9 +266,12 @@ 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`);
-    // 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');
+    // v0.17.0: SessionStart project_map injection is OFF by default (regardless
+    // of adoption). Adoption now only governs MEMORY.md sentinel + decision-table
+    // refresh; the noisy hook needs an explicit opt-in.
+    lines.push('[code-graph] Active. SessionStart project_map injection: OFF (default).');
+    lines.push('[code-graph] Opt in to map dump:  CODE_GRAPH_VERBOSE_HOOKS=1');
+    lines.push('[code-graph] Legacy override:     CODE_GRAPH_QUIET_HOOKS=0 (force noisy) / =1 (force quiet)');
     return lines.join('\n');
   }
   if (action === 'unadopt') {

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

@@ -11,13 +11,22 @@ const {
 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 = {} } = {}) {
+// v0.17.0 — quietHooks: unconditional quiet 默认。
+// 项目地图与 MEMORY.md plugin contract + on-demand `project_map` 工具高度重叠，
+// 默认每次 SessionStart 都注入 ≈2.3 KB 是不必要的常驻上下文成本。
+// 优先级（高到低）：
+//   1. legacy CODE_GRAPH_QUIET_HOOKS='0'  → forced noisy（向后兼容）
+//   2. legacy CODE_GRAPH_QUIET_HOOKS='1'  → forced quiet（向后兼容）
+//   3. CODE_GRAPH_VERBOSE_HOOKS='1'       → opt-in noisy（新）
+//   4. 默认                                 → quiet
+// `adopted` 参数已弃用（unconditional 默认不再依赖该信号），保留接口签名只为
+// 不破坏既有调用 / 测试。
+function computeQuietHooks({ env = {} } = {}) {
   const envQuiet = env.CODE_GRAPH_QUIET_HOOKS;
   if (envQuiet === '0') return false;
   if (envQuiet === '1') return true;
-  return !!adopted;
+  if (env.CODE_GRAPH_VERBOSE_HOOKS === '1') return false;
+  return true;
 }
 
 function launchBackgroundAutoUpdate(spawnFn = spawn, env = process.env) {
@@ -277,10 +286,11 @@ function runSessionInit() {
     }
   }
 
-  // quietHooks: adopted → quiet by default (rely on MEMORY.md pointer + on-demand
-  // project_map tool); env '1'/'0' overrides for explicit control.
+  // quietHooks: default quiet (project_map injection duplicates MEMORY.md +
+  // on-demand tool). CODE_GRAPH_VERBOSE_HOOKS=1 to opt in to the dump;
+  // legacy CODE_GRAPH_QUIET_HOOKS=0/1 still force the old behavior.
   const adopted = isAdopted();
-  const quietHooks = computeQuietHooks({ adopted, env: process.env });
+  const quietHooks = computeQuietHooks({ env: process.env });
 
   const mapInjected = binaryCheck.available && !quietHooks ? injectProjectMap() : false;
   const consistencyIssues = binaryCheck.available

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

@@ -84,27 +84,46 @@ test('consistencyCheck returns empty array when binary version matches plugin',
 });
 
 // ──────────────────────────────────────────────────────────────────────────
-// v0.9.0 — quietHooks inference from adopted state
+// v0.17.0 — quietHooks: unconditional quiet default
+// Priority: legacy QUIET_HOOKS=0/1 > new VERBOSE_HOOKS=1 > default true.
+// `adopted` param is dead (unconditional default does not consult it) but
+// the destructured signature still accepts it for backward compat.
 // ──────────────────────────────────────────────────────────────────────────
 
-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: legacy QUIET_HOOKS="0" forces noisy', () => {
+  assert.equal(computeQuietHooks({ 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: legacy QUIET_HOOKS="1" forces quiet', () => {
+  assert.equal(computeQuietHooks({ 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: VERBOSE_HOOKS="1" opts in to noisy', () => {
+  assert.equal(computeQuietHooks({ env: { CODE_GRAPH_VERBOSE_HOOKS: '1' } }), false);
+});
+
+test('computeQuietHooks: legacy QUIET_HOOKS="1" wins over VERBOSE_HOOKS="1"', () => {
+  // Conflicting opt-ins: legacy explicit-quiet wins over new verbose opt-in.
+  // (Legacy QUIET_HOOKS="0" + VERBOSE_HOOKS="1" both mean noisy — no conflict.)
+  assert.equal(
+    computeQuietHooks({ env: { CODE_GRAPH_QUIET_HOOKS: '1', CODE_GRAPH_VERBOSE_HOOKS: '1' } }),
+    true
+  );
+});
+
+test('computeQuietHooks: env unset → quiet by default', () => {
+  assert.equal(computeQuietHooks({ env: {} }), true);
+});
+
+test('computeQuietHooks: no args → quiet by default', () => {
+  assert.equal(computeQuietHooks(), true);
 });
 
-test('computeQuietHooks: env unset, no env arg → follows adopted state', () => {
-  assert.equal(computeQuietHooks({ adopted: true }), true);
-  assert.equal(computeQuietHooks({ adopted: false }), false);
+test('computeQuietHooks: legacy `adopted` param is ignored under new default', () => {
+  // adopted=true used to imply quiet; now quiet is unconditional.
+  // adopted=false used to imply noisy; now still quiet by default.
+  assert.equal(computeQuietHooks({ adopted: true, env: {} }), true);
+  assert.equal(computeQuietHooks({ adopted: false, env: {} }), true);
 });
 
 test('consistencyCheck returns version-mismatch when versions differ', (t) => {

package/claude-plugin/templates/plugin_code_graph_mcp.md

@@ -8,13 +8,19 @@ type: reference
 > Invited-memory 模式：MCP `instructions` 仅留指针，决策细则集中在此。
 >
 > **v0.9.0 起**：插件（`/plugin install`）模式下首次 SessionStart 自动 adopt，
-> 本文件自动写入，自动切换 quietHooks（跳过每次 project_map 注入）。
+> 本文件自动写入到项目 memory 目录。
 > 退出：`CODE_GRAPH_NO_AUTO_ADOPT=1` 阻止，`code-graph-mcp unadopt` 回退。
-> 手动强控：`CODE_GRAPH_QUIET_HOOKS=0` 强制注入 / `=1` 强制静默（覆盖 adoption 推导）。
 >
 > **v0.11.0 起**：已 adopt 的项目在下次 SessionStart 会自动对齐到插件 shipped
 > 的最新决策表（本文件 SHA 与 template 差异时覆盖）。手动编辑会被覆盖——
 > 要锁定自己的版本，设 `CODE_GRAPH_NO_TEMPLATE_REFRESH=1`（不影响首次 adopt）。
+>
+> **v0.17.0 起**：SessionStart `project_map` 注入 **默认 OFF**（不再随 adoption
+> 切换）。本文件 + 7 个工具描述已经覆盖路由所需的全部决策信息，每次会话再
+> dump ≈2.3 KB 的项目地图是冗余的常驻上下文成本。
+> 显式启用：`CODE_GRAPH_VERBOSE_HOOKS=1` —— Bash 调 `code-graph-mcp map --compact`
+> 也是等价的按需替代。
+> 向后兼容：`CODE_GRAPH_QUIET_HOOKS=0` 强制 noisy / `=1` 强制 quiet（优先级最高）。
 
 ## 何时调用 MCP/CLI（替代多步 Grep/Read）
 
@@ -100,7 +106,8 @@ code-graph-mcp health-check              # 索引健康
 
 ## 卸载 / 回退
 
-- `code-graph-mcp unadopt` — 精确移除 sentinel 段 + 本文件，quietHooks 自动回到 false（下次 SessionStart 恢复 project_map 注入）。
+- `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_QUIET_HOOKS=0` — 强制恢复 project_map 注入（即使已 adopted）。
+- `CODE_GRAPH_VERBOSE_HOOKS=1`（v0.17.0+） — opt in 到 SessionStart `project_map` 注入（默认 OFF）。
+- `CODE_GRAPH_QUIET_HOOKS=0` — 强制恢复 `project_map` 注入；优先级高于 VERBOSE_HOOKS（向后兼容路径）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdsrs/code-graph",
-  "version": "0.16.9",
+  "version": "0.17.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.16.9",
-    "@sdsrs/code-graph-linux-arm64": "0.16.9",
-    "@sdsrs/code-graph-darwin-x64": "0.16.9",
-    "@sdsrs/code-graph-darwin-arm64": "0.16.9",
-    "@sdsrs/code-graph-win32-x64": "0.16.9"
+    "@sdsrs/code-graph-linux-x64": "0.17.1",
+    "@sdsrs/code-graph-linux-arm64": "0.17.1",
+    "@sdsrs/code-graph-darwin-x64": "0.17.1",
+    "@sdsrs/code-graph-darwin-arm64": "0.17.1",
+    "@sdsrs/code-graph-win32-x64": "0.17.1"
   }
 }