@reconcrap/boss-recommend-mcp 2.1.10 → 2.1.11

package/README.md

@@ -100,6 +100,7 @@ MCP 工具：
 - `resume_recruit_pipeline_run`
 - `cancel_recruit_pipeline_run`
 - `boss_chat_health_check`
+- `list_boss_chat_jobs`（只读读取聊天页岗位列表；chat-only 获取 `job_options` 的首选别名，不会启动任务）
 - `prepare_boss_chat_run`
 - `start_boss_chat_run`
 - `get_boss_chat_run`
@@ -424,7 +425,7 @@ node src/cli.js chat prepare-run --slow-live --port 9222
 - `baseUrl` / `apiKey` / `model` 不再单独传入，固定复用 recommend 的 `screening-config.json`
 - `greeting_text` 默认优先级：本次显式值 > `screening-config.json.greetingMessage` > 内置默认招呼语（`Hi同学，能麻烦发下简历吗？`）
 - 若缺少 `follow_up.chat` 必填项，pipeline 会返回 `NEED_INPUT`
-- 如需聊天页筛选，请调用 `prepare_boss_chat_run` 获取岗位列表，再调用 `start_boss_chat_run`。
+- 如需聊天页筛选，请调用 `list_boss_chat_jobs` 或 `prepare_boss_chat_run` 获取岗位列表，再调用 `start_boss_chat_run`。chat-only、未读、全部聊天、求简历任务不要调用 `list_recommend_jobs` / `run_recommend` / `start_recommend_pipeline_run`；这些 recommend 工具会对明确的 chat/search 误路由 fail closed。
 - `boss-chat` 状态统一写入 `~/.boss-recommend-mcp/boss-chat`（或 `BOSS_CHAT_HOME` 指定目录），不再依赖工作区 `cwd`
 
 ## Chat-only
@@ -438,6 +439,7 @@ node src/cli.js chat prepare-run --slow-live --port 9222
   - `boss-recommend-mcp chat get-run|pause-run|resume-run|cancel-run`
 - MCP：
   - `boss_chat_health_check`
+  - `list_boss_chat_jobs`
   - `prepare_boss_chat_run`
   - `start_boss_chat_run`
   - `get_boss_chat_run`
@@ -450,14 +452,15 @@ node src/cli.js chat prepare-run --slow-live --port 9222
 
 chat-only 交互建议：
 
-- 先调用一次 `prepare_boss_chat_run`（可不带参数），服务会先导航到 `https://www.zhipin.com/web/chat/index` 并返回 `NEED_INPUT`，其中包含岗位 `job_options` 与待补字段。
+- 先调用一次 `list_boss_chat_jobs` 或 `prepare_boss_chat_run`（可不带参数），服务会先导航到 `https://www.zhipin.com/web/chat/index` 并返回 `NEED_INPUT`，其中包含岗位 `job_options` 与待补字段。
 - 然后基于 `job_options` 让用户选择 `job`，并补齐 `start_from`、`target_count`、`criteria` 后调用 `start_boss_chat_run` 启动任务。
 - `greeting_text` 可选；未传时使用 `screening-config.json.greetingMessage`，若未配置则使用默认招呼语（`Hi同学，能麻烦发下简历吗？`）。
 - `target_count` 支持正整数、`all`、`-1`；若用户给出 `全部候选人` / `所有候选人`，会自动按不限（扫到底）处理。
 
 Trae-CN / 长对话防循环建议：
 
