codesift-mcp 0.13.1 → 0.15.0

package/dist/tools/route-tools/next.js

@@ -0,0 +1,77 @@
+import { deriveUrlPath } from "../../utils/nextjs.js";
+import { stripSource } from "../graph-tools.js";
+import { matchPath } from "../route-shared.js";
+function syntheticHandler(file, name) {
+    return {
+        id: file,
+        name,
+        kind: "function",
+        file,
+        start_line: 1,
+        end_line: 1,
+    };
+}
+function appHandlersForFile(index, file) {
+    const symbols = index.symbols.filter((symbol) => symbol.file === file && /^(GET|POST|PUT|DELETE|PATCH)$/.test(symbol.name));
+    if (symbols.length === 0) {
+        return [{
+                symbol: syntheticHandler(file, "route"),
+                file,
+                framework: "nextjs",
+                router: "app",
+            }];
+    }
+    return symbols.map((symbol) => ({
+        symbol: stripSource(symbol),
+        file: symbol.file,
+        method: symbol.name,
+        framework: "nextjs",
+        router: "app",
+    }));
+}
+/** Find Next.js App Router handlers whose file path defines the route. */
+export function findNextJSHandlers(index, searchPath) {
+    const handlers = [];
+    const normalizedSearch = searchPath.replace(/^\/|\/$/g, "");
+    for (const file of index.files) {
+        const routeMatch = /app\/(.*?)\/route\.[jt]sx?$/.exec(file.path);
+        if (!routeMatch)
+            continue;
+        const routePath = routeMatch[1].replace(/\([^)]+\)\/?/g, "");
+        if (matchPath(routePath, normalizedSearch)) {
+            handlers.push(...appHandlersForFile(index, file.path));
+        }
+    }
+    return handlers;
+}
+function hasNextProjectSignal(index) {
+    return index.files.some((file) => /^(src\/)?next\.config\.[mc]?[jt]sx?$/.test(file.path) ||
+        /(^|\/)app\/.*\/(page|layout|route)\.[jt]sx?$/.test(file.path));
+}
+function pagesHandlerForFile(index, file) {
+    const symbols = index.symbols.filter((symbol) => symbol.file === file);
+    const symbol = symbols.find((candidate) => candidate.name === "default" || candidate.name === "handler") ?? symbols.find((candidate) => candidate.kind === "function" || candidate.kind === "variable");
+    return {
+        symbol: symbol ? stripSource(symbol) : syntheticHandler(file, "handler"),
+        file,
+        framework: "nextjs",
+        router: "pages",
+    };
+}
+/** Find Next.js Pages Router API handlers while excluding Astro's src/pages convention. */
+export function findPagesRouterHandlers(index, searchPath) {
+    if (!hasNextProjectSignal(index))
+        return [];
+    const normalizedSearch = searchPath.replace(/^\/|\/$/g, "");
+    const handlers = [];
+    for (const file of index.files) {
+        if (!/^(\.\/)?pages\/api\//.test(file.path))
+            continue;
+        const normalizedRoute = deriveUrlPath(file.path, "pages").replace(/^\/|\/$/g, "");
+        if (normalizedRoute === normalizedSearch) {
+            handlers.push(pagesHandlerForFile(index, file.path));
+        }
+    }
+    return handlers;
+}
+//# sourceMappingURL=next.js.map

package/dist/tools/route-tools/next.js.map

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

package/dist/tools/route-tools/python-decorators.d.ts

@@ -0,0 +1,7 @@
+import type { CodeIndex } from "../../types.js";
+import type { RouteHandler } from "./types.js";
+/** Find Flask @app.route and @bp.route decorators. */
+export declare function findFlaskHandlers(index: CodeIndex, searchPath: string): RouteHandler[];
+/** Find FastAPI verb decorators on app and router instances. */
+export declare function findFastAPIHandlers(index: CodeIndex, searchPath: string): RouteHandler[];
+//# sourceMappingURL=python-decorators.d.ts.map

package/dist/tools/route-tools/python-decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-decorators.d.ts","sourceRoot":"","sources":["../../../src/tools/route-tools/python-decorators.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA6C/C,sDAAsD;AACtD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAKtF;AAED,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAUxF"}

package/dist/tools/route-tools/python-decorators.js

@@ -0,0 +1,53 @@
+import { stripSource } from "../graph-tools.js";
+import { matchPath } from "../route-shared.js";
+function isPythonTestFile(path) {
+    const basename = path.split("/").pop() ?? path;
+    if (basename === "conftest.py")
+        return true;
+    if (/^test_.*\.py$/.test(basename))
+        return true;
+    if (/_test\.py$/.test(basename))
+        return true;
+    if (/\/tests?\//.test(path))
+        return true;
+    return false;
+}
+function findDecoratedPythonHandlers(index, searchPath, parseDecorator) {
+    const handlers = [];
+    const pythonFiles = index.files.filter((file) => file.path.endsWith(".py") && !isPythonTestFile(file.path));
+    for (const file of pythonFiles) {
+        for (const symbol of index.symbols.filter((candidate) => candidate.file === file.path)) {
+            for (const decorator of symbol.decorators ?? []) {
+                const route = parseDecorator(decorator);
+                if (!route || !matchPath(route.routePath, searchPath))
+                    continue;
+                handlers.push({
+                    symbol: stripSource(symbol),
+                    file: file.path,
+                    ...route.handler,
+                });
+            }
+        }
+    }
+    return handlers;
+}
+/** Find Flask @app.route and @bp.route decorators. */
+export function findFlaskHandlers(index, searchPath) {
+    return findDecoratedPythonHandlers(index, searchPath, (decorator) => {
+        const match = /@\w+\.route\s*\(\s*['"]([^'"]*)['"]/.exec(decorator);
+        return match ? { routePath: match[1] ?? "", handler: { framework: "flask" } } : null;
+    });
+}
+/** Find FastAPI verb decorators on app and router instances. */
+export function findFastAPIHandlers(index, searchPath) {
+    return findDecoratedPythonHandlers(index, searchPath, (decorator) => {
+        const match = /@\w+\.(get|post|put|delete|patch|options|head)\s*\(\s*['"]([^'"]*)['"]/.exec(decorator);
+        return match
+            ? {
+                routePath: match[2] ?? "",
+                handler: { framework: "fastapi", method: match[1].toUpperCase() },
+            }
+            : null;
+    });
+}
+//# sourceMappingURL=python-decorators.js.map

package/dist/tools/route-tools/python-decorators.js.map

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

package/dist/tools/route-tools/route-mermaid.d.ts

@@ -0,0 +1,4 @@
+import type { RouteTraceResult } from "./types.js";
+/** Render a route trace as a Mermaid sequence diagram. */
+export declare function routeToMermaid(result: RouteTraceResult): string;
+//# sourceMappingURL=route-mermaid.d.ts.map

package/dist/tools/route-tools/route-mermaid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-mermaid.d.ts","sourceRoot":"","sources":["../../../src/tools/route-tools/route-mermaid.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA2CnD,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAY/D"}

package/dist/tools/route-tools/route-mermaid.js

@@ -0,0 +1,53 @@
+import { appendTracedCalls } from "./mermaid-call-chain.js";
+function mermaidText(value) {
+    return value.replace(/[\r\n]+/g, " ");
+}
+function appendRequest(lines, result, method) {
+    if (result.middleware?.applies) {
+        lines.push("    participant Middleware");
+        lines.push(`    Client->>+Middleware: ${method} ${mermaidText(result.path)}`);
+        lines.push("    Middleware->>+Controller: continue");
+    }
+    else {
+        lines.push(`    Client->>+Controller: ${method} ${mermaidText(result.path)}`);
+    }
+}
+function appendLayouts(lines, layoutChain) {
+    let previousActor = "Controller";
+    for (let index = 0; index < layoutChain.length; index++) {
+        const layoutName = `Layout${index + 1}`;
+        lines.push(`    participant ${layoutName}`);
+        lines.push(`    ${previousActor}->>+${layoutName}: render (${mermaidText(layoutChain[index])})`);
+        previousActor = layoutName;
+    }
+}
+function appendLayoutReturns(lines, layoutCount) {
+    for (let index = layoutCount - 1; index >= 0; index--) {
+        const layoutName = `Layout${index + 1}`;
+        const returnTo = index > 0 ? `Layout${index}` : "Controller";
+        lines.push(`    ${layoutName}-->>-${returnTo}: rendered`);
+    }
+}
+function appendResponse(lines, hasMiddleware) {
+    if (hasMiddleware) {
+        lines.push("    Controller-->>-Middleware: response");
+        lines.push("    Middleware-->>-Client: response");
+    }
+    else {
+        lines.push("    Controller-->>-Client: response");
+    }
+}
+/** Render a route trace as a Mermaid sequence diagram. */
+export function routeToMermaid(result) {
+    if (result.handlers.length === 0) {
+        return "sequenceDiagram\n    Note over Client: No handler found for " + mermaidText(result.path);
+    }
+    const lines = ["sequenceDiagram"];
+    appendRequest(lines, result, result.handlers[0]?.method ?? "REQUEST");
+    appendLayouts(lines, result.layout_chain ?? []);
+    appendTracedCalls(lines, result);
+    appendLayoutReturns(lines, result.layout_chain?.length ?? 0);
+    appendResponse(lines, result.middleware?.applies === true);
+    return lines.join("\n");
+}
+//# sourceMappingURL=route-mermaid.js.map

package/dist/tools/route-tools/route-mermaid.js.map

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

package/dist/tools/route-tools/spring-kotlin.d.ts

@@ -0,0 +1,5 @@
+import type { CodeIndex } from "../../types.js";
+import type { RouteHandler } from "./types.js";
+/** Find Spring Boot Kotlin handlers from controller mapping annotations. */
+export declare function findSpringBootKotlinHandlers(index: CodeIndex, searchPath: string): Promise<RouteHandler[]>;
+//# sourceMappingURL=spring-kotlin.d.ts.map

package/dist/tools/route-tools/spring-kotlin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring-kotlin.d.ts","sourceRoot":"","sources":["../../../src/tools/route-tools/spring-kotlin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAqE/C,4EAA4E;AAC5E,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC,CAGzB"}

package/dist/tools/route-tools/spring-kotlin.js

@@ -0,0 +1,52 @@
+import { stripSource } from "../graph-tools.js";
+import { matchPath } from "../route-shared.js";
+import { readIndexedFiles } from "./file-sources.js";
+const MAPPINGS = [
+    { annotation: "GetMapping", method: "GET" },
+    { annotation: "PostMapping", method: "POST" },
+    { annotation: "PutMapping", method: "PUT" },
+    { annotation: "DeleteMapping", method: "DELETE" },
+    { annotation: "PatchMapping", method: "PATCH" },
+];
+function scanMapping(context, mapping) {
+    const { index, file, source, classPrefix, searchPath } = context;
+    const pattern = new RegExp(`@${mapping.annotation}\\s*\\(\\s*(?:value\\s*=\\s*)?["']([^"']*)["'](?:[^)]*)?\\)\\s*(?:fun|\\n\\s*fun)\\s+(\\w+)`, "g");
+    const handlers = [];
+    for (const match of source.matchAll(pattern)) {
+        const fullPath = `${classPrefix}/${match[1] ?? ""}`.replace(/\/+/g, "/");
+        if (!matchPath(fullPath, searchPath))
+            continue;
+        const functionName = match[2] ?? "";
+        const symbol = index.symbols.find((candidate) => candidate.file === file && candidate.name === functionName);
+        handlers.push({
+            symbol: symbol
+                ? stripSource(symbol)
+                : {
+                    id: `${file}:${functionName}`,
+                    name: functionName,
+                    kind: "method",
+                    file,
+                    start_line: 1,
+                    end_line: 1,
+                },
+            file,
+            method: mapping.method,
+            framework: "spring-kotlin",
+        });
+    }
+    return handlers;
+}
+function scanSpringFile(index, file, source, searchPath) {
+    if (!/@(?:RestController|Controller)\b/.test(source))
+        return [];
+    const classPrefix = /@RequestMapping\s*\(\s*(?:value\s*=\s*)?["']([^"']*)["']/
+        .exec(source)?.[1] ?? "";
+    const context = { index, file, source, classPrefix, searchPath };
+    return MAPPINGS.flatMap((mapping) => scanMapping(context, mapping));
+}
+/** Find Spring Boot Kotlin handlers from controller mapping annotations. */
+export async function findSpringBootKotlinHandlers(index, searchPath) {
+    const files = await readIndexedFiles(index, (path) => /\.kts?$/.test(path));
+    return files.flatMap(({ path, source }) => scanSpringFile(index, path, source, searchPath));
+}
+//# sourceMappingURL=spring-kotlin.js.map

package/dist/tools/route-tools/spring-kotlin.js.map

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

package/dist/tools/route-tools/trace-analysis.d.ts

@@ -0,0 +1,4 @@
+import type { CodeSymbol } from "../../types.js";
+import type { DbCall } from "./types.js";
+export declare function findDbCalls(symbols: CodeSymbol[]): DbCall[];
+//# sourceMappingURL=trace-analysis.d.ts.map

package/dist/tools/route-tools/trace-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-analysis.d.ts","sourceRoot":"","sources":["../../../src/tools/route-tools/trace-analysis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAmBzC,wBAAgB,WAAW,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAiB3D"}

package/dist/tools/route-tools/trace-analysis.js

@@ -0,0 +1,37 @@
+const DB_PATTERNS = [
+    /prisma\.\w+\.(findMany|findFirst|findUnique|create|update|delete|upsert|count|aggregate|groupBy)/,
+    /\.\$(transaction|queryRaw|executeRaw)/,
+    /getRepository|\.query\(|\.execute\(/,
+    /knex\.|\.raw\(/,
+    /->find\(\)|->findOne\(|->findAll\(|->findBySql\(/,
+    /->createCommand\(|Yii::\$app->db/,
+    /::find\(\)->where\(|->andWhere\(|->orWhere\(/,
+    /transaction\s*\{[\s\S]*?\.(select|insert|update|delete)/,
+    /\.(findById|findAll|save|deleteById|findBy\w+)\s*\(/,
+    /\bSchemaUtils\.(create|drop)/,
+    /\.objects\.(get|filter|all|exclude|create|update|delete|aggregate|annotate|values|values_list|count|exists|first|last|bulk_create|bulk_update|get_or_create|update_or_create)\s*\(/,
+    /\.query\.(filter|filter_by|get|all|first|one|one_or_none|join|outerjoin|subquery)\s*\(/,
+    /session\.(add|delete|commit|rollback|flush|execute|query)\s*\(/,
+    /\.select_related\(|\.prefetch_related\(/,
+];
+export function findDbCalls(symbols) {
+    const calls = [];
+    for (const symbol of symbols) {
+        const source = symbol.source;
+        if (!source)
+            continue;
+        const match = DB_PATTERNS
+            .map((pattern) => pattern.exec(source))
+            .find((candidate) => candidate !== null);
+        if (!match)
+            continue;
+        calls.push({
+            symbol_name: symbol.name,
+            file: symbol.file,
+            line: symbol.start_line,
+            operation: match[0],
+        });
+    }
+    return calls;
+}
+//# sourceMappingURL=trace-analysis.js.map

package/dist/tools/route-tools/trace-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-analysis.js","sourceRoot":"","sources":["../../../src/tools/route-tools/trace-analysis.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,GAAG;IAClB,kGAAkG;IAClG,uCAAuC;IACvC,qCAAqC;IACrC,gBAAgB;IAChB,kDAAkD;IAClD,kCAAkC;IAClC,8CAA8C;IAC9C,yDAAyD;IACzD,qDAAqD;IACrD,8BAA8B;IAC9B,oLAAoL;IACpL,wFAAwF;IACxF,gEAAgE;IAChE,yCAAyC;CAC1C,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,OAAqB;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,MAAM;YAAE,SAAS;QACtB,MAAM,KAAK,GAAG,WAAW;aACtB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;aACtC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,KAAK,CAAC,IAAI,CAAC;YACT,WAAW,EAAE,MAAM,CAAC,IAAI;YACxB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,UAAU;YACvB,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;SACpB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/tools/route-tools/trace-route.d.ts

@@ -0,0 +1,6 @@
+import type { RouteTraceResult } from "./types.js";
+/** Trace an HTTP route from framework handler through callees and DB operations. */
+export declare function traceRoute(repo: string, path: string, outputFormat?: "json" | "mermaid"): Promise<RouteTraceResult | {
+    mermaid: string;
+}>;
+//# sourceMappingURL=trace-route.d.ts.map

package/dist/tools/route-tools/trace-route.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-route.d.ts","sourceRoot":"","sources":["../../../src/tools/route-tools/trace-route.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAgB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAqCjE,oFAAoF;AACpF,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,GAChC,OAAO,CAAC,gBAAgB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAqBjD"}

package/dist/tools/route-tools/trace-route.js

@@ -0,0 +1,53 @@
+import { buildAdjacencyIndex, buildCallTree } from "../graph-tools.js";
+import { getCodeIndex } from "../index-tools.js";
+import { collectRouteHandlers } from "./handler-discovery.js";
+import { enrichNextjsTrace } from "./next-trace.js";
+import { routeToMermaid } from "./route-mermaid.js";
+import { findDbCalls } from "./trace-analysis.js";
+function appendCallTree(node, depth, accumulator) {
+    accumulator.callChain.push({
+        name: node.symbol.name,
+        file: node.symbol.file,
+        kind: node.symbol.kind,
+        depth,
+    });
+    accumulator.calleeSymbols.push(node.symbol);
+    for (const child of node.children) {
+        appendCallTree(child, depth + 1, accumulator);
+    }
+}
+function traceHandlerCalls(index, handlers) {
+    const accumulator = { callChain: [], calleeSymbols: [] };
+    const adjacency = buildAdjacencyIndex(index.symbols, false);
+    for (const handler of handlers) {
+        const fullSymbol = index.symbols.find((symbol) => symbol.file === handler.symbol.file &&
+            symbol.name === handler.symbol.name &&
+            symbol.start_line === handler.symbol.start_line);
+        if (!fullSymbol)
+            continue;
+        appendCallTree(buildCallTree(fullSymbol, adjacency, "callees", 3), 0, accumulator);
+    }
+    return accumulator;
+}
+/** Trace an HTTP route from framework handler through callees and DB operations. */
+export async function traceRoute(repo, path, outputFormat) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found.`);
+    const handlers = await collectRouteHandlers(repo, index, path);
+    if (handlers.length === 0) {
+        return { path, handlers: [], call_chain: [], db_calls: [] };
+    }
+    const { callChain, calleeSymbols } = traceHandlerCalls(index, handlers);
+    const result = {
+        path,
+        handlers,
+        call_chain: callChain,
+        db_calls: findDbCalls(calleeSymbols),
+    };
+    await enrichNextjsTrace(result, index, handlers, calleeSymbols);
+    return outputFormat === "mermaid"
+        ? { mermaid: routeToMermaid(result) }
+        : result;
+}
+//# sourceMappingURL=trace-route.js.map

package/dist/tools/route-tools/trace-route.js.map

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

package/dist/tools/route-tools/types.d.ts

@@ -0,0 +1,35 @@
+import type { MiddlewareTraceResult } from "../../utils/nextjs.js";
+import type { CodeSymbol, RouteFramework } from "../../types.js";
+export interface RouteHandler {
+    symbol: CodeSymbol;
+    file: string;
+    method?: string;
+    framework: RouteFramework;
+    router?: "app" | "pages";
+}
+export interface DbCall {
+    symbol_name: string;
+    file: string;
+    line: number;
+    operation: string;
+}
+export interface RouteTraceResult {
+    path: string;
+    handlers: RouteHandler[];
+    call_chain: Array<{
+        name: string;
+        file: string;
+        kind: string;
+        depth: number;
+    }>;
+    db_calls: DbCall[];
+    middleware?: MiddlewareTraceResult;
+    layout_chain?: string[];
+    server_actions?: Array<{
+        name: string;
+        file: string;
+        called_from?: string | undefined;
+    }>;
+}
+export type RouteCallNode = RouteTraceResult["call_chain"][number];
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/route-tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tools/route-tools/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,cAAc,CAAC;IAC1B,MAAM,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,MAAM;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;CAC1F;AAED,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/tools/route-tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/tools/route-tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/route-tools/types.ts"],"names":[],"mappings":""}

package/dist/tools/route-tools/yii2.d.ts

@@ -0,0 +1,5 @@
+import type { CodeIndex } from "../../types.js";
+import type { RouteHandler } from "./types.js";
+/** Find Yii2 handlers through controller/action conventions and URL rules. */
+export declare function findYii2Handlers(index: CodeIndex, searchPath: string): Promise<RouteHandler[]>;
+//# sourceMappingURL=yii2.d.ts.map

package/dist/tools/route-tools/yii2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yii2.d.ts","sourceRoot":"","sources":["../../../src/tools/route-tools/yii2.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAuE/C,8EAA8E;AAC9E,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC,CAWzB"}

package/dist/tools/route-tools/yii2.js

@@ -0,0 +1,73 @@
+import { stripSource } from "../graph-tools.js";
+import { matchPath } from "../route-shared.js";
+import { readIndexedFiles } from "./file-sources.js";
+function toPascal(value) {
+    return value
+        .split("-")
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join("");
+}
+function routeTarget(segments) {
+    if (segments.length === 0)
+        return null;
+    if (segments.length === 1) {
+        return { controllerId: segments[0], actionId: "index" };
+    }
+    return {
+        controllerId: segments[segments.length - 2],
+        actionId: segments[segments.length - 1],
+    };
+}
+function conventionHandler(index, controllerId, actionId) {
+    const controllerName = toPascal(controllerId) + "Controller";
+    const actionName = "action" + toPascal(actionId);
+    const controller = index.symbols.find((symbol) => symbol.name === controllerName && symbol.kind === "class");
+    if (!controller)
+        return null;
+    const action = index.symbols.find((symbol) => symbol.name === actionName && symbol.parent === controller.id);
+    const symbol = action ?? controller;
+    return {
+        symbol: stripSource(symbol),
+        file: symbol.file,
+        ...(action ? { method: "GET" } : {}),
+        framework: "yii2",
+    };
+}
+function configRuleHandler(index, route, method) {
+    const target = routeTarget(route.split("/"));
+    if (!target)
+        return null;
+    const handler = conventionHandler(index, target.controllerId, target.actionId);
+    return handler ? { ...handler, method } : null;
+}
+async function findYii2HandlersFromConfig(index, searchPath) {
+    const [config] = await readIndexedFiles(index, (path) => /config\/web\.php$/.test(path));
+    if (!config)
+        return [];
+    const normalizedSearch = searchPath.replace(/^\/|\/$/g, "").toLowerCase();
+    const pattern = /['"](?:(GET|POST|PUT|DELETE|PATCH)\s+)?([^'"]+)['"]\s*=>\s*['"]([^'"]+)['"]/g;
+    const handlers = [];
+    for (const match of config.source.matchAll(pattern)) {
+        const rulePath = match[2].replace(/<\w+(?::[^>]+)?>/g, "[param]").toLowerCase();
+        if (!matchPath(rulePath, normalizedSearch))
+            continue;
+        const handler = configRuleHandler(index, match[3], match[1]?.toUpperCase() ?? "GET");
+        if (handler)
+            handlers.push(handler);
+    }
+    return handlers;
+}
+/** Find Yii2 handlers through controller/action conventions and URL rules. */
+export async function findYii2Handlers(index, searchPath) {
+    const segments = searchPath
+        .replace(/^\/|\/$/g, "")
+        .toLowerCase()
+        .split("/")
+        .filter(Boolean);
+    const target = routeTarget(segments);
+    if (!target)
+        return [];
+    const handler = conventionHandler(index, target.controllerId, target.actionId);
+    return handler ? [handler] : findYii2HandlersFromConfig(index, searchPath);
+}
+//# sourceMappingURL=yii2.js.map

package/dist/tools/route-tools/yii2.js.map

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

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

@@ -1,52 +1,10 @@
-import { stripSource } from "./graph-tools.js";
-import type { CodeIndex, RouteFramework } from "../types.js";
-export { matchPath } from "./route-shared.js";
-import type { MiddlewareTraceResult } from "../utils/nextjs.js";
-interface RouteHandler {
-    symbol: ReturnType<typeof stripSource>;
-    file: string;
-    method?: string;
-    framework: RouteFramework;
-    router?: "app" | "pages";
-}
-interface DbCall {
-    symbol_name: string;
-    file: string;
-    line: number;
-    operation: string;
-}
-export interface RouteTraceResult {
-    path: string;
-    handlers: RouteHandler[];
-    call_chain: Array<{
-        name: string;
-        file: string;
-        kind: string;
-        depth: number;
-    }>;
-    db_calls: DbCall[];
-    middleware?: MiddlewareTraceResult;
-    layout_chain?: string[];
-    server_actions?: Array<{
-        name: string;
-        file: string;
-        called_from?: string | undefined;
-    }>;
-}
-/**
- * Find NestJS route handlers via @Controller + @Get/@Post/etc. decorators.
- * Reads raw file content because tree-sitter symbol source may not include decorators.
- */
-export declare function findNestJSHandlers(index: CodeIndex, searchPath: string): Promise<RouteHandler[]>;
 /**
- * Render a RouteTraceResult as a Mermaid sequence diagram.
- * @internal exported for unit testing
+ * Stable public facade for HTTP route tracing.
+ * Implementations live in focused modules under ./route-tools/.
  */
-export declare function routeToMermaid(result: RouteTraceResult): string;
-/**
- * Trace an HTTP route: find handler, trace callees, identify DB calls.
- */
-export declare function traceRoute(repo: string, path: string, outputFormat?: "json" | "mermaid"): Promise<RouteTraceResult | {
-    mermaid: string;
-}>;
+export { matchPath } from "./route-shared.js";
+export { findNestJSHandlers } from "./route-tools/nest.js";
+export { routeToMermaid } from "./route-tools/route-mermaid.js";
+export { traceRoute } from "./route-tools/trace-route.js";
+export type { RouteTraceResult } from "./route-tools/types.js";
 //# sourceMappingURL=route-tools.d.ts.map