@holdyourvoice/hyv 2.9.28 → 3.0.0

package/assets/ai-eliminator-rules.md

@@ -1,140 +0,0 @@
-# AI Eliminator Rules (v2 — 220+ patterns + structural signals)
-
-Use these rules to remove AI-generated cadence without erasing the writer.
-
-## Core Rule
-
-Fix the exact line that drifted. Do not rewrite a whole draft when one sentence
-is the problem. Preserve clean surrounding lines.
-
-## Detection Coverage
-
-The algorithm now detects 220+ named AI writing patterns organized across 31
-composite regex rules, plus structural/rhythmic analysis of: burstiness
-(sentence length variance), paragraph rhythm uniformity, contraction density,
-formal hedging, generic intensifiers, fragment ratio, over-structured list
-patterns, and uniform sentence rhythm within paragraphs.
-
-## Banned Pattern Categories
-
-### Binary reframing & negation (#1, #210-212)
-- "It's not X, it's Y" / "The point isn't X, it's Y"
-- "You don't need X, you need Y"
-- "Not just X, but Y" / "Not only... but also"
-- **structural cousins (top priority):** cross-sentence forms the vocabulary scan misses:
-  - "This is not X. It is Y." / "Is not X. It is Y."
-  - "You are not X. You are Y." / "You are no longer X. You are Y."
-  - "You stop X. You start Y."
-  - "They don't need X. They need Y."
-  - "They call it X. They call it Y." (staccato anaphora)
-  - Parallel sermon: "X because… / they X because…" and "endure through… / they endure through…"
-  - Founder-carousel metaphors: "competing with the void", "architect of a new reality", "friction into momentum", "cognitive architecture", "defines what good looks like", "the hidden goal", "quiet promise", "simple but uncomfortable:"
-
-**Tier 1 priority:** rules with ids `structural_*` and `founder_*` are primary flags. They sort first in scan output, win hit-budget slots in the editor, weigh heavier in cleanliness scoring, lead rewrite prompts, and gate rewrite output before vocabulary slop.
-
-### Staccato drama (#2, #95, #96)
-- Short punchy sentence runs: "No X. No Y. Just Z."
-- Perfectly even sentence rhythm throughout paragraphs
-- Three short sentences in a row (performance cadence)
-
-### Landscape/era grandstanding (#3, #181-188)
-- "In today's fast-paced world" / "ever-evolving landscape"
-- "Now more than ever" / "as never before"
-- "Has never been more important"
-- "In the digital age" / "new era of X"
-- "The rise of X" / "increasingly + adjective"
-
-### Truth/reality posturing (#22, #110, #161-163)
-- "The truth is" / "the reality is" / "here's the truth"
-- "The harsh/ugly/brutal reality" / "real talk"
-- "Brutal honesty" / "reality check"
-
-### Hedging & non-committal (#4, #53-55, #89, #197-199)
-- "It depends, but" / "no one-size-fits-all"
-- "It can be tempting to" / "you might be tempted to"
-- "In many ways" / "at first it might seem"
-
-### Transitions & balance (#7, #38-40, #81, #91, #203)
-- "On the one hand / on the other hand"
-- "On the flip side" / "that said" / "however"
-- "Moreover / furthermore / in addition" chains
-- "At first glance vs on closer inspection"
-
-### Let's/invitation patterns (#5, #63-65, #80, #127)
-- "Let's dive in" / "let's explore" / "let's break it down"
-- "Delve into" / "dive deeper" / "deep dive"
-- "Navigate the complex landscape"
-
-### Empathy opener (#21, #74-75, #107, #164-165)
-- "It's easy to feel X" / "you're not alone"
-- "You're not imagining it" / "you deserve"
-- "Shouting into the void"
-
-### Founder/thought-leader cadence (#72-73, #104-109)
-- "Here's the thing" / "and honestly?"
-- "Here's the kicker" / "the part most people miss"
-- "What nobody's saying" / "the best part?"
-- "Same X. Better Y." / "the moment X becomes Y"
-
-### Marketing verbs (#61-62, #83, #114-117, #145-150)
-- "Unlock the power of" / "harness the power of"
-- "Transform/elevate/take to the next level"
-- "Master the art of" / "game-changer"
-- "Supercharge / turbocharge / on steroids"
-
-### Journey/destination clichés (#59, #84, #122, #144, #214-215)
-- "X isn't a destination; it's a journey"
-- "No matter where you are on your journey"
-- "Embark on" / "you're still early" / "it's still day one"
-
-### Metaphor clusters (#18, #120-121, #159-160, #167-168, #173-180)
-- "Beacon / lighthouse / tapestry / symphony / tides"
-- "Silent killer / hidden gem / tip of the iceberg"
-- "North star / double-edged sword / blessing and a curse"
-- "Noise vs signal" / "X is the new Y"
-- "Flood / avalanche / tsunami of X"
-
-### Guide/article framing (#11-13, #27-28, #136-138)
-- "You're in the right place" / "here's a step-by-step guide"
-- "First, second, third" / "key takeaways" / "actionable tips"
-- "In this article/guide/post" / "this piece explores"
-
-### Wrapping/closing (#9, #14-15, #51-52, #66, #93, #103, #189, #217)
-- "At the end of the day" / "the bottom line is"
-- "In conclusion / in summary / to recap"
-- "Let that sink in" / "only time will tell"
-- "Curious what others think" / "let me know if you need help"
-
-### UX/business buzzwords (#92, #123-126, #155-157)
-- "Robust, scalable, innovative, impactful"
-- "Seamless experience" / "frictionless journey"
-- "Pain points" / "wealth of insights"
-
-### Story/temporal templates (#17, #32-33, #113, #216, #218-219)
-- "Imagine this / picture this"
-- "Storytelling has been around for centuries"
-- "Little did I know" / "at first I was skeptical"
-- "The best time was X, the second-best time is now"
-
-## Structural Signals (Beyond Individual Words)
-
-- **Low burstiness**: Sentence lengths all similar (coefficient of variation < 0.35)
-- **Mechanical paragraphs**: All paragraphs nearly identical sentence count
-- **Over-structured lists**: Rigid 3-item lists throughout
-- **Uniform paragraph rhythm**: Most sentences fall in 12-22 word range
-- **Low contractions**: < 0.8 contractions per 100 words (overly formal)
-- **Formal hedging density**: 2+ institutional hedging phrases
-- **Generic intensifiers**: 3+ "remarkably/incredibly/amazingly" instances
-- **No fragments**: Zero sentence fragments in 20+ sentences (over-polished)
-
-## What To Do Instead
-
-- Start from rough private-note material: an exact edit, meeting fragment,
-  dashboard annoyance, customer confusion, half-remembered sentence, or internal
-  contradiction.
-- Let the idea move because the logic moves, not because line breaks perform.
-- Prefer concrete scenes, mechanisms, quoted language, and specific stakes.
-- Let some pieces end on a detail, hesitation, unresolved thought, or awkwardly
-  specific observation.
-- If a line sounds like a maxim, a carousel, or a model trying to be sharp,
-  make it plainer and more grounded.

