@sdsrs/code-graph 0.12.1 → 0.14.0

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

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

package/claude-plugin/scripts/adopt.js

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
 'use strict';
 // adopt / unadopt — writes plugin_code_graph_mcp.md into this project's
-// claude-mem memory dir and maintains a sentinel-bracketed index entry in
-// MEMORY.md. Idempotent. Used by invited-memory pattern with CODE_GRAPH_QUIET_HOOKS=1.
+// Claude Code auto-memory dir (~/.claude/projects/<slug>/memory/, also
+// read/written by claude-mem-lite) and maintains a sentinel-bracketed index
+// entry in MEMORY.md. Idempotent. Used by invited-memory pattern with
+// CODE_GRAPH_QUIET_HOOKS=1.
 const fs = require('fs');
 const path = require('path');
 const os = require('os');

package/claude-plugin/scripts/lifecycle.js

@@ -19,6 +19,10 @@ const MANIFEST_FILE = path.join(CACHE_DIR, 'install-manifest.json');
 const SETTINGS_PATH = path.join(os.homedir(), '.claude', 'settings.json');
 const INSTALLED_PLUGINS_PATH = path.join(os.homedir(), '.claude', 'plugins', 'installed_plugins.json');
 const REGISTRY_FILE = path.join(CACHE_DIR, 'statusline-registry.json');
+// Durable mirror outside ~/.cache/ — survives cache cleanup. Captures the
+// `_previous` snapshot (pre-install statusline) and any third-party providers
+// (GSD, etc.). readRegistry() self-heals from this file when primary is missing.
+const PROVIDERS_BACKUP_FILE = path.join(os.homedir(), '.claude', 'statusline-providers.json');
 
 // --- Helpers ---
 
