@holdyourvoice/hyv 2.9.28 → 3.0.1

package/CHANGELOG.md

@@ -1,241 +0,0 @@
-# Changelog — @holdyourvoice/hyv
-
-All notable CLI changes. Also mirrored to [holdyourvoice.com/changelog](https://holdyourvoice.com/changelog) for user-facing releases.
-
-## [2.9.28] — 2026-07-31
-
-### Fixed
-- **Scoped MCP activation** — installed rules, export prompts, and MCP metadata now use HYV automatically for publishable copy or an explicit voice request, while routine chat and engineering work bypass it
-- **Agent refresh** — `hyv doctor --fix-agents` refreshes the new scoped instructions through the package version marker
-
-## [2.9.27] — 2026-07-15
-
-### Fixed
-- **MCP scan hang** — `hyv_scan`, `hyv_fix`, `hyv_check`, `hyv_score`, `hyv_diff`, and `hyv_validate` no longer block on account profile sync; they use local `~/.hyv` cache immediately (matching `hyv scan` CLI) and hydrate profiles in the background
-
-## [2.9.26] — 2026-07-09
-
-### Improved
-- **Tier 1 structural detection** — cross-sentence binary reframes (`this is not X. it is Y.`), sermon anaphora, and founder-carousel metaphors now sort first in scan output and rewrite prompts
-- **Rewrite prompts** split tier 1 structural hits vs other patterns so the model fixes architecture before vocabulary slop
-- **18 new structural cousin rules** synced in local scan engine (`scan.ts`, `tier-one.ts`)
-
-## [2.9.25] — 2026-07-04
-
-### Fixed
-- **MCP stdio pollution** — `hyv mcp` no longer prints setup banners to stdout when spawned by Cursor/Claude/ChatGPT (fixes "Unexpected token … is not valid JSON" toast spam on app open)
-- Auto-detects piped stdout (`!isTTY`) or explicit `--stdio` flag; MCP configs now use `mcp --stdio`
-- Interactive terminal runs still show setup on stderr before the JSON-RPC server starts
-
-## [2.9.15] — 2026-06-18
-
-### Added
-- `mcp-profile-hydrate` — syncs voice profile into MCP agent configs after setup
-- `mcp-integrate` — writes MCP server entries for cursor, claude, codex, windsurf, and more
-- Postinstall detects installed agents and suggests `hyv mcp --setup`
-
-### Fixed
-- `hyv mcp --test` validates 13 setup checks including ChatGPT actions
-- Agent docs updated for one-command MCP setup across all supported editors
-
-## [2.9.11] — 2026-06-12
-
-### Fixed
-- Data safety: preserve profiles with voice anchors, learned patterns, or dashboard-edited markdown
-- Welcome sync accepts `force: true` to intentionally overwrite preserved server profiles
-- `hyv sync` keeps newer local profiles (uses `updated_at` metadata); `--force` overwrites
-- JSON profile cache (`.hyv/cache/profiles/*.json`) backs up before overwrite; skips stale server snapshots
-- `~/.hyv/auth.json` backed up to `.hyv.bak` before each write
-- Web login: fixed email `body` ReferenceError in strict mode; Google sign-in warms `/ready` and retries on 503
-- Legacy `dashboard.html` email login fixed (`user` response, OTP `code` field, cold-start retries)
-- Static copy/sitemap: `holdyourvoice.com/dashboard` → `/app`
-
-## [2.9.10] — 2026-06-12
-
-### Fixed
-- **Data safety** — welcome profile sync no longer overwrites enriched dashboard profiles (keywords, signature, rules, flashcard onboarding)
-- Local profile cache backs up to `.hyv.bak` before overwrite; refuses empty content replacing real data
-- `hyv sync` skips empty server profile payloads instead of wiping local cache
-
-## [2.9.9] — 2026-06-12
-
-### Fixed
-- Welcome step 4 failure copy — says `hyv welcome` retry, not `hyv sync` (sync requires paid plan)
-- CLI plan/init/export/api messages point to `/app` and `/app/billing`, not `/dashboard`
-- Rewrite prompts no longer silently pick a cached profile when none is passed (generic rules as intended)
-- Web auth forgot-password and session check retry on cold-start 503s
-- Marketing email links point to `/app` not `/dashboard`
-
-## [2.9.7] — 2026-06-12
-
-### Fixed
-- `hyv sync` — profiles with spaces or missing slugs (e.g. "Say About Us") no longer crash with "Invalid profile name"
-- Welcome step 4 — clearer sync failure messages (HTTP status / server error)
-
-## [2.9.6] — 2026-06-12
-
-### Fixed
-- Welcome profile sync — server accepts `content` markdown from step 4 (upsert, no duplicate-profile 403)
-- Dashboard handoff — opens `/app/billing` with session cookie; falls back to billing URL if handoff fails
-- Edge worker handles `/cli/auth/web-handoff` (no container lag)
-
-### Changed
-- `hyv open dashboard` and paid-feature copy point to `/app` not `/dashboard`
-
-## [2.9.5] — 2026-06-12
-
-### Fixed
-- Post-signup browser opens `/app/billing` (live dashboard) instead of `/dashboard` (404)
-- Worker redirects `/dashboard` → `/app` for old links
-
-## [2.9.4] — 2026-06-12
-
-### Fixed
-- Welcome step 4 — one sign-in only; opens dashboard billing tab (no second Google login on marketing site)
-- `hyv plan --upgrade` opens authenticated dashboard billing instead of public pricing page
-
-### Changed
-- Step 4 copy tightened; spinners while account + profile sync run
-
-## [2.9.3] — 2026-06-12
-
-### Fixed
-- Browser signup OAuth — clearer error when Google denies; server fix for `redirect_uri_mismatch` (requires API deploy)
-
-## [2.9.2] — 2026-06-12
-
-### Changed
-- Welcome step 4 copy — warmer signup pitch, highlights $1 first month and what paid unlocks
-
-## [2.9.1] — 2026-06-12
-
-### Added
-- Welcome step 3 is skippable (Enter or `s`)
-- Multiline draft paste for testing (no more single-line shell chaos)
-- Document extraction for samples and scans: `.md`, `.txt`, `.html`, `.docx`, `.pdf`, `.skill`
-- Recursive folder scan; single files (including `.skill` archives) work in step 2
-- Minimal terminal spinners while reading, saving, and scanning
-
-### Fixed
-- Step 3 crash when scanning pasted text (`Cannot read properties of undefined (reading 'match')`) — profile now loads correctly
-- `ENOTDIR` when pointing at a file instead of a folder
-
-## [2.9.0] — 2026-06-12
-
-### Changed
-- `hyv welcome` — profile-first flow: name → samples (paste/folder/link/chat) → test draft → signup
-- Keeps tagline; drops install/init/mcp step list from welcome
-- MCP `hyv_welcome` supports `step`, `mode=extract_prompt`, and `profile` for agent-led onboarding
-- Postinstall points to `hyv welcome` instead of `hyv init`
-
-## [2.8.10] — 2026-06-12
-
-### Fixed
-- `hyv init` browser login opens Google OAuth again (`assertSafeOAuthUrl` allows `accounts.google.com`)
-
-## [2.8.9] — 2026-06-12
-
-### Improved
-- `hyv fix --in-place` matches batch/watch safeguards: interactive `[y/N]` or `--yes` + `.bak` backup
-- `hyv watch --command fix` ignores self-triggered saves after writing fixes
-- `hyv doctor` checks auth.json permissions, stale `hyv.md` vs `hyv.mdc`, and MCP stdio health
-- Shared `resolveCliEntry()` for MCP setup and stdio probes
-- Auth refresh + destructive-write unit tests
-
-### Changed
-- `dist/` built at publish/prepare — no longer committed to git
-
-## [2.8.8] — 2026-06-12
-
-### Security
-- OAuth browser flow verifies server `state` on callback (CSRF protection)
-- Automatic token refresh via `getValidToken()` before API calls
-- `HYV_API_URL` host allowlist; `assertSafeOpenUrl` for checkout/OAuth redirects
-- Profile name path traversal blocked; MCP file reads symlink-safe with `isError` responses
-- Sensitive `~/.hyv` files and dirs use `0o600`/`0o700` permissions
-
-### Fixed
-- `hyv doctor --fix-agents` uses correct postinstall-lib path
-- `hyv import` registered; `--fail-on-hit` exits code 2 (scan + batch)
-- Queue sync sends `original_text` / `accepted_text` for learning reinforce
-- Postinstall: Claude Desktop MCP merge with backup, Cursor `alwaysApply` rule, absolute MCP command path
-
-### Improved
-- `hyv mcp --test` spawns stdio subprocess and validates JSON-RPC `tools/list`
-- `hyv batch --fix --in-place` and `hyv watch --command fix` require `--yes` (`.bak` backups)
-- Stale duplicate agent/skill markdown removed from `assets/` (canonical copies in `agents/` + `skills/`)
-
-## [2.8.6] — 2026-06-12
-
-### Changed
-- `hyv welcome` — short onboarding: 4 steps, one-line demo, subscribe prompt (full lists moved to `hyv free`)
-- Shorter postinstall message before auto-welcome
-
-## [2.8.5] — 2026-06-12
-
-### Changed
-- `hyv welcome` slimmed down (superseded by 2.8.6 — use `npm i -g @holdyourvoice/hyv@2.8.6`)
-
-## [2.8.4] — 2026-06-12
-
-### Fixed
-- Postinstall only auto-runs welcome when npm shows script output; otherwise first bare `hyv` shows full onboarding (fixes silent global installs)
-
-## [2.8.3] — 2026-06-12
-
-### Fixed
-- `npm i -g` runs `hyv welcome` onboarding automatically on first install (no y/N prompt)
-- First bare `hyv` shows full onboarding when npm hid postinstall output
-- Upgraded `glob` to v13 — removes deprecated glob@11 warning during install
-
-## [2.8.2] — 2026-06-12
-
-### Added
-- Phase 5 marketing: `hyv content` (blog outlines, CI snippets, share templates)
-- `hyv plan --free` — canonical free vs paid matrix in terminal
-- `cli/assets/FREE-PAID.md` — shipped free/paid reference
-- Scan funnel hints + `scan_complete` / `init_success` telemetry events
-- Landing + npm README: npx-first install, free CLI section, SEO keywords
-
-### Improved
-- Postinstall, welcome, plan, and init flows promote npx + free local tier
-- npm package description optimized for cursor/claude/MCP discovery
-
-## [2.8.1] — 2026-06-12
-
-### Fixed
-- `postinstall-lib.js` now included in published tarball — `npm install` no longer fails on postinstall
-
-## [2.8.0] — 2026-06-12
-
-### Added
-- Full Phase 1–4 product plan: free local engine, hybrid analysis, MCP `hyv_analyze` / `hyv_clean`, learning loop UX, packaging hardening
-- `npm run test:smoke` — 28+ CLI regression checks
-- `npm run validate:publish` — prepublish tarball verification
-- Golden prompt tests, postinstall idempotency tests, edge-case suite
-
-### Fixed
-- `hyv check ""` no longer reports false clean — rejects empty input
-- Bundled CLI resolves correct package + rules version from `dist/`
-- Smoke tests avoid SIGPIPE false failures when piping CLI output
-
-## [2.7.1] — 2026-06-12
-
-### Added
-- `hyv upgrade` — check and install latest global CLI
-- `hyv mcp --setup` and `hyv mcp --test` — agent setup + health check
-- MCP tools: `hyv_analyze` (hybrid server+local), `hyv_clean` (scan→fix→validate pipeline)
-- `hyv reinforce --last` — learn from last fix/rewrite session
-- Free-first local engine: scan, fix, check, score, diff work offline without subscription
-- `hyv welcome` / `hyv free` — onboarding with live demo
-- Profile-aware local pipeline: never-list, learned patterns, anchors, cadence
-- Opt-in telemetry: `HYV_TELEMETRY=1`
-
-### Improved
-- Postinstall upgrades agent instructions via `~/.hyv/agents-version.json`
-- `hyv status` shows engine/rules version, drift, evolution summary
-- `hyv doctor` reports full engine label + `--fix-agents`
-- Published package excludes Python dev scripts and `src/`
-
-### Fixed
-- Bundled CLI reads correct `package.json` version from `dist/`

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 scoped agent rules and configures MCP for claude desktop and cursor (plus claude code, windsurf, codex, command code skills when detected). HYV runs automatically for publishable copy or an explicit voice request, not routine chat or engineering work. 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,82 +0,0 @@
-# Hold Your Voice — Agent Instructions
-
-The user has a voice profile for publishable copy. Use it for 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 — do these automatically
-
-**For eligible publishable copy or an explicit HYV/voice request:**
-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 create or rewrite eligible copy:**
-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
-
-**Do not auto-run HYV** for routine chat, Q&A, analysis, research, planning, coding, debugging, reviews, logs, operational work, code comments, or internal engineering-status messages. If the request is ambiguous, bypass HYV unless the user explicitly asks for it.
-
-**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) | Eligible publishable copy or an explicit HYV request |
-| `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. All host instructions share the same activation boundary: publishable copy or an explicit voice request uses HYV; routine chat and engineering work bypass it.
-
-## 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,47 +0,0 @@
-# Hold Your Voice — Writing Rules
-
-The user has a voice profile for publishable copy: social posts, newsletters, blogs, landing or product pages, campaigns, and external audience-facing emails. Apply it whenever the user explicitly asks for HYV, a voice profile, or writing in their voice.
-
-Do not apply these rules to routine chat, Q&A, analysis, research, planning, coding, debugging, reviews, logs, operational work, code comments, or internal engineering-status messages. If a request is ambiguous, bypass HYV unless the user explicitly requests it.
-
-## 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,45 +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.
-
-## When to use HYV
-
-Run `hyv_scan` or use the `hyv_scan` MCP tool before delivering eligible publishable copy:
-- Social posts, threads, and public replies
-- Newsletters, blogs, articles, and landing or product pages
-- Campaigns and external audience-facing emails
-
-Run `hyv_rewrite` or use the `hyv_rewrite` MCP tool when eligible copy needs voice work, or whenever the user explicitly asks for HYV or voice-profile writing.
-
-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.
-
-## 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`