@holdyourvoice/hyv 2.9.28 → 3.0.1

package/agents/codex.md

@@ -1,31 +0,0 @@
-# Hold Your Voice
-
-The user has a voice profile for publishable copy. Use HYV for social posts, newsletters, blogs, landing or product pages, campaigns, and external audience-facing emails. Always use HYV when the user explicitly asks for it, a voice profile, or writing in their voice.
-
-## Auto-trigger rules
-
-Run these MCP tools (or CLI commands) for eligible publishable copy:
-- `hyv_scan` or `hyv_analyze` before delivering it
-- `hyv_clean` for the full pipeline, or `hyv_fix` → `hyv_rewrite`
-- `hyv_validate` to verify the output
-- Suggest `hyv reinforce --last` after substantial accepted edits
-
-## Quick tools
-- `hyv_welcome` / `hyv_demo` for new users
-- `hyv_check` / `hyv_score` / `hyv_diff`
-
-## CLI fallback
-```bash
-echo "text" | hyv scan -
-hyv fix file.md
-hyv rewrite file.md
-hyv reinforce --last
-hyv profiles
-hyv mcp --setup
-```
-
-## Rules
-- Bypass HYV for routine chat, Q&A, analysis, research, planning, coding, debugging, reviews, logs, operational work, code comments, and internal engineering-status messages. If ambiguous, bypass it unless HYV is explicitly requested.
-- Always scan eligible publishable copy
-- Always fix/rewrite if scan finds issues
-- Preserve meaning, match voice profile

package/agents/cursor.md

@@ -1,36 +0,0 @@
-# Hold Your Voice
-
-Use HYV MCP tools for publishable copy: social posts, newsletters, blogs, landing or product pages, campaigns, and external audience-facing emails. Always use HYV when the user explicitly asks for it, a voice profile, or writing in their voice. If no profile exists yet, call `hyv_welcome` or `hyv_profiles` first — free local scan works without a profile. For MCP host setup or refresh, call `hyv_mcp_setup` (no terminal).
-
-## When to use
-- Social posts, newsletters, blogs, landing or product pages, campaigns, and external audience-facing emails
-- Any request that explicitly names HYV, a voice profile, or writing in the user's voice
-- New users: `hyv_welcome` (name → samples via extract_prompt → scan → signup last)
-
-Bypass HYV for routine chat, Q&A, analysis, research, planning, coding, debugging, reviews, logs, operational work, code comments, and internal engineering-status messages. If ambiguous, bypass it unless HYV is explicitly requested.
-
-## Tool flow (preferred)
-1. `hyv_scan` — fast local check (free, offline)
-2. `hyv_analyze` — full hybrid engine when user is on a paid plan
-3. `hyv_fix` — deterministic word swaps
-4. `hyv_clean` — scan → fix → validate → rewrite prompt in one call
-5. `hyv_rewrite` — profile-aware rewrite prompt for remaining issues
-6. `hyv_validate` — verify output matches voice
-7. After user accepts a big edit: suggest `hyv reinforce --last` (CLI)
-
-## Tools
-- `hyv_profiles` — active default + all MCP-ready profiles (dashboard profiles after `hyv init`)
-- `hyv_mcp_setup` — integration status, refresh configs, ChatGPT steps
-- `hyv_welcome` / `hyv_list_free_tools` / `hyv_demo` — onboarding (free)
-- `hyv_scan` — local AI pattern + profile scan
-- `hyv_analyze` — hybrid local + server analysis (paid when online)
-- `hyv_clean` — full clean pipeline for agents
-- `hyv_fix` / `hyv_check` / `hyv_score` / `hyv_diff` — local utilities
-- `hyv_rewrite` / `hyv_validate` — voice matching
-- `hyv_profiles` — list profiles
-
-## Rules
-- Always scan eligible publishable copy
-- Use `hyv_fix` before `hyv_rewrite` when possible
-- Preserve meaning when rewriting
-- Match the user's voice profile exactly

package/agents/generic.md

