/** * @license * Copyright 2025 Google LLC * SPDX-License-Identifier: Apache-2.0 */ import type { GitIgnoreFilter } from '../utils/gitIgnoreParser.js'; import type { IgnoreFileFilter } from '../utils/ignoreFileParser.js'; import { GitIgnoreParser } from '../utils/gitIgnoreParser.js'; import { IgnoreFileParser } from '../utils/ignoreFileParser.js'; import { isGitRepository } from '../utils/gitUtils.js'; import { GEMINI_IGNORE_FILE_NAME } from '../config/constants.js'; import fs from 'node:fs'; import * as path from 'node:path'; export interface FilterFilesOptions { respectGitIgnore?: boolean; respectGeminiIgnore?: boolean; customIgnoreFilePaths?: string[]; } export interface FilterReport { filteredPaths: string[]; ignoredCount: number; } export class FileDiscoveryService { private gitIgnoreFilter: GitIgnoreFilter | null = null; private geminiIgnoreFilter: IgnoreFileFilter | null = null; private customIgnoreFilter: IgnoreFileFilter | null = null; private combinedIgnoreFilter: GitIgnoreFilter | IgnoreFileFilter | null = null; private defaultFilterFileOptions: FilterFilesOptions = { respectGitIgnore: true, respectGeminiIgnore: true, customIgnoreFilePaths: [], }; private projectRoot: string; constructor(projectRoot: string, options?: FilterFilesOptions) { this.projectRoot = path.resolve(projectRoot); this.applyFilterFilesOptions(options); if (isGitRepository(this.projectRoot)) { this.gitIgnoreFilter = new GitIgnoreParser(this.projectRoot); } this.geminiIgnoreFilter = new IgnoreFileParser( this.projectRoot, GEMINI_IGNORE_FILE_NAME, ); if (this.defaultFilterFileOptions.customIgnoreFilePaths?.length) { this.customIgnoreFilter = new IgnoreFileParser( this.projectRoot, this.defaultFilterFileOptions.customIgnoreFilePaths, ); } if (this.gitIgnoreFilter) { const geminiPatterns = this.geminiIgnoreFilter.getPatterns(); const customPatterns = this.customIgnoreFilter ? this.customIgnoreFilter.getPatterns() : []; // Create combined parser: .gitignore + .geminiignore + custom ignore this.combinedIgnoreFilter = new GitIgnoreParser( this.projectRoot, // customPatterns should go the last to ensure overwriting of geminiPatterns [...geminiPatterns, ...customPatterns], ); } else { // Create combined parser when not git repo const geminiPatterns = this.geminiIgnoreFilter.getPatterns(); const customPatterns = this.customIgnoreFilter ? this.customIgnoreFilter.getPatterns() : []; this.combinedIgnoreFilter = new IgnoreFileParser( this.projectRoot, [...geminiPatterns, ...customPatterns], true, ); } } private applyFilterFilesOptions(options?: FilterFilesOptions): void { if (!options) return; if (options.respectGitIgnore !== undefined) { this.defaultFilterFileOptions.respectGitIgnore = options.respectGitIgnore; } if (options.respectGeminiIgnore !== undefined) { this.defaultFilterFileOptions.respectGeminiIgnore = options.respectGeminiIgnore; } if (options.customIgnoreFilePaths) { this.defaultFilterFileOptions.customIgnoreFilePaths = options.customIgnoreFilePaths; } } /** * Filters a list of file paths based on ignore rules */ filterFiles(filePaths: string[], options: FilterFilesOptions = {}): string[] { const { respectGitIgnore = this.defaultFilterFileOptions.respectGitIgnore, respectGeminiIgnore = this.defaultFilterFileOptions.respectGeminiIgnore, } = options; return filePaths.filter((filePath) => { if ( respectGitIgnore && respectGeminiIgnore && this.combinedIgnoreFilter ) { return !this.combinedIgnoreFilter.isIgnored(filePath); } // Always respect custom ignore filter if provided if (this.customIgnoreFilter?.isIgnored(filePath)) { return false; } if (respectGitIgnore && this.gitIgnoreFilter?.isIgnored(filePath)) { return false; } if (respectGeminiIgnore && this.geminiIgnoreFilter?.isIgnored(filePath)) { return false; } return true; }); } /** * Filters a list of file paths based on git ignore rules and returns a report * with counts of ignored files. */ filterFilesWithReport( filePaths: string[], opts: FilterFilesOptions = { respectGitIgnore: true, respectGeminiIgnore: true, }, ): FilterReport { const filteredPaths = this.filterFiles(filePaths, opts); const ignoredCount = filePaths.length - filteredPaths.length; return { filteredPaths, ignoredCount, }; } /** * Unified method to check if a file should be ignored based on filtering options */ shouldIgnoreFile( filePath: string, options: FilterFilesOptions = {}, ): boolean { return this.filterFiles([filePath], options).length === 0; } /** * Returns the list of ignore files being used (e.g. .geminiignore) excluding .gitignore. */ getIgnoreFilePaths(): string[] { const paths: string[] = []; if ( this.geminiIgnoreFilter && this.defaultFilterFileOptions.respectGeminiIgnore ) { paths.push(...this.geminiIgnoreFilter.getIgnoreFilePaths()); } if (this.customIgnoreFilter) { paths.push(...this.customIgnoreFilter.getIgnoreFilePaths()); } return paths; } /** * Returns all ignore files including .gitignore if applicable. */ getAllIgnoreFilePaths(): string[] { const paths: string[] = []; if ( this.gitIgnoreFilter && this.defaultFilterFileOptions.respectGitIgnore ) { const gitIgnorePath = path.join(this.projectRoot, '.gitignore'); if (fs.existsSync(gitIgnorePath)) { paths.push(gitIgnorePath); } } return paths.concat(this.getIgnoreFilePaths()); } }