@intellectronica/ruler 0.3.26 → 0.3.28

package/README.md

@@ -75,7 +75,7 @@ Ruler solves this by providing a **single source of truth** for all your AI agen
 | Gemini CLI       | `AGENTS.md`                                      | `.gemini/settings.json`                          | `.gemini/skills/`                                 |
 | Junie            | `.junie/guidelines.md`                           | -                                                | -                                                 |
 | AugmentCode      | `.augment/rules/ruler_augment_instructions.md`   | -                                                | -                                                 |
-| Kilo Code        | `.kilocode/rules/ruler_kilocode_instructions.md` | `.kilocode/mcp.json`                             | `.claude/skills/`                                 |
+| Kilo Code        | `AGENTS.md`                                      | `.kilocode/mcp.json`                             | `.claude/skills/`                                 |
 | OpenCode         | `AGENTS.md`                                      | `opencode.json`                                  | `.opencode/skill/`                                |
 | Goose            | `.goosehints`                                    | -                                                | `.agents/skills/`                                 |
 | Qwen Code        | `AGENTS.md`                                      | `.qwen/settings.json`                            | -                                                 |
@@ -91,6 +91,8 @@ Ruler solves this by providing a **single source of truth** for all your AI agen
 
 ### Installation
 
+Requires Node.js `^20.19.0 || ^22.12.0 || >=23`.
+
 **Global Installation (Recommended for CLI use):**
 
 ```bash
@@ -449,7 +451,7 @@ enabled = false
 
 [agents.kilocode]
 enabled = true
-output_path = ".kilocode/rules/ruler_kilocode_instructions.md"
+output_path = "AGENTS.md"
 
 [agents.warp]
 enabled = true

package/dist/agents/FactoryDroidAgent.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FactoryDroidAgent = void 0;
+const AgentsMdAgent_1 = require("./AgentsMdAgent");
+/**
+ * Factory Droid agent adapter.
+ * Uses the root-level AGENTS.md for instructions.
+ */
+class FactoryDroidAgent extends AgentsMdAgent_1.AgentsMdAgent {
+    getIdentifier() {
+        return 'factory';
+    }
+    getName() {
+        return 'Factory Droid';
+    }
+    getMcpServerKey() {
+        return 'mcpServers';
+    }
+    supportsMcpStdio() {
+        return true;
+    }
+    supportsMcpRemote() {
+        return true;
+    }
+    supportsNativeSkills() {
+        return true;
+    }
+}
+exports.FactoryDroidAgent = FactoryDroidAgent;

package/dist/agents/KiloCodeAgent.js

@@ -35,12 +35,12 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KiloCodeAgent = void 0;
 const path = __importStar(require("path"));
-const AbstractAgent_1 = require("./AbstractAgent");
+const AgentsMdAgent_1 = require("./AgentsMdAgent");
 /**
  * Kilo Code agent adapter.
- * Generates ruler_kilocode_instructions.md configuration file in .kilocode/rules/ directory.
+ * Uses AGENTS.md for instructions and .kilocode/mcp.json for MCP configuration.
  */
-class KiloCodeAgent extends AbstractAgent_1.AbstractAgent {
+class KiloCodeAgent extends AgentsMdAgent_1.AgentsMdAgent {
     getIdentifier() {
         return 'kilocode';
     }
@@ -48,7 +48,7 @@ class KiloCodeAgent extends AbstractAgent_1.AbstractAgent {
         return 'Kilo Code';
     }
     getDefaultOutputPath(projectRoot) {
-        return path.join(projectRoot, '.kilocode', 'rules', 'ruler_kilocode_instructions.md');
+        return path.join(projectRoot, 'AGENTS.md');
     }
     getMcpServerKey() {
         return 'mcpServers';

package/dist/agents/index.js

@@ -31,6 +31,7 @@ const RooCodeAgent_1 = require("./RooCodeAgent");
 const TraeAgent_1 = require("./TraeAgent");
 const AmazonQCliAgent_1 = require("./AmazonQCliAgent");
 const FirebenderAgent_1 = require("./FirebenderAgent");
+const FactoryDroidAgent_1 = require("./FactoryDroidAgent");
 const AntigravityAgent_1 = require("./AntigravityAgent");
 const MistralVibeAgent_1 = require("./MistralVibeAgent");
 const PiAgent_1 = require("./PiAgent");
@@ -62,6 +63,7 @@ exports.allAgents = [
     new TraeAgent_1.TraeAgent(),
     new AmazonQCliAgent_1.AmazonQCliAgent(),
     new FirebenderAgent_1.FirebenderAgent(),
+    new FactoryDroidAgent_1.FactoryDroidAgent(),
     new AntigravityAgent_1.AntigravityAgent(),
     new MistralVibeAgent_1.MistralVibeAgent(),
     new PiAgent_1.PiAgent(),

package/dist/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SKILL_MD_FILENAME = exports.ANTIGRAVITY_SKILLS_PATH = exports.CURSOR_SKILLS_PATH = exports.GEMINI_SKILLS_PATH = exports.ROO_SKILLS_PATH = exports.VIBE_SKILLS_PATH = exports.GOOSE_SKILLS_PATH = exports.PI_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.SKILL_MD_FILENAME = exports.ANTIGRAVITY_SKILLS_PATH = exports.FACTORY_SKILLS_PATH = exports.CURSOR_SKILLS_PATH = exports.GEMINI_SKILLS_PATH = exports.ROO_SKILLS_PATH = exports.VIBE_SKILLS_PATH = exports.GOOSE_SKILLS_PATH = exports.PI_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;
@@ -61,5 +61,6 @@ exports.VIBE_SKILLS_PATH = '.vibe/skills';
 exports.ROO_SKILLS_PATH = '.roo/skills';
 exports.GEMINI_SKILLS_PATH = '.gemini/skills';
 exports.CURSOR_SKILLS_PATH = '.cursor/skills';
+exports.FACTORY_SKILLS_PATH = '.factory/skills';
 exports.ANTIGRAVITY_SKILLS_PATH = '.agent/skills';
 exports.SKILL_MD_FILENAME = 'SKILL.md';

package/dist/core/SkillsProcessor.js

@@ -45,6 +45,7 @@ exports.propagateSkillsForVibe = propagateSkillsForVibe;
 exports.propagateSkillsForRoo = propagateSkillsForRoo;
 exports.propagateSkillsForGemini = propagateSkillsForGemini;
 exports.propagateSkillsForCursor = propagateSkillsForCursor;
+exports.propagateSkillsForFactory = propagateSkillsForFactory;
 exports.propagateSkillsForAntigravity = propagateSkillsForAntigravity;
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs/promises"));
@@ -81,7 +82,7 @@ async function getSkillsGitignorePaths(projectRoot) {
         return [];
     }
     // Import here to avoid circular dependency
-    const { CLAUDE_SKILLS_PATH, CODEX_SKILLS_PATH, OPENCODE_SKILLS_PATH, PI_SKILLS_PATH, GOOSE_SKILLS_PATH, VIBE_SKILLS_PATH, ROO_SKILLS_PATH, GEMINI_SKILLS_PATH, CURSOR_SKILLS_PATH, ANTIGRAVITY_SKILLS_PATH, } = await Promise.resolve().then(() => __importStar(require('../constants')));
+    const { CLAUDE_SKILLS_PATH, CODEX_SKILLS_PATH, OPENCODE_SKILLS_PATH, PI_SKILLS_PATH, GOOSE_SKILLS_PATH, VIBE_SKILLS_PATH, ROO_SKILLS_PATH, GEMINI_SKILLS_PATH, CURSOR_SKILLS_PATH, FACTORY_SKILLS_PATH, ANTIGRAVITY_SKILLS_PATH, } = await Promise.resolve().then(() => __importStar(require('../constants')));
     return [
         path.join(projectRoot, CLAUDE_SKILLS_PATH),
         path.join(projectRoot, CODEX_SKILLS_PATH),
@@ -92,6 +93,7 @@ async function getSkillsGitignorePaths(projectRoot) {
         path.join(projectRoot, ROO_SKILLS_PATH),
         path.join(projectRoot, GEMINI_SKILLS_PATH),
         path.join(projectRoot, CURSOR_SKILLS_PATH),
+        path.join(projectRoot, FACTORY_SKILLS_PATH),
         path.join(projectRoot, ANTIGRAVITY_SKILLS_PATH),
     ];
 }
@@ -127,6 +129,7 @@ async function cleanupSkillsDirectories(projectRoot, dryRun, verbose) {
     const rooSkillsPath = path.join(projectRoot, constants_1.ROO_SKILLS_PATH);
     const geminiSkillsPath = path.join(projectRoot, constants_1.GEMINI_SKILLS_PATH);
     const cursorSkillsPath = path.join(projectRoot, constants_1.CURSOR_SKILLS_PATH);
+    const factorySkillsPath = path.join(projectRoot, constants_1.FACTORY_SKILLS_PATH);
     const antigravitySkillsPath = path.join(projectRoot, constants_1.ANTIGRAVITY_SKILLS_PATH);
     // Clean up .claude/skills
     try {
@@ -254,6 +257,20 @@ async function cleanupSkillsDirectories(projectRoot, dryRun, verbose) {
     catch {
         // Directory doesn't exist, nothing to clean
     }
+    // Clean up .factory/skills
+    try {
+        await fs.access(factorySkillsPath);
+        if (dryRun) {
+            (0, constants_1.logVerboseInfo)(`DRY RUN: Would remove ${constants_1.FACTORY_SKILLS_PATH}`, verbose, dryRun);
+        }
+        else {
+            await fs.rm(factorySkillsPath, { recursive: true, force: true });
+            (0, constants_1.logVerboseInfo)(`Removed ${constants_1.FACTORY_SKILLS_PATH} (skills disabled)`, verbose, dryRun);
+        }
+    }
+    catch {
+        // Directory doesn't exist, nothing to clean
+    }
     // Clean up .agent/skills
     try {
         await fs.access(antigravitySkillsPath);
@@ -333,6 +350,8 @@ async function propagateSkills(projectRoot, agents, skillsEnabled, verbose, dryR
         await propagateSkillsForGemini(projectRoot, { dryRun });
         (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.CURSOR_SKILLS_PATH} for Cursor`, verbose, dryRun);
         await propagateSkillsForCursor(projectRoot, { dryRun });
