@holdyourvoice/hyv 2.9.27 → 3.0.0

package/README.md

@@ -1,218 +0,0 @@
-# hold your voice
-
-make your ai agent sound exactly like you.
-
-`@holdyourvoice/hyv` is a CLI-first voice gate for AI workflows. scan drafts for AI writing patterns locally (offline, no API), wire it into cursor/claude via MCP, and unlock profile-aware rewrites when you subscribe.
-
-**Try without installing:**
-
-```bash
-npx @holdyourvoice/hyv welcome
-npx @holdyourvoice/hyv scan draft.md
-```
-
-## install
-
-**Recommended** (installs node automatically if missing):
-
-```bash
-# mac / linux
-curl -fsSL https://holdyourvoice.com/install.sh | bash
-
-# windows (powershell)
-powershell -ExecutionPolicy Bypass -c "irm https://holdyourvoice.com/install.ps1 | iex"
-```
-
-Already have node 18+?
-
-```bash
-npm i -g @holdyourvoice/hyv
-```
-
-postinstall copies agent rules and configures MCP for claude desktop and cursor (plus claude code, windsurf, codex, command code skills when detected). set `HYV_AUTO_CONFIGURE_AGENTS=0` to skip.
-
-## free vs paid
-
-| free forever (local, no account) | paid unlocks |
-|----------------------------------|--------------|
-| `hyv scan`, `fix`, `check`, `score`, `diff`, `batch`, `watch` | voice profiles synced from your account |
-| `hyv mcp` — agent tools (`hyv_scan`, `hyv_clean`, …) | learning loop: `hyv reinforce`, `hyv add` |
-| `hyv welcome`, `hyv doctor`, `hyv content` | profile-aware `hyv rewrite` prompts |
-| 30+ free web tools at [holdyourvoice.com/tools](https://holdyourvoice.com/tools) | hybrid server analysis (`hyv scan --server`, MCP `hyv_analyze`) |
-| public voice profiles + blog | multiple profiles, team voices, dashboard |
-
-```bash
-hyv plan --free    # full matrix in the terminal
-hyv welcome        # live demo + every free capability
-```
-
-local scan never calls an LLM. your text stays on your machine.
-
-## quick start
-
-```bash
-# instant demo — no auth
-npx @holdyourvoice/hyv welcome
-
-# scan a draft offline
-hyv scan draft.md
-
-# sign in when you want profiles + learning
-hyv init
-hyv new my-voice
-
-# generate a rewrite prompt (profile-aware when subscribed)
-hyv rewrite draft.md
-```
-
-## npx (no global install)
-
-```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 --setup
-```
-
-## MCP server
-
-`hyv mcp` runs a stdio MCP server for claude desktop, claude code, cursor, windsurf, codex, and command code.
-
-```bash
-hyv mcp --setup    # copy-paste config for every agent
-hyv mcp --test     # health check (tools, demo pipeline, profile)
-hyv mcp            # start server (stdio)
-```
-
-postinstall copies agent rules to `~/.cursor/rules/hyv.mdc`, `~/.claude/commands/hyv.md`, etc. re-run anytime:
-
-```bash
-hyv doctor --fix-agents
-```
-
-### tools
-
-| tool | description |
-|------|-------------|
-| `hyv_welcome` / `hyv_demo` | onboarding + live free scan demo |
-| `hyv_scan` | fast local scan (free, offline; uses `~/.hyv` cache, no network wait) |
-| `hyv_analyze` | hybrid local + server analysis (paid when online) |
-| `hyv_clean` | scan → fix → validate → rewrite prompt |
-| `hyv_fix` / `hyv_check` / `hyv_score` / `hyv_diff` | local utilities |
-| `hyv_rewrite` | profile-aware rewrite prompt |
-| `hyv_validate` | verify text against voice profile |
-| `hyv_profiles` | list cached or account profiles |
-
-### agent workflow
-
-1. `hyv_scan` or `hyv_analyze` on draft text
-2. `hyv_clean` or `hyv_fix` → `hyv_rewrite` → `hyv_validate`
-3. after user accepts edits: `hyv reinforce --last` (CLI learning loop)
-
-## CI / pre-commit
-
-block AI-slop before merge:
-
-```bash
-hyv content ci    # full github actions + pre-commit snippets
-```
-
-github actions:
-
-```yaml
-- run: npx @holdyourvoice/hyv@latest scan content/ --fail-on-hit
-```
-
-`--fail-on-hit` exits with code **2** when issues are found (exit 0 = clean). use in CI to block merges on AI-slop.
-
-### destructive in-place writes
-
-`fix`, `batch`, and `watch` can rewrite files on disk. they create a `.bak` backup sibling before writing.
-
-| command | safeguard |
-|---------|-----------|
-| `hyv fix <file> --in-place` | prompts `[y/N]` locally; use `--yes` in CI |
-| `hyv batch <glob> --fix --in-place` | same — one prompt for the whole batch |
-| `hyv watch <file> --command fix` | same — confirms once at startup |
-
-```bash
-# interactive (local)
-hyv fix draft.md --in-place
-
-# non-interactive (CI/scripts)
-hyv fix draft.md --in-place --yes
-hyv batch "posts/**/*.md" --fix --in-place --yes
-```
-
-## commands
-
-| command | description |
-|---------|-------------|
-| `hyv` | condensed welcome (no args) |
-| `hyv welcome` / `hyv free` | free demo + capability tour |
-| `hyv scan <file>` | scan text for AI patterns |
-| `hyv fix <file>` | auto-swap fixable patterns (`--in-place --yes` for CI) |
-| `hyv batch <glob>` | scan/fix many files (`--fail-on-hit` exits 2) |
-| `hyv watch <file>` | re-scan on save (`--command fix --yes` to auto-fix) |
-| `hyv check <text>` | quick pass/fail check |
-| `hyv init` | authenticate with hold your voice |
-| `hyv new <name>` | create a voice profile |
-| `hyv rewrite <file>` | generate rewrite prompt |
-| `hyv content [topic]` | blog outlines, CI snippets, share templates |
-| `hyv plan --free` | free vs paid matrix |
-| `hyv mcp` | start MCP server |
-| `hyv export [format]` | export profile for LLMs |
-| `hyv reinforce --last` | learn from last fix session |
-| `hyv doctor` | diagnose and fix issues |
-| `hyv upgrade` | install latest global CLI |
-
-## voice profiles
-
-profiles live in `~/.hyv/profiles/` as markdown. create one with:
-
-```bash
-hyv new my-voice
-```
-
-onboarding walks through your style, audience, and tone. profiles sync to the server when you're on a paid plan.
-
-## content formats
-
-`hyv scan` detects 220+ AI writing patterns:
-
-- **ai-slop** — delve, leverage, tapestry, pivotal, foster
-- **formulaic** — firstly, moreover, in conclusion
-- **voice-drift** — arguably, perhaps, some might say
-- **structure** — antithesis, signpost claims, lesson setups
-
-paid profiles add never-list bans, learned patterns, anchors, and cadence scoring.
-
-## environment variables
-
-| variable | description |
-|----------|-------------|
-| `HYV_API_URL` | API base URL (default: `https://holdyourvoice.com`) |
-| `HYV_LOCAL_ONLY` | force offline mode (`1` or `true`) |
-| `HYV_TELEMETRY` | log funnel events to `~/.hyv/telemetry/` (`1` to enable) |
-| `HYV_POSTINSTALL_QUIET` | suppress postinstall output (`1`) |
-
-```bash
-HYV_API_URL=https://staging.holdyourvoice.com hyv init
-```
-
-## links
-
-- [npm package](https://www.npmjs.com/package/@holdyourvoice/hyv)
-- [free tools](https://holdyourvoice.com/tools)
-- [pricing](https://holdyourvoice.com/#pricing)
-- [blog](https://holdyourvoice.com/blog)
-- [community](https://holdyourvoice.com/community)
-
-## documentation ownership
-
-Changes under `cli/` update this README, the more-specific owner README when applicable, and the root repository README. Package-relative paths, bin names, published files, and postinstall behavior are contracts; validate them with `npm run validate:publish` before merging.
-
-## license
-
-UNLICENSED — [holdyourvoice.com](https://holdyourvoice.com)

package/agents/AGENTS.md

@@ -1,80 +0,0 @@
-# Hold Your Voice — Agent Instructions
-
-The user has a voice profile that defines their unique writing style. Your job is to make ALL written content match their voice automatically — without waiting for them to mention "voice" or "hyv".
-
-## Auto-trigger — do these automatically
-
-**Before delivering any written content (emails, replies, posts, docs, messages, or prose):**
-1. Run `hyv_scan` for a fast local check (free, offline, works without a profile)
-2. Run `hyv_clean` for the full scan → fix → validate pipeline, or `hyv_fix` then `hyv_rewrite`
-3. Run `hyv_validate` to verify the output matches their voice
-
-**When the user asks you to write, draft, compose, edit, improve, or rewrite anything:**
-1. Write your draft normally
-2. Run `hyv_scan` or `hyv_clean` on it
-3. Run `hyv_rewrite` to match their voice profile
-4. Deliver the voice-matched version
-
-**After the user accepts a substantial edit:**
-- Suggest they run `hyv reinforce --last` so their profile learns from the change
-
-## Which tool to use
-
-| Tool | What it does | When to use |
-|------|-------------|-------------|
-| `hyv_welcome` | Onboarding guide (name → samples → test → signup) | New users, first time |
-| `hyv_mcp_setup` | Status, integrate apps, ChatGPT connector | Check/refresh setup |
-| `hyv_profiles` | List voice profiles | See which profiles are available |
-| `hyv_scan` | Fast local AI-pattern scan (free, 220+ patterns) | Before any prose delivery |
-| `hyv_analyze` | Full hybrid scan (local + server, paid) | Important drafts |
-| `hyv_clean` | Scan → fix → validate → rewrite in one call | Best single-call pipeline |
-| `hyv_fix` | Auto-fix deterministic patterns (no LLM) | Before rewrite |
-| `hyv_rewrite` | Profile-aware rewrite prompt | After scan/fix |
-| `hyv_validate` | Verify output matches voice profile | After rewrite |
-| `hyv_check` | Quick pass/fail | Spot checks |
-| `hyv_score` | 0-100 voice score | Quantify quality |
-| `hyv_diff` | Before/after comparison | Review changes |
-| `hyv_list_free_tools` | List all free capabilities | What's available |
-
-## Voice profiles
-
-- Run `hyv_profiles` first if unsure which profile is active.
-- Terminal profiles (from `hyv welcome`) are already local — no extra step.
-- Dashboard profiles sync after the user runs `hyv init` once (MCP auto-downloads).
-- Pass `profile: "<slug>"` on tools only when using a non-default profile.
-- If no profile exists yet, free local scan still works — call `hyv_welcome` to onboard.
-
-## Rewrite rules
-
-1. **Never** use AI-slop words: delve, leverage, tapestry, foster, harness, pivotal, innovative, cutting-edge, robust, holistic, nuanced, resonate, unpack, navigate, landscape, ecosystem, transformative, paradigm, revolutionize, unlock, supercharge, game-changer
-2. **Never** use formulaic connectors: firstly, secondly, moreover, furthermore, in conclusion, to conclude, notably
-3. **Never** use hedging: arguably, perhaps, some might say, it's worth noting, it's important to note
-4. **Never** use signpost claims: this is why, this is how, here's where, here's why
-5. **Never** use antithesis patterns: "not just X, but Y", "more than just", "it's not about X, it's about Y"
-6. **Match** the user's sentence rhythm, vocabulary, and tone from their voice profile
-7. **Preserve** roughness that carries voice — don't over-polish
-8. **Open** from concrete observations, not generic setups
-9. **Fix only** flagged lines — preserve clean lines exactly
-10. **Never add** sections, hooks, CTAs, markdown, or commentary
-
-## MCP setup (no terminal needed)
-
-- `hyv_mcp_setup` with `action=status` — see what's integrated and onboarding progress
-- `hyv_mcp_setup` with `action=integrate` — refresh Cursor/Claude configs (`force=true` after hyv upgrade)
-- `hyv_mcp_setup` with `action=chatgpt` — ChatGPT remote OAuth steps (recommended for paid users)
-- `hyv_welcome` — finish voice onboarding inside this chat
-
-## CLI fallback (when MCP tools aren't available)
-
-```bash
-echo "text to check" | hyv scan -
-hyv fix file.md              # apply auto-fixes without LLM
-hyv rewrite file.md          # generate rewrite prompt
-hyv check "inline text"      # quick spot-check
-hyv score file.md            # just a 0-100 number
-hyv diff file.md             # show proposed fixes
-hyv profiles                 # list profiles
-hyv reinforce --last         # learn from last edit
-hyv mcp --setup              # view all MCP configs
-hyv mcp --test               # verify everything works
-```

package/agents/README.md

@@ -1,20 +0,0 @@
-# `cli/agents/`
-
-## Purpose
-
-`cli/agents/` contains agent resources included in the published CLI package.
-
-## Contracts
-
-The directory is included by the `files` list in `cli/package.json`. Changes must preserve package inclusion and postinstall discovery behavior.
-
-## Validation
-
-```bash
-cd cli
-npm run validate:publish
-```
-
-## Documentation ownership
-
-Changes update this README, `cli/README.md`, and the root `README.md`.

package/agents/chatgpt.md

@@ -1,45 +0,0 @@
-# Hold Your Voice — Writing Rules
-
-The user has a voice profile. All writing must match their personal style.
-
-## Rules
-1. Never use AI-slop words: delve, leverage, tapestry, foster, harness, pivotal, innovative, cutting-edge, state-of-the-art, robust, holistic, multifaceted, nuanced
-2. Never use formulaic connectors: firstly, secondly, moreover, furthermore, in conclusion
-3. Never use hedging: arguably, perhaps, some might say, it's worth noting
-4. Never use signpost claims: this is why, this is how, here's where
-5. Match the user's sentence rhythm and vocabulary
-6. Preserve roughness that carries voice — don't over-polish
-7. Open from concrete observations, not generic setups
-
-## When rewriting
-- Fix only flagged lines, preserve clean lines
-- Remove AI patterns line by line
-- Match the user's voice profile exactly
-- Never add sections, hooks, CTAs, or commentary
-
-## Voice profiles
-- `hyv_profiles` — which profile MCP tools use (default + all local copies)
-- Dashboard-built profiles: user runs `hyv init` once on their Mac — then MCP auto-syncs
-- Terminal `hyv welcome` profiles are already local — no extra step
-
-## MCP setup (no terminal)
-- `hyv_mcp_setup` with `action=status` — see what's integrated and onboarding progress
-- `hyv_mcp_setup` with `action=integrate` — refresh Cursor/Claude configs (`force=true` after hyv upgrade)
-- `hyv_mcp_setup` with `action=chatgpt` — **recommended:** remote OAuth (developer mode → new app → https://holdyourvoice.com/mcp + OAuth). Free fallback: local connector (command: hyv, arguments: mcp)
-- `hyv_welcome` — finish voice onboarding inside this chat
-
-## ChatGPT connection (recommended — paid users)
-1. Settings → Developer mode ON
-2. Settings → Apps → New App
-3. Server URL: `https://holdyourvoice.com/mcp` · Authentication: OAuth
-4. Save → sign in to holdyourvoice.com
-5. OAuth runs in ChatGPT's browser — no Windows firewall issues, no local install
-
-## Available tools
-- `hyv_mcp_setup` / `hyv_welcome` / `hyv_demo` — setup and onboarding
-- `hyv_scan` / `hyv_analyze` — check for AI patterns (+ hybrid when paid)
-- `hyv_clean` — full scan → fix → validate pipeline
-- `hyv_fix` / `hyv_rewrite` / `hyv_validate`
-- `hyv_check` / `hyv_score` / `hyv_diff`
-- `hyv_profiles` — list available profiles
-- CLI: `hyv reinforce --last` after user accepts edits

package/agents/claude-code.md

@@ -1,50 +0,0 @@
-# Hold Your Voice
-
-The user has a voice profile that defines their writing style. Use HYV tools for ALL writing tasks — not just when they say "voice" or "hyv".
-
-## When to use HYV
-
-ALWAYS run `hyv_scan` or use the `hyv_scan` MCP tool before delivering any written content:
-- Writing emails, replies, or messages
-- Drafting blog posts, articles, or documentation
-- Creating social media posts (Twitter, LinkedIn, etc.)
-- Editing or improving any text
-- Responding to questions with longer answers
-- Any task where the output is prose/text the user will publish or send
-
-ALWAYS run `hyv_rewrite` or use the `hyv_rewrite` MCP tool when:
-- The user asks to "write", "draft", "compose", "edit", "improve", or "fix" text
-- The user says "make this better", "clean this up", "fix the tone"
-- The user asks for any content creation
-- The scan finds issues and you need to fix them
-
-## How to use
-
-### MCP tools (preferred — if MCP is connected):
-1. `hyv_welcome` for new users (step 2: extract_prompt from chat history)
-2. `hyv_scan` (fast local) or `hyv_analyze` (hybrid when paid) → get issues
-3. `hyv_clean` → scan + fix + validate + rewrite prompt in one call
-4. Or stepwise: `hyv_fix` → `hyv_rewrite` → `hyv_validate`
-5. `hyv_check` / `hyv_score` / `hyv_diff` for quick checks
-6. After user accepts edits: suggest `hyv reinforce --last` (CLI learning loop)
-
-### CLI commands (fallback):
-```bash
-echo "text to check" | hyv scan -
-hyv fix file.md              # apply auto-fixes without LLM
-hyv rewrite file.md          # generate rewrite prompt
-hyv check "inline text"      # quick spot-check
-hyv score file.md            # just a 0-100 number
-hyv diff file.md             # show proposed fixes
-hyv profiles                 # list profiles
-hyv rules                    # list/toggle detection rules
-hyv batch "posts/**/*.md"   # scan multiple files
-hyv history                  # track scores over time
-```
-
-## Rules
-- Never skip the scan step for user-facing content
-- Preserve the original meaning exactly when rewriting
-- Match the voice profile's rhythm, vocabulary, and patterns
-- If no profile is set up yet, run `hyv profiles` to check
-- Setup: `hyv mcp --setup` | health: `hyv mcp --test`

package/agents/codex.md

@@ -1,30 +0,0 @@
-# Hold Your Voice
-
-The user has a voice profile for their writing style. Use HYV for ALL writing tasks.
-
-## Auto-trigger rules
-
-Run these MCP tools (or CLI commands) for any writing task:
-- `hyv_scan` or `hyv_analyze` on any text 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
-- Always scan before delivering prose content
-- Always fix/rewrite if scan finds issues
-- Preserve meaning, match voice profile

package/agents/cursor.md

@@ -1,35 +0,0 @@
-# Hold Your Voice
-
-Use HYV MCP tools for all writing tasks. 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
-- Any email, post, doc, or content creation
-- Before delivering any prose to the user
-- When editing or improving text
-- New users: `hyv_welcome` (name → samples via extract_prompt → scan → signup last)
-
-## 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 before delivering content
-- Use `hyv_fix` before `hyv_rewrite` when possible
-- Preserve meaning when rewriting
-- Match the user's voice profile exactly

package/agents/generic.md

@@ -1,47 +0,0 @@
-# Hold Your Voice — Agent Instructions
-
-You have access to the Hold Your Voice MCP tools. The user has a voice profile that defines how they write. Your job is to make ALL written content match their voice.
-
-## Auto-trigger rules
-
-You MUST use these tools automatically — do NOT wait for the user to mention "voice" or "hyv":
-
-**Before delivering any written content (emails, posts, docs, messages):**
-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 write, draft, edit, or improve anything:**
-1. Write your draft
-2. Run `hyv_scan` or `hyv_clean` on it
-3. Deliver the cleaned version
-
-**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 user-facing content
-- 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,19 +0,0 @@
-# Hold Your Voice
-
-Use HYV MCP tools for all writing tasks. The user has a voice profile.
-
-## Auto-trigger
-- `hyv_scan` or `hyv_analyze` before delivering any text
-- `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
-- Always scan user-facing content
-- 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`.