clawt 3.5.3 → 3.6.1

package/tests/unit/commands/resume.test.ts

@@ -5,6 +5,16 @@ vi.mock('../../../src/logger/index.js', () => ({
   logger: { debug: vi.fn(), info: vi.fn(), warn: vi.fn(), error: vi.fn() },
 }));
 
+vi.mock('../../../src/errors/index.js', () => ({
+  ClawtError: class ClawtError extends Error {
+    exitCode: number;
+    constructor(message: string, exitCode = 1) {
+      super(message);
+      this.exitCode = exitCode;
+    }
+  },
+}));
+
 vi.mock('../../../src/constants/index.js', async (importOriginal) => {
   const actual = await importOriginal<typeof import('../../../src/constants/index.js')>();
   return {
@@ -16,6 +26,11 @@ vi.mock('../../../src/constants/index.js', async (importOriginal) => {
       RESUME_NO_MATCH: (keyword: string, branches: string[]) => `未找到匹配 "${keyword}" 的分支`,
       RESUME_ALL_CONFIRM: (count: number) => `确认恢复 ${count} 个分支？`,
       RESUME_ALL_SUCCESS: (count: number) => `已恢复 ${count} 个分支`,
+      RESUME_PROMPT_REQUIRES_BRANCH: '--prompt 必须配合 -b 指定目标分支',
+      RESUME_PROMPT_FILE_CONFLICT: '--prompt 和 -f 不能同时使用',
+      RESUME_WORKTREE_NOT_FOUND: (branch: string, available: string[]) => `未找到分支 "${branch}" 对应的 worktree`,
+      RESUME_FOLLOW_UP_FILE_LOADED: (count: number, path: string) => `从 ${path} 加载了 ${count} 个追问任务`,
+      CONCURRENCY_INFO: (concurrency: number, total: number) => `并发限制: ${concurrency}，共 ${total} 个任务`,
     },
   };
 });
@@ -29,48 +44,64 @@ vi.mock('../../../src/utils/index.js', () => ({
   hasClaudeSessionHistory: vi.fn(),
   resolveTargetWorktrees: vi.fn(),
   promptGroupedMultiSelectBranches: vi.fn(),
+  findExactMatch: vi.fn(),
   printInfo: vi.fn(),
   printSuccess: vi.fn(),
+  printWarning: vi.fn(),
   confirmAction: vi.fn(),
   getConfigValue: vi.fn(),
+  parseConcurrency: vi.fn().mockReturnValue(0),
+  loadTaskFile: vi.fn(),
+  executeBatchTasks: vi.fn().mockResolvedValue([]),
 }));
 
 import { registerResumeCommand } from '../../../src/commands/resume.js';
 import {
   runPreChecks,
-  validateClaudeCodeInstalled,
   getProjectWorktrees,
   launchInteractiveClaude,
   launchInteractiveClaudeInNewTerminal,
   hasClaudeSessionHistory,
   resolveTargetWorktrees,
   promptGroupedMultiSelectBranches,
+  findExactMatch,
   confirmAction,
   getConfigValue,
+  parseConcurrency,
+  loadTaskFile,
+  executeBatchTasks,
 } from '../../../src/utils/index.js';
 
 const mockedRunPreChecks = vi.mocked(runPreChecks);
-const mockedValidateClaudeCodeInstalled = vi.mocked(validateClaudeCodeInstalled);
 const mockedGetProjectWorktrees = vi.mocked(getProjectWorktrees);
 const mockedLaunchInteractiveClaude = vi.mocked(launchInteractiveClaude);
 const mockedLaunchInteractiveClaudeInNewTerminal = vi.mocked(launchInteractiveClaudeInNewTerminal);
 const mockedHasClaudeSessionHistory = vi.mocked(hasClaudeSessionHistory);
 const mockedResolveTargetWorktrees = vi.mocked(resolveTargetWorktrees);
 const mockedPromptGroupedMultiSelectBranches = vi.mocked(promptGroupedMultiSelectBranches);
+const mockedFindExactMatch = vi.mocked(findExactMatch);
 const mockedConfirmAction = vi.mocked(confirmAction);
 const mockedGetConfigValue = vi.mocked(getConfigValue);
+const mockedParseConcurrency = vi.mocked(parseConcurrency);
+const mockedLoadTaskFile = vi.mocked(loadTaskFile);
+const mockedExecuteBatchTasks = vi.mocked(executeBatchTasks);
 
 beforeEach(() => {
   mockedRunPreChecks.mockReset();
-  mockedValidateClaudeCodeInstalled.mockReset();
   mockedGetProjectWorktrees.mockReset();
   mockedLaunchInteractiveClaude.mockReset();
   mockedLaunchInteractiveClaudeInNewTerminal.mockReset();
   mockedHasClaudeSessionHistory.mockReset();
   mockedResolveTargetWorktrees.mockReset();
   mockedPromptGroupedMultiSelectBranches.mockReset();
+  mockedFindExactMatch.mockReset();
   mockedConfirmAction.mockReset();
   mockedGetConfigValue.mockReset();
+  mockedParseConcurrency.mockReset();
+  mockedParseConcurrency.mockReturnValue(0);
+  mockedLoadTaskFile.mockReset();
+  mockedExecuteBatchTasks.mockReset();
+  mockedExecuteBatchTasks.mockResolvedValue([]);
 });
 
 describe('registerResumeCommand', () => {
@@ -80,6 +111,16 @@ describe('registerResumeCommand', () => {
     const cmd = program.commands.find((c) => c.name() === 'resume');
     expect(cmd).toBeDefined();
   });
+
+  it('注册 --prompt、-f、-c 选项', () => {
+    const program = new Command();
+    registerResumeCommand(program);
+    const cmd = program.commands.find((c) => c.name() === 'resume');
+    const options = cmd!.options.map((o) => o.long);
+    expect(options).toContain('--prompt');
+    expect(options).toContain('--file');
+    expect(options).toContain('--concurrency');
+  });
 });
 
 describe('handleResume', () => {
@@ -226,3 +267,200 @@ describe('handleResume — resumeInPlace 配置', () => {
     expect(mockedGetConfigValue).not.toHaveBeenCalled();
   });
 });
+
+describe('handleResume — 非交互式追问', () => {
+  it('--prompt + -b 有历史会话时传 [true]', async () => {
+    const worktree = { path: '/path/feature', branch: 'feature' };
+    mockedGetProjectWorktrees.mockReturnValue([worktree]);
+    mockedFindExactMatch.mockReturnValue(worktree);
+    mockedHasClaudeSessionHistory.mockReturnValue(true);
+    mockedExecuteBatchTasks.mockResolvedValue([]);
+
+    const program = new Command();
+    program.exitOverride();
+    registerResumeCommand(program);
+    await program.parseAsync(['resume', '-b', 'feature', '--prompt', '加上单元测试'], { from: 'user' });
+
+    expect(mockedFindExactMatch).toHaveBeenCalled();
+    expect(mockedHasClaudeSessionHistory).toHaveBeenCalledWith(worktree.path);
+    // 有历史会话时使用 --continue 模式
+    expect(mockedExecuteBatchTasks).toHaveBeenCalledWith(
+      [worktree],
+      ['加上单元测试'],
+      0,
+      [true],
+    );
+    // 不应走交互式流程
+    expect(mockedResolveTargetWorktrees).not.toHaveBeenCalled();
+    expect(mockedLaunchInteractiveClaude).not.toHaveBeenCalled();
+  });
+
+  it('--prompt + -b 无历史会话时传 [false]', async () => {
+    const worktree = { path: '/path/feature', branch: 'feature' };
+    mockedGetProjectWorktrees.mockReturnValue([worktree]);
+    mockedFindExactMatch.mockReturnValue(worktree);
+    mockedHasClaudeSessionHistory.mockReturnValue(false);
+    mockedExecuteBatchTasks.mockResolvedValue([]);
+
+    const program = new Command();
+    program.exitOverride();
+    registerResumeCommand(program);
+    await program.parseAsync(['resume', '-b', 'feature', '--prompt', '加上单元测试'], { from: 'user' });
+
+    expect(mockedHasClaudeSessionHistory).toHaveBeenCalledWith(worktree.path);
+    // 无历史会话时不传 --continue
+    expect(mockedExecuteBatchTasks).toHaveBeenCalledWith(
+      [worktree],
+      ['加上单元测试'],
+      0,
+      [false],
+    );
+  });
+
+  it('--prompt 无 -b 时报错', async () => {
+    const program = new Command();
+    program.exitOverride();
+    registerResumeCommand(program);
+
+    await expect(
+      program.parseAsync(['resume', '--prompt', '加上单元测试'], { from: 'user' }),
+    ).rejects.toThrow('--prompt 必须配合 -b 指定目标分支');
+  });
+
+  it('--prompt 和 -f 同时使用时报错', async () => {
+    const program = new Command();
+    program.exitOverride();
+    registerResumeCommand(program);
+
+    await expect(
+      program.parseAsync(['resume', '-b', 'feature', '--prompt', '追问', '-f', 'tasks.md'], { from: 'user' }),
+    ).rejects.toThrow('--prompt 和 -f 不能同时使用');
+  });
+
+  it('--prompt 指定的分支不存在时报错', async () => {
+    mockedGetProjectWorktrees.mockReturnValue([
+      { path: '/path/other', branch: 'other' },
+    ]);
+    mockedFindExactMatch.mockReturnValue(undefined);
+
+    const program = new Command();
+    program.exitOverride();
+    registerResumeCommand(program);
+
+    await expect(
+      program.parseAsync(['resume', '-b', 'nonexistent', '--prompt', '追问'], { from: 'user' }),
+    ).rejects.toThrow('未找到分支');
+  });
+
+  it('-f 批量追问模式', async () => {
+    const worktrees = [
+      { path: '/path/feat-a', branch: 'feat-a' },
+      { path: '/path/feat-b', branch: 'feat-b' },
+    ];
+    mockedLoadTaskFile.mockReturnValue([
+      { branch: 'feat-a', task: '追问任务A' },
+      { branch: 'feat-b', task: '追问任务B' },
+    ]);
+    mockedGetProjectWorktrees.mockReturnValue(worktrees);
+    mockedFindExactMatch
+      .mockReturnValueOnce(worktrees[0])
+      .mockReturnValueOnce(worktrees[1]);
+    mockedHasClaudeSessionHistory.mockReturnValue(true);
+    mockedExecuteBatchTasks.mockResolvedValue([]);
+
+    const program = new Command();
+    program.exitOverride();
+    registerResumeCommand(program);
+    await program.parseAsync(['resume', '-f', 'follow-up.md'], { from: 'user' });
+
+    expect(mockedLoadTaskFile).toHaveBeenCalledWith('follow-up.md', { branchRequired: true });
+    // 按 worktree 独立检查会话历史
+    expect(mockedHasClaudeSessionHistory).toHaveBeenCalledWith('/path/feat-a');
+    expect(mockedHasClaudeSessionHistory).toHaveBeenCalledWith('/path/feat-b');
+    expect(mockedExecuteBatchTasks).toHaveBeenCalledWith(
+      worktrees,
+      ['追问任务A', '追问任务B'],
+      0,
+      [true, true],
+    );
+  });
+
+  it('-f 批量追问分支不存在时报错', async () => {
+    mockedLoadTaskFile.mockReturnValue([
+      { branch: 'nonexistent', task: '追问任务' },
+    ]);
+    mockedGetProjectWorktrees.mockReturnValue([
+      { path: '/path/feat-a', branch: 'feat-a' },
+    ]);
+    mockedFindExactMatch.mockReturnValue(undefined);
+
+    const program = new Command();
+    program.exitOverride();
+    registerResumeCommand(program);
+
+    await expect(
+      program.parseAsync(['resume', '-f', 'follow-up.md'], { from: 'user' }),
+    ).rejects.toThrow('未找到分支');
+  });
+
+  it('-f + -c 传递并发数', async () => {
+    const worktree = { path: '/path/feat-a', branch: 'feat-a' };
+    mockedLoadTaskFile.mockReturnValue([
+      { branch: 'feat-a', task: '追问' },
+    ]);
+    mockedGetProjectWorktrees.mockReturnValue([worktree]);
+    mockedFindExactMatch.mockReturnValue(worktree);
+    mockedHasClaudeSessionHistory.mockReturnValue(true);
+    mockedParseConcurrency.mockReturnValue(2);
+    mockedExecuteBatchTasks.mockResolvedValue([]);
+
+    const program = new Command();
+    program.exitOverride();
+    registerResumeCommand(program);
+    await program.parseAsync(['resume', '-f', 'follow-up.md', '-c', '2'], { from: 'user' });
+
+    expect(mockedExecuteBatchTasks).toHaveBeenCalledWith(
+      [worktree],
+      ['追问'],
+      2,
+      [true],
+    );
+  });
+
+  it('-f 批量追问按 worktree 独立检查会话历史', async () => {
+    const worktrees = [
+      { path: '/path/feat-a', branch: 'feat-a' },
+      { path: '/path/feat-b', branch: 'feat-b' },
+      { path: '/path/feat-c', branch: 'feat-c' },
+    ];
+    mockedLoadTaskFile.mockReturnValue([
+      { branch: 'feat-a', task: '任务A' },
+      { branch: 'feat-b', task: '任务B' },
+      { branch: 'feat-c', task: '任务C' },
+    ]);
+    mockedGetProjectWorktrees.mockReturnValue(worktrees);
+    mockedFindExactMatch
+      .mockReturnValueOnce(worktrees[0])
+      .mockReturnValueOnce(worktrees[1])
+      .mockReturnValueOnce(worktrees[2]);
+    // feat-a 有历史会话，feat-b 无，feat-c 有
+    mockedHasClaudeSessionHistory
+      .mockReturnValueOnce(true)
+      .mockReturnValueOnce(false)
+      .mockReturnValueOnce(true);
+    mockedExecuteBatchTasks.mockResolvedValue([]);
+
+    const program = new Command();
+    program.exitOverride();
+    registerResumeCommand(program);
+    await program.parseAsync(['resume', '-f', 'follow-up.md'], { from: 'user' });
+
+    // continueFlags 应按 worktree 独立反映各自的会话历史状态
+    expect(mockedExecuteBatchTasks).toHaveBeenCalledWith(
+      worktrees,
+      ['任务A', '任务B', '任务C'],
+      0,
+      [true, false, true],
+    );
+  });
+});

package/docs/alias.md

@@ -1,114 +0,0 @@
-### 5.15 命令别名管理
-
-**命令：**
-
-```bash
-# 列出所有命令别名
-clawt alias
-clawt alias list
-
-# 设置命令别名
-clawt alias set <alias> <command>
-
-# 移除命令别名
-clawt alias remove <alias>
-```
-
-**子命令：**
-
-| 子命令 | 说明 |
-| ------ | ---- |
-| `clawt alias` / `clawt alias list` | 列出所有已配置的命令别名 |
-| `clawt alias set <alias> <command>` | 设置命令别名，将 `<alias>` 映射到 `<command>` |
-| `clawt alias remove <alias>` | 移除指定的命令别名 |
-
-**参数：**
-
-| 参数 | 必填 | 说明 |
-| ---- | ---- | ---- |
-| `<alias>` | 是（set / remove） | 别名名称 |
-| `<command>` | 是（set） | 目标内置命令名 |
-
-**约束规则：**
-
-1. **别名不能覆盖内置命令名**：别名不能与任何已注册的内置命令同名（动态检测，当前包括 `list`、`create`、`remove`、`run`、`resume`、`validate`、`cover`、`merge`、`config`、`sync`、`reset`、`status`、`alias`、`projects`、`completion`、`init`、`home`）。如果用户尝试设置与内置命令同名的别名，输出错误提示并返回
-2. **目标必须是内置命令**：别名的目标（`<command>`）必须是已注册的内置命令名。如果指定了不存在的目标命令，输出错误提示并返回
-3. **参数透传**：通过别名调用时，所有选项和参数会完全透传给目标命令，行为与直接调用目标命令完全一致
-
-**持久化：**
-
-别名配置存储在 `~/.clawt/config.json` 的 `aliases` 字段中（类型 `Record<string, string>`，默认 `{}`）。
-
-**运行流程：**
-
-#### `alias list`（默认）
-
-1. 读取配置文件中的 `aliases` 字段
-2. 如果没有配置任何别名，输出提示 `(无别名)`
-3. 如果有别名，逐行输出所有别名映射
-
-**输出格式：**
-
-```
-当前别名列表：
-────────────────────────────────────────
-
-  l → list
-  r → run
-  v → validate
-
-────────────────────────────────────────
-```
-
-#### `alias set <alias> <command>`
-
-1. **校验别名不与内置命令冲突**：检查 `<alias>` 是否为内置命令名，是则输出错误提示并返回
-2. **校验目标命令存在**：检查 `<command>` 是否为已注册的内置命令名，不是则输出错误提示并返回
-3. 将别名写入配置文件的 `aliases` 字段（如果别名已存在，覆盖旧值）
-4. 输出成功提示
-
-**输出格式：**
-
-```
-✓ 已设置别名: l → list
-```
-
-#### `alias remove <alias>`
-
-1. 读取配置文件中的 `aliases` 字段
-2. 检查指定的别名是否存在，不存在则输出错误提示并返回
-3. 从 `aliases` 中删除该别名并写入配置文件
-4. 输出成功提示
-
-**输出格式：**
-
-```
-✓ 已移除别名: l
-```
-
-**别名使用示例：**
-
-```bash
-# 设置别名
-clawt alias set l list
-clawt alias set r run
-clawt alias set v validate
-
-# 使用别名（等同于对应的完整命令）
-clawt l          # 等同于 clawt list
-clawt r task.md  # 等同于 clawt run task.md
-
-# 查看所有别名
-clawt alias list
-
-# 移除别名
-clawt alias remove l
-```
-
-**实现要点：**
-
-- 消息常量定义在 `src/constants/messages/alias.ts`（`ALIAS_MESSAGES`），包括列表为空提示、设置/移除成功、别名不存在、与内置命令冲突、目标命令不存在等消息
-- 别名应用逻辑位于 `src/utils/alias.ts` 的 `applyAliases` 函数：在主入口 `src/index.ts` 中，所有命令注册完成后调用，遍历配置中的 `aliases` 映射，通过 Commander.js 的 `.alias()` 方法为对应命令注册别名。如果目标命令不存在则跳过并输出 warn 级别日志
-- 内置命令冲突检测通过 `getRegisteredCommandNames(program)` 动态获取所有已注册命令名，而非硬编码命令列表
-
----

package/docs/completion.md

@@ -1,55 +0,0 @@
-### 5.16 `clawt completion` 命令
-
-为终端环境（bash/zsh）生成并安装 `clawt` 的命令、选项及参数的自动补全脚本。
-
-#### 语法
-```bash
-clawt completion bash
-clawt completion zsh
-clawt completion install
-```
-
-#### 子命令说明
-
-| 子命令    | 说明                                                                                |
-| --------- | ----------------------------------------------------------------------------------- |
-| `bash`    | 输出适用于 bash 的补全脚本（用户可重定向到 `~/.bashrc`）                                |
-| `zsh`     | 输出适用于 zsh 的补全脚本（用户可重定向到 `~/.zshrc`）                                  |
-| `install` | 自动检测当前 shell 类型，将补全脚本追加到对应的配置文件中                                  |
-
-#### `install` 子命令流程
-
-1. 通过 `process.env.SHELL` 检测当前 shell 类型
-2. 根据 shell 类型确定目标配置文件：
-   - zsh → `~/.zshrc`（追加 `source <(clawt completion zsh)`）
-   - bash → `~/.bashrc`（追加 `eval "$(clawt completion bash)"`）
-3. 检查目标文件中是否已包含 `clawt completion`，已存在则跳过并提示
-4. 追加成功后提示用户重启终端或 source 配置文件
-5. 未知 shell 类型时输出警告，提示手动配置
-
-#### 动态补全特性
-
-补全脚本通过内部子命令 `_complete` 实现动态补全，不对外公开。补全引擎基于 Commander.js 的命令树结构遍历，支持以下场景：
-
-| 场景                         | 补全行为                                                   |
-| ---------------------------- | ---------------------------------------------------------- |
-| `-b` / `--branch` 参数之后   | 动态列出当前项目所有 worktree 分支名（通过 `getProjectWorktrees`） |
-| `-f` / `--file` 参数之后     | 动态列出匹配的文件和子目录（不限制文件类型，支持子目录递归浏览）    |
-| `config set` / `config get` 之后 | 动态列出所有配置项键名（从 `CONFIG_DEFINITIONS` 获取）         |
-| 输入以 `-` 开头              | 列出当前命令层级的可用选项（short/long）                       |
-| 其他情况                     | 列出当前命令层级的可用子命令及别名；若输入为空，同时列出可用选项    |
-
-**文件路径补全细节：**
-- 支持子目录递归浏览（如 `tasks/` 后继续 Tab 可深入子目录）
-- 目录候选项以 `/` 结尾，补全时不自动追加空格
-- 不限制文件类型，列出所有非隐藏文件
-- 跳过隐藏文件和目录（以 `.` 开头）
-
-#### 实现说明
-
-- 补全命令注册函数：`registerCompletionCommand()`（在 `src/commands/completion.ts`）
-- 消息常量：`COMPLETION_MESSAGES`（在 `src/constants/messages/completion.ts`）
-- 核心函数：`generateCompletions()` 解析当前输入上下文并输出候选项，`completeFilePath()` 处理文件路径补全，`tryCompleteSpecialArg()` 处理特殊参数（分支名、文件路径、配置键）的动态补全，`completeFromCommandTree()` 基于命令树遍历生成子命令和选项候选项
-- shell 脚本生成：`getBashScript()`、`getZshScript()` 分别生成对应 shell 的补全脚本
-
----

package/docs/config-file.md

@@ -1,45 +0,0 @@
-### 5.7 默认配置文件
-
-**路径：** `~/.clawt/config.json`
-
-**生成时机：** 全局安装后自动生成（通过 `postinstall` 脚本）。
-
-**升级策略：** 配置文件已存在时，执行增量合并而非简单跳过：
-
-- **新版本新增的配置项** → 使用默认值补充到用户配置中
-- **用户已有的配置项** → 保留用户的值，不覆盖
-- **新版本已移除的配置项** → 从用户配置中删除
-
-仅在合并后配置发生变化时才写入文件。配置文件损坏或无法解析时，视为不存在，重新生成默认配置。
-
-**默认内容：**
-
-```json
-{
-  "autoDeleteBranch": false,
-  "claudeCodeCommand": "claude",
-  "autoPullPush": false,
-  "confirmDestructiveOps": true,
-  "maxConcurrency": 0,
-  "terminalApp": "auto",
-  "resumeInPlace": false,
-  "aliases": {},
-  "autoUpdate": true
-}
-```
-
-**配置项说明：**
-
-| 配置项             | 类型      | 默认值    | 说明                                               |
-| ------------------ | --------- | --------- | -------------------------------------------------- |
-| `autoDeleteBranch` | `boolean` | `false`   | 移除 worktree 时是否自动删除对应本地分支（无需每次确认）；merge 成功后是否自动清理 worktree 和分支；run 任务被中断（Ctrl+C）后是否自动清理本次创建的 worktree 和分支 |
-| `claudeCodeCommand` | `string` | `"claude"` | Claude Code CLI 启动指令，用于 `clawt run` 不传 `--tasks` 时和 `clawt resume` 在 worktree 中打开交互式界面 |
-| `autoPullPush` | `boolean` | `false` | merge 成功后是否自动执行 git pull 和 git push |
-| `confirmDestructiveOps` | `boolean` | `true` | 执行破坏性操作（reset、validate --clean）前是否提示确认 |
-| `maxConcurrency` | `number` | `0` | run 命令默认最大并发数，`0` 表示不限制 |
-| `terminalApp` | `string` | `"auto"` | 批量 resume 使用的终端应用：`auto`（自动检测）、`iterm2`、`terminal`（macOS） |
-| `resumeInPlace` | `boolean` | `false` | resume 单选时是否在当前终端就地打开，`false` 则通过 `terminalApp` 在新 Tab 中打开 |
-| `aliases` | `Record<string, string>` | `{}` | 命令别名映射，键为别名，值为目标内置命令名 |
-| `autoUpdate` | `boolean` | `true` | 是否启用自动更新检查（每 24 小时通过 npm registry 检查一次新版本） |
-
----

package/docs/config.md

@@ -1,93 +0,0 @@
-### 5.10 交互式查看和修改全局配置
-
-**命令：**
-
-```bash
-# 交互式修改配置（等同于 config set 无参数）
-clawt config
-
-# 修改配置项（无参数进入交互式，有参数直接设置）
-clawt config set [key] [value]
-
-# 获取单个配置项的值
-clawt config get <key>
-
-# 将配置恢复为默认值
-clawt config reset
-```
-
-#### 交互式修改配置（`config` / `config set`）
-
-直接执行 `clawt config` 或 `clawt config set`（不带参数）进入交互式配置修改模式。
-
-**运行流程：**
-
-1. 读取全局配置文件 `~/.clawt/config.json`
-2. 列出所有配置项供用户选择（`Enquirer.Select`），每项显示：
-   - 配置项名称
-   - 当前值（布尔值绿色/黄色，字符串和数字青色）
-   - 配置项描述（暗淡色 dim）
-   - 对象类型配置项（如 `aliases`）标灰不可选，提示用户通过专用命令管理
-3. 用户选择某个配置项后，根据值类型自动选择提示策略：
-   - **boolean 类型** → `Select`（true / false）
-   - **number 类型** → `Input`（带数字校验）
-   - **string 类型 + 有 `allowedValues`** → `Select`（枚举列表）
-   - **string 类型 + 无 `allowedValues`** → `Input`（自由输入）
-4. 将修改后的配置持久化到配置文件
-5. 输出成功提示：`✓ <key> 已设置为 <value>`
-
-#### 直接设置配置项（`config set <key> <value>`）
-
-当带参数执行 `clawt config set <key> <value>` 时，直接修改指定配置项。
-
-**参数：**
-
-| 参数 | 必填 | 说明 |
-| ---- | ---- | ---- |
-| `key` | 否 | 配置项名称（不传则进入交互式模式） |
-| `value` | 否 | 配置值（传了 `key` 时必填） |
-
-**运行流程：**
-
-1. 校验 `key` 是否为有效的配置项名称（基于 `DEFAULT_CONFIG` 的键列表），无效则输出错误及可用配置项列表
-2. 校验 `value` 是否缺失，缺失则提示：`缺少配置值，用法: clawt config set <key> <value>`
-3. 根据目标配置项的类型解析并校验值：
-   - **boolean** → 仅接受 `true` 或 `false`
-   - **number** → `Number()` 解析，`NaN` 报错
-   - **string + 有 `allowedValues`** → 校验值是否在枚举列表中
-   - **string + 无 `allowedValues`** → 无额外校验
-4. 加载配置、修改目标项、持久化
-5. 输出成功提示：`✓ <key> 已设置为 <value>`
-
-#### 获取单个配置项（`config get <key>`）
-
-**参数：**
-
-| 参数 | 必填 | 说明 |
-| ---- | ---- | ---- |
-| `key` | 是 | 配置项名称 |
-
-**运行流程：**
-
-1. 校验 `key` 是否为有效的配置项名称，无效则输出错误及可用配置项列表
-2. 读取配置文件，获取目标配置项的值
-3. 输出：`<key> = <value>`
-
-#### 恢复默认配置（`config reset`）
-
-**运行流程：**
-
-1. 始终提示确认（显示即将执行的操作和后果：当前配置将被覆盖为默认值），不受 `confirmDestructiveOps` 配置控制。用户取消则退出
-2. 将默认配置写入 `~/.clawt/config.json`（覆盖现有配置文件）
-3. 输出成功提示：`✓ 配置已恢复为默认值`
-
-**实现要点：**
-
-- 配置项类型定义：`ConfigItemDefinition` 新增可选字段 `allowedValues`（`readonly string[]`），仅对 string 类型有效，用于枚举值校验和交互式 Select 提示
-- 值解析与提示策略：`src/utils/config-strategy.ts` 中的 `parseConfigValue()`（CLI 字符串解析）和 `promptConfigValue()`（交互式提示），基于类型和 `allowedValues` 自动分发
-- 交互式配置编辑：`handleInteractiveConfigSet` 调用通用的 `interactiveConfigEditor`（`src/utils/config-strategy.ts`），传入 `CONFIG_DEFINITIONS` 和 `disabledKeys`（对象类型配置项禁用映射），不再在 config 命令中直接构建选择列表和调用 `promptConfigValue`
-- `saveConfig(config)`：`src/utils/config.ts` 中的通用配置写入函数，将完整配置对象持久化到文件
-- `formatConfigValue(value)`：支持 boolean（绿色/黄色）和 string/number（青色）的格式化显示。`undefined` / `null` 值显示为暗淡色的 `(未设置)`
-- 对象类型配置项（如 `aliases`）的显示逻辑在 `interactiveConfigEditor` 的列表构建中处理：通过 `JSON.stringify` 以暗淡色显示值，并标记为不可选（disabled），提示用户通过 `clawt alias` 命令管理
-
----