@lark-apaas/miaoda-cli 0.1.4 → 0.1.5-alpha.2f1e0ff

package/upgrade/templates/design-stack/templates/scripts/hooks/run-precommit.js

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+// FULLSTACK_PRECOMMIT_V1
+'use strict';
+
+const { spawnSync } = require('node:child_process');
+
+const SEP = '  ' + '─'.repeat(36);
+
+function failAndExit(step, body) {
+  process.stderr.write('\n✗ pre-commit failed: ' + step + '\n');
+  process.stderr.write(SEP + '\n');
+  if (body && body.length > 0) {
+    process.stderr.write(body.replace(/\s+$/, '') + '\n');
+  }
+  process.stderr.write(SEP + '\n');
+  process.stderr.write('  bypass: git commit --no-verify\n');
+  process.exit(1);
+}
+
+function runLint() {
+  const cwd = process.cwd();
+  const res = spawnSync('npm', ['run', 'lint'], {
+    cwd,
+    stdio: ['ignore', 'pipe', 'pipe'],
+    env: process.env,
+  });
+  if (res.error) {
+    failAndExit('lint', String(res.error.message || res.error));
+  }
+  if (res.status !== 0) {
+    const stdout = res.stdout ? res.stdout.toString() : '';
+    const stderr = res.stderr ? res.stderr.toString() : '';
+    failAndExit('lint', stdout + '\n' + stderr);
+  }
+}
+
+runLint();

package/upgrade/templates/nestjs-react-fullstack/templates/.githooks/pre-commit

@@ -0,0 +1,4 @@
+#!/usr/bin/env sh
+[ "$SKIP_GIT_HOOKS" = "1" ] && exit 0
+export PATH="node_modules/.bin:$PATH"
+npm run precommit

package/upgrade/templates/nestjs-react-fullstack/templates/.gitignore.append

@@ -0,0 +1,8 @@
+
+# ==========================================
+# fullstack-cli managed files
+# ==========================================
+# scripts/ directory is auto-generated
+# DO NOT modify manually
+scripts/
+

package/upgrade/templates/nestjs-react-fullstack/templates/.spark_project

@@ -0,0 +1,16 @@
+run = ["npm", "run", "dev"] # 默认 spark-cli dev
+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"]
+genOpenApiClient = ["npm", "run", "gen:openapi"]
+
+[deployment]
+build = ["npm", "run", "build"]
+run = ["npm", "run", "start"]
+
+[files]
+[files.restrict]
+pathPatterns = ["client/src/api/gen", "package.json", ".spark_project", ".gitignore"]
+[files.hidden]
+pathPatterns = [".config", ".git", "scripts", "node_modules", "dist", ".spark", ".agent", ".agents", "tmp", ".spark_project", ".playwright-cli"]

package/upgrade/templates/nestjs-react-fullstack/templates/drizzle.config.ts

@@ -0,0 +1,55 @@
+import { defineConfig, Config } from 'drizzle-kit';
+require('dotenv').config();
+
+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 || '');
+
+const envSchemaFilter = process.env.DRIZZLE_SCHEMA_FILTER;
+const urlSchemaFilter = parsedUrl.searchParams.get('schema');
+
+const schemaFilter = (envSchemaFilter ?? urlSchemaFilter ?? '')
+  .split(',')
+  .map((s) => s.trim())
+  .filter(Boolean);
+
+parsedUrl.searchParams.delete('schema'); // 移除schema参数，避免 drizzle-kit 解析错误
+
+// 默认排除的系统对象（PostgreSQL 扩展和系统视图）
+// 这些对象在 drizzle-kit introspect 时可能导致无效的 JS 代码生成
+const SYSTEM_OBJECTS_EXCLUSIONS = [
+  '!spatial_ref_sys',       // PostGIS 空间参考系统表
+  '!geography_columns',     // PostGIS 地理列视图
+  '!geometry_columns',      // PostGIS 几何列视图
+  '!raster_columns',        // PostGIS 栅格列视图
+  '!raster_overviews',      // PostGIS 栅格概览视图
+  '!pg_stat_statements',    // pg_stat_statements 扩展
+  '!pg_stat_statements_info', // pg_stat_statements 扩展
+  '!part_config',           // pg_partman 分区配置表
+  '!part_config_sub',       // pg_partman 子分区配置表
+  '!table_privs',           // 系统权限视图
+];
+
+const envTablesFilter = process.env.DRIZZLE_TABLES_FILTER;
+const userTablesFilter = (envTablesFilter ?? '*')
+  .split(',')
+  .map((s) => s.trim())
+  .filter(Boolean);
+
+// 合并用户过滤器和系统对象排除
+// 用户可以通过设置 DRIZZLE_TABLES_FILTER 来覆盖（如果需要包含某些系统对象）
+const tablesFilter = [...userTablesFilter, ...SYSTEM_OBJECTS_EXCLUSIONS];
+
+const config:Config = {
+  schema: schemaPath,
+  out: outputDir,
+  tablesFilter,
+  schemaFilter,
+  dialect: 'postgresql',
+  dbCredentials: {
+    url: parsedUrl.toString(),
+  },
+}
+
+export default defineConfig(config);

