@sdsrs/code-graph 0.71.0 → 0.72.0

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

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

package/claude-plugin/scripts/covering-tests.js

@@ -0,0 +1,67 @@
+'use strict';
+// Pure formatter for edit-time covering-test targeting.
+//
+// pre-edit-guide.js feeds this the `test_callers` from `impact --json` (the tests
+// that exercise the symbol being edited) plus the edited file's path. It returns a
+// summary fragment that turns the bare "(N tests)" count into an actionable,
+// language-aware run command — so the fix-test-iterate loop runs the TARGETED
+// covering tests, not the whole suite or a guessed test name.
+//
+// Pure + side-effect-free so it's unit-testable by require() — unlike the hook
+// itself, which top-level-exits on require (reads stdin / checks the index).
+
+// Display cap: list at most this many "name (file)" entries before collapsing to a
+// bare count. Above the cap a long per-name list is noise in the injected context.
+const LIST_CAP = 6;
+
+// Detect the project's test runner from the edited file's extension. v1 emits a
+// REAL targeted command only for Rust (`cargo test` accepts bare substring filters,
+// so the test fn names work directly). Other languages degrade to listing the
+// covering tests with no command — a wrong/guessed command is worse than none
+// (jest vs vitest vs mocha / pytest node ids / `go test -run` all differ).
+function detectRunner(filePath) {
+  if (typeof filePath === 'string' && /\.rs$/.test(filePath)) return 'rust';
+  return null;
+}
+
+function targetedCommand(runner, names) {
+  if (runner === 'rust') return `cargo test ${names.join(' ')}`;
+  return null;
+}
+
+function suiteCommand(runner) {
+  if (runner === 'rust') return 'cargo test';
+  return null;
+}
+
+/**
+ * Build the covering-tests summary fragment.
+ * @param {Array<{name:string,file:string}>} testCallers  from `impact --json` test_callers
+ * @param {string} editedFile  the file being edited (drives runner detection)
+ * @returns {string} a `\n`-terminated fragment, or '' when there's nothing to add
+ */
+function formatCoveringTests(testCallers, editedFile) {
+  const tests = Array.isArray(testCallers) ? testCallers.filter((t) => t && t.name) : [];
+  const n = tests.length;
+  if (n === 0) return '';
+
+  const runner = detectRunner(editedFile);
+
+  if (n <= LIST_CAP) {
+    const list = tests.map((t) => `${t.name} (${t.file})`).join(', ');
+    let out = `  Covering tests (${n}): ${list}\n`;
+    const cmd = targetedCommand(runner, tests.map((t) => t.name));
+    if (cmd) out += `  → Run after editing: ${cmd}\n`;
+    return out;
+  }
+
+  // High fan-out: editing a widely-tested symbol. A long targeted command is noise
+  // — point at the suite instead (mirrors the blast-size scaling in
+  // session-init.js formatRecentImpact).
+  let out = `  Covering tests: ${n} — editing a widely-tested symbol\n`;
+  const suite = suiteCommand(runner);
+  if (suite) out += `  → Run the suite after editing: ${suite}\n`;
+  return out;
+}
+
+module.exports = { formatCoveringTests, LIST_CAP };

package/claude-plugin/scripts/covering-tests.test.js

