@reconcrap/boss-recruit-mcp 1.0.0

package/README.md

@@ -0,0 +1,82 @@
+# @reconcrap/boss-recruit-mcp
+
+统一招聘流水线 MCP（stdio）服务。将 `boss-search-cli` 与 `boss-screen-cli` 串联为单工具：
+
+- 工具名：`run_recruit_pipeline`
+- 状态：`NEED_INPUT` / `NEED_CONFIRMATION` / `COMPLETED` / `FAILED`
+
+## 通过 npm / npx 安装
+
+全局安装：
+
+```bash
+npm install -g @reconcrap/boss-recruit-mcp
+boss-recruit-mcp install
+```
+
+一次性执行安装：
+
+```bash
+npx @reconcrap/boss-recruit-mcp install
+```
+
+安装命令会：
+
+- 安装 Codex skill 到 `$CODEX_HOME/skills/boss-recruit-pipeline`
+- 初始化用户配置到 `$CODEX_HOME/boss-recruit-mcp/screening-config.json`
+- 包内自带 `boss-search-cli` 与 `boss-screen-cli` 运行时文件，无需额外目录结构
+
+## 准备配置
+
+1. 初始化后编辑用户配置文件：
+
+```bash
+$CODEX_HOME/boss-recruit-mcp/screening-config.json
+```
+
+2. 填写以下字段：
+
+- `baseUrl` / `apiKey` / `model` 必填
+- `calibrationFile` 可选，默认走 `boss-screen-cli/favorite-calibration.json`
+- `outputDir` 可选，不填则输出到 `boss-screen-cli` 目录
+
+## 运行
+
+```bash
+boss-recruit-mcp start
+```
+
+该服务通过 stdio 与 MCP client 通信。
+
+## 工具输入
+
+```json
+{
+  "instruction": "自然语言招聘指令",
+  "confirmation": {
+    "keyword_confirmed": true,
+    "keyword_value": "ai infra"
+  },
+  "overrides": {
+    "target_count": 500
+  }
+}
+```
+
+## 行为说明
+
+- 若缺 `city/degree/schools/keyword/target_count`，返回 `NEED_INPUT`
+- 若 keyword 由语义自动抽取（非显式给出），返回 `NEED_CONFIRMATION`
+- 确认后自动执行：搜索 CLI -> 筛选 CLI
+- 返回摘要：目标数、已处理、通过数、耗时、输出 CSV
+- 执行前会先做本地依赖预检查，若目录 / 入口 / 配置文件缺失则返回 `PIPELINE_PREFLIGHT_FAILED`
+- 若当前运行环境不允许启动子进程，会返回更明确的权限错误码而不是笼统失败
+- 配置文件查找顺序：`BOSS_RECRUIT_SCREEN_CONFIG` > 工作区 `boss-recruit-mcp/config/screening-config.json` > 用户目录 `$CODEX_HOME/boss-recruit-mcp/screening-config.json` > 包内示例配置
+
+## 发布
+
+```bash
+npm publish
+```
+
+该包已设置 `publishConfig.access=public`。

package/bin/boss-recruit-mcp.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../src/cli.js";

package/config/screening-config.example.json

@@ -0,0 +1,7 @@
+{
+  "baseUrl": "https://your-llm-endpoint.example.com/v1",
+  "apiKey": "replace-with-your-api-key",
+  "model": "replace-with-your-model-name",
+  "calibrationFile": "../boss-screen-cli/favorite-calibration.json",
+  "outputDir": "../boss-screen-cli/output"
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@reconcrap/boss-recruit-mcp",
+  "version": "1.0.0",
+  "description": "Unified MCP pipeline for boss-search-cli and boss-screen-cli",
+  "keywords": [
+    "boss",
+    "mcp",
+    "codex",
+    "recruiting",
+    "boss-zhipin"
+  ],
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "boss-recruit-mcp": "bin/boss-recruit-mcp.js"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "cli": "node src/cli.js",
+    "install:local": "node src/cli.js install",
+    "test:parser": "node src/test-parser.js"
+  },
+  "files": [
+    "bin",
+    "config/screening-config.example.json",
+    "skills",
+    "src",
+    "vendor",
+    "README.md"
+  ],
+  "dependencies": {
+    "chrome-remote-interface": "^0.33.3",
+    "ws": "^8.19.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT"
+}