@@ -75,15 +79,28 @@ function isOurComposite(settings) {
 // Multiple providers can register. The composite script runs them all.
 
 function readRegistry() {
-  return readJson(REGISTRY_FILE) || [];
+  const primary = readJson(REGISTRY_FILE);
+  if (primary && Array.isArray(primary) && primary.length > 0) return primary;
+  // Self-heal: primary missing or empty (e.g. user cleaned ~/.cache/code-graph/).
+  // Durable backup in ~/.claude/ retains `_previous` + third-party providers.
+  const backup = readJson(PROVIDERS_BACKUP_FILE);
+  if (backup && Array.isArray(backup) && backup.length > 0) {
+    try { writeJsonAtomic(REGISTRY_FILE, backup); } catch { /* ok */ }
+    return backup;
+  }
+  return [];
 }
 
 function writeRegistry(registry) {
   if (!registry || registry.length === 0) {
     try { fs.unlinkSync(REGISTRY_FILE); } catch { /* ok */ }
+    try { fs.unlinkSync(PROVIDERS_BACKUP_FILE); } catch { /* ok */ }
     return;
   }
   writeJsonAtomic(REGISTRY_FILE, registry);
+  // Mirror to durable location so cache cleanup doesn't strand `_previous`
+  // or third-party provider entries.
+  try { writeJsonAtomic(PROVIDERS_BACKUP_FILE, registry); } catch { /* ok */ }
 }
 
 function registerStatuslineProvider(id, command, needsStdin) {
@@ -535,7 +552,9 @@ module.exports = {
   readRegistry, writeRegistry,
   getPluginVersion, cleanupOldCacheVersions,
   removeHooksFromSettings, isOurHookEntry,
+  registerStatuslineProvider, unregisterStatuslineProvider,
   PLUGIN_ID, OLD_PLUGIN_IDS, MARKETPLACE_NAME, CACHE_DIR, REGISTRY_FILE,
+  PROVIDERS_BACKUP_FILE,
 };
 
 // CLI: node lifecycle.js <install|uninstall|update|health>

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

@@ -178,6 +178,94 @@ test('removeHooksFromSettings strips our entries but keeps unrelated hooks', ()
   assert.ok(!s.hooks.PostToolUse, 'empty event key should be deleted');
 });
 
+test('writeRegistry mirrors entries to durable backup outside ~/.cache/', (t) => {
+  const homeDir = mkHome(t);
+  const registryPath = path.join(homeDir, '.cache', 'code-graph', 'statusline-registry.json');
+  const backupPath = path.join(homeDir, '.claude', 'statusline-providers.json');
+
+  execFileSync(process.execPath, ['-e', `
+    const { registerStatuslineProvider } = require(${JSON.stringify(lifecyclePath)});
+    registerStatuslineProvider('_previous', 'echo prev', true);
+    registerStatuslineProvider('code-graph', 'node /cg.js', false);
+  `], { env: { ...process.env, HOME: homeDir } });
+
+  const primary = JSON.parse(fs.readFileSync(registryPath, 'utf8'));
+  const backup = JSON.parse(fs.readFileSync(backupPath, 'utf8'));
+  assert.deepEqual(primary, backup);
+  assert.equal(primary.length, 2);
+});
+
+test('readRegistry self-heals primary from durable backup after cache wipe', (t) => {
+  const homeDir = mkHome(t);
+  const cacheDir = path.join(homeDir, '.cache', 'code-graph');
+  const registryPath = path.join(cacheDir, 'statusline-registry.json');
+  const backupPath = path.join(homeDir, '.claude', 'statusline-providers.json');
+
+  // Seed both files, then simulate user wiping ~/.cache/code-graph/
+  writeJson(registryPath, [
+    { id: '_previous', command: 'echo gsd', needsStdin: true },
+    { id: 'code-graph', command: 'node /cg.js', needsStdin: false },
+  ]);
+  writeJson(backupPath, [
+    { id: '_previous', command: 'echo gsd', needsStdin: true },
+    { id: 'code-graph', command: 'node /cg.js', needsStdin: false },
+  ]);
+  fs.rmSync(cacheDir, { recursive: true, force: true });
+  assert.equal(fs.existsSync(registryPath), false);
+
+  const out = execFileSync(process.execPath, ['-e', `
+    const { readRegistry } = require(${JSON.stringify(lifecyclePath)});
+    process.stdout.write(JSON.stringify(readRegistry()));
+  `], { env: { ...process.env, HOME: homeDir } }).toString();
+
+  const restored = JSON.parse(out);
+  assert.equal(restored.length, 2);
+  assert.equal(restored[0].id, '_previous');
+  // Primary file rebuilt from backup
+  assert.equal(fs.existsSync(registryPath), true);
+});
+
+test('writeRegistry([]) clears both primary and backup', (t) => {
+  const homeDir = mkHome(t);
+  const registryPath = path.join(homeDir, '.cache', 'code-graph', 'statusline-registry.json');
+  const backupPath = path.join(homeDir, '.claude', 'statusline-providers.json');
+
+  execFileSync(process.execPath, ['-e', `
+    const { registerStatuslineProvider, unregisterStatuslineProvider } = require(${JSON.stringify(lifecyclePath)});
+    registerStatuslineProvider('code-graph', 'node /cg.js', false);
+    unregisterStatuslineProvider('code-graph');
+  `], { env: { ...process.env, HOME: homeDir } });
+
+  assert.equal(fs.existsSync(registryPath), false);
+  assert.equal(fs.existsSync(backupPath), false);
+});
+
+test('statusline-chain CLI register/unregister/list + reserved-id guard', (t) => {
+  const homeDir = mkHome(t);
+  const chainPath = path.join(__dirname, 'statusline-chain.js');
+  const env = { ...process.env, HOME: homeDir };
+
+  const reg = execFileSync(process.execPath, [chainPath, 'register', 'gsd', 'node /gsd.cjs', '--stdin'], { env }).toString();
+  assert.match(reg, /registered gsd/);
+
+  const reRun = execFileSync(process.execPath, [chainPath, 'register', 'gsd', 'node /gsd.cjs', '--stdin'], { env }).toString();
+  assert.match(reRun, /unchanged gsd/);
+
+  const list = execFileSync(process.execPath, [chainPath, 'list'], { env }).toString();
+  assert.match(list, /gsd \[stdin\]: node \/gsd\.cjs/);
+
+  // Reserved ids rejected — both should exit 2 with stderr "reserved"
+  const { spawnSync } = require('child_process');
+  for (const rid of ['_previous', 'code-graph']) {
+    const r = spawnSync(process.execPath, [chainPath, 'register', rid, 'x'], { env });
+    assert.equal(r.status, 2, `${rid} should exit 2`);
+    assert.match(r.stderr.toString(), /reserved/);
+  }
+
+  const un = execFileSync(process.execPath, [chainPath, 'unregister', 'gsd'], { env }).toString();
+  assert.match(un, /unregistered gsd/);
+});
+
 test('install() removes legacy code-graph hooks from settings.json without re-registering', (t) => {
   const homeDir = mkHome(t);
   const settingsPath = path.join(homeDir, '.claude', 'settings.json');

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

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+'use strict';
+// Public CLI for third-party plugins (GSD, etc.) to register a statusline
+// provider into code-graph's composite chain.
+//
+// Usage:
+//   node statusline-chain.js register <id> <command> [--stdin]
+//   node statusline-chain.js unregister <id>
+//   node statusline-chain.js list
+//
+// Writes to ~/.cache/code-graph/statusline-registry.json (working copy) and
+// mirrors to ~/.claude/statusline-providers.json (durable backup). The
+// composite script reads both.
+//
+// Reserved ids: "_previous" (captures pre-install statusline), "code-graph"
+// (this plugin's own provider). Third parties should use stable ids like
+// "gsd", "claude-mem", etc.
+
+const { readRegistry, registerStatuslineProvider, unregisterStatuslineProvider } = require('./lifecycle');
+
+function usage(code = 1) {
+  process.stderr.write(
+    'Usage:\n' +
+    '  node statusline-chain.js register <id> <command> [--stdin]\n' +
+    '  node statusline-chain.js unregister <id>\n' +
+    '  node statusline-chain.js list\n'
+  );
+  process.exit(code);
+}
+
+function runRegister(id, command, needsStdin) {
+  if (id === 'code-graph' || id === '_previous') {
+    process.stderr.write(`error: id "${id}" is reserved\n`);
+    process.exit(2);
+  }
+  if (!id || !command) usage();
+  const changed = registerStatuslineProvider(id, command, needsStdin);
+  process.stdout.write(changed ? `registered ${id}\n` : `unchanged ${id}\n`);
+}
+
+function runUnregister(id) {
+  if (!id) usage();
+  const changed = unregisterStatuslineProvider(id);
+  process.stdout.write(changed ? `unregistered ${id}\n` : `not-found ${id}\n`);
+}
+
+function runList() {
+  const registry = readRegistry();
+  if (registry.length === 0) {
+    process.stdout.write('(empty)\n');
+    return;
+  }
+  for (const entry of registry) {
+    const stdin = entry.needsStdin ? ' [stdin]' : '';
+    process.stdout.write(`${entry.id}${stdin}: ${entry.command}\n`);
+  }
+}
+
+if (require.main === module) {
+  const [, , cmd, ...rest] = process.argv;
+  if (cmd === 'register') {
+    const needsStdin = rest.includes('--stdin');
+    const args = rest.filter((a) => a !== '--stdin');
+    runRegister(args[0], args[1], needsStdin);
+  } else if (cmd === 'unregister') {
+    runUnregister(rest[0]);
+  } else if (cmd === 'list') {
+    runList();
+  } else {
+    usage();
+  }
+}
+
+module.exports = { runRegister, runUnregister, runList };

package/claude-plugin/templates/plugin_code_graph_mcp.md

@@ -30,7 +30,7 @@ type: reference
 |------|------|----------------|
 | "谁调用 X？" / "X 调了啥？" | `get_call_graph` / `callgraph X` | 替代 `grep "X("` |
 | "Y 模块长啥样？" | `module_overview` / `overview Y/` | 替代逐文件 Read |
-| "找做 Z 的代码"（概念） | `semantic_code_search` / `search "Z"` | 不知道精确名 |
+| "找做 Z 的代码"（概念） | MCP `semantic_code_search`（RRF 混合）；CLI `search`（纯 FTS5） | 不知道精确名；要向量召回走 MCP |
 | "返回 T 类型的函数" | `ast_search --returns T` | 结构化筛选 |
 | "X 在哪被引用？" | `find_references` / `refs X` | 含 callers/importers |
 | "看 X 的源码 / 签名" | `get_ast_node` / `show X` | `include_impact=true` 含影响面（替代 impact_analysis） |
@@ -76,7 +76,7 @@ type: reference
 
 ```
 code-graph-mcp grep "pattern" [path]     # ripgrep + AST 上下文
-code-graph-mcp search "concept"          # FTS5 语义搜索
+code-graph-mcp search "concept"          # 纯 FTS5（要混合检索走 MCP semantic_code_search）
 code-graph-mcp ast-search "q" --type fn  # 结构化筛选
 code-graph-mcp map                       # 项目架构
 code-graph-mcp overview src/mcp/         # 模块总览

package/package.json

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