@coze-arch/cli 0.0.1-alpha.3002ee → 0.0.1-alpha.6a5120

package/lib/cli.js

@@ -5,12 +5,13 @@ var commander = require('commander');
 var path = require('path');
 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 jsYaml = require('js-yaml');
-var perf_hooks = require('perf_hooks');
 var addFormats = require('ajv-formats');
 var Ajv = require('ajv');
+var minimist = require('minimist');
 var changeCase = require('change-case');
 var ejs = require('ejs');
 
@@ -269,6 +270,329 @@ const createLogger = (options = {}) =>
 // 导出默认实例
 const logger = createLogger();
 
+/**
+ * 时间统计工具
+ */
+class TimeTracker {
+  
+  
+
+  constructor() {
+    this.startTime = perf_hooks.performance.now();
+    this.lastTime = this.startTime;
+  }
+
+  /**
+   * 记录阶段耗时
+   * @param phaseName 阶段名称
+   */
+  logPhase(phaseName) {
+    const now = perf_hooks.performance.now();
+    const phaseTime = now - this.lastTime;
+    this.lastTime = now;
+
+    logger.verbose(`⏱ ${phaseName}: ${phaseTime.toFixed(2)}ms`);
+  }
+
+  /**
+   * 记录总耗时
+   */
+  logTotal() {
+    const totalTime = perf_hooks.performance.now() - this.startTime;
+    logger.verbose(`⏱ Total time: ${totalTime.toFixed(2)}ms`);
+  }
+
+  /**
+   * 获取当前耗时（不输出日志）
+   * @returns 从开始到现在的总耗时（毫秒）
+   */
+  getElapsedTime() {
+    return perf_hooks.performance.now() - this.startTime;
+  }
+}
+
+/**
+ * 获取模板配置文件路径
+ * @returns templates.json 的绝对路径
+ */
+const getTemplatesConfigPath = () => {
+  const configPath = path.resolve(getTemplatesDir(), 'templates.json');
+  logger.verbose(`Templates config path: ${configPath}`);
+  logger.verbose(`Config file exists: ${fs.existsSync(configPath)}`);
+  return configPath;
+};
+
+/**
+ * 获取模板目录路径
+ * @returns __templates__ 目录的绝对路径
+ */
+const getTemplatesDir = () => {
+  const templatesDir = path.resolve(__dirname, './__templates__');
+  logger.verbose(`Templates directory: ${templatesDir}`);
+  logger.verbose(`Templates directory exists: ${fs.existsSync(templatesDir)}`);
+  return templatesDir;
+};
+
+/**
+ * 加载模板配置文件
+ * 支持 .ts 和 .js 文件（通过 sucrase 注册）
+ *
+ * @param templatePath - 模板目录路径
+ * @returns 模板配置对象
+ */
+
+const loadTemplateConfig = async ( 
+  templatePath,
+) => {
+  logger.verbose(`Loading template config from: ${templatePath}`);
+
+  const tsConfigPath = path.join(templatePath, 'template.config.ts');
+  const jsConfigPath = path.join(templatePath, 'template.config.js');
+
+  logger.verbose('Checking for config files:');
+  logger.verbose(`  - TypeScript: ${tsConfigPath}`);
+  logger.verbose(`  - JavaScript: ${jsConfigPath}`);
+
+  let configPath;
+
+  const [tsExists, jsExists] = await Promise.all([
+    fs$1.access(tsConfigPath).then(
+      () => true,
+      () => false,
+    ),
+    fs$1.access(jsConfigPath).then(
+      () => true,
+      () => false,
+    ),
+  ]);
+
+  logger.verbose('Config file existence check:');
+  logger.verbose(`  - template.config.ts: ${tsExists}`);
+  logger.verbose(`  - template.config.js: ${jsExists}`);
+
+  if (tsExists) {
+    configPath = tsConfigPath;
+  } else if (jsExists) {
+    configPath = jsConfigPath;
+  } else {
+    throw new Error(
+      `Template config not found in ${templatePath}.\n` +
+        'Expected: template.config.ts or template.config.js',
+    );
+  }
+
+  logger.verbose(`Using config file: ${configPath}`);
+
+  // eslint-disable-next-line @typescript-eslint/no-require-imports, security/detect-non-literal-require -- Sucrase handles .ts files at runtime, path is validated above
+  const config = require(configPath);
+
+  logger.verbose('Template config loaded successfully');
+
+  return config.default || config;
+};
+
+/**
+ * 加载模板列表配置
+ *
+ * @param configPath - templates.json 配置文件路径
+ * @returns 模板列表配置
+ */
+const loadTemplatesConfig = async (
+  configPath,
+) => {
+  logger.verbose(`Loading templates config from: ${configPath}`);
+
+  const content = await fs$1.readFile(configPath, 'utf-8');
+  // eslint-disable-next-line no-restricted-syntax -- Static config file loaded at build time, safeJsonParse not needed
+  const config = JSON.parse(content) ;
+
+  logger.verbose(
+    `Found ${config.templates.length} templates: ${config.templates.map(t => t.name).join(', ')}`,
+  );
+
+  return config;
+};
+
+/**
+ * 根据模板名称查找模板元信息
+ *
+ * @param templatesConfig - 模板列表配置
+ * @param templateName - 模板名称
+ * @returns 模板元信息
+ */
+const findTemplate = (
+  templatesConfig,
+  templateName,
+) => {
+  const template = templatesConfig.templates.find(t => t.name === templateName);
+
+  if (!template) {
+    const availableTemplates = templatesConfig.templates
+      .map(t => t.name)
+      .join(', ');
+    throw new Error(
+      `Template "${templateName}" not found.\n` +
+        `Available templates: ${availableTemplates}\n` +
+        'Use --template <name> to specify a template.',
+    );
+  }
+
+  return template;
+};
+
+/**
+ * 获取模板的完整路径
+ *
+ * @param basePath - 模板目录（templates.json 所在目录）
+ * @param templateMetadata - 模板元信息
+ * @returns 模板完整路径
+ */
+const getTemplatePath = async (
+  basePath,
+  templateMetadata,
+) => {
+  logger.verbose('Resolving template path:');
+  logger.verbose(`  - Base path: ${basePath}`);
+  logger.verbose(`  - Template location: ${templateMetadata.location}`);
+
+  // location 是相对于 templates.json 文件的路径
+  const templatePath = path.join(basePath, templateMetadata.location);
+
+  logger.verbose(`  - Resolved path: ${templatePath}`);
+
+  try {
+    await fs$1.access(templatePath);
+    logger.verbose('  - Template directory exists: ✓');
+    // eslint-disable-next-line @coze-arch/use-error-in-catch -- Error handling done in throw statement
+  } catch (e) {
+    logger.error('  - Template directory does not exist: ✗');
+    throw new Error(`Template directory not found: ${templatePath}`);
+  }
+
+  return templatePath;
+};
+
+/**
+ * 对单个模板执行 pnpm install
+ */
+const warmupTemplate = (templatePath, templateName) => {
+  logger.info(`\nWarming up template: ${templateName}`);
+  logger.info(`  Path: ${templatePath}`);
+
+  const result = shelljs.exec('pnpm install', {
+    cwd: templatePath,
+    silent: true,
+  });
+
+  // 输出 stdout
+  if (result.stdout) {
+    process.stdout.write(result.stdout);
+  }
+
+  // 输出 stderr
+  if (result.stderr) {
+    process.stderr.write(result.stderr);
+  }
+
+  if (result.code === 0) {
+    logger.success(`  ✓ ${templateName} warmed up successfully`);
+  } else {
+    const errorMessage = [
+      `pnpm install failed for ${templateName} with exit code ${result.code}`,
+      result.stderr ? `\nStderr:\n${result.stderr}` : '',
+      result.stdout ? `\nStdout:\n${result.stdout}` : '',
+    ]
+      .filter(Boolean)
+      .join('');
+
+    throw new Error(errorMessage);
+  }
+};
+
+/**
+ * 执行 warmup 命令的内部实现
+ */
+const executeWarmup = async (
+  options
+
+,
+
+  command,
+) => {
+  const timer = new TimeTracker();
+
+  try {
+    const { template: templateFilter } = options;
+
+    logger.info('Starting template warmup...');
+    timer.logPhase('Initialization');
+
+    // 加载模板配置
+    const configPath = getTemplatesConfigPath();
+    const templatesConfig = await loadTemplatesConfig(configPath);
+
+    logger.verbose(
+      `Found ${templatesConfig.templates.length} templates in config`,
+    );
+
+    // 过滤模板
+    const templatesToWarmup = templateFilter
+      ? templatesConfig.templates.filter(t => t.name === templateFilter)
+      : templatesConfig.templates;
+
+    if (templatesToWarmup.length === 0) {
+      if (templateFilter) {
+        logger.warn(`Template "${templateFilter}" not found`);
+        logger.info(
+          `Available templates: ${templatesConfig.templates.map(t => t.name).join(', ')}`,
+        );
+      } else {
+        logger.warn('No templates found');
+      }
+      return;
+    }
+
+    logger.info(
+      `\nWill warm up ${templatesToWarmup.length} template(s): ${templatesToWarmup.map(t => t.name).join(', ')}`,
+    );
+
+    // 获取模板基础路径
+    const basePath = configPath.replace(/\/templates\.json$/, '');
+
+    // 对每个模板执行 pnpm install
+    for (const templateMetadata of templatesToWarmup) {
+      const templatePath = await getTemplatePath(basePath, templateMetadata);
+      warmupTemplate(templatePath, templateMetadata.name);
+      timer.logPhase(`Warmup ${templateMetadata.name}`);
+    }
+
+    logger.success('\n✅ All templates warmed up successfully!');
+    logger.info(
+      '\nNext time you run `coze init`, it will be much faster as node_modules are pre-installed.',
+    );
+
+    timer.logTotal();
+  } catch (error) {
+    timer.logTotal();
+    logger.error('Failed to warmup templates:');
+    logger.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+};
+
+/**
+ * 注册 warmup 命令到 program
+ */
+const registerCommand$2 = 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) => {
+      await executeWarmup(options);
+    });
+};
+
 function _optionalChain$3(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; }/* eslint-disable @typescript-eslint/no-explicit-any */
 // Safe JSON parsing utilities with type safety and error handling
 // Provides fallback values, validation, and error monitoring capabilities
