Vale Integration¶

Overview¶

Snapper ships a vale style package with two rules that flag lines needing semantic line breaks. For precise enforcement, use snapper --check directly in CI.

Style package setup¶

Add the snapper vale style to your .vale.ini:

StylesPath = /path/to/snapper/vale
MinAlertLevel = suggestion

[*.org]
BasedOnStyles = snapper

[*.tex]
BasedOnStyles = snapper

[*.md]
BasedOnStyles = snapper

Bundled rules¶

SemanticLineBreaks: Flags lines containing multiple sentences (a period followed by a space and a capital letter on the same line).

Level: warning.

LongProseLine: Flags prose lines exceeding 120 characters.

Level: suggestion.

SnapperCheck: External action. Runs snapper --check --output-format json and reports fused / wrap on the matching lines when snapper is on PATH. Advisory long stays on LongProseLine.

Precise CI enforcement¶

The vale rules use regex heuristics. For accurate checking, use the formatter directly:

snapper --check paper.org

This catches all cases the regex rules miss (abbreviations, inline tokens, etc.).

Combining vale and snapper¶

A typical workflow:

vale catches style issues (AI tells, hedging, E-Prime) during editing
snapper enforces line break formatting in CI via --check
Pre-commit hook runs both:

- repo: https://github.com/TurtleTech-ehf/snapper
  rev: v0.11.6
  hooks:
    - id: snapper
- repo: https://github.com/errata-ai/vale
  rev: v3.0.0
  hooks:
    - id: vale