ai-text-check 1.0.0

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

@@ -0,0 +1,52 @@
+---
+extends: existence
+message: "AI cross-reference: '%s'. Rewrite the passage to work without the cross-reference."
+level: error
+ignorecase: true
+tokens:
+  - as mentioned above
+  - as mentioned earlier
+  - as mentioned before
+  - as noted above
+  - as noted earlier
+  - as noted before
+  - as discussed above
+  - as discussed earlier
+  - as discussed before
+  - as stated above
+  - as stated earlier
+  - as stated before
+  - as outlined above
+  - as outlined earlier
+  - as described above
+  - as described earlier
+  - as referenced above
+  - as referenced earlier
+  - as we saw
+  - as we saw above
+  - as we saw earlier
+  - as we'll see
+  - as we'll explore
+  - as we'll discuss
+  - as we discussed
+  - as we explored
+  - as we covered
+  - as covered above
+  - as covered earlier
+  - as shown above
+  - as shown earlier
+  - as explained above
+  - as explained earlier
+  - as we noted
+  - recall that
+  - remember that
+  - as previously mentioned
+  - as previously noted
+  - as previously discussed
+  - as previously stated
+  - as previously described
+  - as I mentioned
+  - as I noted
+  - as I discussed
+  - as I said
+  - as I explained

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

@@ -0,0 +1,31 @@
+---
+extends: existence
+message: "AI punctuation: '%s'. Replace the semicolon with a period or two sentences."
+level: error
+nonword: true
+# Semicolons are an em-dash workaround: once the em-dash gets flagged, the agent
+# swaps in a semicolon to tack a punchy clause onto a sentence. Per Google's
+# guidance the legitimate uses nearly always carry a comma (a series of items
+# with their own punctuation, a "; however," join, a complex clause), so the
+# token flags only a comma-free clause-final continuation and exempts the
+# conjunctive adverbs that join clauses without one. Google.Semicolons still
+# warns on the rest.
+exceptions:
+  - "(?i)however"
+  - "(?i)therefore"
+  - "(?i)thus"
+  - "(?i)hence"
+  - "(?i)moreover"
+  - "(?i)furthermore"
+  - "(?i)consequently"
+  - "(?i)nevertheless"
+  - "(?i)nonetheless"
+  - "(?i)otherwise"
+  - "(?i)meanwhile"
+  - "(?i)accordingly"
+  - "(?i)besides"
+  - "(?i)indeed"
+  - "(?i)namely"
+  - "(?i)instead"
+tokens:
+  - "; [^,;\\n]*[.!?]"

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

@@ -0,0 +1,41 @@
+---
+extends: existence
+message: "AI sequencing: '%s'. Use natural transitions or write an actual list."
+level: error
+tokens:
+  - Firstly
+  - Secondly
+  - Thirdly
+  - Fourthly
+  - Fifthly
+  - Lastly
+  - The first takeaway
+  - The second takeaway
+  - The third takeaway
+  - The fourth takeaway
+  - The first lesson
+  - The second lesson
+  - The third lesson
+  - The first key
+  - The second key
+  - The third key
+  - The first thing to note
+  - The second thing to note
+  - The first point
+  - The second point
+  - The third point
+  - The first reason
+  - The second reason
+  - The third reason
+  - The first challenge
+  - The second challenge
+  - The third challenge
+  - The first step is
+  - The second step is
+  - The third step is
+  - The first benefit
+  - The second benefit
+  - The third benefit
+  - The first advantage
+  - The second advantage
+  - The third advantage

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