-- 固定流程：`boss_chat_health_check` -> `prepare_boss_chat_run(空参可)` -> 一次性补齐 `job/start_from/target_count/criteria` -> `start_boss_chat_run`。
+- 固定流程：`boss_chat_health_check` -> `list_boss_chat_jobs(空参可)` / `prepare_boss_chat_run(空参可)` -> 一次性补齐 `job/start_from/target_count/criteria` -> `start_boss_chat_run`。
+- chat-only 场景严禁调用 `list_recommend_jobs`、`run_recommend` 或 `start_recommend_pipeline_run`。
 - `start_boss_chat_run` 的工具 schema 已把 `job/start_from/target_count/criteria` 标记为必填；不要用它获取岗位列表。
 - 若 `pending_questions` / UI 选项里出现“扫到底（必须传 `target_count="all"`）”，下一次工具调用请直接照抄 `"target_count": "all"`，不要只保留“扫到底”这层自然语言语义。
 - `start_boss_chat_run` 返回 `ACCEPTED` 后直接结束当前回合，不要自动轮询。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recommend-mcp",
-  "version": "2.1.10",
+  "version": "2.1.11",
   "description": "Unified MCP pipeline for recommend-page filtering and screening on Boss Zhipin",
   "keywords": [
     "boss",

package/skills/boss-chat/README.md

@@ -16,7 +16,7 @@ Please run a Boss chat-only task (do not switch to recommend flow).
 
 Execution order:
 1) Call boss_chat_health_check.
-2) Call prepare_boss_chat_run once (empty params allowed) to fetch job_options and missing fields.
+2) Call list_boss_chat_jobs once (empty params allowed), or prepare_boss_chat_run once, to fetch job_options and missing fields.
 3) Ask for these required fields in one shot: job, start_from (unread/all), target_count, criteria, rest_level (low/medium/high).
 4) After user reply, call start_boss_chat_run exactly once to start the run.
 5) If ACCEPTED, reply only with run_id and "task started"; no auto polling.
@@ -24,6 +24,8 @@ Execution order:
 Anti-loop rules:
 - Do not repeat the same sentence across turns.
 - On validation errors, list all missing/invalid fields once.
+- Do not call list_recommend_jobs for chat-only tasks; it is recommend-page only and will switch the browser to /web/chat/recommend.
+- Do not call run_recommend or start_recommend_pipeline_run for chat-only tasks; use start_boss_chat_run.
 - Do not use start_boss_chat_run for preflight. It is only for the final start call and must include job/start_from/target_count/criteria.
 - Do not call start_boss_chat_run repeatedly in one turn.
 - Do not call get_boss_chat_run unless user explicitly asks for progress.

package/skills/boss-chat/SKILL.md

@@ -14,6 +14,7 @@ description: "Use when users want Boss chat-page screening/outreach via the bund
 ## Tool Routing
 
 - 健康检查：`boss_chat_health_check`
+- 只读获取聊天页岗位列表：`list_boss_chat_jobs`
 - 预备并获取岗位列表：`prepare_boss_chat_run`
 - 启动异步任务：`start_boss_chat_run`
 - 查询进度：`get_boss_chat_run`
@@ -69,6 +70,8 @@ description: "Use when users want Boss chat-page screening/outreach via the bund
 - 若本机找不到 Chrome，可提示用户设置 `BOSS_MCP_CHROME_PATH` 或 `BOSS_RECOMMEND_CHROME_PATH`；非本机 debug host 不自动启动。
 - `job` / `start_from` / `criteria` 缺一不可；缺参时只补缺口。
 - `target_count` 在 chat-only 启动前也是必填项，不能默认省略。
+- chat-only 岗位列表只能通过 `list_boss_chat_jobs` 或 `prepare_boss_chat_run` 获取；严禁调用 `list_recommend_jobs`，因为它会切到推荐页。
+- chat-only 启动只能调用 `start_boss_chat_run`；严禁调用 `run_recommend` 或 `start_recommend_pipeline_run`。
 - 每次 run 必须明确询问用户本次休息强度 `rest_level`：`low`（旧策略）/ `medium`（约 5 小时或 700 人累计休息 30 分钟）/ `high`（约 5 小时或 700 人累计休息 1 小时）；不得默认使用配置文件里的值替用户决定。
 - 当用户说“全部候选人/所有候选人”时，必须按“扫到底（unlimited）”处理，不要再追问正整数。
 - 参数名必须写 `target_count`（不要写“目标数量”等中文键名）。
