@holdyourvoice/hyv 2.9.14 → 2.9.16

package/dist/index.js

@@ -973,8 +973,8 @@ var require_command = __commonJS({
   "node_modules/commander/lib/command.js"(exports2) {
     var EventEmitter = require("node:events").EventEmitter;
     var childProcess = require("node:child_process");
-    var path27 = require("node:path");
-    var fs30 = require("node:fs");
+    var path28 = require("node:path");
+    var fs31 = require("node:fs");
     var process2 = require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -1916,13 +1916,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
         let launchWithNode = false;
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
-          const localBin = path27.resolve(baseDir, baseName);
-          if (fs30.existsSync(localBin))
+          const localBin = path28.resolve(baseDir, baseName);
+          if (fs31.existsSync(localBin))
             return localBin;
-          if (sourceExt.includes(path27.extname(baseName)))
+          if (sourceExt.includes(path28.extname(baseName)))
             return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs30.existsSync(`${localBin}${ext}`)
+            (ext) => fs31.existsSync(`${localBin}${ext}`)
           );
           if (foundExt)
             return `${localBin}${foundExt}`;
@@ -1935,21 +1935,21 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs30.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs31.realpathSync(this._scriptPath);
           } catch (err) {
             resolvedScriptPath = this._scriptPath;
           }
-          executableDir = path27.resolve(
-            path27.dirname(resolvedScriptPath),
+          executableDir = path28.resolve(
+            path28.dirname(resolvedScriptPath),
             executableDir
           );
         }
         if (executableDir) {
           let localFile = findFile(executableDir, executableFile);
           if (!localFile && !subcommand._executableFile && this._scriptPath) {
-            const legacyName = path27.basename(
+            const legacyName = path28.basename(
               this._scriptPath,
-              path27.extname(this._scriptPath)
+              path28.extname(this._scriptPath)
             );
             if (legacyName !== this._name) {
               localFile = findFile(
@@ -1960,7 +1960,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           }
           executableFile = localFile || executableFile;
         }
-        launchWithNode = sourceExt.includes(path27.extname(executableFile));
+        launchWithNode = sourceExt.includes(path28.extname(executableFile));
         let proc;
         if (process2.platform !== "win32") {
           if (launchWithNode) {
@@ -2817,7 +2817,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @return {Command}
        */
       nameFromFilename(filename) {
-        this._name = path27.basename(filename, path27.extname(filename));
+        this._name = path28.basename(filename, path28.extname(filename));
         return this;
       }
       /**
@@ -2831,10 +2831,10 @@ Expecting one of '${allowedValues.join("', '")}'`);
        * @param {string} [path]
        * @return {(string|null|Command)}
        */
-      executableDir(path28) {
-        if (path28 === void 0)
+      executableDir(path29) {
+        if (path29 === void 0)
           return this._executableDir;
-        this._executableDir = path28;
+        this._executableDir = path29;
         return this;
       }
       /**
@@ -3934,15 +3934,15 @@ var require_route = __commonJS({
       };
     }
     function wrapConversion(toModel, graph) {
-      const path27 = [graph[toModel].parent, toModel];
+      const path28 = [graph[toModel].parent, toModel];
       let fn = conversions[graph[toModel].parent][toModel];
       let cur = graph[toModel].parent;
       while (graph[cur].parent) {
-        path27.unshift(graph[cur].parent);
+        path28.unshift(graph[cur].parent);
         fn = link(conversions[graph[cur].parent][cur], fn);
         cur = graph[cur].parent;
       }
-      fn.conversion = path27;
+      fn.conversion = path28;
       return fn;
     }
     module2.exports = function(fromModel) {
@@ -4182,7 +4182,7 @@ var require_has_flag = __commonJS({
 var require_supports_color = __commonJS({
   "node_modules/supports-color/index.js"(exports2, module2) {
     "use strict";
-    var os13 = require("os");
+    var os15 = require("os");
     var tty = require("tty");
     var hasFlag = require_has_flag();
     var { env } = process;
@@ -4230,7 +4230,7 @@ var require_supports_color = __commonJS({
         return min;
       }
       if (process.platform === "win32") {
-        const osRelease = os13.release().split(".");
+        const osRelease = os15.release().split(".");
         if (Number(osRelease[0]) >= 10 && Number(osRelease[2]) >= 10586) {
           return Number(osRelease[2]) >= 14931 ? 3 : 2;
         }
@@ -4381,14 +4381,14 @@ var require_templates = __commonJS({
       }
       return results;
     }
-    function buildStyle(chalk34, 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 = chalk34;
+      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 = (chalk34, 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(chalk34, 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(chalk34, 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 chalk35 = {};
-      applyOptions(chalk35, options);
-      chalk35.template = (...arguments_) => chalkTag(chalk35.template, ...arguments_);
-      Object.setPrototypeOf(chalk35, Chalk.prototype);
-      Object.setPrototypeOf(chalk35.template, chalk35);
-      chalk35.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.");
       };
-      chalk35.template.Instance = ChalkClass;
-      return chalk35.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 = (chalk35, ...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(chalk35, parts.join(""));
+      return template(chalk37, parts.join(""));
     };
     Object.defineProperties(Chalk.prototype, styles);
-    var chalk34 = Chalk();
-    chalk34.supportsColor = stdoutColor;
-    chalk34.stderr = Chalk({ level: stderrColor ? stderrColor.level : 0 });
-    chalk34.stderr.supportsColor = stderrColor;
-    module2.exports = chalk34;
+    var chalk36 = Chalk();
+    chalk36.supportsColor = stdoutColor;
+    chalk36.stderr = Chalk({ level: stderrColor ? stderrColor.level : 0 });
+    chalk36.stderr.supportsColor = stderrColor;
+    module2.exports = chalk36;
   }
 });
 
@@ -4990,11 +4990,11 @@ var init_config = __esm({
 var require_is_docker = __commonJS({
   "node_modules/is-docker/index.js"(exports2, module2) {
     "use strict";
-    var fs30 = require("fs");
+    var fs31 = require("fs");
     var isDocker;
     function hasDockerEnv() {
       try {
-        fs30.statSync("/.dockerenv");
+        fs31.statSync("/.dockerenv");
         return true;
       } catch (_2) {
         return false;
@@ -5002,7 +5002,7 @@ var require_is_docker = __commonJS({
     }
     function hasDockerCGroup() {
       try {
-        return fs30.readFileSync("/proc/self/cgroup", "utf8").includes("docker");
+        return fs31.readFileSync("/proc/self/cgroup", "utf8").includes("docker");
       } catch (_2) {
         return false;
       }
@@ -5020,21 +5020,21 @@ var require_is_docker = __commonJS({
 var require_is_wsl = __commonJS({
   "node_modules/is-wsl/index.js"(exports2, module2) {
     "use strict";
-    var os13 = require("os");
-    var fs30 = require("fs");
+    var os15 = require("os");
+    var fs31 = require("fs");
     var isDocker = require_is_docker();
     var isWsl = () => {
       if (process.platform !== "linux") {
         return false;
       }
-      if (os13.release().toLowerCase().includes("microsoft")) {
+      if (os15.release().toLowerCase().includes("microsoft")) {
         if (isDocker()) {
           return false;
         }
         return true;
       }
       try {
-        return fs30.readFileSync("/proc/version", "utf8").toLowerCase().includes("microsoft") ? !isDocker() : false;
+        return fs31.readFileSync("/proc/version", "utf8").toLowerCase().includes("microsoft") ? !isDocker() : false;
       } catch (_2) {
         return false;
       }
@@ -5073,17 +5073,17 @@ var require_define_lazy_prop = __commonJS({
 // node_modules/open/index.js
 var require_open = __commonJS({
   "node_modules/open/index.js"(exports2, module2) {
-    var path27 = require("path");
+    var path28 = require("path");
     var childProcess = require("child_process");
-    var { promises: fs30, constants: fsConstants } = require("fs");
+    var { promises: fs31, constants: fsConstants } = require("fs");
     var isWsl = require_is_wsl();
     var isDocker = require_is_docker();
     var defineLazyProperty = require_define_lazy_prop();
-    var localXdgOpenPath = path27.join(__dirname, "xdg-open");
+    var localXdgOpenPath = path28.join(__dirname, "xdg-open");
     var { platform, arch } = process;
     var hasContainerEnv = () => {
       try {
-        fs30.statSync("/run/.containerenv");
+        fs31.statSync("/run/.containerenv");
         return true;
       } catch {
         return false;
@@ -5106,14 +5106,14 @@ var require_open = __commonJS({
         const configFilePath = "/etc/wsl.conf";
         let isConfigFileExists = false;
         try {
-          await fs30.access(configFilePath, fsConstants.F_OK);
+          await fs31.access(configFilePath, fsConstants.F_OK);
           isConfigFileExists = true;
         } catch {
         }
         if (!isConfigFileExists) {
           return defaultMountPoint;
         }
-        const configContent = await fs30.readFile(configFilePath, { encoding: "utf8" });
+        const configContent = await fs31.readFile(configFilePath, { encoding: "utf8" });
         const configMountPoint = /(?<!#.*)root\s*=\s*(?<mountPoint>.*)/g.exec(configContent);
         if (!configMountPoint) {
           return defaultMountPoint;
@@ -5213,7 +5213,7 @@ var require_open = __commonJS({
           const isBundled = !__dirname || __dirname === "/";
           let exeLocalXdgOpen = false;
           try {
-            await fs30.access(localXdgOpenPath, fsConstants.X_OK);
+            await fs31.access(localXdgOpenPath, fsConstants.X_OK);
             exeLocalXdgOpen = true;
           } catch {
           }
@@ -5236,14 +5236,14 @@ var require_open = __commonJS({
       }
       const subprocess = childProcess.spawn(command, cliArguments, childProcessOptions);
       if (options.wait) {
-        return new Promise((resolve15, reject) => {
+        return new Promise((resolve16, reject) => {
           subprocess.once("error", reject);
           subprocess.once("close", (exitCode) => {
             if (!options.allowNonzeroExitCode && exitCode > 0) {
               reject(new Error(`Exited with code ${exitCode}`));
               return;
             }
-            resolve15(subprocess);
+            resolve16(subprocess);
           });
         });
       }
@@ -5459,16 +5459,16 @@ function compareSemver(a, b) {
   return 0;
 }
 function fetchLatestNpmVersion(timeoutMs = 8e3) {
-  return new Promise((resolve15) => {
+  return new Promise((resolve16) => {
     (0, import_child_process.execFile)(
       "npm",
       ["view", "@holdyourvoice/hyv", "version"],
       { timeout: timeoutMs, encoding: "utf-8" },
       (err, stdout) => {
         if (err || !stdout?.trim())
-          resolve15(null);
+          resolve16(null);
         else
-          resolve15(stdout.trim());
+          resolve16(stdout.trim());
       }
     );
   });
@@ -5533,7 +5533,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((resolve15, reject) => {
+  return new Promise((resolve16, reject) => {
     const urlObj = new URL(url);
     const isHttps = urlObj.protocol === "https:";
     const client = isHttps ? https : http;
@@ -5554,9 +5554,9 @@ function request(url, options = {}) {
       res.on("data", (chunk) => data += chunk);
       res.on("end", () => {
         try {
-          resolve15({ status: res.statusCode || 0, data: JSON.parse(data) });
+          resolve16({ status: res.statusCode || 0, data: JSON.parse(data) });
         } catch {
-          resolve15({ status: res.statusCode || 0, data });
+          resolve16({ status: res.statusCode || 0, data });
         }
       });
     });
@@ -5614,9 +5614,9 @@ async function authenticateWithLicense(licenseKey) {
 }
 async function authenticateWithBrowser() {
   const server = http.createServer();
-  const port = await new Promise((resolve15) => {
+  const port = await new Promise((resolve16) => {
     server.listen(0, "127.0.0.1", () => {
-      resolve15(server.address().port);
+      resolve16(server.address().port);
     });
   });
   const redirectUri = `http://127.0.0.1:${port}/callback`;
@@ -5635,7 +5635,7 @@ 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((resolve15, reject) => {
+  const authData = await new Promise((resolve16, reject) => {
     const timeout = setTimeout(() => {
       server.close();
       reject(new Error("Authentication timeout. Please try again."));
@@ -5692,7 +5692,7 @@ async function authenticateWithBrowser() {
           `);
           clearTimeout(timeout);
           server.close();
-          resolve15(data);
+          resolve16(data);
         } catch (error) {
           res.writeHead(500, { "Content-Type": "text/html" });
           res.end(`<h1>Authentication failed</h1><p>${escapeHtml(error.message)}</p>`);
@@ -5854,17 +5854,11 @@ var init_telemetry = __esm({
 });
 
 // src/lib/api.ts
-var api_exports = {};
-__export(api_exports, {
-  apiGet: () => apiGet,
-  apiPost: () => apiPost,
-  requireSubscription: () => requireSubscription
-});
-async function request2(method, path27, body) {
+async function request2(method, path28, body) {
   const token = await getValidToken();
   if (!token)
     throw new Error("you're not signed in yet. run: hyv init");
-  const url = `${API_BASE}${path27}`;
+  const url = `${API_BASE}${path28}`;
   const opts = {
     method,
     headers: {
@@ -5889,15 +5883,11 @@ async function request2(method, path27, body) {
   }
   return res.json();
 }
-function apiGet(path27) {
-  return request2("GET", path27);
-}
-function apiPost(path27, body) {
-  return request2("POST", path27, body);
+function apiGet(path28) {
+  return request2("GET", path28);
 }
-async function requireSubscription() {
-  const { requirePaidFeature: requirePaidFeature2 } = await Promise.resolve().then(() => (init_access(), access_exports));
-  await requirePaidFeature2("profiles");
+function apiPost(path28, body) {
+  return request2("POST", path28, body);
 }
 var init_api = __esm({
   "src/lib/api.ts"() {
@@ -5907,130 +5897,6 @@ var init_api = __esm({
   }
 });
 
-// src/lib/access.ts
-var access_exports = {};
-__export(access_exports, {
-  formatModeLabel: () => formatModeLabel,
-  getAccessState: () => getAccessState,
-  isLocalOnlyMode: () => isLocalOnlyMode,
-  maybeShowLimitedModeHint: () => maybeShowLimitedModeHint,
-  requirePaidFeature: () => requirePaidFeature,
-  setLocalOnlyMode: () => setLocalOnlyMode
-});
-function setLocalOnlyMode(enabled) {
-  localOnlyOverride = enabled;
-}
-function isLocalOnlyMode() {
-  if (localOnlyOverride)
-    return true;
-  const env = process.env.HYV_LOCAL_ONLY;
-  return env === "1" || env === "true";
-}
-async function getAccessState() {
-  if (isLocalOnlyMode()) {
-    return { authenticated: false, hasPaidPlan: false, plan: "local", localOnly: true };
-  }
-  const now = Date.now();
-  if (cachedAccess && now - cachedAccess.at < ACCESS_CACHE_MS) {
-    return cachedAccess.state;
-  }
-  const token = getToken();
-  if (!token) {
-    const state = { authenticated: false, hasPaidPlan: false, plan: "none", localOnly: false };
-    cachedAccess = { state, at: now };
-    return state;
-  }
-  try {
-    const session = await checkSession();
-    const plan = (session.plan || "none").toLowerCase();
-    const subStatus = String(session.subscription_status || "").toLowerCase();
-    const activeSubscription = !subStatus || ["active", "past_due", "trialing"].includes(subStatus);
-    const hasPaidPlan = session.valid && activeSubscription && plan !== "none" && plan !== "free" && plan !== "expired" && plan !== "unknown" && plan !== "pending";
-    const state = {
-      authenticated: session.valid,
-      hasPaidPlan,
-      plan: session.plan || "none",
-      localOnly: false
-    };
-    cachedAccess = { state, at: now };
-    return state;
-  } catch {
-    const state = { authenticated: !!token, hasPaidPlan: false, plan: "unknown", localOnly: false };
-    cachedAccess = { state, at: now };
-    return state;
-  }
-}
-async function requirePaidFeature(feature) {
-  if (isLocalOnlyMode()) {
-    throw new Error(
-      `${FEATURE_MESSAGES[feature]} (local-only mode is on \u2014 unset HYV_LOCAL_ONLY or remove --local-only)`
-    );
-  }
-  const token = getToken();
-  if (!token) {
-    throw new Error(`you're not signed in yet. run: hyv init \u2014 then ${FEATURE_MESSAGES[feature]}`);
-  }
-  let data;
-  try {
-    data = await apiGet("/cli/heartbeat");
-  } catch (err) {
-    const msg = err.message || "";
-    if (msg.includes("not signed in") || msg.includes("session expired") || msg.includes("don't have access")) {
-      throw err;
-    }
-    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") {
-    throw new Error(FEATURE_MESSAGES[feature]);
-  }
-}
-async function maybeShowLimitedModeHint(hasProfile) {
-  if (isLocalOnlyMode())
-    return;
-  const access = await getAccessState();
-  if (access.hasPaidPlan)
-    return;
-  if (hasProfile) {
-    console.log(import_chalk5.default.dim("\n  using cached profile (local). sync for latest: hyv sync"));
-  } else if (!access.authenticated) {
-    console.log(import_chalk5.default.dim("\n  local mode \u2014 free scan engine. profiles + learning: hyv init"));
-  } else {
-    console.log(import_chalk5.default.dim("\n  local mode \u2014 upgrade for full profiles + learning: hyv upgrade"));
-  }
-}
-function formatModeLabel(access, hasFullProfile) {
-  if (access.localOnly)
-    return "local-only (forced)";
-  if (access.hasPaidPlan && hasFullProfile)
-    return "full profile (paid)";
-  if (hasFullProfile)
-    return "cached profile (local)";
-  if (access.authenticated)
-    return "local engine (free)";
-  return "local engine (free, not signed in)";
-}
-var import_chalk5, FEATURE_MESSAGES, localOnlyOverride, cachedAccess, ACCESS_CACHE_MS;
-var init_access = __esm({
-  "src/lib/access.ts"() {
-    "use strict";
-    import_chalk5 = __toESM(require_source());
-    init_config();
-    init_auth();
-    init_api();
-    FEATURE_MESSAGES = {
-      profiles: "syncing voice profiles from your account requires a paid plan. run: hyv upgrade",
-      learning: "the learning loop (reinforce, add) requires a paid plan. run: hyv upgrade",
-      premiumPrompts: "rich profile-aware rewrite prompts require a paid plan. run: hyv upgrade",
-      serverAnalysis: "server-assisted analysis requires a paid plan. run: hyv upgrade"
-    };
-    localOnlyOverride = false;
-    cachedAccess = null;
-    ACCESS_CACHE_MS = 3e4;
-  }
-});
-
 // src/lib/profile.ts
 async function loadFullProfile(slug, opts = {}) {
   const includeSamples = opts.includeSamples !== false;
@@ -6242,8 +6108,12 @@ function countLearnedPatterns(slug) {
 async function loadProfileForCommand(name, opts = {}) {
   const config = readConfig();
   const candidates = [];
-  if (name)
+  if (name) {
     candidates.push(name);
+    const normalized = toSafeProfileCacheKey(name);
+    if (normalized !== name)
+      candidates.push(normalized);
+  }
   if (config.default_profile)
     candidates.push(config.default_profile);
   if (config.profile)
@@ -6294,6 +6164,250 @@ var init_local_profile = __esm({
   }
 });
 
+// src/lib/mcp-profile-hydrate.ts
+var mcp_profile_hydrate_exports = {};
+__export(mcp_profile_hydrate_exports, {
+  ensureMcpProfilesHydrated: () => ensureMcpProfilesHydrated,
+  formatMcpProfilesList: () => formatMcpProfilesList,
+  normalizeProfileSlug: () => normalizeProfileSlug
+});
+function normalizeProfileSlug(name) {
+  return toSafeProfileCacheKey(name);
+}
+async function ensureMcpProfilesHydrated(opts = {}) {
+  if (process.env.VITEST) {
+    return { ok: true, synced: [], skipped: true };
+  }
+  if (!getToken()) {
+    return { ok: true, synced: [], skipped: true };
+  }
+  const now = Date.now();
+  if (!opts.force && now - lastHydrateAt < HYDRATE_TTL_MS) {
+    return { ok: true, synced: [], skipped: true };
+  }
+  if (hydrateInFlight && !opts.force) {
+    return hydrateInFlight;
+  }
+  hydrateInFlight = runHydrate().then((result) => {
+    lastHydrateAt = Date.now();
+    return result;
+  }).finally(() => {
+    hydrateInFlight = null;
+  });
+  return hydrateInFlight;
+}
+async function runHydrate() {
+  const synced = [];
+  try {
+    const data = await apiGet("/cli/profiles");
+    const profiles = data.profiles || [];
+    if (profiles.length === 0) {
+      return { ok: true, synced: [] };
+    }
+    let defaultSlug;
+    for (const row of profiles) {
+      const slug = normalizeProfileSlug(row.slug || row.name);
+      if (row.is_default)
+        defaultSlug = slug;
+      try {
+        const detail = await apiGet(`/cli/profiles/${encodeURIComponent(slug)}`);
+        const content = (detail.content || "").trim();
+        if (content) {
+          writeCachedProfile(slug, content);
+          if (!synced.includes(slug))
+            synced.push(slug);
+        }
+        await loadFullProfile(slug, {
+          forceRefresh: true,
+          serverUpdatedAt: row.updated_at || detail.updated_at
+        });
+      } catch {
+      }
+    }
+    const config = readConfig();
+    const localNames = /* @__PURE__ */ new Set([...listCachedProfiles(), ...listDiskCachedProfiles()]);
+    const shouldSetDefault = defaultSlug && (!config.default_profile || !localNames.has(config.default_profile));
+    if (shouldSetDefault && defaultSlug) {
+      writeConfig({ ...config, default_profile: defaultSlug, profile: defaultSlug });
+    }
+    return { ok: true, synced, defaultProfile: defaultSlug || config.default_profile };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : "profile sync failed";
+    return { ok: false, synced, error: message };
+  }
+}
+function formatMcpProfilesList(hydrate) {
+  const config = readConfig();
+  const local = [.../* @__PURE__ */ new Set([...listCachedProfiles(), ...listDiskCachedProfiles()])].sort();
+  const active = config.default_profile || config.profile;
+  const lines = ["### Voice profiles (MCP-ready)"];
+  if (active && local.includes(active)) {
+    lines.push(`Active default: **${active}** \u2014 hyv_scan / hyv_rewrite / hyv_clean use this unless you pass \`profile\`.`);
+  } else if (local.length === 1) {
+    lines.push(`Active default: **${local[0]}** (only local profile).`);
+  } else if (local.length > 1) {
+    lines.push("No default set \u2014 pass `profile` on tools, or run `hyv init` + create a default in the dashboard.");
+  }
+  if (local.length > 0) {
+    lines.push("");
+    lines.push("Local (ready for MCP tools now):");
+    for (const name of local) {
+      const mark = name === active ? " (default)" : "";
+      lines.push(`  \u2022 ${name}${mark}`);
+    }
+  } else {
+    lines.push("");
+    lines.push("No local profiles yet.");
+  }
+  if (!getToken()) {
+    lines.push("");
+    lines.push("Account profiles (dashboard / web): run **`hyv init`** once on this machine \u2014 MCP will auto-download them here.");
+    lines.push("Terminal welcome (`hyv welcome`) saves locally immediately; no init needed for that path.");
+    return lines.join("\n");
+  }
+  if (hydrate?.synced?.length) {
+    lines.push("");
+    lines.push(`Just synced from your account: ${hydrate.synced.join(", ")}`);
+  } else if (hydrate?.error) {
+    lines.push("");
+    lines.push(`Account sync note: ${hydrate.error}`);
+  } else if (local.length === 0 && hydrate?.skipped) {
+    lines.push("");
+    lines.push("Signed in \u2014 checking account\u2026 if profiles exist on holdyourvoice.com, they load automatically.");
+  }
+  lines.push("");
+  lines.push("Same profile everywhere: build in **dashboard** or **`hyv welcome`**, then use MCP tools with no extra setup (after `hyv init` for dashboard-only profiles).");
+  return lines.join("\n");
+}
+var lastHydrateAt, hydrateInFlight, HYDRATE_TTL_MS;
+var init_mcp_profile_hydrate = __esm({
+  "src/lib/mcp-profile-hydrate.ts"() {
+    "use strict";
+    init_config();
+    init_api();
+    init_profile();
+    init_local_profile();
+    lastHydrateAt = 0;
+    hydrateInFlight = null;
+    HYDRATE_TTL_MS = 5 * 60 * 1e3;
+  }
+});
+
+// src/lib/access.ts
+function setLocalOnlyMode(enabled) {
+  localOnlyOverride = enabled;
+}
+function isLocalOnlyMode() {
+  if (localOnlyOverride)
+    return true;
+  const env = process.env.HYV_LOCAL_ONLY;
+  return env === "1" || env === "true";
+}
+async function getAccessState() {
+  if (isLocalOnlyMode()) {
+    return { authenticated: false, hasPaidPlan: false, plan: "local", localOnly: true };
+  }
+  const now = Date.now();
+  if (cachedAccess && now - cachedAccess.at < ACCESS_CACHE_MS) {
+    return cachedAccess.state;
+  }
+  const token = getToken();
+  if (!token) {
+    const state = { authenticated: false, hasPaidPlan: false, plan: "none", localOnly: false };
+    cachedAccess = { state, at: now };
+    return state;
+  }
+  try {
+    const session = await checkSession();
+    const plan = (session.plan || "none").toLowerCase();
+    const subStatus = String(session.subscription_status || "").toLowerCase();
+    const activeSubscription = !subStatus || ["active", "past_due", "trialing"].includes(subStatus);
+    const hasPaidPlan = session.valid && activeSubscription && plan !== "none" && plan !== "free" && plan !== "expired" && plan !== "unknown" && plan !== "pending";
+    const state = {
+      authenticated: session.valid,
+      hasPaidPlan,
+      plan: session.plan || "none",
+      localOnly: false
+    };
+    cachedAccess = { state, at: now };
+    return state;
+  } catch {
+    const state = { authenticated: !!token, hasPaidPlan: false, plan: "unknown", localOnly: false };
+    cachedAccess = { state, at: now };
+    return state;
+  }
+}
+async function requirePaidFeature(feature) {
+  if (isLocalOnlyMode()) {
+    throw new Error(
+      `${FEATURE_MESSAGES[feature]} (local-only mode is on \u2014 unset HYV_LOCAL_ONLY or remove --local-only)`
+    );
+  }
+  const token = getToken();
+  if (!token) {
+    throw new Error(`you're not signed in yet. run: hyv init \u2014 then ${FEATURE_MESSAGES[feature]}`);
+  }
+  let data;
+  try {
+    data = await apiGet("/cli/heartbeat");
+  } catch (err) {
+    const msg = err.message || "";
+    if (msg.includes("not signed in") || msg.includes("session expired") || msg.includes("don't have access")) {
+      throw err;
+    }
+    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") {
+    throw new Error(FEATURE_MESSAGES[feature]);
+  }
+}
+async function maybeShowLimitedModeHint(hasProfile) {
+  if (isLocalOnlyMode())
+    return;
+  const access = await getAccessState();
+  if (access.hasPaidPlan)
+    return;
+  if (hasProfile) {
+    console.log(import_chalk5.default.dim("\n  using cached profile (local). sync for latest: hyv sync"));
+  } else if (!access.authenticated) {
+    console.log(import_chalk5.default.dim("\n  local mode \u2014 free scan engine. profiles + learning: hyv init"));
+  } else {
+    console.log(import_chalk5.default.dim("\n  local mode \u2014 upgrade for full profiles + learning: hyv upgrade"));
+  }
+}
+function formatModeLabel(access, hasFullProfile) {
+  if (access.localOnly)
+    return "local-only (forced)";
+  if (access.hasPaidPlan && hasFullProfile)
+    return "full profile (paid)";
+  if (hasFullProfile)
+    return "cached profile (local)";
+  if (access.authenticated)
+    return "local engine (free)";
+  return "local engine (free, not signed in)";
+}
+var import_chalk5, FEATURE_MESSAGES, localOnlyOverride, cachedAccess, ACCESS_CACHE_MS;
+var init_access = __esm({
+  "src/lib/access.ts"() {
+    "use strict";
+    import_chalk5 = __toESM(require_source());
+    init_config();
+    init_auth();
+    init_api();
+    FEATURE_MESSAGES = {
+      profiles: "syncing voice profiles from your account requires a paid plan. run: hyv upgrade",
+      learning: "the learning loop (reinforce, add) requires a paid plan. run: hyv upgrade",
+      premiumPrompts: "rich profile-aware rewrite prompts require a paid plan. run: hyv upgrade",
+      serverAnalysis: "server-assisted analysis requires a paid plan. run: hyv upgrade"
+    };
+    localOnlyOverride = false;
+    cachedAccess = null;
+    ACCESS_CACHE_MS = 3e4;
+  }
+});
+
 // src/lib/profile-parse.ts
 function parseAnchorsFromBody(body) {
   const anchors = [];
@@ -7432,7 +7546,7 @@ function ps(n7) {
   return n7.replace(as, fe).replace(ls, ue).replace(cs, qt).replace(fs10, de).replace(us, pe);
 }
 function ms(n7) {
-  return n7.replace(is, "\\").replace(rs, "{").replace(ns, "}").replace(os6, ",").replace(hs, ".");
+  return n7.replace(is, "\\").replace(rs, "{").replace(ns, "}").replace(os7, ",").replace(hs, ".");
 }
 function me(n7) {
   if (!n7)
@@ -7532,7 +7646,7 @@ function Ut(n7, t = {}) {
 function es(n7, t = {}) {
   return new I(n7, t).iterate();
 }
-var import_node_url, import_node_path, import_node_url2, import_fs, xi, import_promises, import_node_events, import_node_stream, import_node_string_decoder, Gt, ce, ss, fe, ue, qt, de, pe, is, rs, ns, os6, hs, as, ls, cs, fs10, us, ds, at, Ss, lt, Es, we, ye, W, xs, be, vs, Ct, Cs, Ts, As, ks, Kt, Se, Ee, Q, tt, O, Rs, Os, Fs, Ds, Ms, Ns, _s, Ls, Ws, Ps, js, Is, zs, Bs, Us, $s, Gs, Hs, Ce, Te, Ae, xe, qs, A, Ks, Vs, Ys, Xs, Js, N, Zs, ke, Qs, ti, ve, ei, D, si, Oe, Vt, Fe, At, Re, ii, q, De, Tt, ri, ft, Ne, oi, hi, ai, G, H, K, kt, ut, Rt, _e, Ot, Le, P, et, v, dt, st, C, F, T, Yt, Ft, k, x, Xt, Jt, We, Zt, B, Qt, Dt, pt, Y, M, mt, li, ci, fi, ui, Mt, te, di, pi, V, vi, wt, Ue, $e, Ri, Oi, L, Ge, He, U, qe, Ke, X, Ve, _, gt, se, je, yt, j, Nt, Lt, Ie, Fi, ie, ze, bt, Be, _t, Wt, ne, Ye, R, Pt, jt, It, it, rt, St, Cr, Xe, Di, Mi, Ni, nt, _i, ot, oe, he, ae, Et, Li, zt, xt, vt, Pi, I, le, ji, Ii, zi, Bi, Ui, Ze;
+var import_node_url, import_node_path, import_node_url2, import_fs, xi, import_promises, import_node_events, import_node_stream, import_node_string_decoder, Gt, ce, ss, fe, ue, qt, de, pe, is, rs, ns, os7, hs, as, ls, cs, fs10, us, ds, at, Ss, lt, Es, we, ye, W, xs, be, vs, Ct, Cs, Ts, As, ks, Kt, Se, Ee, Q, tt, O, Rs, Os, Fs, Ds, Ms, Ns, _s, Ls, Ws, Ps, js, Is, zs, Bs, Us, $s, Gs, Hs, Ce, Te, Ae, xe, qs, A, Ks, Vs, Ys, Xs, Js, N, Zs, ke, Qs, ti, ve, ei, D, si, Oe, Vt, Fe, At, Re, ii, q, De, Tt, ri, ft, Ne, oi, hi, ai, G, H, K, kt, ut, Rt, _e, Ot, Le, P, et, v, dt, st, C, F, T, Yt, Ft, k, x, Xt, Jt, We, Zt, B, Qt, Dt, pt, Y, M, mt, li, ci, fi, ui, Mt, te, di, pi, V, vi, wt, Ue, $e, Ri, Oi, L, Ge, He, U, qe, Ke, X, Ve, _, gt, se, je, yt, j, Nt, Lt, Ie, Fi, ie, ze, bt, Be, _t, Wt, ne, Ye, R, Pt, jt, It, it, rt, St, Cr, Xe, Di, Mi, Ni, nt, _i, ot, oe, he, ae, Et, Li, zt, xt, vt, Pi, I, le, ji, Ii, zi, Bi, Ui, Ze;
 var init_index_min = __esm({
   "node_modules/glob/dist/esm/index.min.js"() {
     import_node_url = require("node:url");
@@ -7579,7 +7693,7 @@ var init_index_min = __esm({
     is = new RegExp(fe, "g");
     rs = new RegExp(ue, "g");
     ns = new RegExp(qt, "g");
-    os6 = new RegExp(de, "g");
+    os7 = new RegExp(de, "g");
     hs = new RegExp(pe, "g");
     as = /\\\\/g;
     ls = /\\{/g;
@@ -10740,18 +10854,18 @@ function stripXmlText(xml) {
 }
 function commandExists(cmd) {
   try {
-    (0, import_child_process2.execFileSync)("which", [cmd], { stdio: "ignore" });
+    (0, import_child_process3.execFileSync)("which", [cmd], { stdio: "ignore" });
     return true;
   } catch {
     return false;
   }
 }
 function unzipList(filePath) {
-  const out = (0, import_child_process2.execFileSync)("unzip", ["-Z1", filePath], { encoding: "utf-8", maxBuffer: 5e6 });
+  const out = (0, import_child_process3.execFileSync)("unzip", ["-Z1", filePath], { encoding: "utf-8", maxBuffer: 5e6 });
   return out.split("\n").map((l) => l.trim()).filter(Boolean);
 }
 function unzipExtract(filePath, entry) {
-  return (0, import_child_process2.execFileSync)("unzip", ["-p", filePath, entry], {
+  return (0, import_child_process3.execFileSync)("unzip", ["-p", filePath, entry], {
     encoding: "utf-8",
     maxBuffer: 1e7
   });
@@ -10759,7 +10873,7 @@ function unzipExtract(filePath, entry) {
 function extractDocx(filePath) {
   if (process.platform === "darwin") {
     try {
-      const out = (0, import_child_process2.execFileSync)("textutil", ["-convert", "txt", "-stdout", filePath], {
+      const out = (0, import_child_process3.execFileSync)("textutil", ["-convert", "txt", "-stdout", filePath], {
         encoding: "utf-8",
         maxBuffer: 1e7
       });
@@ -10802,7 +10916,7 @@ function extractPdfRaw(buffer) {
 function extractPdf(filePath) {
   if (process.platform === "darwin") {
     try {
-      const out = (0, import_child_process2.execFileSync)("textutil", ["-convert", "txt", "-stdout", filePath], {
+      const out = (0, import_child_process3.execFileSync)("textutil", ["-convert", "txt", "-stdout", filePath], {
         encoding: "utf-8",
         maxBuffer: 1e7
       });
@@ -10812,7 +10926,7 @@ function extractPdf(filePath) {
     }
   }
   if (commandExists("pdftotext")) {
-    const out = (0, import_child_process2.execFileSync)("pdftotext", ["-layout", "-enc", "UTF-8", filePath, "-"], {
+    const out = (0, import_child_process3.execFileSync)("pdftotext", ["-layout", "-enc", "UTF-8", filePath, "-"], {
       encoding: "utf-8",
       maxBuffer: 1e7
     });
@@ -10877,7 +10991,7 @@ function listDocumentsInDir(dirPath) {
   }).filter(isSupportedDocument);
 }
 function collectDocumentsFromPath(inputPath) {
-  const resolved = path10.resolve(inputPath.trim().replace(/^~(?=$|\/)/, os7.homedir()));
+  const resolved = path10.resolve(inputPath.trim().replace(/^~(?=$|\/)/, os8.homedir()));
   if (!fs11.existsSync(resolved)) {
     throw new Error(`path not found: ${resolved}`);
   }
@@ -10908,19 +11022,19 @@ function readDraftInput(input) {
   const trimmed = input.trim();
   if (!trimmed)
     throw new Error("empty draft");
-  const maybePath = path10.resolve(trimmed.replace(/^~(?=$|\/)/, os7.homedir()));
+  const maybePath = path10.resolve(trimmed.replace(/^~(?=$|\/)/, os8.homedir()));
   if (fs11.existsSync(maybePath) && fs11.statSync(maybePath).isFile()) {
     return { text: extractTextFromFile(maybePath), source: maybePath };
   }
   return { text: trimmed, source: "paste" };
 }
-var import_child_process2, fs11, os7, path10, SUPPORTED_EXTENSIONS, SAMPLE_GLOB, GLOB_IGNORE;
+var import_child_process3, fs11, os8, path10, SUPPORTED_EXTENSIONS, SAMPLE_GLOB, GLOB_IGNORE;
 var init_document_text = __esm({
   "src/lib/document-text.ts"() {
     "use strict";
-    import_child_process2 = require("child_process");
+    import_child_process3 = require("child_process");
     fs11 = __toESM(require("fs"));
-    os7 = __toESM(require("os"));
+    os8 = __toESM(require("os"));
     path10 = __toESM(require("path"));
     init_index_min();
     SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Set([
@@ -10996,21 +11110,21 @@ function runPipeline(text, profile, applyFixes = false) {
   };
 }
 function readText(source) {
-  const fs30 = require("fs");
-  const path27 = require("path");
+  const fs31 = require("fs");
+  const path28 = require("path");
   if (source === "-") {
     if (process.stdin.isTTY) {
       console.error("No input provided. Pipe content or specify a file.");
       process.exit(1);
     }
-    return { text: fs30.readFileSync(0, "utf-8"), path: "stdin" };
+    return { text: fs31.readFileSync(0, "utf-8"), path: "stdin" };
   }
-  const resolved = path27.resolve(source);
-  if (!fs30.existsSync(resolved)) {
+  const resolved = path28.resolve(source);
+  if (!fs31.existsSync(resolved)) {
     console.error(`File not found: ${resolved}`);
     process.exit(1);
   }
-  const stat = fs30.statSync(resolved);
+  const stat = fs31.statSync(resolved);
   if (stat.isDirectory()) {
     console.error(`${resolved} is a directory, not a file.`);
     process.exit(1);
@@ -11410,7 +11524,7 @@ function isInteractiveTTY() {
   return Boolean(process.stdin.isTTY && process.stdout.isTTY && !process.env.CI);
 }
 function briefPause(ms2 = 280) {
-  return new Promise((resolve15) => setTimeout(resolve15, ms2));
+  return new Promise((resolve16) => setTimeout(resolve16, ms2));
 }
 async function withSpinner(label, fn, opts = {}) {
   const minMs = opts.minMs ?? 450;
@@ -11461,10 +11575,10 @@ var init_terminal_ui = __esm({
 
 // src/lib/welcome-flow.ts
 function localProfilePath(name) {
-  return path14.join(os8.homedir(), ".hyv", "profiles", `${name}.md`);
+  return path14.join(os9.homedir(), ".hyv", "profiles", `${name}.md`);
 }
 function listLocalProfileNames() {
-  const profilesDir = path14.join(os8.homedir(), ".hyv", "profiles");
+  const profilesDir = path14.join(os9.homedir(), ".hyv", "profiles");
   if (!fs15.existsSync(profilesDir))
     return [];
   return fs15.readdirSync(profilesDir).filter((entry) => entry.endsWith(".md")).map((entry) => entry.slice(0, -3));
@@ -11627,13 +11741,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");
 }
@@ -11644,6 +11759,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");
   }
@@ -11725,10 +11841,10 @@ function saveLocalProfile(name, content) {
   writeWelcomeState({ profile_name: safe });
   markStepComplete("name");
   markStepComplete("samples");
-  return path14.join(os8.homedir(), ".hyv", "profiles", `${safe}.md`);
+  return path14.join(os9.homedir(), ".hyv", "profiles", `${safe}.md`);
 }
 function fetchUrlText(url) {
-  return new Promise((resolve15, reject) => {
+  return new Promise((resolve16, reject) => {
     let parsed;
     try {
       parsed = new URL(url);
@@ -11757,7 +11873,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();
-          resolve15(text.slice(0, 12e3));
+          resolve16(text.slice(0, 12e3));
         });
       }
     );
@@ -11777,10 +11893,10 @@ async function collectSamplesFromLink(url) {
 }
 function askLine(prompt) {
   const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve15) => {
+  return new Promise((resolve16) => {
     rl.question(prompt, (answer) => {
       rl.close();
-      resolve15(answer.trim());
+      resolve16(answer.trim());
     });
   });
 }
@@ -11789,11 +11905,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((resolve15) => {
+  return new Promise((resolve16) => {
     rl.on("line", (line) => {
       if (line.trim() === "---") {
         rl.close();
-        resolve15(lines.join("\n").trim());
+        resolve16(lines.join("\n").trim());
         return;
       }
       lines.push(line);
@@ -12072,7 +12188,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"}
@@ -12091,7 +12208,7 @@ function getMcpWelcomeResponse(args2) {
   }
   return buildWelcomeGuide({ profileName: args2.profile, forLlm: true });
 }
-var import_chalk12, fs15, http2, https2, os8, path14, readline, PROFILE_SYNC_TIMEOUT_MS, WELCOME_TAGLINE, FLOW_STEPS, STATE_FILE;
+var import_chalk12, fs15, http2, https2, os9, path14, readline, PROFILE_SYNC_TIMEOUT_MS, WELCOME_TAGLINE, FLOW_STEPS, STATE_FILE;
 var init_welcome_flow = __esm({
   "src/lib/welcome-flow.ts"() {
     "use strict";
@@ -12099,7 +12216,7 @@ var init_welcome_flow = __esm({
     fs15 = __toESM(require("fs"));
     http2 = __toESM(require("http"));
     https2 = __toESM(require("https"));
-    os8 = __toESM(require("os"));
+    os9 = __toESM(require("os"));
     path14 = __toESM(require("path"));
     readline = __toESM(require("readline"));
     init_pipeline();
@@ -12121,7 +12238,7 @@ var init_welcome_flow = __esm({
       { n: 3, key: "test", title: "test on a draft", hint: "optional \u2014 scan or rewrite a draft" },
       { n: 4, key: "signup", title: "save & unlock", hint: "signup syncs your profile and unlocks learning" }
     ];
-    STATE_FILE = path14.join(os8.homedir(), ".hyv", "welcome-state.json");
+    STATE_FILE = path14.join(os9.homedir(), ".hyv", "welcome-state.json");
   }
 });
 
@@ -12204,6 +12321,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");
@@ -13157,15 +13275,15 @@ globstar while`, t, d, e, u, m), this.matchOne(t.slice(d), e.slice(u), s))
       g.minimatch.escape = vi2.escape;
       g.minimatch.unescape = Ei2.unescape;
     });
-    var fs30 = R2((Wt2) => {
+    var fs31 = R2((Wt2) => {
       "use strict";
       Object.defineProperty(Wt2, "__esModule", { value: true });
       Wt2.LRUCache = void 0;
       var er = typeof performance == "object" && performance && typeof performance.now == "function" ? performance : Date, as2 = /* @__PURE__ */ new Set(), ge2 = typeof process == "object" && process ? process : {}, ls2 = (n7, t, e, s) => {
         typeof ge2.emitWarning == "function" ? ge2.emitWarning(n7, t, e, s) : console.error(`[${e}] ${t}: ${n7}`);
-      }, Lt2 = globalThis.AbortController, os13 = globalThis.AbortSignal;
+      }, Lt2 = globalThis.AbortController, os15 = globalThis.AbortSignal;
       if (typeof Lt2 > "u") {
-        os13 = class {
+        os15 = class {
           onabort;
           _onabort = [];
           reason;
@@ -13177,7 +13295,7 @@ globstar while`, t, d, e, u, m), this.matchOne(t.slice(d), e.slice(u), s))
           constructor() {
             t();
           }
-          signal = new os13();
+          signal = new os15();
           abort(e) {
             if (!this.signal.aborted) {
               this.signal.reason = e, this.signal.aborted = true;
@@ -14126,7 +14244,7 @@ globstar while`, t, d, e, u, m), this.matchOne(t.slice(d), e.slice(u), s))
       };
       Object.defineProperty(_2, "__esModule", { value: true });
       _2.PathScurry = _2.Path = _2.PathScurryDarwin = _2.PathScurryPosix = _2.PathScurryWin32 = _2.PathScurryBase = _2.PathPosix = _2.PathWin32 = _2.PathBase = _2.ChildrenCache = _2.ResolveCache = void 0;
-      var Qt2 = fs30(), Yt2 = require("node:path"), yr = require("node:url"), pt2 = require("fs"), Sr = br(require("node:fs")), vr = pt2.realpathSync.native, Ht2 = require("node:fs/promises"), bs2 = Oe2(), mt2 = { lstatSync: pt2.lstatSync, readdir: pt2.readdir, readdirSync: pt2.readdirSync, readlinkSync: pt2.readlinkSync, realpathSync: vr, promises: { lstat: Ht2.lstat, readdir: Ht2.readdir, readlink: Ht2.readlink, realpath: Ht2.realpath } }, _s2 = (n7) => !n7 || n7 === mt2 || n7 === Sr ? mt2 : { ...mt2, ...n7, promises: { ...mt2.promises, ...n7.promises || {} } }, Os2 = /^\\\\\?\\([a-z]:)\\?$/i, Er = (n7) => n7.replace(/\//g, "\\").replace(Os2, "$1\\"), _r = /[\\\/]/, N2 = 0, xs2 = 1, Ts2 = 2, G2 = 4, Cs2 = 6, Rs2 = 8, Q2 = 10, As2 = 12, j2 = 15, dt2 = ~j2, xe2 = 16, ys2 = 32, gt2 = 64, W2 = 128, Vt2 = 256, Xt2 = 512, Ss2 = gt2 | W2 | Xt2, Or = 1023, Te2 = (n7) => n7.isFile() ? Rs2 : n7.isDirectory() ? G2 : n7.isSymbolicLink() ? Q2 : n7.isCharacterDevice() ? Ts2 : n7.isBlockDevice() ? Cs2 : n7.isSocket() ? As2 : n7.isFIFO() ? xs2 : N2, vs2 = new Qt2.LRUCache({ max: 2 ** 12 }), wt2 = (n7) => {
+      var Qt2 = fs31(), Yt2 = require("node:path"), yr = require("node:url"), pt2 = require("fs"), Sr = br(require("node:fs")), vr = pt2.realpathSync.native, Ht2 = require("node:fs/promises"), bs2 = Oe2(), mt2 = { lstatSync: pt2.lstatSync, readdir: pt2.readdir, readdirSync: pt2.readdirSync, readlinkSync: pt2.readlinkSync, realpathSync: vr, promises: { lstat: Ht2.lstat, readdir: Ht2.readdir, readlink: Ht2.readlink, realpath: Ht2.realpath } }, _s2 = (n7) => !n7 || n7 === mt2 || n7 === Sr ? mt2 : { ...mt2, ...n7, promises: { ...mt2.promises, ...n7.promises || {} } }, Os2 = /^\\\\\?\\([a-z]:)\\?$/i, Er = (n7) => n7.replace(/\//g, "\\").replace(Os2, "$1\\"), _r = /[\\\/]/, N2 = 0, xs2 = 1, Ts2 = 2, G2 = 4, Cs2 = 6, Rs2 = 8, Q2 = 10, As2 = 12, j2 = 15, dt2 = ~j2, xe2 = 16, ys2 = 32, gt2 = 64, W2 = 128, Vt2 = 256, Xt2 = 512, Ss2 = gt2 | W2 | Xt2, Or = 1023, Te2 = (n7) => n7.isFile() ? Rs2 : n7.isDirectory() ? G2 : n7.isSymbolicLink() ? Q2 : n7.isCharacterDevice() ? Ts2 : n7.isBlockDevice() ? Cs2 : n7.isSocket() ? As2 : n7.isFIFO() ? xs2 : N2, vs2 = new Qt2.LRUCache({ max: 2 ** 12 }), wt2 = (n7) => {
         let t = vs2.get(n7);
         if (t)
           return t;
@@ -15645,7 +15763,7 @@ var {
 } = import_index.default;
 
 // src/index.ts
-var import_chalk33 = __toESM(require_source());
+var import_chalk35 = __toESM(require_source());
 
 // src/commands/init.ts
 var import_chalk4 = __toESM(require_source());
@@ -15791,10 +15909,19 @@ function registerInitCommand(program3) {
       if (authData.license_key) {
         console.log(import_chalk4.default.dim(`  License: ${authData.license_key.slice(0, 12)}...`));
       }
+      try {
+        const { ensureMcpProfilesHydrated: ensureMcpProfilesHydrated2 } = await Promise.resolve().then(() => (init_mcp_profile_hydrate(), mcp_profile_hydrate_exports));
+        const hydrated = await ensureMcpProfilesHydrated2({ force: true });
+        if (hydrated.synced?.length) {
+          console.log(import_chalk4.default.green(`
+\u2713 MCP profiles ready: ${hydrated.synced.join(", ")}`));
+        }
+      } catch {
+      }
       const mcpResults = configureMcpForDesktop();
       const { printPaidUnlockReminder: printPaidUnlockReminder2 } = await Promise.resolve().then(() => (init_marketing_hints(), marketing_hints_exports));
       console.log("\nNext steps:");
-      console.log(import_chalk4.default.dim("  1. Set up your voice:       hyv welcome"));
+      console.log(import_chalk4.default.dim("  1. Voice profile:           hyv welcome  (or use dashboard \u2014 MCP syncs after init)"));
       console.log(import_chalk4.default.dim("  2. Scan a draft:            hyv scan draft.md"));
       console.log(import_chalk4.default.dim("  3. Rewrite with voice:      hyv rewrite draft.md"));
       printPaidUnlockReminder2();
@@ -16018,6 +16145,8 @@ init_profile();
 init_profile_meta();
 var fs8 = __toESM(require("fs"));
 var path8 = __toESM(require("path"));
+var os6 = __toESM(require("os"));
+var import_child_process2 = require("child_process");
 function registerSyncCommand(program3) {
   program3.command("sync").description("Sync profiles and rules from server").option("--force", "Force re-download even if cache is fresh").action(async (options) => {
     try {
@@ -16105,7 +16234,15 @@ function registerSyncCommand(program3) {
       process.exit(1);
     }
   });
-  program3.command("profiles").description("List voice profiles").option("--verbose", "Show learned patterns, drift, anchors").option("--history <name>", "Show profile evolution for a slug").action(async (options) => {
+  program3.command("profiles").description("List, edit, or delete voice profiles").option("--verbose", "Show learned patterns, drift, anchors").option("--history <name>", "Show profile evolution for a slug").option("--delete <name>", "Delete a profile (server + local cache)").option("--edit <name>", "Open a local profile in your $EDITOR").action(async (options) => {
+    if (options.delete) {
+      await deleteProfileByName(options.delete);
+      return;
+    }
+    if (options.edit) {
+      await editLocalProfile(options.edit);
+      return;
+    }
     if (options.history) {
       await showProfileHistory(options.history);
       return;
@@ -16151,6 +16288,58 @@ ${profiles.length} profile(s) cached.`));
     await program3.parseAsync(["node", "hyv", "sync", "--force"]);
   });
 }
+async function deleteProfileByName(name) {
+  const token = getToken();
+  const localKey = toSafeProfileCacheKey(name);
+  const localPath = path8.join(os6.homedir(), ".hyv", "profiles", `${localKey}.md`);
+  if (token) {
+    try {
+      const res = await authenticatedRequest(cliApiUrl("/cli/profiles/delete"), {
+        method: "POST",
+        body: { slug_or_id: name }
+      });
+      if (res.status !== 200) {
+        const err = res.data?.error || `delete failed (HTTP ${res.status})`;
+        console.log(import_chalk8.default.red(`
+  ${err}
+`));
+        process.exit(1);
+      }
+      console.log(import_chalk8.default.green(`
+  \u2713 deleted "${name}" from your account
+`));
+    } catch (err) {
+      console.log(import_chalk8.default.red(`
+  ${err.message || "delete failed"}
+`));
+      process.exit(1);
+    }
+  } else {
+    console.log(import_chalk8.default.yellow("\n  not signed in \u2014 deleting local profile only\n"));
+  }
+  if (fs8.existsSync(localPath)) {
+    fs8.unlinkSync(localPath);
+    console.log(import_chalk8.default.dim(`  removed ${localPath}`));
+  }
+}
+async function editLocalProfile(name) {
+  const localKey = toSafeProfileCacheKey(name);
+  const localPath = path8.join(os6.homedir(), ".hyv", "profiles", `${localKey}.md`);
+  if (!fs8.existsSync(localPath)) {
+    console.log(import_chalk8.default.yellow(`
+  no local profile at ${localPath}`));
+    console.log(import_chalk8.default.dim("  run `hyv sync` or `hyv welcome` first\n"));
+    process.exit(1);
+  }
+  const editor = process.env.EDITOR || process.env.VISUAL || (process.platform === "win32" ? "notepad" : "nano");
+  const result = (0, import_child_process2.spawnSync)(editor, [localPath], { stdio: "inherit", shell: process.platform === "win32" });
+  if (result.status !== 0) {
+    process.exit(result.status || 1);
+  }
+  console.log(import_chalk8.default.green(`
+  \u2713 saved ${localPath}`));
+  console.log(import_chalk8.default.dim("  sync to account: hyv sync\n"));
+}
 async function showProfileHistory(slug) {
   const { authenticatedRequest: authenticatedRequest2 } = await Promise.resolve().then(() => (init_auth(), auth_exports));
   const token = getToken();
@@ -16990,7 +17179,7 @@ function registerImportCommand(program3) {
   });
 }
 function askQuestion(question) {
-  return new Promise((resolve15) => {
+  return new Promise((resolve16) => {
     const readline3 = require("readline");
     const rl = readline3.createInterface({
       input: process.stdin,
@@ -16999,7 +17188,7 @@ function askQuestion(question) {
     rl.question(import_chalk13.default.cyan(`  ${question}
   > `), (answer) => {
       rl.close();
-      resolve15(answer.trim());
+      resolve16(answer.trim());
     });
   });
 }
@@ -17558,7 +17747,7 @@ hyv scan ${filePath}`));
 var import_chalk19 = __toESM(require_source());
 var fs19 = __toESM(require("fs"));
 var path18 = __toESM(require("path"));
-var os9 = __toESM(require("os"));
+var os10 = __toESM(require("os"));
 init_config();
 init_auth();
 init_access();
@@ -17566,7 +17755,7 @@ init_local_profile();
 init_version();
 
 // src/lib/mcp-stdio-test.ts
-var import_child_process3 = require("child_process");
+var import_child_process4 = require("child_process");
 
 // src/lib/cli-entry.ts
 var fs18 = __toESM(require("fs"));
@@ -17596,8 +17785,8 @@ async function testMcpStdioSubprocess() {
   const entry = resolveCliEntry();
   if (!entry)
     return { ok: false };
-  return new Promise((resolve15) => {
-    const child = (0, import_child_process3.spawn)(process.execPath, [entry, "mcp"], {
+  return new Promise((resolve16) => {
+    const child = (0, import_child_process4.spawn)(process.execPath, [entry, "mcp"], {
       stdio: ["pipe", "pipe", "pipe"],
       env: { ...process.env, HYV_POSTINSTALL_QUIET: "1" }
     });
@@ -17612,7 +17801,7 @@ async function testMcpStdioSubprocess() {
         child.kill();
       } catch {
       }
-      resolve15({ ok, toolCount });
+      resolve16({ ok, toolCount });
     };
     const timeout = setTimeout(() => finish(false), 1e4);
     const handleLine = (line) => {
@@ -17663,7 +17852,7 @@ async function testMcpStdioSubprocess() {
 }
 
 // src/commands/doctor.ts
-var HOME = os9.homedir();
+var HOME = os10.homedir();
 var IS_WIN = process.platform === "win32";
 function claudeDesktopDir() {
   if (IS_WIN)
@@ -17874,7 +18063,7 @@ function registerDoctorCommand(program3) {
       if (cursorMcp)
         console.log(import_chalk19.default.green("  \u2713 mcp configured for cursor"));
     } else {
-      console.log(import_chalk19.default.yellow("  ! mcp not configured \u2014 run: hyv doctor --fix-agents or hyv mcp --setup"));
+      console.log(import_chalk19.default.yellow("  ! mcp not configured \u2014 run: hyv mcp (auto-detect) or hyv doctor --fix-agents"));
       issues++;
     }
     try {
@@ -18017,11 +18206,11 @@ async function confirmDestructiveWrite(options) {
   const question = `
 ${label}
 A .bak backup will be created. Proceed? [y/N] `;
-  const answer = await new Promise((resolve15) => {
+  const answer = await new Promise((resolve16) => {
     const rl = readline2.createInterface({ input: process.stdin, output: process.stdout });
     rl.question(question, (value) => {
       rl.close();
-      resolve15(value.trim().toLowerCase());
+      resolve16(value.trim().toLowerCase());
     });
   });
   return answer === "y" || answer === "yes";
@@ -18127,19 +18316,19 @@ function registerCheckCommand(program3) {
       const profile = await loadProfileForCommand(options.profile);
       let inputText = text;
       if (text === "-") {
-        const fs31 = require("fs");
+        const fs32 = require("fs");
         if (process.stdin.isTTY) {
           console.error(import_chalk23.default.red("No input provided. Pipe content or pass text as argument."));
           process.exit(1);
         }
-        inputText = fs31.readFileSync(0, "utf-8");
+        inputText = fs32.readFileSync(0, "utf-8");
       }
       if (!inputText.trim()) {
         console.error(import_chalk23.default.red("No text provided."));
         process.exit(1);
       }
-      const fs30 = require("fs");
-      if (text !== "-" && fs30.existsSync(text)) {
+      const fs31 = require("fs");
+      if (text !== "-" && fs31.existsSync(text)) {
         console.log(import_chalk23.default.yellow(`"${text}" looks like a file. Did you mean: hyv scan ${text}`));
         process.exit(1);
       }
@@ -18266,12 +18455,12 @@ function registerDiffCommand(program3) {
   ${result.changes.length} auto-fix${result.changes.length === 1 ? "" : "es"} available`));
       console.log(import_chalk25.default.dim(`  run: hyv fix ${file} -i  to apply`));
       if (options.apply && filePath !== "stdin") {
-        const fs30 = require("fs");
-        const path27 = require("path");
+        const fs31 = require("fs");
+        const path28 = require("path");
         const backupPath = filePath + ".bak";
-        fs30.copyFileSync(filePath, backupPath);
-        fs30.writeFileSync(filePath, result.fixed);
-        console.log(import_chalk25.default.green(`  \u2713 Applied. Backup: ${path27.basename(backupPath)}`));
+        fs31.copyFileSync(filePath, backupPath);
+        fs31.writeFileSync(filePath, result.fixed);
+        console.log(import_chalk25.default.green(`  \u2713 Applied. Backup: ${path28.basename(backupPath)}`));
       }
     } catch (error) {
       console.error(import_chalk25.default.red(`Error: ${error.message}`));
@@ -18807,13 +18996,14 @@ function registerOpenCommand(program3) {
 }
 
 // src/commands/welcome.ts
+var import_chalk31 = __toESM(require_source());
 init_welcome();
 
 // src/lib/onboarding.ts
 var fs24 = __toESM(require("fs"));
 var path22 = __toESM(require("path"));
-var os10 = __toESM(require("os"));
-var hyvDir = path22.join(os10.homedir(), ".hyv");
+var os11 = __toESM(require("os"));
+var hyvDir = path22.join(os11.homedir(), ".hyv");
 var onboardingFile = path22.join(hyvDir, "onboarding-complete.json");
 function hasCompletedOnboarding() {
   try {
@@ -18835,6 +19025,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 {
@@ -18844,10 +19048,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");
@@ -18886,7 +19095,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: {
@@ -18960,19 +19169,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"));
   });
 }
 
@@ -18986,9 +19195,9 @@ function registerUpgradeCommand(program3) {
 }
 
 // src/mcp.ts
-var fs26 = __toESM(require("fs"));
-var path24 = __toESM(require("path"));
-var os11 = __toESM(require("os"));
+var fs27 = __toESM(require("fs"));
+var path25 = __toESM(require("path"));
+var os13 = __toESM(require("os"));
 init_classifier();
 init_autofix();
 init_validator();
@@ -18996,23 +19205,201 @@ init_pipeline();
 init_signals();
 init_local_profile();
 init_welcome();
-init_config();
 init_telemetry();
 init_access();
-var VOICE_MD = path24.join(os11.homedir(), ".hyv", "voice.md");
+
+// src/lib/mcp-integrate.ts
+var import_chalk33 = __toESM(require_source());
+var fs26 = __toESM(require("fs"));
+var os12 = __toESM(require("os"));
+var path24 = __toESM(require("path"));
+init_version();
+init_welcome_flow();
+init_config();
+init_local_profile();
+function resolveCliRoot() {
+  const candidates = [
+    path24.resolve(__dirname, ".."),
+    path24.resolve(__dirname, "..", "..")
+  ];
+  for (const root of candidates) {
+    if (fs26.existsSync(path24.join(root, "scripts", "postinstall-lib.js"))) {
+      return root;
+    }
+  }
+  return candidates[0];
+}
+function loadPostinstallLib() {
+  return require(path24.join(resolveCliRoot(), "scripts", "postinstall-lib.js"));
+}
+function runMcpAutoIntegrate(opts = {}) {
+  const { integrateDetectedAgents } = loadPostinstallLib();
+  return integrateDetectedAgents({
+    pkgDir: resolveCliRoot(),
+    quiet: true,
+    force: Boolean(opts.force)
+  });
+}
+function listLocalProfileNames2() {
+  return [.../* @__PURE__ */ new Set([...listCachedProfiles(), ...listDiskCachedProfiles()])].sort();
+}
+function buildOnboardingStatusLines() {
+  const lines = [];
+  const welcome = readWelcomeState();
+  const profiles = listLocalProfileNames2();
+  const onboarded = hasCompletedOnboarding();
+  const config = readConfig();
+  const active = config.default_profile || config.profile;
+  if (profiles.length > 0) {
+    const activeNote = active && profiles.includes(active) ? ` (default: ${active})` : "";
+    lines.push(`voice profiles (MCP-ready): ${profiles.join(", ")}${activeNote}`);
+  } else {
+    lines.push("voice profiles: none on this machine yet");
+    lines.push("dashboard profile \u2192 run `hyv init` once; terminal `hyv welcome` \u2192 saved locally automatically");
+  }
+  if (welcome.profile_name) {
+    lines.push(`welcome progress: profile name "${welcome.profile_name}"`);
+  }
+  if (welcome.completed_steps?.length) {
+    const done = welcome.completed_steps.map((key) => FLOW_STEPS.find((s) => s.key === key)?.title || key).join(", ");
+    lines.push(`welcome steps done: ${done}`);
+  } else if (!onboarded) {
+    lines.push("welcome steps: not started (or only partial)");
+  }
+  lines.push("free without profile: hyv_scan, hyv_demo, hyv_fix, hyv_check work offline");
+  lines.push("with profile: hyv_rewrite, hyv_validate, hyv_clean use your voice rules");
+  return lines;
+}
+function formatChatGptConnectorGuide() {
+  const lib = loadPostinstallLib();
+  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)",
+    "",
+    "1. Open ChatGPT **desktop** app (browser chat cannot use local MCP)",
+    "2. Settings \u2192 Connectors \u2192 Add connector",
+    "3. Name: **hold your voice**",
+    "4. Command: **hyv**",
+    "5. Arguments: **mcp**",
+    "",
+    "If the connector fails to start, use absolute paths:",
+    `   command: ${mcpCmd.command}`,
+    `   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.");
+  }
+  return lines.join("\n");
+}
+function buildMcpAgentStatus() {
+  const {
+    detectInstalledAgents,
+    isAgentIntegrated,
+    resolveHyvMcpCommand
+  } = loadPostinstallLib();
+  const home = os12.homedir();
+  const detected = detectInstalledAgents(home);
+  const mcpCmd = resolveHyvMcpCommand(resolveCliRoot());
+  const lines = [
+    "### HYV MCP status",
+    "",
+    `mcp server command: ${mcpCmd.command} ${mcpCmd.args.join(" ")}`,
+    "",
+    ...buildOnboardingStatusLines().map((l) => `- ${l}`),
+    ""
+  ];
+  if (detected.length === 0) {
+    lines.push("### Installed apps");
+    lines.push("- none detected \u2014 install Cursor, Claude Desktop, ChatGPT Desktop, etc.");
+    lines.push("- then run `hyv mcp` in terminal or call hyv_mcp_setup with action=integrate");
+    lines.push("");
+    lines.push(formatChatGptConnectorGuide());
+    return lines.join("\n");
+  }
+  lines.push("### Installed apps");
+  for (const app of detected) {
+    const integrated = isAgentIntegrated(app.id, home);
+    const status = app.integration === "manual" ? integrated ? "guide written" : "add connector manually" : integrated ? "integrated" : "needs setup";
+    lines.push(`- ${app.label}: ${status} (${app.integration})`);
+  }
+  lines.push("");
+  lines.push("### In this chat (no terminal needed)");
+  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("- Test free scan \u2192 hyv_demo or hyv_scan on any draft");
+  return lines.join("\n");
+}
+function formatMcpIntegrateReportText(result, opts = {}) {
+  const { agentIdForConfiguredLabel, isAgentIntegrated } = loadPostinstallLib();
+  const configuredIds = new Set(
+    result.configured.map((label) => agentIdForConfiguredLabel(label)).filter(Boolean)
+  );
+  const lines = [
+    "### HYV MCP integration",
+    "",
+    ...buildOnboardingStatusLines().map((l) => `- ${l}`),
+    ""
+  ];
+  if (result.detected.length === 0) {
+    lines.push("No supported AI apps detected on this machine.");
+    lines.push("Install Cursor, Claude Desktop, Windsurf, or ChatGPT Desktop, then run integrate again.");
+    lines.push("");
+    lines.push(formatChatGptConnectorGuide());
+    return lines.join("\n");
+  }
+  lines.push("### Apps");
+  for (const app of result.detected) {
+    const justConfigured = configuredIds.has(app.id);
+    const integrated = isAgentIntegrated(app.id) || justConfigured;
+    const status = app.integration === "manual" ? "manual connector" : justConfigured ? opts.force ? "updated now" : "configured now" : integrated ? "integrated" : "needs setup";
+    lines.push(`- ${app.label}: ${status}`);
+  }
+  if (result.configured.length > 0) {
+    lines.push("");
+    lines.push(`Wired: ${result.configured.join(", ")}`);
+  }
+  if (result.warnings.length > 0) {
+    lines.push("");
+    lines.push("Notes:");
+    for (const warning of result.warnings) {
+      lines.push(`- ${warning}`);
+    }
+  }
+  lines.push("");
+  lines.push("Restart MCP hosts (Cursor, Claude Desktop, Antigravity, OpenCode) after config changes.");
+  if (result.detected.some((a) => a.integration === "manual")) {
+    lines.push("");
+    lines.push(formatChatGptConnectorGuide());
+  }
+  return lines.join("\n");
+}
+
+// src/mcp.ts
+init_mcp_profile_hydrate();
+init_profile();
+var VOICE_MD = path25.join(os13.homedir(), ".hyv", "voice.md");
 var MAX_RESPONSE_CHARS = 12e4;
 var MAX_SCAN_FILE_BYTES = 2 * 1024 * 1024;
 function readScanFile(filePath) {
-  const cwdReal = fs26.realpathSync(process.cwd());
-  const resolved = fs26.realpathSync(path24.resolve(filePath));
-  if (!resolved.startsWith(cwdReal + path24.sep) && resolved !== cwdReal) {
+  const cwdReal = fs27.realpathSync(process.cwd());
+  const resolved = fs27.realpathSync(path25.resolve(filePath));
+  if (!resolved.startsWith(cwdReal + path25.sep) && resolved !== cwdReal) {
     throw new Error(`file must be in the current working directory (${cwdReal})`);
   }
-  const stat = fs26.statSync(resolved);
+  const stat = fs27.statSync(resolved);
   if (stat.size > MAX_SCAN_FILE_BYTES) {
     throw new Error(`file too large (max ${MAX_SCAN_FILE_BYTES} bytes)`);
   }
-  return fs26.readFileSync(resolved, "utf-8");
+  return fs27.readFileSync(resolved, "utf-8");
 }
 function toolResultPayload(result) {
   const isError = result.startsWith("Error:") || result.startsWith("Unknown tool:");
@@ -19021,20 +19408,22 @@ function toolResultPayload(result) {
     ...isError ? { isError: true } : {}
   };
 }
-var pkgPath = path24.resolve(__dirname, "..", "package.json");
+var pkgPath = path25.resolve(__dirname, "..", "package.json");
 var pkgVersion = (() => {
   try {
-    return JSON.parse(fs26.readFileSync(pkgPath, "utf-8")).version;
+    return JSON.parse(fs27.readFileSync(pkgPath, "utf-8")).version;
   } catch {
     return "2.7.1";
   }
 })();
-async function resolveProfile(slug, allowServerFetch = false) {
-  const profile = await loadProfileForCommand(slug, { allowServerFetch });
-  if (slug && !profile) {
-    const { requirePaidFeature: requirePaidFeature2 } = await Promise.resolve().then(() => (init_access(), access_exports));
-    await requirePaidFeature2("premiumPrompts");
-    return loadProfileForCommand(slug, { allowServerFetch: true });
+async function resolveProfile(slug) {
+  await ensureMcpProfilesHydrated();
+  let profile = await loadProfileForCommand(slug, { allowServerFetch: true });
+  if (!profile && slug) {
+    try {
+      profile = await loadFullProfile(normalizeProfileSlug(slug), { forceRefresh: true });
+    } catch {
+    }
   }
   return profile;
 }
@@ -19134,27 +19523,8 @@ async function toolScan(args2) {
   }
 }
 async function toolProfiles(_args) {
-  const local = [.../* @__PURE__ */ new Set([...listCachedProfiles(), ...listDiskCachedProfiles()])];
-  if (local.length > 0) {
-    return "Cached profiles (local):\n" + local.map((p) => `  \u2022 ${p}`).join("\n");
-  }
-  try {
-    const { apiGet: apiGet2 } = await Promise.resolve().then(() => (init_api(), api_exports));
-    const data = await apiGet2("/cli/profiles");
-    const profiles = data.profiles || [];
-    if (profiles.length === 0) {
-      return "No voice profiles found. Free local scan works without a profile. Run: hyv init";
-    }
-    return profiles.map(
-      (p) => `${p.name}${p.is_default ? " (default)" : ""}${p.keywords?.length ? " \u2014 " + p.keywords.slice(0, 3).join(", ") : ""}`
-    ).join("\n");
-  } catch (err) {
-    const msg = err.message || "";
-    if (msg.includes("session expired") || msg.includes("not signed in")) {
-      return "Not signed in. Free local scan/fix/check work offline. Run `hyv init` for profiles.";
-    }
-    return `Cached profiles: none. Free local engine ready. (${msg})`;
-  }
+  const hydrate = await ensureMcpProfilesHydrated();
+  return formatMcpProfilesList(hydrate);
 }
 async function toolValidate(args2) {
   const text = args2.text || "";
@@ -19262,6 +19632,22 @@ function toolListFreeTools() {
 function toolDemo() {
   return getDemoText();
 }
+function toolMcpSetup(args2 = {}) {
+  const action = (args2.action || "status").toLowerCase();
+  const force = Boolean(args2.force);
+  switch (action) {
+    case "status":
+      return buildMcpAgentStatus();
+    case "integrate": {
+      const result = runMcpAutoIntegrate({ force });
+      return formatMcpIntegrateReportText(result, { force });
+    }
+    case "chatgpt":
+      return formatChatGptConnectorGuide();
+    default:
+      return `Error: unknown action "${args2.action}". Use status, integrate, or chatgpt.`;
+  }
+}
 async function toolAnalyze(args2) {
   const text = args2.text || "";
   if (!text.trim())
@@ -19356,6 +19742,23 @@ async function toolClean(args2) {
   }
 }
 var TOOLS = [
+  {
+    name: "hyv_mcp_setup",
+    description: "MCP host setup without terminal: status of installed apps, auto-integrate configs, or ChatGPT Desktop connector steps. Works with or without a voice profile \u2014 use hyv_welcome for onboarding.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        action: {
+          type: "string",
+          description: "status (default) | integrate (wire hyv into Cursor/Claude/etc.) | chatgpt (desktop connector steps)"
+        },
+        force: {
+          type: "boolean",
+          description: "Refresh MCP configs even when already integrated (e.g. after hyv upgrade)"
+        }
+      }
+    }
+  },
   {
     name: "hyv_welcome",
     description: "Profile-first onboarding: name \u2192 samples \u2192 test draft \u2192 signup. Call when the user is new. Use step (1-4) for one step, mode extract_prompt for chat voice extraction.",
@@ -19478,7 +19881,7 @@ var TOOLS = [
   },
   {
     name: "hyv_profiles",
-    description: "List cached or account voice profiles. Falls back gracefully when not signed in.",
+    description: "List voice profiles ready for MCP tools (local + account after hyv init). Shows active default. Call before hyv_rewrite/hyv_clean if unsure which profile to use.",
     inputSchema: { type: "object", properties: {} }
   },
   {
@@ -19503,14 +19906,15 @@ var PROMPTS = [
 ];
 var HYV_STATUS_PROMPT = `Use hold your voice MCP tools:
 
-1. New user \u2192 hyv_welcome (or step 1\u20134). Step 2: hyv_welcome mode=extract_prompt to build profile from chat.
-2. Save profile \u2192 user runs hyv import <name> file.md (or you draft markdown for them).
-3. hyv_profiles \u2014 list local/account profiles.
-4. Writing: hyv_scan \u2192 hyv_fix / hyv_rewrite \u2192 hyv_validate.
-5. Ready to pay \u2192 hyv init + hyv plan --upgrade (signup last, not first).
+0. MCP setup \u2192 hyv_mcp_setup (status | integrate | chatgpt). Profiles \u2192 hyv_profiles (lists MCP-ready profiles).
+1. Profiles work automatically: terminal \`hyv welcome\` saves locally; dashboard profiles need \`hyv init\` once on this machine (MCP auto-syncs).
+2. New onboarding in chat \u2192 hyv_welcome. Step 2: mode=extract_prompt. Save markdown \u2192 hyv import or dashboard.
+3. Writing (use active profile from hyv_profiles): hyv_scan \u2192 hyv_fix / hyv_rewrite \u2192 hyv_validate. Optional profile= slug.
+4. Paid extras \u2192 hyv init + hyv plan --upgrade (signup last).
 
 Keep the answer compact.`;
 var TOOL_HANDLERS = {
+  hyv_mcp_setup: toolMcpSetup,
   hyv_welcome: toolWelcome,
   hyv_list_free_tools: () => toolListFreeTools(),
   hyv_demo: () => toolDemo(),
@@ -19605,14 +20009,31 @@ async function handleRequest(line) {
 }
 async function startMcpServer() {
   const access = await getAccessState().catch(() => null);
-  if (fs26.existsSync(VOICE_MD)) {
+  const config = (() => {
+    try {
+      return JSON.parse(fs27.readFileSync(path25.join(os13.homedir(), ".hyv", "config.json"), "utf-8"));
+    } catch {
+      return {};
+    }
+  })();
+  const defaultProfile = config.default_profile || config.profile;
+  if (defaultProfile) {
+    mcpLog("info", `default profile: ${defaultProfile}`);
+  } else if (fs27.existsSync(VOICE_MD)) {
     mcpLog("info", `voice profile: ${VOICE_MD}`);
   } else {
-    mcpLog("info", "free local engine ready \u2014 no voice profile yet");
+    mcpLog("info", "free local engine ready \u2014 no voice profile yet (hyv_profiles / hyv init)");
   }
   if (access) {
     mcpLog("info", `mode: ${access.hasPaidPlan ? "paid" : "free local"}${access.authenticated ? "" : " (not signed in)"}`);
   }
+  ensureMcpProfilesHydrated().then((r) => {
+    if (r.synced?.length)
+      mcpLog("info", `synced account profiles: ${r.synced.join(", ")}`);
+    else if (r.error)
+      mcpLog("info", `account profile sync skipped: ${r.error}`);
+  }).catch(() => {
+  });
   let buffer = "";
   process.stdin.setEncoding("utf-8");
   let requestChain = Promise.resolve();
@@ -19637,150 +20058,184 @@ async function startMcpServer() {
 }
 
 // src/lib/mcp-setup.ts
-var import_chalk32 = __toESM(require_source());
-var fs27 = __toESM(require("fs"));
-var path25 = __toESM(require("path"));
-var os12 = __toESM(require("os"));
+var import_chalk34 = __toESM(require_source());
+var fs28 = __toESM(require("fs"));
+var path26 = __toESM(require("path"));
+var os14 = __toESM(require("os"));
 init_version();
-var HOME2 = os12.homedir();
+var HOME2 = os14.homedir();
 var IS_WIN2 = process.platform === "win32";
 function claudeDesktopConfigPath() {
   if (IS_WIN2)
-    return path25.join(HOME2, "AppData", "Roaming", "Claude", "claude_desktop_config.json");
+    return path26.join(HOME2, "AppData", "Roaming", "Claude", "claude_desktop_config.json");
   if (process.platform === "linux")
-    return path25.join(HOME2, ".config", "Claude", "claude_desktop_config.json");
-  return path25.join(HOME2, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+    return path26.join(HOME2, ".config", "Claude", "claude_desktop_config.json");
+  return path26.join(HOME2, "Library", "Application Support", "Claude", "claude_desktop_config.json");
 }
 function printMcpSetup() {
-  console.log(import_chalk32.default.bold("\nhold your voice \u2014 mcp setup\n"));
-  console.log(import_chalk32.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_chalk32.default.bold("Claude Desktop"));
-  console.log(import_chalk32.default.dim("  Add to claude_desktop_config.json \u2192 mcpServers.hyv:"));
-  console.log(import_chalk32.default.cyan(`  ${mcpServerSnippet().split("\n").join("\n  ")}`));
-  console.log(import_chalk32.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_chalk32.default.bold("Cursor"));
-  console.log(import_chalk32.default.dim("  MCP: ~/.cursor/mcp.json \u2192 mcpServers.hyv (same JSON as above)"));
-  console.log(import_chalk32.default.dim("  Rule: ~/.cursor/rules/hyv.mdc (alwaysApply \u2014 auto via postinstall)\n"));
-  console.log(import_chalk32.default.bold("Claude Code"));
-  console.log(import_chalk32.default.dim("  Command: ~/.claude/commands/hyv.md"));
-  console.log(import_chalk32.default.dim("  Skill: ~/.claude/skills/hold-your-voice/SKILL.md\n"));
-  console.log(import_chalk32.default.bold("Windsurf"));
-  console.log(import_chalk32.default.dim("  Rule: ~/.windsurf/rules/hyv.md (trigger: always_on)\n"));
-  console.log(import_chalk32.default.bold("Codex"));
-  console.log(import_chalk32.default.dim("  Instructions: ~/.codex/AGENTS.md (merged on install)\n"));
-  console.log(import_chalk32.default.bold("Command Code"));
-  console.log(import_chalk32.default.dim("  Skill: ~/.commandcode/skills/hyv/SKILL.md\n"));
-  console.log(import_chalk32.default.bold("ChatGPT Desktop (manual connector)"));
-  console.log(import_chalk32.default.dim("  Settings \u2192 Connectors \u2192 add connector"));
-  console.log(import_chalk32.default.dim("  Name: hold your voice  |  Command: hyv  |  Arguments: mcp"));
-  console.log(import_chalk32.default.dim("  Guide: ~/.chatgpt/hyv-mcp-connector.txt (after hyv doctor --fix-agents)"));
-  console.log(import_chalk32.default.dim("  hyv mcp --setup-chatgpt\n"));
-  console.log(import_chalk32.default.bold("Antigravity"));
-  console.log(import_chalk32.default.dim("  MCP: ~/.gemini/config/mcp_config.json \u2192 mcpServers.hyv (auto via postinstall)\n"));
-  console.log(import_chalk32.default.bold("OpenCode"));
-  console.log(import_chalk32.default.dim("  MCP: ~/.config/opencode/opencode.jsonc \u2192 mcp.hyv (auto via postinstall)"));
-  console.log(import_chalk32.default.dim("  Rules: ~/.config/opencode/AGENTS.md\n"));
-  console.log(import_chalk32.default.bold("Auto-configure"));
-  console.log(import_chalk32.default.dim("  hyv doctor --fix-agents"));
-  console.log(import_chalk32.default.dim("  HYV_AUTO_CONFIGURE_AGENTS=0 npm i -g @holdyourvoice/hyv  (skip)\n"));
-  console.log(import_chalk32.default.bold("Verify"));
-  console.log(import_chalk32.default.dim("  hyv mcp --test"));
-  console.log(import_chalk32.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_chalk32.default.bold("\nhold your voice \u2014 mcp self-test\n"));
-  console.log(import_chalk32.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_chalk32.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_chalk32.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 = ["hyv_welcome", "hyv_scan", "hyv_analyze", "hyv_clean", "hyv_validate", "hyv_list_free_tools"];
+  const required = [
+    "hyv_mcp_setup",
+    "hyv_welcome",
+    "hyv_scan",
+    "hyv_analyze",
+    "hyv_clean",
+    "hyv_validate",
+    "hyv_list_free_tools"
+  ];
   for (const name of required) {
     if (tools.includes(name)) {
-      console.log(import_chalk32.default.green(`  \u2713 tool: ${name}`));
+      console.log(import_chalk34.default.green(`  \u2713 tool: ${name}`));
       passed++;
     } else {
-      console.log(import_chalk32.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_chalk32.default.green("  \u2713 hyv_welcome responds"));
+      console.log(import_chalk34.default.green("  \u2713 hyv_welcome responds"));
       passed++;
     } else {
-      console.log(import_chalk32.default.red("  \u2717 hyv_welcome unexpected output"));
+      console.log(import_chalk34.default.red("  \u2717 hyv_welcome unexpected output"));
       failed++;
     }
   } catch (e) {
-    console.log(import_chalk32.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_chalk34.default.green("  \u2713 hyv_mcp_setup responds"));
+      passed++;
+    } else {
+      console.log(import_chalk34.default.red("  \u2717 hyv_mcp_setup unexpected output"));
+      failed++;
+    }
+  } catch (e) {
+    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_chalk32.default.green("  \u2713 hyv_demo pipeline works"));
+      console.log(import_chalk34.default.green("  \u2713 hyv_demo pipeline works"));
       passed++;
     } else {
-      console.log(import_chalk32.default.red("  \u2717 hyv_demo unexpected output"));
+      console.log(import_chalk34.default.red("  \u2717 hyv_demo unexpected output"));
       failed++;
     }
   } catch (e) {
-    console.log(import_chalk32.default.red(`  \u2717 hyv_demo failed: ${e.message}`));
+    console.log(import_chalk34.default.red(`  \u2717 hyv_demo failed: ${e.message}`));
     failed++;
   }
-  const voiceMd = path25.join(HOME2, ".hyv", "voice.md");
-  if (fs27.existsSync(voiceMd)) {
-    console.log(import_chalk32.default.green("  \u2713 voice profile found"));
+  const voiceMd = path26.join(HOME2, ".hyv", "voice.md");
+  if (fs28.existsSync(voiceMd)) {
+    console.log(import_chalk34.default.green("  \u2713 voice profile found"));
     passed++;
   } else {
-    console.log(import_chalk32.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_chalk32.default.green("  \u2713 demo content available"));
+    console.log(import_chalk34.default.green("  \u2713 demo content available"));
     passed++;
   } else {
-    console.log(import_chalk32.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_chalk32.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_chalk32.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_chalk32.default.red("  \u2717 stdio MCP subprocess failed"));
+      console.log(import_chalk34.default.red("  \u2717 stdio MCP subprocess failed"));
       failed++;
     }
   } catch (e) {
-    console.log(import_chalk32.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_chalk32.default.green(`\u2713 all checks passed (${passed})`));
-    console.log(import_chalk32.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_chalk32.default.yellow(`! ${failed} check(s) failed, ${passed} passed`));
+  console.log(import_chalk34.default.yellow(`! ${failed} check(s) failed, ${passed} passed`));
   return false;
 }
 
 // src/commands/export.ts
-var fs28 = __toESM(require("fs"));
+var fs29 = __toESM(require("fs"));
 init_api();
 var FORMATS = {
   claude: {
@@ -19867,7 +20322,7 @@ async function exportCommand(format, opts) {
       const prompt = fmt.wrap(detail.profile, detail.body);
       if (opts.output) {
         const outFile = opts.output.replace("{name}", profile.slug || profile.name);
-        fs28.writeFileSync(outFile, prompt);
+        fs29.writeFileSync(outFile, prompt);
         results.push({ profile: profile.name, file: outFile });
       } else {
         results.push({ profile: profile.name, prompt });
@@ -19904,13 +20359,13 @@ async function exportCommand(format, opts) {
 // src/index.ts
 init_access();
 init_welcome();
-var fs29 = __toESM(require("fs"));
-var path26 = __toESM(require("path"));
+var fs30 = __toESM(require("fs"));
+var path27 = __toESM(require("path"));
 var program2 = new Command();
-var pkgPath2 = path26.resolve(__dirname, "..", "package.json");
+var pkgPath2 = path27.resolve(__dirname, "..", "package.json");
 var pkgVersion2 = (() => {
   try {
-    return JSON.parse(fs29.readFileSync(pkgPath2, "utf-8")).version;
+    return JSON.parse(fs30.readFileSync(pkgPath2, "utf-8")).version;
   } catch {
     return "2.7.1";
   }
@@ -19956,22 +20411,55 @@ program2.command("mcp").description("Start MCP server (for Claude Desktop and ot
   if (opts.setupChatgpt) {
     const home = require("os").homedir();
     const guide = require("path").join(home, ".chatgpt", "hyv-mcp-connector.txt");
-    console.log(import_chalk33.default.bold("\nhold your voice \u2014 chatgpt desktop mcp setup\n"));
-    console.log("ChatGPT has no auto-config file. Add this connector once in the desktop app:\n");
-    console.log(import_chalk33.default.dim("  1. Install hyv: ") + import_chalk33.default.cyan("npm i -g @holdyourvoice/hyv@latest && hyv welcome"));
-    console.log(import_chalk33.default.dim("  2. Open ") + import_chalk33.default.cyan("https://chatgpt.com/#settings/Connectors"));
-    console.log(import_chalk33.default.dim("  3. Add connector"));
-    console.log(import_chalk33.default.dim("  4. Name: ") + import_chalk33.default.cyan("hold your voice"));
-    console.log(import_chalk33.default.dim("  5. Command: ") + import_chalk33.default.cyan("hyv"));
-    console.log(import_chalk33.default.dim("  6. Arguments: ") + import_chalk33.default.cyan("mcp"));
-    console.log(import_chalk33.default.dim("  7. Save, restart ChatGPT Desktop, ask: scan this with hold your voice"));
-    console.log("");
+    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_chalk33.default.dim(`Full guide written to: ${guide}`));
+      console.log(import_chalk35.default.dim(`  Full connector paths written to: ${guide}`));
     } else {
-      console.log(import_chalk33.default.dim("Run hyv doctor --fix-agents to write ~/.chatgpt/hyv-mcp-connector.txt"));
+      console.log(import_chalk35.default.dim("  Run hyv doctor --fix-agents to write " + guide));
     }
-    console.log(import_chalk33.default.dim("\nBrowser chatgpt cannot use local MCP \u2014 desktop app only."));
+    console.log("");
     return;
   }
   startMcpServer();