@intellectronica/ruler 0.3.20 → 0.3.22

package/README.md

@@ -60,6 +60,7 @@ Ruler solves this by providing a **single source of truth** for all your AI agen
 | GitHub Copilot   | `AGENTS.md`                                      | `.vscode/mcp.json`                               |
 | Claude Code      | `CLAUDE.md`                                      | `.mcp.json`                                      |
 | OpenAI Codex CLI | `AGENTS.md`                                      | `.codex/config.toml`                             |
+| Pi Coding Agent  | `AGENTS.md`                                      | -                                                |
 | Jules            | `AGENTS.md`                                      | -                                                |
 | Cursor           | `AGENTS.md`                                      | `.cursor/mcp.json`                               |
 | Windsurf         | `AGENTS.md`                                      | `.windsurf/mcp_config.json`                      |
@@ -317,15 +318,15 @@ ruler revert [options]
 
 ### 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, 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                                                                                                                                                                                                                              |
-| `--verbose` / `-v`             | Display detailed output during execution                                                                                                                                                                                                                                      |
-| `--local-only`                 | Only search for local .ruler directories, ignore global config                                                                                                                                                                                                                |
+| 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, 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                                                                                                                                                                                                                                      |
 
 ### Common Examples
 
@@ -571,7 +572,9 @@ Skills are specialized knowledge packages that extend AI agent capabilities with
   - **GitHub Copilot**: `.claude/skills/` (shared with Claude Code)
   - **OpenAI Codex CLI**: `.codex/skills/`
   - **OpenCode**: `.opencode/skill/`
+  - **Pi Coding Agent**: `.pi/skills/`
   - **Goose**: `.agents/skills/`
+  - **Mistral Vibe**: `.vibe/skills/`
 - **Other MCP-compatible agents**: Skills are copied to `.skillz/` and a Skillz MCP server is automatically configured via `uvx`
 
 ### Skills Directory Structure
@@ -627,7 +630,7 @@ For agents that support MCP but don't have native skills support, Ruler automati
 2. Configures a Skillz MCP server in the agent's configuration
 3. Uses `uvx` to launch the server with the absolute path to `.skillz`
 
-Agents using native skills support (Claude Code, GitHub Copilot, OpenAI Codex CLI, OpenCode, and Goose) **do not** use the Skillz MCP server and instead use their own native skills directories.
+Agents using native skills support (Claude Code, GitHub Copilot, OpenAI Codex CLI, OpenCode, Pi Coding Agent, Goose, and Mistral Vibe) **do not** use the Skillz MCP server and instead use their own native skills directories.
 
 Example auto-generated MCP server configuration:
 
@@ -644,14 +647,16 @@ When skills support is enabled and gitignore integration is active, Ruler automa
 - `.claude/skills/` (for Claude Code and GitHub Copilot)
 - `.codex/skills/` (for OpenAI Codex CLI)
 - `.opencode/skill/` (for OpenCode)
+- `.pi/skills/` (for Pi Coding Agent)
 - `.agents/skills/` (for Goose)
+- `.vibe/skills/` (for Mistral Vibe)
 - `.skillz/` (for other MCP-based agents)
 
 to your `.gitignore` file within the managed Ruler block.
 
 ### Requirements
 
-- **For agents with native skills support** (Claude Code, GitHub Copilot, OpenAI Codex CLI, OpenCode, Goose): No additional requirements
+- **For agents with native skills support** (Claude Code, GitHub Copilot, OpenAI Codex CLI, OpenCode, Pi Coding Agent, Goose, Mistral Vibe): No additional requirements
 - **For other MCP agents**: `uv` must be installed and available in your PATH
   ```bash
   # Install uv if needed
@@ -702,7 +707,9 @@ ruler apply
 #    - Claude Code & GitHub Copilot: .claude/skills/my-skill/
 #    - OpenAI Codex CLI: .codex/skills/my-skill/
 #    - OpenCode: .opencode/skill/my-skill/
+#    - Pi Coding Agent: .pi/skills/my-skill/
 #    - Goose: .agents/skills/my-skill/
+#    - Mistral Vibe: .vibe/skills/my-skill/
 #    - Other MCP agents: .skillz/my-skill/ + Skillz MCP server configured
 ```
 

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/PiAgent.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PiAgent = void 0;
+const AgentsMdAgent_1 = require("./AgentsMdAgent");
+/**
+ * Pi Coding Agent adapter.
+ */
+class PiAgent extends AgentsMdAgent_1.AgentsMdAgent {
+    getIdentifier() {
+        return 'pi';
+    }
+    getName() {
+        return 'Pi Coding Agent';
+    }
+    supportsNativeSkills() {
+        return true;
+    }
+}
+exports.PiAgent = PiAgent;

package/dist/agents/index.js

@@ -33,6 +33,7 @@ const AmazonQCliAgent_1 = require("./AmazonQCliAgent");
 const FirebenderAgent_1 = require("./FirebenderAgent");
 const AntigravityAgent_1 = require("./AntigravityAgent");
 const MistralVibeAgent_1 = require("./MistralVibeAgent");