package/skills/boss-recruit-pipeline/README.md

@@ -0,0 +1,20 @@
+# boss-recruit-pipeline skill
+
+随 `boss-recruit-mcp` npm 包一起分发的 Codex skill。
+
+## 安装
+
+```powershell
+npx boss-recruit-mcp install
+```
+
+这条命令会：
+
+- 把 skill 安装到 `$CODEX_HOME/skills/boss-recruit-pipeline`
+- 在 `$CODEX_HOME/boss-recruit-mcp/screening-config.json` 创建配置模板
+
+## 前置要求
+
+- Chrome 已使用 `--remote-debugging-port=9222` 启动
+- Boss 页面已登录
+- 已在用户配置中填写有效的 `baseUrl`、`apiKey`、`model`

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

@@ -0,0 +1,83 @@
+# Boss Recruit Pipeline Skill
+
+## Purpose
+
+当用户给出招聘需求时，优先调用 MCP 工具 `run_recruit_pipeline` 完成端到端任务：
+
+1. 解析指令
+2. 校验必填项
+3. 关键词自动提取与确认
+4. 调用搜索与筛选工具
+5. 返回简洁摘要结果
+
+适用场景：
+
+- 在 Boss 上按城市 / 学历 / 学校标签搜索候选人
+- 再按自然语言 criteria 做二次 LLM 筛选
+- 适合“做过某方向 + 额外论文/项目/经历要求”的招聘请求
+
+## Required MCP Tool
+
+- Tool name: `run_recruit_pipeline`
+- Input:
+  - `instruction` (string, required)
+  - `confirmation` (object, optional)
+  - `overrides` (object, optional)
+
+## Execution Policy
+
+1. 收到招聘指令后，先调用一次 `run_recruit_pipeline`（只传 `instruction`）。
+2. 若返回 `NEED_INPUT`：
+   - 一次性向用户列出 `missing_fields` 所有缺失项；
+   - 缺失项常见含义：
+     - `city`: 城市，如“杭州”
+     - `degree`: 学历，如“本科”“硕士及以上”
+     - `schools`: 学校标签，如“985、211、qs100”
+     - `target_count`: 目标筛选人数，如“10”
+   - 用户补充后再次调用工具。
+3. 若返回 `NEED_CONFIRMATION`：
+   - 询问用户是否确认 `proposed_keyword`；
+   - 若确认，带 `confirmation.keyword_confirmed=true` 和 `keyword_value` 再次调用；
+   - 若用户修改关键词，传用户给的新词作为 `keyword_value` 再次调用。
+4. 若返回 `COMPLETED`：
+   - 向用户返回摘要：目标数、已处理、通过数、耗时、输出文件路径。
+5. 若返回 `FAILED`：
+   - 先提炼 `error.code`、`error.message`、`diagnostics`；
+   - 如果是 `PIPELINE_PREFLIGHT_FAILED`，明确指出缺失的本地目录 / 文件；
+   - 如果是 `SEARCH_PROCESS_PERMISSION_DENIED` 或 `SCREEN_PROCESS_PERMISSION_DENIED`，明确说明“当前环境拒绝创建子进程”，建议用户在本地终端直接运行 MCP；
+   - 如果是 `SEARCH_CLI_MISSING` / `SCREEN_CLI_MISSING` / `SCREEN_CONFIG_ERROR`，直接告诉用户缺什么，不要只说“重试”；
+   - 若是可修复输入问题，提示用户修正条件后重试。
+
+## Input Guidance
+
+- 优先鼓励用户一次性给全这些字段：城市、学历、学校标签、目标人数、核心方向关键词。
+- 当用户提到“做过 AI infra / 推荐系统 / 搜索 / 广告 / 多模态”等经历，但没有显式写“关键词”，默认允许流水线先自动抽取，再走确认分支。
+- 当用户附带筛选要求（如“必须发表过 CCF-A 区论文”“有开源项目”“带过团队”），这些要求应该保留在 `criteria` 中，不应被误当作搜索过滤条件。
+- 回答时不要暴露 `screening-config.json` 中的 `apiKey`、`baseUrl` 等敏感值。
+
+## Failure Handling
+
+- 不要把底层 stderr 原样大段贴给用户，只提炼关键错误和下一步。
+- 如果失败原因明显是环境问题，要直接说明不是用户输入有误。
+- 如果工具已经返回 `diagnostics.checks`，优先基于这些检查项生成排障建议。
+- 如果工具返回 `output_csv`，在摘要里给出路径，避免重复解释内部流程。
+
+## Example
+
+用户：
+
+- “在 Boss 上找做过 AI infra 的候选人，必须发过 CCF-A 区论文，城市杭州，本科，学校 985/211/QS100，目标 10 人”
+
+期望行为：
+
+1. 首次调用流水线。
+2. 若 keyword 被自动提取为 `AI infra`，先让用户确认。
+3. 确认后再次调用。
+4. 成功则返回通过人数与 CSV 路径；失败则按错误类型给出下一步。
+
+## Response Style
+
+- 优先结构化、简洁中文输出。
+- 不展示密钥和底层敏感配置。
+- 不跳过 `NEED_CONFIRMATION` 分支。
+- 若运行失败，优先给用户“现在卡在哪一步 + 怎么继续”。

