ai-text-check 1.0.0

package/vale/styles/ai-tells/AICompoundPhrases.yml

@@ -0,0 +1,139 @@
+---
+extends: existence
+message: "AI fingerprint: '%s'. Rewrite with concrete specifics instead of this clichéd phrase."
+level: error
+ignorecase: true
+tokens:
+  - rich tapestry
+  - rich tapestries
+  - tapestry of
+  - intricate tapestry
+  - complex and multifaceted
+  - multifaceted and complex
+  - intricate interplay
+  - delicate balance
+  - delicate interplay
+  - dynamic interplay
+  - crucial role
+  - played a crucial role
+  - plays a crucial role
+  - vital role
+  - pivotal role
+  - key role
+  - instrumental role
+  - cutting-edge
+  - game-changer
+  - game-changing
+  - paradigm shift
+  - sea change
+  - tipping point
+  - watershed moment
+  - double-edged sword
+  - slippery slope
+  - tip of the iceberg
+  - at the forefront
+  - on the cutting edge
+  - paving the way
+  - laid the groundwork
+  - lays the groundwork
+  - sets the stage
+  - set the stage
+  - a testament to
+  - stands as a testament
+  - serve as a reminder
+  - serves as a reminder
+  - it remains to be seen
+  - only time will tell
+  - the jury is still out
+  - takes center stage
+  - take center stage
+  - took center stage
+  - paints a picture of
+  - paint a picture of
+  - painted a picture of
+  - is not without its challenges
+  - are not without their challenges
+  - is not without challenges
+  - whether we like it or not
+  - whether you like it or not
+  - a cornerstone of
+  - the transformative power of
+  - deeply rooted in
+  - deeply rooted
+  - the hallmark of
+  - a hallmark of
+  - moving the needle
+  - moves the needle
+  - moved the needle
+  - move the needle
+  - nudge the needle
+  - nudges the needle
+  - nudged the needle
+  - unlocks new
+  - unlocked new
+  - unlocking new
+  - unlock new
+  - unlocks the potential
+  - unlock the potential
+  - unlocks the power
+  - unlock the power
+  - unlocks the value
+  - unlock the value
+  - unlocks capabilities
+  - unlock capabilities
+  - unlocks possibilities
+  - unlock possibilities
+
+  # "real" as intensifier before an abstract noun.
+  # AI reaches for "a real choice" / "a real difference" to inflate
+  # weight where a plain noun would do. Bare "real" is too broad
+  # (real-time, real estate, real world), so this is enumerated.
+  - a real choice
+  - a real option
+  - a real difference
+  - a real test
+  - a real question
+  - a real chance
+  - a real problem
+  - a real shot
+  - a real risk
+  - a real cost
+  - a real benefit
+  - real value
+  - real progress
+  - real flexibility
+  - real benefits
+  - real costs
+  - real impact
+  - real leverage
+  - real ownership
+  - real accountability
+  - real consequences
+  - real tradeoffs
+  - real trade-offs
+  - real choices
+  - real options
+  - real differences
+
+  # Investigation-thread metaphors: AI's preferred way to describe
+  # "open questions" or "loose ends." Tutorial-blog tone.
+  - threads to pull on
+  - thread to pull on
+  - threads to pull
+  - thread to pull
+  - loose threads to pull
+  - loose threads to chase
+  - another thread to pull
+  - more threads to pull
+
+  # Solidification metaphors: the surface/design/contract "hardens"
+  # before some deadline. AI reaches for this constantly when
+  # describing in-progress work or pre-release windows.
+  # Broad regex catches "before/after X hardens" for any 1-6
+  # word X.
+  - (?:before|after) [^.,;:!?]{1,40} hardens
+  - (?:before|after) [^.,;:!?]{1,40} hardened
+  - (?:before|after) [^.,;:!?]{1,40} solidifies
+  - (?:before|after) [^.,;:!?]{1,40} solidified
+  - (?:before|after) [^.,;:!?]{1,40} ossifies
+  - (?:before|after) [^.,;:!?]{1,40} ossified

package/vale/styles/ai-tells/AbsoluteAssertions.yml

@@ -0,0 +1,21 @@
+---
+extends: existence
+message: "AI overreach: '%s'. Verify this claim or soften it."
+level: error
+ignorecase: true
+tokens:
+  - the only way to
+  - the only real solution
+  - the only way forward
+  - the single most important
+  - the most important thing is
+  - above all else
+  - above everything else
+  - more than anything else
+  - there is no better
+  - there is no other way
+  - there can be no doubt
+  - make no mistake
+  - make no mistake about it
+  - there's no denying
+  - there is no denying

