@lark-apaas/miaoda-cli 0.1.20-alpha.dd573f8 → 0.1.20-beta.4eeca5a

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

@@ -164,8 +164,6 @@ 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)
@@ -182,17 +180,6 @@ 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/
@@ -221,8 +208,7 @@ function registerAppInit(parent) {
 JSON 输出
   已初始化：{"data": {"initialized": false, "reason": "already_initialized", "targetDir": "..."}}
   新初始化：{"data": {"initialized": true, "template": "...", "templateVersion": "...", "steeringVersion": "...",
-                     "appId": "...", "appType": "modern_html", "sourceImported": true, "importedFileCount": 7,
-                     "platformStackFound": true, "platformSyncedFiles": [...],
+                     "appId": "...", "platformStackFound": true, "platformSyncedFiles": [...],
                      "installed": true, "installSource": "cache|npm|skipped", "installHash": "...", ...}}
   async 模式：{"data": {"initialized": true, "asyncInstall": true, "installed": false,
                       "installSource": "async", "installPid": 123, "installLogPath": "...",
@@ -234,16 +220,12 @@ 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,15 +51,23 @@ async function handleAppInit(opts) {
         });
         return;
     }
-    const stack = (0, index_1.resolveStack)({ template: opts.template, appType: opts.appType });
+    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(', ')}`],
+        });
+    }
     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);
@@ -127,11 +135,6 @@ 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,
@@ -156,25 +159,3 @@ 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/config/migrate-configs/vite-react-to-nestjs-react-fullstack.js

@@ -67,9 +67,26 @@ exports.MIGRATE_CONFIG = {
         { type: 'file', from: 'tsconfig.json', to: 'tsconfig.json', overwrite: true },
         { type: 'file', from: 'tsconfig.app.json', to: 'tsconfig.app.json', overwrite: true },
         { type: 'file', from: 'tsconfig.node.json', to: 'tsconfig.node.json', overwrite: true },
+        // vite-react template 的 tsconfig 里有 exclude: ["src/components/ui"]，把 shadcn 组件目录
+        // 整个从 typecheck 排除 —— 因为 template 里 shadcn 组件是老写法（recharts 2.x / RP v3 API），
+        // 但 dep 已经装到 recharts 3.x / RP v4 新版，两侧错配靠 exclude 藏起来。
+        // fullstack template 的 tsconfig 没这条 exclude，migrate 覆盖后 user 老 shadcn 组件
+        // (client/src/components/ui/*.tsx) 立刻被 tsc 扫到，chart.tsx / resizable.tsx 类型 / 命名报错。
+        // 这里在覆盖 tsconfig.app.json 之后补一行 exclude，跟 vite-react 行为对齐。
+        {
+            type: 'add-json-array-items',
+            to: 'tsconfig.app.json',
+            path: ['exclude'],
+            items: ['client/src/components/ui'],
+        },
         // 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 +291,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/index.js

@@ -1,17 +1,10 @@
 "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.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;
+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;
 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,8 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-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.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"));
@@ -26,51 +25,6 @@ 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/dist/utils/sync-rule.js

@@ -109,6 +109,9 @@ function applyOne(rule, opts) {
         case 'merge-json': {
             return applyMergeJson(rule, sourceRoot, targetDir, logPrefix);
         }
+        case 'add-json-array-items': {
+            return applyAddJsonArrayItems(rule, targetDir, logPrefix);
+        }
         case 'directory': {
             const src = node_path_1.default.join(sourceRoot, rule.from);
             const dest = node_path_1.default.join(targetDir, rule.to);
@@ -257,6 +260,53 @@ function applyMergeJson(rule, sourceRoot, targetDir, logPrefix) {
     (0, logger_1.log)(logPrefix, `  ✓ ${rule.to} (merged: ${keys})`);
     return { rule, action: 'merged', path: rule.to, detail: keys };
 }
+function applyAddJsonArrayItems(rule, targetDir, logPrefix) {
+    const dest = node_path_1.default.join(targetDir, rule.to);
+    if (!node_fs_1.default.existsSync(dest)) {
+        (0, logger_1.log)(logPrefix, `  ○ ${rule.to} (not found, skip add-json-array-items)`);
+        return { rule, action: 'skipped', path: rule.to };
+    }
+    const originalText = node_fs_1.default.readFileSync(dest, 'utf-8');
+    // 读一次拿数组当前值来判断幂等；jsonc 兼容 trailing comma / 注释。
+    const errors = [];
+    const root = jsonc.parse(originalText, errors, { allowTrailingComma: true });
+    if (errors.length > 0) {
+        const first = errors[0];
+        throw new Error(`${rule.to}: jsonc parse error ${jsonc.printParseErrorCode(first.error)} at offset ${String(first.offset)}`);
+    }
+    // 沿 rule.path 走到目标节点
+    let node = root;
+    for (const seg of rule.path) {
+        if (node && typeof node === 'object' && seg in node) {
+            node = node[seg];
+        }
+        else {
+            node = undefined;
+            break;
+        }
+    }
+    if (!Array.isArray(node)) {
+        (0, logger_1.log)(logPrefix, `  ○ ${rule.to} (path ${rule.path.join('.')} is not an array, skip)`);
+        return { rule, action: 'skipped', path: rule.to };
+    }
+    const existing = new Set(node.filter((v) => typeof v === 'string'));
+    const toAdd = rule.items.filter((it) => !existing.has(it));
+    if (toAdd.length === 0) {
+        (0, logger_1.log)(logPrefix, `  ○ ${rule.to} (${rule.path.join('.')} already has all items)`);
+        return { rule, action: 'noop', path: rule.to };
+    }
+    // jsonc.modify 逐项 append，保留缩进 / 注释 / trailing comma。
+    let text = originalText;
+    for (const item of toAdd) {
+        const edits = jsonc.modify(text, [...rule.path, -1], item, {
+            formattingOptions: { insertSpaces: true, tabSize: 2 },
+        });
+        text = jsonc.applyEdits(text, edits);
+    }
+    node_fs_1.default.writeFileSync(dest, text);
+    (0, logger_1.log)(logPrefix, `  ✓ ${rule.to} (${rule.path.join('.')} += ${toAdd.map((s) => JSON.stringify(s)).join(', ')})`);
+    return { rule, action: 'patched', path: rule.to, detail: toAdd.join(',') };
+}
 /**
  * 用 jsonc-parser 读 user 端 JSON 文件，兼容 tsconfig/nest-cli.json 等带 trailing comma 或
  * 注释的配置。模板侧严格 JSON 走 JSON.parse 也能通，统一走 jsonc 简化代码。

package/package.json

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

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

@@ -1,67 +0,0 @@
-"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 };
-}