feat(plugin): improve auto-update UX and reliability

- Reduce update check interval from 24h to 6h (within GitHub API limits)
- Add post-update 1h fast check interval to verify binary install success
- Record pendingBinaryUpdate state when npm install fails (CI race condition)
- Retry pending binary install on next session start (step 0b)
- Prompt user to run /mcp after binary update so MCP server uses new version
- Add scripts/sync-versions.js for consistent version bumping across
  Cargo.toml, plugin.json, and marketplace.json

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: sdsrss

.claude-plugin/marketplace.json

@@ -19,7 +19,15 @@
       "homepage": "https://github.com/sdsrss/code-graph-mcp",
       "repository": "https://github.com/sdsrss/code-graph-mcp",
       "license": "MIT",
-      "keywords": ["code-graph", "ast", "navigation", "mcp", "knowledge-graph", "semantic-search", "call-graph"]
+      "keywords": [
+        "code-graph",
+        "ast",
+        "navigation",
+        "mcp",
+        "knowledge-graph",
+        "semantic-search",
+        "call-graph"
+      ]
     }
   ]
 }

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

@@ -5,5 +5,11 @@
     "name": "sdsrs"
   },
   "version": "0.5.26",
-  "keywords": ["code-graph", "ast", "navigation", "mcp", "knowledge-graph"]
+  "keywords": [
+    "code-graph",
+    "ast",
+    "navigation",
+    "mcp",
+    "knowledge-graph"
+  ]
 }

claude-plugin/scripts/auto-update.js