package/vale/styles/ai-tells/AffirmativeFormulas.yml

@@ -0,0 +1,101 @@
+---
+extends: existence
+message: "AI affirmation: '%s'. Cut the flourish and state the point plainly."
+level: error
+tokens:
+  # "And that's [the/what] X" patterns
+  - "[Aa]nd that'?s the beauty of it"
+  - "[Aa]nd that'?s what makes it [^.!?]+"
+  - "[Aa]nd that'?s what makes this [^.!?]+"
+  - "[Aa]nd that'?s exactly (?:what|why|how) [^.!?]+"
+  - "[Aa]nd that'?s the (?:key|real|true) [^.!?]+"
+  - "[Aa]nd that'?s precisely (?:what|why|how) [^.!?]+"
+
+  # "That's the X" standalone affirmations
+  - "[Tt]hat'?s the key (?:insight|takeaway|point|difference)"
+  - "[Tt]hat'?s the beauty of [^.!?]+"
+  - "[Tt]hat'?s the power of [^.!?]+"
+  - "[Tt]hat'?s the magic of [^.!?]+"
+  - "[Tt]hat'?s the essence of [^.!?]+"
+  - "[Tt]hat'?s the heart of [^.!?]+"
+  - "[Tt]hat'?s the crux of [^.!?]+"
+  - "[Tt]hat'?s the real (?:question|issue|challenge|opportunity)"
+
+  # "This is what X looks like" patterns
+  - "[Tt]his is what [^.!?]+ looks like"
+  - "[Tt]hat'?s what [^.!?]+ looks like"
+  - "[Tt]his is what it means to [^.!?]+"
+  - "[Tt]hat'?s what it means to [^.!?]+"
+
+  # "Here's the thing" and variants
+  - "[Hh]ere'?s the thing"
+  - "[Hh]ere'?s the deal"
+  - "[Hh]ere'?s the truth"
+  - "[Hh]ere'?s the reality"
+  - "[Hh]ere'?s the kicker"
+  - "[Hh]ere'?s the catch"
+  - "[Hh]ere'?s the secret"
+  - "[Hh]ere'?s what (?:most people|many|few) [^.!?]+"
+  - "[Hh]ere'?s why (?:this|that|it) matters"
+
+  # "The [adjective] X is" revelation patterns
+  - "[Tt]he (?:key|fundamental|crucial|core|central|critical|essential|main|primary|underlying|basic|real|true) (?:insight|point|takeaway|lesson|idea|observation|realization|understanding|truth|message|principle) is"
+  # "[Adjective] Xs are" revelation patterns (optional article)
+  - "(?:[Tt]he )?(?:[Kk]ey|[Ff]undamental|[Cc]rucial|[Cc]ore|[Cc]entral|[Cc]ritical|[Ee]ssential|[Mm]ain|[Pp]rimary|[Uu]nderlying|[Bb]asic|[Rr]eal|[Tt]rue) (?:insights|points|takeaways|lessons|ideas|observations|realizations|understandings|truths|messages|principles) are"
+  # Simpler "The X is" patterns
+  - "[Tt]he takeaway (?:here )?is [^.!?]+"
+  - "[Tt]he lesson (?:here )?is [^.!?]+"
+  - "[Tt]he point (?:here )?is [^.!?]+"
+  - "[Tt]he insight (?:here )?is [^.!?]+"
+  - "[Tt]he bottom line is [^.!?]+"
+
+  # "And X is [exactly/precisely] what/why" patterns
+  - "[Aa]nd (?:this|that) is (?:exactly|precisely) (?:what|why|how) [^.!?]+"
+  - "[Aa]nd (?:this|that)'?s (?:exactly|precisely) (?:what|why|how) [^.!?]+"
+
+  # "Think about it" and "Let that sink in" patterns
+  - "[Tt]hink about (?:it|that) for a (?:moment|second)"
+  - "[Ll]et that sink in"
+  - "[Rr]ead that again"
+  - "[Ll]et me say that again"
+
+  # "X, and that's [rare/powerful/significant]"
+  - ", and that'?s (?:rare|powerful|significant|remarkable|important|huge|massive)"
+  - "—and that'?s (?:rare|powerful|significant|remarkable|important|huge|massive)"
+
+  # "The real X is Y" revelation
+  - "[Tt]he real (?:secret|trick|key|answer|solution) is [^.!?]+"
+  - "[Tt]he real (?:question|issue|problem|challenge) isn'?t [^.!?]+"
+
+  # "What X really means" patterns
+  - "[Ww]hat (?:this|that) really means is [^.!?]+"
+  - "[Ww]hat (?:this|that) tells us is [^.!?]+"
+  - "[Ww]hat (?:this|that) shows us is [^.!?]+"
+
+  # "And here's why" / "And here's the thing"
+  - "[Aa]nd here'?s (?:why|the thing|the kicker|the catch)"
+  - "[Bb]ut here'?s (?:why|the thing|the kicker|the catch)"
+
+  # "Let me be clear/honest" patterns
+  - "[Ll]et me be (?:clear|honest|direct|frank|real)"
+  - "[Ll]et'?s be (?:clear|honest|direct|frank|real)"
+  - "[Tt]o be (?:clear|honest|direct|frank)"
+
+  # "Have no doubt" / "Rest assured" patterns
+  - "[Hh]ave no doubt"
+  - "[Rr]est assured"
+
+  # "The truth is" patterns
+  - "[Tt]he truth is"
+  - "[Tt]he reality is"
+  - "[Tt]he fact is"
+  - "[Tt]he simple truth is"
+  - "[Tt]he hard truth is"
+  - "[Tt]he uncomfortable truth is"
+
+  # "Spoiler alert" / meta-commentary
+  - "[Ss]poiler alert"
+  - "[Pp]lot twist"
+  - "[Ff]un fact"
+  - "[Pp]ro tip"
+  - "[Hh]ot take"

