purecontext-mcp 1.0.1

package/dist/adapters/django.js

@@ -0,0 +1,257 @@
+/**
+ * Django framework adapter.
+ *
+ * Extracts model, view, route, and signal symbols from Django applications
+ * using regex pattern scanning on Python source text.
+ *
+ * Patterns recognised:
+ *   class User(models.Model):                      → model
+ *   class UserListView(APIView):                   → view (CBV)
+ *   @login_required / @api_view([...])             → view (FBV)
+ *   path('/users/', ...) in urls.py                → route
+ *   @receiver(post_save, sender=User)              → signal
+ */
+import { createHash } from 'crypto';
+import { readFileSync, existsSync } from 'fs';
+import { join, basename } 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);
+}
+function hasDjangoImport(sourceStr) {
+    return (/from\s+django\b/.test(sourceStr) ||
+        /import\s+django\b/.test(sourceStr) ||
+        /from\s+rest_framework\b/.test(sourceStr));
+}
+// ─── Model extraction ─────────────────────────────────────────────────────────
+// Base classes that indicate a Django ORM model
+const MODEL_BASES = [
+    'models\\.Model',
+    'Model',
+    'BaseModel', // DRF / Pydantic style (common pattern)
+    'MPTTModel', // django-mptt
+    'TimeStampedModel', // django-extensions
+    'AbstractUser',
+    'AbstractBaseUser',
+].join('|');
+const MODEL_RE = new RegExp(`^class\\s+(\\w+)\\s*\\(([^)]*(?:${MODEL_BASES})[^)]*)\\)\\s*:`, 'gm');
+function extractModels(sourceStr, filePath) {
+    const symbols = [];
+    MODEL_RE.lastIndex = 0;
+    let m;
+    while ((m = MODEL_RE.exec(sourceStr)) !== null) {
+        const name = m[1];
+        symbols.push({
+            id: makeId(filePath, name, 'model'),
+            name,
+            kind: 'model',
+            filePath,
+            startByte: 0,
+            endByte: 0,
+            signature: m[0].trim(),
+            summary: `Django model: ${name}`,
+            frameworkMeta: { django_model: true },
+        });
+    }
+    return symbols;
+}
+// ─── View extraction ──────────────────────────────────────────────────────────
+// Class-based view base classes
+const CBV_BASES = [
+    'View',
+    'TemplateView',
+    'RedirectView',
+    'ListView',
+    'DetailView',
+    'CreateView',
+    'UpdateView',
+    'DeleteView',
+    'FormView',
+    'APIView',
+    'ModelViewSet',
+    'ReadOnlyModelViewSet',
+    'ViewSet',
+    'GenericAPIView',
+    'ListAPIView',
+    'CreateAPIView',
+    'RetrieveAPIView',
+    'UpdateAPIView',
+    'DestroyAPIView',
+    'ListCreateAPIView',
+    'RetrieveUpdateAPIView',
+    'RetrieveDestroyAPIView',
+    'RetrieveUpdateDestroyAPIView',
+].join('|');
+const CBV_RE = new RegExp(`^class\\s+(\\w+)\\s*\\(([^)]*(?:${CBV_BASES})[^)]*)\\)\\s*:`, 'gm');
+// FBV decorators that mark a function as a view
+const FBV_DECORATOR_RE = /^[ \t]*@(?:login_required|permission_required|api_view|staff_member_required|user_passes_test)\s*[(\n]/gm;
+function extractViews(sourceStr, filePath) {
+    const symbols = [];
+    // Class-based views
+    CBV_RE.lastIndex = 0;
+    let m;
+    while ((m = CBV_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: `Django CBV: ${name}`,
+            frameworkMeta: { django_cbv: true },
+        });
+    }
+    // Function-based views — find decorated functions
+    FBV_DECORATOR_RE.lastIndex = 0;
+    while ((m = FBV_DECORATOR_RE.exec(sourceStr)) !== null) {
+        // Find the `def name(` on the next non-decorator, non-blank line
+        const rest = sourceStr.slice(m.index + m[0].length);
+        const fnMatch = rest.match(/(?:^|\n)[ \t]*(?:@\w[^\n]*\n)*[ \t]*(?:async\s+)?def\s+(\w+)\s*\(/);
+        if (!fnMatch)
+            continue;
+        const name = fnMatch[1];
+        // Avoid duplicates
+        if (!symbols.some((s) => s.name === name && s.kind === 'view')) {
+            symbols.push({
+                id: makeId(filePath, name, 'view'),
+                name,
+                kind: 'view',
+                filePath,
+                startByte: 0,
+                endByte: 0,
+                signature: `def ${name}(request, ...)`,
+                summary: `Django FBV: ${name}`,
+                frameworkMeta: { django_fbv: true },
+            });
+        }
+    }
+    return symbols;
+}
+// ─── URL pattern extraction ───────────────────────────────────────────────────
+/**
+ * Normalise Django URL path to :param format.
+ * e.g.  <int:pk>  → :pk
+ *       <slug>    → :slug
+ *       (?P<pk>\d+) (re_path) → :pk
+ */
+function normaliseUrlPath(path) {
+    // Django 2+ angle-bracket params: <type:name> or <name>
+    let result = path.replace(/<(?:[a-zA-Z_][a-zA-Z0-9_]*:)?([a-zA-Z_][a-zA-Z0-9_]*)>/g, ':$1');
+    // Legacy regex named groups: (?P<name>...)
+    result = result.replace(/\(\?P<([^>]+)>[^)]*\)/g, ':$1');
+    return result;
+}
+// Match path(...), re_path(...), url(...) at module level or inside urlpatterns
+const URL_PATTERN_RE = /\b(?:path|re_path|url)\s*\(\s*r?(['"])([^'"]*)\1\s*,/g;
+function extractUrlPatterns(sourceStr, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    URL_PATTERN_RE.lastIndex = 0;
+    let m;
+    while ((m = URL_PATTERN_RE.exec(sourceStr)) !== null) {
+        const rawPath = m[2];
+        const normPath = normaliseUrlPath(rawPath);
+        const routeName = 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: m[0].trim().slice(0, 100),
+            summary: `Django URL: ${routeName}`,
+            frameworkMeta: {
+                django_url_pattern: true,
+                route_path: rawPath,
+            },
+        });
+    }
+    return symbols;
+}
+// ─── Signal extraction ────────────────────────────────────────────────────────
+const SIGNAL_RE = /^[ \t]*@receiver\s*\(\s*(\w[\w.]*)\s*(?:,|\))[^\n]*\n(?:[ \t]*@[^\n]+\n)*[ \t]*(?:async\s+)?def\s+(\w+)\s*\(/gm;
+function extractSignals(sourceStr, filePath) {
+    const symbols = [];
+    SIGNAL_RE.lastIndex = 0;
+    let m;
+    while ((m = SIGNAL_RE.exec(sourceStr)) !== null) {
+        const signal = m[1];
+        const name = m[2];
+        symbols.push({
+            id: makeId(filePath, name, 'signal'),
+            name,
+            kind: 'signal',
+            filePath,
+            startByte: 0,
+            endByte: 0,
+            signature: `@receiver(${signal}) def ${name}(...)`,
+            summary: `Django signal receiver: ${name} (${signal})`,
+            frameworkMeta: { django_signal: true, signal_type: signal },
+        });
+    }
+    return symbols;
+}
+// ─── Django adapter ───────────────────────────────────────────────────────────
+export const djangoAdapter = {
+    name: 'django',
+    extensions: () => [],
+    async detect(projectRoot) {
+        // manage.py at project root is the canonical Django marker
+        if (existsSync(join(projectRoot, 'manage.py')))
+            return true;
+        try {
+            const req = readFileSync(join(projectRoot, 'requirements.txt'), 'utf8');
+            if (/^\s*[Dd]jango\b/m.test(req))
+                return true;
+        }
+        catch { /* absent */ }
+        try {
+            const toml = readFileSync(join(projectRoot, 'pyproject.toml'), 'utf8');
+            if (/["']django\b/i.test(toml))
+                return true;
+        }
+        catch { /* absent */ }
+        return false;
+    },
+    fileFilter: (filePath) => {
+        if (!filePath.endsWith('.py'))
+            return false;
+        const base = filePath.split('/').pop();
+        return base !== 'manage.py';
+    },
+    extractFrameworkSymbols(_tree, source, filePath) {
+        const sourceStr = source.toString('utf8');
+        if (!hasDjangoImport(sourceStr))
+            return [];
+        const symbols = [
+            ...extractModels(sourceStr, filePath),
+            ...extractViews(sourceStr, filePath),
+            ...extractSignals(sourceStr, filePath),
+        ];
+        // URL patterns only from urls.py files
+        const fileName = basename(filePath);
+        if (fileName === 'urls.py' || filePath.endsWith('/urls.py')) {
+            symbols.push(...extractUrlPatterns(sourceStr, filePath));
+        }
+        return symbols;
+    },
+    enrichMetadata(symbol) {
+        return symbol;
+    },
+};
+// ─── Self-registration ────────────────────────────────────────────────────────
+registerAdapter(djangoAdapter);
+logger.debug("Adapter 'django' registered");
+//# sourceMappingURL=django.js.map

package/dist/adapters/django.js.map

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

package/dist/adapters/echo.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Echo framework adapter (Go).
+ *
+ * Extracts route and middleware symbols from Echo web framework applications
+ * by regex-scanning Go source files for router method calls.
+ *
+ * Patterns recognised:
+ *   e.GET("/path", handler)       → route
+ *   e.POST("/path", h)            → route
+ *   g := e.Group("/api")          → group prefix (applied to child routes)
+ *   e.Use(middleware.Logger())    → middleware
+ */
+import type { FrameworkAdapter } from '../core/types.js';
+export declare const echoAdapter: FrameworkAdapter;
+//# sourceMappingURL=echo.d.ts.map

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

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

package/dist/adapters/echo.js

@@ -0,0 +1,142 @@
+/**
+ * Echo framework adapter (Go).
+ *
+ * Extracts route and middleware symbols from Echo web framework applications
+ * by regex-scanning Go source files for router method calls.
+ *
+ * Patterns recognised:
+ *   e.GET("/path", handler)       → route
+ *   e.POST("/path", h)            → route
+ *   g := e.Group("/api")          → group prefix (applied to child routes)
+ *   e.Use(middleware.Logger())    → 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);
+}
+// Echo HTTP method names are uppercase (same as Gin)
+const ECHO_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS', 'Any'];
+function hasEchoImport(sourceStr) {
+    return /["']github\.com\/labstack\/echo/.test(sourceStr);
+}
+/**
+ * Heuristic: does this variable name look like an Echo instance/group?
+ */
+function looksLikeEchoRouter(name) {
+    const KNOWN = new Set(['e', 'echo', 'server', 'srv', 'app', 'api', 'g']);
+    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 extractEchoRoutes(sourceStr, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    const methodPattern = ECHO_METHODS.join('|');
+    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 (!looksLikeEchoRouter(varName))
+            continue;
+        const routeName = method === 'Any' ? `ANY ${path}` : `${method} ${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: `Echo route: ${routeName}`,
+            frameworkMeta: {
+                http_method: method === 'Any' ? 'ANY' : method,
+                route_path: path,
+                echo_route: true,
+            },
+        });
+    }
+    return symbols;
+}
+// ─── Middleware extraction ────────────────────────────────────────────────────
+function extractEchoMiddleware(sourceStr, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    // Match: identifier.Use(SomeName) or identifier.Use(pkg.SomeName())
+    // Capture the first token (function or package) as the middleware name
+    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 (!looksLikeEchoRouter(varName))
+            continue;
+        if (['func', 'echo', 'middleware'].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: `Echo middleware: ${mwName}`,
+            frameworkMeta: { echo_middleware: true },
+        });
+    }
+    return symbols;
+}
+// ─── Echo adapter ─────────────────────────────────────────────────────────────
+export const echoAdapter = {
+    name: 'echo',
+    extensions: () => [],
+    async detect(projectRoot) {
+        try {
+            const goMod = readFileSync(join(projectRoot, 'go.mod'), 'utf8');
+            return goMod.includes('github.com/labstack/echo');
+        }
+        catch {
+            return false;
+        }
+    },
+    fileFilter: (filePath) => filePath.endsWith('.go'),
+    extractFrameworkSymbols(_tree, source, filePath) {
+        const sourceStr = source.toString('utf8');
+        if (!hasEchoImport(sourceStr))
+            return [];
+        return [
+            ...extractEchoRoutes(sourceStr, filePath),
+            ...extractEchoMiddleware(sourceStr, filePath),
+        ];
+    },
+    enrichMetadata(symbol) {
+        return symbol;
+    },
+};
+// ─── Self-registration ────────────────────────────────────────────────────────
+registerAdapter(echoAdapter);
+logger.debug("Adapter 'echo' registered");
+//# sourceMappingURL=echo.js.map

package/dist/adapters/echo.js.map

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

package/dist/adapters/express.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Express framework adapter.
+ *
+ * Extracts route symbols from Express procedural route definitions.
+ * Only extracts routes with string literal paths (not dynamic constructions).
+ *
+ * Patterns recognised:
+ *   app.get('/path', handler)
+ *   app.post('/path', handler)
+ *   router.get('/path', handler)
+ *   app.use('/path', middleware) → kind 'middleware'
+ */
+import type { FrameworkAdapter } from '../core/types.js';
+export declare const expressAdapter: FrameworkAdapter;
+//# sourceMappingURL=express.d.ts.map

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

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

package/dist/adapters/express.js

@@ -0,0 +1,126 @@
+/**
+ * Express framework adapter.
+ *
+ * Extracts route symbols from Express procedural route definitions.
+ * Only extracts routes with string literal paths (not dynamic constructions).
+ *
+ * Patterns recognised:
+ *   app.get('/path', handler)
+ *   app.post('/path', handler)
+ *   router.get('/path', handler)
+ *   app.use('/path', middleware) → 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 the source declares an Express app or router.
+ * Returns true if `express()` or `express.Router()` is called.
+ */
+function hasExpressSetup(sourceStr) {
+    return (/\bexpress\s*\(\s*\)/.test(sourceStr) ||
+        /\bexpress\.Router\s*\(\s*\)/.test(sourceStr) ||
+        /require\s*\(\s*['"]express['"]\s*\)/.test(sourceStr) ||
+        /from\s+['"]express['"]/.test(sourceStr));
+}
+/**
+ * Extract Express route symbols from source text.
+ * Only extracts routes where the path is a string literal.
+ */
+function extractExpressRoutes(sourceStr, filePath) {
+    const symbols = [];
+    // Match: identifier.method('path', ...) where method is an HTTP verb or 'use'
+    // The identifier can be app, router, or any variable that assigned express()/Router()
+    const allMethods = [...HTTP_METHODS, 'use'];
+    const methodPattern = allMethods.join('|');
+    // Regex: \w+.(get|post|...)('/path', ...) with string literal path
+    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];
+        // Heuristic: skip if this doesn't look like Express usage
+        // Allow common Express variable names
+        if (!['app', 'router', 'server', 'api', 'v1', 'v2'].includes(varName) &&
+            !varName.endsWith('Router') &&
+            !varName.endsWith('App')) {
+            continue;
+        }
+        if (method === 'use') {
+            const routeName = `MW ${path}`;
+            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}.use('${path}', ...)`,
+                    summary: `Express middleware: ${path}`,
+                    frameworkMeta: { http_framework: 'express', prefix_unknown: true },
+                });
+            }
+        }
+        else {
+            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: `Express route: ${routeName}`,
+                    frameworkMeta: { http_method: httpMethod, http_framework: 'express' },
+                });
+            }
+        }
+    }
+    return symbols;
+}
+// ─── Express adapter ──────────────────────────────────────────────────────────
+export const expressAdapter = {
+    name: 'express',
+    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 'express' in deps;
+        }
+        catch {
+            return false;
+        }
+    },
+    fileFilter: (filePath) => filePath.endsWith('.ts') || filePath.endsWith('.js'),
+    extractFrameworkSymbols(_tree, source, filePath) {
+        const sourceStr = source.toString('utf8');
+        // Quick check — skip files that don't look like Express
+        if (!hasExpressSetup(sourceStr))
+            return [];
+        return extractExpressRoutes(sourceStr, filePath);
+    },
+    enrichMetadata(symbol) {
+        return symbol;
+    },
+};
+// ─── Self-registration ────────────────────────────────────────────────────────
+registerAdapter(expressAdapter);
+logger.debug("Adapter 'express' registered");
+//# sourceMappingURL=express.js.map

package/dist/adapters/express.js.map

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

package/dist/adapters/fastapi.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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 type { FrameworkAdapter } from '../core/types.js';
+export declare const fastapiAdapter: FrameworkAdapter;
+//# sourceMappingURL=fastapi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fastapi.d.ts","sourceRoot":"","sources":["../../src/adapters/fastapi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,kBAAkB,CAAC;AAiF7E,eAAO,MAAM,cAAc,EAAE,gBAuC5B,CAAC"}