@holdyourvoice/hyv 2.9.28 → 3.0.0

package/scripts/postinstall-lib.js

@@ -1,796 +0,0 @@
-/**
- * postinstall-lib.js — agent setup helpers (postinstall + doctor --fix-agents)
- */
-const fs = require('fs');
-const path = require('path');
-
-function readPkgVersion(pkgDir) {
-  try {
-    return JSON.parse(fs.readFileSync(path.join(pkgDir, 'package.json'), 'utf-8')).version;
-  } catch {
-    return 'unknown';
-  }
-}
-
-function readAgentsMarker(markerPath) {
-  try {
-    if (!fs.existsSync(markerPath)) return null;
-    return JSON.parse(fs.readFileSync(markerPath, 'utf-8'));
-  } catch {
-    return null;
-  }
-}
-
-function shouldUpgradeAgent(destFile, markerPath, pkgVersion) {
-  try {
-    if (!fs.existsSync(markerPath)) return !fs.existsSync(destFile);
-    const marker = readAgentsMarker(markerPath);
-    return !marker || marker.version !== pkgVersion;
-  } catch {
-    return true;
-  }
-}
-
-function copyAgent(src, dest, markerPath, pkgVersion, transform) {
-  if (!fs.existsSync(src)) return { copied: false, reason: 'missing-src' };
-  if (!shouldUpgradeAgent(dest, markerPath, pkgVersion) && fs.existsSync(dest)) {
-    return { copied: false, reason: 'up-to-date' };
-  }
-  fs.mkdirSync(path.dirname(dest), { recursive: true });
-  const raw = fs.readFileSync(src, 'utf-8');
-  const content = typeof transform === 'function' ? transform(raw) : raw;
-  fs.writeFileSync(dest, content);
-  return { copied: true, reason: fs.existsSync(dest) ? 'upgraded' : 'created' };
-}
-
-function writeAgentsMarker(hyvDir, pkgVersion) {
-  const markerPath = path.join(hyvDir, 'agents-version.json');
-  if (!fs.existsSync(hyvDir)) fs.mkdirSync(hyvDir, { recursive: true, mode: 0o700 });
-  fs.writeFileSync(
-    markerPath,
-    JSON.stringify({ version: pkgVersion, updated_at: new Date().toISOString() }, null, 2),
-    { mode: 0o600 }
-  );
-  return markerPath;
-}
-
-function onboardingPath(hyvDir) {
-  return path.join(hyvDir, 'onboarding-complete.json');
-}
-
-function hasCompletedOnboarding(hyvDir) {
-  try {
-    return fs.existsSync(onboardingPath(hyvDir));
-  } catch {
-    return false;
-  }
-}
-
-function markOnboardingComplete(hyvDir, pkgVersion) {
-  if (!fs.existsSync(hyvDir)) fs.mkdirSync(hyvDir, { recursive: true, mode: 0o700 });
-  fs.writeFileSync(
-    onboardingPath(hyvDir),
-    JSON.stringify({ version: pkgVersion, completed_at: new Date().toISOString() }, null, 2),
-    { mode: 0o600 }
-  );
-}
-
-function resolveHyvMcpCommand(pkgDir) {
-  const entry = path.join(pkgDir, 'dist', 'index.js');
-  if (fs.existsSync(entry)) {
-    return { command: process.execPath, args: [entry, 'mcp', '--stdio'] };
-  }
-  return { command: 'hyv', args: ['mcp', '--stdio'] };
-}
-
-/** OpenCode local MCP uses a command array: [node, entry, mcp] */
-function resolveHyvMcpCommandArray(pkgDir) {
-  const { command, args } = resolveHyvMcpCommand(pkgDir);
-  return [command, ...args];
-}
-
-function mcpJsonEntriesMatch(existing, desired) {
-  if (!existing || typeof existing !== 'object') return false;
-  const a = existing.args || [];
-  const b = desired.args || [];
-  return existing.command === desired.command && JSON.stringify(a) === JSON.stringify(b);
-}
-
-function mcpCommandArrayMatches(existing, desired) {
-  if (!Array.isArray(existing) || !Array.isArray(desired)) return false;
-  return JSON.stringify(existing) === JSON.stringify(desired);
-}
-
-function parseJsonc(text) {
-  const noBlock = text.replace(/\/\*[\s\S]*?\*\//g, '');
-  const noLine = noBlock.replace(/^\s*\/\/.*$/gm, '');
-  return JSON.parse(noLine);
-}
-
-function stringifyJsonc(config, originalText) {
-  const usesTrailingComma = /,\s*[}\]]/.test(originalText || '');
-  const space = (originalText || '').includes(': ') ? 2 : 2;
-  let out = JSON.stringify(config, null, space);
-  if (usesTrailingComma) {
-    out = out.replace(/,\n(\s*[}\]])/g, ',\n$1');
-  }
-  return out.endsWith('\n') ? out : `${out}\n`;
-}
-
-function readJsonObjectFromFile(file, parser) {
-  if (!fs.existsSync(file)) return { config: {}, original: '' };
-  const original = fs.readFileSync(file, 'utf-8');
-  if (!original.trim()) return { config: {}, original };
-  try {
-    const parsed = parser(original);
-    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
-      return { ok: false, reason: 'parse-error', error: 'expected json object' };
-    }
-    return { config: parsed, original };
-  } catch (err) {
-    return { ok: false, reason: 'parse-error', error: err.message };
-  }
-}
-
-function mergeJsoncConfigFile(configFile, mutator, { backup = true } = {}) {
-  fs.mkdirSync(path.dirname(configFile), { recursive: true });
-  const read = readJsonObjectFromFile(configFile, parseJsonc);
-  if (read.ok === false) return read;
-  let { config, original } = read;
-  const next = mutator(config) || config;
-  if (backup && fs.existsSync(configFile)) {
-    try {
-      fs.copyFileSync(configFile, `${configFile}.hyv.bak`);
-    } catch {
-      // non-fatal
-    }
-  }
-  fs.writeFileSync(configFile, original ? stringifyJsonc(next, original) : `${JSON.stringify(next, null, 2)}\n`);
-  return { ok: true };
-}
-
-function antigravityMcpConfigPath(home, isWin) {
-  return path.join(home, '.gemini', 'config', 'mcp_config.json');
-}
-
-function opencodeConfigDir(home, isWin) {
-  if (isWin) return path.join(home, '.config', 'opencode');
-  if (process.platform === 'linux') return path.join(home, '.config', 'opencode');
-  return path.join(home, '.config', 'opencode');
-}
-
-function chatgptHelperDir(home) {
-  return path.join(home, '.chatgpt');
-}
-
-function macAppInstalled(appName, home) {
-  if (process.platform !== 'darwin') return false;
-  const roots = ['/Applications', path.join(home, 'Applications')];
-  return roots.some((root) => fs.existsSync(path.join(root, `${appName}.app`)));
-}
-
-function dirExists(dir) {
-  try {
-    return fs.existsSync(dir) && fs.statSync(dir).isDirectory();
-  } catch {
-    return false;
-  }
-}
-
-function fileExists(file) {
-  try {
-    return fs.existsSync(file);
-  } catch {
-    return false;
-  }
-}
-
-function commandOnPath(cmd) {
-  const pathVar = process.env.PATH || '';
-  const exts = process.platform === 'win32' ? (process.env.PATHEXT || '.EXE;.CMD;.BAT').split(';') : [''];
-  for (const entry of pathVar.split(path.delimiter)) {
-    if (!entry) continue;
-    for (const ext of exts) {
-      const candidate = path.join(entry, process.platform === 'win32' ? `${cmd}${ext}` : cmd);
-      try {
-        if (fs.existsSync(candidate)) return true;
-      } catch {
-        // ignore
-      }
-    }
-  }
-  return false;
-}
-
-/**
- * Detect locally installed AI apps that hyv can integrate with.
- * @returns {{ id: string, label: string, reason: string, integration: 'mcp'|'rules'|'manual' }[]}
- */
-function detectInstalledAgents(home = require('os').homedir(), isWin = process.platform === 'win32') {
-  const detected = [];
-
-  const claudeDir = claudeDesktopDir(home, isWin);
-  if (
-    dirExists(claudeDir) ||
-    fileExists(path.join(claudeDir, 'claude_desktop_config.json')) ||
-    macAppInstalled('Claude', home)
-  ) {
-    detected.push({
-      id: 'claude-desktop',
-      label: 'claude desktop',
-      reason: dirExists(claudeDir) ? 'config directory found' : 'claude desktop app found',
-      integration: 'mcp',
-    });
-  }
-
-  const cursorDir = path.join(home, '.cursor');
-  if (dirExists(cursorDir) || macAppInstalled('Cursor', home)) {
-    detected.push({
-      id: 'cursor',
-      label: 'cursor',
-      reason: dirExists(cursorDir) ? '~/.cursor found' : 'cursor app found',
-      integration: 'mcp',
-    });
-  }
-
-  const claudeCodeDir = path.join(home, '.claude');
-  if (dirExists(claudeCodeDir) || commandOnPath('claude')) {
-    detected.push({
-      id: 'claude-code',
-      label: 'claude code',
-      reason: dirExists(claudeCodeDir) ? '~/.claude found' : 'claude cli on path',
-      integration: 'rules',
-    });
-  }
-
-  const windsurfDirs = [
-    path.join(home, '.windsurf'),
-    isWin ? path.join(home, 'AppData', 'Roaming', 'Windsurf') : path.join(home, 'Library', 'Application Support', 'Windsurf'),
-  ].filter(Boolean);
-  if (windsurfDirs.some(dirExists) || macAppInstalled('Windsurf', home)) {
-    detected.push({
-      id: 'windsurf',
-      label: 'windsurf',
-      reason: windsurfDirs.some(dirExists) ? 'windsurf config found' : 'windsurf app found',
-      integration: 'rules',
-    });
-  }
-
-  if (dirExists(path.join(home, '.codex')) || commandOnPath('codex')) {
-    detected.push({
-      id: 'codex',
-      label: 'codex',
-      reason: dirExists(path.join(home, '.codex')) ? '~/.codex found' : 'codex cli on path',
-      integration: 'rules',
-    });
-  }
-
-  if (dirExists(path.join(home, '.commandcode'))) {
-    detected.push({
-      id: 'command-code',
-      label: 'command code',
-      reason: '~/.commandcode found',
-      integration: 'rules',
-    });
-  }
-
-  const agDir = path.dirname(antigravityMcpConfigPath(home, isWin));
-  if (dirExists(agDir) || macAppInstalled('Antigravity', home)) {
-    detected.push({
-      id: 'antigravity',
-      label: 'antigravity',
-      reason: dirExists(agDir) ? '~/.gemini/config found' : 'antigravity app found',
-      integration: 'mcp',
-    });
-  }
-
-  const ocDir = opencodeConfigDir(home, isWin);
-  if (dirExists(ocDir) || commandOnPath('opencode')) {
-    detected.push({
-      id: 'opencode',
-      label: 'opencode',
-      reason: dirExists(ocDir) ? 'opencode config found' : 'opencode cli on path',
-      integration: 'mcp',
-    });
-  }
-
-  const chatgptDir = chatgptHelperDir(home);
-  if (dirExists(chatgptDir) || macAppInstalled('ChatGPT', home)) {
-    detected.push({
-      id: 'chatgpt',
-      label: 'chatgpt desktop',
-      reason: dirExists(chatgptDir) ? '~/.chatgpt found' : 'chatgpt app found',
-      integration: 'manual',
-    });
-  }
-
-  return detected;
-}
-
-function agentIdForConfiguredLabel(label) {
-  const map = {
-    'claude desktop': 'claude-desktop',
-    'claude desktop mcp': 'claude-desktop',
-    cursor: 'cursor',
-    'cursor mcp': 'cursor',
-    'claude code': 'claude-code',
-    'claude code skill': 'claude-code',
-    windsurf: 'windsurf',
-    codex: 'codex',
-    'command code': 'command-code',
-    'antigravity mcp': 'antigravity',
-    'opencode mcp': 'opencode',
-    'opencode agents': 'opencode',
-    'chatgpt connector guide': 'chatgpt',
-  };
-  return map[label] || null;
-}
-
-function isAgentIdEnabled(agentId, onlyDetected, detectedIds) {
-  if (!onlyDetected) return true;
-  return detectedIds.includes(agentId);
-}
-
-function readMcpHyvEntry(configFile) {
-  if (!fileExists(configFile)) return null;
-  try {
-    const cfg = JSON.parse(fs.readFileSync(configFile, 'utf-8'));
-    return cfg?.mcpServers?.hyv || null;
-  } catch {
-    return null;
-  }
-}
-
-function isAgentIntegrated(agentId, home = require('os').homedir(), isWin = process.platform === 'win32') {
-  switch (agentId) {
-    case 'claude-desktop':
-      return Boolean(readMcpHyvEntry(path.join(claudeDesktopDir(home, isWin), 'claude_desktop_config.json')));
-    case 'cursor':
-      return Boolean(readMcpHyvEntry(path.join(home, '.cursor', 'mcp.json')))
-        && fileExists(path.join(home, '.cursor', 'rules', 'hyv.mdc'));
-    case 'claude-code':
-      return fileExists(path.join(home, '.claude', 'commands', 'hyv.md'))
-        && fileExists(path.join(home, '.claude', 'skills', 'hold-your-voice', 'SKILL.md'));
-    case 'windsurf': {
-      const dirs = [
-        path.join(home, '.windsurf'),
-        isWin ? path.join(home, 'AppData', 'Roaming', 'Windsurf') : path.join(home, 'Library', 'Application Support', 'Windsurf'),
-      ].filter(Boolean);
-      return dirs.some((dir) => fileExists(path.join(dir, 'rules', 'hyv.md')));
-    }
-    case 'codex': {
-      const agents = path.join(home, '.codex', 'AGENTS.md');
-      return fileExists(agents) && fs.readFileSync(agents, 'utf-8').includes('hyv');
-    }
-    case 'command-code':
-      return fileExists(path.join(home, '.commandcode', 'skills', 'hyv', 'SKILL.md'));
-    case 'antigravity':
-      return Boolean(readMcpHyvEntry(antigravityMcpConfigPath(home, isWin)));
-    case 'opencode': {
-      const ocFile = path.join(opencodeConfigDir(home, isWin), 'opencode.jsonc');
-      if (!fileExists(ocFile)) return false;
-      try {
-        const cfg = parseJsonc(fs.readFileSync(ocFile, 'utf-8'));
-        return Boolean(cfg.mcp?.hyv);
-      } catch {
-        return false;
-      }
-    }
-    case 'chatgpt':
-      return fileExists(path.join(chatgptHelperDir(home), 'hyv-mcp-connector.txt'));
-    default:
-      return false;
-  }
-}
-
-function mergeJsonConfigFile(configFile, mutator, { backup = true } = {}) {
-  fs.mkdirSync(path.dirname(configFile), { recursive: true });
-  const read = readJsonObjectFromFile(configFile, (text) => JSON.parse(text));
-  if (read.ok === false) return read;
-  let { config, original } = read;
-  const next = mutator(config) || config;
-  if (backup && fs.existsSync(configFile)) {
-    try {
-      fs.copyFileSync(configFile, `${configFile}.hyv.bak`);
-    } catch {
-      // non-fatal
-    }
-  }
-  fs.writeFileSync(configFile, `${JSON.stringify(next, null, 2)}\n`);
-  return { ok: true };
-}
-
-function toCursorMdc(content) {
-  if (content.startsWith('---')) return content;
-  return [
-    '---',
-    'description: Hold Your Voice — scan and rewrite drafts for brand voice consistency',
-    'alwaysApply: true',
-    '---',
-    '',
-    content.trim(),
-    '',
-  ].join('\n');
-}
-
-function toWindsurfRule(content) {
-  if (content.startsWith('---')) return content;
-  return ['---', 'trigger: always_on', '---', '', content.trim(), ''].join('\n');
-}
-
-function mergeAgentsMd(existing, addition, title) {
-  const marker = `<!-- hyv:${title} -->`;
-  if (existing.includes(marker)) {
-    const start = existing.indexOf(marker);
-    const end = existing.indexOf('<!-- /hyv -->', start);
-    if (end !== -1) {
-      return existing.slice(0, start) + marker + '\n' + addition.trim() + '\n<!-- /hyv -->\n' + existing.slice(end + '<!-- /hyv -->'.length);
-    }
-  }
-  const block = `${marker}\n${addition.trim()}\n<!-- /hyv -->\n`;
-  return existing.trim() ? `${existing.trim()}\n\n${block}` : block;
-}
-
-function claudeDesktopDir(home, isWin) {
-  if (isWin) return path.join(home, 'AppData', 'Roaming', 'Claude');
-  if (process.platform === 'linux') return path.join(home, '.config', 'Claude');
-  return path.join(home, 'Library', 'Application Support', 'Claude');
-}
-
-/**
- * Configure MCP + agent instructions for detected IDEs.
- * @returns {{ configured: string[], warnings: string[], pkgVersion: string, detected: object[], skipped: string[] }}
- */
-function setupAgents({
-  pkgDir,
-  home = require('os').homedir(),
-  quiet = false,
-  onlyDetected = false,
-  force = false,
-} = {}) {
-  const configured = [];
-  const warnings = [];
-  const skipped = [];
-  const isWin = process.platform === 'win32';
-  const hyvDir = path.join(home, '.hyv');
-  const agentsMarker = path.join(hyvDir, 'agents-version.json');
-  const pkgVersion = readPkgVersion(pkgDir);
-  const mcpCmd = resolveHyvMcpCommand(pkgDir);
-  const autoConfigure = process.env.HYV_AUTO_CONFIGURE_AGENTS !== '0';
-  const detected = detectInstalledAgents(home, isWin);
-  const detectedIds = detected.map((entry) => entry.id);
-
-  if (!autoConfigure) {
-    return {
-      configured,
-      warnings: ['HYV_AUTO_CONFIGURE_AGENTS=0 — skipped agent setup'],
-      pkgVersion,
-      detected,
-      skipped: detectedIds,
-    };
-  }
-
-  function installAgent(src, dest, transform) {
-    const result = copyAgent(src, dest, agentsMarker, pkgVersion, transform);
-    return result.copied;
-  }
-
-  function setupMcpJson(configFile, label) {
-    const desired = { command: mcpCmd.command, args: mcpCmd.args };
-    const result = mergeJsonConfigFile(configFile, (config) => {
-      if (!config.mcpServers) config.mcpServers = {};
-      const existing = config.mcpServers.hyv;
-      if (!existing) {
-        config.mcpServers.hyv = desired;
-        configured.push(`${label} mcp`);
-      } else if (force || !mcpJsonEntriesMatch(existing, desired)) {
-        config.mcpServers.hyv = desired;
-        configured.push(`${label} mcp (updated)`);
-      }
-      return config;
-    });
-    if (!result.ok) warnings.push(`${label}: could not update MCP config (${result.reason})`);
-    return result.ok;
-  }
-
-  // Claude Desktop MCP
-  if (isAgentIdEnabled('claude-desktop', onlyDetected, detectedIds)) {
-    try {
-      const claudeDir = claudeDesktopDir(home, isWin);
-      const configFile = path.join(claudeDir, 'claude_desktop_config.json');
-      setupMcpJson(configFile, 'claude desktop');
-    } catch (err) {
-      warnings.push(`claude desktop: ${err.message}`);
-    }
-  } else if (onlyDetected) {
-    skipped.push('claude-desktop');
-  }
-
-  // Cursor — global MCP + always-on rule (.mdc)
-  if (!isAgentIdEnabled('cursor', onlyDetected, detectedIds)) {
-    if (onlyDetected) skipped.push('cursor');
-  } else try {
-    const cursorDir = path.join(home, '.cursor');
-    fs.mkdirSync(cursorDir, { recursive: true });
-    const mcpFile = path.join(cursorDir, 'mcp.json');
-    setupMcpJson(mcpFile, 'cursor');
-    const rulesFile = path.join(cursorDir, 'rules', 'hyv.mdc');
-    const src = path.join(pkgDir, 'agents', 'cursor.md');
-    if (installAgent(src, rulesFile, toCursorMdc)) configured.push('cursor');
-    // legacy .md (upgrade path)
-    const legacy = path.join(cursorDir, 'rules', 'hyv.md');
-    if (fs.existsSync(legacy)) {
-      try { fs.unlinkSync(legacy); } catch { /* ignore */ }
-    }
-  } catch (err) {
-    warnings.push(`cursor: ${err.message}`);
-  }
-
-  // Claude Code — slash command + skill
-  if (!isAgentIdEnabled('claude-code', onlyDetected, detectedIds)) {
-    if (onlyDetected) skipped.push('claude-code');
-  } else try {
-    const cmdDir = path.join(home, '.claude', 'commands');
-    const skillDir = path.join(home, '.claude', 'skills', 'hold-your-voice');
-    fs.mkdirSync(cmdDir, { recursive: true });
-    fs.mkdirSync(skillDir, { recursive: true });
-    const cmdFile = path.join(cmdDir, 'hyv.md');
-    const skillFile = path.join(skillDir, 'SKILL.md');
-    const cmdSrc = path.join(pkgDir, 'agents', 'claude-code.md');
-    const skillSrc = path.join(pkgDir, 'skills', 'hold-your-voice', 'SKILL.md');
-    if (installAgent(cmdSrc, cmdFile)) configured.push('claude code');
-    if (fs.existsSync(skillSrc) && installAgent(skillSrc, skillFile)) configured.push('claude code skill');
-  } catch (err) {
-    warnings.push(`claude code: ${err.message}`);
-  }
-
-  // Windsurf — rules with frontmatter
-  if (!isAgentIdEnabled('windsurf', onlyDetected, detectedIds)) {
-    if (onlyDetected) skipped.push('windsurf');
-  } else try {
-    const wsDirs = [
-      isWin ? path.join(home, 'AppData', 'Roaming', 'Windsurf') : path.join(home, '.windsurf'),
-      isWin ? null : path.join(home, 'Library', 'Application Support', 'Windsurf'),
-    ].filter(Boolean);
-    const src = path.join(pkgDir, 'agents', 'windsurf.md');
-    for (const wsDir of wsDirs) {
-      fs.mkdirSync(wsDir, { recursive: true });
-      const rulesFile = path.join(wsDir, 'rules', 'hyv.md');
-      if (installAgent(src, rulesFile, toWindsurfRule)) {
-        configured.push('windsurf');
-        break;
-      }
-    }
-  } catch (err) {
-    warnings.push(`windsurf: ${err.message}`);
-  }
-
-  // Codex — ~/.codex/AGENTS.md
-  if (!isAgentIdEnabled('codex', onlyDetected, detectedIds)) {
-    if (onlyDetected) skipped.push('codex');
-  } else try {
-    const codexDir = path.join(home, '.codex');
-    fs.mkdirSync(codexDir, { recursive: true });
-    const agentsFile = path.join(codexDir, 'AGENTS.md');
-    const src = path.join(pkgDir, 'agents', 'AGENTS.md');
-    let existing = '';
-    if (fs.existsSync(agentsFile)) existing = fs.readFileSync(agentsFile, 'utf-8');
-    const addition = fs.existsSync(src) ? fs.readFileSync(src, 'utf-8') : '';
-    if (addition && shouldUpgradeAgent(agentsFile, agentsMarker, pkgVersion)) {
-      const merged = mergeAgentsMd(existing, addition, 'hold-your-voice');
-      fs.writeFileSync(agentsFile, merged);
-      configured.push('codex');
-    } else if (!fs.existsSync(agentsFile) && fs.existsSync(src)) {
-      fs.writeFileSync(agentsFile, addition.trim() + '\n');
-      configured.push('codex');
-    }
-  } catch (err) {
-    warnings.push(`codex: ${err.message}`);
-  }
-
-  // Command Code skill
-  if (!isAgentIdEnabled('command-code', onlyDetected, detectedIds)) {
-    if (onlyDetected) skipped.push('command-code');
-  } else try {
-    const ccSkillDir = path.join(home, '.commandcode', 'skills', 'hyv');
-    fs.mkdirSync(ccSkillDir, { recursive: true });
-    const skillSrc = path.join(pkgDir, 'skills', 'hold-your-voice', 'SKILL.md');
-    const skillDest = path.join(ccSkillDir, 'SKILL.md');
-    if (fs.existsSync(skillSrc) && installAgent(skillSrc, skillDest)) configured.push('command code');
-  } catch (err) {
-    warnings.push(`command code: ${err.message}`);
-  }
-
-  // Antigravity — ~/.gemini/config/mcp_config.json (absolute paths for GUI launch)
-  if (!isAgentIdEnabled('antigravity', onlyDetected, detectedIds)) {
-    if (onlyDetected) skipped.push('antigravity');
-  } else try {
-    const agFile = antigravityMcpConfigPath(home, isWin);
-    const mcpCmd = resolveHyvMcpCommand(pkgDir);
-    const desired = { command: mcpCmd.command, args: mcpCmd.args };
-    const result = mergeJsonConfigFile(agFile, (config) => {
-      if (!config.mcpServers) config.mcpServers = {};
-      const existing = config.mcpServers.hyv;
-      if (!existing) {
-        config.mcpServers.hyv = desired;
-        configured.push('antigravity mcp');
-      } else if (force || !mcpJsonEntriesMatch(existing, desired)) {
-        config.mcpServers.hyv = desired;
-        configured.push('antigravity mcp (updated)');
-      }
-      return config;
-    });
-    if (!result.ok) warnings.push(`antigravity: could not update mcp config (${result.reason})`);
-  } catch (err) {
-    warnings.push(`antigravity: ${err.message}`);
-  }
-
-  // OpenCode — ~/.config/opencode/opencode.jsonc + AGENTS.md
-  if (!isAgentIdEnabled('opencode', onlyDetected, detectedIds)) {
-    if (onlyDetected) skipped.push('opencode');
-  } else try {
-    const ocDir = opencodeConfigDir(home, isWin);
-    const ocFile = path.join(ocDir, 'opencode.jsonc');
-    const cmdArr = resolveHyvMcpCommandArray(pkgDir);
-    const ocResult = mergeJsoncConfigFile(ocFile, (config) => {
-      if (!config.mcp) config.mcp = {};
-      const existing = config.mcp.hyv;
-      const desired = { type: 'local', command: cmdArr, enabled: true };
-      if (!existing) {
-        config.mcp.hyv = desired;
-        configured.push('opencode mcp');
-      } else if (force || !mcpCommandArrayMatches(existing.command, cmdArr)) {
-        config.mcp.hyv = { ...existing, ...desired, command: cmdArr };
-        configured.push('opencode mcp (updated)');
-      }
-      return config;
-    });
-    if (!ocResult.ok) warnings.push(`opencode: could not update opencode.jsonc (${ocResult.reason})`);
-
-    const agentsFile = path.join(ocDir, 'AGENTS.md');
-    const agentsSrc = path.join(pkgDir, 'agents', 'AGENTS.md');
-    let existing = '';
-    if (fs.existsSync(agentsFile)) existing = fs.readFileSync(agentsFile, 'utf-8');
-    const addition = fs.existsSync(agentsSrc) ? fs.readFileSync(agentsSrc, 'utf-8') : '';
-    if (addition && shouldUpgradeAgent(agentsFile, agentsMarker, pkgVersion)) {
-      const merged = mergeAgentsMd(existing, addition, 'hold-your-voice');
-      fs.mkdirSync(ocDir, { recursive: true });
-      fs.writeFileSync(agentsFile, merged);
-      configured.push('opencode agents');
-    } else if (!fs.existsSync(agentsFile) && addition) {
-      fs.mkdirSync(ocDir, { recursive: true });
-      fs.writeFileSync(agentsFile, `${addition.trim()}\n`);
-      configured.push('opencode agents');
-    }
-  } catch (err) {
-    warnings.push(`opencode: ${err.message}`);
-  }
-
-  // ChatGPT — connector helper (UI has no config file; write exact values for manual add)
-  if (!isAgentIdEnabled('chatgpt', onlyDetected, detectedIds)) {
-    if (onlyDetected) skipped.push('chatgpt');
-  } else try {
-    const cgDir = chatgptHelperDir(home);
-    fs.mkdirSync(cgDir, { recursive: true });
-    const mcpCmd = resolveHyvMcpCommand(pkgDir);
-    const connectorGuide = [
-      'hold your voice — chatgpt desktop setup',
-      '',
-      '=== RECOMMENDED — PATH A: remote oauth (paid hyv users) ===',
-      '  No local install. OAuth runs in ChatGPT\'s browser — no Windows firewall issues.',
-      '  Requires: paid HYV plan + ChatGPT Desktop',
-      '',
-      '  1. In ChatGPT: Settings → turn Developer mode ON',
-      '     (Accept the elevated risk warning — expected, not a HYV bug)',
-      '  2. Settings → Apps → New App',
-      '  3. Fill in:',
-      '     Name:           hold your voice',
-      '     Description:    Scans writing for AI patterns and voice drift',
-      '     Connection:     Server URL → https://holdyourvoice.com/mcp',
-      '     Authentication: OAuth',
-      '     Checkbox:       "I understand and want to continue"',
-      '  4. Save → complete OAuth sign-in to holdyourvoice.com',
-      '  5. Test: "scan this with hold your voice"',
-      '',
-      '  Cloud app setup: https://holdyourvoice.com/app/api/mcp',
-      '  Wiki guide:      https://holdyourvoice.com/wiki/use-hyv-in-chatgpt',
-      '',
-      '=== FALLBACK — PATH B: local connector (free users only) ===',
-      '  Only if you do not have a paid HYV plan. Requires Node.js 18+.',
-      '',
-      '  1. Install hyv: npm i -g @holdyourvoice/hyv@latest && hyv welcome',
-      '  2. In ChatGPT: Settings → Connectors (or https://chatgpt.com/#settings/Connectors)',
-      '  3. Add connector:',
-      `     Name:      hold your voice`,
-      `     Command:   ${mcpCmd.command}`,
-      `     Arguments: ${mcpCmd.args.join(' ')}`,
-      '  4. Save, restart ChatGPT Desktop',
-      '  5. Test: "scan this with hold your voice"',
-      '',
-      '  If connector fails to start, use the absolute paths above.',
-      '',
-      '=== not seeing "New App"? ===',
-      '  • Turn Developer mode ON in ChatGPT settings — Path A needs it',
-      '  • If you only see Connectors, you are on Path B (free fallback)',
-      '  • Browser ChatGPT cannot use MCP — desktop app only',
-      '',
-      'More help: hyv mcp --setup-chatgpt',
-      '',
-    ].join('\n');
-    const guideFile = path.join(cgDir, 'hyv-mcp-connector.txt');
-    fs.writeFileSync(guideFile, connectorGuide);
-    configured.push('chatgpt connector guide');
-
-    const chatgptSrc = path.join(pkgDir, 'agents', 'chatgpt.md');
-    const instrFile = path.join(cgDir, 'hyv-instructions.txt');
-    if (fs.existsSync(chatgptSrc)) installAgent(chatgptSrc, instrFile);
-  } catch (err) {
-    warnings.push(`chatgpt: ${err.message}`);
-  }
-
-  // Generic reference copy (always when auto-configure runs)
-  try {
-    const genericSrc = path.join(pkgDir, 'agents', 'AGENTS.md');
-    const genericDest = path.join(hyvDir, 'agents', 'AGENTS.md');
-    if (fs.existsSync(genericSrc)) installAgent(genericSrc, genericDest);
-  } catch {
-    // non-fatal
-  }
-
-  writeAgentsMarker(hyvDir, pkgVersion);
-  if (!quiet && warnings.length) {
-    for (const w of warnings) process.stderr.write(`[hyv postinstall] warning: ${w}\n`);
-  }
-  return {
-    configured: [...new Set(configured)],
-    warnings,
-    pkgVersion,
-    detected,
-    skipped: [...new Set(skipped)],
-  };
-}
-
-/**
- * Detect installed apps and configure hyv MCP/rules for each one.
- * @returns {{ detected: object[], configured: string[], warnings: string[], skipped: string[] }}
- */
-function integrateDetectedAgents({ pkgDir, home = require('os').homedir(), quiet = false, force = false } = {}) {
-  const detected = detectInstalledAgents(home);
-  if (detected.length === 0) {
-    return { detected, configured: [], warnings: [], skipped: [] };
-  }
-  const result = setupAgents({ pkgDir, home, quiet, onlyDetected: true, force });
-  return {
-    detected: result.detected || detected,
-    configured: result.configured || [],
-    warnings: result.warnings || [],
-    skipped: result.skipped || [],
-  };
-}
-
-module.exports = {
-  readPkgVersion,
-  readAgentsMarker,
-  shouldUpgradeAgent,
-  copyAgent,
-  writeAgentsMarker,
-  onboardingPath,
-  hasCompletedOnboarding,
-  markOnboardingComplete,
-  resolveHyvMcpCommand,
-  resolveHyvMcpCommandArray,
-  parseJsonc,
-  mergeJsonConfigFile,
-  mergeJsoncConfigFile,
-  toCursorMdc,
-  toWindsurfRule,
-  setupAgents,
-  detectInstalledAgents,
-  integrateDetectedAgents,
-  agentIdForConfiguredLabel,
-  isAgentIntegrated,
-  claudeDesktopDir,
-  antigravityMcpConfigPath,
-  opencodeConfigDir,
-  chatgptHelperDir,
-};