clawt 3.4.6 → 3.5.1

package/src/constants/tasks-template.ts

@@ -0,0 +1,28 @@
+/** 任务模板默认输出目录 */
+export const TASK_TEMPLATE_OUTPUT_DIR = 'clawt/tasks';
+
+/** 任务模板文件名前缀 */
+export const TASK_TEMPLATE_FILENAME_PREFIX = 'clawt-tasks';
+
+/** 任务模板文件内容 */
+export const TASK_TEMPLATE_CONTENT = `# Clawt 任务文件
+#
+# 使用方法: clawt run -f tasks.md
+# 格式说明: 标签外的文本会被忽略，每个任务用 START/END 标签包裹
+#
+# 规则:
+#   1. 每个任务块用 <!-- CLAWT-TASKS:START --> 和 <!-- CLAWT-TASKS:END --> 包裹
+#   2. 块内 # branch: <分支名> 声明分支名（使用 -b 参数时可省略）
+#   3. 块内其余行为任务描述（支持多行）
+
+<!-- CLAWT-TASKS:START -->
+# branch: feat-example-1
+在这里写第一个任务的描述
+<!-- CLAWT-TASKS:END -->
+
+<!-- CLAWT-TASKS:START -->
+# branch: feat-example-2
+在这里写第二个任务的描述
+支持多行描述
+<!-- CLAWT-TASKS:END -->
+`;

package/src/index.ts

@@ -21,6 +21,7 @@ import { registerProjectsCommand } from './commands/projects.js';
 import { registerCompletionCommand } from './commands/completion.js';
 import { registerInitCommand } from './commands/init.js';
 import { registerHomeCommand } from './commands/home.js';
+import { registerTasksCommand } from './commands/tasks.js';
 
 // 从 package.json 读取版本号，避免硬编码
 const require = createRequire(import.meta.url);
@@ -62,6 +63,7 @@ registerProjectsCommand(program);
 registerCompletionCommand(program);
 registerInitCommand(program);
 registerHomeCommand(program);
+registerTasksCommand(program);
 
 // 加载配置并应用命令别名
 const config = loadConfig();

package/src/types/command.ts

@@ -36,6 +36,8 @@ export interface MergeOptions {
   branch?: string;
   /** 提交信息（目标 worktree 工作区有修改时必填） */
   message?: string;
+  /** 遇到冲突直接调用 AI 解决，不再询问 */
+  auto?: boolean;
 }
 
 /** remove 命令选项 */
@@ -85,3 +87,9 @@ export interface InitOptions {
   /** 指定主工作分支名（可选，默认使用当前分支） */
   branch?: string;
 }
+
+/** tasks init 命令选项 */
+export interface TasksInitOptions {
+  /** 输出文件路径（可选，默认 tasks.md） */
+  path?: string;
+}

package/src/types/config.ts

@@ -18,6 +18,10 @@ export interface ClawtConfig {
   aliases: Record<string, string>;
   /** 是否启用自动更新检查 */
   autoUpdate: boolean;
+  /** merge 冲突时的解决模式：ask（询问）、auto（自动 AI 解决）、manual（手动解决） */
+  conflictResolveMode: 'ask' | 'auto' | 'manual';
+  /** Claude Code 冲突解决超时时间（毫秒），默认 300000（5 分钟） */
+  conflictResolveTimeoutMs: number;
 }
 
 /** 单个配置项的完整定义（默认值 + 描述） */

package/src/types/index.ts

@@ -1,5 +1,5 @@
 export type { ClawtConfig, ConfigItemDefinition, ConfigDefinitions } from './config.js';
-export type { CreateOptions, RunOptions, ValidateOptions, MergeOptions, RemoveOptions, ResumeOptions, SyncOptions, ListOptions, StatusOptions, ProjectsOptions, InitOptions } from './command.js';
+export type { CreateOptions, RunOptions, ValidateOptions, MergeOptions, RemoveOptions, ResumeOptions, SyncOptions, ListOptions, StatusOptions, ProjectsOptions, InitOptions, TasksInitOptions } from './command.js';
 export type { WorktreeInfo, WorktreeStatus } from './worktree.js';
 export type { ClaudeCodeResult } from './claudeCode.js';
 export type { TaskResult, TaskSummary } from './taskResult.js';