package/assets/chatgpt-instructions.txt

@@ -1,8 +0,0 @@
-when i ask you to "write in my voice" or "rewrite this in my voice":
-
-- read `~/.hyv/voice.md` for my voice profile
-- run `hyv rewrite --text "<text>"` to get the structured prompt
-- execute the prompt and rewrite the text
-- match my rhythm, vocabulary, and patterns exactly
-- never use words i avoid
-- present the rewritten version

package/assets/detection-rules.json

@@ -1,18 +0,0 @@
-{
-  "version": "1.0.0",
-  "engine": "node",
-  "source": "cli/src/lib/signals.ts",
-  "updated": "2026-06-12",
-  "categories": {
-    "ai-slop": { "description": "Dead AI language and overused words", "severity_default": "red" },
-    "voice-drift": { "description": "Hedging, generic openers, voice drift", "severity_default": "yellow" },
-    "structure": { "description": "Formulaic structure and antithesis tells", "severity_default": "yellow" },
-    "cadence": { "description": "Sentence rhythm violations", "severity_default": "yellow" },
-    "learned": { "description": "User-specific learned patterns", "severity_default": "yellow" },
-    "engagement-bait": { "description": "Engagement bait patterns", "severity_default": "red" },
-    "ai-cringe": { "description": "AI cringe phrases", "severity_default": "yellow" },
-    "insider-claim": { "description": "Insider knowledge claims", "severity_default": "yellow" }
-  },
-  "pattern_count": 220,
-  "notes": "Node signals.ts is canonical for npm package. Server syncs this manifest; supplemental rules may ship in ~/.hyv/cache/supplemental-rules.json"
-}

package/assets/economic-drift-voice.md

@@ -1,42 +0,0 @@
-# Economic Drift Voice
-
-Economic Drift is the default Shashank voice profile when the user asks for
-"my voice" and no fresher project samples are available. Do not force it onto a
-different writer when their own samples exist.
-
-## Philosophy
-
-High-signal, low-friction writing. The reader should get a lot without working
-hard. The tone feels like a private conversation with someone smart, slightly
-cynical, and not performing for approval.
-
-## Style
-
-- Open with a concrete observation, moment, mechanism, or pattern.
-- Avoid lesson openers, question openers, inspirational claims, and generic
-  category summaries.
-- Use contrarian tension only when the real point is uncomfortable, not for
-  cheap shock.
-- Mix simple language with dense thinking.
-- Let sentence length vary naturally. No theatrical staccato.
-- Favor rough private-note texture: exact edits, customer confusion, dashboard
-  annoyances, meeting fragments, internal contradictions.
-- Do not turn every piece into a tidy lesson. Some endings should stop on a
-  detail or unresolved thought.
-- Use lowercase when writing in Shashank's deliberate social-writing style,
-  unless the user or target format asks otherwise.
-
-## Hard Bans
-
-- `here's the thing`
-- `let's be honest`
-- `at the end of the day`
-- `which is another way of saying`
-- `in other words`
-- `the moment x becomes y`
-- `same x. better y.`
-- motivational poster energy
-- screenshot-ready punchline cadence
-- generic founder advice
-- bullets, hashtags, emojis, and bold emphasis in social prose unless requested
-

