@holdyourvoice/hyv 2.9.24 → 2.9.26

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable CLI changes. Also mirrored to [holdyourvoice.com/changelog](https://holdyourvoice.com/changelog) for user-facing releases.
 
+## [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

package/assets/ai-eliminator-rules.md

@@ -21,6 +21,16 @@ patterns, and uniform sentence rhythm within paragraphs.
 - "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."

package/dist/index.js

@@ -5413,7 +5413,7 @@ function printFreePaidMatrix(opts = {}) {
   First month $1 \u2192 ${PRICING_URL}`));
   console.log(import_chalk.default.dim("  hyv init  |  hyv plan --upgrade\n"));
 }
-var import_chalk, NPX_EXAMPLES, FREE_CLI_COMMANDS, PAID_FEATURES, FREE_WEB_TOOLS, COMMUNITY_URL, PRICING_URL, DASHBOARD_BILLING_URL;
+var import_chalk, NPX_EXAMPLES, FREE_CLI_COMMANDS, PAID_FEATURES, FREE_WEB_TOOLS, COMMUNITY_URL, X_URL, PRICING_URL, DASHBOARD_BILLING_URL;
 var init_free_paid = __esm({
   "src/lib/free-paid.ts"() {
     "use strict";
@@ -5460,6 +5460,7 @@ var init_free_paid = __esm({
       { name: "Blog", url: "https://holdyourvoice.com/blog" }
     ];
     COMMUNITY_URL = "https://holdyourvoice.com/community";
+    X_URL = "https://x.com/istupidpreneur";
     PRICING_URL = "https://holdyourvoice.com/#pricing";
     DASHBOARD_BILLING_URL = "https://holdyourvoice.com/dashboard?tab=billing";
   }
@@ -11315,6 +11316,23 @@ var init_patterns = __esm({
       { id: "struct.lesson-setup", category: "structure", severity: "yellow", regex: /\bhere'?s what .{3,60} taught\b/gi, suggestion: "just share the lesson" },
       // THE BIG ONE — antithesis negation pattern (Voice DNA: FATAL)
       { id: "struct.this-isnt-x-this-is-y", category: "structure", severity: "red", regex: /\bthis isn'?t .{2,40}\.?\s*(?:this is|it'?s) .{2,40}/gi, suggestion: "FATAL: delete the negation, just state the positive claim" },
+      { id: "struct.this-is-not-it-is", category: "structure", severity: "red", regex: /\bthis\s+is\s+not\b.{3,80}\.\s*it\s+is\b/gi, suggestion: 'FATAL: "this is not X. it is Y" \u2014 state what it is directly' },
+      { id: "struct.is-not-it-is", category: "structure", severity: "red", regex: /\bis\s+not\b.{3,80}\.\s*it\s+is\b/gi, suggestion: "FATAL: negation-then-reveal \u2014 drop the denial" },
+      { id: "struct.you-are-not-you-are", category: "structure", severity: "red", regex: /\byou\s+are\s+not\b.{3,80}\.\s*you\s+are\b/gi, suggestion: "FATAL: identity reframe carousel \u2014 say what they are" },
+      { id: "struct.you-no-longer-you-are", category: "structure", severity: "red", regex: /\byou\s+are\s+no\s+longer\b.{3,80}\.\s*you\s+are\b/gi, suggestion: "FATAL: escalation reframe \u2014 one grounded sentence" },
+      { id: "struct.you-stop-you-start", category: "structure", severity: "red", regex: /\byou\s+stop\b.{3,50}\.\s*you\s+start\b/gi, suggestion: "FATAL: pivot cadence \u2014 describe the behavior change" },
+      { id: "struct.need-negation-pivot", category: "structure", severity: "red", regex: /\b(?:do\s+not|don'?t)\s+need\b.{3,50}\.\s*(?:they|you)\s+need\b/gi, suggestion: "FATAL: need antithesis \u2014 say what they need" },
+      { id: "struct.they-call-it-anaphora", category: "structure", severity: "red", regex: /\bthey\s+call\s+it\b[^.!?]{2,50}[.!?]\s*they\s+call\s+it\b/gi, suggestion: "FATAL: staccato anaphora \u2014 name it once" },
+      { id: "struct.parallel-because", category: "structure", severity: "red", regex: /\b(\w+)\s+because\b[^.!?]{3,60}[.!?]\s*they\s+\1\s+because\b/gi, suggestion: "FATAL: parallel sermon rhythm \u2014 merge into one sentence" },
+      { id: "struct.parallel-endure", category: "structure", severity: "red", regex: /\bendure\s+through\b[^.!?]{3,60}[.!?]\s*they\s+endure\s+through\b/gi, suggestion: "FATAL: parallel maxim \u2014 say it once" },
+      { id: "struct.simple-but-uncomfortable", category: "structure", severity: "red", regex: /\bsimple\s+but\s+uncomfortable\s*:/gi, suggestion: "truth-posture colon reveal \u2014 state the mechanism" },
+      { id: "struct.hidden-goal", category: "structure", severity: "red", regex: /\bthe\s+hidden\s+goal\b/gi, suggestion: "reveal framing \u2014 say the goal directly" },
+      { id: "struct.quiet-promise", category: "structure", severity: "red", regex: /\bquiet\s+promise\b/gi, suggestion: "profundity metaphor \u2014 name the actual commitment" },
+      { id: "struct.competing-void", category: "structure", severity: "red", regex: /\bcompeting\s+with\s+the\s+void\b/gi, suggestion: "screenshot profundity \u2014 name the real competitor" },
+      { id: "struct.architect-reality", category: "structure", severity: "red", regex: /\barchitect\s+of\s+(?:a\s+)?new\s+reality\b/gi, suggestion: "thought-leader grandiosity \u2014 describe what you build" },
+      { id: "struct.friction-momentum", category: "structure", severity: "red", regex: /\b(?:turns?\s+)?friction\s+into\s+momentum\b/gi, suggestion: "transformation buzzphrase \u2014 explain the mechanism" },
+      { id: "struct.cognitive-architecture", category: "structure", severity: "red", regex: /\bcognitive\s+architecture\b/gi, suggestion: "abstract systems metaphor \u2014 use a concrete scene" },
+      { id: "struct.defines-good", category: "structure", severity: "red", regex: /\bdefines\s+what\s+good\s+looks\s+like\b/gi, suggestion: "consultant language \u2014 show an example of good" },
       { id: "struct.not-x-y", category: "structure", severity: "red", regex: /\bnot .{2,30}\.?\s*.{2,30}\b/gi, suggestion: 'the "Not X. Y." pattern is an AI tell \u2014 just state Y' },
       { id: "struct.forget-x", category: "structure", severity: "red", regex: /\bforget .{2,40}\.?\s*(?:this is|it'?s|you need)/gi, suggestion: "don't negate \u2014 just state what you mean" }
     ];
@@ -11374,6 +11392,34 @@ var init_patterns = __esm({
   }
 });
 
+// src/lib/tier-one.ts
+function isTierOneRule(ruleId) {
+  const id = String(ruleId || "");
+  if (TIER_ONE_PREFIXES.some((p) => id.startsWith(p)))
+    return true;
+  return TIER_ONE_SIGNAL_IDS.has(id);
+}
+function tierSortKey(ruleId) {
+  return isTierOneRule(ruleId) ? 0 : 1;
+}
+var TIER_ONE_PREFIXES, TIER_ONE_SIGNAL_IDS;
+var init_tier_one = __esm({
+  "src/lib/tier-one.ts"() {
+    "use strict";
+    TIER_ONE_PREFIXES = ["structural_", "founder_"];
+    TIER_ONE_SIGNAL_IDS = /* @__PURE__ */ new Set([
+      "struct.this-isnt-x-this-is-y",
+      "struct.not-x-y",
+      "struct.negation-cascade",
+      "struct.which-is-another",
+      "struct.in-other-words",
+      "struct.moment-becomes",
+      "struct.same-better",
+      "struct.generic-buyer"
+    ]);
+  }
+});
+
 // src/lib/scan.ts
 function words(text) {
   return (text || "").match(/[a-zA-Z][a-zA-Z0-9']*/g) || [];
@@ -11484,6 +11530,9 @@ function scanText(text) {
     }
   }
   return hits.sort((a, b) => {
+    const tier = tierSortKey(a.rule) - tierSortKey(b.rule);
+    if (tier !== 0)
+      return tier;
     if (a.line !== b.line)
       return a.line - b.line;
     return a.rule.localeCompare(b.rule);
@@ -11494,6 +11543,7 @@ var init_scan = __esm({
   "src/lib/scan.ts"() {
     "use strict";
     init_patterns();
+    init_tier_one();
     AI_PATTERN_RULES = [
       {
         id: "ai_antithesis",
@@ -11554,6 +11604,75 @@ var init_scan = __esm({
       {
         id: "founder_cadence_same_better",
         pattern: /\bsame\s+[^.!?\n]{1,35}[.!?]\s*(?:better|nicer|cleaner|calmer|safer)\s+[^.!?\n]{1,35}[.!?]?/i
+      },
+      // structural cousins — cross-sentence binary reframing (top priority)
+      {
+        id: "structural_this_is_not_it_is",
+        pattern: /\bthis\s+is\s+not\b.{3,80}\.\s*it\s+is\b/i
+      },
+      {
+        id: "structural_is_not_it_is",
+        pattern: /\bis\s+not\b.{3,80}\.\s*it\s+is\b/i
+      },
+      {
+        id: "structural_you_are_not_you_are",
+        pattern: /\byou\s+are\s+not\b.{3,80}\.\s*you\s+are\b/i
+      },
+      {
+        id: "structural_you_no_longer_you_are",
+        pattern: /\byou\s+are\s+no\s+longer\b.{3,80}\.\s*you\s+are\b/i
+      },
+      {
+        id: "structural_you_stop_you_start",
+        pattern: /\byou\s+stop\b.{3,50}\.\s*you\s+start\b/i
+      },
+      {
+        id: "structural_need_negation_pivot",
+        pattern: /\b(?:do\s+not|don'?t)\s+need\b.{3,50}\.\s*(?:they|you)\s+need\b/i
+      },
+      {
+        id: "structural_they_call_it_anaphora",
+        pattern: /\bthey\s+call\s+it\b[^.!?]{2,50}[.!?]\s*they\s+call\s+it\b/i
+      },
+      {
+        id: "structural_parallel_verb_because",
+        pattern: /\b(\w+)\s+because\b[^.!?]{3,60}[.!?]\s*they\s+\1\s+because\b/i
+      },
+      {
+        id: "structural_parallel_endure_through",
+        pattern: /\bendure\s+through\b[^.!?]{3,60}[.!?]\s*they\s+endure\s+through\b/i
+      },
+      {
+        id: "structural_simple_but_uncomfortable",
+        pattern: /\bsimple\s+but\s+uncomfortable\s*:/i
+      },
+      {
+        id: "structural_hidden_goal",
+        pattern: /\bthe\s+hidden\s+goal\b/i
+      },
+      {
+        id: "structural_quiet_promise",
+        pattern: /\bquiet\s+promise\b/i
+      },
+      {
+        id: "founder_competing_with_void",
+        pattern: /\bcompeting\s+with\s+the\s+void\b/i
+      },
+      {
+        id: "founder_architect_of_reality",
+        pattern: /\barchitect\s+of\s+(?:a\s+)?new\s+reality\b/i
+      },
+      {
+        id: "founder_friction_into_momentum",
+        pattern: /\b(?:turns?\s+)?friction\s+into\s+momentum\b/i
+      },
+      {
+        id: "founder_cognitive_architecture",
+        pattern: /\bcognitive\s+architecture\b/i
+      },
+      {
+        id: "founder_defines_good_looks_like",
+        pattern: /\bdefines\s+what\s+good\s+looks\s+like\b/i
       }
     ];
     ABSTRACT_STYLE_WORDS = /* @__PURE__ */ new Set([
@@ -16371,6 +16490,8 @@ var path11 = __toESM(require("path"));
 init_config();
 init_signals();
 init_profile_parse();
+init_scan();
+init_tier_one();
 function loadPromptTemplate() {
   const templatePath = path11.join(CACHE_DIR2, "prompt-template.md");
   try {
@@ -16419,6 +16540,7 @@ Rules:
 - "Not X. Y." is banned. Just state Y.
 - "Forget X. This is Y." is banned. Just state Y.
 - ANY sentence that negates one framing then asserts a corrected one fails.
+- Tier 1 structural patterns (binary reframes, negation pivots, parallel sermon cadence) outrank vocabulary fixes. Kill the architecture first.
 
 Voice profile:
 {profile_block}
@@ -16426,8 +16548,11 @@ Voice profile:
 Extra constraints:
 {constraints_block}
 
-Flagged lines:
-{issue_lines}
+Tier 1 \u2014 structural (fix first):
+{tier_one_lines}
+
+Other flagged patterns:
+{other_lines}
 
 Draft with line numbers ({draft_name}):
 {numbered_draft}
@@ -16487,6 +16612,38 @@ function buildProfileBlock(fullProfile, fallbackName) {
   }
   return { block: "(no voice profile supplied \u2014 use generic voice rules)", name: null };
 }
+function collectPromptIssues(draftContent, fullProfile) {
+  const issues = [];
+  const seen = /* @__PURE__ */ new Set();
+  const addIssue = (line, rule, detail) => {
+    const key = `${line}|${rule}|${detail.slice(0, 80)}`;
+    if (seen.has(key))
+      return;
+    seen.add(key);
+    issues.push({ line, rule, detail, tierOne: isTierOneRule(rule) });
+  };
+  for (const signal of extractSignals(draftContent, fullProfile).signals) {
+    addIssue(signal.line, signal.id, signal.suggestion);
+  }
+  for (const hit of scanText(draftContent)) {
+    addIssue(hit.line, hit.rule, hit.phrase || hit.text || "");
+  }
+  issues.sort((a, b) => {
+    const tier = tierSortKey(a.rule) - tierSortKey(b.rule);
+    if (tier !== 0)
+      return tier;
+    if (a.line !== b.line)
+      return a.line - b.line;
+    return a.rule.localeCompare(b.rule);
+  });
+  return issues;
+}
+function formatIssueLines(issues, tierOneOnly) {
+  const filtered = issues.filter((i) => i.tierOne === tierOneOnly);
+  if (!filtered.length)
+    return "- none found";
+  return filtered.map((i) => `- line ${i.line} [${i.rule}]: ${i.detail}`).join("\n");
+}
 function buildRewritePrompt(options) {
   const {
     draftPath,
@@ -16497,16 +16654,17 @@ function buildRewritePrompt(options) {
     skipScan = false
   } = options;
   const { block: profileBlock, name: profileUsed } = buildProfileBlock(fullProfile, profileName);
-  const signals = skipScan ? [] : extractSignals(draftContent, fullProfile).signals;
-  const issueLines = signals.length > 0 ? signals.map((s) => `- line ${s.line} [${s.id}]: ${s.suggestion}`).join("\n") : "- none found by deterministic scan";
+  const issues = skipScan ? [] : collectPromptIssues(draftContent, fullProfile);
+  const tierOneLines = formatIssueLines(issues, true);
+  const otherLines = formatIssueLines(issues, false);
   const draftLines = draftContent.split("\n");
   const numberedDraft = draftLines.map((line, i) => `${i + 1}: ${line}`).join("\n");
   const template = loadPromptTemplate();
-  const prompt = template.replace("{profile_block}", profileBlock).replace("{constraints_block}", constraints || "(none)").replace("{issue_lines}", issueLines).replace("{draft_name}", draftPath).replace("{numbered_draft}", numberedDraft);
+  const prompt = template.replace("{profile_block}", profileBlock).replace("{constraints_block}", constraints || "(none)").replace("{tier_one_lines}", tierOneLines).replace("{other_lines}", otherLines).replace("{draft_name}", draftPath).replace("{numbered_draft}", numberedDraft);
   return {
     prompt,
     profileUsed,
-    issuesFound: signals.length
+    issuesFound: issues.length
   };
 }
 
@@ -17766,6 +17924,18 @@ var import_child_process4 = require("child_process");
 // src/lib/cli-entry.ts
 var fs18 = __toESM(require("fs"));
 var path17 = __toESM(require("path"));
+
+// src/lib/mcp-stdio.ts
+function isMcpStdioMode(opts) {
+  if (opts?.stdio)
+    return true;
+  if (process.env.HYV_MCP_STDIO === "1" || process.env.HYV_MCP_STDIO === "true")
+    return true;
+  return !process.stdout.isTTY;
+}
+var MCP_SERVER_ARGS = ["mcp", "--stdio"];
+
+// src/lib/cli-entry.ts
 function resolveCliEntry() {
   const candidates = [
     path17.resolve(process.argv[1] || ""),
@@ -17777,9 +17947,9 @@ function resolveCliEntry() {
 function mcpServerCommand() {
   const entry = resolveCliEntry();
   if (entry) {
-    return { command: process.execPath, args: [entry, "mcp"] };
+    return { command: process.execPath, args: [entry, ...MCP_SERVER_ARGS] };
   }
-  return { command: "hyv", args: ["mcp"] };
+  return { command: "hyv", args: [...MCP_SERVER_ARGS] };
 }
 function mcpServerSnippet() {
   const { command, args: args2 } = mcpServerCommand();
@@ -17792,9 +17962,9 @@ async function testMcpStdioSubprocess() {
   if (!entry)
     return { ok: false };
   return new Promise((resolve18) => {
-    const child = (0, import_child_process4.spawn)(process.execPath, [entry, "mcp"], {
+    const child = (0, import_child_process4.spawn)(process.execPath, [entry, "mcp", "--stdio"], {
       stdio: ["pipe", "pipe", "pipe"],
-      env: { ...process.env, HYV_POSTINSTALL_QUIET: "1" }
+      env: { ...process.env, HYV_POSTINSTALL_QUIET: "1", HYV_MCP_STDIO: "1" }
     });
     let buffer = "";
     let settled = false;
@@ -19159,16 +19329,17 @@ More: hyv content ci`
   },
   share: {
     title: "Share your voice fingerprint",
-    body: `Social post template:
+    body: `Social post template (X / LinkedIn):
 
 I run my AI drafts through @holdyourvoice/hyv before they ship.
 
-Free local scan caught [N] patterns in 2 seconds \u2014 no API, offline.
+Free local scan caught 34 patterns in 2 seconds \u2014 score 0/100. no API, offline.
 
 Cursor/Claude agents can call hyv mcp tools directly.
 
 Try: npx @holdyourvoice/hyv welcome
 
+${X_URL}
 ${COMMUNITY_URL}`
   }
 };
@@ -19448,7 +19619,7 @@ function formatChatGptConnectorGuide() {
     "2. Settings \u2192 Connectors \u2192 Add connector",
     "3. Name: **hold your voice**",
     "4. Command: **hyv** (or absolute path below if connector fails)",
-    "5. Arguments: **mcp**",
+    "5. Arguments: **mcp --stdio**",
     "",
     "If the connector fails to start, use absolute paths:",
     `   command: ${mcpCmd.command}`,
@@ -20334,7 +20505,7 @@ function printMcpSetup() {
   console.log(import_chalk35.default.dim("  Skill: ~/.commandcode/skills/hyv/SKILL.md\n"));
   console.log(import_chalk35.default.bold("ChatGPT Desktop (manual connector)"));
   console.log(import_chalk35.default.dim("  Settings \u2192 Connectors \u2192 add connector"));
-  console.log(import_chalk35.default.dim("  Name: hold your voice  |  Command: hyv  |  Arguments: mcp"));
+  console.log(import_chalk35.default.dim("  Name: hold your voice  |  Command: hyv  |  Arguments: mcp --stdio"));
   console.log(import_chalk35.default.dim("  Guide: ~/.chatgpt/hyv-mcp-connector.txt (after hyv doctor --fix-agents)"));
   console.log(import_chalk35.default.dim("  hyv mcp --setup-chatgpt"));
   if (IS_WIN2) {
@@ -20638,7 +20809,7 @@ registerWelcomeCommand(program2);
 registerContentCommand(program2);
 registerUpgradeCommand(program2);
 registerShareCommand(program2);
-program2.command("mcp").description("Detect installed apps, configure MCP, and start the MCP server").option("--setup", "Show MCP setup for Claude Desktop, Cursor, Windsurf, Codex").option("--test", "Run MCP health check (tools, profile, stdio)").option("--setup-chatgpt", "Show ChatGPT connector setup instructions").option("--force", "Force re-configure MCP even if already integrated").action(async (opts) => {
+program2.command("mcp").description("Detect installed apps, configure MCP, and start the MCP server").option("--setup", "Show MCP setup for Claude Desktop, Cursor, Windsurf, Codex").option("--test", "Run MCP health check (tools, profile, stdio)").option("--setup-chatgpt", "Show ChatGPT connector setup instructions").option("--force", "Force re-configure MCP even if already integrated").option("--stdio", "Stdio MCP mode \u2014 no stdout banners (auto when stdout is piped)").action(async (opts) => {
   if (opts.setup) {
     printMcpSetup();
     return;
@@ -20675,7 +20846,7 @@ program2.command("mcp").description("Detect installed apps, configure MCP, and s
     console.log(import_chalk36.default.dim("  3. Add connector:"));
     console.log(import_chalk36.default.dim("     Name:      ") + import_chalk36.default.cyan("hold your voice"));
     console.log(import_chalk36.default.dim("     Command:   ") + import_chalk36.default.cyan("hyv") + import_chalk36.default.dim(" (full path on Windows if needed)"));
-    console.log(import_chalk36.default.dim("     Arguments: ") + import_chalk36.default.cyan("mcp"));
+    console.log(import_chalk36.default.dim("     Arguments: ") + import_chalk36.default.cyan("mcp --stdio"));
     console.log(import_chalk36.default.dim("  4. Save, restart ChatGPT Desktop"));
     console.log(import_chalk36.default.dim('  5. Test: "scan this with hold your voice"\n'));
     console.log(import_chalk36.default.dim("  If connector fails to start, use full paths from:"));
@@ -20697,20 +20868,26 @@ program2.command("mcp").description("Detect installed apps, configure MCP, and s
     console.log("");
     return;
   }
-  console.log(import_chalk36.default.bold("\nhold your voice \u2014 detecting and configuring mcp...\n"));
+  if (isMcpStdioMode(opts)) {
+    await startMcpServer();
+    return;
+  }
+  const err = (msg) => process.stderr.write(msg + "\n");
+  err(import_chalk36.default.bold("\nhold your voice \u2014 detecting and configuring mcp...\n"));
   const result = runMcpAutoIntegrate({ force: Boolean(opts.force) });
+  const reportLines = [];
+  const origLog = console.log;
+  console.log = (...args2) => {
+    reportLines.push(args2.map(String).join(" "));
+  };
   printMcpIntegrateReport(result, { force: Boolean(opts.force) });
-  console.log(import_chalk36.default.green.bold("\n\u2713 hold your voice \u2014 mcp setup complete\n"));
-  console.log(import_chalk36.default.dim("  " + import_chalk36.default.bold("To integrate HYV with all MCP-compatible apps on your machine")));
-  console.log(import_chalk36.default.dim("  (Cursor, Claude Desktop, Windsurf, Antigravity, OpenCode, ChatGPT, Codex,"));
-  console.log(import_chalk36.default.dim("   Command Code, and more) \u2014 simply run:"));
-  console.log("");
-  console.log(import_chalk36.default.cyan("    hyv mcp"));
-  console.log("");
-  console.log(import_chalk36.default.dim("  It auto-detects installed apps, configures MCP servers, and is ready"));
-  console.log(import_chalk36.default.dim("  for scanning, rewriting, and voice-profile validation in any tool.\n"));
-  console.log(import_chalk36.default.dim("\nstarting MCP server (press Ctrl+C to stop)...\n"));
-  startMcpServer();
+  console.log = origLog;
+  for (const line of reportLines)
+    err(line);
+  err(import_chalk36.default.green.bold("\n\u2713 hold your voice \u2014 mcp setup complete\n"));
+  err(import_chalk36.default.dim("  restart cursor / claude desktop if they were open during setup"));
+  err(import_chalk36.default.dim("\nstarting MCP server (press Ctrl+C to stop) \u2014 JSON-RPC on stdout...\n"));
+  await startMcpServer();
 });
 program2.command("export").description("Export voice profile for LLMs").argument("[format]", "Export format (claude, chatgpt, generic, cursor)", "claude").option("--output <file>", "Write to file instead of stdout").option("--json", "Output as JSON").action(async (format, opts) => {
   await exportCommand(format, opts);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holdyourvoice/hyv",
-  "version": "2.9.24",
+  "version": "2.9.26",
   "description": "Free local AI writing scan for cursor & claude. MCP server, 220+ pattern detection, voice profiles. npx @holdyourvoice/hyv welcome",
   "main": "dist/index.js",
   "bin": {

package/scripts/postinstall-lib.js

@@ -78,9 +78,9 @@ function markOnboardingComplete(hyvDir, pkgVersion) {
 function resolveHyvMcpCommand(pkgDir) {
   const entry = path.join(pkgDir, 'dist', 'index.js');
   if (fs.existsSync(entry)) {
-    return { command: process.execPath, args: [entry, 'mcp'] };
+    return { command: process.execPath, args: [entry, 'mcp', '--stdio'] };
   }
-  return { command: 'hyv', args: ['mcp'] };
+  return { command: 'hyv', args: ['mcp', '--stdio'] };
 }
 
 /** OpenCode local MCP uses a command array: [node, entry, mcp] */