@reconcrap/boss-recommend-mcp 1.3.34 → 1.3.36

package/README.md

@@ -16,7 +16,7 @@ Boss 推荐页自动化流水线 MCP（stdio）服务。
 
 - 单独运行 chat-only 任务，不需要再单独安装 `boss-chat`
 - 在 recommend screen 完成后，通过同一个父 run 自动进入 `chat_followup`
-- 继续把聊天页状态保存在工作区下的 `.boss-chat/`
+- 继续把聊天页状态保存在用户目录下的 `~/.boss-recommend-mcp/boss-chat/`（可通过 `BOSS_CHAT_HOME` 覆盖）
 
 MCP 工具：
 
@@ -68,7 +68,7 @@ MCP 工具：
 - 在真正开始 search/screen 前，会进行最后一轮全参数总确认（岗位 + 全部筛选参数 + criteria + target_count + post_action + max_greet_count）
 - npm 全局安装后会自动执行 install：生成 skill、导出 MCP 模板，并自动尝试写入已检测到的外部 agent MCP 配置（含 Trae / trae-cn / Cursor / Claude / OpenClaw）
 - npm / npx 安装后会自动初始化 `screening-config.json` 模板（优先写入 workspace 的 `config/`，不可写时回退到用户目录）
-- npm 安装流程会预创建运行目录（跨平台）：`~/.boss-recommend-mcp`、`~/.boss-recommend-mcp/runs`、`<workspace>/.boss-chat` 及其 `logs/runs/profiles/reports/artifacts`
+- npm 安装流程会预创建运行目录（跨平台）：`~/.boss-recommend-mcp`、`~/.boss-recommend-mcp/runs`、`~/.boss-recommend-mcp/boss-chat` 及其 `logs/runs/profiles/reports/artifacts/state`
 - `post_action` 必须在每次完整运行开始时确认一次
 - `target_count` 会在每次运行开始时询问一次（可留空，不设上限）
 - 当 `post_action=greet` 时，必须在运行开始时确认 `max_greet_count`
