rumdl 0.0.134__tar.gz → 0.0.136__tar.gz

{rumdl-0.0.134 → rumdl-0.0.136}/CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.0.136] - 2025-09-03
+
+## [0.0.135] - 2025-09-03
+
 ## [0.0.134] - 2025-09-02
 
 ### Added
@@ -558,7 +562,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial implementation of remaining rules for markdownlint parity
 
-[Unreleased]: https://github.com/rvben/rumdl/compare/v0.0.134...HEAD
+[Unreleased]: https://github.com/rvben/rumdl/compare/v0.0.136...HEAD
+[0.0.136]: https://github.com/rvben/rumdl/compare/v0.0.135...v0.0.136
+[0.0.135]: https://github.com/rvben/rumdl/compare/v0.0.134...v0.0.135
 [0.0.134]: https://github.com/rvben/rumdl/compare/v0.0.133...v0.0.134
 [0.0.133]: https://github.com/rvben/rumdl/compare/v0.0.132...v0.0.133
 [0.0.132]: https://github.com/rvben/rumdl/compare/v0.0.131...v0.0.132

{rumdl-0.0.134 → rumdl-0.0.136}/Cargo.lock

@@ -278,9 +278,9 @@ dependencies = [
 
 [[package]]
 name = "clap"
-version = "4.5.46"
+version = "4.5.47"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "2c5e4fcf9c21d2e544ca1ee9d8552de13019a42aa7dbf32747fa7aaf1df76e57"
+checksum = "7eac00902d9d136acd712710d71823fb8ac8004ca445a89e73a41d45aa712931"
 dependencies = [
  "clap_builder",
  "clap_derive",
@@ -288,9 +288,9 @@ dependencies = [
 
 [[package]]
 name = "clap_builder"
-version = "4.5.46"
+version = "4.5.47"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "fecb53a0e6fcfb055f686001bc2e2592fa527efaf38dbe81a6a9563562e57d41"
+checksum = "2ad9bbf750e73b5884fb8a211a9424a1906c1e156724260fdae972f31d70e1d6"
 dependencies = [
  "anstream",
  "anstyle",
@@ -300,9 +300,9 @@ dependencies = [
 
 [[package]]
 name = "clap_derive"
-version = "4.5.45"
+version = "4.5.47"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "14cb31bb0a7d536caef2639baa7fad459e15c3144efefa6dbd1c84562c4739f6"
+checksum = "bbfd7eae0b0f1a6e63d4b13c9c478de77c2eb546fba158ad50b4203dc24b9f9c"
 dependencies = [
  "heck",
  "proc-macro2",
@@ -1632,7 +1632,7 @@ checksum = "caf4aa5b0f434c91fe5c7f1ecb6a5ece2130b02ad2a590589dda5146df959001"
 
 [[package]]
 name = "rumdl"
-version = "0.0.134"
+version = "0.0.136"
 dependencies = [
  "anyhow",
  "assert_cmd",

{rumdl-0.0.134 → rumdl-0.0.136}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "rumdl"
-version = "0.0.134"
+version = "0.0.136"
 edition = "2024"
 rust-version = "1.89.0"
 description = "A fast Markdown linter written in Rust (Ru(st) MarkDown Linter)"

{rumdl-0.0.134 → rumdl-0.0.136}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rumdl
-Version: 0.0.134
+Version: 0.0.136
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -34,11 +34,8 @@ Project-URL: Repository, https://github.com/rvben/rumdl.git
 ![rumdl Logo](https://raw.githubusercontent.com/rvben/rumdl/main/assets/logo.png)
 
 [![Build Status](https://img.shields.io/github/actions/workflow/status/rvben/rumdl/build.yml?branch=main)](https://github.com/rvben/rumdl/actions)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Crates.io](https://img.shields.io/crates/v/rumdl)](https://crates.io/crates/rumdl)
-[![PyPI](https://img.shields.io/pypi/v/rumdl)](https://pypi.org/project/rumdl/)
-[![GitHub release (latest by date)](https://img.shields.io/github/v/release/rvben/rumdl)](https://github.com/rvben/rumdl/releases/latest)
-[![GitHub stars](https://img.shields.io/github/stars/rvben/rumdl)](https://github.com/rvben/rumdl/stargazers)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Crates.io](https://img.shields.io/crates/v/rumdl)](https://crates.io/crates/rumdl)
+[![PyPI](https://img.shields.io/pypi/v/rumdl)](https://pypi.org/project/rumdl/) [![GitHub release (latest by date)](https://img.shields.io/github/v/release/rvben/rumdl)](https://github.com/rvben/rumdl/releases/latest) [![GitHub stars](https://img.shields.io/github/stars/rvben/rumdl)](https://github.com/rvben/rumdl/stargazers)
 
 ## A modern Markdown linter and formatter, built for speed with Rust
 
@@ -65,9 +62,8 @@ rumdl init
 
 ## Overview
 
-rumdl is a high-performance Markdown linter and formatter that helps ensure consistency and best practices
-in your Markdown files. Inspired by [ruff](https://github.com/astral-sh/ruff)'s approach to Python linting,
-rumdl brings similar speed and developer experience improvements to the Markdown ecosystem.
+rumdl is a high-performance Markdown linter and formatter that helps ensure consistency and best practices in your Markdown files. Inspired by [ruff](https://github.com/astral-sh/ruff) 's approach to
+Python linting, rumdl brings similar speed and developer experience improvements to the Markdown ecosystem.
 
 It offers:
 
@@ -206,7 +202,8 @@ The extension provides:
 - 📋 Hover tooltips with rule documentation
 - ⚡ Lightning-fast performance with zero lag
 
-The CLI will automatically detect VS Code, Cursor, or Windsurf and install the appropriate extension. See the [VS Code extension documentation](https://github.com/rvben/rumdl/blob/main/docs/vscode-extension.md) for more details.
+The CLI will automatically detect VS Code, Cursor, or Windsurf and install the appropriate extension. See the
+[VS Code extension documentation](https://github.com/rvben/rumdl/blob/main/docs/vscode-extension.md) for more details.
 
 ## Usage
 
@@ -252,6 +249,9 @@ rumdl check --include "docs/**/*.md" --exclude "docs/temp,docs/drafts" .
 
 # Don't respect gitignore files (note: --respect-gitignore defaults to true)
 rumdl check --respect-gitignore=false .
+
+# Force exclude patterns even for explicitly specified files (useful for pre-commit)
+rumdl check excluded.md --force-exclude  # Will respect exclude patterns in config
 ```
 
 ### Stdin/Stdout Formatting
@@ -313,6 +313,33 @@ repos:
 
 When you run `pre-commit install` or `pre-commit run`, pre-commit will automatically install `rumdl` in an isolated Python environment using pip. You do **not** need to install rumdl manually.
 
+### Excluding Files in Pre-commit
+
+By default, when pre-commit passes files explicitly to rumdl, the exclude patterns in your `.rumdl.toml` configuration file are ignored. This is intentional behavior - if you explicitly specify a
+file, it gets checked.
+
+However, for pre-commit workflows where you want to exclude certain files even when they're passed explicitly, you have two options:
+
+1. **Use `force_exclude` in your configuration file:**
+
+   ```toml
+   # .rumdl.toml
+   [global]
+   exclude = ["generated/*.md", "vendor/**"]
+   force_exclude = true  # Enforce excludes even for explicitly provided files
+   ```
+
+2. **Use the `--force-exclude` flag in your pre-commit config:**
+
+   ```yaml
+   repos:
+     - repo: https://github.com/rvben/rumdl-pre-commit
+       rev: v0.0.99
+       hooks:
+         - id: rumdl
+           args: [--force-exclude]  # Respect exclude patterns from config
+   ```
+
 ## CI/CD Integration
 
 ### GitHub Actions
@@ -373,6 +400,7 @@ Lint Markdown files and print warnings/errors (main subcommand)
 - `--exclude <patterns>`: Exclude specific files or directories (comma-separated glob patterns)
 - `--include <patterns>`: Include only specific files or directories (comma-separated glob patterns)
 - `--respect-gitignore`: Respect .gitignore files when scanning directories (does not apply to explicitly provided paths)
+- `--force-exclude`: Enforce exclude patterns even for explicitly specified files (useful for pre-commit hooks)
 - `-v, --verbose`: Show detailed output
 - `--profile`: Show profiling information
 - `--statistics`: Show rule violation statistics summary
@@ -569,9 +597,8 @@ rumdl can be configured in several ways:
 
 ### Configuration Discovery
 
-rumdl automatically searches for configuration files by traversing up the directory tree from the current
-working directory, similar to tools like `git`, `ruff`, and `eslint`. This means you can run rumdl from any
-subdirectory of your project and it will find the configuration file at the project root.
+rumdl automatically searches for configuration files by traversing up the directory tree from the current working directory, similar to tools like `git` , `ruff` , and `eslint` . This means you can
+run rumdl from any subdirectory of your project and it will find the configuration file at the project root.
 
 The search follows these rules:
 - Searches upward for `.rumdl.toml`, `rumdl.toml`, or `pyproject.toml` (with `[tool.rumdl]` section)
@@ -624,13 +651,13 @@ indent = 2
 
 rumdl provides seamless compatibility with existing markdownlint configurations:
 
-**Automatic Discovery**: rumdl automatically detects and loads markdownlint config files:
+** Automatic Discovery**: rumdl automatically detects and loads markdownlint config files:
 
 - `.markdownlint.json` / `.markdownlint.jsonc`
 - `.markdownlint.yaml` / `.markdownlint.yml`
 - `markdownlint.json` / `markdownlint.yaml`
 
-**Explicit Import**: Convert markdownlint configs to rumdl format:
+** Explicit Import**: Convert markdownlint configs to rumdl format:
 
 ```bash
 # Convert to .rumdl.toml
@@ -718,8 +745,8 @@ Both kebab-case (`line-length`, `ignore-gitignore`) and snake_case (`line_length
 
 #### Effective Configuration (`rumdl config`)
 
-The `rumdl config` command prints the **full effective configuration** (defaults + all overrides), showing every key and its value, annotated with the source of each value.
-The output is colorized and the `[from ...]` annotation is globally aligned for easy scanning.
+The `rumdl config` command prints the **full effective configuration** (defaults + all overrides), showing every key and its value, annotated with the source of each value. The output is colorized and
+the `[from ...]` annotation is globally aligned for easy scanning.
 
 #### Example output
 
@@ -736,7 +763,7 @@ The output is colorized and the `[from ...]` annotation is globally aligned for
   ...
 ```
 
-- **Keys** are cyan, **values** are yellow, and the `[from ...]` annotation is colored by source:
+- ** Keys** are cyan, **values** are yellow, and the `[from ...]` annotation is colored by source:
   - Green: CLI
   - Blue: `.rumdl.toml`
   - Magenta: `pyproject.toml`
@@ -754,6 +781,7 @@ disable = []
 exclude = []
 include = []
 respect_gitignore = true
+force_exclude = false  # Set to true to exclude files even when explicitly specified
 
 [MD013]
 line_length = 80

{rumdl-0.0.134 → rumdl-0.0.136}/README.md

@@ -5,11 +5,8 @@
 ![rumdl Logo](https://raw.githubusercontent.com/rvben/rumdl/main/assets/logo.png)
 
 [![Build Status](https://img.shields.io/github/actions/workflow/status/rvben/rumdl/build.yml?branch=main)](https://github.com/rvben/rumdl/actions)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Crates.io](https://img.shields.io/crates/v/rumdl)](https://crates.io/crates/rumdl)
-[![PyPI](https://img.shields.io/pypi/v/rumdl)](https://pypi.org/project/rumdl/)
-[![GitHub release (latest by date)](https://img.shields.io/github/v/release/rvben/rumdl)](https://github.com/rvben/rumdl/releases/latest)
-[![GitHub stars](https://img.shields.io/github/stars/rvben/rumdl)](https://github.com/rvben/rumdl/stargazers)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Crates.io](https://img.shields.io/crates/v/rumdl)](https://crates.io/crates/rumdl)
+[![PyPI](https://img.shields.io/pypi/v/rumdl)](https://pypi.org/project/rumdl/) [![GitHub release (latest by date)](https://img.shields.io/github/v/release/rvben/rumdl)](https://github.com/rvben/rumdl/releases/latest) [![GitHub stars](https://img.shields.io/github/stars/rvben/rumdl)](https://github.com/rvben/rumdl/stargazers)
 
 ## A modern Markdown linter and formatter, built for speed with Rust
 
@@ -36,9 +33,8 @@ rumdl init
 
 ## Overview
 
-rumdl is a high-performance Markdown linter and formatter that helps ensure consistency and best practices
-in your Markdown files. Inspired by [ruff](https://github.com/astral-sh/ruff)'s approach to Python linting,
-rumdl brings similar speed and developer experience improvements to the Markdown ecosystem.
+rumdl is a high-performance Markdown linter and formatter that helps ensure consistency and best practices in your Markdown files. Inspired by [ruff](https://github.com/astral-sh/ruff) 's approach to
+Python linting, rumdl brings similar speed and developer experience improvements to the Markdown ecosystem.
 
 It offers:
 
@@ -177,7 +173,8 @@ The extension provides:
 - 📋 Hover tooltips with rule documentation
 - ⚡ Lightning-fast performance with zero lag
 
-The CLI will automatically detect VS Code, Cursor, or Windsurf and install the appropriate extension. See the [VS Code extension documentation](https://github.com/rvben/rumdl/blob/main/docs/vscode-extension.md) for more details.
+The CLI will automatically detect VS Code, Cursor, or Windsurf and install the appropriate extension. See the
+[VS Code extension documentation](https://github.com/rvben/rumdl/blob/main/docs/vscode-extension.md) for more details.
 
 ## Usage
 
@@ -223,6 +220,9 @@ rumdl check --include "docs/**/*.md" --exclude "docs/temp,docs/drafts" .
 
 # Don't respect gitignore files (note: --respect-gitignore defaults to true)
 rumdl check --respect-gitignore=false .
+
+# Force exclude patterns even for explicitly specified files (useful for pre-commit)
+rumdl check excluded.md --force-exclude  # Will respect exclude patterns in config
 ```
 
 ### Stdin/Stdout Formatting
@@ -284,6 +284,33 @@ repos:
 
 When you run `pre-commit install` or `pre-commit run`, pre-commit will automatically install `rumdl` in an isolated Python environment using pip. You do **not** need to install rumdl manually.
 
+### Excluding Files in Pre-commit
+
+By default, when pre-commit passes files explicitly to rumdl, the exclude patterns in your `.rumdl.toml` configuration file are ignored. This is intentional behavior - if you explicitly specify a
+file, it gets checked.
+
+However, for pre-commit workflows where you want to exclude certain files even when they're passed explicitly, you have two options:
+
+1. **Use `force_exclude` in your configuration file:**
+
+   ```toml
+   # .rumdl.toml
+   [global]
+   exclude = ["generated/*.md", "vendor/**"]
+   force_exclude = true  # Enforce excludes even for explicitly provided files
+   ```
+
+2. **Use the `--force-exclude` flag in your pre-commit config:**
+
+   ```yaml
+   repos:
+     - repo: https://github.com/rvben/rumdl-pre-commit
+       rev: v0.0.99
+       hooks:
+         - id: rumdl
+           args: [--force-exclude]  # Respect exclude patterns from config
+   ```
+
 ## CI/CD Integration
 
 ### GitHub Actions
@@ -344,6 +371,7 @@ Lint Markdown files and print warnings/errors (main subcommand)
 - `--exclude <patterns>`: Exclude specific files or directories (comma-separated glob patterns)
 - `--include <patterns>`: Include only specific files or directories (comma-separated glob patterns)
 - `--respect-gitignore`: Respect .gitignore files when scanning directories (does not apply to explicitly provided paths)
+- `--force-exclude`: Enforce exclude patterns even for explicitly specified files (useful for pre-commit hooks)
 - `-v, --verbose`: Show detailed output
 - `--profile`: Show profiling information
 - `--statistics`: Show rule violation statistics summary
@@ -540,9 +568,8 @@ rumdl can be configured in several ways:
 
 ### Configuration Discovery
 
-rumdl automatically searches for configuration files by traversing up the directory tree from the current
-working directory, similar to tools like `git`, `ruff`, and `eslint`. This means you can run rumdl from any
-subdirectory of your project and it will find the configuration file at the project root.
+rumdl automatically searches for configuration files by traversing up the directory tree from the current working directory, similar to tools like `git` , `ruff` , and `eslint` . This means you can
+run rumdl from any subdirectory of your project and it will find the configuration file at the project root.
 
 The search follows these rules:
 - Searches upward for `.rumdl.toml`, `rumdl.toml`, or `pyproject.toml` (with `[tool.rumdl]` section)
@@ -595,13 +622,13 @@ indent = 2
 
 rumdl provides seamless compatibility with existing markdownlint configurations:
 
-**Automatic Discovery**: rumdl automatically detects and loads markdownlint config files:
+** Automatic Discovery**: rumdl automatically detects and loads markdownlint config files:
 
 - `.markdownlint.json` / `.markdownlint.jsonc`
 - `.markdownlint.yaml` / `.markdownlint.yml`
 - `markdownlint.json` / `markdownlint.yaml`
 
-**Explicit Import**: Convert markdownlint configs to rumdl format:
+** Explicit Import**: Convert markdownlint configs to rumdl format:
 
 ```bash
 # Convert to .rumdl.toml
@@ -689,8 +716,8 @@ Both kebab-case (`line-length`, `ignore-gitignore`) and snake_case (`line_length
 
 #### Effective Configuration (`rumdl config`)
 
-The `rumdl config` command prints the **full effective configuration** (defaults + all overrides), showing every key and its value, annotated with the source of each value.
-The output is colorized and the `[from ...]` annotation is globally aligned for easy scanning.
+The `rumdl config` command prints the **full effective configuration** (defaults + all overrides), showing every key and its value, annotated with the source of each value. The output is colorized and
+the `[from ...]` annotation is globally aligned for easy scanning.
 
 #### Example output
 
@@ -707,7 +734,7 @@ The output is colorized and the `[from ...]` annotation is globally aligned for
   ...
 ```
 
-- **Keys** are cyan, **values** are yellow, and the `[from ...]` annotation is colored by source:
+- ** Keys** are cyan, **values** are yellow, and the `[from ...]` annotation is colored by source:
   - Green: CLI
   - Blue: `.rumdl.toml`
   - Magenta: `pyproject.toml`
@@ -725,6 +752,7 @@ disable = []
 exclude = []
 include = []
 respect_gitignore = true
+force_exclude = false  # Set to true to exclude files even when explicitly specified
 
 [MD013]
 line_length = 80

{rumdl-0.0.134 → rumdl-0.0.136}/src/config.rs

@@ -174,6 +174,13 @@ pub struct GlobalConfig {
     /// When set, adjusts parsing and validation rules for that specific Markdown variant
     #[serde(default)]
     pub flavor: MarkdownFlavor,
+
+    /// Whether to enforce exclude and extend-exclude patterns even for paths that are passed explicitly.
+    /// By default (false), rumdl will lint any paths passed in directly, even if they would typically be excluded.
+    /// Setting this to true will cause rumdl to respect exclusions unequivocally.
+    /// This is useful for pre-commit, which explicitly passes all changed files.
+    #[serde(default)]
+    pub force_exclude: bool,
 }
 
 fn default_respect_gitignore() -> bool {
@@ -198,6 +205,7 @@ impl Default for GlobalConfig {
             fixable: Vec::new(),
             unfixable: Vec::new(),
             flavor: MarkdownFlavor::default(),
+            force_exclude: false,
         }
     }
 }
@@ -1115,6 +1123,7 @@ pub struct SourcedGlobalConfig {
     pub fixable: SourcedValue<Vec<String>>,
     pub unfixable: SourcedValue<Vec<String>>,
     pub flavor: SourcedValue<MarkdownFlavor>,
+    pub force_exclude: SourcedValue<bool>,
 }
 
 impl Default for SourcedGlobalConfig {
@@ -1130,6 +1139,7 @@ impl Default for SourcedGlobalConfig {
             fixable: SourcedValue::new(Vec::new(), ConfigSource::Default),
             unfixable: SourcedValue::new(Vec::new(), ConfigSource::Default),
             flavor: SourcedValue::new(MarkdownFlavor::default(), ConfigSource::Default),
+            force_exclude: SourcedValue::new(false, ConfigSource::Default),
         }
     }
 }
@@ -1228,6 +1238,19 @@ impl SourcedConfig {
             fragment.global.flavor.overrides.first().and_then(|o| o.line),
         );
 
+        // Merge force_exclude
+        self.global.force_exclude.merge_override(
+            fragment.global.force_exclude.value,
+            fragment.global.force_exclude.source,
+            fragment
+                .global
+                .force_exclude
+                .overrides
+                .first()
+                .and_then(|o| o.file.clone()),
+            fragment.global.force_exclude.overrides.first().and_then(|o| o.line),
+        );
+
         // Merge output_format if present
         if let Some(output_format_fragment) = fragment.global.output_format {
             if let Some(ref mut output_format) = self.global.output_format {
@@ -1608,6 +1631,7 @@ impl From<SourcedConfig> for Config {
             fixable: sourced.global.fixable.value,
             unfixable: sourced.global.unfixable.value,
             flavor: sourced.global.flavor.value,
+            force_exclude: sourced.global.force_exclude.value,
         };
         Config { global, rules }
     }
@@ -1886,6 +1910,15 @@ fn parse_pyproject_toml(content: &str, path: &str) -> Result<Option<SourcedConfi
                     .push_override(value, source, file.clone(), None);
             }
 
+            if let Some(force_exclude) = table.get("force-exclude").or_else(|| table.get("force_exclude"))
+                && let Ok(value) = bool::deserialize(force_exclude.clone())
+            {
+                fragment
+                    .global
+                    .force_exclude
+                    .push_override(value, source, file.clone(), None);
+            }
+
             if let Some(output_format) = table.get("output-format").or_else(|| table.get("output_format"))
                 && let Ok(value) = String::deserialize(output_format.clone())
             {
@@ -1968,6 +2001,8 @@ fn parse_pyproject_toml(content: &str, path: &str) -> Result<Option<SourcedConfi
                 "exclude",
                 "respect_gitignore",
                 "respect-gitignore", // Added kebab-case here too
+                "force_exclude",
+                "force-exclude",
                 "line_length",
                 "line-length",
                 "output_format",
@@ -2167,6 +2202,23 @@ fn parse_rumdl_toml(content: &str, path: &str) -> Result<SourcedConfigFragment,
                         );
                     }
                 }
+                "force_exclude" | "force-exclude" => {
+                    // Handle both cases
+                    if let Some(toml_edit::Value::Boolean(formatted_bool)) = value_item.as_value() {
+                        let val = *formatted_bool.value();
+                        fragment
+                            .global
+                            .force_exclude
+                            .push_override(val, source, file.clone(), None);
+                    } else {
+                        log::warn!(
+                            "[WARN] Expected boolean for global key '{}' in {}, found {}",
+                            key,
+                            path,
+                            value_item.type_name()
+                        );
+                    }
+                }
                 "line_length" | "line-length" => {
                     // Handle both cases
                     if let Some(toml_edit::Value::Integer(formatted_int)) = value_item.as_value() {

{rumdl-0.0.134 → rumdl-0.0.136}/src/main.rs

@@ -300,6 +300,13 @@ struct CheckArgs {
     /// Run in watch mode by re-running whenever files change
     #[arg(short, long, help = "Run in watch mode by re-running whenever files change")]
     watch: bool,
+
+    /// Enforce exclude patterns even for paths that are passed explicitly.
+    /// By default, rumdl will lint any paths passed in directly, even if they would typically be excluded.
+    /// Setting this flag will cause rumdl to respect exclusions unequivocally.
+    /// This is useful for pre-commit, which explicitly passes all changed files.
+    #[arg(long, help = "Enforce exclude patterns even for explicitly specified files")]
+    force_exclude: bool,
 }
 
 // Get a complete set of enabled rules based on CLI options and config
@@ -591,12 +598,15 @@ fn find_markdown_files(
     // --- Pre-check for explicit file paths ---
     // If not in discovery mode, validate that specified paths exist
     if !is_discovery_mode {
+        // Check if we should apply excludes to explicitly provided files
+        let should_force_exclude = args.force_exclude || config.global.force_exclude;
+
         for path_str in paths {
             let path = Path::new(path_str);
             if !path.exists() {
                 return Err(format!("File not found: {path_str}").into());
             }
-            // If it's a file, check if it's a markdown file and add it directly
+            // If it's a file, check if it's a markdown file
             if path.is_file()
                 && let Some(ext) = path.extension()
                 && (ext == "md" || ext == "markdown")
@@ -606,12 +616,37 @@ fn find_markdown_files(
                 } else {
                     path_str.clone()
                 };
-                file_paths.push(cleaned_path);
+
+                // If force_exclude is enabled, check if this file should be excluded
+                if should_force_exclude && !final_exclude_patterns.is_empty() {
+                    let mut should_exclude = false;
+                    for pattern in &final_exclude_patterns {
+                        // Use globset for pattern matching
+                        if let Ok(glob) = globset::Glob::new(pattern) {
+                            let matcher = glob.compile_matcher();
+                            if matcher.is_match(&cleaned_path) {
+                                should_exclude = true;
+                                if args.verbose {
+                                    eprintln!(
+                                        "Excluding explicitly provided file due to force_exclude: {cleaned_path}"
+                                    );
+                                }
+                                break;
+                            }
+                        }
+                    }
+                    if !should_exclude {
+                        file_paths.push(cleaned_path);
+                    }
+                } else {
+                    // Default behavior: add all explicitly provided files
+                    file_paths.push(cleaned_path);
+                }
             }
         }
 
         // If we found files directly, skip the walker
-        if !file_paths.is_empty() {
+        if !file_paths.is_empty() || should_force_exclude {
             file_paths.sort();
             file_paths.dedup();
             return Ok(file_paths);