codesift-mcp 0.3.0 → 0.5.0

package/dist/tools/wiring-tools.js

@@ -0,0 +1,147 @@
+/**
+ * Framework wiring discovery — find implicit control flow connections.
+ * Django signals, Celery tasks, middleware chains, management commands,
+ * Flask extensions, FastAPI event handlers.
+ */
+import { getCodeIndex } from "./index-tools.js";
+// --- Detection patterns ---
+// Django signals: @receiver(post_save, sender=Model)
+const DJANGO_RECEIVER_RE = /@receiver\s*\(\s*(\w+)(?:\s*,\s*sender\s*=\s*(\w+))?\)/;
+const SIGNAL_CONNECT_RE = /(\w+)\.connect\s*\(\s*(\w+)/;
+// Celery tasks: @app.task, @shared_task, @celery.task
+const CELERY_TASK_DECORATOR_RE = /@(?:\w+\.)?(?:task|shared_task)\b/;
+// Celery task calls: .delay(), .apply_async()
+const CELERY_CALL_RE = /(\w+)\.(delay|apply_async|s|si|signature)\s*\(/;
+// Django middleware: MIDDLEWARE list in settings
+const MIDDLEWARE_RE = /MIDDLEWARE\s*=\s*\[([^\]]*)\]/s;
+// Django management commands: class Command(BaseCommand)
+const MANAGEMENT_CMD_RE = /class\s+Command\s*\(\s*(?:\w+\.)?BaseCommand\s*\)/;
+// Flask extensions: .init_app()
+const FLASK_INIT_APP_RE = /(\w+)\.init_app\s*\(\s*(\w+)\s*\)/;
+// FastAPI event handlers: @app.on_event("startup")
+const FASTAPI_EVENT_RE = /@\w+\.on_event\s*\(\s*['"](\w+)['"]\s*\)/;
+/**
+ * Discover implicit framework wiring across a Python codebase.
+ */
+export async function findFrameworkWiring(repo, options) {
+    const index = await getCodeIndex(repo);
+    if (!index)
+        throw new Error(`Repository "${repo}" not found.`);
+    const filePattern = options?.file_pattern;
+    const entries = [];
+    for (const sym of index.symbols) {
+        if (!sym.file.endsWith(".py"))
+            continue;
+        if (filePattern && !sym.file.includes(filePattern))
+            continue;
+        const source = sym.source ?? "";
+        const decorators = sym.decorators ?? [];
+        // Django signals
+        for (const dec of decorators) {
+            const sigMatch = DJANGO_RECEIVER_RE.exec(dec);
+            if (sigMatch) {
+                entries.push({
+                    type: "signal",
+                    name: sym.name,
+                    file: sym.file,
+                    line: sym.start_line,
+                    detail: `@receiver(${sigMatch[1]}${sigMatch[2] ? `, sender=${sigMatch[2]}` : ""})`,
+                });
+            }
+        }
+        // Signal.connect()
+        const connectMatch = SIGNAL_CONNECT_RE.exec(source);
+        if (connectMatch) {
+            entries.push({
+                type: "signal",
+                name: connectMatch[2],
+                file: sym.file,
+                line: sym.start_line,
+                detail: `${connectMatch[1]}.connect(${connectMatch[2]})`,
+            });
+        }
+        // Celery tasks
+        for (const dec of decorators) {
+            if (CELERY_TASK_DECORATOR_RE.test(dec)) {
+                entries.push({
+                    type: "task",
+                    name: sym.name,
+                    file: sym.file,
+                    line: sym.start_line,
+                    detail: dec,
+                });
+            }
+        }
+        // Celery task calls
+        const callMatch = CELERY_CALL_RE.exec(source);
+        if (callMatch) {
+            entries.push({
+                type: "task_call",
+                name: callMatch[1],
+                file: sym.file,
+                line: sym.start_line,
+                detail: `${callMatch[1]}.${callMatch[2]}()`,
+            });
+        }
+        // Management commands
+        if (MANAGEMENT_CMD_RE.test(source) && sym.file.includes("management/commands/")) {
+            const cmdName = sym.file.split("/").pop()?.replace(".py", "") ?? sym.name;
+            entries.push({
+                type: "command",
+                name: cmdName,
+                file: sym.file,
+                line: sym.start_line,
+                detail: `manage.py ${cmdName}`,
+            });
+        }
+        // Flask init_app
+        const initMatch = FLASK_INIT_APP_RE.exec(source);
+        if (initMatch) {
+            entries.push({
+                type: "extension",
+                name: initMatch[1],
+                file: sym.file,
+                line: sym.start_line,
+                detail: `${initMatch[1]}.init_app(${initMatch[2]})`,
+            });
+        }
+        // FastAPI event handlers
+        for (const dec of decorators) {
+            const eventMatch = FASTAPI_EVENT_RE.exec(dec);
+            if (eventMatch) {
+                entries.push({
+                    type: "event_handler",
+                    name: sym.name,
+                    file: sym.file,
+                    line: sym.start_line,
+                    detail: `on_event("${eventMatch[1]}")`,
+                });
+            }
+        }
+        // Django middleware (from settings)
+        if (sym.name === "MIDDLEWARE" || sym.kind === "constant") {
+            const mwMatch = MIDDLEWARE_RE.exec(source);
+            if (mwMatch) {
+                const middlewares = mwMatch[1]
+                    .split(",")
+                    .map((m) => m.trim().replace(/['"]/g, ""))
+                    .filter((m) => m.length > 0);
+                for (const mw of middlewares) {
+                    entries.push({
+                        type: "middleware",
+                        name: mw.split(".").pop() ?? mw,
+                        file: sym.file,
+                        line: sym.start_line,
+                        detail: mw,
+                    });
+                }
+            }
+        }
+    }
+    const by_type = {};
+    for (const e of entries) {
+        by_type[e.type] = (by_type[e.type] ?? 0) + 1;
+    }
+    return { entries, total: entries.length, by_type };
+}
+//# sourceMappingURL=wiring-tools.js.map

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

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

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-export type SymbolKind = "function" | "method" | "class" | "interface" | "type" | "variable" | "constant" | "field" | "enum" | "namespace" | "module" | "section" | "metadata" | "test_suite" | "test_case" | "test_hook" | "default_export" | "conversation_turn" | "conversation_summary" | "unknown";
+export type SymbolKind = "function" | "method" | "class" | "interface" | "type" | "variable" | "constant" | "field" | "enum" | "namespace" | "module" | "section" | "metadata" | "test_suite" | "test_case" | "test_hook" | "component" | "hook" | "table" | "view" | "index" | "trigger" | "procedure" | "default_export" | "conversation_turn" | "conversation_summary" | "unknown";
 export interface FileLocation {
     file: string;
     start_line: number;
@@ -18,6 +18,10 @@ export interface CodeSymbol extends FileLocation {
     source?: string;
     parent?: string;
     tokens?: string[];
+    decorators?: string[];
+    extends?: string[];
+    is_async?: boolean;
+    meta?: Record<string, unknown>;
 }
 export interface FileEntry {
     path: string;
@@ -36,6 +40,9 @@ export interface CodeIndex {
     updated_at: number;
     symbol_count: number;
     file_count: number;
+    /** Snapshot of EXTRACTOR_VERSIONS at index creation time — used to detect
+     *  schema changes and trigger full reindex when any language version bumps. */
+    extractor_version?: Record<string, string>;
 }
 export interface RepoMeta {
     name: string;
@@ -83,6 +90,7 @@ export interface TextMatchGroup {
     first_match: string;
 }
 export type Direction = "callers" | "callees";
+export type RouteFramework = "nestjs" | "nextjs" | "express" | "hono" | "yii2" | "laravel" | "ktor" | "spring-kotlin" | "astro" | "flask" | "fastapi" | "django" | "unknown";
 export interface CallNode {
     symbol: CodeSymbol;
     children: CallNode[];

package/dist/types.d.ts.map

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

package/dist/utils/framework-detect.d.ts

@@ -1,5 +1,21 @@
 import type { CodeIndex, CodeSymbol } from "../types.js";
-export type Framework = "react" | "nestjs" | "nextjs" | "express" | "test";
+import type { HonoAppModel } from "../parser/extractors/hono-model.js";
+export type Framework = "react" | "nestjs" | "nextjs" | "express" | "astro" | "hono" | "test" | "kotlin-android";
+/**
+ * Kotlin/Android annotations that mark a symbol as referenced by the runtime
+ * rather than by static imports. `find_dead_code` must treat these as live
+ * because Hilt (reflection), Compose (tooling), Room (KSP), kotlinx.serialization
+ * (JSON), and JUnit/Kotest (runner) all instantiate or invoke symbols outside
+ * the normal call graph.
+ */
+export declare const KOTLIN_FRAMEWORK_ANNOTATIONS: ReadonlySet<string>;
+/** Exported for testing — matches next.config.{js,mjs,cjs,ts} at root or src/ */
+export declare const NEXT_CONFIG_FILE: RegExp;
+/** Exported for testing — App Router convention files */
+export declare const NEXT_APP_CONVENTION_FILE: RegExp;
 export declare function detectFrameworks(index: CodeIndex): Set<Framework>;
-export declare function isFrameworkEntryPoint(symbol: Pick<CodeSymbol, "name" | "file">, frameworks: Set<Framework>): boolean;
+export declare function isFrameworkEntryPoint(symbol: Pick<CodeSymbol, "name" | "file"> & {
+    source?: string;
+    decorators?: string[] | undefined;
+}, frameworks: Set<Framework>, honoModel?: HonoAppModel | null): boolean;
 //# sourceMappingURL=framework-detect.d.ts.map

package/dist/utils/framework-detect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"framework-detect.d.ts","sourceRoot":"","sources":["../../src/utils/framework-detect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;AAW3E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,CAYjE;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,EACzC,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,GACzB,OAAO,CAST"}
+{"version":3,"file":"framework-detect.d.ts","sourceRoot":"","sources":["../../src/utils/framework-detect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAEvE,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,gBAAgB,CAAC;AAEjH;;;;;;GAMG;AACH,eAAO,MAAM,4BAA4B,EAAE,WAAW,CAAC,MAAM,CAmB3D,CAAC;AA8BH,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,QAAuC,CAAC;AACrE,yDAAyD;AACzD,eAAO,MAAM,wBAAwB,QAA0G,CAAC;AAEhJ,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,SAAS,CAAC,CA0CjE;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;CAAE,EAClG,UAAU,EAAE,GAAG,CAAC,SAAS,CAAC,EAC1B,SAAS,CAAC,EAAE,YAAY,GAAG,IAAI,GAC9B,OAAO,CA0ET"}

package/dist/utils/framework-detect.js

@@ -1,3 +1,30 @@
+/**
+ * Kotlin/Android annotations that mark a symbol as referenced by the runtime
+ * rather than by static imports. `find_dead_code` must treat these as live
+ * because Hilt (reflection), Compose (tooling), Room (KSP), kotlinx.serialization
+ * (JSON), and JUnit/Kotest (runner) all instantiate or invoke symbols outside
+ * the normal call graph.
+ */
+export const KOTLIN_FRAMEWORK_ANNOTATIONS = new Set([
+    // Hilt / Dagger DI
+    "HiltViewModel", "HiltAndroidApp", "AndroidEntryPoint",
+    "Inject", "Module", "Provides", "Binds", "InstallIn", "Singleton",
+    // Jetpack Compose + Compose tooling
+    "Composable", "Preview", "PreviewParameter",
+    // kotlinx.serialization
+    "Serializable", "SerialName", "Transient",
+    // Room persistence
+    "Entity", "Dao", "Database", "Query", "Insert", "Update", "Delete",
+    "TypeConverter", "TypeConverters", "PrimaryKey", "Embedded", "Relation",
+    // Android framework entry points
+    "Keep", "JvmStatic", "JvmOverloads", "JvmName", "JvmField",
+    // Test runners (JUnit4/5 + Kotest)
+    "Test", "BeforeEach", "AfterEach", "BeforeAll", "AfterAll",
+    "Before", "After", "BeforeClass", "AfterClass",
+    "ParameterizedTest", "RepeatedTest",
+    // Kotlin Multiplatform
+    "JsExport", "ObjCName", "Throws",
+]);
 const NEXT_ROUTE_FILE = /(^|\/)app\/.*\/route\.[jt]sx?$/;
 const NEXT_APP_FILE = /(^|\/)app\/.+\.[jt]sx?$/;
 const NEXT_PAGES_FILE = /(^|\/)pages\/.+\.[jt]sx?$/;
@@ -5,6 +32,26 @@ const NEXT_MIDDLEWARE_FILE = /(^|\/)middleware\.[jt]sx?$/;
 const NEXT_ROUTE_METHODS = /^(GET|POST|PUT|DELETE|PATCH|HEAD|OPTIONS)$/;
 const NEXT_PAGES_DATA_FUNCTIONS = /^(getServerSideProps|getStaticProps|getStaticPaths)$/;
 const NEXT_APP_METADATA_FUNCTIONS = /^(generateMetadata|generateStaticParams)$/;
+/** Next.js config exports that are framework entry points (not dead code) */
+const NEXT_CONFIG_EXPORTS = /^(metadata|viewport|dynamic|revalidate|runtime|preferredRegion|maxDuration|fetchCache|dynamicParams)$/;
+/** NestJS lifecycle hooks + decorator-based entry points */
+const NESTJS_LIFECYCLE = /^(onModuleInit|onModuleDestroy|onApplicationBootstrap|onApplicationShutdown|beforeApplicationShutdown|handleCron|handleInterval|handleTimeout|handleEvent)$/;
+const NESTJS_ENTRY_FILE = /\.(controller|resolver|gateway|guard|interceptor|pipe|filter)\.[jt]sx?$/;
+const NESTJS_MAIN_FILE = /(^|\/)main\.[jt]sx?$/;
+/** Astro file-based routing — pages/ directory with .astro, .ts, or .js files */
+const ASTRO_PAGES_FILE = /(^|\/)src\/pages\/.+\.(astro|[jt]sx?)$/;
+/** Astro special exports that the framework consumes implicitly */
+const ASTRO_ENTRY_SYMBOLS = /^(getStaticPaths|prerender|GET|POST|PUT|DELETE|PATCH)$/;
+/** React/Next.js app router file conventions — these are route entry points */
+const REACT_ROUTE_FILE = /(^|\/)(pages|app)\/.*\.(tsx|jsx)$/;
+/** Special Next.js/Remix file names that are always entry points regardless of export name */
+const REACT_SPECIAL_FILE = /(^|\/)(page|layout|loading|error|not-found|global-error|default|template|head)\.(tsx|jsx)$/;
+/** Remix convention: routes/ directory with file-based routing */
+const REMIX_ROUTE_FILE = /(^|\/)routes\/.*\.(tsx|jsx)$/;
+/** Exported for testing — matches next.config.{js,mjs,cjs,ts} at root or src/ */
+export const NEXT_CONFIG_FILE = /^(src\/)?next\.config\.[mc]?[jt]s$/;
+/** Exported for testing — App Router convention files */
+export const NEXT_APP_CONVENTION_FILE = /(^|\/)app\/(.*\/)?(page|layout|loading|error|not-found|global-error|default|template|route)\.[jt]sx?$/;
 export function detectFrameworks(index) {
     const frameworks = new Set();
     // Sample first 200 symbols' source for framework indicators
@@ -13,14 +60,80 @@ export function detectFrameworks(index) {
         frameworks.add("nestjs");
     if (sources.includes("from 'react'") || sources.includes('from "react"') || sources.includes("useState"))
         frameworks.add("react");
-    if (index.files.some((f) => f.path.includes("app/api/") && f.path.endsWith("route.ts")))
-        frameworks.add("nextjs");
     if (sources.includes("express()") || sources.includes("Router()"))
         frameworks.add("express");
+    // Hono detection: check symbol sources for new Hono() / new OpenAPIHono() instantiation,
+    // or import statements (captured in some extractor flows), or hono/factory createApp
+    if (/new\s+(?:Hono|OpenAPIHono)\s*(?:<[^>]*>)?\s*\(/.test(sources) ||
+        sources.includes("from 'hono'") ||
+        sources.includes('from "hono"') ||
+        sources.includes("from '@hono/zod-openapi'") ||
+        sources.includes('from "@hono/zod-openapi"') ||
+        sources.includes("factory.createApp")) {
+        frameworks.add("hono");
+    }
+    if (sources.includes("from 'astro'") || sources.includes('from "astro"') || sources.includes("from 'astro:") || sources.includes('from "astro:') || index.files.some((f) => f.path.endsWith(".astro")))
+        frameworks.add("astro");
+    // Kotlin/Android detection: any .kt file is a signal. The annotation
+    // whitelist kicks in across all Kotlin symbols regardless of whether Hilt
+    // is actually in use — the cost of a false negative (flagging @HiltViewModel
+    // as dead code) is much higher than the cost of a false positive (allowing
+    // a few annotated symbols through when the project isn't Android).
+    if (index.files.some((f) => f.path.endsWith(".kt") || f.path.endsWith(".kts"))) {
+        frameworks.add("kotlin-android");
+    }
+    // Next.js detection: broadened to cover config file, pages/ dir, and App Router conventions
+    const hasNextConfig = index.files.some((f) => NEXT_CONFIG_FILE.test(f.path));
+    const hasPagesDir = index.files.some((f) => NEXT_PAGES_FILE.test(f.path) && /\.[jt]sx?$/.test(f.path));
+    const hasAppConvention = index.files.some((f) => NEXT_APP_CONVENTION_FILE.test(f.path));
+    if (hasNextConfig || hasPagesDir || hasAppConvention) {
+        frameworks.add("nextjs");
+    }
     frameworks.add("test"); // always include test patterns
     return frameworks;
 }
-export function isFrameworkEntryPoint(symbol, frameworks) {
+export function isFrameworkEntryPoint(symbol, frameworks, honoModel) {
+    // Kotlin/Android: whitelisted annotations mark a symbol as runtime-referenced
+    // (Hilt, Compose, Room, serialization, Android entry points, JUnit).
+    if (frameworks.has("kotlin-android") && (symbol.file.endsWith(".kt") || symbol.file.endsWith(".kts"))) {
+        const decorators = symbol.decorators;
+        if (decorators && decorators.length > 0) {
+            for (const decorator of decorators) {
+                if (KOTLIN_FRAMEWORK_ANNOTATIONS.has(decorator))
+                    return true;
+            }
+        }
+        // Fallback for symbols where the extractor didn't surface decorators yet:
+        // scan the first 400 chars of source for any whitelisted @Annotation.
+        // Cheaper than re-parsing and keeps correctness as the extractor evolves.
+        const head = symbol.source?.slice(0, 400);
+        if (head) {
+            for (const annotation of KOTLIN_FRAMEWORK_ANNOTATIONS) {
+                // Word-boundary match against "@Annotation" to avoid false matches on
+                // @HiltViewModelInternal or similar.
+                const re = new RegExp(`@${annotation}\\b`);
+                if (re.test(head))
+                    return true;
+            }
+        }
+    }
+    if (frameworks.has("hono") && honoModel) {
+        // Symbol is in a file that the HonoExtractor reached
+        if (honoModel.files_used.includes(symbol.file)) {
+            // Handler function referenced by a route
+            if (honoModel.routes.some((r) => r.handler.name === symbol.name))
+                return true;
+            // Middleware referenced in any chain
+            if (honoModel.middleware_chains.some((mc) => mc.entries.some((e) => e.name === symbol.name)))
+                return true;
+            // Sub-app variable mounted via app.route()
+            if (honoModel.mounts.some((m) => m.child_var === symbol.name))
+                return true;
+            // The root Hono app variable itself
+            if (honoModel.app_variables[symbol.name])
+                return true;
+        }
+    }
     if (frameworks.has("nextjs")) {
         if (NEXT_ROUTE_FILE.test(symbol.file) && NEXT_ROUTE_METHODS.test(symbol.name))
             return true;
@@ -30,6 +143,40 @@ export function isFrameworkEntryPoint(symbol, frameworks) {
             return true;
         if (NEXT_APP_FILE.test(symbol.file) && NEXT_APP_METADATA_FUNCTIONS.test(symbol.name))
             return true;
+        if (NEXT_APP_FILE.test(symbol.file) && NEXT_CONFIG_EXPORTS.test(symbol.name))
+            return true;
+    }
+    if (frameworks.has("nestjs")) {
+        if (NESTJS_LIFECYCLE.test(symbol.name))
+            return true;
+        if (NESTJS_ENTRY_FILE.test(symbol.file))
+            return true;
+        if (NESTJS_MAIN_FILE.test(symbol.file) && symbol.name === "bootstrap")
+            return true;
+    }
+    if (frameworks.has("astro")) {
+        if (ASTRO_PAGES_FILE.test(symbol.file))
+            return true;
+        if (ASTRO_ENTRY_SYMBOLS.test(symbol.name))
+            return true;
+    }
+    // React route/layout components: any default export from a routed file
+    // (pages/, app/, or routes/) is an entry point — the framework renders it
+    // based on file path, not via explicit import. Without this, find_dead_code
+    // flags them as unused.
+    if (frameworks.has("react") || frameworks.has("nextjs")) {
+        if (REACT_SPECIAL_FILE.test(symbol.file))
+            return true;
+        if (REACT_ROUTE_FILE.test(symbol.file))
+            return true;
+        if (REMIX_ROUTE_FILE.test(symbol.file))
+            return true;
+    }
+    // RSC boundary: "use client" / "use server" directive → framework entry point
+    if (symbol.source && (frameworks.has("react") || frameworks.has("nextjs"))) {
+        const head = symbol.source.slice(0, 200);
+        if (/['"]use client['"]/.test(head) || /['"]use server['"]/.test(head))
+            return true;
     }
     return false;
 }

package/dist/utils/framework-detect.js.map

@@ -1 +1 @@
-{"version":3,"file":"framework-detect.js","sourceRoot":"","sources":["../../src/utils/framework-detect.ts"],"names":[],"mappings":"AAIA,MAAM,eAAe,GAAG,gCAAgC,CAAC;AACzD,MAAM,aAAa,GAAG,yBAAyB,CAAC;AAChD,MAAM,eAAe,GAAG,2BAA2B,CAAC;AACpD,MAAM,oBAAoB,GAAG,4BAA4B,CAAC;AAE1D,MAAM,kBAAkB,GAAG,4CAA4C,CAAC;AACxE,MAAM,yBAAyB,GAAG,sDAAsD,CAAC;AACzF,MAAM,2BAA2B,GAAG,2CAA2C,CAAC;AAEhF,MAAM,UAAU,gBAAgB,CAAC,KAAgB;IAC/C,MAAM,UAAU,GAAG,IAAI,GAAG,EAAa,CAAC;IACxC,4DAA4D;IAC5D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAElF,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC9F,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClI,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAAE,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClH,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7F,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,+BAA+B;IAEvD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,MAAyC,EACzC,UAA0B;IAE1B,IAAI,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3F,IAAI,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,KAAK,YAAY;YAAE,OAAO,IAAI,CAAC;QACxF,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAClG,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,2BAA2B,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IACpG,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"framework-detect.js","sourceRoot":"","sources":["../../src/utils/framework-detect.ts"],"names":[],"mappings":"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"}

package/dist/utils/import-graph.d.ts

@@ -2,6 +2,9 @@ import type { CodeIndex } from "../types.js";
 export interface ImportEdge {
     from: string;
     to: string;
+    type_only?: boolean;
+    star_import?: boolean;
+    raw?: string;
 }
 /**
  * Extract import paths from a source string.
@@ -13,6 +16,43 @@ export declare function extractImports(source: string): string[];
  * Resolves "./foo" and "../bar" relative to the importer's directory.
  */
 export declare function resolveImportPath(importerFile: string, importPath: string): string;
+/**
+ * Extract PHP `use` statements (FQCN imports).
+ * Returns fully-qualified class/namespace names without the leading backslash.
+ * These are NOT file paths — they require PSR-4 resolution against composer.json.
+ *
+ * Handles both single-FQCN and grouped forms:
+ *   `use App\Models\User;`
+ *   `use App\Models\User as U;`
+ *   `use App\Models\{User, Post, Comment};`
+ *   `use App\{Models\User, Services\Auth as A};`
+ */
+export declare function extractPhpUseStatements(source: string): string[];
+/**
+ * Extract Kotlin `import` statements (fully-qualified names).
+ * Returns dot-separated package + class names. Wildcards (`com.example.*`) are
+ * preserved as-is. These are NOT file paths — they require heuristic resolution
+ * against the source root (usually `src/main/kotlin`, `src/commonMain/kotlin`, etc.).
+ */
+export declare function extractKotlinImports(source: string): string[];
+/**
+ * Heuristically resolve a Kotlin fully-qualified import to an indexed file.
+ * Strategy: match the last segment of the FQN (the simple class name) against
+ * file basenames. For `com.example.service.UserService`, tries to find a file
+ * whose basename (without .kt/.kts) is `UserService` AND whose path contains
+ * the package path `com/example/service`.
+ *
+ * Returns the matched file path or null if no match.
+ *
+ * Limitations: single-repo heuristic. Doesn't handle wildcard imports
+ * (`com.example.*`) or multi-module setups with complex source roots.
+ */
+export declare function resolveKotlinImport(fqName: string, kotlinFilesByBasename: Map<string, string[]>): string | null;
+/**
+ * Build a lookup map from Kotlin file basenames (without extension) to file paths.
+ * Used by resolveKotlinImport for heuristic FQN resolution.
+ */
+export declare function buildKotlinFilesByBasename(index: CodeIndex): Map<string, string[]>;
 /**
  * Build normalized path map for matching imports to indexed files.
  */
@@ -20,6 +60,8 @@ export declare function buildNormalizedPathMap(index: CodeIndex): Map<string, st
 /**
  * Collect all import edges between files in the index.
  * Reads file source from disk to extract import statements.
+ * Handles JS/TS/PHP relative imports AND Kotlin fully-qualified imports
+ * (via heuristic basename + package-path matching).
  */
 export declare function collectImportEdges(index: CodeIndex, fileFilter?: Set<string>): Promise<ImportEdge[]>;
 /**

package/dist/utils/import-graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import-graph.d.ts","sourceRoot":"","sources":["../../src/utils/import-graph.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAYD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAevD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAoBlF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAU5E;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,SAAS,EAChB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACvB,OAAO,CAAC,UAAU,EAAE,CAAC,CAgCvB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAYlF"}
+{"version":3,"file":"import-graph.d.ts","sourceRoot":"","sources":["../../src/utils/import-graph.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO7C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAkCD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAevD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAoBlF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CA0BhE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAS7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAC3C,MAAM,GAAG,IAAI,CA8Bf;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAelF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAc5E;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,SAAS,EAChB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GACvB,OAAO,CAAC,UAAU,EAAE,CAAC,CAoIvB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAYlF"}