@holdyourvoice/hyv 0.1.0 → 0.1.1

package/agents/claude-code.md

@@ -7,41 +7,51 @@ When the user asks to write, rewrite, or edit text "in their voice", "using thei
 Recognize these patterns:
 - `hyv shashank` or `hyv <name>` — rewrite using the named voice profile
 - `write this in my voice` / `rewrite in my voice` — use the default profile
+- `rewrite the above in my voice` — rewrite the text above the user's message
+- `rewrite this paragraph in my voice` — rewrite selected/referenced text
 - `check my voice` / `scan my voice` / `voice check` — run `hyv scan`
 - `voice status` / `hyv status` — show account status
 
-## Workflow
+## Workflows
 
-### To rewrite text in a user's voice:
+### 1. Inline rewrite (text in conversation)
 
-1. If there's a draft file, run:
+When the user says "rewrite the above in my voice" or "rewrite this in my voice" and the text is in the conversation (not a file):
+
+1. Capture the text the user wants rewritten (the previous message, a code block, a paragraph, etc.)
+2. Run:
    ```bash
-   hyv rewrite <profile> <file>
+   hyv rewrite <profile> --text "the captured text here"
    ```
-   If no file, pipe the text:
+   Or pipe it:
    ```bash
-   echo "the draft text" | hyv rewrite <profile>
+   printf '%s' "the captured text" | hyv rewrite <profile>
    ```
+3. The CLI outputs a structured prompt. Read it.
+4. Execute the rewrite following the prompt's instructions.
+5. Present the rewritten text to the user.
 
-2. The CLI outputs a structured prompt to stdout. Read it.
+### 2. File rewrite
 
-3. Execute the rewrite following the prompt's instructions. The prompt contains:
-   - The voice profile (keywords, tone, anchors, never-list)
-   - Issues found in the draft
-   - The draft text
-   - Rewrite rules
+When the user references a file:
 
-4. Present the rewritten text to the user.
+1. Run:
+   ```bash
+   hyv rewrite <profile> <file.md>
+   ```
+2. Read the structured prompt from stdout.
+3. Execute the rewrite.
+4. Present or write the result.
 
-### To check writing for issues:
+### 3. Scan (check for issues)
 
 ```bash
 hyv scan
 ```
 
-This scans all `.md` files in the current directory. Shows issues with line numbers and severity.
+Scans all `.md` files in the current directory for AI patterns and voice drift.
 
