@intellectronica/ruler 0.2.7 → 0.2.9

package/README.md

@@ -48,6 +48,8 @@ Ruler solves this by providing a **single source of truth** for all your AI agen
 | Firebase Studio  | `.idx/airules.md`                                             |
 | Open Hands       | `.openhands/microagents/repo.md` and `.openhands/config.toml` |
 | Gemini CLI       | `GEMINI.md` and `.gemini/settings.json`                       |
+| Junie            | `.junie/guidelines.md`                                        |
+| AugmentCode      | `.augment-guidelines` and `.augmentcode/config.json`         |
 
 ## Getting Started
 
@@ -143,7 +145,7 @@ The `apply` command looks for `.ruler/` in the current directory tree, reading t
 | Option                         | Description                                               |
 | ------------------------------ | --------------------------------------------------------- |
 | `--project-root <path>`        | Path to your project's root (default: current directory)  |
-| `--agents <agent1,agent2,...>` | Comma-separated list of agent names to target             |
+| `--agents <agent1,agent2,...>` | Comma-separated list of agent names to target (copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie, augmentcode) |
 | `--config <path>`              | Path to a custom `ruler.toml` configuration file          |
 | `--mcp` / `--with-mcp`         | Enable applying MCP server configurations (default: true) |
 | `--no-mcp`                     | Disable applying MCP server configurations                |
