@lark-apaas/miaoda-cli 0.1.39-alpha.4ae5653 → 0.1.39-alpha.508c930

package/README.md

@@ -54,11 +54,11 @@ miaoda file ls --output json
 
 ## 全栈应用的 MCP UI 检查
 
-MCP UI 使用平台预设提供的浏览器检查默认值。`npm run lint` 和 `npm run type:check` 自动覆盖 `server/mcp/ui`，模板统一提供 UI 子命令与类型配置；`lint -- --files` 保留按文件选择检查范围。没有 UI 源码时跳过 UI 检查。
+创建 MCP UI 时，Agent 在 `server/mcp/ui` 中同时生成 `tsconfig.json` 和 `eslint.config.cjs`，修改 UI 或其 shared 依赖后主动运行独立检查。模板和 CLI 不生成 UI 配置，也不将 UI 检查接入主工程 lint/type:check。
 
-应用增加 `type:check:mcp-ui` 子命令，与 `type:check:client`、`type:check:server` 一起由 `type:check` 聚合。`scripts/typecheck-mcp-ui.js` 只在 UI 源码存在时调用应用安装的 `tsc --noEmit --project tsconfig.mcp-ui.json`；无 UI 或目录为空时成功跳过。根目录 `tsconfig.mcp-ui.json` 提供浏览器、React JSX 和严格类型检查配置，可按应用需要修改；sync 仅在该文件不存在时创建。已有 `server/mcp/ui/tsconfig.json` 的应用优先沿用原配置，保留自定义 paths/types。
+主工程保留原 client/server 检查。Agent 从工程根执行 `npx --no-install tsc --noEmit --project server/mcp/ui/tsconfig.json`，再执行 `npx --no-install eslint --config server/mcp/ui/eslint.config.cjs "server/mcp/ui/**/*.{ts,tsx,js,jsx}" --max-warnings 0`；必须检查退出码并修复错误。无需辅助脚本或新增 npm 命令。
 
-UI ESLint 默认配置由平台预设提供，也可用根目录 `eslint.mcp-ui.config.js` / `.cjs` / `.mjs` 定制。`npm run lint` 包含 UI 检查；`--files` 按影响范围检查，shared 变更触发三个环境的类型检查。应用脚本不使用 `node -e` 或 TypeScript 编译器 API。
+CLI 不注入 MCP UI 检查命令；主工程保留原有 client/server 检查，UI 由 Agent 按独立配置执行标准 tsc/eslint。
 
 存量 sync 不改写 ESLint 源码；UI 全局排除项由平台 ESLint 预设提供。TS 仅向已有显式 `exclude` 数组追加目录，保留注释和原项；依赖继承且未显式声明 `exclude` 的自定义配置保持不变并提示人工调整。自定义检查命令保留。lint.js 和 build.sh 仍由平台脚本模板维护，不依赖预设包中的脚本执行入口。
 

package/dist/config/migrate-configs/vite-react-to-nestjs-react-fullstack.js

