@lark-apaas/fullstack-cli 1.1.56 → 1.1.58-alpha.0

package/dist/index.js

@@ -847,117 +847,6 @@ var tweakImportsTransform = {
   }
 };
 
-// src/commands/db/gen-dbschema/transforms/ast/fix-opclass.ts
-import { Node as Node9 } from "ts-morph";
-var TYPE_TO_OPCLASS = {
-  uuid: "uuid_ops",
-  date: "date_ops",
-  varchar: "text_ops",
-  text: "text_ops",
-  boolean: "bool_ops",
-  integer: "int4_ops",
-  serial: "int4_ops",
-  numeric: "numeric_ops",
-  jsonb: "jsonb_ops",
-  customTimestamptz: "timestamptz_ops",
-  bigint: "int8_ops",
-  smallint: "int2_ops",
-  real: "float4_ops",
-  doublePrecision: "float8_ops"
-};
-var fixOpclassTransform = {
-  name: "fix-opclass",
-  transform(ctx) {
-    const { sourceFile } = ctx;
-    sourceFile.forEachDescendant((node) => {
-      if (!Node9.isCallExpression(node)) return;
-      const expr = node.getExpression();
-      if (!Node9.isIdentifier(expr)) return;
-      const fnName = expr.getText();
-      if (fnName !== "pgTable") return;
-      const args = node.getArguments();
-      if (args.length < 3) return;
-      const tableColumns = collectTableColumns(args[1]);
-      if (!tableColumns.size) return;
-      const indexFn = args[2];
-      if (!Node9.isArrowFunction(indexFn)) return;
-      fixOpclassInIndexes(indexFn, tableColumns);
-    });
-  }
-};
-function collectTableColumns(columnsArg) {
-  const columns = /* @__PURE__ */ new Map();
-  if (!Node9.isObjectLiteralExpression(columnsArg)) return columns;
-  for (const prop of columnsArg.getProperties()) {
-    if (!Node9.isPropertyAssignment(prop)) continue;
-    const colName = prop.getName();
-    const initializer = prop.getInitializer();
-    if (!initializer) continue;
-    const colType = extractColumnType(initializer);
-    if (colType) {
-      columns.set(colName, colType);
-    }
-  }
-  return columns;
-}
-function extractColumnType(node) {
-  const text = node.getText();
-  for (const typeName of Object.keys(TYPE_TO_OPCLASS)) {
-    const pattern = new RegExp(`\\b${typeName}\\s*\\(`);
-    if (pattern.test(text)) {
-      return typeName;
-    }
-  }
-  return void 0;
-}
-function fixOpclassInIndexes(indexFn, tableColumns) {
-  const paramName = getArrowParam(indexFn);
-  if (!paramName) return;
-  indexFn.forEachDescendant((node) => {
-    if (!Node9.isCallExpression(node)) return;
-    const expr = node.getExpression();
-    if (!Node9.isPropertyAccessExpression(expr)) return;
-    if (expr.getName() !== "op") return;
-    const opArgs = node.getArguments();
-    if (opArgs.length !== 1) return;
-    const currentOp = opArgs[0];
-    if (!Node9.isStringLiteral(currentOp)) return;
-    const colName = resolveColumnName(expr.getExpression(), paramName);
-    if (!colName) return;
-    const colType = tableColumns.get(colName);
-    if (!colType) return;
-    const correctOp = TYPE_TO_OPCLASS[colType];
-    if (!correctOp) return;
-    const currentValue = currentOp.getLiteralValue();
-    if (currentValue !== correctOp) {
-      currentOp.setLiteralValue(correctOp);
-    }
-  });
-}
-function getArrowParam(node) {
-  if (!Node9.isArrowFunction(node)) return void 0;
-  const params = node.getParameters();
-  if (params.length !== 1) return void 0;
-  return params[0].getName();
-}
-function resolveColumnName(node, tableParam) {
-  if (Node9.isPropertyAccessExpression(node)) {
-    const obj = node.getExpression();
-    const propName = node.getName();
-    if (Node9.isIdentifier(obj) && obj.getText() === tableParam) {
-      return propName;
-    }
-    return resolveColumnName(obj, tableParam);
-  }
-  if (Node9.isCallExpression(node)) {
-    const callExpr = node.getExpression();
-    if (Node9.isPropertyAccessExpression(callExpr)) {
-      return resolveColumnName(callExpr.getExpression(), tableParam);
-    }
-  }
-  return void 0;
-}
-
 // src/commands/db/gen-dbschema/transforms/ast/index.ts
 var defaultTransforms = [
   patchDefectsTransform,
@@ -976,8 +865,6 @@ var defaultTransforms = [
   // #9 Replace .defaultNow()
   removeSystemFieldsTransform,
   // #10 Remove conflicting system fields
-  fixOpclassTransform,
-  // #11 Fix multi-column index opclass mapping
   tweakImportsTransform
   // #12 Adjust imports
 ];
@@ -2014,7 +1901,7 @@ export class ${className}Module {}
 }
 
 // src/commands/db/gen-nest-resource/schema-parser.ts
