@reconcrap/boss-recommend-mcp 1.3.38 → 2.0.0

package/src/test-run-state.js

@@ -1,152 +0,0 @@
-import assert from "node:assert/strict";
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import {
-  RUN_MODE_ASYNC,
-  RUN_STATE_PAUSED,
-  RUN_STAGE_SCREEN,
-  RUN_STATE_COMPLETED,
-  RUN_STATE_QUEUED,
-  RUN_STATE_RUNNING,
-  cleanupExpiredRuns,
-  createRunId,
-  createRunStateSnapshot,
-  getRunsDir,
-  readRunState,
-  touchRunHeartbeat,
-  updateRunProgress,
-  updateRunState,
-  writeRunState
-} from "./run-state.js";
-
-function withTempHome(testFn) {
-  const previous = process.env.BOSS_RECOMMEND_HOME;
-  const tempHome = fs.mkdtempSync(path.join(os.tmpdir(), "boss-recommend-run-state-"));
-  process.env.BOSS_RECOMMEND_HOME = tempHome;
-  try {
-    testFn(tempHome);
-  } finally {
-    if (previous === undefined) {
-      delete process.env.BOSS_RECOMMEND_HOME;
-    } else {
-      process.env.BOSS_RECOMMEND_HOME = previous;
-    }
-    fs.rmSync(tempHome, { recursive: true, force: true });
-  }
-}
-
-function testRunStateLifecycle() {
-  withTempHome(() => {
-    const runId = createRunId();
-    const queued = writeRunState(createRunStateSnapshot({
-      runId,
-      mode: RUN_MODE_ASYNC,
-      state: RUN_STATE_QUEUED,
-      stage: "preflight",
-      context: {
-        workspace_root: "C:/workspace",
-        instruction: "筛选有 MCP 经验候选人",
-        confirmation: {
-          final_confirmed: true
-        }
-      },
-      control: {
-        pause_requested: false
-      },
-      resume: {
-        checkpoint_path: `C:/workspace/.state/${runId}.checkpoint.json`,
-        pause_control_path: `C:/workspace/.state/${runId}.json`,
-        output_csv: "C:/workspace/result.csv"
-      }
-    }));
-    assert.equal(queued.run_id, runId);
-    assert.equal(queued.state, RUN_STATE_QUEUED);
-    assert.equal(queued.context.workspace_root, "C:/workspace");
-    assert.equal(queued.resume.output_csv, "C:/workspace/result.csv");
-    assert.equal(queued.control.cancel_requested, false);
-
-    const running = updateRunState(runId, {
-      state: RUN_STATE_RUNNING,
-      stage: RUN_STAGE_SCREEN,
-      last_message: "screening in progress"
-    });
-    assert.equal(running.state, RUN_STATE_RUNNING);
-    assert.equal(running.stage, RUN_STAGE_SCREEN);
-    const heartbeatBeforeProgress = running.heartbeat_at;
-
-    const progressed = updateRunProgress(runId, {
-      processed: 7,
-      passed: 2,
-      skipped: 5,
-      greet_count: 1
-    });
-    assert.equal(progressed.progress.processed, 7);
-    assert.equal(progressed.progress.passed, 2);
-    assert.equal(progressed.progress.skipped, 5);
-    assert.equal(progressed.progress.greet_count, 1);
-    assert.equal(progressed.heartbeat_at, heartbeatBeforeProgress);
-
-    const paused = updateRunState(runId, {
-      state: RUN_STATE_PAUSED,
-      control: {
-        pause_requested: true,
-        pause_requested_at: "2026-01-01T00:00:00.000Z",
-        pause_requested_by: "pause_recommend_pipeline_run",
-        cancel_requested: true
-      },
-      resume: {
-        output_csv: "C:/workspace/result-partial.csv",
-        last_paused_at: "2026-01-01T00:00:01.000Z"
-      }
-    });
-    assert.equal(paused.state, RUN_STATE_PAUSED);
-    assert.equal(paused.control.pause_requested, true);
-    assert.equal(paused.control.pause_requested_by, "pause_recommend_pipeline_run");
-    assert.equal(paused.control.cancel_requested, true);
-    assert.equal(paused.resume.output_csv, "C:/workspace/result-partial.csv");
-
-    const heartbeated = touchRunHeartbeat(runId, "still running");
-    assert.equal(heartbeated.last_message, "still running");
-    assert.equal(Date.parse(heartbeated.heartbeat_at) >= Date.parse(heartbeatBeforeProgress), true);
-
-    const completed = updateRunState(runId, {
-      state: RUN_STATE_COMPLETED,
-      stage: "finalize",
-      result: {
-        status: "COMPLETED",
-        result: {
-          processed_count: 7
-        }
-      }
-    });
-    assert.equal(completed.state, RUN_STATE_COMPLETED);
-    assert.equal(completed.result.status, "COMPLETED");
-
-    const reloaded = readRunState(runId);
-    assert.equal(reloaded.state, RUN_STATE_COMPLETED);
-    assert.equal(reloaded.progress.processed, 7);
-  });
-}
-
-function testRunStateCleanup() {
-  withTempHome(() => {
-    const runId = createRunId();
-    writeRunState(createRunStateSnapshot({ runId, mode: RUN_MODE_ASYNC }));
-    const runFile = path.join(getRunsDir(), `${runId}.json`);
-    const oldSeconds = Math.floor((Date.now() - 3 * 24 * 60 * 60 * 1000) / 1000);
-    fs.utimesSync(runFile, oldSeconds, oldSeconds);
-
-    const cleaned = cleanupExpiredRuns(1000);
-    assert.equal(cleaned.removed.some((item) => item.endsWith(`${runId}.json`)), true);
-    assert.equal(fs.existsSync(runFile), false);
-  });
-}
-
-function main() {
-  testRunStateLifecycle();
-  testRunStateCleanup();
-  console.log("run-state tests passed");
-}
-
-main();

