@intellectronica/ruler 0.2.17 → 0.2.19

package/README.md

@@ -45,6 +45,7 @@ Ruler solves this by providing a **single source of truth** for all your AI agen
 | Cursor           | `.cursor/rules/ruler_cursor_instructions.mdc`    | `.cursor/mcp.json`, `~/.cursor/mcp.json`            |
 | Windsurf         | `.windsurf/rules/ruler_windsurf_instructions.md` | `~/.codeium/windsurf/mcp_config.json`               |
 | Cline            | `.clinerules`                                    | -                                                   |
+| Amp              | `AGENT.md`                                       | -                                                   |
 | Aider            | `ruler_aider_instructions.md`, `.aider.conf.yml` | `.mcp.json`                                         |
 | Firebase Studio  | `.idx/airules.md`                                | -                                                   |
 | Open Hands       | `.openhands/microagents/repo.md`                 | `.openhands/config.toml`                            |
@@ -150,7 +151,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 (copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie, augmentcode, kilocode) |
+| `--agents <agent1,agent2,...>` | Comma-separated list of agent names to target (amp, copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie, augmentcode, kilocode) |
 | `--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                                                                                                                 |
@@ -222,7 +223,7 @@ ruler revert [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, kilocode, opencode) |
+| `--agents <agent1,agent2,...>` | Comma-separated list of agent names to revert (amp, copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie, kilocode, opencode) |
 | `--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                                                                                                        |

package/dist/agents/AmpAgent.js

@@ -0,0 +1,55 @@
+"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.AmpAgent = void 0;
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
+const path = __importStar(require("path"));
+class AmpAgent {
+    getIdentifier() {
+        return 'amp';
+    }
+    getName() {
+        return 'Amp';
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig) {
+        const outputPath = agentConfig?.outputPath ?? this.getDefaultOutputPath(projectRoot);
+        const absolutePath = path.resolve(projectRoot, outputPath);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(absolutePath, concatenatedRules);
+    }
+    getDefaultOutputPath(projectRoot) {
+        return path.join(projectRoot, 'AGENT.md');
+    }
+}
+exports.AmpAgent = AmpAgent;

package/dist/agents/CrushAgent.js

@@ -0,0 +1,88 @@
+"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.CrushAgent = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+class CrushAgent {
+    getIdentifier() {
+        return 'crush';
+    }
+    getName() {
+        return 'Crush';
+    }
+    getDefaultOutputPath(projectRoot) {
+        return {
+            instructions: path.join(projectRoot, 'CRUSH.md'),
+            mcp: path.join(projectRoot, '.crush.json'),
+        };
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig) {
+        const outputPaths = this.getDefaultOutputPath(projectRoot);
+        const instructionsPath = agentConfig?.outputPathInstructions ?? outputPaths['instructions'];
+        const mcpPath = agentConfig?.outputPathConfig ?? outputPaths['mcp'];
+        await fs.writeFile(instructionsPath, concatenatedRules);
+        // Always transform from mcpServers ({ mcpServers: ... }) to { mcp: ... } for Crush
+        let finalMcpConfig = { mcp: {} };
+        try {
+            const existingMcpConfig = JSON.parse(await fs.readFile(mcpPath, 'utf-8'));
+            if (existingMcpConfig && typeof existingMcpConfig === 'object') {
+                finalMcpConfig = {
+                    ...existingMcpConfig,
+                    mcp: {
+                        ...(existingMcpConfig.mcp || {}),
+                        ...(rulerMcpJson?.mcpServers ?? {}),
+                    },
+                };
+            }
+            else if (rulerMcpJson) {
+                finalMcpConfig = {
+                    mcp: (rulerMcpJson?.mcpServers ?? {}),
+                };
+            }
+        }
+        catch {
+            if (rulerMcpJson) {
+                finalMcpConfig = {
+                    mcp: (rulerMcpJson?.mcpServers ?? {}),
+                };
+            }
+        }
+        if (Object.keys(finalMcpConfig.mcp).length > 0) {
+            await fs.writeFile(mcpPath, JSON.stringify(finalMcpConfig, null, 2));
+        }
+    }
+}
+exports.CrushAgent = CrushAgent;