package/vale/styles/ai-tells/AnnouncementHeadings.yml

@@ -0,0 +1,16 @@
+---
+extends: existence
+message: "AI announcement heading: '%s'. Cut the heading or rename it to the topic."
+level: error
+ignorecase: true
+scope: heading
+tokens:
+  - What You'll Learn
+  - What You Will Learn
+  - What We'll Cover
+  - What We Will Cover
+  - What to Expect
+  - What We're Building
+  - What We Are Building
+  - Here's What You'll Get
+  - Here's What You Get

package/vale/styles/ai-tells/AnthropomorphicJustification.yml

@@ -0,0 +1,115 @@
+---
+extends: existence
+message: "AI cliché: '%s'. Say what you mean directly."
+level: error
+ignorecase: true
+tokens:
+  # "Earning" family
+  - earns? its keep
+  - earns? its place
+  - earns? its spot
+  - earned its keep
+  - earned its place
+  - earned its spot
+  - more than earns?
+
+  # "Paying" family
+  - pays? for itself
+  - pays? dividends
+  - pays? its rent
+  - more than pays? for itself
+  - paid for itself
+  - paid dividends
+  - paid its rent
+  - paying its rent
+
+  # "Weight" family
+  - pulls? its weight
+  - carries? its weight
+  - carrying its weight
+  - pulling its weight
+  - punche?s? above its weight
+  - punching above its weight
+  - worth its weight
+
+  # "Lifting" family
+  - does? the heavy lifting
+  - does? a lot of heavy lifting
+  - doing the heavy lifting
+  - doing a lot of heavy lifting
+  - does? the legwork
+  - doing the legwork
+  - do the heavy lifting
+
+  # "Load-bearing" / "doing work" family.
+  - load-bearing
+  - load bearing
+  - does? the work
+  - doing the work
+  - does? the real work
+  - doing the real work
+  - does? the actual work
+  - doing the actual work
+  - does? the hard work
+  - doing the hard work
+  - does? the important work
+  - doing the important work
+  - does? most of the work
+  - doing most of the work
+
+  # "Standing" family
+  - stands? on its own
+  - standing on its own
+  - holds? its own
+  - holding its own
+  - speaks? for itself
+  - speaking for itself
+  - justifies? its existence
+  - justify its existence
+  - justifying its existence
+
+  # "Deserving" family.
+  # Treats abstractions and inanimate subjects as moral agents owed
+  # consideration. The gerund shape ("deserves noting", "deserves
+  # exploring") is the strongest AI tell — the older idiomatic
+  # phrases ("deserves a closer look", "deserves mention") are
+  # included for completeness.
+  - deserves? attention
+  - deserves? mention
+  - deserves? mentioning
+  - deserves? noting
+  - deserves? exploring
+  - deserves? unpacking
+  - deserves? examining
+  - deserves? scrutiny
+  - deserves? consideration
+  - deserves? careful consideration
+  - deserves? careful thought
+  - deserves? careful attention
+  - deserves? a closer look
+  - deserves? a second look
+  - deserves? a moment
+  - deserves? a mention
+  - deserves? credit
+  - deserves? confirming
+  - deserves? checking
+  - deserves? rethinking
+  - deserves? revisiting
+
+  # "Harm" family.
+  # Treats inanimate subjects (a check, a config, a flag) as moral
+  # agents capable of inflicting or withholding damage — the
+  # Hippocratic register applied to code. "The check passes too
+  # without doing harm." Technical writing rarely needs it; just say
+  # what the change does or doesn't do.
+  # NOTE: legitimate in medical / health-software prose ("the device
+  # must do no harm"). No regex-clean way to detect that context;
+  # disable this rule for those files via .vale.ini if needed.
+  - does? harm
+  - doing harm
+  - does? no harm
+  - doing no harm
+  - without doing harm
+  - causes? harm
+  - causing harm
+  - without causing harm

