codedev-mcp 3.2.0

package/dist/db/sqlite-store.js

@@ -0,0 +1,388 @@
+/**
+ * SQLite-based persistent index for codebase data.
+ * Uses sql.js (WASM) — zero native compilation, works everywhere.
+ * Drop-in replacement for JsonStore with dramatically faster queries at scale.
+ *
+ * Storage: .codedev-mcp/index.sqlite in the project root.
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import { stat as fsStat } from 'node:fs/promises';
+const INDEX_DIR = '.codedev-mcp';
+const INDEX_FILE = 'index.sqlite';
+const SCHEMA_VERSION = 2;
+/**
+ * SQLite-backed persistent index for codebase data using sql.js WASM.
+ */
+export class SqliteStore {
+    dbPath;
+    db = null;
+    dirty = false;
+    SQL = null;
+    /**
+     * Create a new SqliteStore instance.
+     * @param cwd - The working directory for the database file.
+     */
+    constructor(cwd) {
+        this.dbPath = path.join(cwd, INDEX_DIR, INDEX_FILE);
+    }
+    /**
+     * Initialize sql.js WASM module.
+     * @returns The initialized sql.js static instance.
+     */
+    async initSqlJs() {
+        if (this.SQL)
+            return this.SQL;
+        const initSqlJs = (await import('sql.js')).default;
+        const sql = await initSqlJs();
+        this.SQL = sql;
+        return sql;
+    }
+    /**
+     * Run a query with bind parameters.
+     * Replaces db.run() which doesn't support params in all cases.
+     * @param sql - The SQL query string.
+     * @param params - Bind parameters for the query.
+     * @returns An array of result rows.
+     */
+    query(sql, params = []) {
+        if (!this.db)
+            return [];
+        try {
+            const db = this.db;
+            const stmt = db.prepare(sql);
+            stmt.bind(params);
+            const rows = [];
+            while (stmt.step()) {
+                rows.push(stmt.get());
+            }
+            stmt.free();
+            return rows;
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Create tables if they don't exist.
+     */
+    createSchema() {
+        if (!this.db)
+            return;
+        this.db.run(`
+      CREATE TABLE IF NOT EXISTS meta (
+        key TEXT PRIMARY KEY,
+        value TEXT
+      )
+    `);
+        this.db.run(`
+      CREATE TABLE IF NOT EXISTS files (
+        path TEXT PRIMARY KEY,
+        mtime REAL NOT NULL,
+        lines INTEGER NOT NULL,
+        language TEXT NOT NULL,
+        size INTEGER NOT NULL
+      )
+    `);
+        this.db.run(`
+      CREATE TABLE IF NOT EXISTS symbols (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        name TEXT NOT NULL,
+        type TEXT NOT NULL,
+        file TEXT NOT NULL,
+        line INTEGER NOT NULL,
+        exported INTEGER NOT NULL DEFAULT 0
+      )
+    `);
+        this.db.run(`
+      CREATE TABLE IF NOT EXISTS imports (
+        file TEXT NOT NULL,
+        import_path TEXT NOT NULL,
+        PRIMARY KEY (file, import_path)
+      )
+    `);
+        // Indices for fast lookups
+        this.db.run(`CREATE INDEX IF NOT EXISTS idx_symbols_name ON symbols(name)`);
+        this.db.run(`CREATE INDEX IF NOT EXISTS idx_symbols_file ON symbols(file)`);
+        this.db.run(`CREATE INDEX IF NOT EXISTS idx_symbols_type ON symbols(type)`);
+        this.db.run(`CREATE INDEX IF NOT EXISTS idx_imports_file ON imports(file)`);
+        this.db.run(`CREATE INDEX IF NOT EXISTS idx_imports_path ON imports(import_path)`);
+        // Analytics schema
+        this.db.run(`
+      CREATE TABLE IF NOT EXISTS usage_stats (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        tool TEXT NOT NULL,
+        timestamp INTEGER NOT NULL,
+        duration INTEGER NOT NULL,
+        success INTEGER NOT NULL,
+        cached INTEGER NOT NULL
+      )
+    `);
+        this.db.run(`CREATE INDEX IF NOT EXISTS idx_usage_tool ON usage_stats(tool)`);
+        this.db.run(`CREATE INDEX IF NOT EXISTS idx_usage_ts ON usage_stats(timestamp)`);
+        // Set schema version
+        this.db.run(`INSERT OR REPLACE INTO meta (key, value) VALUES ('version', ?)`, [String(SCHEMA_VERSION)]);
+        this.db.run(`INSERT OR REPLACE INTO meta (key, value) VALUES ('updated', ?)`, [new Date().toISOString()]);
+    }
+    /**
+     * Load existing database from disk. Returns false if none exists or version mismatch.
+     * @returns True if the database was loaded successfully.
+     */
+    async load() {
+        try {
+            const SQL = await this.initSqlJs();
+            const data = await readFile(this.dbPath);
+            this.db = new SQL.Database(data);
+            // Check schema version
+            const result = this.db.exec(`SELECT value FROM meta WHERE key = 'version'`);
+            if (!result.length || !result[0].values.length) {
+                this.db.close();
+                this.db = null;
+                return false;
+            }
+            const version = parseInt(result[0].values[0][0], 10);
+            if (version !== SCHEMA_VERSION) {
+                this.db.close();
+                this.db = null;
+                return false;
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Save database to disk.
+     */
+    async save() {
+        if (!this.db || !this.dirty)
+            return;
+        this.db.run(`INSERT OR REPLACE INTO meta (key, value) VALUES ('updated', ?)`, [new Date().toISOString()]);
+        const data = this.db.export();
+        const dir = path.dirname(this.dbPath);
+        await mkdir(dir, { recursive: true });
+        await writeFile(this.dbPath, Buffer.from(data));
+        this.dirty = false;
+    }
+    /**
+     * Initialize a new empty database.
+     * @param _ - The working directory (unused, kept for interface compatibility).
+     */
+    async init(_) {
+        const SQL = await this.initSqlJs();
+        this.db = new SQL.Database();
+        this.createSchema();
+        this.db.run(`INSERT OR REPLACE INTO meta (key, value) VALUES ('created', ?)`, [new Date().toISOString()]);
+        this.dirty = true;
+    }
+    /**
+     * Check if a file needs re-indexing (mtime changed).
+     * @param filePath - The file path to check.
+     * @returns True if the file needs re-indexing.
+     */
+    async needsReindex(filePath) {
+        if (!this.db)
+            return true;
+        const rows = this.query('SELECT mtime FROM files WHERE path = ?', [filePath]);
+        if (!rows.length)
+            return true;
+        const storedMtime = rows[0][0];
+        try {
+            const s = await fsStat(filePath);
+            return s.mtimeMs !== storedMtime;
+        }
+        catch {
+            return true;
+        }
+    }
+    /**
+     * Update file entry in index.
+     * @param file - The file entry to update.
+     */
+    updateFile(file) {
+        if (!this.db)
+            return;
+        this.db.run(`INSERT OR REPLACE INTO files (path, mtime, lines, language, size) VALUES (?, ?, ?, ?, ?)`, [
+            file.path,
+            file.mtime,
+            file.lines,
+            file.language,
+            file.size,
+        ]);
+        this.dirty = true;
+    }
+    /**
+     * Update symbols for a file (replaces all).
+     * @param filePath - The file path whose symbols are being updated.
+     * @param symbols - The new symbols for the file.
+     */
+    updateSymbols(filePath, symbols) {
+        if (!this.db)
+            return;
+        this.db.run(`DELETE FROM symbols WHERE file = ?`, [filePath]);
+        for (const s of symbols) {
+            this.db.run(`INSERT INTO symbols (name, type, file, line, exported) VALUES (?, ?, ?, ?, ?)`, [
+                s.name,
+                s.type,
+                s.file,
+                s.line,
+                s.exported ? 1 : 0,
+            ]);
+        }
+        this.dirty = true;
+    }
+    /**
+     * Update imports for a file.
+     * @param filePath - The file path whose imports are being updated.
+     * @param imports - The new import paths for the file.
+     */
+    updateImports(filePath, imports) {
+        if (!this.db)
+            return;
+        this.db.run(`DELETE FROM imports WHERE file = ?`, [filePath]);
+        for (const imp of imports) {
+            this.db.run(`INSERT INTO imports (file, import_path) VALUES (?, ?)`, [filePath, imp]);
+        }
+        this.dirty = true;
+    }
+    /**
+     * Query symbols by name pattern.
+     * @param pattern - Pattern to match symbol names (uses SQL LIKE).
+     * @param type - Optional symbol type filter.
+     * @returns Matching symbols.
+     */
+    findSymbols(pattern, type) {
+        if (!this.db)
+            return [];
+        let sql = 'SELECT name, type, file, line, exported FROM symbols WHERE name LIKE ?';
+        const params = [`%${pattern}%`];
+        if (type) {
+            sql += ' AND type = ?';
+            params.push(type);
+        }
+        const rows = this.query(sql, params);
+        return rows.map((row) => ({
+            name: row[0],
+            type: row[1],
+            file: row[2],
+            line: row[3],
+            exported: row[4] === 1,
+        }));
+    }
+    /**
+     * Get all files in index.
+     * @returns All indexed files.
+     */
+    getFiles() {
+        const rows = this.query('SELECT path, mtime, lines, language, size FROM files');
+        return rows.map((row) => ({
+            path: row[0],
+            mtime: row[1],
+            lines: row[2],
+            language: row[3],
+            size: row[4],
+        }));
+    }
+    /**
+     * Get imports for a file.
+     * @param filePath - The file path to look up.
+     * @returns The import paths for the file.
+     */
+    getImports(filePath) {
+        const rows = this.query('SELECT import_path FROM imports WHERE file = ?', [filePath]);
+        return rows.map((row) => row[0]);
+    }
+    /**
+     * Get importers of a file (reverse lookup).
+     * @param filePath - The file path to find importers for.
+     * @returns Files that import the given file.
+     */
+    getImporters(filePath) {
+        const baseName = path.basename(filePath, path.extname(filePath));
+        const rows = this.query('SELECT DISTINCT file FROM imports WHERE import_path LIKE ?', [`%${baseName}%`]);
+        return rows.map((row) => row[0]);
+    }
+    /**
+     * Remove a file from the index.
+     * @param filePath - The file path to remove.
+     */
+    removeFile(filePath) {
+        if (!this.db)
+            return;
+        this.db.run(`DELETE FROM files WHERE path = ?`, [filePath]);
+        this.db.run(`DELETE FROM symbols WHERE file = ?`, [filePath]);
+        this.db.run(`DELETE FROM imports WHERE file = ?`, [filePath]);
+        this.dirty = true;
+    }
+    /**
+     * Get index stats.
+     * @returns Stats object or null if no database loaded.
+     */
+    stats() {
+        if (!this.db)
+            return null;
+        const files = this.query('SELECT COUNT(*) FROM files');
+        const symbols = this.query('SELECT COUNT(*) FROM symbols');
+        const imports = this.query('SELECT COUNT(DISTINCT file) FROM imports');
+        const updated = this.query("SELECT value FROM meta WHERE key = 'updated'");
+        return {
+            files: files[0]?.[0] || 0,
+            symbols: symbols[0]?.[0] || 0,
+            imports: imports[0]?.[0] || 0,
+            updated: updated[0]?.[0] || '',
+            engine: 'sqlite (sql.js WASM)',
+        };
+    }
+    /**
+     * Close the database.
+     */
+    close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+    /**
+     * Log tool usage to DB.
+     * @param tool - Tool name.
+     * @param duration - Duration in milliseconds.
+     * @param success - Whether the operation succeeded.
+     * @param cached - Whether the result was cached.
+     */
+    logUsage(tool, duration, success, cached) {
+        if (!this.db)
+            return;
+        this.db.run(`INSERT INTO usage_stats (tool, timestamp, duration, success, cached) VALUES (?, ?, ?, ?, ?)`, [
+            tool,
+            Date.now(),
+            duration,
+            success ? 1 : 0,
+            cached ? 1 : 0,
+        ]);
+        this.dirty = true;
+    }
+    /**
+     * Get usage stats.
+     * @returns Aggregated usage statistics per tool.
+     */
+    getUsageStats() {
+        const rows = this.query(`
+      SELECT
+        tool,
+        COUNT(*) as count,
+        SUM(CASE WHEN success = 0 THEN 1 ELSE 0 END) as errorCount,
+        AVG(duration) as avgDuration
+      FROM usage_stats
+      GROUP BY tool
+      ORDER BY count DESC
+    `);
+        return rows.map((r) => ({
+            tool: r[0],
+            count: r[1],
+            errorCount: r[2],
+            avgDuration: Math.round(r[3]),
+        }));
+    }
+}
+//# sourceMappingURL=sqlite-store.js.map

package/dist/db/sqlite-store.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * codedev-mcp — Universal Code Development MCP Server
+ *
+ * A zero-API-key MCP server that provides code search, analysis,
+ * navigation, and git context tools to any LLM-powered IDE.
+ *
+ * The host LLM (Claude, Codex, Gemini) does all reasoning —
+ * this server just provides fast, structured access to your codebase.
+ *
+ * Works with: Claude Code, Codex CLI, Gemini CLI, Cursor, VS Code
+ *             Copilot, Windsurf, Claude Desktop — any MCP client.
+ *
+ * Supports: 40+ programming languages, any codebase size.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;GAaG"}

package/dist/index.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+/**
+ * codedev-mcp — Universal Code Development MCP Server
+ *
+ * A zero-API-key MCP server that provides code search, analysis,
+ * navigation, and git context tools to any LLM-powered IDE.
+ *
+ * The host LLM (Claude, Codex, Gemini) does all reasoning —
+ * this server just provides fast, structured access to your codebase.
+ *
+ * Works with: Claude Code, Codex CLI, Gemini CLI, Cursor, VS Code
+ *             Copilot, Windsurf, Claude Desktop — any MCP client.
+ *
+ * Supports: 40+ programming languages, any codebase size.
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+// CLI argument handling
+const args = process.argv.slice(2);
+if (args.includes('--version') || args.includes('-v')) {
+    const pkg = await import('../package.json', { with: { type: 'json' } });
+    process.stdout.write(`codedev-mcp v${pkg.default.version}\n`);
+    process.exit(0);
+}
+if (args.includes('--help') || args.includes('-h')) {
+    process.stdout.write(`
+codedev-mcp — Universal Code Development MCP Server
+
+Usage: codedev-mcp [options]
+
+Options:
+  -v, --version    Show version number
+  -h, --help       Show this help message
+  --timeout <ms>   Request timeout in milliseconds (default: 30000)
+
+Environment Variables:
+  CODEDEV_MCP_CWD    Working directory (default: current directory)
+  CODEDEV_ROOTS      Multi-root workspace paths (comma-separated)
+  CODEDEV_TIMEOUT    Request timeout in milliseconds
+
+Examples:
+  npx codedev-mcp
+  codedev-mcp --timeout 60000
+\n`);
+    process.exit(0);
+}
+import { logger } from './utils/logger.js';
+// Tool Registries
+import { registerSearchTools } from './tools/search.js';
+import { registerAnalysisTools } from './tools/analysis.js';
+import { registerNavTools } from './tools/nav.js';
+import { registerGitTools } from './tools/git.js';
+import { registerQualityTools } from './tools/quality.js';
+import { registerDocsTools } from './tools/docs.js';
+import { registerSecurityTools } from './tools/security.js';
+import { registerNotebookTools } from './tools/notebook.js';
+import { registerArchitectureTools } from './tools/architecture.js';
+import { registerDevOpsTools } from './tools/devops.js';
+import { registerPerformanceTools } from './tools/performance.js';
+import { registerScaffoldTools } from './tools/scaffold.js';
+import { VERSION } from './version.js';
+import { SERVER_INSTRUCTIONS } from './constants/instructions.js';
+import { registerHealthResource } from './resources/health.js';
+import { toolLimiter } from './utils/concurrency.js';
+// Create MCP Server
+const server = new McpServer({ name: 'codedev-mcp', version: VERSION }, {
+    capabilities: { tools: {}, resources: {}, prompts: {} },
+    instructions: SERVER_INSTRUCTIONS,
+});
+// Wrap all tool handlers with concurrency limiter to prevent resource exhaustion
+// when MCP clients send many parallel tool calls.
+const originalRegisterTool = server.registerTool.bind(server);
+server.registerTool = (name, config, handler) => {
+    const wrappedHandler = async (...handlerArgs) => {
+        return toolLimiter.run(async () => handler(...handlerArgs));
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Config type is complex from MCP SDK
+    return originalRegisterTool(name, config, wrappedHandler);
+};
+// Register Tools
+registerSearchTools(server);
+registerAnalysisTools(server);
+registerNavTools(server);
+registerGitTools(server);
+registerQualityTools(server);
+registerDocsTools(server);
+registerSecurityTools(server);
+registerNotebookTools(server);
+registerArchitectureTools(server);
+registerDevOpsTools(server);
+registerPerformanceTools(server);
+registerScaffoldTools(server);
+// Register Resources
+registerHealthResource(server, VERSION);
+/**
+ * Starts the MCP server using stdio transport and initializes the database.
+ * @returns A promise that resolves when the server is running.
+ */
+async function runServer() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Initialize DB
+    try {
+        const { getDb } = await import('./db/connection.js');
+        await getDb();
+        logger.info('codedev-mcp server running on stdio', { version: '3.1.0', db: 'initialized' });
+    }
+    catch (err) {
+        logger.warn('Failed to initialize database', { error: err });
+    }
+}
+runServer().catch((error) => {
+    logger.error('Fatal error running server', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/resources/health.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Health Check Resource
+ * Exposes server health status for monitoring
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+interface HealthStatus {
+    status: 'healthy' | 'degraded' | 'unhealthy';
+    uptime: number;
+    memory: {
+        used: number;
+        total: number;
+        percentage: number;
+    };
+    version: string;
+    timestamp: string;
+    checks: {
+        name: string;
+        status: 'pass' | 'fail';
+        message?: string;
+    }[];
+}
+/**
+ * Get the current server health status including memory, uptime, and binary checks.
+ * @param version - The server version string.
+ * @returns The health status object.
+ */
+export declare function getHealthStatus(version: string): Promise<HealthStatus>;
+/**
+ * Register the health resource on the MCP server.
+ * @param server - The MCP server instance.
+ * @param version - The server version string.
+ */
+export declare function registerHealthResource(server: McpServer, version: string): void;
+export {};
+//# sourceMappingURL=health.d.ts.map

package/dist/resources/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/resources/health.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,UAAU,YAAY;IACpB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;CACL;AAaD;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAsC5E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAa/E"}

package/dist/resources/health.js

@@ -0,0 +1,81 @@
+/**
+ * Health Check Resource
+ * Exposes server health status for monitoring
+ */
+import os from 'node:os';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+const startTime = Date.now();
+async function isBinaryAvailable(binary) {
+    try {
+        await execFileAsync('which', [binary]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the current server health status including memory, uptime, and binary checks.
+ * @param version - The server version string.
+ * @returns The health status object.
+ */
+export async function getHealthStatus(version) {
+    const memUsage = process.memoryUsage();
+    const totalMem = os.totalmem();
+    const checks = [];
+    // Check ripgrep availability (async)
+    if (await isBinaryAvailable('rg')) {
+        checks.push({ name: 'ripgrep', status: 'pass' });
+    }
+    else {
+        checks.push({ name: 'ripgrep', status: 'fail', message: 'ripgrep not found, using fallback' });
+    }
+    // Check fd availability (async)
+    if (await isBinaryAvailable('fd')) {
+        checks.push({ name: 'fd', status: 'pass' });
+    }
+    else {
+        checks.push({ name: 'fd', status: 'fail', message: 'fd not found, using fallback' });
+    }
+    // Determine overall status
+    const failedChecks = checks.filter((c) => c.status === 'fail').length;
+    let status = 'healthy';
+    if (failedChecks > 0)
+        status = 'degraded';
+    if (failedChecks === checks.length)
+        status = 'unhealthy';
+    return {
+        status,
+        uptime: Math.floor((Date.now() - startTime) / 1000),
+        memory: {
+            used: Math.round(memUsage.heapUsed / 1024 / 1024),
+            total: Math.round(totalMem / 1024 / 1024),
+            percentage: Math.round((memUsage.heapUsed / totalMem) * 100 * 100) / 100,
+        },
+        version,
+        timestamp: new Date().toISOString(),
+        checks,
+    };
+}
+/**
+ * Register the health resource on the MCP server.
+ * @param server - The MCP server instance.
+ * @param version - The server version string.
+ */
+export function registerHealthResource(server, version) {
+    server.resource('health://status', 'health://status', async () => {
+        const health = await getHealthStatus(version);
+        return {
+            contents: [
+                {
+                    uri: 'health://status',
+                    mimeType: 'application/json',
+                    text: JSON.stringify(health, null, 2),
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=health.js.map

package/dist/resources/health.js.map

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