codesift-mcp 0.1.0

package/dist/tools/graph-tools.js

@@ -0,0 +1,313 @@
+import { execSync } from "node:child_process";
+import { getCodeIndex } from "./index-tools.js";
+import { validateGitRef } from "../utils/git-validation.js";
+import { isTestFileStrict as isTestFile } from "../utils/test-file.js";
+const DEFAULT_CALL_DEPTH = 1;
+const DEFAULT_IMPACT_DEPTH = 2;
+/** Maximum total nodes in a call tree to prevent runaway expansion */
+const MAX_TREE_NODES = 500;
+/** Maximum children per node to keep output readable */
+const MAX_CHILDREN_PER_NODE = 20;
+/** Minimum symbol name length to consider as a call edge (skip `id`, `e`, etc.) */
+const MIN_CALL_NAME_LENGTH = 3;
+/** Symbol kinds that represent callable entities */
+const CALLABLE_KINDS = new Set([
+    "function", "method", "class", "default_export", "variable",
+]);
+/**
+ * Extract identifiers that look like function/method calls from source code.
+ * Matches patterns like: `functionName(`, `obj.methodName(`, `this.method(`
+ * Returns a Set of the called identifier names.
+ */
+function extractCallSites(source) {
+    const calls = new Set();
+    // Match: word followed by ( — captures function calls and method calls
+    // Also handles: this.method(, obj.method(, await func(, new Class(
+    const callPattern = /\b([a-zA-Z_$][\w$]*)\s*(?:<[^>]*>)?\s*\(/g;
+    let match;
+    while ((match = callPattern.exec(source)) !== null) {
+        const name = match[1];
+        // Skip language keywords that look like calls
+        if (!KEYWORD_SET.has(name) && name.length >= MIN_CALL_NAME_LENGTH) {
+            calls.add(name);
+        }
+    }
+    return calls;
+}
+/** JS/TS keywords that appear with ( but are not function calls */
+const KEYWORD_SET = new Set([
+    "if", "for", "while", "switch", "catch", "return", "typeof", "instanceof",
+    "new", "throw", "delete", "void", "yield", "await", "import", "export",
+    "from", "const", "let", "var", "function", "class", "extends", "implements",
+    "interface", "type", "enum", "async", "static", "get", "set", "constructor",
+    "super", "this", "true", "false", "null", "undefined", "try", "finally",
+    "else", "case", "default", "break", "continue", "do", "in", "of",
+    "as", "is", "keyof", "readonly", "declare", "abstract", "override",
+    "public", "private", "protected",
+]);
+/**
+ * Build caller/callee adjacency lists by extracting actual call sites from source code.
+ *
+ * For each symbol with source, extracts identifiers used as function calls (pattern: `name(`)
+ * and looks them up in the symbol name index. This produces much more accurate edges than
+ * simple word-boundary matching, which matches any mention of a symbol name.
+ *
+ * @param allSymbols - All symbols in the index
+ * @param skipTests - If true, exclude symbols from test files (default: true)
+ */
+function buildAdjacencyIndex(allSymbols, skipTests = true) {
+    const callees = new Map();
+    const callers = new Map();
+    // Filter symbols: optionally skip test files
+    const symbols = skipTests
+        ? allSymbols.filter(s => !isTestFile(s.file))
+        : allSymbols;
+    // Build name → symbols lookup (only callable kinds for callee targets)
+    const nameToSymbols = new Map();
+    for (const sym of symbols) {
+        if (!CALLABLE_KINDS.has(sym.kind))
+            continue;
+        if (sym.name.length < MIN_CALL_NAME_LENGTH)
+            continue;
+        const existing = nameToSymbols.get(sym.name);
+        if (existing)
+            existing.push(sym);
+        else
+            nameToSymbols.set(sym.name, [sym]);
+    }
+    // For each symbol with source, extract call sites and find matching targets
+    for (const sym of symbols) {
+        if (!sym.source)
+            continue;
+        const callSites = extractCallSites(sym.source);
+        const symCallees = [];
+        for (const calledName of callSites) {
+            const targets = nameToSymbols.get(calledName);
+            if (!targets)
+                continue;
+            for (const target of targets) {
+                if (target.id === sym.id)
+                    continue;
+                // Skip self-file references for common patterns (e.g., method calling sibling method)
+                // Keep cross-file references always
+                symCallees.push(target);
+                // Record reverse edge (caller)
+                const targetCallers = callers.get(target.id);
+                if (targetCallers)
+                    targetCallers.push(sym);
+                else
+                    callers.set(target.id, [sym]);
+            }
+        }
+        if (symCallees.length > 0) {
+            callees.set(sym.id, symCallees);
+        }
+    }
+    return { callees, callers };
+}
+/**
+ * BFS traversal to build a call chain tree up to the given depth.
+ * Uses pre-built adjacency index for O(1) neighbor lookups.
+ * Enforces MAX_TREE_NODES and MAX_CHILDREN_PER_NODE limits.
+ */
+function buildCallTree(root, adjacency, direction, maxDepth) {
+    const visited = new Set([root.id]);
+    const adj = direction === "callees" ? adjacency.callees : adjacency.callers;
+    let totalNodes = 1;
+    function expand(symbol, depth) {
+        if (depth >= maxDepth || totalNodes >= MAX_TREE_NODES) {
+            return { symbol, children: [] };
+        }
+        const neighbors = adj.get(symbol.id) ?? [];
+        const children = [];
+        for (const neighbor of neighbors) {
+            if (totalNodes >= MAX_TREE_NODES)
+                break;
+            if (children.length >= MAX_CHILDREN_PER_NODE)
+                break;
+            if (visited.has(neighbor.id))
+                continue;
+            visited.add(neighbor.id);
+            totalNodes++;
+            children.push(expand(neighbor, depth + 1));
+        }
+        return { symbol, children };
+    }
+    return expand(root, 0);
+}
+/**
+ * Strip the `source` field from a CodeSymbol, keeping compact metadata.
+ */
+function stripSource(sym) {
+    const { source: _, ...rest } = sym;
+    return rest;
+}
+/**
+ * Recursively strip `source` from all symbols in a CallNode tree.
+ */
+function stripCallTreeSource(node) {
+    return {
+        symbol: stripSource(node.symbol),
+        children: node.children.map(stripCallTreeSource),
+    };
+}
+/**
+ * Trace the call chain for a symbol in a repository.
+ * Returns a tree of callers or callees up to the specified depth.
+ * By default, source code is stripped from symbols to keep output compact.
+ * Test files are excluded by default (use include_tests: true to include them).
+ */
+export async function traceCallChain(repo, symbolName, direction, depthOrOptions) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository not found: ${repo}`);
+    }
+    // Support both legacy (depth: number) and new (options: TraceOptions) signatures
+    let maxDepth;
+    let includeSource;
+    let includeTests;
+    if (typeof depthOrOptions === "object" && depthOrOptions !== null) {
+        maxDepth = depthOrOptions.depth ?? DEFAULT_CALL_DEPTH;
+        includeSource = depthOrOptions.include_source ?? false;
+        includeTests = depthOrOptions.include_tests ?? false;
+    }
+    else {
+        maxDepth = depthOrOptions ?? DEFAULT_CALL_DEPTH;
+        includeSource = false;
+        includeTests = false;
+    }
+    // Find the target symbol — prefer non-test files when tests are excluded
+    const candidates = index.symbols.filter((s) => s.name === symbolName);
+    let target;
+    if (!includeTests) {
+        target = candidates.find((s) => !isTestFile(s.file));
+    }
+    target ??= candidates[0];
+    if (!target) {
+        throw new Error(`Symbol "${symbolName}" not found in repository "${repo}"`);
+    }
+    const adjacency = buildAdjacencyIndex(index.symbols, !includeTests);
+    const tree = buildCallTree(target, adjacency, direction, maxDepth);
+    return includeSource ? tree : stripCallTreeSource(tree);
+}
+/**
+ * Find all callers of the given symbols, recursing up to depth levels.
+ * Uses pre-built adjacency index for efficient lookups.
+ */
+function findAffectedSymbols(changedSymbols, adjacency, maxDepth) {
+    const affected = new Map();
+    for (const sym of changedSymbols) {
+        affected.set(sym.id, sym);
+    }
+    let frontier = changedSymbols;
+    for (let d = 0; d < maxDepth; d++) {
+        const nextFrontier = [];
+        for (const sym of frontier) {
+            const symCallers = adjacency.callers.get(sym.id) ?? [];
+            for (const caller of symCallers) {
+                if (!affected.has(caller.id)) {
+                    affected.set(caller.id, caller);
+                    nextFrontier.push(caller);
+                }
+            }
+        }
+        if (nextFrontier.length === 0)
+            break;
+        frontier = nextFrontier;
+    }
+    return [...affected.values()];
+}
+/**
+ * Build a file-level dependency graph from pre-computed adjacency.
+ */
+function buildFileDependencyGraph(index, adjacency) {
+    const graph = {};
+    const symbolsByFile = new Map();
+    for (const sym of index.symbols) {
+        const existing = symbolsByFile.get(sym.file);
+        if (existing)
+            existing.push(sym);
+        else
+            symbolsByFile.set(sym.file, [sym]);
+    }
+    for (const [file, fileSymbols] of symbolsByFile) {
+        const dependentFiles = new Set();
+        for (const sym of fileSymbols) {
+            const symCallers = adjacency.callers.get(sym.id) ?? [];
+            for (const caller of symCallers) {
+                if (caller.file !== file) {
+                    dependentFiles.add(caller.file);
+                }
+            }
+        }
+        if (dependentFiles.size > 0) {
+            graph[file] = [...dependentFiles];
+        }
+    }
+    return graph;
+}
+/**
+ * Run git diff to find changed files between two refs.
+ */
+function getChangedFiles(repoRoot, since, until) {
+    validateGitRef(since);
+    validateGitRef(until);
+    try {
+        const output = execSync(`git diff --name-only ${since}..${until}`, {
+            cwd: repoRoot,
+            encoding: "utf-8",
+            timeout: 10_000,
+        });
+        return output
+            .split("\n")
+            .map((line) => line.trim())
+            .filter((line) => line.length > 0);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`Git diff failed: ${message}`);
+    }
+}
+/**
+ * Analyze the impact of recent git changes on a repository.
+ * Finds changed files, affected symbols, and builds a dependency graph.
+ * By default, source code is stripped from symbols to keep output compact.
+ */
+export async function impactAnalysis(repo, since, depthOrOptions, until) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository not found: ${repo}`);
+    }
+    // Support both legacy (depth: number, until: string) and new (options: ImpactOptions) signatures
+    let maxDepth;
+    let untilRef;
+    let includeSource;
+    if (typeof depthOrOptions === "object" && depthOrOptions !== null) {
+        maxDepth = depthOrOptions.depth ?? DEFAULT_IMPACT_DEPTH;
+        untilRef = depthOrOptions.until ?? until ?? "HEAD";
+        includeSource = depthOrOptions.include_source ?? false;
+    }
+    else {
+        maxDepth = depthOrOptions ?? DEFAULT_IMPACT_DEPTH;
+        untilRef = until ?? "HEAD";
+        includeSource = false;
+    }
+    const changedFiles = getChangedFiles(index.root, since, untilRef);
+    // Find all symbols in changed files
+    const changedSymbols = index.symbols.filter((s) => changedFiles.includes(s.file));
+    // Build adjacency index once, reuse for both affected + dependency graph
+    // Include test files for impact analysis (want to know which tests are affected)
+    const adjacency = buildAdjacencyIndex(index.symbols, false);
+    const affectedSymbols = findAffectedSymbols(changedSymbols, adjacency, maxDepth);
+    const dependencyGraph = buildFileDependencyGraph(index, adjacency);
+    return {
+        changed_files: changedFiles,
+        affected_symbols: includeSource
+            ? affectedSymbols
+            : affectedSymbols.map(stripSource),
+        dependency_graph: dependencyGraph,
+    };
+}
+// Export for testing
+export { buildAdjacencyIndex, extractCallSites, buildCallTree, isTestFile };
+//# sourceMappingURL=graph-tools.js.map

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

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

