spec-gen-cli 1.1.0 → 1.2.0

package/dist/core/analyzer/http-route-parser.d.ts

@@ -0,0 +1,111 @@
+/**
+ * HTTP Route Parser
+ *
+ * Extracts two complementary sets of data:
+ *   1. HTTP CALLS  — fetch/axios/ky/got calls in JS/TS frontend files
+ *   2. ROUTE DEFS  — FastAPI / Flask / Django route declarations in Python files
+ *
+ * These are then matched by `buildHttpEdges()` to create cross-language edges
+ * between the frontend files that call an endpoint and the Python handlers that
+ * serve it — filling the gap that static import analysis cannot reach.
+ *
+ * Matching strategy
+ * -----------------
+ * Routes are normalised to a canonical form before comparison:
+ *   - Path parameters are replaced with a placeholder: /items/{id} → /items/:param
+ *   - Leading slashes are normalised
+ *   - Query strings are stripped from call-site URLs
+ *   - Common API prefixes (/api, /api/v1, /v1, …) are tried both with and
+ *     without the prefix so that a frontend call to /api/v1/search still matches
+ *     a FastAPI router mounted at /search.
+ *
+ * Confidence levels
+ * -----------------
+ *   exact   — method + full path match
+ *   path    — path matches, method unknown on one side (e.g. bare fetch)
+ *   fuzzy   — normalised path matches after prefix stripping
+ */
+/** An HTTP call found in a JS/TS source file */
+export interface HttpCall {
+    /** Absolute path of the file containing the call */
+    file: string;
+    /** HTTP method, upper-cased. 'UNKNOWN' when it cannot be determined. */
+    method: string;
+    /** URL as written in source — may be a template literal or variable ref */
+    url: string;
+    /** Normalised, static portion of the URL (params stripped, prefix removed) */
+    normalizedUrl: string;
+    /** 1-based source line */
+    line: number;
+    /** axios / fetch / ky / got / custom */
+    client: string;
+}
+/** A route handler found in a Python source file */
+export interface RouteDefinition {
+    /** Absolute path of the file containing the handler */
+    file: string;
+    /** HTTP method, upper-cased */
+    method: string;
+    /** Path pattern as declared (may contain {param} or <param> placeholders) */
+    path: string;
+    /** Normalised path for matching */
+    normalizedPath: string;
+    /** Name of the handler function */
+    handlerName: string;
+    /** fastapi / flask / django / starlette */
+    framework: string;
+    /** 1-based source line */
+    line: number;
+}
+/** A resolved cross-language edge */
+export interface HttpEdge {
+    /** Absolute path of the JS/TS caller file */
+    callerFile: string;
+    /** Absolute path of the Python handler file */
+    handlerFile: string;
+    method: string;
+    /** Normalised path used for the match */
+    path: string;
+    call: HttpCall;
+    route: RouteDefinition;
+    /** How confident the match is */
+    confidence: 'exact' | 'path' | 'fuzzy';
+}
+/**
+ * Reduce a URL/path to a comparable canonical form:
+ *   - Strip protocol + host if present  (https://example.com/foo → /foo)
+ *   - Strip query string and fragment
+ *   - Replace path parameters with :param
+ *     {id}, :id, <int:id>, <id>  →  :param
+ *   - Collapse duplicate slashes
+ *   - Remove trailing slash (except root)
+ */
+export declare function normalizeUrl(raw: string): string;
+/**
+ * Extract all HTTP calls from a JavaScript or TypeScript source file.
+ */
+export declare function extractHttpCalls(filePath: string): Promise<HttpCall[]>;
+/**
+ * Extract all route definitions from a Python source file.
+ * Supports FastAPI, Starlette, Flask, and Django (urls.py path/re_path).
+ */
+export declare function extractRouteDefinitions(filePath: string): Promise<RouteDefinition[]>;
+/**
+ * Match HTTP calls from JS/TS files against route definitions from Python files
+ * and return cross-language edges.
+ *
+ * Pass in pre-extracted calls and routes (so callers can cache them across
+ * multiple graph builds without re-parsing).
+ */
+export declare function buildHttpEdges(calls: HttpCall[], routes: RouteDefinition[]): HttpEdge[];
+/**
+ * Parse all files in a mixed JS+Python codebase and return HTTP edges.
+ * Intended to be called once per graph build and its result merged into
+ * the DependencyGraphResult edges.
+ */
+export declare function extractAllHttpEdges(filePaths: string[]): Promise<{
+    calls: HttpCall[];
+    routes: RouteDefinition[];
+    edges: HttpEdge[];
+}>;
+//# sourceMappingURL=http-route-parser.d.ts.map

