purecontext-mcp 1.0.1

package/dist/adapters/rocket.js

@@ -0,0 +1,271 @@
+/**
+ * Rocket framework adapter (Rust).
+ *
+ * Extracts route, catcher, fairing (middleware), and guard symbols from Rocket
+ * web applications. Rocket uses procedural macros for route definitions:
+ *
+ *   #[get("/path")]                     → GET /path
+ *   #[post("/path")]                    → POST /path
+ *   #[route(GET, path = "/path")]       → GET /path
+ *   #[catch(404)]                       → error catcher for 404
+ *   impl Fairing for LogFairing         → fairing (middleware)
+ *   #[derive(FromForm)]                 → request guard / form type
+ *   #[derive(FromRequest)]              → request guard
+ *
+ * Path parameters use `<param>` syntax: `/users/<id>`.
+ */
+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);
+}
+// ─── Constants ────────────────────────────────────────────────────────────────
+const ROCKET_HTTP_METHODS = [
+    'get', 'post', 'put', 'patch', 'delete', 'head', 'options',
+];
+// ─── Simple macro route extraction ────────────────────────────────────────────
+/**
+ * Extract routes defined via simple Rocket attribute macros:
+ *   #[get("/users")]          → GET /users
+ *   #[post("/users/<id>")]    → POST /users/<id>
+ *   #[rocket::get("/path")]   → GET /path  (fully qualified)
+ *
+ * The attribute must be immediately followed by either another attribute, or a
+ * `fn`/`async fn` definition. The route path is taken from the first string
+ * argument of the macro.
+ */
+function extractRocketMacroRoutes(source, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    const methodPat = ROCKET_HTTP_METHODS.join('|');
+    // Match: #[optional::path::get("/path")]  or  #[get("/path", ...)]
+    const re = new RegExp(`#\\[(?:[\\w]+::)*(${methodPat})\\s*\\(\\s*"([^"]+)"`, 'g');
+    let m;
+    while ((m = re.exec(source)) !== null) {
+        const method = m[1].toUpperCase();
+        const routePath = m[2];
+        const routeName = `${method} ${routePath}`;
+        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[1]}("${routePath}")]`,
+            summary: `Rocket route: ${routeName}`,
+            frameworkMeta: {
+                http_method: method,
+                route_path: routePath,
+                rocket_route: true,
+            },
+        });
+    }
+    return symbols;
+}
+// ─── Generic #[route(...)] macro extraction ───────────────────────────────────
+/**
+ * Extract routes defined via the generic `#[route]` macro:
+ *   #[route(GET, path = "/users/<id>")]   → GET /users/<id>
+ *   #[rocket::route(POST, path = "/")]    → POST /
+ *
+ * The first argument is the HTTP method (unquoted identifier), and `path` is a
+ * named parameter.
+ */
+function extractRocketGenericRoutes(source, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    // Match: #[optional::route(METHOD, path = "/path")]
+    const re = /#\[(?:[\w]+::)*route\s*\(\s*([A-Z]+)\s*,\s*path\s*=\s*"([^"]+)"/g;
+    let m;
+    while ((m = re.exec(source)) !== null) {
+        const method = m[1].toUpperCase();
+        const routePath = m[2];
+        const routeName = `${method} ${routePath}`;
+        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: `#[route(${method}, path = "${routePath}")]`,
+            summary: `Rocket route: ${routeName}`,
+            frameworkMeta: {
+                http_method: method,
+                route_path: routePath,
+                rocket_route: true,
+            },
+        });
+    }
+    return symbols;
+}
+// ─── Error catcher extraction ─────────────────────────────────────────────────
+/**
+ * Extract error catchers defined via `#[catch(code)]`:
+ *   #[catch(404)]   → catcher for HTTP 404
+ *   #[catch(500)]   → catcher for HTTP 500
+ *   #[catch(default)] → default catch-all catcher (code = null)
+ *
+ * Each catcher is emitted as a `route` symbol with `rocket_catcher: true` and
+ * the `status_code` populated (or null for the default catcher).
+ */
+function extractRocketCatchers(source, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    // Match: #[catch(404)]  or  #[rocket::catch(404)]  or  #[catch(default)]
+    const re = /#\[(?:[\w]+::)*catch\s*\(\s*([\w]+)\s*\)/g;
+    let m;
+    while ((m = re.exec(source)) !== null) {
+        const codeStr = m[1];
+        const isDefault = codeStr === 'default';
+        const statusCode = isDefault ? null : parseInt(codeStr, 10);
+        const symbolName = isDefault ? 'CATCH default' : `CATCH ${codeStr}`;
+        if (seen.has(symbolName))
+            continue;
+        seen.add(symbolName);
+        symbols.push({
+            id: makeId(filePath, symbolName, 'route'),
+            name: symbolName,
+            kind: 'route',
+            filePath,
+            startByte: 0,
+            endByte: 0,
+            signature: `#[catch(${codeStr})]`,
+            summary: `Rocket error catcher: ${symbolName}`,
+            frameworkMeta: {
+                rocket_catcher: true,
+                status_code: statusCode,
+            },
+        });
+    }
+    return symbols;
+}
+// ─── Fairing (middleware) extraction ─────────────────────────────────────────
+/**
+ * Extract Rocket fairings by scanning for `impl [<bounds>] [path::]Fairing for TypeName`.
+ * Fairings are the Rocket equivalent of middleware — lifecycle hooks that run
+ * on attach, launch, request, and response events.
+ */
+function extractRocketFairings(source, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    // impl [<...>] [path::]Fairing [<...>] for TypeName
+    const implRe = /\bimpl(?:\s*<[^>]*>)?\s+(?:\w+::)*Fairing(?:\s*<[^>]*>)?\s+for\s+([A-Za-z][A-Za-z0-9_]*)/g;
+    let m;
+    while ((m = implRe.exec(source)) !== null) {
+        const name = m[1];
+        if (seen.has(name))
+            continue;
+        seen.add(name);
+        symbols.push({
+            id: makeId(filePath, name, 'middleware'),
+            name,
+            kind: 'middleware',
+            filePath,
+            startByte: 0,
+            endByte: 0,
+            signature: `impl Fairing for ${name}`,
+            summary: `Rocket fairing: ${name}`,
+            frameworkMeta: { rocket_fairing: true },
+        });
+    }
+    return symbols;
+}
+// ─── Request guard / form type extraction ────────────────────────────────────
+/**
+ * Extract request guard and form types derived via procedural macros:
+ *   #[derive(FromForm)]     → form guard (data validation)
+ *   #[derive(FromRequest)]  → request guard (auth / extraction)
+ *
+ * Both are emitted as `type` symbols with `rocket_guard: true`.
+ */
+function extractRocketGuards(source, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    function emit(name) {
+        if (seen.has(name))
+            return;
+        seen.add(name);
+        symbols.push({
+            id: makeId(filePath, name, 'type'),
+            name,
+            kind: 'type',
+            filePath,
+            startByte: 0,
+            endByte: 0,
+            signature: `#[derive(FromForm/FromRequest)] struct ${name}`,
+            summary: `Rocket guard: ${name}`,
+            frameworkMeta: { rocket_guard: true },
+        });
+    }
+    // #[derive(..., FromForm, ...)] / #[derive(..., FromRequest, ...)]
+    // followed by pub? struct|enum Name
+    const deriveRe = /#\[derive\([^\]]*\b(?:FromForm|FromRequest)\b[^\]]*\)\][\s\S]*?(?:pub\s+(?:\([^)]*\)\s+)?)?(?:struct|enum)\s+([A-Za-z][A-Za-z0-9_]*)/g;
+    let m;
+    while ((m = deriveRe.exec(source)) !== null) {
+        emit(m[1]);
+    }
+    return symbols;
+}
+// ─── Rocket import guard ──────────────────────────────────────────────────────
+/**
+ * Quick check — only process files that reference rocket. Avoids scanning
+ * every `.rs` file in projects that happen to use similar patterns.
+ */
+function hasRocketUsage(source) {
+    return /\brocket\b/.test(source);
+}
+// ─── Rocket adapter ───────────────────────────────────────────────────────────
+export const rocketAdapter = {
+    name: 'rocket',
+    /** `.rs` files are handled by the Rust language handler — no new extension. */
+    extensions: () => [],
+    // ── Detection ─────────────────────────────────────────────────────────────
+    async detect(projectRoot) {
+        try {
+            const cargoToml = readFileSync(join(projectRoot, 'Cargo.toml'), 'utf8');
+            // Match `rocket = "..."` or `rocket = { version = "..." }`
+            return /\brocket\s*=/.test(cargoToml);
+        }
+        catch {
+            return false;
+        }
+    },
+    // ── File routing ───────────────────────────────────────────────────────────
+    fileFilter: (filePath) => filePath.endsWith('.rs'),
+    // ── Framework symbol extraction ────────────────────────────────────────────
+    extractFrameworkSymbols(_tree, source, filePath) {
+        const sourceStr = source.toString('utf8');
+        if (!hasRocketUsage(sourceStr))
+            return [];
+        return [
+            ...extractRocketMacroRoutes(sourceStr, filePath),
+            ...extractRocketGenericRoutes(sourceStr, filePath),
+            ...extractRocketCatchers(sourceStr, filePath),
+            ...extractRocketFairings(sourceStr, filePath),
+            ...extractRocketGuards(sourceStr, filePath),
+        ];
+    },
+    // ── Metadata enrichment ────────────────────────────────────────────────────
+    enrichMetadata(symbol) {
+        return symbol;
+    },
+};
+// ─── Self-registration ────────────────────────────────────────────────────────
+registerAdapter(rocketAdapter);
+logger.debug("Adapter 'rocket' registered");
+//# sourceMappingURL=rocket.js.map

