clawt 2.16.1 → 2.16.3

package/README.md

@@ -123,11 +123,18 @@ clawt validate -b <branch>                    # 将变更迁移到主 worktree
 clawt validate -b <branch> --clean             # 清理 validate 状态
 clawt validate -b <branch> -r "npm test"       # validate 成功后自动运行测试
 clawt validate -b <branch> -r "npm run build"  # validate 成功后自动构建
+clawt validate -b <branch> -r "pnpm test & pnpm build"  # 并行执行多个命令
 ```
 
 支持增量模式：再次 validate 同一分支时，可通过 `git diff` 查看两次之间的增量差异。
 
-`-r, --run` 选项可在 validate 成功后自动在主 worktree 中执行指定命令（如测试、构建等），命令执行失败不影响 validate 结果。
+`-r, --run` 选项可在 validate 成功后自动在主 worktree 中执行指定命令（如测试、构建等），命令执行失败不影响 validate 结果。支持用 `&` 分隔多个命令并行执行：
+
+| 用法 | 行为 |
+| ---- | ---- |
+| `-r "npm test"` | 单命令，同步执行 |
+| `-r "npm lint && npm test"` | `&&` 不拆分，同步执行 |
+| `-r "pnpm test & pnpm build"` | 并行执行，等全部完成后汇总结果 |
 
 ### `clawt sync` — 同步主分支代码到目标 worktree
 
@@ -164,6 +171,39 @@ clawt status          # 文本格式
 clawt status --json   # JSON 格式
 ```
 
+展示主 worktree 状态、各 worktree 的变更详情（含分支创建时间和验证状态）以及 validate 快照摘要：
+
+```
+════════════════════════════════════════
+  项目状态总览: my-project
+════════════════════════════════════════
+
+  ◆ 主 Worktree
+    分支: main
+    状态: ✓ 干净
+
+────────────────────────────────────────
+
+  ◆ Worktree 列表 (2 个)
+
+  ● feature-login   [已提交]
+    +120 -30   3 个本地提交   与主分支同步
+    创建于 3 天前
+    上次验证: 2 小时前
+
+  ● feature-signup   [未提交修改]
+    +45 -10   1 个本地提交   落后主分支 2 个提交
+    创建于 1 天前
+    ✗ 未验证
+
+────────────────────────────────────────
+
+  ◆ Validate 快照 (3 个)
+    其中 1 个快照对应的 worktree 已不存在
+
+════════════════════════════════════════
+```
+
 ### `clawt reset` — 重置主 worktree 到干净状态
 
 ```bash

package/dist/index.js

@@ -197,7 +197,21 @@ ${branches.map((b) => `    - ${b}`).join("\n")}`,
   /** --run 命令执行失败（退出码非 0） */
   VALIDATE_RUN_FAILED: (command, exitCode) => `\u2717 \u547D\u4EE4\u6267\u884C\u5B8C\u6210: ${command}\uFF0C\u9000\u51FA\u7801: ${exitCode}`,
   /** --run 命令执行异常（进程启动失败等） */
-  VALIDATE_RUN_ERROR: (command, errorMessage) => `\u2717 \u547D\u4EE4\u6267\u884C\u51FA\u9519: ${errorMessage}`
+  VALIDATE_RUN_ERROR: (command, errorMessage) => `\u2717 \u547D\u4EE4\u6267\u884C\u51FA\u9519: ${errorMessage}`,
+  /** 并行命令开始执行提示 */
+  VALIDATE_PARALLEL_RUN_START: (count) => `\u6B63\u5728\u5E76\u884C\u6267\u884C ${count} \u4E2A\u547D\u4EE4...`,
+  /** 并行执行中单个命令开始提示（带序号） */
+  VALIDATE_PARALLEL_CMD_START: (index, total, command) => `[${index}/${total}] ${command}`,
+  /** 并行执行全部成功汇总提示 */
+  VALIDATE_PARALLEL_RUN_ALL_SUCCESS: (count) => `\u2713 \u5168\u90E8 ${count} \u4E2A\u547D\u4EE4\u6267\u884C\u6210\u529F`,
+  /** 并行执行部分失败汇总提示 */
+  VALIDATE_PARALLEL_RUN_SUMMARY: (successCount, failedCount) => `\u5171 ${successCount + failedCount} \u4E2A\u547D\u4EE4\uFF0C${successCount} \u4E2A\u6210\u529F\uFF0C${failedCount} \u4E2A\u5931\u8D25`,
+  /** 并行执行中单个命令成功 */
+  VALIDATE_PARALLEL_CMD_SUCCESS: (command) => `  \u2713 ${command}`,
+  /** 并行执行中单个命令失败 */
+  VALIDATE_PARALLEL_CMD_FAILED: (command, exitCode) => `  \u2717 ${command}\uFF08\u9000\u51FA\u7801: ${exitCode}\uFF09`,
+  /** 并行执行中单个命令启动失败 */
+  VALIDATE_PARALLEL_CMD_ERROR: (command, errorMessage) => `  \u2717 ${command}\uFF08\u9519\u8BEF: ${errorMessage}\uFF09`
 };
 
 // src/constants/messages/sync.ts
