@lark-apaas/fullstack-cli 1.1.16-beta.12 → 1.1.16-beta.14

package/dist/config/drizzle.config.js

@@ -1,6 +1,6 @@
 // src/config/drizzle.config.ts
 import { defineConfig } from "drizzle-kit";
-var outputDir = process.env.__DRIZZLE_OUT_DIR__ || "./server/database/.introspect";
+var outputDir = process.env.__DRIZZLE_OUT_DIR__ || "./tmp/.introspect";
 var schemaPath = process.env.__DRIZZLE_SCHEMA_PATH__ || "./server/database/schema.ts";
 var parsedUrl = new URL(process.env.SUDA_DATABASE_URL || "");
 var envSchemaFilter = process.env.DRIZZLE_SCHEMA_FILTER;

package/dist/index.js

@@ -2167,7 +2167,9 @@ async function run(options = {}) {
     process.exit(1);
   }
   const outputPath = options.output || process.env.DB_SCHEMA_OUTPUT || "server/database/schema.ts";
-  const OUT_DIR = path2.resolve(process.cwd(), "server/database/.introspect");
+  const INTROSPECT_ROOT = path2.resolve(process.cwd(), "tmp/.introspect");
+  fs4.mkdirSync(INTROSPECT_ROOT, { recursive: true });
+  const OUT_DIR = fs4.mkdtempSync(path2.join(INTROSPECT_ROOT, "run-"));
   const SCHEMA_FILE = path2.resolve(process.cwd(), outputPath);
   console.log("[gen-db-schema] Starting...");
   const __filename = fileURLToPath2(import.meta.url);
@@ -2363,8 +2365,8 @@ var genDbSchemaCommand = {
 };
 
 // src/commands/sync/run.handler.ts
-import path4 from "path";
-import fs6 from "fs";
+import path5 from "path";
+import fs7 from "fs";
 import { fileURLToPath as fileURLToPath3 } from "url";
 
 // src/config/sync.ts
@@ -2525,18 +2527,93 @@ function deepMergeJson(user, template, arrayMerge = {}, currentPath = "") {
   return result;
 }
 
