@lark-apaas/miaoda-cli 0.1.23 → 0.1.24-alpha.1425dbf

package/dist/api/app/api.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAppInfo = getAppInfo;
 exports.updateAppMeta = updateAppMeta;
+exports.getCodeArchive = getCodeArchive;
 const http_1 = require("../../utils/http");
 const devops_error_1 = require("../../utils/devops-error");
 const DEFAULT_ERR_CODE = 'INTERNAL_DEVOPS_ERROR';
@@ -23,3 +24,22 @@ async function updateAppMeta(req) {
     // 路径已带 appID，body 里也保留以匹配 BAM IDL 的 sensitive:"no" 透传约定
     return (0, http_1.postInnerApi)(url, req, envelopeOpts('Failed to update app'));
 }
+/**
+ * GET /api/v1/studio/innerapi/apps/:appID/code-archive?sourceAppID=xxx — 导出源应用源码归档。
+ * 走 studio_server inner 通道（force 身份，服务侧 force→lark 换取后按 DOWNLOAD 鉴权，
+ * 鉴权对象是 sourceAppID），与 comment 域同一 inner 信封；创意应用升级链路（app export）消费。
+ *
+ * path :appID 必须是当前沙箱应用：网关 apaas_force_admin_plugin 强校验 URL appID 与沙箱
+ * AK 绑定应用一致（不一致 400 "appID in url is illegal"），跨应用导出目标因此走 query。
+ */
+async function getCodeArchive(params) {
+    const { appID, sourceAppID, checkpointID } = params;
+    let url = `/api/v1/studio/innerapi/apps/${encodeURIComponent(appID)}/code-archive` +
+        `?sourceAppID=${encodeURIComponent(sourceAppID)}`;
+    if (checkpointID !== undefined && checkpointID > 0) {
+        url += `&checkPointID=${String(checkpointID)}`;
+    }
+    return (0, http_1.getInnerApi)(url, {
+        errPrefix: 'Failed to export code archive',
+    });
+}

package/dist/api/app/index.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ArchType = exports.Source = exports.BizType = exports.AppType = exports.AppMode = exports.AppStatus = exports.appMetaSchema = exports.updateAppMeta = exports.getAppInfo = void 0;
+exports.ArchType = exports.Source = exports.BizType = exports.AppType = exports.AppMode = exports.AppStatus = exports.appMetaSchema = exports.getCodeArchive = exports.updateAppMeta = exports.getAppInfo = void 0;
 var api_1 = require("./api");
 Object.defineProperty(exports, "getAppInfo", { enumerable: true, get: function () { return api_1.getAppInfo; } });
 Object.defineProperty(exports, "updateAppMeta", { enumerable: true, get: function () { return api_1.updateAppMeta; } });
+Object.defineProperty(exports, "getCodeArchive", { enumerable: true, get: function () { return api_1.getCodeArchive; } });
 var schemas_1 = require("./schemas");
 Object.defineProperty(exports, "appMetaSchema", { enumerable: true, get: function () { return schemas_1.appMetaSchema; } });
 var types_1 = require("./types");

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