+        (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.FACTORY_SKILLS_PATH} for Factory Droid`, verbose, dryRun);
+        await propagateSkillsForFactory(projectRoot, { dryRun });
         (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.ANTIGRAVITY_SKILLS_PATH} for Antigravity`, verbose, dryRun);
         await propagateSkillsForAntigravity(projectRoot, { dryRun });
     }
@@ -788,6 +807,56 @@ async function propagateSkillsForCursor(projectRoot, options) {
     }
     return [];
 }
+/**
+ * Propagates skills for Factory Droid by copying .ruler/skills to .factory/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 propagateSkillsForFactory(projectRoot, options) {
+    const skillsDir = path.join(projectRoot, constants_1.RULER_SKILLS_PATH);
+    const factorySkillsPath = path.join(projectRoot, constants_1.FACTORY_SKILLS_PATH);
+    const factoryDir = path.dirname(factorySkillsPath);
+    // 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.FACTORY_SKILLS_PATH}`];
+    }
+    // Ensure .factory directory exists
+    await fs.mkdir(factoryDir, { recursive: true });
+    // Use atomic replace: copy to temp, then rename
+    const tempDir = path.join(factoryDir, `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(factorySkillsPath, { recursive: true, force: true });
+        }
+        catch {
+            // Target didn't exist, that's fine
+        }
+        // Rename temp to target
+        await fs.rename(tempDir, factorySkillsPath);
+    }
+    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 Antigravity by copying .ruler/skills to .agent/skills.
  * Uses atomic replace to ensure safe overwriting of existing skills.

package/dist/core/apply-engine.js

@@ -489,6 +489,34 @@ function transformMcpForKiloCode(mcpJson) {
     transformedMcp.mcpServers = transformedServers;
     return transformedMcp;
 }
+/**
+ * Transform MCP server types for Factory Droid compatibility.
+ * Factory Droid expects "http" for remote HTTP servers, not "remote".
+ */
+function transformMcpForFactoryDroid(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 };
+            if (server.type === 'remote' &&
+                server.url &&
+                typeof server.url === 'string') {
+                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 ??
@@ -513,6 +541,9 @@ async function applyStandardMcpConfiguration(agent, filteredMcpJson, dest, agent
         else if (agent.getIdentifier() === 'kilocode') {
             mcpToMerge = transformMcpForKiloCode(filteredMcpJson);
         }
+        else if (agent.getIdentifier() === 'factory') {
+            mcpToMerge = transformMcpForFactoryDroid(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/dist/paths/mcp.js

@@ -86,6 +86,9 @@ async function getNativeMcpPath(adapterName, projectRoot) {
         case 'Firebase Studio':
             candidates.push(path.join(projectRoot, '.idx', 'mcp.json'));
             break;
+        case 'Factory Droid':
+            candidates.push(path.join(projectRoot, '.factory', '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.26",
+  "version": "0.3.28",
   "description": "Ruler — apply the same rules to all coding agents",
   "main": "dist/lib.js",
   "scripts": {
@@ -36,7 +36,7 @@
   },
   "homepage": "https://ai.intellectronica.net/ruler",
   "engines": {
-    "node": ">=18"
+    "node": "^20.19.0 || ^22.12.0 || >=23"
   },
   "files": [
     "dist",