codesift-mcp 0.9.0 → 0.9.10

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

@@ -0,0 +1,240 @@
+/**
+ * NestJS guard, middleware, and decorator chain analysis.
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { getCodeIndex } from "./index-tools.js";
+import { extractNestConventions } from "./project-tools.js";
+// ---------------------------------------------------------------------------
+// Shared helpers: guard/interceptor/pipe parsing (CQ14)
+// ---------------------------------------------------------------------------
+/** Parse @UseGuards(...) from source, returns guard class names.
+ * R-8 fix: handles both class-ref form @UseGuards(AuthGuard) and
+ * instantiation form @UseGuards(new ThrottlerGuard()). */
+export function parseUseGuards(source) {
+    const results = [];
+    // Match the full @UseGuards(...) arg including nested parens for `new Guard()`
+    const re = /@UseGuards\s*\(\s*([^)]*(?:\([^)]*\)[^)]*)*)\s*\)/g;
+    let m;
+    while ((m = re.exec(source)) !== null) {
+        const args = m[1];
+        // Extract class names — both bare refs and `new ClassName(...)` instantiations
+        for (const part of args.split(",")) {
+            const trimmed = part.trim();
+            if (!trimmed)
+                continue;
+            const newMatch = /new\s+(\w+)/.exec(trimmed);
+            if (newMatch) {
+                results.push(newMatch[1]);
+                continue;
+            }
+            const bareMatch = /^(\w+)$/.exec(trimmed);
+            if (bareMatch)
+                results.push(bareMatch[1]);
+        }
+    }
+    return results;
+}
+/**
+ * Factory for @Use*() decorator parsers. parseUseGuards is separate because
+ * it needs to handle `new Guard()` instantiation form (R-8 fix).
+ */
+function makeUseDecoratorParser(decoratorName) {
+    const re = new RegExp(`@${decoratorName}\\s*\\(\\s*([\\w\\s,]+)\\s*\\)`, "g");
+    return (source) => {
+        const results = [];
+        let m;
+        re.lastIndex = 0;
+        while ((m = re.exec(source)) !== null) {
+            for (const name of m[1].split(",").map((s) => s.trim()).filter(Boolean)) {
+                results.push(name);
+            }
+        }
+        return results;
+    };
+}
+const parseUseInterceptors = makeUseDecoratorParser("UseInterceptors");
+const parseUsePipes = makeUseDecoratorParser("UsePipes");
+const parseUseFilters = makeUseDecoratorParser("UseFilters");
+/** Built-in NestJS decorators that should NOT be reported as custom metadata */
+const BUILTIN_DECORATORS = new Set([
+    "Get", "Post", "Put", "Delete", "Patch", "Options", "Head", "All",
+    "Controller", "Injectable", "Module", "Global",
+    "UseGuards", "UseInterceptors", "UsePipes", "UseFilters",
+    "Param", "Body", "Query", "Headers", "Req", "Res", "Next", "Ip", "Session", "HostParam",
+    "Version", "ApiOperation", "ApiBearerAuth", "ApiTags", "ApiResponse", "ApiProperty", "ApiParam", "ApiBody", "ApiQuery",
+    "HealthCheck", "HealthIndicator",
+    "Catch", "Optional", "Inject", "InjectRepository", "InjectModel",
+    "Resolver", "Query" /*gql*/, "Mutation", "Subscription", "Args", "ResolveField",
+    "WebSocketGateway", "SubscribeMessage", "MessageBody", "ConnectedSocket",
+    "MessagePattern", "EventPattern", "Payload", "Ctx",
+    "Cron", "Interval", "Timeout", "OnEvent",
+    "Entity", "Column", "PrimaryGeneratedColumn", "PrimaryColumn", "OneToMany", "ManyToOne", "OneToOne", "ManyToMany",
+    "JoinColumn", "JoinTable", "CreateDateColumn", "UpdateDateColumn", "DeleteDateColumn", "Index", "Unique",
+]);
+/**
+ * G4: Parse custom decorators on methods (e.g. @Roles('admin'), @Public(), @CurrentUser()).
+ * Returns decorator name + raw argument string (may be empty).
+ * Excludes built-in NestJS decorators (BUILTIN_DECORATORS set).
+ */
+function parseCustomDecorators(source) {
+    const results = [];
+    // Match @PascalCase(args) — capture name and argument text
+    const re = /@([A-Z]\w*)\s*\(([^)]*)\)/g;
+    let m;
+    while ((m = re.exec(source)) !== null) {
+        const name = m[1];
+        if (BUILTIN_DECORATORS.has(name))
+            continue;
+        // Strip quotes from simple string args for readable output
+        const args = m[2].trim().replace(/^['"`]|['"`]$/g, "");
+        results.push({ name, args });
+    }
+    return results;
+}
+/** G1: glob-like matching for NestJS middleware forRoutes against resolved route paths */
+function matchMiddlewareRoute(mwRoute, routePath, routeMethod) {
+    // Method filter
+    if (mwRoute.method && mwRoute.method !== "ALL" && mwRoute.method !== routeMethod)
+        return false;
+    // Normalise both sides to leading-slash form for comparison
+    const norm = (p) => "/" + p.replace(/^\/+|\/+$/g, "");
+    const mwNorm = norm(mwRoute.path);
+    const routeNorm = norm(routePath);
+    // '*' matches everything
+    if (mwNorm === "/*" || mwRoute.path === "*")
+        return true;
+    // Convert NestJS glob (users/*) into anchored regex
+    // escape regex metachars except '*', then replace '*' with '.*'
+    const escaped = mwNorm.replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
+    const re = new RegExp(`^${escaped}($|/)`);
+    return re.test(routeNorm);
+}
+export async function nestGuardChain(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found. Index it first with index_folder.`);
+    const maxRoutes = options?.max_routes ?? 300;
+    const routes = [];
+    const errors = [];
+    let truncated = false;
+    // 1. Collect global guards/interceptors/pipes from module files + G1 middleware chains
+    const globalChain = [];
+    const middlewareEntries = [];
+    for (const file of index.files) {
+        if (!file.path.endsWith(".module.ts") && !file.path.endsWith(".module.js"))
+            continue;
+        let source;
+        try {
+            source = await readFile(join(index.root, file.path), "utf-8");
+        }
+        catch (err) {
+            errors.push({ file: file.path, reason: `readFile failed: ${err instanceof Error ? err.message : String(err)}` });
+            continue;
+        }
+        const conv = extractNestConventions(source, file.path);
+        for (const g of conv.global_guards)
+            globalChain.push({ layer: "global", type: "guard", name: g.name, file: g.file });
+        for (const f of conv.global_filters)
+            globalChain.push({ layer: "global", type: "filter", name: f.name, file: f.file });
+        for (const p of conv.global_pipes)
+            globalChain.push({ layer: "global", type: "pipe", name: p.name, file: p.file });
+        for (const i of conv.global_interceptors)
+            globalChain.push({ layer: "global", type: "interceptor", name: i.name, file: i.file });
+        // G1: defensive default since middleware_chains is optional on older profiles
+        for (const mw of conv.middleware_chains ?? []) {
+            middlewareEntries.push({ middleware: mw.middleware, routes: mw.routes, file: mw.file });
+        }
+    }
+    // 2. Scan controller files
+    const controllerFiles = index.files.filter((f) => f.path.endsWith(".controller.ts") || f.path.endsWith(".controller.js"));
+    const methods = ["Get", "Post", "Put", "Delete", "Patch", "All", "Head", "Options"];
+    for (const file of controllerFiles) {
+        if (routes.length >= maxRoutes) {
+            truncated = true;
+            break;
+        }
+        let source;
+        try {
+            source = await readFile(join(index.root, file.path), "utf-8");
+        }
+        catch (err) {
+            errors.push({ file: file.path, reason: `readFile failed: ${err instanceof Error ? err.message : String(err)}` });
+            continue;
+        }
+        // Controller-level info
+        const ctrlMatch = /@Controller\s*\(\s*['"`]([^'"`]*)['"`]/.exec(source);
+        const ctrlPrefix = ctrlMatch?.[1] ?? "";
+        const ctrlClassMatch = /class\s+(\w+)/.exec(source);
+        const ctrlClass = ctrlClassMatch?.[1] ?? "UnknownController";
+        // Controller-level decorators (before class body — find source before first method)
+        const classIdx = source.indexOf(`class ${ctrlClass}`);
+        const ctrlHeader = classIdx >= 0 ? source.slice(0, classIdx) : "";
+        const ctrlGuards = parseUseGuards(ctrlHeader).map((n) => ({ layer: "controller", type: "guard", name: n }));
+        const ctrlInterceptors = parseUseInterceptors(ctrlHeader).map((n) => ({ layer: "controller", type: "interceptor", name: n }));
+        const ctrlPipes = parseUsePipes(ctrlHeader).map((n) => ({ layer: "controller", type: "pipe", name: n }));
+        const ctrlFilters = parseUseFilters(ctrlHeader).map((n) => ({ layer: "controller", type: "filter", name: n }));
+        const ctrlLevelChain = [...ctrlGuards, ...ctrlInterceptors, ...ctrlPipes, ...ctrlFilters];
+        // Collect ALL method decorator positions first to bound lookback correctly
+        const allMethodPositions = [];
+        for (const method of methods) {
+            const reStr = new RegExp(`@${method}\\s*\\(\\s*['"\`]([^'"\`]*)['"\`]\\s*\\)`, "g");
+            const reEmpty = new RegExp(`@${method}\\s*\\(\\s*\\)`, "g");
+            let m;
+            while ((m = reStr.exec(source)) !== null)
+                allMethodPositions.push({ method, path: m[1] ?? "", pos: m.index });
+            while ((m = reEmpty.exec(source)) !== null)
+                allMethodPositions.push({ method, path: "", pos: m.index });
+        }
+        allMethodPositions.sort((a, b) => a.pos - b.pos);
+        for (let idx = 0; idx < allMethodPositions.length; idx++) {
+            if (routes.length >= maxRoutes) {
+                truncated = true;
+                break;
+            }
+            const mm = allMethodPositions[idx];
+            // Normalise: collapse slashes, trim trailing slash (except for root "/")
+            const rawPath = `/${ctrlPrefix}/${mm.path}`.replace(/\/+/g, "/");
+            const fullPath = rawPath.length > 1 ? rawPath.replace(/\/$/, "") : rawPath;
+            if (options?.path && fullPath !== options.path)
+                continue;
+            // Lookback window: from previous method decorator (or class start) to current
+            const prevEnd = idx > 0 ? allMethodPositions[idx - 1].pos + 10 : (classIdx >= 0 ? classIdx : 0);
+            const methodCtx = source.slice(Math.max(prevEnd, 0), mm.pos);
+            const methodGuards = parseUseGuards(methodCtx).map((n) => ({ layer: "method", type: "guard", name: n }));
+            const methodInterceptors = parseUseInterceptors(methodCtx).map((n) => ({ layer: "method", type: "interceptor", name: n }));
+            const methodPipes = parseUsePipes(methodCtx).map((n) => ({ layer: "method", type: "pipe", name: n }));
+            const methodFilters = parseUseFilters(methodCtx).map((n) => ({ layer: "method", type: "filter", name: n }));
+            // G4: custom decorators (e.g. @Roles('admin'), @Public()) — method-level only
+            const methodMetadata = parseCustomDecorators(methodCtx).map((d) => ({
+                layer: "method",
+                type: "metadata",
+                name: d.name,
+                ...(d.args ? { args: d.args } : {}),
+            }));
+            // G1: match middleware entries against this route
+            const middlewareChain = [];
+            for (const mw of middlewareEntries) {
+                for (const mwRoute of mw.routes) {
+                    if (matchMiddlewareRoute(mwRoute, fullPath, mm.method.toUpperCase())) {
+                        middlewareChain.push({ layer: "middleware", type: "guard", name: mw.middleware, file: mw.file });
+                        break;
+                    }
+                }
+            }
+            routes.push({
+                route: fullPath,
+                method: mm.method.toUpperCase(),
+                controller: ctrlClass,
+                file: file.path,
+                chain: [...globalChain, ...middlewareChain, ...ctrlLevelChain, ...methodGuards, ...methodInterceptors, ...methodPipes, ...methodFilters, ...methodMetadata],
+            });
+        }
+    }
+    return {
+        routes,
+        ...(errors.length > 0 ? { errors } : {}),
+        ...(truncated ? { truncated } : {}),
+    };
+}
+//# sourceMappingURL=nest-guard-tools.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * NestJS lifecycle hook mapping.
+ */
+import type { NestToolError } from "./nest-shared-tools.js";
+export interface NestLifecycleEntry {
+    class_name: string;
+    file: string;
+    hook: string;
+    is_async: boolean;
+}
+export interface NestLifecycleMapResult {
+    hooks: NestLifecycleEntry[];
+    errors?: NestToolError[];
+}
+export declare function nestLifecycleMap(repo: string): Promise<NestLifecycleMapResult>;
+//# sourceMappingURL=nest-lifecycle-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nest-lifecycle-tools.d.ts","sourceRoot":"","sources":["../../src/tools/nest-lifecycle-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAc5D,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,sBAAsB,CAAC,CA4CjC"}

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

@@ -0,0 +1,54 @@
+/**
+ * NestJS lifecycle hook mapping.
+ */
+import { getCodeIndex } from "./index-tools.js";
+// ---------------------------------------------------------------------------
+// B5: nest_lifecycle_map — types + implementation
+// ---------------------------------------------------------------------------
+const LIFECYCLE_HOOKS = new Set([
+    "onModuleInit",
+    "onModuleDestroy",
+    "onApplicationBootstrap",
+    "onApplicationShutdown",
+    "beforeApplicationShutdown",
+]);
+export async function nestLifecycleMap(repo) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository "${repo}" not found. Index it first with index_folder.`);
+    }
+    const hooks = [];
+    const errors = [];
+    for (const sym of index.symbols) {
+        if (!LIFECYCLE_HOOKS.has(sym.name))
+            continue;
+        if (sym.kind !== "method" && sym.kind !== "function")
+            continue;
+        // Determine parent class name from source or file context
+        let className = "Unknown";
+        const source = sym.source ?? "";
+        // Try to find the enclosing class via parent_id (if available)
+        const symAny = sym;
+        if (symAny.parent_id) {
+            const parentSym = index.symbols.find((s) => s.id === symAny.parent_id);
+            if (parentSym)
+                className = parentSym.name;
+        }
+        // Fallback: look for class name in source
+        if (className === "Unknown") {
+            // Check if there's a class symbol in the same file that contains this method
+            const classSym = index.symbols.find((s) => s.file === sym.file && s.kind === "class" && s.start_line <= sym.start_line && s.end_line >= sym.end_line);
+            if (classSym)
+                className = classSym.name;
+        }
+        const isAsync = /async\s/.test(source.slice(0, 50));
+        hooks.push({
+            class_name: className,
+            file: sym.file,
+            hook: sym.name,
+            is_async: isAsync,
+        });
+    }
+    return { hooks, ...(errors.length > 0 ? { errors } : {}) };
+}
+//# sourceMappingURL=nest-lifecycle-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nest-lifecycle-tools.js","sourceRoot":"","sources":["../../src/tools/nest-lifecycle-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,8EAA8E;AAC9E,kDAAkD;AAClD,8EAA8E;AAE9E,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,cAAc;IACd,iBAAiB;IACjB,wBAAwB;IACxB,uBAAuB;IACvB,2BAA2B;CAC5B,CAAC,CAAC;AAcH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAY;IAEZ,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,eAAe,IAAI,gDAAgD,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,KAAK,GAAyB,EAAE,CAAC;IACvC,MAAM,MAAM,GAAoB,EAAE,CAAC;IAEnC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAChC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7C,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU;YAAE,SAAS;QAE/D,0DAA0D;QAC1D,IAAI,SAAS,GAAG,SAAS,CAAC;QAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;QAEhC,+DAA+D;QAC/D,MAAM,MAAM,GAAG,GAAwC,CAAC;QACxD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,SAAS,CAAC,CAAC;YACvE,IAAI,SAAS;gBAAE,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC;QAC5C,CAAC;QAED,0CAA0C;QAC1C,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,6EAA6E;YAC7E,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CACjC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,IAAI,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,CACjH,CAAC;YACF,IAAI,QAAQ;gBAAE,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC1C,CAAC;QAED,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAEpD,KAAK,CAAC,IAAI,CAAC;YACT,UAAU,EAAE,SAAS;YACrB,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC7D,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * NestJS module graph analysis.
+ */
+import { type NestToolError } from "./nest-shared-tools.js";
+export interface NestModuleNode {
+    name: string;
+    file: string;
+    is_global: boolean;
+    imports: string[];
+    exports: string[];
+    providers: string[];
+    controllers: string[];
+}
+export interface NestModuleGraphResult {
+    modules: NestModuleNode[];
+    edges: Array<{
+        from: string;
+        to: string;
+    }>;
+    circular_deps: string[][];
+    errors?: NestToolError[];
+    truncated?: boolean;
+}
+export declare function nestModuleGraph(repo: string, options?: {
+    max_modules?: number;
+    output_format?: "json" | "mermaid";
+}): Promise<NestModuleGraphResult>;
+//# sourceMappingURL=nest-module-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nest-module-tools.d.ts","sourceRoot":"","sources":["../../src/tools/nest-module-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAO1E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,aAAa,EAAE,MAAM,EAAE,EAAE,CAAC;IAC1B,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACrE,OAAO,CAAC,qBAAqB,CAAC,CAmFhC"}

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

@@ -0,0 +1,86 @@
+/**
+ * NestJS module graph analysis.
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { getCodeIndex } from "./index-tools.js";
+import { detectCycles } from "./nest-shared-tools.js";
+import { extractNestConventions } from "./project-tools.js";
+export async function nestModuleGraph(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found. Index it first with index_folder.`);
+    const maxModules = options?.max_modules ?? 200;
+    const moduleFiles = index.files.filter((f) => f.path.endsWith(".module.ts") || f.path.endsWith(".module.js"));
+    const modules = [];
+    const edges = [];
+    const errors = [];
+    let truncated = false;
+    // Parse each module file
+    for (const file of moduleFiles) {
+        if (modules.length >= maxModules) {
+            truncated = true;
+            break;
+        }
+        let source;
+        try {
+            source = await readFile(join(index.root, file.path), "utf-8");
+        }
+        catch (err) {
+            errors.push({ file: file.path, reason: `readFile failed: ${err instanceof Error ? err.message : String(err)}` });
+            continue;
+        }
+        const conv = extractNestConventions(source, file.path);
+        // Find the module class name from source
+        const classMatch = /export\s+class\s+(\w+Module)\b/.exec(source);
+        const moduleName = classMatch?.[1] ?? file.path.replace(/.*\//, "").replace(/\.module\.[jt]sx?$/, "Module");
+        // Check for @Global()
+        const isGlobal = /@Global\s*\(\s*\)/.test(source) || conv.modules.some((m) => m.is_global && m.name === moduleName);
+        // Extract exports array
+        const exportNames = [];
+        const exportsMatch = /exports:\s*\[([^\]]*)\]/s.exec(source);
+        if (exportsMatch) {
+            const inner = exportsMatch[1];
+            for (const m of inner.matchAll(/(\w+)/g)) {
+                exportNames.push(m[1]);
+            }
+        }
+        // Extract provider names
+        const providerNames = [];
+        const providersMatch = /providers:\s*\[([^\]]*)\]/s.exec(source);
+        if (providersMatch) {
+            const inner = providersMatch[1];
+            for (const m of inner.matchAll(/(?:useClass:\s*)?(\w+(?:Service|Provider|Guard|Interceptor|Pipe|Filter|Factory|Strategy))\b/g)) {
+                providerNames.push(m[1]);
+            }
+        }
+        modules.push({
+            name: moduleName,
+            file: file.path,
+            is_global: isGlobal,
+            imports: conv.modules.map((m) => m.name),
+            exports: exportNames,
+            providers: providerNames,
+            controllers: conv.controllers,
+        });
+    }
+    // Build edges: module → imported module
+    const moduleNames = new Set(modules.map((m) => m.name));
+    for (const mod of modules) {
+        for (const imp of mod.imports) {
+            if (moduleNames.has(imp)) {
+                edges.push({ from: mod.name, to: imp });
+            }
+        }
+    }
+    // Detect circular deps via DFS
+    const circular_deps = detectCycles(modules.map((m) => m.name), edges);
+    return {
+        modules,
+        edges,
+        circular_deps,
+        ...(errors.length > 0 ? { errors } : {}),
+        ...(truncated ? { truncated } : {}),
+    };
+}
+//# sourceMappingURL=nest-module-tools.js.map

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * NestJS request pipeline visualization.
+ */
+import type { NestToolError } from "./nest-shared-tools.js";
+export interface NestPipelineStep {
+    layer: "middleware" | "global-guard" | "global-filter" | "global-pipe" | "global-interceptor" | "controller-guard" | "controller-interceptor" | "controller-pipe" | "controller-filter" | "method-guard" | "method-interceptor" | "method-pipe" | "method-filter" | "custom-metadata" | "handler";
+    name: string;
+    file?: string;
+    note?: string;
+}
+export interface NestRequestPipelineResult {
+    route: string;
+    method: string;
+    controller: string;
+    handler: string;
+    file: string;
+    steps: NestPipelineStep[];
+    mermaid?: string;
+    errors?: NestToolError[];
+}
+/**
+ * Wave 3 Feature 1: visualize the full NestJS request pipeline for a single route.
+ * Walks middleware.configure() chain, global guards/filters/pipes/interceptors,
+ * controller-level decorators, method-level decorators, and the handler itself.
+ * Returns ordered steps + optional mermaid diagram.
+ */
+export declare function nestRequestPipeline(repo: string, options: {
+    route: string;
+    method?: string;
+    output_format?: "json" | "mermaid";
+}): Promise<NestRequestPipelineResult>;
+//# sourceMappingURL=nest-pipeline-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nest-pipeline-tools.d.ts","sourceRoot":"","sources":["../../src/tools/nest-pipeline-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAM5D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,YAAY,GAAG,cAAc,GAAG,eAAe,GAAG,aAAa,GAAG,oBAAoB,GACtF,kBAAkB,GAAG,wBAAwB,GAAG,iBAAiB,GAAG,mBAAmB,GACvF,cAAc,GAAG,oBAAoB,GAAG,aAAa,GAAG,eAAe,GACvE,iBAAiB,GAAG,SAAS,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC9E,OAAO,CAAC,yBAAyB,CAAC,CAqHpC"}

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