@@ -309,7 +323,7 @@ var STATUS_MESSAGES = {
   /** status worktrees 区块标题 */
   STATUS_WORKTREES_SECTION: "Worktree \u5217\u8868",
   /** status 快照区块标题 */
-  STATUS_SNAPSHOTS_SECTION: "\u672A\u6E05\u7406\u7684 Validate \u5FEB\u7167",
+  STATUS_SNAPSHOTS_SECTION: "Validate \u5FEB\u7167",
   /** status 无 worktree */
   STATUS_NO_WORKTREES: "(\u65E0\u6D3B\u8DC3 worktree)",
   /** status 无未清理快照 */
@@ -323,7 +337,15 @@ var STATUS_MESSAGES = {
   /** status 变更状态：无变更 */
   STATUS_CHANGE_CLEAN: "\u65E0\u53D8\u66F4",
   /** status 快照对应 worktree 已不存在 */
-  STATUS_SNAPSHOT_ORPHANED: "(\u5BF9\u5E94 worktree \u5DF2\u4E0D\u5B58\u5728)"
+  STATUS_SNAPSHOT_ORPHANED: (count) => `\u5176\u4E2D ${count} \u4E2A\u5FEB\u7167\u5BF9\u5E94\u7684 worktree \u5DF2\u4E0D\u5B58\u5728`,
+  /** status 分支创建时间标签 */
+  STATUS_CREATED_AT: (relativeTime) => `\u521B\u5EFA\u4E8E ${relativeTime}`,
+  /** status 分支无分叉提交时的提示 */
+  STATUS_NO_DIVERGED_COMMITS: "\u5C1A\u65E0\u5206\u53C9\u63D0\u4EA4",
+  /** status 上次验证时间标签 */
+  STATUS_LAST_VALIDATED: (relativeTime) => `\u4E0A\u6B21\u9A8C\u8BC1: ${relativeTime}`,
+  /** status 未验证警示 */
+  STATUS_NOT_VALIDATED: "\u2717 \u672A\u9A8C\u8BC1"
 };
 
 // src/constants/messages/alias.ts
@@ -573,6 +595,31 @@ function runCommandInherited(command, options) {
     shell: true
   });
 }
+function parseParallelCommands(commandString) {
+  const placeholder = "\0AND\0";
+  const escaped = commandString.replace(/&&/g, placeholder);
+  const parts = escaped.split("&");
+  return parts.map((part) => part.replace(new RegExp(placeholder, "g"), "&&").trim()).filter((part) => part.length > 0);
+}
+function runParallelCommands(commands, options) {
+  const promises = commands.map((command) => {
+    return new Promise((resolve2) => {
+      logger.debug(`\u5E76\u884C\u542F\u52A8\u547D\u4EE4: ${command}${options?.cwd ? ` (cwd: ${options.cwd})` : ""}`);
+      const child = spawn(command, {
+        cwd: options?.cwd,
+        stdio: "inherit",
+        shell: true
+      });
+      child.on("error", (err) => {
+        resolve2({ command, exitCode: 1, error: err.message });
+      });
+      child.on("close", (code) => {
+        resolve2({ command, exitCode: code ?? 1 });
+      });
+    });
+  });
+  return Promise.all(promises);
+}
 
 // src/utils/git.ts
 import { basename } from "path";
@@ -748,6 +795,17 @@ function gitApplyCachedCheck(patchContent, cwd) {
     return false;
   }
 }
+function getBranchCreatedAt(branchName, cwd) {
+  try {
+    const output = execCommand(`git reflog show ${branchName} --format=%cI`, { cwd });
+    if (!output.trim()) return null;
+    const lines = output.trim().split("\n");
+    const lastLine = lines[lines.length - 1];
+    return lastLine || null;
+  } catch {
+    return null;
+  }
+}
 
 // src/utils/formatter.ts
 import chalk2 from "chalk";
@@ -817,6 +875,35 @@ function formatDuration(ms) {
   const seconds = Math.floor(totalSeconds % 60);
   return `${minutes}m${String(seconds).padStart(2, "0")}s`;
 }
