@intellectronica/ruler 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Eleanor Berger
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,104 @@
+# Ruler
+
+A CLI tool to manage custom rules and configs across different AI coding agents.
+
+## Features
+
+- Centralise AI agent instructions in a single `.ruler/` directory
+- Distribute rules to supported agents (GitHub Copilot, Claude Code, OpenAI Codex CLI, Cursor, Windsurf, Cline, Aider)
+- Extensible architecture: add new agent adapters easily
+
+## Installation
+
+Install globally:
+
+```bash
+npm install -g @intellectronica/ruler
+```
+
+Or use npx:
+
+```bash
+npx @intellectronica/ruler apply
+```
+
+## Usage
+
+Create a `.ruler/` directory at your project root and add Markdown files defining your rules:
+
+```
+.ruler/
+├── coding_guidelines.md
+└── style_guide.md
+```
+
+Run the apply command:
+
+```bash
+ruler apply [--project-root <path>] [--agents <agent1,agent2,...>]
+```
+
+Use `--agents` to specify a comma-separated list of agent names (case-insensitive substrings) to limit which agents the rules are applied to.
+
+The command will read all `.md` files under `.ruler/`, concatenate their contents, and generate/update configuration files for the following agents:
+
+| Agent                  | File(s) Created/Updated                                    |
+| ---------------------- | ----------------------------------------------------------- |
+| GitHub Copilot         | `.github/copilot-instructions.md`                           |
+| Claude Code            | `CLAUDE.md`                                                 |
+| OpenAI Codex CLI       | `AGENTS.md`                                                 |
+| Cursor                 | `.cursor/rules/ruler_cursor_instructions.md`                |
+| Windsurf               | `.windsurf/rules/ruler_windsurf_instructions.md`            |
+| Cline                  | `.clinerules`                                               |
+| Aider                  | `ruler_aider_instructions.md` <br>and updates `.aider.conf.yml` |
+
+## Development
+
+Clone the repository and install dependencies:
+
+```bash
+git clone https://github.com/intellectronica/ruler.git
+cd ruler
+npm install
+npm run build
+```
+
+Run linting and formatting checks:
+
+```bash
+npm run lint
+npm run format
+```
+
+Run tests:
+
+```bash
+npm test
+```
+
+End-to-end tests (run build before tests):
+
+```bash
+npm run build && npm test
+```
+
+### Roadmap
+- [ ] Support for MCP servers config
+- [ ] Support for transforming and rewriting the rules using AI
+- [ ] Support "harmonisation" (reading existing rules of specific agents and combining them with the master config)
+- [ ] Support for additional agents
+- [ ] Support for agent-specific features (for example: apply rules in copilot)
+
+## Contributing
+
+Contributions are welcome! Please open issues or pull requests on GitHub.
+
+## License
+
+MIT
+
+---
+
+© Eleanor Berger
+
+[ai.intellectronica.net](https://ai.intellectronica.net/)

package/dist/agents/AiderAgent.js

@@ -0,0 +1,73 @@
+"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.AiderAgent = void 0;
+const path = __importStar(require("path"));
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
+const fs = __importStar(require("fs/promises"));
+const yaml = __importStar(require("js-yaml"));
+/**
+ * Aider agent adapter (stub implementation).
+ */
+class AiderAgent {
+    getName() {
+        return 'Aider';
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot) {
+        const mdFile = path.join(projectRoot, 'ruler_aider_instructions.md');
+        await (0, FileSystemUtils_1.backupFile)(mdFile);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(mdFile, concatenatedRules);
+        const cfgPath = path.join(projectRoot, '.aider.conf.yml');
+        let doc = {};
+        try {
+            await fs.access(cfgPath);
+            await (0, FileSystemUtils_1.backupFile)(cfgPath);
+            const raw = await fs.readFile(cfgPath, 'utf8');
+            doc = (yaml.load(raw) || {});
+        }
+        catch {
+            doc = {};
+        }
+        if (!Array.isArray(doc.read)) {
+            doc.read = [];
+        }
+        if (!doc.read.includes('ruler_aider_instructions.md')) {
+            doc.read.push('ruler_aider_instructions.md');
+        }
+        const yamlStr = yaml.dump(doc);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(cfgPath, yamlStr);
+    }
+}
+exports.AiderAgent = AiderAgent;

package/dist/agents/ClaudeAgent.js

@@ -0,0 +1,52 @@
+"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.ClaudeAgent = void 0;
+const path = __importStar(require("path"));
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
+/**
+ * Claude Code agent adapter (stub implementation).
+ */
+class ClaudeAgent {
+    getName() {
+        return 'Claude Code';
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot) {
+        const target = path.join(projectRoot, 'CLAUDE.md');
+        await (0, FileSystemUtils_1.backupFile)(target);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(target, concatenatedRules);
+    }
+}
+exports.ClaudeAgent = ClaudeAgent;

package/dist/agents/ClineAgent.js

@@ -0,0 +1,52 @@
+"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.ClineAgent = void 0;
+const path = __importStar(require("path"));
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
+/**
+ * Cline agent adapter (stub implementation).
+ */
+class ClineAgent {
+    getName() {
+        return 'Cline';
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot) {
+        const target = path.join(projectRoot, '.clinerules');
+        await (0, FileSystemUtils_1.backupFile)(target);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(target, concatenatedRules);
+    }
+}
+exports.ClineAgent = ClineAgent;

package/dist/agents/CodexCliAgent.js

@@ -0,0 +1,52 @@
+"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.CodexCliAgent = void 0;
+const path = __importStar(require("path"));
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
+/**
+ * OpenAI Codex CLI agent adapter (stub implementation).
+ */
+class CodexCliAgent {
+    getName() {
+        return 'OpenAI Codex CLI';
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot) {
+        const target = path.join(projectRoot, 'AGENTS.md');
+        await (0, FileSystemUtils_1.backupFile)(target);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(target, concatenatedRules);
+    }
+}
+exports.CodexCliAgent = CodexCliAgent;

package/dist/agents/CopilotAgent.js

@@ -0,0 +1,54 @@
+"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.CopilotAgent = void 0;
+const path = __importStar(require("path"));
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
+/**
+ * GitHub Copilot agent adapter (stub implementation).
+ */
+class CopilotAgent {
+    getName() {
+        return 'GitHub Copilot';
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot) {
+        const targetDir = path.join(projectRoot, '.github');
+        await (0, FileSystemUtils_1.ensureDirExists)(targetDir);
+        const target = path.join(targetDir, 'copilot-instructions.md');
+        await (0, FileSystemUtils_1.backupFile)(target);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(target, concatenatedRules);
+    }
+}
+exports.CopilotAgent = CopilotAgent;

package/dist/agents/CursorAgent.js

@@ -0,0 +1,54 @@
+"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.CursorAgent = void 0;
+const path = __importStar(require("path"));
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
+/**
+ * Cursor agent adapter (stub implementation).
+ */
+class CursorAgent {
+    getName() {
+        return 'Cursor';
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot) {
+        const targetDir = path.join(projectRoot, '.cursor', 'rules');
+        await (0, FileSystemUtils_1.ensureDirExists)(targetDir);
+        const target = path.join(targetDir, 'ruler_cursor_instructions.md');
+        await (0, FileSystemUtils_1.backupFile)(target);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(target, concatenatedRules);
+    }
+}
+exports.CursorAgent = CursorAgent;

package/dist/agents/IAgent.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/agents/WindsurfAgent.js

@@ -0,0 +1,54 @@
+"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.WindsurfAgent = void 0;
+const path = __importStar(require("path"));
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
+/**
+ * Windsurf agent adapter (stub implementation).
+ */
+class WindsurfAgent {
+    getName() {
+        return 'Windsurf';
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot) {
+        const targetDir = path.join(projectRoot, '.windsurf', 'rules');
+        await (0, FileSystemUtils_1.ensureDirExists)(targetDir);
+        const target = path.join(targetDir, 'ruler_windsurf_instructions.md');
+        await (0, FileSystemUtils_1.backupFile)(target);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(target, concatenatedRules);
+    }
+}
+exports.WindsurfAgent = WindsurfAgent;

package/dist/cli/commands.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+const yargs_1 = __importDefault(require("yargs"));
+const helpers_1 = require("yargs/helpers");
+const lib_1 = require("../lib");
+/**
+ * Sets up and parses CLI commands.
+ */
+function run() {
+    (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
+        .scriptName('ruler')
+        .usage('$0 <command> [options]')
+        .command('apply', 'Apply ruler configurations to supported AI agents', (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 names to include (e.g. "copilot,claude")',
+        });
+    }, async (argv) => {
+        const projectRoot = argv['project-root'];
+        const agents = argv.agents
+            ? argv.agents.split(',').map((a) => a.trim())
+            : undefined;
+        try {
+            await (0, lib_1.applyAllAgentConfigs)(projectRoot, agents);
+            console.log('Ruler apply completed successfully.');
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            console.error('Error applying ruler configurations:', message);
+            process.exit(1);
+        }
+    })
+        .demandCommand(1, 'You need to specify a command')
+        .help()
+        .strict()
+        .parse();
+}

