@jafreck/lore 0.1.0

package/dist/cli.js

@@ -0,0 +1,345 @@
+#!/usr/bin/env node
+/**
+ * @module cli
+ *
+ * Lore CLI — unified entry point for indexing and the MCP server.
+ *
+ * Usage:
+ *   lore index --root <dir> --db <path> [--embedding-model <id>]
+ *                              Index a codebase into a knowledge-base file.
+ *   lore mcp --db <path>                        Start the knowledge-base MCP server (stdio transport).
+ *   lore refresh --db <path> --root <dir>       Run an incremental index update and exit.
+ *   lore refresh --db <path> --root <dir> --watch  Watch for changes and refresh automatically.
+ *   lore refresh --db <path> --root <dir> --poll   Poll for changes and refresh automatically.
+ *   lore hooks --root <dir> --db <path>         Install git hooks for automatic Lore refresh.
+ *   lore ingest-coverage --db <path> --root <dir> --file <path> --format <lcov|cobertura>
+ *                         Ingest a coverage report file into the knowledge base.
+ */
+import * as fs from 'node:fs';
+// ─── Argument helpers ─────────────────────────────────────────────────────────
+function usage() {
+    console.error(`Usage:
+  lore index --root <dir> --db <path> [--embedding-model <id>] [--history] [--history-depth <n>] [--history-all]
+                         Index a codebase into a knowledge-base SQLite file
+  lore mcp --db <path>                          Start the KB MCP server (stdio transport)
+  lore refresh --db <path> --root <dir> [--history] [--history-depth <n>] [--history-all]  Run an incremental index update and exit
+  lore refresh --db <path> --root <dir> --watch Watch for file changes and refresh automatically
+  lore refresh --db <path> --root <dir> --poll  Poll for file changes and refresh automatically
+  lore hooks --db <path> --root <dir> [--history] [--history-depth <n>] [--history-all]
+                         Install git hooks for automatic refresh on commit/merge/checkout
+  lore ingest-coverage --db <path> --root <dir> --file <path> --format <lcov|cobertura> [--commit <sha>]
+                         Ingest an explicit coverage report file into the knowledge base
+
+Options:
+  --root <dir>             Root directory to index (required for index, refresh)
+  --db <path>              Path to a Lore knowledge-base SQLite file (required for index, mcp, refresh)
+  --embedding-model <id>   Embedding model identifier (default: Qwen/Qwen3-Embedding-4B)
+  --history                Enable git history ingestion
+  --history-depth <n>      Limit commit ingestion to the most recent N commits
+  --history-all            Traverse all refs (branches/tags) for history ingestion
+  --include <glob>         Glob pattern for files to include (repeatable)
+  --exclude <glob>         Glob pattern for paths to exclude (repeatable)
+  --language <lang>        Language name to filter by, e.g. typescript (repeatable)
+  --watch                  Enable fs-event watch mode (low-latency, may miss events on some platforms)
+  --poll                   Enable polling mode (reliable but higher CPU/IO cost)
+  --file <path>            Coverage report path (required for ingest-coverage)
+  --format <name>          Coverage format: lcov or cobertura (required for ingest-coverage)
+  --commit <sha>           Commit SHA to associate with coverage ingestion (default: HEAD)
+  --help, -h               Show this help message`);
+    process.exit(1);
+}
+function flag(args, name) {
+    const idx = args.indexOf(name);
+    if (idx === -1)
+        return undefined;
+    return args[idx + 1];
+}
+/** Returns all values provided for a repeatable flag (e.g. --include a --include b → ['a', 'b']). */
+function flags(args, name) {
+    const results = [];
+    for (let i = 0; i < args.length - 1; i++) {
+        if (args[i] === name)
+            results.push(args[i + 1]);
+    }
+    return results;
+}
+// ─── Main ─────────────────────────────────────────────────────────────────────
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes('--help') || args.includes('-h') || args.length === 0) {
+        usage();
+        return;
+    }
+    const subcommand = args[0];
+    if (subcommand === 'index') {
+        const rootDir = flag(args, '--root');
+        const dbPath = flag(args, '--db');
+        if (!rootDir) {
+            console.error('Error: --root <dir> is required for the index subcommand.\n');
+            usage();
+            return;
+        }
+        if (!dbPath) {
+            console.error('Error: --db <path> is required for the index subcommand.\n');
+            usage();
+            return;
+        }
+        const embeddingModel = flag(args, '--embedding-model');
+        const historyEnabled = args.includes('--history');
+        const historyAll = args.includes('--history-all');
+        const historyDepthRaw = flag(args, '--history-depth');
+        let historyDepth;
+        if (historyDepthRaw !== undefined) {
+            const parsed = Number(historyDepthRaw);
+            if (!Number.isFinite(parsed) || parsed <= 0) {
+                console.error('Error: --history-depth must be a positive number.\n');
+                usage();
+                return;
+            }
+            historyDepth = Math.floor(parsed);
+        }
+        const includeGlobs = flags(args, '--include');
+        const excludeGlobs = flags(args, '--exclude');
+        const languageNames = flags(args, '--language');
+        // Static reverse map: language name → extensions (mirrors EXT_TO_LANG in walker.ts)
+        const LANG_TO_EXTS = {
+            c: ['.c', '.h'],
+            rust: ['.rs'],
+            python: ['.py'],
+            cpp: ['.cpp', '.cc', '.cxx', '.hpp', '.hxx'],
+            typescript: ['.ts', '.tsx'],
+            javascript: ['.js', '.jsx', '.mjs', '.cjs'],
+            go: ['.go'],
+            java: ['.java'],
+            csharp: ['.cs'],
+            ruby: ['.rb'],
+            php: ['.php'],
+            swift: ['.swift'],
+            kotlin: ['.kt', '.kts'],
+            scala: ['.scala', '.sc'],
+            lua: ['.lua'],
+            bash: ['.sh', '.bash', '.zsh'],
+            elixir: ['.ex', '.exs'],
+            zig: ['.zig'],
+            dart: ['.dart'],
+            ocaml: ['.ml', '.mli'],
+            haskell: ['.hs'],
+            julia: ['.jl'],
+            elm: ['.elm'],
+            objc: ['.m', '.mm'],
+        };
+        // Resolve --language names to extensions
+        let extensions;
+        if (languageNames.length > 0) {
+            extensions = [];
+            for (const lang of languageNames) {
+                const exts = LANG_TO_EXTS[lang];
+                if (!exts) {
+                    console.error(`Error: unknown language "${lang}". Known languages: ${Object.keys(LANG_TO_EXTS).sort().join(', ')}\n`);
+                    process.exit(1);
+                    return;
+                }
+                extensions.push(...exts);
+            }
+        }
+        const { IndexBuilder } = await import('./indexer/index.js');
+        const shouldEnableHistory = historyEnabled || historyAll || historyDepth !== undefined;
+        const options = {
+            ...(embeddingModel && { embeddingModel }),
+            ...(shouldEnableHistory && {
+                history: {
+                    ...(historyDepth !== undefined && { depth: historyDepth }),
+                    ...(historyAll && { all: true }),
+                },
+            }),
+        };
+        const builder = new IndexBuilder(dbPath, {
+            rootDir,
+            ...(includeGlobs.length > 0 && { includeGlobs }),
+            ...(excludeGlobs.length > 0 && { excludeGlobs }),
+            ...(extensions && { extensions }),
+        }, undefined, Object.keys(options).length > 0 ? options : undefined);
+        await builder.build();
+    }
+    else if (subcommand === 'mcp') {
+        const dbPath = flag(args, '--db');
+        if (!dbPath) {
+            console.error('Error: --db <path> is required for the mcp subcommand.\n');
+            usage();
+            return;
+        }
+        // Dynamically import so tree-shaking keeps the MCP server out of the
+        // library entry point for consumers who only need the indexer.
+        const { McpServer } = await import('@modelcontextprotocol/sdk/server/mcp.js');
+        const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
+        const { openReadOnly } = await import('./kb-server/db.js');
+        const { createKbMcpServer } = await import('./kb-server/server.js');
+        const { getKbMeta } = await import('./indexer/db.js');
+        const { SentenceTransformersProvider, } = await import('./indexer/embedder.js');
+        const db = openReadOnly(dbPath);
+        // Build optional embedder from model recorded at index time.
+        let embedder;
+        const modelName = getKbMeta(db, 'embedding_model');
+        if (modelName) {
+            const provider = new SentenceTransformersProvider(modelName);
+            try {
+                await provider.init();
+                embedder = provider;
+            }
+            catch {
+                try {
+                    await provider.dispose();
+                }
+                catch {
+                    /* ignore */
+                }
+            }
+        }
+        const server = createKbMcpServer(db, dbPath, embedder);
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        // Signal readiness on stderr so parent processes can detect it.
+        process.stderr.write('READY\n');
+    }
+    else if (subcommand === 'refresh') {
+        const dbPath = flag(args, '--db');
+        const rootDir = flag(args, '--root');
+        if (!dbPath || !rootDir) {
+            console.error('Error: --db <path> and --root <dir> are required for the refresh subcommand.\n');
+            usage();
+            return;
+        }
+        const watchMode = args.includes('--watch');
+        const pollMode = args.includes('--poll');
+        const historyEnabled = args.includes('--history');
+        const historyAll = args.includes('--history-all');
+        const historyDepthRaw = flag(args, '--history-depth');
+        let historyDepth;
+        if (historyDepthRaw !== undefined) {
+            const parsed = Number(historyDepthRaw);
+            if (!Number.isFinite(parsed) || parsed <= 0) {
+                console.error('Error: --history-depth must be a positive number.\n');
+                usage();
+                return;
+            }
+            historyDepth = Math.floor(parsed);
+        }
+        const shouldEnableHistory = historyEnabled || historyAll || historyDepth !== undefined;
+        const historyOption = shouldEnableHistory
+            ? {
+                ...(historyDepth !== undefined && { depth: historyDepth }),
+                ...(historyAll && { all: true }),
+            }
+            : false;
+        const walkerConfig = { rootDir };
+        if (watchMode) {
+            const { FileWatcher } = await import('./indexer/watcher.js');
+            const watcher = new FileWatcher(dbPath, walkerConfig, {
+                history: historyOption,
+            });
+            watcher.start();
+            process.stderr.write(JSON.stringify({ level: 'info', source: 'cli', message: 'watch mode started', rootDir }) + '\n');
+            // Keep the process alive until interrupted
+            process.on('SIGINT', () => { watcher.stop(); process.exit(0); });
+            process.on('SIGTERM', () => { watcher.stop(); process.exit(0); });
+        }
+        else if (pollMode) {
+            const { FilePoller } = await import('./indexer/poller.js');
+            const poller = new FilePoller(dbPath, walkerConfig, {
+                history: historyOption,
+            });
+            poller.start();
+            process.stderr.write(JSON.stringify({ level: 'info', source: 'cli', message: 'poll mode started', rootDir }) + '\n');
+            // Keep the process alive until interrupted
+            process.on('SIGINT', () => { poller.stop(); process.exit(0); });
+            process.on('SIGTERM', () => { poller.stop(); process.exit(0); });
+        }
+        else {
+            // Manual refresh: full build if DB doesn't exist yet, otherwise incremental update
+            const { IndexBuilder } = await import('./indexer/index.js');
+            const builder = new IndexBuilder(dbPath, walkerConfig, undefined, {
+                ...(shouldEnableHistory && { history: historyOption }),
+            });
+            const dbExists = fs.existsSync(dbPath);
+            if (dbExists) {
+                const [{ openDb }, { walkFiles }] = await Promise.all([
+                    import('./indexer/db.js'),
+                    import('./indexer/walker.js'),
+                ]);
+                const files = await walkFiles(walkerConfig);
+                const db = openDb(dbPath);
+                const branch = 'HEAD';
+                let indexedPaths;
+                try {
+                    indexedPaths = db.prepare('SELECT path FROM files WHERE branch = ?').all(branch).map((row) => row.path);
+                }
+                finally {
+                    db.close();
+                }
+                const changedPaths = [...new Set([...files.map(f => f.path), ...indexedPaths])];
+                await builder.update(changedPaths);
+            }
+            else {
+                await builder.build();
+            }
+            process.stderr.write(JSON.stringify({ level: 'info', source: 'cli', message: 'refresh complete', rootDir }) + '\n');
+        }
+    }
+    else if (subcommand === 'hooks') {
+        const dbPath = flag(args, '--db');
+        const rootDir = flag(args, '--root');
+        if (!dbPath || !rootDir) {
+            console.error('Error: --db <path> and --root <dir> are required for the hooks subcommand.\n');
+            usage();
+            return;
+        }
+        const historyEnabled = args.includes('--history');
+        const historyAll = args.includes('--history-all');
+        const historyDepthRaw = flag(args, '--history-depth');
+        const includeHistory = historyEnabled || historyAll || historyDepthRaw !== undefined;
+        const { installGitHooks } = await import('./indexer/git-hooks.js');
+        const result = installGitHooks({
+            repoRoot: rootDir,
+            rootDir,
+            dbPath,
+            includeHistory,
+        });
+        process.stderr.write(JSON.stringify({
+            level: 'info',
+            source: 'cli',
+            message: 'git hooks installed',
+            rootDir,
+            hooks: result.installed,
+        }) + '\n');
+    }
+    else if (subcommand === 'ingest-coverage') {
+        const dbPath = flag(args, '--db');
+        const rootDir = flag(args, '--root');
+        const reportPath = flag(args, '--file');
+        const format = flag(args, '--format');
+        const commitSha = flag(args, '--commit');
+        if (!dbPath || !rootDir || !reportPath || !format) {
+            console.error('Error: --db <path>, --root <dir>, --file <path>, and --format <lcov|cobertura> are required for the ingest-coverage subcommand.\n');
+            usage();
+            return;
+        }
+        if (format !== 'lcov' && format !== 'cobertura') {
+            console.error(`Error: unsupported coverage format "${format}". Use "lcov" or "cobertura".\n`);
+            usage();
+            return;
+        }
+        const { IndexBuilder } = await import('./indexer/index.js');
+        const builder = new IndexBuilder(dbPath, { rootDir });
+        await builder.ingestCoverage(reportPath, format, commitSha);
+    }
+    else {
+        console.error(`Unknown subcommand: ${subcommand}\n`);
+        usage();
+        return;
+    }
+}
+main().catch((err) => {
+    console.error('lore: fatal error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export { IndexBuilder } from './indexer/index.js';
+export { openDb, setKbMeta, getKbMeta, createVec0Tables } from './indexer/db.js';
+export type { Database } from './indexer/db.js';
+export { buildCallGraph, topoSort, detectCycles } from './indexer/call-graph.js';
+export { walkFiles, detectLanguageForPath } from './indexer/walker.js';
+export type { WalkerConfig, FileEntry } from './indexer/walker.js';
+export { ImportResolver } from './indexer/resolver.js';
+export { ParserPool } from './indexer/parser.js';
+export { ensurePythonDeps } from './indexer/ensure-python-deps.js';
+export { installGitHooks } from './indexer/git-hooks.js';
+export type { InstallGitHooksOptions } from './indexer/git-hooks.js';
+export { SentenceTransformersProvider, Qwen3EmbeddingProvider, DEFAULT_EMBEDDING_MODEL } from './indexer/embedder.js';
+export type { EmbeddingProvider } from './indexer/embedder.js';
+export type { ExtractionResult, RawCallRef, RawImport, RawSymbol, SymbolExtractor, } from './indexer/extractors/types.js';
+export { FileWatcher } from './indexer/watcher.js';
+export type { WatcherOptions } from './indexer/watcher.js';
+export { FilePoller } from './indexer/poller.js';
+export type { PollerOptions } from './indexer/poller.js';
+export { createKbMcpServer } from './kb-server/server.js';
+export { openReadOnly, getSymbolById, getSymbolsByName, listSymbols, getFileById, getFileByPath, listFiles, } from './kb-server/db.js';
+export type { SymbolRow, FileRow } from './kb-server/db.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACjF,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACvE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACtH,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,SAAS,EACT,SAAS,EACT,eAAe,GAChB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,aAAa,EACb,SAAS,GACV,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+export { IndexBuilder } from './indexer/index.js';
+export { openDb, setKbMeta, getKbMeta, createVec0Tables } from './indexer/db.js';
+export { buildCallGraph, topoSort, detectCycles } from './indexer/call-graph.js';
+export { walkFiles, detectLanguageForPath } from './indexer/walker.js';
+export { ImportResolver } from './indexer/resolver.js';
+export { ParserPool } from './indexer/parser.js';
+export { ensurePythonDeps } from './indexer/ensure-python-deps.js';
+export { installGitHooks } from './indexer/git-hooks.js';
+export { SentenceTransformersProvider, Qwen3EmbeddingProvider, DEFAULT_EMBEDDING_MODEL } from './indexer/embedder.js';
+// ── File watcher / poller ─────────────────────────────────────────────────────
+export { FileWatcher } from './indexer/watcher.js';
+export { FilePoller } from './indexer/poller.js';
+// ── MCP server ────────────────────────────────────────────────────────────────
+export { createKbMcpServer } from './kb-server/server.js';
+export { openReadOnly, getSymbolById, getSymbolsByName, listSymbols, getFileById, getFileByPath, listFiles, } from './kb-server/db.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEvE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,4BAA4B,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAUtH,iFAAiF;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGjD,iFAAiF;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,aAAa,EACb,SAAS,GACV,MAAM,mBAAmB,CAAC"}

package/dist/indexer/call-graph.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @module indexer/call-graph
+ *
+ * Call-graph utilities operating on the SQLite knowledge-base:
+ *
+ *  - `buildCallGraph(db)` — resolves raw callee names in `symbol_refs` to
+ *    concrete symbol IDs where possible.
+ *  - `topoSort(db)` — topological ordering of files based on `file_imports`
+ *    using Kahn's algorithm.
+ *  - `detectCycles(db)` — cycle detection over the `file_imports` graph using
+ *    Tarjan's strongly-connected-components algorithm.
+ */
+import type { Database } from './db.js';
+/**
+ * Resolves unresolved `symbol_refs` rows by looking up `callee_name` in the
+ * `symbols` table and writing the matching `callee_id` back.
+ *
+ * Only exact-name matches within the same DB are performed; cross-file
+ * disambiguation is not attempted here.
+ */
+export declare function buildCallGraph(db: Database.Database): void;
+/**
+ * Returns file IDs in topologically sorted order (dependencies before
+ * dependents) using Kahn's algorithm over the `file_imports` graph.
+ *
+ * Files that are part of a cycle are excluded from the returned list (they
+ * have no valid topological position).  Use `detectCycles()` to identify them.
+ */
+export declare function topoSort(db: Database.Database): string[];
+/**
+ * Detects cycles in the `file_imports` graph using Tarjan's
+ * strongly-connected-components (SCC) algorithm.
+ *
+ * Returns an array of SCCs where each SCC has more than one node (or a
+ * single node with a self-loop).  Each SCC is represented as an array of
+ * file IDs (as strings).
+ */
+export declare function detectCycles(db: Database.Database): string[][];
+//# sourceMappingURL=call-graph.d.ts.map

package/dist/indexer/call-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-graph.d.ts","sourceRoot":"","sources":["../../src/indexer/call-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIxC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAwC1D;AAID;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,EAAE,CA2DxD;AAID;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,EAAE,EAAE,CA+E9D"}

package/dist/indexer/call-graph.js

@@ -0,0 +1,193 @@
+/**
+ * @module indexer/call-graph
+ *
+ * Call-graph utilities operating on the SQLite knowledge-base:
+ *
+ *  - `buildCallGraph(db)` — resolves raw callee names in `symbol_refs` to
+ *    concrete symbol IDs where possible.
+ *  - `topoSort(db)` — topological ordering of files based on `file_imports`
+ *    using Kahn's algorithm.
+ *  - `detectCycles(db)` — cycle detection over the `file_imports` graph using
+ *    Tarjan's strongly-connected-components algorithm.
+ */
+// ─── buildCallGraph ───────────────────────────────────────────────────────────
+/**
+ * Resolves unresolved `symbol_refs` rows by looking up `callee_name` in the
+ * `symbols` table and writing the matching `callee_id` back.
+ *
+ * Only exact-name matches within the same DB are performed; cross-file
+ * disambiguation is not attempted here.
+ */
+export function buildCallGraph(db) {
+    // Build a multimap: symbol name → array of { id, file_id }
+    const nameToSymbols = new Map();
+    const allSymbols = db
+        .prepare('SELECT id, name, file_id FROM symbols')
+        .all();
+    for (const row of allSymbols) {
+        let list = nameToSymbols.get(row.name);
+        if (!list) {
+            list = [];
+            nameToSymbols.set(row.name, list);
+        }
+        list.push({ id: row.id, file_id: row.file_id });
+    }
+    // Fetch all unresolved refs along with the caller's file_id for proximity.
+    const unresolved = db
+        .prepare(`SELECT sr.id, sr.callee_name, s.file_id AS caller_file_id
+         FROM symbol_refs sr
+         JOIN symbols s ON s.id = sr.caller_id
+        WHERE sr.callee_id IS NULL`)
+        .all();
+    const update = db.prepare('UPDATE symbol_refs SET callee_id = ? WHERE id = ?');
+    const updateMany = db.transaction(() => {
+        for (const ref of unresolved) {
+            const candidates = nameToSymbols.get(ref.callee_name);
+            if (!candidates || candidates.length === 0)
+                continue;
+            // Prefer same-file match for common names like init, new, parse.
+            const sameFile = candidates.find(c => c.file_id === ref.caller_file_id);
+            const best = sameFile ?? candidates[0];
+            update.run(best.id, ref.id);
+        }
+    });
+    updateMany();
+}
+// ─── topoSort ─────────────────────────────────────────────────────────────────
+/**
+ * Returns file IDs in topologically sorted order (dependencies before
+ * dependents) using Kahn's algorithm over the `file_imports` graph.
+ *
+ * Files that are part of a cycle are excluded from the returned list (they
+ * have no valid topological position).  Use `detectCycles()` to identify them.
+ */
+export function topoSort(db) {
+    // Build adjacency: importer → set of importees (edges point from user to dep)
+    // For topological sort we need: dep comes before user, so reverse edges.
+    // adjacency[dep] → [users]
+    // in-degree[user] = number of deps it imports
+    const allFiles = db
+        .prepare('SELECT id FROM files')
+        .all();
+    const fileIds = allFiles.map(r => String(r.id));
+    const inDegree = new Map();
+    const dependents = new Map(); // dep → users
+    for (const id of fileIds) {
+        inDegree.set(id, 0);
+        dependents.set(id, []);
+    }
+    const edges = db
+        .prepare(`SELECT fi.file_id AS importer, fi.resolved_id AS dep
+       FROM file_imports fi
+       WHERE fi.resolved_id IS NOT NULL`)
+        .all();
+    for (const { importer, dep } of edges) {
+        const importerStr = String(importer);
+        const depStr = String(dep);
+        if (!inDegree.has(importerStr) || !inDegree.has(depStr))
+            continue;
+        // importer has one more dependency
+        inDegree.set(importerStr, (inDegree.get(importerStr) ?? 0) + 1);
+        dependents.get(depStr).push(importerStr);
+    }
+    // Queue all nodes with in-degree 0 (no dependencies)
+    const queue = [];
+    for (const [id, deg] of inDegree) {
+        if (deg === 0)
+            queue.push(id);
+    }
+    const sorted = [];
+    while (queue.length > 0) {
+        const node = queue.shift();
+        sorted.push(node);
+        for (const dependent of dependents.get(node) ?? []) {
+            const newDeg = (inDegree.get(dependent) ?? 1) - 1;
+            inDegree.set(dependent, newDeg);
+            if (newDeg === 0) {
+                queue.push(dependent);
+            }
+        }
+    }
+    return sorted;
+}
+// ─── detectCycles ─────────────────────────────────────────────────────────────
+/**
+ * Detects cycles in the `file_imports` graph using Tarjan's
+ * strongly-connected-components (SCC) algorithm.
+ *
+ * Returns an array of SCCs where each SCC has more than one node (or a
+ * single node with a self-loop).  Each SCC is represented as an array of
+ * file IDs (as strings).
+ */
+export function detectCycles(db) {
+    const allFiles = db
+        .prepare('SELECT id FROM files')
+        .all();
+    // Build adjacency list: importer → [dep, ...]
+    const adjacency = new Map();
+    for (const { id } of allFiles) {
+        adjacency.set(String(id), []);
+    }
+    const edges = db
+        .prepare(`SELECT fi.file_id AS importer, fi.resolved_id AS dep
+       FROM file_imports fi
+       WHERE fi.resolved_id IS NOT NULL`)
+        .all();
+    for (const { importer, dep } of edges) {
+        const imp = String(importer);
+        const d = String(dep);
+        if (adjacency.has(imp)) {
+            adjacency.get(imp).push(d);
+        }
+    }
+    // Tarjan's SCC
+    let index = 0;
+    const indices = new Map();
+    const lowlink = new Map();
+    const onStack = new Map();
+    const stack = [];
+    const sccs = [];
+    function strongConnect(v) {
+        indices.set(v, index);
+        lowlink.set(v, index);
+        index++;
+        stack.push(v);
+        onStack.set(v, true);
+        for (const w of adjacency.get(v) ?? []) {
+            if (!indices.has(w)) {
+                strongConnect(w);
+                lowlink.set(v, Math.min(lowlink.get(v), lowlink.get(w)));
+            }
+            else if (onStack.get(w)) {
+                lowlink.set(v, Math.min(lowlink.get(v), indices.get(w)));
+            }
+        }
+        if (lowlink.get(v) === indices.get(v)) {
+            const scc = [];
+            let w;
+            do {
+                w = stack.pop();
+                onStack.set(w, false);
+                scc.push(w);
+            } while (w !== v);
+            // Self-loops: check if any node in the scc has an edge to itself
+            if (scc.length > 1) {
+                sccs.push(scc);
+            }
+            else {
+                // Single-node SCC — only a cycle if there's a self-loop
+                const selfLoop = (adjacency.get(scc[0]) ?? []).includes(scc[0]);
+                if (selfLoop)
+                    sccs.push(scc);
+            }
+        }
+    }
+    for (const { id } of allFiles) {
+        const v = String(id);
+        if (!indices.has(v)) {
+            strongConnect(v);
+        }
+    }
+    return sccs;
+}
+//# sourceMappingURL=call-graph.js.map