@@ -70,7 +70,6 @@ exports.MIGRATE_CONFIG = {
         { type: 'file', from: 'tsconfig.json', to: 'tsconfig.json', overwrite: true },
         { type: 'file', from: 'tsconfig.app.json', to: 'tsconfig.app.json', overwrite: true },
         { type: 'file', from: 'tsconfig.node.json', to: 'tsconfig.node.json', overwrite: true },
-        { type: 'file', from: 'tsconfig.mcp-ui.json', to: 'tsconfig.mcp-ui.json', overwrite: false },
         // ESLint 9 flat config —— vite-react 用 eslint.config.mjs 已删，fullstack 用
         // eslint.config.js (commonjs) + extends @lark-apaas/fullstack-presets；user 通常不改
         { type: 'file', from: 'eslint.config.js', to: 'eslint.config.js', overwrite: true },
@@ -159,16 +158,10 @@ exports.MIGRATE_CONFIG = {
             command: 'tsc --noEmit --project tsconfig.app.json',
             overwrite: true,
         },
-        {
-            type: 'add-script',
-            name: 'type:check:mcp-ui',
-            command: 'node ./scripts/typecheck-mcp-ui.js',
-            overwrite: true,
-        },
         {
             type: 'add-script',
             name: 'type:check',
-            command: 'concurrently -n "server,client,mcp-ui" -c "blue,green,magenta" "npm run type:check:server" "npm run type:check:client" "npm run type:check:mcp-ui"',
+            command: 'concurrently -n "server,client" -c "blue,green" "npm run type:check:server" "npm run type:check:client"',
             overwrite: true,
         },
         // ----- 平台脚本调用链 -----

package/dist/config/sync-configs/nestjs-react-fullstack.js

@@ -159,46 +159,12 @@ exports.SYNC_CONFIG = {
             to: `npx -y ${fullstack_cli_pin_1.FULLSTACK_CLI_PIN_SPEC} sync --disable-gen-openapi`,
             ifStartsWith: 'npx -y @lark-apaas/fullstack-cli sync',
         },
-        // MCP UI 使用独立浏览器配置；仅迁移已知模板命令，不生成 UI 目录；根配置仅在缺失时补齐。
+        // MCP UI 使用独立浏览器配置；只补服务端排除项，不生成 UI 目录和配置。
         {
             type: 'typescript-exclude',
             to: 'tsconfig.node.json',
             path: 'server/mcp/ui',
         },
-        { type: 'file', from: 'tsconfig.mcp-ui.json', to: 'tsconfig.mcp-ui.json', overwrite: false },
-        {
-            type: 'add-script',
-            name: 'type:check:mcp-ui',
-            command: 'node ./scripts/typecheck-mcp-ui.js',
-            overwrite: false,
-        },
-        {
-            type: 'patch-script',
-            name: 'type:check:mcp-ui',
-            to: 'node ./scripts/typecheck-mcp-ui.js',
-            ifEquals: [
-                'node ./scripts/check.cjs --typecheck-mcp-ui',
-                'node ./scripts/lint.js --typecheck-mcp-ui',
-            ],
-        },
-        {
-            type: 'patch-script',
-            name: 'type:check',
-            to: 'concurrently -n "server,client,mcp-ui" -c "blue,green,magenta" "npm run type:check:server" "npm run type:check:client" "npm run type:check:mcp-ui"',
-            ifEquals: [
-                'node ./scripts/check.cjs --typecheck',
-                'node ./scripts/lint.js --typecheck',
-                'concurrently -n "server,client" -c "blue,green" "npm run type:check:server" "npm run type:check:client"',
-                'concurrently "npm run type:check:server" "npm run type:check:client"',
-                'concurrently "npm run type:check:client" "npm run type:check:server"',
-            ],
-        },
-        {
-            type: 'patch-script',
-            name: 'eslint',
-            to: 'eslint . --quiet',
-            ifEquals: ['eslint . --quiet --ignore-pattern "server/mcp/ui/**"'],
-        },
         // ===== miaoda-cli 本地开发新增规则（fullstack-cli sync 不会执行） =====
         // M1. scripts.dev:local —— 本地用户绕过沙箱判定直接跑本地链路（npm run dev:local）。
         //     dev.sh 在 MIAODA_DEP_CACHE_DIR 非空时跑 dev.js（沙箱保活）、否则 exec dev-local.js；显式 dev:local

package/dist/utils/sync-rule.js

@@ -221,10 +221,7 @@ function applyPatchScript(rule, targetDir, logPrefix) {
         (0, logger_1.log)(logPrefix, `  ○ scripts.${rule.name} (already patched)`);
         return { rule, action: 'noop', path: 'package.json' };
     }
-    const matches = rule.ifEquals
-        ? rule.ifEquals.includes(current)
-        : rule.ifStartsWith !== undefined && current.startsWith(rule.ifStartsWith);
-    if (!matches) {
+    if (!current.startsWith(rule.ifStartsWith)) {
         (0, logger_1.log)(logPrefix, `  ⚠ scripts.${rule.name} customized, skip patch`);
         return { rule, action: 'skipped', path: 'package.json' };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.39-alpha.4ae5653",
+  "version": "0.1.39-alpha.508c930",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {
@@ -51,9 +51,9 @@
     "prettier": "^3.8.3",
     "tsc-alias": "^1.8.11",
     "tsx": "^4.19.4",
+    "typescript": "^5.8.3",
     "vitest": "^4.1.4",
-    "xml2js": "^0.6.2",
-    "typescript": "^5.8.3"
+    "xml2js": "^0.6.2"
   },
   "scripts": {
     "build": "bash scripts/build.sh",

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

@@ -210,28 +210,3 @@ else
   echo "   node_modules: $NODE_MODULES_SIZE"
   echo ""
 fi
-
-# 仅成功的全构建生成 backendBuildID；必须在构建、产物准备和依赖裁剪之后。
-# UI/Skill 内容由 SDK 独立计入总 hash；纯前端发布不替换已部署的 backendBuildID。
-if [[ "${only_frontend_change:-false}" != "true" ]]; then
-  node - "$ROOT_DIR/dist" <<'NODE'
-const fs = require('node:fs');
-const path = require('node:path');
-const { randomUUID } = require('node:crypto');
-const dist = process.argv[2];
-// 防止 build:server 空跑成功、却没有可交付的服务端入口。
-if (!fs.statSync(path.join(dist, 'server/main.js')).isFile()) {
-  throw new Error('Missing server build output: dist/server/main.js');
-}
-// runtime cwd 分别为工程根、dist/（或整包解压到 dist-server/）、旧版 dist/server/。
-// 与 MCP UI/Skill 的交付布局一致：复制产物时保留同一个 UUID，不在启动时生成。
-const files = [
-  path.join(dist, 'mcp-build-id'),
-  path.join(dist, 'dist/mcp-build-id'),
-  path.join(dist, 'server/dist/mcp-build-id'),
-];
-for (const file of files) fs.mkdirSync(path.dirname(file), { recursive: true });
-const buildID = randomUUID();
-for (const file of files) fs.writeFileSync(file, buildID, 'utf8');
-NODE
-fi

package/upgrade/templates/nestjs-react-fullstack/templates/scripts/lint.js

@@ -1,26 +1,40 @@
 #!/usr/bin/env node
 
 const path = require('node:path');
-const fs = require('node:fs');
 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.log(`[lint] Deleted file: ${filePath}; checking affected projects`);
+    console.warn(`[lint] Skip missing file: ${filePath}`);
+    return null;
   }
 
   const relativePath = path.relative(cwd, absolutePath);
-  if (
-    relativePath === '..' ||
-    relativePath.startsWith(`..${path.sep}`) ||
-    path.isAbsolute(relativePath)
-  ) {
+  if (relativePath.startsWith('..')) {
     console.warn(`[lint] Skip file outside project: ${filePath}`);
     return null;
   }
@@ -77,144 +91,25 @@ function canRunStylelint() {
 
   if (!pkg.scripts || !pkg.scripts.stylelint) return false;
 
-  return STYLELINT_CONFIG_FILES.some(file =>
-    fs.existsSync(path.join(cwd, file))
-  );
-}
-
-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 ?? 1));
-    child.on('error', () => resolve(1));
-  });
-}
-
-// 串行依次执行每个任务，全部跑完后再聚合退出码：
-// 降低并发资源占用、让各任务输出按顺序清晰可读，同时保留“一次暴露所有 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;
-}
-
-const UI_DIR = 'server/mcp/ui';
-
-function uiSourceFiles() {
-  const files = [];
-  function visit(relative) {
-    const absolute = path.join(cwd, relative);
-    if (!fs.existsSync(absolute)) return;
-    if (fs.lstatSync(absolute).isSymbolicLink()) {
-      throw new Error(`MCP UI 检查不支持符号链接: ${relative}`);
-    }
-    for (const entry of fs.readdirSync(absolute, { withFileTypes: true })) {
-      if (['node_modules', 'dist', '.git'].includes(entry.name)) continue;
-      const file = `${relative}/${entry.name}`;
-      if (entry.isSymbolicLink())
-        throw new Error(`MCP UI 检查不支持符号链接: ${file}`);
-      if (entry.isDirectory()) visit(file);
-      else if (isEslintTarget(file) && !/\.d\.(?:ts|mts|cts)$/.test(file))
-        files.push(file);
-    }
-  }
-  visit(UI_DIR);
-  return files.sort();
-}
-
-function uiTasks({ types = true, eslint = true } = {}) {
-  const sources = uiSourceFiles();
-  if (!sources.length) return [];
-  const tasks = [];
-  if (types) tasks.push([getBinName('npm'), ['run', 'type:check:mcp-ui']]);
-  if (eslint) {
-    const config = [
-      'eslint.mcp-ui.config.js',
-      'eslint.mcp-ui.config.cjs',
-      'eslint.mcp-ui.config.mjs',
-    ].find(file => fs.existsSync(path.join(cwd, file)));
-    let resolvedConfig = config;
-    if (!resolvedConfig) {
-      try {
-        resolvedConfig =
-          require.resolve('@lark-apaas/fullstack-presets/lib/mcp/eslint-ui.js');
-      } catch {
-        throw new Error(
-          '请升级 @lark-apaas/fullstack-presets 以使用 MCP UI 默认 ESLint 配置，或提供 eslint.mcp-ui.config.cjs'
-        );
-      }
-    }
-    tasks.push([
-      getBinName('npx'),
-      [
-        '--no-install',
-        'eslint',
-        '--config',
-        resolvedConfig,
-        '--quiet',
-        '--max-warnings',
-        '0',
-        ...sources,
-      ],
-    ]);
-  }
-  return tasks;
-}
-
-function packageScripts() {
-  return (
-    JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf8'))
-      .scripts || {}
-  );
-}
-
-function isUiFile(file) {
-  return file.startsWith('server/mcp/ui/');
+  return STYLELINT_CONFIG_FILES.some(file => fs.existsSync(path.join(cwd, file)));
 }
 
 async function runDefaultLint() {
-  const taskSpecs = [
-    [getBinName('npm'), ['run', 'eslint']],
-    [getBinName('npm'), ['run', 'type:check']],
-  ];
-
-  // 保留用户的 type:check；未聚合 UI 时由 lint 补查。
-  taskSpecs.push(
-    ...uiTasks({
-      types: !/\bnpm\s+run\s+type:check:mcp-ui(?=[\s"';&|)]|$)/.test(
-        packageScripts()['type:check'] || ''
-      ),
-    })
-  );
+  const commands = ['npm run eslint', 'npm run type:check'];
 
   if (canRunStylelint()) {
-    taskSpecs.push([getBinName('npm'), ['run', 'stylelint']]);
+    commands.push('npm run stylelint');
   } else {
-    console.warn(
-      '[lint] Skip stylelint: missing scripts.stylelint or stylelint config'
-    );
+    console.warn('[lint] Skip stylelint: missing scripts.stylelint or stylelint config');
   }
 
-  process.exit(await runTasksSerially(taskSpecs));
+  const code = await runCommand(getBinName('npx'), ['concurrently', ...commands]);
+  process.exit(code);
 }
 
 async function runSelectiveLint(inputFiles) {
   const normalizedFiles = Array.from(
-    new Set(inputFiles.map(normalizeProjectFile).filter(Boolean))
+    new Set(inputFiles.map(normalizeProjectFile).filter(Boolean)),
   );
 
   if (normalizedFiles.length === 0) {
@@ -222,41 +117,15 @@ async function runSelectiveLint(inputFiles) {
     process.exit(0);
   }
 
-  const eslintFiles = normalizedFiles.filter(
-    file =>
-      fs.existsSync(path.join(cwd, file)) &&
-      isEslintTarget(file) &&
-      !isUiFile(file) &&
-      !file.startsWith('eslint.mcp-ui.config.')
-  );
-  const stylelintFiles = normalizedFiles.filter(
-    file => fs.existsSync(path.join(cwd, file)) && isStylelintTarget(file)
-  );
+  const eslintFiles = normalizedFiles.filter(isEslintTarget);
+  const stylelintFiles = normalizedFiles.filter(isStylelintTarget);
   const typeCheckFiles = normalizedFiles.filter(isTypeCheckTarget);
 
   const clientTypeFiles = [];
   const serverTypeFiles = [];
-  const rootConfigChanged = normalizedFiles.some(file =>
-    /^tsconfig(?:\.[^/]*)?\.json$/.test(file)
-  );
-  if (rootConfigChanged) {
-    clientTypeFiles.push('config');
-    serverTypeFiles.push('config');
-  }
-  let checkUi =
-    rootConfigChanged ||
-    normalizedFiles.some(
-      file =>
-        isUiFile(file) ||
-        file.startsWith('shared/') ||
-        file.startsWith('eslint.mcp-ui.config.') ||
-        file === 'package.json'
-    );
 
   for (const filePath of typeCheckFiles) {
-    if (isUiFile(filePath)) {
-      checkUi = true;
-    } else if (filePath.startsWith('client/')) {
+    if (filePath.startsWith('client/')) {
       clientTypeFiles.push(filePath);
     } else if (filePath.startsWith('server/')) {
       serverTypeFiles.push(filePath);
@@ -266,52 +135,36 @@ 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 && !canRunStylelint()) {
-    console.warn(
-      '[lint] Skip stylelint: missing scripts.stylelint or stylelint config'
-    );
+    console.warn('[lint] Skip stylelint: missing scripts.stylelint or stylelint config');
   } else 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 (checkUi) taskSpecs.push(...uiTasks());
-
-  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() {
-  const args = process.argv.slice(2);
-  if (args.length === 1 && args[0] === '--eslint-mcp-ui') {
-    process.exit(await runTasksSerially(uiTasks({ types: false })));
-    return;
-  }
-  if (args.length && !(args[0] === '--files' && args.length > 1)) {
-    throw new Error('用法: lint.js [--files <paths...>]');
-  }
-  if (args[0] === '--files' && args.slice(1).some(arg => arg.startsWith('--')))
-    throw new Error('--files 不可与其他检查模式混用');
   const files = parseFilesArg(process.argv.slice(2));
   if (files === null) {
     await runDefaultLint();
@@ -326,7 +179,7 @@ async function main() {
   await runSelectiveLint(files);
 }
 
-main().catch(error => {
+main().catch((error) => {
   const message = error instanceof Error ? error.message : String(error);
   console.error(`[lint] Failed to run lint: ${message}`);
   process.exit(1);

package/upgrade/templates/nestjs-react-fullstack/templates/scripts/prune-smart.js

@@ -6,6 +6,13 @@ const fs = require('fs');
 const path = require('path');
 
 const ROOT_DIR = path.resolve(__dirname, '..');
+
+// 加载提交的 .env，供读取构建期配置（如 MIAODA_RUNTIME_ENTRIES）。dotenv 不一定安装 → 静默降级。
+try {
+  require('dotenv').config({ path: path.join(ROOT_DIR, '.env') });
+} catch {
+  // dotenv 未安装：跳过；MIAODA_RUNTIME_ENTRIES 仍可来自真实环境变量
+}
 const DIST_DIR = path.join(ROOT_DIR, 'dist');
 const DIST_SERVER_DIR = path.join(DIST_DIR, 'server');
 const ROOT_PACKAGE_JSON = path.join(ROOT_DIR, 'package.json');
@@ -16,6 +23,36 @@ const OUT_PACKAGE_JSON = path.join(DIST_DIR, 'package.json');
 // Server 入口文件
 const SERVER_ENTRY = path.join(DIST_SERVER_DIR, 'main.js');
 
+// nest sourceRoot（源码根，默认 server）：把 .env 里声明的源码路径映射到构建产物位置
+let SOURCE_ROOT = 'server';
+try {
+  const nestCli = JSON.parse(fs.readFileSync(path.join(ROOT_DIR, 'nest-cli.json'), 'utf8'));
+  if (nestCli.sourceRoot) SOURCE_ROOT = nestCli.sourceRoot;
+} catch {
+  // 读不到 nest-cli.json 则用默认 server
+}
+const SRC_TO_OUT_EXT = { '.mts': '.mjs', '.cts': '.cjs', '.ts': '.js' };
+
+// 额外 trace 入口：经 new Function/动态 import 加载、nft 无法从 main.js 静态发现的 ESM runtime。
+// 应用在提交的 .env 里用 MIAODA_RUNTIME_ENTRIES 声明【源码路径】（相对项目根，逗号分隔），例如：
+//   MIAODA_RUNTIME_ENTRIES=server/modules/ethics/runtime/review-run.mjs,server/modules/ethics/runtime/parse-core.mjs
+// 脚本按 nest sourceRoot 自动映射到 dist/server 下的构建产物（并重写 .mts→.mjs / .ts→.js）。
+const RUNTIME_ENTRIES = (process.env.MIAODA_RUNTIME_ENTRIES || '')
+  .split(',')
+  .map((s) => s.trim())
+  .filter(Boolean)
+  .map((srcRel) => {
+    const fromSrc = path.relative(SOURCE_ROOT, srcRel); // 去掉 sourceRoot 前缀
+    const ext = path.extname(fromSrc);
+    const outRel = SRC_TO_OUT_EXT[ext] ? fromSrc.slice(0, -ext.length) + SRC_TO_OUT_EXT[ext] : fromSrc;
+    return path.join(DIST_SERVER_DIR, outRel);
+  })
+  .filter((p) => {
+    if (fs.existsSync(p)) return true;
+    console.warn(`⚠️  MIAODA_RUNTIME_ENTRIES 入口在构建产物中不存在，已忽略: ${path.relative(ROOT_DIR, p)}`);
+    return false;
+  });
+
 // Node.js 内置模块列表
 const BUILTIN_MODULES = new Set([
   'assert', 'buffer', 'child_process', 'cluster', 'crypto', 'dgram', 'dns',
@@ -145,12 +182,15 @@ async function smartPrune() {
   }
 
   console.log(`📂 分析入口文件: ${path.relative(ROOT_DIR, SERVER_ENTRY)}`);
+  if (RUNTIME_ENTRIES.length) {
+    console.log(`📎 额外 trace 入口 (${RUNTIME_ENTRIES.length}): ${RUNTIME_ENTRIES.map((p) => path.relative(DIST_SERVER_DIR, p)).join(', ')}`);
+  }
 
   // 2. 使用 @vercel/nft 追踪依赖
   console.log('🔎 追踪实际依赖...');
   const analyzeStart = Date.now();
 
-  const { fileList } = await nodeFileTrace([SERVER_ENTRY], {
+  const { fileList } = await nodeFileTrace([SERVER_ENTRY, ...RUNTIME_ENTRIES], {
     base: ROOT_DIR,
     processCwd: ROOT_DIR,
     ts: false, // 禁用 TS 解析

package/upgrade/templates/nestjs-react-fullstack/templates/scripts/typecheck-mcp-ui.js

@@ -1,32 +0,0 @@
-// MCP UI 是可选浏览器工程；没有源码时跳过，否则直接交给 tsc。
-const fs = require('node:fs');
-const path = require('node:path');
-const { spawnSync } = require('node:child_process');
-
-function hasSource(dir) {
-  if (!fs.existsSync(dir)) return false;
-  return fs.readdirSync(dir, { withFileTypes: true }).some(entry => {
-    if (['node_modules', 'dist'].includes(entry.name)) return false;
-    if (entry.isDirectory()) return hasSource(path.join(dir, entry.name));
-    return entry.isFile() && /\.(?:[cm]?[jt]sx?)$/.test(entry.name);
-  });
-}
-
-if (hasSource('server/mcp/ui')) {
-  // 已有应用的独立 UI 配置继续生效，避免升级覆盖自定义 paths/types。
-  const config = fs.existsSync('server/mcp/ui/tsconfig.json')
-    ? 'server/mcp/ui/tsconfig.json'
-    : 'tsconfig.mcp-ui.json';
-  const result = spawnSync(
-    process.execPath,
-    [
-      require.resolve('typescript/bin/tsc'),
-      '--noEmit',
-      '--project',
-      config,
-    ],
-    { stdio: 'inherit' }
-  );
-  if (result.error) console.error(result.error.message);
-  process.exitCode = result.status ?? 1;
-}

package/upgrade/templates/nestjs-react-fullstack/templates/tsconfig.mcp-ui.json

@@ -1,33 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "jsx": "react-jsx",
-    "types": [],
-    "strict": true,
-    "checkJs": true,
-    "lib": [
-      "ES2020",
-      "DOM",
-      "DOM.Iterable"
-    ],
-    "allowJs": true,
-    "skipLibCheck": true,
-    "esModuleInterop": true,
-    "noEmit": true,
-    "baseUrl": ".",
-    "paths": {
-      "@shared/*": [
-        "shared/*"
-      ]
-    }
-  },
-  "include": [
-    "server/mcp/ui/**/*"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist"
-  ]
-}