codesight 1.2.0 → 1.3.0

package/dist/detectors/routes.js

@@ -1,5 +1,7 @@
 import { relative, basename } from "node:path";
 import { readFileSafe } from "../scanner.js";
+import { loadTypeScript } from "../ast/loader.js";
+import { extractRoutesAST } from "../ast/extract-routes.js";
 const HTTP_METHODS = ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "HEAD"];
 const TAG_PATTERNS = [
     ["auth", [/auth/i, /jwt/i, /token/i, /session/i, /bearer/i, /passport/i, /clerk/i, /betterAuth/i, /better-auth/i]],
@@ -157,11 +159,22 @@ async function detectNextPagesApi(files, project) {
 async function detectHonoRoutes(files, project) {
     const tsFiles = files.filter((f) => f.match(/\.(ts|js|tsx|jsx|mjs)$/));
     const routes = [];
+    const ts = loadTypeScript(project.root);
     for (const file of tsFiles) {
         const content = await readFileSafe(file);
         if (!content.includes("hono") && !content.includes("Hono"))
             continue;
         const rel = relative(project.root, file);
+        const tags = detectTags(content);
+        // Try AST first
+        if (ts) {
+            const astRoutes = extractRoutesAST(ts, rel, content, "hono", tags);
+            if (astRoutes.length > 0) {
+                routes.push(...astRoutes);
+                continue;
+            }
+        }
+        // Regex fallback
         const routePattern = /\.\s*(get|post|put|patch|delete|options|all)\s*\(\s*['"`]([^'"`]+)['"`]/gi;
         let match;
         while ((match = routePattern.exec(content)) !== null) {
@@ -172,8 +185,9 @@ async function detectHonoRoutes(files, project) {
                 method: match[1].toUpperCase(),
                 path,
                 file: rel,
-                tags: detectTags(content),
+                tags,
                 framework: "hono",
+                confidence: "regex",
             });
         }
     }
@@ -183,11 +197,22 @@ async function detectHonoRoutes(files, project) {
 async function detectExpressRoutes(files, project) {
     const tsFiles = files.filter((f) => f.match(/\.(ts|js|mjs|cjs)$/));
     const routes = [];
+    const ts = loadTypeScript(project.root);
     for (const file of tsFiles) {
         const content = await readFileSafe(file);
         if (!content.includes("express") && !content.includes("Router"))
             continue;
         const rel = relative(project.root, file);
+        const tags = detectTags(content);
+        // Try AST first
+        if (ts) {
+            const astRoutes = extractRoutesAST(ts, rel, content, "express", tags);
+            if (astRoutes.length > 0) {
+                routes.push(...astRoutes);
+                continue;
+            }
+        }
+        // Regex fallback
         const routePattern = /(?:app|router|server)\s*\.\s*(get|post|put|patch|delete|options|all)\s*\(\s*['"`]([^'"`]+)['"`]/gi;
         let match;
         while ((match = routePattern.exec(content)) !== null) {
@@ -195,8 +220,9 @@ async function detectExpressRoutes(files, project) {
                 method: match[1].toUpperCase(),
                 path: match[2],
                 file: rel,
-                tags: detectTags(content),
+                tags,
                 framework: "express",
+                confidence: "regex",
             });
         }
     }
@@ -206,11 +232,22 @@ async function detectExpressRoutes(files, project) {
 async function detectFastifyRoutes(files, project) {
     const tsFiles = files.filter((f) => f.match(/\.(ts|js|mjs|cjs)$/));
     const routes = [];
+    const ts = loadTypeScript(project.root);
     for (const file of tsFiles) {
         const content = await readFileSafe(file);
         if (!content.includes("fastify"))
             continue;
         const rel = relative(project.root, file);
+        const tags = detectTags(content);
+        // Try AST first
+        if (ts) {
+            const astRoutes = extractRoutesAST(ts, rel, content, "fastify", tags);
+            if (astRoutes.length > 0) {
+                routes.push(...astRoutes);
+                continue;
+            }
+        }
+        // Regex fallback
         const routePattern = /(?:fastify|server|app)\s*\.\s*(get|post|put|patch|delete|options|all)\s*\(\s*['"`]([^'"`]+)['"`]/gi;
         let match;
         while ((match = routePattern.exec(content)) !== null) {
@@ -218,8 +255,9 @@ async function detectFastifyRoutes(files, project) {
                 method: match[1].toUpperCase(),
                 path: match[2],
                 file: rel,
-                tags: detectTags(content),
+                tags,
                 framework: "fastify",
+                confidence: "regex",
             });
         }
         // Object-style route registration
@@ -229,8 +267,9 @@ async function detectFastifyRoutes(files, project) {
                 method: match[1].toUpperCase(),
                 path: match[2],
                 file: rel,
-                tags: detectTags(content),
+                tags,
                 framework: "fastify",
+                confidence: "regex",
             });
         }
     }
@@ -240,11 +279,20 @@ async function detectFastifyRoutes(files, project) {
 async function detectKoaRoutes(files, project) {
     const tsFiles = files.filter((f) => f.match(/\.(ts|js|mjs|cjs)$/));
     const routes = [];
+    const ts = loadTypeScript(project.root);
     for (const file of tsFiles) {
         const content = await readFileSafe(file);
         if (!content.includes("koa") && !content.includes("Router"))
             continue;
         const rel = relative(project.root, file);
+        const tags = detectTags(content);
+        if (ts) {
+            const astRoutes = extractRoutesAST(ts, rel, content, "koa", tags);
+            if (astRoutes.length > 0) {
+                routes.push(...astRoutes);
+                continue;
+            }
+        }
         const routePattern = /router\s*\.\s*(get|post|put|patch|delete|options|all)\s*\(\s*['"`]([^'"`]+)['"`]/gi;
         let match;
         while ((match = routePattern.exec(content)) !== null) {
@@ -252,8 +300,9 @@ async function detectKoaRoutes(files, project) {
                 method: match[1].toUpperCase(),
                 path: match[2],
                 file: rel,
-                tags: detectTags(content),
+                tags,
                 framework: "koa",
+                confidence: "regex",
             });
         }
     }
@@ -263,15 +312,24 @@ async function detectKoaRoutes(files, project) {
 async function detectNestJSRoutes(files, project) {
     const tsFiles = files.filter((f) => f.match(/\.(ts|js)$/));
     const routes = [];
+    const ts = loadTypeScript(project.root);
     for (const file of tsFiles) {
         const content = await readFileSafe(file);
         if (!content.includes("@Controller") && !content.includes("@Get") && !content.includes("@Post"))
             continue;
         const rel = relative(project.root, file);
-        // Extract controller base path: @Controller('users') or @Controller('/users')
+        const tags = detectTags(content);
+        // Try AST — NestJS benefits most from AST (decorator + controller prefix combining)
+        if (ts) {
+            const astRoutes = extractRoutesAST(ts, rel, content, "nestjs", tags);
+            if (astRoutes.length > 0) {
+                routes.push(...astRoutes);
+                continue;
+            }
+        }
+        // Regex fallback
         const controllerMatch = content.match(/@Controller\s*\(\s*['"`]([^'"`]*)['"`]\s*\)/);
         const basePath = controllerMatch ? "/" + controllerMatch[1].replace(/^\//, "") : "";
-        // Match method decorators: @Get(), @Post('/create'), @Put(':id'), etc.
         const decoratorPattern = /@(Get|Post|Put|Patch|Delete|Options|Head|All)\s*\(\s*(?:['"`]([^'"`]*)['"`])?\s*\)/gi;
         let match;
         while ((match = decoratorPattern.exec(content)) !== null) {
@@ -282,8 +340,9 @@ async function detectNestJSRoutes(files, project) {
                 method,
                 path: fullPath,
                 file: rel,
-                tags: detectTags(content),
+                tags,
                 framework: "nestjs",
+                confidence: "regex",
             });
         }
     }
@@ -293,11 +352,20 @@ async function detectNestJSRoutes(files, project) {
 async function detectElysiaRoutes(files, project) {
     const tsFiles = files.filter((f) => f.match(/\.(ts|js|mjs)$/));
     const routes = [];
+    const ts = loadTypeScript(project.root);
     for (const file of tsFiles) {
         const content = await readFileSafe(file);
         if (!content.includes("elysia") && !content.includes("Elysia"))
             continue;
         const rel = relative(project.root, file);
+        const tags = detectTags(content);
+        if (ts) {
+            const astRoutes = extractRoutesAST(ts, rel, content, "elysia", tags);
+            if (astRoutes.length > 0) {
+                routes.push(...astRoutes);
+                continue;
+            }
+        }
         const routePattern = /\.\s*(get|post|put|patch|delete|options|all)\s*\(\s*['"`]([^'"`]+)['"`]/gi;
         let match;
         while ((match = routePattern.exec(content)) !== null) {
@@ -308,8 +376,9 @@ async function detectElysiaRoutes(files, project) {
                 method: match[1].toUpperCase(),
                 path,
                 file: rel,
-                tags: detectTags(content),
+                tags,
                 framework: "elysia",
+                confidence: "regex",
             });
         }
     }
@@ -341,6 +410,7 @@ async function detectAdonisRoutes(files, project) {
 async function detectTRPCRoutes(files, project) {
     const tsFiles = files.filter((f) => f.match(/\.(ts|js)$/));
     const routes = [];
+    const ts = loadTypeScript(project.root);
     for (const file of tsFiles) {
         const content = await readFileSafe(file);
         if (!content.includes("Procedure") && !content.includes("procedure") && !content.includes("router"))
@@ -348,11 +418,16 @@ async function detectTRPCRoutes(files, project) {
         if (!content.includes("trpc") && !content.includes("TRPC") && !content.includes("createTRPCRouter") && !content.includes("publicProcedure") && !content.includes("protectedProcedure"))
             continue;
         const rel = relative(project.root, file);
-        // Match tRPC procedure definitions like:
-        //   list: publicProcedure.query(...)
-        //   create: publicProcedure.input(schema).mutation(...)
-        //   getById: t.procedure.input(z.object({...})).query(...)
-        // Strategy: find lines with "query(" or "mutation(" and extract the procedure name
+        const tags = detectTags(content);
+        // AST handles tRPC much better — properly parses router nesting and procedure chains
+        if (ts) {
+            const astRoutes = extractRoutesAST(ts, rel, content, "trpc", tags);
+            if (astRoutes.length > 0) {
+                routes.push(...astRoutes);
+                continue;
+            }
+        }
+        // Regex fallback
         const lines = content.split("\n");
         for (const line of lines) {
             const queryMatch = line.match(/^\s*(\w+)\s*:\s*.*\.(query)\s*\(/);
@@ -366,8 +441,9 @@ async function detectTRPCRoutes(files, project) {
                         method: isQuery ? "QUERY" : "MUTATION",
                         path: procName,
                         file: rel,
-                        tags: detectTags(content),
+                        tags,
                         framework: "trpc",
+                        confidence: "regex",
                     });
                 }
             }

package/dist/detectors/schema.js

@@ -1,5 +1,7 @@
 import { join } from "node:path";
 import { readFileSafe } from "../scanner.js";
+import { loadTypeScript } from "../ast/loader.js";
+import { extractDrizzleSchemaAST, extractTypeORMSchemaAST } from "../ast/extract-schema.js";
 const AUDIT_FIELDS = new Set([
     "createdAt",
     "updatedAt",
@@ -35,10 +37,19 @@ async function detectDrizzleSchemas(files, project) {
         f.match(/\.schema\.(ts|js)$/) ||
         f.match(/\/db\/.*\.(ts|js)$/));
     const models = [];
+    const ts = loadTypeScript(project.root);
     for (const file of schemaFiles) {
         const content = await readFileSafe(file);
         if (!content.includes("pgTable") && !content.includes("mysqlTable") && !content.includes("sqliteTable"))
             continue;
+        // Try AST first — much more accurate for Drizzle field chains
+        if (ts) {
+            const astModels = extractDrizzleSchemaAST(ts, file, content);
+            if (astModels.length > 0) {
+                models.push(...astModels);
+                continue;
+            }
+        }
         // Match: export const users = pgTable("users", { ... })
         const tablePattern = /(?:export\s+)?const\s+(\w+)\s*=\s*(?:pgTable|mysqlTable|sqliteTable)\s*\(\s*['"`](\w+)['"`]\s*,\s*(?:\(\s*\)\s*=>\s*\(?\s*)?\{([\s\S]*?)\}\s*\)?\s*(?:,|\))/g;
         let match;
@@ -185,10 +196,19 @@ async function detectPrismaSchemas(project) {
 async function detectTypeORMSchemas(files, project) {
     const entityFiles = files.filter((f) => f.match(/\.entity\.(ts|js)$/) || f.match(/entities\/.*\.(ts|js)$/));
     const models = [];
+    const ts = loadTypeScript(project.root);
     for (const file of entityFiles) {
         const content = await readFileSafe(file);
         if (!content.includes("@Entity") && !content.includes("@Column"))
             continue;
+        // Try AST first — handles TypeORM decorators accurately
+        if (ts) {
+            const astModels = extractTypeORMSchemaAST(ts, file, content);
+            if (astModels.length > 0) {
+                models.push(...astModels);
+                continue;
+            }
+        }
         // Extract entity name
         const entityMatch = content.match(/@Entity\s*\(\s*(?:['"`](\w+)['"`])?\s*\)/);
         const classMatch = content.match(/class\s+(\w+)/);

package/dist/index.js

@@ -14,7 +14,7 @@ import { calculateTokenStats } from "./detectors/tokens.js";
 import { writeOutput } from "./formatter.js";
 import { generateAIConfigs } from "./generators/ai-config.js";
 import { generateHtmlReport } from "./generators/html-report.js";
-const VERSION = "1.2.0";
+const VERSION = "1.3.0";
 const BRAND = "codesight";
 function printHelp() {
     console.log(`
@@ -86,7 +86,17 @@ async function scan(root, outputDirName, maxDepth) {
     ]);
     // Step 4: Enrich routes with contract info
     const routes = await enrichRouteContracts(rawRoutes, project);
-    console.log(" done");
+    // Report AST vs regex detection
+    const astRoutes = routes.filter((r) => r.confidence === "ast").length;
+    const astSchemas = schemas.filter((s) => s.confidence === "ast").length;
+    const astComponents = components.filter((c) => c.confidence === "ast").length;
+    const totalAST = astRoutes + astSchemas + astComponents;
+    if (totalAST > 0) {
+        console.log(` done (AST: ${astRoutes} routes, ${astSchemas} models, ${astComponents} components)`);
+    }
+    else {
+        console.log(" done");
+    }
     // Step 5: Write output
     process.stdout.write("  Writing output...");
     // Temporary result without token stats to generate output

package/dist/types.d.ts

@@ -17,6 +17,7 @@ export interface WorkspaceInfo {
     frameworks: Framework[];
     orms: ORM[];
 }
+export type DetectionMethod = "ast" | "regex";
 export interface RouteInfo {
     method: string;
     path: string;
@@ -26,12 +27,15 @@ export interface RouteInfo {
     requestType?: string;
     responseType?: string;
     params?: string[];
+    confidence?: DetectionMethod;
+    middleware?: string[];
 }
 export interface SchemaModel {
     name: string;
     fields: SchemaField[];
     relations: string[];
     orm: ORM;
+    confidence?: DetectionMethod;
 }
 export interface SchemaField {
     name: string;
@@ -41,6 +45,7 @@ export interface SchemaField {
 export interface ComponentInfo {
     name: string;
     file: string;
+    confidence?: DetectionMethod;
     props: string[];
     isClient: boolean;
     isServer: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codesight",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "See your codebase clearly. Universal AI context generator that maps routes, schema, components, dependencies, and more for Claude Code, Cursor, Copilot, Codex, and any AI coding tool.",
   "main": "dist/index.js",
   "bin": {