mcp-codebase-intelligence 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gaurav Tiwari
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,166 @@
+# mcp-codebase-intelligence
+
+**Give your AI assistant a deep understanding of your codebase.**
+
+[![CI](https://github.com/g-tiwari/mcp-codebase-intelligence/actions/workflows/ci.yml/badge.svg)](https://github.com/g-tiwari/mcp-codebase-intelligence/actions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+An MCP server that parses your entire codebase with tree-sitter, builds a semantic graph of symbols, references, and dependencies, and lets AI assistants query it in real time. Works with Claude Code, Cursor, VS Code, and any MCP-compatible client.
+
+---
+
+## Why?
+
+AI coding assistants are limited by what fits in their context window. When they need to understand your codebase -- find callers of a function, trace a dependency chain, or assess the impact of a change -- they resort to `grep` and guesswork.
+
+**mcp-codebase-intelligence gives them structural understanding instead.**
+
+| Without | With |
+|---------|------|
+| AI greps for function name, misses qualified calls | AI queries the symbol graph, finds all 47 callers instantly |
+| AI reads files one by one to trace imports | AI gets the full dependency tree in one call |
+| AI reviews a PR by reading the diff | AI analyzes which 12 downstream modules are affected by the change |
+| AI guesses at project structure | AI generates an architecture diagram from the actual import graph |
+
+---
+
+## Quick Start
+
+```bash
+# Clone and build
+git clone https://github.com/g-tiwari/mcp-codebase-intelligence.git
+cd mcp-codebase-intelligence
+npm install && npm run build
+
+# Add to Claude Code
+claude mcp add codebase-intelligence \
+  node /path/to/mcp-codebase-intelligence/dist/index.js \
+  -e PROJECT_ROOT=/path/to/your/project
+```
+
+Or add manually to your MCP config (Claude Code, Cursor, VS Code):
+
+```json
+{
+  "mcpServers": {
+    "codebase-intelligence": {
+      "command": "node",
+      "args": ["/path/to/mcp-codebase-intelligence/dist/index.js"],
+      "env": {
+        "PROJECT_ROOT": "/path/to/your/project"
+      }
+    }
+  }
+}
+```
+
+That's it. The server indexes your codebase on startup and watches for changes.
+
+---
+
+## 14 Tools
+
+### Code Navigation
+| Tool | What it does |
+|------|-------------|
+| `find_symbol` | Search for functions, classes, interfaces, types by name. Fuzzy matching, kind/scope filters. |
+| `get_references` | Find all callers/users of a symbol. Transitive: follow the chain N levels deep. |
+| `get_exports` | Public API surface of any file -- all exported symbols with signatures. |
+| `get_dependencies` | Import graph for a file. Transitive: see the full dependency tree. |
+| `get_call_graph` | Who calls this function? What does it call? Tree or mermaid diagram output. |
+
+### Code Intelligence (LSP-powered)
+| Tool | What it does |
+|------|-------------|
+| `goto_definition` | Jump to the definition of any symbol at a given position (TS/JS). |
+| `get_type_info` | Get the inferred type of any expression at a given position (TS/JS). |
+| `find_implementations` | Find all implementations of an interface or abstract method (TS/JS). |
+
+### Change Analysis
+| Tool | What it does |
+|------|-------------|
+| `semantic_diff` | Feed it `git diff` output. It identifies affected symbols, finds all downstream dependents, and flags breaking changes and high-impact modifications. |
+| `analyze_change_impact` | Point it at specific lines in a file. It tells you which symbols are affected and who depends on them. |
+
+### Architecture & Discovery
+| Tool | What it does |
+|------|-------------|
+| `architecture_diagram` | Auto-generate a mermaid diagram of module dependencies, grouped by directory. |
+| `query_codebase` | Ask natural language questions: "find all API endpoints", "what does the orders module do?", "what depends on the database layer?" |
+
+### Admin
+| Tool | What it does |
+|------|-------------|
+| `get_index_stats` | How many files, symbols, references, and imports are indexed. |
+| `reindex` | Trigger a full re-index after major changes. |
+
+---
+
+## 6 Languages
+
+| Language | Extensions | Parser |
+|----------|-----------|--------|
+| TypeScript | `.ts` `.tsx` `.mts` `.cts` | tree-sitter + LSP |
+| JavaScript | `.js` `.jsx` `.mjs` `.cjs` | tree-sitter + LSP |
+| Python | `.py` `.pyi` | tree-sitter |
+| Go | `.go` | tree-sitter |
+| Rust | `.rs` | tree-sitter |
+| Java | `.java` | tree-sitter |
+
+All languages get symbol extraction, reference tracking, import/export analysis, and call graphs. TypeScript/JavaScript additionally get LSP-powered go-to-definition, type info, and find-implementations.
+
+---
+
+## How It Works
+
+```
+Source Files ──> tree-sitter AST ──> Symbol Extraction ──> SQLite Graph
+                                                              │
+                                    File Watcher ─────────────┤ (incremental updates)
+                                                              │
+                                    MCP Tools ◄───────────────┘ (AI queries)
+                                        │
+                                    LSP Servers ──> Type Info (TS/JS)
+```
+
+1. **Parse** -- tree-sitter builds ASTs for all supported files
+2. **Extract** -- language plugins walk the AST to find symbols, references, imports, inheritance
+3. **Store** -- everything goes into a SQLite database with WAL mode, prepared statements, batch transactions
+4. **Watch** -- chokidar monitors the filesystem; changed files are re-indexed incrementally
+5. **Query** -- MCP tools run recursive SQL queries against the graph (transitive references, dependency chains)
+6. **LSP** -- typescript-language-server provides type-aware intelligence for TS/JS
+
+### Performance
+
+- **Batch indexing** with single-transaction writes
+- **Prepared statement cache** -- 14 SQL statements prepared once at startup
+- **In-memory hash cache** -- skip DB lookups for unchanged files
+- **Incremental updates** -- only re-index files that actually changed
+
+Tested on real-world projects: Zod, Express, gin, ripgrep, gson.
+
+---
+
+## Testing
+
+```bash
+npm test
+```
+
+90 tests across 7 test suites covering all 6 language parsers, the graph engine, and semantic diff.
+
+---
+
+## Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `PROJECT_ROOT` | Path to the codebase to index (required) | `cwd()` |
+| `DB_PATH` | Path to SQLite database file | `$PROJECT_ROOT/.codegraph/index.db` |
+| `LOG_LEVEL` | Logging verbosity: debug, info, warn, error | `info` |
+
+---
+
+## License
+
+MIT

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

@@ -0,0 +1,119 @@
+import Database from "better-sqlite3";
+export interface SymbolInfo {
+    name: string;
+    kind: string;
+    filePath: string;
+    lineStart: number;
+    lineEnd: number;
+    colStart: number;
+    colEnd: number;
+    parentSymbolId?: number;
+    signature?: string;
+    isExported: boolean;
+}
+export interface ReferenceInfo {
+    fromSymbolId: number;
+    toSymbolName: string;
+    toSymbolBareName: string;
+    toFileId?: number;
+    kind: string;
+    line: number;
+    col: number;
+}
+export interface ImportInfo {
+    sourcePath: string;
+    importedName: string;
+    localName: string;
+    isDefault: boolean;
+    isNamespace: boolean;
+    line: number;
+}
+export declare class CodeGraph {
+    private db;
+    private stmts;
+    private hashCache;
+    constructor(db: Database.Database);
+    private prepareStatements;
+    getDb(): Database.Database;
+    fileHash(content: string): string;
+    getFileId(filePath: string): number | undefined;
+    getFileHash(filePath: string): string | undefined;
+    upsertFile(filePath: string, hash: string): number;
+    clearFileData(fileId: number): void;
+    insertSymbol(fileId: number, symbol: SymbolInfo): number;
+    insertReference(ref: ReferenceInfo): void;
+    insertImport(fileId: number, imp: ImportInfo): void;
+    /**
+     * Index a single file. Wraps in a transaction.
+     * For batch indexing many files, use indexFileBatch() instead.
+     */
+    indexFile(filePath: string, content: string, symbols: SymbolInfo[], references: ReferenceInfo[], imports: ImportInfo[]): void;
+    /**
+     * Batch-index many files in a single transaction.
+     * Much faster for initial indexing of large repos.
+     */
+    indexFileBatch(files: Array<{
+        filePath: string;
+        content: string;
+        symbols: SymbolInfo[];
+        references: ReferenceInfo[];
+        imports: ImportInfo[];
+    }>): {
+        indexed: number;
+        skipped: number;
+    };
+    private _indexFileInner;
+    removeFile(filePath: string): void;
+    findSymbols(query: {
+        name?: string;
+        kind?: string;
+        scope?: string;
+        limit?: number;
+    }): Array<{
+        name: string;
+        kind: string;
+        filePath: string;
+        lineStart: number;
+        lineEnd: number;
+        colStart: number;
+        colEnd: number;
+        signature: string | null;
+        isExported: boolean;
+    }>;
+    getReferences(symbolName: string, depth?: number): Array<{
+        fromSymbol: string;
+        fromKind: string;
+        fromFile: string;
+        fromLine: number;
+        toSymbol: string;
+        refKind: string;
+        refLine: number;
+        refCol: number;
+        depth: number;
+    }>;
+    getExports(filePath: string): Array<{
+        name: string;
+        kind: string;
+        lineStart: number;
+        signature: string | null;
+    }>;
+    getImports(filePath: string): Array<{
+        sourcePath: string;
+        importedName: string;
+        localName: string;
+        isDefault: boolean;
+        isNamespace: boolean;
+        line: number;
+    }>;
+    getDependencyGraph(filePath: string, depth?: number): Array<{
+        file: string;
+        imports: string;
+        depth: number;
+    }>;
+    getStats(): {
+        files: number;
+        symbols: number;
+        references: number;
+        imports: number;
+    };
+}

package/dist/graph/code-graph.js

@@ -0,0 +1,279 @@
+import { createHash } from "crypto";
+import { logger } from "../utils/logger.js";
+export class CodeGraph {
+    db;
+    // Prepared statement cache — avoids re-preparing on every call
+    stmts;
+    // In-memory hash cache — avoids DB lookup on unchanged files
+    hashCache = new Map();
+    constructor(db) {
+        this.db = db;
+        this.stmts = this.prepareStatements();
+    }
+    prepareStatements() {
+        return {
+            getFileId: this.db.prepare("SELECT id FROM files WHERE path = ?"),
+            getFileHash: this.db.prepare("SELECT hash FROM files WHERE path = ?"),
+            updateFile: this.db.prepare("UPDATE files SET hash = ?, indexed_at = datetime('now') WHERE id = ?"),
+            insertFile: this.db.prepare("INSERT INTO files (path, hash) VALUES (?, ?)"),
+            deleteSymbols: this.db.prepare("DELETE FROM symbols WHERE file_id = ?"),
+            deleteImports: this.db.prepare("DELETE FROM imports WHERE file_id = ?"),
+            insertSymbol: this.db.prepare(`INSERT INTO symbols (name, kind, file_id, line_start, line_end, col_start, col_end, parent_symbol_id, signature, is_exported)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`),
+            updateParent: this.db.prepare("UPDATE symbols SET parent_symbol_id = ? WHERE id = ?"),
+            insertRef: this.db.prepare(`INSERT INTO references_ (from_symbol_id, to_symbol_name, to_symbol_bare_name, to_file_id, kind, line, col)
+         VALUES (?, ?, ?, ?, ?, ?, ?)`),
+            insertImport: this.db.prepare(`INSERT INTO imports (file_id, source_path, imported_name, local_name, is_default, is_namespace, line)
+         VALUES (?, ?, ?, ?, ?, ?, ?)`),
+            deleteFile: this.db.prepare("DELETE FROM files WHERE id = ?"),
+            countFiles: this.db.prepare("SELECT COUNT(*) as c FROM files"),
+            countSymbols: this.db.prepare("SELECT COUNT(*) as c FROM symbols"),
+            countRefs: this.db.prepare("SELECT COUNT(*) as c FROM references_"),
+            countImports: this.db.prepare("SELECT COUNT(*) as c FROM imports"),
+        };
+    }
+    getDb() {
+        return this.db;
+    }
+    fileHash(content) {
+        return createHash("sha256").update(content).digest("hex");
+    }
+    getFileId(filePath) {
+        const row = this.stmts.getFileId.get(filePath);
+        return row?.id;
+    }
+    getFileHash(filePath) {
+        // Check in-memory cache first
+        const cached = this.hashCache.get(filePath);
+        if (cached)
+            return cached;
+        const row = this.stmts.getFileHash.get(filePath);
+        if (row)
+            this.hashCache.set(filePath, row.hash);
+        return row?.hash;
+    }
+    upsertFile(filePath, hash) {
+        const existing = this.getFileId(filePath);
+        if (existing) {
+            this.stmts.updateFile.run(hash, existing);
+            this.hashCache.set(filePath, hash);
+            return existing;
+        }
+        const result = this.stmts.insertFile.run(filePath, hash);
+        this.hashCache.set(filePath, hash);
+        return result.lastInsertRowid;
+    }
+    clearFileData(fileId) {
+        this.stmts.deleteSymbols.run(fileId);
+        this.stmts.deleteImports.run(fileId);
+    }
+    insertSymbol(fileId, symbol) {
+        const result = this.stmts.insertSymbol.run(symbol.name, symbol.kind, fileId, symbol.lineStart, symbol.lineEnd, symbol.colStart, symbol.colEnd, symbol.parentSymbolId ?? null, symbol.signature ?? null, symbol.isExported ? 1 : 0);
+        return result.lastInsertRowid;
+    }
+    insertReference(ref) {
+        this.stmts.insertRef.run(ref.fromSymbolId, ref.toSymbolName, ref.toSymbolBareName, ref.toFileId ?? null, ref.kind, ref.line, ref.col);
+    }
+    insertImport(fileId, imp) {
+        this.stmts.insertImport.run(fileId, imp.sourcePath, imp.importedName, imp.localName, imp.isDefault ? 1 : 0, imp.isNamespace ? 1 : 0, imp.line);
+    }
+    /**
+     * Index a single file. Wraps in a transaction.
+     * For batch indexing many files, use indexFileBatch() instead.
+     */
+    indexFile(filePath, content, symbols, references, imports) {
+        const hash = this.fileHash(content);
+        const existingHash = this.getFileHash(filePath);
+        if (existingHash === hash) {
+            logger.debug(`Skipping unchanged file: ${filePath}`);
+            return;
+        }
+        const tx = this.db.transaction(() => {
+            this._indexFileInner(filePath, hash, symbols, references, imports);
+        });
+        tx();
+    }
+    /**
+     * Batch-index many files in a single transaction.
+     * Much faster for initial indexing of large repos.
+     */
+    indexFileBatch(files) {
+        let indexed = 0;
+        let skipped = 0;
+        const tx = this.db.transaction(() => {
+            for (const file of files) {
+                const hash = this.fileHash(file.content);
+                const existingHash = this.getFileHash(file.filePath);
+                if (existingHash === hash) {
+                    skipped++;
+                    continue;
+                }
+                this._indexFileInner(file.filePath, hash, file.symbols, file.references, file.imports);
+                indexed++;
+            }
+        });
+        tx();
+        return { indexed, skipped };
+    }
+    _indexFileInner(filePath, hash, symbols, references, imports) {
+        const fileId = this.upsertFile(filePath, hash);
+        this.clearFileData(fileId);
+        // First pass: insert all symbols without parent references
+        const symbolIdMap = new Map();
+        for (let i = 0; i < symbols.length; i++) {
+            const sym = symbols[i];
+            const savedParent = sym.parentSymbolId;
+            sym.parentSymbolId = undefined;
+            const id = this.insertSymbol(fileId, sym);
+            symbolIdMap.set(i, id);
+            sym.parentSymbolId = savedParent;
+        }
+        // Second pass: update parent references now that all symbols have real IDs
+        for (let i = 0; i < symbols.length; i++) {
+            const sym = symbols[i];
+            if (sym.parentSymbolId !== undefined) {
+                const realParentId = symbolIdMap.get(sym.parentSymbolId);
+                const realId = symbolIdMap.get(i);
+                if (realParentId !== undefined && realId !== undefined) {
+                    this.stmts.updateParent.run(realParentId, realId);
+                }
+            }
+        }
+        for (const ref of references) {
+            const mappedFromId = symbolIdMap.get(ref.fromSymbolId) ?? ref.fromSymbolId;
+            this.insertReference({ ...ref, fromSymbolId: mappedFromId });
+        }
+        for (const imp of imports) {
+            this.insertImport(fileId, imp);
+        }
+    }
+    removeFile(filePath) {
+        const fileId = this.getFileId(filePath);
+        if (fileId) {
+            this.stmts.deleteFile.run(fileId);
+            this.hashCache.delete(filePath);
+            logger.info(`Removed file from index: ${filePath}`);
+        }
+    }
+    // --- Query methods ---
+    findSymbols(query) {
+        const conditions = [];
+        const params = [];
+        if (query.name) {
+            conditions.push("s.name LIKE ?");
+            params.push(`%${query.name}%`);
+        }
+        if (query.kind) {
+            conditions.push("s.kind = ?");
+            params.push(query.kind);
+        }
+        if (query.scope) {
+            conditions.push("f.path LIKE ?");
+            params.push(`${query.scope}%`);
+        }
+        const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+        const limit = query.limit ?? 50;
+        const sql = `
+      SELECT s.name, s.kind, f.path as filePath, s.line_start as lineStart, s.line_end as lineEnd,
+             s.col_start as colStart, s.col_end as colEnd, s.signature, s.is_exported as isExported
+      FROM symbols s
+      JOIN files f ON s.file_id = f.id
+      ${where}
+      ORDER BY
+        CASE WHEN s.name = ? THEN 0 ELSE 1 END,
+        s.is_exported DESC,
+        f.path
+      LIMIT ?
+    `;
+        params.push(query.name ?? "", limit);
+        return this.db.prepare(sql).all(...params);
+    }
+    getReferences(symbolName, depth = 1) {
+        if (depth < 1)
+            depth = 1;
+        if (depth > 10)
+            depth = 10;
+        const sql = `
+      WITH RECURSIVE ref_chain(from_symbol_name, from_kind, from_file, from_line, to_name, ref_kind, ref_line, ref_col, depth) AS (
+        -- Base case: direct references to the target symbol
+        -- Match against both full qualified name and bare name
+        SELECT s.name, s.kind, f.path, s.line_start, r.to_symbol_name, r.kind, r.line, r.col, 1
+        FROM references_ r
+        JOIN symbols s ON r.from_symbol_id = s.id
+        JOIN files f ON s.file_id = f.id
+        WHERE r.to_symbol_name = ?
+           OR r.to_symbol_bare_name = ?
+           OR r.to_symbol_name LIKE (? || '.%')
+
+        UNION ALL
+
+        -- Recursive case: who references the symbols that reference our target
+        SELECT s.name, s.kind, f.path, s.line_start, r.to_symbol_name, r.kind, r.line, r.col, rc.depth + 1
+        FROM references_ r
+        JOIN symbols s ON r.from_symbol_id = s.id
+        JOIN files f ON s.file_id = f.id
+        JOIN ref_chain rc ON r.to_symbol_name = rc.from_symbol_name
+                          OR r.to_symbol_bare_name = rc.from_symbol_name
+                          OR r.to_symbol_name LIKE (rc.from_symbol_name || '.%')
+        WHERE rc.depth < ?
+      )
+      SELECT from_symbol_name as fromSymbol, from_kind as fromKind, from_file as fromFile,
+             from_line as fromLine, to_name as toSymbol, ref_kind as refKind,
+             ref_line as refLine, ref_col as refCol, depth
+      FROM ref_chain
+      ORDER BY depth, from_file, ref_line
+      LIMIT 200
+    `;
+        return this.db.prepare(sql).all(symbolName, symbolName, symbolName, depth);
+    }
+    getExports(filePath) {
+        return this.db
+            .prepare(`SELECT s.name, s.kind, s.line_start as lineStart, s.signature
+         FROM symbols s
+         JOIN files f ON s.file_id = f.id
+         WHERE f.path = ? AND s.is_exported = 1
+         ORDER BY s.line_start`)
+            .all(filePath);
+    }
+    getImports(filePath) {
+        return this.db
+            .prepare(`SELECT source_path as sourcePath, imported_name as importedName, local_name as localName,
+                is_default as isDefault, is_namespace as isNamespace, line
+         FROM imports
+         JOIN files f ON imports.file_id = f.id
+         WHERE f.path = ?
+         ORDER BY line`)
+            .all(filePath);
+    }
+    getDependencyGraph(filePath, depth = 2) {
+        const sql = `
+      WITH RECURSIVE dep_tree(file_path, imports_from, depth) AS (
+        SELECT f.path, i.source_path, 1
+        FROM imports i
+        JOIN files f ON i.file_id = f.id
+        WHERE f.path = ?
+
+        UNION ALL
+
+        SELECT f.path, i.source_path, dt.depth + 1
+        FROM imports i
+        JOIN files f ON i.file_id = f.id
+        JOIN dep_tree dt ON f.path LIKE ('%' || dt.imports_from || '%')
+        WHERE dt.depth < ?
+      )
+      SELECT file_path as file, imports_from as imports, depth
+      FROM dep_tree
+      ORDER BY depth, file_path
+      LIMIT 100
+    `;
+        return this.db.prepare(sql).all(filePath, depth);
+    }
+    getStats() {
+        const files = this.stmts.countFiles.get().c;
+        const symbols = this.stmts.countSymbols.get().c;
+        const references = this.stmts.countRefs.get().c;
+        const imports = this.stmts.countImports.get().c;
+        return { files, symbols, references, imports };
+    }
+}
+//# sourceMappingURL=code-graph.js.map

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

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

package/dist/graph/schema.d.ts

@@ -0,0 +1,2 @@
+import Database from "better-sqlite3";
+export declare function initializeDatabase(dbPath: string): Database.Database;

package/dist/graph/schema.js

@@ -0,0 +1,62 @@
+import Database from "better-sqlite3";
+export function initializeDatabase(dbPath) {
+    const db = new Database(dbPath);
+    db.pragma("journal_mode = WAL");
+    db.pragma("foreign_keys = ON");
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS files (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      path TEXT NOT NULL UNIQUE,
+      hash TEXT NOT NULL,
+      indexed_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+
+    CREATE TABLE IF NOT EXISTS symbols (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      name TEXT NOT NULL,
+      kind TEXT NOT NULL,
+      file_id INTEGER NOT NULL REFERENCES files(id) ON DELETE CASCADE,
+      line_start INTEGER NOT NULL,
+      line_end INTEGER NOT NULL,
+      col_start INTEGER NOT NULL,
+      col_end INTEGER NOT NULL,
+      parent_symbol_id INTEGER REFERENCES symbols(id) ON DELETE SET NULL,
+      signature TEXT,
+      is_exported INTEGER NOT NULL DEFAULT 0,
+      UNIQUE(name, kind, file_id, line_start)
+    );
+
+    CREATE TABLE IF NOT EXISTS references_ (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      from_symbol_id INTEGER NOT NULL REFERENCES symbols(id) ON DELETE CASCADE,
+      to_symbol_name TEXT NOT NULL,
+      to_symbol_bare_name TEXT NOT NULL,
+      to_file_id INTEGER,
+      kind TEXT NOT NULL,
+      line INTEGER NOT NULL,
+      col INTEGER NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS imports (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      file_id INTEGER NOT NULL REFERENCES files(id) ON DELETE CASCADE,
+      source_path TEXT NOT NULL,
+      imported_name TEXT NOT NULL,
+      local_name TEXT NOT NULL,
+      is_default INTEGER NOT NULL DEFAULT 0,
+      is_namespace INTEGER NOT NULL DEFAULT 0,
+      line INTEGER NOT NULL
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_symbols_name ON symbols(name);
+    CREATE INDEX IF NOT EXISTS idx_symbols_kind ON symbols(kind);
+    CREATE INDEX IF NOT EXISTS idx_symbols_file ON symbols(file_id);
+    CREATE INDEX IF NOT EXISTS idx_refs_from ON references_(from_symbol_id);
+    CREATE INDEX IF NOT EXISTS idx_refs_to_name ON references_(to_symbol_name);
+    CREATE INDEX IF NOT EXISTS idx_refs_to_bare ON references_(to_symbol_bare_name);
+    CREATE INDEX IF NOT EXISTS idx_imports_file ON imports(file_id);
+    CREATE INDEX IF NOT EXISTS idx_imports_source ON imports(source_path);
+  `);
+    return db;
+}
+//# sourceMappingURL=schema.js.map

package/dist/graph/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/graph/schema.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEhC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAE/B,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDP,CAAC,CAAC;IAEH,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import "./indexer/lang-python.js";
+import "./indexer/lang-go.js";
+import "./indexer/lang-rust.js";
+import "./indexer/lang-java.js";