@sdsrs/code-graph 0.63.0 → 0.66.0

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

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

package/claude-plugin/scripts/pre-grep-guide.js

@@ -484,6 +484,13 @@ function runMain() {
   if (relPrefix) cmd = rebaseRelativePaths(cmd, relPrefix, root);
   if (!shouldHint(cmd)) return;
 
+  // v0.64 — fingerprint the grep's pattern once, shared by the emit points below.
+  // The funnel (aggregate_recommendations_jsonl) uses it to tell a verbatim re-grep
+  // of an answered deny (inline answer ignored → fall-through) from a deeper
+  // drill-down. undefined when there's no identifier-like pattern (unquoted / prose
+  // grep) → omitted from the event, so the funnel stays back-compatible.
+  const grepPattern = translateBreToRg(cmd, pickBlockPattern(cmd));
+
   // v0.48 — deliberate escape: record it (funnel visibility) and stay silent.
   // Before GREP_HEAD accepted bare KEY=VALUE prefixes these were invisible.
   if (commandHasBypass(rawCmd)) {
@@ -495,7 +502,7 @@ function runMain() {
     // Outcome proxy: a source grep re-issued within the cooldown window runs
     // silently (no deny/hint). Record it so `stats` sees the model's grep
     // fan-out — especially a re-grep right after cg answered the same query.
-    recordRecommendation(root, { hook: 'grep', action: 'observe' });
+    recordRecommendation(root, { hook: 'grep', action: 'observe', ...(grepPattern ? { pattern: grepPattern } : {}) });
     return;
   }
 
@@ -510,7 +517,7 @@ function runMain() {
     // v0.49 — intent-aware: declaration+context greps get `show` bodies,
     // falling back to the grep answer, then the static deny.
     let answer = { status: 'unavailable' };
-    const pattern = translateBreToRg(cmd, pickBlockPattern(cmd));
+    const pattern = grepPattern; // computed once above; reused for the answer + deny fingerprint
     // v0.48 — glob-truncated once, shared by the run and the deny message
     // (a literal `dir/*.py` argv made rg exit 1 → answered:false static deny).
     const searchPath = sanitizeSearchPath(extractSearchPath(cmd));
@@ -544,6 +551,9 @@ function runMain() {
     const unansweredTail = extractUnansweredTail(rawCmd);
     recordRecommendation(root, {
       hook: 'grep', action: 'deny', answered,
+      // pattern fingerprints the denied search so the funnel can score a verbatim
+      // re-grep of it (the inline answer was ignored) as fall-through, not a win.
+      ...(pattern ? { pattern } : {}),
       // mode segments which answer type converts (show=bodies, grep=hits).
       ...(answered ? { mode: answeredMode } : {}),
       // reason segments WHY an unanswered deny fell back to the static copy:

package/claude-plugin/scripts/pre-grep-guide.test.js

@@ -909,6 +909,45 @@ test('e2e: denied grep with stub hits → deny JSON embeds the answer + records
   }
 });
 
+test('e2e: denied grep records the denied pattern (fingerprint for verbatim re-grep detection)', () => {
+  // The Rust funnel (aggregate_recommendations_jsonl) scores a follow-up search
+  // carrying the SAME pattern as the armed answered deny as fall-through, not a
+  // sustained drill-down. That needs the pattern on the deny event.
+  const uniq = `StubPat${Date.now()}`;
+  const fixture = e2eFixture(`process.stdout.write('src/foo.rs:7  hit\\n');`);
+  const cmd = `grep -rn "${uniq}" src/`;
+  try {
+    const res = runHook(cmd, fixture);
+    assert.equal(res.status, 0);
+    const rec = JSON.parse(fsE2e.readFileSync(
+      pathE2e.join(fixture.dir, '.code-graph', 'recommendations.jsonl'), 'utf8').trim().split('\n').pop());
+    assert.equal(rec.action, 'deny');
+    assert.equal(rec.pattern, uniq, 'deny event carries the denied pattern as a fingerprint');
+  } finally {
+    cleanupFixture(fixture, cmd);
+  }
+});
+
+test('e2e: re-grep within cooldown → observe carries the same pattern (answer-ignored fingerprint)', () => {
+  // First grep denies + marks the cooldown; the verbatim re-grep within the
+  // window runs silently as an observe. It must carry the same pattern so the
+  // funnel can tell "ignored the inline answer" from "drilled into something new".
+  const uniq = `StubCool${Date.now()}`;
+  const fixture = e2eFixture(`process.stdout.write('src/foo.rs:7  hit\\n');`);
+  const cmd = `grep -rn "${uniq}" src/`;
+  try {
+    runHook(cmd, fixture);              // 1st → deny + markCooldown
+    const res2 = runHook(cmd, fixture); // 2nd within window → observe
+    assert.equal(res2.status, 0);
+    const last = JSON.parse(fsE2e.readFileSync(
+      pathE2e.join(fixture.dir, '.code-graph', 'recommendations.jsonl'), 'utf8').trim().split('\n').pop());
+    assert.equal(last.action, 'observe');
+    assert.equal(last.pattern, uniq, 'cooldown observe carries the re-grepped pattern');
+  } finally {
+    cleanupFixture(fixture, cmd);
+  }
+});
+
 test('e2e: stub reports no matches → grep allowed with FYI + records fallthrough', () => {
   const uniq = `StubMiss${Date.now()}`;
   const fixture = e2eFixture(

package/claude-plugin/scripts/recommendation-log.js

@@ -17,6 +17,9 @@ const fs = require('fs');
 const path = require('path');
 
 const REC_FILE = 'recommendations.jsonl';
+// Opt-in per-project metrics-silence sentinel (under .code-graph/). Mirror of the
+// Rust `domain::NO_METRICS_SENTINEL` — keep the literal in sync.
+const NO_METRICS_FILE = '.no-metrics';
 
 // Bounded growth: recommendations.jsonl is append-only and written per-event
 // from BOTH here and the Rust CLI (cli::record_cli_use). Keep these constants in
@@ -57,6 +60,11 @@ function recordRecommendation(cwd, event = {}) {
     // Append-only: do NOT create .code-graph. Its absence means "not an indexed
     // project" — recording there would pollute non-project cwds.
     if (!fs.existsSync(dir)) return false;
+    // Opt-in metrics silence for dev/dogfood checkouts: when the project marks
+    // itself with `.code-graph/.no-metrics`, the tool's own hook/CLI runs (sims,
+    // functionality testing) must not self-pollute its adoption metrics. Mirrors
+    // the Rust cli::record_cli_use guard. Reversible: delete the file to re-enable.
+    if (fs.existsSync(path.join(dir, NO_METRICS_FILE))) return false;
     const file = path.join(dir, REC_FILE);
     rotateIfNeeded(file); // rotate-before-append so the file never exceeds ~max + one line
     const line = JSON.stringify({ ts: new Date().toISOString(), ...event }) + '\n';

package/claude-plugin/scripts/recommendation-log.test.js

@@ -32,6 +32,19 @@ test('recordRecommendation is a no-op (no dir created) when .code-graph absent',
   assert.equal(fs.existsSync(path.join(cwd, '.code-graph')), false);
 });
 
+test('recordRecommendation is a no-op when .code-graph/.no-metrics sentinel present', (t) => {
+  const cwd = tmpProject(t, true);
+  // Without the sentinel it records normally...
+  assert.equal(recordRecommendation(cwd, { hook: 'grep', action: 'deny' }), true);
+  const before = fs.readFileSync(path.join(cwd, '.code-graph', REC_FILE), 'utf8');
+  // ...then the project marks itself metrics-silent (a dev/dogfood checkout)...
+  fs.writeFileSync(path.join(cwd, '.code-graph', '.no-metrics'), '');
+  // ...and subsequent recordings are suppressed, leaving the file byte-unchanged.
+  assert.equal(recordRecommendation(cwd, { hook: 'grep', action: 'hint' }), false);
+  const after = fs.readFileSync(path.join(cwd, '.code-graph', REC_FILE), 'utf8');
+  assert.equal(after, before, 'sentinel must suppress further recordings');
+});
+
 test('recordRecommendation appends across calls (one line each)', (t) => {
   const cwd = tmpProject(t, true);
   recordRecommendation(cwd, { hook: 'grep', action: 'hint' });

package/package.json

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