package/src/adapters.js

@@ -0,0 +1,352 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+const currentFilePath = fileURLToPath(import.meta.url);
+const packagedMcpDir = path.resolve(path.dirname(currentFilePath), "..");
+
+function getCodexHome() {
+  return process.env.CODEX_HOME
+    ? path.resolve(process.env.CODEX_HOME)
+    : path.join(os.homedir(), ".codex");
+}
+
+function getUserConfigPath() {
+  return path.join(getCodexHome(), "boss-recruit-mcp", "screening-config.json");
+}
+
+function resolveScreenConfigPath(workspaceRoot) {
+  const envConfigPath = process.env.BOSS_RECRUIT_SCREEN_CONFIG
+    ? path.resolve(process.env.BOSS_RECRUIT_SCREEN_CONFIG)
+    : null;
+  const workspaceConfigPath = path.join(workspaceRoot, "boss-recruit-mcp", "config", "screening-config.json");
+  const userConfigPath = getUserConfigPath();
+  const packagedConfigPath = path.join(packagedMcpDir, "config", "screening-config.json");
+  const candidates = [
+    envConfigPath,
+    workspaceConfigPath,
+    userConfigPath,
+    packagedConfigPath
+  ].filter(Boolean);
+
+  return candidates.find((candidate) => pathExists(candidate)) || candidates[0];
+}
+
+function pathExists(targetPath) {
+  try {
+    return fs.existsSync(targetPath);
+  } catch {
+    return false;
+  }
+}
+
+function resolveSearchCliDir(workspaceRoot) {
+  const localDir = path.join(workspaceRoot, "boss-search-cli");
+  if (pathExists(localDir)) {
+    return localDir;
+  }
+  const vendoredDir = path.join(packagedMcpDir, "vendor", "boss-search-cli");
+  if (pathExists(vendoredDir)) {
+    return vendoredDir;
+  }
+  return null;
+}
+
+function resolveScreenCliDir(workspaceRoot) {
+  const localDir = path.join(workspaceRoot, "boss-screen-cli");
+  if (pathExists(localDir)) {
+    return localDir;
+  }
+  const vendoredDir = path.join(packagedMcpDir, "vendor", "boss-screen-cli");
+  if (pathExists(vendoredDir)) {
+    return vendoredDir;
+  }
+  return null;
+}
+
+function resolveScreenCliEntry(screenDir) {
+  const candidates = [
+    path.join(screenDir, "boss-screen-cli.js"),
+    path.join(screenDir, "boss-screen-cli.cjs")
+  ];
+  return candidates.find((candidate) => pathExists(candidate)) || candidates[0];
+}
+
+function runProcess({ command, args, cwd, timeoutMs }) {
+  return new Promise((resolve) => {
+    let stdout = "";
+    let stderr = "";
+    let settled = false;
+    let timer = null;
+
+    function finish(payload) {
+      if (settled) return;
+      settled = true;
+      if (timer) clearTimeout(timer);
+      resolve(payload);
+    }
+
+    let child;
+    try {
+      child = spawn(command, args, {
+        cwd,
+        windowsHide: true,
+        shell: false,
+        env: process.env
+      });
+    } catch (error) {
+      finish({
+        code: -1,
+        stdout,
+        stderr: error.message,
+        error_code: error.code || "SPAWN_FAILED"
+      });
+      return;
+    }
+
+    if (timeoutMs && Number.isFinite(timeoutMs) && timeoutMs > 0) {
+      timer = setTimeout(() => {
+        try {
+          child.kill();
+        } catch {}
+        finish({
+          code: -1,
+          stdout,
+          stderr: `${stderr}\nProcess timed out after ${timeoutMs}ms`.trim(),
+          error_code: "TIMEOUT"
+        });
+      }, timeoutMs);
+    }
+
+    child.stdout.on("data", (chunk) => {
+      stdout += chunk.toString();
+    });
+    child.stderr.on("data", (chunk) => {
+      stderr += chunk.toString();
+    });
+
+    child.on("close", (code) => {
+      finish({ code, stdout, stderr });
+    });
+    child.on("error", (error) => {
+      finish({
+        code: -1,
+        stdout,
+        stderr: `${stderr}\n${error.message}`.trim(),
+        error_code: error.code || "SPAWN_FAILED"
+      });
+    });
+  });
+}
+
+function parseSearchCount(output) {
+  const m = output.match(/找到\s*(\d+)\s*个候选人/);
+  if (!m) return null;
+  return Number.parseInt(m[1], 10);
+}
+
+function parseScreenSummary(output) {
+  const processed = output.match(/已处理:\s*(\d+)\s*人/);
+  const passed = output.match(/通过筛选:\s*(\d+)\s*人/);
+  const target = output.match(/目标人数:\s*(\d+)\s*人/);
+  const csv = output.match(/结果已导出到:\s*(.+)/);
+
+  return {
+    processed_count: processed ? Number.parseInt(processed[1], 10) : null,
+    passed_count: passed ? Number.parseInt(passed[1], 10) : null,
+    target_count: target ? Number.parseInt(target[1], 10) : null,
+    output_csv: csv ? csv[1].trim() : null
+  };
+}
+
+function loadScreenConfig(configPath) {
+  if (!fs.existsSync(configPath)) {
+    return {
+      ok: false,
+      error: `Screen config file not found: ${configPath}`
+    };
+  }
+  try {
+    const content = fs.readFileSync(configPath, "utf8");
+    const parsed = JSON.parse(content);
+    if (!parsed.baseUrl || !parsed.apiKey || !parsed.model) {
+      return {
+        ok: false,
+        error: "Invalid screen config: baseUrl/apiKey/model are required"
+      };
+    }
+    return { ok: true, config: parsed };
+  } catch (error) {
+    return { ok: false, error: `Failed to read screen config: ${error.message}` };
+  }
+}
+
+export function runPipelinePreflight(workspaceRoot) {
+  const searchDir = resolveSearchCliDir(workspaceRoot);
+  const screenDir = resolveScreenCliDir(workspaceRoot);
+  const screenConfigPath = resolveScreenConfigPath(workspaceRoot);
+  const checks = [
+    {
+      key: "search_cli_dir",
+      ok: Boolean(searchDir && pathExists(searchDir)),
+      path: searchDir || localDirHint(workspaceRoot, "boss-search-cli"),
+      message: "boss-search-cli 目录不存在"
+    },
+    {
+      key: "search_cli_entry",
+      ok: Boolean(searchDir && pathExists(path.join(searchDir, "src", "cli.js"))),
+      path: searchDir ? path.join(searchDir, "src", "cli.js") : path.join(localDirHint(workspaceRoot, "boss-search-cli"), "src", "cli.js"),
+      message: "boss-search-cli 入口文件缺失"
+    },
+    {
+      key: "screen_cli_dir",
+      ok: Boolean(screenDir && pathExists(screenDir)),
+      path: screenDir || localDirHint(workspaceRoot, "boss-screen-cli"),
+      message: "boss-screen-cli 目录不存在"
+    },
+    {
+      key: "screen_cli_entry",
+      ok: Boolean(screenDir && pathExists(resolveScreenCliEntry(screenDir))),
+      path: screenDir ? resolveScreenCliEntry(screenDir) : path.join(localDirHint(workspaceRoot, "boss-screen-cli"), "boss-screen-cli.js"),
+      message: "boss-screen-cli 入口文件缺失"
+    },
+    {
+      key: "screen_config",
+      ok: pathExists(screenConfigPath),
+      path: screenConfigPath,
+      message: "screening-config.json 不存在"
+    }
+  ];
+
+  return {
+    ok: checks.every((item) => item.ok),
+    checks
+  };
+}
+
+function localDirHint(workspaceRoot, dirName) {
+  return path.join(workspaceRoot, dirName);
+}
+
+export async function runSearchCli({ workspaceRoot, searchParams }) {
+  const searchDir = resolveSearchCliDir(workspaceRoot);
+  if (!searchDir) {
+    return {
+      ok: false,
+      exit_code: -1,
+      candidate_count: null,
+      stdout: "",
+      stderr: "boss-search-cli package not found",
+      error_code: "ENOENT"
+    };
+  }
+  const cliPath = path.join(searchDir, "src", "cli.js");
+  const args = [
+    cliPath,
+    "--keywords",
+    searchParams.keyword,
+    "--degree",
+    searchParams.degree,
+    "--schools",
+    searchParams.schools.join(","),
+    "--city",
+    searchParams.city
+  ];
+
+  const result = await runProcess({
+    command: "node",
+    args,
+    cwd: searchDir,
+    timeoutMs: 180000
+  });
+
+  const combined = `${result.stdout}\n${result.stderr}`;
+  const candidateCount = parseSearchCount(combined);
+
+  return {
+    ok: result.code === 0,
+    exit_code: result.code,
+    candidate_count: candidateCount,
+    stdout: result.stdout,
+    stderr: result.stderr,
+    error_code: result.error_code || null
+  };
+}
+
+export async function runScreenCli({ workspaceRoot, screenParams }) {
+  const screenDir = resolveScreenCliDir(workspaceRoot);
+  if (!screenDir) {
+    return {
+      ok: false,
+      exit_code: -1,
+      summary: null,
+      stdout: "",
+      stderr: "boss-screen-cli package not found",
+      error_code: "ENOENT"
+    };
+  }
+  const cliPath = resolveScreenCliEntry(screenDir);
+
+  const configPath = resolveScreenConfigPath(workspaceRoot);
+  const configBaseDir = path.dirname(configPath);
+  const loaded = loadScreenConfig(configPath);
+  if (!loaded.ok) {
+    return {
+      ok: false,
+      config_error: true,
+      exit_code: -1,
+      stdout: "",
+      stderr: loaded.error,
+      error_code: "INVALID_SCREEN_CONFIG"
+    };
+  }
+
+  const calibration = loaded.config.calibrationFile
+    ? path.resolve(configBaseDir, loaded.config.calibrationFile)
+    : path.join(screenDir, "favorite-calibration.json");
+
+  const outputName = `筛选结果_${Date.now()}.csv`;
+  let outputPath = outputName;
+  if (loaded.config.outputDir) {
+    const resolvedOutputDir = path.resolve(configBaseDir, loaded.config.outputDir);
+    fs.mkdirSync(resolvedOutputDir, { recursive: true });
+    outputPath = path.join(resolvedOutputDir, outputName);
+  }
+
+  const args = [
+    cliPath,
+    "--baseurl",
+    loaded.config.baseUrl,
+    "--apikey",
+    loaded.config.apiKey,
+    "--model",
+    loaded.config.model,
+    "--criteria",
+    screenParams.criteria,
+    "--targetCount",
+    String(screenParams.target_count),
+    "--config",
+    calibration,
+    "--output",
+    outputPath
+  ];
+
+  const result = await runProcess({
+    command: "node",
+    args,
+    cwd: screenDir
+  });
+
+  const combined = `${result.stdout}\n${result.stderr}`;
+  const summary = parseScreenSummary(combined);
+
+  return {
+    ok: result.code === 0,
+    exit_code: result.code,
+    summary,
+    stdout: result.stdout,
+    stderr: result.stderr,
+    error_code: result.error_code || null
+  };
+}

