centaurus-cli 2.9.3 → 2.9.5

package/dist/tools/grep-search.d.ts

@@ -6,77 +6,150 @@ export interface GrepSearchParams {
     CaseInsensitive?: boolean;
     IsRegex?: boolean;
     MatchPerLine?: boolean;
+    MaxResults?: number;
 }
+/**
+ * Context line with explicit line number tracking
+ */
+export interface ContextLine {
+    lineNumber: number;
+    text: string;
+}
+/**
+ * Enhanced match with column/offset information
+ */
 export interface GrepMatch {
     file: string;
     line: number;
+    column?: number;
+    byteOffset?: number;
     match: string;
-    contextBefore: string[];
-    contextAfter: string[];
+    matchIndices?: [number, number][];
+    contextBefore: ContextLine[];
+    contextAfter: ContextLine[];
+}
+/**
+ * Backend type - now includes powershell and nodejs
+ */
+export type GrepBackend = 'ripgrep' | 'grep' | 'powershell' | 'findstr' | 'nodejs' | 'remote';
+/**
+ * Reason for result truncation
+ */
+export type TruncationReason = 'max_matches' | 'backend_limit' | 'timeout';
+/**
+ * Search metadata for debugging and transparency
+ */
+export interface GrepSearchMetadata {
+    backend: GrepBackend;
+    searchDurationMs: number;
+    filesSearched?: number;
+    queriesExecuted: string[];
+    matchesPerQuery: Record<string, number>;
+    encodingFallback?: boolean;
 }
+/**
+ * Enhanced search result with structured data and metadata
+ */
 export interface GrepSearchResult {
+    matches: GrepMatch[];
+    totalMatches: number;
+    uniqueMatchesCount: number;
+    truncated: boolean;
+    truncationReason?: TruncationReason;
+    searchPattern: string;
+    metadata: GrepSearchMetadata;
+    formattedOutput: string;
+}
+/**
+ * Internal result before formatting
+ */
+interface InternalSearchResult {
     matches: GrepMatch[];
     totalMatches: number;
     truncated: boolean;
+    truncationReason?: TruncationReason;
     searchPattern: string;
+    filesSearched?: number;
+    encodingFallback?: boolean;
 }
 /**
- * GrepSearchTool - Search for text patterns across files in the codebase
+ * GrepSearchTool - Cross-platform text search with multiple backends
+ *
+ * Backend priority:
+ * 1. ripgrep (fastest, cross-platform)
+ * 2. grep (Linux/macOS native)
+ * 3. PowerShell Select-String (Windows, good Unicode support)
+ * 4. Pure Node.js (universal fallback, no dependencies)
  *
- * Improvements over basic implementation:
- * 1. Security: Uses execFile to prevent shell injection
- * 2. Robustness: Handles binary files and encoding issues (via rg/grep)
- * 3. AI-Friendly Output: Formats results for easy parsing
- * 4. Fallback: Gracefully degrades from ripgrep -> grep -> findstr
+ * Features:
+ * - Streaming output to handle large repos
+ * - Early abort when MAX_MATCHES reached
+ * - Proper encoding handling (UTF-8 with fallback)
+ * - CRLF normalization
+ * - Windows path support (drive letters, UNC)
  */
 export declare class GrepSearchTool {
-    private static readonly MAX_MATCHES;
+    static readonly DEFAULT_MAX_MATCHES = 50;
     private static readonly MAX_LINE_LENGTH;
     private static readonly CONTEXT_LINES;
+    private static readonly SEARCH_TIMEOUT;
+    private static toolCache;
     /**
-     * Check if ripgrep is available
+     * Check if a command is available
      */
+    private hasCommand;
     private hasRipgrep;
-    /**
-     * Check if native grep is available (Linux/Mac)
-     */
     private hasGrep;
+    private hasPowerShell;
     /**
-     * Normalize file path to use forward slashes
+     * Get the PowerShell executable name
      */
-    private normalizePath;
+    private getPowerShellExe;
     /**
-     * Check if a file path matches the Includes patterns
-     * Returns true if there are no patterns or if the file matches at least one pattern
+     * Normalize file path to forward slashes
      */
-    private matchesIncludesFilter;
+    private normalizePath;
     /**
      * Truncate long lines
      */
     private truncateLine;
     /**
-     * Execute search using ripgrep
+     * Normalize line endings (CRLF -> LF)
+     */
+    private normalizeLineEndings;
+    /**
+     * Parse file:line:content format robustly, handling Windows paths
+     * E.g., "C:\foo\bar.ts:42:content" or "/foo/bar.ts:42:content"
+     */
+    private parseGrepLine;
+    /**
+     * Create regex from pattern
      */
-    private searchWithRipgrep;
+    private createSearchRegex;
     /**
-     * Parse ripgrep JSON output
+     * Escape regex special characters
      */
-    private parseRipgrepOutput;
+    private escapeRegex;
     /**
-     * Execute search using native grep (Linux/Mac)
+     * Check if file matches include patterns
      */
-    private searchWithGrep;
-    private parseGrepOutput;
+    private matchesIncludesFilter;
     /**
-     * Execute search using findstr (Windows)
-     * NOTE: Context is DISABLED for findstr to avoid performance/encoding issues.
+     * Check if file is likely binary
      */
-    private searchWithFindstr;
-    private parseFindstrOutput;
+    private isBinaryFile;
+    private searchWithRipgrepStreaming;
+    private searchWithGrepStreaming;
+    private searchWithPowerShell;
+    private searchWithNodeJS;
     /**
-     * Execute the grep search
+     * Recursively collect files from directory
      */
-    execute(params: GrepSearchParams, cwd: string): Promise<GrepSearchResult>;
+    private collectFiles;
+    execute(params: GrepSearchParams, cwd: string): Promise<InternalSearchResult & {
+        backend: GrepBackend;
+    }>;
 }
 export declare const grepSearchTool: Tool;
+export {};
 //# sourceMappingURL=grep-search.d.ts.map

package/dist/tools/grep-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"grep-search.d.ts","sourceRoot":"","sources":["../../src/tools/grep-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAwB,MAAM,YAAY,CAAC;AAQxD,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAM;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAO;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAK;IAE1C;;OAEG;YACW,UAAU;IAiBxB;;OAEG;YACW,OAAO;IAiBrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAgC7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;YACW,iBAAiB;IA2D/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoF1B;;OAEG;YACW,cAAc;IAgD5B,OAAO,CAAC,eAAe;IAwEvB;;;OAGG;YACW,iBAAiB;IA6D/B,OAAO,CAAC,kBAAkB;IA2C1B;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAuDlF;AAsED,eAAO,MAAM,cAAc,EAAE,IAwH5B,CAAC"}
+{"version":3,"file":"grep-search.d.ts","sourceRoot":"","sources":["../../src/tools/grep-search.ts"],"names":[],"mappings":"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"}