package/dist/core/analyzer/http-route-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-route-parser.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/http-route-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AASH,gDAAgD;AAChD,MAAM,WAAW,QAAQ;IACvB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,8EAA8E;IAC9E,aAAa,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qCAAqC;AACrC,MAAM,WAAW,QAAQ;IACvB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,eAAe,CAAC;IACvB,iCAAiC;IACjC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;CACxC;AAaD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAsBhD;AAuBD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAuH5E;AAMD;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAgI1F;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,EAAE,EACjB,MAAM,EAAE,eAAe,EAAE,GACxB,QAAQ,EAAE,CAgFZ;AAMD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACtE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB,CAAC,CAmBD"}

package/dist/core/analyzer/http-route-parser.js

@@ -0,0 +1,466 @@
+/**
+ * HTTP Route Parser
+ *
+ * Extracts two complementary sets of data:
+ *   1. HTTP CALLS  — fetch/axios/ky/got calls in JS/TS frontend files
+ *   2. ROUTE DEFS  — FastAPI / Flask / Django route declarations in Python files
+ *
+ * These are then matched by `buildHttpEdges()` to create cross-language edges
+ * between the frontend files that call an endpoint and the Python handlers that
+ * serve it — filling the gap that static import analysis cannot reach.
+ *
+ * Matching strategy
+ * -----------------
+ * Routes are normalised to a canonical form before comparison:
+ *   - Path parameters are replaced with a placeholder: /items/{id} → /items/:param
+ *   - Leading slashes are normalised
+ *   - Query strings are stripped from call-site URLs
+ *   - Common API prefixes (/api, /api/v1, /v1, …) are tried both with and
+ *     without the prefix so that a frontend call to /api/v1/search still matches
+ *     a FastAPI router mounted at /search.
+ *
+ * Confidence levels
+ * -----------------
+ *   exact   — method + full path match
+ *   path    — path matches, method unknown on one side (e.g. bare fetch)
+ *   fuzzy   — normalised path matches after prefix stripping
+ */
+import { readFile } from 'node:fs/promises';
+import { extname } from 'node:path';
+// ============================================================================
+// NORMALISATION HELPERS
+// ============================================================================
+/** Common API prefixes that frontends add but backends may not declare */
+const API_PREFIXES = [
+    '/api/v1', '/api/v2', '/api/v3',
+    '/api',
+    '/v1', '/v2', '/v3',
+];
+/**
+ * Reduce a URL/path to a comparable canonical form:
+ *   - Strip protocol + host if present  (https://example.com/foo → /foo)
+ *   - Strip query string and fragment
+ *   - Replace path parameters with :param
+ *     {id}, :id, <int:id>, <id>  →  :param
+ *   - Collapse duplicate slashes
+ *   - Remove trailing slash (except root)
+ */
+export function normalizeUrl(raw) {
+    // Remove template-literal variable parts: ${...}
+    let url = raw.replace(/\$\{[^}]+\}/g, ':param');
+    // Strip protocol + host
+    url = url.replace(/^https?:\/\/[^/]+/, '');
+    // Strip query string and fragment
+    url = url.replace(/[?#].*$/, '');
+    // Replace FastAPI / Flask style path params
+    url = url.replace(/\{[^}]+\}/g, ':param'); // {item_id}
+    url = url.replace(/<[^>]+>/g, ':param'); // <int:item_id>
+    url = url.replace(/:[\w]+/g, ':param'); // :item_id  (Express style)
+    // Collapse duplicate slashes, ensure leading slash
+    url = ('/' + url).replace(/\/+/g, '/');
+    // Remove trailing slash unless it IS the root
+    if (url.length > 1 && url.endsWith('/'))
+        url = url.slice(0, -1);
+    return url.toLowerCase();
+}
+/**
+ * Return all candidate normalised paths to try for a frontend URL.
+ * We try both the full path and the path with each known prefix stripped,
+ * to handle cases where the backend router is mounted without the prefix.
+ */
+function candidatePaths(normalizedUrl) {
+    const candidates = new Set([normalizedUrl]);
+    for (const prefix of API_PREFIXES) {
+        if (normalizedUrl.startsWith(prefix + '/') || normalizedUrl === prefix) {
+            candidates.add(normalizedUrl.slice(prefix.length) || '/');
+        }
+    }
+    return Array.from(candidates);
+}
+// ============================================================================
+// HTTP CALL EXTRACTION  (JS / TS)
+// ============================================================================
+/**
+ * Extract all HTTP calls from a JavaScript or TypeScript source file.
+ */
+export async function extractHttpCalls(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    if (!['.js', '.jsx', '.ts', '.tsx', '.mjs', '.cjs'].includes(ext))
+        return [];
+    let content;
+    try {
+        content = await readFile(filePath, 'utf8');
+    }
+    catch {
+        return [];
+    }
+    const calls = [];
+    // Strip comments to avoid false matches.
+    // The line-comment regex must NOT match `://` inside URLs — we only strip
+    // `//` that is preceded by whitespace, punctuation, brackets, or the start
+    // of the line (i.e. genuine JS/TS comments, not protocol separators).
+    // The character class intentionally includes ) and ] so that patterns like
+    // `fetch('/api/items') // comment` are correctly stripped.
+    const clean = content
+        .replace(/\/\*[\s\S]*?\*\//g, '')
+        .replace(/(^|[\s,;()[\]{}])\/\/.*$/gm, '$1');
+    const lines = content.split('\n'); // keep original for line numbers
+    // ── fetch ──────────────────────────────────────────────────────────────────
+    // fetch('/api/search')
+    // fetch(`/api/search/${id}`, { method: 'POST' })
+    const fetchRegex = /\bfetch\s*\(\s*(`[^`]+`|'[^']+'|"[^"]+")\s*(?:,\s*\{([^}]*)\})?\s*\)/g;
+    let m;
+    while ((m = fetchRegex.exec(clean)) !== null) {
+        const rawUrl = m[1].replace(/^[`'"]/, '').replace(/[`'"]$/, '');
+        const optionsBlock = m[2] ?? '';
+        const methodMatch = optionsBlock.match(/method\s*:\s*['"`](\w+)['"`]/i);
+        const method = methodMatch ? methodMatch[1].toUpperCase() : 'GET';
+        calls.push({
+            file: filePath,
+            method,
+            url: rawUrl,
+            normalizedUrl: normalizeUrl(rawUrl),
+            line: getLine(lines, m.index),
+            client: 'fetch',
+        });
+    }
+    // ── axios (method shorthands + generic) ────────────────────────────────────
+    // axios.get('/api/items')
+    // axios.post('/api/items', data)
+    // axios({ method: 'post', url: '/api/items' })
+    // axios.request({ method: 'DELETE', url: '/api/items/1' })
+    const axiosMethodRegex = /\baxios\.(get|post|put|patch|delete|head|options)\s*\(\s*(`[^`]+`|'[^']+'|"[^"]+")/g;
+    while ((m = axiosMethodRegex.exec(clean)) !== null) {
+        const method = m[1].toUpperCase();
+        const rawUrl = m[2].replace(/^[`'"]/, '').replace(/[`'"]$/, '');
+        calls.push({
+            file: filePath,
+            method,
+            url: rawUrl,
+            normalizedUrl: normalizeUrl(rawUrl),
+            line: getLine(lines, m.index),
+            client: 'axios',
+        });
+    }
+    // axios({ url: '...', method: '...' })  or  axios.request({ ... })
+    const axiosConfigRegex = /\baxios(?:\.request)?\s*\(\s*\{([^}]{0,400})\}/g;
+    while ((m = axiosConfigRegex.exec(clean)) !== null) {
+        const block = m[1];
+        const urlMatch = block.match(/url\s*:\s*(`[^`]+`|'[^']+'|"[^"]+")/);
+        if (!urlMatch)
+            continue;
+        const rawUrl = urlMatch[1].replace(/^[`'"]/, '').replace(/[`'"]$/, '');
+        const methodMatch = block.match(/method\s*:\s*['"`](\w+)['"`]/i);
+        const method = methodMatch ? methodMatch[1].toUpperCase() : 'UNKNOWN';
+        calls.push({
+            file: filePath,
+            method,
+            url: rawUrl,
+            normalizedUrl: normalizeUrl(rawUrl),
+            line: getLine(lines, m.index),
+            client: 'axios',
+        });
+    }
+    // ── ky ─────────────────────────────────────────────────────────────────────
+    // ky.get('/api/items')  ky.post('/api/items', { json: data })
+    const kyRegex = /\bky\.(get|post|put|patch|delete|head)\s*\(\s*(`[^`]+`|'[^']+'|"[^"]+")/g;
+    while ((m = kyRegex.exec(clean)) !== null) {
+        const rawUrl = m[2].replace(/^[`'"]/, '').replace(/[`'"]$/, '');
+        calls.push({
+            file: filePath,
+            method: m[1].toUpperCase(),
+            url: rawUrl,
+            normalizedUrl: normalizeUrl(rawUrl),
+            line: getLine(lines, m.index),
+            client: 'ky',
+        });
+    }
+    // ── got ────────────────────────────────────────────────────────────────────
+    // got.get('/api/items')
+    const gotRegex = /\bgot\.(get|post|put|patch|delete|head)\s*\(\s*(`[^`]+`|'[^']+'|"[^"]+")/g;
+    while ((m = gotRegex.exec(clean)) !== null) {
+        const rawUrl = m[2].replace(/^[`'"]/, '').replace(/[`'"]$/, '');
+        calls.push({
+            file: filePath,
+            method: m[1].toUpperCase(),
+            url: rawUrl,
+            normalizedUrl: normalizeUrl(rawUrl),
+            line: getLine(lines, m.index),
+            client: 'got',
+        });
+    }
+    // ── React Query / SWR convenience wrappers ─────────────────────────────────
+    // useQuery(['key', id], () => fetch('/api/items'))   — already caught above
+    // useMutation(() => axios.post('/api/items'))        — already caught above
+    return calls;
+}
+// ============================================================================
+// ROUTE DEFINITION EXTRACTION  (Python)
+// ============================================================================
+/**
+ * Extract all route definitions from a Python source file.
+ * Supports FastAPI, Starlette, Flask, and Django (urls.py path/re_path).
+ */
+export async function extractRouteDefinitions(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    if (!['.py', '.pyw'].includes(ext))
+        return [];
+    let content;
+    try {
+        content = await readFile(filePath, 'utf8');
+    }
+    catch {
+        return [];
+    }
+    const routes = [];
+    const lines = content.split('\n');
+    // Remove comments for cleaner matching
+    const clean = content.replace(/#.*$/gm, '');
+    // ── FastAPI / Starlette decorators ─────────────────────────────────────────
+    // @app.get("/items/{item_id}")
+    // @router.post("/search", ...)
+    // @app.api_route("/multi", methods=["GET","POST"])
+    const fastapiDecoratorRegex = /@(?:app|router|api_router)\.(get|post|put|patch|delete|head|options|trace)\s*\(\s*(['"/][^'")\n]+['"])/gm;
+    let m;
+    while ((m = fastapiDecoratorRegex.exec(clean)) !== null) {
+        const method = m[1].toUpperCase();
+        const path = m[2].replace(/^['"]/, '').replace(/['"]$/, '');
+        const lineNum = getLine(lines, m.index);
+        // The handler name is on the `def` line right after the decorator block
+        const handlerName = extractNextDefName(lines, lineNum);
+        routes.push({
+            file: filePath,
+            method,
+            path,
+            normalizedPath: normalizeUrl(path),
+            handlerName,
+            framework: 'fastapi',
+            line: lineNum,
+        });
+    }
+    // @app.api_route("/path", methods=["GET", "POST"])
+    const apiRouteRegex = /@(?:app|router|api_router)\.api_route\s*\(\s*(['"/][^'")\n]+['"]),\s*methods\s*=\s*\[([^\]]+)\]/gm;
+    while ((m = apiRouteRegex.exec(clean)) !== null) {
+        const path = m[1].replace(/^['"]/, '').replace(/['"]$/, '');
+        const lineNum = getLine(lines, m.index);
+        const handlerName = extractNextDefName(lines, lineNum);
+        // Parse the methods list
+        const methodMatches = m[2].matchAll(/['"](\w+)['"]/g);
+        for (const mm of methodMatches) {
+            routes.push({
+                file: filePath,
+                method: mm[1].toUpperCase(),
+                path,
+                normalizedPath: normalizeUrl(path),
+                handlerName,
+                framework: 'fastapi',
+                line: lineNum,
+            });
+        }
+    }
+    // ── Flask ──────────────────────────────────────────────────────────────────
+    // @app.route("/items", methods=["GET", "POST"])
+    // @bp.route("/items/<int:item_id>", methods=["DELETE"])
+    const flaskRouteRegex = /@(?:\w+)\.route\s*\(\s*(['"/][^'")\n]+['"]),?\s*(?:methods\s*=\s*\[([^\]]*)\])?\s*\)/gm;
+    while ((m = flaskRouteRegex.exec(clean)) !== null) {
+        const path = m[1].replace(/^['"]/, '').replace(/['"]$/, '');
+        const lineNum = getLine(lines, m.index);
+        const handlerName = extractNextDefName(lines, lineNum);
+        const rawMethods = m[2];
+        if (rawMethods) {
+            const methodMatches = rawMethods.matchAll(/['"](\w+)['"]/g);
+            for (const mm of methodMatches) {
+                routes.push({
+                    file: filePath,
+                    method: mm[1].toUpperCase(),
+                    path,
+                    normalizedPath: normalizeUrl(path),
+                    handlerName,
+                    framework: 'flask',
+                    line: lineNum,
+                });
+            }
+        }
+        else {
+            // Flask default is GET when no methods specified
+            routes.push({
+                file: filePath,
+                method: 'GET',
+                path,
+                normalizedPath: normalizeUrl(path),
+                handlerName,
+                framework: 'flask',
+                line: lineNum,
+            });
+        }
+    }
+    // ── Django urls.py ─────────────────────────────────────────────────────────
+    // path('api/items/', views.ItemListView.as_view(), name='item-list'),
+    // re_path(r'^api/items/(?P<pk>[0-9]+)/$', views.ItemDetailView.as_view()),
+    //
+    // NOTE: Django views handle HTTP method dispatch internally (via class-based
+    // views or decorators), so no method is declared in urls.py. All Django
+    // routes are stored with method='UNKNOWN', which means any frontend call
+    // matched against a Django route will receive confidence='path' at best —
+    // never 'exact'. This may produce false-positive edges when multiple HTTP
+    // methods share the same URL pattern. Filter by confidence if this matters.
+    const djangoPathRegex = /\bpath\s*\(\s*r?(['"])(.*?)\1\s*,\s*([\w.]+)/gm;
+    while ((m = djangoPathRegex.exec(clean)) !== null) {
+        const path = '/' + m[2].replace(/\$$/, '').replace(/^\^/, '');
+        const handlerName = m[3].split('.').pop() ?? m[3];
+        const lineNum = getLine(lines, m.index);
+        routes.push({
+            file: filePath,
+            method: 'UNKNOWN', // Django views handle method internally
+            path,
+            normalizedPath: normalizeUrl(path),
+            handlerName,
+            framework: 'django',
+            line: lineNum,
+        });
+    }
+    return routes;
+}
+// ============================================================================
+// EDGE BUILDER
+// ============================================================================
+/**
+ * Match HTTP calls from JS/TS files against route definitions from Python files
+ * and return cross-language edges.
+ *
+ * Pass in pre-extracted calls and routes (so callers can cache them across
+ * multiple graph builds without re-parsing).
+ */
+export function buildHttpEdges(calls, routes) {
+    const edges = [];
+    // Index routes by normalised path for O(1) lookup
+    const routesByPath = new Map();
+    for (const route of routes) {
+        const existing = routesByPath.get(route.normalizedPath) ?? [];
+        existing.push(route);
+        routesByPath.set(route.normalizedPath, existing);
+    }
+    for (const call of calls) {
+        // Build all candidate paths (handles /api/v1 prefix stripping)
+        const candidates = candidatePaths(call.normalizedUrl);
+        let matched = false;
+        for (const candidate of candidates) {
+            const matchingRoutes = routesByPath.get(candidate);
+            if (!matchingRoutes)
+                continue;
+            for (const route of matchingRoutes) {
+                // Determine confidence
+                let confidence;
+                const methodsKnown = call.method !== 'UNKNOWN' && route.method !== 'UNKNOWN';
+                const methodsMatch = call.method === route.method;
+                if (methodsKnown && methodsMatch && candidate === call.normalizedUrl) {
+                    confidence = 'exact';
+                }
+                else if (!methodsKnown || !methodsMatch) {
+                    confidence = candidate !== call.normalizedUrl ? 'fuzzy' : 'path';
+                }
+                else {
+                    confidence = candidate !== call.normalizedUrl ? 'fuzzy' : 'exact';
+                }
+                edges.push({
+                    callerFile: call.file,
+                    handlerFile: route.file,
+                    method: methodsKnown ? call.method : route.method,
+                    path: candidate,
+                    call,
+                    route,
+                    confidence,
+                });
+                matched = true;
+            }
+        }
+        // If no match found via exact/prefix logic, try fuzzy segment comparison
+        if (!matched) {
+            const callSegments = call.normalizedUrl.replace(/:param/g, '*').split('/');
+            for (const [routePath, routeList] of routesByPath) {
+                const routeSegments = routePath.replace(/:param/g, '*').split('/');
+                if (callSegments.length !== routeSegments.length)
+                    continue;
+                const allMatch = callSegments.every((seg, i) => seg === routeSegments[i] || seg === '*' || routeSegments[i] === '*');
+                if (!allMatch)
+                    continue;
+                for (const route of routeList) {
+                    edges.push({
+                        callerFile: call.file,
+                        handlerFile: route.file,
+                        method: call.method !== 'UNKNOWN' ? call.method : route.method,
+                        path: routePath,
+                        call,
+                        route,
+                        confidence: 'fuzzy',
+                    });
+                }
+            }
+        }
+    }
+    // Deduplicate: same caller file + handler file + method + path
+    const seen = new Set();
+    return edges.filter(e => {
+        const key = `${e.callerFile}|${e.handlerFile}|${e.method}|${e.path}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+// ============================================================================
+// BATCH HELPERS
+// ============================================================================
+/**
+ * Parse all files in a mixed JS+Python codebase and return HTTP edges.
+ * Intended to be called once per graph build and its result merged into
+ * the DependencyGraphResult edges.
+ */
+export async function extractAllHttpEdges(filePaths) {
+    const allCalls = [];
+    const allRoutes = [];
+    await Promise.all(filePaths.map(async (fp) => {
+        const ext = extname(fp).toLowerCase();
+        if (['.js', '.jsx', '.ts', '.tsx', '.mjs', '.cjs'].includes(ext)) {
+            const calls = await extractHttpCalls(fp);
+            allCalls.push(...calls);
+        }
+        else if (['.py', '.pyw'].includes(ext)) {
+            const routes = await extractRouteDefinitions(fp);
+            allRoutes.push(...routes);
+        }
+    }));
+    const edges = buildHttpEdges(allCalls, allRoutes);
+    return { calls: allCalls, routes: allRoutes, edges };
+}
+// ============================================================================
+// PRIVATE UTILITIES
+// ============================================================================
+/** Convert a character offset in `content` to a 1-based line number */
+function getLine(lines, charOffset) {
+    let accumulated = 0;
+    for (let i = 0; i < lines.length; i++) {
+        accumulated += lines[i].length + 1; // +1 for newline
+        if (accumulated > charOffset)
+            return i + 1;
+    }
+    return lines.length;
+}
+/**
+ * Given the line of a decorator, scan forward to find the next `def` name.
+ * Handles multi-line decorators with up to 10 lines of lookahead.
+ *
+ * `decoratorLine` is 1-based (from getLine()), so we convert to a 0-based
+ * index before indexing into the `lines` array.
+ */
+function extractNextDefName(lines, decoratorLine) {
+    const start = decoratorLine - 1; // convert 1-based → 0-based
+    const maxLook = Math.min(lines.length, start + 10);
+    for (let i = start; i < maxLook; i++) {
+        const defMatch = lines[i]?.match(/^\s*(?:async\s+)?def\s+(\w+)/);
+        if (defMatch)
+            return defMatch[1];
+    }
+    return 'unknown';
+}
+//# sourceMappingURL=http-route-parser.js.map

package/dist/core/analyzer/http-route-parser.js.map

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

package/dist/core/analyzer/import-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import-parser.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/import-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;IACpF,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AA8kBD;;GAEG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAsExB;AAMD;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAwC;IAErD;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAsDxD;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAU1E;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAGvE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAGxF"}
+{"version":3,"file":"import-parser.d.ts","sourceRoot":"","sources":["../../../src/core/analyzer/import-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;IACpF,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,OAAO,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AA8kBD;;GAEG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqFxB;AAMD;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,CAAwC;IAErD;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAsDxD;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAU1E;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAGvE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAGxF"}

package/dist/core/analyzer/import-parser.js

@@ -547,13 +547,15 @@ function parsePythonExports(content) {
  * Resolve a relative import to an absolute file path
  */
 export async function resolveImport(importSource, fromFile, options) {
-    // External package - return null
-    if (!isRelativeImport(importSource)) {
+    const fromExt = extname(fromFile).toLowerCase();
+    const isPython = fromExt === '.py' || fromExt === '.pyw';
+    // For non-Python files, external packages can never resolve to a local file.
+    // For Python files we must NOT bail out here: `from services.retriever import X`
+    // looks like a package import but may well be a local module under rootDir.
+    if (!isRelativeImport(importSource) && !isPython) {
         return null;
     }
     const fromDir = dirname(fromFile);
-    const fromExt = extname(fromFile).toLowerCase();
-    const isPython = fromExt === '.py' || fromExt === '.pyw';
     // Default extensions depend on the source file type
     const extensions = options.extensions ?? (isPython
         ? ['.py', '.pyw']
@@ -573,7 +575,19 @@ export async function resolveImport(importSource, fromFile, options) {
         const prefix = dots === 1 ? './' : '../'.repeat(dots - 1);
         normalizedSource = rest ? prefix + rest : prefix.replace(/\/$/, '') || '.';
     }
-    const basePath = resolve(fromDir, normalizedSource);
+    else if (isPython && !importSource.startsWith('.')) {
+        // Absolute-style intra-project import: "services.retriever" or "services.retriever.utils"
+        // Convert dotted module path to a filesystem path relative to rootDir.
+        // e.g. "services.retriever" → "<rootDir>/services/retriever.py"
+        normalizedSource = './' + importSource.replace(/\./g, '/');
+    }
+    // For Python absolute imports resolve from rootDir, not fromDir,
+    // because Python's module system uses sys.path (typically the project root).
+    // Fall back to fromDir if baseDir is empty to avoid resolving against cwd.
+    const resolveBase = (isPython && !importSource.startsWith('.'))
+        ? (options.baseDir || fromDir)
+        : fromDir;
+    const basePath = resolve(resolveBase, normalizedSource);
     // Strip any existing extension from the import source.
     // This handles the TypeScript NodeNext convention where imports are written
     // as `./foo.js` but the actual file on disk is `./foo.ts`.