clawt 3.9.13 → 3.10.0

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';