@lark-apaas/miaoda-cli 0.1.39-alpha.76f8fd5 → 0.1.39-alpha.ad15159

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (32) hide show
  1. package/README.md +10 -0
  2. package/dist/cli/commands/deploy/modern.js +4 -1
  3. package/dist/cli/commands/skills/index.js +1 -1
  4. package/dist/cli/handlers/app/export.js +3 -3
  5. package/dist/cli/handlers/app/migrate.js +4 -1
  6. package/dist/cli/handlers/app/sync.js +2 -2
  7. package/dist/cli/handlers/db/sql.js +8 -6
  8. package/dist/cli/handlers/deploy/modern.js +10 -3
  9. package/dist/cli/handlers/plugin/plugin-local.js +5 -4
  10. package/dist/config/migrate-configs/vite-react-to-nestjs-react-fullstack.js +21 -3
  11. package/dist/config/sync-configs/nestjs-react-fullstack.js +40 -0
  12. package/dist/services/app/init/async-install.js +13 -2
  13. package/dist/services/app/init/install.js +4 -3
  14. package/dist/services/deploy/modern/atoms/build.js +3 -3
  15. package/dist/services/deploy/modern/atoms/local-release.js +1 -0
  16. package/dist/services/deploy/modern/atoms/tosutil.js +6 -8
  17. package/dist/services/deploy/modern/pipelines/design-local.js +1 -0
  18. package/dist/services/deploy/modern/pipelines/local.js +1 -0
  19. package/dist/utils/archive.js +103 -0
  20. package/dist/utils/coding-steering.js +30 -2
  21. package/dist/utils/file-ops.js +28 -8
  22. package/dist/utils/http.js +6 -6
  23. package/dist/utils/npm-pack.js +6 -7
  24. package/dist/utils/run-npm.js +102 -0
  25. package/dist/utils/sync-rule.js +10 -1
  26. package/dist/utils/typescript-exclude.js +36 -0
  27. package/dist/utils/which.js +27 -0
  28. package/package.json +8 -4
  29. package/upgrade/templates/nestjs-react-fullstack/templates/scripts/build.sh +25 -0
  30. package/upgrade/templates/nestjs-react-fullstack/templates/scripts/lint.js +169 -27
  31. package/upgrade/templates/nestjs-react-fullstack/templates/scripts/typecheck-mcp-ui.js +32 -0
  32. package/upgrade/templates/nestjs-react-fullstack/templates/tsconfig.mcp-ui.json +33 -0
package/README.md CHANGED
@@ -52,6 +52,16 @@ miaoda file ls --output json
52
52
 
53
53
  完整命令通过 `miaoda --help` 或 `miaoda <domain> --help` 查看。
54
54
 