@@ -628,69 +952,6 @@ const registerCommand$1 = program => {
     });
 };
 
-/**
- * 时间统计工具
- */
-class TimeTracker {
-  
-  
-
-  constructor() {
-    this.startTime = perf_hooks.performance.now();
-    this.lastTime = this.startTime;
-  }
-
-  /**
-   * 记录阶段耗时
-   * @param phaseName 阶段名称
-   */
-  logPhase(phaseName) {
-    const now = perf_hooks.performance.now();
-    const phaseTime = now - this.lastTime;
-    this.lastTime = now;
-
-    logger.verbose(`⏱ ${phaseName}: ${phaseTime.toFixed(2)}ms`);
-  }
-
-  /**
-   * 记录总耗时
-   */
-  logTotal() {
-    const totalTime = perf_hooks.performance.now() - this.startTime;
-    logger.verbose(`⏱ Total time: ${totalTime.toFixed(2)}ms`);
-  }
-
-  /**
-   * 获取当前耗时（不输出日志）
-   * @returns 从开始到现在的总耗时（毫秒）
-   */
-  getElapsedTime() {
-    return perf_hooks.performance.now() - this.startTime;
-  }
-}
-
-/**
- * 获取模板配置文件路径
- * @returns templates.json 的绝对路径
- */
-const getTemplatesConfigPath = () => {
-  const configPath = path.resolve(getTemplatesDir(), 'templates.json');
-  logger.verbose(`Templates config path: ${configPath}`);
-  logger.verbose(`Config file exists: ${fs.existsSync(configPath)}`);
-  return configPath;
-};
-
-/**
- * 获取模板目录路径
- * @returns __templates__ 目录的绝对路径
- */
-const getTemplatesDir = () => {
-  const templatesDir = path.resolve(__dirname, './__templates__');
-  logger.verbose(`Templates directory: ${templatesDir}`);
-  logger.verbose(`Templates directory exists: ${fs.existsSync(templatesDir)}`);
-  return templatesDir;
-};
-
 /**
  * 创建 AJV 验证器实例
  */
