@lark-apaas/miaoda-cli 0.1.24-alpha.fb2cf0a → 0.1.24-beta.353f5fa

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

@@ -96,6 +96,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 +106,7 @@ JSON 输出
             "mergedJsonFiles": [{"path": "...", "keys": [...]}],
             "patchedScripts": [...],
             "upgradedPackages": [{"name": "...", "from": "...", "to": "...", "section": "..."}]}}
+  跳过时：{"data": {"stack": "...", "skipped": true, "reason": "stack_not_in_sync_scope", ...空数组}}
 
 示例
   $ miaoda app sync
@@ -193,11 +197,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/handlers/app/init.js

@@ -60,11 +60,16 @@ async function handleAppInit(opts) {
     const tplResult = (0, index_1.renderTemplate)({ stack, version, targetDir, projectName });
     // source_path 导入：当前仅 app_type=modern_html 生效。渲染完模板后、装依赖前叠加进 src/。
     const sourceImport = applySourcePathImport(opts, targetDir);
+    // 本地脚手架门禁：沙箱内所有栈照旧同步（nested，产出 .agent/）；本地只有 LOCAL_STEERING_STACKS
+    // 白名单栈（nestjs-react-fullstack / vite-react）才落地 steering（.claude/.agents）与 logs/。
+    // html / design-html 是纯静态 / 设计产物，本地不需要这套 agent skills 脚手架，整段跳过。
+    const sandbox = (0, env_1.isSandboxEnv)();
+    const scaffoldSteering = sandbox || index_1.LOCAL_STEERING_STACKS.has(stack);
     // 先建 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)()) {
+    // 仅本地白名单栈需要：沙箱环境由平台 supervisor 拉起 dev,无 init 前的 shell redirect 场景;
+    // 非白名单栈本地不落 steering 脚手架,也无需预建 logs/。
+    if (!sandbox && scaffoldSteering) {
         (0, logs_dir_1.ensureLogsDir)(targetDir);
     }
     // skills 同步软失败：拉不到 coding-steering 包不该阻断 writeSparkMeta /
@@ -74,21 +79,28 @@ async function handleAppInit(opts) {
     //     跟沙箱端 update-skills.sh 链路对齐
     //   - 本地 → flat (.agents/skills + .claude/skills 软链),
     //     Agent / Claude Code 用同一份;nrf 在本地是主战场,vite-react 等也一样适用
-    const outputLayout = (0, env_1.isSandboxEnv)() ? 'nested' : 'flat';
-    let steeringResult;
+    const outputLayout = sandbox ? 'nested' : 'flat';
+    // 默认空结果：非白名单栈跳过 steering 同步时（scaffoldSteering=false）直接沿用，
+    // 与"拉不到 coding-steering 包"软失败路径共用同一份占位，emit / meta 落盘不受影响。
+    let steeringResult = {
+        version: 'unknown',
+        syncedSkills: [],
+        techSynced: false,
+    };
     let steeringError;
-    try {
-        steeringResult = (0, coding_steering_1.syncCodingSteering)({
-            stack,
-            targetDir,
-            logPrefix: 'init',
-            outputLayout,
-        });
-    }
-    catch (err) {
-        steeringError = err instanceof Error ? err.message : String(err);
-        (0, logger_1.log)('init', `⚠ skills sync failed (continuing init): ${steeringError}`);
-        steeringResult = { version: 'unknown', syncedSkills: [], techSynced: false };
+    if (scaffoldSteering) {
+        try {
+            steeringResult = (0, coding_steering_1.syncCodingSteering)({
+                stack,
+                targetDir,
+                logPrefix: 'init',
+                outputLayout,
+            });
+        }
+        catch (err) {
+            steeringError = err instanceof Error ? err.message : String(err);
+            (0, logger_1.log)('init', `⚠ skills sync failed (continuing init): ${steeringError}`);
+        }
     }
     // 依赖安装：async 模式留到 meta 落盘后派发后台进程（不等装完），同步模式当场装。
     // 同步：装模板钉死的依赖。不带 <pkg>@latest 位置参数,因此 npm 不会改写 package.json/lockfile

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

@@ -1,10 +1,11 @@
 "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.IMPORT_SKIP_FILES = exports.IMPORT_SKIP_DIRS = exports.importSourceSrc = exports.TEMPLATE_PACKAGE_BY_STACK = exports.STACK_BY_APP_TYPE = exports.APP_TYPES = exports.LOCAL_STEERING_STACKS = 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, "LOCAL_STEERING_STACKS", { enumerable: true, get: function () { return template_1.LOCAL_STEERING_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; } });

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

@@ -3,7 +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.APP_TYPES = exports.STACK_BY_APP_TYPE = exports.LOCAL_STEERING_STACKS = 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"));
@@ -27,6 +27,13 @@ exports.TEMPLATE_PACKAGE_BY_STACK = {
  */
 exports.TEMPLATE_PINNED_VERSION_BY_STACK = {};
 exports.SUPPORTED_STACKS = Object.keys(exports.TEMPLATE_PACKAGE_BY_STACK);
+/**
+ * 本地开发（非沙箱）需要落地 agent skills 脚手架（.claude/.agents）与 logs/ 的 stack 白名单。
+ * 只有这些全栈 / 前端框架栈在本地才需要 coding-steering 的 skills；html / design-html 是纯
+ * 静态 / 设计产物，本地无需这套脚手架，init 直接跳过 syncCodingSteering 与 logs 创建。
+ * 沙箱环境不受此白名单约束（所有栈照旧走 nested 同步，产出 .agent/）。
+ */
+exports.LOCAL_STEERING_STACKS = new Set(['nestjs-react-fullstack', 'vite-react']);
 /**
  * app_type（业务类型）→ stack 短名映射。仅在调用方未显式传 --template 时用于解析 stack。
  * 与 src/api/app/types.ts 的 AppType 枚举无关，是独立的业务类型概念。

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.24-alpha.fb2cf0a",
+  "version": "0.1.24-beta.353f5fa",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {