@kage-core/kage-graph-mcp 1.1.27 → 1.1.29

package/README.md

@@ -37,7 +37,7 @@ Restart your agent once after setup so MCP tools reload.
 - repo-local memory for decisions, runbooks, bug fixes, gotchas, conventions,
   and code explanations
 - a code graph for files, symbols, imports, calls, routes, tests, and packages,
-  including generic call/test signals for non-TypeScript repos
+  including generic call/test signals and mixed-language framework routes
 - memory-code links so project knowledge points at the code it affects
 - decision intelligence for why-memory coverage, stale/weak packets, and
   important files that still lack linked repo knowledge

package/dist/kernel.js

@@ -2830,11 +2830,62 @@ function extractGenericCalls(path, text, symbols, symbolByName) {
     }
     return calls.sort((a, b) => a.line - b.line || a.to_symbol.localeCompare(b.to_symbol));
 }
+function offsetForLine(text, oneBasedLine) {
+    if (oneBasedLine <= 1)
+        return 0;
+    const lines = text.split(/\r?\n/).slice(0, oneBasedLine - 1);
+    return lines.join("\n").length + (lines.length ? 1 : 0);
+}
+function normalizeWebRoutePath(routePath) {
+    let cleaned = routePath
+        .trim()
+        .replace(/^r(["'`])|(["'`])$/g, "")
+        .replace(/^['"`]|['"`]$/g, "")
+        .replace(/\\/g, "")
+        .replace(/^\^/, "")
+        .replace(/\$$/, "")
+        .replace(/\{([A-Za-z_][\w]*)\}/g, ":$1")
+        .replace(/<(?:(?:int|str|slug|uuid|path):)?([A-Za-z_][\w]*)>/g, ":$1")
+        .replace(/\/+/g, "/");
+    if (!cleaned.startsWith("/"))
+        cleaned = `/${cleaned}`;
+    if (cleaned.length > 1)
+        cleaned = cleaned.replace(/\/$/, "");
+    return cleaned || "/";
+}
+function pythonRouteFramework(text) {
+    return /\bfrom\s+flask\s+import\b|\bimport\s+flask\b|\bFlask\s*\(/.test(text) ? "flask" : "fastapi";
+}
+function parsePythonMethodList(value) {
+    if (!value)
+        return ["GET"];
+    const methods = [...value.matchAll(/["']([A-Za-z]+)["']/g)].map((match) => match[1].toUpperCase());
+    return methods.length ? unique(methods) : ["GET"];
+}
+const SPRING_ROUTE_METHODS = {
+    GetMapping: "GET",
+    PostMapping: "POST",
+    PutMapping: "PUT",
+    PatchMapping: "PATCH",
+    DeleteMapping: "DELETE",
+    RequestMapping: "ANY",
+};
+const ASPNET_ROUTE_METHODS = {
+    Get: "GET",
+    Post: "POST",
+    Put: "PUT",
+    Patch: "PATCH",
+    Delete: "DELETE",
+};
+function routeHandlerNearLine(lines, startIndex, pattern) {
+    const handlerLine = lines.slice(startIndex + 1, Math.min(lines.length, startIndex + 8)).find((candidate) => pattern.test(candidate));
+    return handlerLine?.match(pattern)?.[1] ?? null;
+}
 function extractRoutes(path, text, symbols) {
     const routes = [];
     const addRoute = (method, routePath, offset, framework, handler = null) => {
         const line = lineForOffset(text, offset);
-        const cleanRoutePath = routePath.replace(/\\/g, "");
+        const cleanRoutePath = normalizeWebRoutePath(routePath);
         const containing = handler ? symbols.find((symbol) => symbol.path === path && symbol.name === handler) : symbolAtLine(symbols, path, line);
         routes.push({
             id: routeId(path, method, cleanRoutePath, line),
@@ -2856,6 +2907,92 @@ function extractRoutes(path, text, symbols) {
         const routeMatch = text.match(new RegExp(`const\\s+${match[2]}Match\\s*=\\s*url\\.pathname\\.match\\(\\s*/\\^\\\\/([^/]+)[^/]*`));
         addRoute(match[1], routeMatch ? `/${routeMatch[1]}/:id` : "/:dynamic", match.index ?? 0, "node-http");
     }
+    if (extensionOf(path) === ".py") {
+        const lines = text.split(/\r?\n/);
+        const framework = pythonRouteFramework(text);
+        for (let index = 0; index < lines.length; index += 1) {
+            const line = lines[index];
+            const decorator = line.match(/^\s*@(?:\w+\.)?(get|post|put|patch|delete|options|head)\s*\(\s*["']([^"']+)["']/i);
+            if (decorator) {
+                const handlerLine = lines.slice(index + 1, Math.min(lines.length, index + 7)).find((candidate) => /^\s*(?:async\s+)?def\s+[A-Za-z_][\w]*\s*\(/.test(candidate));
+                const handler = handlerLine?.match(/^\s*(?:async\s+)?def\s+([A-Za-z_][\w]*)\s*\(/)?.[1] ?? null;
+                addRoute(decorator[1].toUpperCase(), decorator[2], offsetForLine(text, index + 1), framework, handler);
+                continue;
+            }
+            const flaskRoute = line.match(/^\s*@(?:\w+\.)?route\s*\(\s*["']([^"']+)["']/i);
+            if (flaskRoute) {
+                const handlerLine = lines.slice(index + 1, Math.min(lines.length, index + 7)).find((candidate) => /^\s*(?:async\s+)?def\s+[A-Za-z_][\w]*\s*\(/.test(candidate));
+                const handler = handlerLine?.match(/^\s*(?:async\s+)?def\s+([A-Za-z_][\w]*)\s*\(/)?.[1] ?? null;
+                const methods = line.match(/methods\s*=\s*\[([^\]]+)\]/i)?.[1];
+                for (const method of parsePythonMethodList(methods))
+                    addRoute(method, flaskRoute[1], offsetForLine(text, index + 1), "flask", handler);
+                continue;
+            }
+            const djangoPath = line.match(/\b(?:path|re_path)\s*\(\s*r?["']([^"']+)["']\s*,\s*([A-Za-z_][\w.]+)/);
+            if (djangoPath) {
+                const handler = djangoPath[2].split(".").pop() ?? null;
+                addRoute("ANY", djangoPath[1], offsetForLine(text, index + 1), "django", handler);
+            }
+        }
+    }
+    if (extensionOf(path) === ".rb") {
+        for (const match of text.matchAll(/\b(get|post|put|patch|delete)\s+["']([^"']+)["']/gi)) {
+            addRoute(match[1].toUpperCase(), match[2], match.index ?? 0, "rails");
+        }
+    }
+    if (extensionOf(path) === ".php") {
+        for (const match of text.matchAll(/\bRoute::(get|post|put|patch|delete|options|any)\s*\(\s*["']([^"']+)["']/gi)) {
+            addRoute(match[1].toUpperCase(), match[2], match.index ?? 0, "laravel");
+        }
+    }
+    if ([".java", ".kt"].includes(extensionOf(path))) {
+        const lines = text.split(/\r?\n/);
+        for (let index = 0; index < lines.length; index += 1) {
+            const line = lines[index];
+            const mapping = line.match(/@(GetMapping|PostMapping|PutMapping|PatchMapping|DeleteMapping|RequestMapping)\s*(?:\(\s*(?:value\s*=\s*)?["']([^"']+)["'])?/);
+            if (!mapping || !mapping[2])
+                continue;
+            let method = SPRING_ROUTE_METHODS[mapping[1]] ?? "ANY";
+            if (mapping[1] === "RequestMapping") {
+                const explicit = line.match(/RequestMethod\.(GET|POST|PUT|PATCH|DELETE|OPTIONS|HEAD)/);
+                if (explicit)
+                    method = explicit[1];
+            }
+            const handler = routeHandlerNearLine(lines, index, /^\s*(?:public|private|protected)?\s*[\w<>\[\], ?]+\s+([A-Za-z_][\w]*)\s*\(/);
+            addRoute(method, mapping[2], offsetForLine(text, index + 1), "spring", handler);
+        }
+    }
+    if (extensionOf(path) === ".go") {
+        for (const match of text.matchAll(/\b[A-Za-z_][\w]*\.(GET|POST|PUT|PATCH|DELETE|OPTIONS|HEAD)\s*\(\s*["`]([^"`]+)["`]\s*,\s*([A-Za-z_][\w.]*)?/g)) {
+            addRoute(match[1], match[2], match.index ?? 0, "go-router", match[3]?.split(".").pop() ?? null);
+        }
+    }
+    if (extensionOf(path) === ".rs") {
+        for (const match of text.matchAll(/\.route\s*\(\s*["']([^"']+)["']\s*,\s*(get|post|put|patch|delete|options|head)\s*\(\s*([A-Za-z_][\w:]*)?/gi)) {
+            addRoute(match[2].toUpperCase(), match[1], match.index ?? 0, "rust-router", match[3]?.split("::").pop() ?? null);
+        }
+        const lines = text.split(/\r?\n/);
+        for (let index = 0; index < lines.length; index += 1) {
+            const attr = lines[index].match(/#\[(get|post|put|patch|delete|options|head)\(\s*["']([^"']+)["']\s*\)\]/i);
+            if (!attr)
+                continue;
+            const handler = routeHandlerNearLine(lines, index, /^\s*(?:pub\s+)?(?:async\s+)?fn\s+([A-Za-z_][\w]*)\s*\(/);
+            addRoute(attr[1].toUpperCase(), attr[2], offsetForLine(text, index + 1), "rust-router", handler);
+        }
+    }
+    if (extensionOf(path) === ".cs") {
+        for (const match of text.matchAll(/\bMap(Get|Post|Put|Patch|Delete)\s*\(\s*["']([^"']+)["']\s*,\s*([A-Za-z_][\w.]*)?/g)) {
+            addRoute(ASPNET_ROUTE_METHODS[match[1]] ?? match[1].toUpperCase(), match[2], match.index ?? 0, "aspnet", match[3]?.split(".").pop() ?? null);
+        }
+        const lines = text.split(/\r?\n/);
+        for (let index = 0; index < lines.length; index += 1) {
+            const attr = lines[index].match(/\[\s*Http(Get|Post|Put|Patch|Delete)?\s*\(\s*["']([^"']+)["']\s*\)\s*\]/);
+            if (!attr)
+                continue;
+            const handler = routeHandlerNearLine(lines, index, /^\s*(?:public|private|protected|internal)?\s*(?:async\s+)?[\w<>\[\], ?]+\s+([A-Za-z_][\w]*)\s*\(/);
+            addRoute(attr[1] ? ASPNET_ROUTE_METHODS[attr[1]] ?? attr[1].toUpperCase() : "ANY", attr[2], offsetForLine(text, index + 1), "aspnet", handler);
+        }
+    }
     if (/app\/api\//.test(path)) {
         for (const symbol of symbols.filter((symbol) => symbol.path === path && symbol.export && ["GET", "POST", "PUT", "PATCH", "DELETE"].includes(symbol.name))) {
             const apiPath = `/${path.replace(/^.*app\/api\//, "").replace(/\/route\.[cm]?[jt]sx?$/, "").replace(/\[([^\]]+)\]/g, ":$1")}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kage-core/kage-graph-mcp",
-  "version": "1.1.27",
+  "version": "1.1.29",
   "description": "Local-first repo memory, code graph, and recall MCP server for coding agents",
   "main": "dist/index.js",
   "files": [