@lark-apaas/miaoda-cli 0.1.46 → 0.1.47

package/dist/services/app/migrate/symlinks.js

@@ -0,0 +1,146 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writePathSymlinkConflicts = writePathSymlinkConflicts;
+exports.migrationWritePaths = migrationWritePaths;
+exports.migrationSymlinkConflicts = migrationSymlinkConflicts;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const project_snapshot_1 = require("../../../utils/project-snapshot");
+function rulePaths(rule) {
+    switch (rule.type) {
+        case 'set-stack':
+            return ['.spark/meta.json'];
+        case 'add-script':
+        case 'patch-script':
+        case 'ensure-dependency':
+            return ['package.json'];
+        case 'codemod-client-toolkit-lite':
+            return [rule.root ?? 'client/src'];
+        case 'codemod-vite-config-fullstack':
+            return [rule.to ?? 'vite.config.ts'];
+        case 'add-deps-from-template':
+        case 'ensure-scripts':
+            return [rule.to ?? 'package.json'];
+        case 'adapt-nest-app-module':
+            return [rule.to ?? 'server/app.module.ts', rule.checkMain ?? 'server/main.ts'];
+        case 'move-directory':
+        case 'move-file':
+        case 'move-capabilities':
+        case 'adapt-html-entry':
+            return [rule.from, rule.to];
+        default:
+            return [rule.to];
+    }
+}
+function overlaps(first, second) {
+    return (first === '.' ||
+        second === '.' ||
+        first === second ||
+        first.startsWith(`${second}/`) ||
+        second.startsWith(`${first}/`));
+}
+function writePathSymlinkConflicts(root, writePaths) {
+    const links = new Set();
+    for (const rel of writePaths) {
+        const parts = rel.split('/');
+        for (let count = 1; count <= parts.length; count++) {
+            const parent = parts.slice(0, count).join('/');
+            try {
+                if (node_fs_1.default.lstatSync(node_path_1.default.join(root, parent)).isSymbolicLink()) {
+                    links.add(parent);
+                    break;
+                }
+            }
+            catch (err) {
+                if (err.code !== 'ENOENT')
+                    throw err;
+                break;
+            }
+        }
+    }
+    return [...links].sort().map((rel) => ({
+        path: rel,
+        reason: 'symlink intersects a migration write path; replace it with a project-owned file or directory',
+    }));
+}
+function migrationWritePaths(rules, mode) {
+    return [
+        '.spark/meta.json',
+        '.spark/local',
+        'package.json',
+        'package-lock.json',
+        'node_modules',
+        ...rules.filter((rule) => mode !== 'repair' || rule.migrateOnly !== true).flatMap(rulePaths),
+    ];
+}
+function migrationSymlinkConflicts(root, writePaths, installed = false) {
+    const writeConflicts = writePathSymlinkConflicts(root, writePaths);
+    if (writeConflicts.length > 0)
+        return writeConflicts;
+    const links = new Set();
+    const pending = [''];
+    while (pending.length > 0) {
+        const directory = pending.pop() ?? '';
+        for (const name of node_fs_1.default.readdirSync(node_path_1.default.join(root, directory))) {
+            const rel = directory === '' ? name : `${directory}/${name}`;
+            if ((0, project_snapshot_1.isExcludedPath)(rel) &&
+                !(installed && (rel === 'node_modules' || rel.startsWith('node_modules/')))) {
+                continue;
+            }
+            const stat = node_fs_1.default.lstatSync(node_path_1.default.join(root, rel));
+            if (stat.isSymbolicLink()) {
+                links.add(rel);
+            }
+            else if (stat.isDirectory()) {
+                pending.push(rel);
+            }
+        }
+    }
+    return [...links].sort().flatMap((rel) => {
+        const link = node_fs_1.default.readlinkSync(node_path_1.default.join(root, rel));
+        if (writePaths.some((writePath) => overlaps(rel, writePath)) &&
+            !(installed && rel.startsWith('node_modules/'))) {
+            return [
+                {
+                    path: rel,
+                    reason: 'symlink intersects a migration write path; replace it with a project-owned file or directory',
+                },
+            ];
+        }
+        if (node_path_1.default.isAbsolute(link)) {
+            return [
+                {
+                    path: rel,
+                    reason: 'absolute symlink would let in-place install/build reach outside the project',
+                },
+            ];
+        }
+        try {
+            const resolved = node_fs_1.default.realpathSync(node_path_1.default.join(root, rel));
+            const target = node_path_1.default.relative(node_fs_1.default.realpathSync(root), resolved).split(node_path_1.default.sep).join('/');
+            const parts = target.split('/');
+            const excluded = !(installed && target.startsWith('node_modules/')) &&
+                parts.some((_, index) => (0, project_snapshot_1.isExcludedPath)(parts.slice(0, index + 1).join('/')));
+            if (target === '..' || target.startsWith('../') || node_path_1.default.isAbsolute(target) || excluded) {
+                return [
+                    {
+                        path: rel,
+                        reason: 'symlink target is outside the project or in an excluded directory; in-place install/build could escape',
+                    },
+                ];
+            }
+        }
+        catch {
+            return [
+                {
+                    path: rel,
+                    reason: 'symlink target cannot be resolved safely for in-place install/build',
+                },
+            ];
+        }
+        return [];
+    });
+}

