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

package/README.md

@@ -11,17 +11,12 @@ pnpm add -g @lark-apaas/miaoda-cli
 ## 使用
 
 ```bash
-# 设置默认应用（需要应用上下文的命令从 MIAODA_APP_ID 读取）
+# 设置默认应用（需要应用上下文的命令可用 --app-id 覆盖）
 export MIAODA_APP_ID=app_demo_xxx
 
 # 文件操作
 miaoda file ls
 miaoda file upload ./local/path
-
-# 评论操作
-miaoda comment list --json
-miaoda comment list --only-unresolved --json
-miaoda comment resolve 1703677660120110076 --json
 ```
 
 JSON 结构化输出（Agent 推荐）：
@@ -46,38 +41,9 @@ miaoda file ls --output json
 | `miaoda file ...`          | 文件操作：上传、下载、元数据、签名下载、批量删除     |
 | `miaoda db ...`            | 数据操作：SQL 执行、表结构查询、数据导入导出         |
 | `miaoda observability ...` | 线上日志、链路、前端源码堆栈反查、监控指标、运营指标 |
-| `miaoda comment ...`       | 应用评论：查看评论列表、解决评论                     |
-| `miaoda registry ...`      | 组件 registry：列出 / copy-in design-html SDK 文件（本地执行）     |
 
 完整命令通过 `miaoda --help` 或 `miaoda <domain> --help` 查看。
 
-## 组件 registry（design-html）
-
-`miaoda registry` 为 design-html 技术栈提供 shadcn 式的「组件 registry」：把 SDK 文件**拷进**当前项目（copy-in），而非作为依赖安装。registry 是独立 npm 包，按运行时分发（design-html → buildless runtime → `@lark-apaas/coding-registry-buildless`）。
-
-前置：当前目录（或 `--dir`）已走过 `miaoda app init`，`.spark/meta.json` 含 `stack=design-html`。
-
-```bash
-# 列出可用 SDK 条目（输出各文件 USAGE 注释块原文，便于 Agent 直接读用法）
-miaoda registry list
-miaoda registry list --json
-
-# 把条目 copy-in 到当前项目（自动按 USAGE 块的 Depends 解析依赖闭包一并拷入）
-miaoda registry add deck-slide
-miaoda registry add foo.css theme --dry-run        # 只报告将写 / 将跳，不落盘
-miaoda registry add deck-slide --overwrite         # 目标已存在时覆盖（默认跳过以保护改动）
-```
-
-要点：
-
-- **条目**：registry 包根 `components/` · `scripts/` · `stylesheets/` 三个顶层目录（任意深度）下的代码文件即条目。USAGE 注释块**可选**（有则提供描述 + Depends，无则空描述、无依赖）；包根直放文件、其它目录、非代码文件都不算条目。
-- **寻址**：`add` / `Depends` 的 token 可写三种形式 —— `name`（去扩展名，如 `foo`）/ 完整文件名（如 `foo.css`）/ relPath（如 `stylesheets/foo.css`）。`name` **不要求唯一**，`list --json` 的 `file`（relPath）是永远无歧义的 canonical 地址。
-- **多匹配全拉**：token 命中多个同名条目时全部 copy-in（如 `add foo` 把 `foo.jsx` + `foo.css` 一起拉），想只要其一就用完整文件名或 relPath。
-- **拍平落地**：所有文件**拍平**到项目根（`scripts/deck-slide.js` → 项目 `deck-slide.js`，不保留子目录）；闭包内同名 basename 撞车时后者覆盖前者。
-- **skip-by-disk**：项目已有同名（拍平后的 basename）文件默认跳过，`--overwrite` 才覆盖；不写任何安装记账文件，项目文件树即状态。
-- **add 回执带 usage**：`add` 结果的 `entries` 只列**你请求的条目**（不含被 `Depends` 传递拉进来的依赖——依赖照常落地在 `added`/`skipped`，但那是"管道"），逐条给出 `usage`（USAGE 块原文）与 `dependsOn`，Agent `add` 完即可直接读用法，无需再 `registry list`。请求的条目即使已存在被跳过也回带 usage（`status` 标 `added`/`skipped`，据此判断磁盘上是 registry 版还是你改过的旧版）。`--json` 结构为 `{registryVersion, added, skipped, dryRun, entries}`；pretty（默认）输出 `registry@<ver>` + `added:`/`skipped:` 逗号列表 + 各请求条目的 USAGE 块，稳定 label、无 JSON 数组、无截断，对 Agent 与人同样可读。
-- `--version <ver>` 指定 registry 包版本或 dist-tag（缺省 `latest`），`--dir <path>` 指定项目目录（缺省当前目录）。
-
 ## 全局参数
 
 - `--json [fields]`：输出结构化 JSON，可选字段级选择（如 `--json id,name`）。
