clawt 3.9.12 → 3.10.0

package/tests/unit/utils/interactive-panel.test.ts

@@ -0,0 +1,191 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+
+// mock 所有依赖，避免真实 git 命令执行
+vi.mock('../../../src/constants/index.js', () => ({
+  CURSOR_HIDE: '',
+  CURSOR_SHOW: '',
+  LINE_WRAP_DISABLE: '',
+  LINE_WRAP_ENABLE: '',
+  SYNC_OUTPUT_START: '',
+  SYNC_OUTPUT_END: '',
+  ALT_SCREEN_ENTER: '',
+  ALT_SCREEN_LEAVE: '',
+  CLEAR_SCREEN: '',
+  CURSOR_HOME: '',
+  DEFAULT_TERMINAL_COLUMNS: 80,
+  PANEL_REFRESH_INTERVAL_MS: 5000,
+  PANEL_COUNTDOWN_INTERVAL_MS: 1000,
+  KEY_ARROW_UP: '\x1b[A',
+  KEY_ARROW_DOWN: '\x1b[B',
+  KEY_CTRL_C: 3,
+  PANEL_SHORTCUT_KEYS: {
+    VALIDATE: 'v',
+    MERGE: 'm',
+    DELETE: 'd',
+    RESUME: 'r',
+    SYNC: 's',
+    COVER: 'c',
+    REFRESH: 'f',
+    QUIT: 'q',
+  },
+}));
+
+vi.mock('../../../src/constants/messages/index.js', () => ({
+  PANEL_NOT_TTY: 'not tty',
+  PANEL_PRESS_ENTER_TO_RETURN: 'press enter',
+}));
+
+vi.mock('../../../src/utils/shell.js', () => ({
+  runCommandInherited: vi.fn(),
+}));
+
+vi.mock('../../../src/utils/interactive-panel-render.js', () => ({
+  buildPanelFrame: vi.fn(() => ['line1', 'line2']),
+  renderFooter: vi.fn(() => 'footer'),
+}));
+
+vi.mock('../../../src/utils/progress-render.js', () => ({
+  truncateToTerminalWidth: vi.fn((s: string) => s),
+}));
+
+vi.mock('../../../src/utils/keyboard-controller.js', () => ({
+  KeyboardController: vi.fn(function () {
+    return {
+      start: vi.fn(),
+      stop: vi.fn(),
+    };
+  }),
+}));
+
+vi.mock('../../../src/utils/interactive-panel-state.js', () => ({
+  PanelStateManager: vi.fn(function () {
+    return {
+      updateData: vi.fn(),
+      getStatusResult: vi.fn(() => ({ main: {}, worktrees: [], snapshots: {}, totalWorktrees: 0 })),
+      getSelectedOriginalIndex: vi.fn(() => 0),
+      getSelectedBranch: vi.fn(() => 'feat-test'),
+      getScrollOffset: vi.fn(() => 0),
+      getCachedPanelLines: vi.fn(() => []),
+      adjustScrollForSelection: vi.fn(),
+      navigateUp: vi.fn(() => false),
+      navigateDown: vi.fn(() => false),
+    };
+  }),
+}));
+
+vi.mock('../../../src/logger/index.js', () => ({
+  logger: { debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() },
+}));
+
+import { InteractivePanel } from '../../../src/utils/interactive-panel.js';
+import type { StatusResult } from '../../../src/types/index.js';
+
+/**
+ * 构造最小可用的 StatusResult mock
+ */
+function makeStatusResult(): StatusResult {
+  return {
+    main: {
+      branch: 'main',
+      isClean: true,
+      projectName: 'test-project',
+      configuredMainBranch: 'main',
+      configuredBranchExists: true,
+      insertions: 0,
+      deletions: 0,
+    },
+    worktrees: [],
+    snapshots: { total: 0, orphaned: 0 },
+    totalWorktrees: 0,
+  };
+}
+
+describe('InteractivePanel.executeOperation()', () => {
+  let panel: InteractivePanel;
+  let collectStatusMock: ReturnType<typeof vi.fn>;
+  let renderSpy: ReturnType<typeof vi.spyOn>;
+  let refreshDataSpy: ReturnType<typeof vi.spyOn>;
+
+  beforeEach(() => {
+    // 模拟 TTY 环境
+    Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+    Object.defineProperty(process.stdout, 'columns', { value: 80, configurable: true });
+    Object.defineProperty(process.stdout, 'rows', { value: 24, configurable: true });
+    vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+
+    collectStatusMock = vi.fn().mockResolvedValue(makeStatusResult());
+    panel = new InteractivePanel(collectStatusMock);
+
+    // 监视 render 和 refreshData，记录调用顺序
+    renderSpy = vi.spyOn(panel as any, 'render');
+    refreshDataSpy = vi.spyOn(panel as any, 'refreshData').mockResolvedValue(undefined);
+  });
+
+  it('应在 refreshData 之前调用一次 render（立即渲染旧数据消除白屏）', async () => {
+    const callOrder: string[] = [];
+    renderSpy.mockImplementation(() => { callOrder.push('render'); });
+    refreshDataSpy.mockImplementation(async () => { callOrder.push('refreshData'); });
+
+    // 直接调用私有方法 executeOperation
+    const action = vi.fn();
+    // 绕过 waitForEnter，直接 resolve
+    vi.spyOn(panel as any, 'waitForEnter').mockResolvedValue(undefined);
+    vi.spyOn(panel as any, 'initTerminal').mockImplementation(() => {});
+    vi.spyOn(panel as any, 'restoreTerminal').mockImplementation(() => {});
+    vi.spyOn(panel as any, 'removeTerminalListeners').mockImplementation(() => {});
+    vi.spyOn(panel as any, 'startAutoRefresh').mockImplementation(() => {});
+    vi.spyOn(panel as any, 'clearTimers').mockImplementation(() => {});
+
+    // stateManager.getStatusResult() 需要返回非 null 才能让 render 不被 guard 拦截
+    // executeOperation 顶部也检查 statusResult 非 null
+    await (panel as any).executeOperation(action);
+
+    // render 必须在 refreshData 之前被调用至少一次
+    const firstRenderIdx = callOrder.indexOf('render');
+    const refreshDataIdx = callOrder.indexOf('refreshData');
+    expect(firstRenderIdx).toBeGreaterThanOrEqual(0);
+    expect(refreshDataIdx).toBeGreaterThanOrEqual(0);
+    expect(firstRenderIdx).toBeLessThan(refreshDataIdx);
+  });
+
+  it('应在 refreshData 之后再调用一次 render（刷新为最新数据）', async () => {
+    const callOrder: string[] = [];
+    renderSpy.mockImplementation(() => { callOrder.push('render'); });
+    refreshDataSpy.mockImplementation(async () => { callOrder.push('refreshData'); });
+
+    vi.spyOn(panel as any, 'waitForEnter').mockResolvedValue(undefined);
+    vi.spyOn(panel as any, 'initTerminal').mockImplementation(() => {});
+    vi.spyOn(panel as any, 'restoreTerminal').mockImplementation(() => {});
+    vi.spyOn(panel as any, 'removeTerminalListeners').mockImplementation(() => {});
+    vi.spyOn(panel as any, 'startAutoRefresh').mockImplementation(() => {});
+    vi.spyOn(panel as any, 'clearTimers').mockImplementation(() => {});
+
+    await (panel as any).executeOperation(vi.fn());
+
+    // refreshData 之后必须还有一次 render
+    const refreshDataIdx = callOrder.lastIndexOf('refreshData');
+    const lastRenderIdx = callOrder.lastIndexOf('render');
+    expect(lastRenderIdx).toBeGreaterThan(refreshDataIdx);
+  });
+
+  it('isOperating 应在 render 之前被设为 false', async () => {
+    const isOperatingAtRender: boolean[] = [];
+
+    renderSpy.mockImplementation(() => {
+      isOperatingAtRender.push((panel as any).isOperating);
+    });
+    refreshDataSpy.mockResolvedValue(undefined);
+
+    vi.spyOn(panel as any, 'waitForEnter').mockResolvedValue(undefined);
+    vi.spyOn(panel as any, 'initTerminal').mockImplementation(() => {});
+    vi.spyOn(panel as any, 'restoreTerminal').mockImplementation(() => {});
+    vi.spyOn(panel as any, 'removeTerminalListeners').mockImplementation(() => {});
+    vi.spyOn(panel as any, 'startAutoRefresh').mockImplementation(() => {});
+    vi.spyOn(panel as any, 'clearTimers').mockImplementation(() => {});
+
+    await (panel as any).executeOperation(vi.fn());
+
+    // 第一次 render 调用时 isOperating 必须为 false
+    expect(isOperatingAtRender[0]).toBe(false);
+  });
+});

