@intellectronica/ruler/dist/core/FileSystemUtils.js

Ruler — apply the same rules to all coding agents

"use strict";
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
    if (k2 === undefined) k2 = k;
    var desc = Object.getOwnPropertyDescriptor(m, k);
    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
      desc = { enumerable: true, get: function() { return m[k]; } };
    }
    Object.defineProperty(o, k2, desc);
}) : (function(o, m, k, k2) {
    if (k2 === undefined) k2 = k;
    o[k2] = m[k];
}));
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
    Object.defineProperty(o, "default", { enumerable: true, value: v });
}) : function(o, v) {
    o["default"] = v;
});
var __importStar = (this && this.__importStar) || (function () {
    var ownKeys = function(o) {
        ownKeys = Object.getOwnPropertyNames || function (o) {
            var ar = [];
            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
            return ar;
        };
        return ownKeys(o);
    };
    return function (mod) {
        if (mod && mod.__esModule) return mod;
        var result = {};
        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
        __setModuleDefault(result, mod);
        return result;
    };
})();
Object.defineProperty(exports, "__esModule", { value: true });
exports.findRulerDir = findRulerDir;
exports.readMarkdownFiles = readMarkdownFiles;
exports.writeGeneratedFile = writeGeneratedFile;
exports.backupFile = backupFile;
exports.ensureDirExists = ensureDirExists;
const fs_1 = require("fs");
const path = __importStar(require("path"));
const os = __importStar(require("os"));
/**
 * Gets the XDG config directory path, falling back to ~/.config if XDG_CONFIG_HOME is not set.
 */
function getXdgConfigDir() {
    return process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config');
}
/**
 * Searches upwards from startPath to find a directory named .ruler.
 * If not found locally and checkGlobal is true, checks for global config at XDG_CONFIG_HOME/ruler.
 * Returns the path to the .ruler directory, or null if not found.
 */
async function findRulerDir(startPath, checkGlobal = true) {
    // First, search upwards from startPath for local .ruler directory
    let current = startPath;
    while (current) {
        const candidate = path.join(current, '.ruler');
        try {
            const stat = await fs_1.promises.stat(candidate);
            if (stat.isDirectory()) {
                return candidate;
            }
        }
        catch {
            // ignore errors when checking for .ruler directory
        }
        const parent = path.dirname(current);
        if (parent === current) {
            break;
        }
        current = parent;
    }
    // If no local .ruler found and checkGlobal is true, check global config directory
    if (checkGlobal) {
        const globalConfigDir = path.join(getXdgConfigDir(), 'ruler');
        try {
            const stat = await fs_1.promises.stat(globalConfigDir);
            if (stat.isDirectory()) {
                return globalConfigDir;
            }
        }
        catch (err) {
            console.error(`[ruler] Error checking global config directory ${globalConfigDir}:`, err);
        }
    }
    return null;
}
/**
 * Recursively reads all Markdown (.md) files in rulerDir, returning their paths and contents.
 * Files are sorted alphabetically by path.
 */
async function readMarkdownFiles(rulerDir) {
    const results = [];
    async function walk(dir) {
        const entries = await fs_1.promises.readdir(dir, { withFileTypes: true });
        for (const entry of entries) {
            const fullPath = path.join(dir, entry.name);
            if (entry.isDirectory()) {
                await walk(fullPath);
            }
            else if (entry.isFile() && entry.name.endsWith('.md')) {
                const content = await fs_1.promises.readFile(fullPath, 'utf8');
                results.push({ path: fullPath, content });
            }
        }
    }
    await walk(rulerDir);
    results.sort((a, b) => a.path.localeCompare(b.path));
    return results;
}
/**
 * Writes content to filePath, creating parent directories if necessary.
 */
async function writeGeneratedFile(filePath, content) {
    await fs_1.promises.mkdir(path.dirname(filePath), { recursive: true });
    await fs_1.promises.writeFile(filePath, content, 'utf8');
}
/**
 * Creates a backup of the given filePath by copying it to filePath.bak if it exists.
 */
async function backupFile(filePath) {
    try {
        await fs_1.promises.access(filePath);
        await fs_1.promises.copyFile(filePath, `${filePath}.bak`);
    }
    catch {
        // ignore if file does not exist
    }
}
/**
 * Ensures that the given directory exists by creating it recursively.
 */
async function ensureDirExists(dirPath) {
    await fs_1.promises.mkdir(dirPath, { recursive: true });
}