package/dist/tools/index-tools.d.ts

@@ -0,0 +1,39 @@
+import { type BM25Index } from "../search/bm25.js";
+import type { CodeIndex, RepoMeta } from "../types.js";
+export interface IndexFolderResult {
+    repo: string;
+    root: string;
+    file_count: number;
+    symbol_count: number;
+    duration_ms: number;
+}
+export declare function indexFolder(folderPath: string, options?: {
+    incremental?: boolean | undefined;
+    include_paths?: string[] | undefined;
+    watch?: boolean | undefined;
+}): Promise<IndexFolderResult>;
+/**
+ * Clone a remote git repository and index it.
+ * Clones into ~/.codesift/repos/{name}. If already cloned, pulls latest.
+ */
+export declare function indexRepo(url: string, options?: {
+    branch?: string | undefined;
+    include_paths?: string[] | undefined;
+}): Promise<IndexFolderResult>;
+export declare function listAllRepos(): Promise<RepoMeta[]>;
+export declare function invalidateCache(repoName: string): Promise<boolean>;
+/**
+ * Get the in-memory BM25 index for a repo.
+ * Loads from disk if not cached.
+ */
+export declare function getBM25Index(repoName: string): Promise<BM25Index | null>;
+/**
+ * Get the code index for a repo from disk.
+ */
+export declare function getCodeIndex(repoName: string): Promise<CodeIndex | null>;
+/**
+ * Get the in-memory embedding cache for a repo.
+ * Loads from disk if not cached. Returns null if no embeddings file exists.
+ */
+export declare function getEmbeddingCache(repoName: string): Promise<Map<string, Float32Array> | null>;
+//# sourceMappingURL=index-tools.d.ts.map

package/dist/tools/index-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-tools.d.ts","sourceRoot":"","sources":["../../src/tools/index-tools.ts"],"names":[],"mappings":"AASA,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAOnE,OAAO,KAAK,EAAc,SAAS,EAAa,QAAQ,EAAE,MAAM,aAAa,CAAC;AA0I9E,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACrC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B,GACA,OAAO,CAAC,iBAAiB,CAAC,CAyJ5B;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACtC,GACA,OAAO,CAAC,iBAAiB,CAAC,CA8D5B;AAkDD,wBAAsB,YAAY,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAGxD;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CA4BxE;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAc9E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAM9E;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,IAAI,CAAC,CAc3C"}