package/src/cli.js

@@ -0,0 +1,112 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+import { startServer } from "./index.js";
+
+const currentFilePath = fileURLToPath(import.meta.url);
+const packageRoot = path.resolve(path.dirname(currentFilePath), "..");
+const skillSourceDir = path.join(packageRoot, "skills", "boss-recruit-pipeline");
+const exampleConfigPath = path.join(packageRoot, "config", "screening-config.example.json");
+
+function getCodexHome() {
+  return process.env.CODEX_HOME
+    ? path.resolve(process.env.CODEX_HOME)
+    : path.join(os.homedir(), ".codex");
+}
+
+function ensureDir(targetPath) {
+  fs.mkdirSync(targetPath, { recursive: true });
+}
+
+function installSkill() {
+  const codexHome = getCodexHome();
+  const targetDir = path.join(codexHome, "skills", "boss-recruit-pipeline");
+  ensureDir(path.dirname(targetDir));
+  fs.cpSync(skillSourceDir, targetDir, { recursive: true, force: true });
+  return targetDir;
+}
+
+function ensureUserConfig() {
+  const targetDir = path.join(getCodexHome(), "boss-recruit-mcp");
+  const targetPath = path.join(targetDir, "screening-config.json");
+  ensureDir(targetDir);
+  if (!fs.existsSync(targetPath)) {
+    fs.copyFileSync(exampleConfigPath, targetPath);
+    return { path: targetPath, created: true };
+  }
+  return { path: targetPath, created: false };
+}
+
+function printHelp() {
+  console.log("boss-recruit-mcp");
+  console.log("");
+  console.log("Usage:");
+  console.log("  boss-recruit-mcp              Start the MCP server");
+  console.log("  boss-recruit-mcp start        Start the MCP server");
+  console.log("  boss-recruit-mcp install      Install Codex skill and initialize user config");
+  console.log("  boss-recruit-mcp install-skill Install only the Codex skill");
+  console.log("  boss-recruit-mcp init-config  Create ~/.codex/boss-recruit-mcp/screening-config.json if missing");
+  console.log("  boss-recruit-mcp where        Print installed package, skill, and config paths");
+}
+
+function printPaths() {
+  const codexHome = getCodexHome();
+  console.log(`package_root=${packageRoot}`);
+  console.log(`skill_source=${skillSourceDir}`);
+  console.log(`codex_home=${codexHome}`);
+  console.log(`skill_target=${path.join(codexHome, "skills", "boss-recruit-pipeline")}`);
+  console.log(`config_target=${path.join(codexHome, "boss-recruit-mcp", "screening-config.json")}`);
+}
+
+function installAll() {
+  const skillTarget = installSkill();
+  const configResult = ensureUserConfig();
+  console.log(`Skill installed to: ${skillTarget}`);
+  if (configResult.created) {
+    console.log(`Config template created at: ${configResult.path}`);
+  } else {
+    console.log(`Config already exists at: ${configResult.path}`);
+  }
+  console.log("");
+  console.log("Next steps:");
+  console.log("1. Fill in baseUrl/apiKey/model in the config file above.");
+  console.log("2. Start Chrome with --remote-debugging-port=9222 and log in to Boss.");
+  console.log("3. Run `boss-recruit-mcp start` or configure your MCP client to launch `boss-recruit-mcp`.");
+}
+
+const command = process.argv[2] || "start";
+
+switch (command) {
+  case "start":
+    startServer();
+    break;
+  case "install":
+    installAll();
+    break;
+  case "install-skill":
+    console.log(`Skill installed to: ${installSkill()}`);
+    break;
+  case "init-config": {
+    const result = ensureUserConfig();
+    console.log(
+      result.created
+        ? `Config template created at: ${result.path}`
+        : `Config already exists at: ${result.path}`
+    );
+    break;
+  }
+  case "where":
+    printPaths();
+    break;
+  case "help":
+  case "--help":
+  case "-h":
+    printHelp();
+    break;
+  default:
+    console.error(`Unknown command: ${command}`);
+    console.error("Run `boss-recruit-mcp --help` for usage.");
+    process.exitCode = 1;
+}