@sdsrs/code-graph 0.56.0 → 0.56.2

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

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

package/claude-plugin/agents/code-explorer.md

@@ -1,7 +1,7 @@
 ---
 name: code-explorer
 description: Deep code understanding expert using AST knowledge graph. Use when exploring unfamiliar code, tracing complex relationships, or understanding module architecture.
-tools: ["Read", "Grep", "Glob", "Bash", "mcp__code-graph__semantic_code_search", "mcp__code-graph__get_call_graph", "mcp__code-graph__get_ast_node", "mcp__code-graph__trace_http_chain"]
+tools: ["Read", "Grep", "Glob", "Bash", "mcp__code-graph__semantic_code_search", "mcp__code-graph__get_call_graph", "mcp__code-graph__get_ast_node", "mcp__code-graph__project_map", "mcp__code-graph__module_overview", "mcp__code-graph__ast_search", "mcp__code-graph__find_references"]
 model: sonnet
 ---
 
@@ -9,10 +9,10 @@ You are a code exploration specialist with access to an AST knowledge graph.
 
 ## Strategy
 
-1. **Start with semantic_code_search** to locate relevant code by meaning
-2. **Use get_call_graph** to understand function relationships and call chains
-3. **Use get_ast_node** to get symbol metadata, code, and callers/callees (use `context_lines` for surrounding source)
-4. **Use trace_http_chain** for HTTP request flow analysis
+1. **Start with semantic_code_search** to locate relevant code by meaning, or **module_overview** / **project_map** to map an unfamiliar directory or the whole repo
+2. **Use get_call_graph** to understand function relationships and call chains (pass `route_path='GET /api/x'` to trace an HTTP handler downstream)
+3. **Use get_ast_node** to get symbol metadata, source, and callers/callees (`context_lines` for surrounding source, `include_impact` for blast radius)
+4. **Use find_references** for rename/remove audits and **ast_search** to enumerate symbols by type / return / params
 5. **Fall back to Grep/Read** only when code-graph tools lack coverage (e.g., config files, non-code assets)
 
 ## Rules

package/claude-plugin/scripts/lifecycle.e2e.test.js

@@ -141,3 +141,39 @@ test('lifecycle install writes to CLAUDE_CONFIG_DIR instead of ~/.claude when se
     'default ~/.claude/settings.json must not be written when override is set');
 });
 
+test('composite expands a leading ~ in a _previous command instead of dropping it (issue #24)', (t) => {
+  // A user whose prior statusline used a leading ~ (valid in settings.json, which
+  // Claude Code runs through a shell). install() captures it verbatim as _previous.
+  // The composite runs providers via execFileSync (no shell), so without tilde
+  // expansion the command throws ENOENT and is silently swallowed — the user's
+  // original statusline vanishes.
+  const homeDir = mkHome(t);
+  const prevScript = path.join(homeDir, '.claude', 'utils', 'statusline.sh');
+  fs.mkdirSync(path.dirname(prevScript), { recursive: true });
+  fs.writeFileSync(prevScript, '#!/bin/sh\necho "PREV-STATUSLINE-OK"\n');
+  fs.chmodSync(prevScript, 0o755);
+
+  const registryPath = path.join(homeDir, '.cache', 'code-graph', 'statusline-registry.json');
+  writeJson(registryPath, [
+    { id: '_previous', command: '~/.claude/utils/statusline.sh', needsStdin: true },
+  ]);
+
+  const out = runScript(homeDir, compositeCli, [], { input: '{}' });
+  assert.match(out, /PREV-STATUSLINE-OK/,
+    'a _previous command using a leading ~ must be tilde-expanded, not silently dropped');
+});
+
+test('expandTilde mirrors shell tilde expansion (only a leading ~ / ~/)', () => {
+  const composite = require('./statusline-composite');
+  const home = os.homedir();
+  assert.equal(composite.expandTilde('~'), home);
+  assert.equal(composite.expandTilde('~/.claude/utils/statusline.sh'),
+    path.join(home, '.claude', 'utils', 'statusline.sh'));
+  assert.equal(composite.expandTilde('/abs/path/script.sh'), '/abs/path/script.sh');
+  assert.equal(composite.expandTilde('node'), 'node');
+  assert.equal(composite.expandTilde('~user/script.sh'), '~user/script.sh',
+    'other-user home dirs are not resolved');
+  assert.equal(composite.expandTilde('a~/b'), 'a~/b',
+    'only a leading ~ expands, not a mid-string ~');
+});
+

