@sdsrs/code-graph 0.5.33 → 0.5.35

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

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

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

@@ -17,8 +17,8 @@ try {
 fs.writeFileSync(flag, '');
 process.stdout.write(
   '[code-graph] For code structure understanding, try code-graph first (one call vs many):\n' +
-  '  project_map → full architecture overview\n' +
-  '  module_overview(path) → module structure, exports, hot paths\n' +
-  '  get_call_graph(symbol) → trace call chains\n' +
+  '  project_map(compact=true) \u2192 full architecture overview\n' +
+  '  module_overview(path, compact=true) \u2192 module structure, exports, hot paths\n' +
+  '  get_call_graph(symbol, compact=true) \u2192 trace call chains\n' +
   'Explore agents remain best for: non-code files, runtime behavior, open-ended investigation.\n'
 );

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

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 'use strict';
 // PreToolUse hook: On FIRST Glob call per session window, suggest
-// code-graph tools when exploring project structure (not finding specific files).
+// code-graph tools — but only when exploring project structure,
+// NOT finding specific files by name.
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
@@ -14,10 +15,24 @@ try {
   if (Date.now() - stat.mtimeMs < WINDOW_MS) process.exit(0);
 } catch { /* first time */ }
 
+// Parse tool input to detect intent — skip for specific file lookups
+try {
+  const input = JSON.parse(fs.readFileSync('/dev/stdin', 'utf8'));
+  const pattern = (input && input.tool_input && input.tool_input.pattern) || '';
+  // Skip suggestion for: specific file patterns (has extension), config files, specific names
+  if (/\.(json|yaml|yml|toml|md|txt|env|lock|config|rc)$/i.test(pattern)) {
+    process.exit(0);
+  }
+  // Skip for patterns with specific filenames (not just wildcards like **/*.ts)
+  if (!pattern.includes('*') && /[\w-]+\.\w{1,5}$/.test(pattern)) {
+    process.exit(0);
+  }
+} catch { /* stdin not available or parse error — show guide anyway */ }
+
 fs.writeFileSync(flag, '');
 process.stdout.write(
   '[code-graph] If exploring project structure (not finding specific files):\n' +
-  '  project_map → all modules, their files, key symbols, and dependencies\n' +
-  '  module_overview(path) → files and exports within a module\n' +
+  '  project_map(compact=true) \u2192 all modules, files, key symbols, dependencies\n' +
+  '  module_overview(path, compact=true) \u2192 files and exports within a module\n' +
   'Glob remains best for: finding specific files, configs, non-code assets.\n'
 );

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

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 'use strict';
 // PreToolUse hook: On FIRST Grep call per session window, suggest
-// code-graph tools as complementary options for code understanding.
+// code-graph tools — but only when the pattern looks like code understanding
+// (function names, module patterns), NOT exact string/constant searches.
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
@@ -14,11 +15,25 @@ try {
   if (Date.now() - stat.mtimeMs < WINDOW_MS) process.exit(0);
 } catch { /* first time */ }
 
+// Parse tool input to detect intent — skip for literal/constant searches
+try {
+  const input = JSON.parse(fs.readFileSync('/dev/stdin', 'utf8'));
+  const pattern = (input && input.tool_input && input.tool_input.pattern) || '';
+  // Skip suggestion for: quoted strings, TODO/FIXME, constants, exact literals, error messages
+  if (/^["']|^(TODO|FIXME|HACK|WARN|ERROR|const )|^\w+[=:]/i.test(pattern)) {
+    process.exit(0);
+  }
+  // Skip for very short patterns (likely exact match)
+  if (pattern.length <= 3) {
+    process.exit(0);
+  }
+} catch { /* stdin not available or parse error — show guide anyway */ }
+
 fs.writeFileSync(flag, '');
 process.stdout.write(
   '[code-graph] For understanding code relationships, these tools complement Grep:\n' +
-  '  get_call_graph(symbol) → who calls X / what X calls (vs Grep + Read ×N)\n' +
-  '  module_overview(path) → module exports, structure, hot paths\n' +
-  '  semantic_code_search(query) → find code by concept across indexed files\n' +
+  '  get_call_graph(symbol, compact=true) \u2192 who calls X / what X calls\n' +
+  '  semantic_code_search(query, compact=true) \u2192 find code by concept\n' +
+  '  module_overview(path, compact=true) \u2192 module exports and structure\n' +
   'Grep remains best for: exact strings, regex, constants, non-code files.\n'
 );

package/claude-plugin/skills/code-navigation.md

@@ -1,30 +1,35 @@
 ---
 name: code-navigation
-description: PROACTIVE code-graph tool selection. Triggers automatically when you need to explore, understand, trace, or modify code. Use BEFORE choosing Grep/Read for code understanding tasks — code-graph tools save 10-40x tokens. Especially critical before modifying functions (impact_analysis first).
+description: PROACTIVE code-graph tool selection. Triggers automatically when you need to explore, understand, trace, or modify code. Use BEFORE choosing Grep/Read for code understanding tasks — code-graph tools save 5-20x tokens. Especially critical before modifying functions (impact_analysis first).
 ---
 
 # Code Navigation Rules
 
-This project has a code-graph MCP server. These tools return structured, token-efficient results.
-**Use them as your PRIMARY navigation method. Fall back to Grep/Read only for exact-match or file editing.**
+This project has a code-graph MCP server. The MCP instructions (injected at session start) are the authoritative decision table.
 
-## Decision Rules
+**Key principle: code-graph tools SUPERSEDE Grep/Agent for code understanding. Use compact=true for browsing, full when you need signatures or will edit.**
 
-| Task | MUST use | NOT this | Token savings |
-|---|---|---|---|
-| Who calls X / what X calls | `get_call_graph` | Grep + Read ×5 | 13x |
-| Understand module/directory | `module_overview` | Read multiple files | 20x |
-| **Before modifying a function** | `impact_analysis` FIRST | Just Edit | prevents breakage |
-| Find code by concept/meaning | `semantic_code_search` | Grep multiple patterns | 10x |
-| Trace HTTP request flow | `trace_http_chain` | Read router→handler→service | 10x |
-| One symbol's signature+relations | `get_ast_node` | Read entire file | 10x |
-| File import/export dependencies | `dependency_graph` | Grep import statements | 5x |
-| Find similar/duplicate code | `find_similar_code` | Grep partial names | 5x |
-| Read code of a search result | `get_ast_node` (by node_id) | Read entire file | 3x |
+## Quick Reference
+
+| Task | Tool | Savings |
+|---|---|---|
+| Architecture overview | `project_map(compact=true)` | 20x vs Read multiple |
+| Who calls X / what X calls | `get_call_graph(symbol, compact=true)` | 13x vs Grep+Read |
+| Understand module/directory | `module_overview(path, compact=true)` | 20x vs Read files |
+| **Before modifying a function** | `impact_analysis(symbol)` FIRST | prevents breakage |
+| Find code by concept | `semantic_code_search(query, compact=true)` | 10x vs Grep |
+| Trace HTTP request flow | `trace_http_chain(route)` | 10x vs Read |
+| Symbol signature+relations | `get_ast_node(node_id)` | 10x vs Read file |
+| File dependencies | `dependency_graph(file)` | 5x vs Grep |
+
+## Workflow Patterns
+
+1. **Quick lookup**: `semantic_code_search(compact=true)` → `get_ast_node(node_id=N)`
+2. **Before edit**: `impact_analysis(symbol)` → Edit
+3. **Understand**: `project_map(compact=true)` → `module_overview(path, compact=true)` → `get_call_graph(symbol)`
 
 ## When to use native tools instead
 
 - **Grep**: exact string match, constants, regex patterns, literal text search
 - **Glob**: find files by name/path pattern
 - **Read**: specific file you already know and need to edit
-- **Write/Edit**: creating or modifying files

package/package.json

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