@holdyourvoice/hyv 2.9.20 → 2.9.22

package/dist/index.js

@@ -4727,6 +4727,41 @@ var init_profile_meta = __esm({
 });
 
 // src/lib/config.ts
+var config_exports = {};
+__export(config_exports, {
+  API_BASE: () => API_BASE,
+  AUTH_FILE: () => AUTH_FILE,
+  CACHE_DIR: () => CACHE_DIR2,
+  CONFIG_FILE: () => CONFIG_FILE,
+  HYV_DIR: () => HYV_DIR,
+  LAST_SESSION_FILE: () => LAST_SESSION_FILE,
+  PROFILES_DIR: () => PROFILES_DIR,
+  QUEUE_DIR: () => QUEUE_DIR,
+  appendSecureLine: () => appendSecureLine,
+  assertSafeOAuthUrl: () => assertSafeOAuthUrl,
+  assertSafeOpenUrl: () => assertSafeOpenUrl,
+  assertSafeProfileName: () => assertSafeProfileName,
+  clearAuth: () => clearAuth,
+  clearQueuedSignals: () => clearQueuedSignals,
+  cliApiUrl: () => cliApiUrl,
+  ensureHyvDir: () => ensureHyvDir,
+  getQueuedSignals: () => getQueuedSignals,
+  getToken: () => getToken,
+  isInitialized: () => isInitialized,
+  listCachedProfiles: () => listCachedProfiles,
+  profilePathForName: () => profilePathForName,
+  queueSignal: () => queueSignal,
+  readAuth: () => readAuth,
+  readCachedProfile: () => readCachedProfile,
+  readConfig: () => readConfig,
+  readLastEditSession: () => readLastEditSession,
+  saveLastEditSession: () => saveLastEditSession,
+  toSafeProfileCacheKey: () => toSafeProfileCacheKey,
+  writeAuth: () => writeAuth,
+  writeCachedProfile: () => writeCachedProfile,
+  writeConfig: () => writeConfig,
+  writeSecureFile: () => writeSecureFile
+});
 function validateApiBase(raw) {
   const trimmed = raw.replace(/\/$/, "");
   let parsed;
@@ -4822,6 +4857,10 @@ function ensureHyvDir() {
     }
   }
 }