package/upgrade/templates/nestjs-react-fullstack/templates/helper/gen-openapi.ts

@@ -0,0 +1,34 @@
+// This file is auto-generated by @lark-apaas/fullstack-cli
+import { NestFactory } from '@nestjs/core';
+import { DevToolsV2Module } from '@lark-apaas/fullstack-nestjs-core';
+
+import { AppModule } from '../server/app.module';
+
+/**
+ * 生成 OpenAPI 文档和客户端 SDK
+ *
+ * 此文件由 @lark-apaas/fullstack-cli 自动派生，请勿手动修改
+ * 每次运行 npm install 时会自动更新
+ */
+async function generateOpenApi() {
+  const app = await NestFactory.create(AppModule, { logger: false });
+  const basePath = process.env.CLIENT_BASE_PATH;
+
+  if (basePath) {
+    app.setGlobalPrefix(basePath);
+  }
+
+  await DevToolsV2Module.mount(app, {
+    basePath,
+    docsPath: '/api_docs',
+    needSetupServer: false,
+    needGenerateClientSdk: true,
+  });
+  
+  process.exit(0); // 主动退出进程，不等待 app 关闭（用户存在场景，未释放 timer 导致 app 卡死问题）
+}
+
+generateOpenApi().catch((err) => {
+  console.error('[OpenAPI] Failed to generate schema', err);
+  process.exitCode = 1;
+});

package/upgrade/templates/nestjs-react-fullstack/templates/nest-cli.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "server",
+  "compilerOptions": {
+    "deleteOutDir": false,
+    "tsConfigPath": "tsconfig.node.json",
+    "assets": [
+      {
+        "include": "capabilities/**/*.json",
+        "outDir": "dist/server",
+        "watchAssets": true
+      }
+    ],
+    "plugins": [
+      {
+        "name": "@nestjs/swagger",
+        "options": {
+          "introspectComments": true,
+          "classValidatorShim": true
+        }
+      }
+    ]
+  }
+}

package/upgrade/templates/nestjs-react-fullstack/templates/scripts/build.sh

@@ -0,0 +1,207 @@
+#!/usr/bin/env bash
+# This file is auto-generated by @lark-apaas/fullstack-cli
+set -euo pipefail
+
+ROOT_DIR="$(pwd)"
+DIST_DIR="$ROOT_DIR/dist"
+
+# 记录总开始时间
+TOTAL_START=$(node -e "console.log(Date.now())")
+
+# 打印耗时的辅助函数
+print_time() {
+  local start=$1
+  local end=$(node -e "console.log(Date.now())")
+  local elapsed=$((end - start))
+  local seconds=$((elapsed / 1000))
+  local ms=$((elapsed % 1000))
+  echo "   ⏱️  耗时: ${seconds}.$(printf "%03d" $ms)s"
+}
+
+# ==================== 步骤 0 ====================
+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/6] 更新 openapi 代码"
+STEP_START=$(node -e "console.log(Date.now())")
+npm run gen:openapi
+print_time $STEP_START
+echo ""
+
+# ==================== 步骤 2 ====================
+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/6] 生成路由定义"
+STEP_START=$(node -e "console.log(Date.now())")
+
+# 在 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 "   ├─ 生成页面路由定义..."
+npx generate-page-routes --app-path ./client/src/app.tsx --out-dir ./dist > /tmp/gen-page-routes.log 2>&1 &
+PAGE_ROUTES_PID=$!
+
+API_ROUTES_EXIT=0
+PAGE_ROUTES_EXIT=0
+
+wait $API_ROUTES_PID || API_ROUTES_EXIT=$?
+wait $PAGE_ROUTES_PID || PAGE_ROUTES_EXIT=$?
+
+if [ $API_ROUTES_EXIT -ne 0 ]; then
+  echo "   ⚠️  API 路由生成失败（不影响构建）"
+  cat /tmp/gen-api-routes.log
+else
+  echo "   ✅ API 路由生成完成"
+fi
+
+if [ $PAGE_ROUTES_EXIT -ne 0 ]; then
+  echo "   ⚠️  页面路由生成失败（不影响构建）"
+  cat /tmp/gen-page-routes.log
+else
+  echo "   ✅ 页面路由生成完成"
+fi
+print_time $STEP_START
+echo ""
+
+# ==================== 步骤 4 ====================
+echo "🔨 [4/6] 并行构建 server 和 client"
+STEP_START=$(node -e "console.log(Date.now())")
+
+# 给 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"
+
+print_time $STEP_START
+echo ""
+
+# ==================== 步骤 6 ====================
+echo "✂️  [6/6] 智能依赖裁剪"
+STEP_START=$(node -e "console.log(Date.now())")
+
+# 智能依赖裁剪（仅全量构建时执行，纯前端场景不打包 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 ""
+
+# 总耗时
+echo "构建完成"
+print_time $TOTAL_START
+
+# 输出产物信息
+DIST_SIZE=$(du -sh "$DIST_DIR" | cut -f1)
+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/upgrade/templates/nestjs-react-fullstack/templates/scripts/dev-local.sh

