Function getFileList

projects/electron/src/modules/code/files.ts:401–455

* Get file list for a directory, using cache if available

(
    dir: string,
    matchDirs: boolean
)

 * Get file list for a directory, using cache if available
 */
async function getFileList(
    dir: string,
    matchDirs: boolean
): Promise<{ items: string[]; source: "git" | "ripgrep" | "fs"; tree: TreeNode }> {
    const cacheKey = `${dir}:${matchDirs}`

    // Check cache
    const cached = fileListCache.get(cacheKey)
    if (cached) {
        logger.info("[Files:getFileList] Using cached file list", JSON.stringify({
            dir,
            matchDirs,
            count: cached.items.length,
        }))
        return { items: cached.items, source: cached.source, tree: cached.tree }
    }

    let items: string[] = []
    let source: "git" | "ripgrep" | "fs" = "fs"

    // Strategy 1: Use ripgrep if available (faster than git ls-files)
    const rgPath = (await getRipgrepPath()) || getManagedRipgrepPath()
    if (rgPath) {
        items = await listFilesWithRipgrep({ rgPath, dir, matchDirs })
        source = "ripgrep"
        logger.info("[Files:getFileList] Using ripgrep", JSON.stringify({ path: rgPath, count: items.length }))
    }

    // Strategy 2: Use git if ripgrep didn't work
    if (items.length === 0 && (await isGitRepo(dir))) {
        items = await listFilesWithGit({ dir, matchDirs })
        source = "git"
        logger.info("[Files:getFileList] Using git ls-files", JSON.stringify({ count: items.length }))
    }

    // Strategy 3: Fallback to filesystem walk
    if (items.length === 0) {
        items = listFilesWithFs({ dir, matchDirs })
        source = "fs"
        logger.info("[Files:getFileList] Using filesystem walk", JSON.stringify({ count: items.length }))
    }

    // Build tree for directory browsing
    const tree = buildTree(items)

    // Cache with auto-expiry
    const timeoutId = setTimeout(() => {
        fileListCache.delete(cacheKey)
        logger.info("[Files:getFileList] Cache expired", JSON.stringify({ cacheKey }))
    }, FILE_LIST_CACHE_TTL_MS)

    fileListCache.set(cacheKey, { items, source, tree, timeoutId })

    return { items, source, tree }
}

/**
 * Fuzzy search for files or directories