@@ -77,7 +80,7 @@ description: "Use when users want Boss chat-page screening/outreach via the bund
 - 若工具或提问选项里出现“扫到底（必须传 `target_count=\"all\"`）”之类字样，下一次工具调用时必须直接照抄这个字面量，不要只保留“扫到底”语义。
 - 禁止 agent 自行补全 `job/start_from/criteria` 并直接执行，必须由用户明确给出或确认。
 - chat-only 启动流程必须先进入聊天页并拉取岗位列表，再让用户从列表中选择 `job`。
-- 必须先用空参调用 `prepare_boss_chat_run` 获取 `job_options`；不要用 `start_boss_chat_run` 做预备调用。
+- 必须先用空参调用 `list_boss_chat_jobs` 或 `prepare_boss_chat_run` 获取 `job_options`；不要用 `start_boss_chat_run` 做预备调用。
 - `start_boss_chat_run` 只能用于真正启动，必须一次性传齐 `job` / `start_from` / `target_count` / `criteria`。
 - 若 `start_boss_chat_run` 返回 `NEED_INPUT` 且 `missing_fields` 包含 `target_count`，说明你没有把用户选择写入工具参数；下一次调用必须照 `next_call_example` 原样补上 `"target_count": "all"` 或正整数，不要重复空调用。
 - 默认不自动轮询；只有用户要求查进度时才调用 `get_boss_chat_run`。
@@ -96,6 +99,6 @@ description: "Use when users want Boss chat-page screening/outreach via the bund
 ## Response Style
 
 - 用结构化中文。
-- 首轮建议先调用一次 `prepare_boss_chat_run`（可空参）获取 `job_options` 与 `pending_questions`。
+- 首轮建议先调用一次 `list_boss_chat_jobs`（可空参）或 `prepare_boss_chat_run`（可空参）获取 `job_options` 与 `pending_questions`。
 - 缺参时必须逐项确认：`job`（来自岗位列表）、`start_from`（`unread|all`）、`target_count`、`criteria`、`rest_level`。
 - 若健康检查失败，明确提示共享配置文件 `screening-config.json` 不可用。

package/src/index.js

@@ -110,6 +110,7 @@ const TOOL_RUN_FEATURED_CALIBRATION = "run_featured_calibration";
 const TOOL_GET_FEATURED_CALIBRATION_STATUS = "get_featured_calibration_status";
 const TOOL_RUN_RECOMMEND_SELF_HEAL = "run_recommend_self_heal";
 const TOOL_BOSS_CHAT_HEALTH_CHECK = "boss_chat_health_check";
+const TOOL_BOSS_CHAT_LIST_JOBS = "list_boss_chat_jobs";
 const TOOL_BOSS_CHAT_PREPARE_RUN = "prepare_boss_chat_run";
 const TOOL_BOSS_CHAT_START_RUN = "start_boss_chat_run";
 const TOOL_BOSS_CHAT_GET_RUN = "get_boss_chat_run";
@@ -1295,9 +1296,107 @@ function createScheduleRunInputSchema() {
 
 function createToolsSchema() {
   return [
+    {
+      name: TOOL_BOSS_CHAT_HEALTH_CHECK,
+      description: "Boss 聊天页/chat-only 健康检查。chat-only、未读、全部聊天、求简历等任务必须先走 boss-chat 工具，不要调用 list_recommend_jobs 或 start_recommend_pipeline_run。",
+      inputSchema: {
+        type: "object",
+        properties: {
+          host: {
+            type: "string",
+            description: "可选，Chrome 调试 host；默认 127.0.0.1"
+          },
+          port: {
+            type: "integer",
+            minimum: 1,
+            description: "可选，Chrome 调试端口；默认读取 screening-config.json.debugPort 或 9222"
+          },
+          target_url_includes: {
+            type: "string",
+            description: "可选，Chrome target URL 匹配片段；默认 Boss chat 页"
+          },
+          allow_navigate: {
+            type: "boolean",
+            description: "可选，未在 chat 页时允许通过 Page.navigate 切换；默认 true"
+          },
+          slow_live: {
+            type: "boolean",
+            description: "可选，VPN/慢页面 live 测试模式，放宽等待时间"
+          }
+        },
+        additionalProperties: false
+      }
+    },
+    {
+      name: TOOL_BOSS_CHAT_LIST_JOBS,
+      description: "只读读取 Boss 聊天页岗位列表；这是 chat-only 获取 job_options 的首选别名，等价于 prepare_boss_chat_run 的预备步骤但不会启动任务。聊天页/未读/全部聊天/求简历任务必须用本工具或 prepare_boss_chat_run，严禁用 list_recommend_jobs。",
+      inputSchema: createBossChatStartInputSchema()
+    },
+    {
+      name: TOOL_BOSS_CHAT_PREPARE_RUN,
+      description: "预备一次 boss-chat/chat-only 任务：只导航聊天页并返回岗位列表与待补字段，不会启动任务。用它先获取 job_options；不要用 list_recommend_jobs。",
+      inputSchema: createBossChatStartInputSchema()
+    },
+    {
+      name: TOOL_BOSS_CHAT_START_RUN,
+      description: "异步启动一次 boss-chat/chat-only 任务。必须一次性提供 job、start_from、target_count、criteria；若用户选择扫到底/不限/全部候选人，必须字面传 target_count=\"all\"。严禁改用 start_recommend_pipeline_run。",
+      inputSchema: createBossChatStartInputSchema({ requireFullInput: true })
+    },
+    {
+      name: TOOL_BOSS_CHAT_GET_RUN,
+      description: "查询 boss-chat run_id 的当前状态。chat-only 状态查询用本工具，不要用 get_recommend_pipeline_run。",
+      inputSchema: {
+        type: "object",
+        properties: {
+          run_id: { type: "string" },
+          profile: { type: "string" }
+        },
+        required: ["run_id"],
+        additionalProperties: false
+      }
+    },
+    {
+      name: TOOL_BOSS_CHAT_PAUSE_RUN,
+      description: "暂停运行中的 boss-chat 任务。",
+      inputSchema: {
+        type: "object",
+        properties: {
+          run_id: { type: "string" },
+          profile: { type: "string" }
+        },
+        required: ["run_id"],
+        additionalProperties: false
+      }
+    },
+    {
+      name: TOOL_BOSS_CHAT_RESUME_RUN,
+      description: "继续已暂停的 boss-chat 任务。",
+      inputSchema: {
+        type: "object",
+        properties: {
+          run_id: { type: "string" },
+          profile: { type: "string" }
+        },
+        required: ["run_id"],
+        additionalProperties: false
+      }
+    },
+    {
+      name: TOOL_BOSS_CHAT_CANCEL_RUN,
+      description: "取消运行中的 boss-chat 任务。",
+      inputSchema: {
+        type: "object",
+        properties: {
+          run_id: { type: "string" },
+          profile: { type: "string" }
+        },
+        required: ["run_id"],
+        additionalProperties: false
+      }
+    },
     {
       name: TOOL_LIST_RECOMMEND_JOBS,
-      description: "CDP-only 读取 Boss 推荐页岗位下拉框，返回所有可用岗位完整名称，方便 cron/一次性任务提前填写 job 参数。不会启动筛选任务。",
+      description: "CDP-only 读取 Boss 推荐页岗位下拉框，返回所有可用岗位完整名称，方便 recommend/推荐页 cron/一次性任务提前填写 job 参数。不会启动筛选任务。chat-only、未读、全部聊天、求简历任务严禁调用本工具，必须用 list_boss_chat_jobs 或 prepare_boss_chat_run。",
       inputSchema: createListRecommendJobsInputSchema()
     },
     {
@@ -1428,99 +1527,6 @@ function createToolsSchema() {
       description: "手动运维自愈工具：扫描 Boss recommend 相关 selector / network 规则漂移，并在确认后应用高置信度修复。",
       inputSchema: createRunRecommendSelfHealInputSchema()
     },
-    {
-      name: TOOL_BOSS_CHAT_HEALTH_CHECK,
-      description: "CDP-only 检查 Boss chat 页面、自愈 probes、共享 screening-config.json 与 chat runtime 目录是否可用。",
-      inputSchema: {
-        type: "object",
-        properties: {
-          host: {
-            type: "string",
-            description: "可选，Chrome 调试 host；默认 127.0.0.1"
-          },
-          port: {
-            type: "integer",
-            minimum: 1,
-            description: "可选，Chrome 调试端口；默认读取 screening-config.json.debugPort 或 9222"
-          },
-          target_url_includes: {
-            type: "string",
-            description: "可选，Chrome target URL 匹配片段；默认 Boss chat 页"
-          },
-          allow_navigate: {
-            type: "boolean",
-            description: "可选，未在 chat 页时允许通过 Page.navigate 切换；默认 true"
-          },
-          slow_live: {
-            type: "boolean",
-            description: "可选，VPN/慢页面 live 测试模式，放宽等待时间"
-          }
-        },
-        additionalProperties: false
-      }
-    },
-    {
-      name: TOOL_BOSS_CHAT_PREPARE_RUN,
-      description: "预备一次 boss-chat 任务：只导航聊天页并返回岗位列表与待补字段，不会启动任务。用它先获取 job_options。",
-      inputSchema: createBossChatStartInputSchema()
-    },
-    {
-      name: TOOL_BOSS_CHAT_START_RUN,
-      description: "异步启动一次 boss-chat 任务。必须一次性提供 job、start_from、target_count、criteria；若用户选择扫到底/不限/全部候选人，必须字面传 target_count=\"all\"。",
-      inputSchema: createBossChatStartInputSchema({ requireFullInput: true })
-    },
-    {
-      name: TOOL_BOSS_CHAT_GET_RUN,
-      description: "查询 boss-chat run_id 的当前状态。",
-      inputSchema: {
-        type: "object",
-        properties: {
-          run_id: { type: "string" },
-          profile: { type: "string" }
-        },
-        required: ["run_id"],
-        additionalProperties: false
-      }
-    },
-    {
-      name: TOOL_BOSS_CHAT_PAUSE_RUN,
-      description: "暂停运行中的 boss-chat 任务。",
-      inputSchema: {
-        type: "object",
-        properties: {
-          run_id: { type: "string" },
-          profile: { type: "string" }
-        },
-        required: ["run_id"],
-        additionalProperties: false
-      }
-    },
-    {
-      name: TOOL_BOSS_CHAT_RESUME_RUN,
-      description: "继续已暂停的 boss-chat 任务。",
-      inputSchema: {
-        type: "object",
-        properties: {
-          run_id: { type: "string" },
-          profile: { type: "string" }
-        },
-        required: ["run_id"],
-        additionalProperties: false
-      }
-    },
-    {
-      name: TOOL_BOSS_CHAT_CANCEL_RUN,
-      description: "取消运行中的 boss-chat 任务。",
-      inputSchema: {
-        type: "object",
-        properties: {
-          run_id: { type: "string" },
-          profile: { type: "string" }
-        },
-        required: ["run_id"],
-        additionalProperties: false
-      }
-    },
     {
       name: TOOL_RUN_RECRUIT_PIPELINE,
       description: "兼容 Boss recruit 入口：默认 async；sync 模式会等待终态。所有浏览器动作走共享 CDP-only recruit service。",
@@ -2885,7 +2891,7 @@ async function handleRequest(message, workspaceRoot) {
       }
     }
 
-    if ([TOOL_BOSS_CHAT_PREPARE_RUN, TOOL_BOSS_CHAT_START_RUN].includes(toolName)) {
+    if ([TOOL_BOSS_CHAT_LIST_JOBS, TOOL_BOSS_CHAT_PREPARE_RUN, TOOL_BOSS_CHAT_START_RUN].includes(toolName)) {
       const inputError = validateBossChatStartArgs(args);
       if (inputError) {
         return createJsonRpcError(id, -32602, inputError);
@@ -2941,6 +2947,8 @@ async function handleRequest(message, workspaceRoot) {
         payload = await handleRunRecommendSelfHealTool({ workspaceRoot, args });
       } else if (toolName === TOOL_BOSS_CHAT_HEALTH_CHECK) {
         payload = await handleBossChatHealthCheckTool(workspaceRoot, args);
+      } else if (toolName === TOOL_BOSS_CHAT_LIST_JOBS) {
+        payload = await handleBossChatPrepareRunTool({ workspaceRoot, args });
       } else if (toolName === TOOL_BOSS_CHAT_PREPARE_RUN) {
         payload = await handleBossChatPrepareRunTool({ workspaceRoot, args });
       } else if (toolName === TOOL_BOSS_CHAT_START_RUN) {

package/src/recommend-mcp.js

@@ -75,13 +75,119 @@ let recommendRunService = createRecommendRunService({
 });
 const recommendRunMeta = new Map();
 
-function normalizeText(value) {
-  return String(value || "").replace(/\s+/g, " ").trim();
-}
-
-function parsePositiveInteger(raw, fallback) {
-  const parsed = Number.parseInt(String(raw || ""), 10);
-  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+function normalizeText(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+
+function collectRecommendRouteText(args = {}) {
+  return normalizeText([
+    args.instruction,
+    args.criteria,
+    args.target_url_includes,
+    args.page_scope,
+    args.confirmation?.page_value,
+    args.confirmation?.job_value,
+    args.overrides?.criteria,
+    args.overrides?.page_scope,
+    args.overrides?.job,
+    args.overrides?.target_url_includes
+  ].filter((value) => value !== undefined && value !== null).join(" "));
+}
+
+function findRouteSignals(text, patterns = []) {
+  const signals = [];
+  for (const { label, pattern } of patterns) {
+    if (pattern.test(text)) signals.push(label);
+  }
+  return signals;
+}
+
+function detectNonRecommendRoute(args = {}) {
+  const text = collectRecommendRouteText(args);
+  if (!text) return null;
+  const chatSignals = findRouteSignals(text, [
+    { label: "chat-only", pattern: /\bchat[-\s]?only\b/i },
+    { label: "boss-chat", pattern: /\bboss[-\s]?chat\b/i },
+    { label: "chat page", pattern: /\bchat\s+page\b/i },
+    { label: "chat/index", pattern: /(?:\/web\/chat\/index|chat\/index)/i },
+    { label: "聊天页", pattern: /聊天页/ },
+    { label: "聊天列表", pattern: /聊天列表/ },
+    { label: "未读", pattern: /未读/ },
+    { label: "全部聊天", pattern: /全部聊天|所有聊天/ },
+    { label: "求简历", pattern: /求简历|索要简历|要简历|在线简历/ }
+  ]);
+  if (chatSignals.length) {
+    return {
+      domain: "chat",
+      signals: chatSignals,
+      text
+    };
+  }
+  const searchSignals = findRouteSignals(text, [
+    { label: "search-only", pattern: /\bsearch[-\s]?only\b/i },
+    { label: "search page", pattern: /\bsearch\s+page\b/i },
+    { label: "recruit pipeline", pattern: /\brecruit\s+pipeline\b/i },
+    { label: "chat/search", pattern: /(?:\/web\/chat\/search|chat\/search)/i },
+    { label: "搜索页", pattern: /搜索页/ },
+    { label: "招聘搜索", pattern: /招聘搜索/ }
+  ]);
+  if (searchSignals.length) {
+    return {
+      domain: "search",
+      signals: searchSignals,
+      text
+    };
+  }
+  return null;
+}
+
+function buildWrongRecommendRouteResponse(route) {
+  if (route?.domain === "chat") {
+    return {
+      status: "FAILED",
+      route_guard: true,
+      error: {
+        code: "WRONG_BOSS_TOOL_FOR_CHAT",
+        message: "This request is explicitly chat-only/chat-page work. Do not use recommend tools. Use boss_chat_health_check, then list_boss_chat_jobs or prepare_boss_chat_run, then start_boss_chat_run.",
+        retryable: false
+      },
+      detected_domain: "chat",
+      detected_signals: route.signals || [],
+      recommended_tool_sequence: [
+        "boss_chat_health_check",
+        "list_boss_chat_jobs",
+        "prepare_boss_chat_run",
+        "start_boss_chat_run"
+      ]
+    };
+  }
+  if (route?.domain === "search") {
+    return {
+      status: "FAILED",
+      route_guard: true,
+      error: {
+        code: "WRONG_BOSS_TOOL_FOR_SEARCH",
+        message: "This request is explicitly search/recruit-page work. Do not use recommend tools. Use run_recruit_pipeline or start_recruit_pipeline_run.",
+        retryable: false
+      },
+      detected_domain: "search",
+      detected_signals: route.signals || [],
+      recommended_tool_sequence: [
+        "run_recruit_pipeline",
+        "start_recruit_pipeline_run"
+      ]
+    };
+  }
+  return null;
+}
+
+function guardRecommendRoute(args = {}) {
+  return buildWrongRecommendRouteResponse(detectNonRecommendRoute(args));
+}
+
+function parsePositiveInteger(raw, fallback) {
+  const parsed = Number.parseInt(String(raw || ""), 10);
+  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
 }
 
 function parseNonNegativeInteger(raw, fallback) {
@@ -855,9 +961,17 @@ async function readRecommendJobOptionsFromSession(session) {
   };
 }
 
-export async function listRecommendJobsTool({ workspaceRoot = "", args = {} } = {}) {
-  const configResolution = resolveBossScreeningConfig(workspaceRoot);
-  const host = normalizeText(args.host) || DEFAULT_RECOMMEND_HOST;
+export async function listRecommendJobsTool({ workspaceRoot = "", args = {} } = {}) {
+  const routeGuard = guardRecommendRoute(args);
+  if (routeGuard) {
+    return {
+      ...routeGuard,
+      stage: "recommend_job_list",
+      message: "list_recommend_jobs is recommend-page only. For chat-only job lists, call list_boss_chat_jobs or prepare_boss_chat_run."
+    };
+  }
+  const configResolution = resolveBossScreeningConfig(workspaceRoot);
+  const host = normalizeText(args.host) || DEFAULT_RECOMMEND_HOST;
   const port = parsePositiveInteger(
     args.port,
     configResolution.ok ? configResolution.config.debugPort : DEFAULT_RECOMMEND_PORT
@@ -1477,8 +1591,10 @@ function getRunOptions(args, parsed, normalized, session, configResolution = nul
   };
 }
 
-function prepareRecommendPipelineStart(args = {}, { workspaceRoot = "" } = {}) {
-  const parsed = parseRecommendPipelineRequest(args);
+function prepareRecommendPipelineStart(args = {}, { workspaceRoot = "" } = {}) {
+  const routeGuard = guardRecommendRoute(args);
+  if (routeGuard) return { response: routeGuard };
+  const parsed = parseRecommendPipelineRequest(args);
   const gate = evaluateRecommendPipelineGate(parsed, args);
   if (gate) return { response: gate };
   const configResolution = resolveBossScreeningConfig(workspaceRoot);