@lark-apaas/miaoda-cli 0.1.16-alpha.f013f1c → 0.1.16-alpha.fdc0db1

package/dist/cli/commands/app/index.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerAppCommands = registerAppCommands;
 const shared_1 = require("../../../cli/commands/shared");
 const index_1 = require("../../../cli/handlers/app/index");
-const index_2 = require("../../../config/migrate-configs/index");
 const error_1 = require("../../../utils/error");
 function registerAppCommands(program, opts = {}) {
     const description = opts.includeInit
@@ -23,56 +22,8 @@ function registerAppCommands(program, opts = {}) {
     if (opts.includeInit) {
         registerAppInit(appCmd);
         registerAppSync(appCmd);
-        registerAppMigrate(appCmd);
     }
 }
-function registerAppMigrate(parent) {
-    const supportedDesc = (0, index_2.listSupportedMigrations)()
-        .map((m) => `${m.from} → ${m.to}`)
-        .join(', ');
-    const cmd = parent
-        .command('migrate')
-        .description('跨 stack 原地迁移：按 MigrateConfig 全套 apply（move + delete + 模板覆盖 + 字段 merge + set-stack）')
-        .requiredOption('--to <stack>', '目标 stack 短名')
-        .option('--from <stack>', '源 stack；默认读 .spark/meta.json 当前 stack')
-        .option('--dir <path>', '项目目录，默认 cwd（需含 .spark/meta.json）')
-        .addHelpText('after', `
-已支持的迁移路径
-  ${supportedDesc || '(none)'}
-
-执行流
-  1. 校验 .spark/meta.json 存在且当前 stack 匹配 --from（或自动读 meta）
-  2. 按 (from, to) 在 src/config/migrate-configs/ 取 MigrateConfig
-  3. 顺序执行 rules：
-       move-directory / move-file   → 用户领地搬到新布局（src → client/src 等）
-       delete-file / delete-directory → 清理老 stack 的残留文件
-       delete-json-keys             → 从 user package.json 删 vite-react 专属字段
-       file / directory             → 拷新 stack 的模板资产覆盖
-       merge-json                   → package.json 等字段级深合并
-       add-script / patch-script / add-line / remove-line → 局部修补
-       set-stack                    → 收尾切 .spark/meta.json 的 stack 字段
-  4. 不做 npm install —— 让用户自行 review 改动后再装依赖（package-lock.json 已删）
-
-JSON 输出
-  {"data": {"from": "...", "to": "...",
-            "appliedRules": [{"type": "...", "action": "...", "path": "...", "detail": "..."}],
-            "moved": [...], "deleted": [...], "synced": [...], "merged": [...], "patched": [...],
-            "skipped": N,
-            "nextActions": [...]}}
-
-示例
-  $ miaoda app migrate --to nestjs-react-fullstack
-  $ miaoda app migrate --from vite-react --to nestjs-react-fullstack
-  $ miaoda app migrate --to nestjs-react-fullstack --dir /path/to/app
-`);
-    cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
-        await (0, index_1.handleAppMigrate)({
-            dir: rawOpts.dir,
-            from: rawOpts.from,
-            to: rawOpts.to,
-        });
-    }));
-}
 function registerAppSync(parent) {
     const cmd = parent
         .command('sync')

package/dist/cli/commands/db/index.js

@@ -481,7 +481,6 @@ Examples:
         '应用到 online；online 将无法直接更改数据库结构（仍可进行数据 DML 操作）。')
         .usage('[flags]')
         .option('--sync-data', '启用时将现有数据同步一份到 dev 环境')
-        .option('-y, --yes', '跳过确认提示直接执行')
         .action(async function () {
         await (0, index_1.handleDbMigrationInit)(this.optsWithGlobals());
     })
@@ -562,7 +561,6 @@ Examples:
         .summary('将 dev 的变更发布到 online（单事务原子）')
         .description('将 dev 的变更发布到 online。')
         .usage('[flags]')
-        .option('-y, --yes', '跳过确认提示直接执行')
         .action(async function () {
         await (0, index_1.handleDbMigrationApply)(this.optsWithGlobals());
     })
@@ -681,7 +679,6 @@ Examples:
         .description('将数据库恢复到指定时间点的状态。')
         .usage('<timestamp> [flags]')
         .argument('<timestamp>', '目标时间')
-        .option('-y, --yes', '跳过确认提示直接执行')
         .action(async function (target) {
         await (0, index_1.handleDbRecoveryApply)(target, this.optsWithGlobals());
     })

package/dist/cli/commands/file/index.js

@@ -146,9 +146,10 @@ Examples:
         .usage('[paths...] [flags]')
         .argument('[paths...]', '要删除的文件，每项可填路径或文件名（自动识别）')
         .option('-n, --name <name>', '按文件名删除（可重复指定）', (value, prev) => [...(prev ?? []), value])
