@sdsrs/code-graph 0.73.0 → 0.74.0

package/claude-plugin/scripts/doctor.js

@@ -330,6 +330,32 @@ function relicRepairGuard({ log = console.log, relic = undefined } = {}) {
   return true;
 }
 
+// A dev-mode rebuild must PRESERVE the existing binary's feature set. This repair
+// used to hardcode `--no-default-features`, which silently downgraded a hybrid
+// (embed-model) dev binary to FTS5-only and ping-ponged against a manual
+// `cargo build --release --features embed-model`. Probe the binary's COMPILED
+// feature via `health-check --json` → `model_available` (= cfg!(feature =
+// "embed-model"), reported even with no index) and rebuild to match. Returns
+// true/false, or null when the binary can't be probed (missing/broken) — the
+// caller then defaults to FTS5 + an explicit note, never a silent downgrade.
+// End users never reach this path (binary-stale → auto-update; binary-missing
+// non-dev → install instructions); it is purely the source-repo dev convenience.
+function detectEmbedModel(binary, run = execFileSync) {
+  if (!binary) return null;
+  try {
+    const out = run(binary, ['health-check', '--json'], {
+      timeout: 10000, encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'],
+    });
+    return JSON.parse(out).model_available === true;
+  } catch { return null; }
+}
+
+function devBuildCommand(embed) {
+  return embed
+    ? 'cargo build --release --features embed-model'
+    : 'cargo build --release --no-default-features';
+}
+
 function runRepairs(results) {
   const fixable = results.filter(r => r.fixId);
   if (fixable.length === 0) return 0;
@@ -353,14 +379,23 @@ function runRepairs(results) {
           }
           break;
         }
+        // Preserve the current binary's feature set \u2014 never silently downgrade
+        // a hybrid (embed-model) dev binary to FTS5-only (which also ping-pongs
+        // against a manual `--features embed-model` build).
+        const embed = detectEmbedModel(findBinary());
+        const buildCmd = devBuildCommand(embed === true);
         console.log('\n  Building binary...');
