@sdsrs/code-graph 0.5.4 → 0.5.6

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

@@ -4,6 +4,6 @@
   "author": {
     "name": "sdsrs"
   },
-  "version": "0.5.4",
+  "version": "0.5.6",
   "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 == \"Read\"",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/scripts/pre-read-guide.js\"",
+            "timeout": 2
+          }
+        ],
+        "description": "Suggest code-graph alternatives on first Read 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,25 @@
+#!/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.
+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] Before spawning an Explore agent, try code-graph tools first:\n' +
+  '  project_map → full architecture overview in one call\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'
+);

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

@@ -0,0 +1,24 @@
+#!/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'
+);

package/package.json

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