+function writeSecureFile(filePath, content) {
+  ensureHyvDir();
+  fs3.writeFileSync(filePath, content, { mode: 384 });
+}
 function appendSecureLine(filePath, line, dir) {
   if (dir) {
     if (!fs3.existsSync(dir))
@@ -4866,6 +4905,11 @@ function writeAuth(auth) {
   }
   fs3.writeFileSync(AUTH_FILE, JSON.stringify(auth, null, 2), { mode: 384 });
 }
+function clearAuth() {
+  if (fs3.existsSync(AUTH_FILE)) {
+    fs3.unlinkSync(AUTH_FILE);
+  }
+}
 function readConfig() {
   try {
     if (!fs3.existsSync(CONFIG_FILE))
@@ -4943,6 +4987,17 @@ function queueSignal(signal) {
   const filePath = path2.join(QUEUE_DIR, `${id}.json`);
   fs3.writeFileSync(filePath, JSON.stringify(signal, null, 2), { mode: 384 });
 }
+function clearQueuedSignals() {
+  try {
+    if (!fs3.existsSync(QUEUE_DIR))
+      return;
+    const files = fs3.readdirSync(QUEUE_DIR).filter((f) => f.endsWith(".json"));
+    for (const f of files) {
+      fs3.unlinkSync(path2.join(QUEUE_DIR, f));
+    }
+  } catch {
+  }
+}
 function saveLastEditSession(session) {
   ensureHyvDir();
   const data = { ...session, saved_at: (/* @__PURE__ */ new Date()).toISOString() };
@@ -5236,14 +5291,14 @@ var require_open = __commonJS({
       }
       const subprocess = childProcess.spawn(command, cliArguments, childProcessOptions);
       if (options.wait) {
-        return new Promise((resolve16, reject) => {
+        return new Promise((resolve17, reject) => {
           subprocess.once("error", reject);
           subprocess.once("close", (exitCode) => {
             if (!options.allowNonzeroExitCode && exitCode > 0) {
               reject(new Error(`Exited with code ${exitCode}`));
               return;
             }
-            resolve16(subprocess);
+            resolve17(subprocess);
           });
         });
       }
@@ -5406,7 +5461,7 @@ var init_free_paid = __esm({
     ];
     COMMUNITY_URL = "https://holdyourvoice.com/community";
     PRICING_URL = "https://holdyourvoice.com/#pricing";
-    DASHBOARD_BILLING_URL = "https://holdyourvoice.com/app/billing";
+    DASHBOARD_BILLING_URL = "https://holdyourvoice.com/dashboard?tab=billing";
   }
 });
 
@@ -5459,16 +5514,16 @@ function compareSemver(a, b) {
   return 0;
 }
 function fetchLatestNpmVersion(timeoutMs = 8e3) {
-  return new Promise((resolve16) => {
+  return new Promise((resolve17) => {
     (0, import_child_process.execFile)(
       "npm",
       ["view", "@holdyourvoice/hyv", "version"],
       { timeout: timeoutMs, encoding: "utf-8" },
       (err, stdout) => {
         if (err || !stdout?.trim())
-          resolve16(null);
+          resolve17(null);
         else
-          resolve16(stdout.trim());
+          resolve17(stdout.trim());
       }
     );
   });
@@ -5533,7 +5588,7 @@ function escapeHtml(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
 function request(url, options = {}) {
-  return new Promise((resolve16, reject) => {
+  return new Promise((resolve17, reject) => {
     const urlObj = new URL(url);
     const isHttps = urlObj.protocol === "https:";
     const client = isHttps ? https : http;
@@ -5554,9 +5609,9 @@ function request(url, options = {}) {
       res.on("data", (chunk) => data += chunk);
       res.on("end", () => {
         try {
-          resolve16({ status: res.statusCode || 0, data: JSON.parse(data) });
+          resolve17({ status: res.statusCode || 0, data: JSON.parse(data) });
         } catch {
-          resolve16({ status: res.statusCode || 0, data });
+          resolve17({ status: res.statusCode || 0, data });
         }
       });
     });
@@ -5614,9 +5669,9 @@ async function authenticateWithLicense(licenseKey) {
 }
 async function authenticateWithBrowser() {
   const server = http.createServer();
-  const port = await new Promise((resolve16) => {
+  const port = await new Promise((resolve17) => {
     server.listen(0, "127.0.0.1", () => {
-      resolve16(server.address().port);
+      resolve17(server.address().port);
     });
   });
   const redirectUri = `http://127.0.0.1:${port}/callback`;
@@ -5635,11 +5690,11 @@ async function authenticateWithBrowser() {
   }
   console.log(import_chalk2.default.cyan("\nOpening browser for authentication..."));
   await (0, import_open.default)(assertSafeOAuthUrl(auth_url));
-  const authData = await new Promise((resolve16, reject) => {
+  const authData = await new Promise((resolve17, reject) => {
     const timeout = setTimeout(() => {
       server.close();
       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>"
+        '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 a license key: hyv init <license-key>"
       ));
     }, 12e4);
     server.on("request", async (req, res) => {
@@ -5694,7 +5749,7 @@ async function authenticateWithBrowser() {
           `);
           clearTimeout(timeout);
           server.close();
-          resolve16(data);
+          resolve17(data);
         } catch (error) {
           res.writeHead(500, { "Content-Type": "text/html" });
           res.end(`<h1>Authentication failed</h1><p>${escapeHtml(error.message)}</p>`);
@@ -5712,7 +5767,7 @@ async function authenticateWithBrowser() {
   return authData;
 }
 async function openAuthenticatedDashboard(opts = {}) {
-  const nextPath = opts.next || "/app/billing";
+  const nextPath = opts.next || "/dashboard?tab=billing";
   try {
     const response = await authenticatedRequest(cliApiUrl("/cli/auth/web-handoff"), {
       method: "POST",
@@ -5727,7 +5782,7 @@ async function openAuthenticatedDashboard(opts = {}) {
     }
   } catch {
   }
-  const billingUrl = nextPath === "/app/billing" ? DASHBOARD_BILLING_URL : assertSafeOpenUrl(`https://holdyourvoice.com${nextPath}`);
+  const billingUrl = nextPath === "/dashboard?tab=billing" ? DASHBOARD_BILLING_URL : assertSafeOpenUrl(`https://holdyourvoice.com${nextPath}`);
   await (0, import_open.default)(billingUrl);
 }
 async function refreshToken(tokenOverride) {
@@ -5879,7 +5934,7 @@ async function request2(method, path28, body) {
   if (res.status === 401)
     throw new Error("your session expired. run: hyv init to sign in again.");
   if (res.status === 403)
-    throw new Error("you don't have access to this feature. check your plan at holdyourvoice.com/app/billing");
+    throw new Error("you don't have access to this feature. check your plan at holdyourvoice.com/dashboard?tab=billing");
   if (!res.ok) {
     throw new Error(`something went wrong (${res.status}). try again or contact support.`);
   }
@@ -6360,8 +6415,7 @@ async function requirePaidFeature(feature) {
     throw new Error("can't reach the server. check your internet connection and try again.");
   }
   const plan = (data.plan || "none").toLowerCase();
-  const subStatus = String(data.subscription_status || data.status || "").toLowerCase();
-  if (!data.plan || plan === "none" || plan === "free" || plan === "expired" || subStatus === "trialing" || subStatus === "none") {
+  if (!data.plan || plan === "none" || plan === "free" || plan === "expired") {
     throw new Error(FEATURE_MESSAGES[feature]);
   }
 }
@@ -11526,7 +11580,7 @@ function isInteractiveTTY() {
   return Boolean(process.stdin.isTTY && process.stdout.isTTY && !process.env.CI);
 }
 function briefPause(ms2 = 280) {
-  return new Promise((resolve16) => setTimeout(resolve16, ms2));
+  return new Promise((resolve17) => setTimeout(resolve17, ms2));
 }
 async function withSpinner(label, fn, opts = {}) {
   const minMs = opts.minMs ?? 450;
@@ -11846,7 +11900,7 @@ function saveLocalProfile(name, content) {
   return path14.join(os9.homedir(), ".hyv", "profiles", `${safe}.md`);
 }
 function fetchUrlText(url) {
-  return new Promise((resolve16, reject) => {
+  return new Promise((resolve17, reject) => {
     let parsed;
     try {
       parsed = new URL(url);
@@ -11875,7 +11929,7 @@ function fetchUrlText(url) {
         });
         res.on("end", () => {
           const text = data.replace(/<script[\s\S]*?<\/script>/gi, " ").replace(/<style[\s\S]*?<\/style>/gi, " ").replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
-          resolve16(text.slice(0, 12e3));
+          resolve17(text.slice(0, 12e3));
         });
       }
     );
@@ -11895,10 +11949,10 @@ async function collectSamplesFromLink(url) {
 }
 function askLine(prompt) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve16) => {
+  return new Promise((resolve17) => {
     rl.question(prompt, (answer) => {
       rl.close();
-      resolve16(answer.trim());
+      resolve17(answer.trim());
     });
   });
 }
@@ -11907,11 +11961,11 @@ async function askMultiline(intro) {
   console.log(import_chalk12.default.dim("  paste below, then type --- on its own line when done\n"));
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
   const lines = [];
-  return new Promise((resolve16) => {
+  return new Promise((resolve17) => {
     rl.on("line", (line) => {
       if (line.trim() === "---") {
         rl.close();
-        resolve16(lines.join("\n").trim());
+        resolve17(lines.join("\n").trim());
         return;
       }
       lines.push(line);
@@ -12125,7 +12179,7 @@ async function stepSignup(profileName) {
     }
     const upgrade = await askYesNo("  open billing to upgrade?", false);
     if (upgrade) {
-      await withSpinner("opening billing\u2026", () => openAuthenticatedDashboard({ next: "/app/billing" }));
+      await withSpinner("opening billing\u2026", () => openAuthenticatedDashboard({ next: "/dashboard?tab=billing" }));
       await briefPause();
     }
     markStepComplete("signup");
@@ -12149,7 +12203,7 @@ async function stepSignup(profileName) {
   }
   await syncProfileToAccount(profileName);
   console.log(import_chalk12.default.cyan("\n  opening billing in your dashboard ($1 first month)..."));
-  await withSpinner("opening billing\u2026", () => openAuthenticatedDashboard({ next: "/app/billing" }));
+  await withSpinner("opening billing\u2026", () => openAuthenticatedDashboard({ next: "/dashboard?tab=billing" }));
   await briefPause();
   markStepComplete("signup");
   console.log(import_chalk12.default.dim("\n  you're signed in \u2014 pick a plan in billing, no second login.\n"));
@@ -12365,7 +12419,7 @@ __export(billing_upgrade_exports, {
 });
 async function openBillingUpgrade(opts = {}) {
   const plan = opts.plan || "individual";
-  const next = `/app/billing?checkout=${plan}`;
+  const next = `/dashboard?tab=billing&checkout=${plan}`;
   const token = getToken();
   if (!token) {
     console.log(import_chalk14.default.cyan("\nSign in to upgrade \u2014 opening browser...\n"));
@@ -15769,103 +15823,18 @@ var import_chalk35 = __toESM(require_source());
 
 // src/commands/init.ts
 var import_chalk4 = __toESM(require_source());
-var nodeFs = __toESM(require("fs"));
 var nodePath = __toESM(require("path"));
-var nodeOs = __toESM(require("os"));
 init_config();
 init_auth();
 function configureMcpForDesktop() {
-  const results = [];
-  const home = nodeOs.homedir();
-  const isWin = process.platform === "win32";
-  const claudeDir = isWin ? nodePath.join(home, "AppData", "Roaming", "Claude") : nodePath.join(home, "Library", "Application Support", "Claude");
-  const claudeConfig = nodePath.join(claudeDir, "claude_desktop_config.json");
-  if (nodeFs.existsSync(claudeDir)) {
-    try {
-      let cfg = {};
-      if (nodeFs.existsSync(claudeConfig))
-        cfg = JSON.parse(nodeFs.readFileSync(claudeConfig, "utf-8"));
-      if (!cfg.mcpServers)
-        cfg.mcpServers = {};
-      if (!cfg.mcpServers.hyv) {
-        cfg.mcpServers.hyv = { command: "hyv", args: ["mcp"] };
-        nodeFs.writeFileSync(claudeConfig, JSON.stringify(cfg, null, 2));
-        results.push("Claude Desktop");
-      }
-    } catch {
-    }
-  }
-  const claudeCodeDir = nodePath.join(home, ".claude", "commands");
-  if (nodeFs.existsSync(nodePath.dirname(claudeCodeDir))) {
-    try {
-      nodeFs.mkdirSync(claudeCodeDir, { recursive: true });
-      const cmdFile = nodePath.join(claudeCodeDir, "hyv.md");
-      if (!nodeFs.existsSync(cmdFile)) {
-        const src = findAgentFile("claude-code.md");
-        if (src) {
-          nodeFs.copyFileSync(src, cmdFile);
-          results.push("Claude Code");
-        }
-      }
-    } catch {
-    }
-  }
-  const cursorDir = nodePath.join(home, ".cursor");
-  if (nodeFs.existsSync(cursorDir)) {
-    try {
-      const rulesFile = nodePath.join(cursorDir, "rules", "hyv.md");
-      nodeFs.mkdirSync(nodePath.dirname(rulesFile), { recursive: true });
-      if (!nodeFs.existsSync(rulesFile)) {
-        const src = findAgentFile("cursor.md");
-        if (src) {
-          nodeFs.copyFileSync(src, rulesFile);
-          results.push("Cursor");
-        }
-      }
-    } catch {
-    }
-  }
-  const wsDir = isWin ? nodePath.join(home, "AppData", "Roaming", "Windsurf") : nodePath.join(home, ".windsurf");
-  if (nodeFs.existsSync(wsDir)) {
-    try {
-      const rulesFile = nodePath.join(wsDir, "rules", "hyv.md");
-      nodeFs.mkdirSync(nodePath.dirname(rulesFile), { recursive: true });
-      if (!nodeFs.existsSync(rulesFile)) {
-        const src = findAgentFile("windsurf.md");
-        if (src) {
-          nodeFs.copyFileSync(src, rulesFile);
-          results.push("Windsurf");
-        }
-      }
-    } catch {
-    }
-  }
   try {
-    const chatgptDir = nodePath.join(home, ".chatgpt");
-    nodeFs.mkdirSync(chatgptDir, { recursive: true });
-    const instrFile = nodePath.join(chatgptDir, "hyv-instructions.txt");
-    if (!nodeFs.existsSync(instrFile)) {
-      const src = findAgentFile("chatgpt.md");
-      if (src) {
-        nodeFs.copyFileSync(src, instrFile);
-        results.push("ChatGPT");
-      }
-    }
+    const pkgDir = nodePath.resolve(__dirname, "..");
+    const { integrateDetectedAgents } = require(nodePath.join(pkgDir, "scripts", "postinstall-lib"));
+    const result = integrateDetectedAgents({ pkgDir, quiet: true, force: false });
+    return result.configured || [];
   } catch {
+    return [];
   }
-  return results;
-}
-function findAgentFile(filename) {
-  const candidates = [
-    nodePath.join(nodePath.dirname(__filename || ""), "..", "agents", filename),
-    nodePath.join(process.cwd(), "agents", filename),
-    nodePath.join(nodeOs.homedir(), ".hyv", "agents", filename)
-  ];
-  for (const p of candidates) {
-    if (nodeFs.existsSync(p))
-      return p;
-  }
-  return null;
 }
 function registerInitCommand(program3) {
   program3.command("init").description("Authenticate with Hold Your Voice").argument("[license-key]", "License key (skip browser flow)").option("--no-browser", "Skip browser-based authentication").action(async (licenseKey, options) => {
@@ -17173,7 +17142,28 @@ function registerImportCommand(program3) {
       ensureHyvDir();
       writeCachedProfile(name, content);
       console.log(import_chalk13.default.green(`
-\u2713 Profile imported: ${name}`));
+\u2713 Profile imported locally: ${name}`));
+      const { getToken: getToken2 } = await Promise.resolve().then(() => (init_config(), config_exports));
+      const { authenticatedRequest: authenticatedRequest2, cliApiUrl: cliApiUrl2 } = await Promise.resolve().then(() => (init_auth(), auth_exports));
+      const token = getToken2();
+      if (token) {
+        console.log(import_chalk13.default.cyan("\nSyncing profile to your account..."));
+        try {
+          const syncResponse = await authenticatedRequest2(
+            cliApiUrl2("/cli/profiles/new"),
+            { method: "POST", body: { name, content, source: "import" } }
+          );
+          if (syncResponse.status === 200) {
+            console.log(import_chalk13.default.green("  \u2713 synced to your account"));
+          } else {
+            console.log(import_chalk13.default.yellow("  profile saved locally \u2014 run `hyv sync` to push to your account"));
+          }
+        } catch {
+          console.log(import_chalk13.default.yellow("  profile saved locally \u2014 run `hyv sync` to push to your account"));
+        }
+      } else {
+        console.log(import_chalk13.default.dim("\n  not signed in \u2014 profile saved locally. run `hyv init` then `hyv sync` to back it up."));
+      }
     } catch (error) {
       console.error(import_chalk13.default.red(`Error: ${error.message}`));
       process.exit(1);
@@ -17181,7 +17171,7 @@ function registerImportCommand(program3) {
   });
 }
 function askQuestion(question) {
-  return new Promise((resolve16) => {
+  return new Promise((resolve17) => {
     const readline3 = require("readline");
     const rl = readline3.createInterface({
       input: process.stdin,
@@ -17190,7 +17180,7 @@ function askQuestion(question) {
     rl.question(import_chalk13.default.cyan(`  ${question}
   > `), (answer) => {
       rl.close();
-      resolve16(answer.trim());
+      resolve17(answer.trim());
     });
   });
 }
@@ -17787,7 +17777,7 @@ async function testMcpStdioSubprocess() {
   const entry = resolveCliEntry();
   if (!entry)
     return { ok: false };
-  return new Promise((resolve16) => {
+  return new Promise((resolve17) => {
     const child = (0, import_child_process4.spawn)(process.execPath, [entry, "mcp"], {
       stdio: ["pipe", "pipe", "pipe"],
       env: { ...process.env, HYV_POSTINSTALL_QUIET: "1" }
@@ -17803,7 +17793,7 @@ async function testMcpStdioSubprocess() {
         child.kill();
       } catch {
       }
-      resolve16({ ok, toolCount });
+      resolve17({ ok, toolCount });
     };
     const timeout = setTimeout(() => finish(false), 1e4);
     const handleLine = (line) => {
@@ -18208,11 +18198,11 @@ async function confirmDestructiveWrite(options) {
   const question = `
 ${label}
 A .bak backup will be created. Proceed? [y/N] `;
-  const answer = await new Promise((resolve16) => {
+  const answer = await new Promise((resolve17) => {
     const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
     rl.question(question, (value) => {
       rl.close();
-      resolve16(value.trim().toLowerCase());
+      resolve17(value.trim().toLowerCase());
     });
   });
   return answer === "y" || answer === "yes";
@@ -18972,9 +18962,9 @@ var import_chalk30 = __toESM(require_source());
 var PAGES = {
   dashboard: "https://holdyourvoice.com/dashboard",
   profiles: "https://holdyourvoice.com/dashboard?tab=profiles",
-  pricing: "https://holdyourvoice.com/app/billing",
+  pricing: "https://holdyourvoice.com/dashboard?tab=billing",
   settings: "https://holdyourvoice.com/dashboard",
-  billing: "https://holdyourvoice.com/app/billing"
+  billing: "https://holdyourvoice.com/dashboard?tab=billing"
 };
 function registerOpenCommand(program3) {
   program3.command("open").description("Open the web dashboard in your browser").option("--page <path>", "Page: dashboard, profiles, pricing, settings", "dashboard").option("--profile <name>", "Deep-link to a specific profile").option("--no-browser", "Print URL only, don't open").action(async (options) => {
@@ -19405,6 +19395,69 @@ 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_chalk33.default.bold("\nhold your voice \u2014 mcp integration\n"));
+  console.log(import_chalk33.default.dim(`  ${getEngineLabel()}
+`));
+  const welcome = readWelcomeState();
+  const profiles = listLocalProfileNames2();
+  if (profiles.length > 0) {
+    console.log(import_chalk33.default.dim(`  voice profiles: ${profiles.join(", ")}`));
+  } else {
+    console.log(import_chalk33.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_chalk33.default.dim(`  welcome progress: ${welcome.completed_steps.join(", ")}`));
+  }
+  console.log("");
+  if (result.detected.length === 0) {
+    console.log(import_chalk33.default.yellow("  no supported ai apps detected on this machine."));
+    console.log(import_chalk33.default.dim("\n  install cursor, claude desktop, chatgpt desktop, or another supported app,"));
+    console.log(import_chalk33.default.dim("  then run hyv mcp again \u2014 or hyv doctor --fix-agents to configure everything."));
+    console.log(import_chalk33.default.dim("\n  in chatgpt/claude/cursor: call hyv_welcome to onboard without the terminal."));
+    console.log(import_chalk33.default.dim("  chatgpt desktop (paid): developer mode \u2192 new app \u2192 https://holdyourvoice.com/mcp + oauth"));
+    console.log(import_chalk33.default.dim("  full steps: hyv mcp --setup-chatgpt\n"));
+    return;
+  }
+  console.log(import_chalk33.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_chalk33.default.yellow("\u25CB") : integrated ? import_chalk33.default.green("\u2713") : import_chalk33.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_chalk33.default.dim(`      ${app.reason} \xB7 ${app.integration}`));
+  }
+  if (result.configured.length > 0) {
+    console.log(import_chalk33.default.green(`
+  wired hyv into: ${result.configured.join(", ")}`));
+  }
+  if (result.warnings.length > 0) {
+    console.log(import_chalk33.default.yellow("\n  notes:"));
+    for (const warning of result.warnings) {
+      console.log(import_chalk33.default.yellow(`    ! ${warning}`));
+    }
+  }
+  const mcpApps = result.detected.filter((a) => a.integration === "mcp");
+  const manualApps = result.detected.filter((a) => a.integration === "manual");
+  console.log(import_chalk33.default.bold("\nnext steps"));
+  console.log(import_chalk33.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_chalk33.default.dim("  restart apps that use mcp (cursor, claude desktop, antigravity, opencode)"));
+  }
+  if (manualApps.length > 0) {
+    console.log(import_chalk33.default.dim("  chatgpt (recommended): developer mode \u2192 new app \u2192 https://holdyourvoice.com/mcp + oauth"));
+    console.log(import_chalk33.default.dim("  chatgpt (free fallback): settings \u2192 connectors \u2192 command hyv, arguments mcp"));
+    console.log(import_chalk33.default.dim("  full steps: hyv mcp --setup-chatgpt"));
+  }
+  console.log(import_chalk33.default.dim("  refresh stale configs after upgrade: hyv mcp --force"));
+  console.log(import_chalk33.default.dim("  verify: hyv mcp --test"));
+  console.log(import_chalk33.default.dim("  all hosts: hyv doctor --verify-hosts\n"));
+}
 
 // src/mcp.ts
 init_mcp_profile_hydrate();
@@ -19844,7 +19897,7 @@ var TOOLS = [
   },
   {
     name: "hyv_scan",
-    description: "Fast local scan for 80+ AI patterns + profile never-list/learned rules. FREE, offline. ALWAYS scan before finalizing written content.",
+    description: "Fast local scan for 80+ AI patterns + profile never-list/learned rules. FREE, offline. ALWAYS scan before finalizing any written content \u2014 emails, posts, docs, replies, messages, or prose.",
     inputSchema: {
       type: "object",
       properties: {
@@ -20057,6 +20110,16 @@ async function startMcpServer() {
       mcpLog("info", `account profile sync skipped: ${r.error}`);
   }).catch(() => {
   });
+  try {
+    const result = runMcpAutoIntegrate({ force: false });
+    if (result.configured.length > 0) {
+      mcpLog("info", `mcp auto-configured: ${result.configured.join(", ")}`);
+    }
+    if (result.detected.length > 0 && result.configured.length === 0) {
+      mcpLog("info", `detected apps (already configured): ${result.detected.map((a) => a.label).join(", ")}`);
+    }
+  } catch {
+  }
   let buffer = "";
   process.stdin.setEncoding("utf-8");
   let requestChain = Promise.resolve();
@@ -20421,7 +20484,7 @@ registerOpenCommand(program2);
 registerWelcomeCommand(program2);
 registerContentCommand(program2);
 registerUpgradeCommand(program2);
-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) => {
+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) => {
   if (opts.setup) {
     printMcpSetup();
     return;
@@ -20480,6 +20543,10 @@ program2.command("mcp").description("Start MCP server (for Claude Desktop and ot
     console.log("");
     return;
   }
+  console.log(import_chalk35.default.bold("\nhold your voice \u2014 detecting and configuring mcp...\n"));
+  const result = runMcpAutoIntegrate({ force: Boolean(opts.force) });
+  printMcpIntegrateReport(result, { force: Boolean(opts.force) });
+  console.log(import_chalk35.default.dim("\nstarting MCP server (press Ctrl+C to stop)...\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.20",
+  "version": "2.9.22",
   "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": {