@coze-arch/cli 0.0.1-alpha.01c0ee

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

@@ -0,0 +1,6 @@
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};

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

@@ -0,0 +1,17 @@
+#!/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
+
+echo "Building frontend with Vite..."
+npx vite build
+
+echo "Bundling server with tsup..."
+npx tsup server/server.ts --format cjs --platform node --target node20 --outDir dist-server --no-splitting --no-minify --external vite
+
+echo "Build completed successfully!"

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

@@ -0,0 +1,39 @@
+#!/bin/bash
+set -Eeuo pipefail
+
+<% if (process.env.NODE_ENV === 'test') { %>
+# 测试环境：支持环境变量覆盖端口
+PORT="${PORT:-<%= port %>}"
+COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
+DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
+<% } else { %>
+PORT=<%= port %>
+COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
+DEPLOY_RUN_PORT=<%= port %>
+<% } %>
+
+cd "${COZE_WORKSPACE_PATH}"
+
+kill_port_if_listening() {
+    local pids
+    pids=$(ss -H -lntp 2>/dev/null | awk -v port="${DEPLOY_RUN_PORT}" '$4 ~ ":"port"$"' | grep -o 'pid=[0-9]*' | cut -d= -f2 | paste -sd' ' - || true)
+    if [[ -z "${pids}" ]]; then
+      echo "Port ${DEPLOY_RUN_PORT} is free."
+      return
+    fi
+    echo "Port ${DEPLOY_RUN_PORT} in use by PIDs: ${pids} (SIGKILL)"
+    echo "${pids}" | xargs -I {} kill -9 {}
+    sleep 1
+    pids=$(ss -H -lntp 2>/dev/null | awk -v port="${DEPLOY_RUN_PORT}" '$4 ~ ":"port"$"' | grep -o 'pid=[0-9]*' | cut -d= -f2 | paste -sd' ' - || true)
+    if [[ -n "${pids}" ]]; then
+      echo "Warning: port ${DEPLOY_RUN_PORT} still busy after SIGKILL, PIDs: ${pids}"
+    else
+      echo "Port ${DEPLOY_RUN_PORT} cleared."
+    fi
+}
+
+echo "Clearing port ${PORT} before start."
+kill_port_if_listening
+echo "Starting express + Vite dev server on port ${PORT}..."
+
+PORT=$PORT npx tsx watch server/server.ts

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/scripts/start.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+set -Eeuo pipefail
+
+COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
+<% if (process.env.NODE_ENV === 'test') { %>
+# 测试环境：支持环境变量覆盖端口
+PORT="${PORT:-<%= port %>}"
+DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
+<% } else { %>
+PORT=<%= port %>
+DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-$PORT}"
+<% } %>
+
+start_service() {
+    cd "${COZE_WORKSPACE_PATH}"
+    echo "Starting express production server on port ${DEPLOY_RUN_PORT}..."
+    PORT=$DEPLOY_RUN_PORT node dist-server/server.js
+}
+
+echo "Starting express production server on port ${DEPLOY_RUN_PORT}..."
+start_service

package/lib/__templates__/vite/server/routes/index.ts

@@ -0,0 +1,31 @@
+import { Router } from 'express';
+
+const router = Router();
+
+// API 路由示例
+router.get('/api/hello', (req, res) => {
+  res.json({
+    message: 'Hello from Express + Vite!',
+    timestamp: new Date().toISOString(),
+  });
+});
+
+router.post('/api/data', (req, res) => {
+  const requestData = req.body;
+  res.json({
+    success: true,
+    data: requestData,
+    receivedAt: new Date().toISOString(),
+  });
+});
+
+// 健康检查接口
+router.get('/api/health', (req, res) => {
+  res.json({
+    status: 'ok',
+    env: process.env.COZE_PROJECT_ENV,
+    timestamp: new Date().toISOString(),
+  });
+});
+
+export default router;

package/lib/__templates__/vite/server/server.ts

