@intellectronica/ruler 0.3.19 → 0.3.21

package/README.md

@@ -84,6 +84,7 @@ Ruler solves this by providing a **single source of truth** for all your AI agen
 | Warp             | `WARP.md`                                        | -                                                |
 | Kiro             | `.kiro/steering/ruler_kiro_instructions.md`      | `.kiro/settings/mcp.json`                        |
 | Firebender       | `firebender.json`                                | `firebender.json` (rules and MCP in same file)   |
+| Mistral Vibe     | `AGENTS.md`                                      | `.vibe/config.toml`                              |
 
 ## Getting Started
 
@@ -319,7 +320,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, aider, amazonqcli, amp, antigravity, augmentcode, claude, cline, codex, copilot, crush, cursor, firebase, firebender, gemini-cli, goose, jules, junie, kilocode, kiro, opencode, openhands, qwen, roo, trae, warp, windsurf, zed) |
+| `--agents <agent1,agent2,...>` | Comma-separated list of agent names to revert (agentsmd, aider, amazonqcli, amp, antigravity, augmentcode, claude, cline, codex, copilot, crush, cursor, firebase, firebender, gemini-cli, goose, jules, junie, kilocode, kiro, mistral, 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                                                                                                                                                                                                                              |

package/dist/agents/GeminiCliAgent.js

@@ -69,17 +69,35 @@ class GeminiCliAgent extends AgentsMdAgent_1.AgentsMdAgent {
         const mcpEnabled = agentConfig?.mcp?.enabled ?? true;
         if (mcpEnabled && rulerMcpJson) {
             const strategy = agentConfig?.mcp?.strategy ?? 'merge';
+            // Gemini CLI (since v0.21.0) no longer accepts the "type" field in MCP server entries.
+            // Following the MCP spec update from Nov 25, 2025, the transport type is now inferred
+            // from the presence of specific keys (command/args -> stdio, url -> sse/http).
+            // Strip 'type' field from all incoming servers before merging.
+            const stripTypeField = (servers) => {
+                const cleaned = {};
+                for (const [name, def] of Object.entries(servers)) {
+                    if (def && typeof def === 'object') {
+                        const copy = { ...def };
+                        delete copy.type;
+                        cleaned[name] = copy;
+                    }
+                    else {
+                        cleaned[name] = def;
+                    }
+                }
+                return cleaned;
+            };
             if (strategy === 'overwrite') {
                 // For overwrite, preserve existing settings except MCP servers
                 const incomingServers = rulerMcpJson.mcpServers || {};
-                updated[this.getMcpServerKey()] = incomingServers;
+                updated[this.getMcpServerKey()] = stripTypeField(incomingServers);
             }
             else {
                 // For merge strategy, merge with existing MCP servers
                 const baseServers = existingSettings[this.getMcpServerKey()] || {};
                 const incomingServers = rulerMcpJson.mcpServers || {};
                 const mergedServers = { ...baseServers, ...incomingServers };
-                updated[this.getMcpServerKey()] = mergedServers;
+                updated[this.getMcpServerKey()] = stripTypeField(mergedServers);
             }
         }
         await fs_1.promises.mkdir(path.dirname(settingsPath), { recursive: true });

package/dist/agents/MistralVibeAgent.js

@@ -0,0 +1,171 @@
+"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.MistralVibeAgent = void 0;
+const path = __importStar(require("path"));
+const fs_1 = require("fs");
+const toml_1 = require("@iarna/toml");
+const AgentsMdAgent_1 = require("./AgentsMdAgent");
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
+const constants_1 = require("../constants");
+/**
+ * Mistral Vibe CLI agent adapter.
+ * Propagates rules to AGENTS.md and MCP servers to .vibe/config.toml.
+ */
+class MistralVibeAgent {
+    constructor() {
+        this.agentsMdAgent = new AgentsMdAgent_1.AgentsMdAgent();
+    }
+    getIdentifier() {
+        return 'mistral';
+    }
+    getName() {
+        return 'Mistral';
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig, backup = true) {
+        // First perform idempotent AGENTS.md write via composed AgentsMdAgent
+        await this.agentsMdAgent.applyRulerConfig(concatenatedRules, projectRoot, null, {
+            outputPath: agentConfig?.outputPath ||
+                agentConfig?.outputPathInstructions ||
+                undefined,
+        }, backup);
+        // Handle MCP configuration
+        const defaults = this.getDefaultOutputPath(projectRoot);
+        const mcpEnabled = agentConfig?.mcp?.enabled ?? true;
+        if (mcpEnabled && rulerMcpJson) {
+            // Apply MCP server filtering and transformation
+            const { filterMcpConfigForAgent } = await Promise.resolve().then(() => __importStar(require('../mcp/capabilities')));
+            const filteredMcpConfig = filterMcpConfigForAgent(rulerMcpJson, this);
+            if (!filteredMcpConfig) {
+                return; // No compatible servers found
+            }
+            const filteredRulerMcpJson = filteredMcpConfig;
+            // Determine the config file path
+            const configPath = agentConfig?.outputPathConfig ?? defaults.config;
+            // Ensure the parent directory exists
+            await fs_1.promises.mkdir(path.dirname(configPath), { recursive: true });
+            // Get the merge strategy
+            const strategy = agentConfig?.mcp?.strategy ?? 'merge';
+            // Transform ruler MCP servers to Vibe format
+            const rulerServers = filteredRulerMcpJson.mcpServers || {};
+            const vibeServers = [];
+            for (const [serverName, serverConfig] of Object.entries(rulerServers)) {
+                const vibeServer = {
+                    name: serverName,
+                    transport: this.determineTransport(serverConfig),
+                };
+                // Handle stdio servers
+                if (serverConfig.command) {
+                    vibeServer.command = serverConfig.command;
+                    if (serverConfig.args) {
+                        vibeServer.args = serverConfig.args;
+                    }
+                }
+                // Handle remote servers
+                if (serverConfig.url) {
+                    vibeServer.url = serverConfig.url;
+                }
+                // Handle headers
+                if (serverConfig.headers) {
+                    vibeServer.headers = serverConfig.headers;
+                }
+                // Handle env
+                if (serverConfig.env) {
+                    vibeServer.env = serverConfig.env;
+                }
+                vibeServers.push(vibeServer);
+            }
+            // Read existing TOML config if it exists
+            let existingConfig = {};
+            try {
+                const existingContent = await fs_1.promises.readFile(configPath, 'utf8');
+                existingConfig = (0, toml_1.parse)(existingContent);
+            }
+            catch {
+                // File doesn't exist or can't be parsed, use empty config
+            }
+            // Create the updated config
+            const updatedConfig = { ...existingConfig };
+            if (strategy === 'overwrite') {
+                // For overwrite strategy, replace the entire mcp_servers array
+                updatedConfig.mcp_servers = vibeServers;
+            }
+            else {
+                // For merge strategy, merge by server name
+                const existingServers = updatedConfig.mcp_servers || [];
+                // Keep existing servers that aren't being overwritten by ruler
+                const mergedServers = existingServers.filter((s) => !rulerServers[s.name]);
+                // Add all ruler servers
+                mergedServers.push(...vibeServers);
+                updatedConfig.mcp_servers = mergedServers;
+            }
+            // Convert to TOML and write
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const tomlContent = (0, toml_1.stringify)(updatedConfig);
+            await (0, FileSystemUtils_1.writeGeneratedFile)(configPath, tomlContent);
+        }
+    }
+    /**
+     * Determines the transport type based on server configuration.
+     */
+    determineTransport(server) {
+        if (server.command) {
+            return 'stdio';
+        }
+        if (server.url) {
+            // Default to http for remote servers
+            // Could potentially detect streamable-http based on URL patterns if needed
+            return 'http';
+        }
+        return 'stdio';
+    }
+    getDefaultOutputPath(projectRoot) {
+        return {
+            instructions: path.join(projectRoot, constants_1.DEFAULT_RULES_FILENAME),
+            config: path.join(projectRoot, '.vibe', 'config.toml'),
+        };
+    }
+    supportsMcpStdio() {
+        return true;
+    }
+    supportsMcpRemote() {
+        return true; // Mistral Vibe supports http and streamable-http transports
+    }
+    supportsNativeSkills() {
+        // Mistral Vibe supports native skills in .vibe/skills/
+        return true;
+    }
+}
+exports.MistralVibeAgent = MistralVibeAgent;

package/dist/agents/index.js

@@ -32,6 +32,7 @@ const TraeAgent_1 = require("./TraeAgent");
 const AmazonQCliAgent_1 = require("./AmazonQCliAgent");
 const FirebenderAgent_1 = require("./FirebenderAgent");
 const AntigravityAgent_1 = require("./AntigravityAgent");
+const MistralVibeAgent_1 = require("./MistralVibeAgent");
 exports.allAgents = [
     new CopilotAgent_1.CopilotAgent(),
     new ClaudeAgent_1.ClaudeAgent(),
@@ -61,6 +62,7 @@ exports.allAgents = [
     new AmazonQCliAgent_1.AmazonQCliAgent(),
     new FirebenderAgent_1.FirebenderAgent(),
     new AntigravityAgent_1.AntigravityAgent(),
+    new MistralVibeAgent_1.MistralVibeAgent(),
 ];
 /**
  * Generates a comma-separated list of agent identifiers for CLI help text.

package/dist/cli/handlers.js

@@ -43,11 +43,20 @@ const os = __importStar(require("os"));
 const fs = __importStar(require("fs/promises"));
 const constants_1 = require("../constants");
 const ConfigLoader_1 = require("../core/ConfigLoader");
+function assertNotInsideRulerDir(projectRoot) {
+    const normalized = path.resolve(projectRoot);
+    const segments = normalized.split(path.sep);
+    if (segments.includes('.ruler')) {
+        console.error(`${constants_1.ERROR_PREFIX} Cannot run from inside a .ruler directory. Please run from your project root.`);
+        process.exit(1);
+    }
+}
 /**
  * Handler for the 'apply' command.
  */
 async function applyHandler(argv) {
     const projectRoot = argv['project-root'];
+    assertNotInsideRulerDir(projectRoot);
     const agents = argv.agents
         ? argv.agents.split(',').map((a) => a.trim())
         : undefined;
@@ -192,6 +201,7 @@ async function initHandler(argv) {
  */
 async function revertHandler(argv) {
     const projectRoot = argv['project-root'];
+    assertNotInsideRulerDir(projectRoot);
     const agents = argv.agents
         ? argv.agents.split(',').map((a) => a.trim())
         : undefined;

package/dist/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SKILLZ_MCP_SERVER_NAME = exports.SKILL_MD_FILENAME = exports.SKILLZ_DIR = exports.GOOSE_SKILLS_PATH = exports.OPENCODE_SKILLS_PATH = exports.CODEX_SKILLS_PATH = exports.CLAUDE_SKILLS_PATH = exports.RULER_SKILLS_PATH = exports.SKILLS_DIR = exports.DEFAULT_RULES_FILENAME = exports.ERROR_PREFIX = void 0;
+exports.SKILLZ_MCP_SERVER_NAME = exports.SKILL_MD_FILENAME = exports.SKILLZ_DIR = exports.VIBE_SKILLS_PATH = exports.GOOSE_SKILLS_PATH = exports.OPENCODE_SKILLS_PATH = exports.CODEX_SKILLS_PATH = exports.CLAUDE_SKILLS_PATH = exports.RULER_SKILLS_PATH = exports.SKILLS_DIR = exports.DEFAULT_RULES_FILENAME = exports.ERROR_PREFIX = void 0;
 exports.actionPrefix = actionPrefix;
 exports.createRulerError = createRulerError;
 exports.logVerbose = logVerbose;
@@ -56,6 +56,7 @@ exports.CLAUDE_SKILLS_PATH = '.claude/skills';
 exports.CODEX_SKILLS_PATH = '.codex/skills';
 exports.OPENCODE_SKILLS_PATH = '.opencode/skill';
 exports.GOOSE_SKILLS_PATH = '.agents/skills';
+exports.VIBE_SKILLS_PATH = '.vibe/skills';
 exports.SKILLZ_DIR = '.skillz';
 exports.SKILL_MD_FILENAME = 'SKILL.md';
 exports.SKILLZ_MCP_SERVER_NAME = 'skillz';

package/dist/core/SkillsProcessor.js

@@ -40,6 +40,7 @@ exports.propagateSkillsForClaude = propagateSkillsForClaude;
 exports.propagateSkillsForCodex = propagateSkillsForCodex;
 exports.propagateSkillsForOpenCode = propagateSkillsForOpenCode;
 exports.propagateSkillsForGoose = propagateSkillsForGoose;
+exports.propagateSkillsForVibe = propagateSkillsForVibe;
 exports.propagateSkillsForSkillz = propagateSkillsForSkillz;
 exports.buildSkillzMcpConfig = buildSkillzMcpConfig;
 const path = __importStar(require("path"));
@@ -77,12 +78,13 @@ async function getSkillsGitignorePaths(projectRoot) {
         return [];
     }
     // Import here to avoid circular dependency
-    const { CLAUDE_SKILLS_PATH, CODEX_SKILLS_PATH, OPENCODE_SKILLS_PATH, GOOSE_SKILLS_PATH, SKILLZ_DIR, } = await Promise.resolve().then(() => __importStar(require('../constants')));
+    const { CLAUDE_SKILLS_PATH, CODEX_SKILLS_PATH, OPENCODE_SKILLS_PATH, GOOSE_SKILLS_PATH, VIBE_SKILLS_PATH, SKILLZ_DIR, } = await Promise.resolve().then(() => __importStar(require('../constants')));
     return [
         path.join(projectRoot, CLAUDE_SKILLS_PATH),
         path.join(projectRoot, CODEX_SKILLS_PATH),
         path.join(projectRoot, OPENCODE_SKILLS_PATH),
         path.join(projectRoot, GOOSE_SKILLS_PATH),
+        path.join(projectRoot, VIBE_SKILLS_PATH),
         path.join(projectRoot, SKILLZ_DIR),
     ];
 }
@@ -114,6 +116,7 @@ async function cleanupSkillsDirectories(projectRoot, dryRun, verbose) {
     const codexSkillsPath = path.join(projectRoot, constants_1.CODEX_SKILLS_PATH);
     const opencodeSkillsPath = path.join(projectRoot, constants_1.OPENCODE_SKILLS_PATH);
     const gooseSkillsPath = path.join(projectRoot, constants_1.GOOSE_SKILLS_PATH);
+    const vibeSkillsPath = path.join(projectRoot, constants_1.VIBE_SKILLS_PATH);
     const skillzPath = path.join(projectRoot, constants_1.SKILLZ_DIR);
     // Clean up .claude/skills
     try {
@@ -171,6 +174,20 @@ async function cleanupSkillsDirectories(projectRoot, dryRun, verbose) {
     catch {
         // Directory doesn't exist, nothing to clean
     }
+    // Clean up .vibe/skills
+    try {
+        await fs.access(vibeSkillsPath);
+        if (dryRun) {
+            (0, constants_1.logVerboseInfo)(`DRY RUN: Would remove ${constants_1.VIBE_SKILLS_PATH}`, verbose, dryRun);
+        }
+        else {
+            await fs.rm(vibeSkillsPath, { recursive: true, force: true });
+            (0, constants_1.logVerboseInfo)(`Removed ${constants_1.VIBE_SKILLS_PATH} (skills disabled)`, verbose, dryRun);
+        }
+    }
+    catch {
+        // Directory doesn't exist, nothing to clean
+    }
     // Clean up .skillz
     try {
         await fs.access(skillzPath);
@@ -237,6 +254,8 @@ async function propagateSkills(projectRoot, agents, skillsEnabled, verbose, dryR
         await propagateSkillsForOpenCode(projectRoot, { dryRun });
         (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.GOOSE_SKILLS_PATH} for Goose`, verbose, dryRun);
         await propagateSkillsForGoose(projectRoot, { dryRun });
+        (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.VIBE_SKILLS_PATH} for Mistral Vibe`, verbose, dryRun);
+        await propagateSkillsForVibe(projectRoot, { dryRun });
     }
     // Copy to .skillz directory if needed
     if (hasMcpAgent) {
@@ -444,6 +463,56 @@ async function propagateSkillsForGoose(projectRoot, options) {
     }
     return [];
 }
+/**
+ * Propagates skills for Mistral Vibe by copying .ruler/skills to .vibe/skills.
+ * Uses atomic replace to ensure safe overwriting of existing skills.
+ * Returns dry-run steps if dryRun is true, otherwise returns empty array.
+ */
+async function propagateSkillsForVibe(projectRoot, options) {
+    const skillsDir = path.join(projectRoot, constants_1.RULER_SKILLS_PATH);
+    const vibeSkillsPath = path.join(projectRoot, constants_1.VIBE_SKILLS_PATH);
+    const vibeDir = path.dirname(vibeSkillsPath);
+    // Check if source skills directory exists
+    try {
+        await fs.access(skillsDir);
+    }
+    catch {
+        // No skills directory - return empty
+        return [];
+    }
+    if (options.dryRun) {
+        return [`Copy skills from ${constants_1.RULER_SKILLS_PATH} to ${constants_1.VIBE_SKILLS_PATH}`];
+    }
+    // Ensure .vibe directory exists
+    await fs.mkdir(vibeDir, { recursive: true });
+    // Use atomic replace: copy to temp, then rename
+    const tempDir = path.join(vibeDir, `skills.tmp-${Date.now()}`);
+    try {
+        // Copy to temp directory
+        await (0, SkillsUtils_1.copySkillsDirectory)(skillsDir, tempDir);
+        // Atomically replace the target
+        // First, remove existing target if it exists
+        try {
+            await fs.rm(vibeSkillsPath, { recursive: true, force: true });
+        }
+        catch {
+            // Target didn't exist, that's fine
+        }
+        // Rename temp to target
+        await fs.rename(tempDir, vibeSkillsPath);
+    }
+    catch (error) {
+        // Clean up temp directory on error
+        try {
+            await fs.rm(tempDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        throw error;
+    }
+    return [];
+}
 /**
  * Propagates skills for MCP agents by copying .ruler/skills to .skillz.
  * Uses atomic replace to ensure safe overwriting of existing skills.

package/dist/core/apply-engine.js

@@ -577,7 +577,31 @@ async function applyStandardMcpConfiguration(agent, filteredMcpJson, dest, agent
             out[serverKey] = cleanedServers;
             return out;
         };
-        const toWrite = sanitizeForFirebase(merged);
+        // Gemini CLI (since v0.21.0) no longer accepts the "type" field in MCP server entries.
+        // Following the MCP spec update from Nov 25, 2025, the transport type is now inferred
+        // from the presence of specific keys (command/args -> stdio, url -> sse/http).
+        // Sanitize merged config by stripping 'type' from each server when targeting Gemini.
+        const sanitizeForGemini = (obj) => {
+            if (agent.getIdentifier() !== 'gemini-cli')
+                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;
+        };
+        let toWrite = sanitizeForFirebase(merged);
+        toWrite = sanitizeForGemini(toWrite);
         // Only backup and write if content would actually change (idempotent)
         const currentContent = JSON.stringify(existing, null, 2);
         const newContent = JSON.stringify(toWrite, null, 2);

package/package.json

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