55
+ ## 全栈应用的 MCP UI 检查
56
+
57
+ MCP UI 使用平台预设提供的浏览器检查默认值。`npm run lint` 和 `npm run type:check` 自动覆盖 `server/mcp/ui`,模板统一提供 UI 子命令与类型配置;`lint -- --files` 保留按文件选择检查范围。没有 UI 源码时跳过 UI 检查。
58
+
59
+ 应用增加 `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。
60
+
61
+ UI ESLint 默认配置由平台预设提供,也可用根目录 `eslint.mcp-ui.config.js` / `.cjs` / `.mjs` 定制。`npm run lint` 包含 UI 检查;`--files` 按影响范围检查,shared 变更触发三个环境的类型检查。应用脚本不使用 `node -e` 或 TypeScript 编译器 API。
62
+
63
+ 存量 sync 不改写 ESLint 源码;UI 全局排除项由平台 ESLint 预设提供。TS 仅向已有显式 `exclude` 数组追加目录,保留注释和原项;依赖继承且未显式声明 `exclude` 的自定义配置保持不变并提示人工调整。自定义检查命令保留。lint.js 和 build.sh 仍由平台脚本模板维护,不依赖预设包中的脚本执行入口。
64
+
55
65
  ## 打包可本地访问的静态产物
56
66
 
57
67
  `miaoda app pack`(默认 `--mode standalone`)把当前应用构建成一份自包含静态产物,可脱离妙搭平台本地打开。
@@ -18,7 +18,7 @@ function registerDeployCommandsModern(program) {
18
18
  .option('--dir <path>', '项目目录', '.')
19
19
  .option('--skip-build', '跳过 build 步骤(已构建好时使用)', false)
20
20
  .option('--skip-release', '不创建/更新本地发布单,发布单状态由外部托管', false)
21
- .option('--conf <json>', '关联元信息 JSON,仅识别 checkPointVersion / commitID / sessionID / marker 四字段')
21
+ .option('--conf <json>', '关联元信息 JSON,仅识别 checkPointVersion / commitID / sessionID / marker / versionLevel 五字段')
22
22
  // 这三个 flag 只在父命令声明一份,deploy 与 deploy patch 共用。
23
23
  // 不能在 patch 上再声明一遍:commander 遇到父子同名 option 会把值判给父命令,
24
24
  // 子命令拿到空数组,`deploy patch --create x` 会静默失效(deploy-patch-wiring 测试可复现)。
@@ -66,6 +66,9 @@ function registerDeployCommandsModern(program) {
66
66
  sessionID 发起本次发布的页面会话 ID,原样透传不做净化
67
67
  marker 本次发布的变更说明,落发布单 description
68
68
  四字段均可选;非法 JSON / 非对象 / 字段值非字符串会报错。
69
+ versionLevel:本次发布的版本档位。"major" 声明这是一个大版本,历史记录里强制开新组;
70
+ "minor" 声明是小版本,即使距上次发布超过聚合阈值也不提升。不传则由服务端按
71
+ 时间间隔自动判定,与改造前行为一致——只有会主动声明档位的链路需要传。
69
72
 
70
73
  JSON 输出(stdout)
71
74
  {"data": {"appId": "...", "version": <n>, "url": "...", "releaseID": "...", "preReleaseID": "..."}}
@@ -53,7 +53,7 @@ function registerSkillsSync(parent) {
53
53
 
54
54
  JSON 输出
55
55
  {"data": {"stack": "...", "version": "...", "syncedSkills": [...], "techSynced": true|false,
56
- "claudeSkillsLink": "created|updated|noop|conflict" // 仅 --local 时}}
56
+ "claudeSkillsLink": "created|updated|noop|conflict|unsupported" // 仅 --local 时}}
57
57
 
58
58
  传 --type 时:
59
59
  {"data": {"mode": "sandbox", "type": "...", "packageName": "...", "version": "...",
@@ -38,11 +38,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
38
38
  Object.defineProperty(exports, "__esModule", { value: true });
39
39
  exports.UPGRADE_MANIFEST_FILENAME = exports.DEFAULT_EXPORT_OUT = void 0;
40
40
  exports.handleAppExport = handleAppExport;
41
- const node_child_process_1 = require("node:child_process");
42
41
  const node_fs_1 = __importDefault(require("node:fs"));
43
42
  const node_os_1 = __importDefault(require("node:os"));
44
43
  const node_path_1 = __importDefault(require("node:path"));
45
44
  const api = __importStar(require("../../../api/index"));
45
+ const archive_1 = require("../../../utils/archive");
46
46
  const error_1 = require("../../../utils/error");
47
47
  const output_1 = require("../../../utils/output");
48
48
  const logger_1 = require("../../../utils/logger");
@@ -95,11 +95,11 @@ function extractArchive(archivePath, destDir, head) {
95
95
  const isZip = head.length >= 4 && head[0] === 0x50 && head[1] === 0x4b;
96
96
  const isGzip = head.length >= 2 && head[0] === 0x1f && head[1] === 0x8b;
97
97
  if (isZip) {
98
- (0, node_child_process_1.execFileSync)('unzip', ['-q', '-o', archivePath, '-d', destDir], { stdio: 'pipe' });
98
+ (0, archive_1.extractZip)(archivePath, destDir);
99
99
  return;
100
100
  }
101
101
  if (isGzip) {
102
- (0, node_child_process_1.execFileSync)('tar', ['-xzf', archivePath, '-C', destDir], { stdio: 'pipe' });
102
+ (0, archive_1.extractTarGz)(archivePath, destDir);
103
103
  return;
104
104
  }
105
105
  throw new error_1.AppError('EXPORT_ARCHIVE_INVALID', '无法识别归档格式(非 zip / tar.gz)', {
@@ -16,6 +16,7 @@ const error_1 = require("../../../utils/error");
16
16
  const output_1 = require("../../../utils/output");
17
17
  const env_1 = require("../../../utils/env");
18
18
  const logger_1 = require("../../../utils/logger");
19
+ const run_npm_1 = require("../../../utils/run-npm");
19
20
  /**
20
21
  * miaoda app migrate --to <stack> [--from <stack>] [--dir <path>]
21
22
  *
@@ -126,7 +127,7 @@ async function handleAppMigrate(opts) {
126
127
  (0, logger_1.log)('migrate', `Running npm ${installArgs.join(' ')}...`);
127
128
  let installError;
128
129
  try {
129
- (0, node_child_process_1.execFileSync)('npm', installArgs, {
130
+ (0, run_npm_1.execNpmSync)(installArgs, {
130
131
  cwd: targetDir,
131
132
  stdio: (0, output_1.isJsonMode)() ? ['ignore', 'ignore', 'inherit'] : 'inherit',
132
133
  });
@@ -167,6 +168,8 @@ async function handleAppMigrate(opts) {
167
168
  // - install 挂了不做 —— 新依赖不全, 杀旧 dev 后新 dev 起不来反而更糟,
168
169
  // 留着旧进程让用户先处理 installError
169
170
  // - 软失败:pkill 无匹配进程退出 1,catch 吞掉
171
+ // - pkill 是 POSIX-only,但整段被 isSandboxEnv() 包着(沙箱恒为 Linux),
172
+ // Windows 本地永远走不到这里,故不需要跨平台封装
170
173
  let devRestarted = false;
171
174
  if (installError === undefined && (0, env_1.isSandboxEnv)()) {
172
175
  (0, logger_1.log)('migrate', '沙箱环境,重启 dev process(平台 supervisor 会自动拉起)...');
@@ -9,7 +9,6 @@ exports.runStackSync = runStackSync;
9
9
  exports.summarizeSyncResults = summarizeSyncResults;
10
10
  exports.snapshotManagedDepSpecs = snapshotManagedDepSpecs;
11
11
  exports.diffManagedSpecs = diffManagedSpecs;
12
- const node_child_process_1 = require("node:child_process");
13
12
  const node_fs_1 = __importDefault(require("node:fs"));
14
13
  const node_path_1 = __importDefault(require("node:path"));
15
14
  const sync_configs_1 = require("../../../config/sync-configs");
@@ -19,6 +18,7 @@ const githooks_1 = require("../../../utils/githooks");
19
18
  const logs_dir_1 = require("../../../utils/logs-dir");
20
19
  const install_1 = require("../../../services/app/init/install");
21
20
  const spark_meta_1 = require("../../../utils/spark-meta");
21
+ const run_npm_1 = require("../../../utils/run-npm");
22
22
  const error_1 = require("../../../utils/error");
23
23
  const output_1 = require("../../../utils/output");
24
24
  const logger_1 = require("../../../utils/logger");
@@ -127,7 +127,7 @@ async function handleAppSync(opts) {
127
127
  (0, logger_1.log)('sync', `Running npm ${installArgs.join(' ')}...`);
128
128
  let installError;
129
129
  try {
130
- (0, node_child_process_1.execFileSync)('npm', installArgs, {
130
+ (0, run_npm_1.execNpmSync)(installArgs, {
131
131
  cwd: targetDir,
132
132
  stdio: (0, output_1.isJsonMode)() ? ['ignore', 'ignore', 'inherit'] : 'inherit',
133
133
  });
@@ -47,7 +47,7 @@ const colors_1 = require("../../../utils/colors");
47
47
  const fuzzy_match_1 = require("../../../utils/fuzzy-match");
48
48
  const index_1 = require("../../../api/db/index");
49
49
  const sql_keywords_1 = require("../../../api/db/sql-keywords");
50
- const node_child_process_1 = require("node:child_process");
50
+ const run_npm_1 = require("../../../utils/run-npm");
51
51
  const node_fs_1 = require("node:fs");
52
52
  const node_path_1 = __importDefault(require("node:path"));
53
53
  /**
@@ -140,20 +140,22 @@ async function maybeSyncAgentSchema(results) {
140
140
  (0, logger_1.debug)(`[db sql] DDL detected, running \`npm run gen:db-schema\` in ${projectRoot}`);