+// src/utils/package-json.ts
+import fs6 from "fs";
+import path4 from "path";
+var LEGACY_LINT_SCRIPT = 'concurrently "npm run eslint" "npm run type:check" "npm run stylelint"';
+var PATCHED_LINT_SCRIPT = "node ./scripts/lint.js";
+function readPackageJson(cwd = process.cwd()) {
+  const pkgPath = path4.join(cwd, "package.json");
+  if (!fs6.existsSync(pkgPath)) {
+    throw new Error(`package.json not found at ${pkgPath}`);
+  }
+  const content = fs6.readFileSync(pkgPath, "utf-8");
+  return JSON.parse(content);
+}
+function writePackageJson(pkg2, cwd = process.cwd()) {
+  const pkgPath = path4.join(cwd, "package.json");
+  const content = JSON.stringify(pkg2, null, 2) + "\n";
+  fs6.writeFileSync(pkgPath, content, "utf-8");
+}
+function patchLintScriptForFilesSupport(pkg2) {
+  const currentLint = pkg2.scripts?.lint;
+  if (!currentLint) {
+    return "skipped-missing";
+  }
+  if (currentLint === PATCHED_LINT_SCRIPT || currentLint === "node scripts/lint.js") {
+    return "already-patched";
+  }
+  if (currentLint !== LEGACY_LINT_SCRIPT) {
+    return "skipped-custom";
+  }
+  pkg2.scripts = pkg2.scripts || {};
+  pkg2.scripts.lint = PATCHED_LINT_SCRIPT;
+  return "patched";
+}
+function removeUpgradeScript(pkg2) {
+  if (!pkg2.scripts?.upgrade) {
+    return false;
+  }
+  delete pkg2.scripts.upgrade;
+  return true;
+}
+function cleanDevScript(pkg2) {
+  if (!pkg2.scripts?.dev) {
+    return false;
+  }
+  const originalDev = pkg2.scripts.dev;
+  const cleanedDev = originalDev.replace(/npm\s+run\s+upgrade\s*&&\s*/g, "").replace(/npm\s+run\s+upgrade\s*$/g, "").trim();
+  if (cleanedDev !== originalDev) {
+    pkg2.scripts.dev = cleanedDev;
+    return true;
+  }
+  return false;
+}
+function cleanupPackageJson(cwd = process.cwd()) {
+  try {
+    const pkg2 = readPackageJson(cwd);
+    let changed = false;
+    if (removeUpgradeScript(pkg2)) {
+      console.log("[fullstack-cli] \u2713 Removed scripts.upgrade");
+      changed = true;
+    }
+    if (cleanDevScript(pkg2)) {
+      console.log("[fullstack-cli] \u2713 Cleaned scripts.dev (removed npm run upgrade)");
+      changed = true;
+    }
+    if (changed) {
+      writePackageJson(pkg2, cwd);
+    }
+    return changed;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.log(`[fullstack-cli] \u26A0 Could not cleanup package.json: ${message}`);
+    return false;
+  }
+}
+
 // src/commands/sync/run.handler.ts
 async function run2(options) {
   const userProjectRoot = process.env.INIT_CWD || process.cwd();
   const __filename = fileURLToPath3(import.meta.url);
-  const __dirname2 = path4.dirname(__filename);
-  const pluginRoot = path4.resolve(__dirname2, "..");
+  const __dirname2 = path5.dirname(__filename);
+  const pluginRoot = path5.resolve(__dirname2, "..");
   if (userProjectRoot === pluginRoot) {
     console.log("[fullstack-cli] Skip syncing (installing plugin itself)");
     process.exit(0);
   }
-  const userPackageJson = path4.join(userProjectRoot, "package.json");
-  if (!fs6.existsSync(userPackageJson)) {
+  const userPackageJson = path5.join(userProjectRoot, "package.json");
+  if (!fs7.existsSync(userPackageJson)) {
     console.log("[fullstack-cli] Skip syncing (not a valid npm project)");
     process.exit(0);
   }
@@ -2552,6 +2629,7 @@ async function run2(options) {
     for (const rule of config.sync) {
       await syncRule(rule, pluginRoot, userProjectRoot);
     }
+    patchUserPackageJson(userProjectRoot);
     if (config.permissions) {
       setPermissions(config.permissions, userProjectRoot);
     }
@@ -2562,9 +2640,32 @@ async function run2(options) {
     process.exit(1);
   }
 }
+function patchUserPackageJson(userProjectRoot) {
+  try {
+    const pkg2 = readPackageJson(userProjectRoot);
+    const lintPatchResult = patchLintScriptForFilesSupport(pkg2);
+    if (lintPatchResult === "patched") {
+      writePackageJson(pkg2, userProjectRoot);
+      console.log("[fullstack-cli] \u2713 Patched scripts.lint to support --files");
+      return;
+    }
+    if (lintPatchResult === "already-patched") {
+      console.log("[fullstack-cli] \u25CB scripts.lint already supports --files");
+      return;
+    }
+    if (lintPatchResult === "skipped-custom") {
+      console.warn(
+        "[fullstack-cli] \u26A0 Skipped patching scripts.lint because it has been customized"
+      );
+    }
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.warn(`[fullstack-cli] \u26A0 Could not patch package.json: ${message}`);
+  }
+}
 async function syncRule(rule, pluginRoot, userProjectRoot) {
   if (rule.type === "delete-file" || rule.type === "delete-directory") {
-    const destPath2 = path4.join(userProjectRoot, rule.to);
+    const destPath2 = path5.join(userProjectRoot, rule.to);
     if (rule.type === "delete-file") {
       deleteFile(destPath2);
     } else {
@@ -2573,32 +2674,32 @@ async function syncRule(rule, pluginRoot, userProjectRoot) {
     return;
   }
   if (rule.type === "remove-line") {
-    const destPath2 = path4.join(userProjectRoot, rule.to);
+    const destPath2 = path5.join(userProjectRoot, rule.to);
     removeLineFromFile(destPath2, rule.pattern);
     return;
   }
   if (rule.type === "add-script") {
-    const packageJsonPath = path4.join(userProjectRoot, "package.json");
+    const packageJsonPath = path5.join(userProjectRoot, "package.json");
     addScript(packageJsonPath, rule.name, rule.command, rule.overwrite ?? false);
     return;
   }
   if (rule.type === "add-line") {
-    const destPath2 = path4.join(userProjectRoot, rule.to);
+    const destPath2 = path5.join(userProjectRoot, rule.to);
     addLineToFile(destPath2, rule.line);
     return;
   }
   if (rule.type === "merge-json") {
-    const srcPath2 = path4.join(pluginRoot, rule.from);
-    const destPath2 = path4.join(userProjectRoot, rule.to);
+    const srcPath2 = path5.join(pluginRoot, rule.from);
+    const destPath2 = path5.join(userProjectRoot, rule.to);
     mergeJsonFile(srcPath2, destPath2, rule.arrayMerge);
     return;
   }
   if (!("from" in rule)) {
     return;
   }
-  const srcPath = path4.join(pluginRoot, rule.from);
-  const destPath = path4.join(userProjectRoot, rule.to);
-  if (!fs6.existsSync(srcPath)) {
+  const srcPath = path5.join(pluginRoot, rule.from);
+  const destPath = path5.join(userProjectRoot, rule.to);
+  if (!fs7.existsSync(srcPath)) {
     console.warn(`[fullstack-cli] Source not found: ${rule.from}`);
     return;
   }
@@ -2615,68 +2716,68 @@ async function syncRule(rule, pluginRoot, userProjectRoot) {
   }
 }
 function syncFile(src, dest, overwrite = true, onlyIfExists = false) {
-  if (onlyIfExists && !fs6.existsSync(dest)) {
-    console.log(`[fullstack-cli] \u25CB ${path4.basename(dest)} (skipped, target not exists)`);
+  if (onlyIfExists && !fs7.existsSync(dest)) {
+    console.log(`[fullstack-cli] \u25CB ${path5.basename(dest)} (skipped, target not exists)`);
     return;
   }
-  const destDir = path4.dirname(dest);
-  if (!fs6.existsSync(destDir)) {
-    fs6.mkdirSync(destDir, { recursive: true });
+  const destDir = path5.dirname(dest);
+  if (!fs7.existsSync(destDir)) {
+    fs7.mkdirSync(destDir, { recursive: true });
   }
-  if (fs6.existsSync(dest) && !overwrite) {
-    console.log(`[fullstack-cli] \u25CB ${path4.basename(dest)} (skipped, already exists)`);
+  if (fs7.existsSync(dest) && !overwrite) {
+    console.log(`[fullstack-cli] \u25CB ${path5.basename(dest)} (skipped, already exists)`);
     return;
   }
-  fs6.copyFileSync(src, dest);
-  console.log(`[fullstack-cli] \u2713 ${path4.basename(dest)}`);
+  fs7.copyFileSync(src, dest);
+  console.log(`[fullstack-cli] \u2713 ${path5.basename(dest)}`);
 }
 function syncDirectory(src, dest, overwrite = true) {
-  if (!fs6.existsSync(dest)) {
-    fs6.mkdirSync(dest, { recursive: true });
+  if (!fs7.existsSync(dest)) {
+    fs7.mkdirSync(dest, { recursive: true });
   }
-  const files = fs6.readdirSync(src);
+  const files = fs7.readdirSync(src);
   let count = 0;
   files.forEach((file) => {
-    const srcFile = path4.join(src, file);
-    const destFile = path4.join(dest, file);
-    const stats = fs6.statSync(srcFile);
+    const srcFile = path5.join(src, file);
+    const destFile = path5.join(dest, file);
+    const stats = fs7.statSync(srcFile);
     if (stats.isDirectory()) {
       syncDirectory(srcFile, destFile, overwrite);
     } else {
-      if (overwrite || !fs6.existsSync(destFile)) {
-        fs6.copyFileSync(srcFile, destFile);
-        console.log(`[fullstack-cli] \u2713 ${path4.relative(dest, destFile)}`);
+      if (overwrite || !fs7.existsSync(destFile)) {
+        fs7.copyFileSync(srcFile, destFile);
+        console.log(`[fullstack-cli] \u2713 ${path5.relative(dest, destFile)}`);
         count++;
       }
     }
   });
   if (count > 0) {
-    console.log(`[fullstack-cli] Synced ${count} files to ${path4.basename(dest)}/`);
+    console.log(`[fullstack-cli] Synced ${count} files to ${path5.basename(dest)}/`);
   }
 }
 function appendToFile(src, dest) {
-  const content = fs6.readFileSync(src, "utf-8");
+  const content = fs7.readFileSync(src, "utf-8");
   let existingContent = "";
-  if (fs6.existsSync(dest)) {
-    existingContent = fs6.readFileSync(dest, "utf-8");
+  if (fs7.existsSync(dest)) {
+    existingContent = fs7.readFileSync(dest, "utf-8");
   }
   if (existingContent.includes(content.trim())) {
-    console.log(`[fullstack-cli] \u25CB ${path4.basename(dest)} (already contains content)`);
+    console.log(`[fullstack-cli] \u25CB ${path5.basename(dest)} (already contains content)`);
     return;
   }
-  fs6.appendFileSync(dest, content);
-  console.log(`[fullstack-cli] \u2713 ${path4.basename(dest)} (appended)`);
+  fs7.appendFileSync(dest, content);
+  console.log(`[fullstack-cli] \u2713 ${path5.basename(dest)} (appended)`);
 }
 function setPermissions(permissions, projectRoot) {
   for (const [pattern, mode] of Object.entries(permissions)) {
     if (pattern === "**/*.sh") {
-      const scriptsDir = path4.join(projectRoot, "scripts");
-      if (fs6.existsSync(scriptsDir)) {
-        const files = fs6.readdirSync(scriptsDir);
+      const scriptsDir = path5.join(projectRoot, "scripts");
+      if (fs7.existsSync(scriptsDir)) {
+        const files = fs7.readdirSync(scriptsDir);
         files.forEach((file) => {
           if (file.endsWith(".sh")) {
-            const filePath = path4.join(scriptsDir, file);
-            fs6.chmodSync(filePath, mode);
+            const filePath = path5.join(scriptsDir, file);
+            fs7.chmodSync(filePath, mode);
           }
         });
       }
@@ -2684,27 +2785,27 @@ function setPermissions(permissions, projectRoot) {
   }
 }
 function deleteFile(filePath) {
-  if (fs6.existsSync(filePath)) {
-    fs6.unlinkSync(filePath);
-    console.log(`[fullstack-cli] \u2713 ${path4.basename(filePath)} (deleted)`);
+  if (fs7.existsSync(filePath)) {
+    fs7.unlinkSync(filePath);
+    console.log(`[fullstack-cli] \u2713 ${path5.basename(filePath)} (deleted)`);
   } else {
-    console.log(`[fullstack-cli] \u25CB ${path4.basename(filePath)} (not found)`);
+    console.log(`[fullstack-cli] \u25CB ${path5.basename(filePath)} (not found)`);
   }
 }
 function deleteDirectory(dirPath) {
-  if (fs6.existsSync(dirPath)) {
-    fs6.rmSync(dirPath, { recursive: true });
-    console.log(`[fullstack-cli] \u2713 ${path4.basename(dirPath)} (deleted)`);
+  if (fs7.existsSync(dirPath)) {
+    fs7.rmSync(dirPath, { recursive: true });
+    console.log(`[fullstack-cli] \u2713 ${path5.basename(dirPath)} (deleted)`);
   } else {
-    console.log(`[fullstack-cli] \u25CB ${path4.basename(dirPath)} (not found)`);
+    console.log(`[fullstack-cli] \u25CB ${path5.basename(dirPath)} (not found)`);
   }
 }
 function addScript(packageJsonPath, name, command, overwrite) {
-  if (!fs6.existsSync(packageJsonPath)) {
+  if (!fs7.existsSync(packageJsonPath)) {
     console.log(`[fullstack-cli] \u25CB package.json (not found)`);
     return;
   }
-  const content = fs6.readFileSync(packageJsonPath, "utf-8");
+  const content = fs7.readFileSync(packageJsonPath, "utf-8");
   const pkg2 = JSON.parse(content);
   if (!pkg2.scripts) {
     pkg2.scripts = {};
@@ -2716,42 +2817,42 @@ function addScript(packageJsonPath, name, command, overwrite) {
     }
   }
   pkg2.scripts[name] = command;
-  fs6.writeFileSync(packageJsonPath, JSON.stringify(pkg2, null, 2) + "\n");
+  fs7.writeFileSync(packageJsonPath, JSON.stringify(pkg2, null, 2) + "\n");
   console.log(`[fullstack-cli] \u2713 scripts.${name}`);
 }
 function addLineToFile(filePath, line) {
-  const fileName = path4.basename(filePath);
-  if (!fs6.existsSync(filePath)) {
+  const fileName = path5.basename(filePath);
+  if (!fs7.existsSync(filePath)) {
     console.log(`[fullstack-cli] \u25CB ${fileName} (not found, skipped)`);
     return;
   }
-  const content = fs6.readFileSync(filePath, "utf-8");
+  const content = fs7.readFileSync(filePath, "utf-8");
   const lines = content.split("\n").map((l) => l.trim());
   if (lines.includes(line)) {
     console.log(`[fullstack-cli] \u25CB ${fileName} (line already exists: ${line})`);
     return;
   }
   const appendContent = (content.endsWith("\n") ? "" : "\n") + line + "\n";
-  fs6.appendFileSync(filePath, appendContent);
+  fs7.appendFileSync(filePath, appendContent);
   console.log(`[fullstack-cli] \u2713 ${fileName} (added: ${line})`);
 }
 function mergeJsonFile(src, dest, arrayMerge) {
-  const fileName = path4.basename(dest);
-  if (!fs6.existsSync(src)) {
+  const fileName = path5.basename(dest);
+  if (!fs7.existsSync(src)) {
     console.warn(`[fullstack-cli] Source not found: ${src}`);
     return;
   }
-  const templateContent = JSON.parse(fs6.readFileSync(src, "utf-8"));
-  if (!fs6.existsSync(dest)) {
-    const destDir = path4.dirname(dest);
-    if (!fs6.existsSync(destDir)) {
-      fs6.mkdirSync(destDir, { recursive: true });
+  const templateContent = JSON.parse(fs7.readFileSync(src, "utf-8"));
+  if (!fs7.existsSync(dest)) {
+    const destDir = path5.dirname(dest);
+    if (!fs7.existsSync(destDir)) {
+      fs7.mkdirSync(destDir, { recursive: true });
     }
-    fs6.writeFileSync(dest, JSON.stringify(templateContent, null, 2) + "\n");
+    fs7.writeFileSync(dest, JSON.stringify(templateContent, null, 2) + "\n");
     console.log(`[fullstack-cli] \u2713 ${fileName} (created)`);
     return;
   }
-  const userContent = JSON.parse(fs6.readFileSync(dest, "utf-8"));
+  const userContent = JSON.parse(fs7.readFileSync(dest, "utf-8"));
   const merged = deepMergeJson(userContent, templateContent, arrayMerge ?? {});
   const userStr = JSON.stringify(userContent, null, 2);
   const mergedStr = JSON.stringify(merged, null, 2);
@@ -2759,7 +2860,7 @@ function mergeJsonFile(src, dest, arrayMerge) {
     console.log(`[fullstack-cli] \u25CB ${fileName} (already up to date)`);
     return;
   }
-  fs6.writeFileSync(dest, mergedStr + "\n");
+  fs7.writeFileSync(dest, mergedStr + "\n");
   console.log(`[fullstack-cli] \u2713 ${fileName} (merged)`);
 }
 
@@ -2820,12 +2921,12 @@ async function reportCreateInstanceEvent(pluginKey, version) {
 
 // src/utils/git.ts
 import { execSync, spawnSync as spawnSync2 } from "child_process";
-import fs7 from "fs";
-import path5 from "path";
+import fs8 from "fs";
+import path6 from "path";
 function isGitRepository(cwd = process.cwd()) {
   try {
-    const gitDir = path5.join(cwd, ".git");
-    if (fs7.existsSync(gitDir)) {
+    const gitDir = path6.join(cwd, ".git");
+    if (fs8.existsSync(gitDir)) {
       return true;
     }
     const result = spawnSync2("git", ["rev-parse", "--git-dir"], {
@@ -2854,7 +2955,7 @@ function getChangedFiles(cwd = process.cwd()) {
 function gitAddUpgradeFiles(cwd = process.cwd(), filesToStage) {
   const filteredFiles = [];
   for (const filePath of filesToStage) {
-    if (fs7.existsSync(path5.join(cwd, filePath))) {
+    if (fs8.existsSync(path6.join(cwd, filePath))) {
       filteredFiles.push(filePath);
       continue;
     }
@@ -2938,64 +3039,6 @@ Auto-committed by fullstack-cli`;
   }
 }
 
-// src/utils/package-json.ts
-import fs8 from "fs";
-import path6 from "path";
-function readPackageJson(cwd = process.cwd()) {
-  const pkgPath = path6.join(cwd, "package.json");
-  if (!fs8.existsSync(pkgPath)) {
-    throw new Error(`package.json not found at ${pkgPath}`);
-  }
-  const content = fs8.readFileSync(pkgPath, "utf-8");
-  return JSON.parse(content);
-}
-function writePackageJson(pkg2, cwd = process.cwd()) {
-  const pkgPath = path6.join(cwd, "package.json");
-  const content = JSON.stringify(pkg2, null, 2) + "\n";
-  fs8.writeFileSync(pkgPath, content, "utf-8");
-}
-function removeUpgradeScript(pkg2) {
-  if (!pkg2.scripts?.upgrade) {
-    return false;
-  }
-  delete pkg2.scripts.upgrade;
-  return true;
-}
-function cleanDevScript(pkg2) {
-  if (!pkg2.scripts?.dev) {
-    return false;
-  }
-  const originalDev = pkg2.scripts.dev;
-  const cleanedDev = originalDev.replace(/npm\s+run\s+upgrade\s*&&\s*/g, "").replace(/npm\s+run\s+upgrade\s*$/g, "").trim();
-  if (cleanedDev !== originalDev) {
-    pkg2.scripts.dev = cleanedDev;
-    return true;
-  }
-  return false;
-}
-function cleanupPackageJson(cwd = process.cwd()) {
-  try {
-    const pkg2 = readPackageJson(cwd);
-    let changed = false;
-    if (removeUpgradeScript(pkg2)) {
-      console.log("[fullstack-cli] \u2713 Removed scripts.upgrade");
-      changed = true;
-    }
-    if (cleanDevScript(pkg2)) {
-      console.log("[fullstack-cli] \u2713 Cleaned scripts.dev (removed npm run upgrade)");
-      changed = true;
-    }
-    if (changed) {
-      writePackageJson(pkg2, cwd);
-    }
-    return changed;
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    console.log(`[fullstack-cli] \u26A0 Could not cleanup package.json: ${message}`);
-    return false;
-  }
-}
-
 // src/commands/upgrade/shared/utils.ts
 import path7 from "path";
 import fs9 from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-cli",
-  "version": "1.1.16-beta.12",
+  "version": "1.1.16-beta.14",
   "description": "CLI tool for fullstack template management",
   "type": "module",
   "main": "dist/index.js",
@@ -56,6 +56,5 @@
   },
   "peerDependencies": {
     "typescript": "^5.9.2"
-  },
-  "migrationVersion": 1
+  }
 }

package/templates/drizzle.config.ts

@@ -1,7 +1,7 @@
 import { defineConfig, Config } from 'drizzle-kit';
 require('dotenv').config();
 
-const outputDir = process.env.__DRIZZLE_OUT_DIR__ || './server/database/.introspect';
+const outputDir = process.env.__DRIZZLE_OUT_DIR__ || './tmp/.introspect';
 const schemaPath = process.env.__DRIZZLE_SCHEMA_PATH__ || './server/database/schema.ts';
 
 const parsedUrl = new URL(process.env.SUDA_DATABASE_URL || '');

package/templates/scripts/build.sh

@@ -19,82 +19,149 @@ print_time() {
 }
 
 # ==================== 步骤 0 ====================
-echo "🗑️  [0/5] 安装插件"
+echo "🗑️  [0/6] 安装插件"
 STEP_START=$(node -e "console.log(Date.now())")
 npx fullstack-cli action-plugin init
 print_time $STEP_START
 echo ""
 
 # ==================== 步骤 1 ====================
-echo "📝 [1/5] 更新 openapi 代码"
+echo "📝 [1/6] 更新 openapi 代码"
 STEP_START=$(node -e "console.log(Date.now())")
 npm run gen:openapi
 print_time $STEP_START
 echo ""
 
 # ==================== 步骤 2 ====================
-echo "🗑️  [2/5] 清理 dist 目录"
+echo "🗑️  [2/6] 清理 dist 目录"
 STEP_START=$(node -e "console.log(Date.now())")
 rm -rf "$ROOT_DIR/dist"
 print_time $STEP_START
 echo ""
 
 # ==================== 步骤 3 ====================
-echo "🔨 [3/5] 并行构建 server 和 client"
+echo "🗺️  [3/6] 生成路由定义"
 STEP_START=$(node -e "console.log(Date.now())")
 
-# 并行构建
-echo "   ├─ 启动 server 构建..."
-npm run build:server > /tmp/build-server.log 2>&1 &
-SERVER_PID=$!
+# 在 client/server 构建之前生成到 dist/，供 DefinePlugin 注入前端 bundle
+# 注意：nest-cli.json 中 deleteOutDir 必须为 false（模板默认值），否则 nest build 会清掉 dist/
+echo "   ├─ 生成 API 路由定义..."
+npx generate-api-routes --server-dir ./server --out-dir ./dist > /tmp/gen-api-routes.log 2>&1 &
+API_ROUTES_PID=$!
 
-echo "   ├─ 启动 client 构建..."
-npm run build:client > /tmp/build-client.log 2>&1 &
-CLIENT_PID=$!
+echo "   ├─ 生成页面路由定义..."
+npx generate-page-routes --app-path ./client/src/app.tsx --out-dir ./dist > /tmp/gen-page-routes.log 2>&1 &
+PAGE_ROUTES_PID=$!
 
-# 等待两个构建完成
-SERVER_EXIT=0
-CLIENT_EXIT=0
+API_ROUTES_EXIT=0
+PAGE_ROUTES_EXIT=0
 
-wait $SERVER_PID || SERVER_EXIT=$?
-wait $CLIENT_PID || CLIENT_EXIT=$?
+wait $API_ROUTES_PID || API_ROUTES_EXIT=$?
+wait $PAGE_ROUTES_PID || PAGE_ROUTES_EXIT=$?
 
-# 检查构建结果
-if [ $SERVER_EXIT -ne 0 ]; then
-  echo "   ❌ Server 构建失败"
-  cat /tmp/build-server.log
-  exit 1
+if [ $API_ROUTES_EXIT -ne 0 ]; then
+  echo "   ⚠️  API 路由生成失败（不影响构建）"
+  cat /tmp/gen-api-routes.log
+else
+  echo "   ✅ API 路由生成完成"
 fi
 
-if [ $CLIENT_EXIT -ne 0 ]; then
-  echo "   ❌ Client 构建失败"
-  cat /tmp/build-client.log
-  exit 1
+if [ $PAGE_ROUTES_EXIT -ne 0 ]; then
+  echo "   ⚠️  页面路由生成失败（不影响构建）"
+  cat /tmp/gen-page-routes.log
+else
+  echo "   ✅ 页面路由生成完成"
 fi
-
-echo "   ✅ Server 构建完成"
-echo "   ✅ Client 构建完成"
 print_time $STEP_START
 echo ""
 
 # ==================== 步骤 4 ====================
-echo "📦 [4/5] 准备产物"
+echo "🔨 [4/6] 并行构建 server 和 client"
 STEP_START=$(node -e "console.log(Date.now())")
 
-# 拷贝 run.sh 到 dist/（prod 从 dist/ 启动，确保 cwd 一致性）
-cp "$ROOT_DIR/scripts/run.sh" "$DIST_DIR/"
-
-# 拷贝 .env 文件（如果存在）
-if [ -f "$ROOT_DIR/.env" ]; then
-  cp "$ROOT_DIR/.env" "$DIST_DIR/"
+# 给 server/client 构建子进程预留 8GB heap，缓解 vite build transform 阶段 OOM
+# （典型错误：Reached heap limit Allocation failed）。
+# 仅在外部未设置 NODE_OPTIONS 时注入，允许 CI / 用户通过外部环境变量完全覆盖
+BUILD_NODE_OPTIONS="${NODE_OPTIONS:---max-old-space-size=8192}"
+
+# 根据 only_frontend_change 决定是否构建 server
+if [[ "${only_frontend_change:-false}" == "true" ]]; then
+  echo "🔨 [4/6] 仅构建 client (only_frontend_change=true)"
+
+  echo "   ├─ 启动 client 构建..."
+  NODE_OPTIONS="$BUILD_NODE_OPTIONS" npm run build:client > /tmp/build-client.log 2>&1
+  CLIENT_EXIT=$?
+
+  if [ $CLIENT_EXIT -ne 0 ]; then
+    echo "   ❌ Client 构建失败"
+    cat /tmp/build-client.log
+    exit 1
+  fi
+
+  echo "   ✅ Client 构建完成"
+else
+  echo "🔨 [4/6] 并行构建 server 和 client"
+
+  # 并行构建
+  echo "   ├─ 启动 server 构建..."
+  NODE_OPTIONS="$BUILD_NODE_OPTIONS" npm run build:server > /tmp/build-server.log 2>&1 &
+  SERVER_PID=$!
+
+  echo "   ├─ 启动 client 构建..."
+  NODE_OPTIONS="$BUILD_NODE_OPTIONS" npm run build:client > /tmp/build-client.log 2>&1 &
+  CLIENT_PID=$!
+
+  # 等待两个构建完成
+  SERVER_EXIT=0
+  CLIENT_EXIT=0
+
+  wait $SERVER_PID || SERVER_EXIT=$?
+  wait $CLIENT_PID || CLIENT_EXIT=$?
+
+  # 检查构建结果
+  if [ $SERVER_EXIT -ne 0 ]; then
+    echo "   ❌ Server 构建失败"
+    cat /tmp/build-server.log
+    exit 1
+  fi
+
+  if [ $CLIENT_EXIT -ne 0 ]; then
+    echo "   ❌ Client 构建失败"
+    cat /tmp/build-client.log
+    exit 1
+  fi
+
+  echo "   ✅ Server 构建完成"
+  echo "   ✅ Client 构建完成"
 fi
 
+print_time $STEP_START
+echo ""
+
+# ==================== 步骤 5 ====================
+echo "📦 [5/6] 准备产物"
+STEP_START=$(node -e "console.log(Date.now())")
+
 # 移动 client 下的 HTML 文件到 dist/dist/client，保证 views 路径在 dev/prod 下一致
+# 使用 mv 而非 cp：HTML 不能上传到公网 CDN，移走后 dist/client 中不再包含 HTML
 if [ -d "$DIST_DIR/client" ]; then
   mkdir -p "$DIST_DIR/dist/client"
   find "$DIST_DIR/client" -maxdepth 1 -name "*.html" -exec mv {} "$DIST_DIR/dist/client/" \;
 fi
 
+# server 相关产物准备（only_frontend_change=true 时跳过）
+if [[ "${only_frontend_change:-false}" == "true" ]]; then
+  echo "   [skip] 跳过 run.sh/.env 复制 (only_frontend_change=true)"
+else
+  # 拷贝 run.sh 到 dist/（prod 从 dist/ 启动，确保 cwd 一致性）
+  cp "$ROOT_DIR/scripts/run.sh" "$DIST_DIR/"
+
+  # 拷贝 .env 文件（如果存在）
+  if [ -f "$ROOT_DIR/.env" ]; then
+    cp "$ROOT_DIR/.env" "$DIST_DIR/"
+  fi
+fi
+
 # 清理无用文件
 rm -rf "$DIST_DIR/scripts"
 rm -rf "$DIST_DIR/tsconfig.node.tsbuildinfo"
@@ -102,12 +169,19 @@ rm -rf "$DIST_DIR/tsconfig.node.tsbuildinfo"
 print_time $STEP_START
 echo ""
 
-# ==================== 步骤 5 ====================
-echo "✂️  [5/5] 智能依赖裁剪"
+# ==================== 步骤 6 ====================
+echo "✂️  [6/6] 智能依赖裁剪"
 STEP_START=$(node -e "console.log(Date.now())")
 
-# 分析实际依赖、复制并裁剪 node_modules、生成精简的 package.json
-node "$ROOT_DIR/scripts/prune-smart.js"
+# 智能依赖裁剪（仅全量构建时执行，纯前端场景不打包 server，无需裁剪）
+if [[ "${only_frontend_change:-false}" == "true" ]]; then
+  echo "✂️  [6/6] 跳过智能依赖裁剪 (only_frontend_change=true)"
+else
+  echo "✂️  [6/6] 智能依赖裁剪"
+
+  # 分析实际依赖、复制并裁剪 node_modules、生成精简的 package.json
+  node "$ROOT_DIR/scripts/prune-smart.js"
+fi
 
 print_time $STEP_START
 echo ""
@@ -118,9 +192,16 @@ print_time $TOTAL_START
 
 # 输出产物信息
 DIST_SIZE=$(du -sh "$DIST_DIR" | cut -f1)
-NODE_MODULES_SIZE=$(du -sh "$DIST_DIR/node_modules" | cut -f1)
-echo ""
-echo "📊 构建产物统计:"
-echo "   产物大小:        $DIST_SIZE"
-echo "   node_modules: $NODE_MODULES_SIZE"
-echo ""
+if [[ "${only_frontend_change:-false}" == "true" ]]; then
+  echo ""
+  echo "📊 构建产物统计:"
+  echo "   产物大小:        $DIST_SIZE"
+  echo ""
+else
+  NODE_MODULES_SIZE=$(du -sh "$DIST_DIR/node_modules" | cut -f1)
+  echo ""
+  echo "📊 构建产物统计:"
+  echo "   产物大小:        $DIST_SIZE"
+  echo "   node_modules: $NODE_MODULES_SIZE"
+  echo ""
+fi

package/templates/scripts/lint.js

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+
+const path = require('node:path');
+const { spawn } = require('node:child_process');
+const fs = require('node:fs');
+
+const cwd = process.cwd();
+
+function getBinName(name) {
+  return process.platform === 'win32' ? `${name}.cmd` : name;
+}
+
+function runCommand(command, args) {
+  return new Promise((resolve) => {
+    const child = spawn(command, args, {
+      cwd,
+      stdio: 'inherit',
+      shell: false,
+    });
+
+    child.on('close', (code) => resolve(code || 0));
+    child.on('error', () => resolve(1));
+  });
+}
+
+function normalizeProjectFile(filePath) {
+  const absolutePath = path.isAbsolute(filePath)
+    ? filePath
+    : path.resolve(cwd, filePath);
+
+  if (!fs.existsSync(absolutePath)) {
+    console.warn(`[lint] Skip missing file: ${filePath}`);
+    return null;
+  }
+
+  const relativePath = path.relative(cwd, absolutePath);
+  if (relativePath.startsWith('..')) {
+    console.warn(`[lint] Skip file outside project: ${filePath}`);
+    return null;
+  }
+
+  return relativePath.split(path.sep).join('/');
+}
+
+function parseFilesArg(argv) {
+  const filesIndex = argv.indexOf('--files');
+  if (filesIndex === -1) {
+    return null;
+  }
+
+  return argv.slice(filesIndex + 1).filter(Boolean);
+}
+
+function isEslintTarget(filePath) {
+  return /\.(c|m)?(j|t)sx?$/.test(filePath);
+}
+
+function isTypeCheckTarget(filePath) {
+  return /\.(ts|tsx|mts|cts)$/.test(filePath);
+}
+
+function isStylelintTarget(filePath) {
+  return filePath.endsWith('.css');
+}
+
+async function runDefaultLint() {
+  const code = await runCommand(getBinName('npx'), [
+    'concurrently',
+    'npm run eslint',
+    'npm run type:check',
+    'npm run stylelint',
+  ]);
+  process.exit(code);
+}
+
+async function runSelectiveLint(inputFiles) {
+  const normalizedFiles = Array.from(
+    new Set(inputFiles.map(normalizeProjectFile).filter(Boolean)),
+  );
+
+  if (normalizedFiles.length === 0) {
+    console.log('[lint] No supported project files found');
+    process.exit(0);
+  }
+
+  const eslintFiles = normalizedFiles.filter(isEslintTarget);
+  const stylelintFiles = normalizedFiles.filter(isStylelintTarget);
+  const typeCheckFiles = normalizedFiles.filter(isTypeCheckTarget);
+
+  const clientTypeFiles = [];
+  const serverTypeFiles = [];
+
+  for (const filePath of typeCheckFiles) {
+    if (filePath.startsWith('client/')) {
+      clientTypeFiles.push(filePath);
+    } else if (filePath.startsWith('server/')) {
+      serverTypeFiles.push(filePath);
+    } else if (filePath.startsWith('shared/')) {
+      clientTypeFiles.push(filePath);
+      serverTypeFiles.push(filePath);
+    }
+  }
+
+  const tasks = [];
+
+  if (eslintFiles.length > 0) {
+    tasks.push(runCommand(getBinName('npx'), ['eslint', '--quiet', ...eslintFiles]));
+  }
+
+  if (stylelintFiles.length > 0) {
+    tasks.push(runCommand(getBinName('npx'), ['stylelint', '--quiet', ...stylelintFiles]));
+  }
+
+  if (clientTypeFiles.length > 0) {
+    tasks.push(runCommand(getBinName('npm'), ['run', 'type:check:client']));
+  }
+
+  if (serverTypeFiles.length > 0) {
+    tasks.push(runCommand(getBinName('npm'), ['run', 'type:check:server']));
+  }
+
+  if (tasks.length === 0) {
+    console.log('[lint] No supported files matched for lint');
+    process.exit(0);
+  }
+
+  const results = await Promise.all(tasks);
+  process.exit(results.some(code => code !== 0) ? 1 : 0);
+}
+
+async function main() {
+  const files = parseFilesArg(process.argv.slice(2));
+  if (files === null) {
+    await runDefaultLint();
+    return;
+  }
+
+  if (files.length === 0) {
+    console.error('[lint] --files requires at least one file path');
+    process.exit(1);
+  }
+
+  await runSelectiveLint(files);
+}
+
+main().catch((error) => {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(`[lint] Failed to run lint: ${message}`);
+  process.exit(1);
+});