@@ -191,6 +193,68 @@ ruler apply --verbose
 ruler apply --no-mcp --no-gitignore
 ```
 
+## Usage: The `revert` Command
+
+The `revert` command safely undoes all changes made by `ruler apply`, restoring your project to its pre-ruler state. It intelligently restores files from backups (`.bak` files) when available, or removes generated files that didn't exist before.
+
+### Why Revert is Needed
+
+When experimenting with different rule configurations or switching between projects, you may want to:
+- **Clean slate**: Remove all ruler-generated files to start fresh
+- **Restore originals**: Revert modified files back to their original state
+- **Selective cleanup**: Remove configurations for specific agents only
+- **Safe experimentation**: Try ruler without fear of permanent changes
+
+### Primary Command
+
+```bash
+ruler revert [options]
+```
+
+### Options
+
+| Option                         | Description                                               |
+| ------------------------------ | --------------------------------------------------------- |
+| `--project-root <path>`        | Path to your project's root (default: current directory)  |
+| `--agents <agent1,agent2,...>` | Comma-separated list of agent names to revert (copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie) |
+| `--config <path>`              | Path to a custom `ruler.toml` configuration file          |
+| `--keep-backups`               | Keep backup files (.bak) after restoration (default: false) |
+| `--dry-run`                    | Preview changes without actually reverting files          |
+| `--verbose` / `-v`             | Display detailed output during execution                  |
+| `--local-only`                 | Only search for local .ruler directories, ignore global config |
+
+### Common Examples
+
+**Revert all ruler changes:**
+
+```bash
+ruler revert
+```
+
+**Preview what would be reverted (dry-run):**
+
+```bash
+ruler revert --dry-run
+```
+
+**Revert only specific agents:**
+
+```bash
+ruler revert --agents claude,copilot
+```
+
+**Revert with detailed output:**
+
+```bash
+ruler revert --verbose
+```
+
+**Keep backup files after reverting:**
+
+```bash
+ruler revert --keep-backups
+```
+
 ## Configuration (`ruler.toml`) in Detail
 
 ### Location
@@ -240,6 +304,10 @@ enabled = true
 [agents.jules]
 enabled = true
 
+[agents.junie]
+enabled = true
+output_path = ".junie/guidelines.md"
+
 # Agent-specific MCP configuration
 [agents.cursor.mcp]
 enabled = true

package/dist/agents/AugmentCodeAgent.js

@@ -0,0 +1,81 @@
+"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.AugmentCodeAgent = void 0;
+const path = __importStar(require("path"));
+const fs_1 = require("fs");
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
+const merge_1 = require("../mcp/merge");
+/**
+ * AugmentCode agent adapter.
+ * Generates .augment-guidelines configuration file and supports MCP server configuration.
+ */
+class AugmentCodeAgent {
+    getIdentifier() {
+        return 'augmentcode';
+    }
+    getName() {
+        return 'AugmentCode';
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig) {
+        const output = agentConfig?.outputPath ?? this.getDefaultOutputPath(projectRoot);
+        await (0, FileSystemUtils_1.backupFile)(output);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(output, concatenatedRules);
+        // Handle MCP configuration if provided
+        if (rulerMcpJson) {
+            const configPath = path.join(projectRoot, '.augmentcode', 'config.json');
+            let existingConfig = {};
+            try {
+                const existingConfigRaw = await fs_1.promises.readFile(configPath, 'utf8');
+                existingConfig = JSON.parse(existingConfigRaw);
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT') {
+                    throw error;
+                }
+            }
+            const merged = (0, merge_1.mergeMcp)(existingConfig, rulerMcpJson, agentConfig?.mcp?.strategy ?? 'merge', this.getMcpServerKey());
+            await fs_1.promises.mkdir(path.dirname(configPath), { recursive: true });
+            await fs_1.promises.writeFile(configPath, JSON.stringify(merged, null, 2));
+        }
+    }
+    getDefaultOutputPath(projectRoot) {
+        return path.join(projectRoot, '.augment-guidelines');
+    }
+    getMcpServerKey() {
+        return 'mcpServers';
+    }
+}
+exports.AugmentCodeAgent = AugmentCodeAgent;

package/dist/agents/JunieAgent.js

@@ -0,0 +1,60 @@
+"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.JunieAgent = void 0;
+const path = __importStar(require("path"));
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
+/**
+ * JetBrains Junie agent adapter.
+ */
+class JunieAgent {
+    getIdentifier() {
+        return 'junie';
+    }
+    getName() {
+        return 'Junie';
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, // eslint-disable-line @typescript-eslint/no-unused-vars
+    agentConfig) {
+        const output = agentConfig?.outputPath ?? this.getDefaultOutputPath(projectRoot);
+        await (0, FileSystemUtils_1.ensureDirExists)(path.dirname(output));
+        await (0, FileSystemUtils_1.backupFile)(output);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(output, concatenatedRules);
+    }
+    getDefaultOutputPath(projectRoot) {
+        return path.join(projectRoot, '.junie', 'guidelines.md');
+    }
+}
+exports.JunieAgent = JunieAgent;

package/dist/cli/commands.js

@@ -40,6 +40,7 @@ exports.run = run;
 const yargs_1 = __importDefault(require("yargs"));
 const helpers_1 = require("yargs/helpers");
 const lib_1 = require("../lib");
+const revert_1 = require("../revert");
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const fs_1 = require("fs");
@@ -59,7 +60,7 @@ function run() {
         });
         y.option('agents', {
             type: 'string',
-            description: 'Comma-separated list of agent identifiers: copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli',
+            description: 'Comma-separated list of agent identifiers: copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie',
         });
         y.option('config', {
             type: 'string',
@@ -240,6 +241,60 @@ and apply them to your configured AI coding agents.
         else {
             console.log(`[ruler] mcp.json already exists, skipping`);
         }
+    })
+        .command('revert', 'Revert ruler configurations by restoring backups and removing generated files', (y) => {
+        y.option('project-root', {
+            type: 'string',
+            description: 'Project root directory',
+            default: process.cwd(),
+        });
+        y.option('agents', {
+            type: 'string',
+            description: 'Comma-separated list of agent identifiers: copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie',
+        });
+        y.option('config', {
+            type: 'string',
+            description: 'Path to TOML configuration file',
+        });
+        y.option('keep-backups', {
+            type: 'boolean',
+            description: 'Keep backup files (.bak) after restoration',
+            default: false,
+        });
+        y.option('verbose', {
+            type: 'boolean',
+            description: 'Enable verbose logging',
+            default: false,
+        });
+        y.alias('verbose', 'v');
+        y.option('dry-run', {
+            type: 'boolean',
+            description: 'Preview changes without actually reverting files',
+            default: false,
+        });
+        y.option('local-only', {
+            type: 'boolean',
+            description: 'Only search for local .ruler directories, ignore global config',
+            default: false,
+        });
+    }, async (argv) => {
+        const projectRoot = argv['project-root'];
+        const agents = argv.agents
+            ? argv.agents.split(',').map((a) => a.trim())
+            : undefined;
+        const configPath = argv.config;
+        const keepBackups = argv['keep-backups'];
+        const verbose = argv.verbose;
+        const dryRun = argv['dry-run'];
+        const localOnly = argv['local-only'];
+        try {
+            await (0, revert_1.revertAllAgentConfigs)(projectRoot, agents, configPath, keepBackups, verbose, dryRun, localOnly);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error(`${constants_1.ERROR_PREFIX} ${message}`);
+            process.exit(1);
+        }
     })
         .demandCommand(1, 'You need to specify a command')
         .help()

package/dist/lib.js

@@ -51,6 +51,8 @@ const FirebaseAgent_1 = require("./agents/FirebaseAgent");
 const OpenHandsAgent_1 = require("./agents/OpenHandsAgent");
 const GeminiCliAgent_1 = require("./agents/GeminiCliAgent");
 const JulesAgent_1 = require("./agents/JulesAgent");
+const JunieAgent_1 = require("./agents/JunieAgent");
+const AugmentCodeAgent_1 = require("./agents/AugmentCodeAgent");
 const merge_1 = require("./mcp/merge");
 const validate_1 = require("./mcp/validate");
 const mcp_1 = require("./paths/mcp");
@@ -102,6 +104,8 @@ const agents = [
     new OpenHandsAgent_1.OpenHandsAgent(),
     new GeminiCliAgent_1.GeminiCliAgent(),
     new JulesAgent_1.JulesAgent(),
+    new JunieAgent_1.JunieAgent(),
+    new AugmentCodeAgent_1.AugmentCodeAgent(),
 ];
 /**
  * Applies ruler configurations for all supported AI agents.

package/dist/paths/mcp.js

@@ -74,6 +74,10 @@ async function getNativeMcpPath(adapterName, projectRoot) {
         case 'Gemini CLI':
             candidates.push(path.join(projectRoot, '.gemini', 'settings.json'));
             break;
+        case 'AugmentCode':
+            candidates.push(path.join(projectRoot, '.augmentcode', 'config.json'));
+            candidates.push(path.join(home, '.augmentcode', 'config.json'));
+            break;
         default:
             return null;
     }

package/dist/revert.js

@@ -0,0 +1,453 @@
+"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.revertAllAgentConfigs = revertAllAgentConfigs;
+const path = __importStar(require("path"));
+const fs_1 = require("fs");
+const FileSystemUtils = __importStar(require("./core/FileSystemUtils"));
+const ConfigLoader_1 = require("./core/ConfigLoader");
+const CopilotAgent_1 = require("./agents/CopilotAgent");
+const ClaudeAgent_1 = require("./agents/ClaudeAgent");
+const CodexCliAgent_1 = require("./agents/CodexCliAgent");
+const CursorAgent_1 = require("./agents/CursorAgent");
+const WindsurfAgent_1 = require("./agents/WindsurfAgent");
+const ClineAgent = __importStar(require("./agents/ClineAgent"));
+const AiderAgent_1 = require("./agents/AiderAgent");
+const FirebaseAgent_1 = require("./agents/FirebaseAgent");
+const OpenHandsAgent_1 = require("./agents/OpenHandsAgent");
+const GeminiCliAgent_1 = require("./agents/GeminiCliAgent");
+const JulesAgent_1 = require("./agents/JulesAgent");
+const JunieAgent_1 = require("./agents/JunieAgent");
+const mcp_1 = require("./paths/mcp");
+const constants_1 = require("./constants");
+const agents = [
+    new CopilotAgent_1.CopilotAgent(),
+    new ClaudeAgent_1.ClaudeAgent(),
+    new CodexCliAgent_1.CodexCliAgent(),
+    new CursorAgent_1.CursorAgent(),
+    new WindsurfAgent_1.WindsurfAgent(),
+    new ClineAgent.ClineAgent(),
+    new AiderAgent_1.AiderAgent(),
+    new FirebaseAgent_1.FirebaseAgent(),
+    new OpenHandsAgent_1.OpenHandsAgent(),
+    new GeminiCliAgent_1.GeminiCliAgent(),
+    new JulesAgent_1.JulesAgent(),
+    new JunieAgent_1.JunieAgent(),
+];
+/**
+ * Gets all output paths for an agent, taking into account any config overrides.
+ * This is a copy of the function from lib.ts to maintain consistency.
+ */
+function getAgentOutputPaths(agent, projectRoot, agentConfig) {
+    const paths = [];
+    const defaults = agent.getDefaultOutputPath(projectRoot);
+    if (typeof defaults === 'string') {
+        const actualPath = agentConfig?.outputPath ?? defaults;
+        paths.push(actualPath);
+    }
+    else {
+        const defaultPaths = defaults;
+        if ('instructions' in defaultPaths) {
+            const instructionsPath = agentConfig?.outputPathInstructions ?? defaultPaths.instructions;
+            paths.push(instructionsPath);
+        }
+        if ('config' in defaultPaths) {
+            const configPath = agentConfig?.outputPathConfig ?? defaultPaths.config;
+            paths.push(configPath);
+        }
+        for (const [key, defaultPath] of Object.entries(defaultPaths)) {
+            if (key !== 'instructions' && key !== 'config') {
+                paths.push(defaultPath);
+            }
+        }
+    }
+    return paths;
+}
+/**
+ * Checks if a file exists.
+ */
+async function fileExists(filePath) {
+    try {
+        await fs_1.promises.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Restores a file from its backup if the backup exists.
+ */
+async function restoreFromBackup(filePath, verbose, dryRun) {
+    const backupPath = `${filePath}.bak`;
+    const backupExists = await fileExists(backupPath);
+    if (!backupExists) {
+        (0, constants_1.logVerbose)(`No backup found for: ${filePath}`, verbose);
+        return false;
+    }
+    const actionPrefix = dryRun ? '[ruler:dry-run]' : '[ruler]';
+    if (dryRun) {
+        (0, constants_1.logVerbose)(`${actionPrefix} Would restore: ${filePath} from backup`, verbose);
+    }
+    else {
+        await fs_1.promises.copyFile(backupPath, filePath);
+        (0, constants_1.logVerbose)(`${actionPrefix} Restored: ${filePath} from backup`, verbose);
+    }
+    return true;
+}
+/**
+ * Removes a file if it exists and has no backup (meaning it was generated by ruler).
+ */
+async function removeGeneratedFile(filePath, verbose, dryRun) {
+    const fileExistsFlag = await fileExists(filePath);
+    const backupExists = await fileExists(`${filePath}.bak`);
+    if (!fileExistsFlag) {
+        (0, constants_1.logVerbose)(`File does not exist: ${filePath}`, verbose);
+        return false;
+    }
+    if (backupExists) {
+        (0, constants_1.logVerbose)(`File has backup, skipping removal: ${filePath}`, verbose);
+        return false;
+    }
+    const actionPrefix = dryRun ? '[ruler:dry-run]' : '[ruler]';
+    if (dryRun) {
+        (0, constants_1.logVerbose)(`${actionPrefix} Would remove generated file: ${filePath}`, verbose);
+    }
+    else {
+        await fs_1.promises.unlink(filePath);
+        (0, constants_1.logVerbose)(`${actionPrefix} Removed generated file: ${filePath}`, verbose);
+    }
+    return true;
+}
+/**
+ * Removes backup files.
+ */
+async function removeBackupFile(filePath, verbose, dryRun) {
+    const backupPath = `${filePath}.bak`;
+    const backupExists = await fileExists(backupPath);
+    if (!backupExists) {
+        return false;
+    }
+    const actionPrefix = dryRun ? '[ruler:dry-run]' : '[ruler]';
+    if (dryRun) {
+        (0, constants_1.logVerbose)(`${actionPrefix} Would remove backup file: ${backupPath}`, verbose);
+    }
+    else {
+        await fs_1.promises.unlink(backupPath);
+        (0, constants_1.logVerbose)(`${actionPrefix} Removed backup file: ${backupPath}`, verbose);
+    }
+    return true;
+}
+/**
+ * Removes empty directories that were created by ruler.
+ * Only removes directories if they are empty and were likely created by ruler.
+ */
+async function removeEmptyDirectories(projectRoot, verbose, dryRun) {
+    const rulerCreatedDirs = [
+        '.github',
+        '.cursor',
+        '.windsurf',
+        '.junie',
+        '.openhands',
+        '.idx',
+        '.gemini',
+        '.vscode',
+    ];
+    let directoriesRemoved = 0;
+    const actionPrefix = dryRun ? '[ruler:dry-run]' : '[ruler]';
+    for (const dirName of rulerCreatedDirs) {
+        const dirPath = path.join(projectRoot, dirName);
+        try {
+            const stat = await fs_1.promises.stat(dirPath);
+            if (!stat.isDirectory()) {
+                continue;
+            }
+            const entries = await fs_1.promises.readdir(dirPath);
+            if (entries.length === 0) {
+                if (dryRun) {
+                    (0, constants_1.logVerbose)(`${actionPrefix} Would remove empty directory: ${dirPath}`, verbose);
+                }
+                else {
+                    await fs_1.promises.rmdir(dirPath);
+                    (0, constants_1.logVerbose)(`${actionPrefix} Removed empty directory: ${dirPath}`, verbose);
+                }
+                directoriesRemoved++;
+            }
+            else {
+                let hasNonEmptyContent = false;
+                for (const entry of entries) {
+                    const entryPath = path.join(dirPath, entry);
+                    const entryStat = await fs_1.promises.stat(entryPath);
+                    if (entryStat.isFile()) {
+                        hasNonEmptyContent = true;
+                        break;
+                    }
+                    else if (entryStat.isDirectory()) {
+                        const subEntries = await fs_1.promises.readdir(entryPath);
+                        if (subEntries.length > 0) {
+                            hasNonEmptyContent = true;
+                            break;
+                        }
+                    }
+                }
+                if (!hasNonEmptyContent) {
+                    if (dryRun) {
+                        (0, constants_1.logVerbose)(`${actionPrefix} Would remove directory tree: ${dirPath}`, verbose);
+                    }
+                    else {
+                        await fs_1.promises.rm(dirPath, { recursive: true });
+                        (0, constants_1.logVerbose)(`${actionPrefix} Removed directory tree: ${dirPath}`, verbose);
+                    }
+                    directoriesRemoved++;
+                }
+            }
+        }
+        catch {
+            (0, constants_1.logVerbose)(`Directory ${dirPath} doesn't exist or can't be accessed`, verbose);
+        }
+    }
+    return directoriesRemoved;
+}
+/**
+ * Removes additional files created by specific agents that aren't covered by their main output paths.
+ */
+async function removeAdditionalAgentFiles(projectRoot, verbose, dryRun) {
+    const additionalFiles = [
+        '.gemini/settings.json',
+        'claude_desktop_config.json',
+        '.mcp.json',
+        '.vscode/mcp.json',
+        '.cursor/mcp.json',
+        '.openhands/config.toml',
+    ];
+    let filesRemoved = 0;
+    const actionPrefix = dryRun ? '[ruler:dry-run]' : '[ruler]';
+    for (const filePath of additionalFiles) {
+        const fullPath = path.join(projectRoot, filePath);
+        try {
+            const fileExistsFlag = await fileExists(fullPath);
+            if (!fileExistsFlag) {
+                continue;
+            }
+            const backupExists = await fileExists(`${fullPath}.bak`);
+            if (backupExists) {
+                const restored = await restoreFromBackup(fullPath, verbose, dryRun);
+                if (restored) {
+                    filesRemoved++;
+                }
+            }
+            else {
+                if (dryRun) {
+                    (0, constants_1.logVerbose)(`${actionPrefix} Would remove additional file: ${fullPath}`, verbose);
+                }
+                else {
+                    await fs_1.promises.unlink(fullPath);
+                    (0, constants_1.logVerbose)(`${actionPrefix} Removed additional file: ${fullPath}`, verbose);
+                }
+                filesRemoved++;
+            }
+        }
+        catch {
+            (0, constants_1.logVerbose)(`Additional file ${fullPath} doesn't exist or can't be accessed`, verbose);
+        }
+    }
+    return filesRemoved;
+}
+/**
+ * Removes the ruler-managed block from .gitignore file.
+ */
+async function cleanGitignore(projectRoot, verbose, dryRun) {
+    const gitignorePath = path.join(projectRoot, '.gitignore');
+    const gitignoreExists = await fileExists(gitignorePath);
+    if (!gitignoreExists) {
+        (0, constants_1.logVerbose)('No .gitignore file found', verbose);
+        return false;
+    }
+    const content = await fs_1.promises.readFile(gitignorePath, 'utf8');
+    const startMarker = '# START Ruler Generated Files';
+    const endMarker = '# END Ruler Generated Files';
+    const startIndex = content.indexOf(startMarker);
+    const endIndex = content.indexOf(endMarker);
+    if (startIndex === -1 || endIndex === -1) {
+        (0, constants_1.logVerbose)('No ruler-managed block found in .gitignore', verbose);
+        return false;
+    }
+    const actionPrefix = dryRun ? '[ruler:dry-run]' : '[ruler]';
+    if (dryRun) {
+        (0, constants_1.logVerbose)(`${actionPrefix} Would remove ruler block from .gitignore`, verbose);
+    }
+    else {
+        const beforeBlock = content.substring(0, startIndex);
+        const afterBlock = content.substring(endIndex + endMarker.length);
+        let newContent = beforeBlock + afterBlock;
+        newContent = newContent.replace(/\n{3,}/g, '\n\n'); // Replace 3+ newlines with 2
+        if (newContent.trim() === '') {
+            await fs_1.promises.unlink(gitignorePath);
+            (0, constants_1.logVerbose)(`${actionPrefix} Removed empty .gitignore file`, verbose);
+        }
+        else {
+            await fs_1.promises.writeFile(gitignorePath, newContent);
+            (0, constants_1.logVerbose)(`${actionPrefix} Removed ruler block from .gitignore`, verbose);
+        }
+    }
+    return true;
+}
+/**
+ * Reverts ruler configurations for selected AI agents.
+ */
+async function revertAllAgentConfigs(projectRoot, includedAgents, configPath, keepBackups = false, verbose = false, dryRun = false, localOnly = false) {
+    (0, constants_1.logVerbose)(`Loading configuration for revert from project root: ${projectRoot}`, verbose);
+    const config = await (0, ConfigLoader_1.loadConfig)({
+        projectRoot,
+        cliAgents: includedAgents,
+        configPath,
+    });
+    const rulerDir = await FileSystemUtils.findRulerDir(projectRoot, !localOnly);
+    if (!rulerDir) {
+        throw (0, constants_1.createRulerError)(`.ruler directory not found`, `Searched from: ${projectRoot}`);
+    }
+    (0, constants_1.logVerbose)(`Found .ruler directory at: ${rulerDir}`, verbose);
+    const rawConfigs = config.agentConfigs;
+    const mappedConfigs = {};
+    for (const [key, cfg] of Object.entries(rawConfigs)) {
+        const lowerKey = key.toLowerCase();
+        for (const agent of agents) {
+            const identifier = agent.getIdentifier();
+            if (identifier === lowerKey ||
+                agent.getName().toLowerCase().includes(lowerKey)) {
+                mappedConfigs[identifier] = cfg;
+            }
+        }
+    }
+    config.agentConfigs = mappedConfigs;
+    let selected = agents;
+    if (config.cliAgents && config.cliAgents.length > 0) {
+        const filters = config.cliAgents.map((n) => n.toLowerCase());
+        selected = agents.filter((agent) => filters.some((f) => agent.getIdentifier() === f ||
+            agent.getName().toLowerCase().includes(f)));
+        (0, constants_1.logVerbose)(`Selected agents via CLI filter: ${selected.map((a) => a.getName()).join(', ')}`, verbose);
+    }
+    else if (config.defaultAgents && config.defaultAgents.length > 0) {
+        const defaults = config.defaultAgents.map((n) => n.toLowerCase());
+        selected = agents.filter((agent) => {
+            const identifier = agent.getIdentifier();
+            const override = config.agentConfigs[identifier]?.enabled;
+            if (override !== undefined) {
+                return override;
+            }
+            return defaults.some((d) => identifier === d || agent.getName().toLowerCase().includes(d));
+        });
+        (0, constants_1.logVerbose)(`Selected agents via config default_agents: ${selected.map((a) => a.getName()).join(', ')}`, verbose);
+    }
+    else {
+        selected = agents.filter((agent) => config.agentConfigs[agent.getIdentifier()]?.enabled !== false);
+        (0, constants_1.logVerbose)(`Selected all enabled agents: ${selected.map((a) => a.getName()).join(', ')}`, verbose);
+    }
+    let totalFilesProcessed = 0;
+    let totalFilesRestored = 0;
+    let totalFilesRemoved = 0;
+    let totalBackupsRemoved = 0;
+    for (const agent of selected) {
+        const actionPrefix = dryRun ? '[ruler:dry-run]' : '[ruler]';
+        console.log(`${actionPrefix} Reverting ${agent.getName()}...`);
+        const agentConfig = config.agentConfigs[agent.getIdentifier()];
+        const outputPaths = getAgentOutputPaths(agent, projectRoot, agentConfig);
+        (0, constants_1.logVerbose)(`Agent ${agent.getName()} output paths: ${outputPaths.join(', ')}`, verbose);
+        for (const outputPath of outputPaths) {
+            totalFilesProcessed++;
+            const restored = await restoreFromBackup(outputPath, verbose, dryRun);
+            if (restored) {
+                totalFilesRestored++;
+                if (!keepBackups) {
+                    const backupRemoved = await removeBackupFile(outputPath, verbose, dryRun);
+                    if (backupRemoved) {
+                        totalBackupsRemoved++;
+                    }
+                }
+            }
+            else {
+                const removed = await removeGeneratedFile(outputPath, verbose, dryRun);
+                if (removed) {
+                    totalFilesRemoved++;
+                }
+            }
+        }
+        const mcpPath = await (0, mcp_1.getNativeMcpPath)(agent.getName(), projectRoot);
+        if (mcpPath && mcpPath.startsWith(projectRoot)) {
+            totalFilesProcessed++;
+            const mcpRestored = await restoreFromBackup(mcpPath, verbose, dryRun);
+            if (mcpRestored) {
+                totalFilesRestored++;
+                if (!keepBackups) {
+                    const mcpBackupRemoved = await removeBackupFile(mcpPath, verbose, dryRun);
+                    if (mcpBackupRemoved) {
+                        totalBackupsRemoved++;
+                    }
+                }
+            }
+            else {
+                const mcpRemoved = await removeGeneratedFile(mcpPath, verbose, dryRun);
+                if (mcpRemoved) {
+                    totalFilesRemoved++;
+                }
+            }
+        }
+    }
+    const gitignoreCleaned = !config.cliAgents || config.cliAgents.length === 0
+        ? await cleanGitignore(projectRoot, verbose, dryRun)
+        : false;
+    const additionalFilesRemoved = await removeAdditionalAgentFiles(projectRoot, verbose, dryRun);
+    totalFilesRemoved += additionalFilesRemoved;
+    const directoriesRemoved = await removeEmptyDirectories(projectRoot, verbose, dryRun);
+    const actionPrefix = dryRun ? '[ruler:dry-run]' : '[ruler]';
+    if (dryRun) {
+        console.log(`${actionPrefix} Revert summary (dry run):`);
+    }
+    else {
+        console.log(`${actionPrefix} Revert completed successfully.`);
+    }
+    console.log(`  Files processed: ${totalFilesProcessed}`);
+    console.log(`  Files restored from backup: ${totalFilesRestored}`);
+    console.log(`  Generated files removed: ${totalFilesRemoved}`);
+    if (!keepBackups) {
+        console.log(`  Backup files removed: ${totalBackupsRemoved}`);
+    }
+    if (directoriesRemoved > 0) {
+        console.log(`  Empty directories removed: ${directoriesRemoved}`);
+    }
+    if (gitignoreCleaned) {
+        console.log(`  .gitignore cleaned: yes`);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intellectronica/ruler",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "description": "Ruler — apply the same rules to all coding agents",
   "main": "dist/lib.js",
   "scripts": {