@@ -10,8 +10,9 @@ const { CACHE_DIR, PLUGIN_ID, MARKETPLACE_NAME, readManifest, readJson, writeJso
 const GITHUB_REPO = 'sdsrss/code-graph-mcp';
 const NPM_PACKAGE = '@sdsrs/code-graph';
 const STATE_FILE = path.join(CACHE_DIR, 'update-state.json');
-const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;       // 24h
-const RATE_LIMIT_INTERVAL_MS = 6 * 60 * 60 * 1000;   // 6h if rate-limited
+const CHECK_INTERVAL_MS = 6 * 60 * 60 * 1000;        // 6h (GitHub allows 60 req/h unauthenticated)
+const RATE_LIMIT_INTERVAL_MS = 24 * 60 * 60 * 1000;  // 24h if rate-limited
+const POST_UPDATE_INTERVAL_MS = 1 * 60 * 60 * 1000;  // 1h after update (verify success)
 const FETCH_TIMEOUT_MS = 3000;
 
 // ── State Persistence ──────────────────────────────────────
@@ -42,7 +43,9 @@ function isDevMode() {
 function shouldCheck(state) {
   if (!state.lastCheck) return true;
   const elapsed = Date.now() - new Date(state.lastCheck).getTime();
-  const interval = state.rateLimited ? RATE_LIMIT_INTERVAL_MS : CHECK_INTERVAL_MS;
+  let interval = CHECK_INTERVAL_MS;
+  if (state.rateLimited) interval = RATE_LIMIT_INTERVAL_MS;
+  else if (state.pendingBinaryUpdate) interval = POST_UPDATE_INTERVAL_MS;
   return elapsed >= interval;
 }
 
@@ -154,14 +157,18 @@ async function downloadAndInstall(latest) {
     } catch { /* manifest update failed — not fatal */ }
 
     // 6. Update npm binary (non-blocking, best-effort)
+    let binaryUpdated = false;
     try {
       execFileSync('npm', ['install', '-g', `${NPM_PACKAGE}@${latest.version}`], {
         timeout: 60000,
         stdio: 'pipe',
       });
+      binaryUpdated = true;
+      // Clear pending flag on success
+      try { const s = readState(); delete s.pendingBinaryUpdate; saveState(s); } catch { /* ok */ }
     } catch {
-      // npm install failed — plugin files still updated
-      // User can manually update binary later
+      // npm package may not be published yet (race with CI). Record for retry.
+      try { const s = readState(); s.pendingBinaryUpdate = latest.version; saveState(s); } catch { /* ok */ }
     }
 
     return true;

claude-plugin/scripts/session-init.js

@@ -6,10 +6,31 @@ const path = require('path');
 const os = require('os');
 const { findBinary } = require('./find-binary');
 const { install, update, readManifest, getPluginVersion, checkScopeConflict } = require('./lifecycle');
-const { checkForUpdate } = require('./auto-update');
+const { checkForUpdate, readState: readUpdateState } = require('./auto-update');
 
 let BIN = findBinary();
 
+// --- 0b. Retry pending binary update from previous failed auto-update ---
+{
+  const updateState = readUpdateState();
+  if (updateState.pendingBinaryUpdate) {
+    const pendingVer = updateState.pendingBinaryUpdate;
+    try {
+      execFileSync('npm', ['install', '-g', `@sdsrs/code-graph@${pendingVer}`], {
+        timeout: 30000, stdio: 'pipe'
+      });
+      try { fs.unlinkSync(path.join(os.homedir(), '.cache', 'code-graph', 'binary-path')); } catch {}
+      // Clear pending flag
+      const { writeJsonAtomic, CACHE_DIR } = require('./lifecycle');
+      const s = readUpdateState();
+      delete s.pendingBinaryUpdate;
+      writeJsonAtomic(path.join(CACHE_DIR, 'update-state.json'), s);
+      process.stderr.write(`[code-graph] Binary retry succeeded: v${pendingVer}\n`);
+      BIN = findBinary(); // refresh
+    } catch { /* npm still not available — will retry next session */ }
+  }
+}
+
 // --- 0. Auto-install binary if missing ---
 if (!BIN) {
   const version = getPluginVersion();
@@ -66,18 +87,27 @@ if (BIN) {
         (pv[0] === bv[0] && pv[1] === bv[1] && pv[2] > bv[2]);
       if (pluginNewer) {
         process.stderr.write(`[code-graph] Binary v${binVersion} < plugin v${pluginVersion}, updating...\n`);
+        let binarySynced = false;
         try {
           execFileSync('npm', ['install', '-g', `@sdsrs/code-graph@${pluginVersion}`], {
             timeout: 30000, stdio: 'pipe'
           });
           // Clear cached binary path so next lookup finds the new binary
           try { fs.unlinkSync(path.join(os.homedir(), '.cache', 'code-graph', 'binary-path')); } catch {}
           process.stderr.write(`[code-graph] Binary updated to v${pluginVersion}\n`);
+          binarySynced = true;
         } catch {
           process.stderr.write(
             `[code-graph] Auto-update failed. Run: npm install -g @sdsrs/code-graph@${pluginVersion}\n`
           );
         }
+        if (binarySynced) {
+          // MCP server is still running old binary — prompt user to reconnect
+          process.stdout.write(
+            `\n\u26A0\uFE0F [code-graph] Binary updated v${binVersion} \u2192 v${pluginVersion}. ` +
+            `Run /mcp to reconnect MCP server with new version.\n`
+          );
+        }
       }
     }
   } catch { /* version check failed — not critical */ }
@@ -107,6 +137,10 @@ if (!manifest.version) {
   const result = await checkForUpdate();
   if (result && result.updated) {
     process.stderr.write(`[code-graph] Updated: v${result.from} \u2192 v${result.to}\n`);
+    process.stdout.write(
+      `\n\uD83D\uDD04 [code-graph] Auto-updated v${result.from} \u2192 v${result.to}. ` +
+      `Run /mcp to use the new version.\n`
+    );
   } else if (result && result.updateAvailable) {
     process.stderr.write(
       `[code-graph] Update available: v${result.from} \u2192 v${result.to}. ` +

scripts/sync-versions.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+'use strict';
+/**
+ * Sync version across all project files.
+ * Usage: node scripts/sync-versions.js <version>
+ * Example: node scripts/sync-versions.js 0.5.27
+ */
+const fs = require('fs');
+const path = require('path');
+
+const version = process.argv[2];
+if (!version || !/^\d+\.\d+\.\d+$/.test(version)) {
+  console.error('Usage: node scripts/sync-versions.js <semver>');
+  console.error('Example: node scripts/sync-versions.js 0.5.27');
+  process.exit(1);
+}
+
+const root = path.resolve(__dirname, '..');
+
+const updates = [
+  {
+    file: 'Cargo.toml',
+    transform: (content) => content.replace(/^version = ".*"/m, `version = "${version}"`),
+  },
+  {
+    file: 'claude-plugin/.claude-plugin/plugin.json',
+    json: true,
+    transform: (obj) => { obj.version = version; return obj; },
+  },
+  {
+    file: '.claude-plugin/marketplace.json',
+    json: true,
+    transform: (obj) => {
+      if (obj.metadata) obj.metadata.version = version;
+      if (obj.plugins && obj.plugins[0]) obj.plugins[0].version = version;
+      return obj;
+    },
+  },
+];
+
+let changed = 0;
+for (const { file, json, transform } of updates) {
+  const filePath = path.join(root, file);
+  if (!fs.existsSync(filePath)) {
+    console.warn(`  skip: ${file} (not found)`);
+    continue;
+  }
+  const original = fs.readFileSync(filePath, 'utf8');
+  let result;
+  if (json) {
+    const obj = JSON.parse(original);
+    result = JSON.stringify(transform(obj), null, 2) + '\n';
+  } else {
+    result = transform(original);
+  }
+  if (result !== original) {
+    fs.writeFileSync(filePath, result);
+    console.log(`  updated: ${file}`);
+    changed++;
+  } else {
+    console.log(`  unchanged: ${file}`);
+  }
+}
+
+console.log(`\nVersion synced to ${version} (${changed} file${changed !== 1 ? 's' : ''} updated)`);