@holdyourvoice/hyv 2.9.15 → 2.9.17

package/README.md

@@ -20,7 +20,7 @@ npx @holdyourvoice/hyv scan draft.md
 curl -fsSL https://holdyourvoice.com/install.sh | bash
 
 # windows (powershell)
-irm https://holdyourvoice.com/install.ps1 | iex
+powershell -ExecutionPolicy Bypass -c "irm https://holdyourvoice.com/install.ps1 | iex"
 ```
 
 Already have node 18+?

package/dist/index.js

@@ -4381,14 +4381,14 @@ var require_templates = __commonJS({
       }
       return results;
     }
-    function buildStyle(chalk35, styles) {
+    function buildStyle(chalk36, styles) {
       const enabled = {};
       for (const layer of styles) {
         for (const style of layer.styles) {
           enabled[style[0]] = layer.inverse ? null : style.slice(1);
         }
       }
-      let current = chalk35;
+      let current = chalk36;
       for (const [styleName, styles2] of Object.entries(enabled)) {
         if (!Array.isArray(styles2)) {
           continue;
@@ -4400,7 +4400,7 @@ var require_templates = __commonJS({
       }
       return current;
     }
-    module2.exports = (chalk35, temporary) => {
+    module2.exports = (chalk36, temporary) => {
       const styles = [];
       const chunks = [];
       let chunk = [];
@@ -4410,13 +4410,13 @@ var require_templates = __commonJS({
         } else if (style) {
           const string = chunk.join("");
           chunk = [];
-          chunks.push(styles.length === 0 ? string : buildStyle(chalk35, styles)(string));
+          chunks.push(styles.length === 0 ? string : buildStyle(chalk36, styles)(string));
           styles.push({ inverse, styles: parseStyle(style) });
         } else if (close) {
           if (styles.length === 0) {
             throw new Error("Found extraneous } in Chalk template literal");
           }
-          chunks.push(buildStyle(chalk35, styles)(chunk.join("")));
+          chunks.push(buildStyle(chalk36, styles)(chunk.join("")));
           chunk = [];
           styles.pop();
         } else {
@@ -4464,16 +4464,16 @@ var require_source = __commonJS({
       }
     };
     var chalkFactory = (options) => {
-      const chalk36 = {};
-      applyOptions(chalk36, options);
-      chalk36.template = (...arguments_) => chalkTag(chalk36.template, ...arguments_);
-      Object.setPrototypeOf(chalk36, Chalk.prototype);
-      Object.setPrototypeOf(chalk36.template, chalk36);
-      chalk36.template.constructor = () => {
+      const chalk37 = {};
+      applyOptions(chalk37, options);
+      chalk37.template = (...arguments_) => chalkTag(chalk37.template, ...arguments_);
+      Object.setPrototypeOf(chalk37, Chalk.prototype);
+      Object.setPrototypeOf(chalk37.template, chalk37);
+      chalk37.template.constructor = () => {
         throw new Error("`chalk.constructor()` is deprecated. Use `new chalk.Instance()` instead.");
       };
-      chalk36.template.Instance = ChalkClass;
-      return chalk36.template;
+      chalk37.template.Instance = ChalkClass;
+      return chalk37.template;
     };
     function Chalk(options) {
       return chalkFactory(options);
@@ -4584,7 +4584,7 @@ var require_source = __commonJS({
       return openAll + string + closeAll;
     };
     var template;
-    var chalkTag = (chalk36, ...strings) => {
+    var chalkTag = (chalk37, ...strings) => {
       const [firstString] = strings;
       if (!isArray(firstString) || !isArray(firstString.raw)) {
         return strings.join(" ");
@@ -4600,14 +4600,14 @@ var require_source = __commonJS({
       if (template === void 0) {
         template = require_templates();
       }
-      return template(chalk36, parts.join(""));
+      return template(chalk37, parts.join(""));
     };
     Object.defineProperties(Chalk.prototype, styles);
-    var chalk35 = Chalk();
-    chalk35.supportsColor = stdoutColor;
-    chalk35.stderr = Chalk({ level: stderrColor ? stderrColor.level : 0 });
-    chalk35.stderr.supportsColor = stderrColor;
-    module2.exports = chalk35;
+    var chalk36 = Chalk();
+    chalk36.supportsColor = stdoutColor;
+    chalk36.stderr = Chalk({ level: stderrColor ? stderrColor.level : 0 });
+    chalk36.stderr.supportsColor = stderrColor;
+    module2.exports = chalk36;
   }
 });
 
@@ -5638,7 +5638,9 @@ async function authenticateWithBrowser() {
   const authData = await new Promise((resolve16, reject) => {
     const timeout = setTimeout(() => {
       server.close();
-      reject(new Error("Authentication timeout. Please try again."));
+      reject(new Error(
+        'Authentication timeout \u2014 browser did not return to the local callback.\nThis usually means Windows Defender Firewall blocked the local server.\nFix: run in PowerShell as Admin:\n  New-NetFirewallRule -DisplayName "hyv-cli" -Direction Inbound -LocalPort ' + port + " -Protocol TCP -Action Allow\nOr use the manual API key path: hyv init --api-key <key>"
+      ));
     }, 12e4);
     server.on("request", async (req, res) => {
       const url = new URL(req.url || "/", `http://127.0.0.1:${port}`);
@@ -11741,13 +11743,14 @@ function buildWelcomeGuide(opts = {}) {
     lines.push("");
   }
   lines.push("start in terminal:");
-  lines.push("  hyv welcome          walk through all 4 steps");
+  lines.push("  hyv welcome          walk through all 4 steps (auto-configures mcp)");
   lines.push("  hyv welcome --guide  show this guide (for agents / scripts)");
   lines.push("");
   lines.push("or jump in:");
   lines.push("  hyv import <name> <file.md>   save a profile");
   lines.push("  hyv scan draft.md             test a draft");
   lines.push("  hyv init                      signup when ready");
