@sdsrs/code-graph 0.5.5 → 0.5.7

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

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

package/claude-plugin/hooks/hooks.json

@@ -12,6 +12,28 @@
         ],
         "description": "Suggest code-graph alternatives on first Grep call"
       },
+      {
+        "matcher": "tool == \"Glob\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/pre-glob-guide.js\"",
+            "timeout": 2
+          }
+        ],
+        "description": "Suggest code-graph alternatives on first Glob call"
+      },
+      {
+        "matcher": "tool == \"Agent\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/pre-explore-guide.js\"",
+            "timeout": 2
+          }
+        ],
+        "description": "Suggest code-graph tools before spawning Explore agents"
+      },
       {
         "matcher": "tool == \"Edit\" || tool == \"Write\"",
         "hooks": [

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

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+'use strict';
+// 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');
+
+const flag = path.join(os.tmpdir(), '.code-graph-explore-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] 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' +
+  '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.5",
+  "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.5",
-    "@sdsrs/code-graph-linux-arm64": "0.5.5",
-    "@sdsrs/code-graph-darwin-x64": "0.5.5",
-    "@sdsrs/code-graph-darwin-arm64": "0.5.5",
-    "@sdsrs/code-graph-win32-x64": "0.5.5"
+    "@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"
   }
 }