@holdyourvoice/hyv 2.2.0 → 2.3.0

package/assets/voice-dna-template.md

@@ -0,0 +1,88 @@
+# 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/dist/index.js

@@ -5062,6 +5062,164 @@ var require_open = __commonJS({
   }
 });
 
+// src/lib/patterns.ts
+function scanLine(line, lineNum, filePath) {
+  const findings = [];
+  for (const pat of ALL_PATTERNS) {
+    pat.regex.lastIndex = 0;
+    let match2;
+    while ((match2 = pat.regex.exec(line)) !== null) {
+      findings.push({
+        file: filePath,
+        line: lineNum,
+        column: match2.index + 1,
+        pattern: pat.id,
+        category: pat.category,
+        severity: pat.severity,
+        excerpt: highlightMatch(line.trim(), match2.index, match2[0].length),
+        suggestion: pat.suggestion
+      });
+    }
+  }
+  return findings;
+}
+function highlightMatch(line, start, len) {
+  const before = line.slice(0, start);
+  const match2 = line.slice(start, start + len);
+  const after = line.slice(start + len);
+  return `${before}\xAB${match2}\xBB${after}`.slice(0, 120);
+}
+var AI_OVERUSED, FORMULAIC, HEDGING, STRUCTURE, ENGAGEMENT_BAIT, AI_CRINGE, INSIDER_CLAIMS, FORMATTING, OGILVY, ALL_PATTERNS;
+var init_patterns = __esm({
+  "src/lib/patterns.ts"() {
+    "use strict";
+    AI_OVERUSED = [
+      { id: "ai.delve", category: "ai-slop", severity: "red", regex: /\bdelve\b/gi, suggestion: "use a specific verb: dig, explore, look at" },
+      { id: "ai.leverage", category: "ai-slop", severity: "red", regex: /\bleverage\b/gi, suggestion: "use: use, apply, build on" },
+      { id: "ai.utilize", category: "ai-slop", severity: "red", regex: /\butilize\b/gi, suggestion: "use: use" },
+      { id: "ai.tapestry", category: "ai-slop", severity: "red", regex: /\btapestry\b/gi, suggestion: "be specific about what you mean" },
+      { id: "ai.holistic", category: "ai-slop", severity: "red", regex: /\bholistic\b/gi, suggestion: "describe the actual approach" },
+      { id: "ai.robust", category: "ai-slop", severity: "yellow", regex: /\brobust\b/gi, suggestion: "say what actually makes it strong" },
+      { id: "ai.pivotal", category: "ai-slop", severity: "yellow", regex: /\bpivotal\b/gi, suggestion: "say why it matters specifically" },
+      { id: "ai.foster", category: "ai-slop", severity: "yellow", regex: /\bfoster\b/gi, suggestion: "use: build, grow, encourage, support" },
+      { id: "ai.harness", category: "ai-slop", severity: "yellow", regex: /\bharness\b/gi, suggestion: "use: use, apply, work with" },
+      { id: "ai.illuminate", category: "ai-slop", severity: "yellow", regex: /\billuminate\b/gi, suggestion: "use: show, explain, highlight" },
+      { id: "ai.ever-evolving", category: "ai-slop", severity: "red", regex: /\b(?:ever[\s-]evolving|ever[\s-]changing)\b/gi, suggestion: "cut this \u2014 it says nothing" },
+      { id: "ai.fast-paced", category: "ai-slop", severity: "red", regex: /\bfast[\s-]paced\b/gi, suggestion: "cut this \u2014 every industry says this" },
+      { id: "ai.game-changer", category: "ai-slop", severity: "red", regex: /\bgame[\s-]changer\b/gi, suggestion: "explain what actually changed" },
+      { id: "ai.paradigm", category: "ai-slop", severity: "red", regex: /\bparadigm\b/gi, suggestion: "describe the actual shift" },
+      { id: "ai.synergy", category: "ai-slop", severity: "red", regex: /\bsynergy\b/gi, suggestion: "describe what works together and why" },
+      { id: "ai.ecosystem", category: "ai-slop", severity: "yellow", regex: /\becosystem\b/gi, suggestion: "name the specific tools/partners/platforms" },
+      { id: "ai.seamless", category: "ai-slop", severity: "yellow", regex: /\bseamless\b/gi, suggestion: "describe how it actually works" },
+      { id: "ai.actionable", category: "ai-slop", severity: "yellow", regex: /\bactionable\b/gi, suggestion: "just give the action, don't label it" },
+      { id: "ai.granular", category: "ai-slop", severity: "yellow", regex: /\bgranular\b/gi, suggestion: "say: specific, detailed, or name the level" },
+      { id: "ai.impactful", category: "ai-slop", severity: "yellow", regex: /\bimpactful\b/gi, suggestion: "describe the actual impact" },
+      { id: "ai.landscape", category: "ai-slop", severity: "red", regex: /\blandscape\b/gi, suggestion: "name the specific market/field/area" },
+      { id: "ai.realm", category: "ai-slop", severity: "red", regex: /\brealm\b/gi, suggestion: "name the specific domain" },
+      { id: "ai.straightforward", category: "ai-slop", severity: "yellow", regex: /\bstraightforward\b/gi, suggestion: "just explain it directly" }
+    ];
+    FORMULAIC = [
+      { id: "formula.firstly", category: "ai-slop", severity: "yellow", regex: /\bfirstly\b/gi, suggestion: 'just start \u2014 "firstly" is filler' },
+      { id: "formula.secondly", category: "ai-slop", severity: "yellow", regex: /\bsecondly\b/gi, suggestion: 'just continue \u2014 "secondly" is filler' },
+      { id: "formula.lastly", category: "ai-slop", severity: "yellow", regex: /\blastly\b/gi, suggestion: 'just end \u2014 "lastly" is filler' },
+      { id: "formula.moreover", category: "ai-slop", severity: "yellow", regex: /\bmoreover\b/gi, suggestion: "just add the point" },
+      { id: "formula.furthermore", category: "ai-slop", severity: "yellow", regex: /\bfurthermore\b/gi, suggestion: "just add the point" },
+      { id: "formula.in-conclusion", category: "ai-slop", severity: "red", regex: /\bin conclusion\b/gi, suggestion: "just end. readers know it's the end." },
+      { id: "formula.in-summary", category: "ai-slop", severity: "red", regex: /\bin summary\b/gi, suggestion: "just summarize. the label is redundant." },
+      { id: "formula.it-is-important", category: "ai-slop", severity: "yellow", regex: /\bit is important to note\b/gi, suggestion: "just note it. skip the preamble." },
+      { id: "formula.at-the-end", category: "ai-slop", severity: "yellow", regex: /\bat the end of the day\b/gi, suggestion: "cut this \u2014 it means nothing" },
+      { id: "formula.needless-to-say", category: "ai-slop", severity: "yellow", regex: /\bneedless to say\b/gi, suggestion: "if it's needless, don't say it" },
+      { id: "formula.it-goes-without", category: "ai-slop", severity: "yellow", regex: /\bit goes without saying\b/gi, suggestion: "then don't say it" },
+      { id: "formula.in-today", category: "ai-slop", severity: "red", regex: /\bin today'?s\b/gi, suggestion: "start with your actual point instead" },
+      { id: "formula.lets-dive", category: "ai-slop", severity: "red", regex: /\blet'?s (?:dive|jump|dig|delve)\b/gi, suggestion: "just start. no diving needed." },
+      { id: "formula.without-further", category: "ai-slop", severity: "red", regex: /\bwithout further ado\b/gi, suggestion: "cut this \u2014 just get to it" },
+      { id: "formula.its-worth-noting", category: "ai-slop", severity: "yellow", regex: /\bit'?s worth noting\b/gi, suggestion: "just note it directly" },
+      { id: "formula.moving-forward", category: "ai-slop", severity: "yellow", regex: /\bmoving forward\b/gi, suggestion: "just say what happens next" },
+      { id: "formula.to-put-in-perspective", category: "ai-slop", severity: "yellow", regex: /\bto put this in perspective\b/gi, suggestion: "just give the perspective directly" },
+      { id: "formula.what-makes-interesting", category: "ai-slop", severity: "yellow", regex: /\bwhat makes this particularly interesting\b/gi, suggestion: "just say the interesting thing" },
+      { id: "formula.implications", category: "ai-slop", severity: "yellow", regex: /\bthe implications here are\b/gi, suggestion: "state the implications directly" },
+      { id: "formula.in-other-words", category: "ai-slop", severity: "red", regex: /\bin other words\b/gi, suggestion: "say it once, well" }
+    ];
+    HEDGING = [
+      { id: "hedge.some-might", category: "voice-drift", severity: "yellow", regex: /\bsome might say\b/gi, suggestion: "commit to the claim or drop it" },
+      { id: "hedge.arguably", category: "voice-drift", severity: "yellow", regex: /\barguably\b/gi, suggestion: "commit. say it or don't." },
+      { id: "hedge.worth-noting", category: "voice-drift", severity: "yellow", regex: /\bit'?s worth noting\b/gi, suggestion: "just note it directly" },
+      { id: "hedge.to-some-extent", category: "voice-drift", severity: "yellow", regex: /\bto some extent\b/gi, suggestion: "be specific about the extent" },
+      { id: "hedge.perhaps", category: "voice-drift", severity: "yellow", regex: /\bperhaps\b/gi, suggestion: "commit or cut" },
+      { id: "hedge.it-seems", category: "voice-drift", severity: "yellow", regex: /\bit seems\b/gi, suggestion: "state it directly" }
+    ];
+    STRUCTURE = [
+      { id: "struct.antithesis", category: "structure", severity: "yellow", regex: /\bnot (?:just|only) .{3,50}, but .{3,50}/gi, suggestion: "this antithesis pattern is an AI tell \u2014 restructure" },
+      { id: "struct.more-than-just", category: "structure", severity: "yellow", regex: /\bmore than just\b/gi, suggestion: "say what it IS, not what it isn't" },
+      { id: "struct.in-order-to", category: "structure", severity: "yellow", regex: /\bin order to\b/gi, suggestion: 'just use "to"' },
+      { id: "struct.due-to-the-fact", category: "structure", severity: "yellow", regex: /\bdue to the fact that\b/gi, suggestion: 'use "because"' },
+      { id: "struct.for-the-purpose", category: "structure", severity: "yellow", regex: /\bfor the purpose of\b/gi, suggestion: 'use "to"' },
+      { id: "struct.which-is-another", category: "structure", severity: "red", regex: /\bwhich is another way of saying\b/gi, suggestion: "just say the thing directly" },
+      { id: "struct.this-is-why", category: "structure", severity: "yellow", regex: /\bthis is (?:also )?(?:why|how|where|what\b)/gi, suggestion: "signpost claims are AI tells \u2014 just make the point" },
+      { id: "struct.heres-where", category: "structure", severity: "yellow", regex: /\bhere'?s (?:where|why|what|the part|the (?:harder|real|actual|main|bigger) problem)\b/gi, suggestion: "just make the point without the signpost" },
+      { id: "struct.rhetorical-truth", category: "structure", severity: "yellow", regex: /\b(?:the\s+)?(?:uncomfortable|hard|harsh|brutal|real|honest)\s+(?:truth|reality)\b/gi, suggestion: "state the fact directly, skip the framing" },
+      { id: "struct.lesson-setup", category: "structure", severity: "yellow", regex: /\bhere'?s what .{3,60} taught\b/gi, suggestion: "just share the lesson" },
+      // THE BIG ONE — antithesis negation pattern (Voice DNA: FATAL)
+      { id: "struct.this-isnt-x-this-is-y", category: "structure", severity: "red", regex: /\bthis isn'?t .{2,40}\.?\s*(?:this is|it'?s) .{2,40}/gi, suggestion: "FATAL: delete the negation, just state the positive claim" },
+      { id: "struct.not-x-y", category: "structure", severity: "red", regex: /\bnot .{2,30}\.?\s*.{2,30}\b/gi, suggestion: 'the "Not X. Y." pattern is an AI tell \u2014 just state Y' },
+      { id: "struct.forget-x", category: "structure", severity: "red", regex: /\bforget .{2,40}\.?\s*(?:this is|it'?s|you need)/gi, suggestion: "don't negate \u2014 just state what you mean" }
+    ];
+    ENGAGEMENT_BAIT = [
+      { id: "bait.let-that-sink", category: "engagement-bait", severity: "red", regex: /\blet that sink in\b/gi, suggestion: "cut the sink. make your point and move on." },
+      { id: "bait.read-that-again", category: "engagement-bait", severity: "red", regex: /\bread that again\b/gi, suggestion: "if it needs repeating, repeat it yourself" },
+      { id: "bait.full-stop", category: "engagement-bait", severity: "red", regex: /\bfull stop\b/gi, suggestion: "the period already does this job" },
+      { id: "bait.this-changes-everything", category: "engagement-bait", severity: "red", regex: /\bthis changes everything\b/gi, suggestion: "prove it with specifics" },
+      { id: "bait.paying-attention", category: "engagement-bait", severity: "red", regex: /\bare you paying attention\b/gi, suggestion: "don't patronize the reader" },
+      { id: "bait.not-ready", category: "engagement-bait", severity: "red", regex: /\byou'?re not ready for this\b/gi, suggestion: "just deliver the content" }
+    ];
+    AI_CRINGE = [
+      { id: "cringe.supercharge", category: "ai-cringe", severity: "red", regex: /\bsupercharge\b/gi, suggestion: "describe what it actually does" },
+      { id: "cringe.unlock", category: "ai-cringe", severity: "yellow", regex: /\bunlock\b/gi, suggestion: "describe what they get access to" },
+      { id: "cringe.future-proof", category: "ai-cringe", severity: "red", regex: /\bfuture[\s-]proof\b/gi, suggestion: "explain what specifically makes it durable" },
+      { id: "cringe.10x", category: "ai-cringe", severity: "red", regex: /\b10x\b/gi, suggestion: "use the actual numbers" },
+      { id: "cringe.ai-revolution", category: "ai-cringe", severity: "red", regex: /\bthe ai revolution\b/gi, suggestion: "describe the specific change" },
+      { id: "cringe.age-of-ai", category: "ai-cringe", severity: "red", regex: /\bin the age of ai\b/gi, suggestion: "just talk about what's happening now" },
+      { id: "cringe.happy-to-help", category: "ai-cringe", severity: "red", regex: /\bi'?d be happy to help\b/gi, suggestion: "just help. don't announce it." }
+    ];
+    INSIDER_CLAIMS = [
+      { id: "insider.nobody-talking", category: "insider-claim", severity: "red", regex: /\bhere'?s the part nobody'?s? talking about\b/gi, suggestion: "just say the thing. the framing is noise." },
+      { id: "insider.nobody-tells", category: "insider-claim", severity: "red", regex: /\bwhat nobody tells you\b/gi, suggestion: "just tell them." },
+      { id: "insider.most-people", category: "insider-claim", severity: "yellow", regex: /\bmost people don'?t realize\b/gi, suggestion: "just explain it. skip the setup." },
+      { id: "insider.nobody-realizes", category: "insider-claim", severity: "red", regex: /\bnobody (?:realizes|talks about|mentions)\b/gi, suggestion: "if nobody talks about it, just talk about it" }
+    ];
+    FORMATTING = [
+      { id: "format.em-dash", category: "formatting", severity: "red", regex: /\u2014/g, suggestion: "NO em dashes. use commas, periods, colons, semicolons, or parentheses." }
+    ];
+    OGILVY = [
+      // Jargon — words that hide lack of understanding
+      { id: "ogilvy.jargon-utilize", category: "ai-slop", severity: "red", regex: /\butilize[sd]?\b/gi, suggestion: 'Ogilvy: use "use" instead' },
+      { id: "ogilvy.jargon-leverage", category: "ai-slop", severity: "red", regex: /\bleverage[ds]?\b/gi, suggestion: "Ogilvy: say what you actually mean" },
+      { id: "ogilvy.jargon-synergy", category: "ai-slop", severity: "red", regex: /\bsynerg(?:y|ies|istic)\b/gi, suggestion: "Ogilvy: describe what works together and why" },
+      { id: "ogilvy.jargon-bandwidth", category: "ai-slop", severity: "yellow", regex: /\bbandwidth\b/gi, suggestion: 'Ogilvy: say "time" or "capacity"' },
+      { id: "ogilvy.jargon-circle-back", category: "ai-slop", severity: "red", regex: /\bcircle back\b/gi, suggestion: 'Ogilvy: say "follow up" or "talk later"' },
+      { id: "ogilvy.jargon-low-hanging", category: "ai-slop", severity: "red", regex: /\blow-hanging fruit\b/gi, suggestion: "Ogilvy: name the specific easy win" },
+      { id: "ogilvy.jargon-move-the-needle", category: "ai-slop", severity: "red", regex: /\bmove the needle\b/gi, suggestion: "Ogilvy: describe the actual impact" },
+      { id: "ogilvy.jargon-touch-base", category: "ai-slop", severity: "red", regex: /\btouch base\b/gi, suggestion: 'Ogilvy: say "talk" or "meet"' },
+      { id: "ogilvy.jargon-take-it-offline", category: "ai-slop", severity: "red", regex: /\btake it offline\b/gi, suggestion: 'Ogilvy: say "discuss later"' },
+      { id: "ogilvy.jargon-deep-dive", category: "ai-slop", severity: "yellow", regex: /\bdeep dive\b/gi, suggestion: 'Ogilvy: say "look closely at" or "examine"' },
+      // Throat-clearing openers
+      { id: "ogilvy.preamble-i-want-to", category: "voice-drift", severity: "yellow", regex: /^\s*i want to (?:share|talk about|discuss|mention)\b/gi, suggestion: "Ogilvy: just say it. skip the preamble." },
+      { id: "ogilvy.preamble-just-wanted", category: "voice-drift", severity: "yellow", regex: /^\s*(?:i just wanted|i wanted to)\b/gi, suggestion: "Ogilvy: just say it." }
+    ];
+    ALL_PATTERNS = [
+      ...AI_OVERUSED,
+      ...FORMULAIC,
+      ...HEDGING,
+      ...STRUCTURE,
+      ...ENGAGEMENT_BAIT,
+      ...AI_CRINGE,
+      ...INSIDER_CLAIMS,
+      ...FORMATTING,
+      ...OGILVY
+    ];
+  }
+});
+
 // src/lib/api.ts
 var api_exports = {};
 __export(api_exports, {
@@ -11376,87 +11534,6 @@ var init_esm6 = __esm({
   }
 });
 
-// src/lib/patterns.ts
-function scanLine(line, lineNum, filePath) {
-  const findings = [];
-  for (const pat of ALL_PATTERNS) {
-    pat.regex.lastIndex = 0;
-    let match2;
-    while ((match2 = pat.regex.exec(line)) !== null) {
-      findings.push({
-        file: filePath,
-        line: lineNum,
-        column: match2.index + 1,
-        pattern: pat.id,
-        category: pat.category,
-        severity: pat.severity,
-        excerpt: highlightMatch2(line.trim(), match2.index, match2[0].length),
-        suggestion: pat.suggestion
-      });
-    }
-  }
-  return findings;
-}
-function highlightMatch2(line, start, len) {
-  const before = line.slice(0, start);
-  const match2 = line.slice(start, start + len);
-  const after = line.slice(start + len);
-  return `${before}\xAB${match2}\xBB${after}`.slice(0, 120);
-}
-var AI_OVERUSED2, FORMULAIC2, HEDGING2, STRUCTURE2, ALL_PATTERNS;
-var init_patterns = __esm({
-  "src/lib/patterns.ts"() {
-    "use strict";
-    AI_OVERUSED2 = [
-      { id: "ai.delve", category: "ai-slop", severity: "red", regex: /\bdelve\b/gi, suggestion: "use a specific verb: dig, explore, look at" },
-      { id: "ai.leverage", category: "ai-slop", severity: "red", regex: /\bleverage\b/gi, suggestion: "use: use, apply, build on" },
-      { id: "ai.tapestry", category: "ai-slop", severity: "red", regex: /\btapestry\b/gi, suggestion: "be specific about what you mean" },
-      { id: "ai.holistic", category: "ai-slop", severity: "red", regex: /\bholistic\b/gi, suggestion: "describe the actual approach" },
-      { id: "ai.robust", category: "ai-slop", severity: "yellow", regex: /\brobust\b/gi, suggestion: "say what actually makes it strong" },
-      { id: "ai.pivotal", category: "ai-slop", severity: "yellow", regex: /\bpivotal\b/gi, suggestion: "say why it matters specifically" },
-      { id: "ai.foster", category: "ai-slop", severity: "yellow", regex: /\bfoster\b/gi, suggestion: "use: build, grow, encourage, support" },
-      { id: "ai.harness", category: "ai-slop", severity: "yellow", regex: /\bharness\b/gi, suggestion: "use: use, apply, work with" },
-      { id: "ai.illuminate", category: "ai-slop", severity: "yellow", regex: /\billuminate\b/gi, suggestion: "use: show, explain, highlight" },
-      { id: "ai.ever-evolving", category: "ai-slop", severity: "red", regex: /\b(?:ever[\s-]evolving|ever[\s-]changing)\b/gi, suggestion: "cut this \u2014 it says nothing" },
-      { id: "ai.fast-paced", category: "ai-slop", severity: "red", regex: /\bfast[\s-]paced\b/gi, suggestion: "cut this \u2014 every industry says this" },
-      { id: "ai.game-changer", category: "ai-slop", severity: "red", regex: /\bgame[\s-]changer\b/gi, suggestion: "explain what actually changed" },
-      { id: "ai.paradigm", category: "ai-slop", severity: "red", regex: /\bparadigm\b/gi, suggestion: "describe the actual shift" },
-      { id: "ai.synergy", category: "ai-slop", severity: "red", regex: /\bsynergy\b/gi, suggestion: "describe what works together and why" },
-      { id: "ai.ecosystem", category: "ai-slop", severity: "yellow", regex: /\becosystem\b/gi, suggestion: "name the specific tools/partners/platforms" },
-      { id: "ai.seamless", category: "ai-slop", severity: "yellow", regex: /\bseamless\b/gi, suggestion: "describe how it actually works" },
-      { id: "ai.actionable", category: "ai-slop", severity: "yellow", regex: /\bactionable\b/gi, suggestion: "just give the action, don't label it" },
-      { id: "ai.granular", category: "ai-slop", severity: "yellow", regex: /\bgranular\b/gi, suggestion: "say: specific, detailed, or name the level" },
-      { id: "ai.impactful", category: "ai-slop", severity: "yellow", regex: /\bimpactful\b/gi, suggestion: "describe the actual impact" }
-    ];
-    FORMULAIC2 = [
-      { id: "formula.firstly", category: "ai-slop", severity: "yellow", regex: /\bfirstly\b/gi, suggestion: 'just start \u2014 "firstly" is filler' },
-      { id: "formula.in-conclusion", category: "ai-slop", severity: "red", regex: /\bin conclusion\b/gi, suggestion: "just end. readers know it's the end." },
-      { id: "formula.it-is-important", category: "ai-slop", severity: "yellow", regex: /\bit is important to note\b/gi, suggestion: "just note it. skip the preamble." },
-      { id: "formula.at-the-end", category: "ai-slop", severity: "yellow", regex: /\bat the end of the day\b/gi, suggestion: "cut this \u2014 it means nothing" },
-      { id: "formula.needless-to-say", category: "ai-slop", severity: "yellow", regex: /\bneedless to say\b/gi, suggestion: "if it's needless, don't say it" },
-      { id: "formula.it-goes-without", category: "ai-slop", severity: "yellow", regex: /\bit goes without saying\b/gi, suggestion: "then don't say it" },
-      { id: "formula.in-today", category: "ai-slop", severity: "red", regex: /\bin today'?s\b/gi, suggestion: "start with your actual point instead" },
-      { id: "formula.lets-dive", category: "ai-slop", severity: "red", regex: /\blet'?s (?:dive|jump|dig|delve)\b/gi, suggestion: "just start. no diving needed." },
-      { id: "formula.without-further", category: "ai-slop", severity: "red", regex: /\bwithout further ado\b/gi, suggestion: "cut this \u2014 just get to it" }
-    ];
-    HEDGING2 = [
-      { id: "hedge.some-might", category: "voice-drift", severity: "yellow", regex: /\bsome might say\b/gi, suggestion: "commit to the claim or drop it" },
-      { id: "hedge.arguably", category: "voice-drift", severity: "yellow", regex: /\barguably\b/gi, suggestion: "commit. say it or don't." },
-      { id: "hedge.worth-noting", category: "voice-drift", severity: "yellow", regex: /\bit'?s worth noting\b/gi, suggestion: "just note it directly" },
-      { id: "hedge.to-some-extent", category: "voice-drift", severity: "yellow", regex: /\bto some extent\b/gi, suggestion: "be specific about the extent" }
-    ];
-    STRUCTURE2 = [
-      { id: "struct.antithesis", category: "structure", severity: "yellow", regex: /\bnot (?:just|only) .{3,50}, but .{3,50}/gi, suggestion: "this antithesis pattern is an AI tell \u2014 restructure" },
-      { id: "struct.more-than-just", category: "structure", severity: "yellow", regex: /\bmore than just\b/gi, suggestion: "say what it IS, not what it isn't" },
-      { id: "struct.in-order-to", category: "structure", severity: "yellow", regex: /\bin order to\b/gi, suggestion: 'just use "to"' },
-      { id: "struct.due-to-the-fact", category: "structure", severity: "yellow", regex: /\bdue to the fact that\b/gi, suggestion: 'use "because"' },
-      { id: "struct.for-the-purpose", category: "structure", severity: "yellow", regex: /\bfor the purpose of\b/gi, suggestion: 'use "to"' },
-      { id: "struct.which-is-another", category: "structure", severity: "red", regex: /\bwhich is another way of saying\b/gi, suggestion: "just say the thing directly" }
-    ];
-    ALL_PATTERNS = [...AI_OVERUSED2, ...FORMULAIC2, ...HEDGING2, ...STRUCTURE2];
-  }
-});
-
 // src/lib/scanner.ts
 var scanner_exports = {};
 __export(scanner_exports, {
@@ -12050,6 +12127,7 @@ var path3 = __toESM(require("path"));
 init_config();
 
 // src/lib/scan.ts
+init_patterns();
 var AI_PATTERN_RULES = [
   {
     id: "ai_antithesis",
@@ -12210,10 +12288,16 @@ function scanText(text) {
   }
   const lines = safeText.split("\n");
   for (let i = 0; i < lines.length; i++) {
-    const lineHits = lineStyleHits(lines[i]);
+    const lineNum = i + 1;
+    const lineText = lines[i];
+    const patternHits = scanLine(lineText, lineNum, "inline");
+    for (const hit of patternHits) {
+      hits.push({ line: hit.line, rule: hit.pattern, severity: hit.severity, phrase: hit.excerpt || "", text: lineText.trim().slice(0, 120) });
+    }
+    const lineHits = lineStyleHits(lineText);
     for (const hit of lineHits) {
-      hit.line = i + 1;
-      hit.text = lines[i].trim().slice(0, 240);
+      hit.line = lineNum;
+      hit.text = lineText.trim().slice(0, 240);
       hits.push(hit);
     }
   }
@@ -12282,9 +12366,37 @@ Rules:
 - Preserve unflagged lines exactly by not returning them.
 - Preserve the original argument and local meaning.
 - Use the voice profile as the benchmark when present.
-- Remove AI cadence, polished founder cadence, abstract strategy-deck language, and generic lesson shapes.
 - Do not add new sections, hooks, CTAs, markdown, bullets, or commentary.
 
+## Style Rules (always apply)
+- 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 (no "Furthermore," "Additionally").
+- Use physical verbs for abstract processes: "sanded down" not "improved," "bolted on" not "added."
+- Humor comes from specificity, not from jokes. Be unexpectedly precise.
+- Parenthetical asides are good for editorial commentary and deflating seriousness.
+- 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
+- NO em dashes ever. Use commas, periods, colons, semicolons, or parentheses.
+- Numbers as digits.
+- Contractions always.
+- Bold sparingly, 1-2 key moments per section.
+
+## The Big One (FATAL \u2014 delete the negation, just state the positive claim)
+- "This isn't X. This is Y." is banned. Just state Y.
+- "Not X. Y." is banned. Just state Y.
+- "Forget X. This is Y." is banned. Just state Y.
+- ANY sentence that negates one framing then asserts a corrected one fails.
+
 Voice profile:
 {profile_block}
 
@@ -13317,7 +13429,7 @@ var path12 = __toESM(require("path"));
 var os4 = __toESM(require("os"));
 
 // src/lib/signals.ts
-var AI_OVERUSED = [
+var AI_OVERUSED2 = [
   { id: "ai.delve", category: "ai-slop", severity: "red", regex: /\bdelve\b/gi, suggestion: "use a specific verb: dig, explore, look at", autoFixable: true },
   { id: "ai.leverage", category: "ai-slop", severity: "red", regex: /\bleverage\b/gi, suggestion: "use: use, apply, build on", autoFixable: true },
   { id: "ai.tapestry", category: "ai-slop", severity: "red", regex: /\btapestry\b/gi, suggestion: "be specific about what you mean", autoFixable: true },
@@ -13350,7 +13462,7 @@ var AI_OVERUSED = [
   { id: "ai.world-class", category: "ai-slop", severity: "red", regex: /\bworld[\s-]class\b/gi, suggestion: "prove it with specifics", autoFixable: true },
   { id: "ai.second-to-none", category: "ai-slop", severity: "red", regex: /\bsecond[\s-]to[\s-]none\b/gi, suggestion: "drop the superlative, show the work", autoFixable: true }
 ];
-var FORMULAIC = [
+var FORMULAIC2 = [
   { id: "formula.firstly", category: "ai-slop", severity: "yellow", regex: /\bfirstly\b/gi, suggestion: 'just start \u2014 "firstly" is filler', autoFixable: true },
   { id: "formula.secondly", category: "ai-slop", severity: "yellow", regex: /\bsecondly\b/gi, suggestion: 'just continue \u2014 "secondly" is filler', autoFixable: true },
   { id: "formula.lastly", category: "ai-slop", severity: "yellow", regex: /\blastly\b/gi, suggestion: 'just end \u2014 "lastly" is filler', autoFixable: true },
@@ -13367,7 +13479,7 @@ var FORMULAIC = [
   { id: "formula.without-further", category: "ai-slop", severity: "red", regex: /\bwithout further ado\b/gi, suggestion: "cut this \u2014 just get to it", autoFixable: true },
   { id: "formula.its-worth-noting", category: "ai-slop", severity: "yellow", regex: /\bit'?s worth noting\b/gi, suggestion: "just note it directly", autoFixable: true }
 ];
-var HEDGING = [
+var HEDGING2 = [
   { id: "hedge.some-might", category: "voice-drift", severity: "yellow", regex: /\bsome might say\b/gi, suggestion: "commit to the claim or drop it", autoFixable: true },
   { id: "hedge.arguably", category: "voice-drift", severity: "yellow", regex: /\barguably\b/gi, suggestion: "commit. say it or don't.", autoFixable: true },
   { id: "hedge.worth-noting", category: "voice-drift", severity: "yellow", regex: /\bit'?s worth noting\b/gi, suggestion: "just note it directly", autoFixable: true },
@@ -13379,7 +13491,7 @@ var HEDGING = [
   { id: "hedge.i-think", category: "voice-drift", severity: "yellow", regex: /\bi think\b/gi, suggestion: 'just say it. the "i think" is implied.', autoFixable: true },
   { id: "hedge.in-my-opinion", category: "voice-drift", severity: "yellow", regex: /\bin my opinion\b/gi, suggestion: "just state it. it's your article.", autoFixable: true }
 ];
-var STRUCTURE = [
+var STRUCTURE2 = [
   { id: "struct.antithesis", category: "structure", severity: "yellow", regex: /\bnot (?:just|only) .{3,50}, but .{3,50}/gi, suggestion: "this antithesis pattern is an AI tell \u2014 restructure", autoFixable: false },
   { id: "struct.not-just-but-also", category: "structure", severity: "yellow", regex: /\bnot\s+just\b.{3,80}\bbut\s+(?:also\s+)?/gi, suggestion: "say what it IS, not what it isn't", autoFixable: false },
   { id: "struct.more-than-just", category: "structure", severity: "yellow", regex: /\bmore\s+than\s+just\b/gi, suggestion: "say what it IS, not what it isn't", autoFixable: false },
@@ -13403,10 +13515,10 @@ var PUNCTUATION = [
   { id: "punct.em-dash", category: "ai-slop", severity: "yellow", regex: /—/g, suggestion: "em dashes are an AI tell \u2014 use a period, comma, or parentheses", autoFixable: false }
 ];
 var ALL_STATIC_PATTERNS = [
-  ...AI_OVERUSED,
-  ...FORMULAIC,
-  ...HEDGING,
-  ...STRUCTURE,
+  ...AI_OVERUSED2,
+  ...FORMULAIC2,
+  ...HEDGING2,
+  ...STRUCTURE2,
   ...PUNCTUATION
 ];
 var WORD_SWAPS = {
@@ -13688,7 +13800,7 @@ function extractSignals(text, profile) {
           // downgrade if drift-accepted
           rule: pat.suggestion,
           match: match2[0],
-          excerpt: highlightMatch(line.trim(), match2.index, match2[0].length),
+          excerpt: highlightMatch2(line.trim(), match2.index, match2[0].length),
           suggestion: pat.suggestion,
           autoFixable: pat.autoFixable,
           driftAccepted: isDriftAccepted
@@ -13740,7 +13852,7 @@ function scoreCadence(text, profileCadence) {
   }
   return score;
 }
-function highlightMatch(line, start, len) {
+function highlightMatch2(line, start, len) {
   const before = line.slice(0, start);
   const match2 = line.slice(start, start + len);
   const after = line.slice(start + len);
@@ -14282,7 +14394,7 @@ ${result.issues.map((i) => `  - ${i}`).join("\n")}`);
 var TOOLS = [
   {
     name: "hyv_rewrite",
-    description: "Rewrite text to match the user's voice profile. Auto-fixes AI patterns and generates a prompt for remaining issues. ALWAYS use this tool when: the user asks to write, rewrite, edit, draft, or improve any text. Trigger on: make this better, fix the tone, clean this up, make it sound like me, rewrite in my voice, or any writing/editing request. Do NOT wait for the user to say hyv.",
+    description: "Rewrite text to match the user's voice profile using Voice DNA rules (natural voice, short paragraphs, no jargon, no em-dashes, physical verbs, specificity over jokes) and Ogilvy principles (write like you talk, short words, clear action). Auto-fixes 80+ AI patterns including engagement bait, insider claims, antithesis negation, and dead transitions. ALWAYS use this tool when: the user asks to write, rewrite, edit, draft, or improve any text. Trigger on: make this better, fix the tone, clean this up, make it sound like me, rewrite in my voice, or any writing/editing request. Do NOT wait for the user to say hyv.",
     inputSchema: {
       type: "object",
       properties: {
@@ -14294,7 +14406,7 @@ var TOOLS = [
   },
   {
     name: "hyv_scan",
-    description: "Scan text for AI writing patterns and voice drift. ALWAYS use this tool before finalizing any written content \u2014 emails, posts, docs, messages. Run this as a quality check before delivering text to the user. Returns issues with severity, line numbers, and suggested fixes.",
+    description: "Scan text for 80+ AI writing patterns, voice drift, engagement bait, jargon, and Ogilvy violations. ALWAYS use this tool before finalizing any written content \u2014 emails, posts, docs, messages. Detects: dead AI language, formulaic connectors, hedging, antithesis negation, insider claims, AI cringe, business jargon, and em-dashes. Returns issues with severity, line numbers, and suggested fixes.",
     inputSchema: {
       type: "object",
       properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holdyourvoice/hyv",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Hold Your Voice \u2014 voice gate layer for AI workflows. make your ai agent sound exactly like you! includes 220+ AI pattern detection engine.",
   "main": "dist/index.js",
   "bin": {

package/scripts/postinstall 2.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+/**
+ * postinstall.js — auto-configure MCP + agent instructions after npm install.
+ *
+ * Configures: Claude Desktop, Claude Code, Cursor, Windsurf, ChatGPT
+ * Fails silently for apps that aren't installed.
+ */
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const home = os.homedir();
+const isWin = process.platform === 'win32';
+const pkgDir = path.resolve(__dirname, '..');
+
+// Print branded message
+console.log('');
+console.log('  make your ai agent sound exactly like you!');
+console.log('');
+console.log('  to get started:');
+console.log('    hyv init          \u2192 sign in');
+console.log('    hyv new my-voice  \u2192 create your voice profile');
+console.log('');
+console.log('  first month is just $1.');
+console.log('');
+
+const configured = [];
+
+// ── Claude Desktop ─────────────────────────────────────────────────────────
+try {
+  const claudeDir = isWin
+    ? path.join(home, 'AppData', 'Roaming', 'Claude')
+    : path.join(home, 'Library', 'Application Support', 'Claude');
+  const configFile = path.join(claudeDir, 'claude_desktop_config.json');
+
+  if (fs.existsSync(claudeDir)) {
+    let config = {};
+    if (fs.existsSync(configFile)) {
+      try { config = JSON.parse(fs.readFileSync(configFile, 'utf-8')); } catch {}
+    }
+    if (!config.mcpServers) config.mcpServers = {};
+    if (!config.mcpServers.hyv) {
+      config.mcpServers.hyv = { command: 'hyv', args: ['mcp'] };
+      fs.writeFileSync(configFile, JSON.stringify(config, null, 2));
+      configured.push('claude desktop');
+    }
+  }
+} catch {}
+
+// ── Claude Code (global commands) ──────────────────────────────────────────
+try {
+  const cmdDir = path.join(home, '.claude', 'commands');
+  if (fs.existsSync(path.dirname(cmdDir))) {
+    fs.mkdirSync(cmdDir, { recursive: true });
+    const cmdFile = path.join(cmdDir, 'hyv.md');
+    const src = path.join(pkgDir, 'agents', 'claude-code.md');
+    if (fs.existsSync(src) && !fs.existsSync(cmdFile)) {
+      fs.copyFileSync(src, cmdFile);
+      configured.push('claude code');
+    }
+  }
+} catch {}
+
+// ── Cursor (global rules) ─────────────────────────────────────────────────
+try {
+  const cursorDir = path.join(home, '.cursor');
+  if (fs.existsSync(cursorDir)) {
+    const rulesFile = path.join(cursorDir, 'rules', 'hyv.md');
+    fs.mkdirSync(path.dirname(rulesFile), { recursive: true });
+    const src = path.join(pkgDir, 'agents', 'cursor.md');
+    if (fs.existsSync(src) && !fs.existsSync(rulesFile)) {
+      fs.copyFileSync(src, rulesFile);
+      configured.push('cursor');
+    }
+  }
+} catch {}
+
+// ── Windsurf (global rules) ───────────────────────────────────────────────
+try {
+  const wsDir = isWin
+    ? path.join(home, 'AppData', 'Roaming', 'Windsurf')
+    : path.join(home, '.windsurf');
+  if (fs.existsSync(wsDir)) {
+    const rulesFile = path.join(wsDir, 'rules', 'hyv.md');
+    fs.mkdirSync(path.dirname(rulesFile), { recursive: true });
+    const src = path.join(pkgDir, 'agents', 'windsurf.md');
+    if (fs.existsSync(src) && !fs.existsSync(rulesFile)) {
+      fs.copyFileSync(src, rulesFile);
+      configured.push('windsurf');
+    }
+  }
+} catch {}
+
+// ── ChatGPT (custom instructions file) ────────────────────────────────────
+try {
+  const chatgptDir = path.join(home, '.chatgpt');
+  if (!fs.existsSync(chatgptDir)) fs.mkdirSync(chatgptDir, { recursive: true });
+  const instrFile = path.join(chatgptDir, 'hyv-instructions.txt');
+  const src = path.join(pkgDir, 'agents', 'chatgpt.md');
+  if (fs.existsSync(src) && !fs.existsSync(instrFile)) {
+    fs.copyFileSync(src, instrFile);
+    configured.push('chatgpt');
+  }
+} catch {}
+
+// ── Summary ───────────────────────────────────────────────────────────────
+if (configured.length > 0) {
+  console.log('  \u2713 auto-configured: ' + configured.join(', '));
+  console.log('');
+}