@@ -0,0 +1,78 @@
+'use strict';
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const { formatCoveringTests, LIST_CAP } = require('./covering-tests');
+
+// ── empty / robust ──────────────────────────────────────
+
+test('covering: empty list → no output', () => {
+  assert.equal(formatCoveringTests([], 'src/a.rs'), '');
+});
+
+test('covering: missing/undefined → no output (never throws)', () => {
+  assert.equal(formatCoveringTests(undefined, 'src/a.rs'), '');
+  assert.equal(formatCoveringTests(null, 'src/a.rs'), '');
+});
+
+test('covering: entries without a name are dropped', () => {
+  const out = formatCoveringTests(
+    [{ name: 'test_real', file: 'tests/a.rs' }, { file: 'tests/nameless.rs' }],
+    'src/a.rs'
+  );
+  assert.match(out, /Covering tests \(1\)/); // only the named one counts
+  assert.match(out, /test_real/);
+});
+
+// ── Rust: a real targeted command ───────────────────────
+
+test('covering: Rust ≤cap lists names + a targeted `cargo test` command', () => {
+  const out = formatCoveringTests(
+    [
+      { name: 'test_alpha', file: 'tests/a.rs' },
+      { name: 'test_beta', file: 'src/b.rs' },
+    ],
+    'src/foo.rs'
+  );
+  assert.match(out, /Covering tests \(2\)/);
+  assert.match(out, /test_alpha \(tests\/a\.rs\)/);
+  assert.match(out, /test_beta \(src\/b\.rs\)/);
+  // The actionable part: a command that runs exactly the covering tests.
+  assert.match(out, /Run after editing: cargo test test_alpha test_beta/);
+});
+
+// ── non-Rust: list only, never a fabricated command ─────
+
+test('covering: non-Rust ≤cap lists names but emits NO command (no wrong command)', () => {
+  const out = formatCoveringTests(
+    [{ name: 'testValidate', file: 'src/auth.test.ts' }],
+    'src/auth.ts'
+  );
+  assert.match(out, /Covering tests \(1\): testValidate \(src\/auth\.test\.ts\)/);
+  assert.doesNotMatch(out, /cargo test/);
+  assert.doesNotMatch(out, /Run after editing/);
+});
+
+// ── high fan-out: collapse, point at the suite ──────────
+
+test('covering: Rust high fan-out (>cap) collapses to a count + suite command, no name list', () => {
+  const many = Array.from({ length: LIST_CAP + 1 }, (_, i) => ({
+    name: `test_${i}`,
+    file: 'tests/wide.rs',
+  }));
+  const out = formatCoveringTests(many, 'src/hot.rs');
+  assert.match(out, new RegExp(`Covering tests: ${LIST_CAP + 1}`));
+  assert.match(out, /widely-tested/);
+  assert.match(out, /Run the suite after editing: cargo test/);
+  // The long per-name list must NOT be inlined when fan-out is high.
+  assert.doesNotMatch(out, /test_0 \(/);
+});
+
+test('covering: non-Rust high fan-out collapses to a count with no command', () => {
+  const many = Array.from({ length: LIST_CAP + 3 }, (_, i) => ({
+    name: `test_${i}`,
+    file: 'a.test.ts',
+  }));
+  const out = formatCoveringTests(many, 'src/hot.ts');
+  assert.match(out, new RegExp(`Covering tests: ${LIST_CAP + 3}`));
+  assert.doesNotMatch(out, /cargo test/);
+});

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

@@ -13,6 +13,7 @@ const { findBinary } = require('./find-binary');
 const { cgTmpDir } = require('./tmp-dir');
 const { resolveProjectRoot } = require('./project-root');
 const { recordRecommendation } = require('./recommendation-log');
+const { formatCoveringTests } = require('./covering-tests');
 
 // v0.49 — walk up from the shell cwd (subdir-cwd fix). The per-cwd index.db
 // gate kept this hook dark for entire sessions after `cd backend/` — daagu
@@ -170,7 +171,13 @@ try { fs.writeFileSync(cooldownFile, ''); } catch { /* ok */ }
 // Funnel visibility (v0.49): an injected impact summary is a delivered answer.
 // v0.63 — ack:true marks that this injection carries a salience-forcing directive
 // (the per-caller verdict line below), so a later A/B can segment ack vs non-ack.
-recordRecommendation(cwd, { hook: 'edit', action: 'hint', answered: true, ack: true });
+// test_targets: how many covering tests this injection offered — the forward
+// signal for whether covering-test targeting reduces test-name guessing (read on
+// consumer projects; this dogfood repo's metrics are dark).
+recordRecommendation(cwd, {
+  hook: 'edit', action: 'hint', answered: true, ack: true,
+  test_targets: (jsonResult.test_callers || []).length,
+});
 
 // --- Inject compact impact summary ---
 const routeCount = jsonResult.affected_routes || 0;
@@ -188,6 +195,12 @@ if (callers.length > 0) {
   summary += '  Callers: ' + callers.map(c => `${c.name} (${c.file})`).join(', ') + '\n';
 }
 
+// Covering tests — turn the bare "(N tests)" count above into an actionable,
+// targeted run command so the fix-test-iterate loop runs exactly the tests that
+// exercise the edited symbol (not the whole suite or a guessed name). Empty/absent
+// test_callers → appends nothing.
+summary += formatCoveringTests(jsonResult.test_callers, editedFile);
+
 // Salience forcing (v0.63) — an injected impact summary that the model merely
 // reads is wasted context. mem's PreToolUse edit hook lifts cite-recall to ~94%
 // by making the model ACT on the injection ("apply each lesson or rule it out")

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

@@ -176,3 +176,24 @@ test('pattern-sync: fnPatterns count matches source', () => {
   assert.ok(fnPatterns.length === 8, `Expected 8 patterns, got ${fnPatterns.length}`);
   assert.ok(sourcePatternCount >= 7, `Source should have >= 7 language comments, found ${sourcePatternCount}`);
 });
+
+// ── Covering-test targeting (edit-time PUSH) ────────────
+// The pure formatter lives in covering-tests.js (unit-tested in covering-tests.test.js);
+// these guard that the hook actually wires it in and records the forward signal.
+// Source-grep, same convention as the salience/pattern-sync guards (hook exits on require).
+
+test('covering-tests: hook requires and invokes the covering-tests formatter on test_callers', () => {
+  const fs = require('node:fs');
+  const path = require('node:path');
+  const source = fs.readFileSync(path.join(__dirname, 'pre-edit-guide.js'), 'utf8');
+  assert.match(source, /require\(['"]\.\/covering-tests['"]\)/);
+  assert.match(source, /formatCoveringTests\(/);
+  assert.match(source, /test_callers/);
+});
+
+test('covering-tests: edit injection records test_targets for the forward funnel', () => {
+  const fs = require('node:fs');
+  const path = require('node:path');
+  const source = fs.readFileSync(path.join(__dirname, 'pre-edit-guide.js'), 'utf8');
+  assert.match(source, /test_targets:/);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdsrs/code-graph",
-  "version": "0.71.0",
+  "version": "0.72.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.71.0",
-    "@sdsrs/code-graph-linux-arm64": "0.71.0",
-    "@sdsrs/code-graph-darwin-x64": "0.71.0",
-    "@sdsrs/code-graph-darwin-arm64": "0.71.0",
-    "@sdsrs/code-graph-win32-x64": "0.71.0"
+    "@sdsrs/code-graph-linux-x64": "0.72.0",
+    "@sdsrs/code-graph-linux-arm64": "0.72.0",
+    "@sdsrs/code-graph-darwin-x64": "0.72.0",
+    "@sdsrs/code-graph-darwin-arm64": "0.72.0",
+    "@sdsrs/code-graph-win32-x64": "0.72.0"
   }
 }