@intellectronica/ruler 0.3.41 → 0.3.43

package/dist/agents/CrushAgent.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CrushAgent = void 0;
 const fs = __importStar(require("fs/promises"));
 const path = __importStar(require("path"));
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
 class CrushAgent {
     getIdentifier() {
         return 'crush';
@@ -80,13 +81,20 @@ class CrushAgent {
         }
         return transformedServers;
     }
-    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig) {
+    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig, backup = true) {
         const outputPaths = this.getDefaultOutputPath(projectRoot);
-        const instructionsPath = agentConfig?.outputPathInstructions ?? outputPaths['instructions'];
-        const mcpPath = agentConfig?.outputPathConfig ?? outputPaths['mcp'];
-        await fs.writeFile(instructionsPath, concatenatedRules);
+        const instructionsPath = path.resolve(projectRoot, agentConfig?.outputPath ??
+            agentConfig?.outputPathInstructions ??
+            outputPaths['instructions']);
+        const mcpPath = path.resolve(projectRoot, agentConfig?.outputPathConfig ?? outputPaths['mcp']);
+        await fs.mkdir(path.dirname(instructionsPath), { recursive: true });
+        if (backup) {
+            await (0, FileSystemUtils_1.backupFile)(instructionsPath, projectRoot);
+        }
+        await (0, FileSystemUtils_1.writeGeneratedFile)(instructionsPath, concatenatedRules, projectRoot);
         // Always transform from mcpServers ({ mcpServers: ... }) to { mcp: ... } for Crush
         let finalMcpConfig = { mcp: {} };
+        const strategy = agentConfig?.mcp?.strategy ?? 'merge';
         try {
             const existingMcpConfig = JSON.parse(await fs.readFile(mcpPath, 'utf-8'));
             if (existingMcpConfig && typeof existingMcpConfig === 'object') {
@@ -94,7 +102,7 @@ class CrushAgent {
                 finalMcpConfig = {
                     ...existingMcpConfig,
                     mcp: {
-                        ...(existingMcpConfig.mcp || {}),
+                        ...(strategy === 'merge' ? existingMcpConfig.mcp || {} : {}),
                         ...transformedServers,
                     },
                 };
@@ -115,7 +123,11 @@ class CrushAgent {
             }
         }
         if (Object.keys(finalMcpConfig.mcp).length > 0) {
-            await fs.writeFile(mcpPath, JSON.stringify(finalMcpConfig, null, 2));
+            await fs.mkdir(path.dirname(mcpPath), { recursive: true });
+            if (backup) {
+                await (0, FileSystemUtils_1.backupFile)(mcpPath, projectRoot);
+            }
+            await (0, FileSystemUtils_1.writeGeneratedFile)(mcpPath, JSON.stringify(finalMcpConfig, null, 2), projectRoot);
         }
     }
     supportsMcpStdio() {

package/dist/agents/CursorAgent.d.ts

@@ -0,0 +1,17 @@
+import { IAgentConfig } from './IAgent';
+import { AgentsMdAgent } from './AgentsMdAgent';
+/**
+ * Cursor agent adapter.
+ * Leverages the standardized AGENTS.md approach supported natively by Cursor.
+ * See: https://docs.cursor.com/en/cli/using
+ */
+export declare class CursorAgent extends AgentsMdAgent {
+    getIdentifier(): string;
+    getName(): string;
+    applyRulerConfig(concatenatedRules: string, projectRoot: string, _rulerMcpJson: Record<string, unknown> | null, agentConfig?: IAgentConfig, backup?: boolean): Promise<void>;
+    getMcpServerKey(): string;
+    supportsMcpStdio(): boolean;
+    supportsMcpRemote(): boolean;
+    supportsNativeSkills(): boolean;
+    supportsNativeSubagents(): boolean;
+}

package/dist/agents/FactoryDroidAgent.d.ts

@@ -0,0 +1,13 @@
+import { AgentsMdAgent } from './AgentsMdAgent';
+/**
+ * Factory Droid agent adapter.
+ * Uses the root-level AGENTS.md for instructions.
+ */
+export declare class FactoryDroidAgent extends AgentsMdAgent {
+    getIdentifier(): string;
+    getName(): string;
+    getMcpServerKey(): string;
+    supportsMcpStdio(): boolean;
+    supportsMcpRemote(): boolean;
+    supportsNativeSkills(): boolean;
+}

package/dist/agents/FirebaseAgent.d.ts

@@ -0,0 +1,11 @@
+import { AbstractAgent } from './AbstractAgent';
+/**
+ * Firebase Studio agent adapter.
+ */
+export declare class FirebaseAgent extends AbstractAgent {
+    getIdentifier(): string;
+    getName(): string;
+    getDefaultOutputPath(projectRoot: string): string;
+    supportsMcpStdio(): boolean;
+    supportsMcpRemote(): boolean;
+}

package/dist/agents/FirebenderAgent.d.ts

@@ -0,0 +1,36 @@
+import { IAgent, IAgentConfig } from './IAgent';
+/**
+ * Firebender agent adapter.
+ */
+export declare class FirebenderAgent implements IAgent {
+    /**
+     * Type guard function to safely check if an object is a FirebenderRule.
+     */
+    private isFirebenderRule;
+    getIdentifier(): string;
+    getName(): string;
+    applyRulerConfig(concatenatedRules: string, projectRoot: string, rulerMcpJson: Record<string, unknown> | null, agentConfig?: IAgentConfig, backup?: boolean): Promise<void>;
+    private resolveOutputPath;
+    private loadExistingConfig;
+    private createRulesFromConcatenatedRules;
+    private createRuleObjectsFromFilePaths;
+    private createRulesFromPlainText;
+    private removeDuplicateRules;
+    private saveConfig;
+    /**
+     * Handle MCP server configuration for Firebender.
+     * Merges or overwrites MCP servers in the firebender.json configuration based on strategy.
+     */
+    private handleMcpConfiguration;
+    getDefaultOutputPath(projectRoot: string): Record<string, string>;
+    getMcpServerKey(): string;
+    supportsMcpStdio(): boolean;
+    supportsMcpRemote(): boolean;
+    /**
+     * Extracts file paths from concatenated rules by parsing HTML source comments.
+     * @param concatenatedRules The concatenated rules string with HTML comments
+     * @param projectRoot The project root directory
+     * @returns Array of file paths relative to project root
+     */
+    private extractFilePathsFromRules;
+}

package/dist/agents/FirebenderAgent.js

@@ -60,6 +60,7 @@ class FirebenderAgent {
     }
     async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig, backup = true) {
         const rulesPath = this.resolveOutputPath(projectRoot, agentConfig);
+        await (0, FileSystemUtils_1.assertManagedPathInsideRoot)(rulesPath, projectRoot, 'Refusing to write generated file outside project');
         await (0, FileSystemUtils_1.ensureDirExists)(path.dirname(rulesPath));
         const firebenderConfig = await this.loadExistingConfig(rulesPath);
         const newRules = this.createRulesFromConcatenatedRules(concatenatedRules, projectRoot);
@@ -69,7 +70,7 @@ class FirebenderAgent {
         if (mcpEnabled && rulerMcpJson) {
             await this.handleMcpConfiguration(firebenderConfig, rulerMcpJson, agentConfig);
         }
-        await this.saveConfig(rulesPath, firebenderConfig, backup);
+        await this.saveConfig(rulesPath, firebenderConfig, backup, projectRoot);
     }
     resolveOutputPath(projectRoot, agentConfig) {
         const outputPaths = this.getDefaultOutputPath(projectRoot);
@@ -135,12 +136,12 @@ class FirebenderAgent {
             return true;
         });
     }
-    async saveConfig(rulesPath, config, backup) {
+    async saveConfig(rulesPath, config, backup, projectRoot) {
         const updatedContent = JSON.stringify(config, null, 2);
         if (backup) {
-            await (0, FileSystemUtils_1.backupFile)(rulesPath);
+            await (0, FileSystemUtils_1.backupFile)(rulesPath, projectRoot);
         }
-        await (0, FileSystemUtils_1.writeGeneratedFile)(rulesPath, updatedContent);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(rulesPath, updatedContent, projectRoot);
     }
     /**
      * Handle MCP server configuration for Firebender.

package/dist/agents/GeminiCliAgent.d.ts

@@ -0,0 +1,12 @@
+import { IAgentConfig } from './IAgent';
+import { AgentsMdAgent } from './AgentsMdAgent';
+export declare class GeminiCliAgent extends AgentsMdAgent {
+    getIdentifier(): string;
+    getName(): string;
+    private getContextFileName;
+    applyRulerConfig(concatenatedRules: string, projectRoot: string, rulerMcpJson: Record<string, unknown> | null, agentConfig?: IAgentConfig, backup?: boolean): Promise<void>;
+    getMcpServerKey(): string;
+    supportsMcpStdio(): boolean;
+    supportsMcpRemote(): boolean;
+    supportsNativeSkills(): boolean;
+}

package/dist/agents/GeminiCliAgent.js

@@ -37,6 +37,7 @@ exports.GeminiCliAgent = void 0;
 const path = __importStar(require("path"));
 const fs_1 = require("fs");
 const AgentsMdAgent_1 = require("./AgentsMdAgent");
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
 class GeminiCliAgent extends AgentsMdAgent_1.AgentsMdAgent {
     getIdentifier() {
         return 'gemini-cli';
@@ -44,13 +45,19 @@ class GeminiCliAgent extends AgentsMdAgent_1.AgentsMdAgent {
     getName() {
         return 'Gemini CLI';
     }
-    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig) {
+    getContextFileName(projectRoot, agentConfig) {
+        const outputPath = agentConfig?.outputPath ?? 'AGENTS.md';
+        return path
+            .relative(projectRoot, path.resolve(projectRoot, outputPath))
+            .replace(/\\/g, '/');
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig, backup = true) {
         // First, perform idempotent write of AGENTS.md via base class
         await super.applyRulerConfig(concatenatedRules, projectRoot, null, {
             outputPath: agentConfig?.outputPath,
-        });
-        // Prepare .gemini/settings.json with contextFileName and MCP configuration
-        const settingsPath = path.join(projectRoot, '.gemini', 'settings.json');
+        }, backup);
+        // Prepare settings with contextFileName and MCP configuration
+        const settingsPath = path.resolve(projectRoot, agentConfig?.outputPathConfig ?? path.join('.gemini', 'settings.json'));
         let existingSettings = {};
         try {
             const raw = await fs_1.promises.readFile(settingsPath, 'utf8');
@@ -63,7 +70,7 @@ class GeminiCliAgent extends AgentsMdAgent_1.AgentsMdAgent {
         }
         const updated = {
             ...existingSettings,
-            contextFileName: 'AGENTS.md',
+            contextFileName: this.getContextFileName(projectRoot, agentConfig),
         };
         // Handle MCP server configuration if provided
         const mcpEnabled = agentConfig?.mcp?.enabled ?? true;
@@ -100,8 +107,7 @@ class GeminiCliAgent extends AgentsMdAgent_1.AgentsMdAgent {
                 updated[this.getMcpServerKey()] = stripTypeField(mergedServers);
             }
         }
-        await fs_1.promises.mkdir(path.dirname(settingsPath), { recursive: true });
-        await fs_1.promises.writeFile(settingsPath, JSON.stringify(updated, null, 2));
+        await (0, FileSystemUtils_1.writeGeneratedFile)(settingsPath, JSON.stringify(updated, null, 2), projectRoot);
     }
     // Ensure MCP merging uses the correct key for Gemini (.gemini/settings.json)
     getMcpServerKey() {

package/dist/agents/GooseAgent.d.ts

@@ -0,0 +1,12 @@
+import { AbstractAgent } from './AbstractAgent';
+/**
+ * Goose agent adapter for Block's Goose AI assistant.
+ * Propagates rules to .goosehints file.
+ */
+export declare class GooseAgent extends AbstractAgent {
+    getIdentifier(): string;
+    getName(): string;
+    getDefaultOutputPath(projectRoot: string): string;
+    getMcpServerKey(): string;
+    supportsNativeSkills(): boolean;
+}

package/dist/agents/IAgent.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Interface defining an AI agent configuration adapter.
+ */
+import { McpConfig } from '../types';
+/**
+ * Configuration overrides for a specific agent.
+ */
+export interface IAgentConfig {
+    /** Explicit enable/disable agent */
+    enabled?: boolean;
+    /** Override for primary output path */
+    outputPath?: string;
+    /** Override for Aider instruction file path */
+    outputPathInstructions?: string;
+    /** Override for Aider config file path */
+    outputPathConfig?: string;
+    /** MCP propagation config for this agent. */
+    mcp?: McpConfig;
+    /** Agent-scoped MCP server definitions. */
+    mcpServers?: Record<string, Record<string, unknown>>;
+}
+export interface IAgent {
+    /**
+     * Returns the lowercase identifier of the agent (e.g., "copilot", "claude", "aider").
+     */
+    getIdentifier(): string;
+    /**
+     * Returns the display name of the agent.
+     */
+    getName(): string;
+    /**
+     * Applies the concatenated ruler rules to the agent's configuration.
+     * @param concatenatedRules The combined rules text
+     * @param projectRoot The root directory of the project
+     */
+    applyRulerConfig(concatenatedRules: string, projectRoot: string, rulerMcpJson: Record<string, unknown> | null, agentConfig?: IAgentConfig, backup?: boolean): Promise<void>;
+    /**
+     * Returns the default output path(s) for this agent given the project root.
+     */
+    getDefaultOutputPath(projectRoot: string): string | Record<string, string>;
+    /**
+     * Returns the specific key to be used for the server object in MCP JSON.
+     * Defaults to 'mcpServers' if not implemented.
+     */
+    getMcpServerKey?(): string;
+    /**
+     * Returns whether this agent supports MCP STDIO servers.
+     * Defaults to false if not implemented.
+     */
+    supportsMcpStdio?(): boolean;
+    /**
+     * Returns whether this agent supports MCP remote servers.
+     * Defaults to false if not implemented.
+     */
+    supportsMcpRemote?(): boolean;
+    /**
+     * Returns whether this agent supports MCP server timeout configuration.
+     * Defaults to false if not implemented.
+     */
+    supportsMcpTimeout?(): boolean;
+    /**
+     * Returns whether this agent has native skills support (like Claude Code).
+     * When true, skills are copied directly to the agent's skills directory.
+     * Defaults to false if not implemented.
+     */
+    supportsNativeSkills?(): boolean;
+    /**
+     * Returns whether this agent has native subagent support (like Claude Code,
+     * Cursor, Codex CLI, GitHub Copilot). When true, subagent definitions from
+     * `.ruler/agents/` are propagated to the agent's native subagent location.
+     * Defaults to false if not implemented.
+     */
+    supportsNativeSubagents?(): boolean;
+}

package/dist/agents/JetBrainsAiAssistantAgent.d.ts

@@ -0,0 +1,10 @@
+import { AbstractAgent } from './AbstractAgent';
+/**
+ * JetBrains AI Assistant agent adapter.
+ * Writes rules to .aiassistant/rules/AGENTS.md.
+ */
+export declare class JetBrainsAiAssistantAgent extends AbstractAgent {
+    getIdentifier(): string;
+    getName(): string;
+    getDefaultOutputPath(projectRoot: string): string;
+}

package/dist/agents/JulesAgent.d.ts

@@ -0,0 +1,5 @@
+import { AgentsMdAgent } from './AgentsMdAgent';
+export declare class JulesAgent extends AgentsMdAgent {
+    getIdentifier(): string;
+    getName(): string;
+}

package/dist/agents/JunieAgent.d.ts

@@ -0,0 +1,12 @@
+import { AbstractAgent } from './AbstractAgent';
+/**
+ * JetBrains Junie agent adapter.
+ */
+export declare class JunieAgent extends AbstractAgent {
+    getIdentifier(): string;
+    getName(): string;
+    getDefaultOutputPath(projectRoot: string): string;
+    supportsMcpStdio(): boolean;
+    supportsMcpRemote(): boolean;
+    supportsNativeSkills(): boolean;
+}

package/dist/agents/KiloCodeAgent.d.ts

@@ -0,0 +1,14 @@
+import { AgentsMdAgent } from './AgentsMdAgent';
+/**
+ * Kilo Code agent adapter.
+ * Uses AGENTS.md for instructions and .kilocode/mcp.json for MCP configuration.
+ */
+export declare class KiloCodeAgent extends AgentsMdAgent {
+    getIdentifier(): string;
+    getName(): string;
+    getDefaultOutputPath(projectRoot: string): string;
+    getMcpServerKey(): string;
+    supportsMcpStdio(): boolean;
+    supportsMcpRemote(): boolean;
+    supportsNativeSkills(): boolean;
+}

package/dist/agents/KiroAgent.d.ts

@@ -0,0 +1,8 @@
+import { AbstractAgent } from './AbstractAgent';
+export declare class KiroAgent extends AbstractAgent {
+    getIdentifier(): string;
+    getName(): string;
+    getDefaultOutputPath(projectRoot: string): string;
+    supportsMcpStdio(): boolean;
+    supportsMcpRemote(): boolean;
+}

package/dist/agents/MistralVibeAgent.d.ts

@@ -0,0 +1,31 @@
+import { IAgent, IAgentConfig } from './IAgent';
+interface RulerMcpServer {
+    command?: string;
+    args?: string[];
+    url?: string;
+    headers?: Record<string, string>;
+    env?: Record<string, string>;
+    timeout?: number;
+}
+interface RulerMcp {
+    mcpServers?: Record<string, RulerMcpServer>;
+}
+/**
+ * Mistral Vibe CLI agent adapter.
+ * Propagates rules to AGENTS.md and MCP servers to .vibe/config.toml.
+ */
+export declare class MistralVibeAgent implements IAgent {
+    private agentsMdAgent;
+    getIdentifier(): string;
+    getName(): string;
+    applyRulerConfig(concatenatedRules: string, projectRoot: string, rulerMcpJson: RulerMcp | null, agentConfig?: IAgentConfig, backup?: boolean): Promise<void>;
+    /**
+     * Determines the transport type based on server configuration.
+     */
+    private determineTransport;
+    getDefaultOutputPath(projectRoot: string): Record<string, string>;
+    supportsMcpStdio(): boolean;
+    supportsMcpRemote(): boolean;
+    supportsNativeSkills(): boolean;
+}
+export {};

package/dist/agents/MistralVibeAgent.js

@@ -109,12 +109,20 @@ class MistralVibeAgent {
             }
             // Read existing TOML config if it exists
             let existingConfig = {};
+            let configExists = false;
             try {
                 const existingContent = await fs_1.promises.readFile(configPath, 'utf8');
+                configExists = true;
                 existingConfig = (0, toml_1.parse)(existingContent);
             }
-            catch {
-                // File doesn't exist or can't be parsed, use empty config
+            catch (error) {
+                if (error.code === 'ENOENT') {
+                    // Missing config starts from an empty config.
+                    existingConfig = {};
+                }
+                else {
+                    throw new Error(`Invalid Mistral config at ${configPath}: ${error instanceof Error ? error.message : String(error)}`);
+                }
             }
             // Create the updated config
             const updatedConfig = { ...existingConfig };
@@ -134,7 +142,10 @@ class MistralVibeAgent {
             // Convert to TOML and write
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             const tomlContent = (0, toml_1.stringify)(updatedConfig);
-            await (0, FileSystemUtils_1.writeGeneratedFile)(configPath, tomlContent);
+            if (configExists && backup) {
+                await (0, FileSystemUtils_1.backupFile)(configPath, projectRoot);
+            }
+            await (0, FileSystemUtils_1.writeGeneratedFile)(configPath, tomlContent, projectRoot);
         }
     }
     /**

package/dist/agents/OpenCodeAgent.d.ts

@@ -0,0 +1,11 @@
+import { IAgent, IAgentConfig } from './IAgent';
+export declare class OpenCodeAgent implements IAgent {
+    getIdentifier(): string;
+    getName(): string;
+    getDefaultOutputPath(projectRoot: string): Record<string, string>;
+    applyRulerConfig(concatenatedRules: string, projectRoot: string, rulerMcpJson: Record<string, unknown> | null, agentConfig?: IAgentConfig, backup?: boolean): Promise<void>;
+    supportsMcpStdio(): boolean;
+    supportsMcpRemote(): boolean;
+    supportsMcpTimeout(): boolean;
+    supportsNativeSkills(): boolean;
+}

package/dist/agents/OpenCodeAgent.js

@@ -36,6 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenCodeAgent = void 0;
 const fs = __importStar(require("fs/promises"));
 const path = __importStar(require("path"));
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
 class OpenCodeAgent {
     getIdentifier() {
         return 'opencode';
@@ -49,11 +50,20 @@ class OpenCodeAgent {
             mcp: path.join(projectRoot, 'opencode.json'),
         };
     }
-    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig) {
+    async applyRulerConfig(concatenatedRules, projectRoot, rulerMcpJson, agentConfig, backup = true) {
         const outputPaths = this.getDefaultOutputPath(projectRoot);
-        const instructionsPath = path.resolve(projectRoot, agentConfig?.outputPathInstructions ?? outputPaths['instructions']);
+        const instructionsPath = path.resolve(projectRoot, agentConfig?.outputPath ??
+            agentConfig?.outputPathInstructions ??
+            outputPaths['instructions']);
         const mcpPath = path.resolve(projectRoot, agentConfig?.outputPathConfig ?? outputPaths['mcp']);
-        await fs.writeFile(instructionsPath, concatenatedRules);
+        await fs.mkdir(path.dirname(instructionsPath), { recursive: true });
+        if (backup) {
+            await (0, FileSystemUtils_1.backupFile)(instructionsPath, projectRoot);
+        }
+        await (0, FileSystemUtils_1.writeGeneratedFile)(instructionsPath, concatenatedRules, projectRoot);
+        if (!rulerMcpJson) {
+            return;
+        }
         // Create OpenCode config with schema and MCP configuration
         let finalMcpConfig = {
             $schema: 'https://opencode.ai/config.json',
@@ -71,23 +81,25 @@ class OpenCodeAgent {
                     },
                 };
             }
-            else if (rulerMcpJson) {
+            else {
                 finalMcpConfig = {
                     $schema: 'https://opencode.ai/config.json',
-                    mcp: (rulerMcpJson?.mcpServers ?? {}),
+                    mcp: (rulerMcpJson.mcpServers ?? {}),
                 };
             }
         }
         catch {
-            if (rulerMcpJson) {
-                finalMcpConfig = {
-                    $schema: 'https://opencode.ai/config.json',
-                    mcp: (rulerMcpJson?.mcpServers ?? {}),
-                };
-            }
+            finalMcpConfig = {
+                $schema: 'https://opencode.ai/config.json',
+                mcp: (rulerMcpJson.mcpServers ?? {}),
+            };
         }
         // Always write the config file, even if MCP is empty
-        await fs.writeFile(mcpPath, JSON.stringify(finalMcpConfig, null, 2));
+        await fs.mkdir(path.dirname(mcpPath), { recursive: true });
+        if (backup) {
+            await (0, FileSystemUtils_1.backupFile)(mcpPath, projectRoot);
+        }
+        await (0, FileSystemUtils_1.writeGeneratedFile)(mcpPath, JSON.stringify(finalMcpConfig, null, 2), projectRoot);
     }
     supportsMcpStdio() {
         return true;

package/dist/agents/OpenHandsAgent.d.ts

@@ -0,0 +1,8 @@
+import { AbstractAgent } from './AbstractAgent';
+export declare class OpenHandsAgent extends AbstractAgent {
+    getIdentifier(): string;
+    getName(): string;
+    getDefaultOutputPath(projectRoot: string): string;
+    supportsMcpStdio(): boolean;
+    supportsMcpRemote(): boolean;
+}

package/dist/agents/PiAgent.d.ts

@@ -0,0 +1,9 @@
+import { AgentsMdAgent } from './AgentsMdAgent';
+/**
+ * Pi Coding Agent adapter.
+ */
+export declare class PiAgent extends AgentsMdAgent {
+    getIdentifier(): string;
+    getName(): string;
+    supportsNativeSkills(): boolean;
+}

package/dist/agents/QwenCodeAgent.d.ts

@@ -0,0 +1,11 @@
+import { IAgentConfig } from './IAgent';
+import { AgentsMdAgent } from './AgentsMdAgent';
+export declare class QwenCodeAgent extends AgentsMdAgent {
+    getIdentifier(): string;
+    getName(): string;
+    private getContextFileName;
+    applyRulerConfig(concatenatedRules: string, projectRoot: string, _rulerMcpJson: Record<string, unknown> | null, agentConfig?: IAgentConfig, backup?: boolean): Promise<void>;
+    getMcpServerKey(): string;
+    supportsMcpStdio(): boolean;
+    supportsMcpRemote(): boolean;
+}

package/dist/agents/QwenCodeAgent.js

@@ -37,6 +37,7 @@ exports.QwenCodeAgent = void 0;
 const path = __importStar(require("path"));
 const fs_1 = require("fs");
 const AgentsMdAgent_1 = require("./AgentsMdAgent");
+const FileSystemUtils_1 = require("../core/FileSystemUtils");
 class QwenCodeAgent extends AgentsMdAgent_1.AgentsMdAgent {
     getIdentifier() {
         return 'qwen';
@@ -44,11 +45,17 @@ class QwenCodeAgent extends AgentsMdAgent_1.AgentsMdAgent {
     getName() {
         return 'Qwen Code';
     }
-    async applyRulerConfig(concatenatedRules, projectRoot, _rulerMcpJson, agentConfig) {
+    getContextFileName(projectRoot, agentConfig) {
+        const outputPath = agentConfig?.outputPath ?? 'AGENTS.md';
+        return path
+            .relative(projectRoot, path.resolve(projectRoot, outputPath))
+            .replace(/\\/g, '/');
+    }
+    async applyRulerConfig(concatenatedRules, projectRoot, _rulerMcpJson, agentConfig, backup = true) {
         // First, perform idempotent write of AGENTS.md via base class
         await super.applyRulerConfig(concatenatedRules, projectRoot, null, {
             outputPath: agentConfig?.outputPath,
-        });
+        }, backup);
         // Ensure .qwen/settings.json has contextFileName set to AGENTS.md
         const settingsPath = path.join(projectRoot, '.qwen', 'settings.json');
         let existingSettings = {};
@@ -63,10 +70,9 @@ class QwenCodeAgent extends AgentsMdAgent_1.AgentsMdAgent {
         }
         const updated = {
             ...existingSettings,
-            contextFileName: 'AGENTS.md',
+            contextFileName: this.getContextFileName(projectRoot, agentConfig),
         };
-        await fs_1.promises.mkdir(path.dirname(settingsPath), { recursive: true });
-        await fs_1.promises.writeFile(settingsPath, JSON.stringify(updated, null, 2));
+        await (0, FileSystemUtils_1.writeGeneratedFile)(settingsPath, JSON.stringify(updated, null, 2), projectRoot);
     }
     // Ensure MCP merging uses the correct key for Qwen Code (.qwen/settings.json)
     getMcpServerKey() {

package/dist/agents/RooCodeAgent.d.ts

@@ -0,0 +1,16 @@
+import { IAgent, IAgentConfig } from './IAgent';
+/**
+ * Agent for RooCode that writes to AGENTS.md and generates .roo/mcp.json
+ * with project-level MCP server configuration.
+ */
+export declare class RooCodeAgent implements IAgent {
+    private agentsMdAgent;
+    getIdentifier(): string;
+    getName(): string;
+    getDefaultOutputPath(projectRoot: string): Record<string, string>;
+    applyRulerConfig(concatenatedRules: string, projectRoot: string, rulerMcpJson: Record<string, unknown> | null, agentConfig?: IAgentConfig, backup?: boolean): Promise<void>;
+    supportsMcpStdio(): boolean;
+    supportsMcpRemote(): boolean;
+    getMcpServerKey(): string;
+    supportsNativeSkills(): boolean;
+}

package/dist/agents/RooCodeAgent.js

@@ -69,6 +69,7 @@ class RooCodeAgent {
         // Now handle .roo/mcp.json configuration
         const outputPaths = this.getDefaultOutputPath(projectRoot);
         const mcpPath = path.resolve(projectRoot, agentConfig?.outputPathConfig ?? outputPaths['mcp']);
+        await (0, FileSystemUtils_1.assertManagedPathInsideRoot)(mcpPath, projectRoot, 'Refusing to write generated file outside project');
         await (0, FileSystemUtils_1.ensureDirExists)(path.dirname(mcpPath));
         // Create base structure with mcpServers
         let finalMcpConfig = {
@@ -122,9 +123,9 @@ class RooCodeAgent {
         }
         // Backup (only if file existed and backup is enabled) then write new content
         if (backup) {
-            await (0, FileSystemUtils_1.backupFile)(mcpPath);
+            await (0, FileSystemUtils_1.backupFile)(mcpPath, projectRoot);
         }
-        await (0, FileSystemUtils_1.writeGeneratedFile)(mcpPath, newContent);
+        await (0, FileSystemUtils_1.writeGeneratedFile)(mcpPath, newContent, projectRoot);
     }
     supportsMcpStdio() {
         return true;

package/dist/agents/TraeAgent.d.ts

@@ -0,0 +1,10 @@
+import { AbstractAgent } from './AbstractAgent';
+/**
+ * Trae AI agent adapter.
+ * Generates project_rules.md configuration file.
+ */
+export declare class TraeAgent extends AbstractAgent {
+    getIdentifier(): string;
+    getName(): string;
+    getDefaultOutputPath(projectRoot: string): string;
+}