@@ -0,0 +1,66 @@
+---
+extends: existence
+message: "AI copula dodge: '%s'. Use 'is' or 'are' instead of this inflated construction."
+level: error
+ignorecase: true
+tokens:
+  - serves as a
+  - serves as an
+  - serves as the
+  - served as a
+  - served as an
+  - served as the
+  - serving as a
+  - serving as an
+  - serving as the
+  - stands as a
+  - stands as an
+  - stands as the
+  - stood as a
+  - stood as an
+  - stood as the
+  - standing as a
+  - standing as an
+  - standing as the
+  - marks a pivotal
+  - marks a significant
+  - marks a crucial
+  - marks a key
+  - marks a turning
+  - marks a critical
+  - marks a major
+  - marks a defining
+  - marks a new
+  - represents a significant
+  - represents a pivotal
+  - represents a crucial
+  - represents a key
+  - represents a major
+  - represents a fundamental
+  - represents a paradigm
+  - boasts a vibrant
+  - boasts a rich
+  - boasts a diverse
+  - boasts a wide
+  - boasts a unique
+  - boasts a thriving
+  - boasts an impressive
+  - features a wide
+  - features a rich
+  - features a diverse
+  - features a unique
+  - features a vibrant
+  - offers a unique
+  - offers a wide
+  - offers a comprehensive
+  - offers a diverse
+
+  # === Colon-cheat: copula-replacement remediation ===
+  # AI evades weak-verb / passive-voice lints by replacing "is" or
+  # "are" with a colon — same appositive shape, no verb.
+  # "The candidate mechanism is a hook." -->
+  # "The candidate mechanism: a hook on Bash that..."
+  # Triggered by a 4+ word definite-NP subject, indefinite article
+  # after the colon, and 6+ token descriptive content (filters
+  # short pedagogical "X is: Y" answers).
+  - "The [^,.:!?\\s]+(?: [^,.:!?\\s]+){2,}: an? [^,.:!?\\s]+(?: [^,.:!?\\s]+){4,}"

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

@@ -0,0 +1,16 @@
+---
+extends: existence
+message: "AI overused word: '%s'. Name the specific action or object. Disable this rule for maritime or logistics writing."
+level: error
+nonword: true
+ignorecase: true
+# "Ship" is an AI and startup overuse fingerprint. It covers the release verb
+# ("ship it," "ship fast," "ship the feature") and the maritime clichés ("run a
+# tight ship," "the ship has sailed"). The match stays deliberately broad and
+# carries no exemptions: the logistics verb ("ship the order") and the vessel
+# noun ("a cargo ship") look identical to a regex, so a writer in those domains
+# turns the whole rule off rather than chase a carve-out list. Word boundaries
+# keep the -ship suffixes (relationship, leadership) and the compounds
+# (spaceship, flagship, worship, shipment) clean.
+tokens:
+  - "\\bship(?:s|ped|ping)?\\b"

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