@@ -1,49 +0,0 @@
-# Hold Your Voice — Agent Instructions
-
-You have access to the Hold Your Voice MCP tools. Use the user's voice profile for publishable copy: social posts, newsletters, blogs, landing or product pages, campaigns, and external audience-facing emails. Also use it whenever the user explicitly asks for HYV, a voice profile, or writing in their voice.
-
-## Auto-trigger rules
-
-Use these tools automatically for eligible publishable copy. Always honor an explicit HYV or voice-profile request:
-
-**Before delivering eligible publishable copy:**
-1. Run `hyv_scan` (fast) or `hyv_analyze` (full hybrid when paid)
-2. Run `hyv_clean` for the full scan → fix → validate loop, or `hyv_fix` then `hyv_rewrite`
-3. Run `hyv_validate` to verify the result
-
-**When the user asks you to create or rewrite eligible copy:**
-1. Write your draft
-2. Run `hyv_scan` or `hyv_clean` on it
-3. Deliver the cleaned version
-
-**Bypass HYV** for routine chat, Q&A, analysis, research, planning, coding, debugging, reviews, logs, operational work, code comments, and internal engineering-status messages. If the request is ambiguous, bypass it unless the user explicitly requests HYV.
-
-**After the user accepts a substantial edit:**
-- Suggest they run `hyv reinforce --last` so their profile learns from the change
-
-**For new users or MCP setup:**
-- Call `hyv_welcome` — guide them: name profile → samples (use `hyv_welcome` with `mode=extract_prompt` to pull voice from chat) → `hyv_scan` test → signup last via `hyv init`
-- Call `hyv_mcp_setup` — check integration status, refresh app configs (`action=integrate`), or ChatGPT Desktop steps (`action=chatgpt`). Works without a voice profile.
-
-## Voice profiles (terminal + dashboard)
-- Call **`hyv_profiles`** first if unsure which profile is active.
-- **`hyv welcome`** (terminal) saves to this machine — MCP uses it immediately.
-- **Dashboard** profiles sync here after the user runs **`hyv init`** once (MCP auto-downloads on start).
-- Pass `profile: "<slug>"` on tools only when using a non-default profile (slug is lowercase-hyphenated name).
-
-## Available tools
-- `hyv_mcp_setup` — MCP status, integrate hosts, ChatGPT connector guide (no terminal)
-- `hyv_profiles` — list MCP-ready profiles and active default
-- `hyv_welcome` / `hyv_list_free_tools` / `hyv_demo` — onboarding
-- `hyv_scan` — local scan (free, offline)
-- `hyv_analyze` — hybrid server + local (paid)
-- `hyv_clean` — composite clean pipeline
-- `hyv_fix` / `hyv_rewrite` / `hyv_validate`
-- `hyv_check` / `hyv_score` / `hyv_diff`
-- `hyv_profiles` — list voice profiles
-
-## Rules
-- NEVER skip scanning for eligible publishable copy
-- Preserve original meaning exactly when rewriting
-- Match the voice profile's rhythm, vocabulary, and tone
-- If no profile exists, run onboarding via `hyv_welcome` (step 2 extract_prompt from chat history)

package/agents/windsurf.md

@@ -1,20 +0,0 @@
-# Hold Your Voice
-
-Use HYV MCP tools for publishable copy: social posts, newsletters, blogs, landing or product pages, campaigns, and external audience-facing emails. Always use HYV when the user explicitly asks for it, a voice profile, or writing in their voice.
-
-## Auto-trigger
-- `hyv_scan` or `hyv_analyze` before delivering eligible publishable copy
-- `hyv_clean` for scan → fix → validate in one call
-- `hyv_fix` then `hyv_rewrite` for stepwise fixes
-- `hyv_validate` after rewriting
-- `hyv reinforce --last` after user accepts big edits (CLI)
-
-## Quick tools
-- `hyv_welcome` / `hyv_demo` for onboarding
-- `hyv_check` / `hyv_score` / `hyv_diff`
-
-## Rules
-- Bypass HYV for routine chat, Q&A, analysis, research, planning, coding, debugging, reviews, logs, operational work, code comments, and internal engineering-status messages. If ambiguous, bypass it unless HYV is explicitly requested.
-- Always scan eligible publishable copy
-- Use `hyv_fix` before `hyv_rewrite` when possible
-- Preserve meaning, match voice profile

package/assets/FREE-PAID.md

@@ -1,46 +0,0 @@
-# free vs paid — @holdyourvoice/hyv
-
-## free forever (local + web)
-
-**CLI (offline, no account)**
-
-- `hyv scan`, `fix`, `check`, `score`, `diff`, `batch`, `watch`
-- `hyv rules`, `history`, `demo`, `doctor`, `upgrade`
-- `hyv export` (local profile markdown)
-- `hyv mcp` — agent tools (`hyv_scan`, `hyv_clean`, `hyv_analyze`, …)
-- `hyv welcome` / `hyv free` — capability tour + live demo
-- `hyv content` — blog & share templates
-- `hyv plan --free` — this matrix in the terminal
-
-**Try without installing**
-
-```bash
-npx @holdyourvoice/hyv welcome
-npx @holdyourvoice/hyv scan draft.md
-npx @holdyourvoice/hyv fix draft.md
-npx @holdyourvoice/hyv init
-npx @holdyourvoice/hyv mcp
-```
-
-**Web (30+ free tools)**
-
-- https://holdyourvoice.com/tools
-- headline analyzer, brand voice audit, readability checker, email subject scorer, persona builder, and more
-- public profiles: https://holdyourvoice.com/profiles
-- blog: https://holdyourvoice.com/blog
-
-## paid unlocks
-
-- voice profiles synced from your account (never-list, anchors, learned patterns)
-- learning loop: `hyv reinforce`, `hyv add`
-- profile-aware rewrite prompts (`hyv rewrite`)
-- hybrid server analysis (`hyv scan --server`, MCP `hyv_analyze`)
-- multiple profiles + team voices (team plan)
-- dashboard at https://holdyourvoice.com/app
-
-First month $1 → https://holdyourvoice.com/#pricing
-
-```bash
-hyv init
-hyv plan --upgrade
-```

package/assets/README.md

@@ -1,20 +0,0 @@
-# `cli/assets/`
-
-## Purpose
-
-`cli/assets/` contains assets included in the published CLI package.
-
-## Contracts
-
-The directory is included by the `files` list in `cli/package.json`. Keep package paths and postinstall consumers intact.
-
-## Validation
-
-```bash
-cd cli
-npm run validate:publish
-```
-
-## Documentation ownership
-
-Changes update this README, `cli/README.md`, and the root `README.md`.

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
-  }
-}
-