codesift-mcp 0.3.0 → 0.5.0

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

@@ -0,0 +1,23 @@
+export interface PyprojectInfo {
+    name?: string;
+    version?: string;
+    requires_python?: string;
+    build_system?: string;
+    dependencies: Array<{
+        name: string;
+        version: string;
+    }>;
+    optional_dependencies: Record<string, string[]>;
+    scripts: Record<string, string>;
+    configured_tools: string[];
+    source_file: string;
+}
+/**
+ * Parse pyproject.toml from the repository root.
+ */
+export declare function parsePyproject(repo: string): Promise<PyprojectInfo | null>;
+/**
+ * Parse pyproject.toml content string. Exported for testing.
+ */
+export declare function parsePyprojectContent(content: string, sourcePath: string): PyprojectInfo;
+//# sourceMappingURL=pyproject-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pyproject-tools.d.ts","sourceRoot":"","sources":["../../src/tools/pyproject-tools.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAa/B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,aAAa,CAwDf"}

package/dist/tools/pyproject-tools.js

@@ -0,0 +1,133 @@
+/**
+ * pyproject.toml parsing — extract dependencies, Python version,
+ * build system, configured tools, and entry points.
+ *
+ * Uses simple regex-based TOML parsing for the key sections.
+ * Does not require a full TOML parser dependency.
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { getCodeIndex } from "./index-tools.js";
+/**
+ * Parse pyproject.toml from the repository root.
+ */
+export async function parsePyproject(repo) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found.`);
+    const filePath = join(index.root, "pyproject.toml");
+    let content;
+    try {
+        content = await readFile(filePath, "utf-8");
+    }
+    catch {
+        return null; // No pyproject.toml found
+    }
+    return parsePyprojectContent(content, "pyproject.toml");
+}
+/**
+ * Parse pyproject.toml content string. Exported for testing.
+ */
+export function parsePyprojectContent(content, sourcePath) {
+    const info = {
+        dependencies: [],
+        optional_dependencies: {},
+        scripts: {},
+        configured_tools: [],
+        source_file: sourcePath,
+    };
+    // [project] section
+    const name = extractValue(content, "name");
+    if (name)
+        info.name = name;
+    const version = extractValue(content, "version");
+    if (version)
+        info.version = version;
+    const requiresPython = extractValue(content, "requires-python");
+    if (requiresPython)
+        info.requires_python = requiresPython;
+    // [build-system]
+    const buildReq = extractValue(content, "build-backend");
+    if (buildReq) {
+        info.build_system = buildReq;
+    }
+    // dependencies = [...] — multi-line TOML array (may contain [] in extras like pydantic[email])
+    const depsMatch = content.match(/^dependencies\s*=\s*\[([\s\S]*?)\n\]/m);
+    if (depsMatch) {
+        info.dependencies = parseDependencyList(depsMatch[1]);
+    }
+    // [project.optional-dependencies]
+    const optDepsSection = extractSection(content, "project.optional-dependencies");
+    if (optDepsSection) {
+        const optGroups = optDepsSection.matchAll(/^(\w[\w-]*)\s*=\s*\[([\s\S]*?)\n\]/gm);
+        for (const m of optGroups) {
+            const groupName = m[1];
+            const deps = parseDependencyNames(m[2]);
+            info.optional_dependencies[groupName] = deps;
+        }
+    }
+    // [project.scripts]
+    const scriptsSection = extractSection(content, "project.scripts");
+    if (scriptsSection) {
+        const entries = scriptsSection.matchAll(/^([\w][\w-]*)\s*=\s*"([^"]+)"/gm);
+        for (const m of entries) {
+            info.scripts[m[1]] = m[2];
+        }
+    }
+    // Detect configured tools
+    const toolSections = content.matchAll(/^\[tool\.(\w+)/gm);
+    for (const m of toolSections) {
+        info.configured_tools.push(m[1]);
+    }
+    return info;
+}
+// --- Helpers ---
+function extractValue(content, key) {
+    const re = new RegExp(`^${key.replace("-", "[-_]")}\\s*=\\s*"([^"]*)"`, "m");
+    const match = re.exec(content);
+    return match?.[1];
+}
+function extractSection(content, sectionName) {
+    const escaped = sectionName.replace(/\./g, "\\.");
+    const headerIdx = content.search(new RegExp(`^\\[${escaped}\\]`, "m"));
+    if (headerIdx === -1)
+        return undefined;
+    // Find the start of content (after the [section] line)
+    const afterHeader = content.indexOf("\n", headerIdx);
+    if (afterHeader === -1)
+        return undefined;
+    // Find the next section header or end of content
+    const nextSection = content.slice(afterHeader + 1).search(/^\[/m);
+    if (nextSection === -1)
+        return content.slice(afterHeader + 1);
+    return content.slice(afterHeader + 1, afterHeader + 1 + nextSection);
+}
+function parseDependencyList(block) {
+    const deps = [];
+    const entries = block.matchAll(/["']([^"']+)["']/g);
+    for (const m of entries) {
+        const raw = m[1];
+        const parsed = parseDependencySpec(raw);
+        if (parsed)
+            deps.push(parsed);
+    }
+    return deps;
+}
+function parseDependencyNames(block) {
+    const names = [];
+    const entries = block.matchAll(/["']([^"']+)["']/g);
+    for (const m of entries) {
+        const name = m[1].split(/[><=~!;@\[]/)[0].trim();
+        if (name)
+            names.push(name);
+    }
+    return names;
+}
+function parseDependencySpec(raw) {
+    // Examples: "django>=4.2", "flask~=3.0", "requests", "pydantic[email]>=2.0"
+    const match = raw.match(/^([a-zA-Z0-9][\w.-]*)(?:\[[\w,]+\])?\s*(.*)/);
+    if (!match)
+        return null;
+    return { name: match[1], version: match[2]?.trim() || "*" };
+}
+//# sourceMappingURL=pyproject-tools.js.map

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

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

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

@@ -0,0 +1,20 @@
+export interface FixtureInfo {
+    name: string;
+    file: string;
+    line: number;
+    scope: "function" | "class" | "module" | "session" | "package";
+    autouse: boolean;
+    depends_on: string[];
+}
+export interface FixtureGraph {
+    fixtures: FixtureInfo[];
+    conftest_files: string[];
+    fixture_count: number;
+}
+/**
+ * Extract pytest fixture dependency graph from a repository.
+ */
+export declare function getTestFixtures(repo: string, options?: {
+    file_pattern?: string;
+}): Promise<FixtureGraph>;
+//# sourceMappingURL=pytest-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pytest-tools.d.ts","sourceRoot":"","sources":["../../src/tools/pytest-tools.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IAC/D,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;CACvB;AAUD;;GAEG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GACA,OAAO,CAAC,YAAY,CAAC,CAuDvB"}

package/dist/tools/pytest-tools.js

@@ -0,0 +1,106 @@
+/**
+ * pytest fixture dependency graph extraction.
+ * Scans conftest.py hierarchy, extracts fixtures with scope, autouse,
+ * and dependencies (fixture parameters that reference other fixtures).
+ */
+import { getCodeIndex } from "./index-tools.js";
+// Known pytest built-in fixtures (skip as dependencies)
+const BUILTIN_FIXTURES = new Set([
+    "request", "tmp_path", "tmp_path_factory", "tmpdir", "tmpdir_factory",
+    "capsys", "capfd", "capsysbinary", "capfdbinary", "caplog",
+    "monkeypatch", "recwarn", "pytestconfig", "cache", "record_property",
+    "record_testsuite_property", "record_xml_attribute",
+]);
+/**
+ * Extract pytest fixture dependency graph from a repository.
+ */
+export async function getTestFixtures(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found.`);
+    const filePattern = options?.file_pattern;
+    // Find all fixture symbols (kind === "test_hook")
+    const fixtureSymbols = index.symbols.filter((s) => {
+        if (s.kind !== "test_hook")
+            return false;
+        if (!s.file.endsWith(".py"))
+            return false;
+        if (filePattern && !s.file.includes(filePattern))
+            return false;
+        return true;
+    });
+    // Find conftest files
+    const conftestFiles = [
+        ...new Set(index.files
+            .filter((f) => f.path.endsWith("conftest.py"))
+            .map((f) => f.path)
+            .sort()),
+    ];
+    // Build fixture name set for dependency resolution
+    const fixtureNames = new Set(fixtureSymbols.map((s) => s.name));
+    const fixtures = fixtureSymbols.map((sym) => {
+        const source = sym.source ?? "";
+        const decorators = sym.decorators ?? [];
+        // Extract scope from decorator args
+        const scope = extractScope(decorators, source);
+        // Extract autouse from decorator args
+        const autouse = extractAutouse(decorators, source);
+        // Extract dependencies from function parameters
+        const depends_on = extractDependencies(sym, fixtureNames);
+        return {
+            name: sym.name,
+            file: sym.file,
+            line: sym.start_line,
+            scope,
+            autouse,
+            depends_on,
+        };
+    });
+    return {
+        fixtures,
+        conftest_files: conftestFiles,
+        fixture_count: fixtures.length,
+    };
+}
+function extractScope(decorators, source) {
+    // Check decorator args: @pytest.fixture(scope="session")
+    for (const dec of decorators) {
+        const scopeMatch = dec.match(/scope\s*=\s*['"](\w+)['"]/);
+        if (scopeMatch) {
+            const s = scopeMatch[1];
+            if (["function", "class", "module", "session", "package"].includes(s)) {
+                return s;
+            }
+        }
+    }
+    // Also check source for scope in case decorator text doesn't capture it
+    const srcMatch = source.match(/scope\s*=\s*['"](\w+)['"]/);
+    if (srcMatch) {
+        const s = srcMatch[1];
+        if (["function", "class", "module", "session", "package"].includes(s)) {
+            return s;
+        }
+    }
+    return "function"; // pytest default
+}
+function extractAutouse(decorators, source) {
+    for (const dec of decorators) {
+        if (dec.includes("autouse=True") || dec.includes("autouse=true"))
+            return true;
+    }
+    return source.includes("autouse=True") || source.includes("autouse=true");
+}
+function extractDependencies(sym, knownFixtures) {
+    const sig = sym.signature ?? "";
+    // Extract parameter names from the function signature
+    const paramMatch = sig.match(/\(([^)]*)\)/);
+    if (!paramMatch)
+        return [];
+    const params = paramMatch[1]
+        .split(",")
+        .map((p) => p.trim().split(":")[0].split("=")[0].trim())
+        .filter((p) => p.length > 0 && p !== "self" && p !== "cls");
+    // Filter to known fixtures (excluding builtins unless they're custom-defined)
+    return params.filter((p) => (knownFixtures.has(p) || BUILTIN_FIXTURES.has(p)) && p !== sym.name);
+}
+//# sourceMappingURL=pytest-tools.js.map

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

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

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

@@ -0,0 +1,40 @@
+export interface PythonAuditGate {
+    name: string;
+    status: "ok" | "error" | "timeout" | "skipped";
+    findings_count: number;
+    duration_ms: number;
+    error?: string;
+}
+export interface PythonAuditResult {
+    repo: string;
+    duration_ms: number;
+    checks_run: string[];
+    gates: PythonAuditGate[];
+    summary: {
+        total_findings: number;
+        critical: number;
+        high: number;
+        medium: number;
+        low: number;
+        health_score: number;
+        top_risks: string[];
+    };
+    findings: {
+        circular_imports?: number;
+        django_critical?: number;
+        django_high?: number;
+        anti_patterns?: number;
+        orphan_tasks?: number;
+        unpinned_deps?: number;
+        dead_code?: number;
+        fixture_count?: number;
+    };
+}
+/**
+ * Run a compound Python project audit: 8 parallel checks with unified scoring.
+ */
+export declare function pythonAudit(repo: string, options?: {
+    file_pattern?: string;
+    checks?: string[];
+}): Promise<PythonAuditResult>;
+//# sourceMappingURL=python-audit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"python-audit.d.ts","sourceRoot":"","sources":["../../src/tools/python-audit.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAC/C,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IACF,QAAQ,EAAE;QACR,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAoCD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,GACA,OAAO,CAAC,iBAAiB,CAAC,CA0N5B"}

package/dist/tools/python-audit.js

@@ -0,0 +1,244 @@
+/**
+ * python_audit — compound Python project health check.
+ *
+ * Runs 8 checks in parallel with per-check timeouts:
+ *   1. Circular imports (find_python_circular_imports)
+ *   2. Django settings (analyze_django_settings) — only if Django project
+ *   3. Python anti-patterns (search_patterns across 17 Python patterns)
+ *   4. Framework wiring (find_framework_wiring)
+ *   5. Celery orphan tasks (trace_celery_chain)
+ *   6. pytest fixture issues (get_test_fixtures)
+ *   7. pyproject dependency freshness (parse_pyproject)
+ *   8. Dead code (find_dead_code on Python files)
+ *
+ * Produces a unified health score (0-100), severity counts, and a
+ * prioritized top_risks list. Mirrors the shape of php_project_audit
+ * so downstream report tooling can reuse formatters.
+ */
+import { getCodeIndex } from "./index-tools.js";
+import { findPythonCircularImports } from "./python-circular-imports.js";
+import { analyzeDjangoSettings } from "./django-settings.js";
+import { searchPatterns } from "./pattern-tools.js";
+import { findFrameworkWiring } from "./wiring-tools.js";
+import { traceCeleryChain } from "./celery-tools.js";
+import { getTestFixtures } from "./pytest-tools.js";
+import { parsePyproject } from "./pyproject-tools.js";
+const AUDIT_TIMEOUT = 10000;
+const PYTHON_PATTERNS = [
+    "mutable-default",
+    "bare-except",
+    "broad-except",
+    "eval-exec",
+    "shell-true",
+    "pickle-load",
+    "yaml-unsafe",
+    "shadow-builtin",
+    "n-plus-one-django",
+    "late-binding",
+    "assert-tuple",
+];
+/** Run one check with timeout and capture result + duration. */
+async function runCheck(name, fn) {
+    const start = Date.now();
+    try {
+        const result = await Promise.race([
+            fn(),
+            new Promise((resolve) => setTimeout(() => resolve("TIMEOUT"), AUDIT_TIMEOUT)),
+        ]);
+        return { name, result, ms: Date.now() - start };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { name, result: "ERROR", ms: Date.now() - start, error: msg };
+    }
+}
+/**
+ * Run a compound Python project audit: 8 parallel checks with unified scoring.
+ */
+export async function pythonAudit(repo, options) {
+    const startTime = Date.now();
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found.`);
+    // Detect if this is a Django project (only then run django settings check)
+    const hasDjangoFiles = index.files.some((f) => /\/settings\.py$|\/settings\/[\w_]+\.py$/.test(f.path));
+    const allChecks = [
+        "circular_imports",
+        "django_settings",
+        "anti_patterns",
+        "framework_wiring",
+        "celery",
+        "pytest_fixtures",
+        "dependencies",
+        "dead_code",
+    ];
+    const enabled = new Set(options?.checks ?? allChecks);
+    const tasks = [];
+    if (enabled.has("circular_imports")) {
+        tasks.push(runCheck("circular_imports", () => findPythonCircularImports(repo, options?.file_pattern ? { file_pattern: options.file_pattern } : undefined)));
+    }
+    if (enabled.has("django_settings") && hasDjangoFiles) {
+        tasks.push(runCheck("django_settings", () => analyzeDjangoSettings(repo)));
+    }
+    if (enabled.has("anti_patterns")) {
+        // Run all Python patterns in parallel, aggregate counts
+        tasks.push(runCheck("anti_patterns", async () => {
+            const results = await Promise.all(PYTHON_PATTERNS.map((p) => searchPatterns(repo, p, options?.file_pattern ? { file_pattern: options.file_pattern } : undefined)
+                .catch(() => ({ matches: [] }))));
+            const allMatches = results.flatMap((r) => r.matches ?? []);
+            return { matches: allMatches, total: allMatches.length };
+        }));
+    }
+    if (enabled.has("framework_wiring")) {
+        tasks.push(runCheck("framework_wiring", () => findFrameworkWiring(repo, options?.file_pattern ? { file_pattern: options.file_pattern } : undefined)));
+    }
+    if (enabled.has("celery")) {
+        tasks.push(runCheck("celery", () => traceCeleryChain(repo, options?.file_pattern ? { file_pattern: options.file_pattern } : undefined)));
+    }
+    if (enabled.has("pytest_fixtures")) {
+        tasks.push(runCheck("pytest_fixtures", () => getTestFixtures(repo, options?.file_pattern ? { file_pattern: options.file_pattern } : undefined)));
+    }
+    if (enabled.has("dependencies")) {
+        tasks.push(runCheck("dependencies", () => parsePyproject(repo)));
+    }
+    if (enabled.has("dead_code")) {
+        tasks.push(runCheck("dead_code", async () => {
+            const { findDeadCode } = await import("./symbol-tools.js");
+            return findDeadCode(repo, { file_pattern: ".py" });
+        }));
+    }
+    const results = await Promise.all(tasks);
+    // Build gates + aggregate findings
+    const gates = [];
+    const findings = {};
+    let critical = 0;
+    let high = 0;
+    let medium = 0;
+    let low = 0;
+    for (const r of results) {
+        if (r.result === "TIMEOUT") {
+            gates.push({ name: r.name, status: "timeout", findings_count: 0, duration_ms: r.ms });
+            continue;
+        }
+        if (r.result === "ERROR") {
+            const g = { name: r.name, status: "error", findings_count: 0, duration_ms: r.ms };
+            if (r.error)
+                g.error = r.error;
+            gates.push(g);
+            continue;
+        }
+        let count = 0;
+        const res = r.result;
+        switch (r.name) {
+            case "circular_imports": {
+                count = res.total ?? 0;
+                findings.circular_imports = count;
+                // Short cycles (≤3) are errors — count as high severity
+                const cycles = res.cycles ?? [];
+                high += cycles.filter((c) => c.severity === "error").length;
+                medium += cycles.filter((c) => c.severity === "warning").length;
+                break;
+            }
+            case "django_settings": {
+                const dj = res;
+                count = dj.findings?.length ?? 0;
+                findings.django_critical = dj.by_severity?.critical ?? 0;
+                findings.django_high = dj.by_severity?.high ?? 0;
+                critical += dj.by_severity?.critical ?? 0;
+                high += dj.by_severity?.high ?? 0;
+                medium += dj.by_severity?.medium ?? 0;
+                low += dj.by_severity?.low ?? 0;
+                break;
+            }
+            case "anti_patterns": {
+                count = res.total ?? 0;
+                findings.anti_patterns = count;
+                // All Python anti-patterns are medium unless proven otherwise
+                medium += count;
+                break;
+            }
+            case "framework_wiring": {
+                // Informational — not a finding
+                count = 0;
+                break;
+            }
+            case "celery": {
+                const orphans = res.orphan_tasks ?? [];
+                count = orphans.length;
+                findings.orphan_tasks = count;
+                low += count;
+                break;
+            }
+            case "pytest_fixtures": {
+                // Informational
+                count = 0;
+                findings.fixture_count = res.fixture_count ?? 0;
+                break;
+            }
+            case "dependencies": {
+                if (res && typeof res === "object" && "dependencies" in res) {
+                    const deps = res.dependencies ?? [];
+                    const unpinned = deps.filter((d) => d.version === "*" || d.version === "").length;
+                    count = unpinned;
+                    findings.unpinned_deps = unpinned;
+                    low += unpinned;
+                }
+                break;
+            }
+            case "dead_code": {
+                const candidates = res.candidates ?? [];
+                count = candidates.length;
+                findings.dead_code = count;
+                low += count;
+                break;
+            }
+        }
+        gates.push({ name: r.name, status: "ok", findings_count: count, duration_ms: r.ms });
+    }
+    // Skipped checks (not run because not applicable)
+    if (enabled.has("django_settings") && !hasDjangoFiles) {
+        gates.push({ name: "django_settings", status: "skipped", findings_count: 0, duration_ms: 0 });
+    }
+    // Compute health score: 100 - weighted penalties
+    //   critical = -15, high = -8, medium = -3, low = -1, floor at 0
+    const rawScore = 100 - critical * 15 - high * 8 - medium * 3 - low;
+    const health_score = Math.max(0, Math.min(100, rawScore));
+    const total_findings = critical + high + medium + low;
+    // Top risks: most severe categories first
+    const top_risks = [];
+    if ((findings.django_critical ?? 0) > 0) {
+        top_risks.push(`Django: ${findings.django_critical} critical security issues in settings.py`);
+    }
+    if ((findings.circular_imports ?? 0) > 0) {
+        top_risks.push(`${findings.circular_imports} circular import cycles detected`);
+    }
+    if ((findings.anti_patterns ?? 0) > 5) {
+        top_risks.push(`${findings.anti_patterns} Python anti-pattern matches`);
+    }
+    if ((findings.orphan_tasks ?? 0) > 0) {
+        top_risks.push(`${findings.orphan_tasks} orphan Celery tasks (defined but never called)`);
+    }
+    if ((findings.unpinned_deps ?? 0) > 0) {
+        top_risks.push(`${findings.unpinned_deps} unpinned dependencies`);
+    }
+    if ((findings.dead_code ?? 0) > 10) {
+        top_risks.push(`${findings.dead_code} dead code candidates`);
+    }
+    return {
+        repo,
+        duration_ms: Date.now() - startTime,
+        checks_run: gates.map((g) => g.name),
+        gates,
+        summary: {
+            total_findings,
+            critical,
+            high,
+            medium,
+            low,
+            health_score,
+            top_risks,
+        },
+        findings,
+    };
+}
+//# sourceMappingURL=python-audit.js.map

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

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

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"}