package/vale/styles/ai-tells/ClosingPleasantries.yml

@@ -0,0 +1,120 @@
+---
+extends: existence
+message: "AI closing: '%s'. Delete it and end with your actual content."
+level: error
+ignorecase: true
+tokens:
+  # "I hope this helps" variants
+  - I hope this helps
+  - I hope this was helpful
+  - I hope this is helpful
+  - I hope this proves helpful
+  - I hope this will be helpful
+  - Hope this helps
+  - Hope this was helpful
+  - I hope this clears things up
+  - I hope this cleared things up
+  - I hope this answers your question
+  - I hope that answers your question
+  - I hope this helps clarify
+  - I hope this gives you a better understanding
+  - I hope you find this helpful
+  - I hope you found this helpful
+  - I hope you find this useful
+  - I hope you found this useful
+  - I hope this is what you were looking for
+  - I hope this pointed you in the right direction
+  - I hope this sheds some light
+  - I hope this makes things clearer
+  - Hopefully this helps
+  - Hopefully this is helpful
+
+  # "Feel free to" variants
+  - Feel free to ask
+  - Feel free to reach out
+  - Feel free to let me know
+  - Feel free to contact
+  - Feel free to ask questions
+  - Feel free to ask if you
+  - Feel free to ask if there
+  - Feel free to drop
+  - Please feel free to ask
+  - Please feel free to reach out
+
+  # "Don't hesitate" variants
+  - Don't hesitate to ask
+  - Don't hesitate to reach out
+  - Don't hesitate to contact
+  - Don't hesitate to get in touch
+  - Don't hesitate to drop
+  - Please don't hesitate to ask
+  - Please don't hesitate to reach out
+  - Please don't hesitate to contact
+
+  # "Let me know if" variants
+  - Let me know if you have any questions
+  - Let me know if you have further questions
+  - Let me know if you have any other questions
+  - Let me know if you have additional questions
+  - Let me know if you need anything else
+  - Let me know if you need further clarification
+  - Let me know if you need any clarification
+  - Let me know if you'd like more information
+  - Let me know if you'd like me to elaborate
+  - Let me know if you'd like me to clarify
+  - Let me know if you'd like me to expand
+  - Let me know if there's anything else
+  - Let me know if there's anything I can help with
+  - Let me know if anything is unclear
+  - Let me know if that makes sense
+  - Let me know if you want me to
+
+  # "If you have any questions" standalone variants
+  - If you have any questions, feel free
+  - If you have any further questions
+  - If you have any additional questions
+  - If you have any more questions
+  - If you need any clarification
+  - If you need more information
+  - If anything is unclear
+  - If you'd like more details
+  - If you'd like me to elaborate
+  - If you want me to expand
+
+  # "Happy to" variants
+  - Happy to help
+  - Happy to answer
+  - Happy to clarify
+  - Happy to elaborate
+  - Happy to explain
+  - Happy to assist
+  - Happy to walk you through
+  - I'm happy to help
+  - I'd be happy to help
+  - I'm happy to clarify
+  - I'd be happy to clarify
+  - I'm happy to elaborate
+  - I'd be happy to elaborate
+  - I'm happy to answer
+  - I'd be happy to answer
+  - I'm happy to walk you through
+  - I'd be happy to walk you through
+
+  # "I'm here to help" variants
+  - I'm here to help
+  - I'm here if you need
+  - I'm here if you have
+  - I'm always here to help
+  - We're here to help
+  - We're always happy to help
+
+  # Encouragement/well-wishing closers
+  - Best of luck
+  - Good luck with your
+  - Good luck on your
+  - You've got this
+  - Happy coding
+  - Happy learning
+  - Happy building
+  - Happy exploring
+  - Enjoy the journey

