@lark-apaas/miaoda-cli 0.1.16 → 0.1.17-alpha.ddef3e9

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

@@ -0,0 +1,298 @@
+"use strict";
+/**
+ * vite-react → nestjs-react-fullstack 的跨 stack 迁移规则。
+ *
+ * 设计原则：**最小改动**。只动 fullstack 形态必须的文件 / package.json key，user 已有
+ * 的 vite.config / tsconfig / eslint / prettier / tailwind / postcss / components.json
+ * 等业务配置一律**保留**，不被 template 整体覆盖。
+ *
+ * 步骤：
+ *   1. src/ public/ 搬到 client/ 下（fullstack 布局）
+ *   2. 清掉 vite-react 时代的根 index.html / eslint.config.mjs / package-lock.json
+ *   3. 删 user package.json 里 lite SDK 相关 key（保留 coding-preset-vite-react）
+ *   4. 把 NestJS server runtime 拷进来（server/ + nest-cli.json + tsconfig.node.json
+ *      + client/index.html 等 fullstack 形态新增的资产）
+ *   5. 把 fullstack 必需的 scripts 加到 package.json（dev / build / type:check 等）
+ *   6. 从 fullstack template/package.json 取版本号，精确加 NestJS 强依赖白名单
+ *      （client-toolkit + 几个 @nestjs/* + fullstack-nestjs-core + hbs 等；不全量 merge）
+ *   7. codemod 业务代码：@lark-apaas/client-toolkit-lite → @lark-apaas/client-toolkit
+ *   8. codemod vite.config：defineConfig(...) → defineConfig(..., { fullstack: true })，
+ *      让 coding-preset-vite-react 启用 fullstack dev-proxy / html-output / basename /
+ *      server-log 4 件套，vite 8080 反代 HTML / API 到 nest 3000
+ *   9. set-stack 切 .spark/meta.json
+ *
+ * 跟 SDK 的协作：client-toolkit@1.2.52+ 顶层 single-entry 完整 re-export 了
+ * client-toolkit-lite 全部 48 项 API（fullstack-plugin#1124），所以 codemod 只换
+ * 包名、specifier 列表不动就够。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MIGRATE_CONFIG = void 0;
+exports.MIGRATE_CONFIG = {
+    from: 'vite-react',
+    to: 'nestjs-react-fullstack',
+    rules: [
+        // ===== 1. 用户领地搬迁 =====
+        { type: 'move-directory', from: 'src', to: 'client/src' },
+        { type: 'move-directory', from: 'public', to: 'client/public' },
+        // shared/ 不动（两边布局相同）；.env / .spark_project 同理。
+        // ===== 2. 清理 vite-react 残留 =====
+        // 根 index.html 被 client/index.html 取代（fullstack 用 HBS 渲染）
+        { type: 'delete-file', to: 'index.html' },
+        // ESLint 9 flat config 文件名变了（user eslint.config.mjs → eslint.config.js）
+        { type: 'delete-file', to: 'eslint.config.mjs' },
+        // 依赖集合变了，lockfile 重新生成
+        { type: 'delete-file', to: 'package-lock.json' },
+        // ===== 3. 从 user package.json 删 vite-react 专属字段 =====
+        // 注意保留 devDependencies.@lark-apaas/coding-preset-vite-react —— user 迁移后
+        // vite.config 仍用它（开 fullstack 模式即可），不切到 fullstack-vite-preset。
+        {
+            type: 'delete-json-keys',
+            to: 'package.json',
+            keys: [
+                // 顶层 "type": "module" —— vite-react ESM 入口约定，nestjs CommonJS 不需要
+                'type',
+                // lite SDK：codemod 后 import 走 client-toolkit 顶层
+                'dependencies.@lark-apaas/client-toolkit-lite',
+            ],
+        },
+        // ===== 4. fullstack 形态必需资产（覆盖 user 已有同名文件） =====
+        // server/ 整目录：main.ts / app.module.ts / common/ / modules/view/ 等（fullstack 必需）
+        { type: 'directory', from: 'server', to: 'server', overwrite: true },
+        // nest-cli.json：nest build 入口
+        { type: 'file', from: 'nest-cli.json', to: 'nest-cli.json', overwrite: true },
+        // tsconfig.* —— vite-react 时代 tsconfig 配 include: ["src"]，迁完代码搬到 client/src，
+        // include 路径不对 + 老 tsconfig.app 还 extends @lark-apaas/coding-presets-react；
+        // 整体覆盖到 fullstack 版本（include 改 client/** + shared/**、extends fullstack-presets）。
+        // user 自己加的 paths / strict 等设置如有需要，按 git diff 手动加回。
+        { 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 },
+        // 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 },
+        // client/index.html：HBS 模板（fullstack 用，vite-react 用根 index.html 已删）
+        { type: 'file', from: 'client/index.html', to: 'client/index.html', overwrite: true },
+        // scripts/ 整目录：fullstack 形态启动 / 构建 / lint 所需的 8 个平台脚本（dev.sh /
+        // dev.js / dev-local.js / build.sh / lint.js / prune-smart.js / run.sh / hooks/）。
+        // dev.sh exec node dev.js，dev.js 才是并发起 nest + vite 的核心 —— 漏一个 dev 跑不起来。
+        // overwrite: true：这些脚本由平台 cli 维护，user 一般不改；按 fullstack 版本覆盖。
+        { type: 'directory', from: 'scripts', to: 'scripts', overwrite: true },
+        // .githooks（fallback，user 已有则保留）
+        { type: 'directory', from: '.githooks', to: '.githooks', overwrite: false },
+        // shared/ fallback（user 已有同名文件保留，template 新增文件加入）
+        { type: 'directory', from: 'shared', to: 'shared', overwrite: false },
+        // .env fallback（user 没有时用 template 默认）
+        { type: 'file', from: '.env', to: '.env', overwrite: false },
+        // ===== 4.5. plugin 实例从 shared/capabilities 搬到 server/capabilities =====
+        // vite-react (jsPage) 时期 plugin 实例 json 放在 shared/capabilities/<id>.json，
+        // fullstack 形态走 server 侧装载,路径约定改成 server/capabilities/<id>.json。
+        // 顺序约束:必须在 server/ 覆盖之后 —— server/ 是 overwrite:true,放前面会被擦掉。
+        { type: 'move-directory', from: 'shared/capabilities', to: 'server/capabilities' },
+        // ===== 5. 加 fullstack 形态必需的 scripts =====
+        // 这些 scripts 用 user 现有的可能性低（vite-react 没有 nest 相关 script），直接覆盖
+        {
+            type: 'add-script',
+            name: 'dev',
+            command: './scripts/dev.sh',
+            overwrite: true,
+        },
+        {
+            type: 'add-script',
+            name: 'dev:server',
+            command: 'NODE_ENV=development nest start --watch',
+            overwrite: true,
+        },
+        {
+            type: 'add-script',
+            name: 'dev:client',
+            command: 'NODE_ENV=development vite --config vite.config.ts',
+            overwrite: true,
+        },
+        {
+            type: 'add-script',
+            name: 'build',
+            command: './scripts/build.sh',
+            overwrite: true,
+        },
+        {
+            type: 'add-script',
+            name: 'build:server',
+            command: 'NODE_ENV=production nest build',
+            overwrite: true,
+        },
+        {
+            type: 'add-script',
+            name: 'build:client',
+            command: 'NODE_ENV=production vite build --config vite.config.ts',
+            overwrite: true,
+        },
+        {
+            type: 'add-script',
+            name: 'build:prod',
+            command: 'npm run build:server && npm run build:client',
+            overwrite: true,
+        },
+        {
+            type: 'add-script',
+            name: 'start',
+            command: 'NODE_ENV=production node main.js',
+            overwrite: true,
+        },
+        {
+            type: 'add-script',
+            name: 'type:check:server',
+            command: 'tsc --noEmit --project tsconfig.node.json',
+            overwrite: true,
+        },
+        {
+            type: 'add-script',
+            name: 'type:check:client',
+            command: 'tsc --noEmit --project tsconfig.app.json',
+            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"',
+            overwrite: true,
+        },
+        // ----- 平台脚本调用链 -----
+        // build.sh 步骤 1 跑 `npm run gen:openapi`,缺这条 npm ERR missing script,build 直接挂。
+        // scripts/lint.js 内部 spawn `npm run eslint` 和 `npm run stylelint`,缺这两条 lint 挂。
+        // 这些都是 fullstack 平台脚本自洽必需的桥接 script,user 不会自定义,直接覆盖。
+        {
+            type: 'add-script',
+            name: 'gen:openapi',
+            command: "echo 'UNSUPPORTED, SKIP'",
+            overwrite: true,
+        },
+        {
+            type: 'add-script',
+            name: 'gen:db-schema',
+            command: 'npx -y @lark-apaas/db-schema-sync@latest --output server/database/schema.ts --export-custom-types',
+            overwrite: true,
+        },
+        {
+            type: 'add-script',
+            name: 'eslint',
+            command: 'eslint . --quiet',
+            overwrite: true,
+        },
+        {
+            type: 'add-script',
+            name: 'stylelint',
+            command: 'stylelint client/src/**/*.css --quiet',
+            overwrite: true,
+        },
+        {
+            type: 'add-script',
+            name: 'lint',
+            command: 'node ./scripts/lint.js',
+            overwrite: true,
+        },
+        {
+            type: 'add-script',
+            name: 'precommit',
+            command: 'node scripts/hooks/run-precommit.js',
+            overwrite: true,
+        },
+        {
+            type: 'add-script',
+            name: 'upgrade',
+            command: 'npx -y @lark-apaas/fullstack-cli sync --disable-gen-openapi',
+            overwrite: true,
+        },
+        // ----- user 可能自定义的 scripts -----
+        // format/test 多半 user 自己改过(prettier 配 / jest 配),保留 user 自有值。
+        {
+            type: 'add-script',
+            name: 'format',
+            command: 'prettier --write "{server,client,test}/**/*.{js,ts,tsx,json,md}"',
+            overwrite: false,
+        },
+        {
+            type: 'add-script',
+            name: 'test',
+            command: 'jest',
+            overwrite: false,
+        },
+        {
+            type: 'add-script',
+            name: 'test:watch',
+            command: 'jest --watch',
+            overwrite: false,
+        },
+        {
+            type: 'add-script',
+            name: 'test:e2e',
+            command: 'jest --config test/e2e/jest.config.js',
+            overwrite: false,
+        },
+        // ===== 6. 从 fullstack template 取版本号加 NestJS 强依赖（精确白名单） =====
+        // 不走 merge-json（template 130+ devDeps 全 merge 会污染 user 业务依赖集合）；
+        // 白名单只列 fullstack 启动能跑起来必需的最小集。
+        {
+            type: 'add-deps-from-template',
+            from: 'package.json',
+            to: 'package.json',
+            dependencies: [
+                // NestJS server 核心
+                '@nestjs/core',
+                '@nestjs/common',
+                '@nestjs/platform-express',
+                '@nestjs/config',
+                '@nestjs/axios',
+                '@nestjs/swagger',
+                // 妙搭 fullstack server SDK（main.ts / view module 等都依赖）
+                '@lark-apaas/fullstack-nestjs-core',
+                // HBS 模板引擎（client/index.html 渲染）
+                'hbs',
+                // NestJS runtime 必需
+                'reflect-metadata',
+                'rxjs',
+                'tslib',
+                // DTO 校验 / 转换
+                'class-transformer',
+                'class-validator',
+                // .env 加载（scripts/dev.sh 用到 dotenv-cli 风格）
+                'dotenv',
+                // client-toolkit：替代 lite，业务代码 codemod 后走它
+                '@lark-apaas/client-toolkit',
+            ],
+            devDependencies: [
+                // nest start / nest build 必需
+                '@nestjs/cli',
+                '@nestjs/testing',
+                // server ts 编译
+                'ts-node',
+                '@types/express',
+                '@types/hbs',
+                '@types/node',
+                // 并发跑 nest + vite（scripts/dev.sh 用 concurrently）
+                'concurrently',
+                // fullstack server 端 tsconfig.node.json 通过 extends 引这个包
+                // （@lark-apaas/fullstack-presets/lib/simple/tsconfig/tsconfig.node.json）;
+                // 不装会导致 nest build / type:check:server / vite dev 解析 tsconfig 时 ENOENT
+                '@lark-apaas/fullstack-presets',
+            ],
+        },
+        // ===== 7. 业务代码 codemod：lite → client-toolkit 包名替换 =====
+        // client-toolkit@1.2.52+ 顶层完整 re-export lite 全部 48 项，specifier 列表不动。
+        // 同时扫 shared/（client/server 共享代码也可能引 lite 类型 / utils）。
+        { type: 'codemod-client-toolkit-lite', root: 'client/src' },
+        { type: 'codemod-client-toolkit-lite', root: 'shared' },
+        // ===== 8. vite.config codemod：加 { fullstack: true } 第二参 =====
+        // user vite.config 现在是 defineConfig({...}) 单参；fullstack 形态需要 vite 8080
+        // 反代 HTML / API 到 nest 3000，coding-preset-vite-react 用 fullstack option 启用
+        // 这一行为（详见 fullstack-plugin coding-preset-vite-react#fullstack）。
+        { type: 'codemod-vite-config-fullstack', to: 'vite.config.ts' },
+        // ===== 9. 切 stack =====
+        { type: 'set-stack', stack: 'nestjs-react-fullstack' },
+    ],
+    // install 收尾要钉 latest 的关键平台包 —— 见 MigrateConfig.followLatestPackages 注释。
+    //   - client-toolkit：codemod 后业务代码依赖 lite 兼容 API（getCurrentUserProfile 等），
+    //     这些 API 当前只在 alpha 版本里。template caret range 不匹配 pre-release，必须显式 latest。
+    //   - coding-preset-vite-react：本次切到 MIAODA_APP_TYPE='3' env 检测，老版本 preset 不认 env。
+    followLatestPackages: ['@lark-apaas/client-toolkit', '@lark-apaas/coding-preset-vite-react'],
+};
+exports.default = exports.MIGRATE_CONFIG;