package/dist/cli/index.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commands_1 = require("./commands");
+(0, commands_1.run)();

package/dist/core/FileSystemUtils.js

@@ -0,0 +1,115 @@
+"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"));
+/**
+ * Searches upwards from startPath to find a directory named .ruler.
+ * Returns the path to the .ruler directory, or null if not found.
+ */
+async function findRulerDir(startPath) {
+    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;
+    }
+    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 });
+}

package/dist/core/RuleProcessor.js

@@ -0,0 +1,48 @@
+"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.concatenateRules = concatenateRules;
+const path = __importStar(require("path"));
+/**
+ * Concatenates markdown rule files into a single string,
+ * marking each section with its source filename.
+ */
+function concatenateRules(files) {
+    const sections = files.map(({ path: filePath, content }) => {
+        const rel = path.relative(process.cwd(), filePath);
+        return ['---', `Source: ${rel}`, '---', content.trim(), ''].join('\n');
+    });
+    return sections.join('\n');
+}

package/dist/lib.js

@@ -0,0 +1,82 @@
+"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.applyAllAgentConfigs = applyAllAgentConfigs;
+const path = __importStar(require("path"));
+const FileSystemUtils_1 = require("./core/FileSystemUtils");
+const RuleProcessor_1 = require("./core/RuleProcessor");
+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_1 = require("./agents/ClineAgent");
+const AiderAgent_1 = require("./agents/AiderAgent");
+const agents = [
+    new CopilotAgent_1.CopilotAgent(),
+    new ClaudeAgent_1.ClaudeAgent(),
+    new CodexCliAgent_1.CodexCliAgent(),
+    new CursorAgent_1.CursorAgent(),
+    new WindsurfAgent_1.WindsurfAgent(),
+    new ClineAgent_1.ClineAgent(),
+    new AiderAgent_1.AiderAgent(),
+];
+/**
+ * Applies ruler configurations for all supported AI agents.
+ * @param projectRoot Root directory of the project
+ */
+/**
+ * Applies ruler configurations for selected AI agents.
+ * @param projectRoot Root directory of the project
+ * @param includedAgents Optional list of agent name filters (case-insensitive substrings)
+ */
+async function applyAllAgentConfigs(projectRoot, includedAgents) {
+    const rulerDir = await (0, FileSystemUtils_1.findRulerDir)(projectRoot);
+    if (!rulerDir) {
+        throw new Error(`.ruler directory not found from ${projectRoot}`);
+    }
+    await (0, FileSystemUtils_1.ensureDirExists)(path.join(rulerDir, 'generated'));
+    const files = await (0, FileSystemUtils_1.readMarkdownFiles)(rulerDir);
+    const concatenated = (0, RuleProcessor_1.concatenateRules)(files);
+    let selected = agents;
+    if (includedAgents && includedAgents.length > 0) {
+        const filters = includedAgents.map((n) => n.toLowerCase());
+        selected = agents.filter((agent) => filters.some((f) => agent.getName().toLowerCase().includes(f)));
+    }
+    for (const agent of selected) {
+        console.log(`[ruler] Applying rules for ${agent.getName()}...`);
+        await agent.applyRulerConfig(concatenated, projectRoot);
+    }
+}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@intellectronica/ruler",
+  "version": "0.1.0",
+  "description": "",
+  "main": "dist/lib.js",
+  "scripts": {
+    "lint": "eslint \"src/**/*.{ts,tsx}\"",
+    "format": "prettier --write \"src/**/*.{ts,tsx,json,md}\"",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "build": "tsc",
+    "prepare": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/intellectronica/ruler.git"
+  },
+  "keywords": [
+    "ai",
+    "developer-tools",
+    "copilot",
+    "codex",
+    "claude",
+    "cursor",
+    "aider",
+    "config",
+    "rules",
+    "automation"
+  ],
+  "author": "Eleanor Berger",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/intellectronica/ruler/issues"
+  },
+  "homepage": "https://github.com/intellectronica/ruler#readme",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "ruler": "dist/cli/index.js"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "@types/js-yaml": "^4.0.9",
+    "@types/yargs": "^17.0.33",
+    "@typescript-eslint/eslint-plugin": "^8.32.1",
+    "@typescript-eslint/parser": "^8.32.1",
+    "eslint": "^8.57.1",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-prettier": "^5.4.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.5.3",
+    "ts-jest": "^29.3.4",
+    "typescript": "^5.8.3",
+    "yargs": "^17.7.2"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.0"
+  }
+}