purecontext-mcp 1.0.1

package/dist/core/types.d.ts

@@ -0,0 +1,145 @@
+import type { Database } from 'better-sqlite3';
+import type Parser from 'web-tree-sitter';
+export type Tree = Parser.Tree;
+export type SyntaxNode = Parser.SyntaxNode;
+export type SymbolKind = 'function' | 'class' | 'method' | 'const' | 'type' | 'interface' | 'enum' | 'component' | 'composable' | 'hook' | 'route' | 'decorator' | 'middleware' | 'model' | 'view' | 'struct' | 'macro' | 'signal' | 'namespace' | 'widget';
+export interface SymbolRecord {
+    /** Deterministic hash: SHA-256(filePath:name:kind).slice(0, 16) */
+    id: string;
+    name: string;
+    kind: SymbolKind;
+    /** Relative to repo root */
+    filePath: string;
+    startByte: number;
+    endByte: number;
+    /** One-line declaration signature, max 120 chars */
+    signature: string;
+    /** One-line description (from docstring, framework meta, or signature fallback) */
+    summary: string;
+    frameworkMeta?: Record<string, unknown>;
+}
+export interface ImportRecord {
+    sourceFile: string;
+    /** Raw import path as written in source */
+    specifier: string;
+    /** Resolved path relative to repo root, null for external packages */
+    resolvedPath: string | null;
+    importedNames: string[];
+    isTypeOnly: boolean;
+}
+export interface DepEdge {
+    repoId: string;
+    sourceFile: string;
+    sourceSymbolId: string | null;
+    targetFile: string;
+    targetSymbolId: string | null;
+    /** 'import' | 'dynamic-import' | 're-export' */
+    edgeType: string;
+    specifier: string;
+}
+export interface RepoMetadata {
+    id: string;
+    rootPath: string;
+    symbolCount: number;
+    fileCount: number;
+    /** JSON-serialized string[] */
+    languages: string[];
+    indexedAt: number;
+    schemaVersion: number;
+    /** Path to the cloned repo directory, null for locally-indexed repos. */
+    clonePath: string | null;
+    /** Owning tenant. Defaults to 'local' for single-tenant deployments. */
+    tenantId?: string;
+}
+export interface AISummarizerService {
+    summarizeBatch(symbols: SymbolRecord[]): Promise<Map<string, string>>;
+}
+export interface IndexOptions {
+    fileLimit?: number;
+    excludePatterns?: string[];
+    watch?: boolean;
+    watchDebounceMs?: number;
+    /** Active framework adapters to apply during indexing. */
+    adapters?: FrameworkAdapter[];
+    /**
+     * Optional AI summarizer for Stage 3 summaries. When provided, symbols
+     * whose summaries are still the signature fallback after Stage 1/2 are
+     * sent to the AI for a human-readable one-line description.
+     */
+    aiSummarizer?: AISummarizerService;
+    /**
+     * Path to the cloned repo directory. Set when indexing a remote repo
+     * cloned by index_repo. Stored in the DB so deleteIndex can clean it up.
+     */
+    clonePath?: string;
+    /**
+     * Optional semantic indexer for Phase 11 HNSW embedding.
+     * When provided, triggers semantic indexing after symbol extraction
+     * if the repo meets the configured threshold.
+     */
+    semanticIndexer?: import('../semantic/semantic-indexer.js').SemanticIndexer;
+    /**
+     * Number of worker threads for parallel file parsing.
+     * Default: min(cpuCount, 8). Set to 1 to disable (sequential mode).
+     */
+    concurrency?: number;
+    /** Tenant/workspace ID to associate with this index operation. Defaults to 'local'. */
+    tenantId?: string;
+    /** Workspace plan — used to enforce free-tier limits. */
+    workspacePlan?: 'free' | 'team' | 'enterprise';
+    /** Current repo count for this workspace — used to enforce free-tier repo limit. */
+    workspaceRepoCount?: number;
+}
+export interface IndexResult {
+    repoId: string;
+    filesIndexed: number;
+    filesSkipped: number;
+    symbolsFound: number;
+    totalSymbolsInDb: number;
+    totalFilesInDb: number;
+    edgesFound: number;
+    durationMs: number;
+    errors: Array<{
+        file: string;
+        message: string;
+    }>;
+    /** Non-fatal issues that affect completeness (limit reached, parse errors, etc.). */
+    warnings: string[];
+}
+export interface DiscoveredFile {
+    path: string;
+    size: number;
+    priority: number;
+}
+export interface LanguageHandler {
+    extensions(): string[];
+    /** Absolute path to the .wasm grammar file. filePath hint allows per-extension grammar selection (e.g. .tsx vs .ts). */
+    grammarPath(filePath?: string): string;
+    extractSymbols(tree: Tree, source: Buffer, filePath: string): SymbolRecord[];
+    extractImports(tree: Tree, source: Buffer): ImportRecord[];
+    extractDocstring(node: SyntaxNode): string | null;
+}
+export interface ProcessedBlock {
+    content: Buffer;
+    /** 'typescript' | 'javascript' | 'html' | 'css' */
+    language: string;
+    /** Byte offset where this block starts in the original file */
+    offsetInOriginal: number;
+}
+export interface FrameworkAdapter {
+    name: string;
+    /** Additional file extensions this adapter handles (e.g. ['.vue']). Used by file discovery. */
+    extensions(): string[];
+    detect(projectRoot: string): Promise<boolean>;
+    fileFilter(filePath: string): boolean;
+    preProcess?(source: Buffer, filePath: string): ProcessedBlock[];
+    /** tree is null when there is no parseable script block (e.g. template-only .vue files). */
+    extractFrameworkSymbols(tree: Tree | null, source: Buffer, filePath: string): SymbolRecord[];
+    enrichMetadata?(symbol: SymbolRecord): SymbolRecord;
+}
+export interface Services {
+    db: Database;
+    repoId: string;
+    rootPath: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,18 @@
+export interface WatchOptions {
+    debounceMs?: number;
+}
+export interface FileWatcher {
+    /** Resolves once chokidar has finished its initial scan and is ready to receive events. */
+    ready: Promise<void>;
+    /** Stop watching and clean up the chokidar instance. */
+    stop(): Promise<void>;
+}
+/**
+ * Start watching `rootPath` for changes. When files are added, modified, or
+ * deleted, the relevant paths are batched during the debounce window and then
+ * flushed to `reindexFiles`.
+ *
+ * Only files with a registered language handler extension are considered.
+ */
+export declare function startWatching(rootPath: string, repoId: string, options?: WatchOptions): FileWatcher;
+//# sourceMappingURL=file-watcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../../src/core/watcher/file-watcher.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,2FAA2F;IAC3F,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,wDAAwD;IACxD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAoBD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,YAAiB,GACzB,WAAW,CA8Gb"}

package/dist/core/watcher/file-watcher.js

@@ -0,0 +1,123 @@
+import { watch as chokidarWatch } from 'chokidar';
+import { relative, resolve } from 'path';
+import { logger } from '../logger.js';
+import { reindexFiles } from '../index-manager.js';
+import { getSupportedExtensions } from '../../handlers/handler-registry.js';
+// ─── Default ignore patterns ──────────────────────────────────────────────────
+const IGNORE_PATTERNS = [
+    /(^|[/\\])\../, // dotfiles / dotdirs
+    /node_modules/,
+    /[/\\]\.git([/\\]|$)/,
+    /[/\\]dist([/\\]|$)/,
+    /[/\\]build([/\\]|$)/,
+    /[/\\]\.claude([/\\]|$)/,
+    /[/\\]coverage([/\\]|$)/,
+    /\.lock$/,
+    /\.log$/,
+];
+const DEFAULT_DEBOUNCE_MS = 2000;
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Start watching `rootPath` for changes. When files are added, modified, or
+ * deleted, the relevant paths are batched during the debounce window and then
+ * flushed to `reindexFiles`.
+ *
+ * Only files with a registered language handler extension are considered.
+ */
+export function startWatching(rootPath, repoId, options = {}) {
+    const absRoot = resolve(rootPath);
+    const debounceMs = options.debounceMs ?? DEFAULT_DEBOUNCE_MS;
+    const supportedExts = new Set(getSupportedExtensions());
+    // Batches of paths accumulated during the debounce window
+    const changed = new Set();
+    const deleted = new Set();
+    let timer = null;
+    function hasHandler(filePath) {
+        const dot = filePath.lastIndexOf('.');
+        const ext = dot >= 0 ? filePath.slice(dot) : '';
+        return supportedExts.has(ext);
+    }
+    function schedule() {
+        if (timer)
+            clearTimeout(timer);
+        timer = setTimeout(flush, debounceMs);
+    }
+    async function flush() {
+        timer = null;
+        const changedPaths = [...changed];
+        const deletedPaths = [...deleted];
+        changed.clear();
+        deleted.clear();
+        if (changedPaths.length === 0 && deletedPaths.length === 0)
+            return;
+        logger.info(`Watcher: flushing ${changedPaths.length} changed, ` +
+            `${deletedPaths.length} deleted in repo ${repoId}`);
+        try {
+            const result = await reindexFiles(repoId, changedPaths, deletedPaths);
+            logger.info(`Watcher reindex complete: ${result.filesIndexed} files, ` +
+                `${result.symbolsFound} symbols in ${result.durationMs}ms`);
+            if (result.errors.length > 0) {
+                for (const e of result.errors) {
+                    logger.warn(`Watcher reindex error in ${e.file}: ${e.message}`);
+                }
+            }
+        }
+        catch (err) {
+            logger.error(`Watcher reindex failed: ${err}`);
+        }
+    }
+    const watcher = chokidarWatch(absRoot, {
+        ignored: IGNORE_PATTERNS,
+        persistent: true,
+        ignoreInitial: true, // Don't fire for files already on disk at startup
+        awaitWriteFinish: {
+            stabilityThreshold: 100,
+            pollInterval: 50,
+        },
+    });
+    const readyPromise = new Promise((resolve) => {
+        watcher.once('ready', resolve);
+    });
+    watcher.on('add', (absPath) => {
+        const rel = relative(absRoot, absPath).replace(/\\/g, '/');
+        if (!hasHandler(rel))
+            return;
+        logger.debug(`Watcher: add ${rel}`);
+        changed.add(rel);
+        deleted.delete(rel); // no longer deleted if re-added
+        schedule();
+    });
+    watcher.on('change', (absPath) => {
+        const rel = relative(absRoot, absPath).replace(/\\/g, '/');
+        if (!hasHandler(rel))
+            return;
+        logger.debug(`Watcher: change ${rel}`);
+        changed.add(rel);
+        schedule();
+    });
+    watcher.on('unlink', (absPath) => {
+        const rel = relative(absRoot, absPath).replace(/\\/g, '/');
+        if (!hasHandler(rel))
+            return;
+        logger.debug(`Watcher: unlink ${rel}`);
+        deleted.add(rel);
+        changed.delete(rel); // don't try to re-index a deleted file
+        schedule();
+    });
+    watcher.on('error', (err) => {
+        logger.error(`Watcher error: ${err}`);
+    });
+    logger.info(`Watching ${absRoot} (repo ${repoId}, debounce ${debounceMs}ms)`);
+    return {
+        ready: readyPromise,
+        async stop() {
+            if (timer) {
+                clearTimeout(timer);
+                timer = null;
+            }
+            await watcher.close();
+            logger.info(`Watcher stopped for ${absRoot}`);
+        },
+    };
+}
+//# sourceMappingURL=file-watcher.js.map

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

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

package/dist/core/worker-pool.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Worker thread pool for parallel file parsing.
+ *
+ * Creates `concurrency` Worker instances each running indexing-worker.ts.
+ * A job queue feeds idle workers. All results are collected and returned in
+ * input order once every job has completed.
+ *
+ * Environment detection:
+ *   - Compiled (.js): worker runs as plain JS — no loader needed.
+ *   - Source (.ts, vitest/dev): worker runs through tsx for TS transpilation.
+ */
+import type { ParseJob, ParseResult } from './indexing-worker.js';
+export type { ParseJob, ParseResult };
+export interface WorkerPool {
+    /**
+     * Run all jobs in parallel across the pool.
+     * Returns results in the same order as the input jobs array.
+     */
+    run(jobs: ParseJob[]): Promise<ParseResult[]>;
+    /** Terminate all worker threads. */
+    terminate(): Promise<void>;
+}
+export declare function createWorkerPool(concurrency: number): WorkerPool;
+//# sourceMappingURL=worker-pool.d.ts.map

package/dist/core/worker-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-pool.d.ts","sourceRoot":"","sources":["../../src/core/worker-pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIlE,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AAoBtC,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9C,oCAAoC;IACpC,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAqEhE"}

package/dist/core/worker-pool.js

@@ -0,0 +1,92 @@
+/**
+ * Worker thread pool for parallel file parsing.
+ *
+ * Creates `concurrency` Worker instances each running indexing-worker.ts.
+ * A job queue feeds idle workers. All results are collected and returned in
+ * input order once every job has completed.
+ *
+ * Environment detection:
+ *   - Compiled (.js): worker runs as plain JS — no loader needed.
+ *   - Source (.ts, vitest/dev): worker runs through tsx for TS transpilation.
+ */
+import { Worker } from 'worker_threads';
+import { fileURLToPath } from 'url';
+import { logger } from './logger.js';
+// ─── Worker factory ───────────────────────────────────────────────────────────
+// True when running from compiled dist/ output (not TypeScript source).
+const IS_COMPILED = import.meta.url.endsWith('.js');
+function spawnWorker() {
+    if (IS_COMPILED) {
+        // In dist/, worker lives beside this file as a compiled .js module.
+        return new Worker(fileURLToPath(new URL('./indexing-worker.js', import.meta.url)));
+    }
+    // Development / test: use the plain-JS bootstrap which loads the TypeScript
+    // worker via tsx's programmatic tsImport API (no --loader or --import flag
+    // needed — avoids Windows path issues with Node.js --import handling).
+    return new Worker(fileURLToPath(new URL('./indexing-worker-boot.mjs', import.meta.url)));
+}
+export function createWorkerPool(concurrency) {
+    const workers = Array.from({ length: concurrency }, () => spawnWorker());
+    // Log any uncaught worker errors at the pool level.
+    for (const w of workers) {
+        w.on('error', (err) => logger.warn(`Worker uncaught error: ${err.message}`));
+    }
+    return {
+        async run(jobs) {
+            if (jobs.length === 0)
+                return [];
+            const results = new Array(jobs.length);
+            // queue entries: [original index, job]
+            const queue = jobs.map((j, i) => [i, j]);
+            let pending = jobs.length;
+            return new Promise((resolve) => {
+                function dispatch(worker) {
+                    const next = queue.shift();
+                    if (!next)
+                        return; // No more jobs for this worker.
+                    const [jobIndex, job] = next;
+                    const onMessage = (result) => {
+                        worker.off('message', onMessage);
+                        worker.off('error', onWorkerError);
+                        results[jobIndex] = result;
+                        if (--pending === 0) {
+                            resolve(results);
+                        }
+                        else {
+                            dispatch(worker);
+                        }
+                    };
+                    const onWorkerError = (err) => {
+                        worker.off('message', onMessage);
+                        worker.off('error', onWorkerError);
+                        results[jobIndex] = {
+                            relPath: job.relPath,
+                            symbols: [],
+                            imports: [],
+                            error: `Worker error: ${err.message}`,
+                        };
+                        if (--pending === 0) {
+                            resolve(results);
+                        }
+                        else {
+                            dispatch(worker);
+                        }
+                    };
+                    worker.once('message', onMessage);
+                    worker.once('error', onWorkerError);
+                    worker.postMessage(job);
+                }
+                // Seed all workers — each picks up its first job.
+                for (const worker of workers) {
+                    if (queue.length > 0) {
+                        dispatch(worker);
+                    }
+                }
+            });
+        },
+        async terminate() {
+            await Promise.all(workers.map((w) => w.terminate()));
+        },
+    };
+}
+//# sourceMappingURL=worker-pool.js.map

package/dist/core/worker-pool.js.map

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

package/dist/graph/graph-builder.d.ts

@@ -0,0 +1,16 @@
+import type { ImportRecord, DepEdge } from '../core/types.js';
+import type { PathResolver } from './path-resolver.js';
+/**
+ * Convert a batch of ImportRecords into DepEdges.
+ *
+ * Each ImportRecord may or may not have `resolvedPath` pre-filled; if it is
+ * null the resolver is called to fill it. Records that resolve to external
+ * packages (null resolvedPath) are silently dropped — they don't belong in
+ * the in-project dependency graph.
+ *
+ * Phase 1 emits one file-level edge per unique (sourceFile, targetFile) pair.
+ * Symbol-level edge population is deferred to Phase 2 when we have a DB
+ * handle available during incremental reindexing.
+ */
+export declare function buildGraph(imports: ImportRecord[], resolver: PathResolver, repoId: string): DepEdge[];
+//# sourceMappingURL=graph-builder.d.ts.map

package/dist/graph/graph-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-builder.d.ts","sourceRoot":"","sources":["../../src/graph/graph-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,YAAY,EAAE,EACvB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,EAAE,CAgCX"}

package/dist/graph/graph-builder.js

@@ -0,0 +1,51 @@
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Convert a batch of ImportRecords into DepEdges.
+ *
+ * Each ImportRecord may or may not have `resolvedPath` pre-filled; if it is
+ * null the resolver is called to fill it. Records that resolve to external
+ * packages (null resolvedPath) are silently dropped — they don't belong in
+ * the in-project dependency graph.
+ *
+ * Phase 1 emits one file-level edge per unique (sourceFile, targetFile) pair.
+ * Symbol-level edge population is deferred to Phase 2 when we have a DB
+ * handle available during incremental reindexing.
+ */
+export function buildGraph(imports, resolver, repoId) {
+    // Deduplicate by (sourceFile, targetFile) to avoid flooding the dep table
+    // with one row per named import specifier from the same module.
+    const seen = new Set();
+    const edges = [];
+    for (const rec of imports) {
+        if (!rec.sourceFile)
+            continue; // guard against unfilled sourceFile
+        // Resolve the path if the handler left it null
+        const targetFile = rec.resolvedPath ??
+            resolver.resolve(rec.specifier, rec.sourceFile);
+        if (targetFile === null)
+            continue; // external package — skip
+        const key = `${rec.sourceFile}\0${targetFile}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        edges.push({
+            repoId,
+            sourceFile: rec.sourceFile,
+            sourceSymbolId: null,
+            targetFile,
+            targetSymbolId: null,
+            edgeType: detectEdgeType(rec),
+            specifier: rec.specifier,
+        });
+    }
+    return edges;
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function detectEdgeType(rec) {
+    // re-exports: `export { foo } from './foo'` — importedNames contains
+    // re-exported names. We can't distinguish this from a regular named import
+    // at the ImportRecord level in Phase 1, so everything is 'import'.
+    void rec;
+    return 'import';
+}
+//# sourceMappingURL=graph-builder.js.map

package/dist/graph/graph-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-builder.js","sourceRoot":"","sources":["../../src/graph/graph-builder.ts"],"names":[],"mappings":"AAGA,iFAAiF;AAEjF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CACxB,OAAuB,EACvB,QAAsB,EACtB,MAAc;IAEd,0EAA0E;IAC1E,gEAAgE;IAChE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,KAAK,GAAc,EAAE,CAAC;IAE5B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,UAAU;YAAE,SAAS,CAAC,oCAAoC;QAEnE,+CAA+C;QAC/C,MAAM,UAAU,GACd,GAAG,CAAC,YAAY;YAChB,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;QAElD,IAAI,UAAU,KAAK,IAAI;YAAE,SAAS,CAAC,0BAA0B;QAE7D,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC/C,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEd,KAAK,CAAC,IAAI,CAAC;YACT,MAAM;YACN,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,cAAc,EAAE,IAAI;YACpB,UAAU;YACV,cAAc,EAAE,IAAI;YACpB,QAAQ,EAAE,cAAc,CAAC,GAAG,CAAC;YAC7B,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iFAAiF;AAEjF,SAAS,cAAc,CAAC,GAAiB;IACvC,qEAAqE;IACrE,2EAA2E;IAC3E,mEAAmE;IACnE,KAAK,GAAG,CAAC;IACT,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/graph/graph-traversal.d.ts

@@ -0,0 +1,57 @@
+import type Database from 'better-sqlite3';
+import type { SymbolRecord } from '../core/types.js';
+export interface TraversalResult {
+    symbols: SymbolRecord[];
+    /** Distinct files included in this result. */
+    files: string[];
+    /** Rough token estimate (sum of signature + summary lengths ÷ 4). */
+    tokenEstimate: number;
+}
+export interface ImporterInfo {
+    file: string;
+    symbols: SymbolRecord[];
+}
+/**
+ * Reverse-walk the dependency graph from a symbol outward.
+ * Returns all symbols in files that (transitively) depend on the symbol's file,
+ * up to `depth` hops. Useful for assessing blast radius of a change.
+ */
+export declare function getBlastRadius(symbolId: string, repoId: string, db: Database.Database, depth?: number): TraversalResult;
+/**
+ * Forward-walk the dependency graph from a symbol's file.
+ * Returns the symbol itself plus all symbols in transitively imported files,
+ * up to `depth` hops. Useful for gathering context needed to understand a symbol.
+ */
+export declare function getContextBundle(symbolId: string, repoId: string, db: Database.Database, depth?: number): TraversalResult;
+/**
+ * Return distinct files that import `filePath`, along with the symbols
+ * defined in each importing file.
+ */
+export declare function findImporters(filePath: string, repoId: string, db: Database.Database): ImporterInfo[];
+/**
+ * Symbols in files that are never imported by any other file in the repo.
+ * Delegates to the dep-store query.
+ */
+export declare function findDeadCode(repoId: string, db: Database.Database): SymbolRecord[];
+export interface BlastRadiusEntry {
+    filePath: string;
+    depth: number;
+    symbolCount: number;
+    symbols: Pick<SymbolRecord, 'id' | 'name' | 'kind' | 'signature' | 'summary'>[];
+}
+export interface BlastRadiusWithDepths {
+    symbolId: string;
+    symbolName: string;
+    symbolKind: string;
+    sourceFile: string;
+    totalFiles: number;
+    totalSymbols: number;
+    entries: BlastRadiusEntry[];
+}
+/**
+ * Reverse-walk the dependency graph from a symbol, returning each affected file
+ * annotated with its hop distance from the source. Used by the web UI radial
+ * blast radius visualization.
+ */
+export declare function getBlastRadiusWithDepths(symbolId: string, repoId: string, db: Database.Database, maxDepth?: number): BlastRadiusWithDepths | null;
+//# sourceMappingURL=graph-traversal.d.ts.map

package/dist/graph/graph-traversal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-traversal.d.ts","sourceRoot":"","sources":["../../src/graph/graph-traversal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAMrD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,qEAAqE;IACrE,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAID;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,SAAI,GACR,eAAe,CAQjB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,SAAI,GACR,eAAe,CAQjB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,QAAQ,CAAC,QAAQ,GACpB,YAAY,EAAE,CAMhB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,QAAQ,CAAC,QAAQ,GACpB,YAAY,EAAE,CAEhB;AAoED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC,EAAE,CAAC;CACjF;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,SAAI,GACX,qBAAqB,GAAG,IAAI,CAkD9B"}