codesift-mcp 0.3.0 → 0.4.0

package/dist/tools/room-tools.js

@@ -0,0 +1,147 @@
+/**
+ * Room persistence library analysis tools.
+ *
+ * trace_room_schema — build Entity → Dao → Database graph from indexed
+ * Kotlin symbols annotated with @Entity, @Dao, @Database, @Query, etc.
+ */
+import { getCodeIndex } from "./index-tools.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function hasAnnotation(sym, name) {
+    if (sym.decorators?.includes(name))
+        return true;
+    const head = sym.source?.slice(0, 300);
+    if (!head)
+        return false;
+    return new RegExp(`@${name}\\b`).test(head);
+}
+/**
+ * Extract `tableName = "..."` from @Entity annotation source.
+ * Falls back to camelCase→snake_case of the class name.
+ */
+function extractTableName(sym) {
+    const src = sym.source ?? "";
+    const match = /tableName\s*=\s*"([^"]+)"/.exec(src);
+    if (match)
+        return match[1];
+    // Fallback: Room default = class name (no case conversion in Room)
+    return sym.name;
+}
+/**
+ * Extract SQL string from @Query("...") on a method.
+ */
+function extractQuerySql(sym) {
+    const src = sym.source ?? "";
+    const match = /@Query\s*\(\s*"((?:[^"\\]|\\.)*)"\s*\)/.exec(src);
+    return match?.[1]?.replace(/\\"/g, '"') ?? null;
+}
+/**
+ * Extract entity class references from @Database(entities = [...]).
+ */
+function extractDatabaseEntityRefs(sym) {
+    const src = sym.source ?? "";
+    const match = /entities\s*=\s*\[([^\]]+)\]/.exec(src);
+    if (!match)
+        return [];
+    // Parse `UserEntity::class, OrderEntity::class`
+    return match[1]
+        .split(",")
+        .map((s) => s.trim().replace(/::class$/, "").trim())
+        .filter(Boolean);
+}
+function extractDatabaseVersion(sym) {
+    const src = sym.source ?? "";
+    const match = /version\s*=\s*(\d+)/.exec(src);
+    return match ? parseInt(match[1], 10) : undefined;
+}
+// ---------------------------------------------------------------------------
+// trace_room_schema
+// ---------------------------------------------------------------------------
+export async function traceRoomSchema(repo) {
+    const index = await getCodeIndex(repo);
+    if (!index) {
+        throw new Error(`Repository "${repo}" not found. Index it first with index_folder.`);
+    }
+    const entities = [];
+    const daos = [];
+    const databases = [];
+    const daoById = new Map();
+    // First pass: classify @Entity, @Dao, @Database.
+    for (const sym of index.symbols) {
+        if (sym.kind !== "class" && sym.kind !== "interface")
+            continue;
+        if (hasAnnotation(sym, "Entity")) {
+            entities.push({
+                name: sym.name,
+                file: sym.file,
+                start_line: sym.start_line,
+                table_name: extractTableName(sym),
+                has_primary_key: /\b(?:@PrimaryKey|primaryKeys)\b/.test(sym.source ?? ""),
+            });
+        }
+        if (hasAnnotation(sym, "Dao")) {
+            const dao = {
+                name: sym.name,
+                file: sym.file,
+                start_line: sym.start_line,
+                queries: [],
+                entity_refs: [],
+            };
+            daos.push(dao);
+            daoById.set(sym.id, dao);
+        }
+        if (hasAnnotation(sym, "Database")) {
+            const db = {
+                name: sym.name,
+                file: sym.file,
+                start_line: sym.start_line,
+                entity_refs: extractDatabaseEntityRefs(sym),
+            };
+            const ver = extractDatabaseVersion(sym);
+            if (ver != null)
+                db.version = ver;
+            databases.push(db);
+        }
+    }
+    // Second pass: attach @Query/@Insert/@Update/@Delete methods to parent Dao.
+    const ROOM_METHOD_ANNOTATIONS = ["Query", "Insert", "Update", "Delete", "RawQuery"];
+    for (const sym of index.symbols) {
+        if (sym.kind !== "method" && sym.kind !== "function")
+            continue;
+        if (!sym.parent)
+            continue;
+        const dao = daoById.get(sym.parent);
+        if (!dao)
+            continue;
+        for (const ann of ROOM_METHOD_ANNOTATIONS) {
+            if (hasAnnotation(sym, ann)) {
+                const sql = ann === "Query" ? extractQuerySql(sym) : null;
+                dao.queries.push({
+                    name: sym.name,
+                    file: sym.file,
+                    start_line: sym.start_line,
+                    sql: sql ?? `[${ann}]`,
+                    annotation: ann,
+                });
+                // Track entity references from return types / param types.
+                const sig = sym.signature ?? "";
+                for (const entity of entities) {
+                    if (sig.includes(entity.name)) {
+                        if (!dao.entity_refs.includes(entity.name)) {
+                            dao.entity_refs.push(entity.name);
+                        }
+                    }
+                }
+                break;
+            }
+        }
+    }
+    return {
+        entities,
+        daos,
+        databases,
+        total_queries: daos.reduce((n, d) => n + d.queries.length, 0),
+    };
+}
+//# sourceMappingURL=room-tools.js.map

package/dist/tools/room-tools.js.map

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

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

@@ -1,9 +1,12 @@
 import { stripSource } from "./graph-tools.js";
+import type { CodeIndex, RouteFramework } from "../types.js";
+import type { MiddlewareTraceResult } from "../utils/nextjs.js";
 interface RouteHandler {
     symbol: ReturnType<typeof stripSource>;
     file: string;
     method?: string;
-    framework: "nestjs" | "nextjs" | "express" | "unknown";
+    framework: RouteFramework;
+    router?: "app" | "pages";
 }
 interface DbCall {
     symbol_name: string;
@@ -21,7 +24,30 @@ export interface RouteTraceResult {
         depth: number;
     }>;
     db_calls: DbCall[];
+    middleware?: MiddlewareTraceResult;
+    layout_chain?: string[];
+    server_actions?: Array<{
+        name: string;
+        file: string;
+        called_from?: string | undefined;
+    }>;
 }
+/**
+ * Match a URL path pattern against a route definition.
+ * Handles :param, [param], [...param], [[...param]], <type:name> (Flask/Django),
+ * {name} (FastAPI) as wildcards.
+ */
+export declare function matchPath(routePath: string, searchPath: string): boolean;
+/**
+ * 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
+ */
+export declare function routeToMermaid(result: RouteTraceResult): string;
 /**
  * Trace an HTTP route: find handler, trace callees, identify DB calls.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"route-tools.d.ts","sourceRoot":"","sources":["../../src/tools/route-tools.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsC,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAUnF,UAAU,YAAY;IACpB,MAAM,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CACxD;AAED,UAAU,MAAM;IACd,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;CACpB;AAoQD;;GAEG;AACH,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,CAqDjD"}
+{"version":3,"file":"route-tools.d.ts","sourceRoot":"","sources":["../../src/tools/route-tools.ts"],"names":[],"mappings":"AAKA,OAAO,EAAsC,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,KAAK,EAAc,SAAS,EAAY,cAAc,EAAE,MAAM,aAAa,CAAC;AAGnF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAuBhE,UAAU,YAAY;IACpB,MAAM,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;IACvC,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,UAAU,MAAM;IACd,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;AAID;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAexE;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAgEtG;AAmVD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAkF/D;AAmgBD;;GAEG;AACH,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,CA+FjD"}