purecontext-mcp 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Goran Ocokoljic
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,207 @@
+# PureContext MCP
+
+[![CI](https://github.com/Goran-Ocokoljic/purecontext-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Goran-Ocokoljic/purecontext-mcp/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/purecontext-mcp.svg)](https://www.npmjs.com/package/purecontext-mcp)
+[![Stable](https://img.shields.io/badge/stability-stable-brightgreen.svg)](docs/API_STABILITY.md)
+
+Token-efficient source code navigation for AI agents. Indexes TypeScript/JavaScript projects using tree-sitter AST parsing, stores structured symbol metadata in SQLite, and exposes a Model Context Protocol (MCP) server so AI agents can retrieve precisely the code they need — signatures, dependencies, and source — without reading entire files.
+
+## What's New in 1.0
+
+Version 1.0.0 is the first stable release. The tool API is now under semver — breaking changes require a major version bump. See [CHANGELOG.md](CHANGELOG.md) for the full history and [docs/API_STABILITY.md](docs/API_STABILITY.md) for the public API contract.
+
+Highlights since the initial prototype:
+- **16 languages** — TypeScript, JavaScript, Python, Go, Rust, Java, C/C++, C#, Swift, Kotlin, Dart, Elixir, Haskell, Scala, R, PHP, Lua, Ruby
+- **20+ framework adapters** — Vue, Nuxt, React, Next.js, Angular, Express, Fastify, Django, FastAPI, Flask, Spring, and more
+- **FTS5 + semantic search** — keyword search with camelCase splitting and HNSW vector index
+- **Dependency graph tools** — blast radius, context bundle, dead code detection
+- **Worker thread pool** — parallel parsing for 10k–50k file enterprise repos
+- **Zero-build install** — prebuilt `better-sqlite3` binaries for Node 18/20/22 × Windows/macOS/Linux
+
+---
+
+## Quick Start
+
+### Install and connect to Claude Code
+
+```bash
+# Add to Claude Code (uses npx to run without global install)
+claude mcp add purecontext-mcp -- npx purecontext-mcp
+
+# Or install globally first
+npm install -g purecontext-mcp
+claude mcp add purecontext-mcp -- purecontext-mcp
+```
+
+### Index a project
+
+Once connected, tell Claude to index your project:
+
+```
+Index my project at /path/to/my-project using the index_folder tool
+```
+
+Then use any of the tools below to navigate it.
+
+### Configuration (optional)
+
+```bash
+# Generate a config file with all defaults and comments
+npx purecontext-mcp config --init
+
+# Validate config and check prerequisites
+npx purecontext-mcp config --check
+
+# Show effective configuration
+npx purecontext-mcp config
+```
+
+---
+
+## Tool Reference
+
+All tools return JSON. Responses include a `_tokenEstimate` field (where applicable) so agents can gauge context size before loading full source.
+
+### Indexing
+
+| Tool | Description |
+|------|-------------|
+| `index_folder` | Index a project directory. Discovers source files, parses symbols and imports, builds a dependency graph. Returns `repoId` and statistics. |
+| `resolve_repo` | Resolve a local path to its `repoId`. Reports whether the project has been indexed and its metadata. |
+| `list_repos` | List all indexed repositories with their metadata. |
+
+### Symbol Search and Retrieval
+
+| Tool | Description |
+|------|-------------|
+| `search_symbols` | Search symbols by name fragment. Filters by `kind`, `filePath`, and `limit`. Returns signatures and summaries — no source code. |
+| `get_symbol_source` | Retrieve the raw source of one symbol using its byte offsets. Use after `search_symbols` to drill into a specific definition. |
+| `get_file_outline` | All symbols defined in a file with signatures and summaries. Token-efficient alternative to reading the file. |
+| `get_repo_outline` | All files with their top-level symbols. Useful for understanding project structure. |
+| `get_file_tree` | Directory tree of an indexed project with file counts per directory. |
+
+### Dependency Graph
+
+| Tool | Description |
+|------|-------------|
+| `get_context_bundle` | Forward-walk from a symbol: returns everything needed to understand it (transitive imports). Includes token estimate. |
+| `get_blast_radius` | Reverse-walk from a symbol: returns all files that (transitively) import it. Use before modifying or deleting a symbol. |
+| `find_importers` | Direct importers of a file, with their symbols. |
+| `find_dead_code` | Exported symbols in files that nothing else imports. Helps identify unused code. |
+
+---
+
+## Configuration Reference
+
+Config file location: `~/.purecontext/config.json`
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `indexDir` | `string` | `~/.purecontext/indexes/` | Where SQLite index files are stored |
+| `fileLimit` | `number` | `1000` | Max files indexed per project |
+| `watchDebounceMs` | `number` | `2000` | File watcher debounce window (ms) |
+| `excludePatterns` | `string[]` | `[]` | Additional glob patterns to exclude |
+| `adapters` | `'auto'`\|`'none'`\|`string[]` | `'auto'` | Framework adapter activation |
+| `ai.provider` | `'none'`\|`'anthropic'`\|`'openai'` | `'none'` | AI summarization provider (Phase 2) |
+| `ai.allowRemoteAI` | `boolean` | `false` | Allow outbound AI API calls |
+
+---
+
+## Team Setup (Shared Server)
+
+PureContext can run as an always-on shared server so your whole team queries the same index without each developer re-indexing independently.
+
+### 1. Start the server
+
+```bash
+# Docker (recommended)
+docker run -d \
+  -p 3000:3000 \
+  -v ./data:/data \
+  -e PCTX_ADMIN_KEY=your-admin-secret \
+  purecontext/purecontext-mcp:latest
+
+# Or with npx
+PCTX_ADMIN_KEY=your-admin-secret npx purecontext-mcp --server --host 0.0.0.0 --port 3000
+```
+
+### 2. Create a workspace and API keys
+
+```bash
+# Create workspace
+curl -s -X POST http://localhost:3000/admin/workspaces \
+  -H "Authorization: Bearer your-admin-secret" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "my-team"}' | jq .
+
+# Create a key for each developer
+curl -s -X POST http://localhost:3000/admin/keys \
+  -H "Authorization: Bearer your-admin-secret" \
+  -H "Content-Type: application/json" \
+  -d '{"label": "alice-laptop", "permissions": ["read", "write"]}' | jq .key
+```
+
+### 3. Index the shared repo (once, on the server)
+
+```bash
+curl -s -X POST http://localhost:3000/mcp/sse \
+  -H "Authorization: Bearer pctx_alice_key_here" \
+  -H "Accept: application/json, text/event-stream" \
+  -H "Content-Type: application/json" \
+  -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"cli","version":"1.0.0"}},"id":1}'
+```
+
+Or simply ask Claude Code to index via the remote connection (step 4).
+
+### 4. Connect each developer's Claude Code
+
+```bash
+claude mcp add purecontext-remote \
+  --transport http \
+  --url https://purecontext.mycompany.com/mcp/sse \
+  --header "Authorization: Bearer pctx_yourkey"
+```
+
+Each developer gets their own API key. The server handles concurrent agent sessions independently. See [docs/TEAM_SETUP.md](docs/TEAM_SETUP.md) for the full walkthrough including proxy configuration, TLS, and troubleshooting.
+
+---
+
+## Architecture Overview
+
+PureContext MCP follows a strict three-layer architecture:
+
+```
+Adapters  (src/adapters/)    Framework-specific extraction (Vue, Nuxt, React — Phase 2)
+    ↓
+Handlers  (src/handlers/)    Language-specific AST parsing (TypeScript, JavaScript)
+    ↓
+Core      (src/core/)        File discovery, SQLite storage, MCP transport
+```
+
+Dependencies flow strictly downward. Core knows nothing about specific languages or frameworks.
+
+### Key components
+
+- **Index Manager** (`src/core/index-manager.ts`) — orchestrates the full pipeline: discover → parse → extract → store → graph
+- **Parse Dispatcher** (`src/core/parse-dispatcher.ts`) — routes files to language handlers via web-tree-sitter (WASM)
+- **Graph Traversal** (`src/graph/graph-traversal.ts`) — BFS forward/reverse walks over the dependency graph
+- **File Watcher** (`src/core/watcher/file-watcher.ts`) — chokidar-based incremental re-indexing on file changes
+- **MCP Server** (`src/server/mcp-server.ts`) — registers all tools, handles stdio transport
+
+For detailed design decisions and requirements, see `docs/PureContext_MCP_PRD_v1.0.docx`.
+
+---
+
+## Development
+
+```bash
+npm run build      # Compile TypeScript
+npm run dev        # Watch mode
+npm run test       # Run test suite (vitest)
+npm run lint       # ESLint
+```
+
+### Requirements
+
+- Node.js >= 18.0.0
+- The `grammars/` directory must contain the bundled `.wasm` grammar files (included in the package)

package/dist/adapters/actix-web.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Actix-web framework adapter (Rust).
+ *
+ * Extracts route, middleware, and extractor symbols from Actix-web applications.
+ * Actix supports two route definition styles:
+ *
+ *   Attribute macros (common):
+ *     #[get("/users")]
+ *     async fn list_users() -> impl Responder { ... }
+ *
+ *   Programmatic (web::resource / web::scope):
+ *     web::resource("/users")
+ *         .route(web::get().to(list_users))
+ *         .route(web::post().to(create_user))
+ *
+ *   Scope prefix:
+ *     web::scope("/api/v2")
+ *         .service(...)
+ *
+ *   Middleware via .wrap():
+ *     .wrap(actix_web::middleware::Logger::default())
+ *
+ *   Extractor via impl FromRequest:
+ *     impl FromRequest for AuthUser { ... }
+ */
+import type { FrameworkAdapter } from '../core/types.js';
+export declare const actixWebAdapter: FrameworkAdapter;
+//# sourceMappingURL=actix-web.d.ts.map

package/dist/adapters/actix-web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actix-web.d.ts","sourceRoot":"","sources":["../../src/adapters/actix-web.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,kBAAkB,CAAC;AAoV7E,eAAO,MAAM,eAAe,EAAE,gBA+C7B,CAAC"}

package/dist/adapters/actix-web.js

@@ -0,0 +1,362 @@
+/**
+ * Actix-web framework adapter (Rust).
+ *
+ * Extracts route, middleware, and extractor symbols from Actix-web applications.
+ * Actix supports two route definition styles:
+ *
+ *   Attribute macros (common):
+ *     #[get("/users")]
+ *     async fn list_users() -> impl Responder { ... }
+ *
+ *   Programmatic (web::resource / web::scope):
+ *     web::resource("/users")
+ *         .route(web::get().to(list_users))
+ *         .route(web::post().to(create_user))
+ *
+ *   Scope prefix:
+ *     web::scope("/api/v2")
+ *         .service(...)
+ *
+ *   Middleware via .wrap():
+ *     .wrap(actix_web::middleware::Logger::default())
+ *
+ *   Extractor via impl FromRequest:
+ *     impl FromRequest for AuthUser { ... }
+ */
+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 ACTIX_HTTP_METHODS = [
+    'get', 'post', 'put', 'patch', 'delete', 'head', 'options', 'trace', 'connect',
+];
+// ─── Argument collector ───────────────────────────────────────────────────────
+/**
+ * Collect the full text inside a parenthesised call, handling nested parens
+ * and string literals. `pos` must point immediately after the opening `(`.
+ * Returns inner text (sans outer parens), or null if unbalanced.
+ */
+function collectArgs(source, pos) {
+    let depth = 1;
+    const start = pos;
+    let inString = false;
+    let stringChar = '';
+    while (pos < source.length && depth > 0) {
+        const ch = source[pos];
+        if (inString) {
+            if (ch === '\\') {
+                pos++;
+            }
+            else if (ch === stringChar) {
+                inString = false;
+            }
+        }
+        else {
+            if (ch === '"' || ch === '\'') {
+                inString = true;
+                stringChar = ch;
+            }
+            else if (ch === '(') {
+                depth++;
+            }
+            else if (ch === ')') {
+                depth--;
+            }
+        }
+        pos++;
+    }
+    if (depth !== 0)
+        return null;
+    return source.slice(start, pos - 1);
+}
+/**
+ * Collect a method-chaining expression starting at `pos`. Advances until a
+ * semicolon or unmatched closing bracket/paren/brace at depth 0 is reached.
+ */
+function collectMethodChain(source, pos) {
+    let depth = 0;
+    const start = pos;
+    while (pos < source.length) {
+        const ch = source[pos];
+        if (ch === '(' || ch === '{' || ch === '[') {
+            depth++;
+        }
+        else if (ch === ')' || ch === '}' || ch === ']') {
+            if (depth === 0)
+                break;
+            depth--;
+        }
+        else if (ch === ';' && depth === 0) {
+            break;
+        }
+        pos++;
+    }
+    return source.slice(start, pos);
+}
+// ─── Attribute macro route extraction ────────────────────────────────────────
+/**
+ * Extract routes defined via Actix attribute macros:
+ *   #[get("/path")]          → GET /path
+ *   #[actix_web::get("/path")] → GET /path
+ *   #[route(GET, path = "/path")] is not handled (use programmatic style instead)
+ *
+ * The attribute immediately precedes an `async fn` or `fn` declaration; the
+ * route path is taken from the attribute argument.
+ */
+function extractActixMacroRoutes(source, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    const methodPat = ACTIX_HTTP_METHODS.join('|');
+    // Match: #[optional::path::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: `Actix route: ${routeName}`,
+            frameworkMeta: {
+                http_method: method,
+                route_path: routePath,
+                actix_route: true,
+            },
+        });
+    }
+    return symbols;
+}
+// ─── Programmatic route extraction (web::resource) ────────────────────────────
+/**
+ * Extract routes from `web::resource("/path").route(web::METHOD().to(handler))`
+ * chains. Collects the full method chain after each `web::resource(...)` call
+ * and scans it for `.route(web::METHOD()...)` patterns.
+ */
+function extractActixResourceRoutes(source, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    const methodPat = ACTIX_HTTP_METHODS.join('|');
+    // Inner pattern: .route(web::METHOD()...)
+    const innerRouteRe = new RegExp(`\\.route\\s*\\(\\s*web::(${methodPat})\\s*\\(`, 'g');
+    const resourceRe = /\bweb::resource\s*\(/g;
+    let m;
+    while ((m = resourceRe.exec(source)) !== null) {
+        const pathArgPos = m.index + m[0].length;
+        const pathArgs = collectArgs(source, pathArgPos);
+        if (!pathArgs)
+            continue;
+        const pathMatch = pathArgs.match(/^\s*"([^"]+)"\s*$/);
+        if (!pathMatch)
+            continue;
+        const resourcePath = pathMatch[1];
+        // Collect the chained .route() calls that follow
+        const chainStart = pathArgPos + pathArgs.length + 1; // skip closing )
+        const chain = collectMethodChain(source, chainStart);
+        innerRouteRe.lastIndex = 0;
+        let rm;
+        while ((rm = innerRouteRe.exec(chain)) !== null) {
+            const method = rm[1].toUpperCase();
+            const routeName = `${method} ${resourcePath}`;
+            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: `web::resource("${resourcePath}").route(web::${method.toLowerCase()}().to(...))`,
+                summary: `Actix route: ${routeName}`,
+                frameworkMeta: {
+                    http_method: method,
+                    route_path: resourcePath,
+                    actix_route: true,
+                },
+            });
+        }
+    }
+    return symbols;
+}
+// ─── Scope prefix extraction ──────────────────────────────────────────────────
+/**
+ * Extract `web::scope("/prefix")` mount points and emit them as route symbols
+ * with `actix_scope: true`. The prefix is preserved for URL hierarchy
+ * understanding.
+ */
+function extractActixScopes(source, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    const scopeRe = /\bweb::scope\s*\(/g;
+    let m;
+    while ((m = scopeRe.exec(source)) !== null) {
+        const argsPos = m.index + m[0].length;
+        const argsText = collectArgs(source, argsPos);
+        if (!argsText)
+            continue;
+        const pathMatch = argsText.match(/^\s*"([^"]+)"\s*$/);
+        if (!pathMatch)
+            continue;
+        const prefix = pathMatch[1];
+        if (seen.has(prefix))
+            continue;
+        seen.add(prefix);
+        symbols.push({
+            id: makeId(filePath, `SCOPE ${prefix}`, 'route'),
+            name: `SCOPE ${prefix}`,
+            kind: 'route',
+            filePath,
+            startByte: 0,
+            endByte: 0,
+            signature: `web::scope("${prefix}")`,
+            summary: `Actix scope prefix: ${prefix}`,
+            frameworkMeta: {
+                route_path: prefix,
+                actix_scope: true,
+            },
+        });
+    }
+    return symbols;
+}
+// ─── Middleware extraction ────────────────────────────────────────────────────
+/**
+ * Extract middleware symbols from `.wrap(...)` calls.
+ * The middleware name is taken from the first type segment of the argument
+ * (e.g. `Logger` from `actix_web::middleware::Logger::default()`).
+ */
+function extractActixMiddleware(source, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    const wrapRe = /\.wrap\s*\(/g;
+    let m;
+    while ((m = wrapRe.exec(source)) !== null) {
+        const argsPos = m.index + m[0].length;
+        const argsText = collectArgs(source, argsPos);
+        if (!argsText)
+            continue;
+        // Capture the full path, then pick the first PascalCase segment as the type name.
+        // e.g. `actix_web::middleware::Logger::default()` → segments ['actix_web', 'middleware', 'Logger', 'default']
+        //      first PascalCase → 'Logger'
+        // e.g. `AuthMiddleware` → 'AuthMiddleware'
+        // e.g. `CorsMiddleware::new()` → 'CorsMiddleware'
+        const typeMatch = argsText.trim().match(/^([A-Za-z][A-Za-z0-9_]*(?:::[A-Za-z][A-Za-z0-9_]*)*)/);
+        if (!typeMatch)
+            continue;
+        const segments = typeMatch[1].split('::');
+        const typeName = segments.find((s) => /^[A-Z]/.test(s)) ?? segments[0];
+        if (seen.has(typeName))
+            continue;
+        seen.add(typeName);
+        symbols.push({
+            id: makeId(filePath, typeName, 'middleware'),
+            name: typeName,
+            kind: 'middleware',
+            filePath,
+            startByte: 0,
+            endByte: 0,
+            signature: `.wrap(${argsText.trim().split('(')[0].trim()}(...))`,
+            summary: `Actix middleware: ${typeName}`,
+            frameworkMeta: {
+                actix_middleware: true,
+            },
+        });
+    }
+    return symbols;
+}
+// ─── FromRequest extractor extraction ────────────────────────────────────────
+/**
+ * Scan for `impl [<bounds>] [path::]FromRequest for TypeName` and emit a
+ * `type` symbol with `actix_extractor: true`.
+ */
+function extractActixExtractors(source, filePath) {
+    const symbols = [];
+    const seen = new Set();
+    // impl [<...>] [path::]FromRequest [<...>] for TypeName
+    const implRe = /\bimpl(?:\s*<[^>]*>)?\s+(?:\w+::)*FromRequest(?:\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, 'type'),
+            name,
+            kind: 'type',
+            filePath,
+            startByte: 0,
+            endByte: 0,
+            signature: `impl FromRequest for ${name}`,
+            summary: `Actix extractor: ${name}`,
+            frameworkMeta: { actix_extractor: true },
+        });
+    }
+    return symbols;
+}
+// ─── Actix import guard ───────────────────────────────────────────────────────
+/**
+ * Quick check — only process files that reference actix_web. Avoids scanning
+ * every `.rs` file in projects that use similar patterns.
+ */
+function hasActixUsage(source) {
+    return /\bactix_web\b/.test(source);
+}
+// ─── Actix-web adapter ────────────────────────────────────────────────────────
+export const actixWebAdapter = {
+    name: 'actix-web',
+    /** `.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 `actix-web = "..."` or `actix-web = { version = "..." }`
+            return /\bactix-web\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 (!hasActixUsage(sourceStr))
+            return [];
+        return [
+            ...extractActixMacroRoutes(sourceStr, filePath),
+            ...extractActixResourceRoutes(sourceStr, filePath),
+            ...extractActixScopes(sourceStr, filePath),
+            ...extractActixMiddleware(sourceStr, filePath),
+            ...extractActixExtractors(sourceStr, filePath),
+        ];
+    },
+    // ── Metadata enrichment ────────────────────────────────────────────────────
+    enrichMetadata(symbol) {
+        return symbol;
+    },
+};
+// ─── Self-registration ────────────────────────────────────────────────────────
+registerAdapter(actixWebAdapter);
+logger.debug("Adapter 'actix-web' registered");
+//# sourceMappingURL=actix-web.js.map

package/dist/adapters/actix-web.js.map

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

package/dist/adapters/adapter-registry.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Adapter registry — registration and auto-discovery of framework adapters.
+ *
+ * Adapters self-register by calling `registerAdapter(myAdapter)` at module level.
+ * The pipeline calls `discoverAdapters()` at indexing time to get the active set.
+ */
+import type { FrameworkAdapter } from '../core/types.js';
+import type { PureContextConfig } from '../config/config-schema.js';
+/**
+ * Register a framework adapter. Adapters call this at module load time.
+ * Re-registering the same name overwrites the previous entry.
+ */
+export declare function registerAdapter(adapter: FrameworkAdapter): void;
+/**
+ * Return all registered adapters (in registration order).
+ */
+export declare function getRegisteredAdapters(): FrameworkAdapter[];
+/**
+ * Resolve which adapters are active for a given project root, honouring the
+ * `adapters` config setting:
+ *   'auto'   — call detect() on every registered adapter
+ *   'none'   — return []
+ *   string[] — activate named adapters only (skip detect(), assume active)
+ */
+export declare function discoverAdapters(projectRoot: string, config: Pick<PureContextConfig, 'adapters'>): Promise<FrameworkAdapter[]>;
+/**
+ * Collect all additional file extensions declared by a set of active adapters.
+ * Used by file discovery to expand the extension allowlist beyond what language
+ * handlers cover.
+ */
+export declare function getAdapterExtensions(adapters: FrameworkAdapter[]): string[];
+/** Reset registry to empty — for use in tests only. */
+export declare function _resetForTesting(): void;
+//# sourceMappingURL=adapter-registry.d.ts.map