@reconcrap/boss-recommend-mcp 2.1.0 → 2.1.2

package/README.md

@@ -7,6 +7,68 @@ Boss 推荐 / 搜索 / 聊天筛选 MCP（stdio）服务。
 - npm: `@reconcrap/boss-recommend-mcp`（https://www.npmjs.com/package/@reconcrap/boss-recommend-mcp）
 - GitHub: `reconcrap-cpu/boss-recommend-mcp`（https://github.com/reconcrap-cpu/boss-recommend-mcp）
 
+## AI harness install entrypoint
+
+如果用户只把这个 GitHub 链接交给 Codex、Claude Code、Cursor、OpenClaw、QClaw、Trae 等 AI harness，并要求“安装这个工具”，请优先执行本节，而不是直接在 macOS 上裸跑 `npm install -g`。
+
+AI harness 不能只完成 npm 安装就结束。安装流程还必须帮助用户完成必填 LLM 配置；如果用户没有提前提供，请向用户索取：
+
+- LLM base URL（默认可用 `https://api.openai.com/v1`）
+- LLM API key
+- LLM model（默认可用 `gpt-4.1-mini`）
+
+然后写入配置：
+
+```bash
+boss-recommend-mcp config set --base-url <baseUrl> --api-key <apiKey> --model <model> --thinking-level low
+boss-recommend-mcp doctor
+```
+
+如果用户用 macOS bootstrap，它会自动尝试交互式询问并写入这些字段。非交互式 AI harness 如果拿不到用户输入，应暂停并询问用户上述三项，不要把安装标记为完成。
+
+macOS 首次安装推荐使用仓库里的 nvm bootstrap。它会把 Node/npm/global packages 放到用户目录，避免首次安装或后续升级时出现：
+
+```text
+EACCES: permission denied, mkdir '/usr/local/lib/node_modules/@reconcrap'
+```
+
+这是 npm global prefix 权限问题，不是 `boss-recommend-mcp` 包内部创建目录失败。
+
+macOS 一键安装：
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/reconcrap-cpu/boss-recommend-mcp/main/scripts/install-macos.sh | bash
+```
+
+如果要直接配置某个宿主：
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/reconcrap-cpu/boss-recommend-mcp/main/scripts/install-macos.sh | bash -s -- --agent openclaw
+curl -fsSL https://raw.githubusercontent.com/reconcrap-cpu/boss-recommend-mcp/main/scripts/install-macos.sh | bash -s -- --agent qclaw
+curl -fsSL https://raw.githubusercontent.com/reconcrap-cpu/boss-recommend-mcp/main/scripts/install-macos.sh | bash -s -- --agent trae-cn
+```
+
+安装后，未来升级只需要在同一个 nvm shell 里运行：
+
+```bash
+npm -g i @reconcrap/boss-recommend-mcp@latest
+boss-recommend-mcp where
+```
+
+如果升级前 `npm config get prefix` 返回 `/usr/local`，说明当前 shell 没有使用 nvm Node；请先重新加载 nvm，不要使用 `sudo npm install -g`。
+
+macOS bootstrap 会执行 `boss-recommend-mcp install --mcp-launch global-wrapper`。该模式会把 MCP 宿主配置为启动稳定 wrapper：`~/.boss-recommend-mcp/bin/boss-recommend-mcp-mcp-server`。这个 wrapper 每次启动时都会调用当前全局 `boss-recommend-mcp start`，因此后续 `npm -g i @reconcrap/boss-recommend-mcp@latest` 会更新 MCP 宿主实际运行的版本，不需要每次升级后重写 MCP 配置。
+
+如果 AI harness 已经从用户处拿到 LLM 信息，可以非交互式传给 bootstrap：
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/reconcrap-cpu/boss-recommend-mcp/main/scripts/install-macos.sh \
+  | BOSS_RECOMMEND_BASE_URL="https://api.openai.com/v1" \
+    BOSS_RECOMMEND_API_KEY="<apiKey>" \
+    BOSS_RECOMMEND_MODEL="gpt-4.1-mini" \
+    bash -s -- --agent openclaw
+```
+
 2.0.0 是 CDP-only 重写版本：活跃浏览器路径只允许 Chrome DevTools Protocol 的 `DOM` / `Input` / `Page` / `Network` / `Accessibility` 等域，不使用 `Runtime.evaluate` 或页面 JS。包内保留 recommend、search/recruit、chat 三条域服务，并共享浏览器、生命周期、筛选、CV 获取、无限滚动、自愈与 CSV 报告层。
 
 安装 `boss-recommend-mcp` 后可以直接：
@@ -20,6 +82,7 @@ Boss 推荐 / 搜索 / 聊天筛选 MCP（stdio）服务。
 MCP 工具：
 
 - `list_recommend_jobs`（只读读取推荐页岗位下拉框，返回可直接用于 cron/一次性任务的 `job_names`）
+- `prepare_recommend_pipeline_run`（只校验完整 payload 是否已可用于 cron/一次性任务；不启动筛选，返回 `READY + cron_ready=true` 后才应创建 cron）
 - `start_recommend_pipeline_run`（异步启动；同样先经过前置门禁，通过后返回 run_id）
 - `get_recommend_pipeline_run`（轮询 run_id 状态）
 - `cancel_recommend_pipeline_run`（取消运行中任务）
@@ -53,10 +116,19 @@ boss-recommend-mcp list-jobs --slow-live --port 9222
 
 返回的 `job_names` 可直接作为后续 `start_recommend_pipeline_run` 的 `confirmation.job_value` / `overrides.job`。
 
+Cron / 一次性定时任务设置建议先在设置阶段完成 Chrome/登录/岗位发现与全部确认：
+
+```bash
+boss-recommend-mcp prepare-run --instruction-file boss-recommend-instruction.txt --overrides-file boss-recommend-overrides.json --confirmation-file boss-recommend-confirmation.json --slow-live --port 9222
+```
+
+只有输出 `status: "READY"` 且 `cron_ready: true` 后，才把同一份 payload 写入 cron 并在到点时调用 `start_recommend_pipeline_run` / `boss-recommend-mcp run --detached`。如果设置阶段返回 `BOSS_LOGIN_REQUIRED`、`NEED_INPUT` 或 `NEED_CONFIRMATION`，先让用户登录或补齐确认，不要创建 cron。
+
 状态机：
 
 - `NEED_INPUT`
 - `NEED_CONFIRMATION`
+- `READY`（仅准备工具）
 - `COMPLETED`
 - `FAILED`
 
@@ -115,6 +187,13 @@ npm install -g @reconcrap/boss-recommend-mcp@latest
 boss-recommend-mcp start
 ```
 
