clawt 3.7.0 → 3.8.0

package/dist/index.js

@@ -564,6 +564,30 @@ var TASKS_CMD_MESSAGES = {
   TASK_INIT_HINT: (path2) => `\u4F7F\u7528 clawt run -f ${path2} \u6267\u884C\u4EFB\u52A1`
 };
 
+// src/constants/messages/post-create.ts
+var POST_CREATE_MESSAGES = {
+  /** hook 执行跳过（--no-post-create） */
+  HOOK_SKIPPED: "\u5DF2\u8DF3\u8FC7 postCreate hook\uFF08--no-post-create\uFF09",
+  /** 无 hook 配置 */
+  HOOK_NOT_CONFIGURED: "\u672A\u914D\u7F6E postCreate hook\uFF0C\u8DF3\u8FC7",
+  /** hook 来源提示 */
+  HOOK_SOURCE_INFO: (source) => `postCreate hook \u6765\u6E90: ${source}`,
+  /** hook 开始执行 */
+  HOOK_EXECUTING: (branch, command) => `[${branch}] \u6B63\u5728\u6267\u884C postCreate hook: ${command}`,
+  /** hook 执行成功 */
+  HOOK_SUCCESS: (branch) => `[${branch}] postCreate hook \u6267\u884C\u6210\u529F`,
+  /** hook 执行失败 */
+  HOOK_FAILED: (branch, error) => `[${branch}] postCreate hook \u6267\u884C\u5931\u8D25: ${error}`,
+  /** hook 执行汇总 */
+  HOOK_SUMMARY: (succeeded, failed) => `postCreate hook \u6267\u884C\u5B8C\u6210: ${succeeded} \u6210\u529F, ${failed} \u5931\u8D25`,
+  /** hook 后台执行中提示 */
+  HOOK_BACKGROUND_START: (count, command) => `postCreate hook \u6B63\u5728\u540E\u53F0\u6267\u884C (${count} \u4E2A worktree): ${command}`,
+  /** postCreate.sh 自动添加执行权限 */
+  POST_CREATE_SCRIPT_AUTO_CHMOD: (path2) => `${path2} \u4E0D\u53EF\u6267\u884C\uFF0C\u5DF2\u81EA\u52A8\u6DFB\u52A0\u6267\u884C\u6743\u9650`,
+  /** postCreate.sh 不可执行（自动 chmod 失败时降级提示） */
+  POST_CREATE_SCRIPT_NOT_EXECUTABLE: (path2) => `\u68C0\u6D4B\u5230 ${path2} \u4F46\u4E0D\u53EF\u6267\u884C\uFF0C\u81EA\u52A8\u6DFB\u52A0\u6743\u9650\u5931\u8D25\uFF0C\u8BF7\u624B\u52A8\u6267\u884C chmod +x ${path2}`
+};
+
 // src/constants/messages/interactive-panel.ts
 import chalk from "chalk";
 
@@ -652,7 +676,8 @@ var MESSAGES = {
   ...INIT_MESSAGES,
   ...COVER_VALIDATE_MESSAGES,
   ...HOME_MESSAGES,
-  ...TASKS_CMD_MESSAGES
+  ...TASKS_CMD_MESSAGES,
+  ...POST_CREATE_MESSAGES
 };
 
 // src/constants/exitCodes.ts
@@ -670,7 +695,7 @@ var VALID_TERMINAL_APPS = ["auto", "iterm2", "terminal"];
 var ITERM2_APP_PATH = "/Applications/iTerm.app";
 
 // src/constants/config.ts
