@coze-arch/cli 0.0.1-alpha.351659 → 0.0.1-alpha.400852

package/lib/cli.js

@@ -7,10 +7,10 @@ var fs = require('fs');
 var shelljs = require('shelljs');
 var perf_hooks = require('perf_hooks');
 var fs$1 = require('fs/promises');
-var toml = require('@iarna/toml');
+var os = require('os');
 var jsYaml = require('js-yaml');
+var toml = require('@iarna/toml');
 var child_process = require('child_process');
-var os = require('os');
 var addFormats = require('ajv-formats');
 var Ajv = require('ajv');
 var minimist = require('minimist');
@@ -585,7 +585,7 @@ const executeWarmup = async (
 /**
  * 注册 warmup 命令到 program
  */
-const registerCommand$2 = program => {
+const registerCommand$3 = program => {
   program
     .command('warmup')
     .description('Pre-install dependencies for templates to speed up init')
@@ -727,7 +727,7 @@ const parseConfigContent = (content) => {
     return config ;
   } catch (error) {
     // TOML 解析失败，继续尝试其他格式
-    // eslint-disable-next-line no-console
+
     console.debug('TOML parse failed:', error);
   }
 
@@ -739,7 +739,7 @@ const parseConfigContent = (content) => {
     }
   } catch (error) {
     // YAML 解析失败，继续尝试其他格式
-    // eslint-disable-next-line no-console
+
     console.debug('YAML parse failed:', error);
   }
 
@@ -823,27 +823,276 @@ const getCommandConfig = (
   return commandConfig;
 };
 
-function _nullishCoalesce$1(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+// ABOUTME: Fix rule to comment out problematic outputFileTracingRoot config in Next.js projects
+// ABOUTME: This config can cause issues in monorepo environments and should be removed
+
+
+
 
 /**
- * 创建日志管理器
+ * 检查是否为 Next.js 项目
  */
-const createLogManager = (logDir = '.coze-logs') => {
-  const ensureLogDir = () => {
-    if (!fs.existsSync(logDir)) {
-      fs.mkdirSync(logDir, { recursive: true });
+const isNextProject = (projectFolder) => {
+  const packageJsonPath = path.join(projectFolder, 'package.json');
+
+  if (!fs.existsSync(packageJsonPath)) {
+    return false;
+  }
+
+  try {
+    // eslint-disable-next-line no-restricted-syntax
+    const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+    const deps = {
+      ...packageJson.dependencies,
+      ...packageJson.devDependencies,
+    };
+
+    return 'next' in deps;
+  } catch (e) {
+    return false;
+  }
+};
+
+/**
+ * 查找 Next.js 配置文件
+ */
+const findNextConfigFile = (projectFolder) => {
+  const possibleConfigs = [
+    'next.config.ts',
+    'next.config.js',
+    'next.config.mjs',
+  ];
+
+  for (const configFile of possibleConfigs) {
+    const configPath = path.join(projectFolder, configFile);
+    if (fs.existsSync(configPath)) {
+      return configPath;
     }
-  };
+  }
+
+  return null;
+};
+
+/**
+ * 注释掉 outputFileTracingRoot 配置
+ */
+const commentOutOutputTracingRoot = (
+  configPath,
+) => {
+  let content = fs.readFileSync(configPath, 'utf-8');
+  let modified = false;
+  let originalLine = null;
+
+  // 匹配包含 outputFileTracingRoot 的行（尚未被注释的）
+  // 支持 path.resolve(...) 后面有空格，然后可选逗号
+  // 只匹配单行配置，不匹配跨多行的配置
+  const pattern =
+    /^(\s*)(outputFileTracingRoot:\s*path\.resolve\([^\n\r)]+\)\s*,?)\s*$/gm;
+
+  const matches = content.match(pattern);
+
+  if (matches && matches.length > 0) {
+    originalLine = matches[0].trim();
+
+    // 在匹配的行前添加 // 注释
+    content = content.replace(pattern, '$1// $2');
+    modified = true;
+
+    fs.writeFileSync(configPath, content, 'utf-8');
+  }
+
+  return { modified, originalLine };
+};
+
+// start_aigc
+/**
+ * Fix 规则：注释掉 Next.js 项目中的 outputFileTracingRoot 配置
+ * 这个配置在 monorepo 环境中可能会导致问题
+ */
+const fixNextOutputTracingRoot = context => {
+  const ruleName = 'next-output-tracing-root';
+
+  // 1. 检查是否为 Next.js 项目
+  if (!isNextProject(context.projectFolder)) {
+    return {
+      ruleName,
+      applied: false,
+      message: 'Not a Next.js project, skipping',
+    };
+  }
+
+  // 2. 查找 Next.js 配置文件
+  const configPath = findNextConfigFile(context.projectFolder);
 
-  const getLogPath = (logFile) => path.join(logDir, logFile);
+  if (!configPath) {
+    return {
+      ruleName,
+      applied: false,
+      message: 'Next.js config file not found, skipping',
+    };
+  }
+
+  // 3. 注释掉 outputFileTracingRoot 配置
+  const { modified, originalLine } = commentOutOutputTracingRoot(configPath);
+
+  if (modified && originalLine) {
+    logger.success(
+      `Commented out outputFileTracingRoot in ${configPath.split('/').pop()}`,
+    );
+    logger.info(`  Original: ${originalLine}`);
+
+    return {
+      ruleName,
+      applied: true,
+      message: `Successfully commented out: ${originalLine}`,
+    };
+  }
 
   return {
-    createWriteStream: (logFile) => {
-      ensureLogDir();
-      return fs.createWriteStream(getLogPath(logFile), { flags: 'a' });
-    },
+    ruleName,
+    applied: false,
+    message: 'No outputFileTracingRoot config found, skipping',
   };
 };
+// end_aigc
+
+/**
+ * 所有修复规则的数组
+ * 按顺序执行，新增规则直接添加到数组中
+ */
+const rules = [
+  // Next.js related fixes
+  fixNextOutputTracingRoot,
+
+  // Add more rules here
+] ;
+
+// ABOUTME: Fix command for resolving legacy issues from previous project versions
+// ABOUTME: Applies a series of fix rules defined in the fix-rules directory
+
+
+// start_aigc
+/**
+ * 执行 fix 命令的内部实现
+ */
+const executeFix = async (options = {}) => {
+  try {
+    const cwd = process.cwd();
+    const projectFolder = options.directory
+      ? path.resolve(cwd, options.directory)
+      : cwd;
+
+    logger.info(`Running fix command on: ${projectFolder}`);
+    logger.info(`Found ${rules.length} fix rule(s) to apply\n`);
+
+    const context = {
+      cwd,
+      projectFolder,
+    };
+
+    let appliedCount = 0;
+    let skippedCount = 0;
+
+    // 依次执行所有修复规则
+    for (const rule of rules) {
+      try {
+        const result = await Promise.resolve(rule(context));
+
+        if (result.applied) {
+          appliedCount++;
+          logger.success(`✓ ${result.ruleName}: ${result.message}`);
+        } else {
+          skippedCount++;
+          logger.info(`○ ${result.ruleName}: ${result.message}`);
+        }
+      } catch (error) {
+        logger.error(
+          `✗ Rule execution failed: ${error instanceof Error ? error.message : String(error)}`,
+        );
+      }
+    }
+
+    // 输出汇总信息
+    logger.info(
+      `\nSummary: ${appliedCount} fixed, ${skippedCount} skipped, ${rules.length} total`,
+    );
+
+    if (appliedCount > 0) {
+      logger.success('\nFixes applied successfully!');
+    } else {
+      logger.info('\nNo fixes needed');
+    }
+  } catch (error) {
+    logger.error('Failed to run fix command:');
+    logger.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+};
+// end_aigc
+
+/**
+ * 注册 fix 命令到 program
+ */
+const registerCommand$2 = program => {
+  program
+    .command('fix')
+    .description(
+      'Fix legacy issues from previous versions (e.g., problematic configs)',
+    )
+    .argument(
+      '[directory]',
+      'Target directory to fix (defaults to current directory)',
+    )
+    .action(async (directory) => {
+      await executeFix({ directory });
+    });
+};
+
+function _nullishCoalesce$1(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+/**
+ * 日志文件名常量
+ */
+const LOG_FILE_NAME = 'dev.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' });
+};
 
 /**
  * 执行命令的内部实现
@@ -855,21 +1104,32 @@ const executeRun = async (
   try {
     logger.info(`Running ${commandName} command...`);
 
-    // 1. 加载 .coze 配置
+    // 1. 对于 build 命令，先执行 fix 以确保项目配置正确
+    if (commandName === 'build') {
+      logger.info('\n🔧 Running fix command before build...\n');
+      try {
+        await executeFix();
+        // eslint-disable-next-line @coze-arch/no-empty-catch
+      } catch (e) {
+        // just ignore
+      }
+      logger.info('');
+    }
+
+    // 2. 加载 .coze 配置
     const config = await loadCozeConfig();
     const commandArgs = getCommandConfig(config, commandName);
 
-    // 2. 准备日志
-    const logManager = createLogManager();
-    const logFile = options.logFile || `${commandName}.log`;
-    const logStream = logManager.createWriteStream(logFile);
+    // 3. 准备日志
+    const logFilePath = resolveLogFilePath(options.logFile);
+    const logStream = createLogStream(logFilePath);
 
-    // 3. 执行命令
+    // 4. 执行命令
     const commandString = commandArgs.join(' ');
 
     logger.info(`Executing: ${commandString}`);
     logger.info(`Working directory: ${process.cwd()}`);
-    logger.info(`Log file: ${logFile}`);
+    logger.info(`Log file: ${logFilePath}`);
 
     const childProcess = shelljs.exec(commandString, {
       async: true,
@@ -898,11 +1158,11 @@ const executeRun = async (
         logger.error(
           `Command exited with code ${_nullishCoalesce$1(code, () => ( 'unknown'))}${signal ? ` and signal ${signal}` : ''}`,
         );
-        logger.error(`Check log file for details: ${logFile}`);
+        logger.error(`Check log file for details: ${logFilePath}`);
         process.exit(code || 1);
       } else {
         logger.success('Command completed successfully');
-        logger.info(`Log file: ${logFile}`);
+        logger.info(`Log file: ${logFilePath}`);
       }
     });
 
@@ -1248,17 +1508,139 @@ const convertDotfileName = (filePath) => {
 };
 
 /**
- * 复制并处理模板文件到目标目录
+ * 执行文件渲染钩子
  *
- * @param templatePath - 模板目录路径
- * @param outputPath - 输出目录路径
+ * @param templateConfig - 模板配置
+ * @param fileInfo - 文件渲染信息
  * @param context - 模板上下文
+ * @returns 处理后的文件信息，或 null 表示跳过该文件
  */
-const processTemplateFiles = async (
-  templatePath,
-  outputPath,
+const executeFileRenderHook = async (
+  templateConfig,
+  fileInfo,
   context,
 ) => {
+  if (!templateConfig.onFileRender) {
+    return fileInfo;
+  }
+
+  const result = await templateConfig.onFileRender(
+    fileInfo,
+    context,
+  );
+
+  // false: 跳过文件
+  if (result === false) {
+    return null;
+  }
+
+  // undefined/void: 使用默认内容
+  if (result === undefined || result === null) {
+    return fileInfo;
+  }
+
+  // string: 作为 content，其他不变
+  if (typeof result === 'string') {
+    return {
+      ...fileInfo,
+      content: result,
+    };
+  }
+
+  // FileRenderInfo: 使用新对象的信息
+  return result;
+};
+
+/**
+ * 处理单个文件
+ */
+const processSingleFile = async (options
+
+
+
+
+
+) => {
+  const { file, templatePath, outputPath, context, templateConfig } = options;
+
+  const srcPath = path.join(templatePath, file);
+  const destFile = convertDotfileName(file);
+
+  logger.verbose(
+    `  - Processing: ${file}${destFile !== file ? ` -> ${destFile}` : ''}`,
+  );
+
+  // 判断是否为二进制文件
+  const isBinary = !shouldRenderFile(srcPath);
+  let content;
+  let wasRendered = false;
+
+  if (isBinary) {
+    // 二进制文件，读取为 buffer 然后转为 base64
+    const buffer = await fs$1.readFile(srcPath);
+    content = buffer.toString('base64');
+  } else {
+    // 文本文件，渲染后的内容
+    content = await renderTemplate(srcPath, context);
+    wasRendered = true;
+  }
+
+  // 构造文件信息对象
+  const fileInfo = {
+    path: file,
+    destPath: destFile,
+    content,
+    isBinary,
+    wasRendered,
+  };
+
+  // 执行文件渲染钩子
+  const processedFileInfo = await executeFileRenderHook(
+    templateConfig,
+    fileInfo,
+    context,
+  );
+
+  // 如果返回 null，跳过该文件
+  if (processedFileInfo === null) {
+    logger.verbose('    ⊘ Skipped by onFileRender hook');
+    return;
+  }
+
+  // 使用处理后的目标路径
+  const finalDestPath = path.join(outputPath, processedFileInfo.destPath);
+
+  // 确保目标目录存在
+  await ensureDir(path.dirname(finalDestPath));
+
+  // 写入文件
+  if (processedFileInfo.isBinary) {
+    // 二进制文件：如果内容没变，直接复制；否则从 base64 解码写入
+    if (processedFileInfo.content === content) {
+      await fs$1.copyFile(srcPath, finalDestPath);
+      logger.verbose('    ✓ Copied (binary)');
+    } else {
+      const buffer = Buffer.from(processedFileInfo.content, 'base64');
+      await fs$1.writeFile(finalDestPath, buffer);
+      logger.verbose('    ✓ Written (binary, modified by hook)');
+    }
+  } else {
+    // 文本文件
+    await fs$1.writeFile(finalDestPath, processedFileInfo.content, 'utf-8');
+    logger.verbose('    ✓ Rendered and written');
+  }
+};
+
+/**
+ * 复制并处理模板文件到目标目录
+ */
+const processTemplateFiles = async (options
+
+
+
+
+) => {
+  const { templatePath, outputPath, context, templateConfig } = options;
   logger.verbose('Processing template files:');
   logger.verbose(`  - Template path: ${templatePath}`);
   logger.verbose(`  - Output path: ${outputPath}`);
@@ -1289,29 +1671,15 @@ const processTemplateFiles = async (
   }
 
   await Promise.all(
-    files.map(async file => {
-      const srcPath = path.join(templatePath, file);
-      const destFile = convertDotfileName(file);
-      const destPath = path.join(outputPath, destFile);
-
-      logger.verbose(
-        `  - Processing: ${file}${destFile !== file ? ` -> ${destFile}` : ''}`,
-      );
-
-      // 确保目标目录存在
-      await ensureDir(path.dirname(destPath));
-
-      if (shouldRenderFile(srcPath)) {
-        // 渲染文本文件
-        const rendered = await renderTemplate(srcPath, context);
-        await fs$1.writeFile(destPath, rendered, 'utf-8');
-        logger.verbose('    ✓ Rendered and written');
-      } else {
-        // 直接复制二进制文件
-        await fs$1.copyFile(srcPath, destPath);
-        logger.verbose('    ✓ Copied');
-      }
-    }),
+    files.map(file =>
+      processSingleFile({
+        file,
+        templatePath,
+        outputPath,
+        context,
+        templateConfig,
+      }),
+    ),
   );
 
   logger.verbose('✓ All files processed successfully');
@@ -1498,7 +1866,12 @@ const execute = async (
   const absoluteOutputPath = await prepareOutputDirectory(outputPath);
 
   // 6. 处理模板文件
-  await processTemplateFiles(templatePath, absoluteOutputPath, context);
+  await processTemplateFiles({
+    templatePath,
+    outputPath: absoluteOutputPath,
+    context,
+    templateConfig,
+  });
 
   // 7. 执行 onAfterRender 钩子
   await executeAfterRenderHook(templateConfig, context, absoluteOutputPath);
@@ -1611,13 +1984,20 @@ const runGitInit = (projectPath) => {
 /**
  * 运行开发服务器(后台模式)
  * 启动后台子进程运行开发服务器，父进程可以直接退出
+ * 使用 CLI 自己的 dev 命令(定义在 run.ts)而不是直接运行 npm run dev
  */
-const runNpmDev = (projectPath) => {
+const runDev = (projectPath) => {
   logger.info('\nStarting development server in background...');
-  logger.info(`Executing: npm run dev in ${projectPath}`);
+
+  // 获取当前 CLI 的可执行文件路径
+  // process.argv[0] 是 node，process.argv[1] 是 CLI 入口文件
+  const cliPath = process.argv[1];
+
+  logger.info(`Executing: ${cliPath} dev in ${projectPath}`);
 
   // 使用通用的后台执行函数启动开发服务器
-  const pid = spawnDetached('npm', ['run', 'dev'], {
+  // 调用 CLI 自己的 dev 命令
+  const pid = spawnDetached(process.argv[0], [cliPath, 'dev'], {
     cwd: projectPath,
     verbose: false, // 不输出额外的进程信息，由 logger 统一处理
   });
@@ -1693,7 +2073,7 @@ const executeInit = async (
 
     // 如果没有跳过 dev，则启动开发服务器
     if (!skipDev) {
-      runNpmDev(absoluteOutputPath);
+      runDev(absoluteOutputPath);
       timer.logPhase('Dev server startup');
     } else {
       // 只有跳过 dev 时才显示 Next steps
@@ -1707,7 +2087,7 @@ const executeInit = async (
           '  git init && git add . && git commit -m "initial commit"',
         );
       }
-      logger.info('  npm run dev');
+      logger.info('  coze dev');
     }
 
     // 输出总耗时
@@ -1741,13 +2121,14 @@ const registerCommand = program => {
     });
 };
 
-var version = "0.0.1-alpha.351659";
+var version = "0.0.1-alpha.400852";
 var packageJson = {
 	version: version};
 
 const commands = [
   registerCommand,
   registerCommand$1,
+  registerCommand$3,
   registerCommand$2,
 ];
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coze-arch/cli",
-  "version": "0.0.1-alpha.351659",
+  "version": "0.0.1-alpha.400852",
   "private": false,
   "description": "coze coding devtools cli",
   "license": "MIT",
@@ -19,12 +19,13 @@
   "scripts": {
     "prebuild": "tsx scripts/prebuild.ts",
     "build": "tsx scripts/build.ts",
+    "create": "tsx scripts/create-template.ts",
     "lint": "eslint ./ --cache",
     "postpublish": "bash scripts/sync-npmmirror.sh",
     "test": "vitest --run --passWithNoTests",
     "test:all": "bash scripts/test-coverage.sh",
     "test:cov": "vitest --run --passWithNoTests --coverage",
-    "test:e2e": "bash scripts/e2e.sh",
+    "test:e2e": "NODE_ENV=test bash scripts/e2e.sh",
     "test:perf": "vitest bench --run --config vitest.perf.config.ts",
     "test:perf:compare": "bash scripts/compare-perf.sh",
     "test:perf:save": "bash scripts/run-perf-with-output.sh"
@@ -48,21 +49,25 @@
     "@coze-arch/ts-config": "workspace:*",
     "@coze-arch/vitest-config": "workspace:*",
     "@coze-coding/lambda": "workspace:*",
+    "@inquirer/prompts": "^3.2.0",
     "@types/ejs": "^3.1.5",
     "@types/iarna__toml": "^2.0.5",
     "@types/js-yaml": "^4.0.9",
+    "@types/minimatch": "^5.1.2",
     "@types/minimist": "^1.2.5",
     "@types/node": "^24",
     "@types/shelljs": "^0.10.0",
     "@vitest/coverage-v8": "~4.0.16",
     "json-schema-to-typescript": "^15.0.3",
+    "minimatch": "^10.0.1",
     "rollup": "^4.41.1",
     "sucrase": "^3.35.0",
     "tsx": "^4.20.6",
     "vitest": "~4.0.16"
   },
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
   },
   "cozePublishConfig": {
     "bin": {