@intellectronica/ruler 0.3.36 → 0.3.38

package/README.md

@@ -63,7 +63,7 @@ Ruler solves this by providing a **single source of truth** for all your AI agen
 | Pi Coding Agent        | `AGENTS.md`                                    | -                                                | `.pi/skills/`             |
 | Jules                  | `AGENTS.md`                                    | -                                                | -                         |
 | Cursor                 | `AGENTS.md`                                    | `.cursor/mcp.json`                               | `.cursor/skills/`         |
-| Windsurf               | `AGENTS.md`                                    | `.windsurf/mcp_config.json`                      | -                         |
+| Windsurf               | `AGENTS.md`                                    | `.windsurf/mcp_config.json`                      | `.windsurf/skills/`       |
 | Cline                  | `.clinerules`                                  | -                                                | -                         |
 | Crush                  | `CRUSH.md`                                     | `.crush.json`                                    | -                         |
 | Amp                    | `AGENTS.md`                                    | -                                                | `.agents/skills/`         |
@@ -73,7 +73,7 @@ Ruler solves this by providing a **single source of truth** for all your AI agen
 | Firebase Studio        | `.idx/airules.md`                              | `.idx/mcp.json`                                  | -                         |
 | Open Hands             | `.openhands/microagents/repo.md`               | `config.toml`                                    | -                         |
 | Gemini CLI             | `AGENTS.md`                                    | `.gemini/settings.json`                          | `.gemini/skills/`         |
-| Junie                  | `.junie/guidelines.md`                         | `.junie/mcp/mcp.json`                            | -                         |
+| Junie                  | `.junie/guidelines.md`                         | `.junie/mcp/mcp.json`                            | `.junie/skills/`          |
 | AugmentCode            | `.augment/rules/ruler_augment_instructions.md` | -                                                | -                         |
 | Kilo Code              | `AGENTS.md`                                    | `.kilocode/mcp.json`                             | `.claude/skills/`         |
 | OpenCode               | `AGENTS.md`                                    | `opencode.json`                                  | `.opencode/skills/`       |
@@ -325,15 +325,15 @@ ruler revert [options]
 
 ### Options
 
-| Option                         | Description                                                                                                                                                                                                                                                                                                      |
-| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `--project-root <path>`        | Path to your project's root (default: current directory)                                                                                                                                                                                                                                                         |
+| 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, factory, firebase, firebender, gemini-cli, goose, jetbrains-ai, jules, junie, kilocode, kiro, mistral, opencode, openhands, pi, 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                                                                                                                                                                                                                                                                 |
-| `--verbose` / `-v`             | Display detailed output during execution                                                                                                                                                                                                                                                                         |
-| `--local-only`                 | Only search for local .ruler directories, ignore global config                                                                                                                                                                                                                                                   |
+| `--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                                                                                                                                                                                                                                                                               |
+| `--verbose` / `-v`             | Display detailed output during execution                                                                                                                                                                                                                                                                                       |
+| `--local-only`                 | Only search for local .ruler directories, ignore global config                                                                                                                                                                                                                                                                 |
 
 ### Common Examples
 
@@ -594,7 +594,9 @@ Skills are specialized knowledge packages that extend AI agent capabilities with
   - **Mistral Vibe**: `.vibe/skills/`
   - **Roo Code**: `.roo/skills/`
   - **Gemini CLI**: `.gemini/skills/`
+  - **Junie**: `.junie/skills/`
   - **Cursor**: `.cursor/skills/`
+  - **Windsurf**: `.windsurf/skills/`
 
 ### Skills Directory Structure
 
@@ -659,13 +661,14 @@ When skills support is enabled and gitignore integration is active, Ruler automa
 - `.vibe/skills/` (for Mistral Vibe)
 - `.roo/skills/` (for Roo Code)
 - `.gemini/skills/` (for Gemini CLI)
+- `.junie/skills/` (for Junie)
 - `.cursor/skills/` (for Cursor)
 
 to your `.gitignore` file within the managed Ruler block.
 
 ### Requirements
 
-- **For agents with native skills support** (Claude Code, GitHub Copilot, Kilo Code, OpenAI Codex CLI, OpenCode, Pi Coding Agent, Goose, Amp, Antigravity, Factory Droid, Mistral Vibe, Roo Code, Gemini CLI, Cursor): No additional requirements.
+- **For agents with native skills support** (Claude Code, GitHub Copilot, Kilo Code, OpenAI Codex CLI, OpenCode, Pi Coding Agent, Goose, Amp, Antigravity, Factory Droid, Mistral Vibe, Roo Code, Gemini CLI, Junie, Cursor): No additional requirements.
 
 ### Validation
 
@@ -718,6 +721,7 @@ ruler apply
 #    - Mistral Vibe: .vibe/skills/my-skill/
 #    - Roo Code: .roo/skills/my-skill/
 #    - Gemini CLI: .gemini/skills/my-skill/
+#    - Junie: .junie/skills/my-skill/
 #    - Cursor: .cursor/skills/my-skill/
 ```
 