package/src/utils/conflict-resolver.ts

@@ -0,0 +1,170 @@
+import { execFileSync } from 'node:child_process';
+import { logger } from '../logger/index.js';
+import { ClawtError } from '../errors/index.js';
+import { getConfigValue } from './config.js';
+import { getConflictFiles, gitAddFiles, gitMergeContinue } from './git.js';
+import { printInfo, printSuccess, printWarning } from './formatter.js';
+import { confirmAction } from './formatter.js';
+import { MESSAGES } from '../constants/index.js';
+import { CONFLICT_RESOLVE_PROMPT } from '../constants/ai-prompts.js';
+
+/** 默认 Claude Code 冲突解决超时时间（毫秒） */
+const DEFAULT_CONFLICT_RESOLVE_TIMEOUT_MS = 300000;
+
+/**
+ * 构建发送给 Claude Code 的冲突解决 prompt
+ * Claude Code 会自动读取当前工作目录下的冲突文件，无需手动传入
+ * @returns {string} 纯指令性 AI prompt
+ */
+export function buildConflictResolvePrompt(): string {
+  return CONFLICT_RESOLVE_PROMPT;
+}
+
+/**
+ * 获取冲突解决超时时间（毫秒）
+ * 优先使用配置项，未配置时使用默认值
+ * @returns {number} 超时时间（毫秒）
+ */
+function getConflictResolveTimeout(): number {
+  const configValue = getConfigValue('conflictResolveTimeoutMs');
+  if (typeof configValue === 'number' && configValue > 0) {
+    return configValue;
+  }
+  return DEFAULT_CONFLICT_RESOLVE_TIMEOUT_MS;
+}
+
+/**
+ * 调用 Claude Code CLI 以非交互模式解决冲突
+ * 使用 execFileSync 数组参数形式避免 shell 注入
+ * @param {string} prompt - AI prompt
+ * @param {string} cwd - 工作目录
+ * @returns {string} Claude Code 的输出
+ */
+export function invokeClaudeForConflictResolve(prompt: string, cwd: string): string {
+  const args = ['-p', prompt, '--permission-mode', 'bypassPermissions'];
+
+  logger.info(`调用 Claude Code 解决冲突，命令: claude -p "..." --permission-mode bypassPermissions`);
+
+  try {
+    const output = execFileSync('claude', args, {
+      cwd,
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+      timeout: getConflictResolveTimeout(),
+    });
+    return output;
+  } catch (error: unknown) {
+    const errMsg = error instanceof Error ? error.message : String(error);
+    logger.error(`Claude Code 冲突解决失败: ${errMsg}`);
+    throw new ClawtError(MESSAGES.MERGE_CONFLICT_AI_FAILED(errMsg));
+  }
+}
+
+/**
+ * 执行 AI 辅助冲突解决的完整流程
+ * 1. 获取冲突文件列表
+ * 2. 构建 AI prompt
+ * 3. 调用 Claude Code 解决冲突
+ * 4. 检查冲突是否解决
+ * 5. git add 已解决的文件并 merge --continue
+ * @param {string} currentBranch - 当前分支名
+ * @param {string} incomingBranch - 传入分支名
+ * @param {string} cwd - 工作目录
+ * @returns {boolean} 是否所有冲突都已解决
+ */
+export function resolveConflictsWithAI(
+  currentBranch: string,
+  incomingBranch: string,
+  cwd: string,
+): boolean {
+  const conflictFiles = getConflictFiles(cwd);
+  if (conflictFiles.length === 0) {
+    return true;
+  }
+
+  printInfo(MESSAGES.MERGE_CONFLICT_AI_START(conflictFiles.length));
+
+  // 构建 prompt 并调用 Claude Code，捕获异常提供恢复提示
+  const prompt = buildConflictResolvePrompt();
+  try {
+    invokeClaudeForConflictResolve(prompt, cwd);
+  } catch (error) {
+    // AI 调用失败时输出友好提示，告知用户可手动解决或重试
+    const errMsg = error instanceof ClawtError ? error.message : String(error);
+    printWarning(errMsg);
+    return false;
+  }
+
+  // 检查冲突是否已解决
+  const remainingConflicts = getConflictFiles(cwd);
+
+  if (remainingConflicts.length === 0) {
+    // 所有冲突已解决，git add 所有原冲突文件并完成 merge
+    gitAddFiles(conflictFiles, cwd);
+    gitMergeContinue(cwd);
+    printSuccess(MESSAGES.MERGE_CONFLICT_AI_SUCCESS);
+    return true;
+  }
+
+  // 部分冲突已解决，git add 已解决的文件
+  const resolvedFiles = conflictFiles.filter((f) => !remainingConflicts.includes(f));
+  if (resolvedFiles.length > 0) {
+    gitAddFiles(resolvedFiles, cwd);
+  }
+
+  printWarning(MESSAGES.MERGE_CONFLICT_AI_PARTIAL(remainingConflicts.length));
+  return false;
+}
+
+/**
+ * 根据配置和命令选项判断冲突解决模式
+ * @param {boolean} [autoFlag] - --auto 命令行参数
+ * @returns {'ask' | 'auto' | 'manual'} 冲突解决模式
+ */
+export function determineConflictResolveMode(autoFlag?: boolean): 'ask' | 'auto' | 'manual' {
+  // --auto 命令行参数优先级最高
+  if (autoFlag === true) {
+    return 'auto';
+  }
+
+  const configMode = getConfigValue('conflictResolveMode');
+  if (configMode === 'auto' || configMode === 'manual') {
+    return configMode;
+  }
+
+  return 'ask';
+}
+
+/**
+ * 处理合并冲突的入口函数
+ * 根据冲突解决模式决定处理方式：auto 直接 AI 解决，ask 询问用户，manual 抛出错误
+ * @param {string} currentBranch - 当前分支名
+ * @param {string} incomingBranch - 传入分支名
+ * @param {string} cwd - 工作目录
+ * @param {boolean} [autoFlag] - --auto 命令行参数
+ * @returns {Promise<boolean>} 是否成功解决了所有冲突
+ */
+export async function handleMergeConflict(
+  currentBranch: string,
+  incomingBranch: string,
+  cwd: string,
+  autoFlag?: boolean,
+): Promise<boolean> {
+  const mode = determineConflictResolveMode(autoFlag);
+
+  if (mode === 'manual') {
+    throw new ClawtError(MESSAGES.MERGE_CONFLICT_MANUAL);
+  }
+
+  if (mode === 'auto') {
+    return resolveConflictsWithAI(currentBranch, incomingBranch, cwd);
+  }
+
+  // mode === 'ask'
+  const shouldUseAI = await confirmAction(MESSAGES.MERGE_CONFLICT_ASK_AI);
+  if (!shouldUseAI) {
+    throw new ClawtError(MESSAGES.MERGE_CONFLICT_MANUAL);
+  }
+
+  return resolveConflictsWithAI(currentBranch, incomingBranch, cwd);
+}