@@ -0,0 +1,185 @@
+---
+extends: existence
+message: "AI anaphora: '%s'. Vary the sentence openings or combine into a single statement."
+level: error
+nonword: true
+tokens:
+  # "No X. No Y. No Z." pattern (3+ consecutive)
+  - "No [^.]+\\. No [^.]+\\. No [^.]+"
+
+  # "No X. No Y." pattern (2 consecutive)
+  - "No \\w[^.]+\\. No \\w[^.]+"
+
+  # "No X, no Y, no Z." pattern (3+ comma-separated)
+  - "No [^,]+, no [^,]+, no [^.!?]+"
+
+  # "No X, no Y." pattern (2 comma-separated)
+  - "No [^,]+, no [^.!?]+"
+
+  # "Not X. Not Y. Not Z." pattern
+  - "Not [^.]+\\. Not [^.]+\\. Not [^.]+"
+
+  # "Not X. Not Y." pattern (2 consecutive)
+  - "Not \\w[^.]+\\. Not \\w[^.]+"
+
+  # "No more X. No more Y. No more Z." pattern
+  - "No more [^.]+\\. No more [^.]+\\. No more [^.]+"
+
+  # "No more X. No more Y." pattern (2 consecutive)
+  - "No more \\w[^.]+\\. No more \\w[^.]+"
+
+  # "It's X. It's Y. It's Z." pattern
+  - "[Ii]t'?s [^.]+\\. [Ii]t'?s [^.]+\\. [Ii]t'?s [^.]+"
+
+  # "This is X. This is Y. This is Z." pattern
+  - "[Tt]his is [^.]+\\. [Tt]his is [^.]+\\. [Tt]his is [^.]+"
+
+  # Three consecutive rhetorical questions
+  - "(?:What|Why|How|Where|When|Who|Which|Is|Are|Can|Could|Should|Would|Do|Does) [^?]+\\? (?:What|Why|How|Where|When|Who|Which|Is|Are|Can|Could|Should|Would|Do|Does) [^?]+\\? (?:What|Why|How|Where|When|Who|Which|Is|Are|Can|Could|Should|Would|Do|Does) [^?]+\\?"
+
+  # "X works because Y. Z works because W." parallel justifications
+  - "[A-Z][^.]+works because [^.]+\\. [A-Z][^.]+works because [^.]+\\. [A-Z][^.]+works because [^.]+"
+
+  # "One X. One Y. One Z." pattern (3+ consecutive)
+  - "One [^.]+\\. One [^.]+\\. One [^.]+"
+
+  # "One X, one Y, one Z." pattern (3+ comma-separated)
+  - "One [^,]+, one [^,]+, one [^.!?]+"
+
+  # "One X, one Y." pattern (2 comma-separated)
+  - "One [^,]+, one [^.!?]+"
+
+  # "Every X. Every Y. Every Z." pattern (3+ consecutive)
+  - "Every [^.]+\\. Every [^.]+\\. Every [^.]+"
+
+  # "Every X, every Y, every Z." pattern (3+ comma-separated)
+  - "Every [^,]+, every [^,]+, every [^.!?]+"
+
+  # "Every X, every Y." pattern (2 comma-separated)
+  - "Every [^,]+, every [^.!?]+"
+
+  # "Each X. Each Y. Each Z." pattern (3+ consecutive)
+  - "Each [^.]+\\. Each [^.]+\\. Each [^.]+"
+
+  # "Each X, each Y, each Z." pattern (3+ comma-separated)
+  - "Each [^,]+, each [^,]+, each [^.!?]+"
+
+  # "Each X, each Y." pattern (2 comma-separated)
+  - "Each [^,]+, each [^.!?]+"
+
+  # "Zero X. Zero Y. Zero Z." pattern (3+ consecutive)
+  - "Zero [^.]+\\. Zero [^.]+\\. Zero [^.]+"
+
+  # "Zero X, zero Y, zero Z." pattern (3+ comma-separated)
+  - "Zero [^,]+, zero [^,]+, zero [^.!?]+"
+
+  # "Zero X, zero Y." pattern (2 comma-separated)
+  - "Zero [^,]+, zero [^.!?]+"
+
+  # "A single X. A single Y." pattern (2+ consecutive)
+  - "A single [^.]+\\. A single [^.]+"
+
+  # "A single X, a single Y." pattern (2+ comma-separated)
+  - "A single [^,]+, a single [^.!?]+"
+
+  # "Many X. Many Y." pattern (2+ consecutive)
+  - "Many [^.]+\\. Many [^.]+\\."
+
+  # "Few X. Few Y." pattern (2+ consecutive)
+  - "Few [^.]+\\. Few [^.]+\\."
+
+  # "All X. All Y. All Z." pattern (3+ consecutive)
+  - "All [^.]+\\. All [^.]+\\. All [^.]+"
+
+  # Three prepositional phrase chains: "with X, through Y, and for Z" style
+  - "(?:with|through|by|for|via|within) [^,]+, (?:with|through|by|for|via|within) [^,]+, (?:and )?(?:with|through|by|for|via|within) [^.!?]+"
+
+  # === Adverb anaphora ===
+
+  # "Always X. Always Y." pattern (2+ consecutive)
+  - "Always [^.]+\\. Always [^.]+\\."
+
+  # "always X, always Y." pattern (2+ comma-separated)
+  - "[Aa]lways [^,]+, always [^.!?]+"
+
+  # "Never X. Never Y." pattern (2+ consecutive)
+  - "Never [^.]+\\. Never [^.]+\\."
+
+  # "never X, never Y." pattern (2+ comma-separated)
+  - "[Nn]ever [^,]+, never [^.!?]+"
+
+  # "Fully X. Fully Y." pattern (2+ consecutive)
+  - "Fully [^.]+\\. Fully [^.]+\\."
+
+  # "fully X, fully Y." pattern (2+ comma-separated)
+  - "[Ff]ully [^,]+, fully [^.!?]+"
+
+  # "Completely X. Completely Y." pattern (2+ consecutive)
+  - "Completely [^.]+\\. Completely [^.]+\\."
+
+  # "completely X, completely Y." pattern (2+ comma-separated)
+  - "[Cc]ompletely [^,]+, completely [^.!?]+"
+
+  # "Entirely X. Entirely Y." pattern (2+ consecutive)
+  - "Entirely [^.]+\\. Entirely [^.]+\\."
+
+  # "entirely X, entirely Y." pattern (2+ comma-separated)
+  - "[Ee]ntirely [^,]+, entirely [^.!?]+"
+
+  # "Truly X. Truly Y." pattern (2+ consecutive)
+  - "Truly [^.]+\\. Truly [^.]+\\."
+
+  # "truly X, truly Y." pattern (2+ comma-separated)
+  - "[Tt]ruly [^,]+, truly [^.!?]+"
+
+  # "Purely X. Purely Y." pattern (2+ consecutive)
+  - "Purely [^.]+\\. Purely [^.]+\\."
+
+  # "purely X, purely Y." pattern (2+ comma-separated)
+  - "[Pp]urely [^,]+, purely [^.!?]+"
+
+  # "Only X. Only Y." pattern (2+ consecutive)
+  - "Only [^.]+\\. Only [^.]+\\."
+
+  # "only X, only Y." pattern (2+ comma-separated)
+  - "[Oo]nly [^,]+, only [^.!?]+"
+
+  # "Just X. Just Y." pattern (2+ consecutive)
+  - "Just [^.]+\\. Just [^.]+\\."
+
+  # "just X, just Y." pattern (2+ comma-separated)
+  - "[Jj]ust [^,]+, just [^.!?]+"
+
+  # === Indefinite-article exemplification stack ===
+  # AI loves stacking hypothetical scenarios as parallel sentences:
+  # "A hook wants to count failures. A subagent wants to record a
+  # result. A skill wants to stash a value." The shape — A/An +
+  # noun (1-3 words) + present-tense verb — paired across 3
+  # sentences is distinctive enough to flag even when verbs differ.
+  - "(?:A|An) \\w+(?: \\w+){0,2} \\w+s [^.]+\\. (?:A|An) \\w+(?: \\w+){0,2} \\w+s [^.]+\\. (?:A|An) \\w+(?: \\w+){0,2} \\w+s [^.!?]+"
+
+  # 2-sentence parallel-mirror pair: "An unset X counts as Y.
+  # A set-but-wrong value belongs to Z." Same A/An + NP + verb-s
+  # shape but paired instead of tripled. Common in technical prose
+  # written by humans too, but the dramatic shared-verb framing
+  # reads as an AI tell in practice.
+  - "(?:A|An) \\w+(?: \\w+){0,2} \\w+s [^.]+\\. (?:A|An) \\w+(?: \\w+){0,2} \\w+s [^.!?]+"
+
+  # === Definite-article noun-list fragment ===
+  # "The X, the Y, the Z." — three or more comma-separated
+  # definite noun phrases as a verbless sentence. AI uses this
+  # as a faux-summary closer. Subjects are up to 5 words to
+  # tolerate parenthetical glosses like "Time-To-Live (TTL)".
+  # Sentence-initial capital "The" reduces mid-sentence
+  # false positives.
+  - "The [\\w-]+(?: [\\w-]+){0,4}(?:, the [\\w-]+(?: [\\w-]+){0,4}){2,}\\."
+
+  # === "Whether X, or whether Y." subordinate-clause fragment ===
+  # AI promotes a "whether... or whether..." subordinate-clause
+  # pair to a standalone sentence with no main clause. The
+  # paired "whether" markers carry the rhetorical weight a real
+  # verb would carry.
+  - "Whether [^.]+, or whether [^.!?]+\\."
+
+  # Two consecutive "Whether X." sentences — same shape, paired.
+  - "Whether [^.]+\\. Whether [^.]+\\."

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