+function formatRelativeTime(isoDateString) {
+  const date = new Date(isoDateString);
+  const now = /* @__PURE__ */ new Date();
+  const diffMs = now.getTime() - date.getTime();
+  if (isNaN(diffMs)) {
+    return null;
+  }
+  if (diffMs < 0 || diffMs < 60 * 1e3) {
+    return "\u521A\u521A";
+  }
+  const diffMinutes = Math.floor(diffMs / (1e3 * 60));
+  const diffHours = Math.floor(diffMs / (1e3 * 60 * 60));
+  const diffDays = Math.floor(diffMs / (1e3 * 60 * 60 * 24));
+  if (diffHours < 1) {
+    return `${diffMinutes} \u5206\u949F\u524D`;
+  }
+  if (diffDays < 1) {
+    return `${diffHours} \u5C0F\u65F6\u524D`;
+  }
+  if (diffDays < 30) {
+    return `${diffDays} \u5929\u524D`;
+  }
+  if (diffDays < 365) {
+    const months = Math.floor(diffDays / 30);
+    return `${months} \u4E2A\u6708\u524D`;
+  }
+  const years = Math.floor(diffDays / 365);
+  return `${years} \u5E74\u524D`;
+}
 
 // src/utils/branch.ts
 function sanitizeBranchName(branchName) {
@@ -1160,7 +1247,7 @@ function launchInteractiveClaudeInNewTerminal(worktree, hasPreviousSession) {
 
 // src/utils/validate-snapshot.ts
 import { join as join4 } from "path";
-import { existsSync as existsSync7, readFileSync as readFileSync2, writeFileSync as writeFileSync2, unlinkSync, readdirSync as readdirSync4, rmdirSync as rmdirSync2 } from "fs";
+import { existsSync as existsSync7, readFileSync as readFileSync2, writeFileSync as writeFileSync2, unlinkSync, readdirSync as readdirSync4, rmdirSync as rmdirSync2, statSync } from "fs";
 function getSnapshotPath(projectName, branchName) {
   return join4(VALIDATE_SNAPSHOTS_DIR, projectName, `${branchName}.tree`);
 }
@@ -1170,6 +1257,12 @@ function getSnapshotHeadPath(projectName, branchName) {
 function hasSnapshot(projectName, branchName) {
   return existsSync7(getSnapshotPath(projectName, branchName));
 }
+function getSnapshotModifiedTime(projectName, branchName) {
+  const snapshotPath = getSnapshotPath(projectName, branchName);
+  if (!existsSync7(snapshotPath)) return null;
+  const stat = statSync(snapshotPath);
+  return stat.mtime.toISOString();
+}
 function readSnapshot(projectName, branchName) {
   const snapshotPath = getSnapshotPath(projectName, branchName);
   const headPath = getSnapshotHeadPath(projectName, branchName);
@@ -2392,8 +2485,7 @@ function handleIncrementalValidate(targetWorktreePath, mainWorktreePath, project
   }
   printSuccess(MESSAGES.INCREMENTAL_VALIDATE_SUCCESS(branchName));
 }
-function executeRunCommand(command, mainWorktreePath) {
-  printInfo("");
+function executeSingleCommand(command, mainWorktreePath) {
   printInfo(MESSAGES.VALIDATE_RUN_START(command));
   printSeparator();
   const result = runCommandInherited(command, { cwd: mainWorktreePath });
@@ -2409,6 +2501,43 @@ function executeRunCommand(command, mainWorktreePath) {
     printError(MESSAGES.VALIDATE_RUN_FAILED(command, exitCode));
   }
 }
+function reportParallelResults(results) {
+  printSeparator();
+  const successCount = results.filter((r) => r.exitCode === 0 && !r.error).length;
+  const failedCount = results.length - successCount;
+  for (const result of results) {
+    if (result.error) {
+      printError(MESSAGES.VALIDATE_PARALLEL_CMD_ERROR(result.command, result.error));
+    } else if (result.exitCode === 0) {
+      printSuccess(MESSAGES.VALIDATE_PARALLEL_CMD_SUCCESS(result.command));
+    } else {
+      printError(MESSAGES.VALIDATE_PARALLEL_CMD_FAILED(result.command, result.exitCode));
+    }
+  }
+  if (failedCount === 0) {
+    printSuccess(MESSAGES.VALIDATE_PARALLEL_RUN_ALL_SUCCESS(results.length));
+  } else {
+    printError(MESSAGES.VALIDATE_PARALLEL_RUN_SUMMARY(successCount, failedCount));
+  }
+}
+async function executeParallelCommands(commands, mainWorktreePath) {
+  printInfo(MESSAGES.VALIDATE_PARALLEL_RUN_START(commands.length));
+  for (let i = 0; i < commands.length; i++) {
+    printInfo(MESSAGES.VALIDATE_PARALLEL_CMD_START(i + 1, commands.length, commands[i]));
+  }
+  printSeparator();
+  const results = await runParallelCommands(commands, { cwd: mainWorktreePath });
+  reportParallelResults(results);
+}
+async function executeRunCommand(command, mainWorktreePath) {
+  printInfo("");
+  const commands = parseParallelCommands(command);
+  if (commands.length <= 1) {
+    executeSingleCommand(commands[0] || command, mainWorktreePath);
+  } else {
+    await executeParallelCommands(commands, mainWorktreePath);
+  }
+}
 async function handleValidate(options) {
   if (options.clean) {
     await handleValidateClean(options);
@@ -2441,7 +2570,7 @@ async function handleValidate(options) {
     handleFirstValidate(targetWorktreePath, mainWorktreePath, projectName, branchName, hasUncommitted);
   }
   if (options.run) {
-    executeRunCommand(options.run, mainWorktreePath);
+    await executeRunCommand(options.run, mainWorktreePath);
   }
 }
 
@@ -2774,15 +2903,17 @@ function collectWorktreeDetailedStatus(worktree, projectName) {
   const changeStatus = detectChangeStatus(worktree);
   const { commitsAhead, commitsBehind } = countCommitDivergence(worktree.branch);
   const { insertions, deletions } = countDiffStat(worktree.path);
+  const createdAt = resolveBranchCreatedAt(worktree.branch);
   return {
     path: worktree.path,
     branch: worktree.branch,
     changeStatus,
     commitsAhead,
     commitsBehind,
-    hasSnapshot: hasSnapshot(projectName, worktree.branch),
+    snapshotTime: resolveSnapshotTime(projectName, worktree.branch),
     insertions,
-    deletions
+    deletions,
+    createdAt
   };
 }
 function detectChangeStatus(worktree) {
@@ -2818,13 +2949,28 @@ function countDiffStat(worktreePath) {
     return { insertions: 0, deletions: 0 };
   }
 }
+function resolveBranchCreatedAt(branchName) {
+  try {
+    return getBranchCreatedAt(branchName);
+  } catch {
+    return null;
+  }
+}
+function resolveSnapshotTime(projectName, branchName) {
+  try {
+    return getSnapshotModifiedTime(projectName, branchName);
+  } catch {
+    return null;
+  }
+}
 function collectSnapshots(projectName, worktrees) {
   const snapshotBranches = getProjectSnapshotBranches(projectName);
   const worktreeBranchSet = new Set(worktrees.map((wt) => wt.branch));
-  return snapshotBranches.map((branch) => ({
-    branch,
-    worktreeExists: worktreeBranchSet.has(branch)
-  }));
+  const orphaned = snapshotBranches.filter((branch) => !worktreeBranchSet.has(branch)).length;
+  return {
+    total: snapshotBranches.length,
+    orphaned
+  };
 }
 function printStatusAsJson(result) {
   console.log(JSON.stringify(result, null, 2));
@@ -2867,21 +3013,30 @@ function printWorktreesSection(worktrees, total) {
 function printWorktreeItem(wt) {
   const statusLabel = formatChangeStatusLabel(wt.changeStatus);
   printInfo(`  ${chalk8.bold("\u25CF")} ${chalk8.bold(wt.branch)}   [${statusLabel}]`);
-  const parts = [];
   if (wt.insertions > 0 || wt.deletions > 0) {
-    parts.push(`${chalk8.green(`+${wt.insertions}`)} ${chalk8.red(`-${wt.deletions}`)}`);
+    printInfo(`    ${chalk8.green(`+${wt.insertions}`)} ${chalk8.red(`-${wt.deletions}`)}`);
   }
   if (wt.commitsAhead > 0) {
-    parts.push(chalk8.yellow(`${wt.commitsAhead} \u4E2A\u672C\u5730\u63D0\u4EA4`));
+    printInfo(`    ${chalk8.yellow(`${wt.commitsAhead} \u4E2A\u672C\u5730\u63D0\u4EA4`)}`);
   }
   if (wt.commitsBehind > 0) {
-    parts.push(chalk8.yellow(`\u843D\u540E\u4E3B\u5206\u652F ${wt.commitsBehind} \u4E2A\u63D0\u4EA4`));
+    printInfo(`    ${chalk8.yellow(`\u843D\u540E\u4E3B\u5206\u652F ${wt.commitsBehind} \u4E2A\u63D0\u4EA4`)}`);
   } else {
-    parts.push(chalk8.green("\u4E0E\u4E3B\u5206\u652F\u540C\u6B65"));
+    printInfo(`    ${chalk8.green("\u4E0E\u4E3B\u5206\u652F\u540C\u6B65")}`);
+  }
+  if (wt.createdAt) {
+    const relativeTime = formatRelativeTime(wt.createdAt);
+    if (relativeTime) {
+      printInfo(`    ${chalk8.gray(MESSAGES.STATUS_CREATED_AT(relativeTime))}`);
+    }
   }
-  printInfo(`    ${parts.join("   ")}`);
-  if (wt.hasSnapshot) {
-    printInfo(`    ${chalk8.blue("\u6709 validate \u5FEB\u7167")}`);
+  if (wt.snapshotTime) {
+    const relativeTime = formatRelativeTime(wt.snapshotTime);
+    if (relativeTime) {
+      printInfo(`    ${chalk8.green(MESSAGES.STATUS_LAST_VALIDATED(relativeTime))}`);
+    }
+  } else {
+    printInfo(`    ${chalk8.red(MESSAGES.STATUS_NOT_VALIDATED)}`);
   }
   printInfo("");
 }
@@ -2898,17 +3053,9 @@ function formatChangeStatusLabel(status) {
   }
 }
 function printSnapshotsSection(snapshots) {
-  printInfo(`  ${chalk8.bold("\u25C6")} ${chalk8.bold(MESSAGES.STATUS_SNAPSHOTS_SECTION)} (${snapshots.length} \u4E2A)`);
-  printInfo("");
-  if (snapshots.length === 0) {
-    printInfo(`    ${MESSAGES.STATUS_NO_SNAPSHOTS}`);
-    printInfo("");
-    return;
-  }
-  for (const snap of snapshots) {
-    const orphanLabel = snap.worktreeExists ? "" : `  ${chalk8.yellow(MESSAGES.STATUS_SNAPSHOT_ORPHANED)}`;
-    const icon = snap.worktreeExists ? chalk8.blue("\u25CF") : chalk8.yellow("\u26A0");
-    printInfo(`  ${icon} ${snap.branch}${orphanLabel}`);
+  printInfo(`  ${chalk8.bold("\u25C6")} ${chalk8.bold(MESSAGES.STATUS_SNAPSHOTS_SECTION)} (${snapshots.total} \u4E2A)`);
+  if (snapshots.orphaned > 0) {
+    printInfo(`    ${chalk8.yellow(MESSAGES.STATUS_SNAPSHOT_ORPHANED(snapshots.orphaned))}`);
   }
   printInfo("");
 }

package/dist/postinstall.js

@@ -189,7 +189,21 @@ ${branches.map((b) => `    - ${b}`).join("\n")}`,
   /** --run 命令执行失败（退出码非 0） */
   VALIDATE_RUN_FAILED: (command, exitCode) => `\u2717 \u547D\u4EE4\u6267\u884C\u5B8C\u6210: ${command}\uFF0C\u9000\u51FA\u7801: ${exitCode}`,
   /** --run 命令执行异常（进程启动失败等） */
-  VALIDATE_RUN_ERROR: (command, errorMessage) => `\u2717 \u547D\u4EE4\u6267\u884C\u51FA\u9519: ${errorMessage}`
+  VALIDATE_RUN_ERROR: (command, errorMessage) => `\u2717 \u547D\u4EE4\u6267\u884C\u51FA\u9519: ${errorMessage}`,
+  /** 并行命令开始执行提示 */
+  VALIDATE_PARALLEL_RUN_START: (count) => `\u6B63\u5728\u5E76\u884C\u6267\u884C ${count} \u4E2A\u547D\u4EE4...`,
+  /** 并行执行中单个命令开始提示（带序号） */
+  VALIDATE_PARALLEL_CMD_START: (index, total, command) => `[${index}/${total}] ${command}`,
+  /** 并行执行全部成功汇总提示 */
+  VALIDATE_PARALLEL_RUN_ALL_SUCCESS: (count) => `\u2713 \u5168\u90E8 ${count} \u4E2A\u547D\u4EE4\u6267\u884C\u6210\u529F`,
+  /** 并行执行部分失败汇总提示 */
+  VALIDATE_PARALLEL_RUN_SUMMARY: (successCount, failedCount) => `\u5171 ${successCount + failedCount} \u4E2A\u547D\u4EE4\uFF0C${successCount} \u4E2A\u6210\u529F\uFF0C${failedCount} \u4E2A\u5931\u8D25`,
+  /** 并行执行中单个命令成功 */
+  VALIDATE_PARALLEL_CMD_SUCCESS: (command) => `  \u2713 ${command}`,
+  /** 并行执行中单个命令失败 */
+  VALIDATE_PARALLEL_CMD_FAILED: (command, exitCode) => `  \u2717 ${command}\uFF08\u9000\u51FA\u7801: ${exitCode}\uFF09`,
+  /** 并行执行中单个命令启动失败 */
+  VALIDATE_PARALLEL_CMD_ERROR: (command, errorMessage) => `  \u2717 ${command}\uFF08\u9519\u8BEF: ${errorMessage}\uFF09`
 };
 
 // src/constants/messages/sync.ts
@@ -300,7 +314,7 @@ var STATUS_MESSAGES = {
   /** status worktrees 区块标题 */
   STATUS_WORKTREES_SECTION: "Worktree \u5217\u8868",
   /** status 快照区块标题 */
-  STATUS_SNAPSHOTS_SECTION: "\u672A\u6E05\u7406\u7684 Validate \u5FEB\u7167",
+  STATUS_SNAPSHOTS_SECTION: "Validate \u5FEB\u7167",
   /** status 无 worktree */
   STATUS_NO_WORKTREES: "(\u65E0\u6D3B\u8DC3 worktree)",
   /** status 无未清理快照 */
@@ -314,7 +328,15 @@ var STATUS_MESSAGES = {
   /** status 变更状态：无变更 */
   STATUS_CHANGE_CLEAN: "\u65E0\u53D8\u66F4",
   /** status 快照对应 worktree 已不存在 */
-  STATUS_SNAPSHOT_ORPHANED: "(\u5BF9\u5E94 worktree \u5DF2\u4E0D\u5B58\u5728)"
+  STATUS_SNAPSHOT_ORPHANED: (count) => `\u5176\u4E2D ${count} \u4E2A\u5FEB\u7167\u5BF9\u5E94\u7684 worktree \u5DF2\u4E0D\u5B58\u5728`,
+  /** status 分支创建时间标签 */
+  STATUS_CREATED_AT: (relativeTime) => `\u521B\u5EFA\u4E8E ${relativeTime}`,
+  /** status 分支无分叉提交时的提示 */
+  STATUS_NO_DIVERGED_COMMITS: "\u5C1A\u65E0\u5206\u53C9\u63D0\u4EA4",
+  /** status 上次验证时间标签 */
+  STATUS_LAST_VALIDATED: (relativeTime) => `\u4E0A\u6B21\u9A8C\u8BC1: ${relativeTime}`,
+  /** status 未验证警示 */
+  STATUS_NOT_VALIDATED: "\u2717 \u672A\u9A8C\u8BC1"
 };
 
 // src/constants/messages/alias.ts

package/docs/spec.md

@@ -603,40 +603,104 @@ git restore --staged .
 如果用户传入了 `-r, --run` 选项，在 validate 成功后自动在主 worktree 中执行指定命令：
 
 ```bash
-# 示例
+# 示例：单命令
 clawt validate -b feature-scheme-1 -r "npm test"
+
+# 示例：并行执行多个命令（& 为并行分隔符）
+clawt validate -b feature-scheme-1 -r "pnpm test & pnpm build"
 ```
 
 **执行说明：**
 
-- 命令通过 `spawnSync` + `inherit` stdio 模式在主 worktree 中执行，输出实时显示在终端
 - 命令执行失败（退出码非 0 或进程启动失败）**不影响** validate 本身的结果，仅输出提示信息
 - `--clean` 模式下传入 `--run` 会被忽略（只执行 clean 逻辑）
 
+**命令解析规则：**
+
+`-r` 选项支持通过 `&` 将多个命令并行执行。解析由 `parseParallelCommands()`（`src/utils/shell.ts`）负责：
+
+1. 先将命令字符串中的 `&&` 临时替换为占位符，避免被误拆
+2. 按单个 `&` 分割为多个独立命令
+3. 还原占位符为 `&&`，去除首尾空白，过滤空串
+
+| 输入示例 | 解析结果 | 执行方式 |
+| -------- | -------- | -------- |
+| `"npm test"` | `["npm test"]` | 单命令，同步执行（`spawnSync` + `inherit`） |
+| `"npm lint && npm test"` | `["npm lint && npm test"]` | 单命令（`&&` 不拆分），同步执行 |
+| `"npm test & npm build"` | `["npm test", "npm build"]` | 并行执行（`spawn` + `Promise.all`） |
+| `"npm lint && npm test & npm build"` | `["npm lint && npm test", "npm build"]` | 并行执行 2 个命令 |
+
+**单命令执行：**
+
+当解析后只有 1 个命令时，通过 `spawnSync` + `inherit` stdio 模式同步执行，输出实时显示在终端。
+
+**并行命令执行：**
+
+当解析后有多个命令时，通过 `runParallelCommands()`（`src/utils/shell.ts`）执行：
+
+- 每个命令通过 Node.js `spawn` 以 shell 模式启动，`stdio: 'inherit'`
+- 使用 `Promise.all` 等待全部命令完成
+- 完成后汇总输出各命令的执行结果
+
+**向后兼容性：**
+
+- `-r "npm test"` — 单命令，走原有同步路径，行为无变化
+- `-r "npm lint && npm test"` — `&&` 不拆分，走原有同步路径，行为无变化
+- `-r "npm test & npm build"` — **新行为**：并行执行，等全部完成后汇总
+
 **输出格式：**
 
 ```
-# 命令执行成功
+# 单命令执行成功
 正在主 worktree 中执行命令: npm test
 ────────────────────────────────────────
 ... 命令的实时输出 ...
 ────────────────────────────────────────
 ✓ 命令执行完成: npm test，退出码: 0
 
-# 命令执行失败（退出码非 0）
+# 单命令执行失败（退出码非 0）
 正在主 worktree 中执行命令: npm test
 ────────────────────────────────────────
 ... 命令的实时输出 ...
 ────────────────────────────────────────
 ✗ 命令执行完成: npm test，退出码: 1
 
-# 命令执行出错（进程启动失败）
+# 单命令执行出错（进程启动失败）
 正在主 worktree 中执行命令: nonexistent
 ────────────────────────────────────────
 ────────────────────────────────────────
 ✗ 命令执行出错: spawn ENOENT
+
+# 并行命令执行（全部成功）
+正在并行执行 2 个命令...
+[1/2] pnpm test
+[2/2] pnpm build
+────────────────────────────────────────
+... 各命令的实时输出（交错显示） ...
+────────────────────────────────────────
+  ✓ pnpm test
+  ✓ pnpm build
+✓ 全部 2 个命令执行成功
+
+# 并行命令执行（部分失败）
+正在并行执行 2 个命令...
+[1/2] pnpm test
+[2/2] pnpm build
+────────────────────────────────────────
+... 各命令的实时输出（交错显示） ...
+────────────────────────────────────────
+  ✗ pnpm test（退出码: 1）
+  ✓ pnpm build
+共 2 个命令，1 个成功，1 个失败
 ```
 
+**实现要点：**
+
+- 命令解析：`parseParallelCommands()`（`src/utils/shell.ts`）
+- 并行执行：`runParallelCommands()`（`src/utils/shell.ts`），返回 `ParallelCommandResult[]`
+- 结果汇总：`reportParallelResults()`（`src/commands/validate.ts`）
+- 消息常量：`MESSAGES.VALIDATE_PARALLEL_*` 系列（`src/constants/messages/validate.ts`）
+
 #### 增量 validate（存在历史快照）
 
 当 `~/.clawt/validate-snapshots/<project>/<branchName>.tree` 存在时，自动进入增量模式：
@@ -1367,7 +1431,7 @@ clawt status [--json]
 
 **使用场景：**
 
-在管理多个 worktree 时，快速了解项目全局状态：主 worktree 当前分支及干净状态、所有 worktree 的变更情况和与主分支的同步状态、未清理的 validate 快照。
+在管理多个 worktree 时，快速了解项目全局状态：主 worktree 当前分支及干净状态、所有 worktree 的变更情况和与主分支的同步状态、validate 快照摘要。
 
 **运行流程：**
 
@@ -1382,17 +1446,18 @@ clawt status [--json]
      - **变更状态**（优先级：合并冲突 > 未提交修改 > 已提交 > 无变更）
      - **行数差异**（新增/删除行数，通过 `getDiffStat()` 获取）
      - **提交差异**（相对于主分支的领先提交数 `getCommitCountAhead()` 和落后提交数 `getCommitCountBehind()`）
-     - **快照状态**（是否存在 validate 快照）
-4. **收集未清理的 validate 快照**：
+     - **快照时间**（validate 快照文件的 mtime，通过 `getSnapshotModifiedTime()` 获取，返回 ISO 8601 时间字符串或 null）
+     - **分支创建时间**（通过 `getBranchCreatedAt()` 从 git reflog 获取分支创建时的时间戳）
+4. **收集 validate 快照摘要**：
    - 通过 `getProjectSnapshotBranches()` 扫描快照目录下的 `.tree` 文件获取所有存在快照的分支名
-   - 对比现有 worktree 分支列表，标识孤立快照（对应 worktree 已不存在的快照）
+   - 统计快照总数和孤立快照数（对应 worktree 已不存在的快照）
 5. **输出状态信息**：
    - 指定 `--json` → 以 JSON 格式输出完整状态数据（`JSON.stringify`）
    - 未指定 → 以文本格式输出
 
 **文本输出格式（默认）：**
 
-输出分为三个区块：主 Worktree、Worktree 列表、未清理的 Validate 快照。
+输出分为三个区块：主 Worktree、Worktree 列表、Validate 快照摘要。每个 worktree 条目每行展示一种信息。
 
 ```
 ════════════════════════════════════════
@@ -1409,16 +1474,18 @@ clawt status [--json]
 
   ● feature-login   [已提交]
     +120 -30   3 个本地提交   与主分支同步
-    有 validate 快照
+    创建于 3 天前
+    上次验证: 2 小时前
 
   ● feature-signup   [未提交修改]
     +45 -10   1 个本地提交   落后主分支 2 个提交
+    创建于 1 天前
+    ✗ 未验证
 
 ────────────────────────────────────────
 
-  ◆ 未清理的 Validate 快照 (1 个)
-
-  ⚠ old-feature   (对应 worktree 已不存在)
+  ◆ Validate 快照 (3 个)
+    其中 1 个快照对应的 worktree 已不存在
 
 ════════════════════════════════════════
 ```
@@ -1438,11 +1505,21 @@ clawt status [--json]
 - 本地提交数（`N 个本地提交`）仅在有提交时展示
 - 与主分支同步状态始终展示（落后时显示黄色，同步时显示绿色）
 
+**分支创建时间行：**
+
+- 通过 `getBranchCreatedAt()` 从 git reflog 获取分支创建时间，以 `formatRelativeTime()` 格式化为中文相对时间（如"3 天前"、"2 小时前"、"刚刚"）
+- 展示为灰色文本 `创建于 X前`，无法获取时不展示
+
+**验证状态行：**
+
+- 有快照时：显示绿色 `上次验证: X前`（通过 `getSnapshotModifiedTime()` 获取快照文件 mtime，再用 `formatRelativeTime()` 格式化）
+- 无快照时：显示红色 `✗ 未验证` 警示
+
 **快照区块：**
 
-- 每个快照显示对应的分支名
-- 如果对应的 worktree 仍存在，显示蓝色圆点图标
-- 如果对应的 worktree 已不存在（孤立快照），显示黄色警告图标并标注 `(对应 worktree 已不存在)`
+- 标题显示快照总数
+- 如果存在孤立快照（对应 worktree 已不存在），显示黄色警告 `其中 N 个快照对应的 worktree 已不存在`
+- 无孤立快照时不显示额外信息
 
 **JSON 输出格式（`--json`）：**
 
@@ -1460,25 +1537,31 @@ clawt status [--json]
       "changeStatus": "committed",
       "commitsAhead": 3,
       "commitsBehind": 0,
-      "hasSnapshot": true,
+      "snapshotTime": "2025-02-06T12:30:00.000Z",
       "insertions": 120,
-      "deletions": 30
-    }
-  ],
-  "snapshots": [
-    {
-      "branch": "old-feature",
-      "worktreeExists": false
+      "deletions": 30,
+      "createdAt": "2025-02-03T10:00:00.000Z"
     }
   ],
+  "snapshots": {
+    "total": 3,
+    "orphaned": 1
+  },
   "totalWorktrees": 1
 }
 ```
 
 **实现要点：**
 
-- 类型定义在 `src/types/status.ts`：`WorktreeDetailedStatus`、`MainWorktreeStatus`、`SnapshotInfo`、`StatusResult`
-- 消息常量在 `MESSAGES.STATUS_*` 系列
+- 类型定义在 `src/types/status.ts`：`WorktreeDetailedStatus`（`hasSnapshot` 已改为 `snapshotTime: string | null`，新增 `createdAt: string | null`）、`MainWorktreeStatus`、`SnapshotInfo`、`SnapshotSummary`（新增，包含 `total` 和 `orphaned`）、`StatusResult`（`snapshots` 已从 `SnapshotInfo[]` 改为 `SnapshotSummary`）
+- 消息常量在 `MESSAGES.STATUS_*` 系列，新增：
+  - `STATUS_LAST_VALIDATED`：上次验证时间标签（如 `上次验证: 2 小时前`）
+  - `STATUS_NOT_VALIDATED`：未验证红色警示文本（`✗ 未验证`）
+  - `STATUS_CREATED_AT`：分支创建时间标签（如 `创建于 3 天前`）
+  - `STATUS_SNAPSHOT_ORPHANED`：改为接受数量参数的函数（如 `其中 1 个快照对应的 worktree 已不存在`）
+- `getBranchCreatedAt()` 是新增的工具函数（在 `src/utils/git.ts`），通过 `git reflog show <branch> --format=%cI` 获取 reflog 最后一条记录的时间戳（即分支创建时间），返回 ISO 8601 格式字符串或 null
+- `getSnapshotModifiedTime()` 是新增的工具函数（在 `src/utils/validate-snapshot.ts`），通过 `fs.statSync` 获取快照文件的修改时间（mtime），返回 ISO 8601 格式字符串或 null
+- `formatRelativeTime()` 是新增的格式化函数（在 `src/utils/formatter.ts`），将 ISO 8601 日期字符串转换为中文相对时间描述（如"3 天前"、"2 小时前"、"刚刚"），无效日期时返回 null
 - `getCommitCountBehind()` 是新增的工具函数（在 `src/utils/git.ts`），通过 `git rev-list --count <branch>..HEAD` 计算落后提交数
 - `getProjectSnapshotBranches()` 是新增的工具函数（在 `src/utils/validate-snapshot.ts`），通过扫描快照目录下的 `.tree` 文件提取分支名列表