codesift-mcp 0.14.0 → 0.15.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"express.js","sourceRoot":"","sources":["../../../src/tools/route-tools/express.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAElE,SAAS,sBAAsB,CAAC,MAAkB;IAChD,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;QAC3B,4BAA4B,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QAC9C,CAAC,iCAAiC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAkB,EAAE,UAAkB;IAC/D,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,OAAO,MAAM,oCAAoC,EAAE,GAAG,CAAC,CAAC;QACnF,KAAK,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5D,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,UAAU,CAAC;gBAAE,SAAS;YAChD,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;gBAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE;gBAC5B,SAAS,EAAE,SAAS;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,mBAAmB,CAAC,KAAgB,EAAE,UAAkB;IACtE,OAAO,KAAK,CAAC,OAAO;SACjB,MAAM,CAAC,sBAAsB,CAAC;SAC9B,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAChE,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { CodeIndex } from "../../types.js";
+export interface IndexedFileSource {
+    path: string;
+    source: string;
+}
+export declare function readIndexedFiles(index: CodeIndex, matches: (path: string) => boolean): Promise<IndexedFileSource[]>;
+//# sourceMappingURL=file-sources.d.ts.map

package/dist/tools/route-tools/file-sources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sources.d.ts","sourceRoot":"","sources":["../../../src/tools/route-tools/file-sources.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GACjC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAU9B"}

package/dist/tools/route-tools/file-sources.js

@@ -0,0 +1,15 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+export async function readIndexedFiles(index, matches) {
+    const candidates = index.files.filter((file) => matches(file.path));
+    const sources = await Promise.all(candidates.map(async (file) => {
+        try {
+            return { path: file.path, source: await readFile(join(index.root, file.path), "utf-8") };
+        }
+        catch {
+            return null;
+        }
+    }));
+    return sources.filter((source) => source !== null);
+}
+//# sourceMappingURL=file-sources.js.map

package/dist/tools/route-tools/file-sources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sources.js","sourceRoot":"","sources":["../../../src/tools/route-tools/file-sources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAAgB,EAChB,OAAkC;IAElC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QAC9D,IAAI,CAAC;YACH,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC;QAC3F,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC,CAAC;IACJ,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAA+B,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;AAClF,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { CodeIndex } from "../../types.js";
+import type { RouteHandler } from "./types.js";
+export declare function collectRouteHandlers(repo: string, index: CodeIndex, path: string): Promise<RouteHandler[]>;
+//# sourceMappingURL=handler-discovery.d.ts.map

package/dist/tools/route-tools/handler-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-discovery.d.ts","sourceRoot":"","sources":["../../../src/tools/route-tools/handler-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAWhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,EAAE,CAAC,CA0BzB"}

package/dist/tools/route-tools/handler-discovery.js

@@ -0,0 +1,38 @@
+import { findAstroHandlers } from "../astro-routes.js";
+import { findDjangoHandlers } from "./django.js";
+import { findExpressHandlers } from "./express.js";
+import { findHonoHandlers } from "./hono.js";
+import { findKtorHandlers } from "./ktor.js";
+import { findLaravelHandlers } from "./laravel.js";
+import { findNestJSHandlers } from "./nest.js";
+import { findNextJSHandlers, findPagesRouterHandlers } from "./next.js";
+import { findFastAPIHandlers, findFlaskHandlers } from "./python-decorators.js";
+import { findSpringBootKotlinHandlers } from "./spring-kotlin.js";
+import { findYii2Handlers } from "./yii2.js";
+export async function collectRouteHandlers(repo, index, path) {
+    const [nest, hono, yii2, laravel, ktor, springKotlin, django] = await Promise.all([
+        findNestJSHandlers(index, path),
+        findHonoHandlers(repo, index, path),
+        findYii2Handlers(index, path),
+        findLaravelHandlers(index, path),
+        findKtorHandlers(index, path),
+        findSpringBootKotlinHandlers(index, path),
+        findDjangoHandlers(index, path),
+    ]);
+    return [
+        ...nest,
+        ...findNextJSHandlers(index, path),
+        ...findPagesRouterHandlers(index, path),
+        ...findExpressHandlers(index, path),
+        ...hono,
+        ...yii2,
+        ...laravel,
+        ...ktor,
+        ...springKotlin,
+        ...findAstroHandlers(index, path),
+        ...findFastAPIHandlers(index, path),
+        ...findFlaskHandlers(index, path),
+        ...django,
+    ];
+}
+//# sourceMappingURL=handler-discovery.js.map

package/dist/tools/route-tools/handler-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-discovery.js","sourceRoot":"","sources":["../../../src/tools/route-tools/handler-discovery.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAY,EACZ,KAAgB,EAChB,IAAY;IAEZ,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAChF,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC;QAC/B,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC;QACnC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC;QAC7B,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC;QAChC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC;QAC7B,4BAA4B,CAAC,KAAK,EAAE,IAAI,CAAC;QACzC,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC;KAChC,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,IAAI;QACP,GAAG,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC;QAClC,GAAG,uBAAuB,CAAC,KAAK,EAAE,IAAI,CAAC;QACvC,GAAG,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC;QACnC,GAAG,IAAI;QACP,GAAG,IAAI;QACP,GAAG,OAAO;QACV,GAAG,IAAI;QACP,GAAG,YAAY;QACf,GAAG,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC;QACjC,GAAG,mBAAmB,CAAC,KAAK,EAAE,IAAI,CAAC;QACnC,GAAG,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC;QACjC,GAAG,MAAM;KACV,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { CodeIndex } from "../../types.js";
+import type { RouteHandler } from "./types.js";
+/** Find Hono handlers from the extractor's resolved application model. */
+export declare function findHonoHandlers(repo: string, index: CodeIndex, searchPath: string): Promise<RouteHandler[]>;
+//# sourceMappingURL=hono.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../../../src/tools/route-tools/hono.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,gBAAgB,CAAC;AAG5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAoD/C,0EAA0E;AAC1E,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC,CAazB"}

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

@@ -0,0 +1,61 @@
+import { join } from "node:path";
+import { stripSource } from "../graph-tools.js";
+import { matchPath } from "../route-shared.js";
+function resolveHonoEntryFile(index) {
+    const entrySymbol = index.symbols.find((symbol) => symbol.source &&
+        /new\s+(?:Hono|OpenAPIHono)\s*(?:<[^>]*>)?\s*\(/.test(symbol.source));
+    return entrySymbol ? join(index.root, entrySymbol.file) : null;
+}
+async function loadHonoModel(repo, entryFile) {
+    try {
+        const { honoCache } = await import("../../cache/hono-cache.js");
+        const { HonoExtractor } = await import("../../parser/extractors/hono.js");
+        return await honoCache.get(repo, entryFile, new HonoExtractor());
+    }
+    catch {
+        return null;
+    }
+}
+function routeHandlerSymbol(repo, index, route) {
+    const relativeFile = route.handler.file.replace(index.root + "/", "");
+    return index.symbols.find((symbol) => symbol.file === relativeFile &&
+        symbol.name === route.handler.name &&
+        Math.abs(symbol.start_line - route.handler.line) <= 2) ?? {
+        id: `hono:${route.file}:${route.line}`,
+        repo,
+        name: route.handler.name,
+        kind: "function",
+        file: relativeFile,
+        start_line: route.handler.line,
+        end_line: route.handler.line,
+        start_byte: 0,
+        end_byte: 0,
+        source: "",
+        tokens: [route.handler.name],
+    };
+}
+function toRouteHandler(repo, index, route) {
+    const symbol = routeHandlerSymbol(repo, index, route);
+    return {
+        symbol: stripSource(symbol),
+        file: symbol.file,
+        method: route.method,
+        framework: "hono",
+    };
+}
+/** Find Hono handlers from the extractor's resolved application model. */
+export async function findHonoHandlers(repo, index, searchPath) {
+    const { detectFrameworks } = await import("../../utils/framework-detect.js");
+    if (!detectFrameworks(index).has("hono"))
+        return [];
+    const entryFile = resolveHonoEntryFile(index);
+    if (!entryFile)
+        return [];
+    const model = await loadHonoModel(repo, entryFile);
+    if (!model)
+        return [];
+    return model.routes
+        .filter((route) => matchPath(route.path, searchPath))
+        .map((route) => toRouteHandler(repo, index, route));
+}
+//# sourceMappingURL=hono.js.map

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

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

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

@@ -0,0 +1,5 @@
+import type { CodeIndex } from "../../types.js";
+import type { RouteHandler } from "./types.js";
+/** Find Ktor handlers in routing DSL blocks, including nested route prefixes. */
+export declare function findKtorHandlers(index: CodeIndex, searchPath: string): Promise<RouteHandler[]>;
+//# sourceMappingURL=ktor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ktor.d.ts","sourceRoot":"","sources":["../../../src/tools/route-tools/ktor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiG/C,iFAAiF;AACjF,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC,CAGzB"}

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

@@ -0,0 +1,76 @@
+import { stripSource } from "../graph-tools.js";
+import { matchPath } from "../route-shared.js";
+import { readIndexedFiles } from "./file-sources.js";
+const KTOR_METHODS = ["get", "post", "put", "delete", "patch", "head", "options"];
+function updateScopes(line, state) {
+    const route = /\broute\s*\(\s*["']([^"']+)["']\s*\)\s*\{/.exec(line);
+    if (route)
+        state.prefixes.push({ prefix: route[1], braceDepth: state.braceDepth });
+    for (const character of line) {
+        if (character === "{") {
+            state.braceDepth++;
+            continue;
+        }
+        if (character !== "}")
+            continue;
+        state.braceDepth--;
+        let currentScope = state.prefixes.at(-1);
+        while (currentScope && currentScope.braceDepth >= state.braceDepth) {
+            state.prefixes.pop();
+            currentScope = state.prefixes.at(-1);
+        }
+    }
+}
+function methodMatches(line) {
+    const matches = [];
+    for (const method of KTOR_METHODS) {
+        const pattern = new RegExp(`\\b${method}\\s*\\(\\s*["']([^"']+)["']\\s*\\)\\s*\\{`);
+        const match = pattern.exec(line);
+        if (match)
+            matches.push({ method, path: match[1] });
+    }
+    return matches;
+}
+function ktorHandler(index, file, line, method, methodPath) {
+    const symbol = index.symbols.find((candidate) => candidate.file === file &&
+        candidate.start_line <= line &&
+        candidate.end_line >= line);
+    return {
+        symbol: symbol
+            ? stripSource(symbol)
+            : {
+                id: `${file}:${method}:${methodPath}`,
+                name: `${method} ${methodPath}`,
+                kind: "function",
+                file,
+                start_line: line,
+                end_line: line,
+            },
+        file,
+        method: method.toUpperCase(),
+        framework: "ktor",
+    };
+}
+function scanKtorFile(index, file, source, searchPath) {
+    if (!/\b(routing|route)\s*[({]/.test(source))
+        return [];
+    const handlers = [];
+    const state = { prefixes: [], braceDepth: 0 };
+    for (const [lineIndex, line] of source.split("\n").entries()) {
+        updateScopes(line, state);
+        const prefix = state.prefixes.map((scope) => scope.prefix).join("/");
+        for (const match of methodMatches(line)) {
+            const fullPath = `${prefix}/${match.path}`.replace(/\/+/g, "/");
+            if (matchPath(fullPath, searchPath)) {
+                handlers.push(ktorHandler(index, file, lineIndex + 1, match.method, match.path));
+            }
+        }
+    }
+    return handlers;
+}
+/** Find Ktor handlers in routing DSL blocks, including nested route prefixes. */
+export async function findKtorHandlers(index, searchPath) {
+    const files = await readIndexedFiles(index, (path) => /\.kts?$/.test(path));
+    return files.flatMap(({ path, source }) => scanKtorFile(index, path, source, searchPath));
+}
+//# sourceMappingURL=ktor.js.map

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

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

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

@@ -0,0 +1,5 @@
+import type { CodeIndex } from "../../types.js";
+import type { RouteHandler } from "./types.js";
+/** Find Laravel handlers by scanning framework route files. */
+export declare function findLaravelHandlers(index: CodeIndex, searchPath: string): Promise<RouteHandler[]>;
+//# sourceMappingURL=laravel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"laravel.d.ts","sourceRoot":"","sources":["../../../src/tools/route-tools/laravel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAIhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAwE/C,+DAA+D;AAC/D,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC,CAGzB"}

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

@@ -0,0 +1,45 @@
+import { stripSource } from "../graph-tools.js";
+import { matchPath } from "../route-shared.js";
+import { readIndexedFiles } from "./file-sources.js";
+const LARAVEL_METHODS = ["get", "post", "put", "delete", "patch"];
+function findControllerMethod(index, controllerName, methodName) {
+    return index.symbols.find((candidate) => candidate.name === methodName &&
+        candidate.kind === "method" &&
+        index.symbols.some((parent) => parent.id === candidate.parent && parent.name === controllerName));
+}
+function laravelHandler(index, file, method, match) {
+    const controllerClass = match[2] ?? match[4] ?? "";
+    const methodName = match[3] ?? match[5] ?? "";
+    const controllerName = controllerClass.split("\\").pop() ?? controllerClass;
+    const symbol = findControllerMethod(index, controllerName, methodName);
+    return {
+        symbol: symbol
+            ? stripSource(symbol)
+            : {
+                id: `${controllerName}::${methodName}`,
+                name: methodName,
+                kind: "method",
+                file,
+                start_line: 0,
+                end_line: 0,
+            },
+        file: symbol?.file ?? file,
+        method: method.toUpperCase(),
+        framework: "laravel",
+    };
+}
+function scanLaravelMethod(index, file, source, searchPath, method) {
+    const pattern = new RegExp(`Route::${method}\\s*\\(\\s*['"\`]([^'"\`]+)['"\`]\\s*,\\s*(?:\\[([\\w\\\\]+)::class\\s*,\\s*['"\`](\\w+)['"\`]\\]|['"\`](\\w+)@(\\w+)['"\`])`, "gi");
+    return [...source.matchAll(pattern)]
+        .filter((match) => matchPath(match[1] ?? "", searchPath))
+        .map((match) => laravelHandler(index, file, method, match));
+}
+function scanLaravelFile(index, file, source, searchPath) {
+    return LARAVEL_METHODS.flatMap((method) => scanLaravelMethod(index, file, source, searchPath, method));
+}
+/** Find Laravel handlers by scanning framework route files. */
+export async function findLaravelHandlers(index, searchPath) {
+    const files = await readIndexedFiles(index, (path) => /routes\/(web|api)\.php$/.test(path));
+    return files.flatMap(({ path, source }) => scanLaravelFile(index, path, source, searchPath));
+}
+//# sourceMappingURL=laravel.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { RouteTraceResult } from "./types.js";
+export declare function appendTracedCalls(lines: string[], result: RouteTraceResult): void;
+//# sourceMappingURL=mermaid-call-chain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-call-chain.d.ts","sourceRoot":"","sources":["../../../src/tools/route-tools/mermaid-call-chain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAiD1E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAqBjF"}

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

@@ -0,0 +1,50 @@
+function nodeAlias(node, aliases) {
+    const key = `${node.file}:${node.name}`;
+    const existing = aliases.get(key);
+    if (existing)
+        return existing;
+    const baseName = node.file.split("/").pop()?.replace(/\.\w+$/, "") ?? node.name;
+    const alias = `${baseName}_${node.name}`.replace(/[^a-zA-Z0-9_]/g, "_");
+    aliases.set(key, alias);
+    return alias;
+}
+function appendDbCalls(lines, dbCalls, node, actor) {
+    const calls = dbCalls
+        .filter((dbCall) => dbCall.file === node.file && dbCall.symbol_name === node.name)
+        .slice(0, 3);
+    for (const dbCall of calls) {
+        lines.push(`    ${actor}->>+DB: ${dbCall.operation}`);
+        lines.push(`    DB-->>-${actor}: result`);
+    }
+}
+function closeStack(lines, stack, nextDepth) {
+    while (stack.length > 0 && (stack[stack.length - 1]?.node.depth ?? -1) >= nextDepth) {
+        const finished = stack.pop();
+        if (!finished)
+            return;
+        const returnTo = stack.at(-1)?.alias ?? "Controller";
+        lines.push(`    ${finished.alias}-->>-${returnTo}: result`);
+    }
+}
+export function appendTracedCalls(lines, result) {
+    const root = result.call_chain[0];
+    if (root)
+        appendDbCalls(lines, result.db_calls, root, "Controller");
+    const descendants = result.call_chain
+        .filter((node, index) => index > 0 && node.depth > 0)
+        .slice(0, 12);
+    const aliases = new Map();
+    const stack = [];
+    for (let index = 0; index < descendants.length; index++) {
+        const node = descendants[index];
+        closeStack(lines, stack, node.depth);
+        const parentActor = stack.at(-1)?.alias ?? "Controller";
+        const alias = nodeAlias(node, aliases);
+        lines.push(`    ${parentActor}->>+${alias}: ${node.name}()`);
+        appendDbCalls(lines, result.db_calls, node, alias);
+        stack.push({ node, alias });
+        closeStack(lines, stack, descendants[index + 1]?.depth ?? 0);
+    }
+    closeStack(lines, stack, 0);
+}
+//# sourceMappingURL=mermaid-call-chain.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid-call-chain.js","sourceRoot":"","sources":["../../../src/tools/route-tools/mermaid-call-chain.ts"],"names":[],"mappings":"AAOA,SAAS,SAAS,CAChB,IAA0C,EAC1C,OAA4B;IAE5B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAE9B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC;IAChF,MAAM,KAAK,GAAG,GAAG,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IACxE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CACpB,KAAe,EACf,OAAiB,EACjB,IAA0C,EAC1C,KAAa;IAEb,MAAM,KAAK,GAAG,OAAO;SAClB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,WAAW,KAAK,IAAI,CAAC,IAAI,CAAC;SACjF,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACf,KAAK,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,WAAW,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,cAAc,KAAK,UAAU,CAAC,CAAC;IAC5C,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CACjB,KAAe,EACf,KAAmB,EACnB,SAAiB;IAEjB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC;QACpF,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,MAAM,QAAQ,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,YAAY,CAAC;QACrD,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,KAAK,QAAQ,QAAQ,UAAU,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAe,EAAE,MAAwB;IACzE,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,IAAI,IAAI;QAAE,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;IAEpE,MAAM,WAAW,GAAG,MAAM,CAAC,UAAU;SAClC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;SACpD,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1C,MAAM,KAAK,GAAiB,EAAE,CAAC;IAE/B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACxD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAE,CAAC;QACjC,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,WAAW,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,YAAY,CAAC;QACxD,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,OAAO,WAAW,OAAO,KAAK,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;QAC7D,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5B,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAC9B,CAAC"}

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

@@ -0,0 +1,5 @@
+import type { CodeIndex } from "../../types.js";
+import type { RouteHandler } from "./types.js";
+/** Find NestJS handlers from controller and method decorators. */
+export declare function findNestJSHandlers(index: CodeIndex, searchPath: string): Promise<RouteHandler[]>;
+//# sourceMappingURL=nest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nest.d.ts","sourceRoot":"","sources":["../../../src/tools/route-tools/nest.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA+F/C,kEAAkE;AAClE,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,YAAY,EAAE,CAAC,CAgBzB"}

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

@@ -0,0 +1,75 @@
+import { stripSource } from "../graph-tools.js";
+import { matchPath } from "../route-shared.js";
+import { readIndexedFiles } from "./file-sources.js";
+function addNestHandler(input) {
+    const { handlers, index, filePath, functionName, method, deduplicate } = input;
+    if (deduplicate && handlers.some((handler) => handler.file === filePath &&
+        handler.symbol.name === functionName &&
+        handler.method === method))
+        return;
+    const symbol = index.symbols.find((candidate) => candidate.file === filePath && candidate.name === functionName);
+    handlers.push({
+        symbol: symbol
+            ? stripSource(symbol)
+            : {
+                id: `${filePath}:${functionName}`,
+                name: functionName,
+                kind: "method",
+                file: filePath,
+                start_line: 1,
+                end_line: 1,
+            },
+        file: filePath,
+        method,
+        framework: "nestjs",
+    });
+}
+function appendPathDecorators(context, decorator) {
+    const { handlers, index, filePath, source, controllerPrefix, searchPath } = context;
+    const pattern = new RegExp(`@${decorator}\\s*\\(\\s*['"\`]([^'"\`]*)['"\`]\\s*\\)\\s*(?:\\n\\s*@[^\\n]+)*\\n\\s*(?:async\\s+)?(\\w+)`, "g");
+    for (const match of source.matchAll(pattern)) {
+        const fullPath = `/${controllerPrefix}/${match[1] ?? ""}`.replace(/\/+/g, "/");
+        if (matchPath(fullPath, searchPath)) {
+            addNestHandler({
+                handlers,
+                index,
+                filePath,
+                functionName: match[2] ?? "",
+                method: decorator.toUpperCase(),
+                deduplicate: false,
+            });
+        }
+    }
+}
+function appendEmptyDecorators(context, decorator) {
+    const { handlers, index, filePath, source, controllerPrefix, searchPath } = context;
+    const pattern = new RegExp(`@${decorator}\\s*\\(\\s*\\)\\s*(?:\\n\\s*@[^\\n]+)*\\n\\s*(?:async\\s+)?(\\w+)`, "g");
+    const fullPath = `/${controllerPrefix}`.replace(/\/+/g, "/") || "/";
+    if (!matchPath(fullPath, searchPath))
+        return;
+    for (const match of source.matchAll(pattern)) {
+        addNestHandler({
+            handlers,
+            index,
+            filePath,
+            functionName: match[1] ?? "",
+            method: decorator.toUpperCase(),
+            deduplicate: true,
+        });
+    }
+}
+/** Find NestJS handlers from controller and method decorators. */
+export async function findNestJSHandlers(index, searchPath) {
+    const handlers = [];
+    const controllerFiles = await readIndexedFiles(index, (path) => path.endsWith(".controller.ts") || path.endsWith(".controller.js"));
+    for (const { path, source } of controllerFiles) {
+        const controllerPrefix = /@Controller\s*\(\s*['"`]([^'"`]*)['"`]/.exec(source)?.[1] ?? "";
+        const context = { handlers, index, filePath: path, source, controllerPrefix, searchPath };
+        for (const decorator of ["Get", "Post", "Put", "Delete", "Patch"]) {
+            appendPathDecorators(context, decorator);
+            appendEmptyDecorators(context, decorator);
+        }
+    }
+    return handlers;
+}
+//# sourceMappingURL=nest.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { CodeIndex, CodeSymbol } from "../../types.js";
+import type { RouteHandler, RouteTraceResult } from "./types.js";
+export declare function enrichNextjsTrace(result: RouteTraceResult, index: CodeIndex, handlers: RouteHandler[], calleeSymbols: CodeSymbol[]): Promise<void>;
+//# sourceMappingURL=next-trace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"next-trace.d.ts","sourceRoot":"","sources":["../../../src/tools/route-tools/next-trace.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AA8BjE,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,YAAY,EAAE,EACxB,aAAa,EAAE,UAAU,EAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CA0Bf"}

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

@@ -0,0 +1,48 @@
+import { join } from "node:path";
+import { computeLayoutChain, scanDirective, traceMiddleware } from "../../utils/nextjs.js";
+async function findServerActions(repoRoot, calleeSymbols, callChain) {
+    const actions = [];
+    const uniqueFiles = [...new Set(calleeSymbols.map((symbol) => symbol.file))];
+    const directiveEntries = await Promise.all(uniqueFiles.map(async (file) => [
+        file,
+        await scanDirective(join(repoRoot, file)) === "use server",
+    ]));
+    const hasServerDirective = new Map(directiveEntries);
+    for (const symbol of calleeSymbols) {
+        if (!hasServerDirective.get(symbol.file))
+            continue;
+        const callerIndex = callChain.findIndex((node) => node.file === symbol.file && node.name === symbol.name);
+        actions.push({
+            name: symbol.name,
+            file: symbol.file,
+            called_from: callerIndex > 0 ? callChain[callerIndex - 1]?.name : undefined,
+        });
+    }
+    return actions;
+}
+export async function enrichNextjsTrace(result, index, handlers, calleeSymbols) {
+    if (!handlers.some((handler) => handler.framework === "nextjs"))
+        return;
+    const firstFile = handlers[0]?.file;
+    if (firstFile) {
+        try {
+            result.layout_chain = await computeLayoutChain(firstFile, index.root);
+        }
+        catch {
+            result.layout_chain = [];
+        }
+    }
+    else {
+        result.layout_chain = [];
+    }
+    try {
+        const middleware = await traceMiddleware(index.root, result.path);
+        if (middleware)
+            result.middleware = middleware;
+    }
+    catch {
+        // Optional middleware analysis must not make route tracing fail.
+    }
+    result.server_actions = await findServerActions(index.root, calleeSymbols, result.call_chain);
+}
+//# sourceMappingURL=next-trace.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"next-trace.js","sourceRoot":"","sources":["../../../src/tools/route-tools/next-trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG3F,KAAK,UAAU,iBAAiB,CAC9B,QAAgB,EAChB,aAA2B,EAC3B,SAAyC;IAEzC,MAAM,OAAO,GAAoD,EAAE,CAAC;IACpE,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;QACzE,IAAI;QACJ,MAAM,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAK,YAAY;KAClD,CAAC,CAAC,CAAC;IACb,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAErD,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;QACnC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,SAAS;QAEnD,MAAM,WAAW,GAAG,SAAS,CAAC,SAAS,CACrC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CACjE,CAAC;QACF,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,SAAS;SAC5E,CAAC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAwB,EACxB,KAAgB,EAChB,QAAwB,EACxB,aAA2B;IAE3B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,KAAK,QAAQ,CAAC;QAAE,OAAO;IAExE,MAAM,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;IACpC,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,CAAC,YAAY,GAAG,MAAM,kBAAkB,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACxE,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,YAAY,GAAG,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,YAAY,GAAG,EAAE,CAAC;IAC3B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QAClE,IAAI,UAAU;YAAE,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACP,iEAAiE;IACnE,CAAC;IAED,MAAM,CAAC,cAAc,GAAG,MAAM,iBAAiB,CAC7C,KAAK,CAAC,IAAI,EACV,aAAa,EACb,MAAM,CAAC,UAAU,CAClB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { CodeIndex } from "../../types.js";
+import type { RouteHandler } from "./types.js";
+/** Find Next.js App Router handlers whose file path defines the route. */
+export declare function findNextJSHandlers(index: CodeIndex, searchPath: string): RouteHandler[];
+/** Find Next.js Pages Router API handlers while excluding Astro's src/pages convention. */
+export declare function findPagesRouterHandlers(index: CodeIndex, searchPath: string): RouteHandler[];
+//# sourceMappingURL=next.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../../src/tools/route-tools/next.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAI5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAkC/C,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAavF;AAwBD,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,EAAE,CAa5F"}