+  lines.push("  hyv mcp --setup               view all mcp configs");
   lines.push("");
   return lines.join("\n");
 }
@@ -11758,6 +11761,7 @@ function buildWelcomeHeader(opts = {}) {
       "",
       "  hyv welcome   set up your voice (4 steps)",
       "  hyv scan      test any draft free",
+      "  mcp auto-configured for your installed apps",
       ""
     ].join("\n");
   }
@@ -12186,7 +12190,8 @@ async function runInteractiveWelcome() {
     console.log(import_chalk12.default.green("done \u2014 your voice profile is ready.\n"));
     console.log(import_chalk12.default.dim("  hyv scan draft.md"));
     console.log(import_chalk12.default.dim(`  hyv rewrite draft.md --profile ${profileName}`));
-    console.log(import_chalk12.default.dim("  hyv mcp --setup\n"));
+    console.log(import_chalk12.default.dim("  mcp auto-configured for your installed apps"));
+    console.log(import_chalk12.default.dim("  hyv mcp --setup   (view all configs)\n"));
   } catch (err) {
     console.error(import_chalk12.default.red(`
   ${err.message || "welcome flow stopped"}
@@ -12318,6 +12323,7 @@ function buildWelcomeMessage(opts = {}) {
   lines.push("  set up your voice");
   lines.push("  hyv welcome");
   lines.push("");
+  lines.push("  mcp auto-configured for your installed apps");
   lines.push(`  unlock learning \u2192 ${PRICING_URL}`);
   lines.push("");
   return lines.join("\n");
@@ -15759,7 +15765,7 @@ var {
 } = import_index.default;
 
 // src/index.ts
-var import_chalk34 = __toESM(require_source());
+var import_chalk35 = __toESM(require_source());
 
 // src/commands/init.ts
 var import_chalk4 = __toESM(require_source());
@@ -18992,6 +18998,7 @@ function registerOpenCommand(program3) {
 }
 
 // src/commands/welcome.ts
+var import_chalk31 = __toESM(require_source());
 init_welcome();
 
 // src/lib/onboarding.ts
@@ -19020,6 +19027,20 @@ function markOnboardingComplete(version) {
 init_welcome_flow();
 var fs25 = __toESM(require("fs"));
 var path23 = __toESM(require("path"));
+function runBackgroundMcpSetup() {
+  const pkgDir = path23.resolve(__dirname, "..");
+  const postinstallLib = path23.join(pkgDir, "scripts", "postinstall-lib.js");
+  if (!fs25.existsSync(postinstallLib))
+    return;
+  try {
+    const { setupAgents } = require(postinstallLib);
+    const result = setupAgents({ pkgDir, quiet: true });
+    if (result.configured.length > 0) {
+      console.log(import_chalk31.default.dim(`  \u2713 mcp auto-configured: ${result.configured.join(", ")}`));
+    }
+  } catch {
+  }
+}
 function registerWelcomeCommand(program3) {
   const pkgVersion3 = (() => {
     try {
@@ -19029,10 +19050,15 @@ function registerWelcomeCommand(program3) {
       return "0.0.0";
     }
   })();
-  program3.command("welcome").description("Set up your voice: name \u2192 samples \u2192 test \u2192 signup").option("--guide", "Show LLM/terminal guide (no prompts)").option("--extract-prompt [name]", "Print chat extraction prompt for agents").option("--step <n>", "Show guide for step 1\u20134", (v2) => parseInt(v2, 10)).option("--no-demo", "Skip sample scan line in guide mode").option("--quiet", "Suppress output").action(async (opts) => {
-    if (opts.quiet)
+  program3.command("welcome").description("Set up your voice: name \u2192 samples \u2192 test \u2192 signup").option("--guide", "Show LLM/terminal guide (no prompts)").option("--extract-prompt [name]", "Print chat extraction prompt for agents").option("--step <n>", "Show guide for step 1\u20134", (v2) => parseInt(v2, 10)).option("--no-demo", "Skip sample scan line in guide mode").option("--skip-mcp", "Skip automatic MCP setup for IDE agents").option("--quiet", "Suppress output").action(async (opts) => {
+    if (opts.quiet) {
+      if (!opts.skipMcp)
+        runBackgroundMcpSetup();
       return;
+    }
     const fromPostinstall = process.env.HYV_POSTINSTALL_ONBOARDING === "1";
+    if (!opts.skipMcp && !fromPostinstall)
+      runBackgroundMcpSetup();
     if (opts.extractPrompt !== void 0) {
       const name = typeof opts.extractPrompt === "string" ? opts.extractPrompt : "my-voice";
       console.log("\n" + buildVoiceExtractionPrompt(name) + "\n");
@@ -19071,7 +19097,7 @@ function getWelcomeText(args2) {
 }
 
 // src/commands/content.ts
-var import_chalk31 = __toESM(require_source());
+var import_chalk32 = __toESM(require_source());
 init_free_paid();
 var TEMPLATES = {
   cursor: {
@@ -19145,19 +19171,19 @@ ${COMMUNITY_URL}`
 function registerContentCommand(program3) {
   program3.command("content").description("Blog outlines, CI snippets, and share templates").argument("[topic]", "cursor | agents | ci | share", "cursor").option("--list", "List available templates").action((topic, opts) => {
     if (opts.list) {
-      console.log(import_chalk31.default.bold("\nhyv content templates\n"));
+      console.log(import_chalk32.default.bold("\nhyv content templates\n"));
       for (const [key, t2] of Object.entries(TEMPLATES)) {
-        console.log(import_chalk31.default.dim(`  ${key}`) + ` \u2014 ${t2.title}`);
+        console.log(import_chalk32.default.dim(`  ${key}`) + ` \u2014 ${t2.title}`);
       }
       console.log("");
       return;
     }
     const t = TEMPLATES[topic] || TEMPLATES.cursor;
-    console.log(import_chalk31.default.bold(`
+    console.log(import_chalk32.default.bold(`
 ${t.title}
 `));
     console.log(t.body);
-    console.log(import_chalk31.default.dim("\nBlog: https://holdyourvoice.com/blog\n"));
+    console.log(import_chalk32.default.dim("\nBlog: https://holdyourvoice.com/blog\n"));
   });
 }
 
@@ -19185,7 +19211,7 @@ init_telemetry();
 init_access();
 
 // src/lib/mcp-integrate.ts
-var import_chalk32 = __toESM(require_source());
+var import_chalk33 = __toESM(require_source());
 var fs26 = __toESM(require("fs"));
 var os12 = __toESM(require("os"));
 var path24 = __toESM(require("path"));
@@ -19358,67 +19384,6 @@ function formatMcpIntegrateReportText(result, opts = {}) {
   }
   return lines.join("\n");
 }
-function printMcpIntegrateReport(result, opts = {}) {
-  const { agentIdForConfiguredLabel, isAgentIntegrated } = loadPostinstallLib();
-  const configuredIds = new Set(
-    result.configured.map((label) => agentIdForConfiguredLabel(label)).filter(Boolean)
-  );
-  console.log(import_chalk32.default.bold("\nhold your voice \u2014 mcp integration\n"));
-  console.log(import_chalk32.default.dim(`  ${getEngineLabel()}
-`));
-  const welcome = readWelcomeState();
-  const profiles = listLocalProfileNames2();
-  if (profiles.length > 0) {
-    console.log(import_chalk32.default.dim(`  voice profiles: ${profiles.join(", ")}`));
-  } else {
-    console.log(import_chalk32.default.yellow("  no voice profile yet \u2014 mcp still works (free scan). finish onboarding in terminal or in-chat via hyv_welcome"));
-  }
-  if (welcome.completed_steps?.length) {
-    console.log(import_chalk32.default.dim(`  welcome progress: ${welcome.completed_steps.join(", ")}`));
-  }
-  console.log("");
-  if (result.detected.length === 0) {
-    console.log(import_chalk32.default.yellow("  no supported ai apps detected on this machine."));
-    console.log(import_chalk32.default.dim("\n  install cursor, claude desktop, chatgpt desktop, or another supported app,"));
-    console.log(import_chalk32.default.dim("  then run hyv mcp again \u2014 or hyv doctor --fix-agents to configure everything."));
-    console.log(import_chalk32.default.dim("\n  in chatgpt/claude/cursor: call hyv_welcome to onboard without the terminal."));
-    console.log(import_chalk32.default.dim("  chatgpt desktop: hyv mcp --setup-chatgpt\n"));
-    return;
-  }
-  console.log(import_chalk32.default.bold("detected apps"));
-  for (const app of result.detected) {
-    const justConfigured = configuredIds.has(app.id);
-    const integrated = isAgentIntegrated(app.id) || justConfigured;
-    const mark = app.integration === "manual" ? import_chalk32.default.yellow("\u25CB") : integrated ? import_chalk32.default.green("\u2713") : import_chalk32.default.cyan("\u2192");
-    const status = app.integration === "manual" ? "manual connector \u2014 see ~/.chatgpt/hyv-mcp-connector.txt" : justConfigured ? opts.force ? "updated now" : "configured now" : integrated ? "integrated" : "needs setup";
-    console.log(`  ${mark} ${app.label} \u2014 ${status}`);
-    console.log(import_chalk32.default.dim(`      ${app.reason} \xB7 ${app.integration}`));
-  }
-  if (result.configured.length > 0) {
-    console.log(import_chalk32.default.green(`
-  wired hyv into: ${result.configured.join(", ")}`));
-  }
-  if (result.warnings.length > 0) {
-    console.log(import_chalk32.default.yellow("\n  notes:"));
-    for (const warning of result.warnings) {
-      console.log(import_chalk32.default.yellow(`    ! ${warning}`));
-    }
-  }
-  const mcpApps = result.detected.filter((a) => a.integration === "mcp");
-  const manualApps = result.detected.filter((a) => a.integration === "manual");
-  console.log(import_chalk32.default.bold("\nnext steps"));
-  console.log(import_chalk32.default.dim("  in this app: hyv_welcome (onboarding) \xB7 hyv_mcp_setup (status/refresh) \xB7 hyv_demo (try a scan)"));
-  if (mcpApps.length > 0) {
-    console.log(import_chalk32.default.dim("  restart apps that use mcp (cursor, claude desktop, antigravity, opencode)"));
-  }
-  if (manualApps.length > 0) {
-    console.log(import_chalk32.default.dim("  chatgpt: settings \u2192 connectors \u2192 command hyv, arguments mcp"));
-    console.log(import_chalk32.default.dim("  full steps: hyv mcp --setup-chatgpt"));
-  }
-  console.log(import_chalk32.default.dim("  refresh stale configs after upgrade: hyv mcp --force"));
-  console.log(import_chalk32.default.dim("  verify: hyv mcp --test"));
-  console.log(import_chalk32.default.dim("  all hosts: hyv doctor --verify-hosts\n"));
-}
 
 // src/mcp.ts
 init_mcp_profile_hydrate();
@@ -20095,7 +20060,7 @@ async function startMcpServer() {
 }
 
 // src/lib/mcp-setup.ts
-var import_chalk33 = __toESM(require_source());
+var import_chalk34 = __toESM(require_source());
 var fs28 = __toESM(require("fs"));
 var path26 = __toESM(require("path"));
 var os14 = __toESM(require("os"));
@@ -20110,60 +20075,68 @@ function claudeDesktopConfigPath() {
   return path26.join(HOME2, "Library", "Application Support", "Claude", "claude_desktop_config.json");
 }
 function printMcpSetup() {
-  console.log(import_chalk33.default.bold("\nhold your voice \u2014 mcp setup\n"));
-  console.log(import_chalk33.default.dim(`  ${getEngineLabel()}
+  console.log(import_chalk34.default.bold("\nhold your voice \u2014 mcp setup\n"));
+  console.log(import_chalk34.default.dim(`  ${getEngineLabel()}
 `));
-  console.log(import_chalk33.default.bold("Claude Desktop"));
-  console.log(import_chalk33.default.dim("  Add to claude_desktop_config.json \u2192 mcpServers.hyv:"));
-  console.log(import_chalk33.default.cyan(`  ${mcpServerSnippet().split("\n").join("\n  ")}`));
-  console.log(import_chalk33.default.dim(`  Config: ${claudeDesktopConfigPath()}
+  console.log(import_chalk34.default.bold("Claude Desktop"));
+  console.log(import_chalk34.default.dim("  Add to claude_desktop_config.json \u2192 mcpServers.hyv:"));
+  console.log(import_chalk34.default.cyan(`  ${mcpServerSnippet().split("\n").join("\n  ")}`));
+  console.log(import_chalk34.default.dim(`  Config: ${claudeDesktopConfigPath()}
 `));
-  console.log(import_chalk33.default.bold("Cursor"));
-  console.log(import_chalk33.default.dim("  MCP: ~/.cursor/mcp.json \u2192 mcpServers.hyv (same JSON as above)"));
-  console.log(import_chalk33.default.dim("  Rule: ~/.cursor/rules/hyv.mdc (alwaysApply \u2014 auto via postinstall)\n"));
-  console.log(import_chalk33.default.bold("Claude Code"));
-  console.log(import_chalk33.default.dim("  Command: ~/.claude/commands/hyv.md"));
-  console.log(import_chalk33.default.dim("  Skill: ~/.claude/skills/hold-your-voice/SKILL.md\n"));
-  console.log(import_chalk33.default.bold("Windsurf"));
-  console.log(import_chalk33.default.dim("  Rule: ~/.windsurf/rules/hyv.md (trigger: always_on)\n"));
-  console.log(import_chalk33.default.bold("Codex"));
-  console.log(import_chalk33.default.dim("  Instructions: ~/.codex/AGENTS.md (merged on install)\n"));
-  console.log(import_chalk33.default.bold("Command Code"));
-  console.log(import_chalk33.default.dim("  Skill: ~/.commandcode/skills/hyv/SKILL.md\n"));
-  console.log(import_chalk33.default.bold("ChatGPT Desktop (manual connector)"));
-  console.log(import_chalk33.default.dim("  Settings \u2192 Connectors \u2192 add connector"));
-  console.log(import_chalk33.default.dim("  Name: hold your voice  |  Command: hyv  |  Arguments: mcp"));
-  console.log(import_chalk33.default.dim("  Guide: ~/.chatgpt/hyv-mcp-connector.txt (after hyv doctor --fix-agents)"));
-  console.log(import_chalk33.default.dim("  hyv mcp --setup-chatgpt\n"));
-  console.log(import_chalk33.default.bold("Antigravity"));
-  console.log(import_chalk33.default.dim("  MCP: ~/.gemini/config/mcp_config.json \u2192 mcpServers.hyv (auto via postinstall)\n"));
-  console.log(import_chalk33.default.bold("OpenCode"));
-  console.log(import_chalk33.default.dim("  MCP: ~/.config/opencode/opencode.jsonc \u2192 mcp.hyv (auto via postinstall)"));
-  console.log(import_chalk33.default.dim("  Rules: ~/.config/opencode/AGENTS.md\n"));
-  console.log(import_chalk33.default.bold("Auto-configure"));
-  console.log(import_chalk33.default.dim("  hyv mcp  (detect installed apps + wire mcp into them)"));
-  console.log(import_chalk33.default.dim("  hyv mcp --force  (refresh configs after hyv upgrade)"));
-  console.log(import_chalk33.default.dim("  hyv doctor --fix-agents  (configure all apps, not just detected)"));
-  console.log(import_chalk33.default.dim("  HYV_AUTO_CONFIGURE_AGENTS=0 npm i -g @holdyourvoice/hyv  (skip)\n"));
-  console.log(import_chalk33.default.bold("In-chat (no terminal)"));
-  console.log(import_chalk33.default.dim("  hyv_mcp_setup \u2014 status, integrate, or chatgpt connector steps"));
-  console.log(import_chalk33.default.dim("  hyv_welcome \u2014 finish onboarding inside Cursor/Claude/ChatGPT\n"));
-  console.log(import_chalk33.default.bold("Verify"));
-  console.log(import_chalk33.default.dim("  hyv mcp --test"));
-  console.log(import_chalk33.default.dim("  HYV_TELEMETRY=1 hyv mcp  (optional usage logging to ~/.hyv/telemetry/)\n"));
+  console.log(import_chalk34.default.bold("Cursor"));
+  console.log(import_chalk34.default.dim("  MCP: ~/.cursor/mcp.json \u2192 mcpServers.hyv (same JSON as above)"));
+  console.log(import_chalk34.default.dim("  Rule: ~/.cursor/rules/hyv.mdc (alwaysApply \u2014 auto via postinstall)\n"));
+  console.log(import_chalk34.default.bold("Claude Code"));
+  console.log(import_chalk34.default.dim("  Command: ~/.claude/commands/hyv.md"));
+  console.log(import_chalk34.default.dim("  Skill: ~/.claude/skills/hold-your-voice/SKILL.md\n"));
+  console.log(import_chalk34.default.bold("Windsurf"));
+  console.log(import_chalk34.default.dim("  Rule: ~/.windsurf/rules/hyv.md (trigger: always_on)\n"));
+  console.log(import_chalk34.default.bold("Codex"));
+  console.log(import_chalk34.default.dim("  Instructions: ~/.codex/AGENTS.md (merged on install)\n"));
+  console.log(import_chalk34.default.bold("Command Code"));
+  console.log(import_chalk34.default.dim("  Skill: ~/.commandcode/skills/hyv/SKILL.md\n"));
+  console.log(import_chalk34.default.bold("ChatGPT Desktop (manual connector)"));
+  console.log(import_chalk34.default.dim("  Settings \u2192 Connectors \u2192 add connector"));
+  console.log(import_chalk34.default.dim("  Name: hold your voice  |  Command: hyv  |  Arguments: mcp"));
+  console.log(import_chalk34.default.dim("  Guide: ~/.chatgpt/hyv-mcp-connector.txt (after hyv doctor --fix-agents)"));
+  console.log(import_chalk34.default.dim("  hyv mcp --setup-chatgpt"));
+  if (IS_WIN2) {
+    console.log(import_chalk34.default.dim("  Windows (Lenovo/Win11 often Restricted): if blocked use:"));
+    console.log(import_chalk34.default.cyan('    powershell -ExecutionPolicy Bypass -Command "hyv ..."'));
+    console.log(import_chalk34.default.dim("    Diagnose: Get-ExecutionPolicy -List"));
+    console.log(import_chalk34.default.dim("    Permanent fix: Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force"));
+    console.log(import_chalk34.default.dim("    For connectors: use full path printed in the .txt (node + .js)"));
+  }
+  console.log("");
+  console.log(import_chalk34.default.bold("Antigravity"));
+  console.log(import_chalk34.default.dim("  MCP: ~/.gemini/config/mcp_config.json \u2192 mcpServers.hyv (auto via postinstall)\n"));
+  console.log(import_chalk34.default.bold("OpenCode"));
+  console.log(import_chalk34.default.dim("  MCP: ~/.config/opencode/opencode.jsonc \u2192 mcp.hyv (auto via postinstall)"));
+  console.log(import_chalk34.default.dim("  Rules: ~/.config/opencode/AGENTS.md\n"));
+  console.log(import_chalk34.default.bold("Auto-configure"));
+  console.log(import_chalk34.default.dim("  hyv mcp  (detect installed apps + wire mcp into them)"));
+  console.log(import_chalk34.default.dim("  hyv mcp --force  (refresh configs after hyv upgrade)"));
+  console.log(import_chalk34.default.dim("  hyv doctor --fix-agents  (configure all apps, not just detected)"));
+  console.log(import_chalk34.default.dim("  HYV_AUTO_CONFIGURE_AGENTS=0 npm i -g @holdyourvoice/hyv  (skip)\n"));
+  console.log(import_chalk34.default.bold("In-chat (no terminal)"));
+  console.log(import_chalk34.default.dim("  hyv_mcp_setup \u2014 status, integrate, or chatgpt connector steps"));
+  console.log(import_chalk34.default.dim("  hyv_welcome \u2014 finish onboarding inside Cursor/Claude/ChatGPT\n"));
+  console.log(import_chalk34.default.bold("Verify"));
+  console.log(import_chalk34.default.dim("  hyv mcp --test"));
+  console.log(import_chalk34.default.dim("  HYV_TELEMETRY=1 hyv mcp  (optional usage logging to ~/.hyv/telemetry/)\n"));
 }
 async function runMcpSelfTest() {
-  console.log(import_chalk33.default.bold("\nhold your voice \u2014 mcp self-test\n"));
-  console.log(import_chalk33.default.dim(`  ${getEngineLabel()}
+  console.log(import_chalk34.default.bold("\nhold your voice \u2014 mcp self-test\n"));
+  console.log(import_chalk34.default.dim(`  ${getEngineLabel()}
 `));
   let passed = 0;
   let failed = 0;
   const tools = getMcpToolNames();
   if (tools.length >= 10) {
-    console.log(import_chalk33.default.green(`  \u2713 ${tools.length} MCP tools registered`));
+    console.log(import_chalk34.default.green(`  \u2713 ${tools.length} MCP tools registered`));
     passed++;
   } else {
-    console.log(import_chalk33.default.red(`  \u2717 expected 10+ tools, got ${tools.length}`));
+    console.log(import_chalk34.default.red(`  \u2717 expected 10+ tools, got ${tools.length}`));
     failed++;
   }
   const required = [
@@ -20177,89 +20150,89 @@ async function runMcpSelfTest() {
   ];
   for (const name of required) {
     if (tools.includes(name)) {
-      console.log(import_chalk33.default.green(`  \u2713 tool: ${name}`));
+      console.log(import_chalk34.default.green(`  \u2713 tool: ${name}`));
       passed++;
     } else {
-      console.log(import_chalk33.default.red(`  \u2717 missing tool: ${name}`));
+      console.log(import_chalk34.default.red(`  \u2717 missing tool: ${name}`));
       failed++;
     }
   }
   try {
     const welcome = await invokeMcpTool("hyv_welcome", {});
     if (welcome.includes("Hold Your Voice") || welcome.includes("hold your voice")) {
-      console.log(import_chalk33.default.green("  \u2713 hyv_welcome responds"));
+      console.log(import_chalk34.default.green("  \u2713 hyv_welcome responds"));
       passed++;
     } else {
-      console.log(import_chalk33.default.red("  \u2717 hyv_welcome unexpected output"));
+      console.log(import_chalk34.default.red("  \u2717 hyv_welcome unexpected output"));
       failed++;
     }
   } catch (e) {
-    console.log(import_chalk33.default.red(`  \u2717 hyv_welcome failed: ${e.message}`));
+    console.log(import_chalk34.default.red(`  \u2717 hyv_welcome failed: ${e.message}`));
     failed++;
   }
   try {
     const setup = await invokeMcpTool("hyv_mcp_setup", { action: "status" });
     if (setup.includes("HYV MCP status") && setup.includes("hyv_welcome")) {
-      console.log(import_chalk33.default.green("  \u2713 hyv_mcp_setup responds"));
+      console.log(import_chalk34.default.green("  \u2713 hyv_mcp_setup responds"));
       passed++;
     } else {
-      console.log(import_chalk33.default.red("  \u2717 hyv_mcp_setup unexpected output"));
+      console.log(import_chalk34.default.red("  \u2717 hyv_mcp_setup unexpected output"));
       failed++;
     }
   } catch (e) {
-    console.log(import_chalk33.default.red(`  \u2717 hyv_mcp_setup failed: ${e.message}`));
+    console.log(import_chalk34.default.red(`  \u2717 hyv_mcp_setup failed: ${e.message}`));
     failed++;
   }
   try {
     const demo = await invokeMcpTool("hyv_demo", {});
     if (demo.includes("Score") || demo.includes("issues")) {
-      console.log(import_chalk33.default.green("  \u2713 hyv_demo pipeline works"));
+      console.log(import_chalk34.default.green("  \u2713 hyv_demo pipeline works"));
       passed++;
     } else {
-      console.log(import_chalk33.default.red("  \u2717 hyv_demo unexpected output"));
+      console.log(import_chalk34.default.red("  \u2717 hyv_demo unexpected output"));
       failed++;
     }
   } catch (e) {
-    console.log(import_chalk33.default.red(`  \u2717 hyv_demo failed: ${e.message}`));
+    console.log(import_chalk34.default.red(`  \u2717 hyv_demo failed: ${e.message}`));
     failed++;
   }
   const voiceMd = path26.join(HOME2, ".hyv", "voice.md");
   if (fs28.existsSync(voiceMd)) {
-    console.log(import_chalk33.default.green("  \u2713 voice profile found"));
+    console.log(import_chalk34.default.green("  \u2713 voice profile found"));
     passed++;
   } else {
-    console.log(import_chalk33.default.dim("  - no voice.md (free local engine still works)"));
+    console.log(import_chalk34.default.dim("  - no voice.md (free local engine still works)"));
   }
   if (getDemoText().length > 100) {
-    console.log(import_chalk33.default.green("  \u2713 demo content available"));
+    console.log(import_chalk34.default.green("  \u2713 demo content available"));
     passed++;
   } else {
-    console.log(import_chalk33.default.red("  \u2717 demo content missing"));
+    console.log(import_chalk34.default.red("  \u2717 demo content missing"));
     failed++;
   }
   try {
     const stdio = await testMcpStdioSubprocess();
     if (stdio.ok && (stdio.toolCount || 0) >= 10) {
-      console.log(import_chalk33.default.green(`  \u2713 stdio MCP subprocess responds (${stdio.toolCount} tools)`));
+      console.log(import_chalk34.default.green(`  \u2713 stdio MCP subprocess responds (${stdio.toolCount} tools)`));
       passed++;
     } else if (stdio.ok) {
-      console.log(import_chalk33.default.yellow(`  ! stdio MCP subprocess ok but only ${stdio.toolCount || 0} tools`));
+      console.log(import_chalk34.default.yellow(`  ! stdio MCP subprocess ok but only ${stdio.toolCount || 0} tools`));
       failed++;
     } else {
-      console.log(import_chalk33.default.red("  \u2717 stdio MCP subprocess failed"));
+      console.log(import_chalk34.default.red("  \u2717 stdio MCP subprocess failed"));
       failed++;
     }
   } catch (e) {
-    console.log(import_chalk33.default.red(`  \u2717 stdio MCP subprocess failed: ${e.message}`));
+    console.log(import_chalk34.default.red(`  \u2717 stdio MCP subprocess failed: ${e.message}`));
     failed++;
   }
   console.log("");
   if (failed === 0) {
-    console.log(import_chalk33.default.green(`\u2713 all checks passed (${passed})`));
-    console.log(import_chalk33.default.dim("\nStart server: hyv mcp\n"));
+    console.log(import_chalk34.default.green(`\u2713 all checks passed (${passed})`));
+    console.log(import_chalk34.default.dim("\nStart server: hyv mcp\n"));
     return true;
   }
-  console.log(import_chalk33.default.yellow(`! ${failed} check(s) failed, ${passed} passed`));
+  console.log(import_chalk34.default.yellow(`! ${failed} check(s) failed, ${passed} passed`));
   return false;
 }
 
@@ -20427,7 +20400,7 @@ registerOpenCommand(program2);
 registerWelcomeCommand(program2);
 registerContentCommand(program2);
 registerUpgradeCommand(program2);
-program2.command("mcp").description("Detect local AI apps, wire hyv MCP into them, or start stdio server for hosts").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", "Refresh MCP configs even when already integrated (e.g. after hyv upgrade)").option("--stdio", "Start MCP stdio server (used by Cursor, Claude Desktop, etc.)").option("--integrate-only", "Detect and configure apps without starting stdio server").action(async (opts) => {
+program2.command("mcp").description("Start MCP server (for Claude Desktop and other MCP hosts)").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").action(async (opts) => {
   if (opts.setup) {
     printMcpSetup();
     return;
@@ -20438,21 +20411,59 @@ program2.command("mcp").description("Detect local AI apps, wire hyv MCP into the
     return;
   }
   if (opts.setupChatgpt) {
-    console.log(import_chalk34.default.bold("\nhold your voice \u2014 chatgpt desktop mcp setup\n"));
-    console.log(formatChatGptConnectorGuide());
-    console.log(import_chalk34.default.dim("\nBrowser chatgpt cannot use local MCP \u2014 desktop app only."));
-    console.log(import_chalk34.default.dim("In ChatGPT chat: call hyv_mcp_setup or hyv_welcome \u2014 no terminal needed.\n"));
+    const home = require("os").homedir();
+    const guide = require("path").join(home, ".chatgpt", "hyv-mcp-connector.txt");
+    console.log(import_chalk35.default.bold("\nhold your voice \u2014 chatgpt desktop setup\n"));
+    console.log(import_chalk35.default.bold("=== which setup do i have? ===\n"));
+    console.log(import_chalk35.default.dim('  If you see "New App" with a Server URL field:'));
+    console.log(import_chalk35.default.dim("    \u2192 Developer mode is ON \u2192 use PATH A (remote, below)"));
+    console.log(import_chalk35.default.dim('  If you see "Connectors" with Command/Arguments fields:'));
+    console.log(import_chalk35.default.dim("    \u2192 use PATH B (local, below)"));
+    console.log(import_chalk35.default.dim("  Neither? Turn Developer mode ON in ChatGPT settings.\n"));
+    console.log(import_chalk35.default.bold("=== PATH A \u2014 remote mcp (Developer mode \u2192 New App) ==="));
+    console.log(import_chalk35.default.dim("  Requires: paid HYV plan + ChatGPT Desktop + Developer mode ON\n"));
+    console.log(import_chalk35.default.dim("  1. In ChatGPT: Settings \u2192 turn ") + import_chalk35.default.cyan("Developer mode") + import_chalk35.default.dim(" ON"));
+    console.log(import_chalk35.default.dim("     (Accept the elevated risk warning \u2014 expected, not a HYV bug)"));
+    console.log(import_chalk35.default.dim("  2. Settings \u2192 Apps \u2192 ") + import_chalk35.default.cyan("New App"));
+    console.log(import_chalk35.default.dim("  3. Fill in:"));
+    console.log(import_chalk35.default.dim("     Name:           ") + import_chalk35.default.cyan("hold your voice"));
+    console.log(import_chalk35.default.dim("     Description:    ") + import_chalk35.default.cyan("Scans writing for AI patterns and voice drift"));
+    console.log(import_chalk35.default.dim("     Connection:     ") + import_chalk35.default.cyan("Server URL") + import_chalk35.default.dim(" \u2192 ") + import_chalk35.default.cyan("https://holdyourvoice.com/mcp"));
+    console.log(import_chalk35.default.dim("     Authentication: ") + import_chalk35.default.cyan("OAuth"));
+    console.log(import_chalk35.default.dim("     Checkbox:       ") + import_chalk35.default.cyan('"I understand and want to continue"'));
+    console.log(import_chalk35.default.dim("  4. Save \u2192 complete OAuth sign-in to holdyourvoice.com"));
+    console.log(import_chalk35.default.dim('  5. Test: "scan this with hold your voice"\n'));
+    console.log(import_chalk35.default.dim("  Cloud app setup: ") + import_chalk35.default.cyan("https://holdyourvoice.com/app/api/mcp"));
+    console.log(import_chalk35.default.dim("  Wiki guide:      ") + import_chalk35.default.cyan("https://holdyourvoice.com/wiki/use-hyv-in-chatgpt\n"));
+    console.log(import_chalk35.default.bold("=== PATH B \u2014 local connector (Connectors \u2192 Command/Arguments) ==="));
+    console.log(import_chalk35.default.dim("  Requires: Node.js 18+ + ChatGPT Desktop (free offline scan)\n"));
+    console.log(import_chalk35.default.dim("  1. Install hyv: ") + import_chalk35.default.cyan("npm i -g @holdyourvoice/hyv@latest && hyv welcome"));
+    console.log(import_chalk35.default.dim("  2. In ChatGPT: ") + import_chalk35.default.cyan("Settings \u2192 Connectors") + import_chalk35.default.dim(" (or https://chatgpt.com/#settings/Connectors)"));
+    console.log(import_chalk35.default.dim("  3. Add connector:"));
+    console.log(import_chalk35.default.dim("     Name:      ") + import_chalk35.default.cyan("hold your voice"));
+    console.log(import_chalk35.default.dim("     Command:   ") + import_chalk35.default.cyan("hyv") + import_chalk35.default.dim(" (full path on Windows if needed)"));
+    console.log(import_chalk35.default.dim("     Arguments: ") + import_chalk35.default.cyan("mcp"));
+    console.log(import_chalk35.default.dim("  4. Save, restart ChatGPT Desktop"));
+    console.log(import_chalk35.default.dim('  5. Test: "scan this with hold your voice"\n'));
+    console.log(import_chalk35.default.dim("  If connector fails to start, use full paths from:"));
+    console.log(import_chalk35.default.cyan("  " + guide));
+    console.log(import_chalk35.default.dim(""));
+    console.log(import_chalk35.default.dim('Windows tip: If you get "running scripts is disabled", use:'));
+    console.log(import_chalk35.default.cyan('  powershell -ExecutionPolicy Bypass -Command "hyv mcp --setup-chatgpt"'));
+    console.log(import_chalk35.default.dim("  Fix once:  Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force"));
+    console.log(import_chalk35.default.dim("  In ChatGPT connector use the FULL path from the connector .txt file\n"));
+    console.log(import_chalk35.default.bold("=== not seeing either UI? ==="));
+    console.log(import_chalk35.default.dim("  \u2022 Turn Developer mode ON in ChatGPT settings for New App"));
+    console.log(import_chalk35.default.dim("  \u2022 Connectors may require ChatGPT Plus"));
+    console.log(import_chalk35.default.dim("  \u2022 Browser ChatGPT cannot use either path \u2014 desktop app only\n"));
+    if (require("fs").existsSync(guide)) {
+      console.log(import_chalk35.default.dim(`  Full connector paths written to: ${guide}`));
+    } else {
+      console.log(import_chalk35.default.dim("  Run hyv doctor --fix-agents to write " + guide));
+    }
+    console.log("");
     return;
   }
-  const wantsIntegrate = Boolean(opts.integrateOnly || process.stdin.isTTY);
-  if (wantsIntegrate) {
-    const integrateOpts = { force: Boolean(opts.force) };
-    const result = runMcpAutoIntegrate(integrateOpts);
-    printMcpIntegrateReport(result, integrateOpts);
-    if (!opts.stdio)
-      return;
-    console.log(import_chalk34.default.dim("starting stdio mcp server for local testing (ctrl+c to stop)\u2026\n"));
-  }
   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) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holdyourvoice/hyv",
-  "version": "2.9.15",
+  "version": "2.9.17",
   "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/install.ps1

@@ -68,7 +68,16 @@ function Install-Hyv {
     throw 'npm not found after node install'
   }
   Write-Log 'installing hold your voice...'
-  npm i -g $HyvPkg
+  try {
+    npm i -g $HyvPkg
+  } catch {
+    if ($_.Exception.Message -match 'ExecutionPolicy|scripts is disabled') {
+      Write-Log 'PowerShell execution policy blocked npm — retrying with Bypass...'
+      powershell -ExecutionPolicy Bypass -Command "npm i -g $HyvPkg"
+    } else {
+      throw
+    }
+  }
   Refresh-Path
   if (Get-Command hyv -ErrorAction SilentlyContinue) {
     Write-Log 'running hyv welcome...'
@@ -81,6 +90,9 @@ function Install-Hyv {
 Write-Host ''
 Write-Host 'hold your voice — installer'
 Write-Host ''
+Write-Host '  Note: If you see an "execution policy" error, re-run using:'
+Write-Host '  powershell -ExecutionPolicy Bypass -c "irm https://holdyourvoice.com/install.ps1 | iex"'
+Write-Host ''
 Ensure-Node
 if ($EnsureNodeOnly) { exit 0 }
 Install-Hyv

package/scripts/postinstall-lib.js

@@ -674,23 +674,53 @@ function setupAgents({
     fs.mkdirSync(cgDir, { recursive: true });
     const mcpCmd = resolveHyvMcpCommand(pkgDir);
     const connectorGuide = [
-      'hold your voice — chatgpt desktop mcp connector',
+      'hold your voice — chatgpt desktop setup (two paths)',
       '',
-      'chatgpt has no auto-config file. add this connector once in the chatgpt desktop app:',
+      '=== which setup do i have? ===',
       '',
-      '1. open chatgpt desktop (not the browser)',
-      '2. settings → connectors → add connector',
-      '3. name: hold your voice',
-      '4. command: hyv',
-      '5. arguments: mcp',
+      '  If you see "New App" with a Server URL field:',
+      '    → Developer mode is ON → use PATH A (remote)',
+      '  If you see "Connectors" with Command/Arguments fields:',
+      '    → use PATH B (local)',
       '',
-      'if the connector fails to start, use absolute paths instead:',
-      `   command: ${mcpCmd.command}`,
-      `   arguments: ${mcpCmd.args.join(' ')}`,
+      '=== PATH A — remote mcp (Developer mode → New App) ===',
+      '  Requires: paid HYV plan + ChatGPT Desktop',
       '',
-      'then restart chatgpt desktop and ask: scan this with hold your voice',
+      '  1. In ChatGPT: Settings → turn Developer mode ON',
+      '     (Accept the elevated risk warning — expected, not a HYV bug)',
+      '  2. Settings → Apps → New App',
+      '  3. Fill in:',
+      '     Name:           hold your voice',
+      '     Description:    Scans writing for AI patterns and voice drift',
+      '     Connection:     Server URL → https://holdyourvoice.com/mcp',
+      '     Authentication: OAuth',
+      '     Checkbox:       "I understand and want to continue"',
+      '  4. Save → complete OAuth sign-in to holdyourvoice.com',
+      '  5. Test: "scan this with hold your voice"',
       '',
-      'more help: hyv mcp --setup-chatgpt',
+      '  Cloud app setup: https://holdyourvoice.com/app/api/mcp',
+      '  Wiki guide:      https://holdyourvoice.com/wiki/use-hyv-in-chatgpt',
+      '',
+      '=== PATH B — local connector (Connectors → Command/Arguments) ===',
+      '  Requires: Node.js 18+ (free offline scan)',
+      '',
+      '  1. Install hyv: npm i -g @holdyourvoice/hyv@latest && hyv welcome',
+      '  2. In ChatGPT: Settings → Connectors (or https://chatgpt.com/#settings/Connectors)',
+      '  3. Add connector:',
+      `     Name:      hold your voice`,
+      `     Command:   ${mcpCmd.command}`,
+      `     Arguments: ${mcpCmd.args.join(' ')}`,
+      '  4. Save, restart ChatGPT Desktop',
+      '  5. Test: "scan this with hold your voice"',
+      '',
+      '  If connector fails to start, use the absolute paths above.',
+      '',
+      '=== not seeing either UI? ===',
+      '  • Turn Developer mode ON in ChatGPT settings for New App',
+      '  • Connectors may require ChatGPT Plus',
+      '  • Browser ChatGPT cannot use either path — desktop app only',
+      '',
+      'More help: hyv mcp --setup-chatgpt',
       '',
     ].join('\n');
     const guideFile = path.join(cgDir, 'hyv-mcp-connector.txt');

package/scripts/postinstall.js

@@ -21,6 +21,12 @@ print('  ✓ hold your voice installed — free local scan ready');
 print('  next: hyv welcome  |  hyv scan draft.md  |  hyv mcp --setup');
 print('  no node yet? curl -fsSL https://holdyourvoice.com/install.sh | bash');
 print('');
+if (process.platform === 'win32') {
+  print('  Windows: if you get "scripts is disabled", run in PowerShell:');
+  print('    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser');
+  print('  Or use: powershell -ExecutionPolicy Bypass -Command "hyv ..."');
+  print('');
+}
 
 const { configured, warnings } = setupAgents({ pkgDir, quiet });