-var APPEND_SYSTEM_PROMPT = "Currently, you are in the git worktree directory. There are no dependencies. To save disk space and improve the speed of task completion, installing dependencies is prohibited.";
+var APPEND_SYSTEM_PROMPT = "Currently, you are in the git worktree directory.";
 var CONFIG_DEFINITIONS = {
   autoDeleteBranch: {
     defaultValue: false,
@@ -743,6 +768,10 @@ var PROJECT_CONFIG_DEFINITIONS = {
   validateRunCommand: {
     defaultValue: void 0,
     description: "validate \u6210\u529F\u540E\u81EA\u52A8\u6267\u884C\u7684\u547D\u4EE4\uFF08-r \u7684\u9ED8\u8BA4\u503C\uFF09"
+  },
+  postCreate: {
+    defaultValue: void 0,
+    description: "worktree \u521B\u5EFA\u540E\u81EA\u52A8\u6267\u884C\u7684\u547D\u4EE4\uFF0C\u7528\u4E8E\u5B89\u88C5\u4F9D\u8D56\u7B49\u521D\u59CB\u5316\u64CD\u4F5C"
   }
 };
 function deriveDefaultConfig2(definitions) {
@@ -762,6 +791,7 @@ var PROJECT_CONFIG_DESCRIPTIONS = deriveConfigDescriptions2(PROJECT_CONFIG_DEFIN
 
 // src/constants/git.ts
 var AUTO_SAVE_COMMIT_MESSAGE = "chore: auto-save before sync";
+var EXEC_MAX_BUFFER = 200 * 1024 * 1024;
 
 // src/constants/logger.ts
 var DEBUG_TIMESTAMP_FORMAT = "HH:mm:ss.SSS";
@@ -967,7 +997,8 @@ function execCommand(command, options) {
   const result = execSync(command, {
     cwd: options?.cwd,
     encoding: "utf-8",
-    stdio: ["pipe", "pipe", "pipe"]
+    stdio: ["pipe", "pipe", "pipe"],
+    maxBuffer: EXEC_MAX_BUFFER
   });
   return result.trim();
 }
@@ -992,7 +1023,8 @@ function execCommandWithInput(command, args, options) {
     cwd: options.cwd,
     input: options.input,
     encoding: "utf-8",
-    stdio: ["pipe", "pipe", "pipe"]
+    stdio: ["pipe", "pipe", "pipe"],
+    maxBuffer: EXEC_MAX_BUFFER
   });
   return result.trim();
 }
@@ -1184,7 +1216,8 @@ function gitDiffBinaryAgainstBranch(branchName, cwd) {
   logger.debug(`\u6267\u884C\u547D\u4EE4: git diff HEAD...${branchName} --binary${cwd ? ` (cwd: ${cwd})` : ""}`);
   return execSync2(`git diff HEAD...${branchName} --binary`, {
     cwd,
-    stdio: ["pipe", "pipe", "pipe"]
+    stdio: ["pipe", "pipe", "pipe"],
+    maxBuffer: EXEC_MAX_BUFFER
   });
 }
 function gitApplyFromStdin(patchContent, cwd) {
@@ -1221,7 +1254,8 @@ function gitDiffTree(baseTreeHash, targetTreeHash, cwd) {
   logger.debug(`\u6267\u884C\u547D\u4EE4: git diff-tree -p --binary ${baseTreeHash} ${targetTreeHash}${cwd ? ` (cwd: ${cwd})` : ""}`);
   return execSync2(`git diff-tree -p --binary ${baseTreeHash} ${targetTreeHash}`, {
     cwd,
-    stdio: ["pipe", "pipe", "pipe"]
+    stdio: ["pipe", "pipe", "pipe"],
+    maxBuffer: EXEC_MAX_BUFFER
   });
 }
 function gitApplyCachedCheck(patchContent, cwd) {
@@ -2015,8 +2049,9 @@ function escapeShellSingleQuote(str) {
 }
 function buildClaudeCommand(worktree, hasPreviousSession) {
   const commandStr = getConfigValue("claudeCodeCommand");
+  const systemPrompt = APPEND_SYSTEM_PROMPT;
   const escapedPath = escapeShellSingleQuote(worktree.path);
-  const escapedPrompt = escapeShellSingleQuote(APPEND_SYSTEM_PROMPT);
+  const escapedPrompt = escapeShellSingleQuote(systemPrompt);
   const continueFlag = hasPreviousSession ? " --continue" : "";
   return `cd '${escapedPath}' && ${commandStr} --append-system-prompt '${escapedPrompt}'${continueFlag}`;
 }
@@ -2836,7 +2871,8 @@ function parseStreamEvent(event) {
 
 // src/utils/task-executor.ts
 function executeClaudeTask(worktree, task, onActivity, continueSession) {
-  const args = ["-p", task, "--output-format", "stream-json", "--verbose", "--permission-mode", "bypassPermissions"];
+  const systemPrompt = APPEND_SYSTEM_PROMPT;
+  const args = ["-p", task, "--output-format", "stream-json", "--verbose", "--permission-mode", "bypassPermissions", "--append-system-prompt", systemPrompt];
   if (continueSession) {
     args.push("--continue");
   }
@@ -4321,6 +4357,117 @@ async function handleMergeConflict(currentBranch, incomingBranch, cwd, autoFlag)
   return resolveConflictsWithAI(currentBranch, incomingBranch, cwd);
 }
 
+// src/hooks/post-create.ts
+import { existsSync as existsSync10, accessSync, chmodSync, constants as fsConstants } from "fs";
+import { spawn as spawn2 } from "child_process";
+import { join as join8 } from "path";
+var POST_CREATE_SCRIPT_RELATIVE_PATH = ".clawt/postCreate.sh";
+function isExecutable(filePath) {
+  try {
+    accessSync(filePath, fsConstants.X_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function autoFixExecutablePermission(filePath) {
+  try {
+    chmodSync(filePath, 493);
+    printInfo(MESSAGES.POST_CREATE_SCRIPT_AUTO_CHMOD(filePath));
+  } catch {
+    printWarning(MESSAGES.POST_CREATE_SCRIPT_NOT_EXECUTABLE(filePath));
+  }
+}
+function normalizeCommand(value) {
+  if (!value) return null;
+  const trimmed = value.trim();
+  return trimmed || null;
+}
+function resolvePostCreateHook() {
+  const config2 = loadProjectConfig();
+  if (config2?.postCreate) {
+    const command = normalizeCommand(config2.postCreate);
+    if (command) {
+      return { command, source: "projectConfig" };
+    }
+  }
+  const mainWorktreePath = getMainWorktreePath();
+  const scriptPath = join8(mainWorktreePath, POST_CREATE_SCRIPT_RELATIVE_PATH);
+  if (existsSync10(scriptPath)) {
+    if (!isExecutable(scriptPath)) {
+      autoFixExecutablePermission(scriptPath);
+    }
+    return { command: scriptPath, source: "postCreateScript" };
+  }
+  return null;
+}
+function getSourceLabel(hook) {
+  return hook.source === "projectConfig" ? "\u9879\u76EE\u914D\u7F6E (postCreate)" : ".clawt/postCreate.sh";
+}
+function executeOneHook(worktree, hook) {
+  return new Promise((resolve4) => {
+    const result = {
+      worktreePath: worktree.path,
+      branch: worktree.branch,
+      success: true,
+      source: hook.source
+    };
+    try {
+      const child = spawn2(hook.command, {
+        cwd: worktree.path,
+        stdio: "ignore",
+        shell: true
+      });
+      child.on("error", (err) => {
+        result.success = false;
+        result.error = err.message;
+        logger.error(`postCreate hook \u5F02\u5E38: ${hook.command} @ ${worktree.path}: ${result.error}`);
+        resolve4(result);
+      });
+      child.on("close", (code) => {
+        if (code !== null && code !== 0) {
+          result.success = false;
+          result.error = `\u547D\u4EE4\u9000\u51FA\u7801: ${code}`;
+          logger.error(`postCreate hook \u5931\u8D25: ${hook.command} (\u9000\u51FA\u7801: ${code}) @ ${worktree.path}`);
+        } else {
+          logger.info(`postCreate hook \u6210\u529F: ${hook.command} @ ${worktree.path}`);
+        }
+        resolve4(result);
+      });
+    } catch (err) {
+      result.success = false;
+      result.error = err instanceof Error ? err.message : String(err);
+      logger.error(`postCreate hook \u542F\u52A8\u5931\u8D25: ${hook.command} @ ${worktree.path}: ${result.error}`);
+      resolve4(result);
+    }
+  });
+}
+function executePostCreateHooks(worktrees, hook) {
+  const promises = worktrees.map((worktree) => executeOneHook(worktree, hook));
+  return Promise.all(promises);
+}
+function runPostCreateHooks(worktrees, skip) {
+  if (skip) {
+    printInfo(MESSAGES.HOOK_SKIPPED);
+    return;
+  }
+  const hook = resolvePostCreateHook();
+  if (!hook) {
+    printInfo(MESSAGES.HOOK_NOT_CONFIGURED);
+    return;
+  }
+  printInfo(MESSAGES.HOOK_SOURCE_INFO(getSourceLabel(hook)));
+  printInfo("");
+  printInfo(MESSAGES.HOOK_BACKGROUND_START(worktrees.length, hook.command));
+  executePostCreateHooks(worktrees, hook).then((results) => {
+    const succeeded = results.filter((r) => r.success).length;
+    const failed = results.filter((r) => !r.success).length;
+    logger.info(`postCreate hook \u6C47\u603B: ${succeeded} \u6210\u529F, ${failed} \u5931\u8D25`);
+  }).catch((err) => {
+    logger.error(`postCreate hook \u6267\u884C\u5F02\u5E38: ${err instanceof Error ? err.message : String(err)}`);
+  });
+}
+
 // src/commands/list.ts
 import chalk10 from "chalk";
 function registerListCommand(program2) {
@@ -4374,7 +4521,7 @@ function printListAsText(projectName, worktrees) {
 
 // src/commands/create.ts
 function registerCreateCommand(program2) {
-  program2.command("create").description("\u6279\u91CF\u521B\u5EFA worktree \u53CA\u5BF9\u5E94\u5206\u652F\uFF08\u542B\u9A8C\u8BC1\u5206\u652F\uFF09").requiredOption("-b, --branch <branchName>", "\u5206\u652F\u540D").option("-n, --number <count>", "\u521B\u5EFA\u6570\u91CF", "1").action(async (options) => {
+  program2.command("create").description("\u6279\u91CF\u521B\u5EFA worktree \u53CA\u5BF9\u5E94\u5206\u652F\uFF08\u542B\u9A8C\u8BC1\u5206\u652F\uFF09").requiredOption("-b, --branch <branchName>", "\u5206\u652F\u540D").option("-n, --number <count>", "\u521B\u5EFA\u6570\u91CF", "1").option("--post-create", "\u6267\u884C postCreate hook\uFF08\u9ED8\u8BA4\u5F00\u542F\uFF0C--no-post-create \u8DF3\u8FC7\uFF09", true).action(async (options) => {
     await handleCreate(options);
   });
 }
@@ -4389,6 +4536,7 @@ async function handleCreate(options) {
   }
   logger.info(`create \u547D\u4EE4\u6267\u884C\uFF0C\u5206\u652F: ${options.branch}\uFF0C\u6570\u91CF: ${count}`);
   const worktrees = createWorktrees(options.branch, count);
+  runPostCreateHooks(worktrees, !options.postCreate);
   printSuccess(MESSAGES.WORKTREE_CREATED(worktrees.length));
   printInfo("");
   worktrees.forEach((wt, index) => {
@@ -4482,7 +4630,7 @@ async function handleRemove(options) {
 
 // src/commands/run.ts
 function registerRunCommand(program2) {
-  program2.command("run").description("\u6279\u91CF\u521B\u5EFA worktree + \u542F\u52A8 Claude Code \u6267\u884C\u4EFB\u52A1\uFF08\u652F\u6301\u4EFB\u52A1\u6587\u4EF6\uFF09").option("-b, --branch <branchName>", "\u5206\u652F\u540D").option("--tasks <task...>", "\u4EFB\u52A1\u5217\u8868\uFF08\u53EF\u591A\u6B21\u6307\u5B9A\uFF09\uFF0C\u4E0D\u4F20\u5219\u5728 worktree \u4E2D\u6253\u5F00 Claude Code \u4EA4\u4E92\u5F0F\u754C\u9762").option("-c, --concurrency <n>", "\u6700\u5927\u5E76\u53D1\u6570\uFF0C0 \u8868\u793A\u4E0D\u9650\u5236").option("-f, --file <path>", "\u4ECE\u4EFB\u52A1\u6587\u4EF6\u8BFB\u53D6\u4EFB\u52A1\u5217\u8868\uFF08\u4E0E --tasks \u4E92\u65A5\uFF09").option("--dry-run", "\u9884\u89C8\u6A21\u5F0F\uFF0C\u4EC5\u5C55\u793A\u4EFB\u52A1\u8BA1\u5212\u4E0D\u5B9E\u9645\u6267\u884C").action(async (options) => {
+  program2.command("run").description("\u6279\u91CF\u521B\u5EFA worktree + \u542F\u52A8 Claude Code \u6267\u884C\u4EFB\u52A1\uFF08\u652F\u6301\u4EFB\u52A1\u6587\u4EF6\uFF09").option("-b, --branch <branchName>", "\u5206\u652F\u540D").option("--tasks <task...>", "\u4EFB\u52A1\u5217\u8868\uFF08\u53EF\u591A\u6B21\u6307\u5B9A\uFF09\uFF0C\u4E0D\u4F20\u5219\u5728 worktree \u4E2D\u6253\u5F00 Claude Code \u4EA4\u4E92\u5F0F\u754C\u9762").option("-c, --concurrency <n>", "\u6700\u5927\u5E76\u53D1\u6570\uFF0C0 \u8868\u793A\u4E0D\u9650\u5236").option("-f, --file <path>", "\u4ECE\u4EFB\u52A1\u6587\u4EF6\u8BFB\u53D6\u4EFB\u52A1\u5217\u8868\uFF08\u4E0E --tasks \u4E92\u65A5\uFF09").option("--dry-run", "\u9884\u89C8\u6A21\u5F0F\uFF0C\u4EC5\u5C55\u793A\u4EFB\u52A1\u8BA1\u5212\u4E0D\u5B9E\u9645\u6267\u884C").option("--post-create", "\u6267\u884C postCreate hook\uFF08\u9ED8\u8BA4\u5F00\u542F\uFF0C--no-post-create \u8DF3\u8FC7\uFF09", true).action(async (options) => {
     await handleRun(options);
   });
 }
@@ -4505,6 +4653,7 @@ async function handleRunFromFile(options) {
     const branches = entries.map((e) => sanitizeBranchName(e.branch));
     worktrees = createWorktreesByBranches(branches);
   }
+  runPostCreateHooks(worktrees, !options.postCreate);
   const concurrency = parseConcurrency(options.concurrency, getConfigValue("maxConcurrency"));
   logger.info(`run \u547D\u4EE4\uFF08\u6587\u4EF6\u6A21\u5F0F\uFF09\u6267\u884C\uFF0C\u4EFB\u52A1\u6570: ${entries.length}\uFF0C\u5E76\u53D1\u6570: ${concurrency || "\u4E0D\u9650\u5236"}`);
   await executeBatchTasks(worktrees, tasks, concurrency);
@@ -4556,6 +4705,7 @@ async function handleRun(options) {
     }
     const worktrees2 = createWorktrees(options.branch, 1);
     const worktree = worktrees2[0];
+    runPostCreateHooks(worktrees2, !options.postCreate);
     printSuccess(MESSAGES.WORKTREE_CREATED(1));
     launchInteractiveClaude(worktree);
     return;
@@ -4565,6 +4715,7 @@ async function handleRun(options) {
   const concurrency = parseConcurrency(options.concurrency, getConfigValue("maxConcurrency"));
   logger.info(`run \u547D\u4EE4\u6267\u884C\uFF0C\u5206\u652F: ${options.branch}\uFF0C\u4EFB\u52A1\u6570: ${count}\uFF0C\u5E76\u53D1\u6570: ${concurrency || "\u4E0D\u9650\u5236"}`);
   const worktrees = createWorktrees(options.branch, count);
+  runPostCreateHooks(worktrees, !options.postCreate);
   await executeBatchTasks(worktrees, tasks, concurrency);
 }
 
@@ -5455,8 +5606,8 @@ function registerAliasCommand(program2) {
 }
 
 // src/commands/projects.ts
-import { existsSync as existsSync10, readdirSync as readdirSync5, statSync as statSync4 } from "fs";
-import { join as join8 } from "path";
+import { existsSync as existsSync11, readdirSync as readdirSync5, statSync as statSync4 } from "fs";
+import { join as join9 } from "path";
 import chalk13 from "chalk";
 function registerProjectsCommand(program2) {
   program2.command("projects [name]").description("\u5C55\u793A\u6240\u6709\u9879\u76EE\u7684 worktree \u6982\u89C8\uFF0C\u6216\u67E5\u770B\u6307\u5B9A\u9879\u76EE\u7684 worktree \u8BE6\u60C5").option("--json", "\u4EE5 JSON \u683C\u5F0F\u8F93\u51FA").action((name, options) => {
@@ -5480,8 +5631,8 @@ function handleProjectsOverview(json) {
   printProjectsOverviewAsText(result);
 }
 function handleProjectDetail(name, json) {
-  const projectDir = join8(WORKTREES_DIR, name);
-  if (!existsSync10(projectDir)) {
+  const projectDir = join9(WORKTREES_DIR, name);
+  if (!existsSync11(projectDir)) {
     printError(MESSAGES.PROJECTS_NOT_FOUND(name));
     process.exit(1);
   }
@@ -5494,7 +5645,7 @@ function handleProjectDetail(name, json) {
   printProjectDetailAsText(result);
 }
 function collectProjectsOverview() {
-  if (!existsSync10(WORKTREES_DIR)) {
+  if (!existsSync11(WORKTREES_DIR)) {
     return { projects: [], totalProjects: 0, totalDiskUsage: 0 };
   }
   const entries = readdirSync5(WORKTREES_DIR, { withFileTypes: true });
@@ -5503,7 +5654,7 @@ function collectProjectsOverview() {
     if (!entry.isDirectory()) {
       continue;
     }
-    const projectDir = join8(WORKTREES_DIR, entry.name);
+    const projectDir = join9(WORKTREES_DIR, entry.name);
     const overview = collectSingleProjectOverview(entry.name, projectDir);
     projects.push(overview);
   }
@@ -5520,7 +5671,7 @@ function collectSingleProjectOverview(name, projectDir) {
   const worktreeDirs = subEntries.filter((e) => e.isDirectory());
   const worktreeCount = worktreeDirs.length;
   const diskUsage = calculateDirSize(projectDir);
-  const lastActiveTime = resolveProjectLastActiveTime(projectDir, worktreeDirs.map((e) => join8(projectDir, e.name)));
+  const lastActiveTime = resolveProjectLastActiveTime(projectDir, worktreeDirs.map((e) => join9(projectDir, e.name)));
   return {
     name,
     worktreeCount,
@@ -5535,7 +5686,7 @@ function collectProjectDetail(name, projectDir) {
     if (!entry.isDirectory()) {
       continue;
     }
-    const wtPath = join8(projectDir, entry.name);
+    const wtPath = join9(projectDir, entry.name);
     const detail = collectSingleWorktreeDetail(entry.name, wtPath);
     worktrees.push(detail);
   }
@@ -5634,7 +5785,7 @@ function printWorktreeDetailItem(wt) {
 }
 
 // src/commands/completion.ts
-import { readFileSync as readFileSync6, writeFileSync as writeFileSync5, existsSync as existsSync12 } from "fs";
+import { readFileSync as readFileSync6, writeFileSync as writeFileSync5, existsSync as existsSync13 } from "fs";
 import { resolve as resolve2 } from "path";
 import { homedir as homedir2 } from "os";
 
@@ -5685,14 +5836,14 @@ compdef _clawt_completion clawt
 }
 
 // src/utils/completion-engine.ts
-import { existsSync as existsSync11, readdirSync as readdirSync6, statSync as statSync5 } from "fs";
-import { join as join9, dirname, basename as basename2 } from "path";
+import { existsSync as existsSync12, readdirSync as readdirSync6, statSync as statSync5 } from "fs";
+import { join as join10, dirname, basename as basename2 } from "path";
 function completeFilePath(partial) {
   const cwd = process.cwd();
   const hasDir = partial.includes("/");
-  const searchDir = hasDir ? join9(cwd, dirname(partial)) : cwd;
+  const searchDir = hasDir ? join10(cwd, dirname(partial)) : cwd;
   const prefix = hasDir ? basename2(partial) : partial;
-  if (!existsSync11(searchDir)) {
+  if (!existsSync12(searchDir)) {
     return [];
   }
   const entries = readdirSync6(searchDir);
@@ -5701,7 +5852,7 @@ function completeFilePath(partial) {
   for (const entry of entries) {
     if (!entry.startsWith(prefix)) continue;
     if (entry.startsWith(".")) continue;
-    const fullPath = join9(searchDir, entry);
+    const fullPath = join10(searchDir, entry);
     try {
       const stat = statSync5(fullPath);
       if (stat.isDirectory()) {
@@ -5790,7 +5941,7 @@ function generateCompletions(program2, args) {
 
 // src/commands/completion.ts
 function appendToFile(filePath, content) {
-  if (existsSync12(filePath)) {
+  if (existsSync13(filePath)) {
     const current = readFileSync6(filePath, "utf-8");
     if (current.includes("clawt completion")) {
       printInfo(MESSAGES.COMPLETION_INSTALL_EXISTS + ": " + filePath);
@@ -5925,19 +6076,19 @@ async function handleHome() {
 }
 
 // src/commands/tasks.ts
-import { resolve as resolve3, dirname as dirname2, join as join10 } from "path";
-import { existsSync as existsSync13, writeFileSync as writeFileSync6 } from "fs";
+import { resolve as resolve3, dirname as dirname2, join as join11 } from "path";
+import { existsSync as existsSync14, writeFileSync as writeFileSync6 } from "fs";
 function registerTasksCommand(program2) {
   const taskCmd = program2.command("tasks").description("\u4EFB\u52A1\u6587\u4EF6\u7BA1\u7406");
   taskCmd.command("init").description("\u751F\u6210\u4EFB\u52A1\u6A21\u677F\u6587\u4EF6").argument("[path]", "\u8F93\u51FA\u6587\u4EF6\u8DEF\u5F84").action(async (path2) => {
-    const filePath = path2 ?? join10(TASK_TEMPLATE_OUTPUT_DIR, generateTaskFilename(TASK_TEMPLATE_FILENAME_PREFIX));
+    const filePath = path2 ?? join11(TASK_TEMPLATE_OUTPUT_DIR, generateTaskFilename(TASK_TEMPLATE_FILENAME_PREFIX));
     await handleTasksInit(filePath);
   });
 }
 async function handleTasksInit(filePath) {
   const absolutePath = resolve3(filePath);
   logger.info(`tasks init \u547D\u4EE4\u6267\u884C\uFF0C\u76EE\u6807\u6587\u4EF6: ${absolutePath}`);
-  if (existsSync13(absolutePath)) {
+  if (existsSync14(absolutePath)) {
     throw new ClawtError(MESSAGES.TASK_INIT_FILE_EXISTS(filePath));
   }
   ensureDir(dirname2(absolutePath));

package/dist/postinstall.js

@@ -541,6 +541,30 @@ var TASKS_CMD_MESSAGES = {
   TASK_INIT_HINT: (path) => `\u4F7F\u7528 clawt run -f ${path} \u6267\u884C\u4EFB\u52A1`
 };
 
+// src/constants/messages/post-create.ts
+var POST_CREATE_MESSAGES = {
+  /** hook 执行跳过（--no-post-create） */
+  HOOK_SKIPPED: "\u5DF2\u8DF3\u8FC7 postCreate hook\uFF08--no-post-create\uFF09",
+  /** 无 hook 配置 */
+  HOOK_NOT_CONFIGURED: "\u672A\u914D\u7F6E postCreate hook\uFF0C\u8DF3\u8FC7",
+  /** hook 来源提示 */
+  HOOK_SOURCE_INFO: (source) => `postCreate hook \u6765\u6E90: ${source}`,
+  /** hook 开始执行 */
+  HOOK_EXECUTING: (branch, command) => `[${branch}] \u6B63\u5728\u6267\u884C postCreate hook: ${command}`,
+  /** hook 执行成功 */
+  HOOK_SUCCESS: (branch) => `[${branch}] postCreate hook \u6267\u884C\u6210\u529F`,
+  /** hook 执行失败 */
+  HOOK_FAILED: (branch, error) => `[${branch}] postCreate hook \u6267\u884C\u5931\u8D25: ${error}`,
+  /** hook 执行汇总 */
+  HOOK_SUMMARY: (succeeded, failed) => `postCreate hook \u6267\u884C\u5B8C\u6210: ${succeeded} \u6210\u529F, ${failed} \u5931\u8D25`,
+  /** hook 后台执行中提示 */
+  HOOK_BACKGROUND_START: (count, command) => `postCreate hook \u6B63\u5728\u540E\u53F0\u6267\u884C (${count} \u4E2A worktree): ${command}`,
+  /** postCreate.sh 自动添加执行权限 */
+  POST_CREATE_SCRIPT_AUTO_CHMOD: (path) => `${path} \u4E0D\u53EF\u6267\u884C\uFF0C\u5DF2\u81EA\u52A8\u6DFB\u52A0\u6267\u884C\u6743\u9650`,
+  /** postCreate.sh 不可执行（自动 chmod 失败时降级提示） */
+  POST_CREATE_SCRIPT_NOT_EXECUTABLE: (path) => `\u68C0\u6D4B\u5230 ${path} \u4F46\u4E0D\u53EF\u6267\u884C\uFF0C\u81EA\u52A8\u6DFB\u52A0\u6743\u9650\u5931\u8D25\uFF0C\u8BF7\u624B\u52A8\u6267\u884C chmod +x ${path}`
+};
+
 // src/constants/messages/interactive-panel.ts
 import chalk from "chalk";
 
@@ -600,7 +624,8 @@ var MESSAGES = {
   ...INIT_MESSAGES,
   ...COVER_VALIDATE_MESSAGES,
   ...HOME_MESSAGES,
-  ...TASKS_CMD_MESSAGES
+  ...TASKS_CMD_MESSAGES,
+  ...POST_CREATE_MESSAGES
 };
 
 // src/constants/terminal.ts
@@ -679,6 +704,10 @@ var PROJECT_CONFIG_DEFINITIONS = {
   validateRunCommand: {
     defaultValue: void 0,
     description: "validate \u6210\u529F\u540E\u81EA\u52A8\u6267\u884C\u7684\u547D\u4EE4\uFF08-r \u7684\u9ED8\u8BA4\u503C\uFF09"
+  },
+  postCreate: {
+    defaultValue: void 0,
+    description: "worktree \u521B\u5EFA\u540E\u81EA\u52A8\u6267\u884C\u7684\u547D\u4EE4\uFF0C\u7528\u4E8E\u5B89\u88C5\u4F9D\u8D56\u7B49\u521D\u59CB\u5316\u64CD\u4F5C"
   }
 };
 function deriveDefaultConfig2(definitions) {
@@ -696,6 +725,9 @@ function deriveConfigDescriptions2(definitions) {
 var PROJECT_DEFAULT_CONFIG = deriveDefaultConfig2(PROJECT_CONFIG_DEFINITIONS);
 var PROJECT_CONFIG_DESCRIPTIONS = deriveConfigDescriptions2(PROJECT_CONFIG_DEFINITIONS);
 
+// src/constants/git.ts
+var EXEC_MAX_BUFFER = 200 * 1024 * 1024;
+
 // src/constants/update.ts
 var UPDATE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
 

package/docs/alias.md

@@ -0,0 +1,114 @@
+### 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`、`tasks`）。如果用户尝试设置与内置命令同名的别名，输出错误提示并返回
+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

@@ -0,0 +1,55 @@
+### 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 的补全脚本
+
+---