-import { Project as Project2, Node as Node10 } from "ts-morph";
+import { Project as Project2, Node as Node9 } from "ts-morph";
 var DrizzleSchemaParser = class {
   constructor(projectOptions) {
     this.project = new Project2(projectOptions);
@@ -2027,7 +1914,7 @@ var DrizzleSchemaParser = class {
       const declarations = statement.getDeclarations();
       for (const declaration of declarations) {
         const initializer = declaration.getInitializer();
-        if (initializer && Node10.isCallExpression(initializer)) {
+        if (initializer && Node9.isCallExpression(initializer)) {
           const expression = initializer.getExpression();
           if (expression.getText() === "pgTable") {
             const tableInfo = this.parsePgTable(
@@ -2050,13 +1937,13 @@ var DrizzleSchemaParser = class {
     }
     const tableName = args[0].getText().replace(/['"]/g, "");
     const fieldsArg = args[1];
-    if (!Node10.isObjectLiteralExpression(fieldsArg)) {
+    if (!Node9.isObjectLiteralExpression(fieldsArg)) {
       return null;
     }
     const fields = [];
     const properties = fieldsArg.getProperties();
     for (const prop of properties) {
-      if (Node10.isPropertyAssignment(prop)) {
+      if (Node9.isPropertyAssignment(prop)) {
         const fieldName = prop.getName();
         const initializer = prop.getInitializer();
         const leadingComments = prop.getLeadingCommentRanges();
@@ -2064,7 +1951,7 @@ var DrizzleSchemaParser = class {
         if (leadingComments.length > 0) {
           comment = leadingComments.map((c) => c.getText()).join("\n").replace(/\/\//g, "").trim();
         }
-        if (initializer && Node10.isCallExpression(initializer)) {
+        if (initializer && Node9.isCallExpression(initializer)) {
           const fieldInfo = this.parseField(fieldName, initializer, comment);
           fields.push(fieldInfo);
         }
@@ -2096,10 +1983,10 @@ var DrizzleSchemaParser = class {
   parseBaseType(callExpr, fieldInfo) {
     let current = callExpr;
     let baseCall = null;
-    while (Node10.isCallExpression(current)) {
+    while (Node9.isCallExpression(current)) {
       baseCall = current;
       const expression2 = current.getExpression();
-      if (Node10.isPropertyAccessExpression(expression2)) {
+      if (Node9.isPropertyAccessExpression(expression2)) {
         current = expression2.getExpression();
       } else {
         break;
@@ -2110,7 +1997,7 @@ var DrizzleSchemaParser = class {
     }
     const expression = baseCall.getExpression();
     let typeName = "";
-    if (Node10.isPropertyAccessExpression(expression)) {
+    if (Node9.isPropertyAccessExpression(expression)) {
       typeName = expression.getName();
     } else {
       typeName = expression.getText();
@@ -2119,25 +2006,25 @@ var DrizzleSchemaParser = class {
     const args = baseCall.getArguments();
     if (args.length > 0) {
       const firstArg = args[0];
-      if (Node10.isStringLiteral(firstArg)) {
+      if (Node9.isStringLiteral(firstArg)) {
         fieldInfo.columnName = firstArg.getLiteralText();
-      } else if (Node10.isObjectLiteralExpression(firstArg)) {
+      } else if (Node9.isObjectLiteralExpression(firstArg)) {
         this.parseTypeConfig(firstArg, fieldInfo);
-      } else if (Node10.isArrayLiteralExpression(firstArg)) {
+      } else if (Node9.isArrayLiteralExpression(firstArg)) {
         fieldInfo.enumValues = firstArg.getElements().map((el) => el.getText().replace(/['"]/g, ""));
       }
     }
-    if (args.length > 1 && Node10.isObjectLiteralExpression(args[1])) {
+    if (args.length > 1 && Node9.isObjectLiteralExpression(args[1])) {
       this.parseTypeConfig(args[1], fieldInfo);
     }
   }
   parseTypeConfig(objLiteral, fieldInfo) {
-    if (!Node10.isObjectLiteralExpression(objLiteral)) {
+    if (!Node9.isObjectLiteralExpression(objLiteral)) {
       return;
     }
     const properties = objLiteral.getProperties();
     for (const prop of properties) {
-      if (Node10.isPropertyAssignment(prop)) {
+      if (Node9.isPropertyAssignment(prop)) {
         const propName = prop.getName();
         const value = prop.getInitializer()?.getText();
         switch (propName) {
@@ -2169,9 +2056,9 @@ var DrizzleSchemaParser = class {
   }
   parseCallChain(callExpr, fieldInfo) {
     let current = callExpr;
-    while (Node10.isCallExpression(current)) {
+    while (Node9.isCallExpression(current)) {
       const expression = current.getExpression();
-      if (Node10.isPropertyAccessExpression(expression)) {
+      if (Node9.isPropertyAccessExpression(expression)) {
         const methodName = expression.getName();
         const args = current.getArguments();
         switch (methodName) {
@@ -2267,9 +2154,9 @@ async function parseAndGenerateNestResourceTemplate(options) {
 var require2 = createRequire(import.meta.url);
 async function run(options = {}) {
   let exitCode = 0;
-  const envPath = path2.resolve(process.cwd(), ".env");
-  if (fs4.existsSync(envPath)) {
-    loadEnv({ path: envPath });
+  const envPath2 = path2.resolve(process.cwd(), ".env");
+  if (fs4.existsSync(envPath2)) {
+    loadEnv({ path: envPath2 });
     console.log("[gen-db-schema] \u2713 Loaded .env file");
   }
   const databaseUrl = process.env.SUDA_DATABASE_URL;
@@ -2568,12 +2455,6 @@ function buildDefaultRules(opts) {
       to: ".gitignore",
       line: ".agent/"
     },
-    // 7a. 确保 .gitignore 包含 .npm_cache 目录
-    {
-      type: "add-line",
-      to: ".gitignore",
-      line: ".npm_cache"
-    },
     // 8. 同步 .spark_project 配置文件（总是覆盖）
     {
       from: "templates/.spark_project",
@@ -2626,9 +2507,7 @@ var SYNC_PROFILES = {
   "design-stack": defaultProfile,
   "nestjs-react-fullstack": defaultProfile,
   "vite-react": viteReactProfile,
-  html: emptyProfile,
-  // design-html 与 html 同语义：空 sync + 不激活 git hooks（彻底 no-op）
-  "design-html": emptyProfile
+  html: emptyProfile
 };
 function genSyncConfig(stack, opts = {}) {
   const factory = stack && SYNC_PROFILES[stack] || defaultProfile;
@@ -5762,17 +5641,17 @@ function analyzeImports(sourceFile) {
 }
 
 // src/commands/migration/versions/v001_capability/code-migrator/analyzers/call-site-analyzer.ts
-import { SyntaxKind as SyntaxKind5 } from "ts-morph";
+import { SyntaxKind as SyntaxKind4 } from "ts-morph";
 function analyzeCallSites(sourceFile, imports) {
   const callSites = [];
   const importMap = /* @__PURE__ */ new Map();
   for (const imp of imports) {
     importMap.set(imp.importName, imp.capabilityId);
   }
-  const callExpressions = sourceFile.getDescendantsOfKind(SyntaxKind5.CallExpression);
+  const callExpressions = sourceFile.getDescendantsOfKind(SyntaxKind4.CallExpression);
   for (const callExpr of callExpressions) {
     const expression = callExpr.getExpression();
-    if (expression.getKind() === SyntaxKind5.Identifier) {
+    if (expression.getKind() === SyntaxKind4.Identifier) {
       const functionName = expression.getText();
       const capabilityId = importMap.get(functionName);
       if (capabilityId) {
@@ -5785,11 +5664,11 @@ function analyzeCallSites(sourceFile, imports) {
           text: callExpr.getText()
         });
       }
-    } else if (expression.getKind() === SyntaxKind5.PropertyAccessExpression) {
-      const propAccess = expression.asKind(SyntaxKind5.PropertyAccessExpression);
+    } else if (expression.getKind() === SyntaxKind4.PropertyAccessExpression) {
+      const propAccess = expression.asKind(SyntaxKind4.PropertyAccessExpression);
       if (propAccess) {
         const objectExpr = propAccess.getExpression();
-        if (objectExpr.getKind() === SyntaxKind5.Identifier) {
+        if (objectExpr.getKind() === SyntaxKind4.Identifier) {
           const objectName = objectExpr.getText();
           const capabilityId = importMap.get(objectName);
           if (capabilityId) {
@@ -6018,7 +5897,7 @@ function addInjection(sourceFile) {
 }
 
 // src/commands/migration/versions/v001_capability/code-migrator/transformers/call-site-transformer.ts
-import { SyntaxKind as SyntaxKind6 } from "ts-morph";
+import { SyntaxKind as SyntaxKind5 } from "ts-morph";
 var DEFAULT_ACTION_NAME = "run";
 function generateNewCallText(capabilityId, actionName, args) {
   const argsText = args.trim() || "{}";
@@ -6033,19 +5912,19 @@ function transformCallSites(sourceFile, imports) {
     });
   }
   let replacedCount = 0;
-  const callExpressions = sourceFile.getDescendantsOfKind(SyntaxKind6.CallExpression);
+  const callExpressions = sourceFile.getDescendantsOfKind(SyntaxKind5.CallExpression);
   const sortedCalls = [...callExpressions].sort((a, b) => b.getStart() - a.getStart());
   for (const callExpr of sortedCalls) {
     const expression = callExpr.getExpression();
     let importInfo;
-    if (expression.getKind() === SyntaxKind6.Identifier) {
+    if (expression.getKind() === SyntaxKind5.Identifier) {
       const functionName = expression.getText();
       importInfo = importMap.get(functionName);
-    } else if (expression.getKind() === SyntaxKind6.PropertyAccessExpression) {
-      const propAccess = expression.asKind(SyntaxKind6.PropertyAccessExpression);
+    } else if (expression.getKind() === SyntaxKind5.PropertyAccessExpression) {
+      const propAccess = expression.asKind(SyntaxKind5.PropertyAccessExpression);
       if (propAccess) {
         const objectExpr = propAccess.getExpression();
-        if (objectExpr.getKind() === SyntaxKind6.Identifier) {
+        if (objectExpr.getKind() === SyntaxKind5.Identifier) {
           const objectName = objectExpr.getText();
           importInfo = importMap.get(objectName);
         }
@@ -7698,10 +7577,8 @@ function sanitizeStructuredLog(value) {
   delete sanitized.pid;
   return sanitized;
 }
-var TRANSIENT_CONNECTION_ERROR_PATTERN = /ECONNREFUSED|ECONNRESET|proxy error/i;
 function hasErrorInStdLines(lines) {
-  const filtered = lines.filter((line) => !TRANSIENT_CONNECTION_ERROR_PATTERN.test(line));
-  const combined = filtered.join("\n");
+  const combined = lines.join("\n");
   if (!combined) return false;
   const strong = [
     /compiled with errors/i,
@@ -7720,7 +7597,7 @@ function hasErrorInStdLines(lines) {
     /\b0\s+errors?\b/i,
     /Server Error \d{3}/i
   ];
-  return filtered.some((line) => {
+  return lines.some((line) => {
     const text = line.trim();
     if (!text) return false;
     if (ignorePatterns.some((re) => re.test(text))) return false;
@@ -8269,11 +8146,9 @@ var commands = [
 ];
 
 // src/index.ts
-for (const filename of [".env.local", ".env"]) {
-  const envPath = path25.join(process.cwd(), filename);
-  if (fs29.existsSync(envPath)) {
-    dotenvConfig({ path: envPath });
-  }
+var envPath = path25.join(process.cwd(), ".env");
+if (fs29.existsSync(envPath)) {
+  dotenvConfig({ path: envPath });
 }
 var __dirname = path25.dirname(fileURLToPath5(import.meta.url));
 var pkg = JSON.parse(fs29.readFileSync(path25.join(__dirname, "../package.json"), "utf-8"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-cli",
-  "version": "1.1.56",
+  "version": "1.1.58-alpha.0",
   "description": "CLI tool for fullstack template management",
   "type": "module",
   "main": "dist/index.js",

package/templates/.spark_project

@@ -1,5 +1,5 @@
 run = ["npm", "run", "dev"] # 默认 spark-cli dev
-hidden = [".config", ".git", "scripts", "node_modules", "dist", ".spark", ".agent", ".agents", ".claude", "tmp", ".spark_project", ".playwright-cli"]
+hidden = [".config", ".git", "scripts", "node_modules", "dist", ".spark", ".agent", ".agents", "tmp", ".spark_project", ".playwright-cli"]
 lint = ["npm", "run", "lint"]
 test = ["npm", "run", "test"]
 genDbSchema = ["npm", "run", "gen:db-schema"]
@@ -13,4 +13,4 @@ run = ["npm", "run", "start"]
 [files.restrict]
 pathPatterns = ["client/src/api/gen", "package.json", ".spark_project", ".gitignore"]
 [files.hidden]
-pathPatterns = [".config", ".git", "scripts", "node_modules", "dist", ".spark", ".agent", ".agents", ".claude", "tmp", ".spark_project", ".playwright-cli"]
+pathPatterns = [".config", ".git", "scripts", "node_modules", "dist", ".spark", ".agent", ".agents", "tmp", ".spark_project", ".playwright-cli"]

package/templates/scripts/dev.js

@@ -5,6 +5,10 @@ const fs = require('fs');
 const path = require('path');
 const { spawn, execSync } = require('child_process');
 const readline = require('readline');
+const {
+  createPreviewPhaseReporter,
+  waitForTcpReady,
+} = require('./preview-startup-timing.cjs');
 
 // ── Project root ──────────────────────────────────────────────────────────────
 const PROJECT_ROOT = path.resolve(__dirname, '..');
@@ -78,6 +82,10 @@ function writeOutput(msg) {
   try { fs.write(1, msg, () => { _stdoutInFlight--; }); } catch { _stdoutInFlight--; }
 }
 
+const previewPhaseReporter = createPreviewPhaseReporter({
+  write: (line) => writeOutput(`${line}\n`),
+});
+
 /** Structured event log → terminal + dev.std.log + dev.log */
 function logEvent(level, name, message) {
   const msg = `[${timestamp()}] [${level}] [${name}] ${message}\n`;
@@ -141,7 +149,39 @@ function startProcess({ name, command, args, cleanupPort }) {
       entry.child = child;
 
       const startTime = Date.now();
+      const attempt = restartCount + 1;
       logEvent('INFO', name, `Process started (PGID: ${child.pid}): ${command} ${args.join(' ')}`);
+      const processPhase = name === 'server' ? 'backend_process_spawn' : 'client_process_spawn';
+      previewPhaseReporter.emit(processPhase, 'success', {
+        at_ms: startTime,
+        attempt,
+        exact: true,
+      });
+      if (name === 'server') {
+        void waitForTcpReady({
+          port: Number(SERVER_PORT),
+          started_at_ms: startTime,
+          interval_ms: 50,
+          timeout_ms: 120000,
+          should_continue: () => entry.child === child && !stopping,
+        }).then((result) => {
+          if (result.cancelled) return;
+          previewPhaseReporter.emit(
+            'backend_tcp_ready',
+            result.ready ? 'success' : 'error',
+            { ...result, attempt, exact: false }
+          );
+        }).catch((error) => {
+          if (entry.child !== child || stopping) return;
+          previewPhaseReporter.emit('backend_tcp_ready', 'error', {
+            duration_ms: Date.now() - startTime,
+            attempt,
+            exact: false,
+            precision_ms: 50,
+            error: error instanceof Error ? error.message : String(error),
+          });
+        });
+      }
 
       // Pipe stdout and stderr through readline for timestamped logging
       const pipeLines = (stream) => {
@@ -264,15 +304,30 @@ function cleanStaleDist() {
 // ── Main ──────────────────────────────────────────────────────────────────────
 async function main() {
   logEvent('INFO', 'main', '========== Dev session started ==========');
+  previewPhaseReporter.emit('dev_orchestrator_start', 'success', { exact: true });
 
   cleanStaleDist();
 
   // Initialize action plugins
   writeOutput('\n🔌 Initializing action plugins...\n');
+  const actionPluginStartedAt = Date.now();
+  previewPhaseReporter.emit('action_plugin_init', 'start', {
+    at_ms: actionPluginStartedAt,
+    exact: true,
+  });
   try {
     execSync('fullstack-cli action-plugin init', { cwd: PROJECT_ROOT, stdio: 'inherit' });
+    previewPhaseReporter.emit('action_plugin_init', 'success', {
+      duration_ms: Date.now() - actionPluginStartedAt,
+      exact: true,
+    });
     writeOutput('✅ Action plugins initialized\n\n');
-  } catch {
+  } catch (error) {
+    previewPhaseReporter.emit('action_plugin_init', 'error', {
+      duration_ms: Date.now() - actionPluginStartedAt,
+      exact: true,
+      error: error instanceof Error ? error.message : String(error),
+    });
     writeOutput('⚠️  Action plugin initialization failed, continuing anyway...\n\n');
   }
 

package/templates/scripts/dev.sh

@@ -1,24 +1,2 @@
 #!/usr/bin/env bash
-# `npm run dev` 入口；按 SANDBOX_ID 是否非空判断运行环境：
-#   - SANDBOX_ID 非空（沙箱平台注入应用所属沙箱 ID）→ 直接跑 dev.js
-#       （保活 / restart loop / 文件日志 —— 沙箱生产形态）。脚本同步由平台 pod 启动阶段做过，
-#       dev 入口不再额外 `npm run upgrade`。
-#   - 否则（本地）→ 走 miaoda app sync 兜底 + 跑 dev-local.js：纯 stdout、崩了就崩、Agent 友好。
-# 显式想跑本地路径可用 `npm run dev:local`（绕过 SANDBOX_ID 判断）。
-set -euo pipefail
-SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-
-if [ -n "${SANDBOX_ID:-}" ]; then
-  exec node "$SCRIPT_DIR/dev.js" "$@"
-fi
-
-if [ ! -f "$SCRIPT_DIR/dev-local.js" ]; then
-  echo "[dev] scripts/dev-local.js 缺失；先跑 \`npx -y @lark-apaas/miaoda-cli@latest app sync\` 同步平台脚本" >&2
-  exit 1
-fi
-
-# 本地启动前先跑一次 miaoda app sync：同步 platform-controlled 内容 + 升 @lark-apaas/* 到
-# latest + 迁移老 npm scripts。沙箱不走这里（SANDBOX_ID 分支已经 exec return）。
-npx -y @lark-apaas/miaoda-cli@latest app sync || echo "[dev] miaoda app sync 失败，按现状继续" >&2
-
-exec node "$SCRIPT_DIR/dev-local.js" "$@"
+exec node "$(dirname "$0")/dev.js" "$@"

package/templates/scripts/lint.js

@@ -23,19 +23,6 @@ function runCommand(command, args) {
   });
 }
 
-// 串行依次执行每个任务，全部跑完后再聚合退出码：
-// 降低并发资源占用、让各任务输出按顺序清晰可读，同时保留“一次暴露所有 lint 问题”的行为。
-async function runTasksSerially(taskSpecs) {
-  let exitCode = 0;
-  for (const [command, args] of taskSpecs) {
-    const code = await runCommand(command, args);
-    if (code !== 0) {
-      exitCode = 1;
-    }
-  }
-  return exitCode;
-}
-
 function normalizeProjectFile(filePath) {
   const absolutePath = path.isAbsolute(filePath)
     ? filePath
@@ -77,13 +64,13 @@ function isStylelintTarget(filePath) {
 }
 
 async function runDefaultLint() {
-  const taskSpecs = [
-    [getBinName('npm'), ['run', 'eslint']],
-    [getBinName('npm'), ['run', 'type:check']],
-    [getBinName('npm'), ['run', 'stylelint']],
-  ];
-
-  process.exit(await runTasksSerially(taskSpecs));
+  const code = await runCommand(getBinName('npx'), [
+    'concurrently',
+    'npm run eslint',
+    'npm run type:check',
+    'npm run stylelint',
+  ]);
+  process.exit(code);
 }
 
 async function runSelectiveLint(inputFiles) {
@@ -114,30 +101,31 @@ async function runSelectiveLint(inputFiles) {
     }
   }
 
-  const taskSpecs = [];
+  const tasks = [];
 
   if (eslintFiles.length > 0) {
-    taskSpecs.push([getBinName('npx'), ['eslint', '--quiet', ...eslintFiles]]);
+    tasks.push(runCommand(getBinName('npx'), ['eslint', '--quiet', ...eslintFiles]));
   }
 
   if (stylelintFiles.length > 0) {
-    taskSpecs.push([getBinName('npx'), ['stylelint', '--quiet', ...stylelintFiles]]);
+    tasks.push(runCommand(getBinName('npx'), ['stylelint', '--quiet', ...stylelintFiles]));
   }
 
   if (clientTypeFiles.length > 0) {
-    taskSpecs.push([getBinName('npm'), ['run', 'type:check:client']]);
+    tasks.push(runCommand(getBinName('npm'), ['run', 'type:check:client']));
   }
 
   if (serverTypeFiles.length > 0) {
-    taskSpecs.push([getBinName('npm'), ['run', 'type:check:server']]);
+    tasks.push(runCommand(getBinName('npm'), ['run', 'type:check:server']));
   }
 
-  if (taskSpecs.length === 0) {
+  if (tasks.length === 0) {
     console.log('[lint] No supported files matched for lint');
     process.exit(0);
   }
 
-  process.exit(await runTasksSerially(taskSpecs));
+  const results = await Promise.all(tasks);
+  process.exit(results.some(code => code !== 0) ? 1 : 0);
 }
 
 async function main() {

package/templates/scripts/preview-startup-timing.cjs

@@ -0,0 +1,126 @@
+'use strict';
+
+const net = require('net');
+
+const PREFIX = '[MiaodaPreviewPhase] ';
+const RUN_ID_PATTERN = /^prv_[A-Za-z0-9_-]{1,128}$/;
+
+function resolveAppId(env) {
+  const basePath = env.CLIENT_BASE_PATH || '';
+  const match = /^\/(?:app|af\/p)\/([^/]+)/.exec(basePath);
+  return match ? match[1] : env.MIAODA_APP_ID || '';
+}
+
+function createPreviewPhaseReporter(options = {}) {
+  const env = options.env || process.env;
+  const write = options.write || (line => process.stdout.write(`${line}\n`));
+  const now = options.now || Date.now;
+
+  function emit(phase, status, detail = {}) {
+    const runId = env.MIAODA_PREVIEW_RUN_ID || '';
+    if (!RUN_ID_PATTERN.test(runId)) return false;
+    const atMs = detail.at_ms == null ? now() : detail.at_ms;
+    const event = {
+      ...detail,
+      schema_version: 1,
+      run_id: runId,
+      app_id: resolveAppId(env),
+      sandbox_id: env.SANDBOX_ID || '',
+      phase,
+      status,
+      at_ms: atMs,
+    };
+    write(`${PREFIX}${JSON.stringify(event)}`);
+    return true;
+  }
+
+  return { emit };
+}
+
+function connectTcpOnce({ host, port, timeout_ms }) {
+  return new Promise(resolve => {
+    const socket = net.createConnection({ host, port });
+    let settled = false;
+    const finish = ready => {
+      if (settled) return;
+      settled = true;
+      socket.destroy();
+      resolve(ready);
+    };
+    socket.setTimeout(timeout_ms, () => finish(false));
+    socket.once('connect', () => finish(true));
+    socket.once('error', () => finish(false));
+  });
+}
+
+async function waitForTcpReady(options) {
+  const host = options.host || '127.0.0.1';
+  const port = Number(options.port);
+  const timeoutMs = options.timeout_ms == null ? 120000 : options.timeout_ms;
+  const intervalMs = options.interval_ms == null ? 50 : options.interval_ms;
+  const now = options.now || Date.now;
+  const sleep =
+    options.sleep || (ms => new Promise(resolve => setTimeout(resolve, ms)));
+  const connect = options.connect || connectTcpOnce;
+  const shouldContinue = options.should_continue || (() => true);
+  const startedAtMs =
+    options.started_at_ms == null ? now() : options.started_at_ms;
+  let attempts = 0;
+
+  while (now() - startedAtMs < timeoutMs) {
+    if (!shouldContinue()) {
+      const atMs = now();
+      return {
+        ready: false,
+        cancelled: true,
+        attempts,
+        at_ms: atMs,
+        duration_ms: atMs - startedAtMs,
+        precision_ms: intervalMs,
+      };
+    }
+    attempts += 1;
+    const ready = await connect({
+      host,
+      port,
+      timeout_ms: Math.max(1, Math.min(intervalMs, timeoutMs)),
+    });
+    const atMs = now();
+    if (!shouldContinue()) {
+      return {
+        ready: false,
+        cancelled: true,
+        attempts,
+        at_ms: atMs,
+        duration_ms: atMs - startedAtMs,
+        precision_ms: intervalMs,
+      };
+    }
+    if (ready) {
+      return {
+        ready: true,
+        attempts,
+        at_ms: atMs,
+        duration_ms: atMs - startedAtMs,
+        precision_ms: intervalMs,
+      };
+    }
+    const elapsed = now() - startedAtMs;
+    if (elapsed >= timeoutMs) break;
+    await sleep(Math.min(intervalMs, timeoutMs - elapsed));
+  }
+
+  const atMs = now();
+  return {
+    ready: false,
+    attempts,
+    at_ms: atMs,
+    duration_ms: atMs - startedAtMs,
+    precision_ms: intervalMs,
+  };
+}
+
+module.exports = {
+  createPreviewPhaseReporter,
+  waitForTcpReady,
+};

package/templates/scripts/dev-local.js

@@ -1,113 +0,0 @@
-#!/usr/bin/env node
-// ============================================================================
-// 本地开发启动脚本（由 miaoda app sync 维护，请勿手改）
-// Stack: nestjs-react-fullstack
-//
-// 流程:
-//   1. env pull —— 拉沙箱身份/凭证到 .env.local
-//   2. skills sync —— 同步当前 stack 的 agent skills
-//   3. dotenv 加载 .env / .env.local 到 process.env（含 SUDA_WEBUSER 适配）
-//   4. 并发起 dev:server + dev:client（子进程继承 process.env）
-//
-// 关键设计：本脚本在 spawn 子进程之前先把 .env / .env.local 加载到 process.env，
-// 然后 spawn 的 server / client 进程通过 env 继承直接拿到——SDK（fullstack-nestjs-core
-// / fullstack-vite-preset / fullstack-rspack-preset）无需自己 require('dotenv')。
-//
-// SUDA_WEBUSER 适配：沙箱 env pull 下发到 .env.local 的形态是
-// `SUDA_WEBUSER="{\"user_id\":\"...\"}"`（shell-quoted JSON），dotenv@17 剥外层引号后
-// 保留内部 `\"` 转义不还原，导致 process.env.SUDA_WEBUSER 是 `{\"user_id\":\"...\"}`
-// 这种带反斜杠串，下游 JSON.parse 直接挂。这里做一次「直接 parse 失败则 unescape
-// 后重 parse」兜底，把容错收敛在启动期单点，下游拿到干净 JSON 字符串。
-// ============================================================================
-const fs = require('node:fs');
-const path = require('node:path');
-const { execSync, spawn, spawnSync } = require('node:child_process');
-
-process.chdir(path.resolve(__dirname, '..'));
-
-function warn(msg) {
-  if (process.stderr.isTTY) process.stderr.write(`\x1b[33mWARNING: ${msg}\x1b[0m\n`);
-  else process.stderr.write(`WARNING: ${msg}\n`);
-}
-
-if (!process.env.MIAODA_APP_TYPE) process.env.MIAODA_APP_TYPE = '3';
-process.env.MIAODA_LOCAL_DEV = '1';
-
-// 1. env pull
-console.log('[dev-local] (1/4) env pull...');
-const hasLarkCli = spawnSync('command', ['-v', 'lark-cli'], { shell: true, stdio: 'ignore' }).status === 0;
-if (hasLarkCli) {
-  let appId = '';
-  try {
-    appId = JSON.parse(fs.readFileSync('.spark/meta.json', 'utf8')).app_id || '';
-  } catch {
-    /* meta.json 不存在或非法 JSON */
-  }
-  if (appId) {
-    const r = spawnSync('lark-cli', ['apps', '+env-pull', '--app-id', appId, '--as', 'user'], {
-      stdio: 'inherit',
-    });
-    if (r.status !== 0) warn('env pull 失败，继续按 .env.local 现状启动');
-  } else {
-    warn('.spark/meta.json 缺 app_id，请先跑 `miaoda app init --app-id <id>`');
-  }
-} else {
-  warn('lark-cli 未安装，跳过 env pull；请确保 .env.local 已就绪');
-}
-
-// 2. skills sync —— --local 切到 flat layout (.agents/skills + .claude/skills 软链),
-// 跟沙箱 nested layout 区分。不传 --version,handler 默认拉 coding-steering@latest,
-// 保证每次本地 npm run dev 都把 skills 升到最新。
-console.log('[dev-local] (2/4) miaoda skills sync...');
-try {
-  execSync('npx -y @lark-apaas/miaoda-cli@latest skills sync --local', { stdio: 'inherit' });
-} catch {
-  console.log('  (skills sync 失败，继续启动)');
-}
-
-// 3. 加载 .env / .env.local 到 process.env
-// dotenv 默认 override:false，先到先得 → 先 .env.local 让它优先于 .env；
-// shell env 已在 process.env，两次 config 都不会覆盖。
-console.log('[dev-local] (3/4) loading .env / .env.local...');
-const dotenv = require('dotenv');
-dotenv.config({ path: '.env.local' });
-dotenv.config({ path: '.env' });
-
-// SUDA_WEBUSER 适配（详见文件头注释）
-if (process.env.SUDA_WEBUSER) {
-  const raw = process.env.SUDA_WEBUSER;
-  try {
-    JSON.parse(raw);
-  } catch {
-    try {
-      const unescaped = raw.replace(/\\"/g, '"');
-      JSON.parse(unescaped);
-      process.env.SUDA_WEBUSER = unescaped;
-    } catch {
-      warn(`SUDA_WEBUSER 解析失败,值头部: ${raw.slice(0, 80)}...`);
-    }
-  }
-}
-
-// 4. 并发起前后端 dev server
-console.log('[dev-local] (4/4) 并发起 dev:server + dev:client');
-const child = spawn(
-  'npx',
-  [
-    '--no-install',
-    'concurrently',
-    '--names',
-    'server,client',
-    '--prefix-colors',
-    'blue,green',
-    '--kill-others-on-fail',
-    'npm run dev:server',
-    'npm run dev:client',
-  ],
-  { stdio: 'inherit', env: process.env },
-);
-child.on('exit', (code) => process.exit(code ?? 0));
-child.on('error', (err) => {
-  console.error(err);
-  process.exit(1);
-});