codesift-mcp 0.9.0 → 0.9.10

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

@@ -0,0 +1,232 @@
+/**
+ * NestJS audit meta-orchestrator.
+ */
+import { getCodeIndex } from "./index-tools.js";
+import { nestDIGraph } from "./nest-di-tools.js";
+import { nestGuardChain } from "./nest-guard-tools.js";
+import { nestLifecycleMap } from "./nest-lifecycle-tools.js";
+import { nestModuleGraph } from "./nest-module-tools.js";
+import { nestRouteInventory } from "./nest-route-tools.js";
+const ALL_NEST_CHECKS = [
+    "modules", "routes", "di", "guards", "lifecycle", "patterns",
+    "graphql", "websocket", "schedule", "typeorm", "microservice",
+];
+export async function nestAudit(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found. Index it first with index_folder.`);
+    // Check if this is a NestJS repo
+    const { detectFrameworks } = await import("../utils/framework-detect.js");
+    const frameworks = detectFrameworks(index);
+    if (!frameworks.has("nestjs")) {
+        return {
+            framework_detected: false,
+            summary: { total_routes: 0, cycles: 0, violations: 0, anti_pattern_hits: 0, failed_checks: 0, truncated_checks: [] },
+        };
+    }
+    const enabledChecks = new Set((options?.checks ?? [...ALL_NEST_CHECKS]));
+    const tasks = [];
+    if (enabledChecks.has("lifecycle")) {
+        tasks.push(nestLifecycleMap(repo).then((r) => ({ name: "lifecycle", result: r }))
+            .catch((e) => ({ name: "lifecycle", error: e instanceof Error ? e.message : String(e) })));
+    }
+    if (enabledChecks.has("modules")) {
+        tasks.push(nestModuleGraph(repo).then((r) => ({ name: "modules", result: r }))
+            .catch((e) => ({ name: "modules", error: e instanceof Error ? e.message : String(e) })));
+    }
+    if (enabledChecks.has("di")) {
+        tasks.push(nestDIGraph(repo).then((r) => ({ name: "di", result: r }))
+            .catch((e) => ({ name: "di", error: e instanceof Error ? e.message : String(e) })));
+    }
+    if (enabledChecks.has("guards")) {
+        tasks.push(nestGuardChain(repo).then((r) => ({ name: "guards", result: r }))
+            .catch((e) => ({ name: "guards", error: e instanceof Error ? e.message : String(e) })));
+    }
+    if (enabledChecks.has("routes")) {
+        tasks.push(nestRouteInventory(repo).then((r) => ({ name: "routes", result: r }))
+            .catch((e) => ({ name: "routes", error: e instanceof Error ? e.message : String(e) })));
+    }
+    if (enabledChecks.has("patterns")) {
+        tasks.push((async () => {
+            const { searchPatterns, listPatterns } = await import("./pattern-tools.js");
+            const nestPatterns = listPatterns().filter((p) => p.name.startsWith("nest-"));
+            const results = [];
+            for (const p of nestPatterns) {
+                const r = await searchPatterns(repo, p.name);
+                if (r.matches.length > 0)
+                    results.push({ pattern: p.name, count: r.matches.length });
+            }
+            return { name: "patterns", result: results };
+        })().catch((e) => ({ name: "patterns", error: e instanceof Error ? e.message : String(e) })));
+    }
+    // Wave 2 checks — lazy import to avoid eager loading if nest-ext-tools isn't needed
+    if (enabledChecks.has("graphql")) {
+        tasks.push((async () => {
+            const { nestGraphQLMap } = await import("./nest-ext-tools.js");
+            return { name: "graphql", result: await nestGraphQLMap(repo) };
+        })().catch((e) => ({ name: "graphql", error: e instanceof Error ? e.message : String(e) })));
+    }
+    if (enabledChecks.has("websocket")) {
+        tasks.push((async () => {
+            const { nestWebSocketMap } = await import("./nest-ext-tools.js");
+            return { name: "websocket", result: await nestWebSocketMap(repo) };
+        })().catch((e) => ({ name: "websocket", error: e instanceof Error ? e.message : String(e) })));
+    }
+    if (enabledChecks.has("schedule")) {
+        tasks.push((async () => {
+            const { nestScheduleMap } = await import("./nest-ext-tools.js");
+            return { name: "schedule", result: await nestScheduleMap(repo) };
+        })().catch((e) => ({ name: "schedule", error: e instanceof Error ? e.message : String(e) })));
+    }
+    if (enabledChecks.has("typeorm")) {
+        tasks.push((async () => {
+            const { nestTypeOrmMap } = await import("./nest-ext-tools.js");
+            return { name: "typeorm", result: await nestTypeOrmMap(repo) };
+        })().catch((e) => ({ name: "typeorm", error: e instanceof Error ? e.message : String(e) })));
+    }
+    if (enabledChecks.has("microservice")) {
+        tasks.push((async () => {
+            const { nestMicroserviceMap } = await import("./nest-ext-tools.js");
+            return { name: "microservice", result: await nestMicroserviceMap(repo) };
+        })().catch((e) => ({ name: "microservice", error: e instanceof Error ? e.message : String(e) })));
+    }
+    const settled = await Promise.all(tasks);
+    // Aggregate
+    const auditErrors = [];
+    const warnings = [];
+    const truncatedChecks = [];
+    let lifecycleResult;
+    let moduleResult;
+    let diResult;
+    let guardResult;
+    let routeResult;
+    let patternResults;
+    let graphqlResult;
+    let websocketResult;
+    let scheduleResult;
+    let typeormResult;
+    let microserviceResult;
+    for (const item of settled) {
+        if (item.error) {
+            auditErrors.push({ check: item.name, reason: item.error });
+            continue;
+        }
+        switch (item.name) {
+            case "lifecycle":
+                lifecycleResult = item.result;
+                break;
+            case "modules": {
+                const r = item.result;
+                moduleResult = r;
+                if (r.truncated)
+                    truncatedChecks.push("modules");
+                if (r.errors)
+                    warnings.push(...r.errors);
+                break;
+            }
+            case "di": {
+                const r = item.result;
+                diResult = r;
+                if (r.truncated)
+                    truncatedChecks.push("di");
+                if (r.errors)
+                    warnings.push(...r.errors);
+                break;
+            }
+            case "guards": {
+                const r = item.result;
+                guardResult = r;
+                if (r.truncated)
+                    truncatedChecks.push("guards");
+                if (r.errors)
+                    warnings.push(...r.errors);
+                break;
+            }
+            case "routes": {
+                const r = item.result;
+                routeResult = r;
+                if (r.truncated)
+                    truncatedChecks.push("routes");
+                if (r.errors)
+                    warnings.push(...r.errors);
+                break;
+            }
+            case "patterns":
+                patternResults = item.result;
+                break;
+            case "graphql": {
+                const r = item.result;
+                graphqlResult = r;
+                if (r.truncated)
+                    truncatedChecks.push("graphql");
+                if (r.errors)
+                    warnings.push(...r.errors);
+                break;
+            }
+            case "websocket": {
+                const r = item.result;
+                websocketResult = r;
+                if (r.truncated)
+                    truncatedChecks.push("websocket");
+                if (r.errors)
+                    warnings.push(...r.errors);
+                break;
+            }
+            case "schedule": {
+                const r = item.result;
+                scheduleResult = r;
+                if (r.truncated)
+                    truncatedChecks.push("schedule");
+                if (r.errors)
+                    warnings.push(...r.errors);
+                break;
+            }
+            case "typeorm": {
+                const r = item.result;
+                typeormResult = r;
+                if (r.truncated)
+                    truncatedChecks.push("typeorm");
+                if (r.errors)
+                    warnings.push(...r.errors);
+                break;
+            }
+            case "microservice": {
+                const r = item.result;
+                microserviceResult = r;
+                if (r.truncated)
+                    truncatedChecks.push("microservice");
+                if (r.errors)
+                    warnings.push(...r.errors);
+                break;
+            }
+        }
+    }
+    const totalRoutes = routeResult?.stats.total_routes ?? 0;
+    const cycles = (moduleResult?.circular_deps.length ?? 0) + (diResult?.cycles.length ?? 0) + (typeormResult?.cycles.length ?? 0);
+    const antiPatternHits = patternResults?.reduce((sum, p) => sum + p.count, 0) ?? 0;
+    return {
+        framework_detected: true,
+        ...(lifecycleResult ? { lifecycle_map: lifecycleResult } : {}),
+        ...(moduleResult ? { module_graph: moduleResult } : {}),
+        ...(diResult ? { di_graph: diResult } : {}),
+        ...(guardResult ? { guard_chain: guardResult } : {}),
+        ...(routeResult ? { route_inventory: routeResult } : {}),
+        ...(graphqlResult ? { graphql_map: graphqlResult } : {}),
+        ...(websocketResult ? { websocket_map: websocketResult } : {}),
+        ...(scheduleResult ? { schedule_map: scheduleResult } : {}),
+        ...(typeormResult ? { typeorm_map: typeormResult } : {}),
+        ...(microserviceResult ? { microservice_map: microserviceResult } : {}),
+        ...(patternResults ? { anti_patterns: patternResults } : {}),
+        summary: {
+            total_routes: totalRoutes,
+            cycles,
+            violations: (moduleResult?.circular_deps.length ?? 0) + (diResult?.cross_module_warnings.length ?? 0),
+            anti_pattern_hits: antiPatternHits,
+            failed_checks: auditErrors.length,
+            truncated_checks: truncatedChecks,
+        },
+        ...(warnings.length > 0 ? { warnings } : {}),
+        ...(auditErrors.length > 0 ? { errors: auditErrors } : {}),
+    };
+}
+//# sourceMappingURL=nest-audit-tools.js.map

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * NestJS dependency-injection graph analysis.
+ */
+import { type NestToolError } from "./nest-shared-tools.js";
+export interface NestDINode {
+    name: string;
+    file: string;
+    kind: "provider" | "module" | "controller";
+    scope?: string;
+}
+export interface NestDIEdge {
+    from: string;
+    to: string;
+    via: "inject" | "import";
+}
+export interface NestDIGraphResult {
+    nodes: NestDINode[];
+    edges: NestDIEdge[];
+    cycles: string[][];
+    cross_module_warnings: Array<{
+        provider: string;
+        used_in: string;
+        defined_in: string;
+    }>;
+    errors?: NestToolError[];
+    truncated?: boolean;
+}
+export declare function nestDIGraph(repo: string, options?: {
+    max_nodes?: number;
+    focus?: string;
+}): Promise<NestDIGraphResult>;
+//# sourceMappingURL=nest-di-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nest-di-tools.d.ts","sourceRoot":"","sources":["../../src/tools/nest-di-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAM1E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IACnB,qBAAqB,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxF,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAiFD,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC,iBAAiB,CAAC,CA+D5B"}

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

@@ -0,0 +1,161 @@
+/**
+ * NestJS dependency-injection 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";
+// ---------------------------------------------------------------------------
+// Shared helpers: constructor injection parsing (CQ14)
+// ---------------------------------------------------------------------------
+/** Extract constructor parameter body using paren counting (handles decorated params) */
+function extractConstructorBody(source) {
+    const ctorIdx = source.indexOf("constructor(");
+    if (ctorIdx === -1)
+        return null;
+    const start = ctorIdx + "constructor(".length;
+    let depth = 1;
+    let i = start;
+    while (i < source.length && depth > 0) {
+        if (source[i] === "(")
+            depth++;
+        else if (source[i] === ")")
+            depth--;
+        i++;
+    }
+    return depth === 0 ? source.slice(start, i - 1) : null;
+}
+/** Extract injected type names from a constructor body string */
+function extractInjectedTypes(ctorBody) {
+    const types = [];
+    // R-6 fix: separate depth counters for () and <> to avoid cross-corruption
+    const params = [];
+    let parenDepth = 0;
+    let angleDepth = 0;
+    let current = "";
+    for (const ch of ctorBody) {
+        if (ch === "(")
+            parenDepth++;
+        else if (ch === ")")
+            parenDepth--;
+        else if (ch === "<")
+            angleDepth++;
+        else if (ch === ">")
+            angleDepth--;
+        if (ch === "," && parenDepth === 0 && angleDepth === 0) {
+            params.push(current.trim());
+            current = "";
+        }
+        else {
+            current += ch;
+        }
+    }
+    if (current.trim())
+        params.push(current.trim());
+    for (const param of params) {
+        // Extract type after the last `:` — handles decorators before the param name
+        const colonIdx = param.lastIndexOf(":");
+        if (colonIdx === -1)
+            continue;
+        const typeStr = param.slice(colonIdx + 1).trim();
+        // G3: Detect container generics like Repository<User>, Model<Comment>, Repo<X>.
+        // For container types, unwrap and return the inner type parameter so consumers
+        // can distinguish Repository<Article> from Repository<Comment>.
+        const genericMatch = typeStr.match(/^(\w+)<\s*(\w+)\s*(?:,[^>]*)?>/);
+        if (genericMatch) {
+            const outer = genericMatch[1];
+            const inner = genericMatch[2];
+            if (/^(Repository|Repo|Model|Collection|Array|Set|Map|List|Observable|Promise|Ref|Token|Provider|Class)$/.test(outer)) {
+                types.push(inner);
+                continue;
+            }
+        }
+        // Non-container type — return the outer name as before
+        const typeMatch = typeStr.match(/^(\w+)/);
+        if (typeMatch)
+            types.push(typeMatch[1]);
+    }
+    return types;
+}
+/** Parse @Injectable() classes from source */
+function parseInjectableClasses(source) {
+    const results = [];
+    const re = /@Injectable\s*\(([^)]*)\)\s*(?:export\s+)?class\s+(\w+)/g;
+    let m;
+    while ((m = re.exec(source)) !== null) {
+        const args = m[1] ?? "";
+        const name = m[2];
+        const scopeMatch = args.match(/scope:\s*Scope\.(\w+)/);
+        results.push({ name, ...(scopeMatch ? { scope: scopeMatch[1] } : {}) });
+    }
+    return results;
+}
+export async function nestDIGraph(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found. Index it first with index_folder.`);
+    const maxNodes = options?.max_nodes ?? 200;
+    const focus = options?.focus;
+    const nodes = [];
+    const edges = [];
+    const errors = [];
+    let truncated = false;
+    // Scan files for @Injectable classes
+    const candidateFiles = index.files.filter((f) => {
+        if (focus && !f.path.includes(focus))
+            return false;
+        return f.path.endsWith(".ts") || f.path.endsWith(".js");
+    });
+    for (const file of candidateFiles) {
+        if (nodes.length >= maxNodes) {
+            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 injectables = parseInjectableClasses(source);
+        for (const inj of injectables) {
+            if (nodes.length >= maxNodes) {
+                truncated = true;
+                break;
+            }
+            nodes.push({
+                name: inj.name,
+                file: file.path,
+                kind: "provider",
+                ...(inj.scope ? { scope: inj.scope } : {}),
+            });
+            // Extract constructor injection
+            // Find the class body for this specific injectable
+            const classIdx = source.indexOf(`class ${inj.name}`);
+            if (classIdx === -1)
+                continue;
+            const classSource = source.slice(classIdx);
+            const ctorBody = extractConstructorBody(classSource);
+            if (!ctorBody)
+                continue;
+            const injectedTypes = extractInjectedTypes(ctorBody);
+            for (const type of injectedTypes) {
+                edges.push({ from: inj.name, to: type, via: "inject" });
+            }
+        }
+    }
+    // Detect cycles
+    const nodeNames = nodes.map((n) => n.name);
+    const cycles = detectCycles(nodeNames, edges.map((e) => ({ from: e.from, to: e.to })));
+    return {
+        nodes,
+        edges,
+        cycles,
+        cross_module_warnings: [],
+        ...(errors.length > 0 ? { errors } : {}),
+        ...(truncated ? { truncated } : {}),
+    };
+}
+//# sourceMappingURL=nest-di-tools.js.map

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * NestJS guard, middleware, and decorator chain analysis.
+ */
+import type { NestToolError } from "./nest-shared-tools.js";
+export interface NestGuardChainEntry {
+    route: string;
+    method: string;
+    controller: string;
+    file: string;
+    chain: Array<{
+        /** G1: "middleware" layer for NestModule.configure(consumer) entries */
+        layer: "global" | "controller" | "method" | "middleware";
+        /** G4: "metadata" type for custom decorators like @Roles('admin') */
+        type: "guard" | "interceptor" | "pipe" | "filter" | "metadata";
+        name: string;
+        file?: string;
+        /** G4: raw decorator argument text (e.g., "admin" from @Roles('admin')) */
+        args?: string;
+    }>;
+}
+export interface NestGuardChainResult {
+    routes: NestGuardChainEntry[];
+    errors?: NestToolError[];
+    truncated?: boolean;
+}
+/** 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 declare function parseUseGuards(source: string): string[];
+export declare function nestGuardChain(repo: string, options?: {
+    path?: string;
+    max_routes?: number;
+}): Promise<NestGuardChainResult>;
+//# sourceMappingURL=nest-guard-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nest-guard-tools.d.ts","sourceRoot":"","sources":["../../src/tools/nest-guard-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAO5D,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,KAAK,CAAC;QACX,wEAAwE;QACxE,KAAK,EAAE,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,YAAY,CAAC;QACzD,qEAAqE;QACrE,IAAI,EAAE,OAAO,GAAG,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;QAC/D,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,2EAA2E;QAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,aAAa,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAMD;;0DAE0D;AAC1D,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBvD;AAwFD,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC,oBAAoB,CAAC,CAyH/B"}