clawt 2.7.2 → 2.7.3

package/README.md

@@ -246,7 +246,7 @@ clawt list [--json]
 | ---- | ---- | ---- |
 | `--json` | 否 | 以 JSON 格式输出（仅包含 path 和 branch） |
 
-列出当前项目在 `~/.clawt/worktrees/` 下的所有 worktree 及对应分支。指定 `--json` 时以 JSON 格式输出，便于脚本解析。
+列出当前项目在 `~/.clawt/worktrees/` 下的所有 worktree 及对应分支。文本模式下，如果某个 worktree 处于空闲状态（0 个提交、无变更、无未提交修改），其路径会以橙色高亮显示，方便快速识别可能需要清理或还未开始工作的 worktree。指定 `--json` 时以 JSON 格式输出，便于脚本解析。
 
 ```bash
 # 文本格式输出（默认）

package/dist/index.js

@@ -499,6 +499,9 @@ function confirmDestructiveAction(dangerousCommand, description) {
   printWarning(`\u5373\u5C06\u6267\u884C ${chalk.red.bold(dangerousCommand)}\uFF0C${description}`);
   return confirmAction("\u662F\u5426\u7EE7\u7EED\uFF1F");
 }
+function isWorktreeIdle(status) {
+  return status.commitCount === 0 && status.insertions === 0 && status.deletions === 0 && !status.hasDirtyFiles;
+}
 function formatWorktreeStatus(status) {
   const parts = [];
   parts.push(chalk.yellow(`${status.commitCount} \u4E2A\u63D0\u4EA4`));
@@ -854,8 +857,10 @@ function printListAsText(projectName, worktrees) {
     printInfo(`  ${MESSAGES.NO_WORKTREES}`);
   } else {
     for (const wt of worktrees) {
-      printInfo(`  ${wt.path}   [${wt.branch}]`);
       const status = getWorktreeStatus(wt);
+      const isIdle = status ? isWorktreeIdle(status) : false;
+      const pathDisplay = isIdle ? chalk2.hex("#FF8C00")(wt.path) : wt.path;
+      printInfo(`  ${pathDisplay}   [${wt.branch}]`);
       if (status) {
         printInfo(`    ${formatWorktreeStatus(status)}`);
       } else {

package/docs/spec.md

@@ -806,6 +806,8 @@ clawt list [--json]
 
 **文本输出格式（默认）：**
 
+每个 worktree 会显示路径、分支名和变更状态。如果某个 worktree 处于空闲状态（0 个提交、无变更、无未提交修改），其路径会以橙色高亮显示，方便用户快速识别可能需要清理或还未开始工作的 worktree。
+
 ```
 当前项目: main-project
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawt",
-  "version": "2.7.2",
+  "version": "2.7.3",
   "description": "本地并行执行多个Claude Code Agent任务，融合 Git Worktree 与 Claude Code CLI 的命令行工具",
   "type": "module",
   "main": "dist/index.js",

package/src/commands/list.ts

@@ -9,6 +9,7 @@ import {
   getProjectWorktrees,
   getWorktreeStatus,
   formatWorktreeStatus,
+  isWorktreeIdle,
   printInfo,
 } from '../utils/index.js';
 // getWorktreeStatus 和 formatWorktreeStatus 仅在文本模式下使用
@@ -77,10 +78,15 @@ function printListAsText(projectName: string, worktrees: import('../types/index.
     printInfo(`  ${MESSAGES.NO_WORKTREES}`);
   } else {
     for (const wt of worktrees) {
-      printInfo(`  ${wt.path}   [${wt.branch}]`);
-
       // 获取并展示 worktree 变更状态
       const status = getWorktreeStatus(wt);
+
+      // 空闲状态的 worktree 路径用橙色高亮，提示用户关注
+      const isIdle = status ? isWorktreeIdle(status) : false;
+      const pathDisplay = isIdle ? chalk.hex('#FF8C00')(wt.path) : wt.path;
+
+      printInfo(`  ${pathDisplay}   [${wt.branch}]`);
+
       if (status) {
         printInfo(`    ${formatWorktreeStatus(status)}`);
       } else {

package/src/utils/formatter.ts

@@ -78,6 +78,18 @@ export function confirmDestructiveAction(dangerousCommand: string, description:
   return confirmAction('是否继续？');
 }
 
+/**
+ * 判断 worktree 是否处于空闲状态（0 个提交、无变更、无未提交修改）
+ * @param {WorktreeStatus} status - worktree 变更统计信息
+ * @returns {boolean} 是否空闲
+ */
+export function isWorktreeIdle(status: WorktreeStatus): boolean {
+  return status.commitCount === 0
+    && status.insertions === 0
+    && status.deletions === 0
+    && !status.hasDirtyFiles;
+}
+
 /**
  * 将 WorktreeStatus 格式化为带颜色的字符串
  * @param {WorktreeStatus} status - worktree 变更统计信息

package/src/utils/index.ts

@@ -47,8 +47,8 @@ export {
 export { sanitizeBranchName, generateBranchNames, validateBranchesNotExist } from './branch.js';
 export { validateMainWorktree, validateGitInstalled, validateClaudeCodeInstalled } from './validation.js';
 export { createWorktrees, getProjectWorktrees, getProjectWorktreeDir, cleanupWorktrees, getWorktreeStatus } from './worktree.js';
-export { loadConfig, getConfigValue, ensureClawtDirs, writeDefaultConfig } from './config.js';
-export { printSuccess, printError, printWarning, printInfo, printSeparator, printDoubleSeparator, confirmAction, confirmDestructiveAction, formatWorktreeStatus } from './formatter.js';
+export { loadConfig, writeDefaultConfig, getConfigValue, ensureClawtDirs } from './config.js';
+export { printSuccess, printError, printWarning, printInfo, printSeparator, printDoubleSeparator, confirmAction, confirmDestructiveAction, formatWorktreeStatus, isWorktreeIdle } from './formatter.js';
 export { ensureDir, removeEmptyDir } from './fs.js';
 export { multilineInput } from './prompt.js';
 export { launchInteractiveClaude } from './claude.js';