@lark-apaas/miaoda-cli 0.1.3 → 0.1.4-alpha.8b6506a

package/dist/cli/help.js

@@ -35,7 +35,7 @@ class MiaodaHelp extends commander_1.Help {
         const usage = cmd.usage();
         if (usage) {
             // 去掉末尾的 [flags] / [options]，对齐 spec 的 "name <args>" 形态
-            const argsOnly = usage.replace(/\s*\[(?:flags|options)\]\s*$/i, "").trim();
+            const argsOnly = usage.replace(/\s*\[(?:flags|options)\]\s*$/i, '').trim();
             return argsOnly ? `${cmd.name()} ${argsOnly}` : cmd.name();
         }
         return super.subcommandTerm(cmd);
@@ -51,7 +51,7 @@ class MiaodaHelp extends commander_1.Help {
         if (summary)
             return summary;
         const desc = super.subcommandDescription(cmd);
-        const idx = desc.indexOf("\n");
+        const idx = desc.indexOf('\n');
         return idx === -1 ? desc : desc.slice(0, idx);
     }
     /**
@@ -81,7 +81,7 @@ class MiaodaHelp extends commander_1.Help {
     visibleGlobalOptions(cmd) {
         const opts = super.visibleGlobalOptions(cmd);
         if (cmd.parent) {
-            return opts.filter((o) => o.long !== "--version" && o.short !== "-v");
+            return opts.filter((o) => o.long !== '--version' && o.short !== '-v');
         }
         return opts;
     }
@@ -90,7 +90,7 @@ class MiaodaHelp extends commander_1.Help {
      * spec 不展示这一条，过滤掉。
      */
     visibleCommands(cmd) {
-        return super.visibleCommands(cmd).filter((c) => c.name() !== "help");
+        return super.visibleCommands(cmd).filter((c) => c.name() !== 'help');
     }
     formatHelp(cmd, helper) {
         const isRoot = cmd.parent == null;
@@ -98,28 +98,28 @@ class MiaodaHelp extends commander_1.Help {
         const helpWidth = helper.helpWidth ?? 80;
         const formatItem = (term, description) => {
             if (description) {
-                const padding = " ".repeat(Math.max(termWidth - term.length, 0) + 2);
+                const padding = ' '.repeat(Math.max(termWidth - term.length, 0) + 2);
                 return `${term}${padding}${description}`;
             }
             return term;
         };
-        const formatList = (lines) => lines.map((l) => "  " + l).join("\n");
+        const formatList = (lines) => lines.map((l) => '  ' + l).join('\n');
         void helpWidth; // 保留以备后续按宽度自动 wrap，当前直接透传 description
         const out = [];
         // 1. 描述
         const desc = helper.commandDescription(cmd);
         if (desc) {
-            out.push(desc, "");
+            out.push(desc, '');
         }
         // 2. Usage：独立 heading + 缩进
-        out.push("Usage:", `  ${helper.commandUsage(cmd)}`, "");
+        out.push('Usage:', `  ${helper.commandUsage(cmd)}`, '');
         // 3. Commands（仅父级命令组有，spec 要求 Commands 在 Flags 前）
         //    spec 不展示 Arguments 段，参数说明放在 description 文本里
         const subs = helper
             .visibleCommands(cmd)
             .map((c) => formatItem(helper.subcommandTerm(c), helper.subcommandDescription(c)));
         if (subs.length) {
-            out.push("Commands:", formatList(subs), "");
+            out.push('Commands:', formatList(subs), '');
         }
         // 5. Flags（叶子命令专属 options）
         //    - Root / 父命令组：local options 都视作"会被子命令继承的 globals"，渲染到 Global Flags 段
@@ -132,7 +132,7 @@ class MiaodaHelp extends commander_1.Help {
                 .filter((o) => !isHelpOption(o))
                 .map((o) => formatItem(helper.optionTerm(o), helper.optionDescription(o)));
             if (opts.length) {
-                out.push("Flags:", formatList(opts), "");
+                out.push('Flags:', formatList(opts), '');
             }
         }
         // 6. Global Flags
@@ -162,22 +162,22 @@ class MiaodaHelp extends commander_1.Help {
         }
         if (globals.length) {
             const lines = globals.map((o) => formatItem(helper.optionTerm(o), helper.optionDescription(o)));
-            out.push("Global Flags:", formatList(lines), "");
+            out.push('Global Flags:', formatList(lines), '');
         }
         // 7. 父命令底部追加 "Use <cmd> <subcommand> --help" 提示，对齐 spec
         if (subs.length > 0) {
-            const path = cmd.name() === "miaoda" ? "miaoda" : commandPath(cmd);
-            out.push(`Use "${path} <command> --help" for more information about a command.`, "");
+            const path = cmd.name() === 'miaoda' ? 'miaoda' : commandPath(cmd);
+            out.push(`Use "${path} <command> --help" for more information about a command.`, '');
         }
         // 保留末尾换行：commander 用 join('\n') 拼 addHelpText('after') 段，
         // 这里多留一个 \n，让 Notes / Examples 段与上面段落之间空一行。
-        return out.join("\n").replace(/\n+$/, "\n");
+        return out.join('\n').replace(/\n+$/, '\n');
     }
 }
 exports.MiaodaHelp = MiaodaHelp;
 /** 判断是否为 -h / --help 选项。 */
 function isHelpOption(o) {
-    return o.long === "--help" || o.short === "-h";
+    return o.long === '--help' || o.short === '-h';
 }
 /** 拼接命令完整路径，例如 db schema -> "miaoda db schema"。 */
 function commandPath(cmd) {
@@ -187,5 +187,5 @@ function commandPath(cmd) {
         names.unshift(cur.name());
         cur = cur.parent;
     }
-    return names.join(" ");
+    return names.join(' ');
 }

package/dist/main.js

@@ -20,18 +20,18 @@ commander_1.Command.prototype.createHelp = function () {
 const program = new commander_1.Command();
 const { version } = package_json_1.default;
 program
-    .name("miaoda")
-    .description("妙搭平台 CLI，提供数据服务、文件存储等命令行操作。")
-    .usage("<command> [flags]")
-    .version(version, "-v, --version", "显示版本号")
-    .option("--json [fields]", "JSON 输出，可选字段级选择")
-    .addOption(new commander_1.Option("--output <format>", "输出格式（pretty | json，大小写不敏感）")
-    .choices(["pretty", "json"])
-    .argParser((0, shared_1.caseInsensitiveChoice)(["pretty", "json"]))
-    .default("pretty"))
-    .option("--verbose", "debug 日志到 stderr")
-    .helpOption("-h, --help", "显示帮助信息")
-    .hook("preAction", (_thisCmd, actionCmd) => {
+    .name('miaoda')
+    .description('妙搭平台 CLI，提供数据服务、文件存储等命令行操作。')
+    .usage('<command> [flags]')
+    .version(version, '-v, --version', '显示版本号')
+    .option('--json [fields]', 'JSON 输出，可选字段级选择')
+    .addOption(new commander_1.Option('--output <format>', '输出格式（pretty | json，大小写不敏感）')
+    .choices(['pretty', 'json'])
+    .argParser((0, shared_1.caseInsensitiveChoice)(['pretty', 'json']))
+    .default('pretty'))
+    .option('--verbose', 'debug 日志到 stderr')
+    .helpOption('-h, --help', '显示帮助信息')
+    .hook('preAction', (_thisCmd, actionCmd) => {
     (0, log_id_1.generateLogId)();
     const opts = actionCmd.optsWithGlobals();
     (0, config_1.initConfigFromOpts)(opts);

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,101 @@
+"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');
+            runNpmInstall(opts.targetDir, childStdio);
+            return { installed: true, source: 'npm', hash };
+        }
+        (0, logger_1.log)('init', `Cache miss for ${hash}.zip, falling back to npm install`);
+        runNpmInstall(opts.targetDir, childStdio);
+        return { installed: true, source: 'npm', hash };
+    }
+    if (cacheDir && !hasPkg) {
+        (0, logger_1.log)('init', `${DEP_CACHE_ENV} set but no package.json in target; running npm install`);
+    }
+    runNpmInstall(opts.targetDir, childStdio);
+    return { installed: true, source: 'npm' };
+}
+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`],
+        });
+    }
+}
+function runNpmInstall(targetDir, stdio) {
+    (0, logger_1.log)('init', `npm install in ${targetDir}...`);
+    try {
+        (0, node_child_process_1.execFileSync)('npm', ['install', '--no-audit', '--no-fund'], { cwd: targetDir, stdio });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new error_1.AppError('NPM_INSTALL_FAILED', `npm install 失败: ${msg}`);
+    }
+}

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

@@ -0,0 +1,85 @@
+"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_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 时改这里。 */
+exports.TEMPLATE_PACKAGE_BY_STACK = {
+    'vite-react': '@lark-apaas/coding-template-vite-react',
+    html: '@lark-apaas/coding-template-html',
+};
+exports.SUPPORTED_STACKS = Object.keys(exports.TEMPLATE_PACKAGE_BY_STACK);
+// template/ 内以下划线开头的占位文件名在渲染时改名（npm publish 会把 .gitignore 吞掉，
+// 模板里用 _gitignore 提交，渲染时再改回）。
+const RENAME_FILES = {
+    _gitignore: '.gitignore',
+    '_env.local': '.env.local',
+};
+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(', ')}`],
+        });
+    }
+    (0, logger_1.log)('init', `Fetching ${packageName}@${opts.version ?? 'latest'}...`);
+    const fetched = (0, npm_pack_1.fetchNpmPackage)({ packageName, version: opts.version });
+    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 ?? '';
+        }
+        if (!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,54 @@
+"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");
+/**
+ * 给 CDN 前缀补 https:// 协议头：
+ *   - 已带 http:// 或 https:// → 原样返回
+ *   - 以 / 开头（绝对路径）→ 原样返回
+ *   - 不含 dot（看起来不像域名，比如纯路径 app_xxx/2）→ 原样返回
+ *   - 其它（典型：lf-xxx.bytetos.com/...）→ 前缀 https://
+ *
+ * template 的 build script 直接拿来当 vite base / asset URL 用，必须是合法 URL。
+ */
+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
+ *
+ * CDN 前缀缺 scheme 时由 CLI 自动补 https://，template 不用关心。
+ * build 失败抛 AppError（execSync 自身会 throw，捕获后包一层加错误码）。
+ */
+function runBuild(opts) {
+    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: ensureHttpsScheme((0, protocol_1.requireDataKey)(opts.data, protocol_1.DataKey.STATIC_CDN_PREFIX)),
+    };
+    (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,30 @@
+"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、抽出 appId / stack，
+ * 并把 stack 短名映射成后端 templateKey。
+ *
+ * 任何前置失败统一抛 AppError。返回值是后续 atom 唯一信任的入参源。
+ */
+function prepareDeployContext(projectDir) {
+    (0, check_1.runDeployChecks)(projectDir);
+    const meta = (0, spark_meta_1.readSparkMeta)(projectDir);
+    if (meta.appId === undefined || meta.appId === '') {
+        throw new error_1.AppError('DEPLOY_META_INCOMPLETE', '.spark/meta.json missing appId — run `miaoda app init` first');
+    }
+    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: meta.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 });
+}

