@gadmin2n/schematics 0.0.130 → 0.0.132

package/dist/lib/application/files/gadmin2-game-angle-demo/server/.swcrc

@@ -16,10 +16,10 @@
     "paths": {
       "@/*": ["src/*"]
     },
-    "target": "es2017"
+    "target": "es2020"
   },
   "module": {
     "type": "commonjs"
   },
-  "exclude": ["\\.spec\\.ts$", "\\.test\\.ts$"]
+  "exclude": ["node_modules", ".*\\.spec\\.ts$", ".*\\.test\\.ts$"]
 }

package/dist/lib/application/files/gadmin2-game-angle-demo/server/ecosystem.dev.config.js

@@ -0,0 +1,28 @@
+// pm2 dev 场景专用配置：直接跑 nest CLI（SWC watch），不套 npm/dotenv-cli 壳。
+// 由 branch.service.ts 通过 pm2 CLI 传入 PM2_NAME / NEST_PORT / DATABASE_URL 等环境变量。
+const path = require('path');
+const dotenv = require('dotenv');
+
+const baseEnv = dotenv.config({ path: path.join(__dirname, '.env') }).parsed || {};
+const localEnv = dotenv.config({ path: path.join(__dirname, '.env.local') }).parsed || {};
+
+module.exports = {
+  apps: [
+    {
+      name: process.env.PM2_NAME,
+      script: './node_modules/@nestjs/cli/bin/nest.js',
+      args: 'start -c gadmin-cli.json --watch --builder swc',
+      interpreter: 'node',
+      cwd: __dirname,
+      autorestart: false,
+      env: {
+        ...baseEnv,
+        ...localEnv,
+        // 由 branch.service.ts 注入的分支专属变量优先（覆盖 .env* 里的默认值）
+        ...(process.env.NEST_PORT ? { NEST_PORT: process.env.NEST_PORT } : {}),
+        ...(process.env.DATABASE_URL ? { DATABASE_URL: process.env.DATABASE_URL } : {}),
+        PATH: `/data/home/kavenma/.yarn/bin:${process.env.PATH}`,
+      },
+    },
+  ],
+};

package/dist/lib/application/files/gadmin2-game-angle-demo/server/gadmin-cli.json

