codesift-mcp 0.3.0 → 0.5.0

package/dist/tools/python-callers.js

@@ -0,0 +1,110 @@
+/**
+ * find_python_callers — cross-module call site tracing for Python.
+ *
+ * Given a Python symbol (function, class, method), find every place it's
+ * referenced across the codebase. Uses the Python import graph to resolve
+ * `from myapp.utils import foo` style imports, then scans symbol sources
+ * for usage patterns.
+ *
+ * Differs from generic `find_references`:
+ *   - Python-aware: understands `X.delay()` for Celery task calls, `X()` for
+ *     constructor calls, `.X.method()` for method access
+ *   - Returns call context (containing function, call kind)
+ *   - Respects Python aliasing: `from X import Y as Z`
+ */
+import { getCodeIndex } from "./index-tools.js";
+/**
+ * Find all Python call sites of a given symbol.
+ * The target is identified by name (+ optional file pattern to disambiguate).
+ */
+export async function findPythonCallers(repo, targetName, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found.`);
+    const maxResults = options?.max_results ?? 100;
+    // 1. Find the target symbol
+    const candidates = index.symbols.filter((s) => {
+        if (s.name !== targetName)
+            return false;
+        if (!s.file.endsWith(".py"))
+            return false;
+        if (options?.target_file && !s.file.includes(options.target_file))
+            return false;
+        return true;
+    });
+    if (candidates.length === 0) {
+        throw new Error(`Symbol "${targetName}" not found in Python files`);
+    }
+    // Prefer function/class/method over variable if ambiguous
+    const targetSymbol = candidates.find((s) => ["function", "method", "class"].includes(s.kind)) ?? candidates[0];
+    // 2. Build regex patterns for different call kinds
+    // Escape the symbol name for regex (though Python names shouldn't have metacharacters)
+    const escaped = targetName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    // Patterns ordered by specificity (most specific first)
+    const patterns = [
+        // Celery: foo.delay(...) or foo.apply_async(...)
+        { re: new RegExp(`\\b${escaped}\\.delay\\s*\\(`), kind: "delay" },
+        { re: new RegExp(`\\b${escaped}\\.apply_async\\s*\\(`), kind: "apply_async" },
+        // Method call: X.foo(...)
+        { re: new RegExp(`\\b\\w+\\.${escaped}\\s*\\(`), kind: "method" },
+        // Direct call: foo(...)
+        { re: new RegExp(`\\b${escaped}\\s*\\(`), kind: "direct" },
+        // Reference (no call): foo (as arg, assignment, etc.)
+        { re: new RegExp(`\\b${escaped}\\b`), kind: "reference" },
+    ];
+    // 3. Scan all Python symbols for callers
+    const callers = [];
+    const filesSeen = new Set();
+    const filePattern = options?.file_pattern;
+    for (const sym of index.symbols) {
+        if (callers.length >= maxResults)
+            break;
+        if (!sym.file.endsWith(".py"))
+            continue;
+        if (sym.file === targetSymbol.file && sym.name === targetSymbol.name)
+            continue; // skip self
+        if (filePattern && !sym.file.includes(filePattern))
+            continue;
+        if (!sym.source)
+            continue;
+        // Find first matching pattern (most specific wins)
+        let matched = null;
+        for (const { re, kind } of patterns) {
+            re.lastIndex = 0;
+            const m = re.exec(sym.source);
+            if (m) {
+                // Extract the matching line for context
+                const lineStart = sym.source.lastIndexOf("\n", m.index) + 1;
+                const lineEnd = sym.source.indexOf("\n", m.index);
+                const line = sym.source.slice(lineStart, lineEnd === -1 ? undefined : lineEnd).trim();
+                matched = { kind, context: line.slice(0, 200) };
+                break;
+            }
+        }
+        if (!matched)
+            continue;
+        // Count how many lines into the symbol the match occurred
+        const matchIdx = patterns.find((p) => p.re.test(sym.source))?.re.exec(sym.source)?.index ?? 0;
+        const linesBefore = sym.source.slice(0, matchIdx).split("\n").length - 1;
+        callers.push({
+            caller_symbol: sym.name,
+            caller_kind: sym.kind,
+            caller_file: sym.file,
+            caller_line: sym.start_line + linesBefore,
+            call_kind: matched.kind,
+            context: matched.context,
+        });
+        filesSeen.add(sym.file);
+    }
+    return {
+        target: {
+            name: targetSymbol.name,
+            file: targetSymbol.file,
+            kind: targetSymbol.kind,
+        },
+        callers,
+        caller_count: callers.length,
+        called_from_files: [...filesSeen].sort(),
+    };
+}
+//# sourceMappingURL=python-callers.js.map

package/dist/tools/python-callers.js.map

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

package/dist/tools/python-circular-imports.d.ts

@@ -0,0 +1,19 @@
+export interface CircularImportCycle {
+    cycle: string[];
+    length: number;
+    severity: "error" | "warning";
+    note: string;
+}
+export interface CircularImportsResult {
+    cycles: CircularImportCycle[];
+    total: number;
+    files_scanned: number;
+}
+/**
+ * Find all Python circular imports in the repository.
+ */
+export declare function findPythonCircularImports(repo: string, options?: {
+    file_pattern?: string;
+    max_cycles?: number;
+}): Promise<CircularImportsResult>;
+//# sourceMappingURL=python-circular-imports.d.ts.map

package/dist/tools/python-circular-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-circular-imports.d.ts","sourceRoot":"","sources":["../../src/tools/python-circular-imports.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GACA,OAAO,CAAC,qBAAqB,CAAC,CAyGhC"}

package/dist/tools/python-circular-imports.js

@@ -0,0 +1,126 @@
+/**
+ * find_python_circular_imports — detect Python import cycles with full paths.
+ *
+ * Python circular imports cause runtime ImportError — unlike JS where
+ * hoisted imports usually work. This tool uses the Python import graph
+ * (from python-imports.ts + python-import-resolver.ts) to build a file→file
+ * adjacency and find cycles via DFS.
+ *
+ * Reports the full cycle path so users can identify which edge to break.
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { getCodeIndex } from "./index-tools.js";
+import { getParser } from "../parser/parser-manager.js";
+import { extractPythonImports } from "../utils/python-imports.js";
+import { resolvePythonImport, detectSrcLayout } from "../utils/python-import-resolver.js";
+/**
+ * Find all Python circular imports in the repository.
+ */
+export async function findPythonCircularImports(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found.`);
+    const filePattern = options?.file_pattern;
+    const maxCycles = options?.max_cycles ?? 50;
+    // Collect Python files
+    const pyFiles = index.files
+        .filter((f) => f.path.endsWith(".py"))
+        .filter((f) => !filePattern || f.path.includes(filePattern))
+        .map((f) => f.path);
+    const pyFileSet = new Set(pyFiles);
+    const srcLayout = detectSrcLayout(pyFiles);
+    // Build file → file adjacency via extractPythonImports + resolvePythonImport
+    const adjacency = new Map();
+    const parser = await getParser("python");
+    if (!parser) {
+        return { cycles: [], total: 0, files_scanned: 0 };
+    }
+    for (const filePath of pyFiles) {
+        let source;
+        try {
+            source = await readFile(join(index.root, filePath), "utf-8");
+        }
+        catch {
+            continue;
+        }
+        const tree = parser.parse(source);
+        const imports = extractPythonImports(tree);
+        const outgoing = new Set();
+        for (const imp of imports) {
+            // Skip type-only imports (not a runtime cycle)
+            if (imp.is_type_only)
+                continue;
+            const resolved = resolvePythonImport({ module: imp.module, level: imp.level }, filePath, pyFileSet, srcLayout);
+            if (resolved && resolved !== filePath && pyFileSet.has(resolved)) {
+                outgoing.add(resolved);
+            }
+        }
+        adjacency.set(filePath, outgoing);
+    }
+    // Find all cycles via DFS
+    const cycles = [];
+    const cycleSignatures = new Set();
+    function dfs(node, visited, path) {
+        if (cycles.length >= maxCycles)
+            return;
+        if (visited.has(node)) {
+            // Found a cycle — extract from path
+            const cycleStart = path.indexOf(node);
+            if (cycleStart === -1)
+                return;
+            const cycle = [...path.slice(cycleStart), node];
+            // Canonicalize for dedup (start from lexicographically smallest)
+            const sig = canonicalizeCycle(cycle);
+            if (cycleSignatures.has(sig))
+                return;
+            cycleSignatures.add(sig);
+            cycles.push({
+                cycle,
+                length: cycle.length - 1,
+                severity: cycle.length <= 3 ? "error" : "warning",
+                note: cycle.length <= 3
+                    ? "Short cycle — likely causes ImportError at runtime"
+                    : "Long cycle — may work if imports are inside functions/methods",
+            });
+            return;
+        }
+        visited.add(node);
+        path.push(node);
+        const neighbors = adjacency.get(node);
+        if (neighbors) {
+            for (const next of neighbors) {
+                dfs(next, new Set(visited), [...path]);
+            }
+        }
+    }
+    for (const start of pyFiles) {
+        if (cycles.length >= maxCycles)
+            break;
+        dfs(start, new Set(), []);
+    }
+    return {
+        cycles,
+        total: cycles.length,
+        files_scanned: pyFiles.length,
+    };
+}
+/**
+ * Canonicalize a cycle for dedup: rotate to start from the lex-smallest node.
+ */
+function canonicalizeCycle(cycle) {
+    if (cycle.length < 2)
+        return cycle.join("->");
+    // Drop the repeated last element
+    const core = cycle.slice(0, -1);
+    // Find the lex-smallest start
+    let minIdx = 0;
+    for (let i = 1; i < core.length; i++) {
+        if (core[i] < core[minIdx])
+            minIdx = i;
+    }
+    const rotated = [...core.slice(minIdx), ...core.slice(0, minIdx)];
+    rotated.push(rotated[0]);
+    return rotated.join("->");
+}
+//# sourceMappingURL=python-circular-imports.js.map

package/dist/tools/python-circular-imports.js.map

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

package/dist/tools/python-constants-tools.d.ts

@@ -0,0 +1,44 @@
+import type { CodeSymbol } from "../types.js";
+export type PythonLiteralKind = "string" | "integer" | "float" | "boolean" | "null" | "list" | "tuple" | "dict";
+export interface PythonLiteralObject {
+    [key: string]: PythonLiteralValue;
+}
+export type PythonLiteralValue = string | number | boolean | null | PythonLiteralValue[] | PythonLiteralObject;
+export interface ResolutionHop {
+    name: string;
+    file: string;
+    line: number;
+}
+export interface ResolvedDefaultParameter {
+    name: string;
+    resolved: boolean;
+    value_kind?: PythonLiteralKind;
+    value?: PythonLiteralValue;
+    value_text: string;
+    confidence: "high" | "medium" | "low";
+    alias_chain: ResolutionHop[];
+    reason?: string;
+}
+export interface ConstantResolutionMatch {
+    symbol_name: string;
+    symbol_kind: CodeSymbol["kind"];
+    file: string;
+    line: number;
+    resolved: boolean;
+    value_kind?: PythonLiteralKind;
+    value?: PythonLiteralValue;
+    value_text?: string;
+    default_parameters?: ResolvedDefaultParameter[];
+    confidence: "high" | "medium" | "low";
+    alias_chain: ResolutionHop[];
+    reason?: string;
+}
+export interface ConstantResolutionResult {
+    query: string;
+    matches: ConstantResolutionMatch[];
+}
+export declare function resolveConstantValue(repo: string, symbolName: string, options?: {
+    file_pattern?: string;
+    max_depth?: number;
+}): Promise<ConstantResolutionResult>;
+//# sourceMappingURL=python-constants-tools.d.ts.map

package/dist/tools/python-constants-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-constants-tools.d.ts","sourceRoot":"","sources":["../../src/tools/python-constants-tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzD,MAAM,MAAM,iBAAiB,GACzB,QAAQ,GACR,SAAS,GACT,OAAO,GACP,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,GACP,MAAM,CAAC;AAEX,MAAM,WAAW,mBAAmB;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAC;CACnC;AAED,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,kBAAkB,EAAE,GACpB,mBAAmB,CAAC;AAExB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,wBAAwB,EAAE,CAAC;IAChD,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,WAAW,EAAE,aAAa,EAAE,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,uBAAuB,EAAE,CAAC;CACpC;AAsjBD,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC,wBAAwB,CAAC,CAiCnC"}