@intellectronica/ruler 0.3.34 → 0.3.35

package/README.md

@@ -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]
@@ -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/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/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.34",
+  "version": "0.3.35",
   "description": "Ruler — apply the same rules to all coding agents",
   "main": "dist/lib.js",
   "scripts": {