@intellectronica/ruler 0.2.19 → 0.3.1

package/dist/agents/AgentsMdAgent.js

@@ -0,0 +1,84 @@
+"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.AgentsMdAgent = void 0;
+const path = __importStar(require("path"));
+const fs_1 = require("fs");
+const AbstractAgent_1 = require("./AbstractAgent");
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
+/**
+ * Pseudo-agent that ensures the concatenated rules are written to root-level `AGENTS.md`.
+ * Does not participate in MCP propagation. Idempotent: only writes (and creates a backup)
+ * when content differs from existing file.
+ */
+class AgentsMdAgent extends AbstractAgent_1.AbstractAgent {
+    getIdentifier() {
+        return 'agentsmd';
+    }
+    getName() {
+        return 'AgentsMd';
+    }
+    getDefaultOutputPath(projectRoot) {
+        return path.join(projectRoot, 'AGENTS.md');
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, // eslint-disable-line @typescript-eslint/no-unused-vars
+    agentConfig) {
+        const output = agentConfig?.outputPath ?? this.getDefaultOutputPath(projectRoot);
+        const absolutePath = path.resolve(projectRoot, output);
+        await (0, FileSystemUtils_1.ensureDirExists)(path.dirname(absolutePath));
+        // Add marker comment to the content to identify it as generated
+        const contentWithMarker = `<!-- Generated by Ruler -->\n${concatenatedRules}`;
+        // Read existing content if present and skip write if identical
+        let existing = null;
+        try {
+            existing = await fs_1.promises.readFile(absolutePath, 'utf8');
+        }
+        catch {
+            existing = null;
+        }
+        if (existing !== null && existing === contentWithMarker) {
+            // No change; skip backup/write for idempotency
+            return;
+        }
+        // Backup (only if file existed) then write new content
+        await (0, FileSystemUtils_1.backupFile)(absolutePath);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(absolutePath, contentWithMarker);
+    }
+    getMcpServerKey() {
+        // No MCP configuration for this pseudo-agent
+        return '';
+    }
+}
+exports.AgentsMdAgent = AgentsMdAgent;

package/dist/agents/AiderAgent.js

@@ -35,25 +35,32 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AiderAgent = void 0;
 const path = __importStar(require("path"));
