@lark-apaas/miaoda-cli 0.1.21-alpha.0 → 0.1.21-beta.71cd6c4

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/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

@@ -161,34 +161,6 @@ async function handleAppMigrate(opts) {
             }
         }
     }
-    // 预热 vite deps cache (清 .vite 之后, pkill 之前) —— 把 standalone optimize
-    // 提前在干净状态下跑一次, 写出 _metadata.json + 当前 lockfileHash。下一步 pkill
-    // 让 supervisor 重启 dev:client, vite 启动检测到 metadata.lockfileHash 跟当前
-    // lockfile 一致, 跳过 Re-optimize, 也就跳过了 incremental optimization 中
-    // transform cache 跟 deps middleware metadata 短暂不同步那个窗口(详见
-    // fullstack-plugin#1152 的 504 fix 讨论)。
-    //
-    // 顺序约束:必须在清 .vite 之后(否则 prewarm 写的 metadata 会被清掉, 白干)
-    // 也必须在 pkill 之前(否则 supervisor 拉起的 vite 已经 cold start, prewarm
-    // 没机会赶在它前面写 metadata)。
-    //
-    //   - 只在 SANDBOX_ID 非空时做(本地环境 vite 自带 optimizer 不卡, 没必要拖慢 migrate)
-    //   - 只在 install 成功时做(install 失败时 node_modules 状态不对, optimize 也会挂)
-    //   - 软失败:optimize 挂了不阻断后续 pkill —— 即使没预热成功, supervisor 起的
-    //     vite 自己跑 optimizer 大多数场景能通过, 不要因为这一步丢掉重启 dev 的机会
-    if (installError === undefined && (0, env_1.isSandboxEnv)()) {
-        (0, logger_1.log)('migrate', 'Pre-warming vite deps cache (vite optimize --force)...');
-        try {
-            (0, node_child_process_1.execFileSync)('npx', ['-y', 'vite', 'optimize', '--force'], {
-                cwd: targetDir,
-                stdio: (0, output_1.isJsonMode)() ? ['ignore', 'ignore', 'inherit'] : 'inherit',
-                timeout: 120_000,
-            });
-        }
-        catch (err) {
-            (0, logger_1.log)('migrate', `⚠ vite optimize prewarm failed (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/config/migrate-configs/vite-react-to-nestjs-react-fullstack.js

@@ -70,6 +70,11 @@ exports.MIGRATE_CONFIG = {
         // ESLint 9 flat config —— vite-react 用 eslint.config.mjs 已删，fullstack 用
         // eslint.config.js (commonjs) + extends @lark-apaas/fullstack-presets；user 通常不改
         { type: 'file', from: 'eslint.config.js', to: 'eslint.config.js', overwrite: true },
+        // stylelint 配置 —— package.json 加了 `stylelint` script（下面 add-script 那条）
+        // + npm run precommit 会调它，缺配置文件时报 `No configuration provided for
+        // client/src/index.css`。fullstack template 的 .stylelintrc.js extends
+        // @lark-apaas/fullstack-presets 的 stylelintPresetsOfSimple。
+        { type: 'file', from: '.stylelintrc.js', to: '.stylelintrc.js', overwrite: true },
         // client/index.html：HBS 模板（fullstack 用，vite-react 用根 index.html 已删）
         { type: 'file', from: 'client/index.html', to: 'client/index.html', overwrite: true },
         // scripts/ 整目录：fullstack 形态启动 / 构建 / lint 所需的 8 个平台脚本（dev.sh /
@@ -274,6 +279,10 @@ exports.MIGRATE_CONFIG = {
                 // （@lark-apaas/fullstack-presets/lib/simple/tsconfig/tsconfig.node.json）;
                 // 不装会导致 nest build / type:check:server / vite dev 解析 tsconfig 时 ENOENT
                 '@lark-apaas/fullstack-presets',
+                // stylelint —— scripts.stylelint + npm run precommit 会调它,
+                // 缺依赖时 CI / 本地 precommit 报 "stylelint: command not found"。
+                // 配套的 .stylelintrc.js 由上面 file rule 从 template 搬过来。
+                'stylelint',
             ],
         },
         // ===== 7. 业务代码 codemod：lite → client-toolkit 包名替换 =====

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.21-alpha.0",
+  "version": "0.1.21-beta.71cd6c4",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {