@blamechris/repo-memory 0.12.0 → 0.14.0

package/dist/tools/search-by-purpose.js

@@ -1,7 +1,124 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { hashContents } from '../cache/hash.js';
 import { CacheStore } from '../cache/store.js';
+import { ensureSummaryGeneration, summarizeForProject } from '../indexer/summarize.js';
 import { TelemetryTracker } from '../telemetry/tracker.js';
 import { toPosix } from '../utils/posix-path.js';
-export function searchByPurpose(projectRoot, query, limit, pathPrefix) {
+/** Max exports listed per result; the rest collapse into `exportsTruncated`. */
+const MAX_EXPORTS_PER_RESULT = 5;
+/**
+ * Lowercase word tokens of an identifier or free-text field: splits camelCase
+ * and PascalCase boundaries, snake_case, kebab-case, dots, and path
+ * separators. "CacheStore" -> ["cache","store"]; "get_file_summary" ->
+ * ["get","file","summary"].
+ */
+function tokenize(text) {
+    return text
+        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter(Boolean);
+}
+/** Terms shorter than this only count on a whole-token match. */
+const MIN_SUBSTRING_TERM = 3;
+/**
+ * Match quality of one query term against one field, tiered by specificity:
+ * whole token (1.0) > token prefix (0.75) > bare substring (0.5). Short terms
+ * must match a whole token — "id" landing inside "validation" is noise, but
+ * "id" as an identifier word (findUserById) is a real hit.
+ */
+function termQuality(term, tokens, raw) {
+    if (tokens.includes(term))
+        return 1;
+    if (term.length < MIN_SUBSTRING_TERM)
+        return 0;
+    if (tokens.some((t) => t.startsWith(term)))
+        return 0.75;
+    if (raw.includes(term))
+        return 0.5;
+    return 0;
+}
+/**
+ * Score a cached entry against the query terms; null when nothing matched.
+ * Field weights: purpose 3 > exports 2 > declarations 1 = path 1. Each term
+ * contributes its match quality x the field weight, so a whole-word purpose
+ * hit outranks any pile of incidental substrings. Path segments count as a
+ * field of their own (sans extension) so directory and file names carry the
+ * concept signal they naturally encode — src/telemetry/tracker.ts should
+ * match "telemetry" even when its summary text doesn't say the word.
+ */
+function scoreEntry(path, summary, queryTerms) {
+    const fields = [
+        {
+            name: 'purpose',
+            weight: 3,
+            tokens: tokenize(summary.purpose),
+            raw: summary.purpose.toLowerCase(),
+        },
+        {
+            name: 'exports',
+            weight: 2,
+            tokens: summary.exports.flatMap(tokenize),
+            raw: summary.exports.join(' ').toLowerCase(),
+        },
+        {
+            name: 'declarations',
+            weight: 1,
+            tokens: summary.topLevelDeclarations.flatMap(tokenize),
+            raw: summary.topLevelDeclarations.join(' ').toLowerCase(),
+        },
+        {
+            name: 'path',
+            weight: 1,
+            tokens: tokenize(path.replace(/\.[a-z0-9]+$/i, '')),
+            raw: path.toLowerCase(),
+        },
+    ];
+    const matchedOn = [];
+    let score = 0;
+    for (const field of fields) {
+        let fieldScore = 0;
+        for (const term of queryTerms) {
+            fieldScore += termQuality(term, field.tokens, field.raw) * field.weight;
+        }
+        if (fieldScore > 0) {
+            matchedOn.push(field.name);
+            score += fieldScore;
+        }
+    }
+    return matchedOn.length > 0 ? { matchedOn, score } : null;
+}
+/**
+ * Re-hash a matched candidate before serving it (never return stale data).
+ * - Missing/unreadable file: evict the dead cache entry and drop the result.
+ * - Hash mismatch: regenerate the summary through the standard path (same
+ *   semantics as get_file_summary's cache-miss branch), re-score it against
+ *   the query, and keep it only if it still matches.
+ */
+async function validateCandidate(projectRoot, store, candidate, queryTerms) {
+    let contents;
+    try {
+        contents = await readFile(join(projectRoot, candidate.entry.path), 'utf-8');
+    }
+    catch {
+        store.deleteEntry(candidate.entry.path);
+        return null;
+    }
+    const currentHash = hashContents(contents);
+    if (currentHash === candidate.entry.hash)
+        return candidate;
+    const summary = await summarizeForProject(projectRoot, candidate.entry.path, contents);
+    store.setEntry(candidate.entry.path, currentHash, summary);
+    const match = scoreEntry(candidate.entry.path, summary, queryTerms);
+    if (!match)
+        return null;
+    return { entry: candidate.entry, summary, matchedOn: match.matchedOn, score: match.score };
+}
+export async function searchByPurpose(projectRoot, query, limit, pathPrefix) {
+    // Never serve summaries from an invalidated generation (audit invariant I5).
+    ensureSummaryGeneration(projectRoot);
     const store = new CacheStore(projectRoot);
     const effectiveLimit = limit ?? 20;
     // Optional scope: restrict the search to files at or under a directory/prefix.
@@ -23,57 +140,58 @@ export function searchByPurpose(projectRoot, query, limit, pathPrefix) {
         })
         : allEntries;
     const queryTerms = query.toLowerCase().split(/\s+/).filter(Boolean);
-    const results = [];
+    const candidates = [];
     for (const entry of entries) {
         if (!entry.summary)
             continue;
-        const matchedOn = [];
-        let score = 0;
-        const purpose = entry.summary.purpose.toLowerCase();
-        const purposeMatches = queryTerms.filter(term => purpose.includes(term));
-        if (purposeMatches.length > 0) {
-            matchedOn.push('purpose');
-            score += purposeMatches.length * 3; // purpose matches weighted highest
-        }
-        const exportsLower = entry.summary.exports.map(e => e.toLowerCase());
-        const exportMatches = queryTerms.filter(term => exportsLower.some(exp => exp.includes(term)));
-        if (exportMatches.length > 0) {
-            matchedOn.push('exports');
-            score += exportMatches.length * 2;
-        }
-        const declsLower = entry.summary.topLevelDeclarations.map(d => d.toLowerCase());
-        const declMatches = queryTerms.filter(term => declsLower.some(decl => decl.includes(term)));
-        if (declMatches.length > 0) {
-            matchedOn.push('declarations');
-            score += declMatches.length;
-        }
-        if (matchedOn.length > 0) {
-            results.push({
-                path: entry.path,
-                purpose: entry.summary.purpose,
-                matchedOn,
-                exports: entry.summary.exports,
-                confidence: entry.summary.confidence,
-                score,
-            });
+        const match = scoreEntry(entry.path, entry.summary, queryTerms);
+        if (match) {
+            candidates.push({ entry, summary: entry.summary, ...match });
         }
     }
     // Sort by score descending
-    results.sort((a, b) => b.score - a.score);
-    const matched = results.slice(0, effectiveLimit);
-    // Track each matched file as a summary_served event.
-    // Token estimate: approximate raw file tokens from lineCount (avg ~40 chars/line).
-    const tracker = new TelemetryTracker(projectRoot);
-    for (const result of matched) {
-        const entry = entries.find(e => e.path === result.path);
-        // Approximate raw file tokens from lineCount (avg ~40 chars/line, ~4 chars/token)
-        const estimatedRawTokens = entry?.summary ? entry.summary.lineCount * 10 : 0;
-        tracker.trackEvent('summary_served', result.path, estimatedRawTokens);
+    candidates.sort((a, b) => b.score - a.score);
+    // Validate before serving: walk the sorted candidates in score order until
+    // `limit` survive, so slots freed by dropped (deleted or no-longer-matching)
+    // files are backfilled from the remaining candidates in one pass.
+    const served = [];
+    for (const candidate of candidates) {
+        if (served.length >= effectiveLimit)
+            break;
+        const validated = await validateCandidate(projectRoot, store, candidate, queryTerms);
+        if (validated)
+            served.push(validated);
+    }
+    // Telemetry: ONE summary_served event per query, not per hit. Per-hit
+    // tracking booked every matched file as a full read avoided, inflating
+    // "tokens saved" by up to `limit`x. The realistic counterfactual for one
+    // search is the agent grepping and then reading roughly ONE candidate file
+    // in full, so we book the estimated raw-content tokens of one average
+    // served file (lineCount x ~40 chars/line / ~4 chars/token = lineCount x 10).
+    // Best-effort: a telemetry write failure (e.g. locked DB) must never fail
+    // the read path.
+    if (served.length > 0) {
+        try {
+            const avgLineCount = served.reduce((sum, c) => sum + c.summary.lineCount, 0) / served.length;
+            new TelemetryTracker(projectRoot).trackEvent('summary_served', served[0].entry.path, Math.round(avgLineCount * 10), { query, resultCount: served.length });
+        }
+        catch {
+            // Telemetry is best-effort on read paths (audit invariant I8).
+        }
     }
     return {
-        query,
-        results: matched.map(({ score: _score, ...rest }) => rest),
-        totalCached: entries.filter(e => e.summary).length,
+        results: served.map((c) => {
+            const exports = c.summary.exports;
+            const capped = exports.length > MAX_EXPORTS_PER_RESULT;
+            return {
+                path: c.entry.path,
+                purpose: c.summary.purpose,
+                exports: capped ? exports.slice(0, MAX_EXPORTS_PER_RESULT) : exports,
+                ...(capped ? { exportsTruncated: exports.length } : {}),
+                confidence: c.summary.confidence,
+            };
+        }),
+        totalCached: entries.filter((e) => e.summary).length,
         ...(normalizedPrefix ? { scope: normalizedPrefix } : {}),
     };
 }

package/dist/tools/search-by-purpose.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-by-purpose.js","sourceRoot":"","sources":["../../src/tools/search-by-purpose.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"search-by-purpose.js","sourceRoot":"","sources":["../../src/tools/search-by-purpose.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -17,5 +17,11 @@ export interface ImportRef {
     target: string;
     specifiers: string[];
     type: 'static' | 'dynamic' | 're-export';
+    /**
+     * True when the target does not resolve to a file inside the project
+     * (bare module specifiers, builtins, unresolvable relative paths).
+     * External refs are excluded from the dependency graph.
+     */
+    external?: boolean;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;CAC1C"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blamechris/repo-memory",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "MCP server that gives AI coding agents persistent memory about your codebase",
   "type": "module",
   "main": "dist/server.js",