@nithin554/code-crawler 0.0.0 → 0.1.1

package/dist/crawler.js

@@ -0,0 +1,303 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fieldNodeId, importNodeId } from "./graph/schema.js";
+import { languageForFile } from "./parser/languages/index.js";
+import { buildTypeIndex, phantomNodeId } from "./resolver/types.js";
+import { resolveJavaFile } from "./resolver/javaResolver.js";
+/** Discover source files under a project, respecting exclusion dirs. */
+export function discoverSourceFiles(projectPath, excludeDirs, language) {
+    const excluded = new Set(excludeDirs.map((d) => d.replace(/\/+$/, "")));
+    const out = [];
+    function walk(dir) {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return; // unreadable dir (permissions) — skip
+        }
+        for (const entry of entries) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                if (!excluded.has(entry.name))
+                    walk(full);
+            }
+            else if (entry.isFile() && languageForFile(entry.name, language)) {
+                out.push(full);
+            }
+        }
+    }
+    walk(projectPath);
+    return out.sort();
+}
+/** Convert a ParsedFile into graph nodes + edges (declarations only). */
+export function buildDeclarationGraph(parsed) {
+    const nodes = [];
+    const edges = [];
+    const fileId = parsed.filePath;
+    const fileLines = sourceLineCount(parsed.filePath);
+    nodes.push({
+        id: fileId,
+        kind: "file",
+        qualifiedName: fileId,
+        filePath: fileId,
+        properties: { language: parsed.language, startLine: 0, endLine: fileLines },
+    });
+    if (parsed.packageName) {
+        nodes.push({
+            id: parsed.packageName,
+            kind: "package",
+            qualifiedName: parsed.packageName,
+            filePath: fileId,
+            properties: {},
+        });
+        edges.push({
+            source: fileId,
+            target: parsed.packageName,
+            kind: "DECLARED_IN",
+            properties: {},
+        });
+    }
+    for (const imp of parsed.imports) {
+        const importId = importNodeId(imp.fqn);
+        nodes.push({
+            id: importId,
+            kind: "import",
+            qualifiedName: imp.fqn,
+            filePath: fileId,
+            properties: { simpleName: imp.simpleName, static: imp.isStatic },
+        });
+        edges.push({ source: fileId, target: importId, kind: "IMPORTS", properties: {} });
+    }
+    for (const t of parsed.types) {
+        nodes.push({
+            id: t.id,
+            kind: t.kind,
+            qualifiedName: t.id,
+            filePath: fileId,
+            properties: { name: t.name, startLine: t.startLine, endLine: t.endLine },
+        });
+        edges.push({ source: fileId, target: t.id, kind: "CONTAINS", properties: {} });
+        if (parsed.packageName) {
+            edges.push({ source: t.id, target: parsed.packageName, kind: "DECLARED_IN", properties: {} });
+        }
+        for (const parent of t.extendsTypes) {
+            edges.push({ source: t.id, target: parent, kind: "EXTENDS", properties: {} });
+        }
+        for (const parent of t.implementsTypes) {
+            edges.push({ source: t.id, target: parent, kind: "IMPLEMENTS", properties: {} });
+        }
+    }
+    for (const m of parsed.methods) {
+        nodes.push({
+            id: m.id,
+            kind: m.isConstructor ? "constructor" : "method",
+            qualifiedName: m.id,
+            filePath: fileId,
+            properties: {
+                name: m.name,
+                signature: `(${m.params.map((p) => p.type).join(", ")})`,
+                returnType: m.returnType,
+                modifiers: m.modifiers,
+                startLine: m.startLine,
+                endLine: m.endLine,
+            },
+        });
+        edges.push({
+            source: m.typeId,
+            target: m.id,
+            kind: "CONTAINS",
+            properties: { line: m.startLine },
+        });
+    }
+    for (const f of parsed.fields) {
+        nodes.push({
+            id: fieldNodeId(f.typeId, f.name),
+            kind: "field",
+            qualifiedName: f.id,
+            filePath: fileId,
+            properties: { name: f.name, type: f.type, startLine: f.startLine },
+        });
+        edges.push({
+            source: f.typeId,
+            target: fieldNodeId(f.typeId, f.name),
+            kind: "CONTAINS",
+            properties: { line: f.startLine },
+        });
+    }
+    return { nodes, edges };
+}
+/** Resolve call sites for a parsed file into CALLS edges + phantom nodes. */
+export function buildCallEdges(parsed, index, knownNodeIds) {
+    const edges = [];
+    const phantomNodes = [];
+    let resolved = 0;
+    let unresolved = 0;
+    const javaParsed = parsed;
+    const resolvedCalls = parsed.language === "java" ? resolveJavaFile(javaParsed, index) : [];
+    for (const rc of resolvedCalls) {
+        // Calls in field/static initializers have no enclosing method; attribute
+        // them to the enclosing type so the edge always has a valid source.
+        const source = rc.callSite.enclosingMethodId || rc.callSite.enclosingTypeId;
+        if (rc.resolved) {
+            resolved++;
+            // Targets can reference synthetic methods (e.g. implicit default
+            // constructors) that are not declared anywhere; create a node for them.
+            if (!knownNodeIds.has(rc.targetId)) {
+                const synthetic = {
+                    id: rc.targetId,
+                    kind: rc.targetId.endsWith("#<init>") ? "constructor" : "method",
+                    qualifiedName: rc.targetId,
+                    filePath: parsed.filePath,
+                    properties: {
+                        name: rc.targetId.includes("#") ? rc.targetId.split("#").pop() ?? "" : rc.targetId,
+                        synthetic: true,
+                        reason: rc.reason,
+                    },
+                };
+                phantomNodes.push(synthetic);
+                knownNodeIds.add(rc.targetId);
+            }
+            edges.push({
+                source,
+                target: rc.targetId,
+                kind: "CALLS",
+                properties: {
+                    line: rc.callSite.line,
+                    resolved: true,
+                    confidence: Math.round(rc.confidence * 100) / 100,
+                    reason: rc.reason,
+                },
+            });
+        }
+        else {
+            unresolved++;
+            const phantomId = phantomNodeId(rc.callSite);
+            phantomNodes.push({
+                id: phantomId,
+                kind: "unknown_symbol",
+                qualifiedName: phantomId,
+                filePath: parsed.filePath,
+                properties: {
+                    name: rc.callSite.isConstructorCall ? rc.callSite.name : `${rc.callSite.receiver ? `${rc.callSite.receiver}.` : ""}${rc.callSite.name}`,
+                    reason: rc.reason,
+                },
+            });
+            edges.push({
+                source,
+                target: phantomId,
+                kind: "CALLS",
+                properties: {
+                    line: rc.callSite.line,
+                    resolved: false,
+                    confidence: 0,
+                    reason: rc.reason,
+                },
+            });
+        }
+    }
+    return { edges, phantomNodes, resolved, unresolved };
+}
+/**
+ * Crawl a project directory and index it into the store.
+ * Idempotent: re-crawling refreshes the graph; files that disappeared are
+ * removed from the index.
+ */
+export async function crawlProject(store, projectPath, excludeDirs, options = {}) {
+    const started = Date.now();
+    const absPath = path.resolve(projectPath);
+    if (!fs.existsSync(absPath) || !fs.statSync(absPath).isDirectory()) {
+        throw new Error(`project path is not a directory: ${projectPath}`);
+    }
+    const files = discoverSourceFiles(absPath, excludeDirs, options.language);
+    if (options.fileFilter) {
+        const filter = options.fileFilter;
+        files.splice(0, files.length, ...files.filter((f) => f.includes(filter)));
+    }
+    // Parse every file (grammar is cached, so subsequent parses are fast).
+    const parsedFiles = [];
+    const parseErrors = [];
+    for (const file of files) {
+        try {
+            const source = fs.readFileSync(file, "utf8");
+            const config = languageForFile(file, options.language);
+            if (!config)
+                continue;
+            parsedFiles.push(await config.parseFile(source, file));
+        }
+        catch (err) {
+            parseErrors.push(`${file}: ${err.message}`);
+        }
+    }
+    // Global index for cross-file resolution.
+    const index = buildTypeIndex(parsedFiles);
+    // Build nodes + edges per file and persist file-scoped.
+    const previouslyIndexed = new Set(store.raw("SELECT DISTINCT file_path FROM nodes WHERE file_path IS NOT NULL").map((r) => r.file_path));
+    const currentFiles = new Set(files);
+    let filesRemoved = 0;
+    let totalNodes = 0;
+    let totalEdges = 0;
+    let totalResolved = 0;
+    let totalUnresolved = 0;
+    // Pre-compute every declared node id so synthetic targets (default
+    // constructors) can be created on demand, and so EXTENDS/IMPLEMENTS edges
+    // to external types can be dropped instead of violating FK constraints.
+    const allNodeIds = new Set();
+    for (const parsed of parsedFiles) {
+        for (const n of buildDeclarationGraph(parsed).nodes)
+            allNodeIds.add(n.id);
+    }
+    store.withTransaction(() => {
+        for (const parsed of parsedFiles) {
+            const decl = buildDeclarationGraph(parsed);
+            const calls = buildCallEdges(parsed, index, allNodeIds);
+            for (const p of calls.phantomNodes)
+                allNodeIds.add(p.id);
+            // Phantom nodes must exist as edge endpoints (FK constraint).
+            for (const p of calls.phantomNodes)
+                store.ensureNode(p);
+            // Drop edges whose endpoints aren't part of the indexed project
+            // (external EXTENDS/IMPLEMENTS/IMPORTS targets).
+            const edges = decl.edges
+                .concat(calls.edges)
+                .filter((e) => allNodeIds.has(e.source) && allNodeIds.has(e.target));
+            const nodes = decl.nodes.concat(calls.phantomNodes);
+            store.replaceFile(parsed.filePath, nodes, edges);
+            totalNodes += decl.nodes.length;
+            totalEdges += edges.length;
+            totalResolved += calls.resolved;
+            totalUnresolved += calls.unresolved;
+            previouslyIndexed.delete(parsed.filePath);
+        }
+        // Remove files that disappeared from the project.
+        for (const stale of previouslyIndexed) {
+            if (!currentFiles.has(stale)) {
+                store.removeFile(stale);
+                filesRemoved++;
+            }
+        }
+    });
+    store.setMeta("last_crawl_at", new Date().toISOString());
+    store.setMeta("last_project_path", absPath);
+    return {
+        projectPath: absPath,
+        filesScanned: files.length,
+        filesParsed: parsedFiles.length,
+        filesRemoved,
+        nodes: totalNodes,
+        edges: totalEdges,
+        resolvedCalls: totalResolved,
+        unresolvedCalls: totalUnresolved,
+        languages: [...new Set(parsedFiles.map((p) => p.language))],
+        durationMs: Date.now() - started,
+    };
+}
+function sourceLineCount(filePath) {
+    try {
+        return fs.readFileSync(filePath, "utf8").split("\n").length;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=crawler.js.map

package/dist/crawler.js.map

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

package/dist/graph/queries.d.ts

@@ -0,0 +1,111 @@
+import type { GraphStore } from "./store.js";
+import type { EdgeKind, NodeKind } from "./schema.js";
+/**
+ * Traversal queries over the property graph.
+ *
+ * All queries operate on CALLS edges (directed: caller -> callee) plus
+ * arbitrary edge kinds where relevant. Depth-bounded recursive CTEs keep
+ * queries bounded even on large graphs.
+ */
+export interface SymbolRef {
+    id: string;
+    qualifiedName: string;
+    name?: string;
+    kind: NodeKind;
+    filePath: string | null;
+    line?: number;
+}
+export interface CallerInfo {
+    caller: SymbolRef;
+    /** Properties of the CALLS edge (call site line, resolution, confidence). */
+    callSiteLine?: number;
+    resolved?: boolean;
+}
+export interface CallerQueryOptions {
+    /** Include transitive callers (whole call graph above). Default true. */
+    transitive?: boolean;
+    /** Max depth for transitive traversal. Bounded by config maxDepth. */
+    maxDepth?: number;
+    /** Cap total rows returned. */
+    limit?: number;
+}
+/**
+ * Find every symbol that calls the given symbol, directly or transitively.
+ * Each row includes the edge chain depth so clients can render a call tree.
+ */
+export declare function getCallers(store: GraphStore, symbol: string, opts?: CallerQueryOptions): {
+    target: SymbolRef;
+    callers: {
+        caller: SymbolRef;
+        depth: number;
+        callSiteLine?: number;
+    }[];
+} | null;
+export interface CalleeQueryOptions {
+    /** Include transitive callees (whole call graph below). Default true. */
+    transitive?: boolean;
+    maxDepth?: number;
+    limit?: number;
+}
+/**
+ * Find every symbol the given symbol calls, directly or transitively.
+ */
+export declare function getCallees(store: GraphStore, symbol: string, opts?: CalleeQueryOptions): {
+    source: SymbolRef;
+    callees: {
+        callee: SymbolRef;
+        depth: number;
+        callSiteLine?: number;
+    }[];
+} | null;
+export interface PathEntry {
+    /** Ordered list of symbol ids from source to target (inclusive). */
+    path: string[];
+    length: number;
+    edges: {
+        source: string;
+        target: string;
+        callSiteLine?: number;
+        resolved?: boolean;
+    }[];
+}
+export interface TracePathOptions {
+    maxDepth?: number;
+    limit?: number;
+}
+/**
+ * Find up to `limit` static call paths between two symbols.
+ * BFS over CALLS edges so the shortest paths come first.
+ */
+export declare function tracePath(store: GraphStore, from: string, to: string, opts?: TracePathOptions): PathEntry[] | null;
+export interface SubgraphOptions {
+    radius?: number;
+    edgeKinds?: EdgeKind[];
+    limit?: number;
+}
+export interface SubgraphResult {
+    center: SymbolRef | null;
+    nodes: SymbolRef[];
+    edges: {
+        source: string;
+        target: string;
+        kind: EdgeKind;
+        callSiteLine?: number;
+    }[];
+}
+/**
+ * Extract the neighborhood around a symbol (any edge kinds), useful for
+ * visualization and for letting an LLM see the local shape of the graph.
+ */
+export declare function getSubgraph(store: GraphStore, symbol: string, opts?: SubgraphOptions): SubgraphResult;
+export interface SearchOptions {
+    kind?: NodeKind | null;
+    limit?: number;
+}
+/**
+ * Fuzzy symbol lookup by short name or FQN. Matches substring of either the
+ * id, the qualified name, or the display name.
+ */
+export declare function searchSymbols(store: GraphStore, query: string, opts?: SearchOptions): SymbolRef[];
+/** Suggest similar symbols when an exact lookup fails. */
+export declare function suggestSymbols(store: GraphStore, symbol: string, limit?: number): SymbolRef[];