@intellectronica/ruler 0.2.19 → 0.3.0

package/dist/agents/OpenCodeAgent.js

@@ -34,7 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenCodeAgent = void 0;
-const FileSystemUtils_1 = require("../core/FileSystemUtils");
+const fs = __importStar(require("fs/promises"));
 const path = __importStar(require("path"));
 class OpenCodeAgent {
     getIdentifier() {
@@ -43,18 +43,57 @@ class OpenCodeAgent {
     getName() {
         return 'OpenCode';
     }
-    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, // eslint-disable-line @typescript-eslint/no-unused-vars
-    agentConfig) {
-        const outputPath = agentConfig?.outputPath ?? this.getDefaultOutputPath(projectRoot);
-        const absolutePath = path.resolve(projectRoot, outputPath);
-        await (0, FileSystemUtils_1.backupFile)(absolutePath);
-        await (0, FileSystemUtils_1.writeGeneratedFile)(absolutePath, concatenatedRules);
-    }
     getDefaultOutputPath(projectRoot) {
-        return path.join(projectRoot, 'AGENTS.md');
+        return {
+            instructions: path.join(projectRoot, 'AGENTS.md'),
+            mcp: path.join(projectRoot, 'opencode.json'),
+        };
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig) {
+        const outputPaths = this.getDefaultOutputPath(projectRoot);
+        const instructionsPath = path.resolve(projectRoot, agentConfig?.outputPathInstructions ?? outputPaths['instructions']);
+        const mcpPath = path.resolve(projectRoot, agentConfig?.outputPathConfig ?? outputPaths['mcp']);
+        await fs.writeFile(instructionsPath, concatenatedRules);
+        // Create OpenCode config with schema and MCP configuration
+        let finalMcpConfig = {
+            $schema: 'https://opencode.ai/config.json',
+            mcp: {},
+        };
+        try {
+            const existingMcpConfig = JSON.parse(await fs.readFile(mcpPath, 'utf-8'));
+            if (existingMcpConfig && typeof existingMcpConfig === 'object') {
+                finalMcpConfig = {
+                    $schema: 'https://opencode.ai/config.json',
+                    ...existingMcpConfig,
+                    mcp: {
+                        ...(existingMcpConfig.mcp || {}),
+                        ...(rulerMcpJson?.mcpServers ?? {}),
+                    },
+                };
+            }
+            else if (rulerMcpJson) {
+                finalMcpConfig = {
+                    $schema: 'https://opencode.ai/config.json',
+                    mcp: (rulerMcpJson?.mcpServers ?? {}),
+                };
+            }
+        }
+        catch {
+            if (rulerMcpJson) {
+                finalMcpConfig = {
+                    $schema: 'https://opencode.ai/config.json',
+                    mcp: (rulerMcpJson?.mcpServers ?? {}),
+                };
+            }
+        }
+        // Always write the config file, even if MCP is empty
+        await fs.writeFile(mcpPath, JSON.stringify(finalMcpConfig, null, 2));
+    }
+    supportsMcpStdio() {
+        return true;
     }
-    getMcpServerKey() {
-        return 'mcp';
+    supportsMcpRemote() {
+        return true;
     }
 }
 exports.OpenCodeAgent = OpenCodeAgent;

package/dist/agents/OpenHandsAgent.js

@@ -35,23 +35,22 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenHandsAgent = void 0;
 const path = __importStar(require("path"));
-const FileSystemUtils_1 = require("../core/FileSystemUtils");
-class OpenHandsAgent {
+const AbstractAgent_1 = require("./AbstractAgent");
+class OpenHandsAgent extends AbstractAgent_1.AbstractAgent {
     getIdentifier() {
         return 'openhands';
     }
     getName() {
         return 'Open Hands';
     }
-    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, '.openhands', 'microagents', 'repo.md');
     }
+    supportsMcpStdio() {
+        return true;
+    }
+    supportsMcpRemote() {
+        return true;
+    }
 }
 exports.OpenHandsAgent = OpenHandsAgent;

package/dist/agents/QwenCodeAgent.js

@@ -0,0 +1,83 @@
+"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.QwenCodeAgent = void 0;
+const path = __importStar(require("path"));
+const fs_1 = require("fs");
+const AgentsMdAgent_1 = require("./AgentsMdAgent");
+class QwenCodeAgent extends AgentsMdAgent_1.AgentsMdAgent {
+    getIdentifier() {
+        return 'qwen';
+    }
+    getName() {
+        return 'Qwen Code';
+    }
+    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 .qwen/settings.json has contextFileName set to AGENTS.md
+        const settingsPath = path.join(projectRoot, '.qwen', '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 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));
+    }
+    // Ensure MCP merging uses the correct key for Qwen Code (.qwen/settings.json)
+    getMcpServerKey() {
+        return 'mcpServers';
+    }
+    supportsMcpStdio() {
+        return true;
+    }
+    supportsMcpRemote() {
+        return true;
+    }
+}
+exports.QwenCodeAgent = QwenCodeAgent;

package/dist/agents/WarpAgent.js

@@ -0,0 +1,61 @@
+"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.WarpAgent = void 0;
+const path = __importStar(require("path"));
+const AbstractAgent_1 = require("./AbstractAgent");
+/**
+ * Warp Agent Mode adapter.
+ * Generates WARP.md configuration file in the project root.
+ */
+class WarpAgent extends AbstractAgent_1.AbstractAgent {
+    getIdentifier() {
+        return 'warp';
+    }
+    getName() {
+        return 'Warp';
+    }
+    getDefaultOutputPath(projectRoot) {
+        return path.join(projectRoot, 'WARP.md');
+    }
+    // Warp does not support MCP servers
+    supportsMcpStdio() {
+        return false;
+    }
+    supportsMcpRemote() {
+        return false;
+    }
+}
+exports.WarpAgent = WarpAgent;

package/dist/agents/WindsurfAgent.js

@@ -35,26 +35,25 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WindsurfAgent = void 0;
 const path = __importStar(require("path"));
-const FileSystemUtils_1 = require("../core/FileSystemUtils");
+const AbstractAgent_1 = require("./AbstractAgent");
 /**
- * Windsurf agent adapter (stub implementation).
+ * Windsurf agent adapter.
  */
-class WindsurfAgent {
+class WindsurfAgent extends AbstractAgent_1.AbstractAgent {
     getIdentifier() {
         return 'windsurf';
     }
     getName() {
         return 'Windsurf';
     }
-    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, '.windsurf', 'rules', 'ruler_windsurf_instructions.md');
     }
+    supportsMcpStdio() {
+        return true;
+    }
+    supportsMcpRemote() {
+        return true;
+    }
 }
 exports.WindsurfAgent = WindsurfAgent;

