pi-lens 3.6.3 → 3.6.4

package/clients/tree-sitter-client.js

@@ -1,601 +0,0 @@
-/**
- * Tree-sitter Structural Search Client for pi-lens
- *
- * Inspired by pi-lsp-extension's search-engine.ts and pattern-compiler.ts
- * Provides AST-aware structural search with metavariable capture.
- *
- * Uses web-tree-sitter (WASM) for parsing - no native compilation needed.
- *
- * Pattern syntax:
- *   $NAME    - Matches any single AST node, captures as NAME
- *   $$$NAME  - Matches zero or more sibling nodes (variadic)
- *
- * Example:
- *   "console.log($MSG)" matches any console.log call, captures argument as MSG
- *   "function $NAME($$$PARAMS) { $BODY }" matches function declarations
- */
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { EXCLUDED_DIRS } from "./file-utils.js";
-import { TreeSitterQueryLoader, } from "./tree-sitter-query-loader.js";
-// biome-ignore lint/suspicious/noExplicitAny: Module type
-const _LanguageLoader = null;
-// --- WASM Grammar Mapping ---
-const LANGUAGE_TO_GRAMMAR = {
-    typescript: "tree-sitter-typescript.wasm",
-    tsx: "tree-sitter-tsx.wasm",
-    javascript: "tree-sitter-javascript.wasm",
-    python: "tree-sitter-python.wasm",
-    rust: "tree-sitter-rust.wasm",
-    go: "tree-sitter-go.wasm",
-    java: "tree-sitter-java.wasm",
-    c: "tree-sitter-c.wasm",
-    cpp: "tree-sitter-cpp.wasm",
-    ruby: "tree-sitter-ruby.wasm",
-};
-// --- Parser Manager ---
-export class TreeSitterClient {
-    constructor(verbose = false) {
-        this.initialized = false;
-        this.languages = new Map();
-        this.parsers = new Map();
-        // biome-ignore lint/suspicious/noExplicitAny: Optional dependency loaded dynamically
-        this.ParserClass = null;
-        // biome-ignore lint/suspicious/noExplicitAny: Language loader from module
-        this.LanguageLoader = null;
-        // biome-ignore lint/suspicious/noExplicitAny: Compiled query cache by language+pattern hash
-        this.queryCache = new Map();
-        this.queryLoader = new TreeSitterQueryLoader();
-        this.queriesLoaded = false;
-        this.grammarsDir = this.findGrammarsDir();
-        this.verbose = verbose;
-    }
-    /** Debug logging helper */
-    dbg(msg) {
-        if (this.verbose) {
-            console.error(`[tree-sitter] ${msg}`);
-        }
-    }
-    /** Find tree-sitter grammar directory */
-    findGrammarsDir() {
-        // Check for downloaded grammars in web-tree-sitter/grammars first
-        const downloadedGrammars = [
-            path.join(process.cwd(), "node_modules", "web-tree-sitter", "grammars"),
-        ];
-        // Add __dirname-based paths if __dirname is available (CommonJS)
-        if (typeof __dirname !== "undefined") {
-            downloadedGrammars.push(path.join(__dirname, "..", "..", "node_modules", "web-tree-sitter", "grammars"), path.join(__dirname, "..", "node_modules", "web-tree-sitter", "grammars"));
-        }
-        for (const dir of downloadedGrammars) {
-            if (fs.existsSync(dir) &&
-                fs.existsSync(path.join(dir, "tree-sitter-typescript.wasm"))) {
-                return dir;
-            }
-        }
-        // Fallback to legacy locations
-        const candidates = [
-            path.join(process.cwd(), "node_modules", "tree-sitter-wasms", "out"),
-        ];
-        if (typeof __dirname !== "undefined") {
-            candidates.push(path.join(__dirname, "..", "..", "node_modules", "tree-sitter-wasms", "out"), path.join(__dirname, "..", "node_modules", "tree-sitter-wasms", "out"));
-        }
-        for (const dir of candidates) {
-            if (fs.existsSync(dir))
-                return dir;
-        }
-        // Default to web-tree-sitter/grammars (may need manual download)
-        return downloadedGrammars[0];
-    }
-    /** Initialize tree-sitter WASM runtime */
-    async init() {
-        if (this.initialized)
-            return true;
-        try {
-            const mod = await import("web-tree-sitter");
-            // biome-ignore lint/suspicious/noExplicitAny: Dynamic import of optional dependency
-            const ParserClass = mod.Parser || mod.default || mod;
-            if (!ParserClass || typeof ParserClass.init !== "function") {
-                this.dbg("Parser class not found or missing init method");
-                return false;
-            }
-            // biome-ignore lint/suspicious/noExplicitAny: Parser class type
-            this.ParserClass = ParserClass;
-            // Store Language loader from module (not from Parser)
-            this.LanguageLoader = mod.Language;
-            // Log what we're trying to load
-            const wasmPath = path.join(process.cwd(), "node_modules", "web-tree-sitter", "tree-sitter.wasm");
-            this.dbg(`Looking for WASM at: ${wasmPath}, exists: ${fs.existsSync(wasmPath)}`);
-            await ParserClass.init({
-                locateFile: (scriptName) => {
-                    // Always return the full path to the WASM file
-                    const fullPath = path.join(process.cwd(), "node_modules", "web-tree-sitter", scriptName);
-                    this.dbg(`locateFile: ${scriptName} -> ${fullPath}`);
-                    return fullPath;
-                },
-            });
-            // Load queries after initialization
-            if (!this.queriesLoaded) {
-                try {
-                    await this.queryLoader.loadQueries();
-                    this.queriesLoaded = true;
-                    this.dbg(`Queries loaded successfully`);
-                }
-                catch (err) {
-                    this.dbg(`Failed to load queries: ${err}`);
-                    // Continue anyway - fallbacks will work
-                }
-            }
-            this.initialized = true;
-            return true;
-        }
-        catch (err) {
-            this.dbg(`Init error: ${err}`);
-            return false;
-        }
-    }
-    /** Load language grammar */
-    async loadLanguage(languageId) {
-        this.dbg(`Loading language: ${languageId}`);
-        if (this.languages.has(languageId)) {
-            this.dbg(`Language ${languageId} already loaded`);
-            return this.languages.get(languageId);
-        }
-        if (!this.ParserClass) {
-            this.dbg(`ParserClass not initialized`);
-            return null;
-        }
-        const grammarFile = LANGUAGE_TO_GRAMMAR[languageId];
-        if (!grammarFile) {
-            this.dbg(`No grammar file for ${languageId}`);
-            return null;
-        }
-        const grammarPath = path.join(this.grammarsDir, grammarFile);
-        this.dbg(`Grammar path: ${grammarPath}, exists: ${fs.existsSync(grammarPath)}`);
-        if (!fs.existsSync(grammarPath)) {
-            this.dbg(`Grammar file not found: ${grammarPath}`);
-            return null;
-        }
-        try {
-            if (!this.LanguageLoader?.load) {
-                this.dbg(`LanguageLoader.load not available`);
-                return null;
-            }
-            this.dbg(`Calling Language.load...`);
-            const language = await this.LanguageLoader.load(grammarPath);
-            this.dbg(`Language loaded: ${language?.name || "unknown"}`);
-            if (language) {
-                this.languages.set(languageId, language);
-            }
-            return language;
-        }
-        catch (err) {
-            this.dbg(`Language load error: ${err}`);
-            return null;
-        }
-    }
-    /** Get or create parser for a language */
-    async getParser(languageId) {
-        if (this.parsers.has(languageId)) {
-            return this.parsers.get(languageId);
-        }
-        const language = await this.loadLanguage(languageId);
-        if (!language || !this.ParserClass)
-            return null;
-        const parser = new this.ParserClass();
-        parser.setLanguage(language);
-        this.parsers.set(languageId, parser);
-        return parser;
-    }
-    /** Parse a file and return the AST tree */
-    async parseFile(filePath, languageId) {
-        this.dbg(`Parsing ${filePath} with language ${languageId}`);
-        const parser = await this.getParser(languageId);
-        if (!parser) {
-            this.dbg(`Failed to get parser for ${languageId}`);
-            return null;
-        }
-        try {
-            const content = fs.readFileSync(filePath, "utf-8");
-            this.dbg(`File content length: ${content.length}`);
-            const tree = parser.parse(content);
-            this.dbg(`Parsed, root node type: ${tree.rootNode.type}`);
-            return tree;
-        }
-        catch (err) {
-            this.dbg(`Parse error: ${err}`);
-            return null;
-        }
-    }
-    /** Check if tree-sitter is available (grammars installed) */
-    isAvailable() {
-        return fs.existsSync(this.grammarsDir);
-    }
-    /** Check if specific language is supported */
-    async isLanguageSupported(languageId) {
-        if (!this.initialized)
-            await this.init();
-        const language = await this.loadLanguage(languageId);
-        return language !== null;
-    }
-    /** Get loaded language for symbol extraction */
-    getLanguage(languageId) {
-        return this.languages.get(languageId) || null;
-    }
-    // --- Structural Search ---
-    /**
-     * Search for a structural pattern in files
-     *
-     * @param pattern - Pattern with metavariables (e.g., "console.log($MSG)")
-     * @param languageId - Language ID (typescript, python, etc.)
-     * @param rootDir - Directory to search
-     * @param options - Search options
-     * @returns Array of matches with captures
-     */
-    async structuralSearch(pattern, languageId, rootDir, options = {}) {
-        if (!this.initialized) {
-            const ok = await this.init();
-            if (!ok)
-                return [];
-        }
-        // Compile pattern into tree-sitter query
-        this.dbg(`Compiling pattern: ${pattern.slice(0, 50)}...`);
-        const compiled = await this.compileQuery(pattern, languageId);
-        if (!compiled) {
-            this.dbg(`Pattern compilation failed`);
-            return [];
-        }
-        this.dbg(`Pattern compiled, metavars: ${compiled.metavars.join(", ")}`);
-        // Collect source files
-        const files = this.collectFiles(rootDir, languageId, options.fileFilter);
-        this.dbg(`Scanning ${files.length} files...`);
-        const matches = [];
-        const maxResults = options.maxResults ?? 50;
-        for (const file of files) {
-            if (matches.length >= maxResults)
-                break;
-            const fileMatches = await this.searchFileWithQuery(file, compiled.query, compiled.metavars, languageId, pattern, compiled.postFilter, compiled.postFilterParams);
-            matches.push(...fileMatches);
-        }
-        return matches.slice(0, maxResults);
-    }
-    /**
-     * Convert pattern to tree-sitter query
-     * First tries to load from query files, then falls back to inline patterns
-     */
-    patternToQuery(pattern, languageId) {
-        // Try to find matching query from loaded files
-        const loadedQuery = this.queryLoader.findMatchingQuery(pattern, languageId);
-        if (loadedQuery) {
-            this.dbg(`Using loaded query: ${loadedQuery.id}`);
-            return {
-                query: loadedQuery.query,
-                metavars: loadedQuery.metavars,
-                postFilter: loadedQuery.post_filter,
-                postFilterParams: loadedQuery.post_filter_params,
-                queryDef: loadedQuery,
-            };
-        }
-        // Fallback to inline patterns
-        return this.getInlinePattern(pattern);
-    }
-    /**
-     * Inline patterns as fallback when no query file matches
-     */
-    getInlinePattern(pattern) {
-        // Pattern: async function $NAME($$$PARAMS) { $BODY }
-        if (pattern.includes("async function") && pattern.includes("$NAME")) {
-            return {
-                query: `(function_declaration
-					"async"
-					name: (identifier) @NAME
-					parameters: (formal_parameters) @PARAMS
-					body: (statement_block) @BODY)`,
-                metavars: ["NAME", "PARAMS", "BODY"],
-            };
-        }
-        // Pattern: console.$METHOD($MSG)
-        if (pattern.includes("console")) {
-            return {
-                query: `(call_expression
-					function: (member_expression
-						object: (identifier) @OBJ (#eq? @OBJ "console")
-						property: (property_identifier) @METHOD)
-					arguments: (arguments) @ARGS)`,
-                metavars: ["OBJ", "METHOD", "ARGS"],
-            };
-        }
-        // Pattern: function $NAME($$$PARAMS) { $BODY } - match long parameter lists
-        if (pattern.includes("function $NAME") && pattern.includes("PARAMS")) {
-            return {
-                query: `(function_declaration
-					name: (identifier) @NAME
-					parameters: (formal_parameters) @PARAMS
-					body: (statement_block) @BODY)`,
-                metavars: ["NAME", "PARAMS", "BODY"],
-                postFilter: "count_params",
-                postFilterParams: { min_params: 6 },
-            };
-        }
-        // Pattern: promise chains with .then().catch().then() - 3+ levels
-        if (pattern.includes(".then") && pattern.includes(".catch")) {
-            return {
-                query: `(call_expression
-					function: (member_expression
-						object: (call_expression
-							function: (member_expression
-								object: (call_expression
-									function: (member_expression
-										property: (property_identifier) @M1)
-									arguments: (arguments))
-								property: (property_identifier) @M2)
-							arguments: (arguments))
-						property: (property_identifier) @M3)
-					arguments: (arguments))
-					(#match? @M1 "^(then|catch)$")
-					(#match? @M2 "^(then|catch)$")
-					(#match? @M3 "^(then|catch)$")`,
-                metavars: ["M1", "M2", "M3"],
-            };
-        }
-        // Fallback: try to create a simple identifier capture
-        const simpleMatch = pattern.match(/\$([A-Z_][A-Z0-9_]*)/);
-        if (simpleMatch) {
-            const name = simpleMatch[1];
-            return {
-                query: `(identifier) @${name}`,
-                metavars: [name],
-            };
-        }
-        // If we can't convert, return empty to trigger fallback
-        return { query: "", metavars: [] };
-    }
-    /** Generate cache key for compiled query */
-    getQueryCacheKey(pattern, languageId) {
-        // Simple hash for the query string
-        let hash = 0;
-        for (let i = 0; i < pattern.length; i++) {
-            const char = pattern.charCodeAt(i);
-            hash = ((hash << 5) - hash + char) | 0;
-        }
-        return `${languageId}:${hash.toString(36)}`;
-    }
-    /** Compile a pattern into a tree-sitter Query with caching */
-    async compileQuery(pattern, languageId) {
-        const cacheKey = this.getQueryCacheKey(pattern, languageId);
-        // Check cache first
-        if (this.queryCache.has(cacheKey)) {
-            this.dbg(`Query cache hit: ${cacheKey}`);
-            return this.queryCache.get(cacheKey);
-        }
-        const language = await this.loadLanguage(languageId);
-        if (!language) {
-            this.dbg(`Could not load language ${languageId}`);
-            return null;
-        }
-        const { query: queryStr, metavars, postFilter, postFilterParams, } = this.patternToQuery(pattern, languageId);
-        this.dbg(`Query string: ${queryStr.slice(0, 100)}...`);
-        try {
-            // biome-ignore lint/suspicious/noExplicitAny: Query constructor
-            const Query = (await import("web-tree-sitter")).Query;
-            // biome-ignore lint/suspicious/noExplicitAny: Language type compatibility
-            const query = new Query(language, queryStr);
-            this.dbg(`Query compiled with ${query.patternCount} patterns`);
-            const result = { query, metavars, postFilter, postFilterParams };
-            // Cache the compiled query
-            this.queryCache.set(cacheKey, result);
-            return result;
-        }
-        catch (err) {
-            this.dbg(`Query compilation failed: ${err}`);
-            return null;
-        }
-    }
-    /** Search a single file using tree-sitter Query */
-    async searchFileWithQuery(filePath, 
-    // biome-ignore lint/suspicious/noExplicitAny: Query type from web-tree-sitter
-    query, metavars, languageId, _originalPattern, postFilter, 
-    // biome-ignore lint/suspicious/noExplicitAny: Post filter params
-    postFilterParams) {
-        const tree = await this.parseFile(filePath, languageId);
-        if (!tree)
-            return [];
-        const matches = [];
-        try {
-            // Use tree-sitter's native query matching
-            const queryMatches = query.matches(tree.rootNode);
-            for (const match of queryMatches) {
-                const captures = {};
-                // Extract captured metavariables (store nodes, not just text)
-                for (const capture of match.captures) {
-                    const name = capture.name;
-                    const node = capture.node;
-                    if (metavars.includes(name)) {
-                        captures[name] = node;
-                    }
-                }
-                // Apply post-filters if specified
-                if (postFilter === "count_params") {
-                    const paramsNode = captures.PARAMS;
-                    if (paramsNode) {
-                        // biome-ignore lint/suspicious/noExplicitAny: Count parameter nodes
-                        const paramCount = paramsNode.children.filter((c) => c.type === "required_parameter" ||
-                            c.type === "optional_parameter").length;
-                        const minParams = postFilterParams?.min_params || 6;
-                        if (paramCount < minParams)
-                            continue;
-                    }
-                }
-                if (postFilter === "empty_body") {
-                    const bodyNode = captures.BODY;
-                    if (bodyNode) {
-                        // Check if body has meaningful statements (not just comments/braces)
-                        // biome-ignore lint/suspicious/noExplicitAny: Check for meaningful statements
-                        const meaningfulStatements = bodyNode.children.filter((c) => c.isNamed &&
-                            c.type !== "comment" &&
-                            c.type !== "line_comment" &&
-                            c.type !== "block_comment");
-                        if (meaningfulStatements.length > 0)
-                            continue;
-                    }
-                }
-                if (postFilter === "bare_except_only") {
-                    const clauseNode = captures.CLAUSE;
-                    if (clauseNode) {
-                        // Check if this is a bare except (no identifier after except)
-                        // biome-ignore lint/suspicious/noExplicitAny: Check for identifier
-                        const hasIdentifier = clauseNode.children.some((c) => c.isNamed && c.type === "identifier");
-                        if (hasIdentifier)
-                            continue; // Skip if has identifier (not bare)
-                    }
-                }
-                if (postFilter === "has_mixed_async") {
-                    const bodyNode = captures.BODY;
-                    if (bodyNode) {
-                        const bodyText = bodyNode.text;
-                        // Check if body contains both await AND (.then() or .catch())
-                        const hasAwait = bodyText.includes("await");
-                        const hasPromiseChain = /\.\s*(then|catch)\s*\(/.test(bodyText);
-                        if (!hasAwait || !hasPromiseChain)
-                            continue; // Skip if not mixed
-                    }
-                }
-                if (postFilter === "not_dbg_method") {
-                    const methodNode = captures.METHOD;
-                    if (methodNode) {
-                        const methodName = methodNode.text;
-                        if (methodName === "dbg")
-                            continue; // Skip console.dbg()
-                    }
-                }
-                if (postFilter === "no_super_call") {
-                    const bodyNode = captures.BODY;
-                    if (bodyNode) {
-                        // Check if body contains actual super() call (not in comments)
-                        const bodyText = bodyNode.text;
-                        // Match super() or super.method() but not // super() in comments
-                        const superCallRegex = /(?<!\/\/.*)super\s*\(/;
-                        const hasSuperCall = superCallRegex.test(bodyText);
-                        if (hasSuperCall)
-                            continue; // Skip if has super() - this is the GOOD case
-                    }
-                }
-                // Use first capture for position info
-                if (match.captures.length > 0) {
-                    const firstNode = match.captures[0].node;
-                    // Convert captures to text for the result
-                    const textCaptures = {};
-                    for (const [name, node] of Object.entries(captures)) {
-                        textCaptures[name] = node.text;
-                    }
-                    matches.push({
-                        file: filePath,
-                        line: firstNode.startPosition.row + 1,
-                        column: firstNode.startPosition.column + 1,
-                        matchedText: firstNode.text,
-                        captures: textCaptures,
-                    });
-                }
-            }
-            if (matches.length > 0) {
-                this.dbg(`Found ${matches.length} matches in ${path.basename(filePath)}`);
-            }
-        }
-        catch (err) {
-            this.dbg(`Query matching error: ${err}`);
-        }
-        return matches;
-    }
-    /** Collect source files for a language */
-    collectFiles(dir, languageId, fileFilter) {
-        const files = [];
-        const extensions = this.getExtensionsForLanguage(languageId);
-        const scan = (d) => {
-            try {
-                const entries = fs.readdirSync(d, { withFileTypes: true });
-                for (const entry of entries) {
-                    const full = path.join(d, entry.name);
-                    if (entry.isDirectory()) {
-                        if (EXCLUDED_DIRS.includes(entry.name))
-                            continue;
-                        scan(full);
-                    }
-                    else if (extensions.some((ext) => entry.name.endsWith(ext))) {
-                        if (!fileFilter || fileFilter(full)) {
-                            files.push(full);
-                        }
-                    }
-                }
-            }
-            catch { }
-        };
-        scan(dir);
-        return files;
-    }
-    /** Get file extensions for a language */
-    getExtensionsForLanguage(languageId) {
-        const mapping = {
-            typescript: [".ts", ".mts", ".cts"],
-            tsx: [".tsx"],
-            javascript: [".js", ".mjs", ".cjs"],
-            python: [".py"],
-            rust: [".rs"],
-            go: [".go"],
-            java: [".java"],
-            c: [".c", ".h"],
-            cpp: [".cpp", ".hpp", ".cc", ".hh"],
-            ruby: [".rb"],
-        };
-        return mapping[languageId] || [];
-    }
-}
-// --- Simplified Pattern Search (regex fallback) ---
-/**
- * Fallback structural search using regex when tree-sitter unavailable
- * Less accurate but works without WASM dependencies
- */
-export function regexStructuralSearch(pattern, files, options = {}) {
-    const matches = [];
-    const maxResults = options.maxResults ?? 50;
-    // Extract pattern structure for regex
-    // "console.log($MSG)" -> /console\.log\(([^)]+)\)/
-    const regexPattern = pattern
-        .replace(/\./g, "\\.")
-        .replace(/\$\$\$[A-Z_][A-Z0-9_]*/g, "(.*?)") // variadic - non-greedy
-        .replace(/\$[A-Z_][A-Z0-9_]*/g, "([^,)]+)"); // single - capture group
-    try {
-        const regex = new RegExp(regexPattern, "g");
-        for (const file of files) {
-            if (matches.length >= maxResults)
-                break;
-            try {
-                const content = fs.readFileSync(file, "utf-8");
-                const lines = content.split("\n");
-                for (let i = 0; i < lines.length; i++) {
-                    regex.lastIndex = 0;
-                    const match = regex.exec(lines[i]);
-                    if (match) {
-                        const captures = {};
-                        // Extract captures
-                        for (let j = 1; j < match.length; j++) {
-                            captures[`$${j}`] = match[j];
-                        }
-                        matches.push({
-                            file,
-                            line: i + 1,
-                            column: match.index + 1,
-                            matchedText: match[0],
-                            captures,
-                        });
-                        if (matches.length >= maxResults)
-                            break;
-                    }
-                }
-            }
-            catch { }
-        }
-    }
-    catch {
-        // Invalid regex
-    }
-    return matches;
-}