@@ -111,6 +111,7 @@ node src/cli.js start
 
 ```bash
 BOSS_RECOMMEND_HOME               # 统一状态目录，默认 ~/.boss-recommend-mcp
+BOSS_CHAT_HOME                    # 覆盖 boss-chat 运行态目录；默认 ~/.boss-recommend-mcp/boss-chat
 BOSS_RECOMMEND_SCREEN_CONFIG      # 显式指定 screening-config.json 路径（最高优先级）
 BOSS_RECOMMEND_MCP_CONFIG_TARGETS   # JSON 数组或系统 path 分隔路径列表，指定额外 mcp.json 目标文件
 BOSS_RECOMMEND_EXTERNAL_SKILL_DIRS  # JSON 数组或系统 path 分隔路径列表，指定额外 skills 根目录
@@ -149,6 +150,8 @@ node src/cli.js run --instruction "推荐页筛选985男生，近14天没有，
 - `doctor` / `run` 默认优先读取 `~/.boss-recommend-mcp/screening-config.json`；如需强制其它路径，请设置 `BOSS_RECOMMEND_SCREEN_CONFIG`
 - 首次运行时，若仍检测到默认占位词（如 `replace-with-openai-api-key`），pipeline 会返回配置目录并要求用户修改后确认“已修改完成”再继续
 - 在 `npx` 临时目录（如 `AppData\\Local\\npm-cache\\_npx\\...`）执行时，不会再把该临时目录当作 `screening-config.json` 目标路径
+- `boss-chat` 运行态默认固定写入 `~/.boss-recommend-mcp/boss-chat`；即使宿主把 MCP 进程启动在系统根目录，也不会再尝试写入 `/.boss-chat`
+- 若当前工作区存在历史 `.boss-chat` 且新用户目录尚未初始化，首次运行会自动把 `logs/runs/profiles/reports/artifacts/state` 迁移到新目录，并保留旧目录作为只读历史来源
 
 配置样例见：
 
@@ -217,6 +220,7 @@ node src/cli.js chat run --job "算法工程师" --start-from unread --criteria
 - `baseUrl` / `apiKey` / `model` 不再单独传入，固定复用 recommend 的 `screening-config.json`
 - 若缺少 `follow_up.chat` 必填项，pipeline 会返回 `NEED_INPUT`
 - recommend 成功后，父 run 继续存活并进入 `chat_followup`；chat 结束后父 run 才会进入最终终态
+- `boss-chat` 子任务状态统一写入 `~/.boss-recommend-mcp/boss-chat`（或 `BOSS_CHAT_HOME` 指定目录），不再依赖工作区 `cwd`
 
 ## Chat-only
 
@@ -230,11 +234,14 @@ node src/cli.js chat run --job "算法工程师" --start-from unread --criteria
 - MCP：
   - `boss_chat_health_check`
   - `prepare_boss_chat_run`
-  - `start_boss_chat_run`
-  - `get_boss_chat_run`
-  - `pause_boss_chat_run`
-  - `resume_boss_chat_run`
-  - `cancel_boss_chat_run`
+- `start_boss_chat_run`
+- `get_boss_chat_run`
+- `pause_boss_chat_run`
+- `resume_boss_chat_run`
+- `cancel_boss_chat_run`
+- vendored `boss-chat` CLI 还支持 `--data-dir <path>` 与 `BOSS_CHAT_HOME`，默认目录为 `~/.boss-recommend-mcp/boss-chat`（若设置 `BOSS_RECOMMEND_HOME`，则默认 `<BOSS_RECOMMEND_HOME>/boss-chat`）
+- 对 `/.boss-chat`、系统目录等危险运行目录会主动拒绝启动并返回 `UNSAFE_DATA_DIR`，避免在 harness 丢参时误写根目录
+- `boss_chat_health_check` 与 chat run 返回结果会包含 `data_dir` 与 `data_dir_source`，便于定位是参数/环境变量/默认路径生效
 
 chat-only 交互建议：
 

package/package.json

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

package/src/boss-chat.js

@@ -1,8 +1,9 @@
-import fs from "node:fs";
-import path from "node:path";
-import process from "node:process";
-import { spawn } from "node:child_process";
-import { fileURLToPath } from "node:url";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import process from "node:process";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
 
 import { getScreenConfigResolution, resolveSharedLlmTransportConfig } from "./adapters.js";
 
@@ -11,12 +12,14 @@ const packageRoot = path.resolve(path.dirname(currentFilePath), "..");
 const VENDORED_BOSS_CHAT_DIR = path.join(packageRoot, "vendor", "boss-chat-cli");
 const DEFAULT_BOSS_CHAT_POLL_MS = 1500;
 const PREPARE_BOSS_CHAT_MAX_ATTEMPTS = 3;
-const PREPARE_BOSS_CHAT_RETRY_DELAY_MS = 1200;
-const BOSS_CHAT_TERMINAL_STATES = new Set(["completed", "failed", "canceled"]);
-const CHAT_REQUIRED_FIELDS = ["job", "start_from", "target_count", "criteria"];
-export const TARGET_COUNT_CANONICAL_ALL = "all";
-export const TARGET_COUNT_ACCEPTED_EXAMPLES = [TARGET_COUNT_CANONICAL_ALL, -1, 20, "全部候选人"];
-const TARGET_COUNT_WRAPPER_KEYS = ["target_count", "targetCount", "value", "count", "limit"];
+const PREPARE_BOSS_CHAT_RETRY_DELAY_MS = 1200;
+const BOSS_CHAT_TERMINAL_STATES = new Set(["completed", "failed", "canceled"]);
+const CHAT_REQUIRED_FIELDS = ["job", "start_from", "target_count", "criteria"];
+const BOSS_CHAT_RUNTIME_SUBDIR = "boss-chat";
+const BOSS_CHAT_RUNTIME_CHILD_DIRS = ["logs", "runs", "profiles", "reports", "artifacts", "state"];
+export const TARGET_COUNT_CANONICAL_ALL = "all";
+export const TARGET_COUNT_ACCEPTED_EXAMPLES = [TARGET_COUNT_CANONICAL_ALL, -1, 20, "全部候选人"];
+const TARGET_COUNT_WRAPPER_KEYS = ["target_count", "targetCount", "value", "count", "limit"];
 const LLM_THINKING_LEVEL_FIELDS = [
   "llmThinkingLevel",
   "thinkingLevel",
@@ -28,13 +31,210 @@ function normalizeText(value) {
   return String(value || "").replace(/\s+/g, " ").trim();
 }
 
-function pathExists(targetPath) {
-  try {
-    return fs.existsSync(targetPath);
+function pathExists(targetPath) {
+  try {
+    return fs.existsSync(targetPath);
   } catch {
     return false;
-  }
-}
+  }
+}
+
+function getStateHome() {
+  return process.env.BOSS_RECOMMEND_HOME
+    ? path.resolve(process.env.BOSS_RECOMMEND_HOME)
+    : path.join(os.homedir(), ".boss-recommend-mcp");
+}
+
+function isRootDirectory(targetPath) {
+  const resolved = path.resolve(String(targetPath || ""));
+  const parsed = path.parse(resolved);
+  return resolved.toLowerCase() === String(parsed.root || "").toLowerCase();
+}
+
+function isSystemDirectoryWorkspaceRoot(workspaceRoot) {
+  const root = path.resolve(String(workspaceRoot || ""));
+  const normalized = root.replace(/\\/g, "/").toLowerCase();
+  if (process.platform === "win32") {
+    return (
+      normalized.endsWith("/windows")
+      || normalized.endsWith("/windows/system32")
+      || normalized.endsWith("/windows/syswow64")
+      || normalized.endsWith("/program files")
+      || normalized.endsWith("/program files (x86)")
+    );
+  }
+  return (
+    normalized === "/system"
+    || normalized.startsWith("/system/")
+    || normalized === "/usr"
+    || normalized.startsWith("/usr/")
+    || normalized === "/bin"
+    || normalized.startsWith("/bin/")
+    || normalized === "/sbin"
+    || normalized.startsWith("/sbin/")
+  );
+}
+
+function isEphemeralWorkspaceRoot(workspaceRoot) {
+  const normalized = path.resolve(String(workspaceRoot || ""))
+    .replace(/\\/g, "/")
+    .toLowerCase();
+  return (
+    normalized.includes("/appdata/local/npm-cache/_npx/")
+    || normalized.includes("/node_modules/@reconcrap/boss-recommend-mcp")
+  );
+}
+
+function isSafeBossChatLegacyWorkspaceRoot(workspaceRoot) {
+  const root = path.resolve(String(workspaceRoot || ""));
+  if (!root) return false;
+  const home = path.resolve(os.homedir());
+  return !(
+    isEphemeralWorkspaceRoot(root)
+    || isRootDirectory(root)
+    || root.toLowerCase() === home.toLowerCase()
+    || isSystemDirectoryWorkspaceRoot(root)
+  );
+}
+
+function isUnsafeBossChatDataDir(targetPath) {
+  const resolved = path.resolve(String(targetPath || ""));
+  return isRootDirectory(resolved) || isSystemDirectoryWorkspaceRoot(resolved);
+}
+
+function resolveBossChatDataDir() {
+  if (process.env.BOSS_CHAT_HOME) {
+    return {
+      data_dir: path.resolve(process.env.BOSS_CHAT_HOME),
+      data_dir_source: "env:BOSS_CHAT_HOME"
+    };
+  }
+  const stateHome = getStateHome();
+  const source = process.env.BOSS_RECOMMEND_HOME
+    ? "default:env:BOSS_RECOMMEND_HOME"
+    : "default:user_home";
+  return {
+    data_dir: path.join(stateHome, BOSS_CHAT_RUNTIME_SUBDIR),
+    data_dir_source: source
+  };
+}
+
+export function getBossChatDataDir() {
+  return resolveBossChatDataDir().data_dir;
+}
+
+export function getLegacyBossChatWorkspaceDataDir(workspaceRoot) {
+  if (!isSafeBossChatLegacyWorkspaceRoot(workspaceRoot)) return null;
+  return path.join(path.resolve(String(workspaceRoot)), ".boss-chat");
+}
+
+export function resolveBossChatRuntimeLayout(workspaceRoot) {
+  const resolvedDataDir = resolveBossChatDataDir();
+  const dataDir = resolvedDataDir.data_dir;
+  const legacyWorkspaceDir = getLegacyBossChatWorkspaceDataDir(workspaceRoot);
+  const migrationSourceDir =
+    legacyWorkspaceDir && pathExists(legacyWorkspaceDir) && !pathExists(dataDir)
+      ? legacyWorkspaceDir
+      : null;
+  return {
+    workspace_root: workspaceRoot ? path.resolve(String(workspaceRoot)) : null,
+    data_dir: dataDir,
+    data_dir_source: resolvedDataDir.data_dir_source,
+    legacy_workspace_dir: legacyWorkspaceDir,
+    migration_source_dir: migrationSourceDir,
+    migration_pending: Boolean(migrationSourceDir),
+    directories: [
+      dataDir,
+      ...BOSS_CHAT_RUNTIME_CHILD_DIRS.map((name) => path.join(dataDir, name))
+    ]
+  };
+}
+
+export function ensureBossChatRuntimeReady(workspaceRoot) {
+  const runtime = resolveBossChatRuntimeLayout(workspaceRoot);
+  const created = [];
+  const existed = [];
+  const failed = [];
+  let migration = {
+    attempted: false,
+    performed: false,
+    source: runtime.migration_source_dir,
+    target: runtime.data_dir,
+    message: runtime.migration_source_dir
+      ? `Pending legacy boss-chat migration from ${runtime.migration_source_dir}`
+      : ""
+  };
+
+  if (isUnsafeBossChatDataDir(runtime.data_dir)) {
+    return {
+      ...runtime,
+      created,
+      existed,
+      failed: [
+        {
+          path: runtime.data_dir,
+          message: `Refusing unsafe boss-chat runtime path: ${runtime.data_dir}. Please use BOSS_CHAT_HOME in a writable user directory.`
+        }
+      ],
+      migration,
+      blocked_reason: "UNSAFE_DATA_DIR"
+    };
+  }
+
+  if (runtime.migration_source_dir) {
+    try {
+      fs.cpSync(runtime.migration_source_dir, runtime.data_dir, {
+        recursive: true,
+        force: false,
+        errorOnExist: false
+      });
+      migration = {
+        attempted: true,
+        performed: true,
+        source: runtime.migration_source_dir,
+        target: runtime.data_dir,
+        message: `Migrated legacy boss-chat runtime from ${runtime.migration_source_dir} to ${runtime.data_dir}. Legacy source was preserved.`
+      };
+    } catch (error) {
+      migration = {
+        attempted: true,
+        performed: false,
+        source: runtime.migration_source_dir,
+        target: runtime.data_dir,
+        message: error?.message || "Legacy boss-chat migration failed."
+      };
+      failed.push({
+        path: runtime.data_dir,
+        message: `Legacy migration failed: ${migration.message}`
+      });
+    }
+  }
+
+  for (const directory of runtime.directories) {
+    try {
+      const existedBefore = pathExists(directory);
+      fs.mkdirSync(directory, { recursive: true });
+      if (existedBefore) {
+        existed.push(directory);
+      } else {
+        created.push(directory);
+      }
+    } catch (error) {
+      failed.push({
+        path: directory,
+        message: error?.message || String(error)
+      });
+    }
+  }
+
+  return {
+    ...runtime,
+    created,
+    existed,
+    failed,
+    migration
+  };
+}
 
 function parsePositiveInteger(value, fallback = null) {
   const parsed = Number.parseInt(String(value ?? ""), 10);
@@ -469,9 +669,12 @@ function buildTargetCountNeedInputDiagnostics(input = {}, missingFields = []) {
   };
 }
 
-function buildBossChatCliArgs(command, input, resolvedConfig) {
-  const args = [command, "--json"];
-  if (command === "prepare-run") {
+function buildBossChatCliArgs(command, input, resolvedConfig, runtimeLayout = null) {
+  const args = [command, "--json"];
+  if (runtimeLayout?.data_dir) {
+    args.push("--data-dir", runtimeLayout.data_dir);
+  }
+  if (command === "prepare-run") {
     const normalized = normalizeBossChatStartInput(input);
     args.push("--profile", normalized.profile);
     if (normalized.job) args.push("--job", normalized.job);
@@ -532,29 +735,65 @@ function buildBossChatCliArgs(command, input, resolvedConfig) {
   const runId = normalizeBossChatRunId(input);
   args.push("--profile", normalizeText(input.profile) || "default");
   args.push("--run-id", runId);
-  return args;
-}
-
-async function spawnBossChatCli({ workspaceRoot, command, input = {} }) {
-  const cliPath = resolveBossChatCliPath(workspaceRoot);
-  if (!cliPath) {
-    return {
+  return args;
+}
+
+function withRuntimeDiagnostics(payload, runtimeLayout) {
+  if (!payload || typeof payload !== "object") return payload;
+  return {
+    ...payload,
+    data_dir: runtimeLayout?.data_dir || null,
+    data_dir_source: runtimeLayout?.data_dir_source || null
+  };
+}
+
+async function spawnBossChatCli({ workspaceRoot, command, input = {} }) {
+  const runtimeLayout = ensureBossChatRuntimeReady(workspaceRoot);
+  const cliPath = resolveBossChatCliPath(workspaceRoot);
+  if (!cliPath) {
+    return {
       ok: false,
       exitCode: -1,
       stdout: "",
       stderr: "",
-      payload: {
-        status: "FAILED",
-        error: {
-          code: "BOSS_CHAT_CLI_MISSING",
-          message: "未找到 vendored boss-chat CLI。"
-        }
-      }
-    };
-  }
-
-  let configResolution = null;
-  if (command === "start-run" || command === "prepare-run") {
+      payload: {
+        status: "FAILED",
+        error: {
+          code: "BOSS_CHAT_CLI_MISSING",
+          message: "未找到 vendored boss-chat CLI。"
+        },
+        data_dir: runtimeLayout?.data_dir || null,
+        data_dir_source: runtimeLayout?.data_dir_source || null
+      }
+    };
+  }
+
+  const runtimeInitFailed = runtimeLayout.failed.some((item) => item.path === runtimeLayout.data_dir)
+    && !pathExists(runtimeLayout.data_dir);
+  if (runtimeInitFailed) {
+    return {
+      ok: false,
+      exitCode: 1,
+      stdout: "",
+      stderr: "",
+      payload: {
+        status: "FAILED",
+        error: {
+          code: "BOSS_CHAT_RUNTIME_INIT_FAILED",
+          message: runtimeLayout.failed
+            .filter((item) => item.path === runtimeLayout.data_dir)
+            .map((item) => item.message)
+            .join("; ") || "无法初始化 boss-chat runtime 目录。"
+        },
+        data_dir: runtimeLayout.data_dir,
+        data_dir_source: runtimeLayout.data_dir_source,
+        migration: runtimeLayout.migration
+      }
+    };
+  }
+
+  let configResolution = null;
+  if (command === "start-run" || command === "prepare-run") {
     configResolution = resolveBossChatScreenConfig(workspaceRoot);
     if (!configResolution.ok) {
       return {
@@ -562,25 +801,30 @@ async function spawnBossChatCli({ workspaceRoot, command, input = {} }) {
         exitCode: 1,
         stdout: "",
         stderr: "",
-        payload: {
-          status: "FAILED",
-          error: configResolution.error,
-          config_path: configResolution.config_path,
-          config_dir: configResolution.config_dir
-        }
-      };
-    }
-  }
-
-  const args = [cliPath, ...buildBossChatCliArgs(command, input, configResolution?.config || {})];
-  const cwd = path.resolve(String(workspaceRoot || process.cwd()));
-  return new Promise((resolve) => {
-    const child = spawn(process.execPath, args, {
-      cwd,
-      env: process.env,
-      windowsHide: true,
-      stdio: ["ignore", "pipe", "pipe"]
-    });
+        payload: {
+          status: "FAILED",
+          error: configResolution.error,
+          config_path: configResolution.config_path,
+          config_dir: configResolution.config_dir,
+          data_dir: runtimeLayout.data_dir,
+          data_dir_source: runtimeLayout.data_dir_source
+        }
+      };
+    }
+  }
+
+  const args = [cliPath, ...buildBossChatCliArgs(command, input, configResolution?.config || {}, runtimeLayout)];
+  const cwd = path.resolve(String(workspaceRoot || process.cwd()));
+  return new Promise((resolve) => {
+    const child = spawn(process.execPath, args, {
+      cwd,
+      env: {
+        ...process.env,
+        BOSS_CHAT_HOME: runtimeLayout.data_dir
+      },
+      windowsHide: true,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
 
     let stdout = "";
     let stderr = "";
@@ -596,84 +840,103 @@ async function spawnBossChatCli({ workspaceRoot, command, input = {} }) {
         exitCode: -1,
         stdout,
         stderr,
-        payload: {
-          status: "FAILED",
-          error: {
-            code: "BOSS_CHAT_CLI_SPAWN_FAILED",
-            message: error?.message || "无法启动 vendored boss-chat CLI。"
-          }
-        }
-      });
-    });
+        payload: {
+          status: "FAILED",
+          error: {
+            code: "BOSS_CHAT_CLI_SPAWN_FAILED",
+            message: error?.message || "无法启动 vendored boss-chat CLI。"
+          },
+          data_dir: runtimeLayout.data_dir,
+          data_dir_source: runtimeLayout.data_dir_source
+        }
+      });
+    });
     child.on("close", (code) => {
       const parsed = parseJsonOutput(stdout) || parseJsonOutput(stderr);
       if (parsed && typeof parsed === "object") {
         resolve({
           ok: Number(code) === 0 && String(parsed.status || "").toUpperCase() !== "FAILED",
-          exitCode: Number.isInteger(code) ? code : 1,
-          stdout,
-          stderr,
-          payload: parsed
-        });
-        return;
-      }
-      resolve({
+          exitCode: Number.isInteger(code) ? code : 1,
+          stdout,
+          stderr,
+          payload: withRuntimeDiagnostics(parsed, runtimeLayout)
+        });
+        return;
+      }
+      resolve({
         ok: Number(code) === 0,
         exitCode: Number.isInteger(code) ? code : 1,
         stdout,
-        stderr,
-        payload: Number(code) === 0
-          ? {
-              status: "OK",
-              message: normalizeText(stdout) || `${command} 执行成功。`
-            }
-          : {
-              status: "FAILED",
-              error: {
-                code: "BOSS_CHAT_CLI_EXECUTION_FAILED",
-                message: normalizeText(stderr || stdout) || `${command} 执行失败。`
-              }
-            }
-      });
-    });
-  });
-}
+        stderr,
+        payload: withRuntimeDiagnostics(
+          Number(code) === 0
+            ? {
+                status: "OK",
+                message: normalizeText(stdout) || `${command} 执行成功。`
+              }
+            : {
+                status: "FAILED",
+                error: {
+                  code: "BOSS_CHAT_CLI_EXECUTION_FAILED",
+                  message: normalizeText(stderr || stdout) || `${command} 执行失败。`
+                }
+              },
+          runtimeLayout
+        )
+      });
+    });
+  });
+}
 
-export function getBossChatHealthCheck(workspaceRoot, input = {}) {
-  const cliDir = resolveBossChatCliDir(workspaceRoot);
-  const cliPath = resolveBossChatCliPath(workspaceRoot);
-  const configResolution = resolveBossChatScreenConfig(workspaceRoot);
-  const resolvedPort = parsePositiveInteger(input.port)
-    || (configResolution.ok ? configResolution.config.debugPort : 9222);
-  if (!cliDir || !cliPath) {
+export function getBossChatHealthCheck(workspaceRoot, input = {}) {
+  const cliDir = resolveBossChatCliDir(workspaceRoot);
+  const cliPath = resolveBossChatCliPath(workspaceRoot);
+  const configResolution = resolveBossChatScreenConfig(workspaceRoot);
+  const runtimeLayout = resolveBossChatRuntimeLayout(workspaceRoot);
+  const resolvedPort = parsePositiveInteger(input.port)
+    || (configResolution.ok ? configResolution.config.debugPort : 9222);
+  if (!cliDir || !cliPath) {
     return {
       status: "FAILED",
-      error: {
-        code: "BOSS_CHAT_CLI_MISSING",
-        message: "未找到 vendored boss-chat CLI。"
-      }
-    };
-  }
-  if (!configResolution.ok) {
+      error: {
+        code: "BOSS_CHAT_CLI_MISSING",
+        message: "未找到 vendored boss-chat CLI。"
+      },
+      data_dir: runtimeLayout.data_dir,
+      data_dir_source: runtimeLayout.data_dir_source,
+      legacy_workspace_dir: runtimeLayout.legacy_workspace_dir,
+      migration_pending: runtimeLayout.migration_pending
+    };
+  }
+  if (!configResolution.ok) {
     return {
       status: "FAILED",
-      error: configResolution.error,
-      config_path: configResolution.config_path,
-      config_dir: configResolution.config_dir,
-      cli_dir: cliDir,
-      cli_path: cliPath
-    };
-  }
-  return {
+      error: configResolution.error,
+      config_path: configResolution.config_path,
+      config_dir: configResolution.config_dir,
+      cli_dir: cliDir,
+      cli_path: cliPath,
+      data_dir: runtimeLayout.data_dir,
+      data_dir_source: runtimeLayout.data_dir_source,
+      legacy_workspace_dir: runtimeLayout.legacy_workspace_dir,
+      migration_pending: runtimeLayout.migration_pending
+    };
+  }
+  return {
     status: "OK",
     server: "boss-chat",
-    cli_dir: cliDir,
-    cli_path: cliPath,
-    config_path: configResolution.config_path,
-    debug_port: resolvedPort,
-    shared_llm_config: true
-  };
-}
+    cli_dir: cliDir,
+    cli_path: cliPath,
+    config_path: configResolution.config_path,
+    debug_port: resolvedPort,
+    shared_llm_config: true,
+    data_dir: runtimeLayout.data_dir,
+    data_dir_source: runtimeLayout.data_dir_source,
+    legacy_workspace_dir: runtimeLayout.legacy_workspace_dir,
+    migration_source_dir: runtimeLayout.migration_source_dir,
+    migration_pending: runtimeLayout.migration_pending
+  };
+}
 
 export async function startBossChatRun({ workspaceRoot, input = {} }) {
   const missingFields = getMissingBossChatStartFields(input);