Function grepFiles

src/util/agent/fsOperations.ts:116–166

(
  pattern: string,
  rootDir: string,
  options?: { path?: string; include?: string },
)

 * Returns up to MAX_GREP_MATCHES results.
 */
export async function grepFiles(
  pattern: string,
  rootDir: string,
  options?: { path?: string; include?: string },
): Promise<{
  matches: Array<{ file: string; line: number; content: string }>;
  truncated: boolean;
}> {
  const searchDir = options?.path ? await resolveAndValidate(options.path, rootDir) : rootDir;

  // Build grep command
  const args = ['-rn', '--binary-files=without-match'];
  if (options?.include) {
    args.push(`--include=${options.include}`);
  }
  // Cap output per-file
  args.push('-m', String(MAX_GREP_MATCHES));
  args.push('--', pattern, searchDir);

  try {
    const output = execSync(`grep ${args.map(shellEscape).join(' ')}`, {
      encoding: 'utf-8',
      maxBuffer: 1024 * 1024, // 1MB
      timeout: 30_000,
    });

    const lines = output.trim().split('\n').filter(Boolean);

    const allMatches = lines.map((line) => {
      // grep -n format: file:line:content
      const firstColon = line.indexOf(':');
      const secondColon = line.indexOf(':', firstColon + 1);
      const file = path.relative(rootDir, line.slice(0, firstColon));
      const lineNum = parseInt(line.slice(firstColon + 1, secondColon), 10);
      const content = line.slice(secondColon + 1).slice(0, 200); // cap line length
      return { file, line: lineNum, content };
    });

    // Enforce global cap — grep -m only limits per-file
    const truncated = allMatches.length >= MAX_GREP_MATCHES;
    const matches = allMatches.slice(0, MAX_GREP_MATCHES);

    return { matches, truncated };
  } catch (error) {
    // grep exits 1 when no matches found — that's not an error
    if (error && typeof error === 'object' && 'status' in error && error.status === 1) {
      return { matches: [], truncated: false };
    }
    throw error;
  }
}

function shellEscape(arg: string): string {
  return `'${arg.replace(/'/g, "'\\''")}'`;