package/src/test-self-heal.js

@@ -1,224 +0,0 @@
-import assert from "node:assert/strict";
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { __testables as indexTestables } from "./index.js";
-import { runRecommendSelfHeal, __testables as selfHealTestables } from "./self-heal.js";
-
-const {
-  handleRequest,
-  setRunSelfHealImplForTests
-} = indexTestables;
-
-const TOOL_RUN_RECOMMEND_SELF_HEAL = "run_recommend_self_heal";
-
-function makeToolCall(id, name, args = {}) {
-  return {
-    jsonrpc: "2.0",
-    id,
-    method: "tools/call",
-    params: {
-      name,
-      arguments: args
-    }
-  };
-}
-
-async function readToolPayload(response) {
-  return response?.result?.structuredContent;
-}
-
-async function callTool(name, args, id = 1) {
-  const response = await handleRequest(makeToolCall(id, name, args), process.cwd());
-  return {
-    payload: await readToolPayload(response),
-    response
-  };
-}
-
-async function testToolsListShouldIncludeSelfHeal() {
-  const response = await handleRequest({ jsonrpc: "2.0", id: 1, method: "tools/list", params: {} }, process.cwd());
-  const tools = response?.result?.tools || [];
-  assert.equal(tools.some((tool) => tool?.name === TOOL_RUN_RECOMMEND_SELF_HEAL), true);
-}
-
-async function testIndexShouldRouteSelfHealTool() {
-  setRunSelfHealImplForTests(async () => ({ status: "HEALTHY", message: "ok" }));
-  try {
-    const { payload } = await callTool(TOOL_RUN_RECOMMEND_SELF_HEAL, {}, 2);
-    assert.equal(payload?.status, "HEALTHY");
-  } finally {
-    setRunSelfHealImplForTests(null);
-  }
-}
-
-async function testScanShouldCreateRepairSession() {
-  const previousHome = process.env.BOSS_RECOMMEND_HOME;
-  const tempHome = fs.mkdtempSync(path.join(os.tmpdir(), "boss-recommend-self-heal-home-"));
-  process.env.BOSS_RECOMMEND_HOME = tempHome;
-  try {
-    const result = await runRecommendSelfHeal(
-      { workspaceRoot: process.cwd(), args: { mode: "scan" } },
-      {
-        scanRuntimeSurface: async () => ({
-          selector_checks: [
-            {
-              rule_id: "filter_trigger",
-              path: ["frame", "filter_trigger"],
-              root: "frame",
-              matches: [
-                { selector: ".filter-label-wrap", index: 0, count: 0 },
-                { selector: ".recommend-filter.op-filter", index: 1, count: 1 }
-              ]
-            }
-          ],
-          network_checks: [],
-          side_effect_summary: { opened_candidate_detail: false }
-        })
-      }
-    );
-    assert.equal(result.status, "NEED_CONFIRMATION");
-    assert.equal(typeof result.repair_session_id, "string");
-    assert.equal(result.proposed_repairs.length, 1);
-    const sessionPath = path.join(selfHealTestables.getSelfHealSessionsDir(), `${result.repair_session_id}.json`);
-    assert.equal(fs.existsSync(sessionPath), true);
-  } finally {
-    if (previousHome === undefined) {
-      delete process.env.BOSS_RECOMMEND_HOME;
-    } else {
-      process.env.BOSS_RECOMMEND_HOME = previousHome;
-    }
-    fs.rmSync(tempHome, { recursive: true, force: true });
-  }
-}
-
-async function testOptionalSelectorMissShouldNotBecomeDrift() {
-  const drifts = selfHealTestables.analyzeSelectorChecks([
-    {
-      rule_id: "featured_cards",
-      path: ["frame", "featured_cards"],
-      root: "frame",
-      required: false,
-      report_on_no_match: false,
-      skipped: false,
-      matches: [
-        { selector: "li.geek-info-card", index: 0, count: 0 }
-      ]
-    }
-  ]);
-  assert.equal(drifts.length, 0);
-}
-
-async function testApplyShouldRequireConfirmation() {
-  const previousHome = process.env.BOSS_RECOMMEND_HOME;
-  const tempHome = fs.mkdtempSync(path.join(os.tmpdir(), "boss-recommend-self-heal-apply-home-"));
-  process.env.BOSS_RECOMMEND_HOME = tempHome;
-  try {
-    const scanResult = await runRecommendSelfHeal(
-      { workspaceRoot: process.cwd(), args: { mode: "scan" } },
-      {
-        scanRuntimeSurface: async () => ({
-          selector_checks: [
-            {
-              rule_id: "filter_trigger",
-              path: ["frame", "filter_trigger"],
-              root: "frame",
-              matches: [
-                { selector: ".filter-label-wrap", index: 0, count: 0 },
-                { selector: ".recommend-filter.op-filter", index: 1, count: 1 }
-              ]
-            }
-          ],
-          network_checks: [],
-          side_effect_summary: null
-        })
-      }
-    );
-    const result = await runRecommendSelfHeal({
-      workspaceRoot: process.cwd(),
-      args: {
-        mode: "apply",
-        repair_session_id: scanResult.repair_session_id
-      }
-    });
-    assert.equal(result.status, "FAILED");
-    assert.equal(result.error?.code, "SELF_HEAL_CONFIRMATION_REQUIRED");
-  } finally {
-    if (previousHome === undefined) {
-      delete process.env.BOSS_RECOMMEND_HOME;
-    } else {
-      process.env.BOSS_RECOMMEND_HOME = previousHome;
-    }
-    fs.rmSync(tempHome, { recursive: true, force: true });
-  }
-}
-
-async function testApplyShouldUpdateRulesFile() {
-  const previousHome = process.env.BOSS_RECOMMEND_HOME;
-  const previousRulesPath = process.env.BOSS_RECOMMEND_HEALING_RULES_FILE;
-  const tempHome = fs.mkdtempSync(path.join(os.tmpdir(), "boss-recommend-self-heal-rules-home-"));
-  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "boss-recommend-self-heal-rules-"));
-  const rulesSourcePath = path.join(process.cwd(), "src", "recommend-healing-rules.json");
-  const tempRulesPath = path.join(tempDir, "recommend-healing-rules.json");
-  fs.copyFileSync(rulesSourcePath, tempRulesPath);
-  process.env.BOSS_RECOMMEND_HOME = tempHome;
-  process.env.BOSS_RECOMMEND_HEALING_RULES_FILE = tempRulesPath;
-  try {
-    const scanResult = await runRecommendSelfHeal(
-      { workspaceRoot: process.cwd(), args: { mode: "scan" } },
-      {
-        scanRuntimeSurface: async () => ({
-          selector_checks: [
-            {
-              rule_id: "filter_trigger",
-              path: ["frame", "filter_trigger"],
-              root: "frame",
-              matches: [
-                { selector: ".filter-label-wrap", index: 0, count: 0 },
-                { selector: ".recommend-filter.op-filter", index: 1, count: 1 }
-              ]
-            }
-          ],
-          network_checks: [],
-          side_effect_summary: null
-        })
-      }
-    );
-    const result = await runRecommendSelfHeal({
-      workspaceRoot: process.cwd(),
-      args: {
-        mode: "apply",
-        repair_session_id: scanResult.repair_session_id,
-        confirm_apply: true
-      }
-    });
-    assert.equal(result.status, "REPAIRED");
-    const updatedRules = JSON.parse(fs.readFileSync(tempRulesPath, "utf8"));
-    assert.equal(updatedRules.selectors.frame.filter_trigger[0], ".recommend-filter.op-filter");
-  } finally {
-    if (previousHome === undefined) {
-      delete process.env.BOSS_RECOMMEND_HOME;
-    } else {
-      process.env.BOSS_RECOMMEND_HOME = previousHome;
-    }
-    if (previousRulesPath === undefined) {
-      delete process.env.BOSS_RECOMMEND_HEALING_RULES_FILE;
-    } else {
-      process.env.BOSS_RECOMMEND_HEALING_RULES_FILE = previousRulesPath;
-    }
-    fs.rmSync(tempHome, { recursive: true, force: true });
-    fs.rmSync(tempDir, { recursive: true, force: true });
-  }
-}
-
-async function main() {
-  await testToolsListShouldIncludeSelfHeal();
-  await testIndexShouldRouteSelfHealTool();
-  await testScanShouldCreateRepairSession();
-  await testOptionalSelectorMissShouldNotBecomeDrift();
-  await testApplyShouldRequireConfirmation();
-  await testApplyShouldUpdateRulesFile();
-  console.log("self-heal tests passed");
-}
-
-await main();

