codedev-mcp 3.2.0

package/dist/search/fast-search.js

@@ -0,0 +1,387 @@
+/**
+ * Fast Code Search Engine
+ * Uses ripgrep (rg) for blazing fast search, falls back to grep
+ * Handles codebases of any size efficiently
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+const execFileAsync = promisify(execFile);
+let _rgAvailable = null;
+/**
+ * Checks if ripgrep (rg) is available in the system path.
+ * Caches the result for subsequent calls.
+ *
+ * @returns Promise resolving to true if rg is available, false otherwise.
+ */
+async function isRgAvailable() {
+    if (_rgAvailable !== null)
+        return _rgAvailable;
+    try {
+        await execFileAsync('rg', ['--version']);
+        _rgAvailable = true;
+    }
+    catch {
+        _rgAvailable = false;
+    }
+    return _rgAvailable;
+}
+/**
+ * Resets the cached availability of ripgrep.
+ * Intended for testing purposes only.
+ */
+export function resetRgAvailability() {
+    _rgAvailable = null;
+}
+/**
+ * Primary search function that delegates to ripgrep if available, otherwise falls back to grep.
+ *
+ * @param opts - The search options including pattern, cwd, and filters.
+ * @returns A promise resolving to an array of search results.
+ */
+export async function searchCode(opts) {
+    if (await isRgAvailable()) {
+        return searchWithRipgrep(opts);
+    }
+    return searchWithGrep(opts);
+}
+/**
+ * Default list of directories to exclude from search to improve performance.
+ */
+const DEFAULT_EXCLUDES = [
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '__pycache__',
+    '.venv',
+    'venv',
+    '.tox',
+    '.mypy_cache',
+    'target',
+    'bin',
+    'obj',
+    '.next',
+    '.nuxt',
+    'coverage',
+    '.pytest_cache',
+    '.gradle',
+    'vendor',
+    'Pods',
+    '.dart_tool',
+    '.pub-cache',
+];
+/**
+ * executes search using ripgrep.
+ *
+ * @param opts - Search options.
+ * @returns Array of matches.
+ */
+async function searchWithRipgrep(opts) {
+    const args = ['--json', '--line-number', '--column', '--no-heading'];
+    if (!opts.caseSensitive)
+        args.push('--ignore-case');
+    if (opts.wholeWord)
+        args.push('--word-regexp');
+    if (!opts.isRegex)
+        args.push('--fixed-strings');
+    if (opts.maxResults)
+        args.push('--max-count', String(opts.maxResults));
+    if (opts.contextLines) {
+        args.push('--before-context', String(opts.contextLines));
+        args.push('--after-context', String(opts.contextLines));
+    }
+    if (!opts.includeHidden)
+        args.push('--no-hidden');
+    const excludeDirs = [...DEFAULT_EXCLUDES, ...(opts.excludeDirs || [])];
+    for (const dir of excludeDirs) {
+        args.push('--glob', `!${dir}`);
+    }
+    if (opts.fileGlob) {
+        args.push('--glob', opts.fileGlob);
+    }
+    args.push(opts.pattern, '.');
+    try {
+        const { stdout } = await execFileAsync('rg', args, {
+            cwd: opts.cwd,
+            maxBuffer: 50 * 1024 * 1024,
+            timeout: 30000,
+        });
+        return parseRipgrepJson(stdout, opts.cwd);
+    }
+    catch (error) {
+        if (isExitCodeError(error) && error.code === 1)
+            return [];
+        if (error instanceof Error) {
+            throw new Error(`Search failed: ${error.message}`);
+        }
+        throw new Error('Search failed with unknown error');
+    }
+}
+/**
+ * Type guard for error with code property.
+ *
+ * @param error - The error to check.
+ * @returns True if error has a code property.
+ */
+function isExitCodeError(error) {
+    return typeof error === 'object' && error !== null && 'code' in error;
+}
+/**
+ * Parses the newline-delimited JSON output from ripgrep.
+ *
+ * @param output - Raw stdout from ripgrep.
+ * @param cwd - Current working directory to resolve relative paths.
+ * @returns Parsed search results.
+ */
+function parseRipgrepJson(output, cwd) {
+    const results = [];
+    const lines = output.split('\n').filter(Boolean);
+    for (const line of lines) {
+        try {
+            const parsed = JSON.parse(line);
+            if (parsed.type === 'match') {
+                const data = parsed.data;
+                results.push({
+                    file: path.relative(cwd, data.path.text),
+                    line: data.line_number,
+                    column: data.submatches?.[0]?.start,
+                    text: data.lines.text.trimEnd(),
+                });
+            }
+        }
+        catch {
+            // Intentionally suppressed: skip malformed lines
+        }
+    }
+    return results;
+}
+/**
+ * Executes search using standard grep (fallback).
+ *
+ * @param opts - Search options.
+ * @returns Array of matches.
+ */
+async function searchWithGrep(opts) {
+    const args = ['-r', '-n', '--line-number'];
+    if (!opts.caseSensitive)
+        args.push('-i');
+    if (opts.wholeWord)
+        args.push('-w');
+    if (!opts.isRegex)
+        args.push('-F');
+    if (opts.maxResults)
+        args.push('-m', String(opts.maxResults));
+    if (opts.contextLines) {
+        args.push('-B', String(opts.contextLines));
+        args.push('-A', String(opts.contextLines));
+    }
+    const excludeDirs = [
+        'node_modules',
+        '.git',
+        'dist',
+        'build',
+        '__pycache__',
+        '.venv',
+        'venv',
+        'target',
+        'bin',
+        'obj',
+        '.next',
+        'coverage',
+        'vendor',
+        ...(opts.excludeDirs || []),
+    ];
+    for (const dir of excludeDirs) {
+        args.push(`--exclude-dir=${dir}`);
+    }
+    if (opts.fileGlob) {
+        args.push(`--include=${opts.fileGlob}`);
+    }
+    args.push(opts.pattern, '.');
+    try {
+        const { stdout } = await execFileAsync('grep', args, {
+            cwd: opts.cwd,
+            maxBuffer: 50 * 1024 * 1024,
+            timeout: 30000,
+        });
+        return parseGrepOutput(stdout);
+    }
+    catch (error) {
+        if (isExitCodeError(error) && error.code === 1)
+            return [];
+        if (error instanceof Error) {
+            throw new Error(`Search failed: ${error.message}`);
+        }
+        throw new Error('Search failed with unknown error');
+    }
+}
+/**
+ * Parses the standard grep output.
+ *
+ * @param output - Raw stdout from grep.
+ * @returns Parsed search results.
+ */
+function parseGrepOutput(output) {
+    const results = [];
+    const lines = output.split('\n').filter(Boolean);
+    for (const line of lines) {
+        const match = line.match(/^\.?\/?(.+?):(\d+):(.*)$/);
+        if (match) {
+            results.push({
+                file: match[1],
+                line: parseInt(match[2], 10),
+                text: match[3].trimEnd(),
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Lists files in a directory using 'fd' or 'find'.
+ *
+ * @param cwd - Directory to search in.
+ * @param options - Filtering options.
+ * @returns List of file paths relative to cwd.
+ */
+export async function listFiles(cwd, options) {
+    const excludes = [
+        'node_modules',
+        '.git',
+        'dist',
+        'build',
+        '__pycache__',
+        '.venv',
+        'venv',
+        'target',
+        'bin',
+        'obj',
+        '.next',
+        'coverage',
+        'vendor',
+        'Pods',
+        '.dart_tool',
+        ...(options?.excludeDirs || []),
+    ];
+    try {
+        const fdArgs = [];
+        if (options?.type === 'file')
+            fdArgs.push('--type', 'f');
+        else if (options?.type === 'dir')
+            fdArgs.push('--type', 'd');
+        if (options?.maxDepth)
+            fdArgs.push('--max-depth', String(options.maxDepth));
+        for (const dir of excludes)
+            fdArgs.push('--exclude', dir);
+        fdArgs.push('--hidden');
+        if (options?.glob)
+            fdArgs.push('--glob', options.glob);
+        else
+            fdArgs.push('.');
+        const { stdout } = await execFileAsync('fd', fdArgs, { cwd, maxBuffer: 20 * 1024 * 1024, timeout: 15000 });
+        return stdout.split('\n').filter(Boolean);
+    }
+    catch {
+        // Fallback to find if fd fails
+    }
+    try {
+        const findArgs = ['.'];
+        if (options?.maxDepth)
+            findArgs.push('-maxdepth', String(options.maxDepth));
+        const excludeExpr = [];
+        for (const dir of excludes) {
+            excludeExpr.push('-name', dir, '-o');
+        }
+        if (excludeExpr.length > 0) {
+            excludeExpr.pop();
+            findArgs.push('(', ...excludeExpr, ')', '-prune', '-o');
+        }
+        if (options?.type === 'file')
+            findArgs.push('-type', 'f');
+        else if (options?.type === 'dir')
+            findArgs.push('-type', 'd');
+        if (options?.glob) {
+            findArgs.push('-name', options.glob);
+        }
+        findArgs.push('-print');
+        const { stdout } = await execFileAsync('find', findArgs, {
+            cwd,
+            maxBuffer: 20 * 1024 * 1024,
+            timeout: 15000,
+        });
+        return stdout
+            .split('\n')
+            .filter(Boolean)
+            .map((f) => f.replace(/^\.\//, ''));
+    }
+    catch (error) {
+        // Handle permission errors gracefully - find may write to stderr but still succeed
+        // In CI environments, find can encounter permission denied errors for system directories
+        const err = error;
+        // If we have stdout despite errors, use it (find can succeed with permission warnings)
+        if (err.stdout) {
+            return err.stdout
+                .split('\n')
+                .filter(Boolean)
+                .map((f) => f.replace(/^\.\//, ''));
+        }
+        // If it's just permission errors, return empty array (common in CI environments)
+        const stderr = err.stderr || '';
+        const message = err instanceof Error ? err.message : err.message || String(err);
+        if (stderr.includes('Permission denied') ||
+            stderr.includes('permission') ||
+            message.includes('Permission denied') ||
+            message.includes('permission')) {
+            return [];
+        }
+        throw new Error(`File listing failed: ${message}`);
+    }
+}
+/**
+ * Counts the number of lines in a file efficiently using 'wc -l'.
+ *
+ * @param filePath - Path to the file.
+ * @returns Number of lines.
+ */
+export async function countLines(filePath) {
+    try {
+        const { stdout } = await execFileAsync('wc', ['-l', filePath]);
+        return parseInt(stdout.trim().split(/\s+/)[0], 10);
+    }
+    catch {
+        const content = await readFile(filePath, 'utf-8');
+        return content.split('\n').length;
+    }
+}
+/**
+ * Reads a specific range of lines from a file.
+ *
+ * @param filePath - Path to the file.
+ * @param startLine - 1-based start line.
+ * @param endLine - 1-based end line (inclusive).
+ * @returns Content and total line count.
+ */
+export async function readFileRange(filePath, startLine, endLine) {
+    if (!startLine && !endLine) {
+        const content = await readFile(filePath, 'utf-8');
+        return { content, totalLines: content.split('\n').length };
+    }
+    try {
+        const range = startLine && endLine ? `${startLine},${endLine}p` : startLine ? `${startLine},$p` : `1,${endLine}p`;
+        const { stdout } = await execFileAsync('sed', ['-n', range, filePath]);
+        const total = await countLines(filePath);
+        return { content: stdout, totalLines: total };
+    }
+    catch {
+        const content = await readFile(filePath, 'utf-8');
+        const lines = content.split('\n');
+        const start = (startLine || 1) - 1;
+        const end = endLine || lines.length;
+        return {
+            content: lines.slice(start, end).join('\n'),
+            totalLines: lines.length,
+        };
+    }
+}
+//# sourceMappingURL=fast-search.js.map

package/dist/search/fast-search.js.map

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

package/dist/search/semantic.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Semantic code search using TF-IDF scoring.
+ * No external model dependencies — works offline, instant startup.
+ *
+ * Answers queries like "find authentication logic" or "error handling code"
+ * by matching against function names, comments, imports, and string literals.
+ */
+interface SemanticResult {
+    file: string;
+    startLine: number;
+    endLine: number;
+    score: number;
+    snippet: string;
+    matchedTerms: string[];
+}
+/**
+ * Perform semantic search across files.
+ * @param files - List of file paths to search.
+ * @param query - The search query string.
+ * @param cwd - The working directory.
+ * @param maxResults - Maximum number of results to return.
+ * @returns Ranked search results with scores and snippets.
+ */
+export declare function semanticSearch(files: string[], query: string, cwd: string, maxResults?: number): Promise<SemanticResult[]>;
+export {};
+//# sourceMappingURL=semantic.d.ts.map

package/dist/search/semantic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic.d.ts","sourceRoot":"","sources":["../../src/search/semantic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH,UAAU,cAAc;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AA2ZD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EAAE,EACf,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,UAAU,SAAK,GACd,OAAO,CAAC,cAAc,EAAE,CAAC,CA4D3B"}