+macOS 首次安装如果没有确认 npm prefix 在用户目录，优先使用本文开头的 `scripts/install-macos.sh`。完成 bootstrap 后，后续升级仍然使用同一个 npm 命令：
+
+```bash
+npm -g i @reconcrap/boss-recommend-mcp@latest
+boss-recommend-mcp where
+```
+
 无需安装（npx 直接运行）：
 
 ```bash
@@ -140,7 +219,8 @@ node src/cli.js start
 如果检测到 legacy Boss server entries，installer 会：
 
 - 保留非 Boss MCP server。
-- 写入统一 server：`boss-recommend -> npx -y @reconcrap/boss-recommend-mcp@<installed-version> start`
+- 默认写入统一 server：`boss-recommend -> npx -y @reconcrap/boss-recommend-mcp@<installed-version> start`
+- 如果传入 `--mcp-launch global-wrapper`，写入升级稳定入口：`boss-recommend -> ~/.boss-recommend-mcp/bin/boss-recommend-mcp-mcp-server`。该 wrapper 会加载 `~/.nvm/nvm.sh` 并执行当前全局 `boss-recommend-mcp start`，适合 macOS 上通过 `npm -g i @reconcrap/boss-recommend-mcp@latest` 持续升级。
 - 从同一个 `mcp.json` 删除旧 `boss-recruit-mcp`、standalone `boss-chat`、旧本地 Boss repo 路径，避免 agent 继续调用 legacy 包。
 - 在原文件旁生成 `mcp.json.boss-mcp-migration-*.bak`。
 - 同步外部 skills 目录里的 `boss-recommend-pipeline`、`boss-recruit-pipeline`、`boss-chat`。
@@ -156,6 +236,14 @@ boss-recommend-mcp doctor --agent openclaw
 boss-recommend-mcp doctor --agent qclaw
 ```
 