package/vendor/boss-chat-cli/README.md

@@ -1,134 +0,0 @@
-# boss-chat
-
-基于 Chrome DevTools Protocol 和 OpenAI 兼容 LLM 的 Boss 直聘聊天页教育筛选与自动沟通 CLI。
-
-## 功能
-
-- 连接已登录、已打开聊天页的 Chrome
-- 遍历聊天列表客户卡片，读取教育信息
-- 用自定义 `baseUrl + apiKey + model` 调用大模型判断是否符合教育要求
-- 命中时自动生成简短话术并写入聊天框，随后发送
-- 默认记录已处理客户，避免重复触达
-- 支持选择从`未读`或`全部`列表开始处理
-- 支持 `--dry-run` 先验证页面稳定性和命中效果
-
-## 依赖
-
-- Node.js（建议 18+）
-- Google Chrome（需开启远程调试端口）
-- npm 包依赖：
-  - `chrome-remote-interface@^0.33.3`
-
-## 使用前准备
-
-1. 用远程调试模式启动 Chrome：
-
-```powershell
-chrome.exe --remote-debugging-port=9222
-```
-
-2. 登录 Boss 直聘并打开聊天页：
-
-```text
-https://www.zhipin.com/web/chat/index
-```
-
-3. 全局安装：
-
-```powershell
-npm install -g @reconcrap/boss-chat-cli
-```
-
-也可以直接用 `npx`（适合 agent 平台托管 MCP 时）：
-
-```powershell
-npx -y -p @reconcrap/boss-chat-cli@latest boss-chat-mcp
-```
-
-## 运行
-
-首次运行会交互式询问教育要求、话术样例、LLM 参数等配置；每次运行也可选择从`未读`或`全部`开始：
-
-```powershell
-boss-chat run
-```
-
-建议先用 dry-run：
-
-```powershell
-boss-chat run --dry-run --targetCount 3
-```
-
-## MCP Agent 集成（openclaw / codex / trae-cn）
-
-包内已内置 MCP stdio server，可直接被三类平台调用：
-
-- `openclaw-boss-chat-mcp`
-- `codex-boss-chat-mcp`
-- `trae-cn-boss-chat-mcp`
-- 通用入口：`boss-chat-mcp`
-
-### 工具列表
-
-- `health_check`: 检查服务是否可用
-- `start_run`: 启动异步任务，返回 `run_id`
-- `get_run`: 查询任务状态
-- `pause_run`: 暂停任务
-- `resume_run`: 继续任务
-- `cancel_run`: 取消任务
-
-### 平台配置示例
-
-项目里提供了三份可直接复制的模板：
-
-- `configs/mcp/openclaw.json`
-- `configs/mcp/codex.json`
-- `configs/mcp/trae-cn.json`
-
-三份配置都通过 `npx` 拉取最新包并启动对应 MCP 入口，例如：
-
-```json
-{
-  "mcpServers": {
-    "boss-chat": {
-      "command": "npx",
-      "args": ["-y", "-p", "@reconcrap/boss-chat-cli@latest", "boss-chat-mcp"]
-    }
-  }
-}
-```
-
-> 不同平台的 MCP 配置文件路径可能不同，但 `command + args` 可直接复用。
-
-## 运行中控制
-
-程序运行时可以直接用键盘控制：
-
-- `p`: 暂停；再次按 `p` 或按 `r` 继续
-- `r`: 继续运行
-- `q`: 请求停止，当前步骤结束后安全退出
-- `Ctrl+C`: 请求停止，当前步骤结束后安全退出
-
-停止后仍会写入本次运行报告，已记录的客户状态也会保留。
-
-## 常用参数
-
-- `--profile <name>`: 使用指定 profile
-- `--dry-run`: 只检查和生成文案，不实际发送
-- `--no-state`: 不记录已处理客户
-- `--targetCount <n>`: 覆盖本次检查人数
-- `--educationRequirement <text>`: 覆盖教育要求
-- `--messageSample <text>`: 覆盖话术样例
-- `--start-from <unread|all>`: 本次从未读或全部列表开始
-- `--baseurl <url>`: 覆盖 LLM base URL
-- `--apikey <key>`: 覆盖 LLM API key
-- `--model <name>`: 覆盖 LLM 模型
-- `--port <n>`: 覆盖 Chrome 远程调试端口
-
-## 数据目录
-
-运行产生的数据默认保存在项目下的 `.boss-chat/`：
-
-- `profiles/`: 保存 profile 配置
-- `state/`: 保存已处理客户状态
-- `reports/`: 保存每次运行的 JSON 报告