package/dist/config/migrate.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * MigrateRule 类型定义 —— miaoda app migrate（跨 stack 迁移）的核心抽象。
+ *
+ * 跟 sync 的关系：sync 是**同 stack 内**的版本同步（脚手架更新、平台依赖钉版本）；
+ * migrate 是**跨 stack 切换**（如 vite-react → nestjs-react-fullstack）。
+ *
+ * 复用：MigrateRule 把 SyncRule 全部纳入联合类型（10 种）—— migrate 也要做覆盖 / 删除 /
+ * merge-json / patch-script 等动作，没必要重新定义。
+ *
+ * 新增：MoveRule 和 SetStackRule 是 migrate 专有的语义，sync 用不上：
+ *   - MoveRule：把用户领地从老布局搬到新布局（如 src/ → client/src/），完成后源消失。
+ *   - SetStackRule：把 .spark/meta.json 的 stack 字段切到新 stack，migrate 必跑的收尾。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/services/app/init/async-install.js

@@ -0,0 +1,116 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASYNC_INSTALL_LOG = void 0;
+exports.isSandboxEnv = isSandboxEnv;
+exports.runAsyncInstallWorker = runAsyncInstallWorker;
+exports.dispatchAsyncInstall = dispatchAsyncInstall;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const install_1 = require("./install");
+/** event marker 目录，写死；写前 mkdir -p。沙箱里 code server 轮询此目录。 */
+const EVENT_DIR = '/tmp/event';
+/** 安装成功 marker 名 */
+const MARKER_READY = 'WORKSPACE_READY';
+/** 安装失败 marker 名 */
+const MARKER_FAILED = 'WORKSPACE_FAILED';
+/** 后台 worker stdout/stderr 落盘路径 */
+exports.ASYNC_INSTALL_LOG = '/tmp/async_install_dep.std.log';
+/** 沙箱判定：SANDBOX_ID 非空。与 init handler 的 outputLayout 分流口径一致。 */
+function isSandboxEnv() {
+    return process.env.SANDBOX_ID !== undefined && process.env.SANDBOX_ID !== '';
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+function clearStaleMarkers(eventDir) {
+    for (const name of [MARKER_READY, MARKER_FAILED]) {
+        const p = node_path_1.default.join(eventDir, name);
+        if (node_fs_1.default.existsSync(p))
+            node_fs_1.default.rmSync(p, { force: true });
+    }
+}
+function writeMarker(eventDir, name, content) {
+    node_fs_1.default.mkdirSync(eventDir, { recursive: true });
+    node_fs_1.default.writeFileSync(node_path_1.default.join(eventDir, name), JSON.stringify(content) + '\n', 'utf-8');
+}
+/**
+ * 后台 install worker 体：跑 installDependencies，按结果写 marker（仅沙箱）。
+ * 由 dispatchAsyncInstall 通过 `node -e` 在 detached 子进程里调用（见下）。
+ * presence 定成败：成功写 WORKSPACE_READY，失败写 WORKSPACE_FAILED；content 给排障。
+ */
+function runAsyncInstallWorker(opts) {
+    const eventDir = opts.eventDir ?? EVENT_DIR;
+    const sandbox = isSandboxEnv();
+    if (sandbox)
+        clearStaleMarkers(eventDir);
+    const start = Date.now();
+    let result;
+    try {
+        result = (0, install_1.installDependencies)({ targetDir: opts.targetDir, quietStdout: false });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (sandbox) {
+            writeMarker(eventDir, MARKER_FAILED, {
+                ts: nowIso(),
+                error: msg,
+                logPath: exports.ASYNC_INSTALL_LOG,
+            });
+        }
+        return;
+    }
+    if (!sandbox)
+        return;
+    if (result.source === 'failed') {
+        writeMarker(eventDir, MARKER_FAILED, {
+            ts: nowIso(),
+            error: result.error ?? 'npm install failed',
+            logPath: exports.ASYNC_INSTALL_LOG,
+        });
+    }
+    else {
+        writeMarker(eventDir, MARKER_READY, {
+            ts: nowIso(),
+            durationMs: Date.now() - start,
+            source: result.source,
+        });
+    }
+}
+/**
+ * 派发 detached 后台进程跑依赖安装并立即返回。
+ * 用 `node -e` 直接 require 本模块（编译产物）调 runAsyncInstallWorker，
+ * 不挂任何 CLI 子命令、对外不暴露；worker 内复用 installDependencies（cache / registry / fallback）。
+ * 沙箱下派发前清旧 marker；stdout/stderr 重定向到 logPath。
+ */
+function dispatchAsyncInstall(opts) {
+    const eventDir = opts.eventDir ?? EVENT_DIR;
+    const logPath = opts.logPath ?? exports.ASYNC_INSTALL_LOG;
+    const sandbox = isSandboxEnv();
+    if (sandbox)
+        clearStaleMarkers(eventDir);
+    // targetDir 走 argv 传，不拼进代码串（免转义）；只把本模块路径 JSON 内联进去。
+    const workerCode = `require(${JSON.stringify(__filename)}).runAsyncInstallWorker({ targetDir: process.argv[1] })`;
+    node_fs_1.default.mkdirSync(node_path_1.default.dirname(logPath), { recursive: true });
+    const fd = node_fs_1.default.openSync(logPath, 'w');
+    try {
+        const child = (0, node_child_process_1.spawn)(process.execPath, ['-e', workerCode, opts.targetDir], {
+            detached: true,
+            stdio: ['ignore', fd, fd],
+        });
+        child.unref();
+        return {
+            pid: child.pid,
+            logPath,
+            eventReadyPath: sandbox ? node_path_1.default.join(eventDir, MARKER_READY) : undefined,
+            eventFailedPath: sandbox ? node_path_1.default.join(eventDir, MARKER_FAILED) : undefined,
+        };
+    }
+    finally {
+        // 父进程关掉自己那份 fd；子进程已通过 stdio dup 持有独立副本。
+        node_fs_1.default.closeSync(fd);
+    }
+}

package/dist/services/app/init/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.TEMPLATE_PACKAGE_BY_STACK = exports.SUPPORTED_STACKS = exports.renderTemplate = void 0;
+exports.ASYNC_INSTALL_LOG = exports.isSandboxEnv = exports.runAsyncInstallWorker = exports.dispatchAsyncInstall = exports.resolveNpmInstallRegistry = exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.TEMPLATE_PACKAGE_BY_STACK = exports.SUPPORTED_STACKS = exports.renderTemplate = void 0;
 var template_1 = require("./template");
 Object.defineProperty(exports, "renderTemplate", { enumerable: true, get: function () { return template_1.renderTemplate; } });
 Object.defineProperty(exports, "SUPPORTED_STACKS", { enumerable: true, get: function () { return template_1.SUPPORTED_STACKS; } });
@@ -10,3 +10,9 @@ Object.defineProperty(exports, "readSparkMeta", { enumerable: true, get: functio
 Object.defineProperty(exports, "writeSparkMeta", { enumerable: true, get: function () { return spark_meta_1.writeSparkMeta; } });
 var install_1 = require("./install");
 Object.defineProperty(exports, "installDependencies", { enumerable: true, get: function () { return install_1.installDependencies; } });
+Object.defineProperty(exports, "resolveNpmInstallRegistry", { enumerable: true, get: function () { return install_1.resolveNpmInstallRegistry; } });
+var async_install_1 = require("./async-install");
+Object.defineProperty(exports, "dispatchAsyncInstall", { enumerable: true, get: function () { return async_install_1.dispatchAsyncInstall; } });
+Object.defineProperty(exports, "runAsyncInstallWorker", { enumerable: true, get: function () { return async_install_1.runAsyncInstallWorker; } });
+Object.defineProperty(exports, "isSandboxEnv", { enumerable: true, get: function () { return async_install_1.isSandboxEnv; } });
+Object.defineProperty(exports, "ASYNC_INSTALL_LOG", { enumerable: true, get: function () { return async_install_1.ASYNC_INSTALL_LOG; } });

package/dist/services/deploy/modern/atoms/local-release.js

@@ -10,8 +10,13 @@ const logger_1 = require("../../../../utils/logger");
  * 创建本地发布单（加锁；不挂 pipeline）。
  * 返回的 releaseId 必须由 finalizeLocalRelease 翻为终态，否则发布单一直挂着。
  */
-async function createLocalRelease(appId, version) {
-    return (0, index_1.createLocalRelease)({ appID: appId, version });
+async function createLocalRelease(appId, version, extra) {
+    return (0, index_1.createLocalRelease)({
+        appID: appId,
+        version,
+        checkPointVersion: extra?.checkPointVersion,
+        commitID: extra?.commitID,
+    });
 }
 /**
  * 把本地发布单翻为终态。Finished / Failed 由 pipeline 视上下游结果决定。

package/dist/services/deploy/modern/pipelines/local.js

@@ -43,7 +43,10 @@ async function localBuildLocalPublishPipeline(opts) {
         });
     }
     (0, logger_1.log)('deploy', 'Creating local release...');
-    const release = await (0, index_1.createLocalRelease)(ctx.appId, pre.version);
+    const release = await (0, index_1.createLocalRelease)(ctx.appId, pre.version, {
+        checkPointVersion: opts.checkPointVersion,
+        commitID: opts.commitID,
+    });
     try {
         (0, logger_1.log)('deploy', 'Uploading artifacts...');
         await (0, index_1.uploadArtifacts)({ projectDir: ctx.projectDir, appId: ctx.appId, data });

package/dist/utils/codemod-client-toolkit-lite.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Codemod：把 `@lark-apaas/client-toolkit-lite` 的 import 改写到 `@lark-apaas/client-toolkit`。
+ *
+ * 用于 `miaoda app migrate vite-react → nestjs-react-fullstack`：迁移后让两个包共存属于
+ * lib 冗余（两份 react / 两套主题 / 两套 axios），所以扫 user 代码把 lite import 改写到
+ * full，然后用 delete-json-keys 移除 lite dep。
+ *
+ * 实现策略：单行包名替换。
+ *
+ * client-toolkit 自 v1.2.48 起在顶层 single-entry 完整 re-export 了 client-toolkit-lite
+ * 的全部 48 项（components / hooks / utils / integrations / logger / trace / types /
+ * constants），跟 lite 同名同签 —— 所以 codemod 只需把 import 来源包名从 `-lite` 换掉，
+ * specifier 列表完全不动。CSS `@import` 同理（client-toolkit 顶层加了 ./styles.css 别名）。
+ *
+ * 边界：
+ *   - 仅处理形如 `import [type] { A, B as C } from '@lark-apaas/client-toolkit-lite'` 的
+ *     named import；default import / namespace import / 跨多行 specifier 当前不识别，
+ *     但只要 `from '...lite'` 在同一行，包名替换仍有效（regex 抓 from 段）。
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rewriteLiteImports = rewriteLiteImports;
+exports.rewriteCssText = rewriteCssText;
+exports.rewriteText = rewriteText;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const LITE_PKG = '@lark-apaas/client-toolkit-lite';
+const FULL_PKG = '@lark-apaas/client-toolkit';
+/**
+ * 递归扫描 rootDir 下的 .ts/.tsx/.js/.jsx/.css 文件，把 lite import 改写到 full。
+ */
+function rewriteLiteImports(rootDir) {
+    const result = {
+        filesScanned: 0,
+        filesChanged: [],
+        rewrittenSymbols: 0,
+        unmapped: [],
+    };
+    if (!node_fs_1.default.existsSync(rootDir))
+        return result;
+    for (const file of walk(rootDir)) {
+        const isJs = /\.(ts|tsx|js|jsx)$/.test(file);
+        const isCss = file.endsWith('.css');
+        if (!isJs && !isCss)
+            continue;
+        result.filesScanned++;
+        const before = node_fs_1.default.readFileSync(file, 'utf-8');
+        if (!before.includes(LITE_PKG))
+            continue;
+        const rel = node_path_1.default.relative(rootDir, file);
+        const { text, count } = isJs ? rewriteText(before, rel) : rewriteCssText(before, rel);
+        if (count > 0) {
+            node_fs_1.default.writeFileSync(file, text);
+            result.filesChanged.push(rel);
+            result.rewrittenSymbols += count;
+        }
+    }
+    return result;
+}
+/**
+ * css 改写器：单行包名替换。`@import "@lark-apaas/client-toolkit-lite/<path>"` →
+ * `@import "@lark-apaas/client-toolkit/<path>"`。其中 styles.css 在 full 端已加同名别名
+ * 指向 ./lib/index.css。
+ */
+function rewriteCssText(source, _fileLabel) {
+    let count = 0;
+    const re = /(@import\s+['"])@lark-apaas\/client-toolkit-lite(\/[^'"]*)?(['"])/g;
+    const text = source.replace(re, (_match, p1, sub, p3) => {
+        count++;
+        return `${p1}${FULL_PKG}${sub ?? ''}${p3}`;
+    });
+    return { text, count, unmapped: [] };
+}
+/**
+ * JS/TS 文件改写器：把任何 `from '@lark-apaas/client-toolkit-lite'` 改成 full 包名。
+ * specifier 列表完全保留 —— full 顶层 single-entry 已经兼容 lite 全部 48 项 export。
+ *
+ * 同样兼容 dynamic import / require / `export ... from` 等其他形式（只要包名字符串在）。
+ */
+function rewriteText(source, _fileLabel) {
+    let count = 0;
+    // 既匹配 `from 'pkg'` 也匹配 `from "pkg"`，单双引号都管。
+    // 同时覆盖 `import('pkg')` / `require('pkg')` 等其他常见形态。
+    const re = /(['"])@lark-apaas\/client-toolkit-lite(['"])/g;
+    const text = source.replace(re, (_match, p1, p2) => {
+        count++;
+        return `${p1}${FULL_PKG}${p2}`;
+    });
+    return { text, count, unmapped: [] };
+}
+function* walk(dir) {
+    for (const entry of node_fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.name === 'node_modules' || entry.name.startsWith('.'))
+            continue;
+        const full = node_path_1.default.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            yield* walk(full);
+        }
+        else if (entry.isFile()) {
+            yield full;
+        }
+    }
+}