package/claude-plugin/scripts/statusline-composite.js

@@ -7,22 +7,28 @@
  */
 const { execFileSync } = require('child_process');
 const path = require('path');
+const os = require('os');
 const lifecycle = require('./lifecycle');
 const { readRegistry } = lifecycle;
 const cleanupDisabledStatusline = lifecycle.cleanupDisabledStatusline || (() => ({ cleaned: false }));
 
 const SEPARATOR = ' \x1b[2m|\x1b[0m ';
 
-const disabledCleanup = cleanupDisabledStatusline();
-if (disabledCleanup.cleaned) process.exit(0);
+function main() {
+  const disabledCleanup = cleanupDisabledStatusline();
+  if (disabledCleanup.cleaned) process.exit(0);
 
-// Collect stdin (Claude Code pipes JSON context)
-let stdinData = '';
-let ran = false;
-const stdinTimeout = setTimeout(() => { if (!ran) { ran = true; run(''); } }, 2000);
-process.stdin.setEncoding('utf8');
-process.stdin.on('data', (chunk) => { stdinData += chunk; });
-process.stdin.on('end', () => { clearTimeout(stdinTimeout); if (!ran) { ran = true; run(stdinData); } });
+  // Collect stdin (Claude Code pipes JSON context)
+  let stdinData = '';
+  let ran = false;
+  const stdinTimeout = setTimeout(() => { if (!ran) { ran = true; run(''); } }, 2000);
+  process.stdin.setEncoding('utf8');
+  process.stdin.on('data', (chunk) => { stdinData += chunk; });
+  process.stdin.on('end', () => { clearTimeout(stdinTimeout); if (!ran) { ran = true; run(stdinData); } });
+}
+
+// Only run the statusline when invoked as a CLI; `require()` (tests) just imports helpers.
+if (require.main === module) main();
 
 function run(stdin) {
   const registry = readRegistry();
@@ -58,7 +64,14 @@ function runProvider(command, needsStdin, stdin) {
     const parts = parseCommand(command);
     if (!parts) return null;
 
-    const out = execFileSync(parts[0], parts.slice(1), {
+    // Claude Code runs statusLine.command through a shell, so a leading `~`
+    // (e.g. `~/.claude/utils/statusline.sh`) is expanded natively. execFileSync
+    // does NOT use a shell, so we must expand `~/` ourselves on every word —
+    // otherwise a `_previous` command captured verbatim throws ENOENT and gets
+    // swallowed below, silently dropping the user's original statusline.
+    const argv = parts.map(expandTilde);
+
+    const out = execFileSync(argv[0], argv.slice(1), {
       timeout: 3000,
       stdio: ['pipe', 'pipe', 'pipe'],
       input: needsStdin ? stdin : '',
@@ -81,9 +94,19 @@ function parseCommand(cmd) {
   return parts.length > 0 ? parts : null;
 }
 
+// Expand a leading `~` / `~/` to the home directory, mirroring shell tilde
+// expansion (which Claude Code applies when it runs statusLine.command, but
+// execFileSync does not). Only a bare `~` or a `~/`-prefixed word is expanded;
+// `~user` and mid-string `~` are left untouched (we don't resolve other users).
+function expandTilde(p) {
+  if (p === '~') return os.homedir();
+  if (p.startsWith('~/')) return path.join(os.homedir(), p.slice(2));
+  return p;
+}
+
 function codeGraphCommand() {
   // Always derive from __dirname — CLAUDE_PLUGIN_ROOT can leak from other plugins
   return `node "${path.join(__dirname, 'statusline.js')}"`;
 }
 
-module.exports = { run };
+module.exports = { run, runProvider, parseCommand, expandTilde };

package/package.json

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