package/src/utils/formatter.ts

@@ -230,3 +230,22 @@ export function formatLocalISOString(date: Date): string {
 
   return `${iso}${sign}${hours}:${minutes}`;
 }
+
+/**
+ * 生成任务模板文件名，格式：clawt-tasks-YYYY-MM-DD-HH-mm-ss.md
+ * @param {string} prefix - 文件名前缀
+ * @returns {string} 带时间戳的文件名
+ */
+export function generateTaskFilename(prefix: string): string {
+  const now = new Date();
+  const pad = (n: number) => String(n).padStart(2, '0');
+  const timestamp = [
+    now.getFullYear(),
+    pad(now.getMonth() + 1),
+    pad(now.getDate()),
+    pad(now.getHours()),
+    pad(now.getMinutes()),
+    pad(now.getSeconds()),
+  ].join('-');
+  return `${prefix}-${timestamp}.md`;
+}

package/src/utils/git-branch.ts

@@ -0,0 +1,116 @@
+import { execCommand } from './shell.js';
+import { logger } from '../logger/index.js';
+
+/**
+ * 检查本地分支是否存在
+ * @param {string} branchName - 分支名
+ * @param {string} cwd - 工作目录
+ * @returns {boolean} 分支是否存在
+ */
+export function checkBranchExists(branchName: string, cwd?: string): boolean {
+  try {
+    execCommand(`git show-ref --verify refs/heads/${branchName}`, { cwd });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 强制删除本地分支
+ * @param {string} branchName - 分支名
+ * @param {string} cwd - 工作目录
+ */
+export function deleteBranch(branchName: string, cwd?: string): void {
+  logger.info(`删除分支: ${branchName}`);
+  execCommand(`git branch -D ${branchName}`, { cwd });
+}
+
+/**
+ * 检查目标分支相对于当前分支是否有本地提交
+ * @param {string} branchName - 目标分支名
+ * @param {string} cwd - 工作目录
+ * @returns {boolean} 是否有本地提交
+ */
+export function hasLocalCommits(branchName: string, cwd?: string): boolean {
+  try {
+    const output = execCommand(`git log HEAD..${branchName} --oneline`, { cwd });
+    return output.trim() !== '';
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * 获取目标分支相对于当前分支的新增提交数
+ * @param {string} branchName - 目标分支名
+ * @param {string} [cwd] - 工作目录
+ * @returns {number} 新增提交数
+ */
+export function getCommitCountAhead(branchName: string, cwd?: string): number {
+  const output = execCommand(`git rev-list --count HEAD..${branchName}`, { cwd });
+  return parseInt(output, 10) || 0;
+}
+
+/**
+ * 获取目标分支落后于当前分支的提交数
+ * 即当前分支有多少提交是目标分支没有的
+ * @param {string} branchName - 目标分支名
+ * @param {string} [cwd] - 工作目录
+ * @returns {number} 落后的提交数
+ */
+export function getCommitCountBehind(branchName: string, cwd?: string): number {
+  try {
+    const output = execCommand(`git rev-list --count ${branchName}..HEAD`, { cwd });
+    return parseInt(output, 10) || 0;
+  } catch {
+    return 0;
+  }
+}
+
+/**
+ * 获取当前分支名
+ * @param {string} [cwd] - 工作目录
+ * @returns {string} 当前分支名
+ */
+export function getCurrentBranch(cwd?: string): string {
+  return execCommand('git rev-parse --abbrev-ref HEAD', { cwd });
+}
+
+/**
+ * 获取分支的创建时间（通过 reflog 获取分支创建时的时间戳）
+ * reflog 的最后一条记录即为分支创建时的记录
+ * @param {string} branchName - 目标分支名
+ * @param {string} [cwd] - 工作目录
+ * @returns {string | null} ISO 8601 格式的时间字符串，无法获取时返回 null
+ */
+export function getBranchCreatedAt(branchName: string, cwd?: string): string | null {
+  try {
+    const output = execCommand(`git reflog show ${branchName} --format=%cI`, { cwd });
+    if (!output.trim()) return null;
+    // 取最后一行，即分支创建时的 reflog 记录
+    const lines = output.trim().split('\n');
+    const lastLine = lines[lines.length - 1];
+    return lastLine || null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 切换到指定分支
+ * @param {string} branchName - 目标分支名
+ * @param {string} [cwd] - 工作目录
+ */
+export function gitCheckout(branchName: string, cwd?: string): void {
+  execCommand(`git checkout ${branchName}`, { cwd });
+}
+
+/**
+ * 创建本地分支（不切换）
+ * @param {string} branchName - 新分支名
+ * @param {string} [cwd] - 工作目录
+ */
+export function createBranch(branchName: string, cwd?: string): void {
+  execCommand(`git branch ${branchName}`, { cwd });
+}