@intellectronica/ruler 0.3.7 → 0.3.9

package/README.md

@@ -57,7 +57,7 @@ Ruler solves this by providing a **single source of truth** for all your AI agen
 | Agent            | Rules File(s)                                    | MCP Configuration / Notes                        |
 | ---------------- | ------------------------------------------------ | ------------------------------------------------ |
 | AGENTS.md        | `AGENTS.md`                                      | (pseudo-agent ensuring root `AGENTS.md` exists)  |
-| GitHub Copilot   | `AGENTS.md`, `.github/copilot-instructions.md`   | `.vscode/mcp.json`                               |
+| GitHub Copilot   | `AGENTS.md`                                      | `.vscode/mcp.json`                               |
 | Claude Code      | `CLAUDE.md`                                      | `.mcp.json`                                      |
 | OpenAI Codex CLI | `AGENTS.md`                                      | `.codex/config.toml`                             |
 | Jules            | `AGENTS.md`                                      | -                                                |
@@ -68,11 +68,11 @@ Ruler solves this by providing a **single source of truth** for all your AI agen
 | Amp              | `AGENTS.md`                                      | -                                                |
 | Amazon Q CLI     | `.amazonq/rules/ruler_q_rules.md`                | `.amazonq/mcp.json`                              |
 | Aider            | `AGENTS.md`, `.aider.conf.yml`                   | `.mcp.json`                                      |
-| Firebase Studio  | `.idx/airules.md`                                | -                                                |
+| Firebase Studio  | `.idx/airules.md`                                | `.idx/mcp.json`                                  |
 | Open Hands       | `.openhands/microagents/repo.md`                 | `config.toml`                                    |
 | Gemini CLI       | `AGENTS.md`                                      | `.gemini/settings.json`                          |
 | Junie            | `.junie/guidelines.md`                           | -                                                |
-| AugmentCode      | `.augment/rules/ruler_augment_instructions.md`   | `.vscode/settings.json`                          |
+| AugmentCode      | `.augment/rules/ruler_augment_instructions.md`   | -                                                |
 | Kilo Code        | `.kilocode/rules/ruler_kilocode_instructions.md` | `.kilocode/mcp.json`                             |
 | opencode         | `AGENTS.md`                                      | `opencode.json`                                  |
 | Goose            | `.goosehints`                                    | -                                                |
@@ -214,7 +214,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 (agentsmd, amazonqcli, amp, copilot, claude, codex, cursor, windsurf, cline, aider, firebase, openhands, gemini-cli, jules, junie, augmentcode, kilocode, opencode, goose, crush, zed, qwen, kiro, warp, roo, trae) |
+| `--agents <agent1,agent2,...>` | Comma-separated list of agent names to target (agentsmd, aider, amazonqcli, amp, augmentcode, claude, cline, codex, copilot, crush, cursor, firebase, gemini-cli, goose, jules, junie, kilocode, kiro, opencode, openhands, qwen, roo, trae, warp, windsurf, zed) |
 | `--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                                                                                                                                      |
@@ -307,7 +307,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 (agentsmd, amazonqcli, amp, copilot, claude, codex, cursor, windsurf, cline, aider, firebase, openhands, gemini-cli, jules, junie, augmentcode, kilocode, opencode, goose, crush, zed, qwen, kiro, warp, roo, trae) |
+| `--agents <agent1,agent2,...>` | Comma-separated list of agent names to revert (agentsmd, aider, amazonqcli, amp, augmentcode, claude, cline, codex, copilot, crush, cursor, firebase, gemini-cli, goose, jules, junie, kilocode, kiro, opencode, openhands, qwen, roo, trae, warp, windsurf, zed) |
 | `--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                                                                                                                             |
@@ -389,7 +389,6 @@ enabled = true
 # --- Agent-Specific Configurations ---
 [agents.copilot]
 enabled = true
-output_path = ".github/copilot-instructions.md"
 
 [agents.claude]
 enabled = true
@@ -565,7 +564,6 @@ node_modules/
 .aider.conf.yml
 .clinerules
 .cursor/rules/ruler_cursor_instructions.mdc
-.github/copilot-instructions.md
 .windsurf/rules/ruler_windsurf_instructions.md
 AGENTS.md
 CLAUDE.md

package/dist/agents/CopilotAgent.js