-        console.log('    \u2192 cargo build --release --no-default-features');
+        if (embed === null) {
+          console.log('    (could not detect current feature set \u2014 building FTS5-only;');
+          console.log('     for semantic search rebuild with `cargo build --release --features embed-model`)');
+        }
+        console.log(`    \u2192 ${buildCmd}`);
         try {
           const projectRoot = path.resolve(__dirname, '..', '..');
-          execSync('cargo build --release --no-default-features', {
+          execSync(buildCmd, {
             cwd: projectRoot,
             stdio: 'inherit',
-            timeout: 300000,
+            timeout: 600000,  // embed-model (Candle) builds exceed the old 5min
           });
           clearBinaryCache();
           console.log('  \u2705 Build complete');
@@ -374,13 +409,16 @@ function runRepairs(results) {
       case 'binary-missing': {
         console.log('\n  Installing binary...');
         if (isDevMode()) {
+          // No binary to probe \u2014 build the fast FTS5 binary, but point at the
+          // hybrid option so FTS5 isn't silently presented as the only choice.
           console.log('    \u2192 cargo build --release --no-default-features');
+          console.log('      (for semantic search: cargo build --release --features embed-model)');
           try {
             const projectRoot = path.resolve(__dirname, '..', '..');
             execSync('cargo build --release --no-default-features', {
               cwd: projectRoot,
               stdio: 'inherit',
-              timeout: 300000,
+              timeout: 600000,
             });
             clearBinaryCache();
             console.log('  \u2705 Build complete');
@@ -500,7 +538,7 @@ function runDoctor(opts = {}) {
   return { results, issueCount: issues.length };
 }
 
-module.exports = { runDiagnostics, formatReport, runRepairs, runDoctor, surveyHookCoverage, relicRepairGuard, classifyEmbeddings };
+module.exports = { runDiagnostics, formatReport, runRepairs, runDoctor, surveyHookCoverage, relicRepairGuard, classifyEmbeddings, detectEmbedModel, devBuildCommand };
 
 if (require.main === module) {
   const args = process.argv.slice(2);

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

@@ -122,3 +122,30 @@ test('classifyEmbeddings OK for hybrid (partial + complete) and no-embeddable',
   assert.equal(none.status, 'ok');
   assert.match(none.detail, /no embeddable nodes/);
 });
+
+// ── dev-rebuild feature preservation (no silent hybrid→FTS5 downgrade / ping-pong) ──
+test('devBuildCommand preserves feature set: hybrid → --features embed-model, fts → --no-default-features', () => {
+  const { devBuildCommand } = require('./doctor');
+  assert.match(devBuildCommand(true), /--features embed-model/);
+  assert.doesNotMatch(devBuildCommand(true), /--no-default-features/);
+  assert.match(devBuildCommand(false), /--no-default-features/);
+  assert.doesNotMatch(devBuildCommand(false), /--features embed-model/);
+});
+
+test('detectEmbedModel reads model_available from `health-check --json`; probe failure → null (never a false downgrade signal)', () => {
+  const { detectEmbedModel } = require('./doctor');
+  // hybrid binary
+  const hybridStub = (_bin, args) => {
+    assert.deepEqual(args, ['health-check', '--json']);
+    return JSON.stringify({ model_available: true });
+  };
+  assert.equal(detectEmbedModel('/bin/cg', hybridStub), true);
+  // FTS5-only binary
+  assert.equal(detectEmbedModel('/bin/cg', () => JSON.stringify({ model_available: false })), false);
+  // probe throws (binary broken) → null (caller defaults to FTS5 + note, not a downgrade claim)
+  assert.equal(detectEmbedModel('/bin/cg', () => { throw new Error('boom'); }), null);
+  // unparseable output → null
+  assert.equal(detectEmbedModel('/bin/cg', () => 'not json'), null);
+  // no binary → null
+  assert.equal(detectEmbedModel(null), null);
+});

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

@@ -455,19 +455,27 @@ function runSessionInit({ source } = {}) {
   const autoUpdateLaunched = launchBackgroundAutoUpdate();
   const indexFreshness = binaryCheck.available ? ensureIndexFresh() : 'skipped';
 
-  // v0.9.0 C' 上下文感知默认：插件模式下首次 SessionStart 自动 adopt。
-  // v0.11.0: 已 adopt 的项目如果 shipped template 漂移也会触发一次刷新。
-  // 两种情况都发一次 stderr 提示，让用户知道发生了什么 + 如何回退。
+  // 上下文感知默认：插件模式下首次 SessionStart 自动安装（创建/注入 CLAUDE.md 块 +
+  // .claude/ detail 文件），并清理旧 memory-dir 制品（升级自动迁移）。shipped 漂移
+  // 时刷新。三种情况发一次 stderr 提示，让用户知道发生了什么 + 如何回退。
   const autoAdopt = isRelic ? { attempted: false, result: null } : maybeAutoAdopt({ scriptPath: __dirname });
+  const migrated = autoAdopt.migrated || {};
+  if (migrated.memoryIndexPruned || migrated.legacyDetailRemoved) {
+    process.stderr.write(
+      '[code-graph] Migrated to CLAUDE.md steering — cleaned legacy memory-dir artifacts\n' +
+      '            (MEMORY.md sentinel + detail file). Your other memories are untouched.\n'
+    );
+  }
   if (autoAdopt.attempted && autoAdopt.result && autoAdopt.result.ok) {
     if (autoAdopt.reason === 'refreshed') {
       process.stderr.write(
-        '[code-graph] Refreshed decision table to latest shipped version.\n' +
+        '[code-graph] Refreshed CLAUDE.md decision block to latest shipped version.\n' +
         '            Lock file:  CODE_GRAPH_NO_TEMPLATE_REFRESH=1 in ~/.claude/settings.json env\n'
       );
     } else {
       process.stderr.write(
-        '[code-graph] Auto-adopted into project MEMORY.md (plugin install → knowing consent).\n' +
+        '[code-graph] Installed code-graph block into project CLAUDE.md (plugin install → knowing consent).\n' +
+        '            Detail table: .claude/plugin_code_graph_mcp.md (generated; safe to gitignore)\n' +
         '            Opt out:    CODE_GRAPH_NO_AUTO_ADOPT=1 in ~/.claude/settings.json env\n' +
         '            Reverse:    code-graph-mcp unadopt\n'
       );

package/claude-plugin/templates/plugin_code_graph_mcp.md

@@ -5,15 +5,18 @@ type: reference
 ---
 # code-graph-mcp 插件契约
 
-> Invited-memory 模式：MCP `instructions` 仅留指针，决策细则集中在此。
+> 本文件是 code-graph 工具调度细则。项目根 `CLAUDE.md` 里有一个精炼的 managed
+> 块（sentinel 包裹）做路由摘要 + 指针；本完整决策表按需打开，不每会话常驻。
 >
-> **v0.9.0 起**：插件（`/plugin install`）模式下首次 SessionStart 自动 adopt，
-> 本文件自动写入到项目 memory 目录。
+> **v0.74 起**：插件（`/plugin install`）模式下首次 SessionStart 自动安装——
+> 在项目根 `CLAUDE.md` 注入/创建 managed 块，并把本文件写到 `.claude/plugin_code_graph_mcp.md`。
+> 旧版（≤v0.73）写到 `~/.claude/projects/<slug>/memory/`（MEMORY.md sentinel + 本文件），
+> 升级后首次 SessionStart 自动清理那些遗留制品（你的其它 memory 不受影响）。
 > 退出：`CODE_GRAPH_NO_AUTO_ADOPT=1` 阻止，`code-graph-mcp unadopt` 回退。
 >
-> **v0.11.0 起**：已 adopt 的项目在下次 SessionStart 会自动对齐到插件 shipped
-> 的最新决策表（本文件 SHA 与 template 差异时覆盖）。手动编辑会被覆盖——
-> 要锁定自己的版本，设 `CODE_GRAPH_NO_TEMPLATE_REFRESH=1`（不影响首次 adopt）。
+> 已安装的项目在下次 SessionStart 会自动对齐到插件 shipped 的最新决策表
+> （本文件 / CLAUDE.md 块与 shipped 差异时覆盖）。手动编辑会被覆盖——
+> 要锁定自己的版本，设 `CODE_GRAPH_NO_TEMPLATE_REFRESH=1`（不影响首次安装）。
 >
 > **Hook 默认值（两个 hook，默认不同 —— 故意的）**：
 > - **SessionStart `project_map` 注入：默认 OFF**（v0.17.0 起）。本文件 + 7 个
@@ -139,9 +142,9 @@ code-graph-mcp health-check              # 索引健康
 
 ## 卸载 / 回退
 
-- `code-graph-mcp unadopt` — 精确移除 sentinel 段 + 本文件。
-- `CODE_GRAPH_NO_AUTO_ADOPT=1`（`~/.claude/settings.json` env） — 阻止未来自动 adopt，不影响已 adopted 状态。
-- `CODE_GRAPH_NO_TEMPLATE_REFRESH=1`（v0.11.0+） — 锁定本文件不随插件升级刷新；允许手动编辑长久保留。
+- `code-graph-mcp unadopt` — 精确移除 CLAUDE.md 里的 managed 块 + `.claude/plugin_code_graph_mcp.md`（块移光后若 CLAUDE.md 只剩我们的内容则连文件一起删，否则保留你的正文）；并清理任何遗留 memory-dir 制品。
+- `CODE_GRAPH_NO_AUTO_ADOPT=1`（`~/.claude/settings.json` env） — 阻止未来自动安装，不影响已安装状态。
+- `CODE_GRAPH_NO_TEMPLATE_REFRESH=1` — 锁定 CLAUDE.md 块 + 本文件不随插件升级刷新；允许手动编辑长久保留。
 - `CODE_GRAPH_VERBOSE_HOOKS=1`（v0.17.0+） — opt in 到 SessionStart `project_map` 注入（默认 OFF）。
 - `CODE_GRAPH_QUIET_HOOKS=1` — UserPromptSubmit context push 的 escape hatch（默认 ON）；同时强制 SessionStart `project_map` quiet。
 - `CODE_GRAPH_QUIET_HOOKS=0` — 强制恢复 SessionStart `project_map` 注入（向后兼容路径）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdsrs/code-graph",
-  "version": "0.73.0",
+  "version": "0.74.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": {
@@ -35,10 +35,10 @@
     "node": ">=16"
   },
   "optionalDependencies": {
-    "@sdsrs/code-graph-linux-x64": "0.73.0",
-    "@sdsrs/code-graph-linux-arm64": "0.73.0",
-    "@sdsrs/code-graph-darwin-x64": "0.73.0",
-    "@sdsrs/code-graph-darwin-arm64": "0.73.0",
-    "@sdsrs/code-graph-win32-x64": "0.73.0"
+    "@sdsrs/code-graph-linux-x64": "0.74.0",
+    "@sdsrs/code-graph-linux-arm64": "0.74.0",
+    "@sdsrs/code-graph-darwin-x64": "0.74.0",
+    "@sdsrs/code-graph-darwin-arm64": "0.74.0",
+    "@sdsrs/code-graph-win32-x64": "0.74.0"
   }
 }