@sdsrs/code-graph 0.5.30 → 0.5.32

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

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

package/claude-plugin/.mcp.json

@@ -1,8 +1,8 @@
 {
   "mcpServers": {
     "code-graph": {
-      "command": "code-graph-mcp",
-      "args": ["serve"],
+      "command": "node",
+      "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/mcp-launcher.js"],
       "env": {}
     }
   }

package/claude-plugin/scripts/auto-update.js

@@ -8,6 +8,23 @@ const os = require('os');
 const { CACHE_DIR, PLUGIN_ID, MARKETPLACE_NAME, readManifest, readJson, writeJsonAtomic } = require('./lifecycle');
 const { clearCache: clearBinaryCache } = require('./find-binary');
 
+// ── Environment Checks ────────────────────────────────────
+
+/**
+ * Check if a command-line tool is available on the system PATH.
+ * @param {string} cmd - Command name (e.g., 'curl', 'tar')
+ * @returns {boolean}
+ */
+function commandExists(cmd) {
+  try {
+    const whichCmd = process.platform === 'win32' ? 'where' : 'which';
+    execFileSync(whichCmd, [cmd], { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 // ── Configuration ──────────────────────────────────────────
 const GITHUB_REPO = 'sdsrss/code-graph-mcp';
 const STATE_FILE = path.join(CACHE_DIR, 'update-state.json');
@@ -207,6 +224,13 @@ function promoteVerifiedBinary(binaryTmp, binaryDst, expectedVersion) {
 // ── Download & Install ─────────────────────────────────────
 
 async function downloadAndInstall(latest) {
+  // Pre-flight: check required CLI tools before attempting any download
+  const missingTools = ['curl', 'tar'].filter(cmd => !commandExists(cmd));
+  if (missingTools.length > 0) {
+    console.error(`[code-graph] Auto-update skipped: missing required tools: ${missingTools.join(', ')}. Install them to enable auto-updates.`);
+    return { pluginUpdated: false, binaryUpdated: false };
+  }
+
   const tmpDir = path.join(os.tmpdir(), `code-graph-update-${Date.now()}`);
   let pluginUpdated = false;
   let binaryUpdated = false;
@@ -273,13 +297,15 @@ async function downloadAndInstall(latest) {
         if (promoteVerifiedBinary(binaryTmp, binaryDst, latest.version)) {
           binaryUpdated = true;
         }
-      } catch {
+      } catch (e) {
         // Binary download failed — plugin update still counts as success
+        console.error(`[code-graph] Binary download failed: ${e.message}`);
       }
     }
 
     return { pluginUpdated, binaryUpdated };
-  } catch {
+  } catch (e) {
+    console.error(`[code-graph] Plugin download/extract failed: ${e.message}`);
     return { pluginUpdated: false, binaryUpdated: false };
   } finally {
     try { fs.rmSync(tmpDir, { recursive: true, force: true }); } catch { /* ok */ }
@@ -354,7 +380,7 @@ async function checkForUpdate() {
 }
 
 module.exports = {
-  checkForUpdate, isDevMode, readState, compareVersions,
+  checkForUpdate, commandExists, isDevMode, readState, compareVersions,
   getExtractedPluginVersion, readBinaryVersion, promoteVerifiedBinary, isSilentMode,
   requestJson, parseLatestRelease, fetchLatestRelease,
 };

package/claude-plugin/scripts/auto-update.test.js

@@ -6,6 +6,7 @@ const os = require('os');
 const path = require('path');
 
 const {
+  commandExists,
   fetchLatestRelease,
   getExtractedPluginVersion,
   parseLatestRelease,
@@ -80,6 +81,16 @@ test('parseLatestRelease selects the matching platform asset', () => {
   });
 });
 
+// ── commandExists ──────────────────────────────────────────
+
+test('commandExists returns true for a known command (node)', () => {
+  assert.equal(commandExists('node'), true);
+});
+
+test('commandExists returns false for a non-existent command', () => {
+  assert.equal(commandExists('__nonexistent_cmd_xyz_12345__'), false);
+});
+
 test('fetchLatestRelease parses JSON without relying on global fetch', async () => {
   const latest = await fetchLatestRelease(async () => ({
     statusCode: 200,

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

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+'use strict';
+/**
+ * MCP server launcher — resolves binary via find-binary.js, auto-installs
+ * if missing, then spawns with stdio forwarding for JSON-RPC.
+ *
+ * Used by .mcp.json so the plugin controls binary discovery instead of
+ * relying on the binary being in PATH.
+ */
+const { spawn, execFileSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+// Set plugin root so find-binary.js can locate bundled/dev binaries
+process.env._FIND_BINARY_ROOT = process.env.CLAUDE_PLUGIN_ROOT || path.resolve(__dirname, '..');
+
+const { findBinary, clearCache } = require('./find-binary');
+
+let binary = findBinary();
+
+// Auto-install binary if not found (first-time install)
+if (!binary) {
+  let version = 'latest';
+  try {
+    const pj = path.join(__dirname, '..', '.claude-plugin', 'plugin.json');
+    version = JSON.parse(fs.readFileSync(pj, 'utf8')).version || 'latest';
+  } catch { /* use latest */ }
+
+  process.stderr.write(`[code-graph] Binary not found, installing @sdsrs/code-graph@${version}...\n`);
+  try {
+    execFileSync('npm', ['install', '-g', `@sdsrs/code-graph@${version}`], {
+      timeout: 60000, stdio: 'pipe',
+    });
+    clearCache();
+    binary = findBinary();
+    if (binary) {
+      process.stderr.write(`[code-graph] Installed at ${binary}\n`);
+    }
+  } catch {
+    process.stderr.write('[code-graph] npm install failed. Trying direct download...\n');
+  }
+
+  // Fallback: direct binary download from GitHub release
+  if (!binary) {
+    try {
+      const { downloadBinarySync } = require('./auto-update');
+      if (typeof downloadBinarySync === 'function') {
+        downloadBinarySync(version);
+        clearCache();
+        binary = findBinary();
+      }
+    } catch { /* not available */ }
+  }
+}
+
+if (!binary) {
+  process.stderr.write(
+    '[code-graph] Binary not found. Install manually:\n' +
+    '  npm install -g @sdsrs/code-graph\n'
+  );
+  process.exit(1);
+}
+
+// Spawn binary with stdio inheritance for MCP JSON-RPC
+const child = spawn(binary, ['serve'], {
+  stdio: 'inherit',
+  env: process.env,
+});
+
+child.on('error', (err) => {
+  process.stderr.write(`[code-graph] Failed to start: ${err.message}\n`);
+  process.exit(1);
+});
+
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code ?? 1);
+  }
+});

package/package.json

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