@lark-apaas/miaoda-cli 0.1.6 → 0.1.7-alpha.eb0aa5c

package/dist/utils/file-ops.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeLineFromFile = removeLineFromFile;
+exports.removeLineFromContent = removeLineFromContent;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const logger_1 = require("./logger");
+/**
+ * 从文件中移除匹配的行。
+ * 搬自 @lark-apaas/fullstack-cli/src/utils/file-ops.ts，行为完全对齐：精确匹配（trim 后）。
+ *
+ * @returns 是否真的移除过内容
+ */
+function removeLineFromFile(filePath, pattern, logPrefix = 'sync') {
+    if (!node_fs_1.default.existsSync(filePath)) {
+        (0, logger_1.log)(logPrefix, `  ○ ${node_path_1.default.basename(filePath)} (not found)`);
+        return false;
+    }
+    const content = node_fs_1.default.readFileSync(filePath, 'utf-8');
+    const trimmed = pattern.trim();
+    const lines = content.split('\n');
+    const filtered = lines.filter((line) => line.trim() !== trimmed);
+    if (filtered.length === lines.length) {
+        (0, logger_1.log)(logPrefix, `  ○ ${node_path_1.default.basename(filePath)} (pattern not found: ${pattern})`);
+        return false;
+    }
+    node_fs_1.default.writeFileSync(filePath, filtered.join('\n'));
+    (0, logger_1.log)(logPrefix, `  ✓ ${node_path_1.default.basename(filePath)} (removed: ${pattern})`);
+    return true;
+}
+/**
+ * 纯函数版本：便于单测，不读写文件。
+ */
+function removeLineFromContent(content, pattern) {
+    const trimmed = pattern.trim();
+    const lines = content.split('\n');
+    const filtered = lines.filter((line) => line.trim() !== trimmed);
+    return {
+        result: filtered.join('\n'),
+        changed: filtered.length !== lines.length,
+    };
+}

package/dist/utils/githooks.js

@@ -0,0 +1,55 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.activateGitHooks = activateGitHooks;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const logger_1 = require("../utils/logger");
+/**
+ * 把 `.githooks/` 注册为本仓库的 git hooks 目录，让 pre-commit 等 hook 立即生效。
+ *
+ * 三件事，都先检查再写（幂等）：
+ *   1. `.git` 存在（非 git 仓库直接跳）
+ *   2. `.githooks/pre-commit` 存在（没 hook 文件直接跳，且不写 git config 防止误指空目录）
+ *   3. `core.hooksPath` 是 `.githooks`（已经是就短路）
+ *
+ * 镜像 fullstack-cli `src/commands/sync/activate-hooks.ts`，逻辑保持一致；本地用户
+ * 通过 `miaoda app upgrade` 走的这一份，沙箱用户走 `npm run upgrade`（fullstack-cli sync）
+ * 那一份，两条通道结果应等价。
+ */
+function activateGitHooks(targetDir) {
+    if (!node_fs_1.default.existsSync(node_path_1.default.join(targetDir, '.git'))) {
+        return { action: 'skipped-no-git' };
+    }
+    const hookFile = node_path_1.default.join(targetDir, '.githooks', 'pre-commit');
+    if (!node_fs_1.default.existsSync(hookFile)) {
+        return { action: 'skipped-no-hook-file' };
+    }
+    // copyFileSync 不保留 mode，确保 +x（重要：没 +x 时 git 不会执行 hook）
+    const currentMode = node_fs_1.default.statSync(hookFile).mode & 0o777;
+    if ((currentMode & 0o111) !== 0o111) {
+        node_fs_1.default.chmodSync(hookFile, 0o755);
+    }
+    const probe = (0, node_child_process_1.spawnSync)('git', ['config', '--get', 'core.hooksPath'], {
+        cwd: targetDir,
+        stdio: ['ignore', 'pipe', 'ignore'],
+    });
+    const currentHooksPath = probe.stdout.toString().trim();
+    if (currentHooksPath === '.githooks') {
+        return { action: 'already-active' };
+    }
+    const res = (0, node_child_process_1.spawnSync)('git', ['config', 'core.hooksPath', '.githooks'], {
+        cwd: targetDir,
+        stdio: ['ignore', 'ignore', 'pipe'],
+    });
+    if (res.status !== 0) {
+        const stderr = res.stderr.toString().trim();
+        (0, logger_1.log)('githooks', `⚠️  failed to set core.hooksPath: ${stderr}`);
+        return { action: 'skipped-no-git' };
+    }
+    (0, logger_1.log)('githooks', `activated: core.hooksPath = .githooks`);
+    return { action: 'activated' };
+}

