@sdsrs/code-graph 0.7.8 → 0.7.10

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

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

package/claude-plugin/scripts/mcp-launcher.js

@@ -49,6 +49,23 @@ if (!binary) {
   process.exit(1);
 }
 
+// Pre-spawn: verify binary is executable (catches macOS quarantine, permission issues)
+try {
+  fs.accessSync(binary, fs.constants.X_OK);
+} catch {
+  process.stderr.write(`[code-graph] Binary not executable: ${binary}\n`);
+  if (process.platform === 'darwin') {
+    process.stderr.write(
+      'macOS may be quarantining the downloaded binary. Fix with:\n' +
+      `  xattr -d com.apple.quarantine "${binary}"\n` +
+      `  chmod +x "${binary}"\n`
+    );
+  } else {
+    process.stderr.write(`Fix: chmod +x "${binary}"\n`);
+  }
+  process.exit(1);
+}
+
 // Spawn binary with stdio inheritance for MCP JSON-RPC
 const child = spawn(binary, ['serve'], {
   stdio: 'inherit',
@@ -57,6 +74,12 @@ const child = spawn(binary, ['serve'], {
 
 child.on('error', (err) => {
   process.stderr.write(`[code-graph] Failed to start: ${err.message}\n`);
+  if (process.platform === 'darwin' && (err.code === 'EACCES' || err.code === 'EPERM')) {
+    process.stderr.write(
+      'macOS may be blocking this binary. Try:\n' +
+      `  xattr -d com.apple.quarantine "${binary}"\n`
+    );
+  }
   process.exit(1);
 });
 

package/claude-plugin/scripts/session-init.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 'use strict';
-const { spawn, execSync } = require('child_process');
+const { spawn, execSync, execFileSync } = require('child_process');
 const path = require('path');
 const os = require('os');
 const fs = require('fs');
@@ -82,6 +82,63 @@ function ensureIndexFresh() {
   }
 }
 
+/**
+ * Verify binary is available and executable.
+ * On macOS, detect Gatekeeper quarantine (common after npm/GitHub download).
+ * Returns { available, binary, issue? }.
+ */
+function verifyBinary() {
+  const { findBinary } = require('./find-binary');
+  const binary = findBinary();
+  if (!binary) {
+    process.stderr.write(
+      '[code-graph] Binary not found — MCP server cannot start.\n' +
+      'Install: npm install -g @sdsrs/code-graph\n'
+    );
+    return { available: false, binary: null };
+  }
+
+  // Check executable permission
+  try {
+    fs.accessSync(binary, fs.constants.X_OK);
+  } catch {
+    process.stderr.write(
+      `[code-graph] Binary not executable: ${binary}\n` +
+      `Fix: chmod +x "${binary}"\n`
+    );
+    if (process.platform === 'darwin') {
+      process.stderr.write(`Also try: xattr -d com.apple.quarantine "${binary}"\n`);
+    }
+    return { available: false, binary, issue: 'not-executable' };
+  }
+
+  // On macOS, verify the binary can actually run (Gatekeeper may block it)
+  if (process.platform === 'darwin') {
+    try {
+      execFileSync(binary, ['--version'], { timeout: 3000, stdio: 'pipe' });
+    } catch (err) {
+      const msg = (err.message || '') + (err.stderr ? err.stderr.toString() : '');
+      if (msg.includes('quarantine') || msg.includes('not permitted') ||
+          msg.includes('killed') || err.status === 137 || err.signal === 'SIGKILL') {
+        process.stderr.write(
+          `[code-graph] macOS Gatekeeper is blocking the binary: ${binary}\n` +
+          `Fix: xattr -d com.apple.quarantine "${binary}"\n` +
+          `Then restart Claude Code to reconnect the MCP server.\n`
+        );
+        return { available: false, binary, issue: 'quarantine' };
+      }
+      // Other errors (e.g., missing libs) — still report
+      process.stderr.write(
+        `[code-graph] Binary found but failed to run: ${binary}\n` +
+        `Error: ${msg.slice(0, 200)}\n`
+      );
+      return { available: false, binary, issue: 'runtime-error' };
+    }
+  }
+
+  return { available: true, binary };
+}
+
 function runSessionInit() {
   if (isPluginInactive()) {
     cleanupDisabledStatusline();
@@ -97,10 +154,14 @@ function runSessionInit() {
   }
 
   const lifecycle = syncLifecycleConfig();
+
+  // Verify binary availability — catch issues early with actionable diagnostics
+  const binaryCheck = verifyBinary();
+
   const autoUpdateLaunched = launchBackgroundAutoUpdate();
-  const indexFreshness = ensureIndexFresh();
-  const mapInjected = injectProjectMap();
-  return { inactive: false, lifecycle, autoUpdateLaunched, indexFreshness, mapInjected };
+  const indexFreshness = binaryCheck.available ? ensureIndexFresh() : 'skipped';
+  const mapInjected = binaryCheck.available ? injectProjectMap() : false;
+  return { inactive: false, lifecycle, autoUpdateLaunched, indexFreshness, mapInjected, binaryCheck };
 }
 
 /**
@@ -137,6 +198,7 @@ module.exports = {
   syncLifecycleConfig,
   ensureIndexFresh,
   injectProjectMap,
+  verifyBinary,
   runSessionInit,
 };
 

package/claude-plugin/scripts/session-init.test.js

@@ -2,7 +2,7 @@
 const test = require('node:test');
 const assert = require('node:assert/strict');
 
-const { launchBackgroundAutoUpdate, syncLifecycleConfig, ensureIndexFresh } = require('./session-init');
+const { launchBackgroundAutoUpdate, syncLifecycleConfig, ensureIndexFresh, verifyBinary } = require('./session-init');
 
 test('syncLifecycleConfig is exported as a callable helper', () => {
   assert.equal(typeof syncLifecycleConfig, 'function');
@@ -24,6 +24,27 @@ test('ensureIndexFresh returns skipped when no index exists', () => {
   }
 });
 
+test('verifyBinary returns available:true when binary is found and executable', () => {
+  const result = verifyBinary();
+  // In dev repo, binary should be found (target/release/code-graph-mcp)
+  if (result.available) {
+    assert.equal(typeof result.binary, 'string');
+    assert.ok(result.binary.length > 0);
+  } else {
+    // Binary not built — still verify the return shape
+    assert.equal(result.available, false);
+  }
+});
+
+test('verifyBinary returns structured result with expected shape', () => {
+  const result = verifyBinary();
+  assert.equal(typeof result.available, 'boolean');
+  assert.ok('binary' in result);
+  if (!result.available && result.binary) {
+    assert.ok('issue' in result);
+  }
+});
+
 test('launchBackgroundAutoUpdate spawns detached silent updater', () => {
   const calls = [];
 

package/claude-plugin/scripts/user-prompt-context.js

@@ -8,6 +8,29 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 
+// --- Mid-session install detection ---
+// If hooks are running but lifecycle install() hasn't executed yet (no manifest),
+// the plugin was installed mid-session and the MCP server isn't connected.
+// Claude Code only starts MCP servers at session startup; /mcp reconnect cannot
+// start servers that were never initialized.
+const MANIFEST_PATH = path.join(os.homedir(), '.cache', 'code-graph', 'install-manifest.json');
+if (!fs.existsSync(MANIFEST_PATH)) {
+  const noticeFile = path.join(os.tmpdir(), '.code-graph-mcp-restart-notice');
+  try {
+    // Show once per hour to avoid spam
+    if (Date.now() - fs.statSync(noticeFile).mtimeMs < 3600000) process.exit(0);
+  } catch { /* first notice */ }
+  try { fs.writeFileSync(noticeFile, ''); } catch { /* ok */ }
+  process.stdout.write(
+    '[code-graph] Plugin installed — MCP server requires a session restart to connect.\n' +
+    'MCP servers are only initialized at session startup. To activate:\n' +
+    '  1. Press Ctrl+C to exit the current session\n' +
+    '  2. Re-run `claude` to start a new session\n' +
+    'Meanwhile, CLI tools work directly: code-graph-mcp search <query>, code-graph-mcp map, etc.\n'
+  );
+  process.exit(0);
+}
+
 // --- Rate limiting ---
 const flag = path.join(os.tmpdir(), '.code-graph-prompt-ctx');
 const COOLDOWN_MS = 60 * 1000; // 1 minute between injections

package/package.json

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