codesift-mcp 0.3.0 → 0.5.0

package/dist/tools/astro-migration.js

@@ -0,0 +1,378 @@
+/**
+ * astro_migration_check — Astro v5 → v6 breaking change detector.
+ *
+ * Scans a project for 10 known breaking changes (AM01–AM10) and emits a
+ * structured migration report with per-issue effort estimates.
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+// ---------------------------------------------------------------------------
+// Effort → hours map
+// ---------------------------------------------------------------------------
+const EFFORT_HOURS = {
+    trivial: 0.1,
+    low: 0.5,
+    medium: 2,
+    high: 4,
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Read a file, returning null on any error. */
+async function safeReadFile(path) {
+    try {
+        return await readFile(path, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+/** Parse package.json and return it, or null. */
+async function readPackageJson(root) {
+    const content = await safeReadFile(join(root, "package.json"));
+    if (!content)
+        return null;
+    try {
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/** Extract semver string from a version range like "^4.0.0" → "4.0.0". */
+function parseVersion(raw) {
+    return raw.replace(/^[^0-9]*/, "").split("-")[0] ?? raw;
+}
+/**
+ * Simple grep over a list of source files.
+ * Returns { files: string[], count: number } for matches.
+ */
+function grepFiles(files, pattern) {
+    const hitFiles = [];
+    let count = 0;
+    for (const { path, content } of files) {
+        const matches = content.match(new RegExp(pattern.source, `${pattern.flags.includes("g") ? "" : "g"}${pattern.flags.replace("g", "")}`));
+        if (matches && matches.length > 0) {
+            hitFiles.push(path);
+            count += matches.length;
+        }
+    }
+    return { files: hitFiles, count };
+}
+// ---------------------------------------------------------------------------
+// File discovery
+// ---------------------------------------------------------------------------
+/** Extensions to scan for source-level checks. */
+const SOURCE_EXTENSIONS = new Set([
+    ".ts", ".tsx", ".js", ".jsx", ".mjs", ".cjs",
+    ".astro", ".md", ".mdx",
+]);
+/** Walk the project collecting relevant source files (capped for performance). */
+async function collectSourceFiles(root, maxFiles = 5000) {
+    const { walkDirectory } = await import("../utils/walk.js");
+    let paths;
+    try {
+        paths = await walkDirectory(root, {
+            fileFilter: (ext) => SOURCE_EXTENSIONS.has(ext),
+            maxFiles,
+            relative: true,
+        });
+    }
+    catch {
+        return [];
+    }
+    const results = [];
+    for (const relPath of paths) {
+        const content = await safeReadFile(join(root, relPath));
+        if (content !== null)
+            results.push({ path: relPath, content });
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Individual detectors
+// ---------------------------------------------------------------------------
+/**
+ * AM01 — Astro.glob() usage
+ * Replace with getCollection() or import.meta.glob()
+ */
+function detectAM01(files) {
+    const { files: hitFiles, count } = grepFiles(files, /Astro\.glob\s*\(/);
+    if (count === 0)
+        return null;
+    return {
+        code: "AM01",
+        category: "API removal",
+        severity: "error",
+        message: "Astro.glob() has been removed. Replace with getCollection() for content collections or import.meta.glob() for file imports.",
+        files: hitFiles,
+        count,
+        effort: "low",
+        migration_guide: "https://docs.astro.build/en/guides/upgrade-to/v6/#removed-astroglob",
+    };
+}
+/**
+ * AM02 — emitESMImage() usage
+ */
+function detectAM02(files) {
+    const { files: hitFiles, count } = grepFiles(files, /emitESMImage\s*\(/);
+    if (count === 0)
+        return null;
+    return {
+        code: "AM02",
+        category: "API removal",
+        severity: "error",
+        message: "emitESMImage() has been removed. Use the new image optimization API instead.",
+        files: hitFiles,
+        count,
+        effort: "low",
+        migration_guide: "https://docs.astro.build/en/guides/upgrade-to/v6/#removed-emitesmimage",
+    };
+}
+/**
+ * AM03 — <ViewTransitions /> component rename → <ClientRouter />
+ */
+function detectAM03(files) {
+    const { files: hitFiles, count } = grepFiles(files, /<ViewTransitions\s*\/?>/);
+    if (count === 0)
+        return null;
+    return {
+        code: "AM03",
+        category: "component rename",
+        severity: "error",
+        message: "<ViewTransitions /> has been renamed to <ClientRouter />. Update all usages and imports.",
+        files: hitFiles,
+        count,
+        effort: "trivial",
+        migration_guide: "https://docs.astro.build/en/guides/upgrade-to/v6/#renamed-viewtransitions-to-clientrouter",
+    };
+}
+/**
+ * AM04 — Legacy content config path: src/content/config.ts
+ * Should be moved to src/content.config.ts
+ */
+function detectAM04(root) {
+    const legacyPath = join(root, "src", "content", "config.ts");
+    if (!existsSync(legacyPath))
+        return null;
+    return {
+        code: "AM04",
+        category: "content collections",
+        severity: "warning",
+        message: "Legacy content config found at src/content/config.ts. Move to src/content.config.ts (project root) for Astro v6.",
+        files: ["src/content/config.ts"],
+        count: 1,
+        effort: "medium",
+        migration_guide: "https://docs.astro.build/en/guides/upgrade-to/v6/#new-content-collections-config-location",
+    };
+}
+/**
+ * AM05 — type: "content" or type: "data" in defineCollection (v5 syntax)
+ * Astro v6 uses a different collection type declaration.
+ */
+function detectAM05(files) {
+    const configFiles = files.filter((f) => f.path.includes("content.config") || f.path.includes("content/config"));
+    if (configFiles.length === 0)
+        return null;
+    const { files: hitFiles, count } = grepFiles(configFiles, /type\s*:\s*["'](content|data)["']/);
+    if (count === 0)
+        return null;
+    return {
+        code: "AM05",
+        category: "content collections",
+        severity: "warning",
+        message: "defineCollection with type: 'content' or type: 'data' uses v5 syntax. Update to v6 collection type API.",
+        files: hitFiles,
+        count,
+        effort: "medium",
+        migration_guide: "https://docs.astro.build/en/guides/upgrade-to/v6/#content-collections-api-changes",
+    };
+}
+/**
+ * AM06 — engines.node < 22 in package.json
+ */
+function detectAM06(pkg) {
+    if (!pkg)
+        return null;
+    const engines = pkg["engines"];
+    if (!engines?.node)
+        return null;
+    // Extract minimum version number from range like ">=18", "^18", "18", ">=18.0.0"
+    const nodeRange = engines.node;
+    const match = nodeRange.match(/(\d+)/);
+    if (!match)
+        return null;
+    const minVersion = parseInt(match[1] ?? "0", 10);
+    if (minVersion >= 22)
+        return null;
+    return {
+        code: "AM06",
+        category: "node version",
+        severity: "error",
+        message: `engines.node is "${nodeRange}" but Astro v6 requires Node.js >= 22. Update your package.json and CI configuration.`,
+        files: ["package.json"],
+        count: 1,
+        effort: "low",
+        migration_guide: "https://docs.astro.build/en/guides/upgrade-to/v6/#nodejs-22-minimum",
+    };
+}
+/**
+ * AM07 — .refine() usage (may need updates for Zod 4 compatibility)
+ */
+function detectAM07(files) {
+    const { files: hitFiles, count } = grepFiles(files, /\.refine\s*\(/);
+    if (count === 0)
+        return null;
+    return {
+        code: "AM07",
+        category: "Zod 3",
+        severity: "warning",
+        message: ".refine() usage detected. Review for Zod 4 compatibility — the API may have changed for complex refinements.",
+        files: hitFiles,
+        count,
+        effort: "medium",
+        migration_guide: "https://zod.dev/v4",
+    };
+}
+/**
+ * AM08 — .nonempty() deprecated → .min(1)
+ */
+function detectAM08(files) {
+    const { files: hitFiles, count } = grepFiles(files, /\.nonempty\s*\(/);
+    if (count === 0)
+        return null;
+    return {
+        code: "AM08",
+        category: "Zod 3",
+        severity: "warning",
+        message: ".nonempty() is deprecated in Zod 4. Replace with .min(1).",
+        files: hitFiles,
+        count,
+        effort: "low",
+        migration_guide: "https://zod.dev/v4#nonempty-deprecated",
+    };
+}
+/**
+ * AM09 — output: "hybrid" in astro.config.* (now the default, no longer needed)
+ */
+function detectAM09(files) {
+    const configFiles = files.filter((f) => /astro\.config\.(mjs|ts|cjs|js)$/.test(f.path));
+    const { files: hitFiles, count } = grepFiles(configFiles, /output\s*:\s*["']hybrid["']/);
+    if (count === 0)
+        return null;
+    return {
+        code: "AM09",
+        category: "output mode",
+        severity: "info",
+        message: "output: 'hybrid' is now the default in Astro v6. You can remove this explicit setting.",
+        files: hitFiles,
+        count,
+        effort: "low",
+        migration_guide: "https://docs.astro.build/en/guides/upgrade-to/v6/#hybrid-output-is-now-default",
+    };
+}
+/**
+ * AM10 — @astrojs/lit imported (integration removed in v6)
+ */
+function detectAM10(pkg) {
+    if (!pkg)
+        return null;
+    const deps = {
+        ...(pkg["dependencies"] ?? {}),
+        ...(pkg["devDependencies"] ?? {}),
+        ...(pkg["peerDependencies"] ?? {}),
+    };
+    if (!deps["@astrojs/lit"])
+        return null;
+    return {
+        code: "AM10",
+        category: "integration",
+        severity: "error",
+        message: "@astrojs/lit has been removed in Astro v6. Use Lit directly without the integration, or migrate to another component framework.",
+        files: ["package.json"],
+        count: 1,
+        effort: "medium",
+        migration_guide: "https://docs.astro.build/en/guides/upgrade-to/v6/#removed-astrjslit",
+    };
+}
+// ---------------------------------------------------------------------------
+// Main entry point
+// ---------------------------------------------------------------------------
+export async function astroMigrationCheck(args) {
+    // Resolve project root from repo identifier or from CWD via index.
+    let root;
+    if (args.repo) {
+        // Try to resolve via CodeIndex
+        const { getCodeIndex } = await import("./index-tools.js");
+        const index = await getCodeIndex(args.repo);
+        if (!index)
+            throw new Error(`Repository "${args.repo}" not found. Run index_folder first.`);
+        root = index.root;
+    }
+    else {
+        // Fallback: use CWD
+        root = process.cwd();
+        // Try to auto-detect via index
+        try {
+            const { getCodeIndex } = await import("./index-tools.js");
+            const index = await getCodeIndex(undefined);
+            if (index)
+                root = index.root;
+        }
+        catch {
+            // Use CWD
+        }
+    }
+    const targetVersion = args.target_version ?? "6";
+    // 1. Read package.json
+    const pkg = await readPackageJson(root);
+    let currentVersion = null;
+    if (pkg) {
+        const deps = {
+            ...(pkg["dependencies"] ?? {}),
+            ...(pkg["devDependencies"] ?? {}),
+        };
+        const astroPkg = deps["astro"] ?? deps["astro-cdn"];
+        if (astroPkg)
+            currentVersion = parseVersion(astroPkg);
+    }
+    // 2. Collect source files for grep-based checks
+    const sourceFiles = await collectSourceFiles(root);
+    // 3. Run all detectors
+    const detectors = [
+        detectAM01(sourceFiles),
+        detectAM02(sourceFiles),
+        detectAM03(sourceFiles),
+        detectAM04(root),
+        detectAM05(sourceFiles),
+        detectAM06(pkg),
+        detectAM07(sourceFiles),
+        detectAM08(sourceFiles),
+        detectAM09(sourceFiles),
+        detectAM10(pkg),
+    ];
+    const breakingChanges = detectors.filter((d) => d !== null);
+    // 4. Compute summary
+    const byEffort = {};
+    let totalHours = 0;
+    for (const issue of breakingChanges) {
+        byEffort[issue.effort] = (byEffort[issue.effort] ?? 0) + 1;
+        totalHours += (EFFORT_HOURS[issue.effort] ?? 0) * issue.count;
+    }
+    // Round to 1 decimal place for display
+    const hoursDisplay = totalHours < 0.5
+        ? "< 0.5h"
+        : `~${Math.round(totalHours * 10) / 10}h`;
+    return {
+        current_version: currentVersion,
+        target_version: targetVersion,
+        breaking_changes: breakingChanges,
+        summary: {
+            total_issues: breakingChanges.length,
+            by_effort: byEffort,
+            estimated_migration_hours: hoursDisplay,
+        },
+    };
+}
+//# sourceMappingURL=astro-migration.js.map

package/dist/tools/astro-migration.js.map

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

package/dist/tools/astro-routes.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Astro file-based routing: src/pages/ → routes.
+ * Exports findAstroHandlers (for traceRoute) and astroRouteMap (tool handler).
+ */
+import type { CodeIndex, CodeSymbol, RouteFramework } from "../types.js";
+export interface AstroRouteHandler {
+    symbol: Omit<CodeSymbol, "source" | "tokens">;
+    file: string;
+    method?: string;
+    framework: RouteFramework;
+}
+interface AstroRouteEntry {
+    path: string;
+    file: string;
+    type: "page" | "endpoint";
+    rendering: "static" | "server";
+    dynamic_params: string[];
+    has_getStaticPaths: boolean;
+    methods?: string[] | undefined;
+    layout?: string | undefined;
+}
+/** Convert src/pages/blog/[slug].astro → /blog/:slug */
+export declare function fileToRoute(filePath: string): string;
+/** Build all routes from an Astro project index. */
+export declare function buildRouteEntries(index: CodeIndex): {
+    routes: AstroRouteEntry[];
+    warnings: string[];
+};
+/** Find Astro route handlers matching a search path (for traceRoute dispatch). */
+export declare function findAstroHandlers(index: CodeIndex, searchPath: string): AstroRouteHandler[];
+/** The astro_route_map MCP tool handler. */
+export declare function astroRouteMap(args: {
+    repo?: string;
+    include_endpoints?: boolean;
+    output_format?: "json" | "tree" | "table";
+}): Promise<{
+    routes: AstroRouteEntry[];
+    warnings: string[];
+    summary: {
+        total_routes: number;
+        static_pages: number;
+        server_pages: number;
+        api_endpoints: number;
+        dynamic_routes: number;
+    };
+    virtual_routes_disclaimer: string[];
+}>;
+export {};
+//# sourceMappingURL=astro-routes.d.ts.map

package/dist/tools/astro-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro-routes.d.ts","sourceRoot":"","sources":["../../src/tools/astro-routes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIzE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,cAAc,CAAC;CAC3B;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1B,SAAS,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAMD,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKpD;AAwBD,oDAAoD;AACpD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG;IAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA6CrG;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAmB3F;AAED,4CAA4C;AAC5C,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC3C,GAAG,OAAO,CAAC;IACV,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7H,yBAAyB,EAAE,MAAM,EAAE,CAAC;CACrC,CAAC,CAsBD"}

package/dist/tools/astro-routes.js

@@ -0,0 +1,119 @@
+import { matchPath } from "./route-tools.js";
+import { getCodeIndex } from "./index-tools.js";
+const HTTP_METHODS = ["GET", "POST", "PUT", "DELETE", "PATCH", "HEAD", "OPTIONS"];
+const PAGES_RE = /^src\/pages\//;
+const EXT_RE = /\.(astro|ts|js)$/;
+/** Convert src/pages/blog/[slug].astro → /blog/:slug */
+export function fileToRoute(filePath) {
+    let r = filePath.replace(PAGES_RE, "").replace(EXT_RE, "");
+    r = r.replace(/\/index$/, "").replace(/^index$/, "");
+    r = r.replace(/\[\.\.\.([^\]]+)\]/g, "*$1").replace(/\[([^\]]+)\]/g, ":$1");
+    return "/" + r;
+}
+function extractDynamicParams(route) {
+    const params = [];
+    for (const seg of route.split("/")) {
+        if (seg.startsWith(":"))
+            params.push(seg.slice(1));
+        else if (seg.startsWith("*"))
+            params.push(seg.slice(1));
+    }
+    return params;
+}
+function routeSortKey(route) {
+    return route.includes("*") ? 2 : route.includes(":") ? 1 : 0;
+}
+function stripSym(sym) {
+    const { source: _, tokens: _t, ...rest } = sym;
+    return rest;
+}
+function placeholder(file, name) {
+    return { id: `${file}:${name}`, repo: "", name, kind: "function", file, start_line: 1, end_line: 1 };
+}
+/** Build all routes from an Astro project index. */
+export function buildRouteEntries(index) {
+    const routes = [];
+    const warnings = [];
+    const pageFiles = index.files.filter((f) => PAGES_RE.test(f.path) && EXT_RE.test(f.path));
+    for (const file of pageFiles) {
+        const routePath = fileToRoute(file.path);
+        const isAstro = file.path.endsWith(".astro");
+        const syms = index.symbols.filter((s) => s.file === file.path);
+        const type = isAstro ? "page" : "endpoint";
+        const methods = isAstro ? undefined
+            : syms.filter((s) => HTTP_METHODS.includes(s.name)).map((s) => s.name);
+        const has_getStaticPaths = syms.some((s) => s.name === "getStaticPaths");
+        const hasPrerender = syms.some((s) => s.name === "prerender");
+        const dynamicParams = extractDynamicParams(routePath);
+        const isDynamic = dynamicParams.length > 0;
+        const rendering = isDynamic && !has_getStaticPaths && !hasPrerender ? "server" : "static";
+        if (isDynamic && !has_getStaticPaths && isAstro) {
+            warnings.push(`Dynamic route "${routePath}" (${file.path}) is missing getStaticPaths — will be server-rendered`);
+        }
+        const layoutSym = syms.find((s) => s.name === "Layout" || s.name === "BaseLayout");
+        routes.push({
+            path: routePath, file: file.path, type, rendering,
+            dynamic_params: dynamicParams, has_getStaticPaths,
+            methods: methods && methods.length > 0 ? methods : undefined,
+            layout: layoutSym?.name,
+        });
+    }
+    routes.sort((a, b) => routeSortKey(a.path) - routeSortKey(b.path));
+    // Detect conflicts: dynamic + rest at same prefix
+    for (let i = 0; i < routes.length; i++) {
+        for (let j = i + 1; j < routes.length; j++) {
+            const a = routes[i], b = routes[j];
+            const aDir = a.path.split("/").slice(0, -1).join("/");
+            const bDir = b.path.split("/").slice(0, -1).join("/");
+            if (aDir === bDir && a.path.includes(":") && b.path.includes("*")) {
+                warnings.push(`Potential route conflict: "${a.path}" and "${b.path}" overlap at "${aDir || "/"}"`);
+            }
+        }
+    }
+    return { routes, warnings };
+}
+/** Find Astro route handlers matching a search path (for traceRoute dispatch). */
+export function findAstroHandlers(index, searchPath) {
+    const handlers = [];
+    const { routes } = buildRouteEntries(index);
+    for (const route of routes) {
+        if (!matchPath(route.path, searchPath))
+            continue;
+        const syms = index.symbols.filter((s) => s.file === route.file);
+        if (route.type === "endpoint" && route.methods) {
+            for (const method of route.methods) {
+                const sym = syms.find((s) => s.name === method);
+                handlers.push({ symbol: sym ? stripSym(sym) : placeholder(route.file, method), file: route.file, method, framework: "astro" });
+            }
+        }
+        else {
+            const sym = syms[0];
+            handlers.push({ symbol: sym ? stripSym(sym) : placeholder(route.file, "page"), file: route.file, framework: "astro" });
+        }
+    }
+    return handlers;
+}
+/** The astro_route_map MCP tool handler. */
+export async function astroRouteMap(args) {
+    const index = await getCodeIndex(args.repo ?? "");
+    if (!index)
+        throw new Error("Repository not found");
+    const { routes: allRoutes, warnings } = buildRouteEntries(index);
+    const routes = args.include_endpoints === false ? allRoutes.filter((r) => r.type === "page") : allRoutes;
+    return {
+        routes,
+        warnings,
+        summary: {
+            total_routes: routes.length,
+            static_pages: routes.filter((r) => r.type === "page" && r.rendering === "static").length,
+            server_pages: routes.filter((r) => r.type === "page" && r.rendering === "server").length,
+            api_endpoints: routes.filter((r) => r.type === "endpoint").length,
+            dynamic_routes: routes.filter((r) => r.dynamic_params.length > 0).length,
+        },
+        virtual_routes_disclaimer: [
+            "Virtual/redirect routes defined in astro.config are not detected.",
+            "Middleware rewrites are not reflected in this map.",
+        ],
+    };
+}
+//# sourceMappingURL=astro-routes.js.map

package/dist/tools/astro-routes.js.map

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

package/dist/tools/async-correctness.d.ts

@@ -0,0 +1,26 @@
+export interface AsyncFinding {
+    rule: string;
+    severity: "error" | "warning" | "info";
+    file: string;
+    line: number;
+    symbol: string;
+    symbol_kind: string;
+    match: string;
+    message: string;
+    fix: string;
+}
+export interface AsyncCorrectnessResult {
+    findings: AsyncFinding[];
+    total: number;
+    by_rule: Record<string, number>;
+    async_functions_scanned: number;
+}
+/**
+ * Analyze async correctness across all async Python functions.
+ */
+export declare function analyzeAsyncCorrectness(repo: string, options?: {
+    file_pattern?: string;
+    rules?: string[];
+    max_results?: number;
+}): Promise<AsyncCorrectnessResult>;
+//# sourceMappingURL=async-correctness.d.ts.map

package/dist/tools/async-correctness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-correctness.d.ts","sourceRoot":"","sources":["../../src/tools/async-correctness.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,uBAAuB,EAAE,MAAM,CAAC;CACjC;AA+ED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,OAAO,CAAC,sBAAsB,CAAC,CA+EjC"}