@lark-apaas/miaoda-cli 0.1.4 → 0.1.5-alpha.2f1e0ff

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

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * 按 stack 短名拿到对应的 SyncConfig + 模板源根目录。
+ *
+ * - 类型化的 SyncConfig 放在 src/config/sync-configs/<stack>.ts（被 tsc 编进 dist 一起发）。
+ * - 模板资源文件放在 upgrade/templates/<stack>/templates/（cli 发布时整个目录原样 ship）。
+ *
+ * handler 拿到 stack 后，先 getSyncConfig 拿 rule 列表，再 getStackTemplatesRoot 拿模板根，
+ * 一起喂给 applySyncRules。
+ *
+ * 新加 stack：
+ *   1. src/config/sync-configs/<stack>.ts 里 export default SYNC_CONFIG
+ *   2. upgrade/templates/<stack>/templates/ 下放对应资源文件
+ *   3. 在 STACK_REGISTRY 里加一条
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSyncConfig = getSyncConfig;
+exports.getStackTemplatesRoot = getStackTemplatesRoot;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const nestjs_react_fullstack_1 = __importDefault(require("./nestjs-react-fullstack"));
+const design_stack_1 = __importDefault(require("./design-stack"));
+/**
+ * 已纳入新 sync 机制的 stack 注册表。未在表里的 stack（如老 vite-react / html）走旧的
+ * `upgrade/templates/<stack>/{files,patches}` 机制，由 sync handler 兜底。
+ */
+const STACK_REGISTRY = {
+    'nestjs-react-fullstack': nestjs_react_fullstack_1.default,
+    'design-stack': design_stack_1.default,
+};
+/** 返回该 stack 的 SyncConfig；表里没有时返回 null。 */
+function getSyncConfig(stack) {
+    return STACK_REGISTRY[stack] ?? null;
+}
+/**
+ * 计算 stack 模板资源根目录（绝对路径）。
+ *
+ * cli 发布时 upgrade/ 目录整个 ship，编译产物在 dist/ 下若干层。从当前模块向上回溯找含
+ * upgrade/ + package.json 的目录就是 cli 根。
+ *
+ * 跟 utils/platform-sync.ts 同款 pattern；保持对齐避免两边漂移。
+ */
+function getStackTemplatesRoot(stack) {
+    return node_path_1.default.join(findCliRoot(), 'upgrade', 'templates', stack, 'templates');
+}
+let cliRootCache = null;
+function findCliRoot() {
+    if (cliRootCache !== null)
+        return cliRootCache;
+    let dir = __dirname;
+    while (dir !== node_path_1.default.dirname(dir)) {
+        if (node_fs_1.default.existsSync(node_path_1.default.join(dir, 'upgrade')) && node_fs_1.default.existsSync(node_path_1.default.join(dir, 'package.json'))) {
+            cliRootCache = dir;
+            return dir;
+        }
+        dir = node_path_1.default.dirname(dir);
+    }
+    throw new Error(`miaoda-cli root (containing upgrade/) not found from ${__dirname}`);
+}