@@ -0,0 +1,65 @@
+// ABOUTME: Express server with Vite integration
+// ABOUTME: Handles API routes and serves frontend in dev/prod modes
+
+import { createServer, type Server } from 'http';
+import express from 'express';
+import router from './routes/index';
+import { setupVite } from './vite';
+
+const isDev = process.env.COZE_PROJECT_ENV !== 'PROD';
+const port = parseInt(process.env.PORT || '<%= port %>', 10);
+const hostname = process.env.HOSTNAME || 'localhost';
+const app = express();
+// 使用 http.createServer 包装 Express app，以便支持 WebSocket 等协议升级
+const server = createServer(app);
+
+async function startServer(): Promise<Server> {
+  // 请求日志（仅开发环境）
+  if (isDev) {
+    app.use((req, res, next) => {
+      const start = Date.now();
+      res.on('finish', () => {
+        const ms = Date.now() - start;
+        console.log(`${req.method} ${req.url} - ${ms}ms`);
+      });
+      next();
+    });
+  }
+
+  // 添加请求体解析
+  app.use(express.json());
+  app.use(express.urlencoded({ extended: true }));
+
+  // 注册 API 路由
+  app.use(router);
+
+  // 集成 Vite（开发模式）或静态文件服务（生产模式）
+  await setupVite(app);
+
+  // 全局错误处理
+  app.use((err: Error, req: express.Request, res: express.Response) => {
+    console.error('Server error:', err);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const status = 'status' in err ? (err as any).status || 500 : 500;
+    res.status(status).json({
+      error: err.message || 'Internal server error',
+    });
+  });
+
+  server.once('error', err => {
+    console.error('Server error:', err);
+    process.exit(1);
+  });
+
+  server.listen(port, () => {
+    console.log(`\n✨ Server running at http://${hostname}:${port}`);
+    console.log(`📝 Environment: ${isDev ? 'development' : 'production'}\n`);
+  });
+
+  return server;
+}
+
+startServer().catch(err => {
+  console.error('Failed to start server:', err);
+  process.exit(1);
+});

package/lib/__templates__/vite/server/vite.ts

@@ -0,0 +1,67 @@
+// ABOUTME: Vite integration for Express server
+// ABOUTME: Handles dev middleware and production static file serving
+
+import type { Application, Request, Response } from 'express';
+import express from 'express';
+import path from 'path';
+import fs from 'fs';
+import { createServer as createViteServer } from 'vite';
+import viteConfig from '../vite.config';
+
+const isDev = process.env.COZE_PROJECT_ENV !== 'PROD';
+
+/**
+ * 集成 Vite 开发服务器（中间件模式）
+ */
+export async function setupViteMiddleware(app: Application) {
+  const vite = await createViteServer({
+    ...viteConfig,
+    server: {
+      ...viteConfig.server,
+      middlewareMode: true,
+    },
+    appType: 'spa',
+  });
+
+  // 使用 Vite middleware
+  app.use(vite.middlewares);
+
+  console.log('🚀 Vite dev server initialized');
+}
+
+/**
+ * 设置生产环境静态文件服务
+ */
+export function setupStaticServer(app: Application) {
+  const distPath = path.resolve(process.cwd(), 'dist');
+
+  if (!fs.existsSync(distPath)) {
+    console.error('❌ dist folder not found. Please run "pnpm build" first.');
+    process.exit(1);
+  }
+
+  // 1. 服务静态文件（如果存在对应文件则直接返回）
+  app.use(express.static(distPath));
+
+  // 2. SPA fallback - 所有未处理的请求返回 index.html
+  // 到达这里的请求说明：
+  //   - 不是 API 请求（已被前面注册的路由处理）
+  //   - 不是静态文件（express.static 未找到对应文件）
+  //   - 需要返回 index.html 让前端路由处理
+  app.use((_req: Request, res: Response) => {
+    res.sendFile(path.join(distPath, 'index.html'));
+  });
+
+  console.log('📦 Serving static files from dist/');
+}
+
+/**
+ * 根据环境设置 Vite
+ */
+export async function setupVite(app: Application) {
+  if (isDev) {
+    await setupViteMiddleware(app);
+  } else {
+    setupStaticServer(app);
+  }
+}

package/lib/__templates__/vite/src/index.css

@@ -0,0 +1,21 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+:root {
+  --background: #ffffff;
+  --foreground: #171717;
+}
+
+@media (prefers-color-scheme: dark) {
+  :root {
+    --background: #0a0a0a;
+    --foreground: #ededed;
+  }
+}
+
+body {
+  background: var(--background);
+  color: var(--foreground);
+  font-family: Arial, Helvetica, sans-serif;
+}

package/lib/__templates__/vite/src/index.ts

@@ -0,0 +1,5 @@
+import './index.css';
+import { initApp } from './main';
+
+// Initialize the application
+initApp();

package/lib/__templates__/vite/src/main.ts

@@ -0,0 +1,34 @@
+export function initApp(): void {
+  const app = document.getElementById('app');
+
+  if (!app) {
+    console.error('App element not found');
+    return;
+  }
+
+  app.innerHTML = `
+    <div class="flex h-full items-center justify-center bg-background text-foreground transition-colors duration-300 dark:bg-background dark:text-foreground overflow-hidden min-h-screen">
+      <main class="flex w-full h-full max-w-3xl flex-col items-center justify-center px-16 py-32 sm:items-center">
+        <div class="flex flex-col items-center justify-between gap-4">
+          <img
+            src="https://lf-coze-web-cdn.coze.cn/obj/eden-cn/lm-lgvj/ljhwZthlaukjlkulzlp/coze-coding/icon/coze-coding.gif"
+            alt="扣子编程 Logo"
+            width={156}
+            height={130}
+            style="width: 156px; height: 130px; object-fit: contain;"
+          />
+          <div>
+            <div class="flex flex-col items-center gap-2 text-center sm:items-center sm:text-center">
+              <h1 class="max-w-xl text-base font-semibold leading-tight tracking-tight text-foreground dark:text-foreground">
+                应用开发中
+              </h1>
+              <p class="max-w-2xl text-sm-14 leading-8 text-muted-foreground dark:text-muted-foreground">
+                请稍后，页面即将呈现
+              </p>
+            </div>
+          </div>
+        </div>
+      </main>
+    </div>
+  `;
+}

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