package/dist/adapters/rocket.js.map

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

package/dist/adapters/sinatra.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Sinatra framework adapter.
+ *
+ * Extracts route symbols from Sinatra applications using regex-based scanning
+ * on Ruby source text.
+ *
+ * Patterns recognised:
+ *   get '/users' do ... end              → classic-style route
+ *   post '/users', to: 'users#create'   → route with options
+ *   class MyApp < Sinatra::Base
+ *     get '/items' do ... end            → modular-style route
+ *   end
+ */
+import type { FrameworkAdapter } from '../core/types.js';
+export declare const sinatraAdapter: FrameworkAdapter;
+//# sourceMappingURL=sinatra.d.ts.map

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

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

package/dist/adapters/sinatra.js

@@ -0,0 +1,114 @@
+/**
+ * Sinatra framework adapter.
+ *
+ * Extracts route symbols from Sinatra applications using regex-based scanning
+ * on Ruby source text.
+ *
+ * Patterns recognised:
+ *   get '/users' do ... end              → classic-style route
+ *   post '/users', to: 'users#create'   → route with options
+ *   class MyApp < Sinatra::Base
+ *     get '/items' do ... end            → modular-style route
+ *   end
+ */
+import { createHash } from 'crypto';
+import { readFileSync, existsSync, readdirSync } 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);
+}
+// ─── Route extraction ─────────────────────────────────────────────────────────
+const HTTP_METHODS = ['get', 'post', 'put', 'delete', 'patch', 'head', 'options'];
+/**
+ * Matches Sinatra route declarations in both classic and modular style:
+ *   get '/path' do
+ *   post "/path", ...
+ *   delete '/path/with/:param' do
+ *
+ * Captures: (1) http method, (2) path string
+ */
+const ROUTE_RE = new RegExp(`\\b(${HTTP_METHODS.join('|')})\\s+['"](([^'"]*))['"]`, 'gi');
+function extractRoutes(sourceStr, filePath) {
+    const symbols = [];
+    ROUTE_RE.lastIndex = 0;
+    let m;
+    while ((m = ROUTE_RE.exec(sourceStr)) !== null) {
+        const httpMethod = m[1].toUpperCase();
+        const routePath = m[2];
+        const name = `${httpMethod} ${routePath}`;
+        symbols.push({
+            id: makeId(filePath, name, 'route'),
+            name,
+            kind: 'route',
+            filePath,
+            startByte: m.index,
+            endByte: 0,
+            signature: `${m[1]} '${routePath}'`,
+            summary: `Sinatra route: ${name}`,
+            frameworkMeta: {
+                sinatra_route: true,
+                http_method: httpMethod,
+                route_path: routePath,
+            },
+        });
+    }
+    return symbols;
+}
+// ─── Sinatra adapter ──────────────────────────────────────────────────────────
+export const sinatraAdapter = {
+    name: 'sinatra',
+    extensions: () => [],
+    async detect(projectRoot) {
+        // Check Gemfile
+        const gemfilePath = join(projectRoot, 'Gemfile');
+        if (existsSync(gemfilePath)) {
+            try {
+                const content = readFileSync(gemfilePath, 'utf8');
+                if (/gem\s+['"]sinatra['"]/m.test(content))
+                    return true;
+            }
+            catch {
+                // fall through to next check
+            }
+        }
+        // Shallow scan of root-level .rb files for require 'sinatra'
+        try {
+            const entries = readdirSync(projectRoot, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isFile() || !entry.name.endsWith('.rb'))
+                    continue;
+                try {
+                    const content = readFileSync(join(projectRoot, entry.name), 'utf8');
+                    if (/require\s+['"]sinatra['"]/m.test(content))
+                        return true;
+                }
+                catch {
+                    // skip unreadable files
+                }
+            }
+        }
+        catch {
+            // ignore readdir failures
+        }
+        return false;
+    },
+    fileFilter(filePath) {
+        return filePath.endsWith('.rb');
+    },
+    extractFrameworkSymbols(_tree, source, filePath) {
+        return extractRoutes(source.toString('utf8'), filePath);
+    },
+    enrichMetadata(symbol) {
+        return symbol;
+    },
+};
+// ─── Self-registration ────────────────────────────────────────────────────────
+registerAdapter(sinatraAdapter);
+logger.debug("Adapter 'sinatra' registered");
+//# sourceMappingURL=sinatra.js.map

package/dist/adapters/sinatra.js.map

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

package/dist/adapters/spring-boot.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Spring Boot adapter (Java).
+ *
+ * Extracts route, controller, service, bean, scheduled, and event listener
+ * symbols from Spring Boot applications written in Java. Both `.java` and `.kt`
+ * files are accepted (Kotlin Spring files share the same annotation syntax).
+ *
+ * Patterns recognised:
+ *   @RestController / @Controller class Foo { … }   → class (spring_controller)
+ *   @Service class FooService { … }                  → class (spring_bean)
+ *   @Component class Foo { … }                       → class (spring_bean)
+ *   @Repository class FooRepo { … }                  → class (spring_bean)
+ *   @Configuration class Cfg { … }                   → class (spring_config)
+ *   @RequestMapping("/prefix") at class level        → base path prefix
+ *   @GetMapping / @PostMapping / … on method         → route (spring_route)
+ *   @Bean on method                                  → function (spring_bean)
+ *   @Scheduled on method                             → function (spring_scheduled)
+ *   @EventListener on method                         → function (spring_listener)
+ *
+ * Spring path variables use `{param}` syntax: `/users/{id}`.
+ */
+import type { FrameworkAdapter } from '../core/types.js';
+export declare const springBootAdapter: FrameworkAdapter;
+//# sourceMappingURL=spring-boot.d.ts.map

package/dist/adapters/spring-boot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring-boot.d.ts","sourceRoot":"","sources":["../../src/adapters/spring-boot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,kBAAkB,CAAC;AAyb7E,eAAO,MAAM,iBAAiB,EAAE,gBAgC/B,CAAC"}