package/dist/config/sync-configs/nestjs-react-fullstack.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * nestjs-react-fullstack stack 的 sync 规则。
+ *
+ * 跟沙箱里 `npm run upgrade → npx fullstack-cli sync --disable-gen-openapi` 行为对齐
+ * （fullstack-cli/src/config/sync.ts），新增的 miaoda-cli 本地开发规则单独标注。
+ *
+ * 改这里请同步把 user app 端到端 smoke 跑一次（init → sync → npm run dev）。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SYNC_CONFIG = void 0;
+const fullstack_cli_pin_1 = require("../../config/fullstack-cli-pin");
+exports.SYNC_CONFIG = {
+    sync: [
+        // ===== fullstack-cli sync 同款规则（对齐沙箱行为） =====
+        // 1. 派生 scripts 目录（包含 dev.sh / dev-local.sh / dev.js / build.sh / run.sh /
+        //    lint.js / prune-smart.js / hooks/run-precommit.js；directory rule 自动给 .sh +x）
+        {
+            type: 'directory',
+            from: 'scripts',
+            to: 'scripts',
+            overwrite: true,
+        },
+        // 1a. 同步 .githooks 目录（hook 入口，可执行 sh 脚本）
+        {
+            type: 'directory',
+            from: '.githooks',
+            to: '.githooks',
+            overwrite: true,
+        },
+        // 1b. scripts.prepare：npm install 后自动激活 git hooks（原生 git，无第三方依赖）
+        //     直接写 core.hooksPath，并保底给 pre-commit 加执行位；非 git 仓库下静默退出
+        {
+            type: 'add-script',
+            name: 'prepare',
+            command: 'chmod +x .githooks/pre-commit 2>/dev/null; git config core.hooksPath .githooks 2>/dev/null || true',
+            overwrite: false,
+        },
+        // 1c. scripts.precommit = pre-commit 真正的执行体（跑 npm run lint）
+        {
+            type: 'add-script',
+            name: 'precommit',
+            command: 'node scripts/hooks/run-precommit.js',
+            overwrite: false,
+        },
+        // 2. 智能合并 nest-cli.json 配置（保留用户自定义的 assets、plugins 等）
+        {
+            type: 'merge-json',
+            from: 'nest-cli.json',
+            to: 'nest-cli.json',
+            arrayMerge: {
+                'compilerOptions.assets': { key: 'include' },
+                'compilerOptions.plugins': { key: 'name' },
+            },
+        },
+        // 3. 删除 .swc 缓存目录（如果存在）
+        {
+            type: 'delete-directory',
+            to: '.swc',
+        },
+        // 4. 从 .gitignore 中移除 package-lock.json
+        {
+            type: 'remove-line',
+            to: '.gitignore',
+            pattern: 'package-lock.json',
+        },
+        // 5. 注册 postinstall 脚本，自动恢复 action plugins。
+        //    用 npx -y 形式而不是裸 fullstack-cli：用户项目的 deps 没有 fullstack-cli，
+        //    bare 形式在新机器（PATH 没全局 fullstack-cli）下 npm i 立即 ENOENT。
+        //    fullstack-cli 版本临时钉到 FULLSTACK_CLI_PIN_SPEC，避免 npx 走 latest 碰外部回归版本。
+        {
+            type: 'add-script',
+            name: 'postinstall',
+            command: `npx -y ${fullstack_cli_pin_1.FULLSTACK_CLI_PIN_SPEC} action-plugin init`,
+            overwrite: false,
+        },
+        // 5a. 迁移已有应用的老形式 postinstall（裸 fullstack-cli → npx -y 钉版）。
+        //     patch-script 只在脚本以指定前缀开头时改写，用户真正手改过的脚本保持原样。
+        {
+            type: 'patch-script',
+            name: 'postinstall',
+            to: `npx -y ${fullstack_cli_pin_1.FULLSTACK_CLI_PIN_SPEC} action-plugin init`,
+            ifStartsWith: 'fullstack-cli action-plugin init',
+        },
+        // 5b. 迁移已有应用 npx 未钉版的 postinstall —— sync 之前的版本生成的是
+        //     `npx -y @lark-apaas/fullstack-cli action-plugin init`（无版本号），现在统一钉版。
+        {
+            type: 'patch-script',
+            name: 'postinstall',
+            to: `npx -y ${fullstack_cli_pin_1.FULLSTACK_CLI_PIN_SPEC} action-plugin init`,
+            ifStartsWith: 'npx -y @lark-apaas/fullstack-cli action-plugin init',
+        },
+        // 5c. gen:db-schema —— 把裸 `fullstack-cli gen-db-schema` 迁到钉版 npx。
+        //     这条只在 user app 自己 package.json 已经有 gen:db-schema 时才动（patch-script
+        //     语义），新模板里如果有就一并升级。
+        {
+            type: 'patch-script',
+            name: 'gen:db-schema',
+            to: `npx -y ${fullstack_cli_pin_1.FULLSTACK_CLI_PIN_SPEC} gen-db-schema`,
+            ifStartsWith: 'fullstack-cli gen-db-schema',
+        },
+        // 6. 替换 drizzle.config.ts（仅当文件存在时）
+        {
+            type: 'file',
+            from: 'drizzle.config.ts',
+            to: 'drizzle.config.ts',
+            overwrite: true,
+            onlyIfExists: true,
+        },
+        // 7. 确保 .gitignore 包含 .agent/ 目录
+        {
+            type: 'add-line',
+            to: '.gitignore',
+            line: '.agent/',
+        },
+        // 8. 同步 .spark_project 配置文件（总是覆盖）
+        {
+            type: 'file',
+            from: '.spark_project',
+            to: '.spark_project',
+            overwrite: true,
+        },
+        // 9. 把模板版本的 lint 脚本替换为支持 --files 的 runner
+        //    只识别平台模板生成的 `concurrently ...` 形态，用户真正改写过的脚本保持原样
+        {
+            type: 'patch-script',
+            name: 'lint',
+            to: 'node ./scripts/lint.js',
+            ifStartsWith: 'concurrently ',
+        },
+        // 10. 把老 `npm run upgrade && ./scripts/dev.sh` 形式迁移到 `./scripts/dev.sh`，
+        //     让本地 `npm run dev` 不再前置跑 fullstack-cli sync。新版 dev.sh 按 SANDBOX_ID 是否非空
+        //     判分支：沙箱直接 exec dev.js（脚本同步由平台 pod 启动时做过，dev 入口不再 upgrade）；
+        //     本地走 miaoda app sync 兜底 + dev-local.sh。
+        {
+            type: 'patch-script',
+            name: 'dev',
+            to: './scripts/dev.sh',
+            ifStartsWith: 'npm run upgrade && ',
+        },
+        // 11. 把 `upgrade` 脚本里裸 `fullstack-cli sync` 改成钉版 npx。
+        //     跟 postinstall 同款根因：fullstack-cli 不是用户应用的 dep，新机器无全局命令会 ENOENT。
+        {
+            type: 'patch-script',
+            name: 'upgrade',
+            to: `npx -y ${fullstack_cli_pin_1.FULLSTACK_CLI_PIN_SPEC} sync --disable-gen-openapi`,
+            ifStartsWith: 'fullstack-cli sync',
+        },
+        // 11a. 迁移已有 npx 未钉版的 upgrade
+        {
+            type: 'patch-script',
+            name: 'upgrade',
+            to: `npx -y ${fullstack_cli_pin_1.FULLSTACK_CLI_PIN_SPEC} sync --disable-gen-openapi`,
+            ifStartsWith: 'npx -y @lark-apaas/fullstack-cli sync',
+        },
+        // ===== miaoda-cli 本地开发新增规则（fullstack-cli sync 不会执行） =====
+        // M1. scripts.dev:local —— 本地用户绕过 SANDBOX_ID 分发直接跑本地链路（npm run dev:local）。
+        //     dev.sh 在 SANDBOX_ID 非空时跑 dev.js（沙箱保活）、否则 exec dev-local.sh；显式 dev:local
+        //     用于 agent 在本地稳定调试，不受任何 env 影响。
+        {
+            type: 'add-script',
+            name: 'dev:local',
+            command: './scripts/dev-local.sh',
+            overwrite: false,
+        },
+        // M2. tsconfig.node.json 合并 watchOptions.preserveWatchOutput —— tsc --watch 默认每次
+        //     重编译都会 clear screen + scrollback，本地 nest start --watch 跑下来日志全没。打开
+        //     preserveWatchOutput 让 watch 模式追加而不是清屏。模板只放需要 merge 的几个字段，
+        //     不动用户的 compilerOptions / include / exclude。
+        {
+            type: 'merge-json',
+            from: 'tsconfig.node.json',
+            to: 'tsconfig.node.json',
+        },
+    ],
+};
+exports.default = exports.SYNC_CONFIG;

