@intellectronica/ruler 0.3.37 → 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/`         |
@@ -596,6 +596,7 @@ Skills are specialized knowledge packages that extend AI agent capabilities with
   - **Gemini CLI**: `.gemini/skills/`
   - **Junie**: `.junie/skills/`
   - **Cursor**: `.cursor/skills/`
+  - **Windsurf**: `.windsurf/skills/`
 
 ### Skills Directory Structure
 

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.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.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;
@@ -62,6 +62,7 @@ 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

@@ -46,6 +46,7 @@ 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"));
@@ -83,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, JUNIE_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,
@@ -96,6 +97,7 @@ async function getSkillsGitignorePaths(projectRoot, agents) {
         gemini: GEMINI_SKILLS_PATH,
         junie: JUNIE_SKILLS_PATH,
         cursor: CURSOR_SKILLS_PATH,
+        windsurf: WINDSURF_SKILLS_PATH,
         factory: FACTORY_SKILLS_PATH,
         antigravity: ANTIGRAVITY_SKILLS_PATH,
     };
@@ -130,6 +132,7 @@ const SKILL_TARGET_TO_IDENTIFIERS = new Map([
     ['gemini', ['gemini-cli']],
     ['junie', ['junie']],
     ['cursor', ['cursor']],
+    ['windsurf', ['windsurf']],
     ['factory', ['factory']],
     ['antigravity', ['antigravity']],
 ]);
@@ -160,6 +163,7 @@ async function cleanupSkillsDirectories(projectRoot, dryRun, verbose) {
     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
@@ -302,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);
@@ -421,6 +439,10 @@ async function propagateSkills(projectRoot, agents, skillsEnabled, verbose, dryR
         (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 });
@@ -922,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.37",
+  "version": "0.3.38",
   "description": "Ruler — apply the same rules to all coding agents",
   "main": "dist/lib.js",
   "scripts": {