@@ -0,0 +1,122 @@
+/**
+ * NestJS request pipeline visualization.
+ */
+import { getCodeIndex } from "./index-tools.js";
+import { nestGuardChain } from "./nest-guard-tools.js";
+import { nestRouteInventory } from "./nest-route-tools.js";
+/**
+ * Wave 3 Feature 1: visualize the full NestJS request pipeline for a single route.
+ * Walks middleware.configure() chain, global guards/filters/pipes/interceptors,
+ * controller-level decorators, method-level decorators, and the handler itself.
+ * Returns ordered steps + optional mermaid diagram.
+ */
+export async function nestRequestPipeline(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found. Index it first with index_folder.`);
+    const targetRoute = options.route;
+    const targetMethod = (options.method ?? "GET").toUpperCase();
+    // Reuse nestGuardChain for the chain + nestRouteInventory for handler name + file
+    const [chainResult, inventoryResult] = await Promise.all([
+        nestGuardChain(repo, { path: targetRoute }),
+        nestRouteInventory(repo),
+    ]);
+    const matchingRoute = chainResult.routes.find((r) => r.route === targetRoute && r.method === targetMethod);
+    const inventoryEntry = inventoryResult.routes.find((r) => r.path === targetRoute && r.method === targetMethod);
+    if (!matchingRoute) {
+        return {
+            route: targetRoute,
+            method: targetMethod,
+            controller: "NotFound",
+            handler: "NotFound",
+            file: "",
+            steps: [],
+            ...(chainResult.errors ? { errors: chainResult.errors } : {}),
+        };
+    }
+    const resolvedHandler = inventoryEntry?.handler ?? "anonymous";
+    // Convert chain items to pipeline steps in canonical execution order:
+    //   middleware → global guards → controller guards → method guards
+    //   → global pipes → controller pipes → method pipes → inline pipes
+    //   → global interceptors (pre) → controller interceptors (pre) → method interceptors (pre)
+    //   → handler
+    //   → method interceptors (post) → controller interceptors (post) → global interceptors (post)
+    //   → global filters → controller filters → method filters
+    const steps = [];
+    const byLayerAndType = (layer, type) => matchingRoute.chain.filter((c) => c.layer === layer && c.type === type);
+    // 1. Middleware layer (runs first in NestJS request pipeline)
+    for (const c of byLayerAndType("middleware", "guard")) {
+        steps.push({ layer: "middleware", name: c.name, ...(c.file ? { file: c.file } : {}), note: "module.configure()" });
+    }
+    // 2. Guards (global → controller → method)
+    for (const c of byLayerAndType("global", "guard"))
+        steps.push({ layer: "global-guard", name: c.name, ...(c.file ? { file: c.file } : {}) });
+    for (const c of byLayerAndType("controller", "guard"))
+        steps.push({ layer: "controller-guard", name: c.name });
+    for (const c of byLayerAndType("method", "guard"))
+        steps.push({ layer: "method-guard", name: c.name });
+    // 3. Pipes (global → controller → method)
+    for (const c of byLayerAndType("global", "pipe"))
+        steps.push({ layer: "global-pipe", name: c.name, ...(c.file ? { file: c.file } : {}) });
+    for (const c of byLayerAndType("controller", "pipe"))
+        steps.push({ layer: "controller-pipe", name: c.name });
+    for (const c of byLayerAndType("method", "pipe"))
+        steps.push({ layer: "method-pipe", name: c.name });
+    // 4. Interceptors (pre-handler; global → controller → method)
+    for (const c of byLayerAndType("global", "interceptor"))
+        steps.push({ layer: "global-interceptor", name: c.name, ...(c.file ? { file: c.file } : {}), note: "pre-handler" });
+    for (const c of byLayerAndType("controller", "interceptor"))
+        steps.push({ layer: "controller-interceptor", name: c.name, note: "pre-handler" });
+    for (const c of byLayerAndType("method", "interceptor"))
+        steps.push({ layer: "method-interceptor", name: c.name, note: "pre-handler" });
+    // 5. Custom metadata decorators (@Roles, @Public, etc. — informational, don't execute)
+    for (const c of byLayerAndType("method", "metadata")) {
+        steps.push({
+            layer: "custom-metadata",
+            name: c.name,
+            note: c.args ? `args: ${c.args}` : "metadata only",
+        });
+    }
+    // 6. Handler (the method itself)
+    steps.push({
+        layer: "handler",
+        name: resolvedHandler,
+        file: matchingRoute.file,
+        note: `${matchingRoute.method} ${matchingRoute.route}`,
+    });
+    // 7. Filters (for exception handling — run if handler throws)
+    for (const c of byLayerAndType("global", "filter"))
+        steps.push({ layer: "global-filter", name: c.name, ...(c.file ? { file: c.file } : {}), note: "exception handler" });
+    for (const c of byLayerAndType("controller", "filter"))
+        steps.push({ layer: "controller-filter", name: c.name, note: "exception handler" });
+    for (const c of byLayerAndType("method", "filter"))
+        steps.push({ layer: "method-filter", name: c.name, note: "exception handler" });
+    const result = {
+        route: matchingRoute.route,
+        method: matchingRoute.method,
+        controller: matchingRoute.controller,
+        handler: resolvedHandler,
+        file: matchingRoute.file,
+        steps,
+        ...(chainResult.errors ? { errors: chainResult.errors } : {}),
+    };
+    // Optional mermaid output
+    if (options.output_format === "mermaid") {
+        const lines = ["flowchart TD"];
+        lines.push(`    Request["${matchingRoute.method} ${matchingRoute.route}"]`);
+        let prev = "Request";
+        let idx = 0;
+        for (const step of steps) {
+            idx++;
+            const id = `S${idx}`;
+            const label = step.note ? `${step.name}<br/>${step.note}` : step.name;
+            const shape = step.layer === "handler" ? `(["${label}"])` : `["${label}"]`;
+            lines.push(`    ${id}${shape}`);
+            lines.push(`    ${prev} --> ${id}`);
+            prev = id;
+        }
+        result.mermaid = lines.join("\n");
+    }
+    return result;
+}
+//# sourceMappingURL=nest-pipeline-tools.js.map