package/tests/unit/utils/progress.test.ts

@@ -1,4 +1,25 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+
+// mock i18n 模块，使 getCurrentLanguage 返回 'en' 以匹配英文断言
+// 同时重写 createMessages 使其直接选择 'en' 分支，确保 constants 模块加载时生成英文消息
+vi.mock('../../../src/utils/i18n.js', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('../../../src/utils/i18n.js')>();
+  return {
+    ...actual,
+    getCurrentLanguage: vi.fn().mockReturnValue('en'),
+    resetLanguageCache: vi.fn(),
+    createMessages: <T extends Record<string, { en: any; 'zh-CN': any }>>(
+      i18nMap: T,
+    ) => {
+      const result: any = {};
+      for (const key of Object.keys(i18nMap)) {
+        result[key] = i18nMap[key]['en'];
+      }
+      return result;
+    },
+  };
+});
+
 import { ProgressRenderer } from '../../../src/utils/progress.js';
 
 describe('ProgressRenderer', () => {
@@ -66,7 +87,7 @@ describe('ProgressRenderer', () => {
       // 第二列应显示路径
       expect(allOutput).toContain('/path/feat-1');
       expect(allOutput).toContain('/path/feat-2');
-      expect(allOutput).toContain('运行中');
+      expect(allOutput).toContain('Running');
       // running 状态下不显示额外路径信息
 
       renderer.stop();
@@ -82,7 +103,7 @@ describe('ProgressRenderer', () => {
 
       const allOutput = writeSpy.mock.calls.map((c) => c[0]).join('');
       expect(allOutput).toContain('✓');
-      expect(allOutput).toContain('完成');
+      expect(allOutput).toContain('Done');
       expect(allOutput).toContain('5.0s');
       expect(allOutput).toContain('$0.05');
       // 第二列显示路径
@@ -101,7 +122,7 @@ describe('ProgressRenderer', () => {
 
       const allOutput = writeSpy.mock.calls.map((c) => c[0]).join('');
       expect(allOutput).toContain('✓');
-      expect(allOutput).toContain('完成');
+      expect(allOutput).toContain('Done');
       expect(allOutput).toContain('5.0s');
       expect(allOutput).toContain('$0.05');
       // 第二列仍显示路径
@@ -118,7 +139,7 @@ describe('ProgressRenderer', () => {
 
       const allOutput = writeSpy.mock.calls.map((c) => c[0]).join('');
       expect(allOutput).toContain('✗');
-      expect(allOutput).toContain('失败');
+      expect(allOutput).toContain('Failed');
       expect(allOutput).toContain('3.0s');
       // 第二列显示路径
       expect(allOutput).toContain('/path/feat-1');
@@ -136,7 +157,7 @@ describe('ProgressRenderer', () => {
 
       const allOutput = writeSpy.mock.calls.map((c) => c[0]).join('');
       expect(allOutput).toContain('✗');
-      expect(allOutput).toContain('失败');
+      expect(allOutput).toContain('Failed');
       expect(allOutput).toContain('3.0s');
       // 第二列仍显示路径
       expect(allOutput).toContain('/path/feat-1');
@@ -161,7 +182,7 @@ describe('ProgressRenderer', () => {
 
       const allOutput = writeSpy.mock.calls.map((c) => c[0]).join('');
       expect(allOutput).toContain('◦');
-      expect(allOutput).toContain('排队中');
+      expect(allOutput).toContain('Pending');
 
       renderer.stop();
     });
@@ -175,9 +196,9 @@ describe('ProgressRenderer', () => {
       renderer.stop();
 
       const allOutput = writeSpy.mock.calls.map((c) => c[0]).join('');
-      expect(allOutput).toContain('运行中');
+      expect(allOutput).toContain('Running');
       // 第二个任务仍为排队中
-      expect(allOutput).toContain('排队中');
+      expect(allOutput).toContain('Pending');
     });
 
     it('allRunning=false 时面板包含汇总行', () => {
@@ -187,7 +208,7 @@ describe('ProgressRenderer', () => {
       const allOutput = writeSpy.mock.calls.map((c) => c[0]).join('');
       // 汇总行应包含排队中的计数
       expect(allOutput).toContain('3/3');
-      expect(allOutput).toContain('排队中');
+      expect(allOutput).toContain('Pending');
 
       renderer.stop();
     });
@@ -230,7 +251,7 @@ describe('ProgressRenderer', () => {
       const allOutput = writeSpy.mock.calls.map((c) => c[0]).join('');
       // 第二列显示路径
       expect(allOutput).toContain('/path/feat-1');
-      expect(allOutput).toContain('运行中');
+      expect(allOutput).toContain('Running');
     });
 
     it('任务完成后活动文本不再显示', () => {
@@ -269,7 +290,7 @@ describe('ProgressRenderer', () => {
       const allOutput = writeSpy.mock.calls.map((c) => c[0]).join('');
       // pending 状态第二列应显示路径，末尾无额外路径
       expect(allOutput).toContain('/path/feat-1');
-      expect(allOutput).toContain('排队中');
+      expect(allOutput).toContain('Pending');
 
       renderer.stop();
     });
@@ -336,7 +357,7 @@ describe('ProgressRenderer', () => {
 
       expect(logSpy).toHaveBeenCalledTimes(2);
       expect(logSpy.mock.calls[0][0]).toContain('feat-1');
-      expect(logSpy.mock.calls[0][0]).toContain('启动');
+      expect(logSpy.mock.calls[0][0]).toContain('started');
       expect(logSpy.mock.calls[1][0]).toContain('feat-2');
 
       renderer.stop();
@@ -351,7 +372,7 @@ describe('ProgressRenderer', () => {
 
       expect(logSpy).toHaveBeenCalledTimes(1);
       expect(logSpy.mock.calls[0][0]).toContain('✓');
-      expect(logSpy.mock.calls[0][0]).toContain('完成');
+      expect(logSpy.mock.calls[0][0]).toContain('done');
       expect(logSpy.mock.calls[0][0]).toContain('5.0s');
       expect(logSpy.mock.calls[0][0]).toContain('$0.05');
       // 末尾显示结果预览
@@ -369,7 +390,7 @@ describe('ProgressRenderer', () => {
 
       expect(logSpy).toHaveBeenCalledTimes(1);
       expect(logSpy.mock.calls[0][0]).toContain('✓');
-      expect(logSpy.mock.calls[0][0]).toContain('完成');
+      expect(logSpy.mock.calls[0][0]).toContain('done');
       // 无 resultPreview 时回退到 path
       expect(logSpy.mock.calls[0][0]).toContain('/path/feat-1');
 
@@ -385,7 +406,7 @@ describe('ProgressRenderer', () => {
 
       expect(logSpy).toHaveBeenCalledTimes(1);
       expect(logSpy.mock.calls[0][0]).toContain('✗');
-      expect(logSpy.mock.calls[0][0]).toContain('失败');
+      expect(logSpy.mock.calls[0][0]).toContain('failed');
       expect(logSpy.mock.calls[0][0]).toContain('3.0s');
       // 末尾显示结果预览
       expect(logSpy.mock.calls[0][0]).toContain('执行过程中发生错误');
@@ -402,7 +423,7 @@ describe('ProgressRenderer', () => {
 
       expect(logSpy).toHaveBeenCalledTimes(1);
       expect(logSpy.mock.calls[0][0]).toContain('✗');
-      expect(logSpy.mock.calls[0][0]).toContain('失败');
+      expect(logSpy.mock.calls[0][0]).toContain('failed');
       expect(logSpy.mock.calls[0][0]).toContain('3.0s');
       // 无 resultPreview 时回退到 path
       expect(logSpy.mock.calls[0][0]).toContain('/path/feat-1');
@@ -438,7 +459,7 @@ describe('ProgressRenderer', () => {
 
       expect(logSpy).toHaveBeenCalledTimes(1);
       expect(logSpy.mock.calls[0][0]).toContain('feat-1');
-      expect(logSpy.mock.calls[0][0]).toContain('启动');
+      expect(logSpy.mock.calls[0][0]).toContain('started');
 
       renderer.stop();
     });
@@ -528,7 +549,7 @@ describe('ProgressRenderer', () => {
       // ALT_SCREEN_LEAVE 之后应有面板最终状态输出
       const afterLeave = allCalls.slice(leaveIndex + 1).join('');
       expect(afterLeave).toContain('✓');
-      expect(afterLeave).toContain('完成');
+      expect(afterLeave).toContain('Done');
       expect(afterLeave).toContain('/path/feat-1');
       expect(afterLeave).toContain('代码审查完成');
     });

package/tests/unit/utils/prompt.test.ts

@@ -1,5 +1,28 @@
 import { describe, it, expect, vi } from 'vitest';
 
+// mock i18n 模块，使 getCurrentLanguage 返回 'en' 以匹配英文断言
+// 需要同时提供 createMessages 的真实实现，以便 constants 模块加载时能正确生成英文消息
+vi.mock('../../../src/utils/i18n.js', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('../../../src/utils/i18n.js')>();
+  // 在 createMessages 调用前就 mock getCurrentLanguage
+  const mockGetCurrentLanguage = vi.fn().mockReturnValue('en');
+  return {
+    ...actual,
+    getCurrentLanguage: mockGetCurrentLanguage,
+    resetLanguageCache: vi.fn(),
+    // 重写 createMessages 使其使用 mock 的 getCurrentLanguage
+    createMessages: <T extends Record<string, { en: any; 'zh-CN': any }>>(
+      i18nMap: T,
+    ) => {
+      const result: any = {};
+      for (const key of Object.keys(i18nMap)) {
+        result[key] = i18nMap[key]['en'];
+      }
+      return result;
+    },
+  };
+});
+
 // mock 非交互模式判断函数
 const { mockIsNonInteractive } = vi.hoisted(() => {
   return { mockIsNonInteractive: vi.fn().mockReturnValue(false) };
@@ -95,7 +118,7 @@ describe('promptCommitMessage', () => {
 
     await expect(
       promptCommitMessage('请输入提交信息', '非交互模式错误'),
-    ).rejects.toThrow('提交信息不能为空');
+    ).rejects.toThrow('Commit message cannot be empty');
   });
 
   it('用户输入仅空白字符时抛出 ClawtError', async () => {
@@ -104,7 +127,7 @@ describe('promptCommitMessage', () => {
 
     await expect(
       promptCommitMessage('请输入提交信息', '非交互模式错误'),
-    ).rejects.toThrow('提交信息不能为空');
+    ).rejects.toThrow('Commit message cannot be empty');
   });
 
   it('返回 trim 后的用户输入', async () => {

package/tests/unit/utils/task-file.test.ts

@@ -1,5 +1,4 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { parseTaskFile, loadTaskFile, parseTasksFromOptions } from '../../../src/utils/task-file.js';
 import { existsSync, readFileSync } from 'node:fs';
 
 vi.mock('node:fs', () => ({
@@ -7,6 +6,25 @@ vi.mock('node:fs', () => ({
   readFileSync: vi.fn(),
 }));
 
+vi.mock('../../../src/logger/index.js', () => ({
+  logger: { debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() },
+}));
+
+// mock i18n 模块，避免循环依赖导致 currentLanguage 未初始化
+// 返回 'zh-CN' 以匹配测试中的中文断言
+vi.mock('../../../src/utils/i18n.js', () => ({
+  getCurrentLanguage: vi.fn().mockReturnValue('zh-CN'),
+  resetLanguageCache: vi.fn(),
+  setCurrentLanguage: vi.fn(),
+  createMessages: vi.fn((i18nMap: Record<string, { en: any; 'zh-CN': any }>) => {
+    const result: any = {};
+    for (const key of Object.keys(i18nMap)) {
+      result[key] = i18nMap[key]['zh-CN'];
+    }
+    return result;
+  }),
+}));
+
 vi.mock('../../../src/errors/index.js', () => ({
   ClawtError: class ClawtError extends Error {
     exitCode: number;
@@ -17,15 +35,60 @@ vi.mock('../../../src/errors/index.js', () => ({
   },
 }));
 
-vi.mock('../../../src/constants/index.js', () => ({
-  MESSAGES: {
-    TASK_FILE_NOT_FOUND: (path: string) => `任务文件不存在: ${path}`,
-    TASK_FILE_EMPTY: '任务文件中没有解析到有效任务',
-    TASK_FILE_MISSING_BRANCH: (blockIndex: number) => `第 ${blockIndex} 个任务块缺少分支名`,
-    TASK_FILE_MISSING_TASK: (branch: string) => `分支 ${branch} 缺少任务描述`,
-    TASK_FILE_MISSING_TASK_BY_INDEX: (blockIndex: number) => `第 ${blockIndex} 个任务块缺少任务描述`,
-  },
-}));
+// mock constants/index.js，使用固定的中文 mock 来匹配测试断言中的中文错误消息
+// 同时保留必要的路径常量导出（避免 logger 等模块加载时报错）
+vi.mock('../../../src/constants/index.js', async (importOriginal) => {
+  // 仅从 paths.js 获取路径常量，不触发 messages 模块加载
+  const { CLAWT_HOME, CONFIG_PATH, LOGS_DIR, WORKTREES_DIR, VALIDATE_SNAPSHOTS_DIR, CLAUDE_PROJECTS_DIR, UPDATE_CHECK_PATH, PROJECTS_CONFIG_DIR } = await import('../../../src/constants/paths.js');
+  const { INVALID_BRANCH_CHARS, VALIDATE_BRANCH_PREFIX } = await import('../../../src/constants/branch.js');
+  const { EXIT_CODES } = await import('../../../src/constants/exitCodes.js');
+  const { VALID_TERMINAL_APPS, ITERM2_APP_PATH, ENABLE_BRACKETED_PASTE, DISABLE_BRACKETED_PASTE, PASTE_THRESHOLD_MS } = await import('../../../src/constants/terminal.js');
+  return {
+    CLAWT_HOME,
+    CONFIG_PATH,
+    LOGS_DIR,
+    WORKTREES_DIR,
+    VALIDATE_SNAPSHOTS_DIR,
+    CLAUDE_PROJECTS_DIR,
+    UPDATE_CHECK_PATH,
+    PROJECTS_CONFIG_DIR,
+    INVALID_BRANCH_CHARS,
+    VALIDATE_BRANCH_PREFIX,
+    EXIT_CODES,
+    VALID_TERMINAL_APPS,
+    ITERM2_APP_PATH,
+    ENABLE_BRACKETED_PASTE,
+    DISABLE_BRACKETED_PASTE,
+    PASTE_THRESHOLD_MS,
+    // 使用固定的中文 mock MESSAGES
+    MESSAGES: {
+      TASK_FILE_NOT_FOUND: (path: string) => `任务文件不存在: ${path}`,
+      TASK_FILE_EMPTY: '任务文件中没有解析到有效任务',
+      TASK_FILE_MISSING_BRANCH: (blockIndex: number) => `第 ${blockIndex} 个任务块缺少分支名`,
+      TASK_FILE_MISSING_TASK: (branch: string) => `分支 ${branch} 缺少任务描述`,
+      TASK_FILE_MISSING_TASK_BY_INDEX: (blockIndex: number) => `第 ${blockIndex} 个任务块缺少任务描述`,
+    },
+    // 其他测试不需要的导出设为空对象或空字符串
+    DEFAULT_CONFIG: {},
+    CONFIG_DESCRIPTIONS: {},
+    CONFIG_DEFINITIONS: {},
+    CLAUDE_CODE_ENTRYPOINT_VALUE: 'cli',
+    getI18nConfigDescriptions: vi.fn(),
+    AUTO_SAVE_COMMIT_MESSAGE_PREFIX: '[clawt-auto-save]',
+    DEBUG_LOG_PREFIX: '[clawt]',
+    DEBUG_TIMESTAMP_FORMAT: 'YYYY-MM-DD HH:mm:ss',
+    UPDATE_CHECK_INTERVAL_MS: 86400000,
+    NPM_REGISTRY_URL: 'https://registry.npmjs.org',
+    NPM_REGISTRY_TIMEOUT_MS: 5000,
+    PACKAGE_NAME: 'clawt',
+    CONFLICT_RESOLVE_PROMPT: '',
+    CONFIG_ALIAS_DISABLED_HINT: '',
+    UPDATE_MESSAGES: {},
+    UPDATE_COMMANDS: {},
+  };
+});
+
+import { parseTaskFile, loadTaskFile, parseTasksFromOptions } from '../../../src/utils/task-file.js';
 
 const mockedExistsSync = vi.mocked(existsSync);
 const mockedReadFileSync = vi.mocked(readFileSync);

package/tests/unit/utils/terminal-cmux.test.ts

@@ -20,6 +20,21 @@ vi.mock('../../../src/utils/config.js', () => ({
   getConfigValue: vi.fn(),
 }));
 
+// mock i18n 模块，避免循环依赖导致 currentLanguage 未初始化
+// 返回 'en' 以匹配测试中的英文断言
+vi.mock('../../../src/utils/i18n.js', () => ({
+  getCurrentLanguage: vi.fn().mockReturnValue('en'),
+  resetLanguageCache: vi.fn(),
+  setCurrentLanguage: vi.fn(),
+  createMessages: vi.fn((i18nMap: Record<string, { en: any; 'zh-CN': any }>) => {
+    const result: any = {};
+    for (const key of Object.keys(i18nMap)) {
+      result[key] = i18nMap[key]['en'];
+    }
+    return result;
+  }),
+}));
+
 import { execFileSync } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import {
@@ -180,7 +195,7 @@ describe('cmux surface 创建', () => {
     mockedGetConfigValue.mockReturnValue('cmux');
 
     expect(() => openCommandInNewTerminalTab('claude', 'test-title')).toThrow(
-      /当前不在 cmux 环境中/
+      /Not currently in a cmux environment/
     );
   });
 
@@ -192,7 +207,7 @@ describe('cmux surface 创建', () => {
     mockedExecFileSync.mockReturnValueOnce('invalid output format');
 
     expect(() => openCommandInNewTerminalTab('claude', 'test-title')).toThrow(
-      /无法解析 cmux new-split 输出/
+      /Failed to parse cmux new-split output/
     );
   });
 
@@ -207,7 +222,7 @@ describe('cmux surface 创建', () => {
     });
 
     expect(() => openCommandInNewTerminalTab('claude', 'test-title')).toThrow(
-      /在 cmux 中创建 surface 失败/
+      /Failed to create surface in cmux/
     );
   });
 
@@ -215,7 +230,7 @@ describe('cmux surface 创建', () => {
     Object.defineProperty(process, 'platform', { value: 'linux' });
 
     expect(() => openCommandInNewTerminalTab('claude', 'test-title')).toThrow(
-      /仅支持 macOS 平台/
+      /Batch resume is only supported on macOS/
     );
   });
 });

package/tests/unit/utils/update-checker.test.ts

@@ -6,6 +6,8 @@ import { EventEmitter } from 'node:events';
 vi.mock('node:fs', () => ({
   readFileSync: vi.fn(),
   writeFileSync: vi.fn(),
+  existsSync: vi.fn().mockReturnValue(false),
+  mkdirSync: vi.fn(),
 }));
 
 // mock node:child_process

package/tests/unit/utils/validate-branch.test.ts

@@ -1,5 +1,25 @@
 import { describe, it, expect, vi, beforeEach } from 'vitest';
 
+// mock i18n 模块，使 getCurrentLanguage 返回 'zh-CN' 以匹配中文断言
+// 同时重写 createMessages 使其直接选择 'zh-CN' 分支，确保 constants 模块加载时生成中文消息
+vi.mock('../../../src/utils/i18n.js', async (importOriginal) => {
+  const actual = await importOriginal<typeof import('../../../src/utils/i18n.js')>();
+  return {
+    ...actual,
+    getCurrentLanguage: vi.fn().mockReturnValue('zh-CN'),
+    resetLanguageCache: vi.fn(),
+    createMessages: <T extends Record<string, { en: any; 'zh-CN': any }>>(
+      i18nMap: T,
+    ) => {
+      const result: any = {};
+      for (const key of Object.keys(i18nMap)) {
+        result[key] = i18nMap[key]['zh-CN'];
+      }
+      return result;
+    },
+  };
+});
+
 // mock logger
 vi.mock('../../../src/logger/index.js', () => ({
   logger: { debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() },
@@ -16,13 +36,18 @@ vi.mock('../../../src/errors/index.js', () => ({
   },
 }));
 
-// mock constants
+// mock constants（补充 handleDirtyWorkingDir 和 ensureOnMainWorkBranch 使用的消息键）
 vi.mock('../../../src/constants/index.js', () => ({
   VALIDATE_BRANCH_PREFIX: 'clawt-validate-',
   MESSAGES: {
     GUARD_BRANCH_MISMATCH: (mainBranch: string, currentBranch: string) =>
       `当前分支 ${currentBranch} 与配置的主工作分支 ${mainBranch} 不一致`,
     DESTRUCTIVE_OP_CANCELLED: '已取消操作',
+    WORKSPACE_STILL_DIRTY: '工作区仍然不干净，请手动处理',
+    USER_CHOSE_EXIT: '用户选择退出，请手动处理工作区更改后重试',
+    UNCOMMITTED_CHANGES_ON_BRANCH: '当前分支有未提交的更改，请选择处理方式：\n',
+    SELECT_ACTION: '选择处理方式',
+    CONFIRM_CONTINUE_VALIDATE: '是否继续执行？',
   },
 }));
 

package/tests/unit/utils/validation.test.ts

@@ -45,13 +45,13 @@ describe('validateMainWorktree', () => {
     mockedIsInsideGitRepo.mockReturnValue(true);
     mockedGetGitCommonDir.mockReturnValue('/path/to/.git');
     expect(() => validateMainWorktree()).toThrow(ClawtError);
-    expect(() => validateMainWorktree()).toThrow('请在主 worktree 的根目录下执行 clawt');
+    expect(() => validateMainWorktree()).toThrow('Please run clawt in the root directory of the main worktree');
   });
 
   it('不在 git 仓库中时抛出 NOT_GIT_REPO 错误', () => {
     mockedIsInsideGitRepo.mockReturnValue(false);
     expect(() => validateMainWorktree()).toThrow(ClawtError);
-    expect(() => validateMainWorktree()).toThrow('当前目录不是 git 仓库');
+    expect(() => validateMainWorktree()).toThrow('Current directory is not a git repository');
   });
 });
 

package/tests/unit/utils/worktree-matcher.test.ts

@@ -25,6 +25,8 @@ vi.mock('../../../src/utils/git.js', () => ({
 // mock node:fs 的 statSync，分组测试中按需控制返回值
 vi.mock('node:fs', () => ({
   statSync: vi.fn().mockReturnValue({ birthtime: new Date('2026-02-27T10:00:00') }),
+  existsSync: vi.fn().mockReturnValue(false),
+  mkdirSync: vi.fn(),
 }));
 
 import { statSync } from 'node:fs';