package/vendor/boss-chat-cli/package.json

@@ -1,53 +0,0 @@
-{
-  "name": "@reconcrap/boss-chat-cli",
-  "version": "1.1.0",
-  "description": "Boss chat education screening and outreach CLI with MCP agent bridge",
-  "type": "module",
-  "bin": {
-    "boss-chat": "src/cli.js",
-    "boss-chat-mcp": "src/mcp/server.js",
-    "openclaw-boss-chat-mcp": "src/mcp/server.js",
-    "codex-boss-chat-mcp": "src/mcp/server.js",
-    "trae-cn-boss-chat-mcp": "src/mcp/server.js"
-  },
-  "main": "./src/cli.js",
-  "files": [
-    "src/",
-    "configs/",
-    "README.md"
-  ],
-  "scripts": {
-    "start": "node ./src/cli.js run",
-    "start:mcp": "node ./src/mcp/server.js",
-    "test": "node --test"
-  },
-  "keywords": [
-    "boss",
-    "zhipin",
-    "chrome-devtools",
-    "cli",
-    "automation",
-    "mcp",
-    "openclaw",
-    "codex",
-    "trae-cn"
-  ],
-  "author": "",
-  "license": "MIT",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "repository": {
-    "type": "git",
-    "url": ""
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.18.1",
-    "chrome-remote-interface": "^0.33.3",
-    "sharp": "^0.34.5",
-    "zod": "^4.1.12"
-  }
-}