package/dist/cli/commands.js

@@ -60,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, junie, kilocode, opencode',
+            description: 'Comma-separated list of agent identifiers: amp, copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie, kilocode, opencode, crush',
         });
         y.option('config', {
             type: 'string',
@@ -174,7 +174,7 @@ and apply them to your configured AI coding agents.
 
 # --- Agent Specific Configurations ---
 # You can enable/disable agents and override their default output paths here.
-# Use lowercase agent identifiers: copilot, claude, codex, cursor, windsurf, cline, aider, kilocode
+# Use lowercase agent identifiers: amp, copilot, claude, codex, cursor, windsurf, cline, aider, kilocode
 
 # [agents.copilot]
 # enabled = true
@@ -234,10 +234,15 @@ and apply them to your configured AI coding agents.
         const DEFAULT_MCP_JSON = `{
   "mcpServers": {
     "example": {
-      "url": "https://mcp.example.com"
+      "type": "stdio",
+      "command": "node",
+      "args": ["/path/to/mcp-server.js"],
+      "env": {
+        "NODE_ENV": "production"
+      }
     }
   }
-}`;
+}\n`;
         if (!(await exists(mcpPath))) {
             await fs_1.promises.writeFile(mcpPath, DEFAULT_MCP_JSON);
             console.log(`[ruler] Created ${mcpPath}`);
@@ -254,7 +259,7 @@ and apply them to your configured AI coding agents.
         });
         y.option('agents', {
             type: 'string',
-            description: 'Comma-separated list of agent identifiers: copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie, kilocode, opencode',
+            description: 'Comma-separated list of agent identifiers: amp, copilot, claude, codex, cursor, windsurf, cline, aider, firebase, gemini-cli, junie, kilocode, opencode, crush',
         });
         y.option('config', {
             type: 'string',

package/dist/lib.js

@@ -45,7 +45,7 @@ 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 ClineAgent_1 = require("./agents/ClineAgent");
 const AiderAgent_1 = require("./agents/AiderAgent");
 const FirebaseAgent_1 = require("./agents/FirebaseAgent");
 const OpenHandsAgent_1 = require("./agents/OpenHandsAgent");
@@ -55,7 +55,9 @@ const JunieAgent_1 = require("./agents/JunieAgent");
 const AugmentCodeAgent_1 = require("./agents/AugmentCodeAgent");
 const KiloCodeAgent_1 = require("./agents/KiloCodeAgent");
 const OpenCodeAgent_1 = require("./agents/OpenCodeAgent");
+const CrushAgent_1 = require("./agents/CrushAgent");
 const GooseAgent_1 = require("./agents/GooseAgent");
+const AmpAgent_1 = require("./agents/AmpAgent");
 const merge_1 = require("./mcp/merge");
 const validate_1 = require("./mcp/validate");
 const mcp_1 = require("./paths/mcp");
@@ -102,7 +104,7 @@ const agents = [
     new CodexCliAgent_1.CodexCliAgent(),
     new CursorAgent_1.CursorAgent(),
     new WindsurfAgent_1.WindsurfAgent(),
-    new ClineAgent.ClineAgent(),
+    new ClineAgent_1.ClineAgent(),
     new AiderAgent_1.AiderAgent(),
     new FirebaseAgent_1.FirebaseAgent(),
     new OpenHandsAgent_1.OpenHandsAgent(),
@@ -113,6 +115,8 @@ const agents = [
     new KiloCodeAgent_1.KiloCodeAgent(),
     new OpenCodeAgent_1.OpenCodeAgent(),
     new GooseAgent_1.GooseAgent(),
+    new CrushAgent_1.CrushAgent(),
+    new AmpAgent_1.AmpAgent(),
 ];
 /**
  * Applies ruler configurations for all supported AI agents.
@@ -178,12 +182,28 @@ async function applyAllAgentConfigs(projectRoot, includedAgents, configPath, cli
     let selected = agents;
     if (config.cliAgents && config.cliAgents.length > 0) {
         const filters = config.cliAgents.map((n) => n.toLowerCase());
+        // Check if any of the specified agents don't exist
+        const validAgentIdentifiers = new Set(agents.map((agent) => agent.getIdentifier()));
+        const validAgentNames = new Set(agents.map((agent) => agent.getName().toLowerCase()));
+        const invalidAgents = filters.filter((filter) => !validAgentIdentifiers.has(filter) &&
+            ![...validAgentNames].some((name) => name.includes(filter)));
+        if (invalidAgents.length > 0) {
+            throw (0, constants_1.createRulerError)(`Invalid agent specified: ${invalidAgents.join(', ')}`, `Valid agents are: ${[...validAgentIdentifiers].join(', ')}`);
+        }
         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());
+        // Check if any of the default agents don't exist
+        const validAgentIdentifiers = new Set(agents.map((agent) => agent.getIdentifier()));
+        const validAgentNames = new Set(agents.map((agent) => agent.getName().toLowerCase()));
+        const invalidAgents = defaults.filter((filter) => !validAgentIdentifiers.has(filter) &&
+            ![...validAgentNames].some((name) => name.includes(filter)));
+        if (invalidAgents.length > 0) {
+            throw (0, constants_1.createRulerError)(`Invalid agent specified in default_agents: ${invalidAgents.join(', ')}`, `Valid agents are: ${[...validAgentIdentifiers].join(', ')}`);
+        }
         selected = agents.filter((agent) => {
             const identifier = agent.getIdentifier();
             const override = config.agentConfigs[identifier]?.enabled;

package/dist/mcp/merge.js

@@ -12,15 +12,23 @@ exports.mergeMcp = mergeMcp;
 function mergeMcp(base, incoming, strategy, serverKey) {
     if (strategy === 'overwrite') {
         // Ensure the incoming object uses the correct server key.
-        const incomingServers = incoming.mcpServers || {};
+        // Transform from the standard (Crush) MCP config format
+        const incomingServers = incoming[serverKey] ||
+            incoming.mcpServers ||
+            incoming.mcp ||
+            {};
         return {
             [serverKey]: incomingServers,
         };
     }
     const baseServers = base[serverKey] ||
         base.mcpServers ||
-        {}; // Handle legacy key in existing files
-    const incomingServers = incoming.mcpServers || {};
+        base.mcp ||
+        {};
+    const incomingServers = incoming[serverKey] ||
+        incoming.mcpServers ||
+        incoming.mcp ||
+        {};
     const mergedServers = { ...baseServers, ...incomingServers };
     const newBase = { ...base };
     delete newBase.mcpServers; // Remove old key if present

package/dist/mcp/propagateOpenHandsMcp.js

@@ -48,6 +48,7 @@ async function propagateMcpToOpenHands(rulerMcpPath, openHandsConfigPath) {
     catch {
         return;
     }
+    // Always use the legacy Ruler MCP config format as input (top-level "mcpServers" key)
     const rulerServers = rulerMcp.mcpServers || {};
     let config = {};
     try {

package/dist/mcp/validate.js

@@ -12,6 +12,6 @@ function validateMcp(data) {
         typeof data !== 'object' ||
         !('mcpServers' in data) ||
         typeof data.mcpServers !== 'object') {
-        throw new Error('[ruler] Invalid .ruler/mcp.json: must contain an object property "mcpServers"');
+        throw new Error('[ruler] Invalid MCP config: must contain an object property "mcpServers" (Ruler style)');
     }
 }

package/dist/revert.js

@@ -54,6 +54,7 @@ const AugmentCodeAgent_1 = require("./agents/AugmentCodeAgent");
 const KiloCodeAgent_1 = require("./agents/KiloCodeAgent");
 const OpenCodeAgent_1 = require("./agents/OpenCodeAgent");
 const GooseAgent_1 = require("./agents/GooseAgent");
+const AmpAgent_1 = require("./agents/AmpAgent");
 const mcp_1 = require("./paths/mcp");
 const constants_1 = require("./constants");
 const settings_1 = require("./vscode/settings");
@@ -74,6 +75,7 @@ const agents = [
     new KiloCodeAgent_1.KiloCodeAgent(),
     new OpenCodeAgent_1.OpenCodeAgent(),
     new GooseAgent_1.GooseAgent(),
+    new AmpAgent_1.AmpAgent(),
 ];
 /**
  * Gets all output paths for an agent, taking into account any config overrides.

package/package.json

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