rubocop-prose 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: df5161ee5df2bb5e5b642b3baefb5f95ec038cea286de98c177c317af2ed8115
+  data.tar.gz: 2dde6ed1646ce551227eed6465856616056972e520ccc2830d65c2e035b7d74f
+SHA512:
+  metadata.gz: dcd9ff6b678a0ddcb11c07ec164a5f047f333bd656afe88f0f36eb80fac561c83ef5014de712ee08f212ea2a3f3cb1a291ee76ec70b8078462296538ba119b57
+  data.tar.gz: 52279ff43345beeda93aebd8b718c66a5dc2dea1fcc801c9aab57a4ba467f0ae1d52d4ef1d180d128fc5c8cca9d5153e694980a05984f91583ea7080b9b73fdd

data/AGENTS.md

@@ -0,0 +1,13 @@
+# Contributor instructions
+
+Read [CONTRIBUTING.md](CONTRIBUTING.md) for setup, tests, and pull-request conventions. Read [DESIGN.md](DESIGN.md) before changing parsing, source mapping, or correction behavior.
+
+Keep user guidance in the README and cop guides, contributor workflow in CONTRIBUTING, architecture and rationale in DESIGN, and this file focused on high-value agent guidance. Link to the authoritative documentation instead of duplicating it.
+
+Preserve original source buffers and character-based locations, Markdown container prefixes and hard breaks, and atomic inline syntax. Plain text must remain literal; format-specific cops must not inspect the other format. Withhold corrections when a safe rewrite cannot be established.
+
+Keep common cleanup enabled by default and project-specific, editorial, or renderer-dependent policies opt-in. Do not add an external preprocessor dependency. Preserve functional dependency loading and compatibility settings.
+
+When adding a cop, follow the checklist in [CONTRIBUTING.md](CONTRIBUTING.md#adding-a-cop); document its user-visible behavior and meaningful limits without repeating shared exclusions.
+
+Do not edit historical changelog entries or add one for documentation, tooling, refactoring, or unreleased functionality. Preserve the vendored helmet SVG and its license; follow CONTRIBUTING for artwork changes.

data/CHANGELOG.md

@@ -0,0 +1,82 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## 0.1.0 (2026/11/03)
+
+- [#120](https://github.com/dblock/rubocop-prose/pull/120): Add a default-enabled Markdown hard-break style policy with backslash and trailing-space syntax options - [@dblock](https://github.com/dblock).
+- [#110](https://github.com/dblock/rubocop-prose/pull/110): Add enabled-by-default `Markdown/ListContinuationIndentation` to report lazy list continuation text outside its item's content column - [@dblock](https://github.com/dblock).
+- [#114](https://github.com/dblock/rubocop-prose/pull/114): Add the default-enabled `Markdown/UnclosedFencedCodeBlock` report for EOF-terminated fenced code blocks - [@dblock](https://github.com/dblock).
+- [#108](https://github.com/dblock/rubocop-prose/pull/108): Allow multiple explicit thematic-break spellings with report-only handling for ambiguous corrections - [@dblock](https://github.com/dblock).
+- [#107](https://github.com/dblock/rubocop-prose/pull/107): Apply the configured blank-line limit inside Markdown blockquotes while preserving quote markers and paragraph separation - [@dblock](https://github.com/dblock).
+- [#109](https://github.com/dblock/rubocop-prose/pull/109): Add default-enabled compact-list spacing checks with safe correction for simple items - [@dblock](https://github.com/dblock).
+- [#112](https://github.com/dblock/rubocop-prose/pull/112): Detect and safely correct missing separators after blockquote markers - [@dblock](https://github.com/dblock).
+- [#111](https://github.com/dblock/rubocop-prose/pull/111): Add default-enabled `Markdown/OutsideSpacing` for inline formatting adjacent to prose - [@dblock](https://github.com/dblock).
+- [#113](https://github.com/dblock/rubocop-prose/pull/113): Add `Markdown/ThematicBreakBlankLines` for default-enabled, container-aware spacing around parsed thematic breaks - [@dblock](https://github.com/dblock).
+- [#115](https://github.com/dblock/rubocop-prose/pull/115): Add a default-enabled check for backslash separators in local Markdown image paths - [@dblock](https://github.com/dblock).
+- [#106](https://github.com/dblock/rubocop-prose/pull/106): Enable dollar and percent shell-prompt cleanup with configurable markers and report-only handling of ambiguous shell comments - [@dblock](https://github.com/dblock).
+- [#75](https://github.com/dblock/rubocop-prose/pull/75): Configure independent blank-line counts above and below fenced code blocks - [@dblock](https://github.com/dblock).
+- [#72](https://github.com/dblock/rubocop-prose/pull/72): Allow identical reference definitions while retaining conflict and unused checks - [@dblock](https://github.com/dblock).
+- [#69](https://github.com/dblock/rubocop-prose/pull/69): Add reproducible prose benchmarks and share Markdown document analysis across cops - [@dblock](https://github.com/dblock).
+- [#66](https://github.com/dblock/rubocop-prose/pull/66): Enable common-sense Markdown and text checks and unwrapped paragraphs by default, with conservative heading, tab, and reference policies - [@dblock](https://github.com/dblock).
+- [#65](https://github.com/dblock/rubocop-prose/pull/65): Configure Markdown and text Include patterns with per-file discovery, source dispatch, and a README settings catalog - [@dblock](https://github.com/dblock).
+- [#63](https://github.com/dblock/rubocop-prose/pull/63): Add plain-text support with shared Prose, Markdown, and Text departments, format-specific policies, and grouped integration tests - [@dblock](https://github.com/dblock).
+- [#60](https://github.com/dblock/rubocop-prose/pull/60): Add a RuboCop-inspired logo with a parchment scroll, editable SVG artwork, and a README image - [@dblock](https://github.com/dblock).
+- [#58](https://github.com/dblock/rubocop-prose/pull/58): Add `Prose/TableSpacing` for table cell spacing - [@dblock](https://github.com/dblock).
+- [#57](https://github.com/dblock/rubocop-prose/pull/57): Add `Prose/TableBlankLines` for blank lines around tables - [@dblock](https://github.com/dblock).
+- [#56](https://github.com/dblock/rubocop-prose/pull/56): Add `Prose/TableColumns` for consistent table column counts - [@dblock](https://github.com/dblock).
+- [#55](https://github.com/dblock/rubocop-prose/pull/55): Add `Prose/TablePipes` for table pipe style - [@dblock](https://github.com/dblock).
+- [#54](https://github.com/dblock/rubocop-prose/pull/54): Add `Prose/StrongStyle` for consistent strong-emphasis delimiters - [@dblock](https://github.com/dblock).
+- [#53](https://github.com/dblock/rubocop-prose/pull/53): Add `Prose/EmphasisStyle` for consistent emphasis delimiters - [@dblock](https://github.com/dblock).
+- [#52](https://github.com/dblock/rubocop-prose/pull/52): Add `Prose/ProperNames` for configured proper-name capitalization - [@dblock](https://github.com/dblock).
+- [#51](https://github.com/dblock/rubocop-prose/pull/51): Add `Prose/CodeSpanSpacing` for spacing inside inline code spans - [@dblock](https://github.com/dblock).
+- [#50](https://github.com/dblock/rubocop-prose/pull/50): Add `Prose/EmphasisSpacing` for spacing inside emphasis markers - [@dblock](https://github.com/dblock).
+- [#49](https://github.com/dblock/rubocop-prose/pull/49): Add `Prose/ThematicBreakStyle` for consistent thematic breaks - [@dblock](https://github.com/dblock).
+- [#48](https://github.com/dblock/rubocop-prose/pull/48): Add `Prose/RawHtml` for configurable inline HTML restrictions - [@dblock](https://github.com/dblock).
+- [#47](https://github.com/dblock/rubocop-prose/pull/47): Add `Prose/DescriptiveLinkText` for descriptive link labels - [@dblock](https://github.com/dblock).
+- [#46](https://github.com/dblock/rubocop-prose/pull/46): Add `Prose/LinkStyle` for allowed link and image styles - [@dblock](https://github.com/dblock).
+- [#45](https://github.com/dblock/rubocop-prose/pull/45): Add `Prose/ReferenceDefinitions` for duplicate and unused reference definitions - [@dblock](https://github.com/dblock).
+- [#44](https://github.com/dblock/rubocop-prose/pull/44): Add `Prose/UndefinedReference` for undefined link and image references - [@dblock](https://github.com/dblock).
+- [#43](https://github.com/dblock/rubocop-prose/pull/43): Add `Prose/LinkFragment` for local heading-fragment targets - [@dblock](https://github.com/dblock).
+- [#42](https://github.com/dblock/rubocop-prose/pull/42): Add `Prose/ImageAltText` for missing image alternative text - [@dblock](https://github.com/dblock).
+- [#41](https://github.com/dblock/rubocop-prose/pull/41): Add `Prose/EmptyLink` for empty link destinations - [@dblock](https://github.com/dblock).
+- [#40](https://github.com/dblock/rubocop-prose/pull/40): Add `Prose/LinkTextSpacing` for spacing inside link text - [@dblock](https://github.com/dblock).
+- [#39](https://github.com/dblock/rubocop-prose/pull/39): Add `Prose/BareUrl` for bare URLs outside code and other protected spans - [@dblock](https://github.com/dblock).
+- [#38](https://github.com/dblock/rubocop-prose/pull/38): Add `Prose/ReversedLink` for reversed link syntax - [@dblock](https://github.com/dblock).
+- [#37](https://github.com/dblock/rubocop-prose/pull/37): Add `Prose/FenceStyle` for consistent code-fence markers - [@dblock](https://github.com/dblock).
+- [#36](https://github.com/dblock/rubocop-prose/pull/36): Add `Prose/CodeBlockStyle` for fenced or indented code-block style - [@dblock](https://github.com/dblock).
+- [#35](https://github.com/dblock/rubocop-prose/pull/35): Add `Prose/FenceLanguage` for code-fence language identifiers - [@dblock](https://github.com/dblock).
+- [#34](https://github.com/dblock/rubocop-prose/pull/34): Add `Prose/FenceBlankLines` for blank lines around fenced code blocks - [@dblock](https://github.com/dblock).
+- [#33](https://github.com/dblock/rubocop-prose/pull/33): Add `Prose/ShellPrompts` for unnecessary shell prompts in command examples - [@dblock](https://github.com/dblock).
+- [#32](https://github.com/dblock/rubocop-prose/pull/32): Add `Prose/ListBlankLines` for blank lines around lists - [@dblock](https://github.com/dblock).
+- [#31](https://github.com/dblock/rubocop-prose/pull/31): Add `Prose/ListMarkerSpacing` for spacing after list markers - [@dblock](https://github.com/dblock).
+- [#30](https://github.com/dblock/rubocop-prose/pull/30): Add `Prose/OrderedListNumbering` for ordered-list numbering styles - [@dblock](https://github.com/dblock).
+- [#29](https://github.com/dblock/rubocop-prose/pull/29): Add `Prose/BlockquoteBlankLines` for blank lines within blockquotes - [@dblock](https://github.com/dblock).
+- [#28](https://github.com/dblock/rubocop-prose/pull/28): Add `Prose/BlockquoteSpacing` for spacing after blockquote markers - [@dblock](https://github.com/dblock).
+- [#27](https://github.com/dblock/rubocop-prose/pull/27): Add `Prose/UnorderedListIndentation` for nested unordered-list indentation - [@dblock](https://github.com/dblock).
+- [#26](https://github.com/dblock/rubocop-prose/pull/26): Add `Prose/ListIndentation` for consistent list-item indentation - [@dblock](https://github.com/dblock).
+- [#25](https://github.com/dblock/rubocop-prose/pull/25): Add `Prose/UnorderedListMarker` for unordered-list marker styles - [@dblock](https://github.com/dblock).
+- [#24](https://github.com/dblock/rubocop-prose/pull/24): Add `Prose/HeadingStructure` for a configured heading outline - [@dblock](https://github.com/dblock).
+- [#23](https://github.com/dblock/rubocop-prose/pull/23): Add `Prose/FirstHeading` for the initial heading level and optional front-matter title exemption - [@dblock](https://github.com/dblock).
+- [#22](https://github.com/dblock/rubocop-prose/pull/22): Add `Prose/EmphasisHeading` for emphasis-only paragraphs used as headings - [@dblock](https://github.com/dblock).
+- [#21](https://github.com/dblock/rubocop-prose/pull/21): Add `Prose/HeadingPunctuation` for trailing heading punctuation - [@dblock](https://github.com/dblock).
+- [#20](https://github.com/dblock/rubocop-prose/pull/20): Add `Prose/SingleTopLevelHeading` for multiple top-level headings - [@dblock](https://github.com/dblock).
+- [#19](https://github.com/dblock/rubocop-prose/pull/19): Add `Prose/DuplicateHeadings` for duplicate headings in document or sibling scope - [@dblock](https://github.com/dblock).
+- [#18](https://github.com/dblock/rubocop-prose/pull/18): Add `Prose/HeadingIndentation` for leading heading indentation - [@dblock](https://github.com/dblock).
+- [#17](https://github.com/dblock/rubocop-prose/pull/17): Add `Prose/HeadingBlankLines` for blank lines around headings - [@dblock](https://github.com/dblock).
+- [#16](https://github.com/dblock/rubocop-prose/pull/16): Add `Prose/ClosedHeadingSpacing` for excess spacing before closing heading hashes - [@dblock](https://github.com/dblock).
+- [#15](https://github.com/dblock/rubocop-prose/pull/15): Add `Prose/ClosedHeadingSpace` for missing spacing before closing heading hashes - [@dblock](https://github.com/dblock).
+- [#14](https://github.com/dblock/rubocop-prose/pull/14): Add `Prose/AtxHeadingSpacing` for excess spacing after opening heading hashes - [@dblock](https://github.com/dblock).
+- [#13](https://github.com/dblock/rubocop-prose/pull/13): Add `Prose/AtxHeadingSpace` for missing spacing after opening heading hashes - [@dblock](https://github.com/dblock).
+- [#12](https://github.com/dblock/rubocop-prose/pull/12): Add `Prose/HeadingStyle` for consistent ATX, closed ATX, or Setext headings - [@dblock](https://github.com/dblock).
+- [#11](https://github.com/dblock/rubocop-prose/pull/11): Add `Prose/HeadingIncrement` for skipped heading levels - [@dblock](https://github.com/dblock).
+- [#10](https://github.com/dblock/rubocop-prose/pull/10): Add `Prose/TrailingNewline` to normalize the final document newline - [@dblock](https://github.com/dblock).
+- [#9](https://github.com/dblock/rubocop-prose/pull/9): Add `Prose/MultipleBlankLines` to limit consecutive blank lines without merging paragraphs - [@dblock](https://github.com/dblock).
+- [#8](https://github.com/dblock/rubocop-prose/pull/8): Add `Prose/HardTabs` with code-language exceptions - [@dblock](https://github.com/dblock).
+- [#7](https://github.com/dblock/rubocop-prose/pull/7): Add `Prose/TrailingWhitespace`, preserving Markdown hard breaks - [@dblock](https://github.com/dblock).
+- [#6](https://github.com/dblock/rubocop-prose/pull/6): Extend line-length policies to headings, code blocks, and tables - [@dblock](https://github.com/dblock).
+- [#5](https://github.com/dblock/rubocop-prose/pull/5): Add shared configurable front-matter exclusion - [@dblock](https://github.com/dblock).
+- [#4](https://github.com/dblock/rubocop-prose/pull/4): Add `Prose/Syntax` to report parser diagnostics without duplicate reference reports - [@dblock](https://github.com/dblock).
+- [#3](https://github.com/dblock/rubocop-prose/pull/3): Add single-line paragraph unwrapping and CLI integration - [@dblock](https://github.com/dblock).
+- [#2](https://github.com/dblock/rubocop-prose/pull/2): Add `Prose/MaxLength` for safe Markdown paragraph wrapping - [@dblock](https://github.com/dblock).
+- [#1](https://github.com/dblock/rubocop-prose/pull/1): Add the parser-backed RuboCop plugin foundation with original-source ranges and opt-in document cops - [@dblock](https://github.com/dblock).

data/CONTRIBUTING.md

@@ -0,0 +1,77 @@
+# Contributing
+
+## Setup and validation
+
+Use Ruby 3.2 or newer. Supported RuboCop versions are 1.72.1 and newer within 1.x.
+
+```sh
+bundle install
+bundle exec rake
+bundle exec rake build
+```
+
+The default Rake task runs RuboCop and the full test suite. For focused changes, use `bundle exec rspec spec/path_to_spec.rb` and `bundle exec rubocop`. Run unit or standalone integration tests separately with `bundle exec rake spec:unit` or `bundle exec rake spec:integration`. To install the minimum supported RuboCop, use `RUBOCOP_VERSION=1.72.1 bundle install`.
+
+CI covers Ruby 3.2 and 4.0, gem packaging, and optional Markdown-preprocessor interoperability. See the [workflows](.github/workflows) for suite selection and dependency versions.
+
+The lint configuration loads this checkout's plugin alongside rubocop-rspec and rubocop-rake; intentionally invalid fixtures are excluded.
+
+### Benchmarks
+
+Run `bundle exec rake benchmark`; set `ITERATIONS` and `SECTIONS` to override sample counts and corpus sizes, for example `ITERATIONS=5 SECTIONS=10,50,100 bundle exec rake benchmark`.
+
+The benchmark compares document analysis, cop investigation, and in-memory autocorrection on Markdown and text corpora. Each operation constructs a fresh document; compare results only across revisions using the same Ruby, RuboCop, and corpus settings. Timings are machine-dependent, not CI thresholds.
+
+## Tests
+
+Keep focused cop tests in `spec/<name>_spec.rb`. Cover offenses, exclusions, Unicode source locations, safe corrections, and ambiguous rewrites that must remain report-only. Document adapters and file selection have dedicated specs; format-specific cops must not investigate the other format, even when explicitly selected.
+
+Exercise the real CLI when changing plugin loading, stdin, suppression directives, or cross-cop corrections. Test both CLI-option and YAML plugin loading. Interoperability changes also need both preprocessor loading orders, simultaneous prose/Ruby corrections, repeated runs, and stdin.
+
+### Integration fixtures
+
+Scenarios live under `spec/fixtures/{prose,markdown,text,markdown_interoperability}/`, with specs in `spec/integration/` and `spec/interoperability/`. Each contains an `input` document, a `case.yml` declaring `offenses` and `remaining_offenses` counts (empty maps for clean results), and an `expected` document when correction changes the input.
+
+Content fixtures call `RuboCop::CLI` in-process with fresh configuration state, checking explicit files, discovery, corrections, repeated runs, and stdin with both plugin-loading configurations. Fixtures with explicit `Enabled: true` cop entries run with `--only`; others exercise configured defaults. Mark whitespace-sensitive fixtures using the existing Git attributes.
+
+Fresh-process smoke tests in `spec/integration/cli_spec.rb` check YAML and CLI-option plugin boot for Markdown and text, standard and custom-extension discovery, stdin without disk mutation, and stable corrections. Interoperability keeps a combined Ruby/Markdown scenario across both loading orders and plugin-loading mechanisms; edge cases check reporting, correction, and stability under both loading orders using YAML plugin loading.
+
+Mixed default-cop scenarios in `spec/fixtures/markdown_stability/` check content and document structure after every correction, convergence without cycles, and byte-identical output after stabilization.
+
+For optional interoperability, set `RUBOCOP_MD_PATH` to a checkout supporting the [original-buffer mapping API](DESIGN.md#preprocessor-interoperability) and run `bundle exec rake spec:interoperability`. Without that variable, the suite is skipped. Its separate CI workflow runs only on Ruby 4.0; update the rubocop-md ref when the required API is released.
+
+## Adding a cop
+
+Add implementations under `lib/rubocop/cop/prose`, `lib/rubocop/cop/markdown`, or `lib/rubocop/cop/text`, inheriting from the corresponding department `Base`. Add a per-cop YAML file under `config/cops/<department>/` with an explicit `Enabled` value, supported options, correction policy, and applicable file patterns. The loader discovers implementations and merges their configuration files.
+
+Add focused specs, a guide under `docs/cops/<department>/` with complete default configuration and meaningful bad/good examples, and a linked one-line entry in the [README cops catalog](README.md#cops). Introduce example-specific settings with “For this configuration:” followed by a YAML block. Keep user-visible behavior and meaningful limits in the guide, implementation rationale in [DESIGN.md](DESIGN.md), and shared exclusions in the README. Use the native cop name; do not add numeric aliases or comparisons with other plugins.
+
+Validate defaults, packaging, and the affected tests. Enable broadly applicable cleanup by default; keep project-specific, editorial, and renderer-dependent policies opt-in. Preserve functional dependency loading and compatibility CI settings.
+
+## Pull requests
+
+See [RELEASING.md](RELEASING.md) for the maintainer release procedure.
+
+Keep each pull request focused, with one coherent commit, and use squash merges. Include behavior and configuration documentation. Preserve unrelated worktree changes.
+
+Add a linked unreleased changelog entry only for a notable user-facing change, using the actual pull-request number. Do not add entries for documentation, tooling, refactoring, or unreleased functionality; update an existing feature entry when appropriate.
+
+```markdown
+- [#123](https://github.com/dblock/rubocop-prose/pull/123): Describe the change - [@dblock](https://github.com/dblock).
+```
+
+Keep each Markdown paragraph on one source line. Do not duplicate developer instructions in the README, cop guides, or asset notes.
+
+## Artwork
+
+Edit `assets/logo.svg`, leaving the upstream `assets/rubocop-logo.svg` unchanged and retaining the notice in `assets/RUBOCOP-LICENSE`. The composition and attribution are documented in [DESIGN.md](DESIGN.md#artwork).
+
+Inspect the animation and reduced-motion rendering in a browser. Keep the PNG a static, fully unrolled fallback; the README uses the GIF because GitHub does not reliably preserve SVG animation. When changing the animation, regenerate the GIF from a full six-second SVG cycle at 15 frames per second, with the fully unrolled first frame and infinite looping.
+
+With `rsvg-convert` installed, regenerate the 512px PNG from the repository root:
+
+```sh
+rsvg-convert assets/logo.svg -o assets/logo.png
+```
+
+Check the full-size PNG and 160px README rendering for clipping, legibility, scroll orientation, and separation from the helmet. Keep the opaque white background and package all artwork sources, rendered images, and the upstream notice together.

data/DESIGN.md

@@ -0,0 +1,51 @@
+# Design
+
+## Scope and file selection
+
+The plugin checks Markdown and plain-text prose without evaluating Ruby snippets. `Prose/*` policies apply to both formats; `Markdown/*` and `Text/*` are format-specific. Common cleanup is enabled by default, while project-specific, editorial, and renderer-dependent policies remain opt-in. User-visible behavior and defaults are in [the README cops catalog](README.md#cops) and the cop guides.
+
+`Markdown/Include` and `Text/Include` are resolved by `FileTypes` from each file's effective RuboCop configuration. The same resolver drives discovery and applicability; overlapping patterns are an error. Format selection is configuration-local, not a process-wide registry or a separate set of hard-coded extension lists.
+
+The plugin loads document support and abstract cop bases before concrete cops, then merges shared and per-cop defaults. The runner supplies a file's configuration before source construction when its selected format differs from RuboCop's default classification. This keeps nested configuration, explicit files, stdin, and autocorrection on the same dispatch path.
+
+## Documents and source preservation
+
+`Document` retains the untouched input buffer and exposes character-based ranges. `MarkdownDocument` parses Markdown and provides its structure; `TextDocument` groups nonblank lines into paragraphs without interpreting headings, links, fences, HTML, or metadata. Text indentation may indicate preformatted content, so indented paragraphs can be reported but are not automatically reflowed.
+
+Markdown parsing combines an AST with source-aware scanners for constructs that may be malformed or omitted from the tree. Scanners must exclude code, escaped syntax, and ignored metadata. Parser byte offsets are converted to character positions before they are mapped to the original source, preserving Unicode locations.
+
+Front matter is recognized only as a closed leading header. When ignored, it is masked only in the parser input, preserving line endings and source positions; the original buffer is not rewritten. `Markdown/IgnoreFrontMatter` is resolved while constructing each Markdown document, including documents shared by `Prose/*` cops. Hidden RuboCop directives are recognized only in Markdown outside code and ignored metadata; directive-shaped text remains literal in plain text.
+
+Standalone Markdown and all plain text initialize Ruby parsing with empty input and keep the original document in a separate buffer, preventing Ruby cops from interpreting prose. The cop bases enforce format applicability before accessing format-specific APIs. Documents are cached on the processed source by configuration identity, so cops can share analysis without mixing configuration-dependent results.
+
+Each Markdown document shares positioned emphasis and strong ranges across style and spacing cops, including table-row source mapping. Both types are collected in one parse; style policies remain cop-local, and corrected sources receive fresh documents.
+
+## Preprocessor interoperability
+
+An optional Markdown preprocessor can expose `processed_source.markdown_document` with an untouched `buffer` and `original_range` / `processed_range` mapping methods. The plugin analyzes that original buffer and translates offense and correction ranges at the RuboCop boundary, preserving the preprocessor's Ruby buffer so both kinds of corrections can coexist. This API is optional; standalone Markdown and text linting do not require a preprocessor.
+
+Plain text never consults the preprocessor API. A preprocessor without the original-buffer mapping methods is unsupported. Custom Markdown extensions remain lintable standalone when the preprocessor does not recognize them; Ruby extraction is then unavailable. The shared `Markdown:` section preserves keys owned by the preprocessor, while `IgnoreFrontMatter` belongs to this plugin.
+
+## Correction safety
+
+Corrections are limited to rewrites whose source mapping and resulting document semantics are known. Markdown reflow preserves container prefixes, hard breaks, inline atomic syntax, and HTML break behavior; text preserves literal contents and paragraph boundaries. Unbreakable tokens and ambiguous structural rewrites can be reported without correction. Markdown structural checks do not reflow headings, tables, or code.
+
+Source scanners retain original reference spellings and ranges when AST resolution discards them, and protect inline constructs such as links, code, escapes, and HTML from unrelated formatting corrections. Renderer-dependent heading fragments are configurable approximations, not guarantees for every renderer or extension. Parser warnings are native syntax diagnostics rather than a complete CommonMark validation.
+
+Bare link destinations use character-based searches to skip ordinary path text, retaining whitespace, nesting, and escape checks at candidate boundaries without changing original Unicode offsets.
+
+Shared blank-line cleanup respects the minimum padding required by enabled, applicable Markdown structure-spacing cops, without applying those rules to plain text. When an offense has multiple plausible rewrites, the cop reports it without choosing one.
+
+`Markdown/HardBreakStyle` applies to parser-recognized paragraph hard breaks, not arbitrary terminal backslashes or code. Its default backslash style is coordinated with `Markdown/TrailingWhitespace` so the two cops do not issue overlapping edits; conversions that could change backslash escaping are report-only.
+
+Shell-prompt removal preserves code-content ranges and container prefixes. Blocks with output or ambiguous `#` prompts remain uncorrected; so does an entire block if removing any prompt could expose its closing delimiter. See [Markdown/ShellPrompts](docs/cops/markdown/shell_prompts.md) for prompt and language settings.
+
+`Markdown/ListContinuationIndentation` uses parsed list-item membership and each paragraph's original-source mapping to find continuation lines, excluding following root paragraphs and child list blocks. Its expected column comes from the parsed item's marker, so ordered marker widths and container prefixes are retained. It reports only: reindentation could change Markdown block ownership, so no correction is offered.
+
+Cop guides describe user-visible behavior and correction limits. Parsing, source mapping, and correction rationale belong here rather than in individual guides.
+
+## Artwork
+
+The logo pairs the RuboCop helmet with a parchment scroll, keeping both silhouettes legible at the README's 160px display size. Its opaque white background preserves contrast on dark pages.
+
+`assets/rubocop-logo.svg` is copied unchanged from [the official website's SVG at a pinned commit](https://github.com/rubocop/rubocop.org/blob/e48d295d87264ea7dbfa0c6df7c7c4b56670979d/src/images/favicon.svg). The upstream MIT copyright and permission notice is preserved in [assets/RUBOCOP-LICENSE](assets/RUBOCOP-LICENSE); the newly drawn scroll uses this repository's [MIT license](LICENSE.txt). Editing and rendering instructions are in [CONTRIBUTING.md](CONTRIBUTING.md#artwork), and all artwork sources, rendered images, and the notice are packaged together.

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Doubrovkine
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,152 @@
+<img src="assets/logo.gif" alt="The RuboCop helmet logo alongside a parchment scroll rolling up and unfurling." width="160">
+
+# rubocop-prose
+
+[![Lint](https://github.com/dblock/rubocop-prose/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/dblock/rubocop-prose/actions/workflows/lint.yml) [![Tests](https://github.com/dblock/rubocop-prose/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/dblock/rubocop-prose/actions/workflows/test.yml)
+
+Markdown and plain-text prose checks for RuboCop.
+
+Use [rubocop-md](https://github.com/rubocop/rubocop-md) to lint Ruby code inside Markdown.
+
+This project was inspired by [To Wrap or Not to Wrap in Markdown](https://code.dblock.org/2021/06/07/to-wrap-or-not-to-wrap-in-markdown.html) and borrows many Markdown checks from [markdownlint](https://github.com/DavidAnson/markdownlint).
+
+## Installation
+
+Add to your Gemfile, then run `bundle install`:
+
+```ruby
+gem 'rubocop-prose', '~> 0.1', require: false
+```
+
+Add it to `.rubocop.yml` using RuboCop's plugin interface:
+
+```yaml
+plugins:
+  - rubocop-prose
+```
+
+Ruby 3.2 or newer and RuboCop 1.72.1 or newer within 1.x are supported.
+
+## Usage
+
+Given `example.md`:
+
+```markdown
+A paragraph split
+across two source lines.
+```
+
+Run:
+
+```sh
+bundle exec rubocop example.md
+```
+
+```text
+example.md:2:1: C: [Correctable] Prose/MaxLength: Keep paragraph text on a single source line.
+across two source lines.
+^^^^^^^^^^^^^^^^^^^^^^^^
+```
+
+Fix it automatically with `bundle exec rubocop -a example.md`.
+
+## Cops
+
+### Markdown
+
+Markdown checks ignore [front matter](docs/settings/front_matter.md) by default and do not treat code blocks as prose. Dedicated code-block cops check their structure; [Markdown/HardTabs](docs/cops/markdown/hard_tabs.md) and [Markdown/StructuralLineLength](docs/cops/markdown/structural_line_length.md) can also inspect code content. Inline formatting checks leave code spans, links, escaped syntax, and HTML untouched unless they specifically check those constructs.
+
+| Cop                                                                                         | Default  | Purpose                                                                             |
+| ---                                                                                         | ---      | -------                                                                             |
+| [Markdown/AtxHeadingSpace](docs/cops/markdown/atx_heading_space.md)                         | Enabled  | Separate opening ATX heading hashes from text.                                      |
+| [Markdown/AtxHeadingSpacing](docs/cops/markdown/atx_heading_spacing.md)                     | Enabled  | Use one space after opening ATX heading hashes.                                     |
+| [Markdown/BareUrl](docs/cops/markdown/bare_url.md)                                          | Disabled | Require Markdown links or autolinks around bare URLs.                               |
+| [Markdown/BlockquoteBlankLines](docs/cops/markdown/blockquote_blank_lines.md)               | Enabled  | Keep quote markers on blank lines between blockquotes.                              |
+| [Markdown/BlockquoteSpacing](docs/cops/markdown/blockquote_spacing.md)                      | Enabled  | Use one space after nonempty blockquote markers.                                    |
+| [Markdown/ClosedHeadingSpace](docs/cops/markdown/closed_heading_space.md)                   | Enabled  | Separate closing ATX heading hashes from text.                                      |
+| [Markdown/ClosedHeadingSpacing](docs/cops/markdown/closed_heading_spacing.md)               | Enabled  | Use one space before closing ATX heading hashes.                                    |
+| [Markdown/CompactLists](docs/cops/markdown/compact_lists.md)                                | Enabled  | Avoid blank lines between simple list items.                                        |
+| [Markdown/CodeBlockStyle](docs/cops/markdown/code_block_style.md)                           | Disabled | Use fenced, indented, or consistently styled code blocks.                           |
+| [Markdown/CodeSpanSpacing](docs/cops/markdown/code_span_spacing.md)                         | Enabled  | Avoid unnecessary padding inside inline code.                                       |
+| [Markdown/DescriptiveLinkText](docs/cops/markdown/descriptive_link_text.md)                 | Enabled  | Require descriptive link text instead of generic labels.                            |
+| [Markdown/DuplicateHeadings](docs/cops/markdown/duplicate_headings.md)                      | Enabled  | Avoid duplicate heading text.                                                       |
+| [Markdown/EmphasisHeading](docs/cops/markdown/emphasis_heading.md)                          | Disabled | Avoid single-line emphasis-only paragraphs in place of headings.                    |
+| [Markdown/EmphasisSpacing](docs/cops/markdown/emphasis_spacing.md)                          | Enabled  | Remove whitespace immediately inside emphasis delimiters.                           |
+| [Markdown/EmphasisStyle](docs/cops/markdown/emphasis_style.md)                              | Enabled  | Use a configured or consistent emphasis delimiter.                                  |
+| [Markdown/EmptyLink](docs/cops/markdown/empty_link.md)                                      | Enabled  | Require a nonempty link destination.                                                |
+| [Markdown/FenceBlankLines](docs/cops/markdown/fence_blank_lines.md)                         | Enabled  | Surround fenced code blocks with container-aware blank lines.                       |
+| [Markdown/FenceLanguage](docs/cops/markdown/fence_language.md)                              | Enabled  | Require a language and optionally restrict fence languages.                         |
+| [Markdown/FenceStyle](docs/cops/markdown/fence_style.md)                                    | Enabled  | Use backtick, tilde, or consistently styled fences.                                 |
+| [Markdown/FirstHeading](docs/cops/markdown/first_heading.md)                                | Disabled | Begin documents with a heading or front-matter title.                               |
+| [Markdown/HardBreakStyle](docs/cops/markdown/hard_break_style.md)                           | Enabled  | Use backslashes or trailing spaces for paragraph hard breaks.                       |
+| [Markdown/HardTabs](docs/cops/markdown/hard_tabs.md)                                        | Enabled  | Disallow hard tabs with code-language exceptions.                                   |
+| [Markdown/HeadingBlankLines](docs/cops/markdown/heading_blank_lines.md)                     | Enabled  | Surround headings with blank lines.                                                 |
+| [Markdown/HeadingIncrement](docs/cops/markdown/heading_increment.md)                        | Enabled  | Increase heading levels without skipping levels.                                    |
+| [Markdown/HeadingIndentation](docs/cops/markdown/heading_indentation.md)                    | Enabled  | Avoid leading indentation before headings.                                          |
+| [Markdown/HeadingPunctuation](docs/cops/markdown/heading_punctuation.md)                    | Disabled | Avoid configured trailing heading punctuation.                                      |
+| [Markdown/HeadingStructure](docs/cops/markdown/heading_structure.md)                        | Disabled | Match a configured exact heading outline.                                           |
+| [Markdown/HeadingStyle](docs/cops/markdown/heading_style.md)                                | Disabled | Use a consistent heading syntax.                                                    |
+| [Markdown/ImageAltText](docs/cops/markdown/image_alt_text.md)                               | Enabled  | Require nonblank Markdown image alternative text.                                   |
+| [Markdown/ImagePathSeparators](docs/cops/markdown/image_path_separators.md)                 | Enabled  | Use forward slashes in local image destinations.                                    |
+| [Markdown/LinkFragment](docs/cops/markdown/link_fragment.md)                                | Disabled | Validate local fragments using configurable heading anchors.                        |
+| [Markdown/LinkStyle](docs/cops/markdown/link_style.md)                                      | Disabled | Configure permitted link and image styles independently.                            |
+| [Markdown/LinkTextSpacing](docs/cops/markdown/link_text_spacing.md)                         | Enabled  | Remove leading and trailing whitespace from link text.                              |
+| [Markdown/ListBlankLines](docs/cops/markdown/list_blank_lines.md)                           | Enabled  | Surround parsed lists with blank lines.                                             |
+| [Markdown/ListContinuationIndentation](docs/cops/markdown/list_continuation_indentation.md) | Enabled  | Indent list continuation text to its item's content column.                         |
+| [Markdown/ListIndentation](docs/cops/markdown/list_indentation.md)                          | Enabled  | Keep sibling list markers consistently indented.                                    |
+| [Markdown/ListMarkerSpacing](docs/cops/markdown/list_marker_spacing.md)                     | Enabled  | Configure spaces after ordered and unordered list markers.                          |
+| [Markdown/OrderedListNumbering](docs/cops/markdown/ordered_list_numbering.md)               | Disabled | Use sequential numbers or repeated ones in ordered lists.                           |
+| [Markdown/OutsideSpacing](docs/cops/markdown/outside_spacing.md)                            | Enabled  | Report inline formatting directly adjacent to prose words.                          |
+| [Markdown/ProperNames](docs/cops/markdown/proper_names.md)                                  | Disabled | Use configured capitalization for proper names.                                     |
+| [Markdown/RawHtml](docs/cops/markdown/raw_html.md)                                          | Disabled | Disallow raw HTML except explicitly allowed elements.                               |
+| [Markdown/ReferenceDefinitions](docs/cops/markdown/reference_definitions.md)                | Enabled  | Report unused and duplicate reference definitions.                                  |
+| [Markdown/ReversedLink](docs/cops/markdown/reversed_link.md)                                | Enabled  | Report reversed Markdown link delimiters.                                           |
+| [Markdown/ShellPrompts](docs/cops/markdown/shell_prompts.md)                                | Enabled  | Omit configured shell prompts in examples without output.                           |
+| [Markdown/SingleTopLevelHeading](docs/cops/markdown/single_top_level_heading.md)            | Disabled | Allow at most one top-level heading.                                                |
+| [Markdown/StrongStyle](docs/cops/markdown/strong_style.md)                                  | Enabled  | Use a configured or consistent strong delimiter.                                    |
+| [Markdown/StructuralLineLength](docs/cops/markdown/structural_line_length.md)               | Disabled | Report overlong heading, code-block, and table source lines without reflowing them. |
+| [Markdown/Syntax](docs/cops/markdown/syntax.md)                                             | Enabled  | Report native Markdown parser diagnostics.                                          |
+| [Markdown/TableBlankLines](docs/cops/markdown/table_blank_lines.md)                         | Enabled  | Surround Markdown tables with blank lines.                                          |
+| [Markdown/TableColumns](docs/cops/markdown/table_columns.md)                                | Enabled  | Match table body column counts to the header.                                       |
+| [Markdown/TablePipes](docs/cops/markdown/table_pipes.md)                                    | Enabled  | Use consistent leading and trailing table pipes.                                    |
+| [Markdown/TableSpacing](docs/cops/markdown/table_spacing.md)                                | Enabled  | Use configured spacing around table cell content.                                   |
+| [Markdown/ThematicBreakBlankLines](docs/cops/markdown/thematic_break_blank_lines.md)        | Enabled  | Surround parsed thematic breaks with container-aware blank lines.                   |
+| [Markdown/ThematicBreakStyle](docs/cops/markdown/thematic_break_style.md)                   | Enabled  | Use a configured or consistent thematic break.                                      |
+| [Markdown/TrailingWhitespace](docs/cops/markdown/trailing_whitespace.md)                    | Enabled  | Remove trailing whitespace while retaining Markdown hard breaks.                    |
+| [Markdown/UnclosedFencedCodeBlock](docs/cops/markdown/unclosed_fenced_code_block.md)        | Enabled  | Require an explicit closing fence for fenced code blocks.                           |
+| [Markdown/UndefinedReference](docs/cops/markdown/undefined_reference.md)                    | Enabled  | Require definitions for link and image references.                                  |
+| [Markdown/UnorderedListIndentation](docs/cops/markdown/unordered_list_indentation.md)       | Enabled  | Use a configured indentation width for unordered lists.                             |
+| [Markdown/UnorderedListMarker](docs/cops/markdown/unordered_list_marker.md)                 | Enabled  | Use a configured or consistent unordered list marker.                               |
+| [Prose/MaxLength](docs/cops/prose/max_length.md)                                            | Enabled  | Wrap or unwrap prose paragraphs in Markdown and plain text.                         |
+| [Prose/MultipleBlankLines](docs/cops/prose/multiple_blank_lines.md)                         | Enabled  | Limit blank lines in prose and quotes, but not code.                                |
+| [Prose/TrailingNewline](docs/cops/prose/trailing_newline.md)                                | Enabled  | Require exactly one final newline.                                                  |
+
+#### Settings
+
+| Setting                                                     | Purpose                                                             |
+| ---                                                         | ---                                                                 |
+| [Markdown/Include](docs/settings/files.md)                  | Select files parsed as Markdown using native RuboCop file patterns. |
+| [Markdown/IgnoreFrontMatter](docs/settings/front_matter.md) | Ignore closed leading metadata during Markdown inspection.          |
+
+### Text
+
+| Cop                                                                 | Default | Purpose                                                     |
+| ---                                                                 | ---     | -------                                                     |
+| [Prose/MaxLength](docs/cops/prose/max_length.md)                    | Enabled | Wrap or unwrap prose paragraphs in Markdown and plain text. |
+| [Prose/MultipleBlankLines](docs/cops/prose/multiple_blank_lines.md) | Enabled | Limit consecutive literal blank lines.                      |
+| [Prose/TrailingNewline](docs/cops/prose/trailing_newline.md)        | Enabled | Require exactly one final newline.                          |
+| [Text/TrailingWhitespace](docs/cops/text/trailing_whitespace.md)    | Enabled | Remove all trailing spaces and tabs from plain-text lines.  |
+
+#### Settings
+
+| Setting                                | Purpose                                                                 |
+| ---                                    | ---                                                                     |
+| [Text/Include](docs/settings/files.md) | Select files parsed as literal text using native RuboCop file patterns. |
+
+## Project documentation
+
+See [CONTRIBUTING](CONTRIBUTING.md) for development, testing, and artwork maintenance, [DESIGN](DESIGN.md) for architecture and design decisions, and [AGENTS](AGENTS.md) for contributor instructions for coding agents.
+
+## License
+
+Released under the [MIT license](LICENSE.txt).

data/RELEASING.md

@@ -0,0 +1,32 @@
+# Releasing rubocop-prose
+
+Release only with explicit maintainer authorization. Release preparation happens on `main`; never force-push `main`.
+
+## Prepare
+
+Update `main` with a fast-forward pull. Run `bundle exec rake` and confirm GitHub Actions checks pass, including the separate interoperability workflow. Verify the minimum supported RuboCop with `RUBOCOP_VERSION=1.72.1 bundle install` and `RUBOCOP_VERSION=1.72.1 bundle exec rake spec`; restore the normal dependency resolution afterward. Interoperability currently uses rubocop-md PR #57; update its workflow ref and README compatibility note when the original-source mapping API is released.
+
+Set the version in `lib/rubocop/prose/version.rb`, date its CHANGELOG heading as `YYYY/MM/DD`, remove the contribution placeholder from that release, and check README installation instructions. Commit and push preparation changes, wait for green CI, then build and inspect the package:
+
+```sh
+bundle exec rake build
+gem specification pkg/rubocop-prose-0.1.0.gem files
+```
+
+Confirm runtime code, configuration, cop guides, README, CHANGELOG, licenses, and artwork are present; exclude tests, temporary workspaces, and dependency caches. Preserve the vendored helmet license and provenance. Install the exact built gem into a temporary gem environment outside the checkout and exercise plugin loading, discovery, stdin, configuration, and repeated autocorrection for Markdown and text.
+
+## Publish
+
+Publish the exact inspected package. Enter a fresh RubyGems MFA code when prompted; never put credentials or codes in source, logs, or documentation.
+
+For an assistant-driven release, ask the maintainer for a fresh MFA code only when ready to publish and pass it through `GEM_HOST_OTP_CODE`, not the `--otp` command-line argument. Prefer a hidden local prompt. If the maintainer explicitly chooses chat, explain that the code will be visible in conversation history. Never save the code in repository files or documentation. Alternatively, the maintainer can run `gem push` interactively.
+
+```sh
+gem push pkg/rubocop-prose-0.1.0.gem
+```
+
+Verify that exact version on RubyGems before creating and pushing an annotated `v0.1.0` tag at the release commit. Create a GitHub release with matching changelog notes. Do not move an existing release tag.
+
+## Next development iteration
+
+Bump the gem version, add a matching `(Next)` CHANGELOG section with `* Your contribution here.`, then commit and push to `main`.

data/assets/README.md

@@ -0,0 +1,3 @@
+# Logo artwork
+
+See [DESIGN.md](../DESIGN.md#artwork) for composition and source attribution, [CONTRIBUTING.md](../CONTRIBUTING.md#artwork) for editing and rendering instructions, and [RUBOCOP-LICENSE](RUBOCOP-LICENSE) for the upstream copyright and permission notice.

data/assets/RUBOCOP-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2012-26 Bozhidar Batsov
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/assets/logo.svg

@@ -0,0 +1,80 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 512 512" role="img" aria-labelledby="title description">
+  <title id="title">rubocop-prose logo</title>
+  <desc id="description">RuboCop's original helmet logo alongside a parchment scroll that rolls up and unfurls.</desc>
+  <style>
+    .scroll-static { display: none; }
+    @media (prefers-reduced-motion: reduce) {
+      .scroll-animated { display: none; }
+      .scroll-static { display: inline; }
+    }
+  </style>
+  <defs>
+    <g id="scroll-paper-static">
+      <path fill="#fff" stroke="#fff" stroke-width="16" d="M-46-96h94c18 0 18 26 0 26V80c0 9-6 16-13 16h-81c-19 0-19-30 0-30V-70c-17 0-17-26 0-26z"/>
+      <path fill="#fff6e5" stroke="#17191c" stroke-width="5" d="M-46-83h94V80c0 9-6 16-13 16h-81z"/>
+    </g>
+    <g id="scroll-top">
+      <path fill="#f2dfbf" stroke="#17191c" stroke-width="5" d="M-46-96h94c18 0 18 26 0 26h-94z"/>
+      <circle cx="-46" cy="-83" r="13" fill="#e7c9a0" stroke="#17191c" stroke-width="5"/>
+      <path fill="none" stroke="#17191c" stroke-width="3" d="M-43-89c-8-2-13 8-6 12 4 3 9-1 6-5"/>
+    </g>
+    <g id="scroll-lines">
+      <path fill="none" stroke="#ec1826" stroke-width="6" d="M-26-42H10"/>
+      <path fill="none" stroke="#17191c" stroke-width="4" d="M-26-16H28M-26 5h55M-26 26h40M-26 47h48"/>
+    </g>
+    <g id="scroll-bottom">
+      <path fill="#f2dfbf" stroke="#17191c" stroke-width="5" d="M-46 66h81c19 0 19 30 0 30h-81z"/>
+      <circle cx="-46" cy="81" r="15" fill="#e7c9a0" stroke="#17191c" stroke-width="5"/>
+    </g>
+    <path id="scroll-curl" fill="none" stroke="#17191c" stroke-width="3" d="M-43 74c-9-2-15 10-7 14 5 3 11-2 7-7"/>
+    <clipPath id="scroll-paper-clip">
+      <rect x="-64" y="-83" width="128" height="179">
+        <animate attributeName="height" dur="6s" repeatCount="indefinite"
+          values="179;179;43;43;179;179" keyTimes="0;0.25;0.45;0.55;0.75;1"
+          calcMode="spline" keySplines="0.45 0 0.2 1;0.45 0 0.2 1;0.45 0 0.2 1;0.45 0 0.2 1;0.45 0 0.2 1"/>
+      </rect>
+    </clipPath>
+  </defs>
+  <path fill="#fff" d="M0 0h512v512H0z"/>
+  <image href="rubocop-logo.svg" x="0" y="72" width="360" height="360"/>
+  <g transform="translate(423 258)" stroke-linecap="round" stroke-linejoin="round">
+    <g class="scroll-static">
+      <use href="#scroll-paper-static"/>
+      <use href="#scroll-top"/>
+      <use href="#scroll-lines"/>
+      <use href="#scroll-bottom"/>
+      <use href="#scroll-curl"/>
+    </g>
+    <g class="scroll-animated">
+      <path fill="#fff" stroke="#fff" stroke-width="16" d="M-46-96h94c18 0 18 26 0 26V80c0 9-6 16-13 16h-81c-19 0-19-30 0-30V-70c-17 0-17-26 0-26z">
+        <animate attributeName="d" dur="6s" repeatCount="indefinite"
+          values="M-46-96h94c18 0 18 26 0 26V80c0 9-6 16-13 16h-81c-19 0-19-30 0-30V-70c-17 0-17-26 0-26z;M-46-96h94c18 0 18 26 0 26V80c0 9-6 16-13 16h-81c-19 0-19-30 0-30V-70c-17 0-17-26 0-26z;M-46-96h94c18 0 18 26 0 26V-56c0 9-6 16-13 16h-81c-19 0-19-30 0-30V-70c-17 0-17-26 0-26z;M-46-96h94c18 0 18 26 0 26V-56c0 9-6 16-13 16h-81c-19 0-19-30 0-30V-70c-17 0-17-26 0-26z;M-46-96h94c18 0 18 26 0 26V80c0 9-6 16-13 16h-81c-19 0-19-30 0-30V-70c-17 0-17-26 0-26z;M-46-96h94c18 0 18 26 0 26V80c0 9-6 16-13 16h-81c-19 0-19-30 0-30V-70c-17 0-17-26 0-26z"
+          keyTimes="0;0.25;0.45;0.55;0.75;1" calcMode="spline"
+          keySplines="0.45 0 0.2 1;0.45 0 0.2 1;0.45 0 0.2 1;0.45 0 0.2 1;0.45 0 0.2 1"/>
+      </path>
+      <path id="scroll-paper" fill="#fff6e5" stroke="#17191c" stroke-width="5" d="M-46-83h94V80c0 9-6 16-13 16h-81z">
+        <animate attributeName="d" dur="6s" repeatCount="indefinite"
+          values="M-46-83h94V80c0 9-6 16-13 16h-81z;M-46-83h94V80c0 9-6 16-13 16h-81z;M-46-83h94V-56c0 9-6 16-13 16h-81z;M-46-83h94V-56c0 9-6 16-13 16h-81z;M-46-83h94V80c0 9-6 16-13 16h-81z;M-46-83h94V80c0 9-6 16-13 16h-81z"
+          keyTimes="0;0.25;0.45;0.55;0.75;1" calcMode="spline"
+          keySplines="0.45 0 0.2 1;0.45 0 0.2 1;0.45 0 0.2 1;0.45 0 0.2 1;0.45 0 0.2 1"/>
+      </path>
+      <use href="#scroll-top"/>
+      <g clip-path="url(#scroll-paper-clip)">
+        <use href="#scroll-lines"/>
+      </g>
+      <g id="scroll-roller">
+        <animateTransform attributeName="transform" type="translate" dur="6s" repeatCount="indefinite"
+          values="0 0;0 0;0 -136;0 -136;0 0;0 0" keyTimes="0;0.25;0.45;0.55;0.75;1"
+          calcMode="spline" keySplines="0.45 0 0.2 1;0.45 0 0.2 1;0.45 0 0.2 1;0.45 0 0.2 1;0.45 0 0.2 1"/>
+        <use href="#scroll-bottom"/>
+        <g>
+          <animateTransform attributeName="transform" type="rotate" dur="6s" repeatCount="indefinite"
+            values="0 -46 81;0 -46 81;-540 -46 81;-540 -46 81;0 -46 81;0 -46 81"
+            keyTimes="0;0.25;0.45;0.55;0.75;1" calcMode="spline"
+            keySplines="0.45 0 0.2 1;0.45 0 0.2 1;0.45 0 0.2 1;0.45 0 0.2 1;0.45 0 0.2 1"/>
+          <use href="#scroll-curl"/>
+        </g>
+      </g>
+    </g>
+  </g>
+</svg>

data/assets/rubocop-logo.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="-9.46 0 121.6 121.6"><style>path{fill:#151515}.visor{fill:#eb1c23}@media (prefers-color-scheme:dark){path{fill:#e8e8e3}.visor{fill:#ff2a31}}</style><path d="M99.67 51.58V47.7a7.75 7.75 0 0 0-7.73-7.73h-81.2a7.75 7.75 0 0 0-7.73 7.73v3.88A6.3 6.3 0 0 0 0 56.92v10.39a6.3 6.3 0 0 0 3.01 5.33v4.04a7.75 7.75 0 0 0 7.73 7.72h81.2a7.75 7.75 0 0 0 7.73-7.72v-4.04a6.3 6.3 0 0 0 3.01-5.33V56.92a6.3 6.3 0 0 0-3.01-5.34M51.34 0A43 43 0 0 0 8.7 37.5h85.28A43 43 0 0 0 51.34 0M38.65 95.73h25.38l2.6 3 3.89-3.37-4.13-4.78h-30.1l-4.14 4.78 3.9 3.37zm43.39-8.87v16.43a8.24 8.24 0 0 1-8.21 8.22h-4.47v-.02c-.98 0-1.85-.45-2.42-1.16h-.01l-5.35-6.83-.01.01a3.1 3.1 0 0 0-2.46-1.23l-.01-.01-.02.01H43.6l-.02-.01-.02.01a3.1 3.1 0 0 0-2.33 1.07l-.01-.01-5.47 6.99h-.01a3.1 3.1 0 0 1-2.42 1.16v.02h-4.47a8.25 8.25 0 0 1-8.22-8.22V86.86H10.59v16.48a18.3 18.3 0 0 0 18.26 18.26h44.98a18.3 18.3 0 0 0 18.26-18.26V86.86z"/><path class="visor" d="M84.46 67.87H18.21a5.7 5.7 0 0 1-5.68-5.68 5.7 5.7 0 0 1 5.68-5.69h66.25a5.7 5.7 0 0 1 5.69 5.69 5.7 5.7 0 0 1-5.69 5.68"/></svg>

data/config/cops/markdown/atx_heading_space.yml

@@ -0,0 +1,3 @@
+Markdown/AtxHeadingSpace:
+  Description: 'Separate opening ATX heading hashes from text.'
+  Enabled: true

data/config/cops/markdown/atx_heading_spacing.yml

@@ -0,0 +1,3 @@
+Markdown/AtxHeadingSpacing:
+  Description: 'Use one space after opening ATX heading hashes.'
+  Enabled: true