@@ -739,149 +1000,12 @@ const validateParams = (
   return params ;
 };
 
-/**
- * 加载模板配置文件
- * 支持 .ts 和 .js 文件（通过 sucrase 注册）
- *
- * @param templatePath - 模板目录路径
- * @returns 模板配置对象
- */
-
-const loadTemplateConfig = async ( 
-  templatePath,
-) => {
-  logger.verbose(`Loading template config from: ${templatePath}`);
-
-  const tsConfigPath = path.join(templatePath, 'template.config.ts');
-  const jsConfigPath = path.join(templatePath, 'template.config.js');
-
-  logger.verbose('Checking for config files:');
-  logger.verbose(`  - TypeScript: ${tsConfigPath}`);
-  logger.verbose(`  - JavaScript: ${jsConfigPath}`);
-
-  let configPath;
-
-  const [tsExists, jsExists] = await Promise.all([
-    fs$1.access(tsConfigPath).then(
-      () => true,
-      () => false,
-    ),
-    fs$1.access(jsConfigPath).then(
-      () => true,
-      () => false,
-    ),
-  ]);
-
-  logger.verbose('Config file existence check:');
-  logger.verbose(`  - template.config.ts: ${tsExists}`);
-  logger.verbose(`  - template.config.js: ${jsExists}`);
-
-  if (tsExists) {
-    configPath = tsConfigPath;
-  } else if (jsExists) {
-    configPath = jsConfigPath;
-  } else {
-    throw new Error(
-      `Template config not found in ${templatePath}.\n` +
-        'Expected: template.config.ts or template.config.js',
-    );
-  }
-
-  logger.verbose(`Using config file: ${configPath}`);
-
-  // eslint-disable-next-line @typescript-eslint/no-require-imports, security/detect-non-literal-require -- Sucrase handles .ts files at runtime, path is validated above
-  const config = require(configPath);
-
-  logger.verbose('Template config loaded successfully');
-
-  return config.default || config;
-};
-
-/**
- * 加载模板列表配置
- *
- * @param configPath - templates.json 配置文件路径
- * @returns 模板列表配置
- */
-const loadTemplatesConfig = async (
-  configPath,
-) => {
-  logger.verbose(`Loading templates config from: ${configPath}`);
-
-  const content = await fs$1.readFile(configPath, 'utf-8');
-  // eslint-disable-next-line no-restricted-syntax -- Static config file loaded at build time, safeJsonParse not needed
-  const config = JSON.parse(content) ;
-
-  logger.verbose(
-    `Found ${config.templates.length} templates: ${config.templates.map(t => t.name).join(', ')}`,
-  );
-
-  return config;
-};
-
-/**
- * 根据模板名称查找模板元信息
- *
- * @param templatesConfig - 模板列表配置
- * @param templateName - 模板名称
- * @returns 模板元信息
- */
-const findTemplate = (
-  templatesConfig,
-  templateName,
-) => {
-  const template = templatesConfig.templates.find(t => t.name === templateName);
-
-  if (!template) {
-    const availableTemplates = templatesConfig.templates
-      .map(t => t.name)
-      .join(', ');
-    throw new Error(
-      `Template "${templateName}" not found.\n` +
-        `Available templates: ${availableTemplates}\n` +
-        'Use --template <name> to specify a template.',
-    );
-  }
-
-  return template;
-};
-
-/**
- * 获取模板的完整路径
- *
- * @param basePath - 模板目录（templates.json 所在目录）
- * @param templateMetadata - 模板元信息
- * @returns 模板完整路径
- */
-const getTemplatePath = async (
-  basePath,
-  templateMetadata,
-) => {
-  logger.verbose('Resolving template path:');
-  logger.verbose(`  - Base path: ${basePath}`);
-  logger.verbose(`  - Template location: ${templateMetadata.location}`);
-
-  // location 是相对于 templates.json 文件的路径
-  const templatePath = path.join(basePath, templateMetadata.location);
-
-  logger.verbose(`  - Resolved path: ${templatePath}`);
-
-  try {
-    await fs$1.access(templatePath);
-    logger.verbose('  - Template directory exists: ✓');
-    // eslint-disable-next-line @coze-arch/use-error-in-catch -- Error handling done in throw statement
-  } catch (e) {
-    logger.error('  - Template directory does not exist: ✗');
-    throw new Error(`Template directory not found: ${templatePath}`);
-  }
-
-  return templatePath;
-};
-
 /**
  * 从 Commander 解析透传参数
  * 将 kebab-case 的 CLI 参数转换为 camelCase
  *
+ * 使用 minimist 解析 process.argv，自动处理类型转换
+ *
  * @param command - Commander 命令实例
  * @param knownOptions - 已知的选项集合（不需要透传的选项）
  * @returns 参数对象
@@ -890,20 +1014,34 @@ const parsePassThroughParams = (
   command,
   knownOptions = new Set(),
 ) => {
-  const rawOptions = command.opts();
+  // 使用 minimist 解析所有参数
+  // eslint-disable-next-line @typescript-eslint/no-magic-numbers -- slice(2) to skip node and script path
+  const parsed = minimist(process.argv.slice(2));
 
-  const initial = {};
-  return Object.entries(rawOptions).reduce(
+  // 过滤掉已知选项和位置参数(_)
+  const filtered = Object.entries(parsed).reduce(
     (params, [key, value]) => {
-      if (knownOptions.has(key)) {
+      // 跳过 minimist 的位置参数数组
+      if (key === '_') {
         return params;
       }
 
+      // 跳过已知选项（支持原始格式和 camelCase 格式）
+      if (knownOptions.has(key) || knownOptions.has(changeCase.camelCase(key))) {
+        return params;
+      }
+
+      // 将 kebab-case 转换为 camelCase
       const camelKey = changeCase.camelCase(key);
-      return { ...params, [camelKey]: value };
+      // eslint-disable-next-line security/detect-object-injection -- camelKey is sanitized by camelCase
+      params[camelKey] = value;
+
+      return params;
     },
-    initial,
+    {},
   );
+
+  return filtered;
 };
 
 /**
@@ -1581,14 +1719,14 @@ const registerCommand = program => {
     });
 };
 
-var version = "0.0.1-alpha.3002ee";
+var version = "0.0.1-alpha.6a5120";
 var packageJson = {
 	version: version};
 
 const commands = [
   registerCommand,
   registerCommand$1,
-  // registerWarmupCommand,
+  registerCommand$2,
 ];
 
 const main = () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coze-arch/cli",
-  "version": "0.0.1-alpha.3002ee",
+  "version": "0.0.1-alpha.6a5120",
   "private": false,
   "description": "coze coding devtools cli",
   "license": "MIT",
@@ -19,7 +19,6 @@
   "scripts": {
     "prebuild": "tsx scripts/prebuild.ts",
     "build": "tsx scripts/build.ts",
-    "generate-templates": "tsx scripts/generate-templates-config.ts",
     "lint": "eslint ./ --cache",
     "postpublish": "bash scripts/sync-npmmirror.sh",
     "test": "vitest --run --passWithNoTests",
@@ -38,6 +37,7 @@
     "commander": "~12.1.0",
     "ejs": "^3.1.10",
     "js-yaml": "^4.1.0",
+    "minimist": "^1.2.5",
     "shelljs": "^0.10.0"
   },
   "devDependencies": {
@@ -51,6 +51,7 @@
     "@types/ejs": "^3.1.5",
     "@types/iarna__toml": "^2.0.5",
     "@types/js-yaml": "^4.0.9",
+    "@types/minimist": "^1.2.5",
     "@types/node": "^24",
     "@types/shelljs": "^0.10.0",
     "@vitest/coverage-v8": "~4.0.16",

package/lib/__templates__/nextjs/.babelrc

@@ -1,15 +0,0 @@
-{
-  "presets": [
-    [
-      "next/babel",
-      {
-        "preset-react": {
-          "development": true
-        }
-      }
-    ]
-  ],
-  "plugins": [
-    "@react-dev-inspector/babel-plugin"
-  ]
-}