@coze-arch/cli 0.0.1-alpha.e8683e → 0.0.1-alpha.e89608

package/lib/cli.js

@@ -4,6 +4,8 @@
 var commander = require('commander');
 var path = require('path');
 var fs = require('fs');
+var node_path = require('node:path');
+var node_fs = require('node:fs');
 var shelljs = require('shelljs');
 var perf_hooks = require('perf_hooks');
 var fs$1 = require('fs/promises');
@@ -481,6 +483,14 @@ const warmupTemplate = (templatePath, templateName) => {
   logger.info(`\nWarming up template: ${templateName}`);
   logger.info(`  Path: ${templatePath}`);
 
+  // 检查是否存在 package.json
+  const packageJsonPath = node_path.join(templatePath, 'package.json');
+  // eslint-disable-next-line security/detect-non-literal-fs-filename
+  if (!node_fs.existsSync(packageJsonPath)) {
+    logger.info(`  ⊘ Skipping ${templateName} (no package.json found)`);
+    return;
+  }
+
   const result = shelljs.exec('pnpm install', {
     cwd: templatePath,
     silent: true,
@@ -514,13 +524,7 @@ const warmupTemplate = (templatePath, templateName) => {
 /**
  * 执行 warmup 命令的内部实现
  */
-const executeWarmup = async (
-  options
-
-,
-
-  command,
-) => {
+const executeWarmup = async (options) => {
   const timer = new TimeTracker();
 
   try {
@@ -585,12 +589,12 @@ const executeWarmup = async (
 /**
  * 注册 warmup 命令到 program
  */
-const registerCommand$3 = program => {
+const registerCommand$4 = program => {
   program
     .command('warmup')
     .description('Pre-install dependencies for templates to speed up init')
     .option('-t, --template <name>', 'Warmup a specific template only')
-    .action(async (options, command) => {
+    .action(async options => {
       await executeWarmup(options);
     });
 };
@@ -1033,7 +1037,7 @@ const executeFix = async (options = {}) => {
 /**
  * 注册 fix 命令到 program
  */
-const registerCommand$2 = program => {
+const registerCommand$3 = program => {
   program
     .command('fix')
     .description(
@@ -1052,13 +1056,13 @@ function _nullishCoalesce$1(lhs, rhsFn) { if (lhs != null) { return lhs; } else
 /**
  * 日志文件名常量
  */
-const LOG_FILE_NAME = 'dev.log';
+const LOG_FILE_NAME$1 = 'dev.log';
 
 /**
  * 获取日志目录
  * 优先使用环境变量 COZE_LOG_DIR，否则使用 ~/.coze-logs
  */
-const getLogDir = () =>
+const getLogDir$1 = () =>
   process.env.COZE_LOG_DIR || path.join(os.homedir(), '.coze-logs');
 
 /**
@@ -1067,22 +1071,22 @@ const getLogDir = () =>
  * - 如果是相对路径，基于 getLogDir() + 相对路径
  * - 如果为空，使用 getLogDir() + LOG_FILE_NAME
  */
-const resolveLogFilePath = (logFile) => {
+const resolveLogFilePath$1 = (logFile) => {
   if (!logFile) {
-    return path.join(getLogDir(), LOG_FILE_NAME);
+    return path.join(getLogDir$1(), LOG_FILE_NAME$1);
   }
 
   if (path.isAbsolute(logFile)) {
     return logFile;
   }
 
-  return path.join(getLogDir(), logFile);
+  return path.join(getLogDir$1(), logFile);
 };
 
 /**
  * 创建日志写入流
  */
-const createLogStream = (logFilePath) => {
+const createLogStream$1 = (logFilePath) => {
   const logDir = path.dirname(logFilePath);
 
   // 确保日志目录存在
@@ -1105,7 +1109,7 @@ const executeRun = async (
     logger.info(`Running ${commandName} command...`);
 
     // 1. 对于 build 命令，先执行 fix 以确保项目配置正确
-    if (commandName === 'build') {
+    if (['dev', 'build'].includes(commandName)) {
       logger.info('\n🔧 Running fix command before build...\n');
       try {
         await executeFix();
@@ -1121,8 +1125,8 @@ const executeRun = async (
     const commandArgs = getCommandConfig(config, commandName);
 
     // 3. 准备日志
-    const logFilePath = resolveLogFilePath(options.logFile);
-    const logStream = createLogStream(logFilePath);
+    const logFilePath = resolveLogFilePath$1(options.logFile);
+    const logStream = createLogStream$1(logFilePath);
 
     // 4. 执行命令
     const commandString = commandArgs.join(' ');
@@ -1185,7 +1189,7 @@ const executeRun = async (
 /**
  * 注册 dev/build/start 命令到 program
  */
-const registerCommand$1 = program => {
+const registerCommand$2 = program => {
   // dev 命令
   program
     .command('dev')
@@ -1437,6 +1441,11 @@ const shouldIgnoreFile = (filePath) => {
   return directoryPatterns.some(dir => pathParts.includes(dir));
 };
 
+// ABOUTME: File system utilities for template file processing
+// ABOUTME: Provides directory scanning, file path conversion, and node_modules copying
+
+
+// start_aigc
 /**
  * 递归获取目录中的所有文件
  *
@@ -1506,7 +1515,19 @@ const convertDotfileName = (filePath) => {
 
   return filePath;
 };
+// end_aigc
+
+// ABOUTME: File rendering utilities for template processing
+// ABOUTME: Handles file content rendering, hook execution, and file writing
+
+
+
 
+
+
+
+
+// start_aigc
 /**
  * 执行文件渲染钩子
  *
@@ -1552,22 +1573,25 @@ const executeFileRenderHook = async (
 };
 
 /**
- * 处理单个文件
+ * 准备单个文件的渲染信息（不实际写入）
+ * 用于 dry-run 阶段，收集所有将要写入的文件信息
+ *
+ * @param options - 准备选项
+ * @returns 文件渲染信息，或 null 表示该文件被跳过
  */
-const processSingleFile = async (options
-
+const prepareFileInfo = async (options
 
 
 
 
 ) => {
-  const { file, templatePath, outputPath, context, templateConfig } = options;
+  const { file, templatePath, context, templateConfig } = options;
 
   const srcPath = path.join(templatePath, file);
   const destFile = convertDotfileName(file);
 
   logger.verbose(
-    `  - Processing: ${file}${destFile !== file ? ` -> ${destFile}` : ''}`,
+    `  - Preparing: ${file}${destFile !== file ? ` -> ${destFile}` : ''}`,
   );
 
   // 判断是否为二进制文件
@@ -1601,51 +1625,177 @@ const processSingleFile = async (options
     context,
   );
 
-  // 如果返回 null，跳过该文件
+  // 如果返回 null，表示该文件被 hook 跳过
   if (processedFileInfo === null) {
     logger.verbose('    ⊘ Skipped by onFileRender hook');
-    return;
+    return null;
   }
 
-  // 使用处理后的目标路径
-  const finalDestPath = path.join(outputPath, processedFileInfo.destPath);
+  return processedFileInfo;
+};
+
+/**
+ * 写入渲染后的文件到目标路径
+ *
+ * @param options - 写入选项
+ */
+const writeRenderedFile = async (options
+
+
+
+) => {
+  const { fileInfo, srcPath, destPath } = options;
+
+  logger.verbose(`  - Writing: ${fileInfo.destPath}`);
 
   // 确保目标目录存在
-  await ensureDir(path.dirname(finalDestPath));
+  await ensureDir(path.dirname(destPath));
 
   // 写入文件
-  if (processedFileInfo.isBinary) {
-    // 二进制文件：如果内容没变，直接复制；否则从 base64 解码写入
-    if (processedFileInfo.content === content) {
-      await fs$1.copyFile(srcPath, finalDestPath);
+  if (fileInfo.isBinary) {
+    // 二进制文件：如果内容是原始 base64（未被 hook 修改），直接复制；否则从 base64 解码写入
+    const buffer = await fs$1.readFile(srcPath);
+    const originalContent = buffer.toString('base64');
+
+    if (fileInfo.content === originalContent) {
+      await fs$1.copyFile(srcPath, destPath);
       logger.verbose('    ✓ Copied (binary)');
     } else {
-      const buffer = Buffer.from(processedFileInfo.content, 'base64');
-      await fs$1.writeFile(finalDestPath, buffer);
+      const modifiedBuffer = Buffer.from(fileInfo.content, 'base64');
+      await fs$1.writeFile(destPath, modifiedBuffer);
       logger.verbose('    ✓ Written (binary, modified by hook)');
     }
   } else {
     // 文本文件
-    await fs$1.writeFile(finalDestPath, processedFileInfo.content, 'utf-8');
+    await fs$1.writeFile(destPath, fileInfo.content, 'utf-8');
     logger.verbose('    ✓ Rendered and written');
   }
 };
+// end_aigc
+
+// ABOUTME: File conflict detection utilities for template processing
+// ABOUTME: Provides dry-run file collection and conflict checking
+
+
+
+
+
+
+
+// start_aigc
+/**
+ * 收集所有将要写入的文件路径（dry-run 阶段）
+ *
+ * @param options - 收集选项
+ * @returns 将要写入的文件路径列表
+ */
+const collectFilesToRender = async (options
+
+
+
+
+) => {
+  const { files, templatePath, context, templateConfig } = options;
+
+  logger.verbose('\nDry-run: Collecting files to render...');
+
+  const fileInfos = await Promise.all(
+    files.map(file =>
+      prepareFileInfo({
+        file,
+        templatePath,
+        context,
+        templateConfig,
+      }),
+    ),
+  );
+
+  // 过滤掉被 hook 跳过的文件，收集 destPath
+  const filesToWrite = fileInfos
+    .filter((info) => info !== null)
+    .map(info => info.destPath);
+
+  logger.verbose(`  - ${filesToWrite.length} files will be written`);
+  logger.verbose(
+    `  - ${fileInfos.length - filesToWrite.length} files skipped by hooks`,
+  );
+
+  return filesToWrite;
+};
+// end_aigc
+
+// ABOUTME: Main file processing orchestration for template rendering
+// ABOUTME: Coordinates file system, rendering, and conflict detection layers
+
+
+
+// start_aigc
+/**
+ * 处理单个文件（准备 + 写入）
+ *
+ * @param options - 处理选项
+ */
+const processSingleFile = async (options
+
+
+
+
+
+) => {
+  const { file, templatePath, outputPath, context, templateConfig } = options;
+
+  const srcPath = path.join(templatePath, file);
+
+  // 准备文件信息
+  const processedFileInfo = await prepareFileInfo({
+    file,
+    templatePath,
+    context,
+    templateConfig,
+  });
+
+  // 如果返回 null，跳过该文件
+  if (processedFileInfo === null) {
+    return;
+  }
+
+  // 使用处理后的目标路径
+  const finalDestPath = path.join(outputPath, processedFileInfo.destPath);
+
+  // 写入文件
+  await writeRenderedFile({
+    fileInfo: processedFileInfo,
+    srcPath,
+    destPath: finalDestPath,
+  });
+};
 
 /**
  * 复制并处理模板文件到目标目录
+ *
+ * 流程：
+ * 1. 验证模板目录
+ * 2. 扫描所有模板文件
+ * 3. Dry-run：收集将要写入的文件列表（考虑 hooks 影响）
+ * 4. 冲突检测：检查是否有文件会被覆盖（可通过 force 跳过）
+ * 5. 实际写入：渲染并写入所有文件
+ * 6. 复制 node_modules（如果存在）
+ *
+ * @param options - 处理选项
  */
 const processTemplateFiles = async (options
 
 
 
 
+
 ) => {
-  const { templatePath, outputPath, context, templateConfig } = options;
+  const { templatePath, outputPath, context, templateConfig} = options;
   logger.verbose('Processing template files:');
   logger.verbose(`  - Template path: ${templatePath}`);
   logger.verbose(`  - Output path: ${outputPath}`);
 
-  // 验证模板目录是否存在
+  // 阶段 0: 验证模板目录是否存在
   try {
     const stat = await fs$1.stat(templatePath);
     logger.verbose(
@@ -1661,6 +1811,7 @@ const processTemplateFiles = async (options
     throw error;
   }
 
+  // 阶段 1: 扫描所有模板文件
   const files = await getAllFiles(templatePath);
 
   logger.verbose(`  - Found ${files.length} files to process`);
@@ -1670,6 +1821,23 @@ const processTemplateFiles = async (options
     return;
   }
 
+  // 阶段 2: Dry-run - 收集所有将要写入的文件
+  await collectFilesToRender({
+    files,
+    templatePath,
+    context,
+    templateConfig,
+  });
+
+  // 阶段 3: 冲突检测（force 为 true 时跳过）
+  {
+    logger.verbose(
+      '  - Force mode enabled, skipping conflict detection. Existing files will be overwritten.',
+    );
+  }
+
+  // 阶段 4: 实际写入文件
+  logger.verbose('\nWriting files...');
   await Promise.all(
     files.map(file =>
       processSingleFile({
@@ -1684,74 +1852,9 @@ const processTemplateFiles = async (options
 
   logger.verbose('✓ All files processed successfully');
 
-  // 单独处理 node_modules 目录（如果存在）
-  const sourceNodeModules = path.join(templatePath, 'node_modules');
-  const targetNodeModules = path.join(outputPath, 'node_modules');
-
-  if (fs.existsSync(sourceNodeModules)) {
-    logger.info('\nCopying node_modules from pre-warmed template...');
-    logger.verbose(`  From: ${sourceNodeModules}`);
-    logger.verbose(`  To: ${targetNodeModules}`);
-
-    const result = shelljs.exec(`cp -R "${sourceNodeModules}" "${targetNodeModules}"`, {
-      silent: true,
-    });
-
-    if (result.stdout) {
-      process.stdout.write(result.stdout);
-    }
-
-    if (result.stderr) {
-      process.stderr.write(result.stderr);
-    }
-
-    if (result.code === 0) {
-      logger.success('✓ node_modules copied successfully');
-    } else {
-      logger.warn(
-        `Failed to copy node_modules: ${result.stderr || 'unknown error'}`,
-      );
-      logger.info('Will need to run pnpm install manually');
-    }
-  }
-};
-
-/**
- * 检查输出目录是否为空
- * 注意:.git 目录会被忽略,允许在已初始化 git 的目录中创建项目
- *
- * @param outputPath - 输出目录路径
- * @returns 是否为空
- */
-const isOutputDirEmpty = async (
-  outputPath,
-) => {
-  try {
-    const entries = await fs$1.readdir(outputPath);
-    // 过滤掉 .git 目录,允许在已初始化 git 的目录中创建项目
-    const filteredEntries = entries.filter(entry => entry !== '.git');
-    return filteredEntries.length === 0;
-  } catch (e) {
-    // 目录不存在，视为空
-    return true;
-  }
-};
-
-/**
- * 验证输出目录
- *
- * @param outputPath - 输出目录路径
- * @throws 如果目录不为空则抛出错误
- */
-const validateOutputDir = async (outputPath) => {
-  const isEmpty = await isOutputDirEmpty(outputPath);
-  if (!isEmpty) {
-    throw new Error(
-      `Output directory is not empty: ${outputPath}\n` +
-        'Please use an empty directory or remove existing files.',
-    );
-  }
+  // node_modules 将由 pnpm install 处理（利用缓存和硬链接机制）
 };
+// end_aigc
 
 /**
  * 模板引擎执行选项
@@ -1762,6 +1865,7 @@ const validateOutputDir = async (outputPath) => {
 
 
 
+
 /**
  * 加载模板元数据和路径
  */
@@ -1831,22 +1935,47 @@ const executeAfterRenderHook = async (
   }
 };
 
+/**
+ * 执行完成钩子
+ */
+const executeCompleteHook = async (
+  templateConfig,
+  context,
+  outputPath,
+) => {
+  if (templateConfig.onComplete) {
+    await templateConfig.onComplete(context, outputPath);
+  }
+};
+
 /**
  * 准备输出目录
  */
-const prepareOutputDirectory = async (outputPath) => {
+const prepareOutputDirectory = (outputPath) => {
   const absolutePath = path.resolve(process.cwd(), outputPath);
-  await validateOutputDir(absolutePath);
+  // 不再在这里验证目录是否为空，冲突检测已移至 processTemplateFiles 中
   return absolutePath;
 };
 
+/**
+ * 模板引擎执行结果
+ */
+
+
+
+
+
+
+
+
+
 /**
  * 执行完整的模板渲染流程
  */
 const execute = async (
   options,
 ) => {
-  const { templateName, outputPath, command } = options;
+  const { templateName, outputPath, command} = options;
 
   // 1. 加载模板
   const { templatePath } = await loadTemplateMetadata(templateName);
@@ -1863,20 +1992,23 @@ const execute = async (
   });
 
   // 5. 准备输出目录
-  const absoluteOutputPath = await prepareOutputDirectory(outputPath);
+  const absoluteOutputPath = prepareOutputDirectory(outputPath);
 
   // 6. 处理模板文件
   await processTemplateFiles({
     templatePath,
     outputPath: absoluteOutputPath,
     context,
-    templateConfig,
-  });
+    templateConfig});
 
   // 7. 执行 onAfterRender 钩子
   await executeAfterRenderHook(templateConfig, context, absoluteOutputPath);
 
-  return absoluteOutputPath;
+  return {
+    outputPath: absoluteOutputPath,
+    templateConfig,
+    context,
+  };
 };
 
 function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
@@ -1918,7 +2050,40 @@ const runPnpmInstall = (projectPath) => {
 };
 
 /**
- * 初始化 git 仓库并创建初始提交
+ * 运行 git 命令的辅助函数
+ */
+const runGitCommand = (command, projectPath) => {
+  logger.info(`Executing: ${command}`);
+
+  const result = shelljs.exec(command, {
+    cwd: projectPath,
+    silent: true,
+  });
+
+  // 输出命令的结果
+  if (result.stdout) {
+    process.stdout.write(result.stdout);
+  }
+
+  if (result.stderr) {
+    process.stderr.write(result.stderr);
+  }
+
+  if (result.code !== 0) {
+    const errorMessage = [
+      `${command} failed with exit code ${result.code}`,
+      result.stderr ? `\nStderr:\n${result.stderr}` : '',
+      result.stdout ? `\nStdout:\n${result.stdout}` : '',
+    ]
+      .filter(Boolean)
+      .join('');
+
+    throw new Error(errorMessage);
+  }
+};
+
+/**
+ * 初始化 git 仓库
  * 如果目录中已存在 .git,则跳过初始化
  */
 const runGitInit = (projectPath) => {
@@ -1931,46 +2096,9 @@ const runGitInit = (projectPath) => {
     return;
   }
 
-  const runGitCommand = (command) => {
-    logger.info(`Executing: ${command}`);
-
-    const result = shelljs.exec(command, {
-      cwd: projectPath,
-      silent: true,
-    });
-
-    // 输出命令的结果
-    if (result.stdout) {
-      process.stdout.write(result.stdout);
-    }
-
-    if (result.stderr) {
-      process.stderr.write(result.stderr);
-    }
-
-    if (result.code !== 0) {
-      const errorMessage = [
-        `${command} failed with exit code ${result.code}`,
-        result.stderr ? `\nStderr:\n${result.stderr}` : '',
-        result.stdout ? `\nStdout:\n${result.stdout}` : '',
-      ]
-        .filter(Boolean)
-        .join('');
-
-      throw new Error(errorMessage);
-    }
-  };
-
   try {
     logger.info('\nInitializing git repository...');
-    runGitCommand('git init');
-
-    logger.info('Adding files to git...');
-    runGitCommand('git add .');
-
-    logger.info('Creating initial commit...');
-    runGitCommand('git commit -m "chore: initial commit"');
-
+    runGitCommand('git init', projectPath);
     logger.success('Git repository initialized successfully!');
   } catch (error) {
     // Git 初始化失败不应该导致整个流程失败
@@ -1981,6 +2109,35 @@ const runGitInit = (projectPath) => {
   }
 };
 
+/**
+ * 提交初始化生成的所有文件
+ */
+const commitChanges = (projectPath) => {
+  // 检查是否存在 .git 目录
+  const gitDir = path.join(projectPath, '.git');
+  if (!fs.existsSync(gitDir)) {
+    logger.warn(
+      '\n⚠️  Git repository does not exist, skipping commit. Run git init first.',
+    );
+    return;
+  }
+
+  try {
+    logger.info('\nCommitting initialized files...');
+    runGitCommand('git add --all', projectPath);
+    runGitCommand('git commit -m "chore: init env"', projectPath);
+    logger.success('Changes committed successfully!');
+  } catch (error) {
+    // Commit 失败不应该导致整个流程失败
+    logger.warn(
+      `Git commit failed: ${error instanceof Error ? error.message : String(error)}`,
+    );
+    logger.info(
+      'You can manually commit later with: git add --all && git commit -m "chore: init env"',
+    );
+  }
+};
+
 /**
  * 运行开发服务器(后台模式)
  * 启动后台子进程运行开发服务器，父进程可以直接退出
@@ -2022,6 +2179,8 @@ const executeInit = async (
 
 
 
+
+
 ,
   command,
 ) => {
@@ -2033,44 +2192,58 @@ const executeInit = async (
       output: outputPath,
       skipInstall,
       skipGit,
+      skipCommit,
       skipDev,
+      force,
     } = options;
 
     logger.info(`Initializing project with template: ${templateName}`);
     timer.logPhase('Initialization');
 
-    // 执行模板引擎，返回绝对路径
-    const absoluteOutputPath = await execute({
+    // 执行模板引擎，返回结果对象
+    const result = await execute({
       templateName,
       outputPath,
       command,
+      force,
     });
+    const { outputPath: absoluteOutputPath, templateConfig, context } = result;
 
     timer.logPhase('Template engine execution');
     logger.success('Project created successfully!');
 
-    // 如果没有跳过安装，检查是否需要运行 pnpm install
-    if (!skipInstall) {
-      const nodeModulesPath = path.join(absoluteOutputPath, 'node_modules');
-      const hasNodeModules = fs.existsSync(nodeModulesPath);
+    // 检查是否存在 package.json
+    const packageJsonPath = path.join(absoluteOutputPath, 'package.json');
+    const hasPackageJson = fs.existsSync(packageJsonPath);
 
-      if (hasNodeModules) {
-        logger.info(
-          '\n💡 Using pre-warmed node_modules, skipping pnpm install',
-        );
-        timer.logPhase('Node modules (pre-warmed)');
-      } else {
+    // 安装依赖（始终使用 pnpm install，利用缓存机制）
+    if (!skipInstall) {
+      if (hasPackageJson) {
         runPnpmInstall(absoluteOutputPath);
         timer.logPhase('Dependencies installation');
+      } else {
+        logger.info(
+          '\n💡 No package.json found, skipping dependency installation',
+        );
       }
     }
 
+    // 执行 onComplete 钩子（在 pnpm install 之后）
+    await executeCompleteHook(templateConfig, context, absoluteOutputPath);
+    timer.logPhase('Complete hook execution');
+
     // 如果没有跳过 git，则初始化 git 仓库
     if (!skipGit) {
       runGitInit(absoluteOutputPath);
       timer.logPhase('Git initialization');
     }
 
+    // 如果没有跳过 commit，则提交初始化生成的文件
+    if (!skipCommit) {
+      commitChanges(absoluteOutputPath);
+      timer.logPhase('Git commit');
+    }
+
     // 如果没有跳过 dev，则启动开发服务器
     if (!skipDev) {
       runDev(absoluteOutputPath);
@@ -2079,13 +2252,14 @@ const executeInit = async (
       // 只有跳过 dev 时才显示 Next steps
       logger.info('\nNext steps:');
       logger.info(`  cd ${outputPath}`);
-      if (skipInstall) {
+      if (skipInstall && hasPackageJson) {
         logger.info('  pnpm install');
       }
       if (skipGit) {
-        logger.info(
-          '  git init && git add . && git commit -m "initial commit"',
-        );
+        logger.info('  git init');
+      }
+      if (skipCommit) {
+        logger.info('  git add --all && git commit -m "chore: init env"');
       }
       logger.info('  coze dev');
     }
@@ -2103,7 +2277,7 @@ const executeInit = async (
 /**
  * 注册 init 命令到 program
  */
-const registerCommand = program => {
+const registerCommand$1 = program => {
   program
     .command('init')
     .description('Initialize a new project from a template')
@@ -2112,24 +2286,328 @@ const registerCommand = program => {
     .option('-o, --output <path>', 'Output directory', process.cwd())
     .option('--skip-install', 'Skip automatic pnpm install', false)
     .option('--skip-git', 'Skip automatic git initialization', false)
+    .option(
+      '--skip-commit',
+      'Skip automatic git commit after initialization',
+      false,
+    )
     .option('--skip-dev', 'Skip automatic dev server start', false)
     .allowUnknownOption() // 允许透传参数
     .action(async (directory, options, command) => {
       // 位置参数优先级高于 --output 选项
       const outputPath = _nullishCoalesce(directory, () => ( options.output));
-      await executeInit({ ...options, output: outputPath }, command);
+      // Always use force mode - overwrite existing files without conflict check
+      const force = true;
+      await executeInit({ ...options, output: outputPath, force }, command);
+    });
+};
+
+// ABOUTME: This file implements the update command for coze CLI
+// ABOUTME: It wraps pnpm update/install to update package dependencies with logging support
+
+
+
+
+/**
+ * 日志文件名常量
+ */
+const LOG_FILE_NAME = 'update.log';
+
+/**
+ * 获取日志目录
+ * 优先使用环境变量 COZE_LOG_DIR，否则使用 ~/.coze-logs
+ */
+const getLogDir = () =>
+  process.env.COZE_LOG_DIR || path.join(os.homedir(), '.coze-logs');
+
+/**
+ * 解析日志文件路径
+ * - 如果是绝对路径，直接使用
+ * - 如果是相对路径，基于 getLogDir() + 相对路径
+ * - 如果为空，使用 getLogDir() + LOG_FILE_NAME
+ */
+const resolveLogFilePath = (logFile) => {
+  if (!logFile) {
+    return path.join(getLogDir(), LOG_FILE_NAME);
+  }
+
+  if (path.isAbsolute(logFile)) {
+    return logFile;
+  }
+
+  return path.join(getLogDir(), logFile);
+};
+
+/**
+ * 创建日志写入流
+ */
+const createLogStream = (logFilePath) => {
+  const logDir = path.dirname(logFilePath);
+
+  // 确保日志目录存在
+  if (!fs.existsSync(logDir)) {
+    fs.mkdirSync(logDir, { recursive: true });
+  }
+
+  // 使用 'w' 标志覆盖之前的日志
+  return fs.createWriteStream(logFilePath, { flags: 'w' });
+};
+
+/**
+ * 格式化时间戳
+ */
+const formatTimestamp = () => {
+  const now = new Date();
+  return now.toISOString();
+};
+
+/**
+ * 写入带时间戳的日志
+ */
+const writeLogWithTimestamp = (stream, message) => {
+  const timestamp = formatTimestamp();
+  const lines = message.split('\n');
+  lines.forEach(line => {
+    if (line) {
+      stream.write(`[${timestamp}] ${line}\n`);
+    } else {
+      stream.write('\n');
+    }
+  });
+  // 确保数据写入磁盘
+  stream.uncork();
+};
+
+/**
+ * 同时输出到控制台和日志文件
+ */
+const logWithFile = (
+  stream,
+  level,
+  message,
+) => {
+  // 输出到控制台
+  switch (level) {
+    case 'info':
+      logger.info(message);
+      break;
+    case 'success':
+      logger.success(message);
+      break;
+    case 'error':
+      logger.error(message);
+      break;
+    default:
+      logger.info(message);
+      break;
+  }
+
+  // 写入日志文件（带时间戳）
+  writeLogWithTimestamp(stream, `[${level.toUpperCase()}] ${message}`);
+};
+
+// start_aigc
+/**
+ * 构建 pnpm add 命令
+ */
+const buildPnpmCommand = (
+  packageName,
+  options
+
+
+
+
+,
+) => {
+  const { global, version, registry, extraArgs } = options;
+
+  const parts = ['pnpm', 'add'];
+
+  // 添加全局标记
+  if (global) {
+    parts.push('-g');
+  }
+
+  // 添加包名和版本
+  if (version && version !== 'latest') {
+    parts.push(`${packageName}@${version}`);
+  } else {
+    parts.push(`${packageName}@latest`);
+  }
+
+  // 添加 registry
+  if (registry) {
+    parts.push(`--registry=${registry}`);
+  }
+
+  // 添加额外参数
+  if (extraArgs.length > 0) {
+    parts.push(...extraArgs);
+  }
+
+  return parts.join(' ');
+};
+// end_aigc
+
+// start_aigc
+/**
+ * 执行 update 命令的内部实现
+ */
+const executeUpdate = (
+  packageName,
+  options
+
+
+
+
+
+
+,
+) => {
+  let logStream = null;
+
+  try {
+    const { global, cwd, version, registry, logFile, extraArgs } = options;
+
+    // 准备日志
+    const logFilePath = resolveLogFilePath(logFile);
+
+    // 调试：确认日志路径
+    logger.info(`Log file path resolved to: ${logFilePath}`);
+
+    logStream = createLogStream(logFilePath);
+
+    // 调试：确认流已创建
+    logger.info('Log stream created successfully');
+
+    logWithFile(logStream, 'info', `Updating package: ${packageName}`);
+
+    // 构建命令
+    const command = buildPnpmCommand(packageName, {
+      global,
+      version,
+      registry,
+      extraArgs,
+    });
+
+    // 确定工作目录
+    const workingDir = cwd
+      ? path.isAbsolute(cwd)
+        ? cwd
+        : path.join(process.cwd(), cwd)
+      : process.cwd();
+
+    logWithFile(logStream, 'info', `Executing: ${command}`);
+    logWithFile(logStream, 'info', `Working directory: ${workingDir}`);
+    logWithFile(logStream, 'info', `Log file: ${logFilePath}`);
+
+    // 记录命令开始时间
+    writeLogWithTimestamp(logStream, '--- Command execution started ---');
+
+    // 同步执行命令
+    const result = shelljs.exec(command, {
+      cwd: workingDir,
+      silent: true, // 使用 silent 来捕获输出
+    });
+
+    // 将输出写入控制台和日志文件（带时间戳）
+    if (result.stdout) {
+      process.stdout.write(result.stdout);
+      writeLogWithTimestamp(logStream, result.stdout.trim());
+    }
+
+    if (result.stderr) {
+      process.stderr.write(result.stderr);
+      writeLogWithTimestamp(logStream, result.stderr.trim());
+    }
+
+    // 记录命令结束时间
+    writeLogWithTimestamp(logStream, '--- Command execution ended ---');
+
+    // 检查执行结果并记录到日志
+    if (result.code === 0) {
+      logWithFile(logStream, 'success', 'Package updated successfully');
+      logWithFile(logStream, 'info', `Log file: ${logFilePath}`);
+    } else {
+      logWithFile(
+        logStream,
+        'error',
+        `Command exited with code ${result.code}`,
+      );
+      logWithFile(
+        logStream,
+        'error',
+        `Check log file for details: ${logFilePath}`,
+      );
+    }
+
+    // 关闭日志流并等待写入完成
+    logStream.end(() => {
+      // 流关闭后再退出进程
+      if (result.code !== 0) {
+        process.exit(result.code || 1);
+      }
+    });
+  } catch (error) {
+    logger.error('Failed to update package:');
+    logger.error(error instanceof Error ? error.message : String(error));
+
+    // 写入错误到日志文件
+    if (logStream) {
+      writeLogWithTimestamp(
+        logStream,
+        `[ERROR] ${error instanceof Error ? error.message : String(error)}`,
+      );
+      // 等待流关闭后再退出
+      logStream.end(() => {
+        process.exit(1);
+      });
+    } else {
+      process.exit(1);
+    }
+  }
+};
+// end_aigc
+
+/**
+ * 注册 update 命令到 program
+ */
+const registerCommand = program => {
+  program
+    .command('update <package>')
+    .description('Update a package dependency')
+    .option('-g, --global', 'Update package globally', false)
+    .option('-c, --cwd <path>', 'Working directory for the update')
+    .option(
+      '--to <version>',
+      'Version to update to (default: latest)',
+      'latest',
+    )
+    .option('--registry <url>', 'Registry URL to use for the update')
+    .option('--log-file <path>', 'Log file path')
+    .allowUnknownOption() // 允许透传参数给 pnpm
+    .action((packageName, options, command) => {
+      // 收集所有未知选项作为额外参数
+      const extraArgs = command.args.slice(1);
+
+      executeUpdate(packageName, {
+        ...options,
+        version: options.to, // 将 --to 映射到 version
+        extraArgs,
+      });
     });
 };
 
-var version = "0.0.1-alpha.e8683e";
+var version = "0.0.1-alpha.e89608";
 var packageJson = {
 	version: version};
 
 const commands = [
-  registerCommand,
   registerCommand$1,
-  registerCommand$3,
   registerCommand$2,
+  registerCommand$4,
+  registerCommand$3,
+  registerCommand,
 ];
 
 const main = () => {