@blamechris/repo-memory 0.1.0 → 0.3.0

package/dist/tools/get-related-files.js

@@ -0,0 +1,142 @@
+import { readFile } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { DependencyGraph } from '../graph/dependency-graph.js';
+import { scanProject } from '../indexer/scanner.js';
+import { validatePath } from '../utils/validate-path.js';
+import { rankFiles } from '../cache/ranking.js';
+import { getTaskContext } from '../tools/task-context.js';
+export async function getRelatedFiles(projectRoot, relativePath, options) {
+    const validated = validatePath(projectRoot, relativePath);
+    const limit = options?.limit ?? 10;
+    // Build the dependency graph
+    const graph = new DependencyGraph(projectRoot);
+    const files = await scanProject(projectRoot);
+    for (const file of files) {
+        if (!file.endsWith('.ts') &&
+            !file.endsWith('.js') &&
+            !file.endsWith('.tsx') &&
+            !file.endsWith('.jsx') &&
+            !file.endsWith('.mjs') &&
+            !file.endsWith('.cjs') &&
+            !file.endsWith('.py') &&
+            !file.endsWith('.go') &&
+            !file.endsWith('.rs')) {
+            continue;
+        }
+        try {
+            const contents = await readFile(join(projectRoot, file), 'utf-8');
+            graph.updateFile(file, contents);
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    // The graph may store paths with .js extension (from import specifiers) while
+    // actual files have .ts extension. Query both variants to get complete results.
+    const variants = getPathVariants(validated);
+    // Get direct dependencies and dependents across all path variants
+    const dependencies = new Set();
+    const dependents = new Set();
+    for (const v of variants) {
+        for (const d of graph.getDependencies(v))
+            dependencies.add(d);
+        for (const d of graph.getDependents(v))
+            dependents.add(d);
+    }
+    // Get transitive dependencies (depth 2) for "transitive-dependency" classification
+    const transitiveDeps = new Set();
+    const transitiveDependents = new Set();
+    for (const v of variants) {
+        for (const d of graph.getTransitiveDependencies(v, 2))
+            transitiveDeps.add(d);
+        for (const d of graph.getTransitiveDependents(v, 2))
+            transitiveDependents.add(d);
+    }
+    // Determine same-directory files
+    const fileDir = dirname(validated);
+    const sameDirFiles = new Set(files.filter((f) => f !== validated && dirname(f) === fileDir));
+    // Collect all candidate related files (excluding the file itself)
+    const candidates = new Set();
+    for (const d of dependencies)
+        candidates.add(d);
+    for (const d of dependents)
+        candidates.add(d);
+    for (const d of transitiveDeps)
+        candidates.add(d);
+    for (const d of transitiveDependents)
+        candidates.add(d);
+    for (const d of sameDirFiles)
+        candidates.add(d);
+    // Remove the file itself (all variants)
+    for (const v of variants)
+        candidates.delete(v);
+    if (candidates.size === 0) {
+        return { path: validated, relatedFiles: [] };
+    }
+    // Classify relationships
+    const relationshipMap = new Map();
+    for (const c of candidates) {
+        if (dependencies.has(c)) {
+            relationshipMap.set(c, 'imports');
+        }
+        else if (dependents.has(c)) {
+            relationshipMap.set(c, 'imported-by');
+        }
+        else if (transitiveDeps.has(c) || transitiveDependents.has(c)) {
+            relationshipMap.set(c, 'transitive-dependency');
+        }
+        else if (sameDirFiles.has(c)) {
+            relationshipMap.set(c, 'same-directory');
+        }
+    }
+    // Get task context for ranking if taskId provided
+    let exploredFiles = [];
+    let flaggedFiles = [];
+    if (options?.taskId) {
+        try {
+            const ctx = getTaskContext(projectRoot, options.taskId);
+            exploredFiles = ctx.exploredFiles.map((f) => f.filePath);
+            flaggedFiles = ctx.exploredFiles
+                .filter((f) => f.status === 'flagged')
+                .map((f) => f.filePath);
+        }
+        catch {
+            // Task not found — proceed without context
+        }
+    }
+    // Rank candidates
+    const candidateArray = [...candidates];
+    const ranked = rankFiles(candidateArray, {
+        projectRoot,
+        exploredFiles,
+        flaggedFiles,
+        graph,
+        limit,
+    });
+    const relatedFiles = ranked.map((r) => ({
+        path: r.path,
+        score: r.score,
+        relationship: relationshipMap.get(r.path) ?? 'same-directory',
+    }));
+    return { path: validated, relatedFiles };
+}
+/** Get path variants to handle .ts/.js extension mismatch in the dependency graph. */
+function getPathVariants(filePath) {
+    const variants = [filePath];
+    if (filePath.endsWith('.ts')) {
+        variants.push(filePath.replace(/\.ts$/, '.js'));
+    }
+    else if (filePath.endsWith('.tsx')) {
+        variants.push(filePath.replace(/\.tsx$/, '.js'));
+        variants.push(filePath.replace(/\.tsx$/, '.jsx'));
+    }
+    else if (filePath.endsWith('.js')) {
+        variants.push(filePath.replace(/\.js$/, '.ts'));
+        variants.push(filePath.replace(/\.js$/, '.tsx'));
+    }
+    else if (filePath.endsWith('.jsx')) {
+        variants.push(filePath.replace(/\.jsx$/, '.tsx'));
+    }
+    return variants;
+}
+//# sourceMappingURL=get-related-files.js.map

package/dist/tools/get-related-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-related-files.js","sourceRoot":"","sources":["../../src/tools/get-related-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,cAAc,EAA0B,MAAM,0BAA0B,CAAC;AAWlF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAmB,EACnB,YAAoB,EACpB,OAA6C;IAE7C,MAAM,SAAS,GAAG,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;IAEnC,6BAA6B;IAC7B,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;IAE7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IACE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YACrB,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YACrB,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YACtB,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YACtB,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YACtB,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YACtB,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YACrB,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YACrB,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EACrB,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YAClE,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,gFAAgF;IAChF,MAAM,QAAQ,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IAE5C,kEAAkE;IAClE,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;YAAE,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC9D,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;YAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,mFAAmF;IACnF,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC;YAAE,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7E,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC;YAAE,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC;IAED,iCAAiC;IACjC,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,YAAY,GAAG,IAAI,GAAG,CAC1B,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAC/D,CAAC;IAEF,kEAAkE;IAClE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,CAAC,IAAI,YAAY;QAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,UAAU;QAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,cAAc;QAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,oBAAoB;QAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACxD,KAAK,MAAM,CAAC,IAAI,YAAY;QAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEhD,wCAAwC;IACxC,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAE/C,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAC/C,CAAC;IAED,yBAAyB;IACzB,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACxB,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACpC,CAAC;aAAM,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QACxC,CAAC;aAAM,IAAI,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,uBAAuB,CAAC,CAAC;QAClD,CAAC;aAAM,IAAI,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/B,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,IAAI,aAAa,GAAa,EAAE,CAAC;IACjC,IAAI,YAAY,GAAa,EAAE,CAAC;IAEhC,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAsB,CAAC;YAC7E,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACzD,YAAY,GAAG,GAAG,CAAC,aAAa;iBAC7B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC;iBACrC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,2CAA2C;QAC7C,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,MAAM,cAAc,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,SAAS,CAAC,cAAc,EAAE;QACvC,WAAW;QACX,aAAa;QACb,YAAY;QACZ,KAAK;QACL,KAAK;KACN,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtC,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,YAAY,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,gBAAgB;KAC9D,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAC3C,CAAC;AAED,sFAAsF;AACtF,SAAS,eAAe,CAAC,QAAgB;IACvC,MAAM,QAAQ,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC5B,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAClD,CAAC;SAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;QACjD,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,CAAC;SAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAChD,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,CAAC;SAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/tools/get-token-report.d.ts

@@ -1,3 +1,9 @@
+export interface CacheDiagnostics {
+    cacheEntryCount: number;
+    staleEntryCount: number;
+    dbFileSizeBytes: number;
+    cacheAgeDistribution: Record<string, number>;
+}
 export interface TokenReport {
     period: string;
     totalEvents: number;
@@ -11,6 +17,7 @@ export interface TokenReport {
         tokensEstimated: number;
     }>;
     eventBreakdown: Record<string, number>;
+    diagnostics?: CacheDiagnostics;
 }
-export declare function getTokenReport(projectRoot: string, period?: 'session' | 'all' | 'last_n_hours', hours?: number, sessionId?: string): TokenReport;
+export declare function getTokenReport(projectRoot: string, period?: 'session' | 'all' | 'last_n_hours', hours?: number, sessionId?: string, includeDiagnostics?: boolean): TokenReport;
 //# sourceMappingURL=get-token-report.d.ts.map

package/dist/tools/get-token-report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-token-report.d.ts","sourceRoot":"","sources":["../../src/tools/get-token-report.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChF,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,cAAc,EAC3C,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,WAAW,CA4Cb"}
+{"version":3,"file":"get-token-report.d.ts","sourceRoot":"","sources":["../../src/tools/get-token-report.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,gBAAgB;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChF,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChC;AA+CD,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,cAAc,EAC3C,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,kBAAkB,CAAC,EAAE,OAAO,GAC3B,WAAW,CAkDb"}

package/dist/tools/get-token-report.js

@@ -1,6 +1,52 @@
+import { statSync } from 'fs';
+import { join } from 'path';
 import { TelemetryTracker } from '../telemetry/tracker.js';
 import { SessionManager } from '../memory/session.js';
-export function getTokenReport(projectRoot, period, hours, sessionId) {
+import { CacheStore } from '../cache/store.js';
+const MS_PER_DAY = 24 * 60 * 60 * 1000;
+const STALE_THRESHOLD_DAYS = 30;
+function buildCacheDiagnostics(projectRoot) {
+    const store = new CacheStore(projectRoot);
+    const allEntries = store.getAllEntries();
+    const staleEntries = store.getStaleEntries(STALE_THRESHOLD_DAYS * MS_PER_DAY);
+    let dbFileSizeBytes = 0;
+    try {
+        const dbPath = join(projectRoot, '.repo-memory', 'cache.db');
+        dbFileSizeBytes = statSync(dbPath).size;
+    }
+    catch {
+        // DB file may not exist yet
+    }
+    const now = Date.now();
+    const distribution = {
+        '< 1 day': 0,
+        '1-7 days': 0,
+        '7-30 days': 0,
+        '> 30 days': 0,
+    };
+    for (const entry of allEntries) {
+        const ageDays = (now - entry.lastChecked) / MS_PER_DAY;
+        if (ageDays < 1) {
+            distribution['< 1 day']++;
+        }
+        else if (ageDays < 7) {
+            distribution['1-7 days']++;
+        }
+        else if (ageDays < 30) {
+            distribution['7-30 days']++;
+        }
+        else {
+            distribution['> 30 days']++;
+        }
+    }
+    return {
+        cacheEntryCount: allEntries.length,
+        staleEntryCount: staleEntries.length,
+        dbFileSizeBytes,
+        cacheAgeDistribution: distribution,
+    };
+}
+export function getTokenReport(projectRoot, period, hours, sessionId, includeDiagnostics) {
     const tracker = new TelemetryTracker(projectRoot);
     const effectivePeriod = period ?? 'all';
     let since;
@@ -30,7 +76,7 @@ export function getTokenReport(projectRoot, period, hours, sessionId) {
         .map(([path, data]) => ({ path, ...data }))
         .sort((a, b) => b.accessCount - a.accessCount)
         .slice(0, 10);
-    return {
+    const report = {
         period: effectivePeriod,
         totalEvents: stats.totalEvents,
         cacheHits: stats.cacheHits,
@@ -40,5 +86,9 @@ export function getTokenReport(projectRoot, period, hours, sessionId) {
         topFiles,
         eventBreakdown: stats.eventsByType,
     };
+    if (includeDiagnostics) {
+        report.diagnostics = buildCacheDiagnostics(projectRoot);
+    }
+    return report;
 }
 //# sourceMappingURL=get-token-report.js.map

package/dist/tools/get-token-report.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-token-report.js","sourceRoot":"","sources":["../../src/tools/get-token-report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAatD,MAAM,UAAU,cAAc,CAC5B,WAAmB,EACnB,MAA2C,EAC3C,KAAc,EACd,SAAkB;IAElB,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAClD,MAAM,eAAe,GAAG,MAAM,IAAI,KAAK,CAAC;IAExC,IAAI,KAAyB,CAAC;IAE9B,IAAI,eAAe,KAAK,SAAS,IAAI,SAAS,EAAE,CAAC;QAC/C,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,WAAW,CAAC,CAAC;QACvD,MAAM,OAAO,GAAG,cAAc,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QACrD,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC;QAC5B,CAAC;IACH,CAAC;SAAM,IAAI,eAAe,KAAK,cAAc,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAC/D,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,OAAO,CAAC;IACvC,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEtC,iDAAiD;IACjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA4D,CAAC;IACpF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,QAAQ;YAAE,SAAS;QAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;QACpF,KAAK,CAAC,WAAW,EAAE,CAAC;QACpB,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,eAAe,IAAI,CAAC,CAAC;QACpD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;SACpC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;SAC1C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;SAC7C,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEhB,OAAO;QACL,MAAM,EAAE,eAAe;QACvB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,aAAa,EAAE,KAAK,CAAC,QAAQ;QAC7B,oBAAoB,EAAE,KAAK,CAAC,gBAAgB;QAC5C,QAAQ;QACR,cAAc,EAAE,KAAK,CAAC,YAAY;KACnC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get-token-report.js","sourceRoot":"","sources":["../../src/tools/get-token-report.ts"],"names":[],"mappings":"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"}

package/dist/tools/search-by-purpose.d.ts

@@ -0,0 +1,14 @@
+export interface SearchResult {
+    path: string;
+    purpose: string;
+    matchedOn: string[];
+    exports: string[];
+    confidence: string;
+}
+export interface SearchByPurposeResult {
+    query: string;
+    results: SearchResult[];
+    totalCached: number;
+}
+export declare function searchByPurpose(projectRoot: string, query: string, limit?: number): SearchByPurposeResult;
+//# sourceMappingURL=search-by-purpose.d.ts.map

package/dist/tools/search-by-purpose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-by-purpose.d.ts","sourceRoot":"","sources":["../../src/tools/search-by-purpose.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,qBAAqB,CA2DvB"}

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

@@ -0,0 +1,50 @@
+import { CacheStore } from '../cache/store.js';
+export function searchByPurpose(projectRoot, query, limit) {
+    const store = new CacheStore(projectRoot);
+    const allEntries = store.getAllEntries();
+    const effectiveLimit = limit ?? 20;
+    const queryTerms = query.toLowerCase().split(/\s+/).filter(Boolean);
+    const results = [];
+    for (const entry of allEntries) {
+        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,
+            });
+        }
+    }
+    // Sort by score descending
+    results.sort((a, b) => b.score - a.score);
+    return {
+        query,
+        results: results.slice(0, effectiveLimit).map(({ score: _score, ...rest }) => rest),
+        totalCached: allEntries.filter(e => e.summary).length,
+    };
+}
+//# sourceMappingURL=search-by-purpose.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blamechris/repo-memory",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "MCP server that gives AI coding agents persistent memory about your codebase",
   "type": "module",
   "main": "dist/server.js",
@@ -23,7 +23,7 @@
     "lint": "eslint --no-error-on-unmatched-pattern 'src/**/*.ts' 'tests/**/*.ts'",
     "format": "prettier --write 'src/**/*.ts' '*.json' '*.mjs' && prettier --write 'tests/**/*.ts' 2>/dev/null || true",
     "prepublishOnly": "npm run typecheck && npm run lint && npm run test && npm run build",
-    "benchmark": "tsx tests/benchmarks/run-benchmarks.ts"
+    "benchmark": "npx tsx tests/benchmarks/run-benchmarks.ts"
   },
   "keywords": [
     "mcp",