chatccc 0.2.231 → 0.2.233

package/src/__tests__/web-ui.test.ts

@@ -1,326 +1,326 @@
-import { createServer } from "node:http";
-import type { AddressInfo } from "node:net";
-import { describe, it, expect } from "vitest";
-import {
-  AGENT_TEAM_PAGE_HTML,
-  PAGE_HTML,
-  chooseStartPath,
-  createUiRouter,
-  getRestartRequiredReasons,
-  unflattenConfig,
-} from "../web-ui.ts";
-
-describe("Agent Team page", () => {
-  it("adds a prominent global entry to the ChatCCC page", () => {
-    expect(PAGE_HTML).toContain('href="/agent-team"');
-    expect(PAGE_HTML).toContain('class="agent-team-entry"');
-    expect(PAGE_HTML).toContain("Agent Team");
-    expect(PAGE_HTML).toContain("linear-gradient");
-  });
-
-  it("contains only the Agent Team title as page content", () => {
-    expect(AGENT_TEAM_PAGE_HTML).toContain("<title>Agent Team</title>");
-    expect(AGENT_TEAM_PAGE_HTML).toContain("<h1>Agent Team</h1>");
-    expect(AGENT_TEAM_PAGE_HTML).not.toContain("dashboard-view");
-    expect(AGENT_TEAM_PAGE_HTML).not.toContain("wizard-view");
-  });
-
-  it("serves the Agent Team page from its own route", async () => {
-    const server = createServer(createUiRouter());
-    await new Promise<void>((resolve) => server.listen(0, "127.0.0.1", resolve));
-    const port = (server.address() as AddressInfo).port;
-    try {
-      const response = await fetch(`http://127.0.0.1:${port}/agent-team`);
-      expect(response.status).toBe(200);
-      expect(await response.text()).toBe(AGENT_TEAM_PAGE_HTML);
-    } finally {
-      await new Promise<void>((resolve, reject) => server.close((err) => err ? reject(err) : resolve()));
-    }
-  });
-});
-
-describe("unflattenConfig", () => {
-  it("maps Claude subagent model into claude.subagentModel", () => {
-    expect(
-      unflattenConfig({
-        CHATCCC_ANTHROPIC_MODEL: "claude-sonnet-4-6",
-        CHATCCC_ANTHROPIC_SUBAGENT_MODEL: "claude-haiku-4-5-20251001",
-      }),
-    ).toEqual({
-      claude: {
-        model: "claude-sonnet-4-6",
-        subagentModel: "claude-haiku-4-5-20251001",
-      },
-    });
-  });
-
-  it("maps Claude apiKey and baseUrl into claude config", () => {
-    expect(
-      unflattenConfig({
-        CHATCCC_ANTHROPIC_API_KEY: "sk-test-key",
-        CHATCCC_ANTHROPIC_BASE_URL: "https://api.example.com",
-      }),
-    ).toEqual({
-      claude: {
-        apiKey: "sk-test-key",
-        baseUrl: "https://api.example.com",
-      },
-    });
-  });
-
-  it("maps Cursor and Codex runtime settings into agent config", () => {
-    expect(
-      unflattenConfig({
-        CHATCCC_CURSOR_ALTERNATIVE_MODEL: "gpt-5.5-high",
-        CHATCCC_CODEX_ALTERNATIVE_MODEL: "gpt-5.3-codex",
-        CHATCCC_CODEX_FAST_MODE: true,
-      }),
-    ).toEqual({
-      cursor: {
-        alternativeModel: "gpt-5.5-high",
-      },
-      codex: {
-        alternativeModel: "gpt-5.3-codex",
-        fastMode: true,
-      },
-    });
-  });
-
-  it("maps CCC Agent settings into ccc config", () => {
-    expect(
-      unflattenConfig({
-        CHATCCC_CCC_ENABLED: true,
-        CHATCCC_CCC_DEFAULT_AGENT: true,
-        CHATCCC_CCC_API_KEY: "sk-test-ccc",
-        CHATCCC_CCC_BASE_URL: "https://api.deepseek.com/v1",
-        CHATCCC_CCC_MODEL: "deepseek-v4-flash",
-        CHATCCC_CCC_ALTERNATIVE_MODEL: "deepseek-v4-pro",
-        CHATCCC_CCC_EFFORT: "max",
-      }),
-    ).toEqual({
-      ccc: {
-        enabled: true,
-        defaultAgent: true,
-        DEEPSEEK_API_KEY: "sk-test-ccc",
-        DEEPSEEK_BASE_URL: "https://api.deepseek.com/v1",
-        model: "deepseek-v4-flash",
-        alternativeModel: "deepseek-v4-pro",
-        effort: "max",
-      },
-    });
-  });
-
-  it("maps Chrome CDP guard fields into chromeDevtools config", () => {
-    expect(
-      unflattenConfig({
-        CHATCCC_CHROME_DEVTOOLS_ENABLED: true,
-        CHATCCC_CHROME_DEVTOOLS_PORT: "15166",
-        CHATCCC_CHROME_DEVTOOLS_PATH: "C:/Program Files/Google/Chrome/Application/chrome.exe",
-      }),
-    ).toEqual({
-      chromeDevtools: {
-        enabled: true,
-        port: 15166,
-        chromePath: "C:/Program Files/Google/Chrome/Application/chrome.exe",
-      },
-    });
-  });
-
-  it("maps the Web UI startup preference into webUi config", () => {
-    expect(
-      unflattenConfig({
-        CHATCCC_WEB_UI_OPEN_ON_START: false,
-      }),
-    ).toEqual({
-      webUi: {
-        openOnStart: false,
-      },
-    });
-  });
-});
-
-describe("getRestartRequiredReasons", () => {
-  const baseConfig = {
-    feishu: { appId: "cli_old", appSecret: "secret_old" },
-    platforms: {
-      feishu: { enabled: true, platformType: "feishu" },
-      ilink: { enabled: true, reuseTokenOnStart: true },
-    },
-    webUi: { openOnStart: true },
-    chromeDevtools: { enabled: false, port: 15166, chromePath: "" },
-    port: 18080,
-    claude: {
-      enabled: true,
-      defaultAgent: true,
-      model: "",
-      subagentModel: "",
-      effort: "",
-      apiKey: "",
-      baseUrl: "",
-      maxTurn: 0,
-    },
-    cursor: {
-      enabled: true,
-      defaultAgent: false,
-      path: "",
-      model: "",
-      alternativeModel: "",
-      avatarBatteryMode: "apiPercent",
-      onDemandMonthlyBudget: 1000,
-    },
-    codex: {
-      enabled: true,
-      defaultAgent: false,
-      path: "",
-      model: "",
-      alternativeModel: "",
-      effort: "",
-      fastMode: false,
-    },
-    ccc: {
-      enabled: true,
-      defaultAgent: false,
-      DEEPSEEK_API_KEY: "sk-test-ccc",
-      DEEPSEEK_BASE_URL: "https://api.deepseek.com/v1",
-      model: "deepseek-v4-pro",
-      alternativeModel: "",
-    },
-  };
-
-  it("does not require restart for agent and Chrome runtime settings", () => {
-    expect(
-      getRestartRequiredReasons(baseConfig, {
-        ...baseConfig,
-        chromeDevtools: { enabled: true, port: 15167, chromePath: "C:/Chrome/chrome.exe" },
-        claude: { ...baseConfig.claude, model: "claude-sonnet", apiKey: "sk-test", maxTurn: 8 },
-        cursor: { ...baseConfig.cursor, path: "C:/cursor-agent.cmd", model: "cursor-model" },
-        codex: {
-          ...baseConfig.codex,
-          path: "C:/codex.cmd",
-          model: "gpt-5.3-codex",
-          effort: "high",
-          fastMode: true,
-        },
-      }),
-    ).toEqual([]);
-  });
-
-  it("requires restart for port, Feishu credentials, platform type, and platform lifecycle", () => {
-    expect(
-      getRestartRequiredReasons(baseConfig, {
-        ...baseConfig,
-        feishu: { appId: "cli_new", appSecret: "secret_new" },
-        platforms: {
-          feishu: { enabled: false, platformType: "lark" },
-          ilink: { enabled: false, reuseTokenOnStart: false },
-        },
-        port: 18081,
-      }),
-    ).toEqual([
-      "port",
-      "feishu.appId",
-      "feishu.appSecret",
-      "platforms.feishu.platformType",
-      "platforms.feishu.enabled",
-      "platforms.ilink.enabled",
-      "platforms.ilink.reuseTokenOnStart",
-    ]);
-  });
-});
-
-describe("dashboard edit modal", () => {
-  it("keeps the embedded dashboard script syntactically valid", () => {
-    const script = PAGE_HTML.match(/<script>([\s\S]*)<\/script>/)?.[1];
-    expect(script).toBeTruthy();
-    expect(() => new Function(script ?? "")).not.toThrow();
-  });
-
-  it("shows the edit modal and overlay when a section edit button is clicked", () => {
-    expect(PAGE_HTML).toContain("function editSection(section)");
-    expect(PAGE_HTML).toContain("document.getElementById('edit-modal').classList.remove('hidden');");
-    expect(PAGE_HTML).toContain("document.getElementById('edit-overlay').classList.remove('hidden');");
-  });
-
-  it("uses plain alternative model labels for Cursor and Codex", () => {
-    expect(PAGE_HTML).toContain("field-CHATCCC_CURSOR_ALTERNATIVE_MODEL");
-    expect(PAGE_HTML).toContain("field-CHATCCC_CODEX_ALTERNATIVE_MODEL");
-    expect(PAGE_HTML).toContain("备选模型");
-  });
-
-  it("shows CCC Agent in the wizard and dashboard with model switching fields", () => {
-    expect(PAGE_HTML).toContain('id="agent-card-ccc"');
-    expect(PAGE_HTML).toContain('id="agent-enable-ccc"');
-    expect(PAGE_HTML).toContain('id="agent-default-ccc"');
-    expect(PAGE_HTML).toContain('id="field-CHATCCC_CCC_MODEL"');
-    expect(PAGE_HTML).toContain('id="field-CHATCCC_CCC_ALTERNATIVE_MODEL"');
-    expect(PAGE_HTML).toContain('id="field-CHATCCC_CCC_EFFORT"');
-    expect(PAGE_HTML).toContain('id="dash-ccc"');
-    expect(PAGE_HTML).toContain("editSection('ccc')");
-  });
-
-  it("shows config effect scope hints", () => {
-    expect(PAGE_HTML).toContain("生效范围：保存后下一条消息或下个新会话生效");
-    expect(PAGE_HTML).toContain("生效范围：飞书开关、App ID、App Secret 或平台类型变更需要重启 ChatCCC");
-  });
-
-  it("shows the Codex Fast mode switch in both the wizard and dashboard", () => {
-    expect(PAGE_HTML).toContain('id="field-CHATCCC_CODEX_FAST_MODE"');
-    expect(PAGE_HTML).toContain('id="cfg-CODEX_FAST_MODE"');
-    expect(PAGE_HTML).toContain("Fast 模式");
-  });
-
-  it("shows the Web UI startup switch in both the wizard and dashboard", () => {
-    expect(PAGE_HTML).toContain('id="field-CHATCCC_WEB_UI_OPEN_ON_START"');
-    expect(PAGE_HTML).toContain('id="cfg-WEB_UI_OPEN_ON_START"');
-    expect(PAGE_HTML).toContain("editSection('webUi')");
-    expect(PAGE_HTML).toContain("下次直接启动生效；内部重启始终不打开");
-  });
-});
-
-// ---------------------------------------------------------------------------
-// chooseStartPath — /api/start 的路径选择
-// 关键护栏：
-//   - setup 模式（hasInplaceActivateHook=true）下 isServiceRunning 永远为 true
-//     （setup 进程自己占着 PID 文件），必须无条件走 inplace；否则用户点
-//     "保存并启动"将永远拿到 "Service is already running"。
-//   - dashboard 模式 + service 已运行（通常就是当前进程自己）→ "reload"：
-//     用户点"保存并启动"想让新 config 生效，但服务正在跑——不真重启，仅
-//     调用 reloadConfigFromDisk() 刷新进程内 export let 常量。绝不能再
-//     返回"already running"挡用户路。
-//   - dashboard 模式 + service 未运行 → spawn 一个新的（旧 service 退出后场景）。
-// ---------------------------------------------------------------------------
-
-describe("chooseStartPath", () => {
-  it("setup 模式（注入 inplace hook）→ inplace（不管 PID 文件状态）", () => {
-    expect(
-      chooseStartPath({
-        hasInplaceActivateHook: true,
-        isServiceRunning: true,
-      }),
-    ).toBe("inplace");
-    expect(
-      chooseStartPath({
-        hasInplaceActivateHook: true,
-        isServiceRunning: false,
-      }),
-    ).toBe("inplace");
-  });
-
-  it("dashboard 模式 + service 已运行 → reload（仅刷新 config，不真重启）", () => {
-    expect(
-      chooseStartPath({
-        hasInplaceActivateHook: false,
-        isServiceRunning: true,
-      }),
-    ).toBe("reload");
-  });
-
-  it("dashboard 模式 + service 未运行 → spawn", () => {
-    expect(
-      chooseStartPath({
-        hasInplaceActivateHook: false,
-        isServiceRunning: false,
-      }),
-    ).toBe("spawn");
-  });
-});
+import { createServer } from "node:http";
+import type { AddressInfo } from "node:net";
+import { describe, it, expect } from "vitest";
+import {
+  AGENT_TEAM_PAGE_HTML,
+  PAGE_HTML,
+  chooseStartPath,
+  createUiRouter,
+  getRestartRequiredReasons,
+  unflattenConfig,
+} from "../web-ui.ts";
+
+describe("Agent Team page", () => {
+  it("adds a prominent global entry to the ChatCCC page", () => {
+    expect(PAGE_HTML).toContain('href="/agent-team"');
+    expect(PAGE_HTML).toContain('class="agent-team-entry"');
+    expect(PAGE_HTML).toContain("Agent Team");
+    expect(PAGE_HTML).toContain("linear-gradient");
+  });
+
+  it("contains only the Agent Team title as page content", () => {
+    expect(AGENT_TEAM_PAGE_HTML).toContain("<title>Agent Team</title>");
+    expect(AGENT_TEAM_PAGE_HTML).toContain("<h1>Agent Team</h1>");
+    expect(AGENT_TEAM_PAGE_HTML).not.toContain("dashboard-view");
+    expect(AGENT_TEAM_PAGE_HTML).not.toContain("wizard-view");
+  });
+
+  it("serves the Agent Team page from its own route", async () => {
+    const server = createServer(createUiRouter());
+    await new Promise<void>((resolve) => server.listen(0, "127.0.0.1", resolve));
+    const port = (server.address() as AddressInfo).port;
+    try {
+      const response = await fetch(`http://127.0.0.1:${port}/agent-team`);
+      expect(response.status).toBe(200);
+      expect(await response.text()).toBe(AGENT_TEAM_PAGE_HTML);
+    } finally {
+      await new Promise<void>((resolve, reject) => server.close((err) => err ? reject(err) : resolve()));
+    }
+  });
+});
+
+describe("unflattenConfig", () => {
+  it("maps Claude subagent model into claude.subagentModel", () => {
+    expect(
+      unflattenConfig({
+        CHATCCC_ANTHROPIC_MODEL: "claude-sonnet-4-6",
+        CHATCCC_ANTHROPIC_SUBAGENT_MODEL: "claude-haiku-4-5-20251001",
+      }),
+    ).toEqual({
+      claude: {
+        model: "claude-sonnet-4-6",
+        subagentModel: "claude-haiku-4-5-20251001",
+      },
+    });
+  });
+
+  it("maps Claude apiKey and baseUrl into claude config", () => {
+    expect(
+      unflattenConfig({
+        CHATCCC_ANTHROPIC_API_KEY: "sk-test-key",
+        CHATCCC_ANTHROPIC_BASE_URL: "https://api.example.com",
+      }),
+    ).toEqual({
+      claude: {
+        apiKey: "sk-test-key",
+        baseUrl: "https://api.example.com",
+      },
+    });
+  });
+
+  it("maps Cursor and Codex runtime settings into agent config", () => {
+    expect(
+      unflattenConfig({
+        CHATCCC_CURSOR_ALTERNATIVE_MODEL: "gpt-5.5-high",
+        CHATCCC_CODEX_ALTERNATIVE_MODEL: "gpt-5.3-codex",
+        CHATCCC_CODEX_FAST_MODE: true,
+      }),
+    ).toEqual({
+      cursor: {
+        alternativeModel: "gpt-5.5-high",
+      },
+      codex: {
+        alternativeModel: "gpt-5.3-codex",
+        fastMode: true,
+      },
+    });
+  });
+
+  it("maps CCC Agent settings into ccc config", () => {
+    expect(
+      unflattenConfig({
+        CHATCCC_CCC_ENABLED: true,
+        CHATCCC_CCC_DEFAULT_AGENT: true,
+        CHATCCC_CCC_API_KEY: "sk-test-ccc",
+        CHATCCC_CCC_BASE_URL: "https://api.deepseek.com/v1",
+        CHATCCC_CCC_MODEL: "deepseek-v4-flash",
+        CHATCCC_CCC_ALTERNATIVE_MODEL: "deepseek-v4-pro",
+        CHATCCC_CCC_EFFORT: "max",
+      }),
+    ).toEqual({
+      ccc: {
+        enabled: true,
+        defaultAgent: true,
+        DEEPSEEK_API_KEY: "sk-test-ccc",
+        DEEPSEEK_BASE_URL: "https://api.deepseek.com/v1",
+        model: "deepseek-v4-flash",
+        alternativeModel: "deepseek-v4-pro",
+        effort: "max",
+      },
+    });
+  });
+
+  it("maps Chrome CDP guard fields into chromeDevtools config", () => {
+    expect(
+      unflattenConfig({
+        CHATCCC_CHROME_DEVTOOLS_ENABLED: true,
+        CHATCCC_CHROME_DEVTOOLS_PORT: "15166",
+        CHATCCC_CHROME_DEVTOOLS_PATH: "C:/Program Files/Google/Chrome/Application/chrome.exe",
+      }),
+    ).toEqual({
+      chromeDevtools: {
+        enabled: true,
+        port: 15166,
+        chromePath: "C:/Program Files/Google/Chrome/Application/chrome.exe",
+      },
+    });
+  });
+
+  it("maps the Web UI startup preference into webUi config", () => {
+    expect(
+      unflattenConfig({
+        CHATCCC_WEB_UI_OPEN_ON_START: false,
+      }),
+    ).toEqual({
+      webUi: {
+        openOnStart: false,
+      },
+    });
+  });
+});
+
+describe("getRestartRequiredReasons", () => {
+  const baseConfig = {
+    feishu: { appId: "cli_old", appSecret: "secret_old" },
+    platforms: {
+      feishu: { enabled: true, platformType: "feishu" },
+      ilink: { enabled: true, reuseTokenOnStart: true },
+    },
+    webUi: { openOnStart: true },
+    chromeDevtools: { enabled: false, port: 15166, chromePath: "" },
+    port: 18080,
+    claude: {
+      enabled: true,
+      defaultAgent: true,
+      model: "",
+      subagentModel: "",
+      effort: "",
+      apiKey: "",
+      baseUrl: "",
+      maxTurn: 0,
+    },
+    cursor: {
+      enabled: true,
+      defaultAgent: false,
+      path: "",
+      model: "",
+      alternativeModel: "",
+      avatarBatteryMode: "apiPercent",
+      onDemandMonthlyBudget: 1000,
+    },
+    codex: {
+      enabled: true,
+      defaultAgent: false,
+      path: "",
+      model: "",
+      alternativeModel: "",
+      effort: "",
+      fastMode: false,
+    },
+    ccc: {
+      enabled: true,
+      defaultAgent: false,
+      DEEPSEEK_API_KEY: "sk-test-ccc",
+      DEEPSEEK_BASE_URL: "https://api.deepseek.com/v1",
+      model: "deepseek-v4-pro",
+      alternativeModel: "",
+    },
+  };
+
+  it("does not require restart for agent and Chrome runtime settings", () => {
+    expect(
+      getRestartRequiredReasons(baseConfig, {
+        ...baseConfig,
+        chromeDevtools: { enabled: true, port: 15167, chromePath: "C:/Chrome/chrome.exe" },
+        claude: { ...baseConfig.claude, model: "claude-sonnet", apiKey: "sk-test", maxTurn: 8 },
+        cursor: { ...baseConfig.cursor, path: "C:/cursor-agent.cmd", model: "cursor-model" },
+        codex: {
+          ...baseConfig.codex,
+          path: "C:/codex.cmd",
+          model: "gpt-5.3-codex",
+          effort: "high",
+          fastMode: true,
+        },
+      }),
+    ).toEqual([]);
+  });
+
+  it("requires restart for port, Feishu credentials, platform type, and platform lifecycle", () => {
+    expect(
+      getRestartRequiredReasons(baseConfig, {
+        ...baseConfig,
+        feishu: { appId: "cli_new", appSecret: "secret_new" },
+        platforms: {
+          feishu: { enabled: false, platformType: "lark" },
+          ilink: { enabled: false, reuseTokenOnStart: false },
+        },
+        port: 18081,
+      }),
+    ).toEqual([
+      "port",
+      "feishu.appId",
+      "feishu.appSecret",
+      "platforms.feishu.platformType",
+      "platforms.feishu.enabled",
+      "platforms.ilink.enabled",
+      "platforms.ilink.reuseTokenOnStart",
+    ]);
+  });
+});
+
+describe("dashboard edit modal", () => {
+  it("keeps the embedded dashboard script syntactically valid", () => {
+    const script = PAGE_HTML.match(/<script>([\s\S]*)<\/script>/)?.[1];
+    expect(script).toBeTruthy();
+    expect(() => new Function(script ?? "")).not.toThrow();
+  });
+
+  it("shows the edit modal and overlay when a section edit button is clicked", () => {
+    expect(PAGE_HTML).toContain("function editSection(section)");
+    expect(PAGE_HTML).toContain("document.getElementById('edit-modal').classList.remove('hidden');");
+    expect(PAGE_HTML).toContain("document.getElementById('edit-overlay').classList.remove('hidden');");
+  });
+
+  it("uses plain alternative model labels for Cursor and Codex", () => {
+    expect(PAGE_HTML).toContain("field-CHATCCC_CURSOR_ALTERNATIVE_MODEL");
+    expect(PAGE_HTML).toContain("field-CHATCCC_CODEX_ALTERNATIVE_MODEL");
+    expect(PAGE_HTML).toContain("备选模型");
+  });
+
+  it("shows CCC Agent in the wizard and dashboard with model switching fields", () => {
+    expect(PAGE_HTML).toContain('id="agent-card-ccc"');
+    expect(PAGE_HTML).toContain('id="agent-enable-ccc"');
+    expect(PAGE_HTML).toContain('id="agent-default-ccc"');
+    expect(PAGE_HTML).toContain('id="field-CHATCCC_CCC_MODEL"');
+    expect(PAGE_HTML).toContain('id="field-CHATCCC_CCC_ALTERNATIVE_MODEL"');
+    expect(PAGE_HTML).toContain('id="field-CHATCCC_CCC_EFFORT"');
+    expect(PAGE_HTML).toContain('id="dash-ccc"');
+    expect(PAGE_HTML).toContain("editSection('ccc')");
+  });
+
+  it("shows config effect scope hints", () => {
+    expect(PAGE_HTML).toContain("生效范围：保存后下一条消息或下个新会话生效");
+    expect(PAGE_HTML).toContain("生效范围：飞书开关、App ID、App Secret 或平台类型变更需要重启 ChatCCC");
+  });
+
+  it("shows the Codex Fast mode switch in both the wizard and dashboard", () => {
+    expect(PAGE_HTML).toContain('id="field-CHATCCC_CODEX_FAST_MODE"');
+    expect(PAGE_HTML).toContain('id="cfg-CODEX_FAST_MODE"');
+    expect(PAGE_HTML).toContain("Fast 模式");
+  });
+
+  it("shows the Web UI startup switch in both the wizard and dashboard", () => {
+    expect(PAGE_HTML).toContain('id="field-CHATCCC_WEB_UI_OPEN_ON_START"');
+    expect(PAGE_HTML).toContain('id="cfg-WEB_UI_OPEN_ON_START"');
+    expect(PAGE_HTML).toContain("editSection('webUi')");
+    expect(PAGE_HTML).toContain("下次直接启动生效；内部重启始终不打开");
+  });
+});
+
+// ---------------------------------------------------------------------------
+// chooseStartPath — /api/start 的路径选择
+// 关键护栏：
+//   - setup 模式（hasInplaceActivateHook=true）下 isServiceRunning 永远为 true
+//     （setup 进程自己占着 PID 文件），必须无条件走 inplace；否则用户点
+//     "保存并启动"将永远拿到 "Service is already running"。
+//   - dashboard 模式 + service 已运行（通常就是当前进程自己）→ "reload"：
+//     用户点"保存并启动"想让新 config 生效，但服务正在跑——不真重启，仅
+//     调用 reloadConfigFromDisk() 刷新进程内 export let 常量。绝不能再
+//     返回"already running"挡用户路。
+//   - dashboard 模式 + service 未运行 → spawn 一个新的（旧 service 退出后场景）。
+// ---------------------------------------------------------------------------
+
+describe("chooseStartPath", () => {
+  it("setup 模式（注入 inplace hook）→ inplace（不管 PID 文件状态）", () => {
+    expect(
+      chooseStartPath({
+        hasInplaceActivateHook: true,
+        isServiceRunning: true,
+      }),
+    ).toBe("inplace");
+    expect(
+      chooseStartPath({
+        hasInplaceActivateHook: true,
+        isServiceRunning: false,
+      }),
+    ).toBe("inplace");
+  });
+
+  it("dashboard 模式 + service 已运行 → reload（仅刷新 config，不真重启）", () => {
+    expect(
+      chooseStartPath({
+        hasInplaceActivateHook: false,
+        isServiceRunning: true,
+      }),
+    ).toBe("reload");
+  });
+
+  it("dashboard 模式 + service 未运行 → spawn", () => {
+    expect(
+      chooseStartPath({
+        hasInplaceActivateHook: false,
+        isServiceRunning: false,
+      }),
+    ).toBe("spawn");
+  });
+});