@sdsrs/code-graph 0.5.6 → 0.5.7

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

@@ -4,6 +4,6 @@
   "author": {
     "name": "sdsrs"
   },
-  "version": "0.5.6",
+  "version": "0.5.7",
   "keywords": ["code-graph", "ast", "navigation", "mcp", "knowledge-graph"]
 }

package/claude-plugin/hooks/hooks.json

@@ -13,15 +13,15 @@
         "description": "Suggest code-graph alternatives on first Grep call"
       },
       {
-        "matcher": "tool == \"Read\"",
+        "matcher": "tool == \"Glob\"",
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/pre-read-guide.js\"",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/pre-glob-guide.js\"",
             "timeout": 2
           }
         ],
-        "description": "Suggest code-graph alternatives on first Read call"
+        "description": "Suggest code-graph alternatives on first Glob call"
       },
       {
         "matcher": "tool == \"Agent\"",

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

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 'use strict';
-// PreToolUse hook: On FIRST Agent(Explore) call per session window, remind Claude
-// that code-graph tools provide faster, structured codebase exploration.
+// PreToolUse hook: On FIRST Agent call per session window, suggest
+// code-graph tools for structural code understanding before spawning agents.
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
@@ -16,10 +16,9 @@ try {
 
 fs.writeFileSync(flag, '');
 process.stdout.write(
-  '[code-graph] Before spawning an Explore agent, try code-graph tools first:\n' +
-  '  project_map → full architecture overview in one call\n' +
+  '[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 instantly\n' +
-  '  dependency_graph(file) → file-level import/export map\n' +
-  'Explore agents cost many tool calls; code-graph returns structured results in one.\n'
+  '  get_call_graph(symbol) → 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

@@ -0,0 +1,23 @@
+#!/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).
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const flag = path.join(os.tmpdir(), '.code-graph-glob-guided');
+const WINDOW_MS = 2 * 60 * 60 * 1000; // 2 hours
+
+try {
+  const stat = fs.statSync(flag);
+  if (Date.now() - stat.mtimeMs < WINDOW_MS) process.exit(0);
+} catch { /* first time */ }
+
+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' +
+  'Glob remains best for: finding specific files, configs, non-code assets.\n'
+);

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

@@ -1,25 +1,24 @@
 #!/usr/bin/env node
 'use strict';
-// PreToolUse hook: On FIRST Grep call per session window, remind Claude
-// about code-graph alternatives. Runs fast (<10ms) and only outputs once.
+// PreToolUse hook: On FIRST Grep call per session window, suggest
+// code-graph tools as complementary options for code understanding.
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
 const flag = path.join(os.tmpdir(), '.code-graph-search-guided');
-const WINDOW_MS = 2 * 60 * 60 * 1000; // 2 hours (approximate session window)
+const WINDOW_MS = 2 * 60 * 60 * 1000; // 2 hours
 
 try {
   const stat = fs.statSync(flag);
   if (Date.now() - stat.mtimeMs < WINDOW_MS) process.exit(0);
-} catch { /* flag doesn't exist — first time */ }
+} catch { /* first time */ }
 
 fs.writeFileSync(flag, '');
 process.stdout.write(
-  '[code-graph] For code understanding, prefer code-graph tools over Grep:\n' +
-  '  project_map → full project architecture overview (call FIRST)\n' +
-  '  semantic_code_search → find code by concept (10x fewer tokens)\n' +
-  '  get_call_graph → who calls X / what X calls (13x fewer tokens)\n' +
-  '  module_overview → understand a module (20x fewer tokens)\n' +
-  'Use Grep only for exact strings, constants, or regex patterns.\n'
+  '[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' +
+  'Grep remains best for: exact strings, regex, constants, non-code files.\n'
 );

package/package.json

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

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

@@ -1,24 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-// PreToolUse hook: On FIRST Read call per session window, remind Claude
-// that code-graph tools are more token-efficient for understanding code.
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-const flag = path.join(os.tmpdir(), '.code-graph-read-guided');
-const WINDOW_MS = 2 * 60 * 60 * 1000; // 2 hours
-
-try {
-  const stat = fs.statSync(flag);
-  if (Date.now() - stat.mtimeMs < WINDOW_MS) process.exit(0);
-} catch { /* first time */ }
-
-fs.writeFileSync(flag, '');
-process.stdout.write(
-  '[code-graph] If reading to understand code (not to edit), prefer code-graph tools:\n' +
-  '  module_overview(path) → understand a module\'s exports and structure\n' +
-  '  get_ast_node(file_path, symbol_name) → one function\'s code + callers/callees\n' +
-  '  semantic_code_search(query) → find code by concept\n' +
-  'Use Read only for files you intend to edit.\n'
-);