package/dist/services/deploy/modern/atoms/save-plugin-instances.js

@@ -0,0 +1,72 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.savePluginInstances = savePluginInstances;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const index_1 = require("../../../../api/deploy/index");
+const logger_1 = require("../../../../utils/logger");
+const constants_1 = require("../constants");
+function isValidCapability(o) {
+    if (typeof o !== 'object' || o === null)
+        return false;
+    const id = o.id;
+    return typeof id === 'string' && id.length > 0;
+}
+/**
+ * 扫描 dist/output_capabilities/*.json，过滤出合法 capability，批量上报到 studio_server。
+ *
+ * 合法判定：能 JSON.parse + 顶层 id 是非空字符串。其它字段后端校验。
+ * 目录不存在 / 没有合法 capability → 直接返回 0，pipeline 当作 no-op。
+ * batchSave 调用失败 → 透传抛 AppError，pipeline 兜底 finalizeLocalRelease(Failed)。
+ */
+async function savePluginInstances(opts) {
+    const dir = node_path_1.default.join(opts.projectDir, constants_1.DIST_DIR, constants_1.OUTPUT_CAPABILITIES_DIR);
+    if (!node_fs_1.default.existsSync(dir)) {
+        (0, logger_1.debug)(`save-plugin-instances: ${dir} not present, skipping`);
+        return { saved: 0, skipped: 0 };
+    }
+    const files = node_fs_1.default.readdirSync(dir).filter((f) => f.endsWith('.json'));
+    const instances = [];
+    let skipped = 0;
+    for (const f of files) {
+        const full = node_path_1.default.join(dir, f);
+        let raw;
+        try {
+            raw = node_fs_1.default.readFileSync(full, 'utf-8');
+        }
+        catch (err) {
+            (0, logger_1.debug)(`save-plugin-instances: read ${f} failed: ${err.message}`);
+            skipped++;
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            (0, logger_1.debug)(`save-plugin-instances: ${f} is not valid JSON, skipping`);
+            skipped++;
+            continue;
+        }
+        if (!isValidCapability(parsed)) {
+            (0, logger_1.debug)(`save-plugin-instances: ${f} missing 'id' string, skipping`);
+            skipped++;
+            continue;
+        }
+        instances.push({ id: parsed.id, content: JSON.stringify(parsed) });
+    }
+    if (instances.length === 0) {
+        (0, logger_1.log)('deploy', `No capability to register (${String(files.length)} files scanned, all skipped)`);
+        return { saved: 0, skipped };
+    }
+    (0, logger_1.log)('deploy', `Registering ${String(instances.length)} capability instance(s)...`);
+    await (0, index_1.batchSavePluginInstances)({
+        appID: opts.appId,
+        appVersion: opts.version,
+        pluginInstances: instances,
+    });
+    return { saved: instances.length, skipped };
+}