@sdsrs/code-graph 0.73.1 → 0.74.0

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

@@ -7,447 +7,387 @@ const os = require('os');
 const {
   adopt, unadopt, memoryDir, stripSentinelBlock,
   isAdopted, isPluginModeInstall, maybeAutoAdopt, needsRefresh, isProjectRoot,
-  detectProjectType, buildIndexLine,
-  SENTINEL_BEGIN, SENTINEL_END, INDEX_LINE, TEMPLATE_PATH, TARGET_NAME,
+  detectProjectType, buildBlock, migrateLegacyMemoryDir,
+  SENTINEL_BEGIN, SENTINEL_END, MANAGED_BY, TEMPLATE_PATH, TARGET_NAME,
   PROJECT_MARKERS,
 } = require('./adopt');
 
+// Legacy v1 sentinel (pre-v0.74, lived in the memory-dir MEMORY.md). Hard-coded
+// here because the strip/migration path must keep removing it after the constant
+// moved to v2.
+const SENTINEL_BEGIN_V1 = '<!-- code-graph-mcp:begin v1 -->';
+
 function makeSandbox() {
   const home = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-adopt-home-'));
   const cwd = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-adopt-cwd-'));
-  // Mark the sandbox cwd as a real project — adopt() now gates on a project
-  // marker unconditionally (see project-detect.js), so a bare mkdtemp would be
-  // treated as a non-project and refused.
+  // Mark the sandbox cwd as a real project — adopt() gates on a project marker.
   fs.mkdirSync(path.join(cwd, '.git'));
-  // Pre-create the memory dir (claude-mem convention — we don't create it).
-  const dir = memoryDir(cwd, home);
-  fs.mkdirSync(dir, { recursive: true });
-  return { home, cwd, dir, cleanup: () => {
-    fs.rmSync(home, { recursive: true, force: true });
-    fs.rmSync(cwd, { recursive: true, force: true });
-  }};
+  return {
+    home, cwd,
+    claudeMd: path.join(cwd, 'CLAUDE.md'),
+    detail: path.join(cwd, '.claude', TARGET_NAME),
+    cleanup: () => {
+      fs.rmSync(home, { recursive: true, force: true });
+      fs.rmSync(cwd, { recursive: true, force: true });
+    },
+  };
 }
 
+// ── memoryDir (legacy slug — still used by migrateLegacyMemoryDir) ──────────
+
 test('memoryDir slugifies cwd path', () => {
-  const dir = memoryDir('/home/alice/proj', '/home/alice');
-  assert.strictEqual(dir, '/home/alice/.claude/projects/-home-alice-proj/memory');
+  assert.strictEqual(
+    memoryDir('/home/alice/proj', '/home/alice'),
+    '/home/alice/.claude/projects/-home-alice-proj/memory'
+  );
 });
 
 test('memoryDir replaces underscores and dots (Claude Code slug convention)', () => {
-  // Real-world bug: /mnt/data_ssd/... needs data-ssd slug, not data_ssd
   assert.strictEqual(
     memoryDir('/mnt/data_ssd/dev/projects/code-graph-mcp', '/home/u'),
     '/home/u/.claude/projects/-mnt-data-ssd-dev-projects-code-graph-mcp/memory'
   );
-  // Hidden dirs: /home/sds/.claude/x → -home-sds--claude-x (double-dash)
   assert.strictEqual(
     memoryDir('/home/sds/.claude/x', '/home/sds'),
     '/home/sds/.claude/projects/-home-sds--claude-x/memory'
   );
-  // Preserves case and hyphens
-  assert.strictEqual(
-    memoryDir('/Users/Alice/my-Project_v2.1', '/'),
-    '/.claude/projects/-Users-Alice-my-Project-v2-1/memory'
-  );
 });
 
-test('adopt writes template and appends sentinel block when index absent', () => {
+test('memoryDir honors CLAUDE_CONFIG_DIR override (multi-account isolation)', () => {
+  const prev = process.env.CLAUDE_CONFIG_DIR;
+  process.env.CLAUDE_CONFIG_DIR = '/home/alice/work-claude';
+  try {
+    assert.strictEqual(
+      memoryDir('/home/alice/proj', '/home/alice'),
+      '/home/alice/work-claude/projects/-home-alice-proj/memory'
+    );
+  } finally {
+    if (prev === undefined) delete process.env.CLAUDE_CONFIG_DIR;
+    else process.env.CLAUDE_CONFIG_DIR = prev;
+  }
+});
+
+// ── buildBlock — the managed CLAUDE.md block ────────────────────────────────
+
+test('buildBlock generic: v2 sentinel + 6 base rows + pointer', () => {
+  const block = buildBlock('generic');
+  assert.ok(block.startsWith(SENTINEL_BEGIN), 'opens with v2 BEGIN');
+  assert.ok(block.endsWith(SENTINEL_END), 'closes with END');
+  assert.ok(block.includes('| Who calls X / what X calls | `code-graph-mcp callgraph X` |'));
+  assert.ok(block.includes('| Impact before editing a fn | `code-graph-mcp impact X` |'));
+  assert.ok(block.includes('Full command + MCP-tool table: `.claude/plugin_code_graph_mcp.md`'));
+  assert.ok(!block.includes('trace'), 'generic has no HTTP-trace row');
+});
+
+test('buildBlock web-rs inserts the HTTP-route → handler row', () => {
+  const block = buildBlock('web-rs');
+  assert.ok(block.includes('HTTP route → handler chain'), 'web project gets trace row');
+  assert.ok(block.includes('`code-graph-mcp trace "GET /api/x"`'));
+});
+
+test('buildBlock frontend surfaces a find-references audit row', () => {
+  const block = buildBlock('frontend');
+  assert.ok(block.includes('Rename / refactor audit (refs)'));
+  assert.ok(block.includes('`code-graph-mcp refs X`'));
+});
+
+test('buildBlock is deterministic (byte-identical across calls)', () => {
+  assert.strictEqual(buildBlock('rust'), buildBlock('rust'));
+  assert.strictEqual(buildBlock('generic'), buildBlock(undefined));
+});
+
+// ── adopt — installs CLAUDE.md block + .claude/ detail ──────────────────────
+
+test('adopt creates CLAUDE.md with the block when none exists', () => {
   const sb = makeSandbox();
   try {
-    const res = adopt({ cwd: sb.cwd, home: sb.home });
+    const res = adopt({ cwd: sb.cwd });
     assert.strictEqual(res.ok, true);
-    assert.strictEqual(res.indexed, true);
-    assert.ok(fs.existsSync(res.target), 'plugin file written');
-    const index = fs.readFileSync(res.indexPath, 'utf8');
-    assert.match(index, /^# Memory Index/);
-    assert.ok(index.includes(SENTINEL_BEGIN));
-    assert.ok(index.includes(SENTINEL_END));
-    assert.ok(index.includes(INDEX_LINE));
+    assert.strictEqual(res.created, true);
+    assert.strictEqual(res.claudeMdWritten, true);
+    assert.strictEqual(res.detailWritten, true);
+    const cmd = fs.readFileSync(sb.claudeMd, 'utf8');
+    assert.ok(cmd.includes(SENTINEL_BEGIN) && cmd.includes(SENTINEL_END));
+    assert.ok(fs.existsSync(sb.detail), 'detail file written under .claude/');
+    assert.ok(fs.readFileSync(sb.detail, 'utf8').startsWith(MANAGED_BY), 'detail has managed-by marker');
   } finally { sb.cleanup(); }
 });
 
-test('adopt is idempotent — no duplicate sentinel on re-run', () => {
+test('adopt injects the block into an existing CLAUDE.md, preserving user prose', () => {
   const sb = makeSandbox();
   try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    const res2 = adopt({ cwd: sb.cwd, home: sb.home });
-    assert.strictEqual(res2.indexed, false, 'second run leaves index alone');
-    const index = fs.readFileSync(res2.indexPath, 'utf8');
-    const matches = index.match(new RegExp(SENTINEL_BEGIN.replace(/[\\/[\]^$.*+?()|{}]/g, '\\$&'), 'g'));
-    assert.strictEqual(matches.length, 1, 'sentinel appears exactly once');
+    fs.writeFileSync(sb.claudeMd, '# My Project\n\nUser instructions here.\n');
+    const res = adopt({ cwd: sb.cwd });
+    assert.strictEqual(res.created, false);
+    assert.strictEqual(res.claudeMdWritten, true);
+    const cmd = fs.readFileSync(sb.claudeMd, 'utf8');
+    assert.ok(cmd.includes('User instructions here.'), 'preserves user prose');
+    assert.ok(cmd.includes(SENTINEL_BEGIN), 'block appended');
   } finally { sb.cleanup(); }
 });
 
-test('adopt preserves existing MEMORY.md content and appends', () => {
+test('adopt is idempotent — no duplicate block, no write on re-run', () => {
   const sb = makeSandbox();
   try {
-    const indexPath = path.join(sb.dir, 'MEMORY.md');
-    fs.writeFileSync(indexPath, '# Memory Index\n\n- [foo.md](foo.md) — existing entry\n');
-    adopt({ cwd: sb.cwd, home: sb.home });
-    const index = fs.readFileSync(indexPath, 'utf8');
-    assert.ok(index.includes('existing entry'), 'preserves prior entries');
-    assert.ok(index.includes(SENTINEL_BEGIN), 'appends sentinel');
+    adopt({ cwd: sb.cwd });
+    const res2 = adopt({ cwd: sb.cwd });
+    assert.strictEqual(res2.claudeMdWritten, false, 'second run leaves CLAUDE.md alone');
+    assert.strictEqual(res2.detailWritten, false, 'second run leaves detail alone');
+    const cmd = fs.readFileSync(sb.claudeMd, 'utf8');
+    const esc = SENTINEL_BEGIN.replace(/[\\/[\]^$.*+?()|{}]/g, '\\$&');
+    assert.strictEqual((cmd.match(new RegExp(esc, 'g')) || []).length, 1, 'block appears exactly once');
   } finally { sb.cleanup(); }
 });
 
-test('adopt + unadopt write atomically — no .tmp residue in the memory dir', () => {
-  // The memory dir is shared with claude-mem-lite, which reads MEMORY.md on
-  // every keyword match; a non-atomic write crashing mid-flight would corrupt
-  // it. adopt/unadopt now go through writeFileAtomic (tmp + rename). Proof the
-  // rename completed cleanly across all three write sites (detail file + adopt
-  // index + unadopt prune): no leftover `*.tmp.<pid>` entries.
+test('adopt block reflects detected project type (web-rs → trace row in CLAUDE.md)', () => {
   const sb = makeSandbox();
   try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    unadopt({ cwd: sb.cwd, home: sb.home });
-    const residue = fs.readdirSync(sb.dir).filter((f) => f.includes('.tmp.'));
-    assert.deepStrictEqual(residue, [], `no atomic-write tmp residue; found: ${residue}`);
+    fs.writeFileSync(path.join(sb.cwd, 'Cargo.toml'), '[dependencies]\naxum = "0.7"\n');
+    adopt({ cwd: sb.cwd });
+    assert.ok(fs.readFileSync(sb.claudeMd, 'utf8').includes('HTTP route → handler chain'));
   } finally { sb.cleanup(); }
 });
 
-test('writeFileAtomic cleans its temp file when rename fails (no orphaned .tmp)', () => {
-  // The success path leaves no residue (above). This pins the FAILURE path: if
-  // renameSync throws (ENOSPC/EACCES/EROFS on the shared memory dir) the temp must
-  // be unlinked, not orphaned. Force every rename to fail and assert no `.tmp.<pid>`
-  // survives the (failed) adopt.
+test('adopt heals a malformed prior block (orphan BEGIN) and preserves neighbors', () => {
   const sb = makeSandbox();
-  const realRename = fs.renameSync;
   try {
-    fs.renameSync = () => { const e = new Error('EROFS: simulated read-only fs'); e.code = 'EROFS'; throw e; };
-    try { adopt({ cwd: sb.cwd, home: sb.home }); } catch { /* expected — rename failed */ }
-    const residue = fs.readdirSync(sb.dir).filter((f) => f.includes('.tmp.'));
-    assert.deepStrictEqual(residue, [], `failed rename must not orphan a temp; found: ${residue}`);
-  } finally {
-    fs.renameSync = realRename;
-    sb.cleanup();
-  }
+    fs.writeFileSync(sb.claudeMd,
+      `# Project\n\nKeep me.\n\n${SENTINEL_BEGIN}\n- stale partial block\n\nAlso keep me.\n`);
+    const res = adopt({ cwd: sb.cwd });
+    assert.strictEqual(res.healed, true);
+    const cmd = fs.readFileSync(sb.claudeMd, 'utf8');
+    const esc = SENTINEL_BEGIN.replace(/[\\/[\]^$.*+?()|{}]/g, '\\$&');
+    assert.strictEqual((cmd.match(new RegExp(esc, 'g')) || []).length, 1, 'exactly one block');
+    assert.ok(cmd.includes('Keep me.') && cmd.includes('Also keep me.'), 'neighbors preserved');
+    assert.ok(!cmd.includes('stale partial block'), 'stale block purged');
+  } finally { sb.cleanup(); }
 });
 
-test('adopt refuses a non-project cwd even when the memory dir already exists (regression: /tmp adoption)', () => {
-  // Bug: the isProjectRoot guard was nested inside `if (!fs.existsSync(dir))`,
-  // so when Claude Code had already created ~/.claude/projects/<slug>/memory
-  // (it does this for every session, incl. the ~2035 headless /tmp mem-lite
-  // calls), adopt() sailed past the guard and wrote its sentinel into /tmp's
-  // MEMORY.md. Pre-fix this test FAILS (adopt returns ok:true and writes).
+test('adopt refuses a non-project cwd and writes nothing', () => {
   const home = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-adopt-home-'));
-  const cwd = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-adopt-cwd-')); // no project marker
-  const dir = memoryDir(cwd, home);
-  fs.mkdirSync(dir, { recursive: true }); // simulate CC pre-creating the memory dir
+  const cwd = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-adopt-cwd-')); // no marker
   try {
-    const res = adopt({ cwd, home });
+    const res = adopt({ cwd });
     assert.strictEqual(res.ok, false);
     assert.strictEqual(res.reason, 'not-a-project');
-    const indexPath = path.join(dir, 'MEMORY.md');
-    assert.ok(
-      !fs.existsSync(indexPath) || !fs.readFileSync(indexPath, 'utf8').includes(SENTINEL_BEGIN),
-      'must NOT write the code-graph sentinel into a non-project MEMORY.md'
-    );
+    assert.ok(!fs.existsSync(path.join(cwd, 'CLAUDE.md')), 'no CLAUDE.md written');
+    assert.ok(!fs.existsSync(path.join(cwd, '.claude')), 'no .claude dir created');
   } finally {
     fs.rmSync(home, { recursive: true, force: true });
     fs.rmSync(cwd, { recursive: true, force: true });
   }
 });
 
-test('adopt fails gracefully when cwd is not a project root', () => {
-  // v0.16.9: behavior change — adopt now mkdir's the memory dir when cwd has
-  // a project marker (.git / Cargo.toml / package.json / ...). Bare mkdtemp
-  // without markers still fails with the more specific 'not-a-project' reason
-  // to prevent /tmp pollution.
-  const home = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-adopt-home-'));
-  const cwd = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-adopt-cwd-'));
+test('adopt writes atomically — no .tmp residue in cwd or .claude', () => {
+  const sb = makeSandbox();
   try {
-    const res = adopt({ cwd, home });
-    assert.strictEqual(res.ok, false);
-    assert.strictEqual(res.reason, 'not-a-project');
+    adopt({ cwd: sb.cwd });
+    const cwdResidue = fs.readdirSync(sb.cwd).filter((f) => f.includes('.tmp.'));
+    const claudeResidue = fs.readdirSync(path.join(sb.cwd, '.claude')).filter((f) => f.includes('.tmp.'));
+    assert.deepStrictEqual(cwdResidue, []);
+    assert.deepStrictEqual(claudeResidue, []);
+  } finally { sb.cleanup(); }
+});
+
+test('writeFileAtomic cleans its temp file when rename fails (no orphaned .tmp)', () => {
+  const sb = makeSandbox();
+  const realRename = fs.renameSync;
+  try {
+    fs.renameSync = () => { const e = new Error('EROFS: simulated read-only fs'); e.code = 'EROFS'; throw e; };
+    try { adopt({ cwd: sb.cwd }); } catch { /* expected — rename failed */ }
+    fs.renameSync = realRename;
+    // .claude may or may not exist depending on which write failed first; tolerate both.
+    const dirs = [sb.cwd, path.join(sb.cwd, '.claude')].filter((d) => fs.existsSync(d));
+    for (const d of dirs) {
+      assert.deepStrictEqual(fs.readdirSync(d).filter((f) => f.includes('.tmp.')), [],
+        `failed rename must not orphan a temp in ${d}`);
+    }
   } finally {
-    fs.rmSync(home, { recursive: true, force: true });
-    fs.rmSync(cwd, { recursive: true, force: true });
+    fs.renameSync = realRename;
+    sb.cleanup();
   }
 });
 
-test('unadopt removes file and sentinel block, preserves other entries', () => {
+// ── unadopt ─────────────────────────────────────────────────────────────────
+
+test('unadopt removes the block + detail file, preserving user prose', () => {
   const sb = makeSandbox();
   try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    // add a neighboring entry
-    const indexPath = path.join(sb.dir, 'MEMORY.md');
-    const withNeighbor = fs.readFileSync(indexPath, 'utf8') + '- [bar.md](bar.md) — neighbor\n';
-    fs.writeFileSync(indexPath, withNeighbor);
-
+    fs.writeFileSync(sb.claudeMd, '# Project\n\nMy own notes.\n');
+    adopt({ cwd: sb.cwd });
     const res = unadopt({ cwd: sb.cwd, home: sb.home });
     assert.strictEqual(res.fileRemoved, true);
-    assert.strictEqual(res.indexPruned, true);
-    assert.ok(!fs.existsSync(res.target), 'plugin file gone');
-    const final = fs.readFileSync(indexPath, 'utf8');
-    assert.ok(!final.includes(SENTINEL_BEGIN), 'sentinel removed');
-    assert.ok(final.includes('neighbor'), 'neighbor preserved');
+    assert.strictEqual(res.blockPruned, true);
+    assert.strictEqual(res.claudeMdRemoved, false, 'CLAUDE.md kept — has user prose');
+    assert.ok(!fs.existsSync(sb.detail), 'detail file gone');
+    const cmd = fs.readFileSync(sb.claudeMd, 'utf8');
+    assert.ok(!cmd.includes(SENTINEL_BEGIN), 'block removed');
+    assert.ok(cmd.includes('My own notes.'), 'user prose preserved');
   } finally { sb.cleanup(); }
 });
 
-test('unadopt is a no-op when never adopted', () => {
+test('unadopt deletes a CLAUDE.md that contained only our block', () => {
   const sb = makeSandbox();
   try {
+    adopt({ cwd: sb.cwd }); // creates a block-only CLAUDE.md
     const res = unadopt({ cwd: sb.cwd, home: sb.home });
-    assert.strictEqual(res.fileRemoved, false);
-    assert.strictEqual(res.indexPruned, false);
+    assert.strictEqual(res.claudeMdRemoved, true);
+    assert.ok(!fs.existsSync(sb.claudeMd), 'block-only CLAUDE.md removed');
   } finally { sb.cleanup(); }
 });
 
-test('template file exists and contains decision table', () => {
-  assert.ok(fs.existsSync(TEMPLATE_PATH), `template at ${TEMPLATE_PATH}`);
-  const content = fs.readFileSync(TEMPLATE_PATH, 'utf8');
-  assert.ok(content.includes('get_call_graph'), 'mentions get_call_graph');
-  assert.ok(content.includes('impact_analysis'), 'mentions impact_analysis');
-  assert.ok(content.includes('CODE_GRAPH_QUIET_HOOKS'), 'mentions env gate');
-});
-
-test('stripSentinelBlock removes well-formed block', () => {
-  const before = `# Index\n${SENTINEL_BEGIN}\n${INDEX_LINE}\n${SENTINEL_END}\n- [x.md](x.md)\n`;
-  const after = stripSentinelBlock(before);
-  assert.ok(!after.includes(SENTINEL_BEGIN));
-  assert.ok(!after.includes(SENTINEL_END));
-  assert.ok(after.includes('- [x.md](x.md)'), 'preserves neighbors');
-});
-
-test('stripSentinelBlock self-heals orphan BEGIN without END', () => {
-  // Truncation / partial edit scenario
-  const before = `# Index\n- [a.md](a.md) — entry\n${SENTINEL_BEGIN}\n${INDEX_LINE}\n\n- [b.md](b.md) — survivor\n`;
-  const after = stripSentinelBlock(before);
-  assert.ok(!after.includes(SENTINEL_BEGIN), 'orphan BEGIN removed');
-  assert.ok(after.includes('survivor'), 'content past blank-line boundary preserved');
-  assert.ok(after.includes('entry'), 'content before BEGIN preserved');
-});
-
-test('stripSentinelBlock self-heals orphan END line', () => {
-  const before = `# Index\n- [a.md](a.md)\n${SENTINEL_END}\n- [b.md](b.md)\n`;
-  const after = stripSentinelBlock(before);
-  assert.ok(!after.includes(SENTINEL_END));
-  assert.ok(after.includes('- [a.md](a.md)') && after.includes('- [b.md](b.md)'));
+test('unadopt will NOT delete a user file lacking our managed-by marker', () => {
+  const sb = makeSandbox();
+  try {
+    fs.mkdirSync(path.join(sb.cwd, '.claude'));
+    fs.writeFileSync(sb.detail, 'user-authored notes, not ours\n');
+    const res = unadopt({ cwd: sb.cwd, home: sb.home });
+    assert.strictEqual(res.fileRemoved, false, 'unmarked file is not deleted');
+    assert.ok(fs.existsSync(sb.detail), 'user file survives');
+  } finally { sb.cleanup(); }
 });
 
-test('adopt heals malformed sentinel (orphan BEGIN) on re-run', () => {
+test('unadopt is a no-op when never adopted', () => {
   const sb = makeSandbox();
   try {
-    const indexPath = path.join(sb.dir, 'MEMORY.md');
-    // Simulate truncated prior adopt — BEGIN line + stale entry, no END
-    fs.writeFileSync(
-      indexPath,
-      `# Memory Index\n- [old.md](old.md) — preserved\n${SENTINEL_BEGIN}\n- [stale](stale.md) — wrong entry\n\n- [neighbor.md](neighbor.md) — survives\n`
-    );
-    const res = adopt({ cwd: sb.cwd, home: sb.home });
-    assert.strictEqual(res.ok, true);
-    assert.strictEqual(res.healed, true, 'reports healed');
-    const final = fs.readFileSync(indexPath, 'utf8');
-    // Exactly one well-formed block now
-    const beginCount = (final.match(new RegExp(SENTINEL_BEGIN.replace(/[\\/[\]^$.*+?()|{}]/g, '\\$&'), 'g')) || []).length;
-    const endCount = (final.match(new RegExp(SENTINEL_END.replace(/[\\/[\]^$.*+?()|{}]/g, '\\$&'), 'g')) || []).length;
-    assert.strictEqual(beginCount, 1, 'one BEGIN');
-    assert.strictEqual(endCount, 1, 'one END');
-    assert.ok(final.includes('preserved'), 'preserves pre-BEGIN content');
-    assert.ok(final.includes('neighbor.md'), 'preserves post-malformed-block content');
-    assert.ok(!final.includes('stale.md'), 'old wrong entry purged');
-    assert.ok(final.includes(INDEX_LINE), 'fresh canonical line written');
+    const res = unadopt({ cwd: sb.cwd, home: sb.home });
+    assert.strictEqual(res.fileRemoved, false);
+    assert.strictEqual(res.blockPruned, false);
   } finally { sb.cleanup(); }
 });
 
-test('adopt is a true no-op when desired block is already present verbatim', () => {
+// ── isAdopted ───────────────────────────────────────────────────────────────
+
+test('isAdopted: false fresh, true after adopt, false after unadopt', () => {
   const sb = makeSandbox();
   try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    const indexPath = path.join(sb.dir, 'MEMORY.md');
-    const before = fs.readFileSync(indexPath, 'utf8');
-    const beforeMtime = fs.statSync(indexPath).mtimeMs;
-    const res2 = adopt({ cwd: sb.cwd, home: sb.home });
-    assert.strictEqual(res2.indexed, false);
-    assert.strictEqual(res2.healed, false);
-    assert.strictEqual(fs.readFileSync(indexPath, 'utf8'), before, 'file content identical');
-    // mtime may equal beforeMtime since we skipped the write
-    assert.strictEqual(fs.statSync(indexPath).mtimeMs, beforeMtime, 'no write occurred');
+    assert.strictEqual(isAdopted({ cwd: sb.cwd }), false);
+    adopt({ cwd: sb.cwd });
+    assert.strictEqual(isAdopted({ cwd: sb.cwd }), true);
+    unadopt({ cwd: sb.cwd, home: sb.home });
+    assert.strictEqual(isAdopted({ cwd: sb.cwd }), false);
   } finally { sb.cleanup(); }
 });
 
-test('unadopt heals malformed sentinel (orphan BEGIN)', () => {
+test('isAdopted: false when block present but detail file missing', () => {
   const sb = makeSandbox();
   try {
-    const indexPath = path.join(sb.dir, 'MEMORY.md');
-    fs.writeFileSync(
-      indexPath,
-      `# Index\n${SENTINEL_BEGIN}\n${INDEX_LINE}\n\n- [keep.md](keep.md) — survives\n`
-    );
-    const res = unadopt({ cwd: sb.cwd, home: sb.home });
-    assert.strictEqual(res.indexPruned, true);
-    const final = fs.readFileSync(indexPath, 'utf8');
-    assert.ok(!final.includes(SENTINEL_BEGIN), 'orphan BEGIN purged');
-    assert.ok(final.includes('keep.md'), 'content past blank-line preserved');
+    fs.writeFileSync(sb.claudeMd, `${SENTINEL_BEGIN}\nx\n${SENTINEL_END}\n`);
+    assert.strictEqual(isAdopted({ cwd: sb.cwd }), false, 'needs both block + detail');
   } finally { sb.cleanup(); }
 });
 
-// ──────────────────────────────────────────────────────────────────────────
-// v0.9.0 — C' context-aware auto-adopt
-// ──────────────────────────────────────────────────────────────────────────
+// ── needsRefresh ────────────────────────────────────────────────────────────
 
-test('isAdopted returns false on fresh project (no files)', () => {
+test('needsRefresh: false right after adopt', () => {
   const sb = makeSandbox();
   try {
-    assert.strictEqual(isAdopted({ cwd: sb.cwd, home: sb.home }), false);
+    adopt({ cwd: sb.cwd });
+    assert.strictEqual(needsRefresh({ cwd: sb.cwd }), false);
   } finally { sb.cleanup(); }
 });
 
-test('isAdopted returns true after adopt()', () => {
+test('needsRefresh: true when detail-doc body drifts from shipped template', () => {
   const sb = makeSandbox();
   try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    assert.strictEqual(isAdopted({ cwd: sb.cwd, home: sb.home }), true);
+    adopt({ cwd: sb.cwd });
+    fs.writeFileSync(sb.detail, `${MANAGED_BY}\n# stale content from an older plugin\n`);
+    assert.strictEqual(needsRefresh({ cwd: sb.cwd }), true);
   } finally { sb.cleanup(); }
 });
 
-test('isAdopted returns false after unadopt()', () => {
+test('needsRefresh: true when the CLAUDE.md block drifts (project type change)', () => {
   const sb = makeSandbox();
   try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    unadopt({ cwd: sb.cwd, home: sb.home });
-    assert.strictEqual(isAdopted({ cwd: sb.cwd, home: sb.home }), false);
+    adopt({ cwd: sb.cwd }); // generic block
+    // Now the project gains a web framework — block should switch to web-rs.
+    fs.writeFileSync(path.join(sb.cwd, 'Cargo.toml'), '[dependencies]\naxum = "0.7"\n');
+    assert.strictEqual(needsRefresh({ cwd: sb.cwd }), true);
   } finally { sb.cleanup(); }
 });
 
-test('isAdopted returns false when target file exists but index has no sentinel', () => {
+test('needsRefresh: false when not adopted (nothing to refresh)', () => {
   const sb = makeSandbox();
   try {
-    const indexPath = path.join(sb.dir, 'MEMORY.md');
-    fs.writeFileSync(indexPath, '# Memory Index\n- [foo.md](foo.md) — unrelated\n');
-    fs.writeFileSync(path.join(sb.dir, 'plugin_code_graph_mcp.md'), 'stale copy');
-    assert.strictEqual(isAdopted({ cwd: sb.cwd, home: sb.home }), false);
+    assert.strictEqual(needsRefresh({ cwd: sb.cwd }), false);
   } finally { sb.cleanup(); }
 });
 
-test('isPluginModeInstall recognizes ~/.claude/plugins/... paths', () => {
-  const pluginPath = '/home/user/.claude/plugins/cache/code-graph-mcp@0.9.0/scripts';
-  assert.strictEqual(isPluginModeInstall(pluginPath), true);
-});
+// ── maybeAutoAdopt ──────────────────────────────────────────────────────────
 
-test('isPluginModeInstall rejects npm global install paths', () => {
-  const npmPath = '/usr/local/lib/node_modules/@sdsrs/code-graph/claude-plugin/scripts';
-  assert.strictEqual(isPluginModeInstall(npmPath), false);
-});
+const PLUGIN_SCRIPTS = '/home/u/.claude/plugins/cache/code-graph-mcp/scripts';
 
-test('isPluginModeInstall rejects dev-checkout paths', () => {
-  const devPath = '/mnt/data_ssd/dev/projects/code-graph-mcp/claude-plugin/scripts';
-  assert.strictEqual(isPluginModeInstall(devPath), false);
-});
-
-test('isPluginModeInstall rejects npx cache paths', () => {
-  const npxPath = '/tmp/npx-abc123/node_modules/@sdsrs/code-graph/claude-plugin/scripts';
-  assert.strictEqual(isPluginModeInstall(npxPath), false);
-});
-
-test('memoryDir honors CLAUDE_CONFIG_DIR override (multi-account isolation)', () => {
-  const prev = process.env.CLAUDE_CONFIG_DIR;
-  process.env.CLAUDE_CONFIG_DIR = '/home/alice/work-claude';
+test('maybeAutoAdopt skips when CODE_GRAPH_NO_AUTO_ADOPT=1', () => {
+  const sb = makeSandbox();
   try {
-    // home arg is irrelevant when env var is set — projects live under the
-    // configured claude dir, not home/.claude.
-    assert.strictEqual(
-      memoryDir('/home/alice/proj', '/home/alice'),
-      '/home/alice/work-claude/projects/-home-alice-proj/memory'
-    );
-  } finally {
-    if (prev === undefined) delete process.env.CLAUDE_CONFIG_DIR;
-    else process.env.CLAUDE_CONFIG_DIR = prev;
-  }
+    const res = maybeAutoAdopt({ cwd: sb.cwd, home: sb.home, scriptPath: PLUGIN_SCRIPTS, env: { CODE_GRAPH_NO_AUTO_ADOPT: '1' } });
+    assert.strictEqual(res.reason, 'opted-out');
+    assert.strictEqual(isAdopted({ cwd: sb.cwd }), false);
+  } finally { sb.cleanup(); }
 });
 
-test('isPluginModeInstall recognizes CLAUDE_CONFIG_DIR/plugins/... paths', () => {
-  const prev = process.env.CLAUDE_CONFIG_DIR;
-  process.env.CLAUDE_CONFIG_DIR = '/home/alice/work-claude';
+test('maybeAutoAdopt skips when not plugin-mode (npm install path)', () => {
+  const sb = makeSandbox();
   try {
-    const pluginPath = '/home/alice/work-claude/plugins/cache/code-graph-mcp@0.31.0/scripts';
-    assert.strictEqual(isPluginModeInstall(pluginPath), true);
-    // Legacy ~/.claude/plugins/ path still works even with env var set.
-    assert.strictEqual(
-      isPluginModeInstall('/home/user/.claude/plugins/cache/code-graph-mcp/scripts'),
-      true
-    );
-    // Unrelated path under same prefix is still rejected.
-    assert.strictEqual(
-      isPluginModeInstall('/home/alice/work-claude/projects/foo/memory'),
-      false
-    );
-  } finally {
-    if (prev === undefined) delete process.env.CLAUDE_CONFIG_DIR;
-    else process.env.CLAUDE_CONFIG_DIR = prev;
-  }
+    const res = maybeAutoAdopt({ cwd: sb.cwd, home: sb.home, scriptPath: '/usr/local/lib/node_modules/@sdsrs/code-graph/claude-plugin/scripts', env: {} });
+    assert.strictEqual(res.reason, 'not-plugin-mode');
+    assert.strictEqual(isAdopted({ cwd: sb.cwd }), false);
+  } finally { sb.cleanup(); }
 });
 
-test('maybeAutoAdopt skips when CODE_GRAPH_NO_AUTO_ADOPT=1', () => {
+test('maybeAutoAdopt installs when plugin-mode + not-yet-adopted', () => {
   const sb = makeSandbox();
   try {
-    const res = maybeAutoAdopt({
-      cwd: sb.cwd, home: sb.home,
-      scriptPath: '/home/u/.claude/plugins/cache/code-graph-mcp/scripts',
-      env: { CODE_GRAPH_NO_AUTO_ADOPT: '1' },
-    });
-    assert.strictEqual(res.attempted, false);
-    assert.strictEqual(res.reason, 'opted-out');
-    assert.strictEqual(isAdopted({ cwd: sb.cwd, home: sb.home }), false);
+    const res = maybeAutoAdopt({ cwd: sb.cwd, home: sb.home, scriptPath: PLUGIN_SCRIPTS, env: {} });
+    assert.strictEqual(res.attempted, true);
+    assert.strictEqual(res.reason, 'adopted');
+    assert.strictEqual(res.result.ok, true);
+    assert.strictEqual(isAdopted({ cwd: sb.cwd }), true);
   } finally { sb.cleanup(); }
 });
 
-test('maybeAutoAdopt skips when not plugin-mode (npm install)', () => {
+test('maybeAutoAdopt is already-adopted when in sync (no gratuitous write)', () => {
   const sb = makeSandbox();
   try {
-    const res = maybeAutoAdopt({
-      cwd: sb.cwd, home: sb.home,
-      scriptPath: '/usr/local/lib/node_modules/@sdsrs/code-graph/claude-plugin/scripts',
-      env: {},
-    });
-    assert.strictEqual(res.attempted, false);
-    assert.strictEqual(res.reason, 'not-plugin-mode');
-    assert.strictEqual(isAdopted({ cwd: sb.cwd, home: sb.home }), false);
+    adopt({ cwd: sb.cwd });
+    const mtime = fs.statSync(sb.claudeMd).mtimeMs;
+    const res = maybeAutoAdopt({ cwd: sb.cwd, home: sb.home, scriptPath: PLUGIN_SCRIPTS, env: {} });
+    assert.strictEqual(res.reason, 'already-adopted');
+    assert.strictEqual(fs.statSync(sb.claudeMd).mtimeMs, mtime, 'CLAUDE.md not touched');
   } finally { sb.cleanup(); }
 });
 
-test('maybeAutoAdopt skips when already adopted (idempotent)', () => {
+test('maybeAutoAdopt refreshes a drifted detail doc (reason=refreshed)', () => {
   const sb = makeSandbox();
   try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    const res = maybeAutoAdopt({
-      cwd: sb.cwd, home: sb.home,
-      scriptPath: '/home/u/.claude/plugins/cache/code-graph-mcp/scripts',
-      env: {},
-    });
-    assert.strictEqual(res.attempted, false);
-    assert.strictEqual(res.reason, 'already-adopted');
+    adopt({ cwd: sb.cwd });
+    fs.writeFileSync(sb.detail, `${MANAGED_BY}\n# stale\n`);
+    const res = maybeAutoAdopt({ cwd: sb.cwd, home: sb.home, scriptPath: PLUGIN_SCRIPTS, env: {} });
+    assert.strictEqual(res.reason, 'refreshed');
+    const shipped = fs.readFileSync(TEMPLATE_PATH);
+    const cur = fs.readFileSync(sb.detail);
+    const nl = cur.indexOf(0x0a);
+    assert.ok(shipped.equals(cur.subarray(nl + 1)), 'detail re-synced to shipped template');
   } finally { sb.cleanup(); }
 });
 
-test('maybeAutoAdopt runs adopt when plugin-mode + unadopted + no opt-out', () => {
+test('maybeAutoAdopt skips refresh when CODE_GRAPH_NO_TEMPLATE_REFRESH=1 (locks edits)', () => {
   const sb = makeSandbox();
   try {
-    const res = maybeAutoAdopt({
-      cwd: sb.cwd, home: sb.home,
-      scriptPath: '/home/u/.claude/plugins/cache/code-graph-mcp/scripts',
-      env: {},
-    });
-    assert.strictEqual(res.attempted, true);
-    assert.strictEqual(res.result.ok, true);
-    assert.strictEqual(res.result.indexed, true);
-    assert.strictEqual(isAdopted({ cwd: sb.cwd, home: sb.home }), true);
+    adopt({ cwd: sb.cwd });
+    const userEdit = `${MANAGED_BY}\n# my hand-edited table\n`;
+    fs.writeFileSync(sb.detail, userEdit);
+    const res = maybeAutoAdopt({ cwd: sb.cwd, home: sb.home, scriptPath: PLUGIN_SCRIPTS, env: { CODE_GRAPH_NO_TEMPLATE_REFRESH: '1' } });
+    assert.strictEqual(res.reason, 'already-adopted');
+    assert.strictEqual(fs.readFileSync(sb.detail, 'utf8'), userEdit, 'user edit preserved');
   } finally { sb.cleanup(); }
 });
 
-test('maybeAutoAdopt fails with not-a-project when cwd has no project marker', () => {
-  // v0.16.9: bare mkdtemp cwd without .git/Cargo.toml/etc. surfaces
-  // 'not-a-project' so plugin-mode auto-adopt doesn't litter ~/.claude/projects/
-  // with bogus slugs from non-project working directories.
+test('maybeAutoAdopt surfaces not-a-project for a bare cwd', () => {
   const home = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-adopt-home-'));
   const cwd = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-adopt-cwd-'));
   try {
-    const res = maybeAutoAdopt({
-      cwd, home,
-      scriptPath: '/home/u/.claude/plugins/cache/code-graph-mcp/scripts',
-      env: {},
-    });
-    assert.strictEqual(res.attempted, true);
+    const res = maybeAutoAdopt({ cwd, home, scriptPath: PLUGIN_SCRIPTS, env: {} });
     assert.strictEqual(res.result.ok, false);
     assert.strictEqual(res.result.reason, 'not-a-project');
   } finally {
@@ -456,154 +396,153 @@ test('maybeAutoAdopt fails with not-a-project when cwd has no project marker', (
   }
 });
 
-// v0.11.0 — template-refresh on drift
+// ── migrateLegacyMemoryDir — auto-upgrade cleanup of the pre-v0.74 scheme ────
+
+function seedLegacy(sb) {
+  const dir = memoryDir(sb.cwd, sb.home);
+  fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(path.join(dir, TARGET_NAME), `<!-- adopted-by: ${sb.cwd} -->\nold detail table\n`);
+  fs.writeFileSync(path.join(dir, 'MEMORY.md'),
+    `# Memory Index\n\n- [user_note.md](user_note.md) — keep me\n\n${SENTINEL_BEGIN_V1}\n- old code-graph router line\n${SENTINEL_END}\n`);
+  return { dir, memIndex: path.join(dir, 'MEMORY.md'), legacyDetail: path.join(dir, TARGET_NAME) };
+}
 
-test('needsRefresh returns false when target matches shipped template + INDEX_LINE', () => {
+test('migrate strips the legacy v1 MEMORY.md block + deletes the adopted-by detail file', () => {
   const sb = makeSandbox();
   try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    assert.strictEqual(needsRefresh({ cwd: sb.cwd, home: sb.home }), false);
+    const L = seedLegacy(sb);
+    const res = migrateLegacyMemoryDir({ cwd: sb.cwd, home: sb.home });
+    assert.strictEqual(res.memoryIndexPruned, true);
+    assert.strictEqual(res.legacyDetailRemoved, true);
+    assert.ok(!fs.existsSync(L.legacyDetail), 'legacy detail deleted');
+    const mem = fs.readFileSync(L.memIndex, 'utf8');
+    assert.ok(!mem.includes(SENTINEL_BEGIN_V1), 'v1 sentinel removed');
+    assert.ok(mem.includes('keep me'), "user's other memory preserved");
   } finally { sb.cleanup(); }
 });
 
-test('needsRefresh returns true when target content drifted from shipped template', () => {
+test('migrate will NOT delete a legacy detail file lacking the adopted-by marker', () => {
   const sb = makeSandbox();
   try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    const target = path.join(sb.dir, TARGET_NAME);
-    fs.writeFileSync(target, '# stale content from earlier plugin version\n');
-    assert.strictEqual(needsRefresh({ cwd: sb.cwd, home: sb.home }), true);
+    const dir = memoryDir(sb.cwd, sb.home);
+    fs.mkdirSync(dir, { recursive: true });
+    const userFile = path.join(dir, TARGET_NAME);
+    fs.writeFileSync(userFile, 'a user file that happens to share the name\n');
+    const res = migrateLegacyMemoryDir({ cwd: sb.cwd, home: sb.home });
+    assert.strictEqual(res.legacyDetailRemoved, false);
+    assert.ok(fs.existsSync(userFile), 'unmarked file survives');
   } finally { sb.cleanup(); }
 });
 
-test('needsRefresh returns true when MEMORY.md INDEX_LINE drifted', () => {
+test('migrate is a no-op when there is nothing to clean', () => {
   const sb = makeSandbox();
   try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    const indexPath = path.join(sb.dir, 'MEMORY.md');
-    const stale = `# Memory Index\n\n${SENTINEL_BEGIN}\n- old 12-tool index line\n${SENTINEL_END}\n`;
-    fs.writeFileSync(indexPath, stale);
-    assert.strictEqual(needsRefresh({ cwd: sb.cwd, home: sb.home }), true);
+    const res = migrateLegacyMemoryDir({ cwd: sb.cwd, home: sb.home });
+    assert.deepStrictEqual(res, { memoryIndexPruned: false, legacyDetailRemoved: false });
   } finally { sb.cleanup(); }
 });
 
-test('needsRefresh returns false when not adopted (nothing to refresh)', () => {
+test('maybeAutoAdopt runs the legacy migration then installs the new scheme', () => {
   const sb = makeSandbox();
   try {
-    assert.strictEqual(needsRefresh({ cwd: sb.cwd, home: sb.home }), false);
+    const L = seedLegacy(sb);
+    const res = maybeAutoAdopt({ cwd: sb.cwd, home: sb.home, scriptPath: PLUGIN_SCRIPTS, env: {} });
+    assert.ok(res.migrated.memoryIndexPruned && res.migrated.legacyDetailRemoved, 'legacy cleaned');
+    assert.ok(!fs.existsSync(L.legacyDetail), 'legacy detail gone');
+    assert.ok(!fs.readFileSync(L.memIndex, 'utf8').includes(SENTINEL_BEGIN_V1), 'v1 block gone');
+    assert.strictEqual(isAdopted({ cwd: sb.cwd }), true, 'new CLAUDE.md scheme installed');
   } finally { sb.cleanup(); }
 });
 
-test('maybeAutoAdopt refreshes drifted target on re-run (reason=refreshed)', () => {
-  const sb = makeSandbox();
-  try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    const target = path.join(sb.dir, TARGET_NAME);
-    fs.writeFileSync(target, '# stale\n');
-    const res = maybeAutoAdopt({
-      cwd: sb.cwd, home: sb.home,
-      scriptPath: '/home/u/.claude/plugins/cache/code-graph-mcp/scripts',
-      env: {},
-    });
-    assert.strictEqual(res.attempted, true);
-    assert.strictEqual(res.reason, 'refreshed');
-    assert.strictEqual(res.result.ok, true);
-    // Target now matches shipped template (after stripping the leading
-    // "<!-- adopted-by: ... -->\n" collision marker added by adopt v0.16.9).
-    const shipped = fs.readFileSync(TEMPLATE_PATH);
-    const current = fs.readFileSync(target);
-    const nl = current.indexOf(0x0a);
-    const body = nl > 0 && /^<!-- adopted-by: /.test(current.subarray(0, nl).toString())
-      ? current.subarray(nl + 1) : current;
-    assert.ok(shipped.equals(body), 'target re-synced to shipped template');
-    // Sentinel preserved in MEMORY.md
-    assert.strictEqual(isAdopted({ cwd: sb.cwd, home: sb.home }), true);
-  } finally { sb.cleanup(); }
+// ── stripSentinelBlock (matches v1 + v2) ────────────────────────────────────
+
+test('stripSentinelBlock removes a well-formed v2 block, preserving neighbors', () => {
+  const before = `# Index\nKeep.\n\n${SENTINEL_BEGIN}\nbody\n${SENTINEL_END}\n\n- [x.md](x.md)\n`;
+  const after = stripSentinelBlock(before);
+  assert.ok(!after.includes(SENTINEL_BEGIN) && !after.includes(SENTINEL_END));
+  assert.ok(after.includes('Keep.') && after.includes('- [x.md](x.md)'));
 });
 
-test('maybeAutoAdopt refreshes drifted INDEX_LINE in MEMORY.md', () => {
-  const sb = makeSandbox();
-  try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    const indexPath = path.join(sb.dir, 'MEMORY.md');
-    const stale = `# Memory Index\n\n${SENTINEL_BEGIN}\n- old 12-tool index line\n${SENTINEL_END}\n`;
-    fs.writeFileSync(indexPath, stale);
-    const res = maybeAutoAdopt({
-      cwd: sb.cwd, home: sb.home,
-      scriptPath: '/home/u/.claude/plugins/cache/code-graph-mcp/scripts',
-      env: {},
-    });
-    assert.strictEqual(res.attempted, true);
-    assert.strictEqual(res.reason, 'refreshed');
-    const index = fs.readFileSync(indexPath, 'utf8');
-    assert.ok(index.includes(INDEX_LINE), 'INDEX_LINE restored from current constant');
-    assert.ok(!index.includes('old 12-tool index line'), 'stale line removed');
-  } finally { sb.cleanup(); }
+test('stripSentinelBlock removes a legacy v1 block (version-agnostic match)', () => {
+  const before = `# Index\n${SENTINEL_BEGIN_V1}\n- old line\n${SENTINEL_END}\n- [keep.md](keep.md)\n`;
+  const after = stripSentinelBlock(before);
+  assert.ok(!after.includes(SENTINEL_BEGIN_V1), 'v1 begin removed');
+  assert.ok(after.includes('- [keep.md](keep.md)'), 'neighbor preserved');
 });
 
-test('maybeAutoAdopt skips refresh when CODE_GRAPH_NO_TEMPLATE_REFRESH=1 (locks manual edits)', () => {
-  const sb = makeSandbox();
-  try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    const target = path.join(sb.dir, TARGET_NAME);
-    const userEdit = '# my hand-edited decision table\n';
-    fs.writeFileSync(target, userEdit);
-    const res = maybeAutoAdopt({
-      cwd: sb.cwd, home: sb.home,
-      scriptPath: '/home/u/.claude/plugins/cache/code-graph-mcp/scripts',
-      env: { CODE_GRAPH_NO_TEMPLATE_REFRESH: '1' },
-    });
-    assert.strictEqual(res.attempted, false);
-    assert.strictEqual(res.reason, 'already-adopted');
-    assert.strictEqual(fs.readFileSync(target, 'utf8'), userEdit, 'user edit preserved');
-  } finally { sb.cleanup(); }
+test('stripSentinelBlock self-heals orphan BEGIN without END', () => {
+  const before = `# Index\n- [a.md](a.md) — entry\n${SENTINEL_BEGIN}\nbody\n\n- [b.md](b.md) — survivor\n`;
+  const after = stripSentinelBlock(before);
+  assert.ok(!after.includes(SENTINEL_BEGIN), 'orphan BEGIN removed');
+  assert.ok(after.includes('survivor') && after.includes('entry'));
 });
 
-test('maybeAutoAdopt stays already-adopted when in sync (no gratuitous refresh)', () => {
-  const sb = makeSandbox();
-  try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    const target = path.join(sb.dir, TARGET_NAME);
-    const mtimeBefore = fs.statSync(target).mtimeMs;
-    const res = maybeAutoAdopt({
-      cwd: sb.cwd, home: sb.home,
-      scriptPath: '/home/u/.claude/plugins/cache/code-graph-mcp/scripts',
-      env: {},
-    });
-    assert.strictEqual(res.attempted, false);
-    assert.strictEqual(res.reason, 'already-adopted');
-    const mtimeAfter = fs.statSync(target).mtimeMs;
-    assert.strictEqual(mtimeAfter, mtimeBefore, 'target file not touched when in sync');
-  } finally { sb.cleanup(); }
+test('stripSentinelBlock self-heals orphan END line', () => {
+  const before = `# Index\n- [a.md](a.md)\n${SENTINEL_END}\n- [b.md](b.md)\n`;
+  const after = stripSentinelBlock(before);
+  assert.ok(!after.includes(SENTINEL_END));
+  assert.ok(after.includes('- [a.md](a.md)') && after.includes('- [b.md](b.md)'));
 });
 
+// ── platform guard ──────────────────────────────────────────────────────────
+
 test('Windows platform is rejected with clear reason', { skip: process.platform === 'win32' }, () => {
   const orig = process.platform;
   Object.defineProperty(process, 'platform', { value: 'win32', configurable: true });
   try {
     const sb = makeSandbox();
     try {
-      const adoptRes = adopt({ cwd: sb.cwd, home: sb.home });
-      assert.strictEqual(adoptRes.ok, false);
-      assert.strictEqual(adoptRes.reason, 'windows-not-supported');
-      const unadoptRes = unadopt({ cwd: sb.cwd, home: sb.home });
-      assert.strictEqual(unadoptRes.ok, false);
-      assert.strictEqual(unadoptRes.reason, 'windows-not-supported');
+      assert.strictEqual(adopt({ cwd: sb.cwd }).reason, 'windows-not-supported');
+      assert.strictEqual(unadopt({ cwd: sb.cwd, home: sb.home }).reason, 'windows-not-supported');
     } finally { sb.cleanup(); }
   } finally {
     Object.defineProperty(process, 'platform', { value: orig, configurable: true });
   }
 });
 
-// ─── C fix: project-marker mkdir ─────────────────────────────────────────
+// ── template integrity ──────────────────────────────────────────────────────
+
+test('template file exists and contains the decision table', () => {
+  assert.ok(fs.existsSync(TEMPLATE_PATH), `template at ${TEMPLATE_PATH}`);
+  const content = fs.readFileSync(TEMPLATE_PATH, 'utf8');
+  assert.ok(content.includes('get_call_graph'), 'mentions get_call_graph');
+  assert.ok(content.includes('CODE_GRAPH_QUIET_HOOKS'), 'mentions env gate');
+  assert.ok(content.includes('.claude/plugin_code_graph_mcp.md'), 'describes the new layout');
+});
+
+// ── isPluginModeInstall ─────────────────────────────────────────────────────
+
+test('isPluginModeInstall recognizes ~/.claude/plugins/... paths', () => {
+  assert.strictEqual(isPluginModeInstall('/home/user/.claude/plugins/cache/code-graph-mcp@0.9.0/scripts'), true);
+});
+
+test('isPluginModeInstall rejects npm global / dev / npx paths', () => {
+  assert.strictEqual(isPluginModeInstall('/usr/local/lib/node_modules/@sdsrs/code-graph/claude-plugin/scripts'), false);
+  assert.strictEqual(isPluginModeInstall('/mnt/data_ssd/dev/projects/code-graph-mcp/claude-plugin/scripts'), false);
+  assert.strictEqual(isPluginModeInstall('/tmp/npx-abc123/node_modules/@sdsrs/code-graph/claude-plugin/scripts'), false);
+});
+
+test('isPluginModeInstall recognizes CLAUDE_CONFIG_DIR/plugins/... paths', () => {
+  const prev = process.env.CLAUDE_CONFIG_DIR;
+  process.env.CLAUDE_CONFIG_DIR = '/home/alice/work-claude';
+  try {
+    assert.strictEqual(isPluginModeInstall('/home/alice/work-claude/plugins/cache/code-graph-mcp@0.31.0/scripts'), true);
+    assert.strictEqual(isPluginModeInstall('/home/user/.claude/plugins/cache/code-graph-mcp/scripts'), true);
+    assert.strictEqual(isPluginModeInstall('/home/alice/work-claude/projects/foo/memory'), false);
+  } finally {
+    if (prev === undefined) delete process.env.CLAUDE_CONFIG_DIR;
+    else process.env.CLAUDE_CONFIG_DIR = prev;
+  }
+});
+
+// ── isProjectRoot markers ───────────────────────────────────────────────────
 
 test('isProjectRoot detects each marker', () => {
   for (const marker of PROJECT_MARKERS) {
     const cwd = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-marker-'));
     try {
-      assert.strictEqual(isProjectRoot(cwd), false, `bare cwd should not be a project`);
+      assert.strictEqual(isProjectRoot(cwd), false, 'bare cwd should not be a project');
       const markerPath = path.join(cwd, marker);
-      // Some markers are directories (.git, .code-graph), others are files.
       if (marker.startsWith('.')) fs.mkdirSync(markerPath);
       else fs.writeFileSync(markerPath, '');
       assert.strictEqual(isProjectRoot(cwd), true, `${marker} should make cwd a project`);
@@ -613,87 +552,11 @@ test('isProjectRoot detects each marker', () => {
   }
 });
 
-test('adopt auto-creates memory dir when cwd has a project marker', () => {
-  const home = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-adopt-home-'));
-  const cwd = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-adopt-cwd-'));
-  try {
-    // Add a project marker so adopt is allowed to create the memory dir.
-    fs.writeFileSync(path.join(cwd, 'package.json'), '{}');
-    // The memory dir does NOT exist yet — pre-fix behavior errored 'no-memory-dir'.
-    const dir = memoryDir(cwd, home);
-    assert.strictEqual(fs.existsSync(dir), false);
-
-    const res = adopt({ cwd, home });
-    assert.strictEqual(res.ok, true, `expected ok, got ${JSON.stringify(res)}`);
-    assert.strictEqual(fs.existsSync(dir), true, 'memory dir auto-created');
-    assert.strictEqual(fs.existsSync(path.join(dir, TARGET_NAME)), true, 'plugin file written');
-  } finally {
-    fs.rmSync(home, { recursive: true, force: true });
-    fs.rmSync(cwd, { recursive: true, force: true });
-  }
-});
-
-// ─── D fix: slug collision marker ────────────────────────────────────────
-
-test('adopt writes adopted-by marker as first line of plugin file', () => {
-  const sb = makeSandbox();
-  try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    const target = path.join(sb.dir, TARGET_NAME);
-    const firstLine = fs.readFileSync(target, 'utf8').split('\n', 1)[0];
-    assert.match(firstLine, /^<!-- adopted-by: .* -->$/, `expected adopted-by marker, got: ${firstLine}`);
-    assert.ok(firstLine.includes(sb.cwd), `marker should embed absolute cwd: ${firstLine}`);
-  } finally { sb.cleanup(); }
-});
-
-test('adopt detects slug collision when same memory dir is re-adopted from a different cwd', () => {
-  // Simulate two real cwds whose paths slugify to the same string. Here we
-  // skip real path encoding and just write a file pretending it came from a
-  // different cwd, then re-adopt — collision detection reads the prior marker.
-  const sb = makeSandbox();
-  try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    const target = path.join(sb.dir, TARGET_NAME);
-    // Tamper: rewrite the marker to look like a different cwd adopted first.
-    const body = fs.readFileSync(target, 'utf8').split('\n').slice(1).join('\n');
-    fs.writeFileSync(target, '<!-- adopted-by: /imaginary/other-project -->\n' + body);
-
-    const res = adopt({ cwd: sb.cwd, home: sb.home });
-    assert.strictEqual(res.ok, true);
-    assert.strictEqual(res.collisionWith, '/imaginary/other-project',
-      `expected collisionWith to surface prior cwd, got ${res.collisionWith}`);
-  } finally { sb.cleanup(); }
-});
-
-test('adopt collisionWith is null when re-adopting from same cwd (idempotent)', () => {
-  const sb = makeSandbox();
-  try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    const res = adopt({ cwd: sb.cwd, home: sb.home });
-    assert.strictEqual(res.ok, true);
-    assert.strictEqual(res.collisionWith, null);
-  } finally { sb.cleanup(); }
-});
-
-test('needsRefresh ignores the adopted-by marker when bytewise comparing', () => {
-  // Critical: the marker we add to target makes target ≠ template byte-for-byte.
-  // needsRefresh must skip the leading marker line before compare; otherwise
-  // every SessionStart would re-write the file and burn IO on a no-op.
-  const sb = makeSandbox();
-  try {
-    adopt({ cwd: sb.cwd, home: sb.home });
-    assert.strictEqual(needsRefresh({ cwd: sb.cwd, home: sb.home }), false,
-      'needsRefresh should be false right after adopt — marker must not trigger drift');
-  } finally { sb.cleanup(); }
-});
-
-// memdir L1 升格 — project-typed INDEX_LINE coverage.
+// ── detectProjectType (unchanged logic; tailoring still feeds buildBlock) ────
 
 test('detectProjectType returns generic for an empty cwd', () => {
   const sb = makeSandbox();
-  try {
-    assert.strictEqual(detectProjectType(sb.cwd), 'generic');
-  } finally { sb.cleanup(); }
+  try { assert.strictEqual(detectProjectType(sb.cwd), 'generic'); } finally { sb.cleanup(); }
 });
 
 test('detectProjectType returns rust for a Cargo.toml without web framework', () => {
@@ -704,7 +567,7 @@ test('detectProjectType returns rust for a Cargo.toml without web framework', ()
   } finally { sb.cleanup(); }
 });
 
-test('detectProjectType returns web-rs when Cargo.toml has axum/actix/etc', () => {
+test('detectProjectType returns web-rs when Cargo.toml has axum', () => {
   const sb = makeSandbox();
   try {
     fs.writeFileSync(path.join(sb.cwd, 'Cargo.toml'), '[dependencies]\naxum = "0.7"\n');
@@ -712,20 +575,18 @@ test('detectProjectType returns web-rs when Cargo.toml has axum/actix/etc', () =
   } finally { sb.cleanup(); }
 });
 
-test('detectProjectType returns frontend for package.json with React/Next/Vue', () => {
+test('detectProjectType returns frontend for React/Next deps', () => {
   const sb = makeSandbox();
   try {
-    fs.writeFileSync(path.join(sb.cwd, 'package.json'),
-      '{"dependencies":{"next":"^14","react":"^18"}}');
+    fs.writeFileSync(path.join(sb.cwd, 'package.json'), '{"dependencies":{"next":"^14","react":"^18"}}');
     assert.strictEqual(detectProjectType(sb.cwd), 'frontend');
   } finally { sb.cleanup(); }
 });
 
-test('detectProjectType returns web-node for package.json with express/fastify', () => {
+test('detectProjectType returns web-node for express', () => {
   const sb = makeSandbox();
   try {
-    fs.writeFileSync(path.join(sb.cwd, 'package.json'),
-      '{"dependencies":{"express":"^4"}}');
+    fs.writeFileSync(path.join(sb.cwd, 'package.json'), '{"dependencies":{"express":"^4"}}');
     assert.strictEqual(detectProjectType(sb.cwd), 'web-node');
   } finally { sb.cleanup(); }
 });
@@ -733,146 +594,35 @@ test('detectProjectType returns web-node for package.json with express/fastify',
 test('detectProjectType returns web-py for FastAPI in pyproject.toml', () => {
   const sb = makeSandbox();
   try {
-    fs.writeFileSync(path.join(sb.cwd, 'pyproject.toml'),
-      '[tool.poetry.dependencies]\nfastapi = "^0.115"\n');
+    fs.writeFileSync(path.join(sb.cwd, 'pyproject.toml'), '[tool.poetry.dependencies]\nfastapi = "^0.115"\n');
     assert.strictEqual(detectProjectType(sb.cwd), 'web-py');
   } finally { sb.cleanup(); }
 });
 
-test('buildIndexLine generic returns the canonical INDEX_LINE byte-for-byte', () => {
-  // Critical: keeps backward compatibility with adopted projects that have no
-  // markers. Any drift here invalidates needsRefresh's idempotency assumption.
-  assert.strictEqual(buildIndexLine('generic'), INDEX_LINE);
-  assert.strictEqual(buildIndexLine(undefined), INDEX_LINE);
-});
-
-test('buildIndexLine web-rs prepends route/trace tags + handler-focused lead', () => {
-  const line = buildIndexLine('web-rs');
-  assert.match(line, /\[trace-http-chain, http-route,/, 'web-rs index line should lead with trace-http-chain/http-route tags');
-  assert.match(line, /HTTP 路由/, 'lead sentence should mention HTTP routes');
-});
-
-test('buildIndexLine frontend emphasizes refs/overview, drops HTTP route priming', () => {
-  const line = buildIndexLine('frontend');
-  assert.match(line, /组件重命名|find_references/, 'frontend should mention rename audit / refs');
-  assert.match(line, /HTTP route 通常不适用/, 'frontend should explicitly demote HTTP route tracing');
-});
-
-test('adopt + needsRefresh agree on typed INDEX_LINE — no spurious refresh in a Rust project', () => {
-  // The detection function is deterministic + adopt and needsRefresh both call
-  // it; together they must produce a consistent indexLine, otherwise every
-  // SessionStart triggers a rewrite.
-  const sb = makeSandbox();
-  try {
-    fs.writeFileSync(path.join(sb.cwd, 'Cargo.toml'), '[package]\nname="x"\n');
-    adopt({ cwd: sb.cwd, home: sb.home });
-    assert.strictEqual(needsRefresh({ cwd: sb.cwd, home: sb.home }), false,
-      'needsRefresh must be false right after adopt for a Rust project');
-    const indexPath = path.join(sb.dir, 'MEMORY.md');
-    const index = fs.readFileSync(indexPath, 'utf8');
-    assert.ok(index.includes('优先于 Grep'),
-      'MEMORY.md should contain the rust-typed index line');
-  } finally { sb.cleanup(); }
-});
-
-test('stale INDEX_LINE → adopt rewrites in place without duplicating sentinel blocks', () => {
-  // Regression for the v0.24+ tag-rename fix (feedback_adoption_tag_specificity).
-  // If a user's MEMORY.md was written by an older code-graph-mcp (pre-rename),
-  // SessionStart → maybeAutoAdopt → needsRefresh must detect the drift,
-  // stripSentinelBlock must locate the old v1 block by sentinel marker, and
-  // the rewrite must end with exactly one BEGIN/END pair. Breaks if anyone
-  // bumps SENTINEL_BEGIN without teaching stripSentinelBlock to also match
-  // the prior version — would leave an orphan v1 block plus a new v2 block.
-  const sb = makeSandbox();
-  try {
-    fs.writeFileSync(path.join(sb.cwd, 'Cargo.toml'), '[package]\nname="x"\n');
-    // Plant pre-rename MEMORY.md: well-formed v1 sentinel + an obsolete tag
-    // line that no current buildIndexLine variant produces. Exact prior bytes
-    // don't matter — only that it differs from today's desiredBlock.
-    const stalePayload =
-      '- [code-graph-mcp](plugin_code_graph_mcp.md) [obsolete-tag, another-stale] — stale lead sentence kept for drift detection.';
-    const indexPath = path.join(sb.dir, 'MEMORY.md');
-    const neighbor = '- [user_profile.md](user_profile.md) — neighbor (must survive)';
-    fs.writeFileSync(
-      indexPath,
-      `# Memory Index\n\n${neighbor}\n\n${SENTINEL_BEGIN}\n${stalePayload}\n${SENTINEL_END}\n`
-    );
-    // Plant target file so isAdopted/needsRefresh treat this as a real prior
-    // adoption (body bytewise-identical to shipped template — drift is only
-    // in MEMORY.md, not the template body).
-    const tplBody = fs.readFileSync(TEMPLATE_PATH);
-    const marker = Buffer.from(`<!-- adopted-by: ${sb.cwd} -->\n`);
-    fs.writeFileSync(path.join(sb.dir, TARGET_NAME), Buffer.concat([marker, tplBody]));
-
-    assert.strictEqual(isAdopted({ cwd: sb.cwd, home: sb.home }), true,
-      'precondition: planted state should look adopted');
-    assert.strictEqual(needsRefresh({ cwd: sb.cwd, home: sb.home }), true,
-      'tag-list drift must trigger refresh');
-
-    adopt({ cwd: sb.cwd, home: sb.home });
-
-    const after = fs.readFileSync(indexPath, 'utf8');
-    const escBegin = SENTINEL_BEGIN.replace(/[-/\\^$*+?.()|[\]{}]/g, '\\$&');
-    const escEnd = SENTINEL_END.replace(/[-/\\^$*+?.()|[\]{}]/g, '\\$&');
-    const beginHits = (after.match(new RegExp(escBegin, 'g')) || []).length;
-    const endHits = (after.match(new RegExp(escEnd, 'g')) || []).length;
-    assert.strictEqual(beginHits, 1, 'exactly one sentinel BEGIN after rewrite (no duplicate blocks)');
-    assert.strictEqual(endHits, 1, 'exactly one sentinel END after rewrite');
-    assert.ok(!after.includes('obsolete-tag'), 'stale tag list must be gone');
-    assert.ok(!after.includes('another-stale'), 'stale tag list must be gone');
-    assert.ok(after.includes(neighbor), 'neighbor entry preserved');
-    assert.strictEqual(needsRefresh({ cwd: sb.cwd, home: sb.home }), false,
-      'post-refresh needsRefresh must be false (no SessionStart refresh loop)');
-  } finally { sb.cleanup(); }
-});
-
-// 2A — false-positive hardening: comment-strip + section-aware scan.
-
 test('detectProjectType ignores commented-out web-framework deps in Cargo.toml', () => {
-  // Pre-fix: `# axum = "0.7"` substring-matched and falsely promoted to web-rs.
-  // Post-fix: comment stripping happens before section scan.
   const sb = makeSandbox();
   try {
     fs.writeFileSync(path.join(sb.cwd, 'Cargo.toml'),
-      '[package]\nname="x"\n[dependencies]\n# axum = "0.7"  # disabled, was for prototype\nserde = "1"\n');
-    assert.strictEqual(detectProjectType(sb.cwd), 'rust',
-      'commented dep must not promote to web-rs');
+      '[package]\nname="x"\n[dependencies]\n# axum = "0.7"  # disabled\nserde = "1"\n');
+    assert.strictEqual(detectProjectType(sb.cwd), 'rust');
   } finally { sb.cleanup(); }
 });
 
 test('detectProjectType ignores axum in [dev-dependencies] only', () => {
-  // axum used solely for tests does not make this a web project.
   const sb = makeSandbox();
   try {
     fs.writeFileSync(path.join(sb.cwd, 'Cargo.toml'),
       '[package]\nname="x"\n[dependencies]\nserde = "1"\n[dev-dependencies]\naxum = "0.7"\n');
-    assert.strictEqual(detectProjectType(sb.cwd), 'rust',
-      'axum in dev-dependencies must not promote to web-rs');
-  } finally { sb.cleanup(); }
-});
-
-test('detectProjectType ignores axum in [build-dependencies] only', () => {
-  const sb = makeSandbox();
-  try {
-    fs.writeFileSync(path.join(sb.cwd, 'Cargo.toml'),
-      '[package]\nname="x"\n[dependencies]\nserde = "1"\n[build-dependencies]\naxum = "0.7"\n');
-    assert.strictEqual(detectProjectType(sb.cwd), 'rust',
-      'axum in build-dependencies must not promote to web-rs');
+    assert.strictEqual(detectProjectType(sb.cwd), 'rust');
   } finally { sb.cleanup(); }
 });
 
-test('detectProjectType ignores react in devDependencies of package.json', () => {
-  // A library that lists react in devDependencies for testing should not
-  // be classified as a frontend app.
+test('detectProjectType ignores react in devDependencies', () => {
   const sb = makeSandbox();
   try {
     fs.writeFileSync(path.join(sb.cwd, 'package.json'),
-      JSON.stringify({
-        dependencies: { lodash: '^4' },
-        devDependencies: { react: '^18', 'react-dom': '^18' },
-      }));
-    assert.strictEqual(detectProjectType(sb.cwd), 'node',
-      'react in devDependencies must not promote to frontend');
+      JSON.stringify({ dependencies: { lodash: '^4' }, devDependencies: { react: '^18' } }));
+    assert.strictEqual(detectProjectType(sb.cwd), 'node');
   } finally { sb.cleanup(); }
 });
 
@@ -881,25 +631,19 @@ test('detectProjectType ignores // indirect deps in go.mod', () => {
   try {
     fs.writeFileSync(path.join(sb.cwd, 'go.mod'),
       'module example.com/x\n\nrequire (\n\tgithub.com/some/cli v1.0.0\n\tgithub.com/gin-gonic/gin v1.9.0 // indirect\n)\n');
-    assert.strictEqual(detectProjectType(sb.cwd), 'go',
-      'indirect gin must not promote to web-go');
+    assert.strictEqual(detectProjectType(sb.cwd), 'go');
   } finally { sb.cleanup(); }
 });
 
 test('detectProjectType handles malformed package.json without throwing', () => {
-  // JSON.parse failure must not crash detection; falls back to 'node' since
-  // package.json exists but is unreadable.
   const sb = makeSandbox();
   try {
     fs.writeFileSync(path.join(sb.cwd, 'package.json'), '{not valid json');
-    assert.strictEqual(detectProjectType(sb.cwd), 'node',
-      'malformed package.json should fall back to node bucket');
+    assert.strictEqual(detectProjectType(sb.cwd), 'node');
   } finally { sb.cleanup(); }
 });
 
 test('detectProjectType detects PEP 621 [project] dependencies block', () => {
-  // PEP 621 puts `dependencies = [...]` inside [project], not a separate
-  // [project.dependencies] section — our state machine accepts both.
   const sb = makeSandbox();
   try {
     fs.writeFileSync(path.join(sb.cwd, 'pyproject.toml'),
@@ -911,60 +655,23 @@ test('detectProjectType detects PEP 621 [project] dependencies block', () => {
 test('detectProjectType reads requirements.txt as fallback', () => {
   const sb = makeSandbox();
   try {
-    fs.writeFileSync(path.join(sb.cwd, 'requirements.txt'),
-      '# web stack\nflask>=3.0\ngunicorn\n');
+    fs.writeFileSync(path.join(sb.cwd, 'requirements.txt'), '# web stack\nflask>=3.0\ngunicorn\n');
     assert.strictEqual(detectProjectType(sb.cwd), 'web-py');
   } finally { sb.cleanup(); }
 });
 
-// 2D — env override.
-
 test('CODE_GRAPH_PROJECT_TYPE env override beats file-based detection', () => {
   const sb = makeSandbox();
   try {
-    // Cargo.toml says rust — env says web-rs. Env wins.
     fs.writeFileSync(path.join(sb.cwd, 'Cargo.toml'), '[package]\nname="x"\n');
-    assert.strictEqual(
-      detectProjectType(sb.cwd, { CODE_GRAPH_PROJECT_TYPE: 'web-rs' }),
-      'web-rs',
-    );
+    assert.strictEqual(detectProjectType(sb.cwd, { CODE_GRAPH_PROJECT_TYPE: 'web-rs' }), 'web-rs');
   } finally { sb.cleanup(); }
 });
 
 test('CODE_GRAPH_PROJECT_TYPE env override falls through on invalid value', () => {
-  // Typo'd / unknown bucket name should not silently classify everything as
-  // 'generic' — fall through to file-based detection so the project still
-  // gets a meaningful index line.
-  const sb = makeSandbox();
-  try {
-    fs.writeFileSync(path.join(sb.cwd, 'Cargo.toml'), '[package]\nname="x"\n');
-    assert.strictEqual(
-      detectProjectType(sb.cwd, { CODE_GRAPH_PROJECT_TYPE: 'web-rust' /* typo */ }),
-      'rust',
-      'invalid override must fall through to file detection',
-    );
-  } finally { sb.cleanup(); }
-});
-
-test('CODE_GRAPH_PROJECT_TYPE env override unset uses file detection', () => {
-  // Empty env reaches file-based detection unchanged.
   const sb = makeSandbox();
   try {
     fs.writeFileSync(path.join(sb.cwd, 'Cargo.toml'), '[package]\nname="x"\n');
-    assert.strictEqual(detectProjectType(sb.cwd, {}), 'rust');
-  } finally { sb.cleanup(); }
-});
-
-test('CODE_GRAPH_PROJECT_TYPE env override forces generic in a Rust project', () => {
-  // Power-user case: explicit opt-out of typed routing for a project that
-  // would otherwise be auto-classified.
-  const sb = makeSandbox();
-  try {
-    fs.writeFileSync(path.join(sb.cwd, 'Cargo.toml'),
-      '[package]\nname="x"\n[dependencies]\naxum = "0.7"\n');
-    assert.strictEqual(
-      detectProjectType(sb.cwd, { CODE_GRAPH_PROJECT_TYPE: 'generic' }),
-      'generic',
-    );
+    assert.strictEqual(detectProjectType(sb.cwd, { CODE_GRAPH_PROJECT_TYPE: 'web-rust' }), 'rust');
   } finally { sb.cleanup(); }
 });