@coze-arch/cli 0.0.1-alpha.a8e799 → 0.0.1-alpha.aea179

package/lib/__templates__/vite/scripts/prepare.sh

@@ -0,0 +1,9 @@
+#!/bin/bash
+set -Eeuo pipefail
+
+COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
+
+cd "${COZE_WORKSPACE_PATH}"
+
+echo "Installing dependencies..."
+pnpm install --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only

package/lib/__templates__/vite/template.config.js

@@ -37,7 +37,11 @@ export const paramsSchema = {
   additionalProperties: false,
 };
 
+const description = `Vite（简单项目）：\`coze init \${COZE_WORKSPACE_PATH} --template vite\`
+- 适用：轻量级 SPA、纯前端交互、仪表盘等轻量级项目。`;
+
 const config = {
+  description: description,
   paramsSchema,
 
   defaultParams: {
@@ -55,11 +59,31 @@ const config = {
 
   onAfterRender: async (context, outputPath) => {
     console.log(`\nProject created at: ${outputPath}`);
-    console.log(`\nConfiguration:`);
-    console.log(`  - TypeScript: enabled`);
-    console.log(`  - Framework: None (Vanilla JS/TS)`);
-    console.log(`  - Build Tool: Vite`);
+    console.log('\nConfiguration:');
+    console.log('  - Framework: vite');
+    console.log('  - TypeScript: enabled');
+    console.log('  - App Router: enabled');
     console.log(`  - Port: ${context.port}`);
+
+    // Skip pnpm add in test environment to avoid monorepo workspace issues
+    if (process.env.NODE_ENV === 'test') {
+      console.log('⊘ Skipping dependency update in test environment');
+      return;
+    }
+
+    const cmd = `pnpm add coze-coding-dev-sdk@"^0.7.0"`;
+    console.log(`${cmd}`);
+    try {
+      const projectRoot = resolve(outputPath);
+      execSync(cmd, {
+        cwd: projectRoot,
+        stdio: 'inherit',
+      });
+      console.log('✓ coze-coding-dev-sdk updated successfully');
+    } catch (error) {
+      console.error('✗ Failed to update coze-coding-dev-sdk:', error);
+      throw error;
+    }
   },
 };
 

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 os = require('os');
 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');
@@ -826,23 +826,48 @@ const getCommandConfig = (
 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 createLogManager = (logDir = '.coze-logs') => {
-  const ensureLogDir = () => {
-    if (!fs.existsSync(logDir)) {
-      fs.mkdirSync(logDir, { recursive: true });
-    }
-  };
+const LOG_FILE_NAME = 'dev.log';
+
+/**
+ * 获取日志目录
+ * 优先使用环境变量 COZE_LOG_DIR，否则使用 ~/.coze-logs
+ */
+const getLogDir = () =>
+  process.env.COZE_LOG_DIR || path.join(os.homedir(), '.coze-logs');
 
-  const getLogPath = (logFile) => path.join(logDir, logFile);
+/**
+ * 解析日志文件路径
+ * - 如果是绝对路径，直接使用
+ * - 如果是相对路径，基于 getLogDir() + 相对路径
+ * - 如果为空，使用 getLogDir() + LOG_FILE_NAME
+ */
+const resolveLogFilePath = (logFile) => {
+  if (!logFile) {
+    return path.join(getLogDir(), LOG_FILE_NAME);
+  }
 
-  return {
-    createWriteStream: (logFile) => {
-      ensureLogDir();
-      return fs.createWriteStream(getLogPath(logFile), { flags: 'a' });
-    },
-  };
+  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' });
 };
 
 /**
@@ -860,16 +885,15 @@ const executeRun = async (
     const commandArgs = getCommandConfig(config, commandName);
 
     // 2. 准备日志
-    const logManager = createLogManager();
-    const logFile = options.logFile || `${commandName}.log`;
-    const logStream = logManager.createWriteStream(logFile);
+    const logFilePath = resolveLogFilePath(options.logFile);
+    const logStream = createLogStream(logFilePath);
 
     // 3. 执行命令
     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 +922,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 +1272,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 +1435,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 +1630,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);
@@ -1741,7 +1878,7 @@ const registerCommand = program => {
     });
 };
 
-var version = "0.0.1-alpha.a8e799";
+var version = "0.0.1-alpha.aea179";
 var packageJson = {
 	version: version};
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coze-arch/cli",
-  "version": "0.0.1-alpha.a8e799",
+  "version": "0.0.1-alpha.aea179",
   "private": false,
   "description": "coze coding devtools cli",
   "license": "MIT",
@@ -25,14 +25,13 @@
     "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"
   },
   "dependencies": {
     "@iarna/toml": "^2.2.5",
-    "@inquirer/prompts": "^3.2.0",
     "ajv": "^8.17.1",
     "ajv-formats": "^3.0.1",
     "change-case": "^5.4.4",
@@ -50,14 +49,17 @@
     "@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",

package/lib/__templates__/nextjs/.vscode/settings.json

@@ -1,121 +0,0 @@
-{
-  "[css]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[dotenv]": {
-    "editor.defaultFormatter": "foxundermoon.shell-format"
-  },
-  "[html]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[ignore]": {
-    "editor.defaultFormatter": "foxundermoon.shell-format"
-  },
-  "[javascript]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[javascriptreact]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[json]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[jsonc]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[less]": {
-    "editor.defaultFormatter": "stylelint.vscode-stylelint"
-  },
-  "[scss]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[shellscript]": {
-    "editor.defaultFormatter": "foxundermoon.shell-format"
-  },
-  "[sql]": {
-    "editor.defaultFormatter": "adpyke.vscode-sql-formatter"
-  },
-  "[svg]": {
-    "editor.defaultFormatter": "jock.svg"
-  },
-  "[typescript]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[typescriptreact]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[xml]": {
-    "editor.defaultFormatter": "mblode.pretty-formatter"
-  },
-  "[yaml]": {
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "cSpell.diagnosticLevel": "Warning",
-  "css.validate": false,
-  "editor.codeActionsOnSave": {
-    "source.fixAll": "never",
-    "source.fixAll.eslint": "explicit",
-    "source.organizeImports": "never",
-    "source.removeUnused": "never",
-    "source.removeUnused.ts": "never",
-    "source.removeUnusedImports": "never",
-    "source.sort.json": "never"
-    // "source.sortImports": "always"
-  },
-  "editor.defaultFormatter": "esbenp.prettier-vscode",
-  "editor.formatOnPaste": false,
-  "editor.formatOnSave": true,
-  "editor.formatOnType": false,
-  "editor.insertSpaces": true,
-  "editor.minimap.enabled": true,
-  //
-  "editor.rulers": [80, 120],
-  "editor.semanticHighlighting.enabled": false,
-  "editor.tabSize": 2,
-  "emmet.triggerExpansionOnTab": true,
-  "files.associations": {
-    ".babelrc": "json",
-    ".code-workspace": "jsonc",
-    ".eslintrc": "jsonc",
-    ".eslintrc*.json": "jsonc",
-    ".htmlhintrc": "jsonc",
-    ".stylelintrc": "javascript",
-    "*.json": "jsonc",
-    "*.log": "plaintext",
-    "*.map": "plaintext",
-    "**/coverage/**/*.*": "plaintext",
-    "**/pnpm-lock.yaml": "plaintext",
-    "htmlhintrc": "jsonc",
-    "package.json": "json",
-    "README": "markdown",
-    "stylelintrc": "jsonc",
-    ".coze": "toml"
-  },
-  "files.defaultLanguage": "plaintext",
-  "files.eol": "\n",
-  "files.exclude": {
-    "**/.DS_Store": true,
-    "**/.git": true,
-    "**/.hg": true,
-    "**/.svn": true,
-    // "**/.lintcache": true,
-    "**/.swc": true,
-    "**/CVS": true,
-    "**/Thumbs.db": true
-  },
-  "files.insertFinalNewline": true,
-  "files.trimTrailingWhitespace": true,
-  "files.watcherExclude": {
-    "**/.git/objects/**": true,
-    "**/.git/subtree-cache/**": true,
-    "**/node_modules/*/**": true
-  },
-  "git.openRepositoryInParentFolders": "always",
-  "search.exclude": {
-    "**/dist": true,
-    "**/node_modules": true
-  },
-  // "editor.formatOnSaveMode": "modificationsIfAvailable",
-  "search.followSymlinks": false,
-  "search.useIgnoreFiles": true
-}

package/lib/__templates__/vite/.vscode/settings.json

@@ -1,7 +0,0 @@
-{
-  "editor.formatOnSave": true,
-  "editor.codeActionsOnSave": {
-    "source.fixAll.eslint": "explicit"
-  },
-  "typescript.tsdk": "node_modules/typescript/lib"
-}