@@ -89,7 +55,7 @@ miaoda registry add deck-slide --overwrite         # 目标已存在时覆盖（
 ## 环境变量
 
 - `MIAODA_APP_ID`：默认应用 ID，等价于 `--app-id`。
-- `MIAODA_CANARY_HEADER`：HTTP 请求的 `x-tt-env` 小流量头取值。未设置时默认 `boe_miaoda_ccm`；设为空字符串则不带该头（例：`export MIAODA_CANARY_HEADER=boe_xxx`）。值形如 `ppe_xxx` 时额外带上 `x-use-ppe: 1`。
+- `MIAODA_CANARY_HEADER`：HTTP 请求的 `x-tt-env` 小流量头取值。未设置时默认 `boe_miaoda_doubao`；设为空字符串则不带该头（例：`export MIAODA_CANARY_HEADER=boe_xxx`）。值形如 `ppe_xxx` 时额外带上 `x-use-ppe: 1`。
 
 ## 输出契约
 

package/dist/api/deploy/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.NodeStatus = exports.nodeStatusFromText = exports.nodeStatusText = exports.errorJobSchema = exports.deployGetSchema = exports.deployHistorySchema = exports.batchSavePluginInstances = exports.TosActionType = exports.LocalReleaseStatus = exports.applyTosDiff = exports.getModernLastPublishedVersion = exports.getModernReleaseStatus = exports.createModernRelease = exports.callbackStatic = exports.updateLocalRelease = exports.createLocalRelease = exports.preRelease = exports.queryPipelineInstance = exports.getErrorLog = exports.listPipelineInstances = exports.createRelease = void 0;
+exports.NodeStatus = exports.nodeStatusFromText = exports.nodeStatusText = exports.errorJobSchema = exports.deployGetSchema = exports.deployHistorySchema = exports.batchSavePluginInstances = exports.LocalReleaseStatus = exports.getModernLastPublishedVersion = exports.getModernReleaseStatus = exports.createModernRelease = exports.callbackStatic = exports.updateLocalRelease = exports.createLocalRelease = exports.preRelease = exports.queryPipelineInstance = exports.getErrorLog = exports.listPipelineInstances = exports.createRelease = void 0;
 var api_1 = require("./api");
 Object.defineProperty(exports, "createRelease", { enumerable: true, get: function () { return api_1.createRelease; } });
 Object.defineProperty(exports, "listPipelineInstances", { enumerable: true, get: function () { return api_1.listPipelineInstances; } });