@@ -1,47 +1,10 @@
 "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 AgentsMdAgent_1 = require("./AgentsMdAgent");
-const FileSystemUtils_1 = require("../core/FileSystemUtils");
-const fs_1 = require("fs");
 /**
  * GitHub Copilot agent adapter.
- * Writes to both AGENTS.md (for web-based GitHub Copilot) and
- * .github/copilot-instructions.md (for VS Code extension compatibility).
+ * Writes to AGENTS.md for both web-based GitHub Copilot and VS Code extension.
  */
 class CopilotAgent {
     constructor() {
@@ -54,41 +17,18 @@ class CopilotAgent {
         return 'GitHub Copilot';
     }
     /**
-     * Returns multiple output paths to ensure both files are added to .gitignore.
+     * Returns the default output path for AGENTS.md.
      */
     getDefaultOutputPath(projectRoot) {
-        return {
-            instructions: path.join(projectRoot, 'AGENTS.md'),
-            legacy: path.join(projectRoot, '.github', 'copilot-instructions.md'),
-        };
+        return this.agentsMdAgent.getDefaultOutputPath(projectRoot);
     }
     async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig, backup = true) {
-        // First, write to AGENTS.md using the existing AgentsMdAgent infrastructure
+        // Write to AGENTS.md using the existing AgentsMdAgent infrastructure
         await this.agentsMdAgent.applyRulerConfig(concatenatedRules, projectRoot, null, // No MCP config needed for the instructions file
         {
             // Preserve explicit outputPath precedence semantics if provided
             outputPath: agentConfig?.outputPath || agentConfig?.outputPathInstructions,
         }, backup);
-        // Additionally write to .github/copilot-instructions.md for VS Code extension compatibility
-        const outputPaths = this.getDefaultOutputPath(projectRoot);
-        const legacyPath = path.resolve(projectRoot, outputPaths.legacy);
-        // Add marker comment to the content to identify it as generated
-        const contentWithMarker = `<!-- Generated by Ruler -->\n${concatenatedRules}`;
-        await (0, FileSystemUtils_1.ensureDirExists)(path.dirname(legacyPath));
-        // Check if content has changed (idempotency)
-        let existingLegacy = null;
-        try {
-            existingLegacy = await fs_1.promises.readFile(legacyPath, 'utf8');
-        }
-        catch {
-            existingLegacy = null;
-        }
-        if (existingLegacy === null || existingLegacy !== contentWithMarker) {
-            if (backup) {
-                await (0, FileSystemUtils_1.backupFile)(legacyPath);
-            }
-            await (0, FileSystemUtils_1.writeGeneratedFile)(legacyPath, contentWithMarker);
-        }
     }
     getMcpServerKey() {
         return 'servers';

package/dist/agents/FirebaseAgent.js

@@ -49,5 +49,13 @@ class FirebaseAgent extends AbstractAgent_1.AbstractAgent {
     getDefaultOutputPath(projectRoot) {
         return path.join(projectRoot, '.idx', 'airules.md');
     }
+    // Firebase Studio (IDX) supports stdio MCP servers via .idx/mcp.json
+    supportsMcpStdio() {
+        return true;
+    }
+    // Remote MCP over HTTP/SSE is not documented for Firebase Studio yet
+    supportsMcpRemote() {
+        return false;
+    }
 }
 exports.FirebaseAgent = FirebaseAgent;

package/dist/core/apply-engine.js

@@ -333,28 +333,96 @@ async function applyOpenCodeMcpConfiguration(filteredMcpJson, dest, dryRun, verb
         await (0, propagateOpenCodeMcp_1.propagateMcpToOpenCode)(filteredMcpJson, dest, backup);
     }
 }
+/**
+ * Transform MCP server types for Claude Code compatibility.
+ * Claude expects "http" for HTTP servers and "sse" for SSE servers, not "remote".
+ */
+function transformMcpForClaude(mcpJson) {
+    if (!mcpJson.mcpServers || typeof mcpJson.mcpServers !== 'object') {
+        return mcpJson;
+    }
+    const transformedMcp = { ...mcpJson };
+    const transformedServers = {};
+    for (const [name, serverDef] of Object.entries(mcpJson.mcpServers)) {
+        if (serverDef && typeof serverDef === 'object') {
+            const server = serverDef;
+            const transformedServer = { ...server };
+            // Transform type: "remote" to appropriate Claude types
+            if (server.type === 'remote' &&
+                server.url &&
+                typeof server.url === 'string') {
+                const url = server.url;
+                // Check if URL suggests SSE (contains /sse path segment)
+                if (/\/sse(\/|$)/i.test(url)) {
+                    transformedServer.type = 'sse';
+                }
+                else {
+                    transformedServer.type = 'http';
+                }
+            }
+            transformedServers[name] = transformedServer;
+        }
+        else {
+            transformedServers[name] = serverDef;
+        }
+    }
+    transformedMcp.mcpServers = transformedServers;
+    return transformedMcp;
+}
 async function applyStandardMcpConfiguration(agent, filteredMcpJson, dest, agentConfig, config, cliMcpStrategy, dryRun, verbose, backup = true) {
     const strategy = cliMcpStrategy ??
         agentConfig?.mcp?.strategy ??
         config.mcp?.strategy ??
         'merge';
     const serverKey = agent.getMcpServerKey?.() ?? 'mcpServers';
+    // Skip agents with empty server keys (e.g., AgentsMdAgent, GooseAgent)
+    if (serverKey === '') {
+        (0, constants_1.logVerbose)(`Skipping MCP config for ${agent.getName()} - agent has empty server key`, verbose);
+        return;
+    }
     (0, constants_1.logVerbose)(`Applying filtered MCP config for ${agent.getName()} with strategy: ${strategy} and key: ${serverKey}`, verbose);
     if (dryRun) {
         (0, constants_1.logVerbose)(`DRY RUN: Would apply MCP config to: ${dest}`, verbose);
     }
     else {
+        // Transform MCP config for Claude Code compatibility
+        let mcpToMerge = filteredMcpJson;
+        if (agent.getIdentifier() === 'claude') {
+            mcpToMerge = transformMcpForClaude(filteredMcpJson);
+        }
         const existing = await (0, mcp_1.readNativeMcp)(dest);
-        const merged = (0, merge_1.mergeMcp)(existing, filteredMcpJson, strategy, serverKey);
+        const merged = (0, merge_1.mergeMcp)(existing, mcpToMerge, strategy, serverKey);
+        // Firebase Studio (IDX) expects no "type" fields in .idx/mcp.json server entries.
+        // Sanitize merged config by stripping 'type' from each server when targeting Firebase.
+        const sanitizeForFirebase = (obj) => {
+            if (agent.getIdentifier() !== 'firebase')
+                return obj;
+            const out = { ...obj };
+            const servers = out[serverKey] || {};
+            const cleanedServers = {};
+            for (const [name, def] of Object.entries(servers)) {
+                if (def && typeof def === 'object') {
+                    const copy = { ...def };
+                    delete copy.type;
+                    cleanedServers[name] = copy;
+                }
+                else {
+                    cleanedServers[name] = def;
+                }
+            }
+            out[serverKey] = cleanedServers;
+            return out;
+        };
+        const toWrite = sanitizeForFirebase(merged);
         // Only backup and write if content would actually change (idempotent)
         const currentContent = JSON.stringify(existing, null, 2);
-        const newContent = JSON.stringify(merged, null, 2);
+        const newContent = JSON.stringify(toWrite, null, 2);
         if (currentContent !== newContent) {
             if (backup) {
                 const { backupFile } = await Promise.resolve().then(() => __importStar(require('../core/FileSystemUtils')));
                 await backupFile(dest);
             }
-            await (0, mcp_1.writeNativeMcp)(dest, merged);
+            await (0, mcp_1.writeNativeMcp)(dest, toWrite);
         }
         else {
             (0, constants_1.logVerbose)(`MCP config for ${agent.getName()} is already up to date - skipping backup and write`, verbose);

package/dist/paths/mcp.js

@@ -80,6 +80,9 @@ async function getNativeMcpPath(adapterName, projectRoot) {
         case 'OpenCode':
             candidates.push(path.join(projectRoot, 'opencode.json'));
             break;
+        case 'Firebase Studio':
+            candidates.push(path.join(projectRoot, '.idx', 'mcp.json'));
+            break;
         case 'Zed':
             // Only consider project-local Zed settings (avoid writing to user home directory)
             candidates.push(path.join(projectRoot, '.zed', 'settings.json'));

package/package.json

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