centaurus-cli 3.0.1 → 3.1.0

package/dist/tools/find-files.js

@@ -1,321 +1,280 @@
-import fg from 'fast-glob';
-import * as path from 'path';
-/**
- * FindFilesTool - Find files by name using fuzzy matching
- *
- * This tool uses fast-glob for efficient, cross-platform file searching
- * with gitignore support and smart result sorting.
- */
-export class FindFilesTool {
-    static DEFAULT_MAX_RESULTS = 10;
-    static EXCLUDE_PATTERNS = [
-        'node_modules/**',
-        'dist/**',
-        'build/**',
-        '.git/**',
-        '.next/**',
-        '.nuxt/**',
-        'coverage/**',
-        '.cache/**',
-        'out/**',
-        'target/**',
-        'vendor/**',
-    ];
-    /**
-     * Normalize file path to use forward slashes
-     */
-    normalizePath(filePath) {
-        return filePath.replace(/\\/g, '/');
+import fg from "fast-glob";
+import * as path from "path";
+class FindFilesTool {
+  static DEFAULT_MAX_RESULTS = 10;
+  static EXCLUDE_PATTERNS = [
+    "node_modules/**",
+    "dist/**",
+    "build/**",
+    ".git/**",
+    ".next/**",
+    ".nuxt/**",
+    "coverage/**",
+    ".cache/**",
+    "out/**",
+    "target/**",
+    "vendor/**"
+  ];
+  /**
+   * Normalize file path to use forward slashes
+   */
+  normalizePath(filePath) {
+    return filePath.replace(/\\/g, "/");
+  }
+  /**
+   * Validate glob pattern
+   */
+  validatePattern(pattern) {
+    if (pattern.includes("[") && !pattern.includes("]")) {
+      return {
+        valid: false,
+        error: `Invalid glob pattern: "${pattern}"
+Suggestion: Use valid glob syntax. Examples: "*.ts", "**/*.py", "*user*"`
+      };
     }
-    /**
-     * Validate glob pattern
-     */
-    validatePattern(pattern) {
-        // Check for common invalid patterns
-        if (pattern.includes('[') && !pattern.includes(']')) {
-            return {
-                valid: false,
-                error: `Invalid glob pattern: "${pattern}"\nSuggestion: Use valid glob syntax. Examples: "*.ts", "**/*.py", "*user*"`,
-            };
-        }
-        if (pattern.includes('{') && !pattern.includes('}')) {
-            return {
-                valid: false,
-                error: `Invalid glob pattern: "${pattern}"\nSuggestion: Use valid glob syntax. Examples: "*.ts", "**/*.py", "*user*"`,
-            };
-        }
-        return { valid: true };
+    if (pattern.includes("{") && !pattern.includes("}")) {
+      return {
+        valid: false,
+        error: `Invalid glob pattern: "${pattern}"
+Suggestion: Use valid glob syntax. Examples: "*.ts", "**/*.py", "*user*"`
+      };
     }
-    /**
-     * Calculate relevance score for sorting
-     * Lower score = more relevant
-     */
-    calculateRelevance(filePath, pattern) {
-        const fileName = path.basename(filePath);
-        const normalizedPattern = pattern.replace(/\*/g, '').toLowerCase();
-        const normalizedFileName = fileName.toLowerCase();
-        // Exact match gets highest priority
-        if (fileName === pattern || normalizedFileName === normalizedPattern) {
-            return 0;
-        }
-        // Exact match without extension
-        const fileNameWithoutExt = fileName.replace(/\.[^.]+$/, '');
-        if (fileNameWithoutExt === pattern || fileNameWithoutExt.toLowerCase() === normalizedPattern) {
-            return 1;
-        }
-        // Calculate path depth (shallower is better)
-        const depth = filePath.split('/').length;
-        // Combine factors: depth + position of match in filename
-        const matchIndex = normalizedFileName.indexOf(normalizedPattern);
-        const positionScore = matchIndex >= 0 ? matchIndex : 1000;
-        return depth * 10 + positionScore;
+    return { valid: true };
+  }
+  /**
+   * Calculate relevance score for sorting
+   * Lower score = more relevant
+   */
+  calculateRelevance(filePath, pattern) {
+    const fileName = path.basename(filePath);
+    const normalizedPattern = pattern.replace(/\*/g, "").toLowerCase();
+    const normalizedFileName = fileName.toLowerCase();
+    if (fileName === pattern || normalizedFileName === normalizedPattern) {
+      return 0;
     }
-    /**
-     * Sort files by relevance
-     */
-    sortByRelevance(files, pattern) {
-        return files.sort((a, b) => {
-            const scoreA = this.calculateRelevance(a, pattern);
-            const scoreB = this.calculateRelevance(b, pattern);
-            return scoreA - scoreB;
-        });
+    const fileNameWithoutExt = fileName.replace(/\.[^.]+$/, "");
+    if (fileNameWithoutExt === pattern || fileNameWithoutExt.toLowerCase() === normalizedPattern) {
+      return 1;
     }
-    /**
-     * Execute the file search
-     */
-    async execute(params, cwd, contextManager) {
-        // Validate pattern
-        const validation = this.validatePattern(params.pattern);
-        if (!validation.valid) {
-            throw new Error(validation.error);
-        }
-        const currentContext = contextManager?.getCurrentContext?.();
-        const isRemote = currentContext && currentContext.type !== 'local';
-        if (isRemote) {
-            return this.searchRemote(params, cwd, contextManager);
-        }
-        const maxResults = params.maxResults ?? FindFilesTool.DEFAULT_MAX_RESULTS;
-        const searchType = params.searchType ?? 'all';
-        try {
-            // Determine search options based on searchType
-            const searchOptions = {
-                cwd,
-                ignore: FindFilesTool.EXCLUDE_PATTERNS,
-                caseSensitiveMatch: false,
-                dot: false, // Don't include hidden files by default
-                suppressErrors: true, // Gracefully handle permission errors
-            };
-            if (searchType === 'files') {
-                searchOptions.onlyFiles = true;
-                searchOptions.onlyDirectories = false;
-            }
-            else if (searchType === 'directories') {
-                searchOptions.onlyFiles = false;
-                searchOptions.onlyDirectories = true;
-            }
-            else {
-                // 'all' - search both files and directories
-                searchOptions.onlyFiles = false;
-                searchOptions.onlyDirectories = false;
-            }
-            // Build patterns to search - handle multi-word patterns for fuzzy matching
-            const patterns = [];
-            // Auto-prefix with **/ if pattern is simple (no path separators) and not already recursive
-            // This allows finding "file.txt" anywhere in the project without typing "**/"
-            let mainPattern = params.pattern;
-            const normalizedPattern = mainPattern.replace(/\\/g, '/');
-            if (!normalizedPattern.includes('/') && !normalizedPattern.startsWith('**')) {
-                mainPattern = `**/${mainPattern}`;
-            }
-            // Always add the main pattern
-            patterns.push(mainPattern);
-            // If pattern contains spaces or is multi-word (without glob chars), also search individual terms
-            const cleanPattern = params.pattern.replace(/\*\*/g, '').replace(/\*/g, '').trim();
-            if (cleanPattern.includes(' ')) {
-                const words = cleanPattern.split(/\s+/).filter(w => w.length > 2); // Skip very short words
-                for (const word of words) {
-                    // Add pattern for each word
-                    patterns.push(`**/*${word}*`);
-                }
-            }
-            // Execute search for all patterns and merge results
-            const allFiles = [];
-            const seenFiles = new Set();
-            for (const searchPattern of patterns) {
-                try {
-                    const files = await fg(searchPattern, searchOptions);
-                    for (const file of files) {
-                        const normalizedFile = this.normalizePath(String(file));
-                        if (!seenFiles.has(normalizedFile)) {
-                            seenFiles.add(normalizedFile);
-                            allFiles.push(normalizedFile);
-                        }
-                    }
-                }
-                catch (patternError) {
-                    // Skip individual pattern errors (permission issues, etc.)
-                    continue;
-                }
-            }
-            // Sort by relevance
-            const sortedFiles = this.sortByRelevance(allFiles, params.pattern);
-            // Truncate results
-            const totalFound = sortedFiles.length;
-            const truncated = totalFound > maxResults;
-            const resultFiles = sortedFiles.slice(0, maxResults);
-            return {
-                files: resultFiles,
-                totalFound,
-                truncated,
-                searchPattern: params.pattern,
-            };
-        }
-        catch (error) {
-            // Return empty results with helpful message instead of crashing
-            if (error.message?.includes('EPERM') || error.message?.includes('EACCES')) {
-                return {
-                    files: [],
-                    totalFound: 0,
-                    truncated: false,
-                    searchPattern: params.pattern,
-                };
-            }
-            throw new Error(`File search failed: ${error.message}`);
-        }
+    const depth = filePath.split("/").length;
+    const matchIndex = normalizedFileName.indexOf(normalizedPattern);
+    const positionScore = matchIndex >= 0 ? matchIndex : 1e3;
+    return depth * 10 + positionScore;
+  }
+  /**
+   * Sort files by relevance
+   */
+  sortByRelevance(files, pattern) {
+    return files.sort((a, b) => {
+      const scoreA = this.calculateRelevance(a, pattern);
+      const scoreB = this.calculateRelevance(b, pattern);
+      return scoreA - scoreB;
+    });
+  }
+  /**
+   * Execute the file search
+   */
+  async execute(params, cwd, contextManager) {
+    const validation = this.validatePattern(params.pattern);
+    if (!validation.valid) {
+      throw new Error(validation.error);
     }
-    async searchRemote(params, cwd, contextManager) {
-        const maxResults = params.maxResults ?? FindFilesTool.DEFAULT_MAX_RESULTS;
-        const searchType = params.searchType ?? 'all';
-        // Check OS type of remote
-        const currentContext = contextManager.getCurrentContext();
-        const isWindows = currentContext.metadata?.os === 'windows';
-        let command;
-        let mainPattern = params.pattern.replace(/\*\*/g, '*'); // simplify glob for find
-        if (!mainPattern.includes('*')) {
-            mainPattern = `*${mainPattern}*`;
-        }
-        if (isWindows) {
-            // PowerShell Get-ChildItem
-            let typeFilter = '';
-            if (searchType === 'files')
-                typeFilter = '-File';
-            else if (searchType === 'directories')
-                typeFilter = '-Directory';
-            command = `Get-ChildItem -Path . -Recurse ${typeFilter} -Filter "${mainPattern}" -ErrorAction SilentlyContinue | Select-Object -First ${maxResults} | Select-Object -ExpandProperty FullName`;
-        }
-        else {
-            // Unix find
-            let typeFilter = '';
-            if (searchType === 'files')
-                typeFilter = '-type f';
-            else if (searchType === 'directories')
-                typeFilter = '-type d';
-            // Escape pattern
-            const escapedPattern = mainPattern.replace(/'/g, "'\\''");
-            // We'll search up to maxResults, ignore permission denied errors
-            command = `find . ${typeFilter} -name '${escapedPattern}' 2>/dev/null | head -n ${maxResults}`;
+    const currentContext = contextManager?.getCurrentContext?.();
+    const isRemote = currentContext && currentContext.type !== "local";
+    if (isRemote) {
+      return this.searchRemote(params, cwd, contextManager);
+    }
+    const maxResults = params.maxResults ?? FindFilesTool.DEFAULT_MAX_RESULTS;
+    const searchType = params.searchType ?? "all";
+    try {
+      const searchOptions = {
+        cwd,
+        ignore: FindFilesTool.EXCLUDE_PATTERNS,
+        caseSensitiveMatch: false,
+        dot: false,
+        // Don't include hidden files by default
+        suppressErrors: true
+        // Gracefully handle permission errors
+      };
+      if (searchType === "files") {
+        searchOptions.onlyFiles = true;
+        searchOptions.onlyDirectories = false;
+      } else if (searchType === "directories") {
+        searchOptions.onlyFiles = false;
+        searchOptions.onlyDirectories = true;
+      } else {
+        searchOptions.onlyFiles = false;
+        searchOptions.onlyDirectories = false;
+      }
+      const patterns = [];
+      let mainPattern = params.pattern;
+      const normalizedPattern = mainPattern.replace(/\\/g, "/");
+      if (!normalizedPattern.includes("/") && !normalizedPattern.startsWith("**")) {
+        mainPattern = `**/${mainPattern}`;
+      }
+      patterns.push(mainPattern);
+      const cleanPattern = params.pattern.replace(/\*\*/g, "").replace(/\*/g, "").trim();
+      if (cleanPattern.includes(" ")) {
+        const words = cleanPattern.split(/\s+/).filter((w) => w.length > 2);
+        for (const word of words) {
+          patterns.push(`**/*${word}*`);
         }
+      }
+      const allFiles = [];
+      const seenFiles = /* @__PURE__ */ new Set();
+      for (const searchPattern of patterns) {
         try {
-            const result = await contextManager.executeCommand(command, 30000, cwd);
-            const output = result.stdout;
-            const files = output.split('\n')
-                .map((line) => line.trim())
-                .filter((line) => line.length > 0)
-                .map((line) => this.normalizePath(line.startsWith('./') ? line.substring(2) : line));
-            return {
-                files,
-                totalFound: files.length,
-                truncated: files.length >= maxResults,
-                searchPattern: params.pattern
-            };
-        }
-        catch (error) {
-            return {
-                files: [],
-                totalFound: 0,
-                truncated: false,
-                searchPattern: params.pattern
-            };
+          const files = await fg(searchPattern, searchOptions);
+          for (const file of files) {
+            const normalizedFile = this.normalizePath(String(file));
+            if (!seenFiles.has(normalizedFile)) {
+              seenFiles.add(normalizedFile);
+              allFiles.push(normalizedFile);
+            }
+          }
+        } catch (patternError) {
+          continue;
         }
+      }
+      const sortedFiles = this.sortByRelevance(allFiles, params.pattern);
+      const totalFound = sortedFiles.length;
+      const truncated = totalFound > maxResults;
+      const resultFiles = sortedFiles.slice(0, maxResults);
+      return {
+        files: resultFiles,
+        totalFound,
+        truncated,
+        searchPattern: params.pattern
+      };
+    } catch (error) {
+      if (error.message?.includes("EPERM") || error.message?.includes("EACCES")) {
+        return {
+          files: [],
+          totalFound: 0,
+          truncated: false,
+          searchPattern: params.pattern
+        };
+      }
+      throw new Error(`File search failed: ${error.message}`);
     }
-}
-/**
- * Format find files results for display
- */
-function formatFindFilesResults(result) {
-    if (result.files.length === 0) {
-        return `No files found matching pattern "${result.searchPattern}"\nSuggestion: Try a broader pattern like "*${result.searchPattern}*" or check if the file exists in the project.`;
+  }
+  async searchRemote(params, cwd, contextManager) {
+    const maxResults = params.maxResults ?? FindFilesTool.DEFAULT_MAX_RESULTS;
+    const searchType = params.searchType ?? "all";
+    const currentContext = contextManager.getCurrentContext();
+    const isWindows = currentContext.metadata?.os === "windows";
+    let command;
+    let mainPattern = params.pattern.replace(/\*\*/g, "*");
+    if (!mainPattern.includes("*")) {
+      mainPattern = `*${mainPattern}*`;
     }
-    const lines = [];
-    lines.push(`Found ${result.totalFound} file${result.totalFound === 1 ? '' : 's'} matching pattern "${result.searchPattern}"`);
-    if (result.truncated) {
-        lines.push(`(showing first ${result.files.length} matches)`);
+    if (isWindows) {
+      let typeFilter = "";
+      if (searchType === "files") typeFilter = "-File";
+      else if (searchType === "directories") typeFilter = "-Directory";
+      command = `Get-ChildItem -Path . -Recurse ${typeFilter} -Filter "${mainPattern}" -ErrorAction SilentlyContinue | Select-Object -First ${maxResults} | Select-Object -ExpandProperty FullName`;
+    } else {
+      let typeFilter = "";
+      if (searchType === "files") typeFilter = "-type f";
+      else if (searchType === "directories") typeFilter = "-type d";
+      const escapedPattern = mainPattern.replace(/'/g, "'\\''");
+      command = `find . ${typeFilter} -name '${escapedPattern}' 2>/dev/null | head -n ${maxResults}`;
     }
-    lines.push('');
-    for (const file of result.files) {
-        lines.push(`  ${file}`);
+    try {
+      const result = await contextManager.executeCommand(command, 3e4, cwd);
+      const output = result.stdout;
+      const files = output.split("\n").map((line) => line.trim()).filter((line) => line.length > 0).map((line) => this.normalizePath(line.startsWith("./") ? line.substring(2) : line));
+      return {
+        files,
+        totalFound: files.length,
+        truncated: files.length >= maxResults,
+        searchPattern: params.pattern
+      };
+    } catch (error) {
+      return {
+        files: [],
+        totalFound: 0,
+        truncated: false,
+        searchPattern: params.pattern
+      };
     }
-    return lines.join('\n');
+  }
+}
+function formatFindFilesResults(result) {
+  if (result.files.length === 0) {
+    return `No files found matching pattern "${result.searchPattern}"
+Suggestion: Try a broader pattern like "*${result.searchPattern}*" or check if the file exists in the project.`;
+  }
+  const lines = [];
+  lines.push(`Found ${result.totalFound} file${result.totalFound === 1 ? "" : "s"} matching pattern "${result.searchPattern}"`);
+  if (result.truncated) {
+    lines.push(`(showing first ${result.files.length} matches)`);
+  }
+  lines.push("");
+  for (const file of result.files) {
+    lines.push(`  ${file}`);
+  }
+  return lines.join("\n");
 }
-/**
- * Find files tool for the tool registry
- */
-export const findFilesTool = {
-    schema: {
-        name: 'find_files',
-        description: `Find files AND folders by name using glob patterns without knowing exact paths.
-
-USE THIS TOOL WHEN:
-- User mentions a file or folder name without providing the full path
-- You need to locate a file or directory but don't know where it is
-- You want to find all files/folders matching a pattern (e.g., all test files, or a project folder)
-- Searching for multi-word names like "Major Project" or "control system"
-
-EXAMPLES:
-- Find a folder: pattern="*Major Project*" or pattern="**/*Major*Project*"
-- Find user controller: pattern="*user*controller*"
-- Find specific file: pattern="database.ts"
-- Find all test files: pattern="**/*.test.ts"
-- Find by partial name: pattern="*screenshot*" (finds files AND folders containing "screenshot")
-
-IMPORTANT: This tool searches BOTH files AND directories by default. For multi-word searches,
-it also searches for each word individually to give you more results.
-
+const findFilesTool = {
+  schema: {
+    name: "find_files",
+    description: `Find files AND folders by name using glob patterns without knowing exact paths.
+
+USE THIS TOOL WHEN:
+- User mentions a file or folder name without providing the full path
+- You need to locate a file or directory but don't know where it is
+- You want to find all files/folders matching a pattern (e.g., all test files, or a project folder)
+- Searching for multi-word names like "Major Project" or "control system"
+
+EXAMPLES:
+- Find a folder: pattern="*Major Project*" or pattern="**/*Major*Project*"
+- Find user controller: pattern="*user*controller*"
+- Find specific file: pattern="database.ts"
+- Find all test files: pattern="**/*.test.ts"
+- Find by partial name: pattern="*screenshot*" (finds files AND folders containing "screenshot")
+
+IMPORTANT: This tool searches BOTH files AND directories by default. For multi-word searches,
+it also searches for each word individually to give you more results.
+
 Use this BEFORE trying to read a file when you don't know its exact path.`,
-        parameters: {
-            type: 'object',
-            properties: {
-                pattern: {
-                    type: 'string',
-                    description: 'Glob pattern to match file/folder names. Use * for wildcards, ** for recursive search. For multi-word names use *word1*word2* pattern.',
-                },
-                maxResults: {
-                    type: 'number',
-                    description: 'Maximum number of results to return. Default: 10',
-                },
-                searchType: {
-                    type: 'string',
-                    enum: ['all', 'files', 'directories'],
-                    description: 'What to search for: "all" (default - files and directories), "files" (only files), "directories" (only folders)',
-                },
-            },
-            required: ['pattern'],
+    parameters: {
+      type: "object",
+      properties: {
+        pattern: {
+          type: "string",
+          description: "Glob pattern to match file/folder names. Use * for wildcards, ** for recursive search. For multi-word names use *word1*word2* pattern."
         },
-    },
-    async execute(args, context) {
-        const tool = new FindFilesTool();
-        const params = {
-            pattern: args.pattern,
-            maxResults: args.maxResults,
-            searchType: args.searchType,
-        };
-        try {
-            const result = await tool.execute(params, context.cwd, context.contextManager);
-            return formatFindFilesResults(result);
-        }
-        catch (error) {
-            throw new Error(`Find files failed: ${error.message}`);
+        maxResults: {
+          type: "number",
+          description: "Maximum number of results to return. Default: 10"
+        },
+        searchType: {
+          type: "string",
+          enum: ["all", "files", "directories"],
+          description: 'What to search for: "all" (default - files and directories), "files" (only files), "directories" (only folders)'
         }
-    },
+      },
+      required: ["pattern"]
+    }
+  },
+  async execute(args, context) {
+    const tool = new FindFilesTool();
+    const params = {
+      pattern: args.pattern,
+      maxResults: args.maxResults,
+      searchType: args.searchType
+    };
+    try {
+      const result = await tool.execute(params, context.cwd, context.contextManager);
+      return formatFindFilesResults(result);
+    } catch (error) {
+      throw new Error(`Find files failed: ${error.message}`);
+    }
+  }
+};
+export {
+  FindFilesTool,
+  findFilesTool
 };
 //# sourceMappingURL=find-files.js.map