@holdyourvoice/hyv 2.9.10 → 2.9.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holdyourvoice/hyv",
-  "version": "2.9.10",
+  "version": "2.9.12",
   "description": "Free local AI writing scan for cursor & claude. MCP server, 220+ pattern detection, voice profiles. npx @holdyourvoice/hyv welcome",
   "main": "dist/index.js",
   "bin": {
@@ -59,6 +59,8 @@
     "dist/",
     "scripts/postinstall.js",
     "scripts/postinstall-lib.js",
+    "scripts/install.sh",
+    "scripts/install.ps1",
     "scripts/check-no-duplicates.js",
     "assets/",
     "skills/",

package/scripts/install.ps1

@@ -0,0 +1,89 @@
+# hold your voice — install node (if needed) + @holdyourvoice/hyv
+param(
+  [switch]$EnsureNodeOnly
+)
+
+$ErrorActionPreference = 'Stop'
+
+$HyvPkg = '@holdyourvoice/hyv@latest'
+$MinNodeMajor = 18
+
+function Write-Log([string]$Message) { Write-Host "  $Message" }
+
+function Test-NodeOk {
+  if (-not (Get-Command node -ErrorAction SilentlyContinue)) { return $false }
+  $major = [int](node -p "parseInt(process.versions.node.split('.')[0], 10)")
+  return $major -ge $MinNodeMajor
+}
+
+function Refresh-Path {
+  $machine = [Environment]::GetEnvironmentVariable('Path', 'Machine')
+  $user = [Environment]::GetEnvironmentVariable('Path', 'User')
+  if ($machine -or $user) {
+    $env:Path = @($machine, $user) -join ';'
+  }
+}
+
+function Install-Node {
+  if (Get-Command winget -ErrorAction SilentlyContinue) {
+    Write-Log 'installing node via winget...'
+    winget install OpenJS.NodeJS.LTS --accept-package-agreements --accept-source-agreements
+    Refresh-Path
+    return
+  }
+  if (Get-Command choco -ErrorAction SilentlyContinue) {
+    Write-Log 'installing node via chocolatey...'
+    choco install nodejs-lts -y
+    Refresh-Path
+    return
+  }
+  $lts = '22.16.0'
+  $msi = "node-v$lts-x64.msi"
+  $url = "https://nodejs.org/dist/v$lts/$msi"
+  $tmp = Join-Path $env:TEMP "hyv-node-$msi"
+  Write-Log "downloading node $lts..."
+  Invoke-WebRequest -Uri $url -OutFile $tmp -UseBasicParsing
+  Write-Log 'installing node...'
+  Start-Process msiexec.exe -ArgumentList "/i `"$tmp`" /qn" -Wait
+  Refresh-Path
+}
+
+function Ensure-Node {
+  Refresh-Path
+  if (Test-NodeOk) {
+    Write-Log "node $(node -v) found"
+    return
+  }
+  Write-Log "node $MinNodeMajor+ not found — installing automatically..."
+  Install-Node
+  Refresh-Path
+  if (-not (Test-NodeOk)) {
+    throw 'node install finished but node is still not on PATH — open a new terminal and run this script again'
+  }
+  Write-Log "node $(node -v) ready"
+}
+
+function Install-Hyv {
+  if (-not (Get-Command npm -ErrorAction SilentlyContinue)) {
+    throw 'npm not found after node install'
+  }
+  Write-Log 'installing hold your voice...'
+  npm i -g $HyvPkg
+  Refresh-Path
+  if (Get-Command hyv -ErrorAction SilentlyContinue) {
+    Write-Log 'running hyv welcome...'
+    hyv welcome
+  } else {
+    Write-Host '  ! hyv installed but not on PATH — open a new terminal and run: hyv welcome' -ForegroundColor Yellow
+  }
+}
+
+Write-Host ''
+Write-Host 'hold your voice — installer'
+Write-Host ''
+Ensure-Node
+if ($EnsureNodeOnly) { exit 0 }
+Install-Hyv
+Write-Host ''
+Write-Host '  ✓ done — hyv is ready'
+Write-Host ''

package/scripts/install.sh

@@ -0,0 +1,155 @@
+#!/usr/bin/env bash
+# hold your voice — install node (if needed) + @holdyourvoice/hyv
+set -euo pipefail
+
+HYV_PKG="@holdyourvoice/hyv@latest"
+MIN_NODE_MAJOR=18
+NODE_LTS="22.16.0"
+ENSURE_NODE_ONLY=0
+
+for arg in "$@"; do
+  case "$arg" in
+    --ensure-node-only) ENSURE_NODE_ONLY=1 ;;
+  esac
+done
+
+log() { printf '  %s\n' "$*"; }
+warn() { printf '  ! %s\n' "$*" >&2; }
+
+node_major() {
+  node -p "parseInt(process.versions.node.split('.')[0], 10)" 2>/dev/null || echo 0
+}
+
+node_ok() {
+  command -v node >/dev/null 2>&1 || return 1
+  [[ "$(node_major)" -ge "$MIN_NODE_MAJOR" ]]
+}
+
+refresh_path() {
+  export PATH="/usr/local/bin:/opt/homebrew/bin:${HOME}/.local/share/fnm:${PATH}"
+  hash -r 2>/dev/null || true
+}
+
+install_node_fnm() {
+  export FNM_DIR="${FNM_DIR:-${HOME}/.local/share/fnm}"
+  export FNM_VERSION="${FNM_VERSION:-v1.38.1}"
+  mkdir -p "$FNM_DIR"
+  if ! command -v fnm >/dev/null 2>&1; then
+    log "installing fnm (user-level node manager)..."
+    curl -fsSL https://fnm.vercel.app/install | bash -s -- --install-no-use
+  fi
+  refresh_path
+  if ! command -v fnm >/dev/null 2>&1 && [[ -x "${FNM_DIR}/fnm" ]]; then
+    export PATH="${FNM_DIR}:${PATH}"
+  fi
+  command -v fnm >/dev/null 2>&1 || return 1
+  eval "$(fnm env)"
+  fnm install "$NODE_LTS"
+  fnm default "$NODE_LTS"
+  eval "$(fnm env)"
+}
+
+install_node_mac() {
+  if command -v brew >/dev/null 2>&1; then
+    log "installing node via homebrew..."
+    brew install node
+    refresh_path
+    return 0
+  fi
+  if install_node_fnm; then
+    refresh_path
+    return 0
+  fi
+  local arch pkg
+  arch="$(uname -m)"
+  case "$arch" in
+    arm64) pkg="node-v${NODE_LTS}.pkg" ;;
+    x86_64) pkg="node-v${NODE_LTS}.pkg" ;;
+    *) warn "unsupported mac architecture: $arch"; return 1 ;;
+  esac
+  local url="https://nodejs.org/dist/v${NODE_LTS}/${pkg}"
+  local tmp="/tmp/hyv-node-v${NODE_LTS}.pkg"
+  log "downloading node ${NODE_LTS}..."
+  curl -fsSL "$url" -o "$tmp"
+  log "installing node (may ask for your password)..."
+  sudo installer -pkg "$tmp" -target /
+  refresh_path
+}
+
+install_node_linux() {
+  if install_node_fnm; then
+    refresh_path
+    return 0
+  fi
+  if command -v apt-get >/dev/null 2>&1; then
+    log "installing node via apt (nodesource)..."
+    curl -fsSL "https://deb.nodesource.com/setup_${NODE_LTS%%.*}.x" | sudo -E bash -
+    sudo apt-get install -y nodejs
+    refresh_path
+    return 0
+  fi
+  if command -v dnf >/dev/null 2>&1; then
+    log "installing node via dnf..."
+    sudo dnf install -y nodejs npm
+    refresh_path
+    return 0
+  fi
+  warn "could not auto-install node on this linux distro — install node ${MIN_NODE_MAJOR}+ manually"
+  return 1
+}
+
+install_node() {
+  case "$(uname -s)" in
+    Darwin) install_node_mac ;;
+    Linux) install_node_linux ;;
+    *)
+      warn "unsupported platform for auto node install"
+      return 1
+      ;;
+  esac
+}
+
+ensure_node() {
+  refresh_path
+  if node_ok; then
+    log "node $(node -v) found"
+    return 0
+  fi
+  log "node ${MIN_NODE_MAJOR}+ not found — installing automatically..."
+  install_node
+  refresh_path
+  if node_ok; then
+    log "node $(node -v) ready"
+    return 0
+  fi
+  warn "node install finished but node is still not on PATH — open a new terminal and run this script again"
+  return 1
+}
+
+install_hyv() {
+  if ! command -v npm >/dev/null 2>&1; then
+    warn "npm not found after node install"
+    return 1
+  fi
+  log "installing hold your voice..."
+  npm i -g "$HYV_PKG"
+  refresh_path
+  if command -v hyv >/dev/null 2>&1; then
+    log "running hyv welcome..."
+    hyv welcome
+  else
+    warn "hyv installed but not on PATH — open a new terminal and run: hyv welcome"
+  fi
+}
+
+main() {
+  printf '\nhold your voice — installer\n\n'
+  ensure_node
+  if [[ "$ENSURE_NODE_ONLY" -eq 1 ]]; then
+    exit 0
+  fi
+  install_hyv
+  printf '\n  ✓ done — hyv is ready\n\n'
+}
+
+main "$@"

package/scripts/postinstall-lib.js

@@ -83,16 +83,79 @@ function resolveHyvMcpCommand(pkgDir) {
   return { command: 'hyv', args: ['mcp'] };
 }
 
-function mergeJsonConfigFile(configFile, mutator, { backup = true } = {}) {
+/** OpenCode local MCP uses a command array: [node, entry, mcp] */
+function resolveHyvMcpCommandArray(pkgDir) {
+  const { command, args } = resolveHyvMcpCommand(pkgDir);
+  return [command, ...args];
+}
+
+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 });
-  let config = {};
-  if (fs.existsSync(configFile)) {
+  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 {
-      config = JSON.parse(fs.readFileSync(configFile, 'utf-8'));
-    } catch (err) {
-      return { ok: false, reason: 'parse-error', error: err.message };
+      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 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 {
@@ -101,7 +164,7 @@ function mergeJsonConfigFile(configFile, mutator, { backup = true } = {}) {
       // non-fatal
     }
   }
-  fs.writeFileSync(configFile, JSON.stringify(next, null, 2));
+  fs.writeFileSync(configFile, `${JSON.stringify(next, null, 2)}\n`);
   return { ok: true };
 }
 
@@ -274,6 +337,93 @@ function setupAgents({ pkgDir, home = require('os').homedir(), quiet = false })
     warnings.push(`command code: ${err.message}`);
   }
 
+  // Antigravity — ~/.gemini/config/mcp_config.json (absolute paths for GUI launch)
+  try {
+    const agFile = antigravityMcpConfigPath(home, isWin);
+    const mcpCmd = resolveHyvMcpCommand(pkgDir);
+    const result = mergeJsonConfigFile(agFile, (config) => {
+      if (!config.mcpServers) config.mcpServers = {};
+      if (!config.mcpServers.hyv) {
+        config.mcpServers.hyv = { command: mcpCmd.command, args: mcpCmd.args };
+        configured.push('antigravity mcp');
+      }
+      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
+  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 = {};
+      if (!config.mcp.hyv) {
+        config.mcp.hyv = { type: 'local', command: cmdArr, enabled: true };
+        configured.push('opencode mcp');
+      }
+      return config;
+    });
+    if (!ocResult.ok) warnings.push(`opencode: could not update opencode.jsonc (${ocResult.reason})`);
+
+    const agentsFile = path.join(ocDir, 'AGENTS.md');
+    const genericSrc = path.join(pkgDir, 'agents', 'generic.md');
+    let existing = '';
+    if (fs.existsSync(agentsFile)) existing = fs.readFileSync(agentsFile, 'utf-8');
+    const addition = fs.existsSync(genericSrc) ? fs.readFileSync(genericSrc, '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)
+  try {
+    const cgDir = chatgptHelperDir(home);
+    fs.mkdirSync(cgDir, { recursive: true });
+    const mcpCmd = resolveHyvMcpCommand(pkgDir);
+    const connectorGuide = [
+      'hold your voice — chatgpt desktop mcp connector',
+      '',
+      'chatgpt has no auto-config file. add this connector once in the chatgpt desktop app:',
+      '',
+      '1. open chatgpt desktop (not the browser)',
+      '2. settings → connectors → add connector',
+      '3. name: hold your voice',
+      '4. command: hyv',
+      '5. arguments: mcp',
+      '',
+      'if the connector fails to start, use absolute paths instead:',
+      `   command: ${mcpCmd.command}`,
+      `   arguments: ${mcpCmd.args.join(' ')}`,
+      '',
+      'then restart chatgpt desktop and ask: scan this with hold your voice',
+      '',
+      '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
   try {
     const genericSrc = path.join(pkgDir, 'agents', 'generic.md');
@@ -300,9 +450,15 @@ module.exports = {
   hasCompletedOnboarding,
   markOnboardingComplete,
   resolveHyvMcpCommand,
+  resolveHyvMcpCommandArray,
+  parseJsonc,
   mergeJsonConfigFile,
+  mergeJsoncConfigFile,
   toCursorMdc,
   toWindsurfRule,
   setupAgents,
   claudeDesktopDir,
+  antigravityMcpConfigPath,
+  opencodeConfigDir,
+  chatgptHelperDir,
 };

package/scripts/postinstall.js

@@ -19,6 +19,7 @@ function print(msg) {
 print('');
 print('  ✓ hold your voice installed — free local scan ready');
 print('  next: hyv welcome  |  hyv scan draft.md  |  hyv mcp --setup');
+print('  no node yet? curl -fsSL https://holdyourvoice.com/install.sh | bash');
 print('');
 
 const { configured, warnings } = setupAgents({ pkgDir, quiet });