@sdsrs/code-graph 0.7.12 → 0.7.14

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

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

package/claude-plugin/commands/impact.md

@@ -1,5 +1,5 @@
 ---
-description: Analyze impact scope before modifying a symbol
+description: Analyze blast radius before modifying a symbol. Use when about to edit/rename/remove a function, or asked about change risk and affected callers.
 argument-hint: <symbol_name>
 ---
 

package/claude-plugin/commands/rebuild.md

@@ -1,5 +1,5 @@
 ---
-description: Force a full code-graph index rebuild
+description: Force code-graph index rebuild. Use when search results seem stale or wrong, after major codebase restructuring, or when index health check reports issues.
 ---
 
 Run via Bash: `code-graph-mcp incremental-index`

package/claude-plugin/commands/status.md

@@ -1,5 +1,5 @@
 ---
-description: Show code-graph index status
+description: Show code-graph index health and coverage. Use when search returns unexpected results, checking if index is current, or diagnosing code-graph issues.
 ---
 
 !`code-graph-mcp health-check --format json 2>/dev/null || echo '{"error":"No index found"}'`

package/claude-plugin/commands/trace.md

@@ -1,5 +1,5 @@
 ---
-description: Trace call flow from a handler or route
+description: Trace call flow from a handler or route. Use when debugging API behavior, understanding request processing flow, or asked how an endpoint works.
 argument-hint: <handler_or_route>
 ---
 

package/claude-plugin/commands/understand.md

@@ -1,5 +1,5 @@
 ---
-description: Deep dive into a module or file's architecture
+description: Deep dive into a module's architecture. Use when starting work in an unfamiliar area, asked to explain how code works, or before implementing changes in a module.
 argument-hint: <file_or_dir_path>
 ---
 

package/claude-plugin/hooks/hooks.json

@@ -1,56 +1,4 @@
 {
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "tool == \"Edit\"",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/pre-edit-guide.js\"",
-            "timeout": 4
-          }
-        ],
-        "description": "Auto-inject impact analysis when editing function definitions with 2+ callers"
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "tool == \"Write\" || tool == \"Edit\"",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/incremental-index.js\"",
-            "timeout": 10
-          }
-        ],
-        "description": "Auto-update code graph index after file edits"
-      }
-    ],
-    "UserPromptSubmit": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/user-prompt-context.js\"",
-            "timeout": 5
-          }
-        ],
-        "description": "Inject code-graph structural context (impact, overview, callgraph) based on user intent"
-      }
-    ],
-    "SessionStart": [
-      {
-        "matcher": "startup",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/session-init.js\"",
-            "timeout": 5
-          }
-        ],
-        "description": "StatusLine self-heal, lifecycle sync, project map injection at session start"
-      }
-    ]
-  }
+  "_note": "Hooks registered to settings.json by lifecycle.js — hooks.json auto-loading is unreliable",
+  "hooks": {}
 }

package/claude-plugin/scripts/lifecycle.js

@@ -150,7 +150,8 @@ function cleanupDisabledStatusline() {
     return { cleaned: false, settingsChanged: false };
   }
 
-  const settingsChanged = detachStatuslineIntegration(settings);
+  let settingsChanged = detachStatuslineIntegration(settings);
+  if (removeHooksFromSettings(settings)) settingsChanged = true;
   if (settingsChanged) {
     writeJsonAtomic(SETTINGS_PATH, settings);
   }
@@ -216,6 +217,91 @@ function migrateOldPluginIds(settings) {
   return changed;
 }
 
