@usrrname/cursorrules/cli/utils/find-folder-up.mjs

A wicked npx-able lib of cursor rules with Otaku AI agents

import { stat } from 'node:fs/promises';
import { dirname, join, parse } from 'node:path';

/**
 * Traverses up the directory tree to find a specific folder.
 * @param {string} folderName The name of the folder to find (e.g., '.git', '.cursor').
 * @param {string} [startPath = process.cwd()] The path to start the upward search from.
 * @returns {Promise<string|null>} The absolute path to the found folder, or null if not found.
 */
export const findFolderUp = async (folderName, startPath = process.cwd()) => {
    let currentPath = startPath;
    const rootPath = parse(currentPath).root;

    while (true) {
        const candidatePath = join(currentPath, folderName);

        try {
            const stats = await stat(candidatePath);
            if (stats.isDirectory()) {
                return candidatePath;
            }
        } catch (err) {
            // expect ENOENT (No such file or directory) if folder is not found
            if (err.code !== 'ENOENT') {
                console.warn(`[findFolderUp]: Unexpected error while checking ${candidatePath}: ${err.message}`);
            }
        }

        // Move up to the parent directory
        const parentPath = dirname(currentPath);

        // If we've reached the root directory and haven't found it, stop.
        if (currentPath === rootPath) {
            console.error(`[findFolderUp]: Reached root '${rootPath}', '${folderName}' not found.`);
            return null;
        }

        currentPath = parentPath;
    }
}