-        .option('-y, --yes', '跳过交互确认；非交互场景必加')
-        .action(async (paths, opts) => {
-        await (0, index_1.handleFileRm)(paths, { ...opts, appId: (0, shared_1.resolveAppId)({}) });
+        // --yes 是 root 全局 option（见 main.ts），不在此重复声明；必须经 optsWithGlobals
+        // 读取（值挂在 root 上，本地 this.opts().yes 为 undefined），否则非交互场景确认门会误拦。
+        .action(async function (paths) {
+        await (0, index_1.handleFileRm)(paths, { ...this.optsWithGlobals(), appId: (0, shared_1.resolveAppId)({}) });
     })
         .addHelpText('after', `
 Notes:

package/dist/cli/handlers/app/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SUPPORTED_STACKS = exports.handleAppMigrate = exports.handleAppUpgrade = exports.handleAppSync = exports.handleAppInit = exports.handleAppUpdate = exports.handleAppGet = void 0;
+exports.SUPPORTED_STACKS = exports.handleAppUpgrade = exports.handleAppSync = exports.handleAppInit = exports.handleAppUpdate = exports.handleAppGet = void 0;
 var get_1 = require("./get");
 Object.defineProperty(exports, "handleAppGet", { enumerable: true, get: function () { return get_1.handleAppGet; } });
 var update_1 = require("./update");
@@ -10,8 +10,6 @@ Object.defineProperty(exports, "handleAppInit", { enumerable: true, get: functio
 var sync_1 = require("./sync");
 Object.defineProperty(exports, "handleAppSync", { enumerable: true, get: function () { return sync_1.handleAppSync; } });
 Object.defineProperty(exports, "handleAppUpgrade", { enumerable: true, get: function () { return sync_1.handleAppUpgrade; } });
-var migrate_1 = require("./migrate");
-Object.defineProperty(exports, "handleAppMigrate", { enumerable: true, get: function () { return migrate_1.handleAppMigrate; } });
 // commands 层渲染 help 时需要这份枚举；从 handler barrel 转发，避免 commands → services 越界
 var index_1 = require("../../../services/app/init/index");
 Object.defineProperty(exports, "SUPPORTED_STACKS", { enumerable: true, get: function () { return index_1.SUPPORTED_STACKS; } });

package/dist/main.js

@@ -30,6 +30,9 @@ program
     .argParser((0, shared_1.caseInsensitiveChoice)(['pretty', 'json']))
     .default('pretty'))
     .option('--verbose', 'debug 日志到 stderr')
+    // 全局接受 -y/--yes：作为 root 全局 option 下发到所有子命令解析（同 --json/--verbose），
+    // 让任意命令带 --yes 都不报 unknown option。对有确认门的破坏性命令生效，其余命令忽略。
+    .option('-y, --yes', '跳过确认提示（对有确认门的命令生效，其余命令忽略）')
     .helpOption('-h, --help', '显示帮助信息')
     .hook('preAction', (_thisCmd, actionCmd) => {
     (0, log_id_1.generateLogId)();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.16-alpha.f013f1c",
+  "version": "0.1.16-alpha.fdc0db1",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {

package/dist/cli/handlers/app/migrate.js

@@ -1,182 +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.handleAppMigrate = handleAppMigrate;
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_os_1 = __importDefault(require("node:os"));
-const node_path_1 = __importDefault(require("node:path"));
-const index_1 = require("../../../config/migrate-configs/index");
-const index_2 = require("../../../services/app/init/index");
-const migrate_rule_1 = require("../../../utils/migrate-rule");
-const spark_meta_1 = require("../../../utils/spark-meta");
-const error_1 = require("../../../utils/error");
-const output_1 = require("../../../utils/output");
-const logger_1 = require("../../../utils/logger");
-/**
- * miaoda app migrate --to <stack> [--from <stack>] [--dir <path>]
- *
- * 跨 stack 原地迁移：把 user app 从源 stack（默认 .spark/meta.json 当前 stack）转到目标 stack。
- * 同一个 git 仓库内进行，不动 git history，所有改动作为 working tree 变更体现，用户跑完后
- * 自行 `git status` / `git diff` 评估并 commit。
- *
- * 跟 sync 的区别：sync 是同 stack 内的版本对齐，migrate 是跨 stack 切换（布局重排、依赖
- * 集合切换、配置文件全套替换）。两条命令的 rule 引擎共享（applyMigrateRules 内部对
- * SyncRule 委派给 applySyncRules）。
- *
- * 执行流：
- *   1. 校验 user app 已 init（.spark/meta.json 存在）+ 当前 stack 匹配 from
- *   2. 拿到 (from, to) 对应的 MigrateConfig 与模板源根目录
- *   3. 顺序执行 rules：move-* → delete-* → delete-json-keys → file/directory →
- *      merge-json → set-stack
- *   4. emit 结果；不做 npm install（用户接下来跑 `npm install` 或 `miaoda app sync` 时自然装）
- *
- * 不做事：
- *   - 不自动 commit / stash —— 让用户自己用 git review 改动
- *   - 不跑 npm install —— 留给后续 sync 或用户手动
- *   - 不动 .agent/skills/（那是 miaoda skills sync 的事，迁移后用户应该单独跑一次切到新 stack 的 skills）
- */
-async function handleAppMigrate(opts) {
-    await Promise.resolve();
-    const targetDir = node_path_1.default.resolve(opts.dir ?? process.cwd());
-    const meta = (0, spark_meta_1.readSparkMeta)(targetDir);
-    if (meta.stack === undefined || meta.stack === '') {
-        throw new error_1.AppError('MIGRATE_META_INCOMPLETE', '.spark/meta.json missing stack — run `miaoda app init` first');
-    }
-    const from = opts.from ?? meta.stack;
-    if (opts.from !== undefined && opts.from !== meta.stack) {
-        throw new error_1.AppError('MIGRATE_FROM_MISMATCH', `--from '${opts.from}' but current stack is '${meta.stack}'`, {
-            next_actions: ['省略 --from 让 cli 自动读 meta.json，或确认 user app 状态'],
-        });
-    }
-    if (from === opts.to) {
-        throw new error_1.AppError('MIGRATE_NOOP', `from and to are both '${from}', nothing to do`);
-    }
-    const config = (0, index_1.getMigrateConfig)(from, opts.to);
-    if (config === null) {
-        const supported = (0, index_1.listSupportedMigrations)()
-            .map((m) => `${m.from} → ${m.to}`)
-            .join(', ');
-        throw new error_1.AppError('MIGRATE_PATH_NOT_SUPPORTED', `no migrate config for '${from}' → '${opts.to}'`, {
-            next_actions: [`已支持：${supported || '(none)'}`],
-        });
-    }
-    // migrate 用 init 同款的 renderTemplate 拉目标 stack 的 npm template tarball 到 tmp，
-    // 再把 tmp 当作 sourceRoot 喂给 applyMigrateRules。这样 migrate config 里 file/directory
-    // rule 的 `from` 引用的是完整的 npm template 渲染产物，不需要在 upgrade/templates/ 重复
-    // 维护一份 server/ + client/ + 全套配置 —— 复杂度由 init 那条链路 amortize。
-    const tmpRoot = node_fs_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), 'miaoda-migrate-'));
-    const projectName = node_path_1.default.basename(targetDir);
-    let templateVersion;
-    let templateArchType;
-    let results;
-    try {
-        const tpl = (0, index_2.renderTemplate)({ stack: opts.to, targetDir: tmpRoot, projectName });
-        templateVersion = tpl.version;
-        templateArchType = tpl.archType;
-        // template package.json 的 user 私有字段（name / version / private 等）不参与 merge —— 否
-        // 则会被 deepMergeJson 当成 template 端"权威值"覆盖 user 项目原本的字段。这里在 tmp 端
-        // 直接 strip 这些字段，让 merge-json rule 只对 dependencies / devDependencies / scripts
-        // 等 schema-level 字段生效。
-        stripUserOwnedFields(node_path_1.default.join(tmpRoot, 'package.json'));
-        (0, logger_1.log)('migrate', `Rendered ${opts.to}@${tpl.version} to tmp, applying ${config.rules.length.toString()} rule(s)`);
-        results = (0, migrate_rule_1.applyMigrateRules)(config.rules, {
-            sourceRoot: tmpRoot,
-            targetDir,
-            logPrefix: 'migrate',
-        });
-    }
-    finally {
-        node_fs_1.default.rmSync(tmpRoot, { recursive: true, force: true });
-    }
-    // archType / version 字段同步：set-stack rule 只切 stack，archType 是从 npm template 包
-    // 的 miaodaTemplate.archType 拿到的动态值，rule 配置时不知道，由 handler 在拿到
-    // renderTemplate 结果后单独写。version 也一并写回方便 sync 后续诊断。
-    (0, spark_meta_1.writeSparkMeta)(targetDir, { archType: templateArchType, version: templateVersion });
-    (0, output_1.emit)({
-        data: {
-            from,
-            to: opts.to,
-            templateVersion,
-            appliedRules: results.map((r) => ({
-                type: r.rule.type,
-                action: r.action,
-                path: r.path,
-                detail: r.detail,
-            })),
-            ...summarizeResults(results),
-            nextActions: [
-                'git status / git diff 评估改动并 commit',
-                'npm install 装新依赖（package-lock.json 已被删除，将重新生成）',
-                'miaoda skills sync 同步到新 stack 的 agent skills',
-            ],
-        },
-    });
-}
-/**
- * 从 tmp 端 template package.json 中删除 user 项目通常拥有的字段，避免 merge-json 时这些
- * 字段被 template 值覆盖。需要 strip 的字段以 npm 模板里"通常专属于具体应用"的为准。
- */
-function stripUserOwnedFields(pkgPath) {
-    if (!node_fs_1.default.existsSync(pkgPath))
-        return;
-    const json = JSON.parse(node_fs_1.default.readFileSync(pkgPath, 'utf-8'));
-    const userOwned = [
-        'name',
-        'version',
-        'private',
-        'description',
-        'author',
-        'keywords',
-        'license',
-        'repository',
-        'homepage',
-        'bugs',
-    ];
-    let changed = false;
-    for (const key of userOwned) {
-        if (Reflect.deleteProperty(json, key))
-            changed = true;
-    }
-    if (changed) {
-        node_fs_1.default.writeFileSync(pkgPath, JSON.stringify(json, null, 2) + '\n');
-    }
-}
-function summarizeResults(results) {
-    const moved = [];
-    const deleted = [];
-    const synced = [];
-    const merged = [];
-    const patched = [];
-    let skipped = 0;
-    for (const r of results) {
-        if (r.path === undefined)
-            continue;
-        switch (r.action) {
-            case 'moved':
-                moved.push(r.path);
-                break;
-            case 'deleted':
-                deleted.push(r.path);
-                break;
-            case 'synced':
-            case 'created':
-                synced.push(r.path);
-                break;
-            case 'merged':
-                merged.push(r.path);
-                break;
-            case 'patched':
-                patched.push(r.path);
-                break;
-            case 'skipped':
-                skipped++;
-                break;
-            case 'appended':
-            case 'noop':
-                break;
-        }
-    }
-    return { moved, deleted, synced, merged, patched, skipped };
-}

package/dist/config/migrate-configs/index.js

@@ -1,35 +0,0 @@
-"use strict";
-/**
- * 跨 stack 迁移注册表 —— 按 (from, to) 二元组查找对应的 MigrateConfig。
- *
- * 跟 sync 注册表 (src/config/sync-configs/index.ts) 的关系：sync 一份配置对应一个 stack，
- * migrate 一份配置对应 (源 stack, 目标 stack) 二元组；模板资产 migrate 在 runtime 从 npm
- * 拉目标 stack 的 template tarball（init 用同一套 renderTemplate），不再用 upgrade/templates/
- * 的子集。
- *
- * 新增迁移路径：
- *   1. src/config/migrate-configs/<from>-to-<to>.ts 里 export default MIGRATE_CONFIG
- *   2. 在 MIGRATE_REGISTRY 加一条
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMigrateConfig = getMigrateConfig;
-exports.listSupportedMigrations = listSupportedMigrations;
-const vite_react_to_nestjs_react_fullstack_1 = __importDefault(require("./vite-react-to-nestjs-react-fullstack"));
-/** key 格式：`<from>:<to>` */
-const MIGRATE_REGISTRY = {
-    'vite-react:nestjs-react-fullstack': vite_react_to_nestjs_react_fullstack_1.default,
-};
-/** 返回 (from, to) 对应的 MigrateConfig；未注册时返回 null。 */
-function getMigrateConfig(from, to) {
-    return MIGRATE_REGISTRY[`${from}:${to}`] ?? null;
-}
-/** 列出已支持的迁移路径，给 handler / 命令 help 用 */
-function listSupportedMigrations() {
-    return Object.keys(MIGRATE_REGISTRY).map((key) => {
-        const [from, to] = key.split(':');
-        return { from, to };
-    });
-}

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

@@ -1,202 +0,0 @@
-"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. NestJS server runtime 资产（新增，不覆盖 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.node.json：server 端 ts 编译配置
-        { type: 'file', from: 'tsconfig.node.json', to: 'tsconfig.node.json', overwrite: true },
-        // client/index.html：HBS 模板（fullstack 用，vite-react 用根 index.html 已删）
-        { type: 'file', from: 'client/index.html', to: 'client/index.html', overwrite: true },
-        // scripts/dev.sh + build.sh：并发起 nest + vite 的脚本（fullstack 形态必需）
-        { type: 'file', from: 'scripts/dev.sh', to: 'scripts/dev.sh', overwrite: true },
-        { type: 'file', from: 'scripts/build.sh', to: 'scripts/build.sh', 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 },
-        // ===== 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,
-        },
-        // ===== 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',
-            ],
-        },
-        // ===== 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' },
-    ],
-};
-exports.default = exports.MIGRATE_CONFIG;

package/dist/config/migrate.js

@@ -1,15 +0,0 @@
-"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/utils/codemod-client-toolkit-lite.js

@@ -1,106 +0,0 @@
-"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;
-        }
-    }
-}

package/dist/utils/migrate-rule.js

@@ -1,507 +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.applyMigrateRules = applyMigrateRules;
-exports.rewriteViteConfigForFullstack = rewriteViteConfigForFullstack;
-const node_fs_1 = __importDefault(require("node:fs"));
-const node_path_1 = __importDefault(require("node:path"));
-const sync_rule_1 = require("./sync-rule");
-const spark_meta_1 = require("./spark-meta");
-const codemod_client_toolkit_lite_1 = require("./codemod-client-toolkit-lite");
-const logger_1 = require("./logger");
-/**
- * 顺序执行 MigrateRule[]：
- *   - move-* / set-stack 是 migrate 专有 rule，本模块直接处理。
- *   - 其余（directory / file / merge-json / delete-* / add-script / ...）全部委派给
- *     applySyncRules —— 单条调用，逻辑跟 sync 完全对齐，避免行为漂移。
- *
- * 一条 rule 报错不影响后续（applySyncRules 内部已有 try/catch；本模块的 applyMove / applySetStack
- * 当前不 catch —— 如果 move 失败说明状态已经被破坏，应当直接抛错让 handler 决定回滚或上报）。
- */
-function applyMigrateRules(rules, opts) {
-    const results = [];
-    for (const rule of rules) {
-        if (rule.type === 'move-directory' || rule.type === 'move-file') {
-            results.push(applyMove(rule, opts));
-            continue;
-        }
-        if (rule.type === 'set-stack') {
-            results.push(applySetStack(rule, opts));
-            continue;
-        }
-        if (rule.type === 'delete-json-keys') {
-            results.push(applyDeleteJsonKeys(rule, opts));
-            continue;
-        }
-        if (rule.type === 'codemod-client-toolkit-lite') {
-            results.push(applyCodemodLite(rule, opts));
-            continue;
-        }
-        if (rule.type === 'codemod-vite-config-fullstack') {
-            results.push(applyCodemodViteConfigFullstack(rule, opts));
-            continue;
-        }
-        if (rule.type === 'add-deps-from-template') {
-            results.push(applyAddDepsFromTemplate(rule, opts));
-            continue;
-        }
-        // 前面 if 已经把 migrate 专用 rule 都 narrow 掉，剩下的必然是 SyncRule
-        const [syncResult] = (0, sync_rule_1.applySyncRules)([rule], opts);
-        results.push(syncResult);
-    }
-    return results;
-}
-function applyMove(rule, opts) {
-    const logPrefix = opts.logPrefix ?? 'migrate';
-    const src = node_path_1.default.join(opts.targetDir, rule.from);
-    const dest = node_path_1.default.join(opts.targetDir, rule.to);
-    const onConflict = rule.onConflict ?? 'merge';
-    if (!node_fs_1.default.existsSync(src)) {
-        (0, logger_1.log)(logPrefix, `  ○ ${rule.from} (source not found, skip)`);
-        return { rule, action: 'skipped', path: rule.to };
-    }
-    if (node_fs_1.default.existsSync(dest)) {
-        if (onConflict === 'skip') {
-            (0, logger_1.log)(logPrefix, `  ○ ${rule.to} (already exists, skip per onConflict=skip)`);
-            return { rule, action: 'skipped', path: rule.to };
-        }
-        if (onConflict === 'overwrite') {
-            node_fs_1.default.rmSync(dest, { recursive: true, force: true });
-            moveAtomic(src, dest);
-            (0, logger_1.log)(logPrefix, `  ✓ ${rule.from} → ${rule.to} (overwritten)`);
-            return { rule, action: 'moved', path: rule.to, detail: rule.from };
-        }
-        // 'merge'：把 src 的内容递归 overlay 到 dest，源 entry 完成后整体清掉
-        mergeOverlay(src, dest);
-        node_fs_1.default.rmSync(src, { recursive: true, force: true });
-        (0, logger_1.log)(logPrefix, `  ✓ ${rule.from} → ${rule.to} (merged)`);
-        return { rule, action: 'moved', path: rule.to, detail: rule.from };
-    }
-    // 目标不存在 —— 直接 rename
-    const destDir = node_path_1.default.dirname(dest);
-    if (destDir !== '.' && !node_fs_1.default.existsSync(destDir)) {
-        node_fs_1.default.mkdirSync(destDir, { recursive: true });
-    }
-    moveAtomic(src, dest);
-    (0, logger_1.log)(logPrefix, `  ✓ ${rule.from} → ${rule.to}`);
-    return { rule, action: 'moved', path: rule.to, detail: rule.from };
-}
-/**
- * fs.renameSync 在跨设备 / 跨文件系统时报 EXDEV（Linux/macOS），fallback 到 cp -r + rm。
- * worktree 内通常同一卷不会触发，但 tmp 目录跟 user app 可能不同卷，留这层兜底。
- */
-function moveAtomic(src, dest) {
-    try {
-        node_fs_1.default.renameSync(src, dest);
-    }
-    catch (err) {
-        if (err.code !== 'EXDEV') {
-            throw err;
-        }
-        node_fs_1.default.cpSync(src, dest, { recursive: true });
-        node_fs_1.default.rmSync(src, { recursive: true, force: true });
-    }
-}
-/**
- * 把 src 的每个 entry 复制到 dest 同路径下（src 是文件则覆盖 dest 同名文件；src 是目录则
- * 递归创建 + 复制）。同名冲突一律 src 覆盖 dest。本函数不删 src；调用方负责清理。
- */
-function mergeOverlay(src, dest) {
-    const stat = node_fs_1.default.statSync(src);
-    if (stat.isFile()) {
-        node_fs_1.default.mkdirSync(node_path_1.default.dirname(dest), { recursive: true });
-        node_fs_1.default.copyFileSync(src, dest);
-        return;
-    }
-    if (!node_fs_1.default.existsSync(dest)) {
-        node_fs_1.default.mkdirSync(dest, { recursive: true });
-    }
-    for (const entry of node_fs_1.default.readdirSync(src)) {
-        mergeOverlay(node_path_1.default.join(src, entry), node_path_1.default.join(dest, entry));
-    }
-}
-function applySetStack(rule, opts) {
-    const logPrefix = opts.logPrefix ?? 'migrate';
-    (0, spark_meta_1.writeSparkMeta)(opts.targetDir, { stack: rule.stack });
-    (0, logger_1.log)(logPrefix, `  ✓ .spark/meta.json stack → ${rule.stack}`);
-    return { rule, action: 'patched', path: '.spark/meta.json', detail: rule.stack };
-}
-function applyDeleteJsonKeys(rule, opts) {
-    const logPrefix = opts.logPrefix ?? 'migrate';
-    const dest = node_path_1.default.join(opts.targetDir, rule.to);
-    if (!node_fs_1.default.existsSync(dest)) {
-        (0, logger_1.log)(logPrefix, `  ○ ${rule.to} (not found, skip delete-json-keys)`);
-        return { rule, action: 'skipped', path: rule.to };
-    }
-    const text = node_fs_1.default.readFileSync(dest, 'utf-8');
-    const json = JSON.parse(text);
-    const deleted = [];
-    for (const dotKey of rule.keys) {
-        if (deleteAtDotPath(json, dotKey))
-            deleted.push(dotKey);
-    }
-    if (deleted.length === 0) {
-        (0, logger_1.log)(logPrefix, `  ○ ${rule.to} (no listed keys present)`);
-        return { rule, action: 'noop', path: rule.to };
-    }
-    // 保持原文件末尾换行约定（package.json 一般以 \n 结尾）
-    const trailing = text.endsWith('\n') ? '\n' : '';
-    node_fs_1.default.writeFileSync(dest, JSON.stringify(json, null, 2) + trailing);
-    (0, logger_1.log)(logPrefix, `  ✓ ${rule.to} (deleted ${deleted.length.toString()} key(s): ${deleted.join(', ')})`);
-    return { rule, action: 'patched', path: rule.to, detail: deleted.join(',') };
-}
-function applyCodemodLite(rule, opts) {
-    const logPrefix = opts.logPrefix ?? 'migrate';
-    const root = node_path_1.default.join(opts.targetDir, rule.root ?? 'client/src');
-    const r = (0, codemod_client_toolkit_lite_1.rewriteLiteImports)(root);
-    if (r.filesChanged.length === 0 && r.unmapped.length === 0) {
-        (0, logger_1.log)(logPrefix, `  ○ ${rule.root ?? 'client/src'} (no @lark-apaas/client-toolkit-lite imports found)`);
-        return { rule, action: 'noop', path: rule.root ?? 'client/src' };
-    }
-    const detail = `${r.rewrittenSymbols.toString()} symbol(s) in ${r.filesChanged.length.toString()} file(s)` +
-        (r.unmapped.length > 0 ? `; ${r.unmapped.length.toString()} unmapped` : '');
-    (0, logger_1.log)(logPrefix, `  ✓ ${rule.root ?? 'client/src'} (codemod: ${detail})`);
-    for (const u of r.unmapped) {
-        (0, logger_1.log)(logPrefix, `    ⚠ unmapped: ${u.file}:${u.line.toString()} '${u.symbol}'`);
-    }
-    return {
-        rule,
-        action: r.rewrittenSymbols > 0 ? 'patched' : 'noop',
-        path: rule.root ?? 'client/src',
-        detail,
-    };
-}
-function applyCodemodViteConfigFullstack(rule, opts) {
-    const logPrefix = opts.logPrefix ?? 'migrate';
-    const rel = rule.to ?? 'vite.config.ts';
-    const dest = node_path_1.default.join(opts.targetDir, rel);
-    if (!node_fs_1.default.existsSync(dest)) {
-        (0, logger_1.log)(logPrefix, `  ○ ${rel} (not found, skip)`);
-        return { rule, action: 'skipped', path: rel };
-    }
-    const before = node_fs_1.default.readFileSync(dest, 'utf-8');
-    const { text, changed, alreadyDone } = rewriteViteConfigForFullstack(before);
-    if (alreadyDone) {
-        (0, logger_1.log)(logPrefix, `  ○ ${rel} (fullstack: true already present)`);
-        return { rule, action: 'noop', path: rel };
-    }
-    if (!changed) {
-        (0, logger_1.log)(logPrefix, `  ⚠ ${rel} (defineConfig call not found; please add { fullstack: true } manually)`);
-        return { rule, action: 'noop', path: rel, detail: 'defineConfig call not found' };
-    }
-    node_fs_1.default.writeFileSync(dest, text);
-    (0, logger_1.log)(logPrefix, `  ✓ ${rel} (added { fullstack: true } to defineConfig)`);
-    return { rule, action: 'patched', path: rel };
-}
-/**
- * 给 vite.config.ts 的 `defineConfig(...)` 调用加上 `{ fullstack: true }` 第二参。
- *
- * 支持的形态：
- *   defineConfig({ ... })             → defineConfig({ ... }, { fullstack: true })
- *   defineConfig({ ... }, { ... })    → 已有第二参，把 fullstack: true 注入对象字面量
- *   defineConfig()                    → defineConfig({}, { fullstack: true })
- *
- * 跨多行 + 嵌套 arrow function / 字符串 / 模板字符串都要保留，所以用括号匹配而非正则。
- * 已经含 `fullstack: true` 字面量则跳过（视为已迁移）。
- */
-function rewriteViteConfigForFullstack(source) {
-    const callRe = /defineConfig\s*\(/g;
-    const m = callRe.exec(source);
-    if (m === null) {
-        return { text: source, changed: false, alreadyDone: false };
-    }
-    const openIdx = m.index + m[0].length - 1; // 指向 '('
-    const closeIdx = findMatchingParen(source, openIdx);
-    if (closeIdx < 0) {
-        return { text: source, changed: false, alreadyDone: false };
-    }
-    const argsRaw = source.slice(openIdx + 1, closeIdx);
-    if (/fullstack\s*:\s*true/.test(argsRaw)) {
-        return { text: source, changed: false, alreadyDone: true };
-    }
-    const { firstArgEnd, secondArgRange } = splitFirstTwoArgs(source, openIdx + 1, closeIdx);
-    if (secondArgRange === null) {
-        // 单参 / 无参：在第一参之后插 ", { fullstack: true }"
-        const insertAt = firstArgEnd ?? openIdx + 1;
-        const head = source.slice(0, insertAt);
-        const tail = source.slice(insertAt, closeIdx);
-        // 第一参是否非空（去空白）
-        const arg1 = source.slice(openIdx + 1, insertAt).trim();
-        const sep = arg1.length === 0 ? '{}, { fullstack: true }' : ', { fullstack: true }';
-        return {
-            text: head + (arg1.length === 0 ? sep : sep) + tail + source.slice(closeIdx),
-            changed: true,
-            alreadyDone: false,
-        };
-    }
-    // 双参：在第二参对象 `{` 之后插 ` fullstack: true,`
-    const arg2 = source.slice(secondArgRange.start, secondArgRange.end);
-    const objOpen = arg2.indexOf('{');
-    if (objOpen < 0) {
-        // 第二参不是对象字面量（罕见），保守跳过
-        return { text: source, changed: false, alreadyDone: false };
-    }
-    const absObjOpen = secondArgRange.start + objOpen;
-    const inserted = '\n  fullstack: true,';
-    return {
-        text: source.slice(0, absObjOpen + 1) + inserted + source.slice(absObjOpen + 1),
-        changed: true,
-        alreadyDone: false,
-    };
-}
-/**
- * 从 openIdx（指向 `(`）开始扫到匹配的 `)`，跳过 string / template / 括号嵌套。
- * 找不到匹配返回 -1。
- */
-function findMatchingParen(text, openIdx) {
-    let depth = 0;
-    let i = openIdx;
-    let inSingle = false;
-    let inDouble = false;
-    let inTpl = false;
-    let inLineComment = false;
-    let inBlockComment = false;
-    while (i < text.length) {
-        const c = text[i];
-        const next = i + 1 < text.length ? text[i + 1] : '';
-        if (inLineComment) {
-            if (c === '\n')
-                inLineComment = false;
-            i++;
-            continue;
-        }
-        if (inBlockComment) {
-            if (c === '*' && next === '/') {
-                inBlockComment = false;
-                i += 2;
-                continue;
-            }
-            i++;
-            continue;
-        }
-        if (inSingle) {
-            if (c === '\\')
-                i += 2;
-            else if (c === "'") {
-                inSingle = false;
-                i++;
-            }
-            else
-                i++;
-            continue;
-        }
-        if (inDouble) {
-            if (c === '\\')
-                i += 2;
-            else if (c === '"') {
-                inDouble = false;
-                i++;
-            }
-            else
-                i++;
-            continue;
-        }
-        if (inTpl) {
-            if (c === '\\')
-                i += 2;
-            else if (c === '`') {
-                inTpl = false;
-                i++;
-            }
-            else
-                i++;
-            continue;
-        }
-        if (c === '/' && next === '/') {
-            inLineComment = true;
-            i += 2;
-            continue;
-        }
-        if (c === '/' && next === '*') {
-            inBlockComment = true;
-            i += 2;
-            continue;
-        }
-        if (c === "'") {
-            inSingle = true;
-            i++;
-            continue;
-        }
-        if (c === '"') {
-            inDouble = true;
-            i++;
-            continue;
-        }
-        if (c === '`') {
-            inTpl = true;
-            i++;
-            continue;
-        }
-        if (c === '(' || c === '{' || c === '[') {
-            depth++;
-            i++;
-            continue;
-        }
-        if (c === ')' || c === '}' || c === ']') {
-            depth--;
-            if (depth === 0 && c === ')')
-                return i;
-            i++;
-            continue;
-        }
-        i++;
-    }
-    return -1;
-}
-/**
- * 在 `argsStart`（`(` 之后第一字符）到 `argsEnd`（`)` 位置）范围内识别顶层 `,`，
- * 拿到第一参结束位置和（如果存在）第二参的范围。
- */
-function splitFirstTwoArgs(text, argsStart, argsEnd) {
-    let depth = 0;
-    let i = argsStart;
-    let inSingle = false;
-    let inDouble = false;
-    let inTpl = false;
-    let firstComma = -1;
-    while (i < argsEnd) {
-        const c = text[i];
-        if (inSingle) {
-            if (c === '\\') {
-                i += 2;
-                continue;
-            }
-            if (c === "'")
-                inSingle = false;
-            i++;
-            continue;
-        }
-        if (inDouble) {
-            if (c === '\\') {
-                i += 2;
-                continue;
-            }
-            if (c === '"')
-                inDouble = false;
-            i++;
-            continue;
-        }
-        if (inTpl) {
-            if (c === '\\') {
-                i += 2;
-                continue;
-            }
-            if (c === '`')
-                inTpl = false;
-            i++;
-            continue;
-        }
-        if (c === "'") {
-            inSingle = true;
-            i++;
-            continue;
-        }
-        if (c === '"') {
-            inDouble = true;
-            i++;
-            continue;
-        }
-        if (c === '`') {
-            inTpl = true;
-            i++;
-            continue;
-        }
-        if (c === '(' || c === '{' || c === '[') {
-            depth++;
-            i++;
-            continue;
-        }
-        if (c === ')' || c === '}' || c === ']') {
-            depth--;
-            i++;
-            continue;
-        }
-        if (c === ',' && depth === 0) {
-            firstComma = i;
-            break;
-        }
-        i++;
-    }
-    if (firstComma < 0) {
-        return { firstArgEnd: argsEnd, secondArgRange: null };
-    }
-    return {
-        firstArgEnd: firstComma,
-        secondArgRange: { start: firstComma + 1, end: argsEnd },
-    };
-}
-function applyAddDepsFromTemplate(rule, opts) {
-    const logPrefix = opts.logPrefix ?? 'migrate';
-    const userPath = node_path_1.default.join(opts.targetDir, rule.to ?? 'package.json');
-    const tplPath = node_path_1.default.join(opts.sourceRoot, rule.from ?? 'package.json');
-    if (!node_fs_1.default.existsSync(userPath)) {
-        (0, logger_1.log)(logPrefix, `  ○ ${rule.to ?? 'package.json'} (not found, skip add-deps-from-template)`);
-        return { rule, action: 'skipped', path: rule.to ?? 'package.json' };
-    }
-    if (!node_fs_1.default.existsSync(tplPath)) {
-        (0, logger_1.log)(logPrefix, `  ⚠ template ${rule.from ?? 'package.json'} not found, skip add-deps-from-template`);
-        return { rule, action: 'skipped', path: rule.to ?? 'package.json' };
-    }
-    const userText = node_fs_1.default.readFileSync(userPath, 'utf-8');
-    const userJson = JSON.parse(userText);
-    const tplJson = JSON.parse(node_fs_1.default.readFileSync(tplPath, 'utf-8'));
-    const added = [];
-    const missingInTpl = [];
-    for (const grp of ['dependencies', 'devDependencies']) {
-        const whitelist = rule[grp] ?? [];
-        if (whitelist.length === 0)
-            continue;
-        userJson[grp] ??= {};
-        for (const dep of whitelist) {
-            // 在 template 里找版本号：优先 tpl 同 grp，其次另一 grp（template 可能把 dep 写在
-            // dependencies/devDependencies 任一处，跟 user 当前 grp 不一定一致）
-            const tplVersion = tplJson[grp]?.[dep] ??
-                (grp === 'dependencies' ? tplJson.devDependencies?.[dep] : tplJson.dependencies?.[dep]);
-            if (tplVersion === undefined) {
-                missingInTpl.push(dep);
-                continue;
-            }
-            userJson[grp][dep] = tplVersion;
-            added.push(`${grp}.${dep}`);
-        }
-    }
-    if (added.length === 0 && missingInTpl.length === 0) {
-        (0, logger_1.log)(logPrefix, `  ○ ${rule.to ?? 'package.json'} (no deps to add)`);
-        return { rule, action: 'noop', path: rule.to ?? 'package.json' };
-    }
-    const trailing = userText.endsWith('\n') ? '\n' : '';
-    node_fs_1.default.writeFileSync(userPath, JSON.stringify(userJson, null, 2) + trailing);
-    (0, logger_1.log)(logPrefix, `  ✓ ${rule.to ?? 'package.json'} (added ${added.length.toString()} dep(s)${missingInTpl.length > 0 ? `; ${missingInTpl.length.toString()} missing in template: ${missingInTpl.join(', ')}` : ''})`);
-    return {
-        rule,
-        action: 'patched',
-        path: rule.to ?? 'package.json',
-        detail: added.join(','),
-    };
-}
-/**
- * 按 dot path 删除嵌套对象里的一个 leaf key。返回是否真的删了一项。
- * 不支持包含 `.` 的字段名（实际 dep 名 / scripts 名不会含 `.`，够用）。
- */
-function deleteAtDotPath(obj, dotPath) {
-    const parts = dotPath.split('.');
-    let cursor = obj;
-    for (let i = 0; i < parts.length - 1; i++) {
-        const next = cursor[parts[i]];
-        if (next === undefined || next === null || typeof next !== 'object')
-            return false;
-        cursor = next;
-    }
-    const leaf = parts[parts.length - 1];
-    if (!Object.prototype.hasOwnProperty.call(cursor, leaf))
-        return false;
-    // 用 Reflect.deleteProperty 避开 eslint 对 `delete obj[computedKey]` 的禁用规则
-    return Reflect.deleteProperty(cursor, leaf);
-}