package/dist/agents/ZedAgent.js

@@ -0,0 +1,132 @@
+"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.ZedAgent = void 0;
+const path = __importStar(require("path"));
+const fs_1 = require("fs");
+const AgentsMdAgent_1 = require("./AgentsMdAgent");
+/**
+ * Zed editor agent adapter.
+ * Inherits from AgentsMdAgent to write instructions to AGENTS.md and handles
+ * MCP server configuration in .zed/settings.json at the project root.
+ */
+class ZedAgent extends AgentsMdAgent_1.AgentsMdAgent {
+    getIdentifier() {
+        return 'zed';
+    }
+    getName() {
+        return 'Zed';
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig) {
+        // First, perform idempotent AGENTS.md write via base class
+        await super.applyRulerConfig(concatenatedRules, projectRoot, null, {
+            outputPath: agentConfig?.outputPath,
+        });
+        // Handle MCP server configuration if enabled and provided
+        const mcpEnabled = agentConfig?.mcp?.enabled ?? true;
+        if (mcpEnabled && rulerMcpJson) {
+            const zedSettingsPath = path.join(projectRoot, '.zed', 'settings.json');
+            // Read existing settings
+            let existingSettings = {};
+            try {
+                const content = await fs_1.promises.readFile(zedSettingsPath, 'utf8');
+                existingSettings = JSON.parse(content);
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT') {
+                    throw error;
+                }
+                // File doesn't exist, use empty settings
+            }
+            // Get the merge strategy
+            const strategy = agentConfig?.mcp?.strategy ?? 'merge';
+            // Handle merging based on strategy
+            let mergedSettings;
+            if (strategy === 'overwrite') {
+                // For overwrite, preserve all existing settings except MCP servers
+                mergedSettings = { ...existingSettings };
+                // Extract incoming MCP servers and transform them for Zed format
+                const incomingServers = rulerMcpJson.mcpServers || {};
+                const transformedServers = {};
+                for (const [serverName, serverConfig] of Object.entries(incomingServers)) {
+                    transformedServers[serverName] = this.transformMcpServerForZed(serverConfig);
+                }
+                // Replace MCP servers completely
+                mergedSettings[this.getMcpServerKey()] = transformedServers;
+            }
+            else {
+                // For merge strategy, preserve all existing settings
+                const baseServers = existingSettings[this.getMcpServerKey()] || {};
+                const incomingServers = rulerMcpJson.mcpServers || {};
+                // Transform incoming servers for Zed format
+                const transformedIncomingServers = {};
+                for (const [serverName, serverConfig] of Object.entries(incomingServers)) {
+                    transformedIncomingServers[serverName] =
+                        this.transformMcpServerForZed(serverConfig);
+                }
+                const mergedServers = { ...baseServers, ...transformedIncomingServers };
+                mergedSettings = {
+                    ...existingSettings,
+                    [this.getMcpServerKey()]: mergedServers,
+                };
+            }
+            // Write updated settings
+            await fs_1.promises.mkdir(path.dirname(zedSettingsPath), { recursive: true });
+            await fs_1.promises.writeFile(zedSettingsPath, JSON.stringify(mergedSettings, null, 2));
+        }
+    }
+    getMcpServerKey() {
+        return 'context_servers';
+    }
+    supportsMcpStdio() {
+        return true;
+    }
+    supportsMcpRemote() {
+        return true;
+    }
+    /**
+     * Transform MCP server configuration from ruler format to Zed format.
+     * Converts "type": "stdio" to "source": "custom" and preserves other fields.
+     */
+    transformMcpServerForZed(rulerServer) {
+        const transformedServer = { ...rulerServer };
+        // Remove "type" field if present
+        delete transformedServer.type;
+        // Add "source": "custom" as required by Zed
+        transformedServer.source = 'custom';
+        return transformedServer;
+    }
+}
+exports.ZedAgent = ZedAgent;

