purecontext-mcp 1.0.1

package/dist/adapters/fastapi.js

@@ -0,0 +1,113 @@
+/**
+ * FastAPI framework adapter.
+ *
+ * Extracts route symbols from FastAPI applications by scanning for decorator
+ * patterns on endpoint functions. Only extracts routes where the path is a
+ * string literal inside the decorator.
+ *
+ * Patterns recognised:
+ *   @app.get('/path')         → GET /path
+ *   @app.post('/path')        → POST /path
+ *   @router.get('/path')      → GET /path  (APIRouter)
+ *   @api.delete('/path')      → DELETE /path
+ */
+import { createHash } from 'crypto';
+import { readFileSync } from 'fs';
+import { join } from 'path';
+import { registerAdapter } from './adapter-registry.js';
+import { logger } from '../core/logger.js';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function makeId(filePath, name, kind) {
+    return createHash('sha256')
+        .update(`${filePath}:${name}:${kind}`)
+        .digest('hex')
+        .slice(0, 16);
+}
+const HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+/**
+ * Normalise FastAPI path parameters from {param_name} to :param_name.
+ * e.g. /users/{user_id}      → /users/:user_id
+ *      /items/{item_id}/tags → /items/:item_id/tags
+ */
+function normalisePath(path) {
+    return path.replace(/\{([a-zA-Z_][a-zA-Z0-9_]*)\}/g, ':$1');
+}
+/**
+ * Return true if source file imports FastAPI.
+ */
+function hasFastApiImport(sourceStr) {
+    return (/from\s+fastapi\s+import/.test(sourceStr) ||
+        /import\s+fastapi\b/.test(sourceStr));
+}
+// ─── Route extraction ─────────────────────────────────────────────────────────
+function extractFastApiRoutes(sourceStr, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    const methodPattern = HTTP_METHODS.join('|');
+    // Match: @identifier.get('/path') / @identifier.post('/path') etc.
+    const routeRe = new RegExp(`^[ \\t]*@([\\w]+)\\.(${methodPattern})\\s*\\(\\s*(['"])([^'"]+)\\3`, 'gm');
+    let m;
+    while ((m = routeRe.exec(sourceStr)) !== null) {
+        const varName = m[1];
+        const method = m[2];
+        const rawPath = m[4];
+        const normPath = normalisePath(rawPath);
+        const routeName = `${method.toUpperCase()} ${normPath}`;
+        if (seen.has(routeName))
+            continue;
+        seen.add(routeName);
+        symbols.push({
+            id: makeId(filePath, routeName, 'route'),
+            name: routeName,
+            kind: 'route',
+            filePath,
+            startByte: 0,
+            endByte: 0,
+            signature: `@${varName}.${method}('${rawPath}', ...)`,
+            summary: `FastAPI route: ${routeName}`,
+            frameworkMeta: {
+                http_method: method.toUpperCase(),
+                route_path: rawPath,
+                fastapi_route: true,
+            },
+        });
+    }
+    return symbols;
+}
+// ─── FastAPI adapter ──────────────────────────────────────────────────────────
+export const fastapiAdapter = {
+    name: 'fastapi',
+    extensions: () => [],
+    async detect(projectRoot) {
+        // Check requirements.txt
+        try {
+            const req = readFileSync(join(projectRoot, 'requirements.txt'), 'utf8');
+            if (/^\s*fastapi\b/im.test(req))
+                return true;
+        }
+        catch { /* file absent */ }
+        // Check pyproject.toml
+        try {
+            const toml = readFileSync(join(projectRoot, 'pyproject.toml'), 'utf8');
+            if (/["']fastapi\b/i.test(toml))
+                return true;
+        }
+        catch { /* file absent */ }
+        return false;
+    },
+    fileFilter: (filePath) => filePath.endsWith('.py'),
+    extractFrameworkSymbols(_tree, source, filePath) {
+        const sourceStr = source.toString('utf8');
+        // Quick guard — skip files that don't import FastAPI
+        if (!hasFastApiImport(sourceStr))
+            return [];
+        return extractFastApiRoutes(sourceStr, filePath);
+    },
+    enrichMetadata(symbol) {
+        return symbol;
+    },
+};
+// ─── Self-registration ────────────────────────────────────────────────────────
+registerAdapter(fastapiAdapter);
+logger.debug("Adapter 'fastapi' registered");
+//# sourceMappingURL=fastapi.js.map

package/dist/adapters/fastapi.js.map

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

package/dist/adapters/fastify.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Fastify framework adapter.
+ *
+ * Extracts route symbols from Fastify procedural route definitions.
+ * Only extracts routes with string literal paths.
+ *
+ * Patterns recognised:
+ *   fastify.get('/path', handler)
+ *   fastify.post('/path', handler)
+ *   fastify.register(plugin, { prefix: '/api' }) → kind 'middleware'
+ */
+import type { FrameworkAdapter } from '../core/types.js';
+export declare const fastifyAdapter: FrameworkAdapter;
+//# sourceMappingURL=fastify.d.ts.map

package/dist/adapters/fastify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastify.d.ts","sourceRoot":"","sources":["../../src/adapters/fastify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,kBAAkB,CAAC;AA8G7E,eAAO,MAAM,cAAc,EAAE,gBAsC5B,CAAC"}

package/dist/adapters/fastify.js

@@ -0,0 +1,124 @@
+/**
+ * Fastify framework adapter.
+ *
+ * Extracts route symbols from Fastify procedural route definitions.
+ * Only extracts routes with string literal paths.
+ *
+ * Patterns recognised:
+ *   fastify.get('/path', handler)
+ *   fastify.post('/path', handler)
+ *   fastify.register(plugin, { prefix: '/api' }) → kind 'middleware'
+ */
+import { createHash } from 'crypto';
+import { readFileSync } from 'fs';
+import { registerAdapter } from './adapter-registry.js';
+import { logger } from '../core/logger.js';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function makeId(filePath, name, kind) {
+    return createHash('sha256')
+        .update(`${filePath}:${name}:${kind}`)
+        .digest('hex')
+        .slice(0, 16);
+}
+const HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+// ─── Route extraction ─────────────────────────────────────────────────────────
+/**
+ * Heuristic: check if source uses Fastify.
+ */
+function hasFastifySetup(sourceStr) {
+    return (/\bfastify\s*\(\s*\)/.test(sourceStr) ||
+        /require\s*\(\s*['"]fastify['"]\s*\)/.test(sourceStr) ||
+        /from\s+['"]fastify['"]/.test(sourceStr) ||
+        /\bFastify\s*\(\s*\)/.test(sourceStr));
+}
+/**
+ * Extract Fastify route symbols from source text.
+ */
+function extractFastifyRoutes(sourceStr, filePath) {
+    const symbols = [];
+    const methodPattern = HTTP_METHODS.join('|');
+    // Match: identifier.method('/path', ...) where identifier looks like a Fastify instance
+    const routeRe = new RegExp(`\\b(\\w+)\\.(${methodPattern})\\s*\\(\\s*(['"\`])([^'"\`]+)\\3`, 'g');
+    let m;
+    while ((m = routeRe.exec(sourceStr)) !== null) {
+        const varName = m[1];
+        const method = m[2];
+        const path = m[4];
+        // Only Fastify-like variable names
+        if (!['fastify', 'server', 'app', 'instance'].includes(varName) &&
+            !varName.toLowerCase().includes('fastify')) {
+            continue;
+        }
+        const httpMethod = method.toUpperCase();
+        const routeName = `${httpMethod} ${path}`;
+        if (!symbols.some((s) => s.name === routeName)) {
+            symbols.push({
+                id: makeId(filePath, routeName, 'route'),
+                name: routeName,
+                kind: 'route',
+                filePath,
+                startByte: 0,
+                endByte: 0,
+                signature: `${varName}.${method}('${path}', ...)`,
+                summary: `Fastify route: ${routeName}`,
+                frameworkMeta: { http_method: httpMethod, http_framework: 'fastify' },
+            });
+        }
+    }
+    // Match fastify.register(plugin, { prefix: '/api' })
+    const registerRe = /\b(\w+)\.register\s*\([^,]+,\s*\{[^}]*prefix\s*:\s*(['"`])([^'"`]+)\2/g;
+    let regMatch;
+    while ((regMatch = registerRe.exec(sourceStr)) !== null) {
+        const varName = regMatch[1];
+        const prefix = regMatch[3];
+        if (!['fastify', 'server', 'app', 'instance'].includes(varName) &&
+            !varName.toLowerCase().includes('fastify')) {
+            continue;
+        }
+        const routeName = `PLUGIN ${prefix}`;
+        if (!symbols.some((s) => s.name === routeName)) {
+            symbols.push({
+                id: makeId(filePath, routeName, 'middleware'),
+                name: routeName,
+                kind: 'middleware',
+                filePath,
+                startByte: 0,
+                endByte: 0,
+                signature: `${varName}.register(plugin, { prefix: '${prefix}' })`,
+                summary: `Fastify plugin with prefix: ${prefix}`,
+                frameworkMeta: { http_framework: 'fastify', route_prefix: prefix },
+            });
+        }
+    }
+    return symbols;
+}
+// ─── Fastify adapter ──────────────────────────────────────────────────────────
+export const fastifyAdapter = {
+    name: 'fastify',
+    extensions: () => [],
+    async detect(projectRoot) {
+        try {
+            const raw = readFileSync(`${projectRoot}/package.json`, 'utf8');
+            const pkg = JSON.parse(raw);
+            const deps = Object.assign({}, pkg['dependencies'], pkg['devDependencies']);
+            return 'fastify' in deps || '@fastify/core' in deps;
+        }
+        catch {
+            return false;
+        }
+    },
+    fileFilter: (filePath) => filePath.endsWith('.ts') || filePath.endsWith('.js'),
+    extractFrameworkSymbols(_tree, source, filePath) {
+        const sourceStr = source.toString('utf8');
+        if (!hasFastifySetup(sourceStr))
+            return [];
+        return extractFastifyRoutes(sourceStr, filePath);
+    },
+    enrichMetadata(symbol) {
+        return symbol;
+    },
+};
+// ─── Self-registration ────────────────────────────────────────────────────────
+registerAdapter(fastifyAdapter);
+logger.debug("Adapter 'fastify' registered");
+//# sourceMappingURL=fastify.js.map

package/dist/adapters/fastify.js.map

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

package/dist/adapters/fiber.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Fiber framework adapter (Go).
+ *
+ * Extracts route and middleware symbols from Fiber web framework applications.
+ * Fiber's API mirrors Express.js but uses title-case method names (Get, Post, …).
+ *
+ * Patterns recognised:
+ *   app.Get("/path", handler)     → route
+ *   app.Post("/path", h)          → route
+ *   grp := app.Group("/api")      → group prefix (applied to child routes)
+ *   app.Use(authMiddleware)       → middleware
+ */
+import type { FrameworkAdapter } from '../core/types.js';
+export declare const fiberAdapter: FrameworkAdapter;
+//# sourceMappingURL=fiber.d.ts.map

package/dist/adapters/fiber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fiber.d.ts","sourceRoot":"","sources":["../../src/adapters/fiber.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,kBAAkB,CAAC;AA6H7E,eAAO,MAAM,YAAY,EAAE,gBAkC1B,CAAC"}

package/dist/adapters/fiber.js

@@ -0,0 +1,147 @@
+/**
+ * Fiber framework adapter (Go).
+ *
+ * Extracts route and middleware symbols from Fiber web framework applications.
+ * Fiber's API mirrors Express.js but uses title-case method names (Get, Post, …).
+ *
+ * Patterns recognised:
+ *   app.Get("/path", handler)     → route
+ *   app.Post("/path", h)          → route
+ *   grp := app.Group("/api")      → group prefix (applied to child routes)
+ *   app.Use(authMiddleware)       → middleware
+ */
+import { createHash } from 'crypto';
+import { readFileSync } from 'fs';
+import { join } from 'path';
+import { registerAdapter } from './adapter-registry.js';
+import { logger } from '../core/logger.js';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function makeId(filePath, name, kind) {
+    return createHash('sha256')
+        .update(`${filePath}:${name}:${kind}`)
+        .digest('hex')
+        .slice(0, 16);
+}
+// Fiber uses title-case method names
+const FIBER_METHODS_TITLECASE = ['Get', 'Post', 'Put', 'Patch', 'Delete', 'Head', 'Options', 'All'];
+// Normalised uppercase equivalents for route name output
+const FIBER_METHOD_NORM = {
+    Get: 'GET', Post: 'POST', Put: 'PUT', Patch: 'PATCH',
+    Delete: 'DELETE', Head: 'HEAD', Options: 'OPTIONS', All: 'ALL',
+};
+function hasFiberImport(sourceStr) {
+    return /["']github\.com\/gofiber\/fiber/.test(sourceStr);
+}
+/**
+ * Heuristic: does this variable name look like a Fiber app/group?
+ */
+function looksLikeFiberApp(name) {
+    const KNOWN = new Set(['app', 'fiber', 'server', 'srv', 'api']);
+    if (KNOWN.has(name))
+        return true;
+    if (name.endsWith('Router') ||
+        name.endsWith('Group') ||
+        name.endsWith('Api') ||
+        name.endsWith('API') ||
+        /^v\d+$/.test(name))
+        return true;
+    return false;
+}
+// ─── Route extraction ─────────────────────────────────────────────────────────
+function extractFiberRoutes(sourceStr, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    const methodPattern = FIBER_METHODS_TITLECASE.join('|');
+    // Fiber uses title-case: app.Get(…), app.Post(…)
+    const routeRe = new RegExp(`\\b(\\w+)\\.(${methodPattern})\\s*\\(\\s*(["'])([^"']+)\\3`, 'g');
+    let m;
+    while ((m = routeRe.exec(sourceStr)) !== null) {
+        const varName = m[1];
+        const method = m[2];
+        const path = m[4];
+        if (!looksLikeFiberApp(varName))
+            continue;
+        const normMethod = FIBER_METHOD_NORM[method] ?? method.toUpperCase();
+        const routeName = `${normMethod} ${path}`;
+        if (seen.has(routeName))
+            continue;
+        seen.add(routeName);
+        symbols.push({
+            id: makeId(filePath, routeName, 'route'),
+            name: routeName,
+            kind: 'route',
+            filePath,
+            startByte: 0,
+            endByte: 0,
+            signature: `${varName}.${method}("${path}", ...)`,
+            summary: `Fiber route: ${routeName}`,
+            frameworkMeta: {
+                http_method: normMethod,
+                route_path: path,
+                fiber_route: true,
+            },
+        });
+    }
+    return symbols;
+}
+// ─── Middleware extraction ────────────────────────────────────────────────────
+function extractFiberMiddleware(sourceStr, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    const useRe = /\b(\w+)\.Use\s*\(\s*(\w+)/g;
+    let m;
+    while ((m = useRe.exec(sourceStr)) !== null) {
+        const varName = m[1];
+        const mwName = m[2];
+        if (!looksLikeFiberApp(varName))
+            continue;
+        if (['func', 'fiber', 'middleware', 'recover', 'logger'].includes(mwName))
+            continue;
+        if (seen.has(mwName))
+            continue;
+        seen.add(mwName);
+        symbols.push({
+            id: makeId(filePath, mwName, 'middleware'),
+            name: mwName,
+            kind: 'middleware',
+            filePath,
+            startByte: 0,
+            endByte: 0,
+            signature: `${varName}.Use(${mwName})`,
+            summary: `Fiber middleware: ${mwName}`,
+            frameworkMeta: { fiber_middleware: true },
+        });
+    }
+    return symbols;
+}
+// ─── Fiber adapter ────────────────────────────────────────────────────────────
+export const fiberAdapter = {
+    name: 'fiber',
+    extensions: () => [],
+    async detect(projectRoot) {
+        try {
+            const goMod = readFileSync(join(projectRoot, 'go.mod'), 'utf8');
+            return goMod.includes('github.com/gofiber/fiber');
+        }
+        catch {
+            return false;
+        }
+    },
+    fileFilter: (filePath) => filePath.endsWith('.go'),
+    extractFrameworkSymbols(_tree, source, filePath) {
+        const sourceStr = source.toString('utf8');
+        if (!hasFiberImport(sourceStr))
+            return [];
+        return [
+            ...extractFiberRoutes(sourceStr, filePath),
+            ...extractFiberMiddleware(sourceStr, filePath),
+        ];
+    },
+    enrichMetadata(symbol) {
+        return symbol;
+    },
+};
+// ─── Self-registration ────────────────────────────────────────────────────────
+registerAdapter(fiberAdapter);
+logger.debug("Adapter 'fiber' registered");
+//# sourceMappingURL=fiber.js.map

package/dist/adapters/fiber.js.map

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

package/dist/adapters/flask.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Flask framework adapter.
+ *
+ * Extracts route symbols from Flask applications by scanning for decorator
+ * patterns on view functions. Only extracts routes where the path is a string
+ * literal inside the decorator.
+ *
+ * Patterns recognised:
+ *   @app.route('/path')                        → GET /path (default)
+ *   @app.route('/path', methods=['GET','POST']) → GET /path + POST /path
+ *   @app.get('/path')                          → GET /path
+ *   @app.post('/path')                         → POST /path
+ *   @bp.route('/path')                         → GET /path  (Blueprint)
+ *   class MyView(MethodView): ...              → view symbol
+ */
+import type { FrameworkAdapter } from '../core/types.js';
+export declare const flaskAdapter: FrameworkAdapter;
+//# sourceMappingURL=flask.d.ts.map

package/dist/adapters/flask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flask.d.ts","sourceRoot":"","sources":["../../src/adapters/flask.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,kBAAkB,CAAC;AA8I7E,eAAO,MAAM,YAAY,EAAE,gBA0C1B,CAAC"}

package/dist/adapters/flask.js

@@ -0,0 +1,175 @@
+/**
+ * Flask framework adapter.
+ *
+ * Extracts route symbols from Flask applications by scanning for decorator
+ * patterns on view functions. Only extracts routes where the path is a string
+ * literal inside the decorator.
+ *
+ * Patterns recognised:
+ *   @app.route('/path')                        → GET /path (default)
+ *   @app.route('/path', methods=['GET','POST']) → GET /path + POST /path
+ *   @app.get('/path')                          → GET /path
+ *   @app.post('/path')                         → POST /path
+ *   @bp.route('/path')                         → GET /path  (Blueprint)
+ *   class MyView(MethodView): ...              → view symbol
+ */
+import { createHash } from 'crypto';
+import { readFileSync } from 'fs';
+import { join } from 'path';
+import { registerAdapter } from './adapter-registry.js';
+import { logger } from '../core/logger.js';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function makeId(filePath, name, kind) {
+    return createHash('sha256')
+        .update(`${filePath}:${name}:${kind}`)
+        .digest('hex')
+        .slice(0, 16);
+}
+const HTTP_METHODS = ['get', 'post', 'put', 'patch', 'delete', 'head', 'options'];
+/**
+ * Normalise Flask path parameters from <type:name> / <name> to :name.
+ * e.g. /users/<int:user_id> → /users/:user_id
+ *      /posts/<slug>        → /posts/:slug
+ */
+function normalisePath(path) {
+    return path.replace(/<(?:[a-zA-Z_][a-zA-Z0-9_]*:)?([a-zA-Z_][a-zA-Z0-9_]*)>/g, ':$1');
+}
+/**
+ * Return true if source file imports Flask (classic or factory pattern).
+ */
+function hasFlaskImport(sourceStr) {
+    return (/from\s+flask\s+import/.test(sourceStr) ||
+        /import\s+flask\b/.test(sourceStr));
+}
+/**
+ * Extract HTTP methods from a `methods=[...]` keyword argument string.
+ * e.g. "methods=['GET', 'POST']" → ['GET', 'POST']
+ * Returns null if no methods argument is found (caller should use default).
+ */
+function extractMethods(decoratorArgs) {
+    const m = decoratorArgs.match(/methods\s*=\s*\[([^\]]*)\]/);
+    if (!m)
+        return null;
+    const methods = [];
+    const inner = m[1];
+    for (const match of inner.matchAll(/['"]([A-Za-z]+)['"]/g)) {
+        methods.push(match[1].toUpperCase());
+    }
+    return methods.length > 0 ? methods : null;
+}
+// ─── Route extraction ─────────────────────────────────────────────────────────
+function extractFlaskRoutes(sourceStr, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    function addRoute(httpMethod, rawPath, varName, decoratorLine) {
+        const normPath = normalisePath(rawPath);
+        const routeName = `${httpMethod.toUpperCase()} ${normPath}`;
+        if (seen.has(routeName))
+            return;
+        seen.add(routeName);
+        symbols.push({
+            id: makeId(filePath, routeName, 'route'),
+            name: routeName,
+            kind: 'route',
+            filePath,
+            startByte: 0,
+            endByte: 0,
+            signature: `@${varName}.${httpMethod}('${rawPath}', ...)`,
+            summary: `Flask route: ${routeName}`,
+            frameworkMeta: {
+                http_method: httpMethod.toUpperCase(),
+                route_path: rawPath,
+                flask_route: true,
+                decorator: decoratorLine.trim().slice(0, 80),
+            },
+        });
+    }
+    // Pattern 1: @identifier.route('/path', ...)
+    // Captures: (varName, path, rest-of-args-on-same-line)
+    const routeRe = /^[ \t]*@([\w]+)\.route\s*\(\s*(['"])([^'"]+)\2([^)]*)\)/gm;
+    let m;
+    while ((m = routeRe.exec(sourceStr)) !== null) {
+        const varName = m[1];
+        const rawPath = m[3];
+        const rest = m[4];
+        const fullDecorator = m[0];
+        const methods = extractMethods(rest);
+        for (const method of (methods ?? ['GET'])) {
+            addRoute(method, rawPath, varName, fullDecorator);
+        }
+    }
+    // Pattern 2: @identifier.get('/path') / .post() / etc.
+    const methodPattern = HTTP_METHODS.join('|');
+    const shorthandRe = new RegExp(`^[ \\t]*@([\\w]+)\\.(${methodPattern})\\s*\\(\\s*(['"])([^'"]+)\\3`, 'gm');
+    while ((m = shorthandRe.exec(sourceStr)) !== null) {
+        const varName = m[1];
+        const method = m[2];
+        const rawPath = m[4];
+        addRoute(method, rawPath, varName, m[0]);
+    }
+    return symbols;
+}
+/**
+ * Extract class-based view symbols (MethodView / View subclasses).
+ */
+function extractClassViews(sourceStr, filePath) {
+    const symbols = [];
+    // Match: class Name(MethodView): or class Name(View):
+    const re = /^class\s+(\w+)\s*\([^)]*(?:MethodView|View)[^)]*\)\s*:/gm;
+    let m;
+    while ((m = re.exec(sourceStr)) !== null) {
+        const name = m[1];
+        symbols.push({
+            id: makeId(filePath, name, 'view'),
+            name,
+            kind: 'view',
+            filePath,
+            startByte: 0,
+            endByte: 0,
+            signature: m[0].trim(),
+            summary: `Flask class-based view: ${name}`,
+            frameworkMeta: { flask_class_view: true },
+        });
+    }
+    return symbols;
+}
+// ─── Flask adapter ────────────────────────────────────────────────────────────
+export const flaskAdapter = {
+    name: 'flask',
+    extensions: () => [],
+    async detect(projectRoot) {
+        // Check requirements.txt
+        try {
+            const req = readFileSync(join(projectRoot, 'requirements.txt'), 'utf8');
+            if (/^\s*[Ff]lask\s*([>=<!]|$)/m.test(req))
+                return true;
+        }
+        catch { /* file absent */ }
+        // Check pyproject.toml
+        try {
+            const toml = readFileSync(join(projectRoot, 'pyproject.toml'), 'utf8');
+            if (/["']flask\b/i.test(toml))
+                return true;
+        }
+        catch { /* file absent */ }
+        return false;
+    },
+    fileFilter: (filePath) => filePath.endsWith('.py'),
+    extractFrameworkSymbols(_tree, source, filePath) {
+        const sourceStr = source.toString('utf8');
+        // Quick guard — skip files that don't import Flask
+        if (!hasFlaskImport(sourceStr))
+            return [];
+        return [
+            ...extractFlaskRoutes(sourceStr, filePath),
+            ...extractClassViews(sourceStr, filePath),
+        ];
+    },
+    enrichMetadata(symbol) {
+        return symbol;
+    },
+};
+// ─── Self-registration ────────────────────────────────────────────────────────
+registerAdapter(flaskAdapter);
+logger.debug("Adapter 'flask' registered");
+//# sourceMappingURL=flask.js.map