package/dist/utils/merge-json.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Deep merge JSON 对象，支持按 key 去重合并数组。
+ *
+ * 搬自 @lark-apaas/fullstack-cli/src/utils/merge-json.ts，行为完全对齐：
+ *   - scalar（string / number / boolean / null）：template 覆盖
+ *   - object：递归 merge（template 字段覆盖，user 多出的字段保留）
+ *   - 在 arrayMerge 配置里的 array：按指定 key 去重合并（template item 覆盖同 key 的 user item，
+ *     user 多出的 item 保留）
+ *   - 不在 arrayMerge 配置里的 array：template 覆盖
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepMergeJson = deepMergeJson;
+function isPlainObject(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function mergeArrayByKey(userArr, templateArr, key) {
+    const result = [...userArr];
+    for (const templateItem of templateArr) {
+        if (!isPlainObject(templateItem))
+            continue;
+        const templateKey = templateItem[key];
+        const existingIndex = result.findIndex((item) => isPlainObject(item) && item[key] === templateKey);
+        if (existingIndex >= 0) {
+            result[existingIndex] = templateItem;
+        }
+        else {
+            result.push(templateItem);
+        }
+    }
+    return result;
+}
+function deepMergeJson(user, template, arrayMerge = {}, currentPath = '') {
+    const result = { ...user };
+    for (const key of Object.keys(template)) {
+        const fullPath = currentPath ? `${currentPath}.${key}` : key;
+        const templateValue = template[key];
+        const userValue = user[key];
+        if (Array.isArray(templateValue)) {
+            const cfg = Object.prototype.hasOwnProperty.call(arrayMerge, fullPath)
+                ? arrayMerge[fullPath]
+                : undefined;
+            if (cfg !== undefined && Array.isArray(userValue)) {
+                result[key] = mergeArrayByKey(userValue, templateValue, cfg.key);
+            }
+            else {
+                result[key] = templateValue;
+            }
+        }
+        else if (isPlainObject(templateValue)) {
+            if (isPlainObject(userValue)) {
+                result[key] = deepMergeJson(userValue, templateValue, arrayMerge, fullPath);
+            }
+            else {
+                result[key] = templateValue;
+            }
+        }
+        else {
+            result[key] = templateValue;
+        }
+    }
+    return result;
+}

package/dist/utils/platform-sync.js

@@ -0,0 +1,160 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncPlatformControlled = syncPlatformControlled;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const jsonc = __importStar(require("jsonc-parser"));
+const logger_1 = require("../utils/logger");
+function syncPlatformControlled(opts) {
+    const logPrefix = opts.logPrefix ?? 'app-sync';
+    const cliRoot = opts.cliRoot ?? resolveCliRoot();
+    const stackDir = node_path_1.default.join(cliRoot, 'upgrade', 'templates', opts.stack);
+    if (!node_fs_1.default.existsSync(stackDir)) {
+        return { stackFound: false, syncedFiles: [], mergedJsonFiles: [] };
+    }
+    (0, logger_1.log)(logPrefix, `Syncing upgrade/templates/${opts.stack}/ → ${opts.targetDir}`);
+    const syncedFiles = syncFilesDir(node_path_1.default.join(stackDir, 'files'), opts.targetDir, logPrefix);
+    const mergedJsonFiles = applyJsonPatches(node_path_1.default.join(stackDir, 'patches'), opts.targetDir, logPrefix);
+    return {
+        stackFound: true,
+        syncedFiles,
+        mergedJsonFiles,
+    };
+}
+/** 推断 cli 安装根:dist/utils/platform-sync.js 上溯两级即仓根 */
+function resolveCliRoot() {
+    return node_path_1.default.resolve(__dirname, '..', '..');
+}
+/** 递归同步 srcDir 下所有文件到 destDir,保持相对路径;.sh 文件 +x。返回 dest 相对路径列表 */
+function syncFilesDir(srcDir, destDir, logPrefix) {
+    if (!node_fs_1.default.existsSync(srcDir))
+        return [];
+    const synced = [];
+    walk(srcDir, srcDir, destDir, (rel, srcPath, destPath) => {
+        node_fs_1.default.mkdirSync(node_path_1.default.dirname(destPath), { recursive: true });
+        node_fs_1.default.copyFileSync(srcPath, destPath);
+        if (rel.endsWith('.sh')) {
+            node_fs_1.default.chmodSync(destPath, 0o755);
+        }
+        synced.push(rel);
+        (0, logger_1.log)(logPrefix, `  + ${rel}`);
+    });
+    return synced;
+}
+/** 递归遍历 patchesDir 下每个 JSON 文件,deep merge 到 destDir 对应路径 */
+function applyJsonPatches(patchesDir, destDir, logPrefix) {
+    if (!node_fs_1.default.existsSync(patchesDir))
+        return [];
+    const merged = [];
+    walk(patchesDir, patchesDir, destDir, (rel, patchPath, destPath) => {
+        if (!rel.endsWith('.json')) {
+            (0, logger_1.log)(logPrefix, `  (skip non-json patch: ${rel})`);
+            return;
+        }
+        if (!node_fs_1.default.existsSync(destPath)) {
+            throw new Error(`[${logPrefix}] target JSON not found: ${destPath} ` +
+                `(patches/${rel} 要求项目根含同路径文件;app init 应该先创建它)`);
+        }
+        const patch = readJson(patchPath);
+        const target = readJson(destPath);
+        if (!isPlainObject(patch) || !isPlainObject(target)) {
+            throw new Error(`[${logPrefix}] patch 与 target 必须都是 JSON object: ${rel}`);
+        }
+        const changed = [];
+        for (const key of Object.keys(patch)) {
+            const before = JSON.stringify(target[key]);
+            target[key] = deepMerge(target[key], patch[key]);
+            const after = JSON.stringify(target[key]);
+            if (before !== after)
+                changed.push(key);
+        }
+        if (changed.length > 0) {
+            node_fs_1.default.writeFileSync(destPath, JSON.stringify(target, null, 2) + '\n', 'utf-8');
+            merged.push({ path: rel, keys: changed });
+            (0, logger_1.log)(logPrefix, `  ~ ${rel} (keys: ${changed.join(', ')})`);
+        }
+        else {
+            (0, logger_1.log)(logPrefix, `  = ${rel} (unchanged)`);
+        }
+    });
+    return merged;
+}
+/** 通用递归遍历:对 rootSrc 下每个文件调 visit(rel, srcAbsPath, destAbsPath) */
+function walk(rootSrc, curSrc, destDir, visit) {
+    for (const name of node_fs_1.default.readdirSync(curSrc)) {
+        const srcPath = node_path_1.default.join(curSrc, name);
+        const stat = node_fs_1.default.statSync(srcPath);
+        if (stat.isDirectory()) {
+            walk(rootSrc, srcPath, destDir, visit);
+            continue;
+        }
+        const rel = node_path_1.default.relative(rootSrc, srcPath);
+        const destPath = node_path_1.default.join(destDir, rel);
+        visit(rel, srcPath, destPath);
+    }
+}
+function readJson(filePath) {
+    // 用 jsonc 解析以兼容 tsconfig*/nest-cli.json 等允许注释和 trailing comma 的配置；
+    // 我们仓自带的 patches/*.json 是严格 JSON，jsonc 也读得通。
+    // 写回时仍走 JSON.stringify，注释和 trailing comma 会丢——user app 的 tsconfig 经过
+    // 一次 deep merge 后会变成严格 JSON，可接受（tsc 同样读得动）。
+    const text = node_fs_1.default.readFileSync(filePath, 'utf-8');
+    const errors = [];
+    const parsed = jsonc.parse(text, errors, { allowTrailingComma: true });
+    if (errors.length > 0) {
+        const first = errors[0];
+        const code = jsonc.printParseErrorCode(first.error);
+        throw new Error(`${filePath}: jsonc parse error ${code} at offset ${String(first.offset)}`);
+    }
+    return parsed;
+}
+function isPlainObject(v) {
+    return typeof v === 'object' && v !== null && !Array.isArray(v);
+}
+/** value 是 object 时递归 merge,其它(包括数组)直接以 patch 覆盖 */
+function deepMerge(target, patch) {
+    if (isPlainObject(patch) && isPlainObject(target)) {
+        const merged = { ...target };
+        for (const k of Object.keys(patch)) {
+            merged[k] = deepMerge(target[k], patch[k]);
+        }
+        return merged;
+    }
+    return patch;
+}

package/dist/utils/sync-rule.js

@@ -0,0 +1,295 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.applySyncRules = applySyncRules;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const jsonc = __importStar(require("jsonc-parser"));
+const file_ops_1 = require("./file-ops");
+const merge_json_1 = require("./merge-json");
+const logger_1 = require("./logger");
+/**
+ * 顺序执行 SyncRule[]，逐条 apply。一条 rule 报错不影响后续 rule（catch + 记录），最终
+ * 在 handler 层决定是否整体 fail。
+ */
+function applySyncRules(rules, opts) {
+    const results = [];
+    for (const rule of rules) {
+        results.push(applyOne(rule, opts));
+    }
+    return results;
+}
+function applyOne(rule, opts) {
+    const { sourceRoot, targetDir } = opts;
+    const logPrefix = opts.logPrefix ?? 'sync';
+    switch (rule.type) {
+        case 'delete-file': {
+            const dest = node_path_1.default.join(targetDir, rule.to);
+            if (!node_fs_1.default.existsSync(dest)) {
+                (0, logger_1.log)(logPrefix, `  ○ ${rule.to} (not found, skip delete)`);
+                return { rule, action: 'noop', path: rule.to };
+            }
+            node_fs_1.default.unlinkSync(dest);
+            (0, logger_1.log)(logPrefix, `  ✗ ${rule.to} (deleted)`);
+            return { rule, action: 'deleted', path: rule.to };
+        }
+        case 'delete-directory': {
+            const dest = node_path_1.default.join(targetDir, rule.to);
+            if (!node_fs_1.default.existsSync(dest)) {
+                (0, logger_1.log)(logPrefix, `  ○ ${rule.to} (not found, skip delete)`);
+                return { rule, action: 'noop', path: rule.to };
+            }
+            node_fs_1.default.rmSync(dest, { recursive: true });
+            (0, logger_1.log)(logPrefix, `  ✗ ${rule.to} (deleted)`);
+            return { rule, action: 'deleted', path: rule.to };
+        }
+        case 'remove-line': {
+            const dest = node_path_1.default.join(targetDir, rule.to);
+            const changed = (0, file_ops_1.removeLineFromFile)(dest, rule.pattern, logPrefix);
+            return { rule, action: changed ? 'patched' : 'noop', path: rule.to };
+        }
+        case 'add-line': {
+            const dest = node_path_1.default.join(targetDir, rule.to);
+            if (!node_fs_1.default.existsSync(dest)) {
+                (0, logger_1.log)(logPrefix, `  ○ ${rule.to} (not found, skip add-line)`);
+                return { rule, action: 'skipped', path: rule.to };
+            }
+            const content = node_fs_1.default.readFileSync(dest, 'utf-8');
+            const lines = content.split('\n').map((l) => l.trim());
+            if (lines.includes(rule.line)) {
+                (0, logger_1.log)(logPrefix, `  ○ ${rule.to} (line already present: ${rule.line})`);
+                return { rule, action: 'noop', path: rule.to };
+            }
+            const sep = content.endsWith('\n') ? '' : '\n';
+            node_fs_1.default.appendFileSync(dest, `${sep}${rule.line}\n`);
+            (0, logger_1.log)(logPrefix, `  ✓ ${rule.to} (added: ${rule.line})`);
+            return { rule, action: 'patched', path: rule.to };
+        }
+        case 'add-script': {
+            return applyAddScript(rule, targetDir, logPrefix);
+        }
+        case 'patch-script': {
+            return applyPatchScript(rule, targetDir, logPrefix);
+        }
+        case 'merge-json': {
+            return applyMergeJson(rule, sourceRoot, targetDir, logPrefix);
+        }
+        case 'directory': {
+            const src = node_path_1.default.join(sourceRoot, rule.from);
+            const dest = node_path_1.default.join(targetDir, rule.to);
+            if (!node_fs_1.default.existsSync(src)) {
+                (0, logger_1.log)(logPrefix, `  ⚠ source not found: ${rule.from}`);
+                return { rule, action: 'skipped', path: rule.to };
+            }
+            const count = syncDirectory(src, dest, rule.overwrite ?? true);
+            if (count === 0) {
+                (0, logger_1.log)(logPrefix, `  ○ ${rule.to}/ (no new files)`);
+                return { rule, action: 'noop', path: rule.to };
+            }
+            (0, logger_1.log)(logPrefix, `  ✓ ${rule.to}/ (synced ${count.toString()} file(s))`);
+            return { rule, action: 'synced', path: rule.to, detail: `${count.toString()} file(s)` };
+        }
+        case 'file': {
+            const src = node_path_1.default.join(sourceRoot, rule.from);
+            const dest = node_path_1.default.join(targetDir, rule.to);
+            if (!node_fs_1.default.existsSync(src)) {
+                (0, logger_1.log)(logPrefix, `  ⚠ source not found: ${rule.from}`);
+                return { rule, action: 'skipped', path: rule.to };
+            }
+            const onlyIfExists = rule.onlyIfExists ?? false;
+            const overwrite = rule.overwrite ?? true;
+            if (onlyIfExists && !node_fs_1.default.existsSync(dest)) {
+                (0, logger_1.log)(logPrefix, `  ○ ${rule.to} (skipped, target not exists)`);
+                return { rule, action: 'skipped', path: rule.to };
+            }
+            if (node_fs_1.default.existsSync(dest) && !overwrite) {
+                (0, logger_1.log)(logPrefix, `  ○ ${rule.to} (skipped, already exists)`);
+                return { rule, action: 'skipped', path: rule.to };
+            }
+            const destDir = node_path_1.default.dirname(dest);
+            if (!node_fs_1.default.existsSync(destDir)) {
+                node_fs_1.default.mkdirSync(destDir, { recursive: true });
+            }
+            node_fs_1.default.copyFileSync(src, dest);
+            (0, logger_1.log)(logPrefix, `  ✓ ${rule.to}`);
+            return { rule, action: 'synced', path: rule.to };
+        }
+        case 'append': {
+            const src = node_path_1.default.join(sourceRoot, rule.from);
+            const dest = node_path_1.default.join(targetDir, rule.to);
+            if (!node_fs_1.default.existsSync(src)) {
+                (0, logger_1.log)(logPrefix, `  ⚠ source not found: ${rule.from}`);
+                return { rule, action: 'skipped', path: rule.to };
+            }
+            const content = node_fs_1.default.readFileSync(src, 'utf-8');
+            const existing = node_fs_1.default.existsSync(dest) ? node_fs_1.default.readFileSync(dest, 'utf-8') : '';
+            if (existing.includes(content.trim())) {
+                (0, logger_1.log)(logPrefix, `  ○ ${rule.to} (already contains content)`);
+                return { rule, action: 'noop', path: rule.to };
+            }
+            node_fs_1.default.appendFileSync(dest, content);
+            (0, logger_1.log)(logPrefix, `  ✓ ${rule.to} (appended)`);
+            return { rule, action: 'appended', path: rule.to };
+        }
+    }
+}
+function readPkgJson(pkgPath) {
+    if (!node_fs_1.default.existsSync(pkgPath))
+        return null;
+    return JSON.parse(node_fs_1.default.readFileSync(pkgPath, 'utf-8'));
+}
+function writePkgJson(pkgPath, pkg) {
+    node_fs_1.default.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
+}
+function applyAddScript(rule, targetDir, logPrefix) {
+    const pkgPath = node_path_1.default.join(targetDir, 'package.json');
+    const pkg = readPkgJson(pkgPath);
+    if (!pkg) {
+        (0, logger_1.log)(logPrefix, `  ⚠ package.json not found, skip add-script ${rule.name}`);
+        return { rule, action: 'skipped', path: 'package.json' };
+    }
+    pkg.scripts ??= {};
+    const overwrite = rule.overwrite ?? false;
+    const has = Object.prototype.hasOwnProperty.call(pkg.scripts, rule.name);
+    if (has && !overwrite) {
+        (0, logger_1.log)(logPrefix, `  ○ scripts.${rule.name} (already exists)`);
+        return { rule, action: 'skipped', path: 'package.json' };
+    }
+    if (pkg.scripts[rule.name] === rule.command) {
+        (0, logger_1.log)(logPrefix, `  ○ scripts.${rule.name} (already set)`);
+        return { rule, action: 'noop', path: 'package.json' };
+    }
+    pkg.scripts[rule.name] = rule.command;
+    writePkgJson(pkgPath, pkg);
+    (0, logger_1.log)(logPrefix, `  ✓ scripts.${rule.name}`);
+    return { rule, action: 'created', path: 'package.json', detail: rule.name };
+}
+function applyPatchScript(rule, targetDir, logPrefix) {
+    const pkgPath = node_path_1.default.join(targetDir, 'package.json');
+    const pkg = readPkgJson(pkgPath);
+    if (!pkg) {
+        (0, logger_1.log)(logPrefix, `  ⚠ package.json not found, skip patch-script ${rule.name}`);
+        return { rule, action: 'skipped', path: 'package.json' };
+    }
+    const current = pkg.scripts?.[rule.name];
+    if (current === undefined) {
+        (0, logger_1.log)(logPrefix, `  ○ scripts.${rule.name} (not present, skip patch)`);
+        return { rule, action: 'skipped', path: 'package.json' };
+    }
+    if (current === rule.to) {
+        (0, logger_1.log)(logPrefix, `  ○ scripts.${rule.name} (already patched)`);
+        return { rule, action: 'noop', path: 'package.json' };
+    }
+    if (!current.startsWith(rule.ifStartsWith)) {
+        (0, logger_1.log)(logPrefix, `  ⚠ scripts.${rule.name} customized, skip patch`);
+        return { rule, action: 'skipped', path: 'package.json' };
+    }
+    pkg.scripts ??= {};
+    pkg.scripts[rule.name] = rule.to;
+    writePkgJson(pkgPath, pkg);
+    (0, logger_1.log)(logPrefix, `  ✓ scripts.${rule.name} (patched)`);
+    return { rule, action: 'patched', path: 'package.json', detail: rule.name };
+}
+function applyMergeJson(rule, sourceRoot, targetDir, logPrefix) {
+    const src = node_path_1.default.join(sourceRoot, rule.from);
+    const dest = node_path_1.default.join(targetDir, rule.to);
+    if (!node_fs_1.default.existsSync(src)) {
+        (0, logger_1.log)(logPrefix, `  ⚠ source not found: ${rule.from}`);
+        return { rule, action: 'skipped', path: rule.to };
+    }
+    const templateContent = JSON.parse(node_fs_1.default.readFileSync(src, 'utf-8'));
+    if (!node_fs_1.default.existsSync(dest)) {
+        const destDir = node_path_1.default.dirname(dest);
+        if (!node_fs_1.default.existsSync(destDir))
+            node_fs_1.default.mkdirSync(destDir, { recursive: true });
+        node_fs_1.default.writeFileSync(dest, `${JSON.stringify(templateContent, null, 2)}\n`);
+        (0, logger_1.log)(logPrefix, `  ✓ ${rule.to} (created from template)`);
+        return { rule, action: 'created', path: rule.to };
+    }
+    // 用户项目里的 JSON 可能是 jsonc（tsconfig*、nest-cli.json 都允许 trailing comma / 注释）。
+    // 这里读取走 jsonc-parser，写回继续标准 JSON.stringify。
+    const userRaw = node_fs_1.default.readFileSync(dest, 'utf-8');
+    const userContent = parseUserJson(userRaw);
+    const merged = (0, merge_json_1.deepMergeJson)(userContent, templateContent, rule.arrayMerge ?? {});
+    const userStr = JSON.stringify(userContent, null, 2);
+    const mergedStr = JSON.stringify(merged, null, 2);
+    if (userStr === mergedStr) {
+        (0, logger_1.log)(logPrefix, `  ○ ${rule.to} (already up to date)`);
+        return { rule, action: 'noop', path: rule.to };
+    }
+    node_fs_1.default.writeFileSync(dest, `${mergedStr}\n`);
+    const keys = Object.keys(templateContent).join(',');
+    (0, logger_1.log)(logPrefix, `  ✓ ${rule.to} (merged: ${keys})`);
+    return { rule, action: 'merged', path: rule.to, detail: keys };
+}
+/**
+ * 用 jsonc-parser 读 user 端 JSON 文件，兼容 tsconfig/nest-cli.json 等带 trailing comma 或
+ * 注释的配置。模板侧严格 JSON 走 JSON.parse 也能通，统一走 jsonc 简化代码。
+ */
+function parseUserJson(text) {
+    const errors = [];
+    const parsed = jsonc.parse(text, errors, { allowTrailingComma: true });
+    if (errors.length > 0) {
+        const first = errors[0];
+        throw new Error(`jsonc parse error ${jsonc.printParseErrorCode(first.error)} at offset ${String(first.offset)}`);
+    }
+    return parsed;
+}
+function syncDirectory(src, dest, overwrite) {
+    if (!node_fs_1.default.existsSync(dest)) {
+        node_fs_1.default.mkdirSync(dest, { recursive: true });
+    }
+    let count = 0;
+    for (const file of node_fs_1.default.readdirSync(src)) {
+        const srcChild = node_path_1.default.join(src, file);
+        const destChild = node_path_1.default.join(dest, file);
+        const stat = node_fs_1.default.statSync(srcChild);
+        if (stat.isDirectory()) {
+            count += syncDirectory(srcChild, destChild, overwrite);
+        }
+        else if (overwrite || !node_fs_1.default.existsSync(destChild)) {
+            node_fs_1.default.copyFileSync(srcChild, destChild);
+            // .sh 自动 +x
+            if (destChild.endsWith('.sh')) {
+                node_fs_1.default.chmodSync(destChild, 0o755);
+            }
+            count++;
+        }
+    }
+    return count;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.6",
+  "version": "0.1.7-alpha.eb0aa5c",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {
@@ -10,10 +10,11 @@
     "access": "public"
   },
   "files": [
+    "LICENSE",
+    "README.md",
     "bin",
     "dist",
-    "README.md",
-    "LICENSE"
+    "upgrade"
   ],
   "keywords": [
     "miaoda",
@@ -27,6 +28,7 @@
   "dependencies": {
     "@lark-apaas/http-client": "^0.1.5",
     "commander": "^13.1.0",
+    "jsonc-parser": "^3.3.1",
     "ora": "^5.4.1",
     "picocolors": "^1.1.1"
   },