@lark-apaas/miaoda-cli 0.1.39-alpha.44e04b8 → 0.1.39-alpha.4ae5653

package/README.md

@@ -54,20 +54,13 @@ miaoda file ls --output json
 
 ## 全栈应用的 MCP UI 检查
 
-`miaoda app sync` 为 `nestjs-react-fullstack` 应用同步 `scripts/lint.js` 和独立 `scripts/check.cjs`，在
-`tsconfig.node.json` 中追加 `server/mcp/ui` 排除项，并保留现有配置及继承的排除路径。
-根 `eslint.config.js` / `.mjs` / `.cjs` 会增量追加 UI 全局忽略，直接 ESLint 调用和编辑器检查均生效。
-迁移不执行配置文件；无法静态识别的自定义导出保留并提示手动补齐。
-已知模板版本的 `type:check`、`eslint` 命令会迁移到独立检查入口；自定义命令保留并提示。
-类型检查及 UI 检查直接调用 `check.cjs`，不会回到 `lint.js`；旧版 sync 覆盖聚合脚本时独立入口仍保留，避免递归。
-
-- `npm run type:check`：检查服务端、客户端及 MCP UI。
-- `npm run type:check:mcp-ui` / `npm run eslint:mcp-ui`：单独检查 MCP UI。
-- `npm run lint -- --files <files...>`：按改动文件选择检查范围。
-
-同步不会生成 MCP UI 目录。开发 MCP UI 时，由 Agent 按 MCP 指南创建
-`server/mcp/ui/tsconfig.json` 和根目录 `eslint.mcp-ui.config.cjs`。
-没有 UI 源码时跳过独立检查；存在 UI 源码但缺少配置时明确报错。
+MCP UI 使用平台预设提供的浏览器检查默认值。`npm run lint` 和 `npm run type:check` 自动覆盖 `server/mcp/ui`，模板统一提供 UI 子命令与类型配置；`lint -- --files` 保留按文件选择检查范围。没有 UI 源码时跳过 UI 检查。
+
+应用增加 `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。
+
+UI ESLint 默认配置由平台预设提供，也可用根目录 `eslint.mcp-ui.config.js` / `.cjs` / `.mjs` 定制。`npm run lint` 包含 UI 检查；`--files` 按影响范围检查，shared 变更触发三个环境的类型检查。应用脚本不使用 `node -e` 或 TypeScript 编译器 API。
+
+存量 sync 不改写 ESLint 源码；UI 全局排除项由平台 ESLint 预设提供。TS 仅向已有显式 `exclude` 数组追加目录，保留注释和原项；依赖继承且未显式声明 `exclude` 的自定义配置保持不变并提示人工调整。自定义检查命令保留。lint.js 和 build.sh 仍由平台脚本模板维护，不依赖预设包中的脚本执行入口。
 
 ## 打包可本地访问的静态产物
 

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

@@ -70,6 +70,7 @@ 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 },
@@ -158,10 +159,16 @@ 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" -c "blue,green" "npm run type:check:server" "npm run type:check:client"',
+            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"',
             overwrite: true,
         },
         // ----- 平台脚本调用链 -----

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

@@ -159,44 +159,34 @@ 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',
         },
-        { type: 'eslint-ignore', to: 'eslint.config.js', pattern: 'server/mcp/ui/**' },
-        { type: 'eslint-ignore', to: 'eslint.config.mjs', pattern: 'server/mcp/ui/**' },
-        { type: 'eslint-ignore', to: 'eslint.config.cjs', pattern: 'server/mcp/ui/**' },
-        // 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/check.cjs --typecheck-mcp-ui',
-            overwrite: false,
-        },
-        {
-            type: 'add-script',
-            name: 'eslint:mcp-ui',
-            command: 'node ./scripts/check.cjs --eslint-mcp-ui',
+            command: 'node ./scripts/typecheck-mcp-ui.js',
             overwrite: false,
         },
         {
             type: 'patch-script',
             name: 'type:check:mcp-ui',
-            to: 'node ./scripts/check.cjs --typecheck-mcp-ui',
-            ifEquals: ['node ./scripts/lint.js --typecheck-mcp-ui'],
-        },
-        {
-            type: 'patch-script',
-            name: 'eslint:mcp-ui',
-            to: 'node ./scripts/check.cjs --eslint-mcp-ui',
-            ifEquals: ['node ./scripts/lint.js --eslint-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: 'node ./scripts/check.cjs --typecheck',
+            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"',
@@ -206,8 +196,8 @@ exports.SYNC_CONFIG = {
         {
             type: 'patch-script',
             name: 'eslint',
-            to: 'eslint . --quiet --ignore-pattern "server/mcp/ui/**"',
-            ifEquals: ['eslint . --quiet', '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）。

package/dist/utils/sync-rule.js

@@ -44,7 +44,6 @@ const file_ops_1 = require("./file-ops");
 const merge_json_1 = require("./merge-json");
 const logger_1 = require("./logger");
 const typescript_exclude_1 = require("./typescript-exclude");
-const eslint_ignore_1 = require("./eslint-ignore");
 /**
  * 顺序执行 SyncRule[]，逐条 apply。一条 rule 报错不影响后续 rule（catch + 记录），最终
  * 在 handler 层决定是否整体 fail。
@@ -108,19 +107,6 @@ function applyOne(rule, opts) {
         case 'patch-script': {
             return applyPatchScript(rule, targetDir, logPrefix);
         }
-        case 'eslint-ignore': {
-            const result = (0, eslint_ignore_1.addEslintGlobalIgnore)(node_path_1.default.join(targetDir, rule.to), rule.pattern);
-            if (result.warning)
-                (0, logger_1.log)(logPrefix, `  ⚠ ${result.warning}`);
-            if (result.changed)
-                (0, logger_1.log)(logPrefix, `  ✓ ${rule.to} (global ignore ${rule.pattern})`);
-            return {
-                rule,
-                action: result.changed ? 'patched' : result.warning ? 'skipped' : 'noop',
-                path: rule.to,
-                detail: result.warning,
-            };
-        }
         case 'typescript-exclude': {
             const changed = (0, typescript_exclude_1.excludeTypeScriptPath)(node_path_1.default.join(targetDir, rule.to), rule.path);
             (0, logger_1.log)(logPrefix, `  ${changed ? '✓' : '○'} ${rule.to} (exclude ${rule.path})`);

package/dist/utils/typescript-exclude.js

@@ -5,58 +5,32 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.excludeTypeScriptPath = excludeTypeScriptPath;
 const node_fs_1 = __importDefault(require("node:fs"));
-const node_path_1 = __importDefault(require("node:path"));
-const typescript_1 = __importDefault(require("typescript"));
 const jsonc_parser_1 = require("jsonc-parser");
 const error_1 = require("./error");
-/** 追加排除项，保留 JSONC 注释和继承的排除路径；不创建缺失的配置。 */
+/** Only append to explicit template excludes; never rewrite inherited user configuration. */
 function excludeTypeScriptPath(filename, excludedPath) {
     if (!node_fs_1.default.existsSync(filename))
         return false;
     const source = node_fs_1.default.readFileSync(filename, 'utf8');
     const errors = [];
     const raw = (0, jsonc_parser_1.parse)(source, errors, { allowTrailingComma: true });
-    if (errors.length || !raw || typeof raw !== 'object' || Array.isArray(raw)) {
-        throw new error_1.AppError('INVALID_CONFIG', `Invalid TypeScript configuration: ${filename}`);
-    }
-    const parsed = typescript_1.default.getParsedCommandLineOfConfigFile(filename, {}, {
-        ...typescript_1.default.sys,
-        onUnRecoverableConfigFileDiagnostic: (diagnostic) => {
-            throw new error_1.AppError('INVALID_CONFIG', typescript_1.default.flattenDiagnosticMessageText(diagnostic.messageText, '\n'));
-        },
-    });
-    // 初始化中的空工程允许迁移，其他错误不能被静默忽略。
-    const diagnostics = parsed?.errors.filter((d) => d.code !== 18003 && d.code !== 18002) ?? [];
-    if (!parsed || diagnostics.length) {
-        throw new error_1.AppError('INVALID_CONFIG', `Cannot migrate ${filename}: ${diagnostics.map((d) => typescript_1.default.flattenDiagnosticMessageText(d.messageText, '\n')).join('; ')}`);
-    }
-    const effective = parsed.raw;
-    const excludes = effective.exclude ?? [
-        'node_modules',
-        'bower_components',
-        'jspm_packages',
-        ...[parsed.options.outDir, parsed.options.declarationDir]
-            .filter((p) => Boolean(p))
-            .map((p) => node_path_1.default.relative(node_path_1.default.dirname(filename), p).split(node_path_1.default.sep).join('/')),
-    ];
-    if (!Array.isArray(excludes) || excludes.some((p) => typeof p !== 'string')) {
+    if (errors.length || !raw || typeof raw !== 'object')
         throw new error_1.AppError('INVALID_CONFIG', `Invalid exclude array: ${filename}`);
+    if (raw.exclude === undefined) {
+        console.warn(`Cannot safely update inherited excludes in ${filename}; add ${excludedPath} to the effective TypeScript exclude configuration.`);
+        return false;
     }
-    const paths = excludes;
-    if (paths.includes(excludedPath))
+    if (!Array.isArray(raw.exclude) || raw.exclude.some((p) => typeof p !== 'string'))
+        throw new error_1.AppError('INVALID_CONFIG', `Invalid exclude array: ${filename}`);
+    if (raw.exclude.includes(excludedPath))
         return false;
-    const ownExclude = raw.exclude;
-    const formattingOptions = {
-        insertSpaces: true,
-        tabSize: 2,
-        eol: source.includes('\r\n') ? '\r\n' : '\n',
-    };
-    const edits = Array.isArray(ownExclude)
-        ? (0, jsonc_parser_1.modify)(source, ['exclude', ownExclude.length], excludedPath, {
-            formattingOptions,
-            isArrayInsertion: true,
-        })
-        : (0, jsonc_parser_1.modify)(source, ['exclude'], [...paths, excludedPath], { formattingOptions });
-    node_fs_1.default.writeFileSync(filename, (0, jsonc_parser_1.applyEdits)(source, edits));
+    node_fs_1.default.writeFileSync(filename, (0, jsonc_parser_1.applyEdits)(source, (0, jsonc_parser_1.modify)(source, ['exclude', raw.exclude.length], excludedPath, {
+        isArrayInsertion: true,
+        formattingOptions: {
+            insertSpaces: true,
+            tabSize: 2,
+            eol: source.includes('\r\n') ? '\r\n' : '\n',
+        },
+    })));
     return true;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.39-alpha.44e04b8",
+  "version": "0.1.39-alpha.4ae5653",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {
@@ -33,8 +33,7 @@
     "jsonc-parser": "^3.3.1",
     "ora": "^5.4.1",
     "picocolors": "^1.1.1",
-    "which": "^7.0.0",
-    "typescript": "^5.8.3"
+    "which": "^7.0.0"
   },
   "devDependencies": {
     "@types/cross-spawn": "^6.0.6",
@@ -53,7 +52,8 @@
     "tsc-alias": "^1.8.11",
     "tsx": "^4.19.4",
     "vitest": "^4.1.4",
-    "xml2js": "^0.6.2"
+    "xml2js": "^0.6.2",
+    "typescript": "^5.8.3"
   },
   "scripts": {
     "build": "bash scripts/build.sh",

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

@@ -2,6 +2,7 @@
 
 const path = require('node:path');
 const fs = require('node:fs');
+const { spawn } = require('node:child_process');
 
 const cwd = process.cwd();
 
@@ -15,7 +16,11 @@ function normalizeProjectFile(filePath) {
   }
 
   const relativePath = path.relative(cwd, absolutePath);
-  if (relativePath.startsWith('..')) {
+  if (
+    relativePath === '..' ||
+    relativePath.startsWith(`..${path.sep}`) ||
+    path.isAbsolute(relativePath)
+  ) {
     console.warn(`[lint] Skip file outside project: ${filePath}`);
     return null;
   }
@@ -72,12 +77,114 @@ function canRunStylelint() {
 
   if (!pkg.scripts || !pkg.scripts.stylelint) return false;
 
-  return STYLELINT_CONFIG_FILES.some(file => fs.existsSync(path.join(cwd, file)));
+  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();
 }
 
-const { getBinName, runTasksSerially, uiTasks, packageScripts, main: runChecks } = require('./check.cjs');
-const UI_TYPECHECKS = ['node ./scripts/check.cjs --typecheck', 'node ./scripts/lint.js --typecheck'];
-function isUiFile(file) { return file.startsWith('server/mcp/ui/'); }
+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/');
+}
 
 async function runDefaultLint() {
   const taskSpecs = [
@@ -85,13 +192,21 @@ async function runDefaultLint() {
     [getBinName('npm'), ['run', 'type:check']],
   ];
 
-  // Customized type:check remains untouched; ensure full lint still checks UI.
-  taskSpecs.push(...uiTasks({ types: !UI_TYPECHECKS.includes(packageScripts()['type:check']) }));
+  // 保留用户的 type:check；未聚合 UI 时由 lint 补查。
+  taskSpecs.push(
+    ...uiTasks({
+      types: !/\bnpm\s+run\s+type:check:mcp-ui(?=[\s"';&|)]|$)/.test(
+        packageScripts()['type:check'] || ''
+      ),
+    })
+  );
 
   if (canRunStylelint()) {
     taskSpecs.push([getBinName('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));
@@ -99,7 +214,7 @@ async function runDefaultLint() {
 
 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) {
@@ -107,15 +222,36 @@ 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(
+    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 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.'));
+  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)) {
@@ -137,9 +273,14 @@ async function runSelectiveLint(inputFiles) {
   }
 
   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]]);
+    taskSpecs.push([
+      getBinName('npx'),
+      ['stylelint', '--quiet', ...stylelintFiles],
+    ]);
   }
 
   if (clientTypeFiles.length > 0) {
@@ -162,13 +303,15 @@ async function runSelectiveLint(inputFiles) {
 
 async function main() {
   const args = process.argv.slice(2);
-  const modes = ['--typecheck', '--typecheck-mcp-ui', '--eslint-mcp-ui'];
-  if (args.length && !(args[0] === '--files' && args.length > 1) && !(args.length === 1 && modes.includes(args[0]))) {
-    throw new Error('用法: lint.js [--files <paths...> | --typecheck | --typecheck-mcp-ui | --eslint-mcp-ui]');
+  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 不可与其他检查模式混用');
-  // 兼容旧入口，只向独立检查器转发；新的 npm scripts 不再指向 lint.js。
-  if (modes.includes(args[0])) return runChecks(args);
+  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();
@@ -183,7 +326,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/typecheck-mcp-ui.js

@@ -0,0 +1,32 @@
+// 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

@@ -0,0 +1,33 @@
+{
+  "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"
+  ]
+}

package/dist/utils/eslint-ignore.js

@@ -1,169 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.addEslintGlobalIgnore = addEslintGlobalIgnore;
-const node_fs_1 = __importDefault(require("node:fs"));
-const typescript_1 = __importDefault(require("typescript"));
-const error_1 = require("./error");
-/** 只解析源码，不加载用户配置；用局部插入保留自定义规则和注释。 */
-function addEslintGlobalIgnore(filename, pattern) {
-    if (!node_fs_1.default.existsSync(filename))
-        return { changed: false };
-    const source = node_fs_1.default.readFileSync(filename, 'utf8');
-    const file = typescript_1.default.createSourceFile(filename, source, typescript_1.default.ScriptTarget.Latest, true, typescript_1.default.ScriptKind.JS);
-    const diagnostics = file
-        .parseDiagnostics;
-    if (diagnostics.length)
-        throw new error_1.AppError('INVALID_CONFIG', `Invalid ESLint configuration: ${filename}`);
-    const variables = new Map();
-    const declarations = new Map();
-    const aliasReferences = new Set();
-    const resolvedAliases = new Set();
-    const exportTargets = new Set();
-    const helpers = new Set();
-    const namespaces = new Set();
-    const exports = [];
-    const moduleName = (node) => {
-        if (!typescript_1.default.isCallExpression(node) ||
-            !typescript_1.default.isIdentifier(node.expression) ||
-            node.expression.text !== 'require')
-            return;
-        const arg = node.arguments.at(0);
-        return arg && typescript_1.default.isStringLiteral(arg) ? arg.text : undefined;
-    };
-    for (const statement of file.statements) {
-        if (typescript_1.default.isImportDeclaration(statement) && typescript_1.default.isStringLiteral(statement.moduleSpecifier)) {
-            const module = statement.moduleSpecifier.text;
-            const clause = statement.importClause;
-            if (module === 'typescript-eslint' && clause?.name)
-                namespaces.add(clause.name.text);
-            const bindings = clause?.namedBindings;
-            if (bindings && typescript_1.default.isNamespaceImport(bindings) && module === 'typescript-eslint')
-                namespaces.add(bindings.name.text);
-            if (bindings && typescript_1.default.isNamedImports(bindings)) {
-                for (const element of bindings.elements) {
-                    const name = element.propertyName?.text ?? element.name.text;
-                    if ((module === 'eslint/config' && name === 'defineConfig') ||
-                        (module === 'typescript-eslint' && name === 'config'))
-                        helpers.add(element.name.text);
-                }
-            }
-        }
-        if (typescript_1.default.isVariableStatement(statement) && statement.declarationList.flags & typescript_1.default.NodeFlags.Const) {
-            for (const declaration of statement.declarationList.declarations) {
-                if (!declaration.initializer)
-                    continue;
-                const module = moduleName(declaration.initializer);
-                if (typescript_1.default.isIdentifier(declaration.name)) {
-                    variables.set(declaration.name.text, declaration.initializer);
-                    declarations.set(declaration.name.text, declaration.name);
-                    if (module === 'typescript-eslint')
-                        namespaces.add(declaration.name.text);
-                }
-                else if (typescript_1.default.isObjectBindingPattern(declaration.name)) {
-                    for (const element of declaration.name.elements) {
-                        const name = element.propertyName ?? element.name;
-                        if (!typescript_1.default.isIdentifier(name) || !typescript_1.default.isIdentifier(element.name))
-                            continue;
-                        if ((module === 'eslint/config' && name.text === 'defineConfig') ||
-                            (module === 'typescript-eslint' && name.text === 'config'))
-                            helpers.add(element.name.text);
-                    }
-                }
-            }
-        }
-        if (typescript_1.default.isExportAssignment(statement) && !statement.isExportEquals)
-            exports.push(statement.expression);
-        if (typescript_1.default.isExpressionStatement(statement) && typescript_1.default.isBinaryExpression(statement.expression)) {
-            const { left, right, operatorToken } = statement.expression;
-            if (operatorToken.kind === typescript_1.default.SyntaxKind.EqualsToken &&
-                typescript_1.default.isPropertyAccessExpression(left) &&
-                typescript_1.default.isIdentifier(left.expression) &&
-                left.expression.text === 'module' &&
-                left.name.text === 'exports') {
-                exports.push(right);
-                exportTargets.add(left);
-            }
-        }
-    }
-    function unwrap(node, seen = new Set()) {
-        if (typescript_1.default.isParenthesizedExpression(node))
-            return unwrap(node.expression, seen);
-        if (typescript_1.default.isIdentifier(node) && !seen.has(node.text)) {
-            const value = variables.get(node.text);
-            if (value) {
-                resolvedAliases.add(node.text);
-                aliasReferences.add(node);
-                seen.add(node.text);
-                return unwrap(value, seen);
-            }
-        }
-        return node;
-    }
-    const root = exports.length === 1 ? unwrap(exports[0]) : undefined;
-    // const 只固定变量绑定，不能保证数组不被 pop/push 或传给其他函数修改。
-    // 有额外引用时保留原配置，避免改变初始化数组影响用户后续操作。
-    function checkReferences(node) {
-        if (typescript_1.default.isIdentifier(node) &&
-            resolvedAliases.has(node.text) &&
-            declarations.get(node.text) !== node &&
-            !aliasReferences.has(node))
-            return true;
-        // module["exports"]、(module).exports、module 别名也可能修改导出数组。
-        if (typescript_1.default.isIdentifier(node) &&
-            node.text === 'module' &&
-            !(typescript_1.default.isPropertyAccessExpression(node.parent) &&
-                node.parent.expression === node &&
-                exportTargets.has(node.parent)))
-            return true;
-        return typescript_1.default.forEachChild(node, (child) => checkReferences(child) || undefined) ?? false;
-    }
-    const unsafeReference = checkReferences(file);
-    const isHelper = (node) => {
-        const callee = node.expression;
-        return typescript_1.default.isIdentifier(callee)
-            ? helpers.has(callee.text)
-            : typescript_1.default.isPropertyAccessExpression(callee) &&
-                typescript_1.default.isIdentifier(callee.expression) &&
-                namespaces.has(callee.expression.text) &&
-                callee.name.text === 'config';
-    };
-    const entries = root && typescript_1.default.isArrayLiteralExpression(root)
-        ? root.elements
-        : root && typescript_1.default.isCallExpression(root) && isHelper(root)
-            ? root.arguments
-            : undefined;
-    if (!entries || unsafeReference) {
-        return {
-            changed: false,
-            warning: `Cannot safely migrate ${filename}; add ${JSON.stringify(pattern)} to its global ignores manually.`,
-        };
-    }
-    // 只认真正的全局 ignores；带 files/rules 的局部忽略不能阻止服务端配置匹配 UI。
-    // 仅检查最后一个配置，确保此前的否定规则或动态配置无法撤销新增忽略。
-    const last = entries.at(-1);
-    if (last && typescript_1.default.isObjectLiteralExpression(last)) {
-        const props = last.properties;
-        const nameOf = (p) => p.name && (typescript_1.default.isIdentifier(p.name) || typescript_1.default.isStringLiteral(p.name)) ? p.name.text : undefined;
-        if (new Set(props.map(nameOf)).size === props.length &&
-            props.every((p) => typescript_1.default.isPropertyAssignment(p) && ['ignores', 'name'].includes(nameOf(p) ?? ''))) {
-            const ignores = props.find((p) => nameOf(p) === 'ignores');
-            if (ignores &&
-                typescript_1.default.isPropertyAssignment(ignores) &&
-                typescript_1.default.isArrayLiteralExpression(ignores.initializer)) {
-                const patterns = ignores.initializer.elements;
-                if (patterns.length &&
-                    patterns.every(typescript_1.default.isStringLiteral) &&
-                    patterns[patterns.length - 1].text === pattern)
-                    return { changed: false };
-            }
-        }
-    }
-    const eol = source.includes('\r\n') ? '\r\n' : '\n';
-    const position = last ? last.end : entries.pos;
-    const addition = `${last ? ',' : ''}${eol}  { ignores: [${JSON.stringify(pattern)}] }`;
-    node_fs_1.default.writeFileSync(filename, source.slice(0, position) + addition + source.slice(position));
-    return { changed: true };
-}

package/upgrade/templates/nestjs-react-fullstack/templates/scripts/check.cjs

@@ -1,123 +0,0 @@
-#!/usr/bin/env node
-
-// 叶子检查入口：不得调用 lint 或聚合 type:check npm script。
-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 ?? 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;
-}
-
-function isEslintTarget(filePath) { return /\.(c|m)?(j|t)sx?$/.test(filePath); }
-
-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) {
-    const config = `${UI_DIR}/tsconfig.json`;
-    if (!fs.existsSync(path.join(cwd, config))) {
-      throw new Error(`MCP UI 缺少 ${config}，请按 mcp-guide 补齐独立浏览器 TypeScript 配置。`);
-    }
-    const ts = require('typescript');
-    const parsed = ts.getParsedCommandLineOfConfigFile(path.join(cwd, config), {}, {
-      ...ts.sys,
-      onUnRecoverableConfigFileDiagnostic: d => { throw new Error(ts.flattenDiagnosticMessageText(d.messageText, '\n')); },
-    });
-    if (!parsed || parsed.errors.length) throw new Error(`MCP UI TypeScript 配置无效: ${config}`);
-    const included = new Set(parsed.fileNames.map(file => path.resolve(file)));
-    const missing = sources.filter(file => !included.has(path.resolve(cwd, file)));
-    if (missing.length) throw new Error(`MCP UI TypeScript 配置未覆盖源码: ${missing.join(', ')}；请检查 include/exclude，JS 源码需开启 allowJs。`);
-    tasks.push([getBinName('npx'), ['--no-install', 'tsc', '--noEmit', '-p', config]]);
-  }
-  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)));
-    if (!config) throw new Error('MCP UI 缺少独立 ESLint 配置，请按 mcp-guide 创建 eslint.mcp-ui.config.cjs。');
-    tasks.push([getBinName('npx'), ['--no-install', 'eslint', '--config', config, '--quiet', '--max-warnings', '0', ...sources]]);
-  }
-  return tasks;
-}
-
-function packageScripts() {
-  return JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf8')).scripts || {};
-}
-
-async function runTypeCheck() {
-  const scripts = packageScripts();
-  const tasks = ['type:check:server', 'type:check:client'].map(name => {
-    if (!scripts[name]) throw new Error(`缺少 scripts.${name}，请保留应用原有类型检查命令。`);
-    return [getBinName('npm'), ['run', name]];
-  });
-  tasks.push(...uiTasks({ eslint: false }));
-  process.exit(await runTasksSerially(tasks));
-}
-
-async function main(args = process.argv.slice(2)) {
-  const modes = ['--typecheck', '--typecheck-mcp-ui', '--eslint-mcp-ui'];
-  if (args.length !== 1 || !modes.includes(args[0])) {
-    throw new Error('用法: check.cjs --typecheck | --typecheck-mcp-ui | --eslint-mcp-ui');
-  }
-  // 自定义 leaf script 意外回到聚合入口时立即失败，避免生成递归进程树。
-  if (process.env.MIAODA_TYPECHECK_ACTIVE === '1') {
-    throw new Error('检测到检查命令递归，请检查 type:check:server/client，不能回调 lint 或 type:check。');
-  }
-  process.env.MIAODA_TYPECHECK_ACTIVE = '1';
-  if (args[0] === '--typecheck') return runTypeCheck();
-  process.exit(await runTasksSerially(uiTasks(args[0] === '--typecheck-mcp-ui' ? { eslint: false } : { types: false })));
-}
-
-module.exports = { getBinName, runTasksSerially, uiTasks, packageScripts, main };
-if (require.main === module) {
-  main().catch(error => { console.error(`[check] ${error.message}`); process.exit(1); });
-}