package/dist/agents/JunieAgent.js

@@ -55,5 +55,8 @@ class JunieAgent extends AbstractAgent_1.AbstractAgent {
     supportsMcpRemote() {
         return true;
     }
+    supportsNativeSkills() {
+        return true;
+    }
 }
 exports.JunieAgent = JunieAgent;

package/dist/agents/WindsurfAgent.js

@@ -23,5 +23,8 @@ class WindsurfAgent extends AgentsMdAgent_1.AgentsMdAgent {
     supportsMcpRemote() {
         return true;
     }
+    supportsNativeSkills() {
+        return true;
+    }
 }
 exports.WindsurfAgent = WindsurfAgent;

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.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.SKILL_MD_FILENAME = exports.ANTIGRAVITY_SKILLS_PATH = exports.FACTORY_SKILLS_PATH = exports.WINDSURF_SKILLS_PATH = exports.CURSOR_SKILLS_PATH = exports.JUNIE_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;
@@ -60,7 +60,9 @@ exports.GOOSE_SKILLS_PATH = '.agents/skills';
 exports.VIBE_SKILLS_PATH = '.vibe/skills';
 exports.ROO_SKILLS_PATH = '.roo/skills';
 exports.GEMINI_SKILLS_PATH = '.gemini/skills';
+exports.JUNIE_SKILLS_PATH = '.junie/skills';
 exports.CURSOR_SKILLS_PATH = '.cursor/skills';
+exports.WINDSURF_SKILLS_PATH = '.windsurf/skills';
 exports.FACTORY_SKILLS_PATH = '.factory/skills';
 exports.ANTIGRAVITY_SKILLS_PATH = '.agent/skills';
 exports.SKILL_MD_FILENAME = 'SKILL.md';

package/dist/core/SkillsProcessor.js

@@ -44,7 +44,9 @@ exports.propagateSkillsForGoose = propagateSkillsForGoose;
 exports.propagateSkillsForVibe = propagateSkillsForVibe;
 exports.propagateSkillsForRoo = propagateSkillsForRoo;
 exports.propagateSkillsForGemini = propagateSkillsForGemini;
+exports.propagateSkillsForJunie = propagateSkillsForJunie;
 exports.propagateSkillsForCursor = propagateSkillsForCursor;
+exports.propagateSkillsForWindsurf = propagateSkillsForWindsurf;
 exports.propagateSkillsForFactory = propagateSkillsForFactory;
 exports.propagateSkillsForAntigravity = propagateSkillsForAntigravity;
 const path = __importStar(require("path"));