141
141
  try {
142
142
  await new Promise((resolve) => {
143
- const proc = (0, node_child_process_1.spawn)('npm', ['run', 'gen:db-schema'], {
143
+ const proc = (0, run_npm_1.spawnNpm)(['run', 'gen:db-schema'], {
144
144
  stdio: ['ignore', 'pipe', 'pipe'],
145
145
  cwd: projectRoot,
146
146
  });
147
147
  // --verbose:实时透传到 stderr 看进度;默认完全静默丢弃。
148
148
  // 任何路径下子进程输出都不会进入当前 CLI 的 stdout,--json 模式安全。
149
149
  // 注:默认路径必须 attach 监听器,否则 pipe 缓冲区写满会反压子进程。
150
+ // `?.`:stdio 走数组形式时 node 类型上 stdout/stderr 可为 null。这里 fd1/fd2
151
+ // 显式给了 'pipe',实际恒非 null;真为 null 也意味着不是 pipe、不存在缓冲反压。
150
152
  if (verbose) {
151
- proc.stdout.pipe(process.stderr);
152
- proc.stderr.pipe(process.stderr);
153
+ proc.stdout?.pipe(process.stderr);
154
+ proc.stderr?.pipe(process.stderr);
153
155
  }
154
156
  else {
155
- proc.stdout.on('data', drainChunk);
156
- proc.stderr.on('data', drainChunk);
157
+ proc.stdout?.on('data', drainChunk);
158
+ proc.stderr?.on('data', drainChunk);
157
159
  }
158
160
  let timedOut = false;
159
161
  const timer = setTimeout(() => {
@@ -12,9 +12,9 @@ const error_1 = require("../../../utils/error");
12
12
  const index_1 = require("../../../services/deploy/modern/index");
13
13
  const index_2 = require("../../../services/deploy/modern/patch/index");
14
14
  const logger_1 = require("../../../utils/logger");
15
- const CONF_EXPECTED = '期望形如 {"checkPointVersion":"...","commitID":"...","sessionID":"...","marker":"..."} 的 JSON 对象';
15
+ const CONF_EXPECTED = '期望形如 {"checkPointVersion":"...","commitID":"...","sessionID":"...","marker":"...","versionLevel":"major"} 的 JSON 对象';
16
16
  /**
17
- * 解析 `--conf` JSON string,只取 checkPointVersion / commitID / sessionID / marker 四个白名单字段。
17
+ * 解析 `--conf` JSON string,只取 checkPointVersion / commitID / sessionID / marker / versionLevel 五个白名单字段。
18
18
  * - 未传 → 返回 {}(行为不变)。
19
19
  * - 非法 JSON / 非 object / 字段值非 string → 抛 DEPLOY_CONF_INVALID。
20
20
  * - 空串字段视为未提供(不进 body,保持可选语义);未知 key 忽略。
@@ -34,7 +34,13 @@ function parseDeployConf(raw) {
34
34
  }
35
35
  const source = parsed;
36
36
  const conf = {};
37
- for (const key of ['checkPointVersion', 'commitID', 'sessionID', 'marker']) {
37
+ for (const key of [
38
+ 'checkPointVersion',
39
+ 'commitID',
40
+ 'sessionID',
41
+ 'marker',
42
+ 'versionLevel',
43
+ ]) {
38
44
  const value = source[key];
39
45
  if (value === undefined)
40
46
  continue;
@@ -86,6 +92,7 @@ async function handleDeployModern(opts) {
86
92
  commitID: conf.commitID,
87
93
  sessionID: conf.sessionID,
88
94
  marker: conf.marker,
95
+ versionLevel: conf.versionLevel,
89
96
  changedFiles: parseChangedFiles(opts),
90
97
  });
91
98
  (0, output_1.emit)({
@@ -56,10 +56,11 @@ exports.readAllCapabilities = readAllCapabilities;
56
56
  exports.hydrateCapability = hydrateCapability;
57
57
  const node_fs_1 = __importDefault(require("node:fs"));
58
58
  const node_path_1 = __importDefault(require("node:path"));
59
- const node_child_process_1 = require("node:child_process");
60
59
  const node_module_1 = require("node:module");
60
+ const archive_1 = require("../../../utils/archive");
61
61
  const error_1 = require("../../../utils/error");
62
62
  const logger_1 = require("../../../utils/logger");
63
+ const run_npm_1 = require("../../../utils/run-npm");
63
64
  // ── Project paths ──
64
65
  function getProjectRoot() {
65
66
  return process.cwd();
@@ -152,7 +153,7 @@ function extractTgzToNodeModules(tgzPath, pluginName) {
152
153
  }
153
154
  node_fs_1.default.mkdirSync(tempDir, { recursive: true });
154
155
  try {
155
- (0, node_child_process_1.execSync)(`tar -xzf "${tgzPath}" -C "${tempDir}"`, { stdio: 'pipe' });
156
+ (0, archive_1.extractTarGz)(tgzPath, tempDir);
156
157
  const extractedDir = node_path_1.default.join(tempDir, 'package');
157
158
  if (node_fs_1.default.existsSync(extractedDir)) {
158
159
  node_fs_1.default.renameSync(extractedDir, targetDir);
@@ -191,7 +192,7 @@ function installMissingDeps(deps) {
191
192
  if (deps.length === 0)
192
193
  return;
193
194
  (0, logger_1.log)('plugin', `Installing missing dependencies: ${deps.join(', ')}`);
194
- const result = (0, node_child_process_1.spawnSync)('npm', ['install', ...deps, '--no-save', '--no-package-lock'], {
195
+ const result = (0, run_npm_1.runNpmSync)(['install', ...deps, '--no-save', '--no-package-lock'], {
195
196
  cwd: getProjectRoot(),
196
197
  stdio: 'inherit',
197
198
  });
@@ -205,7 +206,7 @@ function installMissingDeps(deps) {
205
206
  }
206
207
  }
207
208
  function npmInstall(tgzPath) {
208
- const result = (0, node_child_process_1.spawnSync)('npm', ['install', tgzPath, '--no-save', '--no-package-lock', '--ignore-scripts'], { cwd: getProjectRoot(), stdio: 'inherit' });
209
+ const result = (0, run_npm_1.runNpmSync)(['install', tgzPath, '--no-save', '--no-package-lock', '--ignore-scripts'], { cwd: getProjectRoot(), stdio: 'inherit' });
209
210
  if (result.error) {
210
211
  throw new error_1.AppError('INTERNAL_NPM_FAILED', `npm install failed: ${result.error.message}`, {
211
212
  next_actions: ['确认本机已安装 npm,可 --verbose 查看执行详情'],
@@ -14,7 +14,8 @@
14
14
  * + client/index.html 等 fullstack 形态新增的资产)
15
15
  * 5. 把 fullstack 必需的 scripts 加到 package.json(dev / build / type:check 等)
16
16
  * 6. 从 fullstack template/package.json 取版本号,精确加 NestJS 强依赖白名单
17
- * (client-toolkit + 几个 @nestjs/* + fullstack-nestjs-core + hbs 等;不全量 merge)
17
+ * (client-toolkit + 几个 @nestjs/* + SWC 工具链 + fullstack-nestjs-core + hbs 等;
18
+ * 不全量 merge)
18
19
  * 7. codemod 业务代码:@lark-apaas/client-toolkit-lite → @lark-apaas/client-toolkit
19
20
  * 8. codemod vite.config:defineConfig(...) → defineConfig(..., { fullstack: true }),
20
21
  * 让 coding-preset-vite-react 启用 fullstack dev-proxy / html-output / basename /
@@ -58,7 +59,9 @@ exports.MIGRATE_CONFIG = {
58
59
  // ===== 4. fullstack 形态必需资产(覆盖 user 已有同名文件) =====
59
60
  // server/ 整目录:main.ts / app.module.ts / common/ / modules/view/ 等(fullstack 必需)
60
61
  { type: 'directory', from: 'server', to: 'server', overwrite: true },
61
- // nest-cli.json:nest build 入口
62
+ // nest-cli.json:整文件采用当前 fullstack template,除 Nest build 入口外还必须带上
63
+ // compilerOptions.builder.type=swc 及配套 typeCheck/options。若这里只保留旧的空配置
64
+ // 或字段级残缺合并,即使 package.json 已补齐 SWC 依赖,Nest 仍会回退到 TSC 构建。
62
65
  { type: 'file', from: 'nest-cli.json', to: 'nest-cli.json', overwrite: true },
63
66
  // tsconfig.* —— vite-react 时代 tsconfig 配 include: ["src"],迁完代码搬到 client/src,
64
67
  // include 路径不对 + 老 tsconfig.app 还 extends @lark-apaas/coding-presets-react;
@@ -67,6 +70,7 @@ exports.MIGRATE_CONFIG = {
67
70
  { type: 'file', from: 'tsconfig.json', to: 'tsconfig.json', overwrite: true },
68
71
  { type: 'file', from: 'tsconfig.app.json', to: 'tsconfig.app.json', overwrite: true },
69
72
  { type: 'file', from: 'tsconfig.node.json', to: 'tsconfig.node.json', overwrite: true },
73
+ { type: 'file', from: 'tsconfig.mcp-ui.json', to: 'tsconfig.mcp-ui.json', overwrite: false },
70
74
  // ESLint 9 flat config —— vite-react 用 eslint.config.mjs 已删,fullstack 用
71
75
  // eslint.config.js (commonjs) + extends @lark-apaas/fullstack-presets;user 通常不改
72
76
  { type: 'file', from: 'eslint.config.js', to: 'eslint.config.js', overwrite: true },
@@ -155,10 +159,16 @@ exports.MIGRATE_CONFIG = {
155
159
  command: 'tsc --noEmit --project tsconfig.app.json',
156
160
  overwrite: true,
157
161
  },
162
+ {
163
+ type: 'add-script',
164
+ name: 'type:check:mcp-ui',
165
+ command: 'node ./scripts/typecheck-mcp-ui.js',
166
+ overwrite: true,
167
+ },
158
168
  {
159
169
  type: 'add-script',
160
170
  name: 'type:check',
161
- command: 'concurrently -n "server,client" -c "blue,green" "npm run type:check:server" "npm run type:check:client"',
171
+ 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"',
162
172
  overwrite: true,
163
173
  },
164
174
  // ----- 平台脚本调用链 -----
@@ -272,6 +282,14 @@ exports.MIGRATE_CONFIG = {
272
282
  // nest start / nest build 必需
273
283
  '@nestjs/cli',
274
284
  '@nestjs/testing',
285
+ // nest-cli.json 会被上面的 file rule 覆盖成 builder.type=swc。Nest CLI 只负责
286
+ // 调度 builder,不会自带 SWC 可执行入口和 native compiler;两者必须一起从
287
+ // 当前目标模板取版本写入迁移后 package.json。若漏掉,前端应用升级成全栈后
288
+ // 配置已经选择 SWC,但全新的依赖安装树里找不到 @swc/cli/@swc/core,冷启动和
289
+ // nest build 会失败;开发机旧 node_modules 偶然残留 SWC 时还可能掩盖该问题。
290
+ // 这里不硬编码版本,保持升级应用与同版本新建全栈应用使用完全相同的 SWC 组合。
291
+ '@swc/cli',
292
+ '@swc/core',
275
293
  // server ts 编译
276
294
  'ts-node',
277
295
  '@types/express',
@@ -159,6 +159,46 @@ exports.SYNC_CONFIG = {
159
159
  to: `npx -y ${fullstack_cli_pin_1.FULLSTACK_CLI_PIN_SPEC} sync --disable-gen-openapi`,
160
160
  ifStartsWith: 'npx -y @lark-apaas/fullstack-cli sync',
161
161
  },
162
+ // MCP UI 使用独立浏览器配置;仅迁移已知模板命令,不生成 UI 目录;根配置仅在缺失时补齐。
163
+ {
164
+ type: 'typescript-exclude',
165
+ to: 'tsconfig.node.json',
166
+ path: 'server/mcp/ui',
167
+ },
168
+ { type: 'file', from: 'tsconfig.mcp-ui.json', to: 'tsconfig.mcp-ui.json', overwrite: false },
169
+ {
170
+ type: 'add-script',
171
+ name: 'type:check:mcp-ui',
172
+ command: 'node ./scripts/typecheck-mcp-ui.js',
173
+ overwrite: false,
174
+ },
175
+ {
176
+ type: 'patch-script',
177
+ name: 'type:check:mcp-ui',
178
+ to: 'node ./scripts/typecheck-mcp-ui.js',
179
+ ifEquals: [
180
+ 'node ./scripts/check.cjs --typecheck-mcp-ui',
181
+ 'node ./scripts/lint.js --typecheck-mcp-ui',
182
+ ],
183
+ },
184
+ {
185
+ type: 'patch-script',
186
+ name: 'type:check',
187
+ 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"',
188
+ ifEquals: [
189
+ 'node ./scripts/check.cjs --typecheck',
190
+ 'node ./scripts/lint.js --typecheck',
191
+ 'concurrently -n "server,client" -c "blue,green" "npm run type:check:server" "npm run type:check:client"',
192
+ 'concurrently "npm run type:check:server" "npm run type:check:client"',
193
+ 'concurrently "npm run type:check:client" "npm run type:check:server"',
194
+ ],
195
+ },
196
+ {
197
+ type: 'patch-script',
198
+ name: 'eslint',
199
+ to: 'eslint . --quiet',
200
+ ifEquals: ['eslint . --quiet --ignore-pattern "server/mcp/ui/**"'],
201
+ },
162
202
  // ===== miaoda-cli 本地开发新增规则(fullstack-cli sync 不会执行) =====
163
203
  // M1. scripts.dev:local —— 本地用户绕过沙箱判定直接跑本地链路(npm run dev:local)。
164
204
  // dev.sh 在 MIAODA_DEP_CACHE_DIR 非空时跑 dev.js(沙箱保活)、否则 exec dev-local.js;显式 dev:local
@@ -11,13 +11,24 @@ const node_fs_1 = __importDefault(require("node:fs"));
11
11
  const node_path_1 = __importDefault(require("node:path"));
12
12
  const env_1 = require("../../../utils/env");
13
13
  const install_1 = require("./install");
14
- /** event marker 目录,写死;写前 mkdir -p。沙箱里 code server 轮询此目录。 */
14
+ /**
15
+ * event marker 目录,写死 `/tmp/event`;写前 mkdir -p。沙箱里 code server 轮询此目录,
16
+ * 路径是与平台约定的契约,**不能换成 os.tmpdir()**。所有读写它的代码路径都被
17
+ * isSandboxEnv() 守着(沙箱恒为 Linux),非沙箱环境不会碰。
18
+ */
15
19
  const EVENT_DIR = '/tmp/event';
16
20
  /** 安装成功 marker 名 */
17
21
  const MARKER_READY = 'WORKSPACE_READY';
18
22
  /** 安装失败 marker 名 */
19
23
  const MARKER_FAILED = 'WORKSPACE_FAILED';
20
- /** 后台 worker stdout/stderr 落盘路径 */
24
+ /**
25
+ * 后台 worker stdout/stderr 落盘路径,写死 `/tmp/...`。
26
+ *
27
+ * 刻意**不**换成 `os.tmpdir()`:这个路径已经是对外契约 —— 写在 async-install 设计
28
+ * spec 里、`app init` 的 help 文案里、失败 marker 的 `logPath` 字段里,用户与平台
29
+ * 都按它 cat 日志。Windows 上 Node 会把 `/tmp` 解析到当前盘符根下的 `\tmp\`,
30
+ * 目录可写、内容可读,功能不受影响,不值得为此破坏契约。
31
+ */
21
32
  exports.ASYNC_INSTALL_LOG = '/tmp/async_install_dep.std.log';
22
33
  function nowIso() {
23
34
  return new Date().toISOString();
@@ -5,12 +5,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
5
5
  Object.defineProperty(exports, "__esModule", { value: true });
6
6
  exports.installDependencies = installDependencies;
7
7
  exports.resolveNpmInstallRegistry = resolveNpmInstallRegistry;
8
- const node_child_process_1 = require("node:child_process");
9
8
  const node_crypto_1 = __importDefault(require("node:crypto"));
10
9
  const node_fs_1 = __importDefault(require("node:fs"));
11
10
  const node_path_1 = __importDefault(require("node:path"));
11
+ const archive_1 = require("../../../utils/archive");
12
12
  const error_1 = require("../../../utils/error");
13
13
  const logger_1 = require("../../../utils/logger");
14
+ const run_npm_1 = require("../../../utils/run-npm");
14
15
  const DEP_CACHE_ENV = 'MIAODA_DEP_CACHE_DIR';
15
16
  /**
16
17
  * 依赖安装。
@@ -94,7 +95,7 @@ function md5File(filePath) {
94
95
  }
95
96
  function extractZip(zipPath, targetDir, stdio) {
96
97
  try {
97
- (0, node_child_process_1.execFileSync)('unzip', ['-q', '-o', zipPath, '-d', targetDir], { stdio });
98
+ (0, archive_1.extractZip)(zipPath, targetDir, { stdio });
98
99
  }
99
100
  catch (err) {
100
101
  const msg = err instanceof Error ? err.message : String(err);
@@ -129,5 +130,5 @@ function runNpmInstall(targetDir, stdio, extraPackages) {
129
130
  args.push(...extraPackages);
130
131
  }
131
132
  (0, logger_1.log)('init', `npm ${args.join(' ')} in ${targetDir}...`);
132
- (0, node_child_process_1.execFileSync)('npm', args, { cwd: targetDir, stdio });
133
+ (0, run_npm_1.execNpmSync)(args, { cwd: targetDir, stdio });
133
134
  }
@@ -1,9 +1,9 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.runBuild = runBuild;
4
- const node_child_process_1 = require("node:child_process");
5
4
  const error_1 = require("../../../../utils/error");
6
5
  const logger_1 = require("../../../../utils/logger");
6
+ const run_npm_1 = require("../../../../utils/run-npm");
7
7
  const protocol_1 = require("../protocol");
8
8
  /**
9
9
  * 给 RESOURCE_CDN_PREFIX 补 https:// 协议头:
@@ -33,7 +33,7 @@ function ensureHttpsScheme(v) {
33
33
  * 是 runtime 同域相对路径(例如 /app/<appId>/runtime/api/v1/storage/object/<bucket>/),
34
34
  * 不补 https scheme,原样注入。顶层 static_cdn_prefix 不再下发。
35
35
  *
36
- * build 失败抛 AppError(execSync 自身会 throw,捕获后包一层加错误码)。
36
+ * build 失败抛 AppError(execNpmSync 自身会 throw,捕获后包一层加错误码)。
37
37
  */
38
38
  function runBuild(opts) {
39
39
  const staticCred = (0, protocol_1.parsePaasStorageCredential)((0, protocol_1.requireDataKey)(opts.data, protocol_1.DataKey.OUTPUT_STATIC_PAAS_STORAGE_CREDENTIAL), protocol_1.DataKey.OUTPUT_STATIC_PAAS_STORAGE_CREDENTIAL);
@@ -47,7 +47,7 @@ function runBuild(opts) {
47
47
  };
48
48
  (0, logger_1.log)('deploy', 'Building...');
49
49
  try {
50
- (0, node_child_process_1.execSync)('npm run build', {
50
+ (0, run_npm_1.execNpmSync)(['run', 'build'], {
51
51
  cwd: opts.projectDir,
52
52
  stdio: 'inherit',
53
53
  env: buildEnv,
@@ -18,6 +18,7 @@ async function createLocalRelease(appId, version, extra) {
18
18
  commitID: extra?.commitID,
19
19
  sessionID: extra?.sessionID,
20
20
  description: extra?.marker,
21
+ versionLevel: extra?.versionLevel,
21
22
  });
22
23
  }
23
24
  /**
@@ -18,15 +18,13 @@ const node_path_1 = __importDefault(require("node:path"));
18
18
  const node_child_process_1 = require("node:child_process");
19
19
  const error_1 = require("../../../../utils/error");
20
20
  const logger_1 = require("../../../../utils/logger");
21
+ const which_1 = require("../../../../utils/which");
21
22
  function resolveTosutilPath() {
22
- try {
23
- const resolved = (0, node_child_process_1.execFileSync)('which', ['tosutil'], { encoding: 'utf-8' }).trim();
24
- if (resolved)
25
- return resolved;
26
- }
27
- catch {
28
- /* fallthrough */
29
- }
23
+ // 用 whichSync 而不是 shell out `which`:Windows 上没有 `which`(对应 `where`),
24
+ // 且查 PATH 本身不需要子进程。
25
+ const resolved = (0, which_1.whichSync)('tosutil');
26
+ if (resolved !== undefined)
27
+ return resolved;
30
28
  throw new error_1.AppError('DEPLOY_TOSUTIL_MISSING', 'tosutil is not installed or not in PATH. modern deploy requires sandbox preinstalled tosutil.');
31
29
  }
32
30
  function tosutilUploadFromTos(cred) {
@@ -33,6 +33,7 @@ async function designLocalPublishPipeline(opts) {
33
33
  commitID: opts.commitID,
34
34
  sessionID: opts.sessionID,
35
35
  marker: opts.marker,
36
+ versionLevel: opts.versionLevel,
36
37
  },
37
38
  });
38
39
  try {
@@ -50,6 +50,7 @@ async function localBuildLocalPublishPipeline(opts) {
50
50
  commitID: opts.commitID,
51
51
  sessionID: opts.sessionID,
52
52
  marker: opts.marker,
53
+ versionLevel: opts.versionLevel,
53
54
  },
54
55
  });
55
56
  try {
@@ -0,0 +1,103 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.resetArchiveProbeCache = resetArchiveProbeCache;
4
+ exports.extractTarGz = extractTarGz;
5
+ exports.extractZip = extractZip;
6
+ const node_child_process_1 = require("node:child_process");
7
+ const error_1 = require("../utils/error");
8
+ const logger_1 = require("../utils/logger");
9
+ const which_1 = require("../utils/which");
10
+ /**
11
+ * 归档解压的跨平台入口 —— 仓库内所有解压必须走这里,禁止再裸写
12
+ * `execFileSync('unzip', ...)` / `execSync('tar -xzf ...')`。
13
+ *
14
+ * 平台差异:
15
+ * - `tar`:Linux(GNU tar)、macOS(bsdtar)、Windows 10 1803+(内置 bsdtar)都有,
16
+ * 且都支持 `-xzf` 解 .tar.gz,所以 tar.gz 一条路走到底。
17
+ * - `unzip`:Linux / macOS 常见,**Windows 完全没有**。但 bsdtar 能解 zip,
18
+ * 所以 zip 走 `unzip → tar` 两级探测:Linux 命中 unzip,Windows 命中 tar。
19
+ * (GNU tar 不支持 zip,所以顺序不能反 —— Linux 上必须优先 unzip。)
20
+ *
21
+ * 一律用 execFileSync 传参数数组、不过 shell:路径含空格 / 中文 / `&` 时,
22
+ * 拼字符串交给 cmd.exe 或 sh 重新分词的行为在各平台不一致,且是注入面。
23
+ *
24
+ * ─────────────────────────────────────────────────────────────────────────────
25
+ * 为什么**不**换成纯 JS 解压库(adm-zip / yauzl / node-tar)—— 别再尝试了:
26
+ *
27
+ * `extractZip` 的主要用途是解依赖缓存 zip(`MIAODA_DEP_CACHE_DIR`),内容是整个
28
+ * `node_modules/`。实测对比同一个 zip:
29
+ *
30
+ * | | Unix mode | 软链 |
31
+ * | unzip | 755 保留 | 保留 |
32
+ * | adm-zip | 666(执行位丢) | 被当普通文件解开 |
33
+ *
34
+ * `node_modules/.bin/*` 既需要执行位、又大量是软链 —— 用 adm-zip 解出来的缓存,
35
+ * 沙箱里 `npm run dev` 会直接挂。yauzl 更低层,mode 得自己从
36
+ * `externalFileAttributes` 还原、软链也要自己判,等于把 unzip 重写一遍。
37
+ *
38
+ * node-tar 倒是保权限 + 软链(npm 自己用它装包),但装出来 2.9MB、连传递依赖
39
+ * +3.7MB —— 而本仓生产依赖总共才 1.7MB,翻 3 倍多。CLI 是 `npx -y` 拉起的
40
+ * (模板 `scripts/dev.sh` 每次本地启动都会跑 `app sync`),冷启动下载量直接可感。
41
+ * 外部 tar 在 Linux / macOS / Windows 10 1803+ 都有,不值得为此付这个代价。
42
+ * ─────────────────────────────────────────────────────────────────────────────
43
+ */
44
+ /** tar 可用性探测结果缓存(单次 CLI 执行期内 PATH 不变) */
45
+ let tarAvailable;
46
+ let unzipAvailable;
47
+ function hasTar() {
48
+ tarAvailable ??= (0, which_1.whichSync)('tar') !== undefined;
49
+ return tarAvailable;
50
+ }
51
+ function hasUnzip() {
52
+ unzipAvailable ??= (0, which_1.whichSync)('unzip') !== undefined;
53
+ return unzipAvailable;
54
+ }
55
+ /** 仅测试用:清掉可用性探测缓存 */
56
+ function resetArchiveProbeCache() {
57
+ tarAvailable = undefined;
58
+ unzipAvailable = undefined;
59
+ }
60
+ /**
61
+ * 解 .tar.gz / .tgz 到 `destDir`(须已存在)。失败抛 `INTERNAL_EXTRACT_FAILED`。
62
+ */
63
+ function extractTarGz(archivePath, destDir, options = {}) {
64
+ if (!hasTar()) {
65
+ throw new error_1.AppError('INTERNAL_EXTRACT_FAILED', `解压 ${archivePath} 需要 tar,但当前环境 PATH 中找不到`, {
66
+ next_actions: [
67
+ 'Linux/macOS:安装 tar(通常已内置)',
68
+ 'Windows:升级到 Windows 10 1803+(内置 tar),或安装 Git for Windows 并把其 usr/bin 加入 PATH',
69
+ ],
70
+ });
71
+ }
72
+ (0, logger_1.debug)(`archive: tar -xzf ${archivePath} -C ${destDir}`);
73
+ (0, node_child_process_1.execFileSync)('tar', ['-xzf', archivePath, '-C', destDir], {
74
+ stdio: ['ignore', 'pipe', 'pipe'],
75
+ ...options,
76
+ });
77
+ }
78
+ /**
79
+ * 解 .zip 到 `destDir`(须已存在),同名文件覆盖。失败抛 `INTERNAL_EXTRACT_FAILED`。
80
+ *
81
+ * unzip 优先(Linux 上唯一可用项),退化到 bsdtar(Windows 上唯一可用项)。
82
+ */
83
+ function extractZip(archivePath, destDir, options = {}) {
84
+ const stdio = ['ignore', 'pipe', 'pipe'];
85
+ if (hasUnzip()) {
86
+ (0, logger_1.debug)(`archive: unzip -q -o ${archivePath} -d ${destDir}`);
87
+ (0, node_child_process_1.execFileSync)('unzip', ['-q', '-o', archivePath, '-d', destDir], { stdio, ...options });
88
+ return;
89
+ }
90
+ if (hasTar()) {
91
+ // bsdtar 按后缀自动识别 zip,故用 -xf 而非 -xzf(zip 不是 gzip 流)。
92
+ // 覆盖行为与 `unzip -o` 一致:tar 默认覆盖已存在文件。
93
+ (0, logger_1.debug)(`archive: tar -xf ${archivePath} -C ${destDir}(unzip 不可用,走 bsdtar)`);
94
+ (0, node_child_process_1.execFileSync)('tar', ['-xf', archivePath, '-C', destDir], { stdio, ...options });
95
+ return;
96
+ }
97
+ throw new error_1.AppError('INTERNAL_EXTRACT_FAILED', `解压 ${archivePath} 需要 unzip 或 tar,但当前环境 PATH 中两者都找不到`, {
98
+ next_actions: [
99
+ 'Linux:apt-get install unzip / yum install unzip',
100
+ 'Windows:升级到 Windows 10 1803+(内置 tar 可解 zip)',
101
+ ],
102
+ });
103
+ }