@reconcrap/boss-recommend-mcp 2.1.22 → 2.1.24

package/README.md

@@ -177,6 +177,8 @@ boss-recommend-mcp schedule-status --schedule-id <schedule_id>
 - 不会对每位候选人重复确认
 - 推荐页详情处理完成后，会强制关闭详情页并确认已关闭
 - 简历提取优先使用 Network 响应；没有可解析 Network CV 时，回退到完整滚动截图序列再交给多模态模型判断
+- recommend / search / chat 共用同一条截图安全路径：浏览器只截取可见视口（`captureBeyondViewport:false`、`fromSurface:true`、不传 `clip`），再由现有 Sharp 依赖在本地裁剪 CV 区域；滚动序列至少保留 20% 重叠，只有在连续两次滚动且图像与可用 DOM 锚点均无进展后才判定到底。达到页数上限但没有终止证据时会 fail closed，不会把可能截断的简历交给模型。
+- `Page.captureScreenshot` 不会在 CDP 断线后自动重放；超时或连接关闭会放弃原 session、重新获取 document / iframe / CV target，并且每位候选人最多做一次工作流级恢复。视口健康度始终相对最初稳定基线比较宽度和高度，恢复后需要连续两次稳定读数。
 - recommend / search / 带 `criteria` 的 chat 正式运行默认全部使用 `screening-config.json` 配置的 LLM 筛选；chat 的 `criteria` 留空时进入收集简历模式，不需要 LLM 配置。deterministic/local scorer 只保留给明确测试场景，必须显式传 `debug_test_mode=true` 且 `screening_mode=deterministic` 或 `use_llm=false`。
 - `detail_limit=0`、`no_filter`、`filter_enabled=false`、后置动作 dry-run、chat 求简历 dry-run 等调试路径不会在正式 live run 默认启用；需要测试时必须显式传 `debug_test_mode=true`。
 - 提供显式运维自愈工具：只在手动调用 `run_recommend_self_heal` 时运行，不会接入正常 run / doctor / preflight 自动链路
@@ -464,6 +466,8 @@ node src/cli.js chat prepare-run --slow-live --port 9222
 说明：
 
 - `start_from` / `target_count` 为必填；`criteria` 可选，留空时 chat run 进入收集简历模式：不触发 LLM 筛选，针对没有在线/附件简历的人选发送求简历消息并点击求简历按钮
+- 收集简历模式会为每位已识别的人选随机设定 `10-15` 秒的最低处理时长；已有在线/附件简历、已发送过简历请求或需要新发请求都适用。候选人处理本身已达到目标时不再额外补时，否则只等待剩余差额。
+- 该最低处理时长独立于 `human_behavior.restLevel`：补时结束后仍按用户选择的 `low/medium/high` 执行原有休息预算；显式 `delay_ms` 也继续作为后续的额外延时。
 - `greeting_text` 可选（兼容 `greetingText`）
 - `profile` 可选，默认 `default`
 - `job` 与 `port` 继承 recommend run 已选岗位和调试端口
@@ -501,6 +505,7 @@ chat-only 交互建议：
 - 然后基于 `job_options` 让用户选择 `job`，并补齐 `start_from`、`target_count` 后调用 `start_boss_chat_run` 启动任务；若要筛选再求简历，提供 `criteria`，若只想收集缺失简历则留空。
 - `greeting_text` 可选；未传时使用 `screening-config.json.greetingMessage`，若未配置则使用默认招呼语（`Hi同学，能麻烦发下简历吗？`）。
 - `target_count` 支持正整数、`all`、`-1`；若用户给出 `全部候选人` / `所有候选人`，会自动按不限（扫到底）处理。
+- `criteria` 留空的收集简历模式固定保证每位人选从识别到提交结果至少停留随机 `10-15` 秒；该产品级下限无需新增参数，且不会替代所选休息强度。
 
 Trae-CN / 长对话防循环建议：
 

