projscan 0.5.0 → 0.7.0

package/dist/core/importGraph.d.ts

@@ -1,4 +1,5 @@
 import type { FileEntry } from '../types.js';
+import { toPackageName as graphToPackageName } from './codeGraph.js';
 export interface ImportGraph {
     /** file → set of import specifiers exactly as they appear in source */
     byFile: Map<string, Set<string>>;
@@ -8,23 +9,12 @@ export interface ImportGraph {
     scannedFiles: number;
 }
 /**
- * Walk source files and build an import graph. Extracts ES imports and
- * CommonJS requires; falls back silently on unreadable / oversized files.
+ * Walk source files and build an import graph. Now backed by AST-based
+ * codeGraph — this function is retained for public API compatibility.
  */
 export declare function buildImportGraph(rootPath: string, files: FileEntry[]): Promise<ImportGraph>;
-/**
- * Convert an import specifier to a bare package name.
- * Returns null for relative paths ("./", "../", "/"), node: builtins, and bare builtins.
- *
- *   'react'           -> 'react'
- *   'react/jsx-runtime' -> 'react'
- *   '@types/node'     -> '@types/node'
- *   '@scope/pkg/deep' -> '@scope/pkg'
- *   './local'         -> null
- *   'node:fs'         -> null
- *   'fs'              -> null (node builtin)
- */
-export declare function toPackageName(specifier: string): string | null;
+/** Convert an import specifier to a bare package name. */
+export declare const toPackageName: typeof graphToPackageName;
 /** Check if a package is referenced by at least one file in the graph. */
 export declare function isPackageUsed(graph: ImportGraph, pkg: string): boolean;
 /** List files that import a given package. */

package/dist/core/importGraph.js

@@ -1,124 +1,26 @@
-import fs from 'node:fs/promises';
-import path from 'node:path';
-import { extractImports } from './fileInspector.js';
-const SOURCE_EXTENSIONS = new Set([
-    '.ts',
-    '.tsx',
-    '.js',
-    '.jsx',
-    '.mjs',
-    '.cjs',
-    '.mts',
-    '.cts',
-]);
-const MAX_FILE_SIZE = 1024 * 1024; // 1 MB — skip giant generated files
-const NODE_BUILTINS = new Set([
-    'assert',
-    'async_hooks',
-    'buffer',
-    'child_process',
-    'cluster',
-    'console',
-    'constants',
-    'crypto',
-    'dgram',
-    'dns',
-    'domain',
-    'events',
-    'fs',
-    'fs/promises',
-    'http',
-    'http2',
-    'https',
-    'inspector',
-    'module',
-    'net',
-    'os',
-    'path',
-    'perf_hooks',
-    'process',
-    'punycode',
-    'querystring',
-    'readline',
-    'repl',
-    'stream',
-    'string_decoder',
-    'sys',
-    'timers',
-    'tls',
-    'trace_events',
-    'tty',
-    'url',
-    'util',
-    'v8',
-    'vm',
-    'wasi',
-    'worker_threads',
-    'zlib',
-]);
+import { buildCodeGraph, toPackageName as graphToPackageName } from './codeGraph.js';
 /**
- * Walk source files and build an import graph. Extracts ES imports and
- * CommonJS requires; falls back silently on unreadable / oversized files.
+ * Walk source files and build an import graph. Now backed by AST-based
+ * codeGraph — this function is retained for public API compatibility.
  */
 export async function buildImportGraph(rootPath, files) {
+    const code = await buildCodeGraph(rootPath, files);
     const byFile = new Map();
     const externalPackages = new Set();
-    let scannedFiles = 0;
-    const sourceFiles = files.filter((f) => SOURCE_EXTENSIONS.has(f.extension) && f.sizeBytes <= MAX_FILE_SIZE);
-    await Promise.all(sourceFiles.map(async (file) => {
-        const abs = path.isAbsolute(file.absolutePath)
-            ? file.absolutePath
-            : path.resolve(rootPath, file.relativePath);
-        let content;
-        try {
-            content = await fs.readFile(abs, 'utf-8');
-        }
-        catch {
-            return;
-        }
-        scannedFiles++;
-        const imports = extractImports(content);
+    for (const [file, entry] of code.files) {
         const specifiers = new Set();
-        for (const imp of imports) {
+        for (const imp of entry.imports) {
             specifiers.add(imp.source);
-            const pkg = toPackageName(imp.source);
-            if (pkg && !NODE_BUILTINS.has(pkg) && !pkg.startsWith('node:')) {
+            const pkg = graphToPackageName(imp.source);
+            if (pkg)
                 externalPackages.add(pkg);
-            }
         }
-        byFile.set(file.relativePath, specifiers);
-    }));
-    return { byFile, externalPackages, scannedFiles };
-}
-/**
- * Convert an import specifier to a bare package name.
- * Returns null for relative paths ("./", "../", "/"), node: builtins, and bare builtins.
- *
- *   'react'           -> 'react'
- *   'react/jsx-runtime' -> 'react'
- *   '@types/node'     -> '@types/node'
- *   '@scope/pkg/deep' -> '@scope/pkg'
- *   './local'         -> null
- *   'node:fs'         -> null
- *   'fs'              -> null (node builtin)
- */
-export function toPackageName(specifier) {
-    if (!specifier)
-        return null;
-    if (specifier.startsWith('.') || specifier.startsWith('/'))
-        return null;
-    if (specifier.startsWith('node:'))
-        return null;
-    if (NODE_BUILTINS.has(specifier))
-        return null;
-    if (specifier.startsWith('@')) {
-        const segments = specifier.split('/');
-        if (segments.length < 2)
-            return null;
-        return `${segments[0]}/${segments[1]}`;
+        byFile.set(file, specifiers);
     }
-    return specifier.split('/')[0];
+    return { byFile, externalPackages, scannedFiles: code.scannedFiles };
 }
+/** Convert an import specifier to a bare package name. */
+export const toPackageName = graphToPackageName;
 /** Check if a package is referenced by at least one file in the graph. */
 export function isPackageUsed(graph, pkg) {
     return graph.externalPackages.has(pkg);

package/dist/core/importGraph.js.map

@@ -1 +1 @@
-{"version":3,"file":"importGraph.js","sourceRoot":"","sources":["../../src/core/importGraph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"importGraph.js","sourceRoot":"","sources":["../../src/core/importGraph.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAWrF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAgB,EAChB,KAAkB;IAElB,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAEnD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC9C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;IAE3C,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACvC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAChC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC3B,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC3C,IAAI,GAAG;gBAAE,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;AACvE,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAEhD,0EAA0E;AAC1E,MAAM,UAAU,aAAa,CAAC,KAAkB,EAAE,GAAW;IAC3D,OAAO,KAAK,CAAC,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,cAAc,CAAC,KAAkB,EAAE,GAAW;IAC5D,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAC9C,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;gBAChC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACf,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC"}

package/dist/core/indexCache.d.ts

@@ -0,0 +1,12 @@
+import type { CodeGraph } from './codeGraph.js';
+/**
+ * Load a previously cached code graph, if present and valid. Returns undefined
+ * when there's no cache or the cache is incompatible — caller should rebuild.
+ */
+export declare function loadCachedGraph(rootPath: string): Promise<CodeGraph | undefined>;
+/**
+ * Persist the graph. Creates .projscan-cache/ if needed. Swallows errors —
+ * caching is best-effort, never blocks a run.
+ */
+export declare function saveCachedGraph(rootPath: string, graph: CodeGraph): Promise<void>;
+export declare function invalidateCache(rootPath: string): Promise<void>;

package/dist/core/indexCache.js

@@ -0,0 +1,97 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const CACHE_DIR = '.projscan-cache';
+const CACHE_FILE = 'graph.json';
+const CACHE_VERSION = 1;
+/**
+ * Load a previously cached code graph, if present and valid. Returns undefined
+ * when there's no cache or the cache is incompatible — caller should rebuild.
+ */
+export async function loadCachedGraph(rootPath) {
+    const cachePath = path.join(rootPath, CACHE_DIR, CACHE_FILE);
+    let raw;
+    try {
+        raw = await fs.readFile(cachePath, 'utf-8');
+    }
+    catch {
+        return undefined;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+    if (parsed.version !== CACHE_VERSION)
+        return undefined;
+    const files = new Map();
+    for (const entry of parsed.files) {
+        files.set(entry.relativePath, {
+            relativePath: entry.relativePath,
+            imports: entry.imports,
+            exports: entry.exports,
+            callSites: entry.callSites,
+            lineCount: entry.lineCount,
+            mtimeMs: entry.mtimeMs,
+            parseOk: entry.parseOk,
+            parseReason: entry.parseReason,
+        });
+    }
+    // Derived indexes are rebuilt on load — cheap compared to re-parsing.
+    // Return a partial graph the caller will rehydrate via buildCodeGraph.
+    return {
+        files,
+        packageImporters: new Map(),
+        localImporters: new Map(),
+        symbolDefs: new Map(),
+        scannedFiles: files.size,
+    };
+}
+/**
+ * Persist the graph. Creates .projscan-cache/ if needed. Swallows errors —
+ * caching is best-effort, never blocks a run.
+ */
+export async function saveCachedGraph(rootPath, graph) {
+    const dir = path.join(rootPath, CACHE_DIR);
+    try {
+        await fs.mkdir(dir, { recursive: true });
+    }
+    catch {
+        return;
+    }
+    const payload = {
+        version: CACHE_VERSION,
+        rootPath,
+        files: [...graph.files.values()].map((entry) => ({
+            relativePath: entry.relativePath,
+            imports: entry.imports,
+            exports: entry.exports,
+            callSites: entry.callSites,
+            lineCount: entry.lineCount,
+            mtimeMs: entry.mtimeMs,
+            parseOk: entry.parseOk,
+            parseReason: entry.parseReason,
+        })),
+        createdAt: new Date().toISOString(),
+    };
+    try {
+        await fs.writeFile(path.join(dir, CACHE_FILE), JSON.stringify(payload), 'utf-8');
+        // Ensure users don't accidentally commit the cache.
+        const gitignorePath = path.join(dir, '.gitignore');
+        await fs.writeFile(gitignorePath, '*\n', 'utf-8');
+    }
+    catch {
+        // ignore — cache is best-effort
+    }
+}
+export async function invalidateCache(rootPath) {
+    const cachePath = path.join(rootPath, CACHE_DIR, CACHE_FILE);
+    try {
+        await fs.unlink(cachePath);
+    }
+    catch {
+        // ignore
+    }
+}
+//# sourceMappingURL=indexCache.js.map

package/dist/core/indexCache.js.map

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

package/dist/core/searchIndex.d.ts

@@ -0,0 +1,54 @@
+import type { FileEntry } from '../types.js';
+import type { CodeGraph } from './codeGraph.js';
+export interface IndexedFile {
+    relativePath: string;
+    content: string[];
+    symbols: string[];
+    pathTokens: string[];
+    length: number;
+}
+export interface SearchIndex {
+    files: Map<string, IndexedFile>;
+    /** token → map<file, count> */
+    postings: Map<string, Map<string, number>>;
+    /** average document length across indexed files */
+    avgDocLength: number;
+    /** total number of indexed documents */
+    docCount: number;
+}
+export interface SearchHit {
+    file: string;
+    score: number;
+    matched: string[];
+    symbolMatch: boolean;
+    pathMatch: boolean;
+    excerpt: string;
+    line: number;
+}
+export interface SearchOptions {
+    limit?: number;
+    symbolWeight?: number;
+    pathWeight?: number;
+}
+export declare function buildSearchIndex(rootPath: string, files: FileEntry[], graph?: CodeGraph): Promise<SearchIndex>;
+export declare function search(index: SearchIndex, query: string, options?: SearchOptions): SearchHit[];
+/**
+ * Attach a one-line excerpt to each hit, reading the file to find the first
+ * matching line. This is a separate pass to avoid paying the I/O cost when
+ * the caller only wants paths (e.g., an agent filtering before fetching).
+ */
+export declare function attachExcerpts(rootPath: string, hits: SearchHit[], queryTokens: string[]): Promise<SearchHit[]>;
+/**
+ * Tokenize a string for indexing/querying:
+ *   - lowercase
+ *   - split on non-identifier chars
+ *   - split camelCase and snake_case
+ *   - drop tokens shorter than 2 chars, stopwords, TS keywords
+ *   - apply basic stem (drop trailing s / ing / ed)
+ */
+export declare function tokenize(input: string): string[];
+/**
+ * Expand a user query into a set of candidate tokens. Same rules as tokenize
+ * plus: if the raw query has no hits, try progressively looser tokenization.
+ */
+export declare function expandQuery(query: string): string[];

package/dist/core/searchIndex.js

@@ -0,0 +1,268 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+/**
+ * Lightweight BM25-ranked inverted index over source files.
+ *
+ * We index three fields per file with different weights:
+ *   - content (body tokens, BM25 baseline)
+ *   - symbols (export names — most informative for code search)
+ *   - path (file path tokens)
+ *
+ * Scoring:
+ *   score(file, query) = BM25(content) + 2.0 * hits(symbols) + 0.5 * hits(path)
+ *
+ * This intentionally beats pure substring matching while staying
+ * zero-dependency and fast enough for sub-second queries on 10k-file repos.
+ */
+const MAX_FILE_SIZE = 512 * 1024;
+const STOPWORDS = new Set([
+    'the', 'a', 'an', 'and', 'or', 'not', 'of', 'to', 'in', 'is', 'it', 'for', 'on', 'with',
+    'this', 'that', 'by', 'as', 'at', 'be', 'are', 'was', 'were', 'has', 'have', 'had',
+]);
+const TS_KEYWORDS = new Set([
+    'const', 'let', 'var', 'function', 'return', 'if', 'else', 'while', 'for', 'do', 'break',
+    'continue', 'switch', 'case', 'default', 'new', 'class', 'extends', 'implements',
+    'interface', 'type', 'enum', 'public', 'private', 'protected', 'static', 'readonly',
+    'async', 'await', 'try', 'catch', 'finally', 'throw', 'import', 'export', 'from', 'as',
+    'typeof', 'instanceof', 'void', 'null', 'undefined', 'true', 'false', 'this', 'super',
+    'yield', 'delete', 'in', 'of', 'any', 'never', 'unknown', 'string', 'number', 'boolean',
+    'object', 'symbol', 'bigint',
+]);
+export async function buildSearchIndex(rootPath, files, graph) {
+    const indexed = new Map();
+    const postings = new Map();
+    const parseable = files.filter((f) => f.sizeBytes <= MAX_FILE_SIZE && isIndexable(f.relativePath));
+    await Promise.all(parseable.map(async (file) => {
+        const abs = path.isAbsolute(file.absolutePath)
+            ? file.absolutePath
+            : path.resolve(rootPath, file.relativePath);
+        let content;
+        try {
+            content = await fs.readFile(abs, 'utf-8');
+        }
+        catch {
+            return;
+        }
+        const contentTokens = tokenize(content);
+        const pathTokens = tokenize(file.relativePath);
+        const symbols = (graph?.files.get(file.relativePath)?.exports ?? []).map((e) => e.name.toLowerCase());
+        const entry = {
+            relativePath: file.relativePath,
+            content: contentTokens,
+            symbols: symbols.flatMap((s) => tokenize(s)),
+            pathTokens,
+            length: contentTokens.length,
+        };
+        indexed.set(file.relativePath, entry);
+        // Build postings from content tokens
+        const termCounts = new Map();
+        for (const tok of contentTokens) {
+            termCounts.set(tok, (termCounts.get(tok) ?? 0) + 1);
+        }
+        for (const [tok, count] of termCounts) {
+            if (!postings.has(tok))
+                postings.set(tok, new Map());
+            postings.get(tok).set(file.relativePath, count);
+        }
+    }));
+    const totalLength = [...indexed.values()].reduce((sum, f) => sum + f.length, 0);
+    const avgDocLength = indexed.size > 0 ? totalLength / indexed.size : 1;
+    return {
+        files: indexed,
+        postings,
+        avgDocLength,
+        docCount: indexed.size,
+    };
+}
+export function search(index, query, options = {}) {
+    const limit = Math.max(1, Math.min(500, options.limit ?? 30));
+    const symbolWeight = options.symbolWeight ?? 2.0;
+    const pathWeight = options.pathWeight ?? 0.5;
+    const queryTokens = expandQuery(query);
+    if (queryTokens.length === 0)
+        return [];
+    // BM25 parameters
+    const k1 = 1.5;
+    const b = 0.75;
+    const scores = new Map();
+    for (const qTok of queryTokens) {
+        const postings = index.postings.get(qTok);
+        if (!postings)
+            continue;
+        const df = postings.size;
+        const idf = Math.log(1 + (index.docCount - df + 0.5) / (df + 0.5));
+        for (const [file, tf] of postings) {
+            const doc = index.files.get(file);
+            if (!doc)
+                continue;
+            const dl = doc.length;
+            const norm = tf * (k1 + 1) / (tf + k1 * (1 - b + b * (dl / index.avgDocLength)));
+            const bm25 = idf * norm;
+            const existing = scores.get(file);
+            if (existing) {
+                existing.score += bm25;
+                existing.matched.add(qTok);
+            }
+            else {
+                scores.set(file, { score: bm25, matched: new Set([qTok]) });
+            }
+        }
+    }
+    // Apply symbol + path boosts
+    for (const [file, entry] of index.files) {
+        const symbolHits = countHits(entry.symbols, queryTokens);
+        const pathHits = countHits(entry.pathTokens, queryTokens);
+        if (symbolHits > 0 || pathHits > 0) {
+            const current = scores.get(file) ?? { score: 0, matched: new Set() };
+            current.score += symbolHits * symbolWeight + pathHits * pathWeight;
+            for (const qt of queryTokens) {
+                if (entry.symbols.includes(qt) || entry.pathTokens.includes(qt)) {
+                    current.matched.add(qt);
+                }
+            }
+            scores.set(file, current);
+        }
+    }
+    if (scores.size === 0)
+        return [];
+    // Sort by score, take top limit
+    const ranked = [...scores.entries()]
+        .sort((a, b) => b[1].score - a[1].score)
+        .slice(0, limit);
+    return ranked.map(([file, info]) => {
+        const entry = index.files.get(file);
+        const symbolMatch = queryTokens.some((t) => entry.symbols.includes(t));
+        const pathMatch = queryTokens.some((t) => entry.pathTokens.includes(t));
+        return {
+            file,
+            score: Math.round(info.score * 100) / 100,
+            matched: [...info.matched],
+            symbolMatch,
+            pathMatch,
+            excerpt: '',
+            line: 0,
+        };
+    });
+}
+/**
+ * Attach a one-line excerpt to each hit, reading the file to find the first
+ * matching line. This is a separate pass to avoid paying the I/O cost when
+ * the caller only wants paths (e.g., an agent filtering before fetching).
+ */
+export async function attachExcerpts(rootPath, hits, queryTokens) {
+    const qLower = queryTokens.map((t) => t.toLowerCase());
+    return Promise.all(hits.map(async (hit) => {
+        const abs = path.resolve(rootPath, hit.file);
+        try {
+            const content = await fs.readFile(abs, 'utf-8');
+            const lines = content.split('\n');
+            for (let i = 0; i < lines.length; i++) {
+                const lower = lines[i].toLowerCase();
+                if (qLower.some((t) => lower.includes(t))) {
+                    return { ...hit, line: i + 1, excerpt: lines[i].trim().slice(0, 200) };
+                }
+            }
+        }
+        catch {
+            // ignore
+        }
+        return hit;
+    }));
+}
+/**
+ * Tokenize a string for indexing/querying:
+ *   - lowercase
+ *   - split on non-identifier chars
+ *   - split camelCase and snake_case
+ *   - drop tokens shorter than 2 chars, stopwords, TS keywords
+ *   - apply basic stem (drop trailing s / ing / ed)
+ */
+export function tokenize(input) {
+    const out = [];
+    // Split on non-identifier boundaries. Keep original case so we can also
+    // split on camelCase boundaries below.
+    const rawTokens = input.match(/[A-Za-z0-9_]+/g) ?? [];
+    for (const raw of rawTokens) {
+        // Split on underscore and camelCase. camelCase: insert a boundary before
+        // each uppercase that follows a lowercase or digit (OR before runs of
+        // uppercase followed by lowercase to handle acronyms like "XMLParser").
+        const camelSplit = raw
+            .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+            .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2');
+        const parts = camelSplit.split(/[_\s]+/).filter(Boolean);
+        for (const part of parts) {
+            // Split embedded digits from letters — e.g. "v1api" → "v", "1", "api"
+            const subparts = part.split(/(\d+)/).filter(Boolean);
+            for (const sp of subparts) {
+                const lower = sp.toLowerCase();
+                const stemmed = stem(lower);
+                if (!keepToken(stemmed))
+                    continue;
+                out.push(stemmed);
+            }
+        }
+    }
+    return out;
+}
+/**
+ * Expand a user query into a set of candidate tokens. Same rules as tokenize
+ * plus: if the raw query has no hits, try progressively looser tokenization.
+ */
+export function expandQuery(query) {
+    const tokens = tokenize(query);
+    return [...new Set(tokens)];
+}
+function stem(token) {
+    if (token.length <= 3)
+        return token;
+    if (token.endsWith('ing'))
+        return token.slice(0, -3);
+    if (token.endsWith('ed') && token.length > 4)
+        return token.slice(0, -2);
+    if (token.endsWith('es') && token.length > 4)
+        return token.slice(0, -2);
+    if (token.endsWith('s') && !token.endsWith('ss'))
+        return token.slice(0, -1);
+    return token;
+}
+function keepToken(token) {
+    if (token.length < 2)
+        return false;
+    if (STOPWORDS.has(token))
+        return false;
+    if (TS_KEYWORDS.has(token))
+        return false;
+    return true;
+}
+function countHits(tokens, query) {
+    let count = 0;
+    const set = new Set(tokens);
+    for (const q of query)
+        if (set.has(q))
+            count++;
+    return count;
+}
+function isIndexable(relativePath) {
+    const ext = path.extname(relativePath).toLowerCase();
+    // Index source and markup/docs where it's likely useful
+    return (ext === '.ts' ||
+        ext === '.tsx' ||
+        ext === '.js' ||
+        ext === '.jsx' ||
+        ext === '.mjs' ||
+        ext === '.cjs' ||
+        ext === '.mts' ||
+        ext === '.cts' ||
+        ext === '.py' ||
+        ext === '.go' ||
+        ext === '.rb' ||
+        ext === '.java' ||
+        ext === '.rs' ||
+        ext === '.php' ||
+        ext === '.cs' ||
+        ext === '.swift' ||
+        ext === '.kt' ||
+        ext === '.md' ||
+        ext === '.mdx');
+}
+//# sourceMappingURL=searchIndex.js.map

package/dist/core/searchIndex.js.map

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

package/dist/index.d.ts

@@ -11,6 +11,11 @@ export { runAudit, auditFindingsToIssues } from './core/auditRunner.js';
 export { previewUpgrade } from './core/upgradePreview.js';
 export { parseCoverage, coverageMap } from './core/coverageParser.js';
 export { joinCoverageWithHotspots } from './core/coverageJoin.js';
+export { parseSource, isParseable } from './core/ast.js';
+export { buildCodeGraph, filesImportingFile, filesImportingPackage, filesDefiningSymbol, exportsOf, importsOf, importersOf, } from './core/codeGraph.js';
+export { loadCachedGraph, saveCachedGraph, invalidateCache } from './core/indexCache.js';
+export { applyBudget, estimateTokens } from './mcp/tokenBudget.js';
+export { buildSearchIndex, search, tokenize, expandQuery, attachExcerpts, } from './core/searchIndex.js';
 export { findDependencyLines } from './utils/packageJsonLocator.js';
 export { parse as parseSemver, compare as compareSemver, drift as semverDrift } from './utils/semver.js';
 export { walkFiles } from './utils/fileWalker.js';