-### To list available profiles:
+### 4. List profiles
 
 ```bash
 hyv profiles
@@ -49,8 +59,10 @@ hyv profiles
 
 ## Rules
 
-- The CLI never calls an LLM. It generates prompts. You execute them.
-- Always preserve the original meaning when rewriting.
-- Match the voice profile's rhythm, vocabulary, and patterns.
-- If no profile is specified, use the default from `.hyv.yml` or ask the user.
-- If the CLI isn't installed, tell the user to run `npx @holdyourvoice/hyv init`.
+- The CLI never calls an LLM. It generates prompts. **You** execute the rewrite.
+- Always preserve the original meaning and factual claims.
+- Match the voice profile's rhythm, vocabulary, sentence patterns, and tone.
+- If no profile is specified, use the default from `.hyv.yml` or ask the user which profile.
+- If the CLI isn't installed, tell the user: `npx @holdyourvoice/hyv init`
+- When rewriting inline text, always use `--text` or pipe via stdin. Never save to a temp file.
+- Present the rewritten text directly in the conversation. Don't save to a file unless asked.

package/agents/codex.md

@@ -1,22 +1,34 @@
 # Hold Your Voice (HYV) — Codex Integration
 
-When the user mentions "voice", "brand voice", "hyv", or asks to rewrite in their voice, use the `hyv` CLI.
+When the user mentions "voice", "brand voice", "hyv", "rewrite in my voice", or asks to rewrite text using their voice profile, use the `hyv` CLI.
 
 ## Quick Reference
 
-| User says | Command |
-|-----------|---------|
-| `hyv <name>` | `hyv rewrite <name> <current-file>` |
-| `write this in my voice` | `hyv rewrite <default-profile> <file>` |
-| `check my voice` | `hyv scan` |
-| `voice profiles` | `hyv profiles` |
-| `voice status` | `hyv status` |
+| User says | What to do |
+|-----------|-----------|
+| `hyv shashank` | Capture the text, run `hyv rewrite shashank --text "..."`, execute the prompt |
+| `rewrite the above in my voice` | Capture the text above, run `hyv rewrite --text "..."`, execute |
+| `write this in my voice` | Capture the referenced text, run `hyv rewrite --text "..."`, execute |
+| `rewrite draft.md in my voice` | Run `hyv rewrite <profile> draft.md`, execute the prompt |
+| `check my voice` | Run `hyv scan` |
+| `voice profiles` | Run `hyv profiles` |
+| `voice status` | Run `hyv status` |
 
-## How rewrite works
+## How inline rewrite works
 
-1. Run `hyv rewrite <profile> <file>` — outputs a structured prompt to stdout
-2. Read the prompt and execute the rewrite
-3. Present the rewritten text
+1. User says "rewrite the above in my voice" (or similar)
+2. Capture the text from the conversation context
+3. Run: `hyv rewrite <profile> --text "captured text"`
+4. Read the structured prompt from stdout
+5. Execute the rewrite — match the voice profile's patterns, rhythm, vocabulary
+6. Present the rewritten text directly in the conversation
+
+## How file rewrite works
+
+1. Run: `hyv rewrite <profile> file.md`
+2. Read the prompt from stdout
+3. Execute the rewrite
+4. Present or write the result
 
 ## Install
 

package/dist/index.js

@@ -42,8 +42,9 @@ Expecting one of '${s.join("', '")}'`);let i=`${t}Help`;return this.on(i,r=>{let
   ${W()} ${m.dim("scan")}
 `);let a=0;for(let l of r)if(l.findings.length!==0){console.log(`  ${m.bold(l.file)} ${m.dim(`(${l.lines} lines)`)}`);for(let h of l.findings)on(h),a++;console.log("")}an(o),t.failOnHit&&o.red+o.yellow>0&&process.exit(1)}var mt=I(require("fs"));bt();function dr(n,t,e,s){let i=[];if(i.push("You are rewriting a draft to match a specific voice profile."),i.push(""),i.push("<voice_profile>"),i.push(`<name>${n.name}</name>`),n.brand&&i.push(`<brand>${n.brand}</brand>`),n.description&&i.push(`<description>${n.description}</description>`),n.keywords?.length&&i.push(`<keywords>${n.keywords.join(", ")}</keywords>`),i.push(""),i.push(t),i.push("</voice_profile>"),i.push(""),s.length>0){i.push("<issues_found>");let r=s.filter(a=>a.severity==="red"),o=s.filter(a=>a.severity==="yellow");r.length&&i.push(`Critical issues (${r.length}): ${r.map(a=>a.pattern).join(", ")}`),o.length&&i.push(`Advisory issues (${o.length}): ${o.map(a=>a.pattern).join(", ")}`),i.push("</issues_found>"),i.push("")}return i.push("<draft>"),i.push(e),i.push("</draft>"),i.push(""),i.push("<instruction>"),i.push("Rewrite this draft to match the voice profile. Rules:"),i.push("1. Preserve the original meaning and all factual claims"),i.push("2. Match the profile's rhythm, tone, vocabulary, and sentence patterns"),i.push("3. Fix every critical issue listed above"),i.push("4. Remove AI-slop patterns (delve, leverage, tapestry, etc.)"),i.push("5. Ground your style in the anchor passages from the profile"),i.push("6. Never use words from the never-list"),i.push("7. Keep the same format (markdown headings, lists, links)"),i.push("8. Return ONLY the rewritten text, no commentary"),i.push("</instruction>"),i.join(`
 `)}async function pr(n,t,e){let i=Ht().profile,r;n&&t?(i=n,r=t):n&&(n.endsWith(".md")||mt.existsSync(n)?r=n:i=n),i||(console.log(`
-  ${m.red("\u2717")} no profile specified`),console.log(`    ${m.dim("usage:")} hyv rewrite <profile> <file>`),console.log(`    ${m.dim("or set a default:")} hyv init --profile <name>`),process.exit(1));let o;r?(mt.existsSync(r)||(console.log(`
-  ${m.red("\u2717")} file not found: ${r}`),process.exit(1)),o=mt.readFileSync(r,"utf-8")):o=mt.readFileSync(0,"utf-8"),o.trim()||(console.log(`
+  ${m.red("\u2717")} no profile specified`),console.log(`    ${m.dim("usage:")} hyv rewrite <profile> <file>`),console.log(`    ${m.dim("       ")} hyv rewrite <profile> --text "your text here"`),console.log(`    ${m.dim("       ")} echo "text" | hyv rewrite <profile>`),console.log(`    ${m.dim("or set a default:")} hyv init --profile <name>`),process.exit(1));let o;e.text?o=e.text:r?(mt.existsSync(r)||(console.log(`
+  ${m.red("\u2717")} file not found: ${r}`),process.exit(1)),o=mt.readFileSync(r,"utf-8")):(process.stdin.isTTY&&(console.log(`
+  ${m.red("\u2717")} no text provided`),console.log(`    ${m.dim("usage:")} hyv rewrite <profile> --text "your text here"`),console.log(`    ${m.dim("       ")} echo "text" | hyv rewrite <profile>`),process.exit(1)),o=mt.readFileSync(0,"utf-8")),o.trim()||(console.log(`
   ${m.red("\u2717")} empty draft`),process.exit(1)),console.log(`
   ${W()} ${m.dim("rewrite")}
 `);let a,l;try{console.log(`  ${m.dim("fetching profile:")} ${m.bold(i)}`);let f=await tt(`/cli/profiles/${encodeURIComponent(i)}`);a=f.profile,l=f.body||"",ms(a.slug||i,l)}catch{let f=ps(i);f||(console.log(`  ${m.red("\u2717")} profile not found: ${i}`),console.log(`    ${m.dim("run:")} hyv profiles ${m.dim("to see available profiles")}`),process.exit(1)),a={id:"",slug:i,name:i},l=f,console.log(`  ${m.dim("using cached profile")}`)}console.log(`  ${m.dim("scanning draft...")}`);let{results:h}=await He([r||"draft.md"],[]),u=h[0]?.findings||[];u.length>0?console.log(`  ${m.yellow(String(u.length))} issues found`):console.log(`  ${m.green("\u2713")} no issues found`);let c=dr(a,l,o,u);e.output?(mt.writeFileSync(e.output,c),console.log(`
@@ -60,4 +61,4 @@ ${"\u2500".repeat(60)}`),console.log(c),console.log(`${"\u2500".repeat(60)}
 `);try{await gs("/cli/learning/reinforce",{original:e,edited:s}),console.log(`  ${m.green("\u2713")} learning signal sent`)}catch(i){console.log(`  ${m.red("\u2717")} failed: ${i.message}`),process.exit(1)}}async function wr(n,t){gt.existsSync(n)||(console.log(`
   ${m.red("\u2717")} file not found: ${n}`),process.exit(1));let e=gt.readFileSync(n,"utf-8");console.log(`
   ${W()} ${m.dim("add sample")}
-`);try{await gs("/cli/learning/add",{text:e,profile:t.profile}),console.log(`  ${m.green("\u2713")} sample added${t.profile?` to ${m.bold(t.profile)}`:""}`)}catch(s){console.log(`  ${m.red("\u2717")} failed: ${s.message}`),process.exit(1)}}var lt=new ai;lt.name("hyv").description("hold your voice \u2014 voice gate layer for ai workflows").version("0.1.0");lt.command("init").description("authenticate and set up your project").option("-p, --profile <name>","set default voice profile").option("-k, --key <key>","use a license key directly").action(n=>cn(n.profile,{key:n.key}));lt.command("scan").description("scan local .md files for ai patterns and voice drift").argument("[paths...]","files or directories to scan").option("--json","output as json").option("--fail-on-hit","exit with code 1 if issues found").action((n,t)=>fr(n,t));lt.command("rewrite").description("generate a rewrite prompt for your ai agent").argument("[profile-or-file]","voice profile name or .md file").argument("[file]",".md file to rewrite").option("-o, --output <file>","write prompt to file instead of stdout").action((n,t,e)=>pr(n,t,e));lt.command("profiles").description("list your voice profiles").option("--json","output as json").action(n=>mr(n));lt.command("status").description("show account and cli status").action(()=>gr());lt.command("reinforce").description("send learning signals from an edited draft").argument("<original>","original .md file").argument("<edited>","edited .md file").action((n,t)=>yr(n,t));lt.command("add").description("add a writing sample to your voice profile").argument("<file>",".md file to add as sample").option("-p, --profile <name>","target profile").action((n,t)=>wr(n,t));lt.parse();
+`);try{await gs("/cli/learning/add",{text:e,profile:t.profile}),console.log(`  ${m.green("\u2713")} sample added${t.profile?` to ${m.bold(t.profile)}`:""}`)}catch(s){console.log(`  ${m.red("\u2717")} failed: ${s.message}`),process.exit(1)}}var lt=new ai;lt.name("hyv").description("hold your voice \u2014 voice gate layer for ai workflows").version("0.1.0");lt.command("init").description("authenticate and set up your project").option("-p, --profile <name>","set default voice profile").option("-k, --key <key>","use a license key directly").action(n=>cn(n.profile,{key:n.key}));lt.command("scan").description("scan local .md files for ai patterns and voice drift").argument("[paths...]","files or directories to scan").option("--json","output as json").option("--fail-on-hit","exit with code 1 if issues found").action((n,t)=>fr(n,t));lt.command("rewrite").description("generate a rewrite prompt for your ai agent").argument("[profile-or-file]","voice profile name or .md file").argument("[file]",".md file to rewrite").option("-o, --output <file>","write prompt to file instead of stdout").option("-t, --text <text>","inline text to rewrite (instead of file/stdin)").action((n,t,e)=>pr(n,t,e));lt.command("profiles").description("list your voice profiles").option("--json","output as json").action(n=>mr(n));lt.command("status").description("show account and cli status").action(()=>gr());lt.command("reinforce").description("send learning signals from an edited draft").argument("<original>","original .md file").argument("<edited>","edited .md file").action((n,t)=>yr(n,t));lt.command("add").description("add a writing sample to your voice profile").argument("<file>",".md file to add as sample").option("-p, --profile <name>","target profile").action((n,t)=>wr(n,t));lt.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holdyourvoice/hyv",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Hold Your Voice — voice gate layer for AI workflows",
   "main": "dist/index.js",
   "bin": {