@intellectronica/ruler 0.3.11 → 0.3.13

package/README.md

@@ -54,16 +54,16 @@ Ruler solves this by providing a **single source of truth** for all your AI agen
 
 ## Supported AI Agents
 
-| Agent            | Rules File(s)                                 | MCP Configuration / Notes                        |
-| ---------------- | --------------------------------------------- | ------------------------------------------------ |
-| AGENTS.md        | `AGENTS.md`                                   | (pseudo-agent ensuring root `AGENTS.md` exists)  |
-| GitHub Copilot   | `AGENTS.md`                                   | `.vscode/mcp.json`                               |
-| Claude Code      | `CLAUDE.md`                                   | `.mcp.json`                                      |
-| OpenAI Codex CLI | `AGENTS.md`                                   | `.codex/config.toml`                             |
-| Jules            | `AGENTS.md`                                   | -                                                |
-| Cursor           | `.cursor/rules/ruler_cursor_instructions.mdc` | `.cursor/mcp.json`                               |
-| Windsurf         | `AGENTS.md`                                   | `.windsurf/mcp_config.json`                      |
-| Cline            | `.clinerules`                                 | -                                                |
+| Agent            | Rules File(s)                                    | MCP Configuration / Notes                        |
+| ---------------- | ------------------------------------------------ | ------------------------------------------------ |
+| AGENTS.md        | `AGENTS.md`                                      | (pseudo-agent ensuring root `AGENTS.md` exists)  |
+| GitHub Copilot   | `AGENTS.md`                                      | `.vscode/mcp.json`                               |
+| Claude Code      | `CLAUDE.md`                                      | `.mcp.json`                                      |
+| OpenAI Codex CLI | `AGENTS.md`                                      | `.codex/config.toml`                             |
+| Jules            | `AGENTS.md`                                      | -                                                |
+| Cursor           | `AGENTS.md`                                      | `.cursor/mcp.json`                               |
+| Windsurf         | `AGENTS.md`                                      | `.windsurf/mcp_config.json`                      |
+| Cline            | `.clinerules`                                    | -                                                |
 | Crush            | `CRUSH.md`                                       | `.crush.json`                                    |
 | Amp              | `AGENTS.md`                                      | -                                                |
 | Amazon Q CLI     | `.amazonq/rules/ruler_q_rules.md`                | `.amazonq/mcp.json`                              |
@@ -82,7 +82,7 @@ Ruler solves this by providing a **single source of truth** for all your AI agen
 | Trae AI          | `.trae/rules/project_rules.md`                   | -                                                |
 | Warp             | `WARP.md`                                        | -                                                |
 | Kiro             | `.kiro/steering/ruler_kiro_instructions.md`      | -                                                |
-| Firebender       | `firebender.json`                                | -                                                |
+| Firebender       | `firebender.json`                                | `firebender.json` (rules and MCP in same file)   |
 
 ## Getting Started
 
@@ -582,9 +582,11 @@ Skills can be organized flat or nested:
 ```
 
 Each skill must contain:
+
 - `SKILL.md` - Primary skill file with instructions or knowledge base
 
 Skills can optionally include additional resources like:
+
 - Markdown files with supplementary documentation
 - Python, JavaScript, or other scripts
 - Configuration files or data
@@ -594,6 +596,7 @@ Skills can optionally include additional resources like:
 Skills support is **enabled by default** but can be controlled via:
 
 **CLI flags:**
+
 ```bash
 # Enable skills (default)
 ruler apply --skills
@@ -603,6 +606,7 @@ ruler apply --no-skills
 ```
 
 **Configuration in `ruler.toml`:**
+
 ```toml
 [skills]
 enabled = true  # or false to disable
@@ -617,6 +621,7 @@ For agents that support MCP but don't have native skills support (all agents exc
 3. Uses `uvx` to launch the server with the absolute path to `.skillz`
 
 Example auto-generated MCP server configuration:
