feat: wire up framework route extraction

README.md

@@ -107,10 +107,32 @@ All tests used Claude Opus 4.6 (1M context) with Claude Code v2.1.91. Each test
 | **Impact Analysis** | Trace callers, callees, and the full impact radius of any symbol before making changes |
 | **Always Fresh** | File watcher uses native OS events (FSEvents/inotify/ReadDirectoryChangesW) with debounced auto-sync — the graph stays current as you code, zero config |
 | **19+ Languages** | TypeScript, JavaScript, Python, Go, Rust, Java, C#, PHP, Ruby, C, C++, Swift, Kotlin, Dart, Svelte, Liquid, Pascal/Delphi |
+| **Framework-aware Routes** | Recognizes web-framework routing files and links URL patterns to their handlers across 13 frameworks |
 | **100% Local** | No data leaves your machine. No API keys. No external services. SQLite database only |
 
 ---
 
+## Framework-aware Routes
+
+CodeGraph detects web-framework routing files and emits `route` nodes linked by `references` edges to their handler classes or functions. Querying callers of a view/controller now surfaces the URL pattern that binds it.
+
+| Framework | Shapes recognized |
+|---|---|
+| **Django** | `path()`, `re_path()`, `url()`, `include()` in `urls.py` (CBV `.as_view()`, dotted paths) |
+| **Flask** | `@app.route('/path', methods=[...])`, blueprint routes |
+| **FastAPI** | `@app.get(...)`, `@router.post(...)`, all standard methods |
+| **Express** | `app.get(...)`, `router.post(...)` with middleware chains |
+| **Laravel** | `Route::get()`, `Route::resource()`, `Controller@action`, tuple syntax |
+| **Rails** | `get '/x', to: 'users#index'`, hash-rocket `=>` syntax |
+| **Spring** | `@GetMapping`, `@PostMapping`, `@RequestMapping` on methods |
+| **Gin / chi / gorilla / mux** | `r.GET(...)`, `router.HandleFunc(...)` |
+| **Axum / actix / Rocket** | `.route("/x", get(handler))` |
+| **ASP.NET** | `[HttpGet("/x")]` attributes on action methods |
+| **Vapor** | `app.get("x", use: handler)` |
+| **React Router** / **SvelteKit** | Route component nodes |
+
+---
+
 ## Quick Start
 
 ### 1. Run the Installer

__tests__/frameworks-integration.test.ts

@@ -0,0 +1,59 @@
+import { describe, it, expect, beforeAll, afterEach } from 'vitest';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { CodeGraph } from '../src';
+import { initGrammars, loadAllGrammars } from '../src/extraction/grammars';
+
+beforeAll(async () => {
+  await initGrammars();
+  await loadAllGrammars();
+});
+
+describe('Django end-to-end framework extraction', () => {
+  let tmpDir: string | undefined;
+  afterEach(() => {
+    if (tmpDir) fs.rmSync(tmpDir, { recursive: true, force: true });
+    tmpDir = undefined;
+  });
+
+  it('creates a route->view edge from urls.py to view class', async () => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'cg-django-'));
+    fs.writeFileSync(path.join(tmpDir, 'manage.py'), '# marker\n');
+    fs.writeFileSync(path.join(tmpDir, 'requirements.txt'), 'django==4.2\n');
+    fs.mkdirSync(path.join(tmpDir, 'users'));
+    fs.writeFileSync(path.join(tmpDir, 'users/__init__.py'), '');
+    fs.writeFileSync(
+      path.join(tmpDir, 'users/views.py'),
+      'class UserListView:\n    def get(self, request): pass\n'
+    );
+    fs.writeFileSync(
+      path.join(tmpDir, 'users/urls.py'),
+      'from django.urls import path\n' +
+        'from users.views import UserListView\n' +
+        'urlpatterns = [path("users/", UserListView.as_view(), name="user-list")]\n'
+    );
+
+    const cg = CodeGraph.initSync(tmpDir);
+    await cg.indexAll();
+
+    // Route node exists
+    const routes = cg.getNodesByKind('route');
+    expect(routes.length).toBeGreaterThan(0);
+    const route = routes.find((n) => n.name === 'users/');
+    expect(route).toBeDefined();
+
+    // View class exists
+    const classNodes = cg.getNodesByKind('class');
+    const view = classNodes.find((n) => n.name === 'UserListView');
+    expect(view).toBeDefined();
+
+    // Edge route -> view exists
+    const edges = cg.getOutgoingEdges(route!.id);
+    const toView = edges.find((e) => e.target === view!.id);
+    expect(toView).toBeDefined();
+    expect(toView!.kind).toBe('references');
+
+    cg.close();
+  });
+});