@reconcrap/boss-recommend-mcp 2.1.1 → 2.1.3

package/src/cli.js

@@ -28,6 +28,10 @@ import {
   prepareRecommendPipelineRunTool,
   startRecommendPipelineRunTool
 } from "./recommend-mcp.js";
+import {
+  getRecommendScheduledRunTool,
+  scheduleRecommendPipelineRunTool
+} from "./recommend-scheduler.js";
 import {
   getBossScreenConfigResolution,
   resolveBossChatRuntimeLayout as resolveCdpBossChatRuntimeLayout,
@@ -50,10 +54,12 @@ 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 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";
@@ -124,15 +130,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 {
@@ -738,13 +751,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"
@@ -764,10 +819,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
@@ -2625,6 +2698,8 @@ function printHelp() {
   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 schedule-run Create a package-owned delayed recommend run");
+  console.log("  boss-recommend-mcp schedule-status Check a package-owned delayed recommend run");
   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");
@@ -2633,14 +2708,17 @@ function printHelp() {
   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("  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 schedule-run --schedule-delay-minutes 10 --instruction-file boss-recommend-instruction.txt --overrides-file overrides.json --confirmation-file confirmation.json");
+  console.log("  boss-recommend-mcp schedule-status --schedule-id <id>");
   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");
@@ -2665,14 +2743,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}`);
@@ -2700,10 +2779,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) {
@@ -2833,6 +2915,62 @@ async function preparePipelineOnce(options = {}) {
   }
 }
 
+function addScheduleOptions(args, options = {}) {
+  const scheduleId = String(options["schedule-id"] || options.schedule_id || options.scheduleId || "").trim();
+  if (scheduleId) args.schedule_id = scheduleId;
+  const runAt = String(options["schedule-run-at"] || options.schedule_run_at || options.scheduleRunAt || options["run-at"] || options.run_at || "").trim();
+  if (runAt) args.schedule_run_at = runAt;
+  const delayMinutes = parseNonNegativeInteger(options["schedule-delay-minutes"] ?? options.schedule_delay_minutes ?? options.scheduleDelayMinutes);
+  if (delayMinutes !== undefined) args.schedule_delay_minutes = delayMinutes;
+  const delaySeconds = parseNonNegativeInteger(options["schedule-delay-seconds"] ?? options.schedule_delay_seconds ?? options.scheduleDelaySeconds);
+  if (delaySeconds !== undefined) args.schedule_delay_seconds = delaySeconds;
+  return args;
+}
+
+async function schedulePipelineOnce(options = {}) {
+  const workspaceRoot = getWorkspaceRoot(options);
+  const { args, port } = buildRecommendRunCliInput(options);
+  addScheduleOptions(args, options);
+  const result = await scheduleRecommendPipelineRunTool({
+    workspaceRoot,
+    args
+  });
+  printJson({
+    ...result,
+    cli: {
+      ...(result.cli || {}),
+      command: "schedule-run",
+      cdp_only: true,
+      package_owned_scheduler: true,
+      workspace_root: workspaceRoot,
+      port
+    }
+  });
+  if (result.status !== "SCHEDULED") {
+    process.exitCode = 1;
+  }
+}
+
+function scheduleStatusCli(options = {}) {
+  const scheduleId = String(options["schedule-id"] || options.schedule_id || options.scheduleId || "").trim();
+  const result = getRecommendScheduledRunTool({
+    args: {
+      schedule_id: scheduleId
+    }
+  });
+  printJson({
+    ...result,
+    cli: {
+      command: "schedule-status",
+      cdp_only: true,
+      package_owned_scheduler: true
+    }
+  });
+  if (result.status !== "OK") {
+    process.exitCode = 1;
+  }
+}
+
 async function runPipelineOnce(options = {}) {
   const workspaceRoot = getWorkspaceRoot(options);
   const { args, port } = buildRecommendRunCliInput(options);
@@ -3046,6 +3184,39 @@ export async function runCli(argv = process.argv) {
         process.exitCode = 1;
       }
       break;
+    case "schedule-run":
+    case "schedule":
+      try {
+        await schedulePipelineOnce(options);
+      } catch (error) {
+        printJson({
+          status: "FAILED",
+          schedule_created: false,
+          error: {
+            code: "INVALID_CLI_INPUT",
+            message: error.message || "Invalid CLI input",
+            retryable: false
+          }
+        });
+        process.exitCode = 1;
+      }
+      break;
+    case "schedule-status":
+    case "scheduled-run":
+      try {
+        scheduleStatusCli(options);
+      } catch (error) {
+        printJson({
+          status: "FAILED",
+          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":
@@ -3189,11 +3360,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,
@@ -3206,6 +3379,8 @@ export const __testables = {
   resolveBossChatRuntimeLayout: resolveCdpBossChatRuntimeLayout,
   runBossChatCliCommand,
   preparePipelineOnce,
+  schedulePipelineOnce,
+  scheduleStatusCli,
   runPipelineOnce
 };
 

package/src/index.js

@@ -39,6 +39,12 @@ import {
   startRecruitPipelineRunTool,
   validateRecruitPipelineArgs
 } from "./recruit-mcp.js";
+import {
+  __setRecommendSchedulerSpawnForTests,
+  getRecommendScheduledRunTool,
+  runScheduledRecommendWorker,
+  scheduleRecommendPipelineRunTool
+} from "./recommend-scheduler.js";
 import {
   __resetRecommendMcpStateForTests,
   __setRecommendMcpConnectorForTests,
@@ -90,6 +96,8 @@ const require = createRequire(import.meta.url);
 const { version: SERVER_VERSION } = require("../package.json");
 
 const TOOL_PREPARE_RUN = "prepare_recommend_pipeline_run";
+const TOOL_SCHEDULE_RUN = "schedule_recommend_pipeline_run";
+const TOOL_GET_SCHEDULED_RUN = "get_recommend_scheduled_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";
@@ -1083,6 +1091,36 @@ function createListRecommendJobsInputSchema() {
   };
 }
 
+function createScheduleRunInputSchema() {
+  const base = createRunInputSchema();
+  return {
+    ...base,
+    properties: {
+      ...base.properties,
+      schedule_id: {
+        type: "string",
+        description: "可选，自定义定时任务 id；默认自动生成"
+      },
+      schedule_run_at: {
+        type: "string",
+        description: "ISO 时间字符串；到点后由 package-owned detached scheduler 启动已准备好的 payload"
+      },
+      schedule_delay_minutes: {
+        type: "number",
+        minimum: 0,
+        description: "从现在开始延迟多少分钟后启动；适合 OpenClaw cron/定时任务设置"
+      },
+      schedule_delay_seconds: {
+        type: "number",
+        minimum: 0,
+        description: "从现在开始延迟多少秒后启动；主要用于短延迟或测试"
+      }
+    },
+    required: ["instruction"],
+    additionalProperties: false
+  };
+}
+
 function createToolsSchema() {
   return [
     {
@@ -1095,6 +1133,23 @@ function createToolsSchema() {
       description: "只校验 Boss 推荐页流水线参数是否已可用于 cron/一次性任务；不会启动筛选任务。只有返回 READY/cron_ready=true 后才应创建定时任务。",
       inputSchema: createRunInputSchema()
     },
+    {
+      name: TOOL_SCHEDULE_RUN,
+      description: "创建 package-owned Boss 推荐页定时任务：先校验 READY/cron_ready，再保存完整 payload，并由 detached scheduler 到点直接启动，不再依赖 AI harness 自己拼 shell cron。",
+      inputSchema: createScheduleRunInputSchema()
+    },
+    {
+      name: TOOL_GET_SCHEDULED_RUN,
+      description: "查询 package-owned 推荐页定时任务状态；返回 schedule_id、worker 状态、到点后启动的 run_id 与运行快照。",
+      inputSchema: {
+        type: "object",
+        properties: {
+          schedule_id: { type: "string" }
+        },
+        required: ["schedule_id"],
+        additionalProperties: false
+      }
+    },
     {
       name: TOOL_START_RUN,
       description: "异步启动 Boss 推荐页流水线（含同步门禁预检）；只有在前置确认与页面就绪通过后才返回 run_id。",
@@ -2626,6 +2681,10 @@ async function handleRequest(message, workspaceRoot) {
         payload = await listRecommendJobsTool({ workspaceRoot, args });
       } else if (toolName === TOOL_PREPARE_RUN) {
         payload = prepareRecommendPipelineRunTool({ workspaceRoot, args });
+      } else if (toolName === TOOL_SCHEDULE_RUN) {
+        payload = await scheduleRecommendPipelineRunTool({ workspaceRoot, args });
+      } else if (toolName === TOOL_GET_SCHEDULED_RUN) {
+        payload = getRecommendScheduledRunTool({ args });
       } else if (toolName === TOOL_START_RUN) {
         payload = await handleStartRunTool({ workspaceRoot, args });
       } else if (toolName === TOOL_GET_RUN) {
@@ -2825,6 +2884,12 @@ export const __testables = {
   resetRecommendMcpStateForTests() {
     __resetRecommendMcpStateForTests();
   },
+  setRecommendSchedulerSpawnForTests(nextImpl) {
+    __setRecommendSchedulerSpawnForTests(nextImpl);
+  },
+  runScheduledRecommendWorkerForTests(options = {}) {
+    return runScheduledRecommendWorker(options);
+  },
   setChatMcpConnectorForTests(nextImpl) {
     forceChatInProcForTests = typeof nextImpl === "function";
     __setChatMcpConnectorForTests(nextImpl);