@holdyourvoice/hyv 2.9.18 → 2.9.20

package/LICENSE

@@ -0,0 +1,26 @@
+License
+Copyright © 2025 Hold Your Voice (holdyourvoice.com)
+
+All Rights Reserved.
+
+This software ("@holdyourvoice/hyv") is proprietary and confidential.
+It is provided for use solely by authorized licensees of Hold Your Voice.
+
+1. **Grant of License**: A non-exclusive, non-transferable, revocable license
+   is granted to use this software for its intended purpose as a writing
+   analysis tool.
+
+2. **Restrictions**: You may not:
+   a) Redistribute, sublicense, sell, or lease this software or any
+      derivative works.
+   b) Modify, reverse engineer, decompile, or disassemble this software.
+   c) Remove or alter any proprietary notices.
+   d) Use this software in violation of applicable law.
+
+3. **No Warranty**: This software is provided "as is" without warranty of
+   any kind, express or implied.
+
+4. **Limitation of Liability**: Hold Your Voice shall not be liable for any
+   damages arising from the use of this software.
+
+For licensing inquiries: hello@holdyourvoice.com

package/agents/chatgpt.md

@@ -25,9 +25,16 @@ The user has a voice profile. All writing must match their personal style.
 ## MCP setup (no terminal)
 - `hyv_mcp_setup` with `action=status` — see what's integrated and onboarding progress
 - `hyv_mcp_setup` with `action=integrate` — refresh Cursor/Claude configs (`force=true` after hyv upgrade)