@@ -3,7 +3,6 @@
   "collection": "@gadmin2n/schematics",
   "sourceRoot": "src",
   "compilerOptions": {
-    "builder": "swc",
     "plugins": [
       {
         "name": "@nestjs/swagger",

package/dist/lib/application/files/gadmin2-game-angle-demo/server/nodemon.lite.json

@@ -0,0 +1,12 @@
+{
+  "watch": ["src", "gadmin-cli.json", "tsconfig.json", "tsconfig.build.json"],
+  "ext": "ts,json",
+  "ignore": [
+    "dist",
+    "node_modules",
+    "**/*.spec.ts",
+    "**/*.test.ts"
+  ],
+  "delay": 300,
+  "exec": "nest build -c gadmin-cli.json"
+}

package/dist/lib/application/files/gadmin2-game-angle-demo/server/package.json

@@ -12,6 +12,7 @@
     "prepare": "cd .. && husky install || true",
     "start": "dotenv -e .env.local -e .env  -- nest start -c gadmin-cli.json",
     "start:dev": "dotenv -e .env.local -e .env  -- nest start -c gadmin-cli.json --watch",
+    "start:dev:lite": "dotenv -e .env.local -e .env -- sh -c 'nest build -cgadmin-cli.json && concurrently -k -n build,run \"nodemon --config nodemon.lite.json\" \"node --enable-source-maps --watch dist/src/main\"'",
     "start:debug": "dotenv -e .env.local -e .env  -- nest start -c gadmin-cli.json --debug --watch",
     "start:prod": "/bin/sh start-prod.sh",
     "typecheck": "tsc --noEmit",
@@ -28,8 +29,6 @@
     "generate": "dotenv -e .env.local -e .env  -- npx prisma generate",
     "generate:dev": "npm run migrate:dev && dotenv -e .env.local -e .env  -- npx prisma generate",
     "postgenerate:dev": "dotenv -e .env.local -e .env  -- ts-node seed/data-mngt.seed.ts",
-    "generate:web": "dotenv -e .env.local -e .env  -- npx prisma generate --generator react",
-    "generate:server": "dotenv -e .env.local -e .env  -- npx prisma generate --generator client --generator nestjs",
     "postgadminGenerate": "node scripts/notify-dev-servers.js",
     "push:db": "dotenv -e .env.local -e .env  -- prisma db push --skip-generate",
     "seed": "dotenv -e .env.local -e .env  -- ts-node seed/index.ts",
@@ -105,12 +104,14 @@
     "@types/supertest": "^2.0.11",
     "@typescript-eslint/eslint-plugin": "^5.0.0",
     "@typescript-eslint/parser": "^5.0.0",
+    "concurrently": "^9.1.0",
     "eslint": "^8.0.1",
     "eslint-config-prettier": "^8.3.0",
     "eslint-plugin-prettier": "^4.0.0",
     "husky": "^8.0.0",
     "jest": "^29.0.0",
     "lint-staged": "^13.0.0",
+    "nodemon": "^3.1.7",
     "prettier": "^2.3.2",
     "prettier-plugin-organize-imports": "^3.0.3",
     "prisma-dbml-generator": "^0.9.1",

package/dist/lib/application/files/gadmin2-game-angle-demo/server/prisma/.generator.prisma

@@ -29,6 +29,3 @@ generator react {
   pagesDir = "../../web/src/routes"
 }
 
-generator dbml {
-  provider = "prisma-dbml-generator"
-}

package/dist/lib/application/files/gadmin2-game-angle-demo/server/scripts/notify-dev-servers.js

@@ -6,13 +6,29 @@
  *   1. 释放 Vite dev server 内存（server.restart() 会清空 module graph）
  *   2. 让浏览器自动 full-reload，无需手工刷新
  *
- * 时序：
- *   nest --watch 会因为 server/src/modules/{model} 变化自动重启，
- *   此脚本先 poll 它的 /api/health/live 直到 ready，再 touch web/.vite-restart，
- *   保证浏览器恢复时后端 API 已就绪，避免 502/ECONNREFUSED。
+ * 时序策略（历史与当前）：
+ *   nest --watch 会因为 server/src/{generated,modules} 变化自动重启，此脚本
+ *   先 poll 它的 /api/health/live 直到"稳定就绪"，再 touch web/.vite-restart，
+ *   保证浏览器 iframe 复活时后端 API 已稳定，避免 500/ECONNREFUSED。
  *
- * 环境变量（由 CLI 注入）：
- *   GADMIN_MODE = full | web | server
+ *   旧实现只等"第一次 down → 第一次 up"就返回，遇到 gadmin g prisma 触发的
+ *   多批文件写入（generated/** 与 modules/** 两个子树）+ tsc-watch 的短
+ *   debounce，会连续触发 2+ 次 rebuild。第一次 up 后随即又被 kill，vite
+ *   触发 iframe 复活时 nest 已再次不可达，vite proxy fallback 返回 500 空 body
+ *   （形状：Vary: Origin / Content-Type: text/plain / Transfer-Encoding: chunked
+ *   / 无 body），页面白屏；nest 侧无堆栈日志，因为请求没走到应用层。
+ *
+ *   现改用 waitForNestReady 的自适应稳定窗口：观察到 up 后要求持续
+ *   stableRequiredMs 内保持 up；一旦观察到新一轮 up→down 就按实际 rebuild
+ *   周期动态扩展窗口；有稳定窗口上限 + 硬超时兜底避免异常时卡死。
+ *
+ * 环境变量：
+ *   NEST_PORT                     后端端口，默认 8000
+ *   POSTGEN_POLL_MS               健康 poll 间隔，默认 250ms
+ *   POSTGEN_INITIAL_STABLE_MS     初始稳定窗口，默认 3000ms
+ *   POSTGEN_MAX_STABLE_MS         稳定窗口上限，默认 15000ms
+ *   POSTGEN_OBSERVE_DOWN_TIMEOUT_MS  等待第一次 down 的超时，默认 15000ms
+ *   POSTGEN_TOTAL_TIMEOUT_MS      Phase 2 硬超时，默认 60000ms
  *
  * 与 CLI 通信约定：
  *   - CWD 是 server/（CLI shell.cd('server/') 后调用）
@@ -21,10 +37,7 @@
 const fs = require('fs');
 const http = require('http');
 const path = require('path');
-
-const MODE = process.env.GADMIN_MODE || 'full';
-const shouldWaitNest = MODE === 'full' || MODE === 'server';
-const shouldTouchWeb = MODE === 'full' || MODE === 'web';
+const { waitForNestReady } = require('./wait-for-nest-ready');
 
 const NEST_PORT = Number(process.env.NEST_PORT) || 8000;
 const HEALTH_URL = `http://127.0.0.1:${NEST_PORT}/api/health/live`;
@@ -50,40 +63,11 @@ function pingOnce(url) {
 
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
 
-async function waitForNestReady() {
-  const initiallyAlive = await pingOnce(HEALTH_URL);
-  if (!initiallyAlive) {
-    log(`nest not running at ${HEALTH_URL}, skip waiting.`);
-    return;
-  }
-  log(`waiting for nest restart at ${HEALTH_URL} ...`);
-
-  // Phase 1: 等 nest --watch 检测到文件变化并开始重编译（服务短暂 down）
-  const started = Date.now();
-  const observeDownTimeoutMs = 15_000;
-  let observedDown = false;
-  while (Date.now() - started < observeDownTimeoutMs) {
-    if (!(await pingOnce(HEALTH_URL))) {
-      observedDown = true;
-      break;
-    }
-    await sleep(300);
-  }
-  if (!observedDown) {
-    log('nest did not restart within 15s (maybe not in --watch mode); continue.');
-    return;
-  }
-
-  // Phase 2: 等 nest 重新起来
-  const totalTimeoutMs = 60_000;
-  while (Date.now() - started < totalTimeoutMs) {
-    if (await pingOnce(HEALTH_URL)) {
-      log('nest ready.');
-      return;
-    }
-    await sleep(500);
-  }
-  log(`nest not ready within ${totalTimeoutMs}ms, continue anyway.`);
+function envInt(name) {
+  const v = process.env[name];
+  if (v === undefined || v === '') return undefined;
+  const n = Number(v);
+  return Number.isFinite(n) && n > 0 ? n : undefined;
 }
 
 function touchViteSentinel() {
@@ -97,8 +81,20 @@ function touchViteSentinel() {
 }
 
 (async () => {
-  if (shouldWaitNest) await waitForNestReady();
-  if (shouldTouchWeb) touchViteSentinel();
+  await waitForNestReady({
+    ping: () => pingOnce(HEALTH_URL),
+    sleep,
+    now: () => Date.now(),
+    log,
+    opts: {
+      pollMs: envInt('POSTGEN_POLL_MS'),
+      initialStableMs: envInt('POSTGEN_INITIAL_STABLE_MS'),
+      maxStableMs: envInt('POSTGEN_MAX_STABLE_MS'),
+      observeDownTimeoutMs: envInt('POSTGEN_OBSERVE_DOWN_TIMEOUT_MS'),
+      totalTimeoutMs: envInt('POSTGEN_TOTAL_TIMEOUT_MS'),
+    },
+  });
+  touchViteSentinel();
 })().catch((e) => {
   log(`unexpected error: ${e && e.stack ? e.stack : e}`);
   // 非致命，不 throw 避免影响 CLI 退出码

package/dist/lib/application/files/gadmin2-game-angle-demo/server/scripts/wait-for-nest-ready.js

@@ -0,0 +1,148 @@
+/* eslint-disable */
+/**
+ * waitForNestReady —— 判断 nest --watch 是否"稳定就绪"的纯函数。
+ *
+ * 背景：postgadminGenerate hook 需要在 nest 重启完成后再 touch web sentinel，
+ * 触发 vite reload。旧实现只等"第一次 down → 第一次 up"，遇到 gadmin g prisma
+ * 引发 tsc-watch 连续多次 rebuild 时会误判就绪：vite 触发浏览器 iframe 复活时
+ * nest 已被第 N+1 次 rebuild kill，vite proxy 拿到 ECONNRESET 返回 500 空 body，
+ * 页面白屏。
+ *
+ * 此模块用"自适应稳定窗口"取代"一次 down/up 就返回"：
+ *   - 观察到进入 up 后不立即返回，要求连续 stableRequiredMs 内保持 up。
+ *   - 一旦观察到新的 up→down 转换（说明又 rebuild 了），根据实际 rebuild 周期
+ *     动态扩展 stableRequiredMs，保证下一个静默期至少覆盖下一轮 rebuild。
+ *   - stableRequiredMs 有上限（maxStableMs），总等待时间有硬超时（totalTimeoutMs），
+ *     避免异常场景下 hook 无限阻塞。
+ *
+ * 依赖注入 ping/sleep/now/log 是为了单测可控。生产使用见 notify-dev-servers.js。
+ */
+
+'use strict';
+
+const DEFAULTS = {
+  pollMs: 250,
+  initialStableMs: 3000,
+  maxStableMs: 15000,
+  observeDownTimeoutMs: 15000,
+  totalTimeoutMs: 60000,
+};
+
+/**
+ * @param {object} deps
+ * @param {() => Promise<boolean>} deps.ping        探活函数，true = up, false = down。
+ * @param {(ms: number) => Promise<void>} deps.sleep 睡眠函数（生产用 setTimeout，测试可 mock 时钟）。
+ * @param {() => number} deps.now                    毫秒时间戳（生产用 Date.now，测试可 mock）。
+ * @param {(msg: string) => void} deps.log           日志函数。
+ * @param {Partial<typeof DEFAULTS>} [deps.opts]
+ * @returns {Promise<{skipped:boolean, reason?:string, timeout?:boolean, restarts?:number, stableRequiredMs?:number, waited?:number}>}
+ */
+async function waitForNestReady({ ping, sleep, now, log, opts = {} }) {
+  const {
+    pollMs,
+    initialStableMs,
+    maxStableMs,
+    observeDownTimeoutMs,
+    totalTimeoutMs,
+  } = { ...DEFAULTS, ...opts };
+
+  // Phase 0：nest 一开始就没跑（本地未启动 / 生产环境），直接放行。
+  const initiallyAlive = await ping();
+  if (!initiallyAlive) {
+    log('nest not running, skip waiting.');
+    return { skipped: true, reason: 'not-running' };
+  }
+
+  const started = now();
+  log(
+    `waiting for nest restart (poll=${pollMs}ms, stable=${initialStableMs}ms, ` +
+      `maxStable=${maxStableMs}ms, totalTimeout=${totalTimeoutMs}ms) ...`,
+  );
+
+  // Phase 1：等第一次 down。若长时间不 down，视作"未在 --watch 模式"或"文件全 unchanged"，跳过。
+  let observedDown = false;
+  while (now() - started < observeDownTimeoutMs) {
+    if (!(await ping())) {
+      observedDown = true;
+      break;
+    }
+    await sleep(pollMs);
+  }
+  if (!observedDown) {
+    log(
+      `nest did not restart within ${observeDownTimeoutMs}ms (maybe not in --watch mode); continue.`,
+    );
+    return { skipped: true, reason: 'no-restart' };
+  }
+
+  // Phase 2：状态机 + 自适应稳定窗口。
+  let state = 'down';
+  let lastDownAt = now();
+  let lastUpAt = null;
+  let stableRequiredMs = initialStableMs;
+  let restarts = 1;
+
+  while (true) {
+    if (now() - started >= totalTimeoutMs) {
+      log(
+        `nest not stable within ${totalTimeoutMs}ms ` +
+          `(restarts=${restarts}, stableRequired=${stableRequiredMs}ms); continue anyway.`,
+      );
+      return {
+        skipped: false,
+        timeout: true,
+        restarts,
+        stableRequiredMs,
+        waited: now() - started,
+      };
+    }
+
+    const alive = await ping();
+    const currentState = alive ? 'up' : 'down';
+
+    if (state === 'up' && currentState === 'down') {
+      // 新一轮 rebuild。用观察到的完整周期扩展下一次的静默要求。
+      const cycleLength = now() - lastDownAt;
+      const proposed = Math.ceil(cycleLength * 1.2);
+      const newStable = Math.min(
+        maxStableMs,
+        Math.max(stableRequiredMs, proposed),
+      );
+      if (newStable !== stableRequiredMs) {
+        log(
+          `observed rebuild cycle ${cycleLength}ms; ` +
+            `expanding stable window ${stableRequiredMs}→${newStable}ms.`,
+        );
+        stableRequiredMs = newStable;
+      }
+      lastDownAt = now();
+      restarts += 1;
+    } else if (state === 'down' && currentState === 'up') {
+      lastUpAt = now();
+    }
+
+    state = currentState;
+
+    if (
+      state === 'up' &&
+      lastUpAt !== null &&
+      now() - lastUpAt >= stableRequiredMs
+    ) {
+      const waited = now() - started;
+      log(
+        `nest ready (restarts=${restarts}, stable=${stableRequiredMs}ms, waited=${waited}ms).`,
+      );
+      return {
+        skipped: false,
+        timeout: false,
+        restarts,
+        stableRequiredMs,
+        waited,
+      };
+    }
+
+    await sleep(pollMs);
+  }
+}
+
+module.exports = { waitForNestReady, DEFAULTS };

package/dist/lib/application/files/gadmin2-game-angle-demo/server/scripts/wait-for-nest-ready.test.js

@@ -0,0 +1,196 @@
+/* eslint-disable */
+/**
+ * waitForNestReady 单测。
+ * 运行方式：
+ *   cd server && node --test scripts/wait-for-nest-ready.test.js
+ *
+ * 用 mock 时钟 + mock ping 序列离线覆盖以下场景：
+ *   1. 一次重启（当前 gadmin g prisma 观察到的常态）
+ *   2. 两次重启（调研中记录的双 rebuild 现象）
+ *   3. Phase 1 超时跳过（未在 --watch 模式或全 unchanged）
+ *   4. 稳定窗口按 rebuild 周期扩展（大 schema 情况）
+ *   5. 无限重启触发 totalTimeoutMs 硬超时（异常场景不卡死）
+ *   6. 初始 nest 未跑，直接跳过
+ */
+'use strict';
+
+const { test } = require('node:test');
+const assert = require('node:assert/strict');
+const { waitForNestReady } = require('./wait-for-nest-ready');
+
+/**
+ * 构造 mock 环境：ping 按脚本序列返回，时钟按 sleep 请求推进。
+ * 每次 ping 或 sleep 都会推进"一步"，让状态机可控。
+ *
+ * @param {Array<'up'|'down'>} pingScript 每次 ping 依次返回的状态。用尽后重复最后一项。
+ */
+function makeEnv(pingScript) {
+  let clock = 0;
+  let idx = 0;
+  const logs = [];
+  return {
+    ping: async () => {
+      const state = idx < pingScript.length ? pingScript[idx] : pingScript[pingScript.length - 1];
+      idx += 1;
+      return state === 'up';
+    },
+    sleep: async (ms) => {
+      clock += ms;
+    },
+    now: () => clock,
+    log: (msg) => logs.push(msg),
+    logs,
+    tick: (ms) => {
+      clock += ms;
+    },
+  };
+}
+
+test('nest 一开始就没跑：直接跳过', async () => {
+  const env = makeEnv(['down']);
+  const res = await waitForNestReady({
+    ping: env.ping,
+    sleep: env.sleep,
+    now: env.now,
+    log: env.log,
+  });
+  assert.deepEqual(res, { skipped: true, reason: 'not-running' });
+});
+
+test('Phase 1 超时（一直 up）：跳过', async () => {
+  // 100 次 up，覆盖 15s / 250ms = 60 次以上的 poll。
+  const env = makeEnv(new Array(100).fill('up'));
+  const res = await waitForNestReady({
+    ping: env.ping,
+    sleep: env.sleep,
+    now: env.now,
+    log: env.log,
+    opts: { observeDownTimeoutMs: 1000, pollMs: 250 },
+  });
+  assert.equal(res.skipped, true);
+  assert.equal(res.reason, 'no-restart');
+});
+
+test('一次重启：down 后 up，稳定 3s 后返回', async () => {
+  // 序列: initial up, down (Phase 1 观察), 之后一直 up。
+  const env = makeEnv(['up', 'down', 'up', 'up', 'up', 'up', 'up', 'up', 'up', 'up', 'up', 'up', 'up', 'up', 'up', 'up', 'up', 'up', 'up', 'up']);
+  const res = await waitForNestReady({
+    ping: env.ping,
+    sleep: env.sleep,
+    now: env.now,
+    log: env.log,
+    opts: { pollMs: 250, initialStableMs: 3000, totalTimeoutMs: 30000 },
+  });
+  assert.equal(res.skipped, false);
+  assert.equal(res.timeout, false);
+  assert.equal(res.restarts, 1);
+  assert.equal(res.stableRequiredMs, 3000);
+  // 稳定窗口至少满足初始值。
+  assert.ok(res.waited >= 3000, `waited ${res.waited} < 3000`);
+});
+
+test('两次重启（gadmin g prisma 常态）：等到第二次稳定后才返回', async () => {
+  // 序列: initial up → down (rebuild #1) → up (nest #B) → down (rebuild #2) → up (nest #C)*N。
+  // 用 pollMs=250, initialStableMs=3000。
+  // Phase 1 拿到 down 后进入 Phase 2 state='down'。
+  // 第 1 次 poll 拿到 up：state up, lastUpAt=t。
+  // 之后马上 down：会重启 restart 计数并扩展窗口。
+  // 后续持续 up 直到 stable 满足。
+  const env = makeEnv([
+    'up',    // Phase 0 initial
+    'down',  // Phase 1 observe down
+    'up',    // Phase 2 first poll: state=up
+    'down',  // second poll: state=down (rebuild #2 检测到)
+    'up',    // recovery
+    ...new Array(50).fill('up'),
+  ]);
+  const res = await waitForNestReady({
+    ping: env.ping,
+    sleep: env.sleep,
+    now: env.now,
+    log: env.log,
+    opts: { pollMs: 250, initialStableMs: 3000, totalTimeoutMs: 30000 },
+  });
+  assert.equal(res.skipped, false);
+  assert.equal(res.timeout, false);
+  // 至少 2 次 restart（Phase 1 观察 + Phase 2 又 down 一次）。
+  assert.ok(res.restarts >= 2, `restarts=${res.restarts} < 2`);
+});
+
+test('大 rebuild 周期：稳定窗口按周期扩展', async () => {
+  // 让 up 持续到刚好 = initialStableMs 时再 down（触发 stable 检查前一步）。
+  // pollMs=250, initialStableMs=1000: up 持续 4 次 poll 后 down，
+  // 此时 cycleLength=1000ms，proposed=ceil(1200)=1200 → 触发扩展。
+  const script = [
+    'up',    // Phase 0
+    'down',  // Phase 1 observe down
+    'up',    // Phase 2 iter1: t=0 → 250
+    'up',    // iter2: 250 → 500
+    'up',    // iter3: 500 → 750
+    'up',    // iter4: 750 → 1000 (Check 750 < 1000, 不 return)
+    'down',  // iter5: 1000, cycleLength=1000, 扩展到 1200
+    ...new Array(30).fill('up'), // 恢复 + 稳定 1200ms
+  ];
+  const env = makeEnv(script);
+  const res = await waitForNestReady({
+    ping: env.ping,
+    sleep: env.sleep,
+    now: env.now,
+    log: env.log,
+    opts: { pollMs: 250, initialStableMs: 1000, maxStableMs: 15000, totalTimeoutMs: 60000 },
+  });
+  assert.equal(res.skipped, false);
+  assert.equal(res.timeout, false);
+  assert.equal(res.stableRequiredMs, 1200);
+});
+
+test('稳定窗口不超过 maxStableMs 上限', async () => {
+  // pollMs=250, initialStableMs=500, maxStableMs=800:
+  // up 持续 8 次 poll (2000ms) 后 down，cycleLength=2000ms, proposed=2400ms，
+  // 应被 maxStableMs=800 封顶为 800。
+  const script = [
+    'up',    // Phase 0
+    'down',  // Phase 1
+    ...new Array(8).fill('up'), // 稳定 500ms 检查会在 iter3 触发（250+250+250=750>=500），需要 initialStableMs 更大
+  ];
+  // 重新调整：让 initialStableMs 大过第一段 up，才能保证不提前 return。
+  const env = makeEnv([
+    'up',
+    'down',
+    ...new Array(8).fill('up'), // 8 * 250 = 2000ms
+    'down', // cycleLength ≈ 2000ms
+    ...new Array(30).fill('up'),
+  ]);
+  const res = await waitForNestReady({
+    ping: env.ping,
+    sleep: env.sleep,
+    now: env.now,
+    log: env.log,
+    opts: {
+      pollMs: 250,
+      initialStableMs: 3000, // 大过第一段 up 的 2000ms，避免提前 return
+      maxStableMs: 1500,     // 故意小于 proposed=2400
+      totalTimeoutMs: 60000,
+    },
+  });
+  assert.equal(res.skipped, false);
+  assert.equal(res.stableRequiredMs, 1500);
+});
+
+test('无限重启：命中 totalTimeoutMs 硬超时', async () => {
+  // 交替 up/down 无止境，验证 totalTimeoutMs 触发返回而不是死循环。
+  const script = ['up', 'down'];
+  // 让 makeEnv 初始 ping 返回 up；Phase 1 拿 down；Phase 2 交替。
+  const alternating = ['up', 'down'];
+  for (let i = 0; i < 5000; i++) alternating.push(i % 2 === 0 ? 'up' : 'down');
+  const env = makeEnv(alternating);
+  const res = await waitForNestReady({
+    ping: env.ping,
+    sleep: env.sleep,
+    now: env.now,
+    log: env.log,
+    opts: { pollMs: 250, initialStableMs: 3000, totalTimeoutMs: 5000 },
+  });
+  assert.equal(res.timeout, true);
+  assert.ok(res.waited >= 5000, `waited=${res.waited} < 5000`);
+});

package/dist/lib/application/files/gadmin2-game-angle-demo/server/src/main.ts

@@ -18,13 +18,13 @@ import {
   SwaggerDocumentOptions,
   SwaggerModule,
 } from '@nestjs/swagger';
-import cookieParser from 'cookie-parser';
 import 'dotenv/config';
 import { PrismaClientExceptionFilter, PrismaService } from 'nestjs-prisma';
 import { AppModule } from './app.module';
 import AuthGuard from './lib/auth.guard';
 import RolesGuard from './lib/roles.guard';
 import { UserService } from './modules/user/user.service';
+import cookieParser = require('cookie-parser');
 
 // https://www.prisma.io/docs/concepts/components/prisma-client/working-with-fields#working-with-bigint
 const stringify = JSON.stringify;

package/dist/lib/application/files/gadmin2-game-angle-demo/web/ecosystem.dev.config.cjs

@@ -0,0 +1,20 @@
+// pm2 dev 场景专用配置：直接跑 vite CLI，不套 npm 壳。
+// 由 branch.service.ts 通过 pm2 CLI 传入 PM2_NAME / VITE_PORT / VITE_BRANCH_OWNER 等环境变量。
+// vite 自己会读 .env / .env.local，无需 dotenv-cli 层。
+module.exports = {
+  apps: [
+    {
+      name: process.env.PM2_NAME,
+      script: './node_modules/vite/bin/vite.js',
+      args: process.env.VITE_PORT ? `--port ${process.env.VITE_PORT}` : '',
+      interpreter: 'node',
+      cwd: __dirname,
+      autorestart: false,
+      // NODE_OPTIONS 保留原 package.json 里的 4GB 上限设置。
+      node_args: '--max-old-space-size=4096',
+      env: {
+        ...(process.env.VITE_BRANCH_OWNER ? { VITE_BRANCH_OWNER: process.env.VITE_BRANCH_OWNER } : {}),
+      },
+    },
+  ],
+};

package/dist/lib/application/files/gadmin2-game-angle-demo/web/vite.config.ts

@@ -5,8 +5,15 @@ import tsconfigPaths from 'vite-tsconfig-paths';
 import { devShellPlugin } from './src/plugins/devShellPlugin';
 
 // gadmin g prisma 生成完毕后触发：CLI 会 touch 本文件，
-// 插件监听变更后调用 server.restart() —— 清空 module graph 释放内存，
-// 并通过 HMR ws 广播 full-reload，浏览器自动刷新。
+// 插件监听变更后 invalidate module graph 并广播 full-reload。
+//
+// 历史：曾用 server.restart()，每次会重新 esbuild bundle 一次 vite.config.ts
+// 及其依赖，旧 config module 被 v8 保留，实测每次泄漏 15~20MB rss，
+// 几十次调用后进程内存从 60MB 涨到 600MB+。
+//
+// 改用 moduleGraph.invalidateAll() + hot full-reload：
+// - invalidateAll() 只清 transform 结果，不重载 config、不重跑 esbuild
+// - full-reload 让浏览器重新请求，vite 按最新文件重新 transform
 function gadminRestartPlugin(): Plugin {
   const sentinel = path.resolve(__dirname, '.vite-restart');
   return {
@@ -16,10 +23,11 @@ function gadminRestartPlugin(): Plugin {
       server.watcher.on('change', (file) => {
         if (path.resolve(file) === sentinel) {
           server.config.logger.info(
-            '[gadmin] generated code changed, restarting vite...',
+            '[gadmin] generated code changed, invalidating & full-reload...',
             { timestamp: true },
           );
-          server.restart();
+          server.moduleGraph.invalidateAll();
+          server.hot.send({ type: 'full-reload', path: '*' });
         }
       });
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gadmin2n/schematics",
-  "version": "0.0.130",
+  "version": "0.0.132",
   "description": "Gadmin - modern, fast, powerful node.js web framework (@schematics)",
   "main": "dist/index.js",
   "files": [