@@ -21,6 +21,7 @@ function registerAppCommands(program, opts = {}) {
 `);
     registerAppGet(appCmd);
     registerAppUpdate(appCmd);
+    registerAppExport(appCmd);
     if (opts.includeInit) {
         registerAppInit(appCmd);
         registerAppSync(appCmd);
@@ -96,6 +97,9 @@ function registerAppSync(parent) {
      action-plugin postinstall 在 npm install 时缺平台 env 的卡点（需要时再
      FORCE_AUTHN_INNERAPI_DOMAIN=... npm install 手动跑一次）。
 
+  stack 未纳入 sync 范围（无 SyncConfig 且无 upgrade/templates/<stack>/，如 design-html
+  buildless 静态 HTML）→ 跳过同步（no-op, skipped=true），退出码 0，不阻断 dev/启动链路。
+
 JSON 输出
   {"data": {"stack": "...",
             "appliedRules": [{"type": "...", "action": "...", "path": "...", "detail": "..."}],
@@ -103,6 +107,7 @@ JSON 输出
             "mergedJsonFiles": [{"path": "...", "keys": [...]}],
             "patchedScripts": [...],
             "upgradedPackages": [{"name": "...", "from": "...", "to": "...", "section": "..."}]}}
+  跳过时：{"data": {"stack": "...", "skipped": true, "reason": "stack_not_in_sync_scope", ...空数组}}
 
 示例
   $ miaoda app sync
@@ -115,6 +120,54 @@ JSON 输出
         });
     }));
 }
+function registerAppExport(parent) {
+    const cmd = parent
+        .command('export <app-id>')
+        .description('导出指定应用的源码到本工程（创意应用升级：拉取创意稿作只读参考物）')
+        .option('--out <dir>', '输出目录（相对当前目录）', 'source_package/creative')
+        .option('--checkpoint <n>', '按检查点版本导出；缺省为最新提交（HEAD）')
+        .addHelpText('after', `
+说明
+  从服务端导出 <app-id> 对应应用（源应用，可以不是当前应用）的源码归档并解压到 --out
+  目录，导出完成后写 --out/.upgrade-manifest.json（含 sourceAppId / 导出时间 / 文件数），
+  供升级链路幂等判定与 skill 发现使用。调用者须为源应用协作者（服务端 DOWNLOAD 鉴权）。
+  请求以当前应用（MIAODA_APP_ID）为路径主体、源应用走 sourceAppID 参数。
+
+幂等
+  --out 已存在 manifest 且 sourceAppId 一致时跳过导出（skipped=true），重复调用安全。
+
+JSON 输出
+  {"data": {"appId": "...", "out": "source_package/creative", "fileCount": <n>,
+            "archiveName": "...", "skipped": false}}
+  跳过时：{"data": {"appId": "...", "out": "...", "skipped": true, "reason": "already_exported"}}
+
+失败
+  源应用无可导出内容（从未提交过代码）→ EXPORT_EMPTY_ARCHIVE，请先在源应用完成一轮创作。
+  无权限（非源应用协作者）→ 服务端鉴权错误透传。
+
+示例
+  $ miaoda app export app_demo_source
+  $ miaoda app export app_demo_source --out source_package/creative
+  $ miaoda app export app_demo_source --checkpoint 3
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (appId, rawOpts) => {
+        const checkpointRaw = rawOpts.checkpoint;
+        let checkpoint;
+        if (checkpointRaw !== undefined) {
+            checkpoint = Number(checkpointRaw);
+            if (!Number.isInteger(checkpoint) || checkpoint <= 0) {
+                (0, shared_1.failArgs)(`--checkpoint 须为正整数：${checkpointRaw}`);
+            }
+        }
+        await (0, index_1.handleAppExport)({
+            appId,
+            // path :appID 必须是当前沙箱应用（网关 AK 校验），从 MIAODA_APP_ID/app_id 解析
+            currentAppId: (0, shared_1.resolveAppId)({}),
+            out: rawOpts.out,
+            checkpoint,
+        });
+    }));
+}
 function registerAppGet(parent) {
     const cmd = parent
         .command('get')
@@ -183,8 +236,8 @@ function registerAppInit(parent) {
   env 未设置时回退到 meta.json.app_id。
 
 技术栈解析（--template / --app-type）
-  --template 传了      → 直接用（vite-react / html / nestjs-react-fullstack）
-  否则 --app-type 传了 → 查表：html→html, modern_html→html, jspage→vite-react, full_stack→nestjs-react-fullstack
+  --template 传了      → 直接用（vite-react / html / design-html / nestjs-react-fullstack）
+  否则 --app-type 传了 → 查表：html→design-html, modern_html→html, jspage→vite-react, full_stack→nestjs-react-fullstack
   两者都没传          → 报错 ARGS_INVALID
 
 源码导入（--source-path）
@@ -193,11 +246,11 @@ function registerAppInit(parent) {
   source-path 不存在 → 报错；非 modern_html 传了 source-path → 警告并忽略，继续正常 init。
   app_type 不写入 .spark/meta.json。
 
-平台同步（upgrade/templates）
-  init 内嵌一次 upgrade/templates 同步（跟 app upgrade 共用同一份 util）：
-  从 miaoda-cli 自带的 upgrade/templates/<stack>/ 同步 files/（覆盖）+ patches/
-  （JSON deep merge，含 scripts.dev:local 等）。目标 stack 未纳入 upgrade/templates/
-  时跳过（不报错）。后续要把 @lark-apaas/* 平台包统一指 latest，跑 'miaoda app upgrade'。
+平台同步（不在 init 内做）
+  init 不跑 'miaoda app sync' 的任何子动作（SyncRule 应用 / 平台脚本覆盖 / patches /
+  升 @lark-apaas/* 到 latest）。渲染出的 scripts/ 等是 template 包发版时的版本，
+  package.json 与 template 完全一致。首次同步交给 'miaoda app sync'：本地 dev.sh 入口
+  起服务前会先跑一次，沙箱 pod 启动阶段平台侧也会做，init 不重复。
 
 依赖安装
   默认：npm install --no-audit --no-fund

package/dist/cli/commands/deploy/modern.js

@@ -87,7 +87,7 @@ JSON 输出
             creates: rawOpts.create,
             updates: rawOpts.update,
             deletes: rawOpts.delete,
-            sessionId: rawOpts.sessionId,
+            sessionID: rawOpts.sessionId,
         });
     }));
 }

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

@@ -0,0 +1,185 @@
+"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.UPGRADE_MANIFEST_FILENAME = exports.DEFAULT_EXPORT_OUT = void 0;
+exports.handleAppExport = handleAppExport;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const api = __importStar(require("../../../api/index"));
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+const logger_1 = require("../../../utils/logger");
+/** 导出目录默认值：创意升级链路的参考物约定位置。 */
+exports.DEFAULT_EXPORT_OUT = 'source_package/creative';
+/** 升级 manifest 文件名：前置钩子幂等标记 / skill workspace-contains 锚点 / skill 第 0 步信息源。 */
+exports.UPGRADE_MANIFEST_FILENAME = '.upgrade-manifest.json';
+/** 解码后归档大小上限（对齐服务端 UploadHtmlArtifact 的 50MB 口径）。 */
+const MAX_ARCHIVE_BYTES = 50 * 1024 * 1024;
+/** 校验相对输出路径：禁绝对路径、禁含 ".." 段（与 deploy patch 的 normalizeRel 同口径）。 */
+function normalizeOutDir(rel) {
+    if (node_path_1.default.isAbsolute(rel) || rel.startsWith('/')) {
+        throw new error_1.AppError('ARGS_INVALID', `输出目录不能是绝对路径：${rel}`);
+    }
+    const posix = rel.split(node_path_1.default.sep).join('/').replace(/^\.\//, '');
+    if (posix.split('/').includes('..')) {
+        throw new error_1.AppError('ARGS_INVALID', `输出目录不能包含 "..":${rel}`);
+    }
+    return posix;
+}
+/**
+ * 按魔数识别归档格式并解压到 destDir。
+ * 服务端 GetCodeArchive 的归档名以 .zip 结尾，但底层 git archive 格式由 devops_platform
+ * 决定，历史文档亦有 tar.gz 记载 —— 两种都兼容，识别不了才报错。
+ */
+function extractArchive(archivePath, destDir, head) {
+    const isZip = head.length >= 4 && head[0] === 0x50 && head[1] === 0x4b;
+    const isGzip = head.length >= 2 && head[0] === 0x1f && head[1] === 0x8b;
+    if (isZip) {
+        (0, node_child_process_1.execFileSync)('unzip', ['-q', '-o', archivePath, '-d', destDir], { stdio: 'pipe' });
+        return;
+    }
+    if (isGzip) {
+        (0, node_child_process_1.execFileSync)('tar', ['-xzf', archivePath, '-C', destDir], { stdio: 'pipe' });
+        return;
+    }
+    throw new error_1.AppError('EXPORT_ARCHIVE_INVALID', '无法识别归档格式（非 zip / tar.gz）', {
+        next_actions: ['稍后重试 miaoda app export；持续失败请携带 log_id 反馈平台'],
+    });
+}
+function countFiles(dir) {
+    let count = 0;
+    const walk = (cur) => {
+        for (const entry of node_fs_1.default.readdirSync(cur, { withFileTypes: true })) {
+            if (entry.isDirectory())
+                walk(node_path_1.default.join(cur, entry.name));
+            else
+                count += 1;
+        }
+    };
+    walk(dir);
+    return count;
+}
+/**
+ * miaoda app export <app-id> [--out <dir>] [--checkpoint <n>]
+ *
+ * 创意应用升级链路：把源应用（创意稿）的源码从服务端导出到本工程，作为只读参考物。
+ * 链路：studio_server InnerGetCodeArchive（inner 通道，force 身份鉴权：调用者须为源应用
+ * 协作者）→ git archive → 本地解压 → 末尾写 .upgrade-manifest.json（幂等标记 +
+ * skill workspace-contains 锚点 + skill 第 0 步信息源）。
+ *
+ * URL 形状：path :appID 是当前沙箱应用（网关强校验其与沙箱 AK 一致），源应用走 query
+ * sourceAppID —— 跨应用（升级常态：新应用沙箱里导出源创意应用）必须如此。
+ *
+ * 幂等：--out 已存在 manifest 且 sourceAppId 一致时跳过导出直接返回（重试/多轮不重复拉取）。
+ */
+async function handleAppExport(opts) {
+    const appId = (opts.appId || '').trim();
+    if (!appId) {
+        throw new error_1.AppError('ARGS_INVALID', 'app-id 不能为空');
+    }
+    // 当前沙箱应用：网关 AK 校验要求 path :appID 与沙箱绑定应用一致
+    const currentAppId = (opts.currentAppId || '').trim();
+    if (!currentAppId) {
+        throw new error_1.AppError('APP_ID_MISSING', '未指定当前应用', {
+            next_actions: ['设置 export MIAODA_APP_ID=<id>'],
+        });
+    }
+    const outRel = normalizeOutDir(opts.out ?? exports.DEFAULT_EXPORT_OUT);
+    const outDir = node_path_1.default.resolve(process.cwd(), outRel);
+    const manifestPath = node_path_1.default.join(outDir, exports.UPGRADE_MANIFEST_FILENAME);
+    // 幂等：同源应用已导出过则直接复用（前置钩子重试 / 多轮对话不重复拉取）
+    if (node_fs_1.default.existsSync(manifestPath)) {
+        try {
+            const prev = JSON.parse(node_fs_1.default.readFileSync(manifestPath, 'utf-8'));
+            if (prev.sourceAppId === appId) {
+                (0, logger_1.log)('export', `Already exported (manifest matched), skip: ${outRel}`);
+                (0, output_1.emit)({ data: { appId, out: outRel, skipped: true, reason: 'already_exported' } });
+                return;
+            }
+        }
+        catch {
+            // manifest 损坏视为未导出，走覆盖导出
+        }
+    }
+    (0, logger_1.log)('export', `Fetching code archive of ${appId}...`);
+    const resp = await api.app.getCodeArchive({
+        appID: currentAppId,
+        sourceAppID: appId,
+        checkpointID: opts.checkpoint,
+    });
+    const fileBase64 = resp.file ?? '';
+    if (!fileBase64) {
+        throw new error_1.AppError('EXPORT_EMPTY_ARCHIVE', '源应用没有可导出的内容（可能从未提交过代码）', {
+            next_actions: ['请先在源应用完成一轮创作（至少一次成功提交）后重试 miaoda app export'],
+        });
+    }
+    const archive = Buffer.from(fileBase64, 'base64');
+    if (archive.length === 0) {
+        throw new error_1.AppError('EXPORT_EMPTY_ARCHIVE', '归档内容为空，请稍后重试');
+    }
+    if (archive.length > MAX_ARCHIVE_BYTES) {
+        throw new error_1.AppError('EXPORT_ARCHIVE_TOO_LARGE', `归档超过大小上限（${String(archive.length)} > ${String(MAX_ARCHIVE_BYTES)} bytes）`);
+    }
+    // 归档先落临时文件再解压；解压成功前不动已存在的 outDir 内容之外的文件
+    const tmpDir = node_fs_1.default.mkdtempSync(node_path_1.default.join(node_os_1.default.tmpdir(), 'miaoda-export-'));
+    const archivePath = node_path_1.default.join(tmpDir, resp.name ?? `${appId}.zip`);
+    try {
+        node_fs_1.default.writeFileSync(archivePath, archive);
+        node_fs_1.default.mkdirSync(outDir, { recursive: true });
+        (0, logger_1.log)('export', `Extracting to ${outRel}...`);
+        extractArchive(archivePath, outDir, archive.subarray(0, 4));
+    }
+    finally {
+        node_fs_1.default.rmSync(tmpDir, { recursive: true, force: true });
+    }
+    const fileCount = countFiles(outDir);
+    const manifest = {
+        sourceAppId: appId,
+        archiveName: resp.name ?? '',
+        checkpointId: opts.checkpoint ?? 0,
+        exportedAt: new Date().toISOString(),
+        fileCount,
+    };
+    node_fs_1.default.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n', 'utf-8');
+    (0, logger_1.log)('export', 'Exported successfully');
+    (0, output_1.emit)({
+        data: { appId, out: outRel, fileCount, archiveName: manifest.archiveName, skipped: false },
+    });
+}

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

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

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

@@ -54,7 +54,8 @@ const MANAGED_PLATFORM_PACKAGES = {
  * 执行流：
  *   1. SyncRule[] 全量 apply —— 来自 src/config/sync-configs/<stack>.ts。每个 stack
  *      自带模板资源在 upgrade/templates/<stack>/templates/。表里没有该 stack 时回退到
- *      旧 platform-sync 兜底（兼容尚未迁移的 stack）。
+ *      旧 platform-sync 兜底（兼容尚未迁移的 stack）；两者都识别不了（无 SyncConfig 且无
+ *      upgrade/templates/<stack>/）→ 跳过同步（no-op, skipped=true），不报错。
  *   2. 平台 deps 指 latest —— user app 已装的 @lark-apaas/* 按 MANAGED_PLATFORM_PACKAGES
  *      白名单改写为 "latest"（紧急止血时表里可填具体版本）。
  *   3. activateGitHooks —— 设置 core.hooksPath（template 自带 .githooks/pre-commit）。
@@ -71,14 +72,31 @@ async function handleAppSync(opts) {
     if (meta.stack === undefined || meta.stack === '') {
         throw new error_1.AppError('SYNC_META_INCOMPLETE', '.spark/meta.json missing stack — run `miaoda app init` first');
     }
-    // 1. apply SyncRule[]，stack 没注册时回退到旧 platform-sync 兜底；都不识别就报错
+    // 1. apply SyncRule[]，stack 没注册时回退到旧 platform-sync 兜底
     const syncResults = runStackSync(meta.stack, targetDir, 'sync');
+    // stack 未纳入 sync 范围（既无 SyncConfig 也无 upgrade/templates/<stack>/）：跳过同步（no-op），
+    // 不报错。sync 会在 dev.sh 本地入口 / 沙箱 pod 启动阶段被调用，对不需要 cli 侧 sync 的 stack
+    // （如 design-html buildless 静态 HTML）不该阻断启动链路。
     if (!syncResults.stackFound) {
-        throw new error_1.AppError('SYNC_STACK_NOT_SUPPORTED', `stack '${meta.stack}' has no SyncConfig and no upgrade/templates/${meta.stack}/ — 该 stack 暂未纳入 sync 范围`, {
-            next_actions: [
-                `src/config/sync-configs/${meta.stack}.ts 加 SyncConfig 并在 STACK_REGISTRY 注册`,
-            ],
+        (0, logger_1.log)('sync', `stack '${meta.stack}' 未纳入 sync 范围，跳过同步 (no-op)`);
+        if (!(0, output_1.isJsonMode)()) {
+            process.stdout.write(`⚠ stack '${meta.stack}' 未纳入 sync 范围，已跳过同步\n`);
+        }
+        (0, output_1.emit)({
+            data: {
+                stack: meta.stack,
+                skipped: true,
+                reason: 'stack_not_in_sync_scope',
+                appliedRules: [],
+                syncedFiles: [],
+                mergedJsonFiles: [],
+                patchedScripts: [],
+                upgradedPackages: [],
+                gitHooks: 'skipped',
+                installError: undefined,
+            },
         });
+        return;
     }
     // 2. activate git hooks（template 自带 .githooks/pre-commit，core.hooksPath 一次性设置）
     const hookActivation = (0, githooks_1.activateGitHooks)(targetDir);
@@ -138,8 +156,8 @@ exports.handleAppUpgrade = handleAppSync;
  * stack 在 STACK_REGISTRY 注册时走新 SyncRule 机制，否则回落到旧 platform-sync。
  *
  * stack 完全不识别（既不在 STACK_REGISTRY 也无 upgrade/templates/<stack>/ 目录）时返回
- * `stackFound: false` 而非抛错 —— 让调用方按场景决定：sync handler 抛 AppError，init handler
- * 允许（fresh init 时 stack 还在加注册的过渡期）。
+ * `stackFound: false` 而非抛错 —— 让调用方按场景决定：sync handler 跳过同步（no-op），init handler
+ * 也允许（fresh init 时 stack 还在加注册的过渡期）。
  */
 function runStackSync(stack, targetDir, logPrefix) {
     const config = (0, sync_configs_1.getSyncConfig)(stack);

package/dist/cli/handlers/deploy/patch.js

@@ -11,7 +11,7 @@ async function handleDeployPatch(opts) {
         creates: opts.creates,
         updates: opts.updates,
         deletes: opts.deletes,
-        sessionId: opts.sessionId,
+        sessionID: opts.sessionID,
     });
     (0, output_1.emit)({ data: result });
 }

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

@@ -263,6 +263,10 @@ exports.MIGRATE_CONFIG = {
                 'dotenv',
                 // client-toolkit：替代 lite，业务代码 codemod 后走它
                 '@lark-apaas/client-toolkit',
+                // drizzle-orm —— `gen:db-schema` 生成的 server/database/schema.ts 从
+                // 'drizzle-orm/pg-core' / 'drizzle-orm' 导入 pgTable / sql 等 runtime API,
+                // 缺依赖时 nest build / dev 起来直接 ERR_MODULE_NOT_FOUND。
+                'drizzle-orm',
             ],
             devDependencies: [
                 // nest start / nest build 必需

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

@@ -32,7 +32,7 @@ exports.SUPPORTED_STACKS = Object.keys(exports.TEMPLATE_PACKAGE_BY_STACK);
  * 与 src/api/app/types.ts 的 AppType 枚举无关，是独立的业务类型概念。
  */
 exports.STACK_BY_APP_TYPE = {
-    html: 'html',
+    html: 'design-html',
     modern_html: 'html',
     jspage: 'vite-react',
     full_stack: 'nestjs-react-fullstack',

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

@@ -34,7 +34,7 @@ async function patchDesignDeploy(opts) {
         appID: opts.appId,
         templateKey,
         actions,
-        sessionId: opts.sessionId,
+        sessionID: opts.sessionID,
     });
     (0, logger_1.log)('deploy', `Patched: upsert=${String(res.upsertCount)} delete=${String(res.deleteCount)}`);
     return {

package/dist/services/deploy/modern/pipelines/design-local.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.designLocalPublishPipeline = designLocalPublishPipeline;
-const spark_meta_1 = require("../../../../utils/spark-meta");
 const error_1 = require("../../../../utils/error");
 const logger_1 = require("../../../../utils/logger");
 const index_1 = require("../atoms/index");
@@ -38,9 +37,6 @@ async function designLocalPublishPipeline(opts) {
             await (0, index_1.finalizeLocalRelease)(ctx.appId, release.releaseID, index_1.LocalReleaseStatus.Failed);
             throw err;
         }
-        if (release.onlineUrl !== undefined && release.onlineUrl !== '') {
-            (0, spark_meta_1.writeSparkMeta)(ctx.projectDir, { appUrl: release.onlineUrl });
-        }
         (0, logger_1.log)('deploy', 'Deployed successfully');
         return {
             appId: ctx.appId,

package/dist/services/deploy/modern/pipelines/local.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.localBuildLocalPublishPipeline = localBuildLocalPublishPipeline;
-const spark_meta_1 = require("../../../../utils/spark-meta");
 const error_1 = require("../../../../utils/error");
 const logger_1 = require("../../../../utils/logger");
 const index_1 = require("../atoms/index");
@@ -64,9 +63,6 @@ async function localBuildLocalPublishPipeline(opts) {
         await (0, index_1.finalizeLocalRelease)(ctx.appId, release.releaseID, index_1.LocalReleaseStatus.Failed);
         throw err;
     }
-    if (release.onlineUrl !== undefined && release.onlineUrl !== '') {
-        (0, spark_meta_1.writeSparkMeta)(ctx.projectDir, { appUrl: release.onlineUrl });
-    }
     (0, logger_1.log)('deploy', 'Deployed successfully');
     return {
         appId: ctx.appId,

package/package.json

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