codesift-mcp 0.3.0 → 0.4.0

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

@@ -0,0 +1,28 @@
+export interface PythonCallerInfo {
+    caller_symbol: string;
+    caller_kind: string;
+    caller_file: string;
+    caller_line: number;
+    call_kind: "direct" | "method" | "delay" | "apply_async" | "constructor" | "reference";
+    context: string;
+}
+export interface PythonCallersResult {
+    target: {
+        name: string;
+        file: string;
+        kind: string;
+    };
+    callers: PythonCallerInfo[];
+    caller_count: number;
+    called_from_files: string[];
+}
+/**
+ * Find all Python call sites of a given symbol.
+ * The target is identified by name (+ optional file pattern to disambiguate).
+ */
+export declare function findPythonCallers(repo: string, targetName: string, options?: {
+    file_pattern?: string;
+    target_file?: string;
+    max_results?: number;
+}): Promise<PythonCallersResult>;
+//# sourceMappingURL=python-callers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"python-callers.d.ts","sourceRoot":"","sources":["../../src/tools/python-callers.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,aAAa,GAAG,aAAa,GAAG,WAAW,CAAC;IACvF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,OAAO,CAAC,mBAAmB,CAAC,CA8F9B"}

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-deps-analyzer.d.ts

@@ -0,0 +1,46 @@
+export interface DependencyStatus {
+    name: string;
+    declared_version: string;
+    latest_version?: string;
+    status: "current" | "outdated" | "major-outdated" | "unknown" | "unpinned";
+    severity?: "info" | "warning" | "error";
+    reason?: string;
+    vulnerabilities?: Array<{
+        id: string;
+        summary: string;
+        severity?: string;
+    }>;
+}
+export interface DepsAnalysisResult {
+    source: string;
+    total: number;
+    pypi_checked: boolean;
+    vuln_checked: boolean;
+    dependencies: DependencyStatus[];
+    outdated_count: number;
+    unpinned_count: number;
+    vulnerable_count: number;
+}
+/**
+ * Analyze Python dependencies from pyproject.toml or requirements.txt.
+ */
+export declare function analyzePythonDeps(repo: string, options?: {
+    check_pypi?: boolean;
+    check_vulns?: boolean;
+    file_pattern?: string;
+}): Promise<DepsAnalysisResult>;
+/**
+ * Parse a requirements.txt file into name/version pairs.
+ * Exported for testing.
+ */
+export declare function parseRequirementsTxt(content: string): Array<{
+    name: string;
+    version: string;
+}>;
+/**
+ * Compare a version constraint to the latest version.
+ * Returns: "current", "outdated-minor", "outdated-major", or "unknown".
+ * Exported for testing.
+ */
+export declare function compareVersions(constraint: string, latest: string): "current" | "outdated-minor" | "outdated-major" | "unknown";
+//# sourceMappingURL=python-deps-analyzer.d.ts.map

package/dist/tools/python-deps-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-deps-analyzer.d.ts","sourceRoot":"","sources":["../../src/tools/python-deps-analyzer.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,gBAAgB,GAAG,SAAS,GAAG,UAAU,CAAC;IAC3E,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7E;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACA,OAAO,CAAC,kBAAkB,CAAC,CAuH7B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAgB9F;AAwDD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,SAAS,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,SAAS,CAe7D"}

package/dist/tools/python-deps-analyzer.js

@@ -0,0 +1,227 @@
+/**
+ * analyze_python_deps — Python dependency freshness and vulnerability check.
+ *
+ * Parses pyproject.toml (via parsePyproject) and optionally requirements.txt,
+ * then queries PyPI JSON API for latest versions to flag outdated packages.
+ * Optionally queries OSV.dev for known vulnerabilities.
+ *
+ * Runs offline-safe: if PyPI/OSV unreachable, returns what's in the manifest
+ * without upstream data (marked as "check_skipped").
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { getCodeIndex } from "./index-tools.js";
+import { parsePyproject } from "./pyproject-tools.js";
+/**
+ * Analyze Python dependencies from pyproject.toml or requirements.txt.
+ */
+export async function analyzePythonDeps(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found.`);
+    const checkPypi = options?.check_pypi ?? false;
+    const checkVulns = options?.check_vulns ?? false;
+    // First try pyproject.toml
+    let deps = [];
+    let source = "pyproject.toml";
+    try {
+        const info = await parsePyproject(repo);
+        if (info && info.dependencies.length > 0) {
+            deps = info.dependencies;
+        }
+    }
+    catch {
+        // Fall through to requirements.txt
+    }
+    // Fall back to requirements.txt
+    if (deps.length === 0) {
+        try {
+            const content = await readFile(join(index.root, "requirements.txt"), "utf-8");
+            deps = parseRequirementsTxt(content);
+            source = "requirements.txt";
+        }
+        catch {
+            return {
+                source: "none",
+                total: 0,
+                pypi_checked: false,
+                vuln_checked: false,
+                dependencies: [],
+                outdated_count: 0,
+                unpinned_count: 0,
+                vulnerable_count: 0,
+            };
+        }
+    }
+    // Analyze each dependency
+    const statuses = [];
+    let pypiChecked = false;
+    let vulnChecked = false;
+    for (const dep of deps) {
+        const status = {
+            name: dep.name,
+            declared_version: dep.version,
+            status: "unknown",
+        };
+        // Classify pin status
+        if (dep.version === "*" || dep.version === "") {
+            status.status = "unpinned";
+            status.severity = "warning";
+            status.reason = "No version constraint — any version allowed";
+        }
+        // Optional PyPI check
+        if (checkPypi) {
+            try {
+                const latest = await fetchLatestPypiVersion(dep.name);
+                if (latest) {
+                    status.latest_version = latest;
+                    pypiChecked = true;
+                    const compared = compareVersions(dep.version, latest);
+                    if (compared === "outdated-major") {
+                        status.status = "major-outdated";
+                        status.severity = "error";
+                        status.reason = `Major version behind: ${dep.version} vs ${latest}`;
+                    }
+                    else if (compared === "outdated-minor") {
+                        status.status = "outdated";
+                        status.severity = "warning";
+                        status.reason = `Minor/patch behind: ${dep.version} vs ${latest}`;
+                    }
+                    else if (compared === "current") {
+                        status.status = "current";
+                    }
+                }
+            }
+            catch {
+                // Network/API failure — leave as unknown
+            }
+        }
+        // Optional OSV vulnerability check
+        if (checkVulns) {
+            try {
+                const vulns = await fetchOsvVulnerabilities(dep.name, dep.version);
+                if (vulns.length > 0) {
+                    status.vulnerabilities = vulns;
+                    status.severity = "error";
+                    vulnChecked = true;
+                }
+            }
+            catch {
+                // Leave empty
+            }
+        }
+        statuses.push(status);
+    }
+    const outdated_count = statuses.filter((s) => s.status === "outdated" || s.status === "major-outdated").length;
+    const unpinned_count = statuses.filter((s) => s.status === "unpinned").length;
+    const vulnerable_count = statuses.filter((s) => s.vulnerabilities && s.vulnerabilities.length > 0).length;
+    return {
+        source,
+        total: statuses.length,
+        pypi_checked: pypiChecked,
+        vuln_checked: vulnChecked,
+        dependencies: statuses,
+        outdated_count,
+        unpinned_count,
+        vulnerable_count,
+    };
+}
+/**
+ * Parse a requirements.txt file into name/version pairs.
+ * Exported for testing.
+ */
+export function parseRequirementsTxt(content) {
+    const deps = [];
+    const lines = content.split("\n");
+    for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith("#"))
+            continue;
+        if (line.startsWith("-") || line.startsWith("git+") || line.startsWith("http"))
+            continue;
+        // Parse: `package==1.2.3`, `package>=1.2`, `package[extra]>=1.0`, `package`
+        const match = line.match(/^([a-zA-Z0-9][\w.-]*)(?:\[[\w,]+\])?\s*(.*?)(?:\s*(?:#.*)?)?$/);
+        if (!match)
+            continue;
+        const name = match[1];
+        const version = match[2]?.trim() || "*";
+        deps.push({ name, version });
+    }
+    return deps;
+}
+/**
+ * Fetch the latest version of a package from PyPI.
+ */
+async function fetchLatestPypiVersion(name) {
+    try {
+        const res = await fetch(`https://pypi.org/pypi/${encodeURIComponent(name)}/json`, {
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return data.info?.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Fetch known vulnerabilities for a package/version from OSV.dev.
+ */
+async function fetchOsvVulnerabilities(name, version) {
+    // Strip constraint operators (>=, ~=, etc.) to get a concrete version
+    const versionOnly = version.replace(/^[><=~!^]+\s*/, "").split(/[,;]/)[0].trim();
+    if (!versionOnly)
+        return [];
+    try {
+        const res = await fetch("https://api.osv.dev/v1/query", {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({
+                package: { name, ecosystem: "PyPI" },
+                version: versionOnly,
+            }),
+            signal: AbortSignal.timeout(8000),
+        });
+        if (!res.ok)
+            return [];
+        const data = (await res.json());
+        return (data.vulns ?? []).map((v) => {
+            const vuln = {
+                id: v.id,
+                summary: v.summary ?? "",
+            };
+            if (v.database_specific?.severity)
+                vuln.severity = v.database_specific.severity;
+            return vuln;
+        });
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Compare a version constraint to the latest version.
+ * Returns: "current", "outdated-minor", "outdated-major", or "unknown".
+ * Exported for testing.
+ */
+export function compareVersions(constraint, latest) {
+    // Extract the minimum version from the constraint
+    const versionMatch = constraint.match(/(\d+)\.(\d+)(?:\.(\d+))?/);
+    if (!versionMatch)
+        return "unknown";
+    const declaredMajor = Number(versionMatch[1]);
+    const declaredMinor = Number(versionMatch[2]);
+    const latestMatch = latest.match(/(\d+)\.(\d+)(?:\.(\d+))?/);
+    if (!latestMatch)
+        return "unknown";
+    const latestMajor = Number(latestMatch[1]);
+    const latestMinor = Number(latestMatch[2]);
+    if (latestMajor > declaredMajor)
+        return "outdated-major";
+    if (latestMajor === declaredMajor && latestMinor > declaredMinor)
+        return "outdated-minor";
+    return "current";
+}
+//# sourceMappingURL=python-deps-analyzer.js.map

package/dist/tools/python-deps-analyzer.js.map

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

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

@@ -0,0 +1,23 @@
+export interface ParsedQuery {
+    model: string;
+    method: string;
+    where?: Record<string, unknown> | undefined;
+    select?: string[] | undefined;
+    include?: string[] | undefined;
+    orderBy?: string[] | undefined;
+    take?: number | undefined;
+    skip?: number | undefined;
+}
+export interface ExplainQueryResult {
+    sql: string;
+    explain_command: string;
+    warnings: string[];
+    optimization_hints: string[];
+    parsed: ParsedQuery;
+}
+type Dialect = "postgresql" | "mysql" | "sqlite";
+export declare function explainQuery(code: string, options?: {
+    dialect?: Dialect;
+}): ExplainQueryResult;
+export {};
+//# sourceMappingURL=query-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-tools.d.ts","sourceRoot":"","sources":["../../src/tools/query-tools.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,KAAK,OAAO,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;AAmRjD,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9B,kBAAkB,CAYpB"}