@@ -82,7 +84,7 @@ async function getSkillsGitignorePaths(projectRoot, agents) {
         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, FACTORY_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, JUNIE_SKILLS_PATH, CURSOR_SKILLS_PATH, WINDSURF_SKILLS_PATH, FACTORY_SKILLS_PATH, ANTIGRAVITY_SKILLS_PATH, } = await Promise.resolve().then(() => __importStar(require('../constants')));
     const selectedTargets = getSelectedSkillTargets(agents);
     const targetPaths = {
         claude: CLAUDE_SKILLS_PATH,
@@ -93,7 +95,9 @@ async function getSkillsGitignorePaths(projectRoot, agents) {
         vibe: VIBE_SKILLS_PATH,
         roo: ROO_SKILLS_PATH,
         gemini: GEMINI_SKILLS_PATH,
+        junie: JUNIE_SKILLS_PATH,
         cursor: CURSOR_SKILLS_PATH,
+        windsurf: WINDSURF_SKILLS_PATH,
         factory: FACTORY_SKILLS_PATH,
         antigravity: ANTIGRAVITY_SKILLS_PATH,
     };
@@ -126,7 +130,9 @@ const SKILL_TARGET_TO_IDENTIFIERS = new Map([
     ['vibe', ['mistral']],
     ['roo', ['roo']],
     ['gemini', ['gemini-cli']],
+    ['junie', ['junie']],
     ['cursor', ['cursor']],
+    ['windsurf', ['windsurf']],
     ['factory', ['factory']],
     ['antigravity', ['antigravity']],
 ]);
@@ -155,7 +161,9 @@ async function cleanupSkillsDirectories(projectRoot, dryRun, verbose) {
     const vibeSkillsPath = path.join(projectRoot, constants_1.VIBE_SKILLS_PATH);
     const rooSkillsPath = path.join(projectRoot, constants_1.ROO_SKILLS_PATH);
     const geminiSkillsPath = path.join(projectRoot, constants_1.GEMINI_SKILLS_PATH);
+    const junieSkillsPath = path.join(projectRoot, constants_1.JUNIE_SKILLS_PATH);
     const cursorSkillsPath = path.join(projectRoot, constants_1.CURSOR_SKILLS_PATH);
+    const windsurfSkillsPath = path.join(projectRoot, constants_1.WINDSURF_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
@@ -270,6 +278,20 @@ async function cleanupSkillsDirectories(projectRoot, dryRun, verbose) {
     catch {
         // Directory doesn't exist, nothing to clean
     }
+    // Clean up .junie/skills
+    try {
+        await fs.access(junieSkillsPath);
+        if (dryRun) {
+            (0, constants_1.logVerboseInfo)(`DRY RUN: Would remove ${constants_1.JUNIE_SKILLS_PATH}`, verbose, dryRun);
+        }
+        else {
+            await fs.rm(junieSkillsPath, { recursive: true, force: true });
+            (0, constants_1.logVerboseInfo)(`Removed ${constants_1.JUNIE_SKILLS_PATH} (skills disabled)`, verbose, dryRun);
+        }
+    }
+    catch {
+        // Directory doesn't exist, nothing to clean
+    }
     // Clean up .cursor/skills
     try {
         await fs.access(cursorSkillsPath);
@@ -284,6 +306,20 @@ async function cleanupSkillsDirectories(projectRoot, dryRun, verbose) {
     catch {
         // Directory doesn't exist, nothing to clean
     }
+    // Clean up .windsurf/skills
+    try {
+        await fs.access(windsurfSkillsPath);
+        if (dryRun) {
+            (0, constants_1.logVerboseInfo)(`DRY RUN: Would remove ${constants_1.WINDSURF_SKILLS_PATH}`, verbose, dryRun);
+        }
+        else {
+            await fs.rm(windsurfSkillsPath, { recursive: true, force: true });
+            (0, constants_1.logVerboseInfo)(`Removed ${constants_1.WINDSURF_SKILLS_PATH} (skills disabled)`, verbose, dryRun);
+        }
+    }
+    catch {
+        // Directory doesn't exist, nothing to clean
+    }
     // Clean up .factory/skills
     try {
         await fs.access(factorySkillsPath);
@@ -395,10 +431,18 @@ async function propagateSkills(projectRoot, agents, skillsEnabled, verbose, dryR
         (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.GEMINI_SKILLS_PATH} for Gemini CLI`, verbose, dryRun);
         await propagateSkillsForGemini(projectRoot, { dryRun });
     }
+    if (selectedTargets.has('junie')) {
+        (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.JUNIE_SKILLS_PATH} for Junie`, verbose, dryRun);
+        await propagateSkillsForJunie(projectRoot, { dryRun });
+    }
     if (selectedTargets.has('cursor')) {
         (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.CURSOR_SKILLS_PATH} for Cursor`, verbose, dryRun);
         await propagateSkillsForCursor(projectRoot, { dryRun });
     }
+    if (selectedTargets.has('windsurf')) {
+        (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.WINDSURF_SKILLS_PATH} for Windsurf`, verbose, dryRun);
+        await propagateSkillsForWindsurf(projectRoot, { dryRun });
+    }
     if (selectedTargets.has('factory')) {
         (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.FACTORY_SKILLS_PATH} for Factory Droid`, verbose, dryRun);
         await propagateSkillsForFactory(projectRoot, { dryRun });
@@ -809,6 +853,47 @@ async function propagateSkillsForGemini(projectRoot, options) {
     }
     return [];
 }
+/**
+ * Propagates skills for Junie by copying .ruler/skills to .junie/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 propagateSkillsForJunie(projectRoot, options) {
+    const skillsDir = path.join(projectRoot, constants_1.RULER_SKILLS_PATH);
+    const junieSkillsPath = path.join(projectRoot, constants_1.JUNIE_SKILLS_PATH);
+    const junieDir = path.dirname(junieSkillsPath);
+    try {
+        await fs.access(skillsDir);
+    }
+    catch {
+        return [];
+    }
+    if (options.dryRun) {
+        return [`Copy skills from ${constants_1.RULER_SKILLS_PATH} to ${constants_1.JUNIE_SKILLS_PATH}`];
+    }
+    await fs.mkdir(junieDir, { recursive: true });
+    const tempDir = path.join(junieDir, `skills.tmp-${Date.now()}`);
+    try {
+        await (0, SkillsUtils_1.copySkillsDirectory)(skillsDir, tempDir);
+        try {
+            await fs.rm(junieSkillsPath, { recursive: true, force: true });
+        }
+        catch {
+            // Target didn't exist, that's fine
+        }
+        await fs.rename(tempDir, junieSkillsPath);
+    }
+    catch (error) {
+        try {
+            await fs.rm(tempDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        throw error;
+    }
+    return [];
+}
 /**
  * Propagates skills for Cursor by copying .ruler/skills to .cursor/skills.
  * Uses atomic replace to ensure safe overwriting of existing skills.
@@ -859,6 +944,56 @@ async function propagateSkillsForCursor(projectRoot, options) {
     }
     return [];
 }
+/**
+ * Propagates skills for Windsurf by copying .ruler/skills to .windsurf/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 propagateSkillsForWindsurf(projectRoot, options) {
+    const skillsDir = path.join(projectRoot, constants_1.RULER_SKILLS_PATH);
+    const windsurfSkillsPath = path.join(projectRoot, constants_1.WINDSURF_SKILLS_PATH);
+    const windsurfDir = path.dirname(windsurfSkillsPath);
+    // 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.WINDSURF_SKILLS_PATH}`];
+    }
+    // Ensure .windsurf directory exists
+    await fs.mkdir(windsurfDir, { recursive: true });
+    // Use atomic replace: copy to temp, then rename
+    const tempDir = path.join(windsurfDir, `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(windsurfSkillsPath, { recursive: true, force: true });
+        }
+        catch {
+            // Target didn't exist, that's fine
+        }
+        // Rename temp to target
+        await fs.rename(tempDir, windsurfSkillsPath);
+    }
+    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 Factory Droid by copying .ruler/skills to .factory/skills.
  * Uses atomic replace to ensure safe overwriting of existing skills.

package/package.json

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