package/dist/agents/agent-utils.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAgentOutputPaths = getAgentOutputPaths;
+/**
+ * Gets all output paths for an agent, taking into account any config overrides.
+ */
+function getAgentOutputPaths(agent, projectRoot, agentConfig) {
+    const paths = [];
+    const defaults = agent.getDefaultOutputPath(projectRoot);
+    if (typeof defaults === 'string') {
+        // Single output path (most agents)
+        const actualPath = agentConfig?.outputPath ?? defaults;
+        paths.push(actualPath);
+    }
+    else {
+        // Multiple output paths (e.g., AiderAgent)
+        const defaultPaths = defaults;
+        // Handle instructions path
+        if ('instructions' in defaultPaths) {
+            const instructionsPath = agentConfig?.outputPathInstructions ?? defaultPaths.instructions;
+            paths.push(instructionsPath);
+        }
+        // Handle config path
+        if ('config' in defaultPaths) {
+            const configPath = agentConfig?.outputPathConfig ?? defaultPaths.config;
+            paths.push(configPath);
+        }
+        // Handle any other paths in the default paths record
+        for (const [key, defaultPath] of Object.entries(defaultPaths)) {
+            if (key !== 'instructions' && key !== 'config') {
+                // For unknown path types, use the default since we don't have specific config overrides
+                paths.push(defaultPath);
+            }
+        }
+    }
+    return paths;
+}

package/dist/agents/index.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allAgents = exports.AbstractAgent = void 0;
+const AbstractAgent_1 = require("./AbstractAgent");
+Object.defineProperty(exports, "AbstractAgent", { enumerable: true, get: function () { return AbstractAgent_1.AbstractAgent; } });
+const CopilotAgent_1 = require("./CopilotAgent");
+const ClaudeAgent_1 = require("./ClaudeAgent");
+const CodexCliAgent_1 = require("./CodexCliAgent");
+const CursorAgent_1 = require("./CursorAgent");
+const WindsurfAgent_1 = require("./WindsurfAgent");
+const ClineAgent_1 = require("./ClineAgent");
+const AiderAgent_1 = require("./AiderAgent");
+const FirebaseAgent_1 = require("./FirebaseAgent");
+const OpenHandsAgent_1 = require("./OpenHandsAgent");
+const GeminiCliAgent_1 = require("./GeminiCliAgent");
+const JulesAgent_1 = require("./JulesAgent");
+const JunieAgent_1 = require("./JunieAgent");
+const AugmentCodeAgent_1 = require("./AugmentCodeAgent");
+const KiloCodeAgent_1 = require("./KiloCodeAgent");
+const OpenCodeAgent_1 = require("./OpenCodeAgent");
+const CrushAgent_1 = require("./CrushAgent");
+const GooseAgent_1 = require("./GooseAgent");
+const AmpAgent_1 = require("./AmpAgent");
+const ZedAgent_1 = require("./ZedAgent");
+const AgentsMdAgent_1 = require("./AgentsMdAgent");
+const QwenCodeAgent_1 = require("./QwenCodeAgent");
+const KiroAgent_1 = require("./KiroAgent");
+const WarpAgent_1 = require("./WarpAgent");
+exports.allAgents = [
+    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(),
+    new FirebaseAgent_1.FirebaseAgent(),
+    new OpenHandsAgent_1.OpenHandsAgent(),
+    new GeminiCliAgent_1.GeminiCliAgent(),
+    new JulesAgent_1.JulesAgent(),
+    new JunieAgent_1.JunieAgent(),
+    new AugmentCodeAgent_1.AugmentCodeAgent(),
+    new KiloCodeAgent_1.KiloCodeAgent(),
+    new OpenCodeAgent_1.OpenCodeAgent(),
+    new GooseAgent_1.GooseAgent(),
+    new CrushAgent_1.CrushAgent(),
+    new AmpAgent_1.AmpAgent(),
+    new ZedAgent_1.ZedAgent(),
+    new QwenCodeAgent_1.QwenCodeAgent(),
+    new AgentsMdAgent_1.AgentsMdAgent(),
+    new KiroAgent_1.KiroAgent(),
+    new WarpAgent_1.WarpAgent(),
+];