+const PiAgent_1 = require("./PiAgent");
 exports.allAgents = [
     new CopilotAgent_1.CopilotAgent(),
     new ClaudeAgent_1.ClaudeAgent(),
@@ -63,6 +64,7 @@ exports.allAgents = [
     new FirebenderAgent_1.FirebenderAgent(),
     new AntigravityAgent_1.AntigravityAgent(),
     new MistralVibeAgent_1.MistralVibeAgent(),
+    new PiAgent_1.PiAgent(),
 ];
 /**
  * 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;
@@ -143,7 +152,7 @@ async function initHandler(argv) {
 
 # --- Agent Specific Configurations ---
 # You can enable/disable agents and override their default output paths here.
-# Use lowercase agent identifiers: amp, copilot, claude, codex, cursor, windsurf, cline, aider, kilocode
+# Use lowercase agent identifiers: aider, amp, claude, cline, codex, copilot, cursor, kilocode, pi, windsurf
 
 # [agents.copilot]
 # enabled = true
@@ -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.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.SKILLZ_MCP_SERVER_NAME = exports.SKILL_MD_FILENAME = exports.SKILLZ_DIR = 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;
@@ -55,6 +55,7 @@ exports.RULER_SKILLS_PATH = '.ruler/skills';
 exports.CLAUDE_SKILLS_PATH = '.claude/skills';
 exports.CODEX_SKILLS_PATH = '.codex/skills';
 exports.OPENCODE_SKILLS_PATH = '.opencode/skill';
+exports.PI_SKILLS_PATH = '.pi/skills';
 exports.GOOSE_SKILLS_PATH = '.agents/skills';
 exports.VIBE_SKILLS_PATH = '.vibe/skills';
 exports.SKILLZ_DIR = '.skillz';

package/dist/core/SkillsProcessor.js

@@ -39,6 +39,7 @@ exports.propagateSkills = propagateSkills;
 exports.propagateSkillsForClaude = propagateSkillsForClaude;
 exports.propagateSkillsForCodex = propagateSkillsForCodex;
 exports.propagateSkillsForOpenCode = propagateSkillsForOpenCode;
+exports.propagateSkillsForPi = propagateSkillsForPi;
 exports.propagateSkillsForGoose = propagateSkillsForGoose;
 exports.propagateSkillsForVibe = propagateSkillsForVibe;
 exports.propagateSkillsForSkillz = propagateSkillsForSkillz;
@@ -78,11 +79,12 @@ async function getSkillsGitignorePaths(projectRoot) {
         return [];
     }
     // Import here to avoid circular dependency
-    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')));
+    const { CLAUDE_SKILLS_PATH, CODEX_SKILLS_PATH, OPENCODE_SKILLS_PATH, PI_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, PI_SKILLS_PATH),
         path.join(projectRoot, GOOSE_SKILLS_PATH),
         path.join(projectRoot, VIBE_SKILLS_PATH),
         path.join(projectRoot, SKILLZ_DIR),
@@ -115,6 +117,7 @@ async function cleanupSkillsDirectories(projectRoot, dryRun, verbose) {
     const claudeSkillsPath = path.join(projectRoot, constants_1.CLAUDE_SKILLS_PATH);
     const codexSkillsPath = path.join(projectRoot, constants_1.CODEX_SKILLS_PATH);
     const opencodeSkillsPath = path.join(projectRoot, constants_1.OPENCODE_SKILLS_PATH);
+    const piSkillsPath = path.join(projectRoot, constants_1.PI_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);
@@ -160,6 +163,20 @@ async function cleanupSkillsDirectories(projectRoot, dryRun, verbose) {
     catch {
         // Directory doesn't exist, nothing to clean
     }
+    // Clean up .pi/skills
+    try {
+        await fs.access(piSkillsPath);
+        if (dryRun) {
+            (0, constants_1.logVerboseInfo)(`DRY RUN: Would remove ${constants_1.PI_SKILLS_PATH}`, verbose, dryRun);
+        }
+        else {
+            await fs.rm(piSkillsPath, { recursive: true, force: true });
+            (0, constants_1.logVerboseInfo)(`Removed ${constants_1.PI_SKILLS_PATH} (skills disabled)`, verbose, dryRun);
+        }
+    }
+    catch {
+        // Directory doesn't exist, nothing to clean
+    }
     // Clean up .agents/skills
     try {
         await fs.access(gooseSkillsPath);
@@ -252,6 +269,8 @@ async function propagateSkills(projectRoot, agents, skillsEnabled, verbose, dryR
         await propagateSkillsForCodex(projectRoot, { dryRun });
         (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.OPENCODE_SKILLS_PATH} for OpenCode`, verbose, dryRun);
         await propagateSkillsForOpenCode(projectRoot, { dryRun });
+        (0, constants_1.logVerboseInfo)(`Copying skills to ${constants_1.PI_SKILLS_PATH} for Pi Coding Agent`, verbose, dryRun);
+        await propagateSkillsForPi(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);
@@ -413,6 +432,56 @@ async function propagateSkillsForOpenCode(projectRoot, options) {
     }
     return [];
 }
+/**
+ * Propagates skills for Pi Coding Agent by copying .ruler/skills to .pi/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 propagateSkillsForPi(projectRoot, options) {
+    const skillsDir = path.join(projectRoot, constants_1.RULER_SKILLS_PATH);
+    const piSkillsPath = path.join(projectRoot, constants_1.PI_SKILLS_PATH);
+    const piDir = path.dirname(piSkillsPath);
+    // 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.PI_SKILLS_PATH}`];
+    }
+    // Ensure .pi directory exists
+    await fs.mkdir(piDir, { recursive: true });
+    // Use atomic replace: copy to temp, then rename
+    const tempDir = path.join(piDir, `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(piSkillsPath, { recursive: true, force: true });
+        }
+        catch {
+            // Target didn't exist, that's fine
+        }
+        // Rename temp to target
+        await fs.rename(tempDir, piSkillsPath);
+    }
+    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 Goose by copying .ruler/skills to .agents/skills.
  * 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.20",
+  "version": "0.3.22",
   "description": "Ruler — apply the same rules to all coding agents",
   "main": "dist/lib.js",
   "scripts": {