@@ -14,10 +14,8 @@ Object.defineProperty(exports, "callbackStatic", { enumerable: true, get: functi
 Object.defineProperty(exports, "createModernRelease", { enumerable: true, get: function () { return modern_1.createRelease; } });
 Object.defineProperty(exports, "getModernReleaseStatus", { enumerable: true, get: function () { return modern_1.getReleaseStatus; } });
 Object.defineProperty(exports, "getModernLastPublishedVersion", { enumerable: true, get: function () { return modern_1.getLastPublishedVersion; } });
-Object.defineProperty(exports, "applyTosDiff", { enumerable: true, get: function () { return modern_1.applyTosDiff; } });
 var modern_types_1 = require("./modern-types");
 Object.defineProperty(exports, "LocalReleaseStatus", { enumerable: true, get: function () { return modern_types_1.LocalReleaseStatus; } });
-Object.defineProperty(exports, "TosActionType", { enumerable: true, get: function () { return modern_types_1.TosActionType; } });
 var plugin_instances_1 = require("./plugin-instances");
 Object.defineProperty(exports, "batchSavePluginInstances", { enumerable: true, get: function () { return plugin_instances_1.batchSavePluginInstances; } });
 var schemas_1 = require("./schemas");

package/dist/api/deploy/modern-types.js

@@ -8,7 +8,7 @@
 //
 // 远端部署链路（B/C）所需的 release 接口先预留类型骨架，待 B/C 落地时启用。
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TosActionType = exports.LocalReleaseStatus = void 0;
+exports.LocalReleaseStatus = void 0;
 /**
  * localPublish 状态枚举（数值，与服务端 IDL 对齐）。
  * CLI updateLocalRelease 只翻 Finished / Failed 两个终态；其它由后端流转。
@@ -21,6 +21,3 @@ exports.LocalReleaseStatus = {
     Canceled: 4,
     Rollback: 5,
 };
-// ── applyTosDiff（design-html 增量发布；后端应用 TOS diff） ──
-/** 对齐 IDL publish.TosActionType（UNSPECIFIED=0 不用） */
-exports.TosActionType = { CREATE: 1, UPDATE: 2, DELETE: 3 };

package/dist/api/deploy/modern.js

@@ -17,7 +17,6 @@ exports.callbackStatic = callbackStatic;
 exports.createRelease = createRelease;
 exports.getReleaseStatus = getReleaseStatus;
 exports.getLastPublishedVersion = getLastPublishedVersion;
-exports.applyTosDiff = applyTosDiff;
 const http_1 = require("../../utils/http");
 const devops_error_1 = require("../../utils/devops-error");
 const DEFAULT_ERR_CODE = 'INTERNAL_DEVOPS_ERROR';
@@ -77,10 +76,3 @@ async function getLastPublishedVersion(req) {
     const url = `/v1/devops/app/${encodeURIComponent(appID)}/last_published_version`;
     return (0, http_1.postInnerApi)(url, {}, envelopeOpts('Failed to get last published version'));
 }
-// ── applyTosDiff ──
-/** POST /v1/devops/app/:appID/apply_tos_diff —— 增量应用 TOS 文件 diff */
-async function applyTosDiff(req) {
-    const { appID, ...body } = req;
-    const url = `/v1/devops/app/${encodeURIComponent(appID)}/apply_tos_diff`;
-    return (0, http_1.postInnerApi)(url, body, envelopeOpts('Failed to apply tos diff'));
-}

package/dist/api/index.js

@@ -33,18 +33,16 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.comment = exports.deploy = exports.app = exports.observability = exports.db = exports.file = exports.plugin = void 0;
+exports.deploy = exports.app = exports.observability = exports.db = exports.file = exports.plugin = void 0;
 const _plugin = __importStar(require("../api/plugin/index"));
 const _file = __importStar(require("../api/file/index"));
 const _db = __importStar(require("../api/db/index"));
 const _observability = __importStar(require("../api/observability/index"));
 const _app = __importStar(require("../api/app/index"));
 const _deploy = __importStar(require("../api/deploy/index"));
-const _comment = __importStar(require("../api/comment/index"));
 exports.plugin = { ..._plugin };
 exports.file = { ..._file };
 exports.db = { ..._db };
 exports.observability = { ..._observability };
 exports.app = { ..._app };
 exports.deploy = { ..._deploy };
-exports.comment = { ..._comment };

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

@@ -164,7 +164,9 @@ 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('--conf [json]', 'init 配置 JSON。支持 {"version": "<template 版本>"}，默认 latest')
+        .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)
         .addOption((0, shared_1.appIdOption)())
@@ -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,
@@ -234,9 +252,7 @@ JSON 输出
     }));
 }
 function parseInitConf(raw) {
-    // --conf 为可选值：未传（undefined）、裸 --conf（Commander 给 true）、空/纯空白字符串
-    // 一律视为不配置，回退默认（latest）。
-    if (raw === undefined || typeof raw === 'boolean' || raw.trim() === '')
+    if (raw === undefined)
         return undefined;
     let parsed;
     try {

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/deploy/modern.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerDeployCommandsModern = registerDeployCommandsModern;
 const shared_1 = require("../../../cli/commands/shared");
 const modern_1 = require("../../../cli/handlers/deploy/modern");
-const index_1 = require("../../../cli/handlers/deploy/index");
 /**
  * modern scene (MIAODA_APP_TYPE=7) 专用 deploy 注册。
  * 仅披露顶层 `miaoda deploy`，CLI 表面对齐 openclaw-cli：`--dir / --skip-build`。
@@ -57,37 +56,4 @@ JSON 输出（stdout）
             conf: rawOpts.conf,
         });
     }));
-    const patchCmd = deployCmd
-        .command('patch')
-        .description('design-html 增量发布：按文件 create/update/delete，.html 增删时同步 routes.json')
-        .option('--create <relpath>', '新增文件（可重复）', shared_1.collectRepeatedOption, [])
-        .option('--update <relpath>', '覆盖已有文件（可重复）', shared_1.collectRepeatedOption, [])
-        .option('--delete <relpath>', '删除文件（可重复）', shared_1.collectRepeatedOption, [])
-        .option('--session-id <id>', '会话 ID，发布时透传给下游（可选）')
-        .addHelpText('after', `
---dir 为项目目录（与 deploy 同名参数，默认当前目录）。
-仅支持 design-html（design_local_deploy）。路径为工程根相对路径（= 服务端 latest 下 key），
-禁绝对路径与 ".."。--create/--update 的本地文件必须存在。.html 被新增/删除（路由集合变化）
-时自动重算并随包更新 routes.json；纯 --update 现有 .html 只改内容，不动 routes.json。
-routes.json 每项为 {path, file}：path 为相对路径（不含 base 前缀，由消费侧拼接），file 为
-对应源文件（如 / → index.html）。
-
-JSON 输出
-  {"data": {"upsertCount": <n>, "deleteCount": <n>, "actionsSent": <n>, "routesRegenerated": <bool>}}
-
-示例
-  $ miaoda deploy patch --update index.html
-  $ miaoda deploy patch --create blog/post.html --delete blog/old.html
-  $ miaoda deploy patch --update assets/app.js --update assets/app.css
-`);
-    patchCmd.action((0, shared_1.withHelp)(patchCmd, async (rawOpts) => {
-        await (0, index_1.handleDeployPatch)({
-            appId: (0, shared_1.resolveAppId)({}),
-            dir: deployCmd.opts().dir ?? '.',
-            creates: rawOpts.create,
-            updates: rawOpts.update,
-            deletes: rawOpts.delete,
-            sessionId: rawOpts.sessionId,
-        });
-    }));
 }

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/commands/index.js

@@ -9,14 +9,11 @@ const index_4 = require("../../cli/commands/app/index");
 const index_5 = require("../../cli/commands/deploy/index");
 const modern_1 = require("../../cli/commands/deploy/modern");
 const index_6 = require("../../cli/commands/skills/index");
-const index_7 = require("../../cli/commands/comment/index");
-const index_8 = require("../../cli/commands/registry/index");
 // scene 跟 dispatcher(MIAODA_APP_TYPE)同语义层级 —— app 业务类型维度,
 // 对齐后端 devops app_common.AppType 枚举:
 //   3 = AppType_APPLICATION(全栈应用,当前仅 nestjs-react-fullstack 一个 stack)
 //   4 = AppType_DESIGN(design-stack,SSR 渲染、无业务逻辑、无数据库)
 //   7 = miaoda-cli 自定义 modern 占位(后端枚举无 7,沙箱目前不传)
-//   8 = AppType_DESIGN_HTML(design-html,buildless 静态 HTML,命令集同 modern)
 //   其它(0/1/2/5/6 / 未设)→ default(命令全开,本地 dev / CI / 兼容回退)
 // stack 维度(nestjs-react-fullstack / vite-react / ...)是正交的,
 // skills sync 内部按 .spark/meta.json.stack 拉对应 coding-steering/steering/<stack>/ 子目录。
@@ -27,8 +24,6 @@ function resolveScene(appType, _archType) {
         return 'application';
     if (appType === '4')
         return 'design';
-    if (appType === '8')
-        return 'design-html';
     return 'default';
 }
 const SCENE_REGISTRARS = {
@@ -42,13 +37,11 @@ const SCENE_REGISTRARS = {
         (0, index_1.registerFileCommands)(p);
         (0, index_3.registerObservabilityCommands)(p);
         (0, index_6.registerSkillsCommands)(p);
-        (0, index_7.registerCommentCommands)(p);
     },
     modern: (p) => {
         (0, index_4.registerAppCommands)(p, { includeInit: true });
         (0, modern_1.registerDeployCommandsModern)(p);
         (0, index_6.registerSkillsCommands)(p);
-        (0, index_7.registerCommentCommands)(p);
     },
     // application scene(AppType_APPLICATION=3):
     // 在 default 命令集基础上加 skills(按 meta.json.stack 拉对应 stack 技能)
@@ -60,7 +53,6 @@ const SCENE_REGISTRARS = {
         (0, index_1.registerFileCommands)(p);
         (0, index_3.registerObservabilityCommands)(p);
         (0, index_6.registerSkillsCommands)(p);
-        (0, index_7.registerCommentCommands)(p);
     },
     // design scene(AppType_DESIGN=4):design-stack 仅 SSR 渲染、无后端业务逻辑、
     // 无数据库、无 UGC 文件。命令集裁掉 db / file,保留 deploy / observability / app(init) / skills。
@@ -69,17 +61,6 @@ const SCENE_REGISTRARS = {
         (0, index_5.registerDeployCommands)(p);
         (0, index_3.registerObservabilityCommands)(p);
         (0, index_6.registerSkillsCommands)(p);
-        (0, index_7.registerCommentCommands)(p);
-    },
-    // design-html scene(AppType_DESIGN_HTML=8):buildless 静态 HTML,
-    // 命令集与 modern 一致(app init/sync + modern 拆分版 deploy + skills),不挂 db/file/observability。
-    // 额外挂 registry(shadcn 式 copy-in SDK,design-html scene 专属)。
-    'design-html': (p) => {
-        (0, index_4.registerAppCommands)(p, { includeInit: true });
-        (0, modern_1.registerDeployCommandsModern)(p);
-        (0, index_6.registerSkillsCommands)(p);
-        (0, index_8.registerRegistryCommands)(p);
-        (0, index_7.registerCommentCommands)(p);
     },
 };
 function readEnv(name) {

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

@@ -51,30 +51,18 @@ 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 会先于此)。
-    // 仅本地开发需要：沙箱环境由平台 supervisor 拉起 dev,无 init 前的 shell redirect 场景,
-    // 不预建 logs/ 以免在沙箱工作区留空目录。
-    if (!(0, env_1.isSandboxEnv)()) {
-        (0, logs_dir_1.ensureLogsDir)(targetDir);
-    }
+    // (dev.js / dev-local.js 自己也建 logs/,但只在它启动后;启动前的 shell redirect 会先于此)
+    (0, logs_dir_1.ensureLogsDir)(targetDir);
     // skills 同步软失败：拉不到 coding-steering 包不该阻断 writeSparkMeta /
     // activateGitHooks（之前会让 .spark/meta.json 没写，下次 init 半渲染状态又得重跑全套）。
     // 按运行环境（isSandboxEnv：MIAODA_DEP_CACHE_DIR 非空）分流 outputLayout，不绑 stack:
@@ -139,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,
@@ -163,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/cli/handlers/deploy/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleDeployPatch = exports.DEFAULT_POLL_INTERVAL_MS = exports.waitForPipeline = exports.handleDeployErrorLog = exports.handleDeployHistory = exports.handleDeployGet = exports.handleDeploy = void 0;
+exports.DEFAULT_POLL_INTERVAL_MS = exports.waitForPipeline = exports.handleDeployErrorLog = exports.handleDeployHistory = exports.handleDeployGet = exports.handleDeploy = void 0;
 var deploy_1 = require("./deploy");
 Object.defineProperty(exports, "handleDeploy", { enumerable: true, get: function () { return deploy_1.handleDeploy; } });
 var get_1 = require("./get");
@@ -12,5 +12,3 @@ Object.defineProperty(exports, "handleDeployErrorLog", { enumerable: true, get:
 var polling_1 = require("./polling");
 Object.defineProperty(exports, "waitForPipeline", { enumerable: true, get: function () { return polling_1.waitForPipeline; } });
 Object.defineProperty(exports, "DEFAULT_POLL_INTERVAL_MS", { enumerable: true, get: function () { return polling_1.DEFAULT_POLL_INTERVAL_MS; } });
-var patch_1 = require("./patch");
-Object.defineProperty(exports, "handleDeployPatch", { enumerable: true, get: function () { return patch_1.handleDeployPatch; } });

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

@@ -15,13 +15,8 @@ const output_1 = require("../../../utils/output");
  * 从 .spark/meta.json 读 stack，把 coding-steering 包内对应 stack 的 skills + tech.md
  * 同步到 <dir>/.agent/steering/。需要先跑过 `miaoda app init`。
  *
- * 版本来源优先级（从高到低）：
- *   1. CLI `--version` flag（显式指定）
- *   2. `FORCE_FRAMEWORK_ENVIRONMENT=boe` → dist-tag `dev`（BOE 测试灰度，跟随
- *      publish-alpha.sh 在 develop 分支打的 dev tag，便于在 BOE 沙箱里验证预发 steering）
- *   3. 默认 `latest`
- *
- * **不读 meta.json**——steering 版本不在 meta 里钉。
+ * 版本来源：CLI `--version` flag 或默认 `latest`。**不读 meta.json**——steering 版本
+ * 不在 meta 里钉，每次 sync 都跟随 `--version` 显式传或退回 @latest。
  */
 async function handleSkillsSync(opts) {
     await Promise.resolve();
@@ -30,20 +25,17 @@ async function handleSkillsSync(opts) {
     if (meta.stack === undefined || meta.stack === '') {
         throw new error_1.AppError('SKILLS_META_INCOMPLETE', '.spark/meta.json missing stack — run `miaoda app init` first');
     }
-    const isBoe = process.env.FORCE_FRAMEWORK_ENVIRONMENT === 'boe';
-    const effectiveVersion = opts.version ?? (isBoe ? 'dev' : undefined);
-    const versionSource = opts.version !== undefined ? 'cli-arg' : isBoe ? 'boe-default-dev' : 'default-latest';
     const result = (0, coding_steering_1.syncCodingSteering)({
         stack: meta.stack,
         targetDir,
-        version: effectiveVersion,
+        version: opts.version,
         outputLayout: opts.local === true ? 'flat' : 'nested',
     });
     (0, output_1.emit)({
         data: {
             stack: meta.stack,
             version: result.version,
-            versionSource,
+            versionSource: opts.version !== undefined ? 'cli-arg' : 'default-latest',
             syncedSkills: result.syncedSkills,
             techSynced: result.techSynced,
             ...(result.claudeSkillsLink !== undefined

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/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 };
+}