@@ -0,0 +1,32 @@
+---
+extends: existence
+message: "AI strategy buzzword: '%s'. Describe the actual mechanism or advantage plainly."
+level: error
+nonword: true
+ignorecase: true
+# Strategy-deck buzzword metaphors: the flywheel, the moat, the north star. Each
+# term is scoped to its figurative shape so the literal homograph stays clean
+# without a domain toggle (the engine's flywheel, a castle's moat, the actual
+# North Star). Network effects and first-mover advantage are the most legitimate
+# as analytical terms; they are here because the deck-speak form is overused, but
+# they are the first to drop if they fire on genuine analysis.
+tokens:
+  # flywheel (self-reinforcing loop), not the mechanical part
+  - "\\bflywheel effect\\b"
+  - "\\b(?:growth|data|content|engagement|customer|revenue|sales|marketing|business|virtuous|self-?reinforcing) flywheels?\\b"
+  - "\\b(?:build|building|built|create|creates|created|creating|spin|spins|spinning|start|starts|started|starting) (?:a |the |our |its |their )?flywheels?\\b"
+  # moat (competitive advantage), not the castle
+  - "\\b(?:competitive|economic|defensible|durable|structural|wide|deep|business|data|regulatory|technological|distribution) moats?\\b"
+  - "\\b(?:build|building|built|widen|widens|widening|widened|deepen|deepens|deepening|deepened|create|creates|created|creating) (?:a |the |our |its |their |wider |deeper )?moats?\\b"
+  - "\\bmoats? (?:around|against)\\b"
+  # north star (guiding metric), not Polaris
+  - "\\bnorth[- ]star metric\\b"
+  - "\\bnorth-star\\b"
+  - "\\b(?:our|your|their|its) north star\\b"
+  # network effects (econ deck-speak)
+  - "\\bnetwork effects?\\b"
+  # first-mover advantage (cliche form, not bare "first mover")
+  - "\\bfirst[- ]mover advantage\\b"
+  # land grab (figurative), not the historical kind
+  - "\\b(?:market|customer|data|talent|competitive|global|massive|enterprise) land[- ]grab\\b"
+  - "\\bland[- ]grab for\\b"

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

@@ -0,0 +1,22 @@
+---
+extends: existence
+message: "AI structure announcement: '%s'. Present the content instead of narrating that you're about to."
+level: error
+ignorecase: true
+tokens:
+  - key takeaway
+  - key takeaways
+  - the takeaway is
+  - the takeaway here is
+  - main takeaway
+  - main takeaways
+  - quick recap
+  - a quick recap
+  - to recap
+  - to recap briefly
+  - quick summary
+  - a quick summary
+  - quick overview
+  - a quick overview
+  - to put it plainly
+  - to put this in perspective

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

@@ -0,0 +1,26 @@
+---
+extends: existence
+message: "AI sycophancy: '%s'. Delete this. It sounds robotic and insincere."
+level: error
+ignorecase: true
+tokens:
+  - Great question
+  - Excellent question
+  - That's a great question
+  - That's an excellent question
+  - What a great question
+  - Fantastic question
+  - Wonderful question
+  - I'm glad you asked
+  - I'm happy to help
+  - I'd be happy to help
+  - I'd be glad to help
+  - Absolutely
+  - Certainly
+  - Of course
+  - Without a doubt
+  - You're absolutely right
+  - You make an excellent point
+  - That's a wonderful idea
+  - That's a fantastic point
+  - I couldn't agree more

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