@@ -0,0 +1,9 @@
+/** @type {import('tailwindcss').Config} */
+export default {
+  content: ['./index.html', './src/**/*.{js,ts,jsx,tsx}'],
+  darkMode: 'media',
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+};

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

@@ -0,0 +1,127 @@
+
+import { spawn } from 'child_process';
+import { resolve, join, basename } from 'path';
+import { appendFileSync, openSync, closeSync, mkdirSync } from 'fs';
+
+
+
+
+
+
+
+
+
+export const paramsSchema = {
+  type: 'object',
+  properties: {
+    appName: {
+      type: 'string',
+      minLength: 1,
+      pattern: '^[a-z0-9-]+$',
+      description:
+        'Application name (lowercase, alphanumeric and hyphens only)',
+    },
+    port: {
+      type: 'number',
+      default: 5000,
+      minimum: 1024,
+      maximum: 65535,
+      description: 'Development server port',
+    },
+    hmrPort: {
+      type: 'number',
+      default: 6000,
+      minimum: 1024,
+      maximum: 65535,
+      description: 'Development HMR server port',
+    },
+  },
+  required: [],
+  additionalProperties: false,
+};
+
+const description = `Vite（简单项目）：\`coze init \${COZE_WORKSPACE_PATH} --template vite\`
+- 适用：轻量级 SPA、纯前端交互、仪表盘等轻量级项目。`;
+
+const config = {
+  description: description,
+  paramsSchema,
+
+  defaultParams: {
+    port: 5000,
+    hmrPort: 6000,
+    appName: 'projects',
+  },
+
+  onBeforeRender: async context => {
+    console.log(
+      `Creating Vanilla TypeScript + Vite project: ${context.appName}`,
+    );
+    return context;
+  },
+
+  onAfterRender: async (_context, outputPath) => {
+    console.log(`\nProject created at: ${outputPath}`);
+    console.log('\nConfiguration:');
+    console.log('  - Framework: vite');
+    console.log('  - TypeScript: enabled');
+    console.log('  - App Router: enabled');
+    console.log(`  - Port: ${_context.port}`);
+  },
+
+  onComplete: async (_context, outputPath) => {
+    // Skip pnpm update 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';
+    const args = ['update', 'coze-coding-dev-sdk@^0.7.0'];
+    console.log(
+      `\nTriggering: ${cmd} ${args.join(' ')} (running in background)`,
+    );
+
+    try {
+      const projectRoot = resolve(outputPath);
+
+      // Determine log directory
+      const logDir = process.env.COZE_LOG_DIR || resolve(__dirname, '../.log');
+      mkdirSync(logDir, { recursive: true });
+
+      // Use project name in log file to avoid conflicts
+      const projectName = basename(projectRoot);
+      const logFile = join(logDir, `${projectName}-init.log`);
+
+      // Write log header
+      const timestamp = new Date().toISOString();
+      appendFileSync(
+        logFile,
+        `\n=== [${timestamp}] ${cmd} ${args.join(' ')} ===\n`,
+      );
+
+      // Open log file for appending
+      const logFd = openSync(logFile, 'a');
+
+      // Spawn in detached mode
+      const child = spawn(cmd, args, {
+        cwd: projectRoot,
+        detached: true,
+        stdio: ['ignore', logFd, logFd],
+      });
+
+      child.unref();
+      closeSync(logFd);
+
+      console.log(
+        '✓ coze-coding-dev-sdk update triggered (running in background)',
+      );
+      console.log(`  Log file: ${logFile}`);
+    } catch (error) {
+      console.error('✗ Failed to trigger coze-coding-dev-sdk update:', error);
+      console.log('  You can manually run: pnpm update coze-coding-dev-sdk');
+    }
+  },
+};
+
+export default config;

package/lib/__templates__/vite/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "types": ["node"]
+  },
+  "include": ["src", "server"]
+}

package/lib/__templates__/vite/vite.config.ts

@@ -0,0 +1,20 @@
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  server: {
+    port: <%= port %>,
+    host: '0.0.0.0',
+    allowedHosts: true,
+    hmr: {
+      overlay: true,
+      path: '/hot/vite-hmr',
+      port: <%= hmrPort %>,
+      clientPort: 443,
+      timeout: 30000,
+    },
+    watch: {
+      usePolling: true,
+      interval: 100,
+    }
+  },
+});