Module: Sloplint

Defined in:

lib/sloplint/cli.rb,
lib/sloplint/rules.rb,
lib/sloplint/engine.rb,
lib/sloplint/output.rb,
lib/sloplint/version.rb

Defined Under Namespace

Modules: CLI, Engine, Output Classes: Note, Rule

Constant Summary

RULES =

[
  # ── rhetorical-tic ────────────────────────────────────────────────────
  Rule.new(
    id: "no-x-no-y",
    category: "rhetorical-tic",
    severity: "warning",
    # Comma chains only: "no fluff, no filler, no jargon". The comma is the
    # evidence -- it makes the parallelism deliberate. Fragment chains split
    # by sentence punctuation are a separate, quieter rule (no-x-no-y-frag),
    # because periods are not an authorial choice the way commas are.
    pattern: /\bno\s+[\w'-]+,\s+no\s+[\w'-]+(?:,?\s+(?:and\s+)?no\s+[\w'-]+)*/i,
    message: '"No X, no Y" chain (%{count} items) reads as AI cadence.',
    suggestion: "Cut the chain or make it one plain sentence.",
    count_group: /\bno\b/i,
    examples_bad: ["No fluff, no filler, no jargon."],
    examples_ok: ["No parking on Sundays."],
    rationale: "Asyndetic negation chains are a signature model cadence, near-absent from " \
               "human prose at any length -- 24 hits in 1.02M words across Austen, Melville, " \
               "Madison, Thoreau, and Emerson combined. A careful writer occasionally stacks " \
               "two (and, rarely, more), but a model reaches for the pattern constantly."
  ),
  Rule.new(
    id: "no-x-no-y-frag",
    category: "rhetorical-tic",
    severity: "info",
    # The same cadence built from sentence fragments: "No fluff. No filler."
    # Ships at info, not warning, because the shape is genuinely ambiguous --
    # two short "no" sentences in a row is also just writing ("No one moved.
    # No one spoke."). The agent reading the flag decides; see rationale.
    #
    # Two structural guards keep it from reporting chains that are not in the
    # text at all. A link must START a sentence, so an ordinary sentence
    # cannot donate its tail ("There was no bread." + "No milk either." is
    # one sentence and one fragment, not a chain). And the separator is at
    # most two spaces, so a blanked-out code span or URL under --markdown
    # cannot silently weld two distant fragments together. Links may cross a
    # hard-wrapped newline (\r\n included) but never a paragraph break.
    pattern: /(?:^|(?<=[.;!?])[ \t]{1,2})\K
              no[ \t]+[\w'-]+(?:[ \t]+[\w'-]+)?[ \t]*[.;!]
              (?:(?:[ \t]{1,2}|\r?\n(?!\s*\n)[ \t]*)
                 (?:and[ \t]+)?no[ \t]+[\w'-]+(?:[ \t]+[\w'-]+)?[ \t]*[.;!])+/ix,
    message: '"No X. No Y." fragment chain (%{count} items) reads as AI cadence.',
    suggestion: "Cut the chain or make it one plain sentence.",
    count_group: /\bno\b/i,
    examples_bad: [
      "No fluff. No filler. No jargon.",
      "No fees; no contracts; no hidden charges.",
      # Hard-wrapped Markdown: the chain survives one newline.
      "No fluff.\nNo filler."
    ],
    examples_ok: [
      "No parking on Sundays.",
      # A link must start a sentence, so this donates no tail.
      "There was no bread. No milk either.",
      "Say no more. No worries.",
      # Two fragments split by a paragraph break never chain.
      "No answer.\n\nNo one was home when we finally arrived."
    ],
    rationale: "The fragment form of the same cadence, and the weaker signal of the two: the " \
               "comma chain is one authored sentence, while this is just short sentences in " \
               "sequence, which human prose also does. It scored 1 hit in a 744k-word " \
               "five-book probe (Hamilton's 'no common coin; no common judicatory', itself " \
               "the chain in question), so it is rare in careful writing -- but a deliberate " \
               "staccato run ('No one moved. No one spoke.') has the identical shape and is " \
               "not a tell. Treat a flag here as a question, not a verdict."
  ),
  Rule.new(
    id: "thats-the-whole",
    category: "rhetorical-tic",
    severity: "warning",
    pattern: /\b(?:that|this)(?:'s| is)\s+the\s+whole\s+(?:point|game|thing|deal|story|ballgame|ball\s+game)\b/i,
    message: '"That\'s the whole point/game/…" is a stock LLM closer.',
    suggestion: "Say the point directly instead of announcing it.",
    examples_bad: ["That's the whole point."],
    examples_ok: ["This is the whole cake."],
    rationale: "The 'that's the whole X' flourish is a model tic for landing a paragraph."
  ),
  Rule.new(
    id: "did-not-x-did-not-y",
    category: "rhetorical-tic",
    severity: "warning",
    pattern: /\b(?:did\s+not|didn't)\s+[\w'-]+(?:,?\s+(?:and\s+)?(?:did\s+not|didn't)\s+[\w'-]+)+/i,
    message: '"did not X, did not Y" chain (%{count} items) reads as AI cadence.',
    suggestion: "Cut the chain or make it one plain sentence.",
    count_group: /\b(?:did\s+not|didn't)\b/i,
    examples_bad: ["She didn't flinch, didn't blink, didn't look away."],
    examples_ok: ["He didn't know the answer."],
    rationale: "Repeated negated-verb parallelism is a signature model cadence."
  ),
  Rule.new(
    id: "dont-verb-it",
    category: "rhetorical-tic",
    severity: "warning",
    pattern: /\b(?:don't|do\s+not)\s+(\w+)\s+it\b[^.!?]*[.!?]\s*\1\s+it\b/i,
    message: '"Don\'t X it. X it Y." reframing is a stock LLM move.',
    suggestion: "Drop the fake reframe and state the claim once.",
    examples_bad: ["Don't call it luck. Call it preparation."],
    examples_ok: ["Don't do it now."],
    rationale: "The negate-then-rename couplet almost never occurs in unforced human prose."
  ),
  Rule.new(
    id: "sit-with-that",
    category: "rhetorical-tic",
    severity: "warning",
    pattern: /\bsit\s+with\s+(?:that|this|it|the\s+\w+)\b/i,
    message: '"Sit with that/the discomfort" is therapized LLM filler.',
    suggestion: "Cut it, or say what you actually want the reader to do.",
    examples_bad: ["Just sit with that for a moment."],
    examples_ok: ["Sit with your family at dinner."],
    rationale: "The 'sit with X' imperative is a model comfort tic, rare in real argument."
  ),
  Rule.new(
    id: "you-already-know",
    category: "rhetorical-tic",
    severity: "warning",
    pattern: /\byou\s+already\s+know\b/i,
    message: '"You already know…" is a stock LLM rhetorical setup.',
    suggestion: "Just make the point; don't tell the reader they know it.",
    examples_bad: ["You already know how this ends."],
    examples_ok: ["Did you already send the report?"],
    rationale: "Second-person 'you already know' framing is a model tic, seldom used sincerely."
  ),
  Rule.new(
    id: "is-the-entire",
    category: "rhetorical-tic",
    severity: "warning",
    pattern: /\bis\s+the\s+entire\s+(?:point|game|thing|business\s+model|deal|story)\b/i,
    message: '"X is the entire point/game/…" is an LLM emphasis tic.',
    suggestion: "State the point plainly without the superlative frame.",
    examples_bad: ["The narrow focus is the entire point."],
    examples_ok: ["She read the entire book in a day."],
    rationale: "'is the entire X' overstates for effect the way models routinely do."
  ),
  Rule.new(
    id: "the-entire-is",
    category: "rhetorical-tic",
    severity: "warning",
    pattern: /\bthe\s+entire\s+(?:point|game|thing|business\s+model|deal|story)\s+is\b/i,
    message: '"The entire point/game/… is" is an LLM emphasis tic.',
    suggestion: "State the point plainly without the superlative frame.",
    examples_bad: ["The entire point is to save time."],
    examples_ok: ["The entire team is here today."],
    rationale: "The flipped 'the entire X is' opener carries the same model overstatement."
  ),
  Rule.new(
    id: "is-real-and-not",
    category: "rhetorical-tic",
    severity: "info",
    pattern: /\bis\s+real,?\s+(?:and|but|not)\b/i,
    message: '"The X is real, and…" is a stock LLM concession move.',
    suggestion: "Drop the 'is real, and' scaffolding; assert the point directly.",
    # No skip: for "real estate"/"real time" -- with a word between "real"
    # and the conjunction ("is real estate, and"), the pattern's ,?\s+
    # never reaches the conjunction in the first place, so those compound
    # nouns can't produce a false positive here to begin with. A skip: for
    # them was here before and never fired; confirmed by testing every
    # phrasing it could plausibly have been guarding against.
    examples_bad: ["The risk is real, and it is growing."],
    examples_ok: ["This is real leather.", "This is real estate, and it is expensive."],
    rationale: "The pattern requires nothing about what follows the conjunction, so it fires " \
               "on any 'is real' sentence that happens to continue with and/but/not, concession " \
               "or not. Emerson's 'my debt to my senses is real and constant' is two predicate " \
               "adjectives, not a both-sidesing move -- the AI cadence and the plain sentence " \
               "are three words apart and identical on the surface. An agent reading the flag " \
               "has the rest of the sentence to judge; the pattern alone doesn't."
  ),
  Rule.new(
    id: "the-punchline-is",
    category: "rhetorical-tic",
    severity: "warning",
    pattern: /\bthe\s+punchline\s*(?:is\b|[:?])/i,
    message: '"The punchline is…" is a stock LLM reveal.',
    suggestion: "Deliver the point without announcing a punchline.",
    examples_bad: ["The punchline is that nobody noticed."],
    examples_ok: ["The punchline landed perfectly."],
    rationale: "Announcing 'the punchline' is a model framing device, rare in real prose."
  ),
  Rule.new(
    id: "worth-naming",
    category: "rhetorical-tic",
    severity: "info",
    # Widened to optionally include a trailing "names" so the "naming
    # names" idiom is part of the matched text -- skip: checks the matched
    # text itself, and the tighter /\bworth\s+naming\b/ never captured
    # enough of "worth naming names" for the skip to ever reach it.
    pattern: /\bworth\s+naming(?:\s+names)?\b/i,
    message: '"Worth naming…" is a stock LLM signposting phrase.',
    suggestion: "Just name the thing; skip the meta-announcement.",
    skip: [/naming names/i],
    examples_bad: ["One tension is worth naming here."],
    examples_ok: ["It's worth reading twice.", "It's worth naming names in this report."],
    rationale: "'worth naming' collapses two senses a regex can't tell apart: the AI " \
               "meta-signpost announcing a point is coming ('One tension is worth naming " \
               "here') and the plain sense of a thing worth calling or mentioning, which " \
               "careful writers use too -- Emerson's 'the only thing worth naming to do that' " \
               "is the latter, not the former. A flag here means the phrase is present, not " \
               "which sense it's in."
  ),
  Rule.new(
    id: "thats-not-nothing",
    category: "rhetorical-tic",
    severity: "warning",
    pattern: /\b(?:that|this|it|which)(?:'s| is)\s+not\s+nothing\b/i,
    message: '"…that\'s not nothing" is a stock LLM understatement.',
    suggestion: "State the magnitude directly instead of the litotes.",
    examples_bad: ["We cut latency in half, and that's not nothing."],
    examples_ok: ["That is not enough to matter."],
    rationale: "The 'not nothing' litotes is a recognizable model closer."
  ),

  Rule.new(
    id: "exactly-the",
    category: "rhetorical-tic",
    severity: "warning",
    pattern: /\b(?:(?:that's|this is|it's)\s+)?exactly\s+the\s+(?:point|kind|type|sort|problem|question|issue|opposite|reason|thing|tension)\b/i,
    message: '"exactly the point/kind/problem/…" is an overused LLM emphasis tic.',
    suggestion: "Drop 'exactly the'; state the point without the intensifier.",
    examples_bad: ["That's exactly the point.", "We proved exactly the point we needed."],
    examples_ok: ["She folded it exactly the way he showed her."],
    rationale: "'exactly the X' is a model intensifier that a careful writer rarely leans on."
  ),
  Rule.new(
    id: "thats-how-x",
    category: "rhetorical-tic",
    severity: "warning",
    pattern: /(?:\A|[.!?]\s+|\n\s*\n)\s*(?:that|this)(?:'s| is)\s+how\b/i,
    message: '"That\'s how…" opening a sentence is a stock LLM aphorism closer.',
    suggestion: "Cut the closer, or replace it with the concrete result you mean.",
    examples_bad: ["That's how a review system compounds instead of drifting."],
    examples_ok: [
      "I never learned that's how the engine works.", "And that's how I met your mother.",
      # A mid-sentence use that happens to fall right after a hard-wrapped
      # line break must not read as a paragraph-opening kicker.
      "things are the way they are because\nthat is how things have to be."
    ],
    rationale: "Models end paragraphs by generalizing the point into a maxim; 'That's how X' " \
               "is the usual hinge. Mid-sentence uses are ordinary phrasing, not the tell."
  ),
  Rule.new(
    id: "announced-takeaway",
    category: "rhetorical-tic",
    severity: "warning",
    pattern: /(?:\A|[.!?]\s+|\n\s*\n)\s*(?:here'?s\s+)?the\s+(?:loop|pattern|trick|lesson|takeaway|playbook|framing|insight|kicker)\b[^.!?\n]{0,60}:/i,
    message: "Colon-led takeaway label announces the lesson before making it.",
    suggestion: "Give the observation first; let the reader decide it's the takeaway.",
    examples_bad: ["The loop I'd copy: file the incident, then fix the reviewer."],
    examples_ok: [
      "The pattern repeated all week.", "The move: bishop takes rook.",
      # Mid-sentence, hard-wrapped: the label lands after a line break that
      # isn't a paragraph break, and must not read as a kicker.
      "We noticed something odd about the failures, and\nthe pattern: it only ever happened on Fridays."
    ],
    rationale: "Labelling a claim as the portable lesson does the persuading that the claim " \
               "should be doing — a model habit borrowed from thought-leader prose."
  ),

  # ── puffery ───────────────────────────────────────────────────────────
  Rule.new(
    id: "puffery-words",
    category: "puffery",
    severity: "warning",
    # "nestled" alone is the literal verb as often as the puffery sense --
    # a head nestling against a shoulder, a kitten nestling into a blanket
    # -- so it requires a following in/among/between, the same shape the
    # travel-brochure cliché actually takes ("nestled in the hills").
    pattern: /\b(?:boasts\s+a\b|vibrant|nestled\b(?:\s+\S+){0,2}?\s+(?:in|among|between)\b|
                in\s+the\s+heart\s+of\s+(?:the\s+\w+|downtown\b|(?-i:[A-Z])\w+)|
                groundbreaking|renowned|diverse\s+array|breathtaking|
                natural\s+beauty|indelible\s+mark|deeply\s+rooted|
                stands\s+as\s+a\s+testament|rich\s+(?:history|cultural|heritage))/ix,
    message: "Wikipedia-style puffery word/phrase — a common AI tell.",
    suggestion: "Replace with a concrete, specific detail or cut it.",
    examples_bad: [
      "The vibrant city, nestled in the heart of the valley.",
      "A boutique hotel in the heart of Paris.",
      "A cottage nestled snugly among the pines."
    ],
    examples_ok: [
      "The city sits at the north end of the valley.",
      # Moby-Dick: "in the heart of" used as spatial/emphatic idiom, not a
      # place-description cliché — the narrow trigger requires a definite
      # or proper noun object, which this lacks.
      "You cannot sit motionless in the heart of these perils.",
      "helpless Ahab, even in the heart of such a whirlpool as that",
      # Austen, Emma: "nestled" as the physical verb, not the scene-setting
      # adjective -- no following in/among/between, so the narrowed trigger
      # leaves it alone.
      "He had nestled down his head most conveniently.",
      "The kitten nestled into the blanket."
    ],
    rationale: "Travel-brochure adjectives and phrases that models reach for and careful " \
               "writers avoid."
  ),
  Rule.new(
    id: "stands-serves-as",
    category: "puffery",
    severity: "info",
    pattern: /\b(?:stands|serves)\s+as\b|\bis\s+a\s+(?:testament|reminder)\s+to\b/i,
    message: '"stands/serves as", "is a testament/reminder to" is puffed AI framing.',
    suggestion: "Say what it does, not what it 'stands as'.",
    examples_bad: ["The bridge stands as a symbol of the era."],
    examples_ok: ["He stands at the door."],
    rationale: "The 'stands/serves as' construction inflates significance the way models do."
  ),
  Rule.new(
    id: "vital-role",
    category: "puffery",
    severity: "warning",
    pattern: /\bplays?\s+a\s+(?:vital|crucial|pivotal|significant|key|central)\s+role\b/i,
    message: '"plays a vital/crucial/… role" is a stock AI puffery phrase.',
    suggestion: "State the specific role or effect instead.",
    examples_bad: ["Sleep plays a vital role in recovery."],
    examples_ok: ["She plays a role in the new play."],
    rationale: "'plays a X role' is filler significance, a hallmark of model prose."
  ),
  Rule.new(
    id: "underscores-highlights",
    category: "puffery",
    severity: "info",
    pattern: /\b(?:underscores|highlights|emphasizes)\s+(?:its|the|their)\s+(?:importance|significance)\b/i,
    message: '"underscores/highlights its importance" is stock AI framing.',
    suggestion: "Show why it matters rather than asserting that it does.",
    examples_bad: ["This underscores its importance to the field."],
    examples_ok: ["She highlights the key line in yellow."],
    rationale: "The 'underscores its importance' move asserts significance without earning it."
  ),
  Rule.new(
    id: "rich-tapestry",
    category: "puffery",
    severity: "warning",
    pattern: /\brich\s+tapestry\b|\btapestry\s+of\b/i,
    message: '"rich tapestry"/"tapestry of" is a signature AI cliché.',
    suggestion: "Cut the metaphor; name the actual things.",
    examples_bad: ["A rich tapestry of cultures and traditions."],
    examples_ok: ["She wove a tapestry by hand."],
    rationale: "'tapestry of' is one of the most reliable single-phrase model tells."
  ),

  # ── structure ─────────────────────────────────────────────────────────
  Rule.new(
    id: "not-just-x-but-y",
    category: "structure",
    severity: "warning",
    # Two branches, both anchored on an explicit escalation word. (1) The
    # copula escalation: "is not just/only/merely/simply/solely A … but B".
    # (2) "not because A, but because B". The escalation word is what makes
    # these safe to ship at warning -- it is a deliberate authorial move, not
    # a shape ordinary prose falls into. The bare corrective without it
    # ("is not A but B") is a separate, quieter rule: not-x-but-y.
    #
    # Interior spans stop at a paragraph break so a heading or list item
    # cannot join up with the next paragraph's "But …".
    pattern: /(?:\bis|\bare|\bwas|\bwere|\bisn['’]t|\baren['’]t|\bwasn['’]t|\bweren['’]t|
                \bit['’]s|\bthat['’]s|\bthis\s+is|\bthese\s+are|\bthose\s+are)
               \s+not\s+(?:just|only|merely|simply|solely)\b
               (?:[^.!?\n]|\n(?!\s*\n))*?\bbut\b(?:\s+also\b)?
              |
              \bnot\s+because\b(?:[^.!?;\n]|\n(?!\s*\n)){1,60}?\bbut\s+because\b/ix,
    message: '"not just A, but B" is a stock AI escalation structure.',
    suggestion: "Make the claim once; drop the 'not just… but' frame.",
    examples_bad: [
      "It's not just fast, but genuinely reliable.",
      "This is not just a tool, but a partner in your workflow.",
      "It is not merely fast but reliable.",
      "The issue is not solely technical but cultural.",
      "She stayed not because it was easy, but because it was hers."
    ],
    examples_ok: [
      "He is not tired.",
      # Federalist No. 44: a real correlative conjunction joining two verb
      # phrases, not a copula predicating two things of one subject.
      "This power ought not only to be established, but ought to be established.",
      "Not only that, but they looked embarrassed.",
      "not just to acquire users, but to build something people love.",
      # A paragraph break ends the span; the next paragraph's "but" is not B.
      "He left not because of the noise\n\nbut because of the smell."
    ],
    rationale: "'X is not just A, but B' predicates two things of the same subject through a " \
               "copula, which is the specific shape models overuse. Correlative 'not only… " \
               "but' joining two verb phrases or clauses, without a preceding copula, is " \
               "ordinary and common in formal human prose; requiring the escalation word " \
               "keeps those out. 'not because… but because' scored 2 hits in a 744k-word " \
               "five-book probe (Austen, Melville, Hamilton/Madison, Thoreau, Emerson)."
  ),
  Rule.new(
    id: "not-x-but-y",
    category: "structure",
    severity: "info",
    # The bare corrective: "is not A but B", no escalation word, comma or no
    # comma. Ships at info because the line between a corrective ("not an
    # accident but a strategy") and an ordinary concession ("not warm but the
    # fire helped") is syntactic, and a regex cannot see syntax. What is here
    # is a set of cheap narrowings that cut the worst of the noise: A is
    # capped at one word after an optional article, "so" is excluded to spare
    # the archaic "not so deep but that", degree words ("quite", "very") are
    # excluded because they open concessives, and B may not be a pronoun,
    # possessive, demonstrative, auxiliary, or quantifier.
    #
    # Those guards are a filter, not a decision procedure. They still let
    # through a concession whose second clause opens with a noun phrase
    # ("was not warm but the fire helped") or a bare lexical verb ("was not
    # perfect but got us there"), because neither is distinguishable from the
    # corrective by surface form. That is the cost of the rule and the reason
    # it is info: the agent reading the flag has the context to judge, and
    # should. Do not chase these by growing the B-list -- every word added
    # silently narrows recall with nothing pinning it.
    pattern: /(?:\bis|\bare|\bwas|\bwere|\bisn['’]t|\baren['’]t|\bwasn['’]t|\bweren['’]t|
                \bit['’]s|\bthat['’]s|\bthis\s+is|\bthese\s+are|\bthose\s+are)
               \s+not\s+
               (?!so\b|just\b|only\b|merely\b|simply\b|solely\b|even\b|yet\b|quite\b|very\b
                 |too\b|all\b|always\b|enough\b)
               (?:a\s+|an\s+|the\s+)?[\w'’-]+
               ,?(?:[ \t]|\r?\n(?!\s*\n))+but(?:[ \t]|\r?\n(?!\s*\n))+
               (?:rather(?:[ \t]|\r?\n(?!\s*\n))+)?
               (?!also\b|that\b|this\b|these\b|those\b|they\b|it\b|he\b|she\b|we\b|you\b|i\b
                 |his\b|her\b|their\b|its\b|my\b|your\b|our\b|there\b|then\b|still\b|now\b
                 |is\b|was\b|are\b|were\b|has\b|had\b|have\b|will\b|would\b|could\b|should\b
                 |may\b|might\b|must\b|can\b|to\b|as\b|if\b|when\b|because\b|not\b|no\b|never\b
                 |nor\b|neither\b|every\w*\b|nobody\b|none\b|some\b|somebody\b|someone\b
                 |anyone\b|anybody\b|anything\b|nothing\b|many\b|most\b|few\b)
               (?:a\s+|an\s+|the\s+)?[\w'’-]+/ix,
    message: '"not A but B" is the bare AI corrective frame.',
    suggestion: "Make the claim once; drop the 'not… but' frame.",
    examples_bad: [
      "The delay was not an accident but a strategy.",
      "The delay was not an accident, but a strategy.",
      "The problem is not misconduct but tone.",
      "It's not a bug but a feature.",
      "That's not an accident but a strategy."
    ],
    examples_ok: [
      # Comma concessive with a pronoun subject: a contrast, not a correction.
      "He was not handsome, but he was kind.",
      # B-side pronoun: concession that continues the sentence.
      "The results are not conclusive but they point in the right direction.",
      # Archaic "not so X but that", common in 19th-century prose.
      "The stream is not so deep but that we may ford it.",
      # A capped at one word: multi-word predicates stay unflagged.
      "The evening was not particularly warm but everyone stayed late.",
      # B-side possessive, with the comma allowed.
      "The house was not large, but its garden ran clear to the river.",
      # Bare "every" on the B side, not just "everyone"/"everything".
      "It is not a bug but every case differs.",
      # A paragraph break ends the frame.
      "The result was not final\n\nBut the team moved on anyway."
    ],
    rationale: "The bare 'is not A but B' corrective is the 'not just… but' move with the " \
               "escalation word dropped, and models reach for it constantly. It is the " \
               "noisiest rule in the catalog by design: a loose version scored 174 hits in a " \
               "744k-word five-book probe, and the narrowings here cut that to 15 -- but not " \
               "all 15 are correctives. Some are concessions with an elided subject (Walden's " \
               "'It was not lonely, but made all the earth lonely beneath it'), which no " \
               "surface pattern can tell apart from the real thing. Hence info: a flag here " \
               "means 'this has the shape', not 'this is slop'."
  ),
  Rule.new(
    id: "rule-of-three",
    category: "structure",
    severity: "info",
    default_on: false,
    pattern: /\b[\w'-]+,\s+[\w'-]+,\s+(?:and\s+)?[\w'-]+[.!?]/,
    message: "Three parallel comma items closing a sentence (heuristic; high false-positive).",
    suggestion: "Fine in moderation; watch for the AI habit of ending on triplets.",
    examples_bad: ["It was fast, cheap, and simple."],
    examples_ok: ["We met on Tuesday afternoon."],
    rationale: "Rule-of-three endings are a model habit, but humans use them too — off by default."
  ),
  # clause-triad-then was cut. The pattern (comma-clause, comma-clause,
  # "then" clause) had no way to require the clauses actually be parallel
  # process steps -- against a 1M-word human corpus it went 0-for-40 on its
  # own description, catching ordinary conditionals ("when A, and B, then
  # C") and unrelated comma-separated fragments instead. A skip for leading
  # if/when/once didn't hold up either: real conditionals don't reliably
  # announce themselves at the match boundary ("but, when he does speak,
  # then...", elliptical legal "shall... then..."). It was also the most
  # expensive rule in the catalog at 65% of scan time on 1MB. Per
  # CLAUDE.md: some tells can't be regexes; this was one.
  Rule.new(
    id: "em-dash",
    category: "structure",
    severity: "info",
    pattern: /—/,
    message: "Em dash — an AI punctuation tell.",
    suggestion: "Recast with a comma, parentheses, or a separate sentence.",
    examples_bad: [
      "It was — surprisingly — the best option.",
      "The fix is simple — do less."
    ],
    examples_ok: [
      # Hyphen in a compound modifier -- not the U+2014 this rule targets.
      "The state-of-the-art model shipped on time.",
      # En dash (U+2013) in a range: a different character entirely.
      "See pages 12–18 for the full account."
    ],
    rationale: "Models reach for the em dash by default; humans use it too, but far less " \
               "often."
  ),
  Rule.new(
    id: "em-dash-overuse",
    category: "structure",
    severity: "warning",
    pattern: /—(?:[^\n]|\n(?!\s*\n))*—(?:[^\n]|\n(?!\s*\n))*—/,
    message: "Three or more em dashes in one paragraph — an AI punctuation tell.",
    suggestion: "Recast with commas, parentheses, or separate sentences.",
    examples_bad: [
      "It was — I think — the best — no, the only — option.",
      # Hard-wrapped Markdown: the same paragraph, split across lines. The
      # tell is per-paragraph, not per-line, so this must still flag.
      "It was — I think — the best decision\nwe made all year — though nobody\nbelieved it at the time."
    ],
    examples_ok: [
      "It was — I think — a fine option.",
      # Two separate paragraphs, two dashes each -- never three within one
      # paragraph, even though the raw text has four dashes total.
      "It was — I think — a fine choice.\n\nAnother option — entirely separate — came up too."
    ],
    rationale: "Three or more em dashes packed into one paragraph is a denser interjection " \
               "habit than most human writing settles into."
  ),

  # ── hedging ───────────────────────────────────────────────────────────
  Rule.new(
    id: "vague-attribution",
    category: "hedging",
    severity: "warning",
    pattern: /\bsome\s+(?:critics|experts|observers|scholars|analysts)\s+(?:argue|say|believe|contend|maintain)\b|\bit\s+is\s+widely\s+(?:regarded|considered|seen|believed|acknowledged)\b|\bmany\s+would\s+argue\b/i,
    message: "Vague attribution ('some critics argue', 'it is widely…') — an AI hedging tell.",
    suggestion: "Name the source, or drop the appeal to unnamed authority.",
    examples_bad: ["Some critics argue the plan is deeply flawed."],
    examples_ok: ["Some people left the meeting early."],
    rationale: "Anonymous-authority hedging is a model habit for sounding balanced without a source."
  )
].freeze

VERSION =

"0.2.0"