@@ -0,0 +1,21 @@
+---
+extends: existence
+message: "AI explainer prompt: '%s'. Explain it directly instead of announcing it."
+level: error
+ignorecase: true
+tokens:
+  - Let's unpack
+  - Let me unpack
+  - Let's break this down
+  - Let me break this down
+  - Let's take a closer look at
+  - Let me take a closer look at
+  - Let's dive into
+  - Let me dive into
+  - Let's walk through
+  - Let me walk through
+  - Let's dig into
+  - Let me dig into
+  - Let's examine
+  - Let me examine
+  - Let's explore

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

@@ -0,0 +1,70 @@
+---
+extends: existence
+message: "AI urgency: '%s'. Delete it or show the stakes concretely."
+level: error
+ignorecase: true
+tokens:
+  # "Cannot be overstated" variants
+  - cannot be overstated
+  - can't be overstated
+  - cannot be understated
+  - can't be understated
+  - cannot be emphasized enough
+  - can't be emphasized enough
+
+  # "More important/critical/relevant than ever" variants
+  - more important than ever
+  - more critical than ever
+  - more relevant than ever
+  - more urgent than ever
+  - more necessary than ever
+  - more essential than ever
+  - more vital than ever
+  - more pressing than ever
+  - more significant than ever
+
+  # "Has never been more X" variants
+  - has never been more important
+  - has never been more critical
+  - has never been more urgent
+  - has never been more relevant
+  - has never been more necessary
+  - has never been more essential
+  - has never been more vital
+  - has never been more pressing
+  - has never been more significant
+  - have never been more important
+  - have never been more critical
+  - have never been more urgent
+  - have never been more relevant
+
+  # "The stakes have never been higher" variants
+  - the stakes have never been higher
+  - the stakes are higher than ever
+  - the stakes couldn't be higher
+  - the stakes are enormous
+  - the stakes are immense
+
+  # "At a crossroads" variants
+  - at a crossroads
+  - at an inflection point
+  - at a pivotal moment
+  - at a critical juncture
+  - at a defining moment
+  - at a turning point in history
+  - at a critical moment in history
+  - at a pivotal moment in history
+
+  # "Increasingly [adjective] world" variants
+  - in an increasingly complex world
+  - in an increasingly digital world
+  - in an increasingly connected world
+  - in an increasingly competitive world
+  - in an increasingly polarized world
+  - in an increasingly uncertain world
+  - in an increasingly fast-paced world
+  - in an increasingly globalized world
+  - in an increasingly data-driven world
+  - in an increasingly automated world
+  - in an ever more complex world
+  - in an ever more connected world

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

@@ -0,0 +1,67 @@
+---
+extends: existence
+message: "AI vague attribution: '%s'. Name the specific source or delete the claim."
+level: error
+ignorecase: true
+tokens:
+  - experts argue
+  - experts suggest
+  - experts believe
+  - experts say
+  - experts agree
+  - experts warn
+  - experts note
+  - experts predict
+  - experts contend
+  - experts recommend
+  - experts have noted
+  - experts have argued
+  - experts have suggested
+  - experts have warned
+  - industry reports suggest
+  - industry reports indicate
+  - industry reports show
+  - industry experts
+  - industry observers
+  - industry analysts
+  - observers have cited
+  - observers have noted
+  - observers note
+  - critics argue
+  - critics suggest
+  - critics contend
+  - critics have noted
+  - critics have argued
+  - some critics argue
+  - some experts argue
+  - some experts suggest
+  - some experts believe
+  - some analysts
+  - some observers
+  - some researchers
+  - many experts
+  - many analysts
+  - many observers
+  - many researchers
+  - studies show that
+  - studies suggest that
+  - studies indicate that
+  - studies have shown that
+  - studies have found that
+  - research shows that
+  - research suggests that
+  - research indicates that
+  - research has shown that
+  - research has found that
+  - several studies
+  - several experts
+  - several analysts
+  - several observers
+  - numerous studies
+  - numerous experts
+  - a growing body of research
+  - a growing body of evidence
+  - a growing number of experts
+  - the evidence suggests
+  - the data suggests
+  - the research suggests