package/vale/styles/ai-tells/ColloquialAssessments.yml

@@ -0,0 +1,47 @@
+---
+extends: existence
+message: "AI colloquial assessment: '%s'. State the assessment directly."
+level: error
+nonword: true
+ignorecase: true
+tokens:
+  # ==========================================================================
+  # "X lands" — figurative landing of jokes, points, arguments, analogies.
+  # Anchored to a narrow noun list (and to "really/actually lands"). The broad
+  # arrival-verb sense (a request lands on a node, a PR lands in main) lives in
+  # FigurativeLands, which exempts these assessment nouns and literal landings.
+  # ==========================================================================
+  - "[Tt]he (?:joke|point|argument|line|metaphor|analogy|comparison|critique|distinction|observation|framing|insight|takeaway|punchline|callback|bit|reference|callout) (?:really |actually |just |finally )?lands?\\b"
+  - "[Tt]he (?:joke|point|argument|line|metaphor|analogy|comparison|critique|distinction|observation|framing|insight|takeaway|punchline|callback|bit|reference|callout) (?:really|actually|just|finally) landed\\b"
+  - "\\b(?:really|actually) lands\\b"
+  - "\\b(?:really|actually) landed\\b"
+  # Figurative "lands" beyond the curated nouns: abstract subjects and
+  # assessment completions that can't be a literal landing.
+  - "\\bland(?:s|ed)? flat\\b"
+  - "\\bwhere (?:it|this|that|everything|the whole thing) (?:really |finally |ultimately |just |all )?lands?\\b"
+
+  # ==========================================================================
+  # "X is the move" — anchored verdict. Bare "the move" is too broad (chess,
+  # dance, real-estate), so we only catch the assessment shape.
+  # ==========================================================================
+  - "\\bis the move\\b"
+  - "\\bwas the move\\b"
+  - "\\b(?:that|this)'?s the move\\b"
+  - "\\b(?:that|this) is the move\\b"
+  - "\\bthe right move\\b"
+  - "\\bthe smart move\\b"
+  - "\\bthe obvious move\\b"
+  - "\\bthe play here\\b"
+  - "\\bthe move here\\b"
+
+  # ==========================================================================
+  # "What really matters" — the knowing-tone matters phrase. Bare "matters" is
+  # ordinary English; this targets the rhetorical wind-up.
+  # ==========================================================================
+  - "\\bwhat really matters\\b"
+  - "\\bwhat truly matters\\b"
+  - "\\bwhat actually matters\\b"
+  - "\\bwhat genuinely matters\\b"
+  - "\\bwhat matters most\\b"
+  - "\\ball that (?:really |truly |actually )?matters\\b"
+  - "\\bthe only thing that (?:really |truly |actually )?matters\\b"

package/vale/styles/ai-tells/ColonUsage.yml

@@ -0,0 +1,18 @@
+---
+extends: existence
+message: "AI punctuation: '%s'. Lowercase the word after the colon unless it is a proper noun."
+level: error
+nonword: true
+# Replaces Google.Colons, which checks heading text too and flags the title
+# half of "Appendix A: Glossary". Headings are exempt here; everywhere else
+# a capitalized word after a colon is the "Label: Sentence" construction.
+# The lookbehind (from Google's rule) skips a colon preceded by another
+# colon-joined run, so "10:30: Meeting" stays clean. The token also skips
+# acronyms and the pronoun "I", which stay capitalized in any position.
+# Known limitation: Vale strips markup before matching, so a run-in bold
+# label ("**Note:** Like this.") flags too. Disable the rule where that
+# convention is established.
+scope:
+  - "~heading"
+tokens:
+  - "(?<!:[^ ]+?):\\s(?!I\\b)[A-Z][a-z]*\\b"

package/vale/styles/ai-tells/ConclusionMarkers.yml

@@ -0,0 +1,23 @@
+---
+extends: existence
+message: "AI conclusion: '%s'. Delete this and end on your final point."
+level: error
+ignorecase: true
+tokens:
+  - In conclusion
+  - In summary
+  - To summarize
+  - To sum up
+  - To conclude
+  - In closing
+  - Ultimately
+  - All in all
+  - At the end of the day
+  - When all is said and done
+  - The bottom line is
+  - In the final analysis
+  - Taking everything into account
+  - Taking all of this into account
+  - Overall
+  - On the whole
+  - By way of conclusion