package/bin/boss-recommend-mcp.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
-import { runCli } from "../src/cli.js";
-
-await runCli(process.argv);
+#!/usr/bin/env node
+import { runCli } from "../src/cli.js";
+
+await runCli(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recommend-mcp",
-  "version": "2.1.22",
+  "version": "2.1.24",
   "description": "Unified MCP pipeline for recommend-page filtering and screening on Boss Zhipin",
   "keywords": [
     "boss",
@@ -30,6 +30,7 @@
     "test:core-infinite-list": "node src/test-core-infinite-list.js",
     "test:core-reporting": "node src/test-core-reporting.js",
     "test:core-run": "node src/test-core-run.js",
+    "test:detached-launcher": "node src/test-detached-launcher.js",
     "test:core-screening": "node src/test-core-screening.js",
     "test:core-self-heal": "node src/test-core-self-heal.js",
     "test:installer-migration": "node src/test-installer-migration.js",
@@ -37,13 +38,16 @@
     "test:recommend-domain": "node src/test-recommend-domain.js",
     "test:recommend-run-service": "node src/test-recommend-run-service.js",
     "test:recommend-mcp": "node src/test-recommend-mcp.js",
+    "test:live-recommend-mcp-smoke": "node src/test-live-recommend-mcp-smoke.js",
     "test:recruit-domain": "node src/test-recruit-domain.js",
     "test:recruit-mcp": "node src/test-recruit-mcp.js",
+    "test:chat-action-journal": "node src/test-chat-action-journal.js",
     "test:chat-domain": "node src/test-chat-domain.js",
     "test:chat-run-service": "node src/test-chat-run-service.js",
     "test:chat-mcp": "node src/test-chat-mcp.js",
     "test:async": "node src/test-index-async.js",
     "test:runtime-scan": "node src/test-runtime-scan.js",
+    "test:live-capture-acceptance": "node src/test-live-capture-acceptance.js",
     "scan:runtime": "node scripts/scan-forbidden-runtime.js",
     "scan:runtime:json": "node scripts/scan-forbidden-runtime.js --json",
     "scan:runtime:strict": "node scripts/scan-forbidden-runtime.js --fail-on-findings",
@@ -51,6 +55,7 @@
     "scan:runtime:package:strict": "node scripts/scan-forbidden-runtime.js --package-surface --fail-on-legacy",
     "scan:legacy-boundary": "node scripts/scan-legacy-boundary.js",
     "scan:package-boundary": "node scripts/scan-package-boundary.js",
+    "scan:screenshot-safety": "node scripts/scan-screenshot-safety.js",
     "gate:phase9-static": "node scripts/phase9-static-gate.js",
     "gate:phase10-complete": "node scripts/phase10-completion-gate.js",
     "live:cdp-smoke": "node scripts/live-cdp-smoke.js",
@@ -64,10 +69,11 @@
     "live:self-heal": "node scripts/live-self-heal-smoke.js",
     "live:recommend-actions": "node scripts/live-recommend-actions-smoke.js",
     "live:recommend-phase10-full": "node scripts/live-recommend-phase10-full.js",
-    "live:recommend-domain": "node scripts/live-recommend-domain-smoke.js",
-    "live:recommend-run-service": "node scripts/live-recommend-run-service-smoke.js",
-    "live:recommend-mcp": "node scripts/live-recommend-mcp-smoke.js",
-    "live:search-phase10-full": "node scripts/live-search-phase10-full.js",
+    "live:recommend-domain": "node scripts/live-recommend-domain-smoke.js",
+    "live:recommend-run-service": "node scripts/live-recommend-run-service-smoke.js",
+    "live:recommend-mcp": "node scripts/live-recommend-mcp-smoke.js",
+    "live:recommend-viewport-collapse": "node scripts/live-recommend-viewport-collapse-acceptance.js",
+    "live:search-phase10-full": "node scripts/live-search-phase10-full.js",
     "live:recruit-domain": "node scripts/live-recruit-domain-smoke.js",
     "live:recruit-run-service": "node scripts/live-recruit-run-service-smoke.js",
     "live:recruit-mcp": "node scripts/live-recruit-mcp-smoke.js",
@@ -82,9 +88,9 @@
   "files": [
     "bin",
     "config/screening-config.example.json",
-    "skills",
-    "scripts/install-macos.sh",
-    "scripts/postinstall.cjs",
+    "skills",
+    "scripts/install-macos.sh",
+    "scripts/postinstall.cjs",
     "src/core",
     "src/domains",
     "src/chat-mcp.js",

package/scripts/install-macos.sh

@@ -1,280 +1,280 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-PACKAGE_NAME="@reconcrap/boss-recommend-mcp"
-DEFAULT_NODE_VERSION="${BOSS_RECOMMEND_NODE_VERSION:-22}"
-DEFAULT_NVM_VERSION="${BOSS_RECOMMEND_NVM_VERSION:-v0.40.4}"
-
-NODE_VERSION="$DEFAULT_NODE_VERSION"
-NVM_VERSION="$DEFAULT_NVM_VERSION"
-AGENT="${BOSS_RECOMMEND_AGENT:-}"
-DRY_RUN=0
-SKIP_DOCTOR=0
-SKIP_LLM_CONFIG=0
-BASE_URL="${BOSS_RECOMMEND_BASE_URL:-https://api.openai.com/v1}"
-API_KEY="${BOSS_RECOMMEND_API_KEY:-}"
-MODEL="${BOSS_RECOMMEND_MODEL:-gpt-4.1-mini}"
-THINKING_LEVEL="${BOSS_RECOMMEND_THINKING_LEVEL:-low}"
-GREETING_MESSAGE="${BOSS_RECOMMEND_GREETING_MESSAGE:-Hi同学，能麻烦发下简历吗？}"
-
-usage() {
-  cat <<'EOF'
-Install boss-recommend-mcp on macOS with nvm-backed npm globals.
-
-Usage:
-  install-macos.sh [--agent <agent|all>] [--node-version <version>] [--nvm-version <tag>] [--dry-run] [--skip-doctor] [--skip-llm-config]
-
-Examples:
-  curl -fsSL https://raw.githubusercontent.com/reconcrap-cpu/boss-recommend-mcp/main/scripts/install-macos.sh | bash
-  curl -fsSL https://raw.githubusercontent.com/reconcrap-cpu/boss-recommend-mcp/main/scripts/install-macos.sh | bash -s -- --agent openclaw
-
-Supported agents: cursor, trae, trae-cn, claude, openclaw, qclaw, all
-
-LLM config can be supplied non-interactively with:
-  BOSS_RECOMMEND_BASE_URL, BOSS_RECOMMEND_API_KEY, BOSS_RECOMMEND_MODEL,
-  BOSS_RECOMMEND_THINKING_LEVEL, BOSS_RECOMMEND_GREETING_MESSAGE
-EOF
-}
-
-log() {
-  printf '%s\n' "[boss-recommend-mcp] $*"
-}
-
-die() {
-  printf '%s\n' "[boss-recommend-mcp] ERROR: $*" >&2
-  exit 1
-}
-
-run() {
-  log "+ $*"
-  if [ "$DRY_RUN" -eq 0 ]; then
-    "$@"
-  fi
-}
-
-while [ "$#" -gt 0 ]; do
-  case "$1" in
-    --agent)
-      [ "$#" -ge 2 ] || die "--agent requires a value"
-      AGENT="$2"
-      shift 2
-      ;;
-    --node-version)
-      [ "$#" -ge 2 ] || die "--node-version requires a value"
-      NODE_VERSION="$2"
-      shift 2
-      ;;
-    --nvm-version)
-      [ "$#" -ge 2 ] || die "--nvm-version requires a value"
-      NVM_VERSION="$2"
-      shift 2
-      ;;
-    --dry-run)
-      DRY_RUN=1
-      shift
-      ;;
-    --skip-doctor)
-      SKIP_DOCTOR=1
-      shift
-      ;;
-    --skip-llm-config)
-      SKIP_LLM_CONFIG=1
-      shift
-      ;;
-    --base-url)
-      [ "$#" -ge 2 ] || die "--base-url requires a value"
-      BASE_URL="$2"
-      shift 2
-      ;;
-    --api-key)
-      [ "$#" -ge 2 ] || die "--api-key requires a value"
-      API_KEY="$2"
-      shift 2
-      ;;
-    --model)
-      [ "$#" -ge 2 ] || die "--model requires a value"
-      MODEL="$2"
-      shift 2
-      ;;
-    --thinking-level)
-      [ "$#" -ge 2 ] || die "--thinking-level requires a value"
-      THINKING_LEVEL="$2"
-      shift 2
-      ;;
-    --greeting-message)
-      [ "$#" -ge 2 ] || die "--greeting-message requires a value"
-      GREETING_MESSAGE="$2"
-      shift 2
-      ;;
-    -h|--help)
-      usage
-      exit 0
-      ;;
-    *)
-      die "Unknown option: $1"
-      ;;
-  esac
-done
-
-prompt_text() {
-  local label="$1"
-  local default_value="$2"
-  local secret="${3:-0}"
-  local value
-  if [ ! -r /dev/tty ]; then
-    return 1
-  fi
-  if [ "$secret" -eq 1 ]; then
-    printf '%s' "${label}: " > /dev/tty
-    IFS= read -r -s value < /dev/tty || return 1
-    printf '\n' > /dev/tty
-  elif [ -n "$default_value" ]; then
-    printf '%s' "${label} [${default_value}]: " > /dev/tty
-    IFS= read -r value < /dev/tty || return 1
-    if [ -z "$value" ]; then
-      value="$default_value"
-    fi
-  else
-    printf '%s' "${label}: " > /dev/tty
-    IFS= read -r value < /dev/tty || return 1
-  fi
-  printf '%s' "$value"
-}
-
-if [ "$(uname -s)" != "Darwin" ]; then
-  if [ "$DRY_RUN" -eq 1 ]; then
-    log "dry-run on non-macOS host; skipping platform enforcement"
-  else
-    die "This bootstrap script is for macOS. Use npm install -g ${PACKAGE_NAME}@latest on other platforms."
-  fi
-fi
-
-export NVM_DIR="${NVM_DIR:-$HOME/.nvm}"
-
-load_nvm() {
-  if [ -s "$NVM_DIR/nvm.sh" ]; then
-    # shellcheck disable=SC1090
-    . "$NVM_DIR/nvm.sh"
-  elif [ -s "$HOME/.nvm/nvm.sh" ]; then
-    export NVM_DIR="$HOME/.nvm"
-    # shellcheck disable=SC1091
-    . "$HOME/.nvm/nvm.sh"
-  fi
-}
-
-install_nvm() {
-  if command -v nvm >/dev/null 2>&1; then
-    return
-  fi
-  log "nvm was not found; installing ${NVM_VERSION} into ${NVM_DIR}"
-  if [ "$DRY_RUN" -eq 1 ]; then
-    log "+ curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/${NVM_VERSION}/install.sh | bash"
-    return
-  fi
-  curl -fsSL "https://raw.githubusercontent.com/nvm-sh/nvm/${NVM_VERSION}/install.sh" | bash
-  load_nvm
-  command -v nvm >/dev/null 2>&1 || die "nvm installed but is not available in this shell. Open a new terminal and rerun this script."
-}
-
-load_nvm
-install_nvm
-
-run nvm install "$NODE_VERSION"
-run nvm alias default "$NODE_VERSION"
-run nvm use "$NODE_VERSION"
-
-if [ "$DRY_RUN" -eq 0 ]; then
-  NODE_PATH="$(command -v node || true)"
-  NPM_PATH="$(command -v npm || true)"
-  NPM_PREFIX="$(npm config get prefix || true)"
-  log "node: ${NODE_PATH}"
-  log "npm: ${NPM_PATH}"
-  log "npm prefix: ${NPM_PREFIX}"
-
-  case "$NPM_PREFIX" in
-    /usr/local|/usr/local/*)
-      die "npm is still using /usr/local. Reload nvm and rerun this script; do not use sudo npm install -g."
-      ;;
-  esac
-  case "$NPM_PREFIX" in
-    "$NVM_DIR"/*)
-      ;;
-    *)
-      die "npm prefix is not under ${NVM_DIR}. Current prefix: ${NPM_PREFIX}"
-      ;;
-  esac
-else
-  log "+ verify: npm config get prefix must be under ${NVM_DIR}, not /usr/local"
-fi
-
-run npm -g i "${PACKAGE_NAME}@latest"
-run boss-recommend-mcp where
-
-INSTALL_ARGS=(install --mcp-launch global-wrapper)
-DOCTOR_ARGS=(doctor)
-if [ -n "$AGENT" ]; then
-  INSTALL_ARGS+=(--agent "$AGENT")
-  DOCTOR_ARGS+=(--agent "$AGENT")
-fi
-
-run boss-recommend-mcp "${INSTALL_ARGS[@]}"
-
-if [ "$SKIP_LLM_CONFIG" -eq 0 ]; then
-  log "LLM screening config is required before running candidate screening."
-  if [ "$DRY_RUN" -eq 0 ]; then
-    if [ -r /dev/tty ]; then
-      BASE_URL="$(prompt_text "LLM base URL" "$BASE_URL")"
-      MODEL="$(prompt_text "LLM model" "$MODEL")"
-      THINKING_LEVEL="$(prompt_text "LLM thinking level" "$THINKING_LEVEL")"
-      GREETING_MESSAGE="$(prompt_text "Greeting message for candidates" "$GREETING_MESSAGE")"
-      if [ -z "$API_KEY" ]; then
-        API_KEY="$(prompt_text "LLM API key (input hidden)" "" 1)"
-      fi
-    fi
-    if [ -z "$BASE_URL" ] || [ -z "$API_KEY" ] || [ -z "$MODEL" ]; then
-      cat >&2 <<EOF
-[boss-recommend-mcp] LLM config is still required.
-[boss-recommend-mcp] Ask the user for:
-  1. LLM base URL
-  2. LLM API key
-  3. LLM model name
-[boss-recommend-mcp] Then run:
-  boss-recommend-mcp config set --base-url <baseUrl> --api-key <apiKey> --model <model> --thinking-level ${THINKING_LEVEL}
-EOF
-      exit 2
-    fi
-  fi
-
-  CONFIG_ARGS=(config set --base-url "$BASE_URL" --api-key "$API_KEY" --model "$MODEL")
-  if [ -n "$THINKING_LEVEL" ]; then
-    CONFIG_ARGS+=(--thinking-level "$THINKING_LEVEL")
-  fi
-  if [ -n "$GREETING_MESSAGE" ]; then
-    CONFIG_ARGS+=(--greeting-message "$GREETING_MESSAGE")
-  fi
-
-  if [ "$DRY_RUN" -eq 1 ]; then
-    log "+ boss-recommend-mcp config set --base-url ${BASE_URL:-<baseUrl>} --api-key <hidden> --model ${MODEL:-<model>} --thinking-level ${THINKING_LEVEL:-<level>}"
-  else
-    log "+ boss-recommend-mcp config set --base-url ${BASE_URL} --api-key <hidden> --model ${MODEL}"
-    boss-recommend-mcp "${CONFIG_ARGS[@]}"
-  fi
-else
-  log "Skipping LLM config because --skip-llm-config was provided."
-fi
-
-if [ "$SKIP_DOCTOR" -eq 0 ]; then
-  log "+ boss-recommend-mcp ${DOCTOR_ARGS[*]}"
-  if [ "$DRY_RUN" -eq 0 ]; then
-    if ! boss-recommend-mcp "${DOCTOR_ARGS[@]}"; then
-      log "doctor reported follow-up work. The npm package install still completed."
-    fi
-  fi
-fi
-
-cat <<EOF
-[boss-recommend-mcp] install complete.
-[boss-recommend-mcp] Future upgrades:
-  npm -g i ${PACKAGE_NAME}@latest
-  boss-recommend-mcp where
-EOF
+#!/usr/bin/env bash
+set -euo pipefail
+
+PACKAGE_NAME="@reconcrap/boss-recommend-mcp"
+DEFAULT_NODE_VERSION="${BOSS_RECOMMEND_NODE_VERSION:-22}"
+DEFAULT_NVM_VERSION="${BOSS_RECOMMEND_NVM_VERSION:-v0.40.4}"
+
+NODE_VERSION="$DEFAULT_NODE_VERSION"
+NVM_VERSION="$DEFAULT_NVM_VERSION"
+AGENT="${BOSS_RECOMMEND_AGENT:-}"
+DRY_RUN=0
+SKIP_DOCTOR=0
+SKIP_LLM_CONFIG=0
+BASE_URL="${BOSS_RECOMMEND_BASE_URL:-https://api.openai.com/v1}"
+API_KEY="${BOSS_RECOMMEND_API_KEY:-}"
+MODEL="${BOSS_RECOMMEND_MODEL:-gpt-4.1-mini}"
+THINKING_LEVEL="${BOSS_RECOMMEND_THINKING_LEVEL:-low}"
+GREETING_MESSAGE="${BOSS_RECOMMEND_GREETING_MESSAGE:-Hi同学，能麻烦发下简历吗？}"
+
+usage() {
+  cat <<'EOF'
+Install boss-recommend-mcp on macOS with nvm-backed npm globals.
+
+Usage:
+  install-macos.sh [--agent <agent|all>] [--node-version <version>] [--nvm-version <tag>] [--dry-run] [--skip-doctor] [--skip-llm-config]
+
+Examples:
+  curl -fsSL https://raw.githubusercontent.com/reconcrap-cpu/boss-recommend-mcp/main/scripts/install-macos.sh | bash
+  curl -fsSL https://raw.githubusercontent.com/reconcrap-cpu/boss-recommend-mcp/main/scripts/install-macos.sh | bash -s -- --agent openclaw
+
+Supported agents: cursor, trae, trae-cn, claude, openclaw, qclaw, all
+
+LLM config can be supplied non-interactively with:
+  BOSS_RECOMMEND_BASE_URL, BOSS_RECOMMEND_API_KEY, BOSS_RECOMMEND_MODEL,
+  BOSS_RECOMMEND_THINKING_LEVEL, BOSS_RECOMMEND_GREETING_MESSAGE
+EOF
+}
+
+log() {
+  printf '%s\n' "[boss-recommend-mcp] $*"
+}
+
+die() {
+  printf '%s\n' "[boss-recommend-mcp] ERROR: $*" >&2
+  exit 1
+}
+
+run() {
+  log "+ $*"
+  if [ "$DRY_RUN" -eq 0 ]; then
+    "$@"
+  fi
+}
+
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --agent)
+      [ "$#" -ge 2 ] || die "--agent requires a value"
+      AGENT="$2"
+      shift 2
+      ;;
+    --node-version)
+      [ "$#" -ge 2 ] || die "--node-version requires a value"
+      NODE_VERSION="$2"
+      shift 2
+      ;;
+    --nvm-version)
+      [ "$#" -ge 2 ] || die "--nvm-version requires a value"
+      NVM_VERSION="$2"
+      shift 2
+      ;;
+    --dry-run)
+      DRY_RUN=1
+      shift
+      ;;
+    --skip-doctor)
+      SKIP_DOCTOR=1
+      shift
+      ;;
+    --skip-llm-config)
+      SKIP_LLM_CONFIG=1
+      shift
+      ;;
+    --base-url)
+      [ "$#" -ge 2 ] || die "--base-url requires a value"
+      BASE_URL="$2"
+      shift 2
+      ;;
+    --api-key)
+      [ "$#" -ge 2 ] || die "--api-key requires a value"
+      API_KEY="$2"
+      shift 2
+      ;;
+    --model)
+      [ "$#" -ge 2 ] || die "--model requires a value"
+      MODEL="$2"
+      shift 2
+      ;;
+    --thinking-level)
+      [ "$#" -ge 2 ] || die "--thinking-level requires a value"
+      THINKING_LEVEL="$2"
+      shift 2
+      ;;
+    --greeting-message)
+      [ "$#" -ge 2 ] || die "--greeting-message requires a value"
+      GREETING_MESSAGE="$2"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      die "Unknown option: $1"
+      ;;
+  esac
+done
+
+prompt_text() {
+  local label="$1"
+  local default_value="$2"
+  local secret="${3:-0}"
+  local value
+  if [ ! -r /dev/tty ]; then
+    return 1
+  fi
+  if [ "$secret" -eq 1 ]; then
+    printf '%s' "${label}: " > /dev/tty
+    IFS= read -r -s value < /dev/tty || return 1
+    printf '\n' > /dev/tty
+  elif [ -n "$default_value" ]; then
+    printf '%s' "${label} [${default_value}]: " > /dev/tty
+    IFS= read -r value < /dev/tty || return 1
+    if [ -z "$value" ]; then
+      value="$default_value"
+    fi
+  else
+    printf '%s' "${label}: " > /dev/tty
+    IFS= read -r value < /dev/tty || return 1
+  fi
+  printf '%s' "$value"
+}
+
+if [ "$(uname -s)" != "Darwin" ]; then
+  if [ "$DRY_RUN" -eq 1 ]; then
+    log "dry-run on non-macOS host; skipping platform enforcement"
+  else
+    die "This bootstrap script is for macOS. Use npm install -g ${PACKAGE_NAME}@latest on other platforms."
+  fi
+fi
+
+export NVM_DIR="${NVM_DIR:-$HOME/.nvm}"
+
+load_nvm() {
+  if [ -s "$NVM_DIR/nvm.sh" ]; then
+    # shellcheck disable=SC1090
+    . "$NVM_DIR/nvm.sh"
+  elif [ -s "$HOME/.nvm/nvm.sh" ]; then
+    export NVM_DIR="$HOME/.nvm"
+    # shellcheck disable=SC1091
+    . "$HOME/.nvm/nvm.sh"
+  fi
+}
+
+install_nvm() {
+  if command -v nvm >/dev/null 2>&1; then
+    return
+  fi
+  log "nvm was not found; installing ${NVM_VERSION} into ${NVM_DIR}"
+  if [ "$DRY_RUN" -eq 1 ]; then
+    log "+ curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/${NVM_VERSION}/install.sh | bash"
+    return
+  fi
+  curl -fsSL "https://raw.githubusercontent.com/nvm-sh/nvm/${NVM_VERSION}/install.sh" | bash
+  load_nvm
+  command -v nvm >/dev/null 2>&1 || die "nvm installed but is not available in this shell. Open a new terminal and rerun this script."
+}
+
+load_nvm
+install_nvm
+
+run nvm install "$NODE_VERSION"
+run nvm alias default "$NODE_VERSION"
+run nvm use "$NODE_VERSION"
+
+if [ "$DRY_RUN" -eq 0 ]; then
+  NODE_PATH="$(command -v node || true)"
+  NPM_PATH="$(command -v npm || true)"
+  NPM_PREFIX="$(npm config get prefix || true)"
+  log "node: ${NODE_PATH}"
+  log "npm: ${NPM_PATH}"
+  log "npm prefix: ${NPM_PREFIX}"
+
+  case "$NPM_PREFIX" in
+    /usr/local|/usr/local/*)
+      die "npm is still using /usr/local. Reload nvm and rerun this script; do not use sudo npm install -g."
+      ;;
+  esac
+  case "$NPM_PREFIX" in
+    "$NVM_DIR"/*)
+      ;;
+    *)
+      die "npm prefix is not under ${NVM_DIR}. Current prefix: ${NPM_PREFIX}"
+      ;;
+  esac
+else
+  log "+ verify: npm config get prefix must be under ${NVM_DIR}, not /usr/local"
+fi
+
+run npm -g i "${PACKAGE_NAME}@latest"
+run boss-recommend-mcp where
+
+INSTALL_ARGS=(install --mcp-launch global-wrapper)
+DOCTOR_ARGS=(doctor)
+if [ -n "$AGENT" ]; then
+  INSTALL_ARGS+=(--agent "$AGENT")
+  DOCTOR_ARGS+=(--agent "$AGENT")
+fi
+
+run boss-recommend-mcp "${INSTALL_ARGS[@]}"
+
+if [ "$SKIP_LLM_CONFIG" -eq 0 ]; then
+  log "LLM screening config is required before running candidate screening."
+  if [ "$DRY_RUN" -eq 0 ]; then
+    if [ -r /dev/tty ]; then
+      BASE_URL="$(prompt_text "LLM base URL" "$BASE_URL")"
+      MODEL="$(prompt_text "LLM model" "$MODEL")"
+      THINKING_LEVEL="$(prompt_text "LLM thinking level" "$THINKING_LEVEL")"
+      GREETING_MESSAGE="$(prompt_text "Greeting message for candidates" "$GREETING_MESSAGE")"
+      if [ -z "$API_KEY" ]; then
+        API_KEY="$(prompt_text "LLM API key (input hidden)" "" 1)"
+      fi
+    fi
+    if [ -z "$BASE_URL" ] || [ -z "$API_KEY" ] || [ -z "$MODEL" ]; then
+      cat >&2 <<EOF
+[boss-recommend-mcp] LLM config is still required.
+[boss-recommend-mcp] Ask the user for:
+  1. LLM base URL
+  2. LLM API key
+  3. LLM model name
+[boss-recommend-mcp] Then run:
+  boss-recommend-mcp config set --base-url <baseUrl> --api-key <apiKey> --model <model> --thinking-level ${THINKING_LEVEL}
+EOF
+      exit 2
+    fi
+  fi
+
+  CONFIG_ARGS=(config set --base-url "$BASE_URL" --api-key "$API_KEY" --model "$MODEL")
+  if [ -n "$THINKING_LEVEL" ]; then
+    CONFIG_ARGS+=(--thinking-level "$THINKING_LEVEL")
+  fi
+  if [ -n "$GREETING_MESSAGE" ]; then
+    CONFIG_ARGS+=(--greeting-message "$GREETING_MESSAGE")
+  fi
+
+  if [ "$DRY_RUN" -eq 1 ]; then
+    log "+ boss-recommend-mcp config set --base-url ${BASE_URL:-<baseUrl>} --api-key <hidden> --model ${MODEL:-<model>} --thinking-level ${THINKING_LEVEL:-<level>}"
+  else
+    log "+ boss-recommend-mcp config set --base-url ${BASE_URL} --api-key <hidden> --model ${MODEL}"
+    boss-recommend-mcp "${CONFIG_ARGS[@]}"
+  fi
+else
+  log "Skipping LLM config because --skip-llm-config was provided."
+fi
+
+if [ "$SKIP_DOCTOR" -eq 0 ]; then
+  log "+ boss-recommend-mcp ${DOCTOR_ARGS[*]}"
+  if [ "$DRY_RUN" -eq 0 ]; then
+    if ! boss-recommend-mcp "${DOCTOR_ARGS[@]}"; then
+      log "doctor reported follow-up work. The npm package install still completed."
+    fi
+  fi
+fi
+
+cat <<EOF
+[boss-recommend-mcp] install complete.
+[boss-recommend-mcp] Future upgrades:
+  npm -g i ${PACKAGE_NAME}@latest
+  boss-recommend-mcp where
+EOF