+// --- Hook Registration ---
+// Plugin system's hooks.json auto-loading is unreliable (observed across GSD,
+// superpowers, code-graph-mcp). Write hooks directly to settings.json instead.
+// Same strategy as claude-mem-lite. hooks.json is kept empty to prevent double-firing.
+
+const OUR_HOOK_SCRIPTS = ['session-init.js', 'incremental-index.js', 'user-prompt-context.js', 'pre-edit-guide.js'];
+
+function isOurHookEntry(entry) {
+  if (!entry || !entry.hooks) return false;
+  return entry.hooks.some(h =>
+    h.command && OUR_HOOK_SCRIPTS.some(s => h.command.includes(s)) &&
+    h.command.includes('code-graph')
+  );
+}
+
+function hookCommand(scriptName) {
+  return `node ${JSON.stringify(path.join(PLUGIN_ROOT, 'scripts', scriptName))}`;
+}
+
+function getHookDefinitions() {
+  return {
+    SessionStart: [{
+      matcher: 'startup|clear|compact',
+      hooks: [{ type: 'command', command: hookCommand('session-init.js'), timeout: 5 }],
+      description: 'StatusLine self-heal, lifecycle sync, project map injection',
+    }],
+    PreToolUse: [{
+      matcher: 'tool == "Edit"',
+      hooks: [{ type: 'command', command: hookCommand('pre-edit-guide.js'), timeout: 4 }],
+      description: 'Auto-inject impact analysis when editing functions with 2+ callers',
+    }],
+    PostToolUse: [{
+      matcher: 'tool == "Write" || tool == "Edit"',
+      hooks: [{ type: 'command', command: hookCommand('incremental-index.js'), timeout: 10 }],
+      description: 'Auto-update code graph index after file edits',
+    }],
+    UserPromptSubmit: [{
+      matcher: '',
+      hooks: [{ type: 'command', command: hookCommand('user-prompt-context.js'), timeout: 5 }],
+      description: 'Inject code-graph structural context based on user intent',
+    }],
+  };
+}
+
+function registerHooksToSettings(settings) {
+  if (!settings.hooks) settings.hooks = {};
+  const defs = getHookDefinitions();
+  let changed = false;
+
+  for (const [event, newEntries] of Object.entries(defs)) {
+    if (!settings.hooks[event]) settings.hooks[event] = [];
+
+    for (const newEntry of newEntries) {
+      const existingIdx = settings.hooks[event].findIndex(e => isOurHookEntry(e));
+      if (existingIdx >= 0) {
+        if (JSON.stringify(settings.hooks[event][existingIdx]) !== JSON.stringify(newEntry)) {
+          settings.hooks[event][existingIdx] = newEntry;
+          changed = true;
+        }
+      } else {
+        settings.hooks[event].push(newEntry);
+        changed = true;
+      }
+    }
+  }
+
+  return changed;
+}
+
+function removeHooksFromSettings(settings) {
+  if (!settings.hooks) return false;
+  let changed = false;
+
+  for (const event of Object.keys(settings.hooks)) {
+    if (!Array.isArray(settings.hooks[event])) continue;
+    const before = settings.hooks[event].length;
+    settings.hooks[event] = settings.hooks[event].filter(e => !isOurHookEntry(e));
+    if (settings.hooks[event].length !== before) changed = true;
+    if (settings.hooks[event].length === 0) delete settings.hooks[event];
+  }
+  if (Object.keys(settings.hooks).length === 0) delete settings.hooks;
+
+  return changed;
+}
+
 // --- Install (idempotent) ---
 
 function install() {
@@ -247,16 +333,21 @@ function install() {
   // Register code-graph provider
   registerStatuslineProvider('code-graph', codeGraphStatuslineCommand(), false);
 
+  // 2. Hooks — register to settings.json (hooks.json auto-loading unreliable)
+  if (registerHooksToSettings(settings)) {
+    settingsChanged = true;
+  }
+
   // NOTE: enabledPlugins is managed by Claude Code's plugin system, not by lifecycle.
   // Do NOT add enabledPlugins entries here — it causes phantom plugin entries
   // when the ID doesn't match the marketplace name.
 
-  // 2. Write settings atomically if changed
+  // 3. Write settings atomically if changed
   if (settingsChanged) {
     writeJsonAtomic(SETTINGS_PATH, settings);
   }
 
-  // 3. Write manifest with version
+  // 4. Write manifest with version
   manifest.version = version;
   manifest.installedAt = manifest.installedAt || new Date().toISOString();
   manifest.updatedAt = new Date().toISOString();
@@ -277,7 +368,12 @@ function uninstall() {
       settingsChanged = true;
     }
 
-    // 2. Remove all known IDs from enabledPlugins
+    // 2. Hooks: remove from settings.json
+    if (removeHooksFromSettings(settings)) {
+      settingsChanged = true;
+    }
+
+    // 3. Remove all known IDs from enabledPlugins
     if (settings.enabledPlugins) {
       for (const id of [PLUGIN_ID, ...OLD_PLUGIN_IDS]) {
         if (id in settings.enabledPlugins) {
@@ -287,13 +383,13 @@ function uninstall() {
       }
     }
 
-    // 3. Write settings if changed
+    // 4. Write settings if changed
     if (settingsChanged) {
       writeJsonAtomic(SETTINGS_PATH, settings);
     }
   }
 
-  // 4. Remove all known IDs from installed_plugins.json
+  // 5. Remove all known IDs from installed_plugins.json
   const installedPlugins = readJson(INSTALLED_PLUGINS_PATH);
   if (installedPlugins && installedPlugins.plugins) {
     let ipChanged = false;
@@ -306,10 +402,10 @@ function uninstall() {
     if (ipChanged) writeJsonAtomic(INSTALLED_PLUGINS_PATH, installedPlugins);
   }
 
-  // 5. Remove cache directory
+  // 6. Remove cache directory
   try { fs.rmSync(CACHE_DIR, { recursive: true, force: true }); } catch { /* ok */ }
 
-  // 6. Remove plugin files from cache (all known paths, including parent dirs)
+  // 7. Remove plugin files from cache (all known paths, including parent dirs)
   const pluginCacheDirs = [
     path.join(os.homedir(), '.claude', 'plugins', 'cache', MARKETPLACE_NAME),
     path.join(os.homedir(), '.claude', 'plugins', 'cache', 'sdsrss-code-graph'),
@@ -348,23 +444,28 @@ function update() {
   // 2. Update code-graph provider in registry
   registerStatuslineProvider('code-graph', codeGraphStatuslineCommand(), false);
 
+  // 3. Hooks — update command paths
+  if (registerHooksToSettings(settings)) {
+    settingsChanged = true;
+  }
+
   // NOTE: enabledPlugins is managed by Claude Code's plugin system, not by lifecycle.
 
-  // 3. Write settings if changed
+  // 4. Write settings if changed
   if (settingsChanged) {
     writeJsonAtomic(SETTINGS_PATH, settings);
   }
 
-  // 4. Clear update-check cache (force re-check after update)
+  // 5. Clear update-check cache (force re-check after update)
   const updateCache = path.join(CACHE_DIR, 'update-check');
   try { fs.unlinkSync(updateCache); } catch { /* ok */ }
 
-  // 5. Update manifest
+  // 6. Update manifest
   manifest.version = version;
   manifest.updatedAt = new Date().toISOString();
   writeManifest(manifest);
 
-  // 6. Clean up old cached versions (keep latest 3)
+  // 7. Clean up old cached versions (keep latest 3)
   cleanupOldCacheVersions(3);
 
   return { oldVersion, version, settingsChanged };
@@ -411,6 +512,7 @@ module.exports = {
   readManifest, readJson, writeJsonAtomic,
   readRegistry, writeRegistry,
   getPluginVersion, cleanupOldCacheVersions,
+  registerHooksToSettings, removeHooksFromSettings, getHookDefinitions,
   PLUGIN_ID, OLD_PLUGIN_IDS, MARKETPLACE_NAME, CACHE_DIR, REGISTRY_FILE,
 };
 

package/claude-plugin/scripts/pre-edit-guide.js

@@ -47,6 +47,45 @@ for (const pat of fnPatterns) {
   }
 }
 
+// Fallback: if old_string is inside a function body (not a definition),
+// extract a unique identifier from the code and grep for it to find the containing function
+if (!symbol || symbol.length < 3) {
+  const filePath = (input.tool_input && input.tool_input.file_path) || '';
+  if (filePath && oldStr.length >= 10) {
+    try {
+      // Extract identifiers from old_string, try the most specific one first
+      const identifiers = (oldStr.match(/\b([a-z]\w*(?:_\w+)+|[a-z]\w*(?:[A-Z]\w*)+|[A-Z]\w+\.\w+|[A-Z]\w+::\w+)\b/g) || [])
+        .filter(id => id.length >= 6);
+      const skipWords = new Set(['return', 'function', 'default', 'require', 'module', 'exports', 'import', 'console']);
+      // Sort by length descending (longer = more specific = fewer matches)
+      const candidates = [...new Set(identifiers)]
+        .filter(id => !skipWords.has(id.toLowerCase()))
+        .sort((a, b) => b.length - a.length);
+      for (const candidate of candidates.slice(0, 5)) {
+        try {
+          const raw = execFileSync('code-graph-mcp', ['grep', candidate, filePath, '--json'], {
+            cwd, timeout: 2000, encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'],
+          });
+          const grepResult = JSON.parse(raw);
+          // Pick this candidate if it has few matches (precise location)
+          const withContainer = (grepResult || []).filter(m => m.container && m.container.name);
+          if (withContainer.length > 0 && withContainer.length <= 5) {
+            // If multiple containers, vote for the most common one
+            const votes = {};
+            for (const m of withContainer) {
+              const cn = m.container.name;
+              votes[cn] = (votes[cn] || 0) + 1;
+            }
+            const best = Object.entries(votes).sort((a, b) => b[1] - a[1])[0][0];
+            symbol = best.includes('.') ? best.split('.').pop() : best.includes('::') ? best.split('::').pop() : best;
+            break;
+          }
+        } catch { /* try next candidate */ }
+      }
+    } catch { /* grep failed or no match — fall through */ }
+  }
+}
+
 if (!symbol || symbol.length < 3) process.exit(0);
 
 // Skip common patterns that aren't real function names

package/claude-plugin/scripts/user-prompt-context.js

@@ -95,12 +95,20 @@ if (/^(修复|优化|实施|执行|开始|按|实测|帮我|进入|用|重新)/.
 const filePaths = (message.match(/(?:src|lib|test|pkg|cmd|internal|app|components?)\/[\w/.-]+/g) || [])
   .slice(0, 2);
 
-// Extract potential symbol names (camelCase, snake_case, PascalCase, qualified like Foo::bar)
-const symbolCandidates = (message.match(/\b(?:[A-Z]\w*(?:::\w+)+|[a-z]\w*(?:_\w+){1,}|[a-z]\w*(?:[A-Z]\w*)+|[A-Z][a-z]+(?:[A-Z][a-z]+)+)\b/g) || [])
+// Extract potential symbol names (camelCase, snake_case, PascalCase, qualified like Foo::bar, Foo.bar, Foo::bar::baz)
+const symbolCandidates = (message.match(/\b(?:[A-Z]\w*(?:(?:::|\.)\w+)+|[a-z]\w*(?:_\w+){1,}|[a-z]\w*(?:[A-Z]\w*)+|[A-Z][a-z]+(?:[A-Z][a-z]+)+)\b/g) || [])
   .filter(s => s.length > 4)
   .filter(s => !STOP_WORDS.has(s.toLowerCase()))
   .slice(0, 3);
 
+// Fallback: extract backtick-quoted symbols (common in mixed Chinese+code: "修改 `parse_code` 函数")
+if (symbolCandidates.length === 0) {
+  const backtickSymbols = (message.match(/`([a-zA-Z_]\w{2,})`/g) || [])
+    .map(s => s.replace(/`/g, ''))
+    .filter(s => s.length >= 3 && !STOP_WORDS.has(s.toLowerCase()));
+  symbolCandidates.push(...backtickSymbols.slice(0, 3));
+}
+
 // Fallback: plain lowercase words (8+ chars) likely to be function/type names.
 // Only when strict patterns found nothing — avoids false positives from English prose.
 // Minimum 8 chars filters most common English words while keeping technical terms

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdsrs/code-graph",
-  "version": "0.7.12",
+  "version": "0.7.14",
   "description": "MCP server that indexes codebases into an AST knowledge graph with semantic search, call graph traversal, and HTTP route tracing",
   "license": "MIT",
   "repository": {
@@ -27,16 +27,17 @@
     "claude-plugin"
   ],
   "scripts": {
-    "build": "cargo build --release --no-default-features && node scripts/copy-binary.js"
+    "build": "cargo build --release --no-default-features && node scripts/copy-binary.js",
+    "prepare": "git rev-parse --git-dir > /dev/null 2>&1 && ln -sf ../../scripts/pre-commit.sh .git/hooks/pre-commit || true"
   },
   "engines": {
     "node": ">=16"
   },
   "optionalDependencies": {
-    "@sdsrs/code-graph-linux-x64": "0.7.12",
-    "@sdsrs/code-graph-linux-arm64": "0.7.12",
-    "@sdsrs/code-graph-darwin-x64": "0.7.12",
-    "@sdsrs/code-graph-darwin-arm64": "0.7.12",
-    "@sdsrs/code-graph-win32-x64": "0.7.12"
+    "@sdsrs/code-graph-linux-x64": "0.7.14",
+    "@sdsrs/code-graph-linux-arm64": "0.7.14",
+    "@sdsrs/code-graph-darwin-x64": "0.7.14",
+    "@sdsrs/code-graph-darwin-arm64": "0.7.14",
+    "@sdsrs/code-graph-win32-x64": "0.7.14"
   }
 }