package/dist/config/sync.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * SyncRule 类型定义 —— miaoda app sync 的核心抽象。
+ *
+ * 完整搬自 @lark-apaas/fullstack-cli（packages/tools/fullstack-cli/src/config/sync.ts），
+ * 保持 rule shape 与 fullstack-cli 严格一致。沙箱里跑的 `npm run upgrade →
+ * npx fullstack-cli sync` 走 fullstack-cli 一侧；本地 `miaoda app sync` 走 miaoda-cli
+ * 一侧。两边的 apply 行为对齐，rule 配置则按 stack 拆开（每个 stack 一份
+ * upgrade/templates/<stack>/sync.config.ts）。
+ *
+ * 不同于 fullstack-cli 把 rule 全局 hardcode 在包内：miaoda-cli 把 rule 拆到 stack 级别
+ * 文件，便于 nestjs-react-fullstack / vite-react / html / design-stack 各自维护。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,12 @@
+"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;
+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; } });
+Object.defineProperty(exports, "TEMPLATE_PACKAGE_BY_STACK", { enumerable: true, get: function () { return template_1.TEMPLATE_PACKAGE_BY_STACK; } });
+var spark_meta_1 = require("../../../utils/spark-meta");
+Object.defineProperty(exports, "readSparkMeta", { enumerable: true, get: function () { return spark_meta_1.readSparkMeta; } });
+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; } });

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

