@intellectronica/ruler 0.3.33 → 0.3.35

package/README.md

@@ -76,7 +76,7 @@ Ruler solves this by providing a **single source of truth** for all your AI agen
 | Junie                  | `.junie/guidelines.md`                         | -                                                | -                         |
 | AugmentCode            | `.augment/rules/ruler_augment_instructions.md` | -                                                | -                         |
 | Kilo Code              | `AGENTS.md`                                    | `.kilocode/mcp.json`                             | `.claude/skills/`         |
-| OpenCode               | `AGENTS.md`                                    | `opencode.json`                                  | `.opencode/skill/`        |
+| OpenCode               | `AGENTS.md`                                    | `opencode.json`                                  | `.opencode/skills/`       |
 | Goose                  | `.goosehints`                                  | -                                                | `.agents/skills/`         |
 | Qwen Code              | `AGENTS.md`                                    | `.qwen/settings.json`                            | -                         |
 | RooCode                | `AGENTS.md`                                    | `.roo/mcp.json`                                  | `.roo/skills/`            |
@@ -238,6 +238,7 @@ The `apply` command looks for `.ruler/` in the current directory tree, reading t
 | `--mcp-overwrite`              | Overwrite native MCP config instead of merging.                        |
 | `--gitignore`                  | Enable automatic .gitignore updates (default: true).                   |
 | `--no-gitignore`               | Disable automatic .gitignore updates.                                  |
+| `--gitignore-local`            | Write managed ignore entries to `.git/info/exclude` instead.           |
 | `--nested`                     | Enable nested rule loading (default: inherit from config or disabled). |
 | `--no-nested`                  | Disable nested rule loading even if `nested = true` in config.         |
 | `--backup`                     | Toggle creation of `.bak` backup files (default: enabled).             |
@@ -405,6 +406,8 @@ Authorization = "Bearer your-token"
 [gitignore]
 # Enable/disable automatic .gitignore updates (default: true)
 enabled = true
+# Write managed entries to .git/info/exclude instead of .gitignore (default: false)
+local = false
 
 # --- Agent-Specific Configurations ---
 [agents.copilot]
@@ -578,7 +581,7 @@ Skills are specialized knowledge packages that extend AI agent capabilities with
   - **GitHub Copilot**: `.claude/skills/` (shared with Claude Code)
   - **Kilo Code**: `.claude/skills/` (shared with Claude Code)
   - **OpenAI Codex CLI**: `.codex/skills/`
-  - **OpenCode**: `.opencode/skill/`
+  - **OpenCode**: `.opencode/skills/`
   - **Pi Coding Agent**: `.pi/skills/`
   - **Goose**: `.agents/skills/`
   - **Amp**: `.agents/skills/` (shared with Goose)
@@ -644,7 +647,7 @@ When skills support is enabled and gitignore integration is active, Ruler automa
 
 - `.claude/skills/` (for Claude Code, GitHub Copilot, and Kilo Code)
 - `.codex/skills/` (for OpenAI Codex CLI)
-- `.opencode/skill/` (for OpenCode)
+- `.opencode/skills/` (for OpenCode)
 - `.pi/skills/` (for Pi Coding Agent)
 - `.agents/skills/` (for Goose and Amp)
 - `.agent/skills/` (for Antigravity)
@@ -703,7 +706,7 @@ ruler apply
 # 3. Skills are now available to compatible agents:
 #    - Claude Code, GitHub Copilot & Kilo Code: .claude/skills/my-skill/
 #    - OpenAI Codex CLI: .codex/skills/my-skill/
-#    - OpenCode: .opencode/skill/my-skill/
+#    - OpenCode: .opencode/skills/my-skill/
 #    - Pi Coding Agent: .pi/skills/my-skill/
 #    - Goose & Amp: .agents/skills/my-skill/
 #    - Antigravity: .agent/skills/my-skill/
@@ -744,8 +747,8 @@ dist/
 
 ### Control Options
 
-- **CLI flags**: `--gitignore` or `--no-gitignore`
-- **Configuration**: `[gitignore].enabled` in `ruler.toml`
+- **CLI flags**: `--gitignore`, `--no-gitignore`, `--gitignore-local`, `--no-gitignore-local`
+- **Configuration**: `[gitignore].enabled` and `[gitignore].local` in `ruler.toml`
 - **Default**: enabled
 
 ## Practical Usage Scenarios

package/dist/cli/commands.js

