@coze-arch/cli 0.0.1-alpha.a1ca15 → 0.0.1-alpha.a37c60

package/lib/cli.js

@@ -9,6 +9,8 @@ var perf_hooks = require('perf_hooks');
 var fs$1 = require('fs/promises');
 var toml = require('@iarna/toml');
 var jsYaml = require('js-yaml');
+var child_process = require('child_process');
+var os = require('os');
 var addFormats = require('ajv-formats');
 var Ajv = require('ajv');
 var minimist = require('minimist');
@@ -125,7 +127,7 @@ const generateTemplatesHelpText = () => {
   return lines.join('\n');
 };
 
-function _nullishCoalesce$2(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain$4(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; }var LogLevel; (function (LogLevel) {
+function _nullishCoalesce$2(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } 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; }var LogLevel; (function (LogLevel) {
   const ERROR = 0; LogLevel[LogLevel["ERROR"] = ERROR] = "ERROR";
   const WARN = 1; LogLevel[LogLevel["WARN"] = WARN] = "WARN";
   const SUCCESS = 2; LogLevel[LogLevel["SUCCESS"] = SUCCESS] = "SUCCESS";
@@ -172,7 +174,7 @@ class Logger {
       return level;
     }
 
-    const envLevel = _optionalChain$4([process, 'access', _ => _.env, 'access', _2 => _2.LOG_LEVEL, 'optionalAccess', _3 => _3.toLowerCase, 'call', _4 => _4()]);
+    const envLevel = _optionalChain$3([process, 'access', _ => _.env, 'access', _2 => _2.LOG_LEVEL, 'optionalAccess', _3 => _3.toLowerCase, 'call', _4 => _4()]);
     if (envLevel && envLevel in LOG_LEVEL_MAP) {
       return LOG_LEVEL_MAP[envLevel];
     }
@@ -184,7 +186,7 @@ class Logger {
     // 简单检测：Node.js 环境且支持 TTY
     return (
       typeof process !== 'undefined' &&
-      _optionalChain$4([process, 'access', _5 => _5.stdout, 'optionalAccess', _6 => _6.isTTY]) === true &&
+      _optionalChain$3([process, 'access', _5 => _5.stdout, 'optionalAccess', _6 => _6.isTTY]) === true &&
       process.env.NO_COLOR === undefined
     );
   }
@@ -593,7 +595,7 @@ const registerCommand$2 = program => {
     });
 };
 
-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 */
+function _optionalChain$2(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
 
@@ -684,12 +686,12 @@ function safeJsonParse(
     const parsed = JSON.parse(String(input));
 
     // Optional validation
-    if (_optionalChain$3([options, 'optionalAccess', _ => _.validate])) {
+    if (_optionalChain$2([options, 'optionalAccess', _ => _.validate])) {
       if (options.validate(parsed)) {
         return parsed;
       } else {
         const validationError = new Error('JSON validation failed');
-        _optionalChain$3([options, 'access', _2 => _2.onError, 'optionalCall', _3 => _3(validationError, input)]);
+        _optionalChain$2([options, 'access', _2 => _2.onError, 'optionalCall', _3 => _3(validationError, input)]);
 
         if (options.throwOnValidationError) {
           throw validationError;
@@ -701,15 +703,15 @@ function safeJsonParse(
     return parsed;
   } catch (error) {
     // Re-throw validation errors when throwOnValidationError is true
-    if (error instanceof Error && error.message === 'JSON validation failed' && _optionalChain$3([options, 'optionalAccess', _4 => _4.throwOnValidationError])) {
+    if (error instanceof Error && error.message === 'JSON validation failed' && _optionalChain$2([options, 'optionalAccess', _4 => _4.throwOnValidationError])) {
       throw error;
     }
-    _optionalChain$3([options, 'optionalAccess', _5 => _5.onError, 'optionalCall', _6 => _6(error , input)]);
+    _optionalChain$2([options, 'optionalAccess', _5 => _5.onError, 'optionalCall', _6 => _6(error , input)]);
     return defaultValue;
   }
 }
 
-function _optionalChain$2(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; }
+function _optionalChain$1(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; }
 
 
 /**
@@ -799,13 +801,13 @@ const getCommandConfig = (
   // 根据命令名称映射到配置路径
   switch (commandName) {
     case 'dev':
-      commandConfig = _optionalChain$2([config, 'access', _ => _.dev, 'optionalAccess', _2 => _2.run]);
+      commandConfig = _optionalChain$1([config, 'access', _ => _.dev, 'optionalAccess', _2 => _2.run]);
       break;
     case 'build':
-      commandConfig = _optionalChain$2([config, 'access', _3 => _3.deploy, 'optionalAccess', _4 => _4.build]);
+      commandConfig = _optionalChain$1([config, 'access', _3 => _3.deploy, 'optionalAccess', _4 => _4.build]);
       break;
     case 'start':
-      commandConfig = _optionalChain$2([config, 'access', _5 => _5.deploy, 'optionalAccess', _6 => _6.run]);
+      commandConfig = _optionalChain$1([config, 'access', _5 => _5.deploy, 'optionalAccess', _6 => _6.run]);
       break;
     default:
       throw new Error(`Unknown command: ${commandName}`);
@@ -821,7 +823,7 @@ const getCommandConfig = (
   return commandConfig;
 };
 
-function _nullishCoalesce$1(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain$1(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; }
+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; }
 
 /**
  * 创建日志管理器
@@ -879,12 +881,12 @@ const executeRun = async (
     }
 
     // 将输出同时写入控制台和日志文件
-    _optionalChain$1([childProcess, 'access', _ => _.stdout, 'optionalAccess', _2 => _2.on, 'call', _3 => _3('data', (data) => {
+    _optionalChain([childProcess, 'access', _ => _.stdout, 'optionalAccess', _2 => _2.on, 'call', _3 => _3('data', (data) => {
       process.stdout.write(data);
       logStream.write(data);
     })]);
 
-    _optionalChain$1([childProcess, 'access', _4 => _4.stderr, 'optionalAccess', _5 => _5.on, 'call', _6 => _6('data', (data) => {
+    _optionalChain([childProcess, 'access', _4 => _4.stderr, 'optionalAccess', _5 => _5.on, 'call', _6 => _6('data', (data) => {
       process.stderr.write(data);
       logStream.write(data);
     })]);
@@ -952,6 +954,45 @@ const registerCommand$1 = program => {
     });
 };
 
+/**
+ * 在后台启动一个独立的子进程
+ * 类似于 `setsid command args >/dev/null 2>&1 &`
+ *
+ * @param command - 要执行的命令 (例如: 'npm', 'node', 'bash')
+ * @param args - 命令参数数组 (例如: ['run', 'dev'])
+ * @param options - 配置选项
+ * @returns 子进程的 PID
+ */
+function spawnDetached(
+  command,
+  args,
+  options,
+) {
+  const { cwd, verbose = true } = options;
+  const isWindows = os.platform() === 'win32';
+
+  if (verbose) {
+    console.log(`Spawning detached process: ${command} ${args.join(' ')}`);
+    console.log(`Working directory: ${cwd}`);
+  }
+
+  // 使用 spawn 创建后台子进程
+  const child = child_process.spawn(command, args, {
+    cwd,
+    detached: !isWindows, // Windows 不完全支持 detached，但仍可以使用
+    stdio: 'ignore', // 忽略所有输入输出，让进程完全独立运行
+  });
+
+  // 分离父子进程引用，允许父进程退出而不等待子进程
+  child.unref();
+
+  if (verbose && child.pid) {
+    console.log(`Process started with PID: ${child.pid}`);
+  }
+
+  return child.pid;
+}
+
 /**
  * 创建 AJV 验证器实例
  */
@@ -1207,17 +1248,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}`);
@@ -1248,29 +1411,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');
@@ -1457,7 +1606,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);
@@ -1465,7 +1619,7 @@ const execute = async (
   return absoluteOutputPath;
 };
 
-function _nullishCoalesce(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; }
+function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
 /**
  * 运行 pnpm install
  */
@@ -1568,45 +1722,26 @@ const runGitInit = (projectPath) => {
 };
 
 /**
- * 运行开发服务器
+ * 运行开发服务器(后台模式)
+ * 启动后台子进程运行开发服务器，父进程可以直接退出
  */
 const runNpmDev = (projectPath) => {
-  logger.info('\nStarting development server...');
+  logger.info('\nStarting development server in background...');
   logger.info(`Executing: npm run dev in ${projectPath}`);
-  logger.info('Press Ctrl+C to stop the server\n');
 
-  // 使用 async: true 异步执行，不阻塞进程
-  const child = shelljs.exec('npm run dev', {
+  // 使用通用的后台执行函数启动开发服务器
+  const pid = spawnDetached('npm', ['run', 'dev'], {
     cwd: projectPath,
-    async: true,
-    silent: true, // 手动处理输出以便显示详细信息
+    verbose: false, // 不输出额外的进程信息，由 logger 统一处理
   });
 
-  if (child) {
-    // 输出 stdout
-    _optionalChain([child, 'access', _ => _.stdout, 'optionalAccess', _2 => _2.on, 'call', _3 => _3('data', (data) => {
-      process.stdout.write(data);
-    })]);
-
-    // 输出 stderr
-    _optionalChain([child, 'access', _4 => _4.stderr, 'optionalAccess', _5 => _5.on, 'call', _6 => _6('data', (data) => {
-      process.stderr.write(data);
-    })]);
-
-    // 监听错误
-    child.on('error', (error) => {
-      logger.error(`Failed to start dev server: ${error.message}`);
-      logger.error(`Error stack: ${error.stack}`);
-    });
-
-    // 监听退出
-    child.on('exit', (code, signal) => {
-      if (code !== 0 && code !== null) {
-        logger.error(
-          `Dev server exited with code ${code}${signal ? ` and signal ${signal}` : ''}`,
-        );
-      }
-    });
+  logger.success('Development server started in background!');
+  if (pid) {
+    logger.info(`Process ID: ${pid}`);
+    logger.info(
+      '\nThe dev server is running independently. You can close this terminal.',
+    );
+    logger.info(`To stop the server later, use: kill ${pid}`);
   }
 };
 
@@ -1719,7 +1854,7 @@ const registerCommand = program => {
     });
 };
 
-var version = "0.0.1-alpha.a1ca15";
+var version = "0.0.1-alpha.a37c60";
 var packageJson = {
 	version: version};
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coze-arch/cli",
-  "version": "0.0.1-alpha.a1ca15",
+  "version": "0.0.1-alpha.a37c60",
   "private": false,
   "description": "coze coding devtools cli",
   "license": "MIT",
@@ -19,13 +19,13 @@
   "scripts": {
     "prebuild": "tsx scripts/prebuild.ts",
     "build": "tsx scripts/build.ts",
-    "generate-templates": "tsx scripts/generate-templates-config.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"
@@ -49,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": {