package/assets/voice-dna-template.md

@@ -1,88 +0,0 @@
-# Voice DNA
-
-## Writing Rules
-- Write like a sharp human, not a language model.
-- Use contractions naturally (don't, can't, won't).
-- Short paragraphs. 1-3 sentences max.
-- Get to the point. No throat-clearing, no preamble.
-- If making a claim, be specific. Use numbers, names, concrete details.
-- Vary sentence length. Mix short punchy lines with longer ones.
-- Use natural transitions, not mechanical ones ("Furthermore," "Additionally").
-- When uncertain, say so plainly ("I think," "probably," "kinda"). Hedging is human.
-- Never pad output to seem more thorough. Shorter and accurate beats longer and fluffy.
-- Use physical verbs for abstract processes: "sanded down" not "improved," "bolted on" not "added," "stripped back" not "simplified."
-- Humor comes from specificity, not from jokes. Be unexpectedly precise.
-- Parenthetical asides are good. Use them for editorial commentary, honest reactions, quick tangents, and deflating your own seriousness (like this).
-- Write the way you talk. Naturally.
-- Use short words, short sentences, short paragraphs.
-- Never use jargon. Pretend the reader is smart but unfamiliar with the topic.
-- Read every sentence aloud in your head. If you'd stumble saying it, rewrite it.
-- Be crystal clear about what you want the reader to do next.
-
-## Formatting Rules
-- Short paragraphs (1-2 sentences default, 3 max).
-- Numbers as digits.
-- Contractions always.
-- NO em dashes ever. Use commas, periods, colons, semicolons, or parentheses.
-- Bold sparingly, 1-2 key moments per section.
-- Code blocks for specific prompts, commands, or tool outputs.
-
-## Banned Phrases
-
-### Dead AI Language
-- "In today's [anything]..."
-- "It's important to note that..." / "It's worth noting..."
-- "Delve" / "Dive into" / "Unpack"
-- "Harness" / "Leverage" / "Utilize"
-- "Landscape" / "Realm" / "Robust"
-- "Game-changer" / "Cutting-edge" / "State-of-the-art"
-- "Straightforward"
-- "I'd be happy to help"
-- "In order to"
-
-### Dead Transitions
-- "Furthermore" / "Additionally" / "Moreover"
-- "Moving forward" / "At the end of the day"
-- "To put this in perspective..."
-- "What makes this particularly interesting is..."
-- "The implications here are..."
-- "In other words..."
-- "It goes without saying..."
-
-### Engagement Bait
-- "Let that sink in" / "Read that again" / "Full stop"
-- "This changes everything"
-- "Are you paying attention?"
-- "You're not ready for this"
-
-### AI Cringe
-- "Supercharge" / "Unlock" / "Future-proof"
-- "10x your productivity"
-- "The AI revolution"
-- "In the age of AI"
-
-### Generic Insider Claims
-- "Here's the part nobody's talking about"
-- "What nobody tells you"
-- Anything with "nobody" or "most people don't realize"
-
-### The Big One (FATAL)
-- "This isn't X. This is Y." and ALL variations.
-- "Not X. Y."
-- "Forget X. This is Y."
-- "Less X, more Y."
-- ANY sentence that negates one framing then asserts a corrected one.
-- If even ONE of these appears, the output fails. Delete the negation, just state the positive claim.
-
-### Business Jargon (Ogilvy Rule)
-- "Utilize" / "Leverage" / "Synergy"
-- "Circle back" / "Touch base" / "Take it offline"
-- "Low-hanging fruit" / "Move the needle" / "Bandwidth"
-- "Deep dive" / "Boil the ocean"
-
-## Writing Samples
-
-<!-- Paste your writing here. The more you give, the better the voice match.
-     Google docs, emails, blog posts, Slack messages, reports.
-     Pre-AI writing is best — your voice before it blended with AI defaults. -->
-

package/assets/voice-profile-schema.json

@@ -1,28 +0,0 @@
-{
-  "profile_version": "hold-your-voice-portable-v1",
-  "name": "project voice",
-  "source_count": 0,
-  "word_count": 0,
-  "sentence": {
-    "avg_words": 0,
-    "variance": "medium"
-  },
-  "paragraph": {
-    "avg_sentences": 0
-  },
-  "signature": {
-    "case_style": "mixed",
-    "argument_pattern": "mixed",
-    "opening_moves": [],
-    "cadence": [],
-    "anchors": [],
-    "never_list": []
-  },
-  "voice_rules": [],
-  "ai_eliminator": {
-    "rewrite_scope": "flagged-lines-only",
-    "preserve_surrounding_lines": true,
-    "avoid_polished_founder_cadence": true
-  }
-}
-