+
 ```toml
 [mcp_servers.skillz]
 command = "uvx"
@@ -626,6 +631,7 @@ args = ["skillz@latest", "/absolute/path/to/project/.skillz"]
 ### `.gitignore` Integration
 
 When skills support is enabled and gitignore integration is active, Ruler automatically adds:
+
 - `.claude/skills/` (for Claude Code agents)
 - `.skillz/` (for MCP-based agents)
 
@@ -643,6 +649,7 @@ to your `.gitignore` file within the managed Ruler block.
 ### Validation
 
 Ruler validates discovered skills and issues warnings for:
+
 - Missing required file (`SKILL.md`)
 - Invalid directory structures (directories without `SKILL.md` and no sub-skills)
 
@@ -651,6 +658,7 @@ Warnings don't prevent propagation but help identify potential issues.
 ### Dry-Run Mode
 
 Test skills propagation without making changes:
+
 ```bash
 ruler apply --dry-run
 ```
@@ -704,11 +712,8 @@ node_modules/
 # START Ruler Generated Files
 .aider.conf.yml
 .clinerules
-.cursor/rules/ruler_cursor_instructions.mdc
-.windsurf/rules/ruler_windsurf_instructions.md
 AGENTS.md
 CLAUDE.md
-AGENTS.md
 # END Ruler Generated Files
 
 dist/

package/dist/agents/AbstractAgent.js

@@ -49,8 +49,7 @@ class AbstractAgent {
      * 3. Backing up the existing file
      * 4. Writing the new content
      */
-    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, // eslint-disable-line @typescript-eslint/no-unused-vars
-    agentConfig, backup = true) {
+    async applyRulerConfig(concatenatedRules, projectRoot, _rulerMcpJson, agentConfig, backup = true) {
         const output = agentConfig?.outputPath ?? this.getDefaultOutputPath(projectRoot);
         const absolutePath = path.resolve(projectRoot, output);
         await (0, FileSystemUtils_1.ensureDirExists)(path.dirname(absolutePath));

package/dist/agents/AgentsMdAgent.js

@@ -53,8 +53,7 @@ class AgentsMdAgent extends AbstractAgent_1.AbstractAgent {
     getDefaultOutputPath(projectRoot) {
         return path.join(projectRoot, 'AGENTS.md');
     }
-    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, // eslint-disable-line @typescript-eslint/no-unused-vars
-    agentConfig, backup = true) {
+    async applyRulerConfig(concatenatedRules, projectRoot, _rulerMcpJson, agentConfig, backup = true) {
         const output = agentConfig?.outputPath ?? this.getDefaultOutputPath(projectRoot);
         const absolutePath = path.resolve(projectRoot, output);
         await (0, FileSystemUtils_1.ensureDirExists)(path.dirname(absolutePath));

package/dist/agents/AugmentCodeAgent.js

@@ -47,8 +47,7 @@ class AugmentCodeAgent {
     getName() {
         return 'AugmentCode';
     }
-    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, // eslint-disable-line @typescript-eslint/no-unused-vars
-    agentConfig, backup = true) {
+    async applyRulerConfig(concatenatedRules, projectRoot, _rulerMcpJson, agentConfig, backup = true) {
         const output = agentConfig?.outputPath ?? this.getDefaultOutputPath(projectRoot);
         if (backup) {
             await (0, FileSystemUtils_1.backupFile)(output);

package/dist/agents/CursorAgent.js

@@ -1,68 +1,28 @@
 "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.CursorAgent = void 0;
-const path = __importStar(require("path"));
-const AbstractAgent_1 = require("./AbstractAgent");
-const FileSystemUtils_1 = require("../core/FileSystemUtils");
+const AgentsMdAgent_1 = require("./AgentsMdAgent");
 /**
  * Cursor agent adapter.
+ * Leverages the standardized AGENTS.md approach supported natively by Cursor.
+ * See: https://docs.cursor.com/en/cli/using
  */
-class CursorAgent extends AbstractAgent_1.AbstractAgent {
+class CursorAgent extends AgentsMdAgent_1.AgentsMdAgent {
     getIdentifier() {
         return 'cursor';
     }
     getName() {
         return 'Cursor';
     }
-    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, // eslint-disable-line @typescript-eslint/no-unused-vars
-    agentConfig, backup = true) {
-        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(absolutePath));
-        if (backup) {
-            await (0, FileSystemUtils_1.backupFile)(absolutePath);
-        }
-        await (0, FileSystemUtils_1.writeGeneratedFile)(absolutePath, content);
+    async applyRulerConfig(concatenatedRules, projectRoot, _rulerMcpJson, agentConfig, backup = true) {
+        // Write AGENTS.md via base class
+        // Cursor natively reads AGENTS.md from the project root
+        await super.applyRulerConfig(concatenatedRules, projectRoot, null, {
+            outputPath: agentConfig?.outputPath,
+        }, backup);
     }
-    getDefaultOutputPath(projectRoot) {
-        return path.join(projectRoot, '.cursor', 'rules', 'ruler_cursor_instructions.mdc');
+    getMcpServerKey() {
+        return 'mcpServers';
     }
     supportsMcpStdio() {
         return true;

package/dist/agents/QwenCodeAgent.js

@@ -44,8 +44,7 @@ class QwenCodeAgent extends AgentsMdAgent_1.AgentsMdAgent {
     getName() {
         return 'Qwen Code';
     }
-    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, // eslint-disable-line @typescript-eslint/no-unused-vars
-    agentConfig) {
+    async applyRulerConfig(concatenatedRules, projectRoot, _rulerMcpJson, agentConfig) {
         // First, perform idempotent write of AGENTS.md via base class
         await super.applyRulerConfig(concatenatedRules, projectRoot, null, {
             outputPath: agentConfig?.outputPath,

package/dist/core/ConfigLoader.js

@@ -76,6 +76,27 @@ const rulerConfigSchema = zod_1.z.object({
         .optional(),
     nested: zod_1.z.boolean().optional(),
 });
+/**
+ * Recursively creates a new object with only enumerable string keys,
+ * effectively excluding Symbol properties.
+ * The @iarna/toml parser adds Symbol properties (Symbol(type), Symbol(declared))
+ * for metadata, which Zod v4+ validates and rejects as invalid record keys.
+ * By rebuilding the object structure using Object.keys(), we create clean objects
+ * that only contain the actual data without Symbol metadata.
+ */
+function stripSymbols(obj) {
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(stripSymbols);
+    }
+    const result = {};
+    for (const key of Object.keys(obj)) {
+        result[key] = stripSymbols(obj[key]);
+    }
+    return result;
+}
 /**
  * Loads and parses the ruler TOML configuration file, applying defaults.
  * If the file is missing or invalid, returns empty/default config.
@@ -102,7 +123,9 @@ async function loadConfig(options) {
     let raw = {};
     try {
         const text = await fs_1.promises.readFile(configFile, 'utf8');
-        raw = text.trim() ? (0, toml_1.parse)(text) : {};
+        const parsed = text.trim() ? (0, toml_1.parse)(text) : {};
+        // Strip Symbol properties added by @iarna/toml (required for Zod v4+)
+        raw = stripSymbols(parsed);
         // Validate the configuration with zod
         const validationResult = rulerConfigSchema.safeParse(raw);
         if (!validationResult.success) {

package/dist/core/apply-engine.js

@@ -500,6 +500,35 @@ function transformMcpForClaude(mcpJson) {
     transformedMcp.mcpServers = transformedServers;
     return transformedMcp;
 }
+/**
+ * Transform MCP server types for Kilo Code compatibility.
+ * Kilo Code expects "streamable-http" for remote HTTP servers, not "remote".
+ */
+function transformMcpForKiloCode(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 "streamable-http" for HTTP-based servers
+            if (server.type === 'remote' &&
+                server.url &&
+                typeof server.url === 'string') {
+                transformedServer.type = 'streamable-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 ??
@@ -516,11 +545,14 @@ async function applyStandardMcpConfiguration(agent, filteredMcpJson, dest, agent
         (0, constants_1.logVerbose)(`DRY RUN: Would apply MCP config to: ${dest}`, verbose);
     }
     else {
-        // Transform MCP config for Claude Code compatibility
+        // Transform MCP config for agent-specific compatibility
         let mcpToMerge = filteredMcpJson;
         if (agent.getIdentifier() === 'claude') {
             mcpToMerge = transformMcpForClaude(filteredMcpJson);
         }
+        else if (agent.getIdentifier() === 'kilocode') {
+            mcpToMerge = transformMcpForKiloCode(filteredMcpJson);
+        }
         const existing = await (0, mcp_1.readNativeMcp)(dest);
         const merged = (0, merge_1.mergeMcp)(existing, mcpToMerge, strategy, serverKey);
         // Firebase Studio (IDX) expects no "type" fields in .idx/mcp.json server entries.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intellectronica/ruler",
-  "version": "0.3.11",
+  "version": "0.3.13",
   "description": "Ruler — apply the same rules to all coding agents",
   "main": "dist/lib.js",
   "scripts": {
@@ -35,6 +35,9 @@
     "url": "https://github.com/intellectronica/ruler/issues"
   },
   "homepage": "https://ai.intellectronica.net/ruler",
+  "engines": {
+    "node": ">=18"
+  },
   "files": [
     "dist",
     "README.md",
@@ -47,22 +50,23 @@
     "@types/iarna__toml": "^2.0.5",
     "@types/jest": "^29.5.14",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^22.15.24",
-    "@types/yargs": "^17.0.33",
-    "@typescript-eslint/eslint-plugin": "^8.32.1",
-    "@typescript-eslint/parser": "^8.32.1",
-    "eslint": "^8.57.1",
-    "eslint-config-prettier": "^10.1.5",
-    "eslint-plugin-prettier": "^5.4.0",
+    "@types/node": "^24.9.2",
+    "@types/yargs": "^17.0.34",
+    "@typescript-eslint/eslint-plugin": "^8.46.2",
+    "@typescript-eslint/parser": "^8.46.2",
+    "eslint": "^9.38.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
     "jest": "^29.7.0",
-    "prettier": "^3.5.3",
-    "ts-jest": "^29.3.4",
-    "typescript": "^5.8.3"
+    "prettier": "^3.6.2",
+    "ts-jest": "^29.4.5",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.2"
   },
   "dependencies": {
     "@iarna/toml": "^2.2.5",
     "js-yaml": "^4.1.0",
-    "yargs": "^17.7.2",
-    "zod": "^3.25.28"
+    "yargs": "^18.0.0",
+    "zod": "^4.1.12"
   }
 }