@@ -44,6 +44,10 @@ function run() {
             .option('gitignore', {
             type: 'boolean',
             description: 'Enable/disable automatic .gitignore updates (default: enabled)',
+        })
+            .option('gitignore-local', {
+            type: 'boolean',
+            description: 'Write generated ignore entries to .git/info/exclude instead of .gitignore',
         })
             .option('verbose', {
             type: 'boolean',

package/dist/cli/handlers.js

@@ -78,6 +78,13 @@ async function applyHandler(argv) {
     else {
         gitignorePreference = undefined; // Let TOML/default decide
     }
+    let gitignoreLocalPreference;
+    if (argv['gitignore-local'] !== undefined) {
+        gitignoreLocalPreference = argv['gitignore-local'];
+    }
+    else {
+        gitignoreLocalPreference = undefined; // Let TOML/default decide
+    }
     // Determine nested preference: CLI > TOML > Default (false)
     let nested;
     if (argv.nested !== undefined) {
@@ -108,7 +115,7 @@ async function applyHandler(argv) {
         skillsEnabled = undefined; // Let config/default decide
     }
     try {
-        await (0, lib_1.applyAllAgentConfigs)(projectRoot, agents, configPath, mcpEnabled, mcpStrategy, gitignorePreference, verbose, dryRun, localOnly, nested, backup, skillsEnabled);
+        await (0, lib_1.applyAllAgentConfigs)(projectRoot, agents, configPath, mcpEnabled, mcpStrategy, gitignorePreference, verbose, dryRun, localOnly, nested, backup, skillsEnabled, gitignoreLocalPreference);
         console.log('Ruler apply completed successfully.');
     }
     catch (err) {
@@ -150,6 +157,10 @@ async function initHandler(argv) {
 # When enabled, ruler will search for and process .ruler directories throughout the project hierarchy
 # nested = false
 
+# [gitignore]
+# enabled = true
+# local = false  # set true to write generated ignores to .git/info/exclude instead
+
 # --- Agent Specific Configurations ---
 # You can enable/disable agents and override their default output paths here.
 # Use lowercase agent identifiers: aider, amp, claude, cline, codex, copilot, cursor, jetbrains-ai, kilocode, pi, windsurf

package/dist/constants.js

@@ -54,7 +54,7 @@ exports.SKILLS_DIR = 'skills';
 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.OPENCODE_SKILLS_PATH = '.opencode/skills';
 exports.PI_SKILLS_PATH = '.pi/skills';
 exports.GOOSE_SKILLS_PATH = '.agents/skills';
 exports.VIBE_SKILLS_PATH = '.vibe/skills';

package/dist/core/ConfigLoader.js

@@ -67,6 +67,7 @@ const rulerConfigSchema = zod_1.z.object({
     gitignore: zod_1.z
         .object({
         enabled: zod_1.z.boolean().optional(),
+        local: zod_1.z.boolean().optional(),
     })
         .optional(),
     skills: zod_1.z
@@ -203,6 +204,9 @@ async function loadConfig(options) {
     if (typeof rawGitignoreSection.enabled === 'boolean') {
         gitignoreConfig.enabled = rawGitignoreSection.enabled;
     }
+    if (typeof rawGitignoreSection.local === 'boolean') {
+        gitignoreConfig.local = rawGitignoreSection.local;
+    }
     const rawSkillsSection = raw.skills && typeof raw.skills === 'object' && !Array.isArray(raw.skills)
         ? raw.skills
         : {};

package/dist/core/GitignoreUtils.js

@@ -39,14 +39,15 @@ const path = __importStar(require("path"));
 const RULER_START_MARKER = '# START Ruler Generated Files';
 const RULER_END_MARKER = '# END Ruler Generated Files';
 /**
- * Updates the .gitignore file in the project root with paths in a managed Ruler block.
+ * Updates an ignore file in the project root with paths in a managed Ruler block.
  * Creates the file if it doesn't exist, and creates or updates the Ruler-managed block.
  *
- * @param projectRoot The project root directory (where .gitignore should be located)
- * @param paths Array of file paths to add to .gitignore (can be absolute or relative)
+ * @param projectRoot The project root directory
+ * @param paths Array of file paths to add to the ignore file (can be absolute or relative)
+ * @param ignoreFile Relative path to the ignore file from project root (defaults to .gitignore)
  */
-async function updateGitignore(projectRoot, paths) {
-    const gitignorePath = path.join(projectRoot, '.gitignore');
+async function updateGitignore(projectRoot, paths, ignoreFile = '.gitignore') {
+    const gitignorePath = path.join(projectRoot, ignoreFile);
     // Read existing .gitignore or start with empty content
     let existingContent = '';
     try {
@@ -97,6 +98,7 @@ async function updateGitignore(projectRoot, paths) {
     // Create new content
     const newContent = updateGitignoreContent(existingContent, allRulerPaths);
     // Write the updated content
+    await fs_1.promises.mkdir(path.dirname(gitignorePath), { recursive: true });
     await fs_1.promises.writeFile(gitignorePath, newContent);
 }
 /**

package/dist/core/SkillsProcessor.js

@@ -186,7 +186,7 @@ async function cleanupSkillsDirectories(projectRoot, dryRun, verbose) {
     catch {
         // Directory doesn't exist, nothing to clean
     }
-    // Clean up .opencode/skill
+    // Clean up .opencode/skills
     try {
         await fs.access(opencodeSkillsPath);
         if (dryRun) {
@@ -510,7 +510,7 @@ async function propagateSkillsForCodex(projectRoot, options) {
     return [];
 }
 /**
- * Propagates skills for OpenCode by copying .ruler/skills to .opencode/skill.
+ * Propagates skills for OpenCode by copying .ruler/skills to .opencode/skills.
  * Uses atomic replace to ensure safe overwriting of existing skills.
  * Returns dry-run steps if dryRun is true, otherwise returns empty array.
  */

package/dist/core/apply-engine.js

@@ -644,8 +644,9 @@ async function applyStandardMcpConfiguration(agent, filteredMcpJson, dest, agent
  * @param config Loaded configuration
  * @param cliGitignoreEnabled CLI gitignore setting
  * @param dryRun Whether to perform a dry run
+ * @param cliGitignoreLocal CLI toggle for .git/info/exclude usage
  */
-async function updateGitignore(projectRoot, generatedPaths, config, cliGitignoreEnabled, dryRun) {
+async function updateGitignore(projectRoot, generatedPaths, config, cliGitignoreEnabled, dryRun, cliGitignoreLocal) {
     // Configuration precedence: CLI > TOML > Default (enabled)
     let gitignoreEnabled;
     if (cliGitignoreEnabled !== undefined) {
@@ -657,17 +658,24 @@ async function updateGitignore(projectRoot, generatedPaths, config, cliGitignore
     else {
         gitignoreEnabled = true; // Default enabled
     }
+    const gitignoreTarget = cliGitignoreLocal !== undefined
+        ? cliGitignoreLocal
+            ? '.git/info/exclude'
+            : '.gitignore'
+        : config.gitignore?.local
+            ? '.git/info/exclude'
+            : '.gitignore';
     if (gitignoreEnabled && generatedPaths.length > 0) {
         const uniquePaths = [...new Set(generatedPaths)];
         // Note: Individual backup patterns are added per-file in the collection phase
         // No need to add a broad *.bak pattern here
         if (uniquePaths.length > 0) {
             if (dryRun) {
-                (0, constants_1.logInfo)(`Would update .gitignore with ${uniquePaths.length} unique path(s): ${uniquePaths.join(', ')}`, dryRun);
+                (0, constants_1.logInfo)(`Would update ${gitignoreTarget} with ${uniquePaths.length} unique path(s): ${uniquePaths.join(', ')}`, dryRun);
             }
             else {
-                await (0, GitignoreUtils_1.updateGitignore)(projectRoot, uniquePaths);
-                (0, constants_1.logInfo)(`Updated .gitignore with ${uniquePaths.length} unique path(s) in the Ruler block.`, dryRun);
+                await (0, GitignoreUtils_1.updateGitignore)(projectRoot, uniquePaths, gitignoreTarget);
+                (0, constants_1.logInfo)(`Updated ${gitignoreTarget} with ${uniquePaths.length} unique path(s) in the Ruler block.`, dryRun);
             }
         }
     }

package/dist/lib.js

@@ -62,7 +62,7 @@ function resolveSkillsEnabled(cliFlag, configSetting) {
  * @param projectRoot Root directory of the project
  * @param includedAgents Optional list of agent name filters (case-insensitive substrings)
  */
-async function applyAllAgentConfigs(projectRoot, includedAgents, configPath, cliMcpEnabled = true, cliMcpStrategy, cliGitignoreEnabled, verbose = false, dryRun = false, localOnly = false, nested = false, backup = true, skillsEnabled) {
+async function applyAllAgentConfigs(projectRoot, includedAgents, configPath, cliMcpEnabled = true, cliMcpStrategy, cliGitignoreEnabled, verbose = false, dryRun = false, localOnly = false, nested = false, backup = true, skillsEnabled, cliGitignoreLocal) {
     // Load configuration and rules
     (0, constants_1.logVerbose)(`Loading configuration from project root: ${projectRoot}`, verbose);
     if (configPath) {
@@ -128,7 +128,7 @@ async function applyAllAgentConfigs(projectRoot, includedAgents, configPath, cli
         const skillsPaths = await getSkillsGitignorePaths(projectRoot, selectedAgents);
         allGeneratedPaths = [...generatedPaths, ...skillsPaths];
     }
-    await (0, apply_engine_1.updateGitignore)(projectRoot, allGeneratedPaths, loadedConfig, cliGitignoreEnabled, dryRun);
+    await (0, apply_engine_1.updateGitignore)(projectRoot, allGeneratedPaths, loadedConfig, cliGitignoreEnabled, dryRun, cliGitignoreLocal);
 }
 /**
  * Normalizes per-agent config keys to agent identifiers for consistent lookup.

package/package.json

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