@@ -0,0 +1,123 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installDependencies = installDependencies;
+const node_child_process_1 = require("node:child_process");
+const node_crypto_1 = __importDefault(require("node:crypto"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const error_1 = require("../../../utils/error");
+const logger_1 = require("../../../utils/logger");
+const DEP_CACHE_ENV = 'MIAODA_DEP_CACHE_DIR';
+/**
+ * 依赖安装。
+ *
+ * 优先级：
+ *   1. skip=true → 直接返回 source=skipped
+ *   2. MIAODA_DEP_CACHE_DIR 设了 + 目标目录有 package.json：
+ *        - 算 md5(package.json)（与 CI 生产端 dep-cache pipeline 一致）
+ *        - 若 ${cache}/${hash}.zip 存在 → unzip 到目标目录
+ *           - 校验 node_modules/ 非空：通过则 source=cache，否则 fallback npm install
+ *        - zip 不存在 → fallback npm install，但 hash 仍记录
+ *   3. `npm install --no-audit --no-fund`
+ *
+ * 不做 cache 回写（read-only）。
+ */
+function installDependencies(opts) {
+    if (opts.skip) {
+        (0, logger_1.log)('init', 'Skipping dependency install (--skip-install)');
+        return { installed: false, source: 'skipped' };
+    }
+    const childStdio = stdioFor(opts.quietStdout);
+    const cacheDir = process.env[DEP_CACHE_ENV];
+    const pkgJsonPath = node_path_1.default.join(opts.targetDir, 'package.json');
+    const hasPkg = node_fs_1.default.existsSync(pkgJsonPath);
+    if (cacheDir && hasPkg) {
+        const hash = md5File(pkgJsonPath);
+        const cacheZip = node_path_1.default.join(cacheDir, `${hash}.zip`);
+        if (node_fs_1.default.existsSync(cacheZip)) {
+            (0, logger_1.log)('init', `Cache hit: ${cacheZip}`);
+            extractZip(cacheZip, opts.targetDir, childStdio);
+            if (nodeModulesUsable(opts.targetDir)) {
+                return { installed: true, source: 'cache', hash, cacheZip };
+            }
+            (0, logger_1.log)('init', 'Cache zip extracted but node_modules/ missing or empty; falling back to npm install');
+            return runInstallSoft(opts.targetDir, childStdio, hash);
+        }
+        (0, logger_1.log)('init', `Cache miss for ${hash}.zip, falling back to npm install`);
+        return runInstallSoft(opts.targetDir, childStdio, hash);
+    }
+    if (cacheDir && !hasPkg) {
+        (0, logger_1.log)('init', `${DEP_CACHE_ENV} set but no package.json in target; running npm install`);
+    }
+    return runInstallSoft(opts.targetDir, childStdio);
+}
+/**
+ * 跑 npm install；失败不抛错，返回 source='failed' 让上层 init handler 继续走 writeSparkMeta
+ * 等后续步骤（避免 install 挂了 .spark/meta.json 没写出来，下次 init 看到半渲染状态又得重跑全套）。
+ * 失败信息通过 stderr 直出 + emit data.installError 透传给用户。
+ */
+function runInstallSoft(targetDir, stdio, hash) {
+    try {
+        runNpmInstall(targetDir, stdio);
+        return { installed: true, source: 'npm', hash };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        (0, logger_1.log)('init', `⚠ npm install failed (continuing init): ${msg}`);
+        return { installed: false, source: 'failed', hash, error: msg };
+    }
+}
+function nodeModulesUsable(targetDir) {
+    const nm = node_path_1.default.join(targetDir, 'node_modules');
+    if (!node_fs_1.default.existsSync(nm))
+        return false;
+    try {
+        return node_fs_1.default.readdirSync(nm).length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+function stdioFor(quietStdout) {
+    // quietStdout=true：子进程 stdout 重定向到 fd 2（父进程 stderr），
+    // 保留 stderr 直出 → 终端仍能看到 npm install 进度，但父进程 stdout 干净，
+    // 后续 emit(JSON) 不会被污染。
+    return quietStdout ? ['ignore', 2, 'inherit'] : ['ignore', 'inherit', 'inherit'];
+}
+function md5File(filePath) {
+    const buf = node_fs_1.default.readFileSync(filePath);
+    return node_crypto_1.default.createHash('md5').update(buf).digest('hex');
+}
+function extractZip(zipPath, targetDir, stdio) {
+    try {
+        (0, node_child_process_1.execFileSync)('unzip', ['-q', '-o', zipPath, '-d', targetDir], { stdio });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new error_1.AppError('DEP_CACHE_EXTRACT_FAILED', `解压依赖缓存失败 (${zipPath}): ${msg}`, {
+            next_actions: [`确认 ${zipPath} 是合法 zip`, `或 unset ${DEP_CACHE_ENV} 走 npm install`],
+        });
+    }
+}
+/**
+ * 显式钉死 npmmirror。原因：
+ *   - user 全局 `~/.npmrc` 千奇百怪（bnpm / npmjs / 自定义代理），npm config 层叠下
+ *     CLI flag 优先级最高，写在这里能盖掉所有上游配置，行为可预测。
+ *   - 模板 `_npmrc → .npmrc` 虽然项目级 registry 写得是 npmmirror，但只在 cwd 含 .npmrc
+ *     时才生效，env / CLI 层先到先得，落到这里钉死最稳。
+ *   - 字节内网 DNS 会把 npmmirror 域名透明指向公司镜像，外网就是公网阿里源；同一行配置
+ *     在两套环境都拉得到 @lark-apaas/* 私包（内网经公司镜像，外网经阿里同步过去的副本）。
+ *   - 留 `MIAODA_NPM_REGISTRY` env 应急覆盖。
+ */
+const NPM_INSTALL_REGISTRY_DEFAULT = 'https://registry.npmmirror.com/';
+function runNpmInstall(targetDir, stdio) {
+    (0, logger_1.log)('init', `npm install in ${targetDir}...`);
+    const registry = process.env.MIAODA_NPM_REGISTRY ?? NPM_INSTALL_REGISTRY_DEFAULT;
+    (0, node_child_process_1.execFileSync)('npm', ['install', '--no-audit', '--no-fund', '--registry', registry], {
+        cwd: targetDir,
+        stdio,
+    });
+}

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

@@ -0,0 +1,108 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_STACKS = exports.TEMPLATE_PINNED_VERSION_BY_STACK = exports.TEMPLATE_PACKAGE_BY_STACK = void 0;
+exports.renderTemplate = renderTemplate;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const npm_pack_1 = require("../../../utils/npm-pack");
+const error_1 = require("../../../utils/error");
+const logger_1 = require("../../../utils/logger");
+/** 短名 → 包名映射。新增 stack 时改这里。archType 由 template 包自报，CLI 不维护。 */
+exports.TEMPLATE_PACKAGE_BY_STACK = {
+    'vite-react': '@lark-apaas/coding-template-vite-react',
+    html: '@lark-apaas/coding-template-html',
+    'nestjs-react-fullstack': '@lark-apaas/coding-template-nestjs-react-fullstack',
+};
+/**
+ * 短名 → template 包钉死版本。renderTemplate 默认按这张表取版本号，表外 stack 走 npm latest。
+ *
+ * 钉死稳定版本而非跟 alpha dist-tag —— alpha 通道被多团队共享，外部 prerelease 时常打过去，
+ * 自动跟 alpha 会把回归版本拉进 user app。每次升基线人工 review 一次再改这里。
+ * 用户显式传 `--conf '{"version": "..."}'` 仍 override 此默认值。
+ */
+exports.TEMPLATE_PINNED_VERSION_BY_STACK = {
+    'nestjs-react-fullstack': '0.1.0-alpha.5',
+    // vite-react / html 暂不钉版，跟 latest dist-tag（新版正常迭代后再纳入钉版）
+};
+exports.SUPPORTED_STACKS = Object.keys(exports.TEMPLATE_PACKAGE_BY_STACK);
+// template/ 内以下划线开头的占位文件名在渲染时改名。
+// 原因：
+//   1. npm pack 强制剥的：.npmrc（防 auth token 泄露）
+//   2. 沙箱平台特殊处理的：.gitignore（避免与平台仓库 .gitignore 冲突）
+// .env 通过 negation pattern 例外直接 ship；.env.local 完全由 lark-cli +env-pull
+// 运行时下发，模板里不再放占位文件。
+const RENAME_FILES = {
+    _gitignore: '.gitignore',
+    _npmrc: '.npmrc',
+};
+function renderTemplate(opts) {
+    const packageName = exports.TEMPLATE_PACKAGE_BY_STACK[opts.stack];
+    if (!packageName) {
+        throw new error_1.AppError('ARGS_INVALID', `不支持的 template: ${opts.stack}`, {
+            next_actions: [`可用 stack：${exports.SUPPORTED_STACKS.join(', ')}`],
+        });
+    }
+    // 默认按 TEMPLATE_PINNED_VERSION_BY_STACK 取钉版（避免 npm latest 碰外部 prerelease 回归）；
+    // 表外 stack fallback 到 'latest'；用户显式传 --conf.version 仍 override 钉版。
+    const pinned = Object.prototype.hasOwnProperty.call(exports.TEMPLATE_PINNED_VERSION_BY_STACK, opts.stack)
+        ? exports.TEMPLATE_PINNED_VERSION_BY_STACK[opts.stack]
+        : undefined;
+    const effectiveVersion = opts.version ?? pinned ?? 'latest';
+    (0, logger_1.log)('init', `Fetching ${packageName}@${effectiveVersion}...`);
+    const fetched = (0, npm_pack_1.fetchNpmPackage)({ packageName, version: effectiveVersion });
+    try {
+        const templateDir = node_path_1.default.join(fetched.extractDir, 'template');
+        if (!node_fs_1.default.existsSync(templateDir)) {
+            throw new error_1.AppError('TEMPLATE_INVALID', `包 ${packageName}@${fetched.version} 缺少 template/ 目录`);
+        }
+        const pkgJsonPath = node_path_1.default.join(fetched.extractDir, 'package.json');
+        let archType;
+        if (node_fs_1.default.existsSync(pkgJsonPath)) {
+            const pkgJson = JSON.parse(node_fs_1.default.readFileSync(pkgJsonPath, 'utf-8'));
+            archType = pkgJson.miaodaTemplate?.archType;
+        }
+        // 用显式 null/undefined/'' 判，避免把合法值 0 / false 当成"缺失"误抛
+        if (archType === undefined || archType === null || archType === '') {
+            throw new error_1.AppError('TEMPLATE_INVALID', `包 ${packageName}@${fetched.version} 缺少 package.json.miaodaTemplate.archType`);
+        }
+        (0, logger_1.log)('init', `Rendering template to ${opts.targetDir}...`);
+        copyDir(templateDir, opts.targetDir);
+        for (const [from, to] of Object.entries(RENAME_FILES)) {
+            const fromPath = node_path_1.default.join(opts.targetDir, from);
+            const toPath = node_path_1.default.join(opts.targetDir, to);
+            if (node_fs_1.default.existsSync(fromPath))
+                node_fs_1.default.renameSync(fromPath, toPath);
+        }
+        // 仅替换展示性文件；package.json 写固定 name，保证 md5(package.json) 跨渲染稳定，
+        // 可被 install 阶段直接当 MIAODA_DEP_CACHE_DIR 的 cache key。
+        for (const rel of ['index.html', 'README.md']) {
+            const p = node_path_1.default.join(opts.targetDir, rel);
+            if (node_fs_1.default.existsSync(p))
+                replaceInFile(p, '{{projectName}}', opts.projectName);
+        }
+        return { version: fetched.version, packageName, archType };
+    }
+    finally {
+        fetched.cleanup();
+    }
+}
+function copyDir(src, dest) {
+    node_fs_1.default.mkdirSync(dest, { recursive: true });
+    for (const entry of node_fs_1.default.readdirSync(src, { withFileTypes: true })) {
+        const srcPath = node_path_1.default.join(src, entry.name);
+        const destPath = node_path_1.default.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDir(srcPath, destPath);
+        }
+        else {
+            node_fs_1.default.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+function replaceInFile(filePath, search, replace) {
+    const content = node_fs_1.default.readFileSync(filePath, 'utf-8');
+    node_fs_1.default.writeFileSync(filePath, content.replaceAll(search, replace), 'utf-8');
+}

package/dist/services/deploy/modern/atoms/build.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runBuild = runBuild;
+const node_child_process_1 = require("node:child_process");
+const error_1 = require("../../../../utils/error");
+const logger_1 = require("../../../../utils/logger");
+const protocol_1 = require("../protocol");
+/**
+ * 给 RESOURCE_CDN_PREFIX 补 https:// 协议头：
+ *   - 已带 http:// 或 https:// → 原样返回
+ *   - 以 / 开头（绝对路径）→ 原样返回
+ *   - 不含 dot（看起来不像域名，比如纯路径 app_xxx/2）→ 原样返回
+ *   - 其它（典型：lf-xxx.bytetos.com/...）→ 前缀 https://
+ *
+ * template 的 build script 直接拿来当 vite base / asset URL 用，必须是合法 URL。
+ * STATIC_CDN_PREFIX 由 runtime 同域提供（相对路径），不走这里。
+ */
+function ensureHttpsScheme(v) {
+    if (/^https?:\/\//i.test(v))
+        return v;
+    if (v.startsWith('/'))
+        return v;
+    if (!v.includes('.'))
+        return v;
+    return `https://${v}`;
+}
+/**
+ * 跑 `npm run build`，把 preRelease 下发的动态配置注入 env：
+ *   MIAODA_APP_ID / MIAODA_VERSION / MIAODA_STACK
+ *   MIAODA_RESOURCE_CDN_PREFIX / MIAODA_STATIC_CDN_PREFIX
+ *
+ * MIAODA_STATIC_CDN_PREFIX 取自 output_static_paas_storage_credential.downloadURLPrefix，
+ * 是 runtime 同域相对路径（例如 /app/<appId>/runtime/api/v1/storage/object/<bucket>/），
+ * 不补 https scheme，原样注入。顶层 static_cdn_prefix 不再下发。
+ *
+ * build 失败抛 AppError（execSync 自身会 throw，捕获后包一层加错误码）。
+ */
+function runBuild(opts) {
+    const staticCred = (0, protocol_1.parsePaasStorageCredential)((0, protocol_1.requireDataKey)(opts.data, protocol_1.DataKey.OUTPUT_STATIC_PAAS_STORAGE_CREDENTIAL), protocol_1.DataKey.OUTPUT_STATIC_PAAS_STORAGE_CREDENTIAL);
+    const buildEnv = {
+        ...process.env,
+        MIAODA_APP_ID: opts.appId,
+        MIAODA_VERSION: opts.version,
+        MIAODA_STACK: opts.templateKey,
+        MIAODA_RESOURCE_CDN_PREFIX: ensureHttpsScheme((0, protocol_1.requireDataKey)(opts.data, protocol_1.DataKey.RESOURCE_CDN_PREFIX)),
+        MIAODA_STATIC_CDN_PREFIX: staticCred.downloadURLPrefix,
+    };
+    (0, logger_1.log)('deploy', 'Building...');
+    try {
+        (0, node_child_process_1.execSync)('npm run build', {
+            cwd: opts.projectDir,
+            stdio: 'inherit',
+            env: buildEnv,
+        });
+    }
+    catch (err) {
+        throw new error_1.AppError('DEPLOY_BUILD_FAILED', `npm run build failed: ${err.message}`);
+    }
+}

package/dist/services/deploy/modern/atoms/context.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareDeployContext = prepareDeployContext;
+const error_1 = require("../../../../utils/error");
+const spark_meta_1 = require("../../../../utils/spark-meta");
+const check_1 = require("../check");
+const template_key_map_1 = require("../template-key-map");
+/**
+ * 准备 deploy 上下文：跑前置检查、读 .spark/meta.json 拿 stack，
+ * 并把 stack 短名映射成后端 templateKey。appId 由调用方从 env 解析后传入。
+ *
+ * 任何前置失败统一抛 AppError。返回值是后续 atom 唯一信任的入参源。
+ */
+function prepareDeployContext(projectDir, appId) {
+    (0, check_1.runDeployChecks)(projectDir);
+    const meta = (0, spark_meta_1.readSparkMeta)(projectDir);
+    if (meta.stack === undefined || meta.stack === '') {
+        throw new error_1.AppError('DEPLOY_META_INCOMPLETE', '.spark/meta.json missing stack — run `miaoda app init` first');
+    }
+    return {
+        projectDir,
+        appId,
+        stack: meta.stack,
+        templateKey: (0, template_key_map_1.resolveTemplateKey)(meta.stack),
+        meta,
+    };
+}

package/dist/services/deploy/modern/atoms/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.savePluginInstances = exports.LocalReleaseStatus = exports.finalizeLocalRelease = exports.createLocalRelease = exports.uploadArtifacts = exports.runBuild = exports.preRelease = exports.prepareDeployContext = void 0;
+var context_1 = require("./context");
+Object.defineProperty(exports, "prepareDeployContext", { enumerable: true, get: function () { return context_1.prepareDeployContext; } });
+var pre_release_1 = require("./pre-release");
+Object.defineProperty(exports, "preRelease", { enumerable: true, get: function () { return pre_release_1.preRelease; } });
+var build_1 = require("./build");
+Object.defineProperty(exports, "runBuild", { enumerable: true, get: function () { return build_1.runBuild; } });
+var upload_1 = require("./upload");
+Object.defineProperty(exports, "uploadArtifacts", { enumerable: true, get: function () { return upload_1.uploadArtifacts; } });
+var local_release_1 = require("./local-release");
+Object.defineProperty(exports, "createLocalRelease", { enumerable: true, get: function () { return local_release_1.createLocalRelease; } });
+Object.defineProperty(exports, "finalizeLocalRelease", { enumerable: true, get: function () { return local_release_1.finalizeLocalRelease; } });
+Object.defineProperty(exports, "LocalReleaseStatus", { enumerable: true, get: function () { return local_release_1.LocalReleaseStatus; } });
+var save_plugin_instances_1 = require("./save-plugin-instances");
+Object.defineProperty(exports, "savePluginInstances", { enumerable: true, get: function () { return save_plugin_instances_1.savePluginInstances; } });

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

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalReleaseStatus = void 0;
+exports.createLocalRelease = createLocalRelease;
+exports.finalizeLocalRelease = finalizeLocalRelease;
+const index_1 = require("../../../../api/deploy/index");
+Object.defineProperty(exports, "LocalReleaseStatus", { enumerable: true, get: function () { return index_1.LocalReleaseStatus; } });
+const logger_1 = require("../../../../utils/logger");
+/**
+ * 创建本地发布单（加锁；不挂 pipeline）。
+ * 返回的 releaseId 必须由 finalizeLocalRelease 翻为终态，否则发布单一直挂着。
+ */
+async function createLocalRelease(appId, version) {
+    return (0, index_1.createLocalRelease)({ appID: appId, version });
+}
+/**
+ * 把本地发布单翻为终态。Finished / Failed 由 pipeline 视上下游结果决定。
+ * 失败不抛（避免覆盖上游真错误），但记一行 stderr 让排查可定位。
+ */
+async function finalizeLocalRelease(appId, releaseId, status) {
+    try {
+        await (0, index_1.updateLocalRelease)({ appID: appId, releaseID: releaseId, status });
+    }
+    catch (err) {
+        (0, logger_1.log)('deploy', `finalize release(${releaseId}, status=${String(status)}) failed: ${err.message}`);
+    }
+}

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

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.preRelease = preRelease;
+const index_1 = require("../../../../api/deploy/index");
+/**
+ * 调用 preRelease，拿到 pre_release_id、version 和动态配置 data。
+ *
+ * 失败由 api 层抛 HttpError / AppError 透传上去；atom 本身不再做语义包装，
+ * 让 pipeline 层决定怎么向 handler 报告。
+ */
+async function preRelease(appId, templateKey) {
+    return (0, index_1.preRelease)({ appID: appId, templateKey });
+}