+const AgentsMdAgent_1 = require("./AgentsMdAgent");
 const FileSystemUtils_1 = require("../core/FileSystemUtils");
 const fs = __importStar(require("fs/promises"));
 const yaml = __importStar(require("js-yaml"));
 /**
- * Aider agent adapter (stub implementation).
+ * Aider agent adapter that uses AGENTS.md for instructions and .aider.conf.yml for configuration.
  */
 class AiderAgent {
+    constructor() {
+        this.agentsMdAgent = new AgentsMdAgent_1.AgentsMdAgent();
+    }
     getIdentifier() {
         return 'aider';
     }
     getName() {
         return 'Aider';
     }
-    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, // eslint-disable-line @typescript-eslint/no-unused-vars
-    agentConfig) {
-        const mdPath = agentConfig?.outputPathInstructions ??
-            this.getDefaultOutputPath(projectRoot).instructions;
-        await (0, FileSystemUtils_1.backupFile)(mdPath);
-        await (0, FileSystemUtils_1.writeGeneratedFile)(mdPath, concatenatedRules);
+    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig) {
+        // First perform idempotent AGENTS.md write via composed AgentsMdAgent
+        await this.agentsMdAgent.applyRulerConfig(concatenatedRules, projectRoot, null, {
+            // Preserve explicit outputPath precedence semantics if provided.
+            outputPath: agentConfig?.outputPath ||
+                agentConfig?.outputPathInstructions ||
+                undefined,
+        });
+        // Now handle .aider.conf.yml configuration
         const cfgPath = agentConfig?.outputPathConfig ??
             this.getDefaultOutputPath(projectRoot).config;
         let doc = {};
@@ -69,7 +76,11 @@ class AiderAgent {
         if (!Array.isArray(doc.read)) {
             doc.read = [];
         }
-        const name = path.basename(mdPath);
+        // Determine the actual agents file path (AGENTS.md by default, or custom path)
+        const agentsPath = agentConfig?.outputPath ||
+            agentConfig?.outputPathInstructions ||
+            this.getDefaultOutputPath(projectRoot).instructions;
+        const name = path.basename(agentsPath);
         if (!doc.read.includes(name)) {
             doc.read.push(name);
         }
@@ -78,9 +89,18 @@ class AiderAgent {
     }
     getDefaultOutputPath(projectRoot) {
         return {
-            instructions: path.join(projectRoot, 'ruler_aider_instructions.md'),
+            instructions: path.join(projectRoot, 'AGENTS.md'),
             config: path.join(projectRoot, '.aider.conf.yml'),
         };
     }
+    getMcpServerKey() {
+        return this.agentsMdAgent.getMcpServerKey();
+    }
+    supportsMcpStdio() {
+        return true;
+    }
+    supportsMcpRemote() {
+        return true;
+    }
 }
 exports.AiderAgent = AiderAgent;

package/dist/agents/AmpAgent.js

@@ -1,55 +1,13 @@
 "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 {
+const AgentsMdAgent_1 = require("./AgentsMdAgent");
+class AmpAgent extends AgentsMdAgent_1.AgentsMdAgent {
     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/AugmentCodeAgent.js

@@ -36,7 +36,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AugmentCodeAgent = void 0;
 const path = __importStar(require("path"));
 const FileSystemUtils_1 = require("../core/FileSystemUtils");
-const settings_1 = require("../vscode/settings");
 /**
  * AugmentCode agent adapter.
  * Generates ruler_augment_instructions.md configuration file and updates VSCode settings.json with MCP server configuration.
@@ -48,24 +47,23 @@ class AugmentCodeAgent {
     getName() {
         return 'AugmentCode';
     }
-    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig) {
+    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.backupFile)(output);
         await (0, FileSystemUtils_1.writeGeneratedFile)(output, concatenatedRules);
-        if (rulerMcpJson) {
-            const settingsPath = (0, settings_1.getVSCodeSettingsPath)(projectRoot);
-            await (0, FileSystemUtils_1.backupFile)(settingsPath);
-            const existingSettings = await (0, settings_1.readVSCodeSettings)(settingsPath);
-            const augmentServers = (0, settings_1.transformRulerToAugmentMcp)(rulerMcpJson);
-            const mergedSettings = (0, settings_1.mergeAugmentMcpServers)(existingSettings, augmentServers, agentConfig?.mcp?.strategy ?? 'merge');
-            await (0, settings_1.writeVSCodeSettings)(settingsPath, mergedSettings);
-        }
+        // AugmentCode does not support MCP servers
+        // MCP configuration is ignored for this agent
     }
     getDefaultOutputPath(projectRoot) {
         return path.join(projectRoot, '.augment', 'rules', 'ruler_augment_instructions.md');
     }
-    getMcpServerKey() {
-        return 'mcpServers';
+    // AugmentCode does not support MCP servers
+    supportsMcpStdio() {
+        return false;
+    }
+    supportsMcpRemote() {
+        return false;
     }
 }
 exports.AugmentCodeAgent = AugmentCodeAgent;

package/dist/agents/ClaudeAgent.js

@@ -35,25 +35,25 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClaudeAgent = void 0;
 const path = __importStar(require("path"));
-const FileSystemUtils_1 = require("../core/FileSystemUtils");
+const AbstractAgent_1 = require("./AbstractAgent");
 /**
- * Claude Code agent adapter (stub implementation).
+ * Claude Code agent adapter.
  */
-class ClaudeAgent {
+class ClaudeAgent extends AbstractAgent_1.AbstractAgent {
     getIdentifier() {
         return 'claude';
     }
     getName() {
         return 'Claude Code';
     }
-    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.backupFile)(output);
-        await (0, FileSystemUtils_1.writeGeneratedFile)(output, concatenatedRules);
-    }
     getDefaultOutputPath(projectRoot) {
         return path.join(projectRoot, 'CLAUDE.md');
     }
+    supportsMcpStdio() {
+        return true;
+    }
+    supportsMcpRemote() {
+        return true;
+    }
 }
 exports.ClaudeAgent = ClaudeAgent;

package/dist/agents/ClineAgent.js

@@ -35,23 +35,17 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClineAgent = void 0;
 const path = __importStar(require("path"));
-const FileSystemUtils_1 = require("../core/FileSystemUtils");
+const AbstractAgent_1 = require("./AbstractAgent");
 /**
- * Cline agent adapter (stub implementation).
+ * Cline agent adapter.
  */
-class ClineAgent {
+class ClineAgent extends AbstractAgent_1.AbstractAgent {
     getIdentifier() {
         return 'cline';
     }
     getName() {
         return 'Cline';
     }
-    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.backupFile)(output);
-        await (0, FileSystemUtils_1.writeGeneratedFile)(output, concatenatedRules);
-    }
     getDefaultOutputPath(projectRoot) {
         return path.join(projectRoot, '.clinerules');
     }

package/dist/agents/CodexCliAgent.js

@@ -35,15 +35,16 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CodexCliAgent = void 0;
 const path = __importStar(require("path"));
-/* eslint-disable @typescript-eslint/no-explicit-any */
 const fs_1 = require("fs");
 const toml = __importStar(require("toml"));
 const toml_1 = require("@iarna/toml");
+const AgentsMdAgent_1 = require("./AgentsMdAgent");
 const FileSystemUtils_1 = require("../core/FileSystemUtils");
+const constants_1 = require("../constants");
 /**
  * OpenAI Codex CLI agent adapter.
  */
-class CodexCliAgent {
+class CodexCliAgent extends AgentsMdAgent_1.AgentsMdAgent {
     getIdentifier() {
         return 'codex';
     }
@@ -51,16 +52,18 @@ class CodexCliAgent {
         return 'OpenAI Codex CLI';
     }
     async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig) {
-        // Get default paths
-        const defaults = this.getDefaultOutputPath(projectRoot);
-        // Determine the instructions file path
-        const instructionsPath = agentConfig?.outputPath ??
-            agentConfig?.outputPathInstructions ??
-            defaults.instructions;
-        // Write the instructions file
-        await (0, FileSystemUtils_1.backupFile)(instructionsPath);
-        await (0, FileSystemUtils_1.writeGeneratedFile)(instructionsPath, concatenatedRules);
-        // Handle MCP configuration if enabled
+        // First perform idempotent AGENTS.md write via base class (instructions file).
+        await super.applyRulerConfig(concatenatedRules, projectRoot, null, {
+            // Preserve explicit outputPath precedence semantics if provided.
+            outputPath: agentConfig?.outputPath ||
+                agentConfig?.outputPathInstructions ||
+                undefined,
+        });
+        // Resolve config path helper (mirrors previous logic)
+        const defaults = {
+            instructions: path.join(projectRoot, constants_1.DEFAULT_RULES_FILENAME),
+            config: path.join(projectRoot, '.codex', 'config.toml'),
+        };
         const mcpEnabled = agentConfig?.mcp?.enabled ?? true;
         if (mcpEnabled && rulerMcpJson) {
             // Determine the config file path
@@ -95,13 +98,17 @@ class CodexCliAgent {
                 // Create a properly formatted MCP server entry
                 const mcpServer = {
                     command: serverConfig.command,
-                    args: serverConfig.args,
                 };
+                if (serverConfig.args) {
+                    mcpServer.args = serverConfig.args;
+                }
                 // Format env as an inline table
                 if (serverConfig.env) {
                     mcpServer.env = serverConfig.env;
                 }
-                updatedConfig.mcp_servers[serverName] = mcpServer;
+                if (updatedConfig.mcp_servers) {
+                    updatedConfig.mcp_servers[serverName] = mcpServer;
+                }
             }
             // Convert to TOML with special handling for env to ensure it's an inline table
             let tomlContent = '';
@@ -114,8 +121,7 @@ class CodexCliAgent {
             // Now handle mcp_servers with special formatting for env
             if (updatedConfig.mcp_servers &&
                 Object.keys(updatedConfig.mcp_servers).length > 0) {
-                for (const [serverName, serverConfigRaw] of Object.entries(updatedConfig.mcp_servers)) {
-                    const serverConfig = serverConfigRaw;
+                for (const [serverName, serverConfig] of Object.entries(updatedConfig.mcp_servers)) {
                     tomlContent += `\n[mcp_servers.${serverName}]\n`;
                     // Add command
                     if (serverConfig.command) {
@@ -146,11 +152,11 @@ class CodexCliAgent {
             await (0, FileSystemUtils_1.writeGeneratedFile)(configPath, tomlContent);
         }
     }
-    getDefaultOutputPath(projectRoot) {
-        return {
-            instructions: path.join(projectRoot, 'AGENTS.md'),
-            config: path.join(projectRoot, '.codex', 'config.toml'),
-        };
+    supportsMcpStdio() {
+        return true;
+    }
+    supportsMcpRemote() {
+        return false; // Codex CLI only supports STDIO based on PR description
     }
 }
 exports.CodexCliAgent = CodexCliAgent;

package/dist/agents/CopilotAgent.js

@@ -35,29 +35,28 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CopilotAgent = void 0;
 const path = __importStar(require("path"));
-const FileSystemUtils_1 = require("../core/FileSystemUtils");
+const AbstractAgent_1 = require("./AbstractAgent");
 /**
- * GitHub Copilot agent adapter (stub implementation).
+ * GitHub Copilot agent adapter.
  */
-class CopilotAgent {
+class CopilotAgent extends AbstractAgent_1.AbstractAgent {
     getIdentifier() {
         return 'copilot';
     }
     getName() {
         return 'GitHub Copilot';
     }
-    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, '.github', 'copilot-instructions.md');
     }
     getMcpServerKey() {
         return 'servers';
     }
+    supportsMcpStdio() {
+        return true;
+    }
+    supportsMcpRemote() {
+        return true;
+    }
 }
 exports.CopilotAgent = CopilotAgent;

package/dist/agents/CrushAgent.js

@@ -84,5 +84,11 @@ class CrushAgent {
             await fs.writeFile(mcpPath, JSON.stringify(finalMcpConfig, null, 2));
         }
     }
+    supportsMcpStdio() {
+        return true;
+    }
+    supportsMcpRemote() {
+        return true;
+    }
 }
 exports.CrushAgent = CrushAgent;

package/dist/agents/CursorAgent.js

@@ -35,11 +35,12 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CursorAgent = void 0;
 const path = __importStar(require("path"));
+const AbstractAgent_1 = require("./AbstractAgent");
 const FileSystemUtils_1 = require("../core/FileSystemUtils");
 /**
- * Cursor agent adapter (stub implementation).
+ * Cursor agent adapter.
  */
-class CursorAgent {
+class CursorAgent extends AbstractAgent_1.AbstractAgent {
     getIdentifier() {
         return 'cursor';
     }
@@ -49,16 +50,23 @@ class CursorAgent {
     async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, // eslint-disable-line @typescript-eslint/no-unused-vars
     agentConfig) {
         const output = agentConfig?.outputPath ?? this.getDefaultOutputPath(projectRoot);
+        const absolutePath = path.resolve(projectRoot, output);
         // Cursor expects a YAML front-matter block with an `alwaysApply` flag.
         // See: https://docs.cursor.com/context/rules#rule-anatomy
         const frontMatter = ['---', 'alwaysApply: true', '---', ''].join('\n');
         const content = `${frontMatter}${concatenatedRules.trimStart()}`;
-        await (0, FileSystemUtils_1.ensureDirExists)(path.dirname(output));
-        await (0, FileSystemUtils_1.backupFile)(output);
-        await (0, FileSystemUtils_1.writeGeneratedFile)(output, content);
+        await (0, FileSystemUtils_1.ensureDirExists)(path.dirname(absolutePath));
+        await (0, FileSystemUtils_1.backupFile)(absolutePath);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(absolutePath, content);
     }
     getDefaultOutputPath(projectRoot) {
         return path.join(projectRoot, '.cursor', 'rules', 'ruler_cursor_instructions.mdc');
     }
+    supportsMcpStdio() {
+        return true;
+    }
+    supportsMcpRemote() {
+        return true;
+    }
 }
 exports.CursorAgent = CursorAgent;

package/dist/agents/FirebaseAgent.js

@@ -35,23 +35,17 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FirebaseAgent = void 0;
 const path = __importStar(require("path"));
-const FileSystemUtils_1 = require("../core/FileSystemUtils");
+const AbstractAgent_1 = require("./AbstractAgent");
 /**
  * Firebase Studio agent adapter.
  */
-class FirebaseAgent {
+class FirebaseAgent extends AbstractAgent_1.AbstractAgent {
     getIdentifier() {
         return 'firebase';
     }
     getName() {
         return 'Firebase Studio';
     }
-    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.backupFile)(output);
-        await (0, FileSystemUtils_1.writeGeneratedFile)(output, concatenatedRules);
-    }
     getDefaultOutputPath(projectRoot) {
         return path.join(projectRoot, '.idx', 'airules.md');
     }

package/dist/agents/GeminiCliAgent.js

@@ -36,39 +36,48 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GeminiCliAgent = void 0;
 const path = __importStar(require("path"));
 const fs_1 = require("fs");
-const merge_1 = require("../mcp/merge");
-class GeminiCliAgent {
+const AgentsMdAgent_1 = require("./AgentsMdAgent");
+class GeminiCliAgent extends AgentsMdAgent_1.AgentsMdAgent {
     getIdentifier() {
         return 'gemini-cli';
     }
     getName() {
         return 'Gemini CLI';
     }
-    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig) {
-        const outputPath = this.getDefaultOutputPath(projectRoot);
-        await fs_1.promises.writeFile(outputPath, concatenatedRules);
-        if (rulerMcpJson) {
-            const settingsPath = path.join(projectRoot, '.gemini', 'settings.json');
-            let existingSettings = {};
-            try {
-                const existingSettingsRaw = await fs_1.promises.readFile(settingsPath, 'utf8');
-                existingSettings = JSON.parse(existingSettingsRaw);
-            }
-            catch (error) {
-                if (error.code !== 'ENOENT') {
-                    throw error;
-                }
+    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, // eslint-disable-line @typescript-eslint/no-unused-vars
+    agentConfig) {
+        // First, perform idempotent write of AGENTS.md via base class
+        await super.applyRulerConfig(concatenatedRules, projectRoot, null, {
+            outputPath: agentConfig?.outputPath,
+        });
+        // Ensure .gemini/settings.json has contextFileName set to AGENTS.md
+        const settingsPath = path.join(projectRoot, '.gemini', 'settings.json');
+        let existingSettings = {};
+        try {
+            const raw = await fs_1.promises.readFile(settingsPath, 'utf8');
+            existingSettings = JSON.parse(raw);
+        }
+        catch (err) {
+            if (err.code !== 'ENOENT') {
+                throw err;
             }
-            const merged = (0, merge_1.mergeMcp)(existingSettings, rulerMcpJson, agentConfig?.mcp?.strategy ?? 'merge', this.getMcpServerKey());
-            await fs_1.promises.mkdir(path.dirname(settingsPath), { recursive: true });
-            await fs_1.promises.writeFile(settingsPath, JSON.stringify(merged, null, 2));
         }
+        const updated = {
+            ...existingSettings,
+            contextFileName: 'AGENTS.md',
+        };
+        await fs_1.promises.mkdir(path.dirname(settingsPath), { recursive: true });
+        await fs_1.promises.writeFile(settingsPath, JSON.stringify(updated, null, 2));
     }
-    getDefaultOutputPath(projectRoot) {
-        return path.join(projectRoot, 'GEMINI.md');
-    }
+    // Ensure MCP merging uses the correct key for Gemini (.gemini/settings.json)
     getMcpServerKey() {
         return 'mcpServers';
     }
+    supportsMcpStdio() {
+        return true;
+    }
+    supportsMcpRemote() {
+        return true;
+    }
 }
 exports.GeminiCliAgent = GeminiCliAgent;

package/dist/agents/GooseAgent.js

@@ -35,26 +35,18 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GooseAgent = void 0;
 const path = __importStar(require("path"));
-const FileSystemUtils_1 = require("../core/FileSystemUtils");
+const AbstractAgent_1 = require("./AbstractAgent");
 /**
  * Goose agent adapter for Block's Goose AI assistant.
  * Propagates rules to .goosehints file.
  */
-class GooseAgent {
+class GooseAgent extends AbstractAgent_1.AbstractAgent {
     getIdentifier() {
         return 'goose';
     }
     getName() {
         return 'Goose';
     }
-    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig) {
-        // Get the output path for .goosehints
-        const hintsPath = agentConfig?.outputPathInstructions ??
-            this.getDefaultOutputPath(projectRoot);
-        // Write rules to .goosehints
-        await (0, FileSystemUtils_1.backupFile)(hintsPath);
-        await (0, FileSystemUtils_1.writeGeneratedFile)(hintsPath, concatenatedRules);
-    }
     getDefaultOutputPath(projectRoot) {
         return path.join(projectRoot, '.goosehints');
     }