-- `hyv_mcp_setup` with `action=chatgpt` — desktop connector steps (command: hyv, arguments: mcp)
+- `hyv_mcp_setup` with `action=chatgpt` — **recommended:** remote OAuth (developer mode → new app → https://holdyourvoice.com/mcp + OAuth). Free fallback: local connector (command: hyv, arguments: mcp)
 - `hyv_welcome` — finish voice onboarding inside this chat
 
+## ChatGPT connection (recommended — paid users)
+1. Settings → Developer mode ON
+2. Settings → Apps → New App
+3. Server URL: `https://holdyourvoice.com/mcp` · Authentication: OAuth
+4. Save → sign in to holdyourvoice.com
+5. OAuth runs in ChatGPT's browser — no Windows firewall issues, no local install
+
 ## Available tools
 - `hyv_mcp_setup` / `hyv_welcome` / `hyv_demo` — setup and onboarding
 - `hyv_scan` / `hyv_analyze` — check for AI patterns (+ hybrid when paid)

package/dist/index.js

@@ -19277,12 +19277,34 @@ function formatChatGptConnectorGuide() {
   const mcpCmd = lib.resolveHyvMcpCommand(resolveCliRoot());
   const guidePath = path24.join(os12.homedir(), ".chatgpt", "hyv-mcp-connector.txt");
   const lines = [
-    "### ChatGPT Desktop connector (manual \u2014 no auto-config file)",
+    "### ChatGPT Desktop \u2014 RECOMMENDED: Path A (remote OAuth)",
     "",
-    "1. Open ChatGPT **desktop** app (browser chat cannot use local MCP)",
+    "For paid HYV users. No local install. OAuth runs in ChatGPT's browser \u2014 no Windows firewall issues.",
+    "",
+    "1. Open ChatGPT **desktop** app (browser chat cannot use MCP)",
+    "2. Settings \u2192 turn **Developer mode** ON (accept elevated risk warning \u2014 expected, not a HYV bug)",
+    "3. Settings \u2192 Apps \u2192 **New App**",
+    "4. Fill in:",
+    "   - Name: **hold your voice**",
+    "   - Description: scans writing for AI patterns and voice drift",
+    "   - Connection: Server URL \u2192 **https://holdyourvoice.com/mcp**",
+    "   - Authentication: **OAuth**",
+    '   - Checkbox: "I understand and want to continue"',
+    "5. Save \u2192 complete OAuth sign-in to holdyourvoice.com",
+    '6. Test: "scan this with hold your voice"',
+    "",
+    "Do NOT use https://example.com/sse \u2014 that is a ChatGPT placeholder, not a real URL.",
+    "Cloud app setup: https://holdyourvoice.com/app/api/mcp",
+    "Wiki guide: https://holdyourvoice.com/wiki/use-hyv-in-chatgpt",
+    "",
+    "### FALLBACK: Path B (local connector \u2014 free users only)",
+    "",
+    "Only if you do not have a paid HYV plan. Requires Node.js 18+.",
+    "",
+    "1. Install: npm i -g @holdyourvoice/hyv@latest && hyv welcome",
     "2. Settings \u2192 Connectors \u2192 Add connector",
     "3. Name: **hold your voice**",
-    "4. Command: **hyv**",
+    "4. Command: **hyv** (or absolute path below if connector fails)",
     "5. Arguments: **mcp**",
     "",
     "If the connector fails to start, use absolute paths:",
@@ -19290,13 +19312,12 @@ function formatChatGptConnectorGuide() {
     `   arguments: ${mcpCmd.args.join(" ")}`,
     "",
     "6. Save, restart ChatGPT Desktop",
-    '7. Ask: "run hyv_welcome" or "scan this draft with hold your voice"',
     ""
   ];
   if (fs26.existsSync(guidePath)) {
     lines.push(`Full guide on disk: ${guidePath}`);
   } else {
-    lines.push("Run `hyv mcp` or `hyv doctor --fix-agents` to write the guide file.");
+    lines.push("Run `hyv mcp --setup-chatgpt` or `hyv doctor --fix-agents` to write the guide file.");
   }
   return lines.join("\n");
 }
@@ -19336,7 +19357,7 @@ function buildMcpAgentStatus() {
   lines.push("- Which profile is active \u2192 hyv_profiles");
   lines.push("- New or partial setup \u2192 hyv_welcome (steps 1\u20134, or mode=extract_prompt for voice from chat)");
   lines.push("- Refresh app configs \u2192 hyv_mcp_setup with action=integrate (force=true after hyv upgrade)");
-  lines.push("- ChatGPT connector steps \u2192 hyv_mcp_setup with action=chatgpt");
+  lines.push("- ChatGPT remote OAuth setup (recommended) \u2192 hyv_mcp_setup with action=chatgpt");
   lines.push("- Test free scan \u2192 hyv_demo or hyv_scan on any draft");
   return lines.join("\n");
 }
@@ -19752,7 +19773,7 @@ var TOOLS = [
       properties: {
         action: {
           type: "string",
-          description: "status (default) | integrate (wire hyv into Cursor/Claude/etc.) | chatgpt (desktop connector steps)"
+          description: "status (default) | integrate (wire hyv into Cursor/Claude/etc.) | chatgpt (remote OAuth setup \u2014 recommended for paid users)"
         },
         force: {
           type: "boolean",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holdyourvoice/hyv",
-  "version": "2.9.18",
+  "version": "2.9.20",
   "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": {
@@ -66,7 +66,8 @@
     "skills/",
     "agents/",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "LICENSE"
   ],
   "repository": {
     "type": "git",

package/scripts/postinstall.js

@@ -5,12 +5,7 @@
 const path = require('path');
 const pkgDir = path.resolve(__dirname, '..');
 const quiet = process.env.HYV_POSTINSTALL_QUIET === '1' || process.argv.includes('--quiet');
-const hyvDir = require('path').join(require('os').homedir(), '.hyv');
-const {
-  setupAgents,
-  hasCompletedOnboarding,
-  markOnboardingComplete,
-} = require('./postinstall-lib');
+const { setupAgents } = require('./postinstall-lib');
 
 function print(msg) {
   if (!quiet) console.log(msg);
@@ -37,24 +32,4 @@ if (configured.length > 0) {
 if (warnings.length > 0 && !quiet) {
   print('  ! setup notes: ' + warnings.join('; '));
   print('');
-}
-
-const canShowOnboarding =
-  process.stdout.isTTY || process.env.npm_config_foreground_scripts === 'true';
-
-if (!quiet && !hasCompletedOnboarding(hyvDir) && canShowOnboarding) {
-  print('');
-  print('  starting onboarding...');
-  print('');
-  try {
-    const { execSync } = require('child_process');
-    execSync('node "' + path.join(pkgDir, 'dist', 'index.js') + '" welcome', {
-      stdio: 'inherit',
-      env: { ...process.env, HYV_POSTINSTALL_ONBOARDING: '1' },
-    });
-    markOnboardingComplete(hyvDir, require('./postinstall-lib').readPkgVersion(pkgDir));
-  } catch {
-    print('  finish setup: hyv welcome');
-    print('');
-  }
 }