+macOS 上如果希望 MCP 宿主总是使用全局 npm 最新安装版本：
+
+```bash
+boss-recommend-mcp install --mcp-launch global-wrapper --agent openclaw
+boss-recommend-mcp install --mcp-launch global-wrapper --agent qclaw
+boss-recommend-mcp install --mcp-launch global-wrapper --agent trae-cn
+```
+
 自定义路径：
 
 ```bash
@@ -374,6 +462,7 @@ Trae-CN / 长对话防循环建议：
 说明：
 
 - `start_recommend_pipeline_run` 为异步入口，但不会跳过同步确认流程。
+- `prepare_recommend_pipeline_run` / `boss-recommend-mcp prepare-run` 用于 cron 设置阶段；它不启动筛选，只确认 payload 已经不需要到点后再问用户。
 - 定时心跳默认 120 秒一次；`updated_at` 仍会在阶段或进度变化时刷新。
 - 每个 run 会持久化到 `~/.boss-recommend-mcp/runs/<run_id>.json`（可通过 `BOSS_RECOMMEND_HOME` 覆盖）。
 - screen 阶段会持久化 checkpoint：`~/.boss-recommend-mcp/runs/<run_id>.checkpoint.json`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recommend-mcp",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "Unified MCP pipeline for recommend-page filtering and screening on Boss Zhipin",
   "keywords": [
     "boss",
@@ -79,10 +79,11 @@
     "live:chat-image-screening": "node scripts/live-chat-image-screening-smoke.js"
   },
   "files": [
-    "bin",
-    "config/screening-config.example.json",
-    "skills",
-    "scripts/postinstall.cjs",
+    "bin",
+    "config/screening-config.example.json",
+    "skills",
+    "scripts/install-macos.sh",
+    "scripts/postinstall.cjs",
     "src/core",
     "src/domains",
     "src/chat-mcp.js",

package/scripts/install-macos.sh

@@ -0,0 +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

package/skills/boss-recommend-pipeline/SKILL.md

@@ -89,9 +89,13 @@ description: "Use when users want Boss recommend-page filtering/screening via bo
 ## Tool Usage
 
 - 岗位发现工具：`list_recommend_jobs`
-  - 用途：当用户需要为 cron / 一次性自动任务提前填写完整参数时，先用它读取推荐页岗位下拉框的全部可用岗位名。
+  - 用途：当用户需要为 cron / 一次性自动任务提前填写完整参数时，先用它读取推荐页岗位下拉框的全部可用岗位名；默认会复用/自动打开本机 9222 Chrome 并导航到推荐页。
   - 输出：优先把 `job_names` 里的值作为后续 `overrides.job` / `confirmation.job_value`。
-  - 限制：只读岗位列表，不启动筛选任务；仍然必须在正式 `start_recommend_pipeline_run` 前完成岗位与最终确认。
+  - 限制：只读岗位列表，不启动筛选任务；若返回 `BOSS_LOGIN_REQUIRED`，必须让用户在自动打开的 Chrome 完成登录后重试，本次 cron 不得创建。
+- Cron 准备工具：`prepare_recommend_pipeline_run`
+  - 用途：只校验参数是否已可用于 cron / 一次性任务，不启动筛选任务。
+  - 要求：只有返回 `status=READY` 且 `cron_ready=true` 后，才允许创建 cron。
+  - 若返回 `NEED_INPUT` / `NEED_CONFIRMATION` / `FAILED`：继续补齐 `pending_questions` 或修复登录/页面/config；不得先创建 cron。
 - 主工具：`start_recommend_pipeline_run`
 - 必填：`instruction`
 - 关键输入：
@@ -107,6 +111,25 @@ description: "Use when users want Boss recommend-page filtering/screening via bo
 - 拿到 `ACCEPTED + run_id` 后默认停止本轮，不自动轮询。
 - 在拿到 `ACCEPTED + run_id` 之前，禁止以“我已帮你确认参数”为由越过必填确认阶段。
 
+## Cron / Scheduled Run Policy
+
+创建 cron 时必须在设置 cron 的当下完成全部交互：
+
+1. 锁定用户原始 instruction，不改写、不摘要，criteria 放入 `overrides.criteria` 时必须逐字保留。
+2. 收集 Stage A 全部筛选项、`target_count`、`post_action`、`max_greet_count`（如需要）和本次 `rest_level`。
+3. 调用 `list_recommend_jobs`；若 Chrome 未打开，工具会尝试自动打开本机 9222 Chrome 并进入推荐页。若返回 `BOSS_LOGIN_REQUIRED` 或页面不可用，停止 cron 创建，让用户登录/修复后重试。
+4. 用 `job_names` 中的精确岗位名完成岗位确认，并完成最终总确认，写入 `job_confirmed=true` 与 `final_confirmed=true`。
+5. 调用 `prepare_recommend_pipeline_run` 传入将来要执行的完整 payload；只有 `READY + cron_ready=true` 才能创建 cron。
+6. cron 到点时只调用 `start_recommend_pipeline_run`，并传入准备阶段验证过的同一份 payload。到点后若 Chrome/登录异常，应作为运行失败处理，不得再向用户追问参数。
+
+Shell-only OpenClaw/QClaw cron 设置同样先运行：
+
+```powershell
+npx -y @reconcrap/boss-recommend-mcp@latest prepare-run --instruction-file .\boss-recommend-instruction.txt --overrides-file .\boss-recommend-overrides.json --confirmation-file .\boss-recommend-confirmation.json --slow-live --port 9222
+```
+
+仅当上述命令输出 `READY` 且 `cron_ready=true` 后，才把对应的 detached `run` 命令写入 cron。
+
 ## Async Run Policy
 
 - 用户未明确要求“持续跟进”时，不自动 `sleep + get_recommend_pipeline_run`。
@@ -150,13 +173,14 @@ description: "Use when users want Boss recommend-page filtering/screening via bo
 推荐做法：
 
 1. 将锁定的用户原文写入 instruction 文件，将已确认参数写入 `overrides` 与 `confirmation` JSON 文件。
-2. 用 detached CLI 启动，让父命令返回启动证据，子进程继续持有 CDP 会话：
+2. 先用 `prepare-run` 校验完整 payload 已 cron-ready；未返回 `READY + cron_ready=true` 不得创建 cron 或启动 run。
+3. 用 detached CLI 启动，让父命令返回启动证据，子进程继续持有 CDP 会话：
 
 ```powershell
 npx -y @reconcrap/boss-recommend-mcp@latest run --detached --instruction-file .\boss-recommend-instruction.txt --overrides-file .\boss-recommend-overrides.json --confirmation-file .\boss-recommend-confirmation.json --slow-live --port 9222
 ```
 
-3. 若返回 `ACCEPTED + run_id`，即任务已启动；记录 `run_id/stdout_path/stderr_path`。若返回 `NEED_INPUT` 或 `NEED_CONFIRMATION`，只补 `pending_questions`，不要重写已锁定的用户原文。
+4. 若返回 `ACCEPTED + run_id`，即任务已启动；记录 `run_id/stdout_path/stderr_path`。若返回 `NEED_INPUT` 或 `NEED_CONFIRMATION`，说明 cron 设置阶段漏掉了准备门禁，应回到 `prepare-run` 补齐，不能在到点后继续问用户确认。
 
 兼容路径：
 

package/src/cli.js

@@ -23,10 +23,11 @@ import {
   prepareBossChatRunTool,
   resumeBossChatRunTool
 } from "./chat-mcp.js";
-import {
-  listRecommendJobsTool,
-  startRecommendPipelineRunTool
-} from "./recommend-mcp.js";
+import {
+  listRecommendJobsTool,
+  prepareRecommendPipelineRunTool,
+  startRecommendPipelineRunTool
+} from "./recommend-mcp.js";
 import {
   getBossScreenConfigResolution,
   resolveBossChatRuntimeLayout as resolveCdpBossChatRuntimeLayout,
@@ -49,11 +50,13 @@ const chromeOnboardingUrlPattern = /^chrome:\/\/(welcome|intro|newtab|signin|his
 const bossLoginUrlPattern = /(?:zhipin\.com\/web\/user(?:\/|\?|$)|passport\.zhipin\.com)/i;
 const bossLoginTitlePattern = /登录|signin|扫码登录|BOSS直聘登录/i;
 const supportedMcpClients = ["generic", "cursor", "trae", "claudecode", "openclaw", "qclaw"];
-const defaultMcpServerName = "boss-recommend";
-const defaultMcpCommand = "npx";
-const recommendMcpPackageName = "@reconcrap/boss-recommend-mcp";
-const recommendMcpBinaryName = "boss-recommend-mcp";
-const autoSyncSkipCommands = new Set(["install", "install-skill", "where", "help", "--help", "-h", "list-jobs", "jobs", "recommend-jobs"]);
+const defaultMcpServerName = "boss-recommend";
+const defaultMcpCommand = "npx";
+const recommendMcpPackageName = "@reconcrap/boss-recommend-mcp";
+const recommendMcpBinaryName = "boss-recommend-mcp";
+const globalMcpWrapperFileName = "boss-recommend-mcp-mcp-server";
+const supportedMcpLaunchModes = ["npx", "global-wrapper"];
+const autoSyncSkipCommands = new Set(["install", "install-skill", "where", "help", "--help", "-h", "list-jobs", "jobs", "recommend-jobs"]);
 const externalMcpTargetsEnv = "BOSS_RECOMMEND_MCP_CONFIG_TARGETS";
 const externalSkillDirsEnv = "BOSS_RECOMMEND_EXTERNAL_SKILL_DIRS";
 const installConfigDefaults = Object.freeze({
@@ -123,15 +126,22 @@ function getCodexHome() {
     : path.join(os.homedir(), ".codex");
 }
 
-function getStateHome() {
-  return process.env.BOSS_RECOMMEND_HOME
-    ? path.resolve(process.env.BOSS_RECOMMEND_HOME)
-    : path.join(os.homedir(), ".boss-recommend-mcp");
-}
-
-function ensureDir(targetPath) {
-  fs.mkdirSync(targetPath, { recursive: true });
-}
+function getStateHome() {
+  return process.env.BOSS_RECOMMEND_HOME
+    ? path.resolve(process.env.BOSS_RECOMMEND_HOME)
+    : path.join(os.homedir(), ".boss-recommend-mcp");
+}
+
+function getGlobalMcpWrapperPath(options = {}) {
+  if (typeof options["mcp-wrapper-path"] === "string" && options["mcp-wrapper-path"].trim()) {
+    return path.resolve(options["mcp-wrapper-path"].trim());
+  }
+  return path.join(getStateHome(), "bin", globalMcpWrapperFileName);
+}
+
+function ensureDir(targetPath) {
+  fs.mkdirSync(targetPath, { recursive: true });
+}
 
 function pathExists(targetPath) {
   try {
@@ -737,13 +747,55 @@ function parseMcpClientTargets(rawValue) {
   return unique;
 }
 
-function isPlainObject(value) {
-  return value && typeof value === "object" && !Array.isArray(value);
-}
-
-function shouldDefaultRecommendDetachedMcpEnv(options = {}) {
-  const client = normalizeMcpClientName(options.client);
-  const agent = normalizeAgentName(options.agent);
+function isPlainObject(value) {
+  return value && typeof value === "object" && !Array.isArray(value);
+}
+
+function normalizeMcpLaunchMode(options = {}) {
+  const raw = String(options["mcp-launch"] || options.mcpLaunch || "").trim().toLowerCase().replace(/_/g, "-");
+  if (!raw) return "npx";
+  if (raw === "default") return "npx";
+  if (raw === "global" || raw === "wrapper") return "global-wrapper";
+  if (supportedMcpLaunchModes.includes(raw)) return raw;
+  throw new Error(`Unsupported --mcp-launch value: ${raw}. Supported: ${supportedMcpLaunchModes.join(", ")}`);
+}
+
+function buildGlobalMcpWrapperScript() {
+  return `#!/usr/bin/env bash
+set -euo pipefail
+
+export NVM_DIR="\${NVM_DIR:-$HOME/.nvm}"
+if [ -s "$NVM_DIR/nvm.sh" ]; then
+  . "$NVM_DIR/nvm.sh"
+elif [ -s "$HOME/.nvm/nvm.sh" ]; then
+  export NVM_DIR="$HOME/.nvm"
+  . "$NVM_DIR/nvm.sh"
+fi
+
+if ! command -v ${recommendMcpBinaryName} >/dev/null 2>&1; then
+  echo "${recommendMcpBinaryName} not found on PATH. Install or reload nvm, then run: npm -g i ${recommendMcpPackageName}@latest" >&2
+  exit 127
+fi
+
+exec ${recommendMcpBinaryName} start "$@"
+`;
+}
+
+function ensureGlobalMcpWrapper(options = {}) {
+  const wrapperPath = getGlobalMcpWrapperPath(options);
+  ensureDir(path.dirname(wrapperPath));
+  fs.writeFileSync(wrapperPath, buildGlobalMcpWrapperScript(), "utf8");
+  try {
+    fs.chmodSync(wrapperPath, 0o755);
+  } catch {
+    // Some filesystems ignore POSIX executable bits; the path is still valid for POSIX hosts.
+  }
+  return wrapperPath;
+}
+
+function shouldDefaultRecommendDetachedMcpEnv(options = {}) {
+  const client = normalizeMcpClientName(options.client);
+  const agent = normalizeAgentName(options.agent);
   return client === "openclaw"
     || client === "qclaw"
     || agent === "openclaw"
@@ -763,10 +815,28 @@ function getAgentConfigOutputDir(options = {}) {
   return path.join(getStateHome(), "agent-mcp-configs");
 }
 
-function buildMcpLaunchConfig(options = {}) {
-  const command = typeof options.command === "string" && options.command.trim()
-    ? options.command.trim()
-    : defaultMcpCommand;
+function buildMcpLaunchConfig(options = {}) {
+  const mcpLaunchMode = normalizeMcpLaunchMode(options);
+  if (mcpLaunchMode === "global-wrapper") {
+    const args = parseJsonOption(options["args-json"], "args-json");
+    const env = parseJsonOption(options["env-json"], "env-json");
+    const launchConfig = {
+      command: ensureGlobalMcpWrapper(options),
+      args: Array.isArray(args) ? args : []
+    };
+    const mergedEnv = {
+      ...getDefaultMcpEnv(options),
+      ...(isPlainObject(env) ? env : {})
+    };
+    if (Object.keys(mergedEnv).length > 0) {
+      launchConfig.env = mergedEnv;
+    }
+    return launchConfig;
+  }
+
+  const command = typeof options.command === "string" && options.command.trim()
+    ? options.command.trim()
+    : defaultMcpCommand;
   const args = parseJsonOption(options["args-json"], "args-json");
   const env = parseJsonOption(options["env-json"], "env-json");
   const launchArgs = Array.isArray(args) && args.length > 0
@@ -2621,25 +2691,28 @@ function printHelp() {
   console.log("boss-recommend-mcp");
   console.log("");
   console.log("Usage:");
-  console.log("  boss-recommend-mcp              Start the MCP server");
-  console.log("  boss-recommend-mcp start        Start the MCP server");
-  console.log("  boss-recommend-mcp run          Start a CDP-only recommend run through the shared run service");
-  console.log("  boss-recommend-mcp list-jobs    CDP-only list of exact recommend job names for cron/one-shot inputs");
+  console.log("  boss-recommend-mcp              Start the MCP server");
+  console.log("  boss-recommend-mcp start        Start the MCP server");
+  console.log("  boss-recommend-mcp prepare-run  Validate a cron-ready recommend run payload without starting screening");
+  console.log("  boss-recommend-mcp run          Start a CDP-only recommend run through the shared run service");
+  console.log("  boss-recommend-mcp list-jobs    CDP-only list of exact recommend job names for cron/one-shot inputs");
   console.log("  boss-recommend-mcp chat <subcommand>  Run CDP-only boss-chat health/prepare/status commands");
   console.log("  boss-recommend-mcp install      Install/migrate skills and MCP configs; replaces legacy Boss MCP routes (supports --agent trae-cn/openclaw/qclaw/...)");
   console.log("  boss-recommend-mcp install-skill Install bundled Codex skills (recommend/recruit/chat)");
   console.log("  boss-recommend-mcp init-config  Create screening-config.json if missing (prefer workspace config/, fallback ~/.boss-recommend-mcp)");
   console.log("  boss-recommend-mcp config set   Write baseUrl/apiKey/model (prefer workspace config/, fallback ~/.boss-recommend-mcp)");
   console.log("  boss-recommend-mcp set-port     Persist preferred Chrome debug port to screening-config.json");
-  console.log("  boss-recommend-mcp mcp-config   Generate MCP config JSON for Cursor/Trae(含 trae-cn)/Claude Code/OpenClaw/QClaw");
-  console.log("  boss-recommend-mcp doctor       Check config/runtime/calibration prerequisites (supports --agent trae-cn/qclaw/cursor/...)");
-  console.log("  boss-recommend-mcp calibrate    Disabled until CDP-only featured calibration is live-verified");
-  console.log("  boss-recommend-mcp launch-chrome Launch or reuse Chrome debug instance and open Boss recommend page");
-  console.log("  boss-recommend-mcp where        Print installed package, skill, and config paths");
-  console.log("");
-  console.log("Run command:");
-  console.log("  boss-recommend-mcp run --instruction \"推荐页上筛选211男生，近14天没有，有大模型平台经验\" --overrides-file overrides.json --confirmation-file confirmation.json");
-  console.log("  boss-recommend-mcp run --detached --instruction \"...\" --overrides-file overrides.json --confirmation-file confirmation.json");
+  console.log("  boss-recommend-mcp mcp-config   Generate MCP config JSON for Cursor/Trae(含 trae-cn)/Claude Code/OpenClaw/QClaw");
+  console.log("  boss-recommend-mcp doctor       Check config/runtime/calibration prerequisites (supports --agent trae-cn/qclaw/cursor/...)");
+  console.log("  boss-recommend-mcp calibrate    Disabled until CDP-only featured calibration is live-verified");
+  console.log("  boss-recommend-mcp launch-chrome Launch or reuse Chrome debug instance and open Boss recommend page");
+  console.log("  boss-recommend-mcp where        Print installed package, skill, and config paths");
+  console.log("  boss-recommend-mcp install --mcp-launch global-wrapper  Use ~/.boss-recommend-mcp/bin wrapper so npm global upgrades affect MCP hosts");
+  console.log("");
+  console.log("Run command:");
+  console.log("  boss-recommend-mcp prepare-run --instruction \"...\" --overrides-file overrides.json --confirmation-file confirmation.json");
+  console.log("  boss-recommend-mcp run --instruction \"推荐页上筛选211男生，近14天没有，有大模型平台经验\" --overrides-file overrides.json --confirmation-file confirmation.json");
+  console.log("  boss-recommend-mcp run --detached --instruction \"...\" --overrides-file overrides.json --confirmation-file confirmation.json");
   console.log("  boss-recommend-mcp list-jobs --slow-live --port 9222");
   console.log("  boss-recommend-mcp chat prepare-run --slow-live --port 9222    # CDP-only preflight; start runs through MCP start_boss_chat_run");
   console.log("  boss-recommend-mcp config set --base-url <url> --api-key <key> --model <model> [--thinking-level off|low|medium|high|current] [--greeting-message <text>] [--openai-organization <id>] [--openai-project <id>]");
@@ -2662,14 +2735,15 @@ function printMcpConfig(options = {}) {
   }
 }
 
-async function installAll(options = {}) {
-  const runtimeDirsResult = await ensureRuntimeDirectories(options);
-  const skillResults = installSkill();
-  const configResult = await ensureUserConfig(options);
-  const mcpTemplateResult = writeMcpConfigFiles({ client: "all" });
-  const externalMcpResult = installExternalMcpConfigs(options);
-  const externalSkillResult = mirrorSkillToExternalDirs(options);
-  console.log(
+async function installAll(options = {}) {
+  const runtimeDirsResult = await ensureRuntimeDirectories(options);
+  const skillResults = installSkill();
+  const configResult = await ensureUserConfig(options);
+  const mcpLaunchMode = normalizeMcpLaunchMode(options);
+  const mcpTemplateResult = writeMcpConfigFiles({ ...options, agent: undefined, client: "all" });
+  const externalMcpResult = installExternalMcpConfigs(options);
+  const externalSkillResult = mirrorSkillToExternalDirs(options);
+  console.log(
     `Runtime directories prepared: created=${runtimeDirsResult.created.length}, existing=${runtimeDirsResult.existed.length}, failed=${runtimeDirsResult.failed.length}`
   );
   console.log(`- recommend runtime: ${runtimeDirsResult.stateHome}`);
@@ -2697,10 +2771,13 @@ async function installAll(options = {}) {
     console.warn(`screening-config.json skip default patch: ${configResult.patch_error}`);
   }
   console.log(`请在该目录修改 baseUrl/apiKey/model 并替换占位词后再运行：${path.dirname(configResult.path)}`);
-  console.log(`MCP config templates exported to: ${mcpTemplateResult.outputDir}`);
-  for (const item of mcpTemplateResult.files) {
-    console.log(`- ${item.client}: ${item.file}`);
-  }
+  console.log(`MCP config templates exported to: ${mcpTemplateResult.outputDir}`);
+  for (const item of mcpTemplateResult.files) {
+    console.log(`- ${item.client}: ${item.file}`);
+  }
+  if (mcpLaunchMode === "global-wrapper") {
+    console.log(`Upgrade-stable MCP wrapper: ${getGlobalMcpWrapperPath(options)}`);
+  }
   if (externalMcpResult.targets.length > 0) {
     console.log(`Auto-configured external MCP files: ${externalMcpResult.applied.length}`);
     for (const item of externalMcpResult.applied) {
@@ -2733,14 +2810,13 @@ async function installAll(options = {}) {
   }
 }
 
-async function runPipelineOnce(options = {}) {
-  const instruction = getRunInstruction(options);
-  const confirmation = getRunConfirmation(options);
-  const overrides = getRunOverrides(options);
-  const followUp = getRunFollowUp(options);
-  const workspaceRoot = getWorkspaceRoot(options);
-  const port = parsePositivePort(options.port) || parsePositivePort(process.env.BOSS_RECOMMEND_CHROME_PORT) || 9222;
-
+function buildRecommendRunCliInput(options = {}) {
+  const instruction = getRunInstruction(options);
+  const confirmation = getRunConfirmation(options);
+  const overrides = getRunOverrides(options);
+  const followUp = getRunFollowUp(options);
+  const port = parsePositivePort(options.port) || parsePositivePort(process.env.BOSS_RECOMMEND_CHROME_PORT) || 9222;
+
   const args = {
     instruction,
     confirmation: confirmation ?? undefined,
@@ -2797,15 +2873,46 @@ async function runPipelineOnce(options = {}) {
     "llm_image_limit",
     "llm_image_detail"
   ];
-  for (const key of optionalPassthrough) {
-    const kebab = key.replace(/_/g, "-");
-    if (options[key] !== undefined) args[key] = options[key];
-    else if (options[kebab] !== undefined) args[key] = options[kebab];
-  }
-
-  const result = await startRecommendPipelineRunTool({
-    workspaceRoot,
-    args
+  for (const key of optionalPassthrough) {
+    const kebab = key.replace(/_/g, "-");
+    if (options[key] !== undefined) args[key] = options[key];
+    else if (options[kebab] !== undefined) args[key] = options[kebab];
+  }
+
+  return {
+    args,
+    port
+  };
+}
+
+async function preparePipelineOnce(options = {}) {
+  const workspaceRoot = getWorkspaceRoot(options);
+  const { args, port } = buildRecommendRunCliInput(options);
+  const result = prepareRecommendPipelineRunTool({
+    workspaceRoot,
+    args
+  });
+  printJson({
+    ...result,
+    cli: {
+      command: "prepare-run",
+      cdp_only: true,
+      shared_run_service: true,
+      workspace_root: workspaceRoot,
+      port
+    }
+  });
+  if (result.status !== "READY" || result.cron_ready !== true) {
+    process.exitCode = 1;
+  }
+}
+
+async function runPipelineOnce(options = {}) {
+  const workspaceRoot = getWorkspaceRoot(options);
+  const { args, port } = buildRecommendRunCliInput(options);
+  const result = await startRecommendPipelineRunTool({
+    workspaceRoot,
+    args
   });
   printJson({
     ...result,
@@ -2974,11 +3081,11 @@ export async function runCli(argv = process.argv) {
     case "mcp":
       startServer();
       break;
-    case "run":
-      try {
-        if (
-          (options.detached === true || options.background === true)
-          && process.env[detachedRecommendRunChildEnv] !== "1"
+    case "run":
+      try {
+        if (
+          (options.detached === true || options.background === true)
+          && process.env[detachedRecommendRunChildEnv] !== "1"
         ) {
           await runPipelineDetached(argv.slice(3), options);
         } else {
@@ -2993,9 +3100,26 @@ export async function runCli(argv = process.argv) {
             retryable: false
           }
         });
-        process.exitCode = 1;
-      }
-      break;
+        process.exitCode = 1;
+      }
+      break;
+    case "prepare-run":
+    case "prepare":
+      try {
+        await preparePipelineOnce(options);
+      } catch (error) {
+        printJson({
+          status: "FAILED",
+          cron_ready: false,
+          error: {
+            code: "INVALID_CLI_INPUT",
+            message: error.message || "Invalid CLI input",
+            retryable: false
+          }
+        });
+        process.exitCode = 1;
+      }
+      break;
     case "list-jobs":
     case "jobs":
     case "recommend-jobs":
@@ -3139,11 +3263,13 @@ export async function runCli(argv = process.argv) {
 }
 
 export const __testables = {
-  buildRecommendJobListCliInput,
-  buildBossChatCliInput,
-  buildDefaultMcpArgs,
-  buildMcpLaunchConfig,
-  collectRuntimeDirectories,
+  buildRecommendJobListCliInput,
+  buildBossChatCliInput,
+  buildDefaultMcpArgs,
+  buildMcpLaunchConfig,
+  ensureGlobalMcpWrapper,
+  getGlobalMcpWrapperPath,
+  collectRuntimeDirectories,
   ensureBossChatRuntimeReady: ensureBossChatRuntimeReadyLocal,
   ensureRuntimeDirectories,
   getBossChatCliRunTarget,
@@ -3153,10 +3279,11 @@ export const __testables = {
   installSkill,
   isInstalledPackageRoot,
   mergeMcpServerConfigFile,
-  resolveBossChatRuntimeLayout: resolveCdpBossChatRuntimeLayout,
-  runBossChatCliCommand,
-  runPipelineOnce
-};
+  resolveBossChatRuntimeLayout: resolveCdpBossChatRuntimeLayout,
+  runBossChatCliCommand,
+  preparePipelineOnce,
+  runPipelineOnce
+};
 
 if (process.argv[1] && path.resolve(process.argv[1]) === currentFilePath) {
   await runCli(process.argv);

package/src/index.js

@@ -87,8 +87,9 @@ import {
 } from "./run-state.js";
 
 const require = createRequire(import.meta.url);
-const { version: SERVER_VERSION } = require("../package.json");
-
+const { version: SERVER_VERSION } = require("../package.json");
+
+const TOOL_PREPARE_RUN = "prepare_recommend_pipeline_run";
 const TOOL_START_RUN = "start_recommend_pipeline_run";
 const TOOL_GET_RUN = "get_recommend_pipeline_run";
 const TOOL_CANCEL_RUN = "cancel_recommend_pipeline_run";
@@ -1089,10 +1090,15 @@ function createToolsSchema() {
       description: "CDP-only 读取 Boss 推荐页岗位下拉框，返回所有可用岗位完整名称，方便 cron/一次性任务提前填写 job 参数。不会启动筛选任务。",
       inputSchema: createListRecommendJobsInputSchema()
     },
+    {
+      name: TOOL_PREPARE_RUN,
+      description: "只校验 Boss 推荐页流水线参数是否已可用于 cron/一次性任务；不会启动筛选任务。只有返回 READY/cron_ready=true 后才应创建定时任务。",
+      inputSchema: createRunInputSchema()
+    },
     {
       name: TOOL_START_RUN,
       description: "异步启动 Boss 推荐页流水线（含同步门禁预检）；只有在前置确认与页面就绪通过后才返回 run_id。",
-      inputSchema: createRunInputSchema()
+      inputSchema: createRunInputSchema()
     },
     {
       name: TOOL_GET_RUN,
@@ -2618,6 +2624,8 @@ async function handleRequest(message, workspaceRoot) {
       let payload;
       if (toolName === TOOL_LIST_RECOMMEND_JOBS) {
         payload = await listRecommendJobsTool({ workspaceRoot, args });
+      } else if (toolName === TOOL_PREPARE_RUN) {
+        payload = prepareRecommendPipelineRunTool({ workspaceRoot, args });
       } else if (toolName === TOOL_START_RUN) {
         payload = await handleStartRunTool({ workspaceRoot, args });
       } else if (toolName === TOOL_GET_RUN) {

package/src/recommend-mcp.js

@@ -1464,15 +1464,21 @@ async function startRecommendPipelineRunInternal(args = {}, { workspaceRoot = ""
   };
 }
 
-export function prepareRecommendPipelineRunTool({ workspaceRoot = "", args = {} } = {}) {
-  const prepared = prepareRecommendPipelineStart(args, { workspaceRoot });
-  if (prepared.response) return prepared.response;
-  const { parsed, normalized } = prepared;
-  return {
-    status: "READY",
-    review: parsed.review,
-    post_action: {
-      requested: normalized.postAction,
+export function prepareRecommendPipelineRunTool({ workspaceRoot = "", args = {} } = {}) {
+  const prepared = prepareRecommendPipelineStart(args, { workspaceRoot });
+  if (prepared.response) {
+    return {
+      ...prepared.response,
+      cron_ready: false
+    };
+  }
+  const { parsed, normalized } = prepared;
+  return {
+    status: "READY",
+    cron_ready: true,
+    review: parsed.review,
+    post_action: {
+      requested: normalized.postAction,
       execute_post_action: args.dry_run_post_action === true ? false : args.execute_post_action !== false,
       max_greet_count: normalized.maxGreetCount
     },