purecontext-mcp 1.0.1

package/dist/core/file-discovery.js

@@ -0,0 +1,136 @@
+import { readdirSync, readFileSync, statSync } from 'fs';
+import { join, relative, sep } from 'path';
+import ignore from 'ignore';
+import { isSecretFile, isBinaryFile, peekFileContent, checkFileSize, DEFAULT_MAX_FILE_BYTES } from './security.js';
+import { logger } from './logger.js';
+// ─── Constants ────────────────────────────────────────────────────────────────
+const BUILT_IN_EXCLUDES = [
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '.claude',
+    '.env',
+    '.env.*',
+    '*.lock',
+    'package-lock.json',
+    'yarn.lock',
+    'pnpm-lock.yaml',
+];
+/** Higher number = higher priority (indexed first). */
+const PRIORITY_MAP = [
+    ['src', 100],
+    ['lib', 90],
+    ['app', 80],
+    ['pages', 70],
+    ['components', 60],
+    ['server', 50],
+    // default: 30 (see getPriority)
+    ['test', 20],
+    ['__tests__', 10],
+];
+export const DEFAULT_FILE_LIMIT = 10000;
+// ─── Public API ───────────────────────────────────────────────────────────────
+export function discoverFiles(rootPath, options = {}) {
+    const { extensions, fileLimit = DEFAULT_FILE_LIMIT, extraExcludePatterns = [], maxFileSizeBytes = DEFAULT_MAX_FILE_BYTES, } = options;
+    const ig = buildIgnoreFilter(rootPath, extraExcludePatterns);
+    const results = [];
+    walk(rootPath, rootPath, ig, extensions, maxFileSizeBytes, results);
+    results.sort((a, b) => {
+        if (b.priority !== a.priority)
+            return b.priority - a.priority;
+        return a.path.localeCompare(b.path);
+    });
+    const totalBeforeLimit = results.length;
+    const files = fileLimit > 0 ? results.slice(0, fileLimit) : results;
+    return { files, totalBeforeLimit };
+}
+// ─── Internals ────────────────────────────────────────────────────────────────
+function buildIgnoreFilter(rootPath, extra) {
+    const ig = ignore();
+    ig.add(BUILT_IN_EXCLUDES);
+    ig.add(extra);
+    try {
+        const gitignorePath = join(rootPath, '.gitignore');
+        const content = readFileSync(gitignorePath, 'utf8');
+        ig.add(content);
+    }
+    catch {
+        // No .gitignore present — that's fine.
+    }
+    return ig;
+}
+function walk(rootPath, currentPath, ig, extensions, maxFileSizeBytes, results) {
+    let entries;
+    try {
+        entries = readdirSync(currentPath, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const absPath = join(currentPath, entry.name);
+        // Relative path from root, using forward slashes (ignore package expects /)
+        const relPath = relative(rootPath, absPath).split(sep).join('/');
+        if (ig.ignores(relPath))
+            continue;
+        if (entry.isDirectory()) {
+            // Also prune if the directory name alone is ignored (e.g. node_modules)
+            if (!ig.ignores(entry.name + '/')) {
+                walk(rootPath, absPath, ig, extensions, maxFileSizeBytes, results);
+            }
+            continue;
+        }
+        if (!entry.isFile())
+            continue;
+        if (extensions) {
+            const dot = entry.name.lastIndexOf('.');
+            if (dot === -1)
+                continue;
+            const ext = entry.name.slice(dot);
+            if (!extensions.includes(ext))
+                continue;
+        }
+        // Skip files matching credential/secret patterns
+        if (isSecretFile(entry.name)) {
+            logger.debug('Skipping secret file', { path: relPath });
+            continue;
+        }
+        let size = 0;
+        try {
+            size = statSync(absPath).size;
+        }
+        catch {
+            // skip unreadable files
+            continue;
+        }
+        // Skip files exceeding the size limit
+        try {
+            checkFileSize(size, maxFileSizeBytes);
+        }
+        catch {
+            logger.warn('Skipping oversized file', { path: relPath, size, maxFileSizeBytes });
+            continue;
+        }
+        // Skip binary files (detect via null-byte scan of first 8 KB)
+        const peek = peekFileContent(absPath);
+        if (isBinaryFile(peek)) {
+            logger.debug('Skipping binary file', { path: relPath });
+            continue;
+        }
+        results.push({
+            path: relPath,
+            size,
+            priority: getPriority(relPath),
+        });
+    }
+}
+function getPriority(relPath) {
+    const topDir = relPath.split('/')[0];
+    for (const [name, priority] of PRIORITY_MAP) {
+        if (topDir === name)
+            return priority;
+    }
+    return 30;
+}
+//# sourceMappingURL=file-discovery.js.map

package/dist/core/file-discovery.js.map

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

package/dist/core/file-processor.d.ts

@@ -0,0 +1,21 @@
+/**
+ * File processing pipeline: parse a source file, extract symbols and imports.
+ *
+ * Extracted from index-manager.ts so it can be imported by both the main thread
+ * and worker threads (indexing-worker.ts) without pulling in the full indexing
+ * pipeline (DB, watcher, etc.).
+ */
+import type { ImportRecord, FrameworkAdapter, SymbolRecord } from './types.js';
+export interface ProcessedResult {
+    symbols: SymbolRecord[];
+    imports: ImportRecord[];
+}
+/**
+ * Process a single file through either the normal handler path or the adapter
+ * pipeline (preProcess → block parsing → framework symbol extraction → enrichment).
+ *
+ * Returns extracted symbols and imports. The caller is responsible for
+ * persisting results to the database.
+ */
+export declare function processFile(relPath: string, content: Buffer, adapters: FrameworkAdapter[]): Promise<ProcessedResult>;
+//# sourceMappingURL=file-processor.d.ts.map

package/dist/core/file-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-processor.d.ts","sourceRoot":"","sources":["../../src/core/file-processor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK/E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,gBAAgB,EAAE,GAC3B,OAAO,CAAC,eAAe,CAAC,CAoC1B"}

package/dist/core/file-processor.js

@@ -0,0 +1,110 @@
+/**
+ * File processing pipeline: parse a source file, extract symbols and imports.
+ *
+ * Extracted from index-manager.ts so it can be imported by both the main thread
+ * and worker threads (indexing-worker.ts) without pulling in the full indexing
+ * pipeline (DB, watcher, etc.).
+ */
+import { parseFile } from './parse-dispatcher.js';
+import { getHandler, getHandlerByLanguage } from '../handlers/handler-registry.js';
+import { enrichSymbols } from '../summarizer/summarizer.js';
+/**
+ * Process a single file through either the normal handler path or the adapter
+ * pipeline (preProcess → block parsing → framework symbol extraction → enrichment).
+ *
+ * Returns extracted symbols and imports. The caller is responsible for
+ * persisting results to the database.
+ */
+export async function processFile(relPath, content, adapters) {
+    // Find the first adapter whose fileFilter matches this path
+    const adapter = adapters.find((a) => a.fileFilter(relPath));
+    let symbols;
+    let imports;
+    if (adapter) {
+        const result = await processWithAdapter(relPath, content, adapter);
+        symbols = result.symbols;
+        imports = result.imports;
+    }
+    else {
+        // Normal handler path
+        const handler = getHandler(relPath);
+        if (!handler)
+            return { symbols: [], imports: [] };
+        const tree = await parseFile(content, handler);
+        symbols = handler.extractSymbols(tree, content, relPath);
+        imports = handler.extractImports(tree, content).map((imp) => ({
+            ...imp,
+            sourceFile: relPath,
+        }));
+    }
+    // Apply enrichMetadata from ALL active adapters — not just the one that handled
+    // the file. This enables cross-adapter enrichment (e.g. Nuxt adapter adds route
+    // path metadata to component symbols emitted by the Vue adapter).
+    for (const a of adapters) {
+        if (a.enrichMetadata) {
+            symbols = symbols.map((s) => a.enrichMetadata(s));
+        }
+    }
+    // enrichSymbols runs AFTER enrichMetadata so Stage 2 (framework-derived
+    // summaries) has access to the frameworkMeta set by adapters.
+    return { symbols: enrichSymbols(symbols), imports };
+}
+async function processWithAdapter(relPath, content, adapter) {
+    let blockSymbols = [];
+    const imports = [];
+    let primaryTree = null;
+    if (adapter.preProcess) {
+        // Split the file into typed blocks (e.g. .vue → <script> + <template>)
+        const blocks = adapter.preProcess(content, relPath);
+        for (const block of blocks) {
+            if (block.language !== 'typescript' && block.language !== 'javascript')
+                continue;
+            const handler = getHandlerByLanguage(block.language);
+            if (!handler)
+                continue;
+            const tree = await parseFile(block.content, handler);
+            primaryTree = tree;
+            // Extract symbols from this block and shift byte offsets back into the
+            // original file so get-symbol-source returns the correct slice.
+            const rawSymbols = handler.extractSymbols(tree, block.content, relPath);
+            for (const sym of rawSymbols) {
+                blockSymbols.push({
+                    ...sym,
+                    startByte: sym.startByte + block.offsetInOriginal,
+                    endByte: sym.endByte + block.offsetInOriginal,
+                });
+            }
+            // Imports — source paths are relative to the original file location
+            imports.push(...handler.extractImports(tree, block.content).map((imp) => ({
+                ...imp,
+                sourceFile: relPath,
+            })));
+        }
+    }
+    else {
+        // No preProcess — let the normal handler parse, then adapter enriches
+        const handler = getHandler(relPath);
+        if (handler) {
+            const tree = await parseFile(content, handler);
+            primaryTree = tree;
+            blockSymbols = handler.extractSymbols(tree, content, relPath);
+            imports.push(...handler.extractImports(tree, content).map((imp) => ({
+                ...imp,
+                sourceFile: relPath,
+            })));
+        }
+    }
+    // Extract framework-specific symbols (may use tree or derive from file path alone)
+    const frameworkSymbols = adapter.extractFrameworkSymbols(primaryTree, content, relPath);
+    // Merge: framework symbols override block symbols with the same id
+    const merged = new Map();
+    for (const sym of blockSymbols)
+        merged.set(sym.id, sym);
+    for (const sym of frameworkSymbols)
+        merged.set(sym.id, sym);
+    // Return raw merged symbols — processFile runs enrichSymbols after all
+    // adapters' enrichMetadata so Stage 2 has access to the final frameworkMeta.
+    const symbols = Array.from(merged.values());
+    return { symbols, imports };
+}
+//# sourceMappingURL=file-processor.js.map

package/dist/core/file-processor.js.map

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

package/dist/core/hash-cache.d.ts

@@ -0,0 +1,18 @@
+import type Database from 'better-sqlite3';
+export interface HashCache {
+    /** Compute SHA-256 hash of file content. */
+    computeHash(content: Buffer): string;
+    /** Returns true if there is no cached hash for filePath, or if it differs from newHash. */
+    hasChanged(filePath: string, newHash: string): boolean;
+    /** Store a hash in the in-memory cache (does not write to DB). */
+    set(filePath: string, hash: string): void;
+    /** Persist all in-memory hashes to the files table (hash-only, no content). */
+    sync(db: Database.Database, repoId: string): void;
+    /** Hydrate the in-memory cache from the files table. */
+    loadFromDb(db: Database.Database, repoId: string): void;
+    /** Number of entries in the cache. */
+    size(): number;
+}
+export declare function createHashCache(): HashCache;
+export declare function computeHash(content: Buffer): string;
+//# sourceMappingURL=hash-cache.d.ts.map

package/dist/core/hash-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-cache.d.ts","sourceRoot":"","sources":["../../src/core/hash-cache.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C,MAAM,WAAW,SAAS;IACxB,4CAA4C;IAC5C,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,2FAA2F;IAC3F,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACvD,kEAAkE;IAClE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,+EAA+E;IAC/E,IAAI,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,wDAAwD;IACxD,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACxD,sCAAsC;IACtC,IAAI,IAAI,MAAM,CAAC;CAChB;AAED,wBAAgB,eAAe,IAAI,SAAS,CAkC3C;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/core/hash-cache.js

@@ -0,0 +1,35 @@
+import { createHash } from 'crypto';
+import { getAllFileHashes, upsertFile } from './db/file-store.js';
+export function createHashCache() {
+    const cache = new Map();
+    return {
+        computeHash(content) {
+            return createHash('sha256').update(content).digest('hex');
+        },
+        hasChanged(filePath, newHash) {
+            const cached = cache.get(filePath);
+            return cached === undefined || cached !== newHash;
+        },
+        set(filePath, hash) {
+            cache.set(filePath, hash);
+        },
+        sync(db, repoId) {
+            for (const [filePath, hash] of cache) {
+                upsertFile(db, repoId, filePath, hash);
+            }
+        },
+        loadFromDb(db, repoId) {
+            const stored = getAllFileHashes(db, repoId);
+            for (const [filePath, hash] of stored) {
+                cache.set(filePath, hash);
+            }
+        },
+        size() {
+            return cache.size;
+        },
+    };
+}
+export function computeHash(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+//# sourceMappingURL=hash-cache.js.map

package/dist/core/hash-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash-cache.js","sourceRoot":"","sources":["../../src/core/hash-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAmBlE,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IAExC,OAAO;QACL,WAAW,CAAC,OAAe;YACzB,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5D,CAAC;QAED,UAAU,CAAC,QAAgB,EAAE,OAAe;YAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACnC,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,OAAO,CAAC;QACpD,CAAC;QAED,GAAG,CAAC,QAAgB,EAAE,IAAY;YAChC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;QAED,IAAI,CAAC,EAAqB,EAAE,MAAc;YACxC,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;gBACrC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,UAAU,CAAC,EAAqB,EAAE,MAAc;YAC9C,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAC5C,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;gBACtC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,IAAI;YACF,OAAO,KAAK,CAAC,IAAI,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC"}

package/dist/core/index-manager.d.ts

@@ -0,0 +1,18 @@
+import type { IndexOptions, IndexResult } from './types.js';
+/**
+ * Index a folder end-to-end:
+ * discover files → parse → extract symbols + imports → build dep graph → persist.
+ */
+export declare function indexFolder(rootPath: string, options?: IndexOptions): Promise<IndexResult>;
+/**
+ * Re-index a specific set of files (fast path for watcher events).
+ * Handles additions, modifications, and deletions.
+ */
+export declare function reindexFiles(repoId: string, changedPaths: string[], deletedPaths?: string[], options?: Pick<IndexOptions, 'adapters' | 'aiSummarizer' | 'semanticIndexer'>): Promise<IndexResult>;
+/**
+ * Remove the SQLite index file for a repo. No-op if it does not exist.
+ * If the repo was cloned (clonePath is set), also removes the clone directory.
+ */
+export declare function deleteIndex(repoId: string, indexDir?: string): void;
+export { computeRepoId } from './db/schema.js';
+//# sourceMappingURL=index-manager.d.ts.map

package/dist/core/index-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-manager.d.ts","sourceRoot":"","sources":["../../src/core/index-manager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAA8B,MAAM,YAAY,CAAC;AAkCxF;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CA2TtB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EAAE,EACtB,YAAY,GAAE,MAAM,EAAO,EAC3B,OAAO,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,cAAc,GAAG,iBAAiB,CAAC,GAC5E,OAAO,CAAC,WAAW,CAAC,CA+JtB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAwBnE;AAKD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}