@holdyourvoice/hyv 2.3.0 → 2.3.1

package/agents/chatgpt.md

@@ -0,0 +1,18 @@
+# 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

package/agents/claude-code.md

@@ -0,0 +1,39 @@
+# 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_scan` with the text → get issues
+2. `hyv_rewrite` with the text → get auto-fixed version + LLM prompt for remaining issues
+3. `hyv_validate` after rewriting → verify the output matches the voice
+
+### CLI commands (fallback):
+```bash
+echo "text to check" | hyv scan -
+hyv rewrite file.md
+hyv profiles
+```
+
+## 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

package/agents/codex.md

@@ -0,0 +1,22 @@
+# 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` on any text before delivering it
+- `hyv_rewrite` to fix issues found by scan
+- `hyv_validate` to verify the output
+
+## CLI fallback
+```bash
+echo "text" | hyv scan -
+hyv rewrite file.md
+hyv profiles
+```
+
+## Rules
+- Always scan before delivering prose content
+- Always rewrite if scan finds issues
+- Preserve meaning, match voice profile

package/agents/cursor.md

@@ -0,0 +1,19 @@
+# Hold Your Voice
+
+The user has a voice profile. Use HYV MCP tools for all writing tasks.
+
+## When to use
+- Any email, post, doc, or content creation
+- Before delivering any prose to the user
+- When editing or improving text
+
+## Tools
+- `hyv_scan` — check text for AI patterns
+- `hyv_rewrite` — fix issues and match voice
+- `hyv_validate` — verify output matches voice
+- `hyv_profiles` — list available profiles
+
+## Rules
+- Always scan before delivering content
+- Preserve meaning when rewriting
+- Match the user's voice profile exactly

package/agents/generic.md

@@ -0,0 +1,30 @@
+# 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` on the text
+2. If issues found, run `hyv_rewrite` to fix them
+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` on it
+3. Fix issues with `hyv_rewrite`
+4. Deliver the cleaned version
+
+## Available tools
+- `hyv_scan` — scan text for AI patterns and voice drift
+- `hyv_rewrite` — auto-fix patterns and generate LLM prompt for remaining issues
+- `hyv_validate` — score text against voice profile
+- `hyv_profiles` — list available 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, tell the user to run `hyv init` then `hyv new <name>`

package/agents/windsurf.md

@@ -0,0 +1,12 @@
+# Hold Your Voice
+
+Use HYV MCP tools for all writing tasks. The user has a voice profile.
+
+## Auto-trigger
+- `hyv_scan` before delivering any text
+- `hyv_rewrite` to fix found issues
+- `hyv_validate` after rewriting
+
+## Rules
+- Always scan user-facing content
+- Preserve meaning, match voice profile

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holdyourvoice/hyv",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "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": {
@@ -44,7 +44,8 @@
     "scripts/",
     "assets/",
     "skills/",
-    "README.md"
+    "README.md",
+    "agents/"
   ],
   "repository": {
     "type": "git",

package/assets/chatgpt-instructions 2.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/chatgpt-instructions 3.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/claude-code-skill 2.md

@@ -1,24 +0,0 @@
-## Hold Your Voice — automated voice rewriting
-
-when the user asks to "write in my voice", "rewrite this in my voice", or "make this sound like me":
-
-1. read their voice profile at `~/.hyv/voice.md`
-2. run `hyv rewrite --text "<their text>"` to generate a structured rewrite prompt
-3. execute the prompt — rewrite the text yourself using your own llm
-4. present the rewritten text
-5. when the user accepts it, run `hyv reinforce original.md edited.md` to teach the system
-
-### available commands
-
-- `hyv scan <file>` — check a draft for voice drift and ai patterns
-- `hyv rewrite <file>` — generate a rewrite prompt for your llm
-- `hyv validate <file>` — verify a rewrite matches the voice profile
-- `hyv reinforce <original> <edited>` — teach the system what was accepted
-- `hyv sync` — refresh cached profiles and rules
-- `hyv status` — show auth and plan info
-
-### important
-
-- hyv never calls an llm. it generates prompts you execute yourself.
-- voice profiles live at `~/.hyv/voice.md`
-- always call `hyv validate` after rewriting to verify the result

package/assets/cursor-rules 2.md

@@ -1,12 +0,0 @@
-# Hold Your Voice — Cursor Rules
-
-when writing or rewriting content, match the voice profile below. do not use AI-slop words (delve, leverage, tapestry, in today's fast-paced, not just X but Y, etc.). match rhythm, vocabulary, and sentence patterns from the profile.
-
-your voice profile is at `~/.hyv/voice.md`. load it and use it as your writing guide.
-
-when the user says "rewrite in my voice", "make this sound like me", or similar:
-
-1. run: `hyv rewrite --text "<text>"`
-2. the cli generates a structured rewrite prompt
-3. execute the prompt yourself — rewrite the text matching the voice profile
-4. present the result

package/assets/cursor-rules 3.md

@@ -1,12 +0,0 @@
-# Hold Your Voice — Cursor Rules
-
-when writing or rewriting content, match the voice profile below. do not use AI-slop words (delve, leverage, tapestry, in today's fast-paced, not just X but Y, etc.). match rhythm, vocabulary, and sentence patterns from the profile.
-
-your voice profile is at `~/.hyv/voice.md`. load it and use it as your writing guide.
-
-when the user says "rewrite in my voice", "make this sound like me", or similar:
-
-1. run: `hyv rewrite --text "<text>"`
-2. the cli generates a structured rewrite prompt
-3. execute the prompt yourself — rewrite the text matching the voice profile
-4. present the result

package/scripts/postinstall 2.js

@@ -1,110 +0,0 @@
-#!/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('');
-}