@@ -0,0 +1,61 @@
+#!/usr/bin/env bash
+# ============================================================================
+# 本地 dev 启动脚本（平台控制，通过 `miaoda app upgrade` 同步，请勿手改）
+# Stack: nestjs-react-fullstack
+# 流程：env pull → skills sync → 并发起 server + client
+# ============================================================================
+set -euo pipefail
+ROOT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$ROOT_DIR"
+
+# === Sentinels（必须由本脚本注入，不属于 .env.local 业务范畴）===
+
+# Stack 对应 miaoda CLI 的 application scene；沙箱里平台注入，本地脚本兜底，
+# 让后续 miaoda 子命令（skills sync 等）走对的 scene。
+export MIAODA_APP_TYPE="${MIAODA_APP_TYPE:-3}"
+
+# 本地开发总开关：SDK（fullstack-vite-preset / fullstack-rspack-preset /
+# fullstack-nestjs-core）据此启用本地兜底逻辑：
+#   - vite/rspack-preset：反代 /__runtime__ 到沙箱（带 cookie / webuser header）
+#   - nestjs-core：从 cookie 补 csrf header + 注入 webuser header
+# 沙箱 dev / 生产不设此 env，SDK 行为完全不变。
+export MIAODA_LOCAL_DEV=1
+
+# 临时：绕 npmmirror/bnpm 内网到 npmjs 的同步延迟，等 coding-steering 正式版去掉。
+export MIAODA_NPM_REGISTRY="${MIAODA_NPM_REGISTRY:-https://registry.npmjs.org/}"
+
+# === .env.local / .env 加载由 SDK 侧负责，本脚本不再手工 source ===
+# fullstack-nestjs-core 在 module init 通过 dotenv 读 .env.local + .env；
+# fullstack-{vite,rspack}-preset 的 defineConfig 同理。优先级：shell > .env.local > .env。
+# 历史版本曾在这里用 bash 自写 parser，引号 / 多行 / 行尾注释处理不全且重复造轮子，已下放到 SDK。
+
+# 1. 拉本地 dev 所需 ENV（jwt / cookie / sandbox URL 等，写入 .env.local）
+#    app_id 从 .spark/meta.json 读 —— `miaoda app init --app-id <id>` 时持久化的权威源，
+#    后续 dev / sync 全部沿用这一个值；不在脚本里 hack 别的推断渠道。
+#    lark-cli 子命令真名是 `+env-pull`（带 + 前缀单 token，不是 `env pull` 空格分隔）；
+#    `--as user` 必须显式：env-pull 只接受 user identity，默认 bot 会校验失败。
+echo "[dev-local] (1/3) env pull..."
+if command -v lark-cli >/dev/null 2>&1; then
+  # 用 node 读 .spark/meta.json，不引 python3 依赖（user app 必装 node）。
+  APP_ID=$(node -e 'try{process.stdout.write(JSON.parse(require("fs").readFileSync(".spark/meta.json","utf8")).app_id||"")}catch(e){}' 2>/dev/null || echo "")
+  if [ -n "$APP_ID" ]; then
+    lark-cli apps +env-pull --app-id "$APP_ID" --as user || echo "  (env pull 失败，后续按 .env.local 现状继续)"
+  else
+    echo "  (.spark/meta.json 缺 app_id，先跑 \`miaoda app init --app-id <id>\` 写入)"
+  fi
+else
+  echo "  (lark-cli 未装，跳过 env pull；请确保 .env.local 已就绪)"
+fi
+
+# 2. 同步 stack 对应 skills（coding-steering）。走 npx 不依赖用户全局装 miaoda；
+#    钉到 @alpha dist-tag 跟随最新发布，miaoda-cli 通道我们自己控制风险小。
+echo "[dev-local] (2/3) miaoda skills sync..."
+npx -y @lark-apaas/miaoda-cli@alpha skills sync || echo "  (skills sync 失败，继续启动)"
+
+# 3. 并发起 dev:server（NestJS）+ dev:client（vite/rspack）
+#    端口、SANDBOX_* 等业务 env 由 SDK 内 dotenv 加载，不在 banner 里假装显示。
+#    不走 scripts/dev.js（保活 / restart / 日志写文件那套）—— 本地崩就崩，错日志直接 stdout。
+echo "[dev-local] (3/3) 并发起 dev:server + dev:client"
+exec npx --no-install concurrently \
+  --names "server,client" --prefix-colors "blue,green" --kill-others-on-fail \
+  "npm run dev:server" "npm run dev:client"