package/dist/utils/engineering-state.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * 工程操作的本地执行记录（.spark/local/engineering-state.json）。
+ *
+ * 为什么不写进 .spark/meta.json：meta.json 随 Git 提交，而依赖是否装好、上次迁移停在哪个阶段
+ * 是本机/本沙箱的事实，不能跟着代码传播到别的副本。.spark/local/ 目录自带 `.gitignore`（`*`），
+ * 整个目录不进 Git。
+ *
+ * 用途：
+ *   - init --strict 判断工程是否真正就绪（上次安装失败 / 迁移未完成不能凭 meta 存在放行）
+ *   - migrate 重试时核对上一次执行（源/目标、停在哪个阶段）
+ * 这是执行记录，不是平台状态源；平台权威结果仍由调用方读回。
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOCAL_STATE_DIR = void 0;
+exports.readEngineeringState = readEngineeringState;
+exports.writeEngineeringState = writeEngineeringState;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+exports.LOCAL_STATE_DIR = node_path_1.default.join('.spark', 'local');
+const STATE_FILE = 'engineering-state.json';
+function ensureLocalDir(appDir) {
+    const dir = node_path_1.default.join(appDir, exports.LOCAL_STATE_DIR);
+    node_fs_1.default.mkdirSync(dir, { recursive: true });
+    const ignore = node_path_1.default.join(dir, '.gitignore');
+    if (!node_fs_1.default.existsSync(ignore))
+        node_fs_1.default.writeFileSync(ignore, '*\n', 'utf-8');
+    return dir;
+}
+function readEngineeringState(appDir) {
+    const file = node_path_1.default.join(appDir, exports.LOCAL_STATE_DIR, STATE_FILE);
+    if (!node_fs_1.default.existsSync(file))
+        return undefined;
+    try {
+        return JSON.parse(node_fs_1.default.readFileSync(file, 'utf-8'));
+    }
+    catch {
+        // 本地执行记录损坏只影响诊断，不影响工程本身；按"无记录"处理并由调用方重新校验
+        return undefined;
+    }
+}
+function writeEngineeringState(appDir, state) {
+    const dir = ensureLocalDir(appDir);
+    const file = node_path_1.default.join(dir, STATE_FILE);
+    const tmp = `${file}.${process.pid.toString()}.tmp`;
+    const payload = { ...state, updatedAt: new Date().toISOString() };
+    node_fs_1.default.writeFileSync(tmp, JSON.stringify(payload, null, 2) + '\n', 'utf-8');
+    node_fs_1.default.renameSync(tmp, file);
+}