@lark-apaas/miaoda-cli 0.1.19 → 0.1.20-alpha.dd573f8

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

@@ -164,6 +164,8 @@ function registerAppInit(parent) {
         .command('init')
         .description('初始化应用代码：抓 template 渲染、同步 upgrade/templates、装 .agent/steering/ skills、写 .spark/meta.json。.spark/meta.json 已存在则直接退出')
         .option('--template <stack>', `技术栈短名（${index_1.SUPPORTED_STACKS.join(' / ')}）`)
+        .option('--app-type <type>', 'aPaaS 业务类型（html / modern_html / jspage / full_stack）；未传 --template 时用于解析技术栈')
+        .option('--source-path <path>', '导入源目录：把该目录内容聚合进脚手架 src/（当前仅 --app-type modern_html 生效）')
         .option('--conf <json>', 'init 配置 JSON。支持 {"version": "<template 版本>"}，默认 latest')
         .option('--skip-install', '跳过依赖安装', false)
         .option('--async-install', '派发后台进程装依赖并立即返回（与 --skip-install 互斥）', false)
@@ -180,6 +182,17 @@ function registerAppInit(parent) {
   未提供则不写。运行端命令（deploy / file / plugin 等）仍优先读 MIAODA_APP_ID env，
   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
+  两者都没传          → 报错 ARGS_INVALID
+
+源码导入（--source-path）
+  仅 --app-type modern_html 生效：把 <source-path> 整个目录递归聚合进 src/（同名覆盖，叠加保留）。
+  过滤：跳过 node_modules/.git/dist/build 目录，跳过 .env/.env.*/.DS_Store/.npmrc/package.json/lockfiles。
+  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/
@@ -208,7 +221,8 @@ function registerAppInit(parent) {
 JSON 输出
   已初始化：{"data": {"initialized": false, "reason": "already_initialized", "targetDir": "..."}}
   新初始化：{"data": {"initialized": true, "template": "...", "templateVersion": "...", "steeringVersion": "...",
-                     "appId": "...", "platformStackFound": true, "platformSyncedFiles": [...],
+                     "appId": "...", "appType": "modern_html", "sourceImported": true, "importedFileCount": 7,
+                     "platformStackFound": true, "platformSyncedFiles": [...],
                      "installed": true, "installSource": "cache|npm|skipped", "installHash": "...", ...}}
   async 模式：{"data": {"initialized": true, "asyncInstall": true, "installed": false,
                       "installSource": "async", "installPid": 123, "installLogPath": "...",
@@ -220,12 +234,16 @@ JSON 输出
   $ miaoda app init --template vite-react --conf '{"version": "0.1.0"}'
   $ miaoda app init --template vite-react --skip-install
   $ miaoda app init --template vite-react --async-install
+  $ miaoda app init --app-type full_stack --app-id app_demo_xxx
+  $ miaoda app init --app-type modern_html --source-path ./my-assets
   $ MIAODA_DEP_CACHE_DIR=/tmp/dep-cache miaoda app init --template vite-react
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
         const conf = parseInitConf(rawOpts.conf);
         await (0, index_1.handleAppInit)({
             template: rawOpts.template,
+            appType: rawOpts.appType,
+            sourcePath: rawOpts.sourcePath,
             conf,
             skipInstall: rawOpts.skipInstall,
             appId: rawOpts.appId,

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

@@ -481,7 +481,6 @@ Examples:
         '应用到 online；online 将无法直接更改数据库结构（仍可进行数据 DML 操作）。')
         .usage('[flags]')
         .option('--sync-data', '启用时将现有数据同步一份到 dev 环境')
-        .option('-y, --yes', '跳过确认提示直接执行')
         .action(async function () {
         await (0, index_1.handleDbMigrationInit)(this.optsWithGlobals());
     })
@@ -562,7 +561,6 @@ Examples:
         .summary('将 dev 的变更发布到 online（单事务原子）')
         .description('将 dev 的变更发布到 online。')
         .usage('[flags]')
-        .option('-y, --yes', '跳过确认提示直接执行')
         .action(async function () {
         await (0, index_1.handleDbMigrationApply)(this.optsWithGlobals());
     })
@@ -681,7 +679,6 @@ Examples:
         .description('将数据库恢复到指定时间点的状态。')
         .usage('<timestamp> [flags]')
         .argument('<timestamp>', '目标时间')
-        .option('-y, --yes', '跳过确认提示直接执行')
         .action(async function (target) {
         await (0, index_1.handleDbRecoveryApply)(target, this.optsWithGlobals());
     })

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

@@ -146,9 +146,10 @@ Examples:
         .usage('[paths...] [flags]')
         .argument('[paths...]', '要删除的文件，每项可填路径或文件名（自动识别）')
         .option('-n, --name <name>', '按文件名删除（可重复指定）', (value, prev) => [...(prev ?? []), value])
-        .option('-y, --yes', '跳过交互确认；非交互场景必加')
-        .action(async (paths, opts) => {
-        await (0, index_1.handleFileRm)(paths, { ...opts, appId: (0, shared_1.resolveAppId)({}) });
+        // --yes 是 root 全局 option（见 main.ts），不在此重复声明；必须经 optsWithGlobals
+        // 读取（值挂在 root 上，本地 this.opts().yes 为 undefined），否则非交互场景确认门会误拦。
+        .action(async function (paths) {
+        await (0, index_1.handleFileRm)(paths, { ...this.optsWithGlobals(), appId: (0, shared_1.resolveAppId)({}) });
     })
         .addHelpText('after', `
 Notes:

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

@@ -51,23 +51,15 @@ async function handleAppInit(opts) {
         });
         return;
     }
-    const stack = opts.template;
-    if (!stack) {
-        throw new error_1.AppError('ARGS_INVALID', '缺少 --template <stack>', {
-            next_actions: [`可用 stack：${index_1.SUPPORTED_STACKS.join(', ')}`],
-        });
-    }
-    if (!index_1.SUPPORTED_STACKS.includes(stack)) {
-        throw new error_1.AppError('ARGS_INVALID', `不支持的 template: ${stack}`, {
-            next_actions: [`可用 stack：${index_1.SUPPORTED_STACKS.join(', ')}`],
-        });
-    }
+    const stack = (0, index_1.resolveStack)({ template: opts.template, appType: opts.appType });
     if (opts.asyncInstall && opts.skipInstall) {
         throw new error_1.AppError('ARGS_INVALID', '--async-install 与 --skip-install 互斥');
     }
     const version = opts.conf?.version;
     const projectName = node_path_1.default.basename(targetDir);
     const tplResult = (0, index_1.renderTemplate)({ stack, version, targetDir, projectName });
+    // source_path 导入：当前仅 app_type=modern_html 生效。渲染完模板后、装依赖前叠加进 src/。
+    const sourceImport = applySourcePathImport(opts, targetDir);
     // 先建 logs/,防止 user 跑 dev 之前 AI/工具 redirect 到 logs/*.log 因为父目录不存在直接挂
     // (dev.js / dev-local.js 自己也建 logs/,但只在它启动后;启动前的 shell redirect 会先于此)
     (0, logs_dir_1.ensureLogsDir)(targetDir);
@@ -135,6 +127,11 @@ async function handleAppInit(opts) {
             steeringVersion: steeringResult.version,
             archType: tplResult.archType,
             appId: opts.appId,
+            appType: opts.appType,
+            sourcePath: opts.sourcePath,
+            sourceImported: sourceImport.sourceImported,
+            importedFileCount: sourceImport.importedFileCount,
+            sourceIgnoredReason: sourceImport.sourceIgnoredReason,
             syncedSkills: steeringResult.syncedSkills,
             techSynced: steeringResult.techSynced,
             steeringError,
@@ -159,3 +156,25 @@ async function handleAppInit(opts) {
         },
     });
 }
+/**
+ * 处理 --source-path 导入：当前仅 app_type=modern_html 生效。
+ *   - 未传 source_path → 什么都不做
+ *   - modern_html → 调 importSourceSrc 把源目录聚合进 targetDir/src/
+ *   - 传了 source_path 但非 modern_html → 警告并忽略，继续正常 init（退出码 0）
+ * 终端提示留在 handler 层（service 不做终端输出）。
+ */
+function applySourcePathImport(opts, targetDir) {
+    // 真值判断：未传或空串都视为"无 source_path"。
+    if (!opts.sourcePath) {
+        return { sourceImported: false };
+    }
+    if (opts.appType === 'modern_html') {
+        const { importedFileCount } = (0, index_1.importSourceSrc)({ sourcePath: opts.sourcePath, targetDir });
+        return { sourceImported: true, importedFileCount };
+    }
+    (0, logger_1.log)('init', '⚠ source-path ignored: 仅 app_type=modern_html 支持 source_path 导入');
+    if (!(0, output_1.isJsonMode)()) {
+        process.stdout.write('⚠ 不支持 source_path（仅 app_type=modern_html 生效），已忽略\n');
+    }
+    return { sourceImported: false, sourceIgnoredReason: 'not_modern_html' };
+}

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

@@ -135,6 +135,32 @@ async function handleAppMigrate(opts) {
         installError = err instanceof Error ? err.message : String(err);
         (0, logger_1.log)('migrate', `⚠ npm install failed (continuing): ${installError}`);
     }
+    // 重启 dev process 前清 vite cache —— migrate 改了 package.json + lockfile,
+    // 老 vite 进程的 .vite/deps cache 的 lockfileHash 跟新 lockfile 不一致。
+    // 不清的话 supervisor 拉起的新 vite cold start 会立即 "Re-optimizing because
+    // lockfile has changed", re-optimize 期间 ModuleGraph transform cache 跟
+    // deps middleware metadata 短暂不同步, 浏览器请求老 hash 触发
+    // ERR_OUTDATED_OPTIMIZED_DEP → 504 死锁(详见 fullstack-plugin#1143 的 504
+    // ignoreOutdatedRequests fix 注释)。直接 rm -rf 让新 vite 从干净状态 cold
+    // optimize, 一次写到位 lockfile 一致的 metadata, 不再触发中途 re-optimize。
+    //
+    //   - 只在 SANDBOX_ID 非空时做(本地一般不会撞这条链路)
+    //   - 只在 install 成功时做(install 挂了 node_modules 状态不对, 清 cache 也救不回来)
+    //   - 软失败:.vite 不存在 / 删失败都不阻断
+    if (installError === undefined &&
+        process.env.SANDBOX_ID !== undefined &&
+        process.env.SANDBOX_ID !== '') {
+        const viteCacheDir = node_path_1.default.join(targetDir, 'node_modules', '.vite');
+        if (node_fs_1.default.existsSync(viteCacheDir)) {
+            (0, logger_1.log)('migrate', '清理 node_modules/.vite (vite cache 跟新 lockfile 错位会 504)...');
+            try {
+                node_fs_1.default.rmSync(viteCacheDir, { recursive: true, force: true });
+            }
+            catch (err) {
+                (0, logger_1.log)('migrate', `⚠ 清 .vite 失败 (continuing): ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+    }
     // 沙箱环境下重启 dev process —— scripts/dev.js 被 fullstack 版本覆盖了,但当前正在
     // 跑的 node 进程仍按老逻辑工作(只起 vite,没起 nest),整体没切到 fullstack 模式。
     // 通过 pkill 杀掉 dev.js 主进程,依赖沙箱平台 supervisor 自动重新 exec dev.sh → dev.js,

package/dist/main.js

@@ -30,6 +30,9 @@ program
     .argParser((0, shared_1.caseInsensitiveChoice)(['pretty', 'json']))
     .default('pretty'))
     .option('--verbose', 'debug 日志到 stderr')
+    // 全局接受 -y/--yes：作为 root 全局 option 下发到所有子命令解析（同 --json/--verbose），
+    // 让任意命令带 --yes 都不报 unknown option。对有确认门的破坏性命令生效，其余命令忽略。
+    .option('-y, --yes', '跳过确认提示（对有确认门的命令生效，其余命令忽略）')
     .helpOption('-h, --help', '显示帮助信息')
     .hook('preAction', (_thisCmd, actionCmd) => {
     (0, log_id_1.generateLogId)();

package/dist/services/app/init/import-source.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IMPORT_SKIP_FILES = exports.IMPORT_SKIP_DIRS = void 0;
+exports.importSourceSrc = importSourceSrc;
+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");
+/** 导入时跳过的目录名（任意层级命中即整目录跳过）。 */
+exports.IMPORT_SKIP_DIRS = new Set(['node_modules', '.git', 'dist', 'build']);
+/** 导入时跳过的精确文件名。`.env.*`（如 .env.local）另由前缀规则处理。 */
+exports.IMPORT_SKIP_FILES = new Set([
+    '.env',
+    '.DS_Store',
+    '.npmrc',
+    'package.json',
+    'package-lock.json',
+    'yarn.lock',
+    'pnpm-lock.yaml',
+]);
+function isSkippedFile(name) {
+    if (exports.IMPORT_SKIP_FILES.has(name))
+        return true;
+    // .env.local / .env.production 等一律跳过
+    if (name.startsWith('.env.'))
+        return true;
+    return false;
+}
+/**
+ * 把整个 sourcePath 递归拷进 targetDir/src/（叠加，同名覆盖，不删目标已有文件），
+ * 按 IMPORT_SKIP_DIRS / IMPORT_SKIP_FILES 过滤。
+ * sourcePath 不存在或非目录 → 抛 ARGS_INVALID。
+ */
+function importSourceSrc(opts) {
+    const sourcePath = node_path_1.default.resolve(opts.sourcePath);
+    if (!node_fs_1.default.existsSync(sourcePath) || !node_fs_1.default.statSync(sourcePath).isDirectory()) {
+        throw new error_1.AppError('ARGS_INVALID', `--source-path 不存在或不是目录: ${opts.sourcePath}`);
+    }
+    const destSrc = node_path_1.default.join(opts.targetDir, 'src');
+    node_fs_1.default.mkdirSync(destSrc, { recursive: true });
+    let count = 0;
+    const walk = (relDir) => {
+        const absDir = node_path_1.default.join(sourcePath, relDir);
+        for (const entry of node_fs_1.default.readdirSync(absDir, { withFileTypes: true })) {
+            if (entry.isDirectory()) {
+                if (exports.IMPORT_SKIP_DIRS.has(entry.name))
+                    continue;
+                walk(node_path_1.default.join(relDir, entry.name));
+            }
+            else if (entry.isFile()) {
+                if (isSkippedFile(entry.name))
+                    continue;
+                const rel = node_path_1.default.join(relDir, entry.name);
+                const dest = node_path_1.default.join(destSrc, rel);
+                node_fs_1.default.mkdirSync(node_path_1.default.dirname(dest), { recursive: true });
+                node_fs_1.default.copyFileSync(node_path_1.default.join(sourcePath, rel), dest);
+                count += 1;
+            }
+        }
+    };
+    walk('.');
+    (0, logger_1.log)('init', `Imported ${String(count)} file(s) from ${sourcePath} → src/`);
+    return { importedFileCount: count };
+}

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

@@ -1,10 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ASYNC_INSTALL_LOG = exports.runAsyncInstallWorker = exports.dispatchAsyncInstall = exports.resolveNpmInstallRegistry = exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.TEMPLATE_PACKAGE_BY_STACK = exports.SUPPORTED_STACKS = exports.renderTemplate = void 0;
+exports.ASYNC_INSTALL_LOG = exports.runAsyncInstallWorker = exports.dispatchAsyncInstall = exports.resolveNpmInstallRegistry = exports.installDependencies = exports.writeSparkMeta = exports.readSparkMeta = exports.IMPORT_SKIP_FILES = exports.IMPORT_SKIP_DIRS = exports.importSourceSrc = exports.TEMPLATE_PACKAGE_BY_STACK = exports.STACK_BY_APP_TYPE = exports.APP_TYPES = exports.SUPPORTED_STACKS = exports.resolveStack = exports.renderTemplate = void 0;
 var template_1 = require("./template");
 Object.defineProperty(exports, "renderTemplate", { enumerable: true, get: function () { return template_1.renderTemplate; } });
+Object.defineProperty(exports, "resolveStack", { enumerable: true, get: function () { return template_1.resolveStack; } });
 Object.defineProperty(exports, "SUPPORTED_STACKS", { enumerable: true, get: function () { return template_1.SUPPORTED_STACKS; } });
+Object.defineProperty(exports, "APP_TYPES", { enumerable: true, get: function () { return template_1.APP_TYPES; } });
+Object.defineProperty(exports, "STACK_BY_APP_TYPE", { enumerable: true, get: function () { return template_1.STACK_BY_APP_TYPE; } });
 Object.defineProperty(exports, "TEMPLATE_PACKAGE_BY_STACK", { enumerable: true, get: function () { return template_1.TEMPLATE_PACKAGE_BY_STACK; } });
+var import_source_1 = require("./import-source");
+Object.defineProperty(exports, "importSourceSrc", { enumerable: true, get: function () { return import_source_1.importSourceSrc; } });
+Object.defineProperty(exports, "IMPORT_SKIP_DIRS", { enumerable: true, get: function () { return import_source_1.IMPORT_SKIP_DIRS; } });
+Object.defineProperty(exports, "IMPORT_SKIP_FILES", { enumerable: true, get: function () { return import_source_1.IMPORT_SKIP_FILES; } });
 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; } });

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

@@ -3,7 +3,8 @@ 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.APP_TYPES = exports.STACK_BY_APP_TYPE = exports.SUPPORTED_STACKS = exports.TEMPLATE_PINNED_VERSION_BY_STACK = exports.TEMPLATE_PACKAGE_BY_STACK = void 0;
+exports.resolveStack = resolveStack;
 exports.renderTemplate = renderTemplate;
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
@@ -25,6 +26,51 @@ exports.TEMPLATE_PACKAGE_BY_STACK = {
  */
 exports.TEMPLATE_PINNED_VERSION_BY_STACK = {};
 exports.SUPPORTED_STACKS = Object.keys(exports.TEMPLATE_PACKAGE_BY_STACK);
+/**
+ * app_type（业务类型）→ stack 短名映射。仅在调用方未显式传 --template 时用于解析 stack。
+ * 与 src/api/app/types.ts 的 AppType 枚举无关，是独立的业务类型概念。
+ */
+exports.STACK_BY_APP_TYPE = {
+    html: 'html',
+    modern_html: 'html',
+    jspage: 'vite-react',
+    full_stack: 'nestjs-react-fullstack',
+};
+exports.APP_TYPES = Object.keys(exports.STACK_BY_APP_TYPE);
+/**
+ * 解析要用的 stack（template-first）：
+ *   1. template 传了 → 直接用（SUPPORTED_STACKS 校验）
+ *   2. 否则 appType 传了 → 按 STACK_BY_APP_TYPE 查表
+ *   3. 都没传 → ARGS_INVALID
+ * 非法 template / 非法 appType 均抛 ARGS_INVALID。
+ */
+function resolveStack(opts) {
+    const { template, appType } = opts;
+    // 用真值判断（非 undefined/null/空串）：空串视为未传，回落到 appType。
+    if (template) {
+        if (!exports.SUPPORTED_STACKS.includes(template)) {
+            throw new error_1.AppError('ARGS_INVALID', `不支持的 template: ${template}`, {
+                next_actions: [`可用 stack：${exports.SUPPORTED_STACKS.join(', ')}`],
+            });
+        }
+        return template;
+    }
+    if (appType) {
+        const stack = exports.STACK_BY_APP_TYPE[appType];
+        if (!stack) {
+            throw new error_1.AppError('ARGS_INVALID', `不支持的 app_type: ${appType}`, {
+                next_actions: [`可用 app_type：${exports.APP_TYPES.join(', ')}`],
+            });
+        }
+        return stack;
+    }
+    throw new error_1.AppError('ARGS_INVALID', '缺少 --template 或 --app-type', {
+        next_actions: [
+            `可用 stack：${exports.SUPPORTED_STACKS.join(', ')}`,
+            `可用 app_type：${exports.APP_TYPES.join(', ')}`,
+        ],
+    });
+}
 // template/ 内以下划线开头的占位文件名在渲染时改名。
 // 原因：
 //   1. npm pack 强制剥的：.npmrc（防 auth token 泄露）

package/package.json

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