@lark-apaas/miaoda-cli 0.1.4 → 0.1.5-alpha.2f1e0ff

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

@@ -14,6 +14,24 @@ const COMMON_TIME_HELP = `
     1) 不带时区的形式与 pretty 输出闭环（同机器复制粘贴稳定）；跨机器请带显式时区。
     2) 必须用 T 分隔日期与时间，禁止空格——shell 会把不带引号的 'YYYY-MM-DD HH:mm:ss' 拆成两个参数。
 `;
+function normalizeRepeatedOption(value) {
+    if (Array.isArray(value)) {
+        const items = value.filter((item) => typeof item === 'string' && item.length > 0);
+        return items.length === 1 ? items[0] : items;
+    }
+    return value;
+}
+function normalizeRepeatedArray(value) {
+    if (Array.isArray(value)) {
+        return value.filter((item) => typeof item === 'string' && item.length > 0);
+    }
+    return typeof value === 'string' && value ? [value] : [];
+}
+function compactRepeatedOption(values) {
+    if (values.length === 0)
+        return undefined;
+    return values.length === 1 ? values[0] : values;
+}
 function registerObservabilityCommands(program) {
     const obCmd = program
         .command('observability')
@@ -31,6 +49,7 @@ function registerObservabilityCommands(program) {
 `);
     registerLog(obCmd);
     registerTrace(obCmd);
+    registerSourceStack(obCmd);
     registerMetric(obCmd);
     registerAnalytics(obCmd);
 }
@@ -45,8 +64,8 @@ function registerLog(parent) {
         .argParser((0, shared_1.caseInsensitiveChoice)(['DEBUG', 'INFO', 'WARN', 'ERROR'])))
         .option('--since <time>', '开始时间')
         .option('--until <time>', '截止时间')
-        .option('--log-id <id>', '按请求 logid 过滤（attributes.ob_data_id）')
-        .option('--trace-id <id>', '按 trace ID 过滤')
+        .addOption(new commander_1.Option('--log-id <id>', '按请求 logid 过滤（可重复传入）').argParser(shared_1.collectRepeatedOption))
+        .addOption(new commander_1.Option('--trace-id <id>', '按 trace ID 过滤（可重复传入）').argParser(shared_1.collectRepeatedOption))
         .option('--grep <pattern>', '按关键字模糊搜索 body')
         .option('--module <name>', '按模块名过滤')
         .option('--user-id <user-id>', '按触发用户 ID 过滤')
@@ -63,7 +82,9 @@ JSON 输出
 示例
   $ miaoda observability log --since 1h --level error --json
   $ miaoda observability log --log-id log_abc123 --json
+  $ miaoda observability log --log-id log_1 --log-id log_2 --json
   $ miaoda observability log --trace-id 140ebb5ac9b... --json
+  $ miaoda observability log --trace-id trace_1 --trace-id trace_2 --json
   $ miaoda observability log --api /api/orders --min-duration 200 --json
 `);
     cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
@@ -74,8 +95,8 @@ JSON 输出
             level: rawOpts.level,
             since: rawOpts.since,
             until: rawOpts.until,
-            logId: rawOpts.logId,
-            traceId: rawOpts.traceId,
+            logId: normalizeRepeatedOption(rawOpts.logId),
+            traceId: normalizeRepeatedOption(rawOpts.traceId),
             grep: rawOpts.grep,
             module: rawOpts.module,
             userId: rawOpts.userId,
@@ -100,7 +121,7 @@ function registerTrace(parent) {
         .addOption((0, shared_1.appIdOption)().hideHelp())
         .option('--since <time>', '开始时间')
         .option('--until <time>', '截止时间')
-        .option('--trace-id <id>', '按 trace ID 过滤')
+        .addOption(new commander_1.Option('--trace-id <id>', '按 trace ID 过滤（可重复传入）').argParser(shared_1.collectRepeatedOption))
         .option('--root-span <span-name>', '按入口节点关键词过滤')
         .option('--user-id <user-id>', '按触发用户 ID 过滤')
         .option('--limit <n>', '返回条数上限（1~100）', parseLimit, 50)
@@ -111,6 +132,7 @@ JSON 输出
 
 示例
   $ miaoda observability trace list --since 1h --json
+  $ miaoda observability trace list --trace-id trace_1 --trace-id trace_2 --json
   $ miaoda observability trace list --root-span api-gateway --limit 20 --json
 `);
     listCmd.action((0, shared_1.withHelp)(listCmd, async (rawOpts) => {
@@ -120,7 +142,7 @@ JSON 输出
             appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
             since: rawOpts.since,
             until: rawOpts.until,
-            traceId: rawOpts.traceId,
+            traceId: normalizeRepeatedOption(rawOpts.traceId),
             rootSpan: rawOpts.rootSpan,
             userId: rawOpts.userId,
             limit: rawOpts.limit,
@@ -154,6 +176,40 @@ JSON 输出
         });
     }));
 }
+// ── source-stack ──
+function registerSourceStack(parent) {
+    const cmd = parent
+        .command('source-stack')
+        .description('反解前端错误堆栈到源码位置')
+        .argument('[log-ids...]', '前端错误请求 logid，可传多个')
+        .addOption((0, shared_1.appIdOption)().hideHelp())
+        .addOption(new commander_1.Option('--log-id <id>', '前端错误请求 logid（可重复传入）').argParser(shared_1.collectRepeatedOption))
+        .addOption(new commander_1.Option('--trace-id <id>', '包含前端错误的 trace ID（可重复传入）').argParser(shared_1.collectRepeatedOption))
+        .option('--since <time>', '开始时间')
+        .option('--until <time>', '截止时间')
+        .option('--limit <n>', '每类查询返回条数上限（1~100）', parseLimit, 50)
+        .addHelpText('after', `${COMMON_TIME_HELP}
+JSON 输出
+  {"data": [{"log_id": "...", "trace_id": "...", "status": "resolved", "error_message_stack": "Error: boom\\n  at src/App.tsx:42:7"}], "next_cursor": null, "has_more": false}
+
+示例
+  $ miaoda observability source-stack --log-id log_1 --log-id log_2 --json
+  $ miaoda observability source-stack --trace-id trace_1 --trace-id trace_2 --json
+  $ miaoda observability source-stack log_abc123 --json
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (logIds, rawOpts) => {
+        (0, shared_1.validateTimeOptions)(rawOpts, 'since', 'until');
+        (0, shared_1.rejectCliOverride)(cmd, 'appId');
+        await (0, index_1.handleObservabilitySourceStack)({
+            appId: (0, shared_1.resolveAppId)({ appId: rawOpts.appId }),
+            logId: compactRepeatedOption([...logIds, ...normalizeRepeatedArray(rawOpts.logId)]),
+            traceId: normalizeRepeatedOption(rawOpts.traceId),
+            since: rawOpts.since,
+            until: rawOpts.until,
+            limit: rawOpts.limit,
+        });
+    }));
+}
 // ── metric ──
 function registerMetric(parent) {
     const cmd = parent

package/dist/cli/commands/shared.js

@@ -7,6 +7,7 @@ exports.softRequiredOption = softRequiredOption;
 exports.resolveAppId = resolveAppId;
 exports.withHelp = withHelp;
 exports.caseInsensitiveChoice = caseInsensitiveChoice;
+exports.collectRepeatedOption = collectRepeatedOption;
 exports.validateTimeOptions = validateTimeOptions;
 exports.rejectCliOverride = rejectCliOverride;
 const commander_1 = require("commander");
@@ -86,6 +87,10 @@ function caseInsensitiveChoice(canonical) {
         return hit;
     };
 }
+/** Commander repeatable option parser：重复传入时收集为数组。 */
+function collectRepeatedOption(value, previous = []) {
+    return [...previous, value];
+}
 /**
  * --since / --until 等时间参数的 action 阶段校验。
  *

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

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSkillsCommands = registerSkillsCommands;
+const shared_1 = require("../../../cli/commands/shared");
+const index_1 = require("../../../cli/handlers/skills/index");
+/**
+ * miaoda skills：本地 agent skills 维护。
+ *
+ * 当前仅 steering 一类子集（coding-steering 包内的 _common/skills + <stack>/skills + tech.md）；
+ * 后续如有更多 skill 类型再加 --type。`app init` 会一次性同步装上，独立 `skills sync` 用于
+ * 后续单独升级 / pin 版本，不必走完整 init。
+ */
+function registerSkillsCommands(program) {
+    const skillsCmd = program.command('skills').description('本地 agent skills（含 steering）维护');
+    skillsCmd.action(() => {
+        skillsCmd.outputHelp();
+    });
+    registerSkillsSync(skillsCmd);
+    registerSkillsStatus(skillsCmd);
+}
+function registerSkillsSync(parent) {
+    const cmd = parent
+        .command('sync')
+        .description('同步 coding-steering（latest 或指定版本）到 user app')
+        .argument('[version]', 'coding-steering 包版本或 dist-tag，缺省 latest')
+        .option('--dir <path>', '项目目录，默认当前目录', '.')
+        .option('--local', '走本地 dev / agent 输出形态：拷到 .agents/skills 平铺 + 创建 .claude/skills 软链。' +
+        '不传时退回老形态：拷到 .agent/skills/steering/<stack>/skills/（跟沙箱端 update-skills.sh 对齐）', false)
+        .addHelpText('after', `
+前置要求
+  当前目录（或 --dir）已走过 'miaoda app init'（.spark/meta.json 含 stack）
+
+输出形态（--local 切换）
+  默认（不传 --local）：
+    .agent/skills/steering/<stack>/skills/<skill>/...
+    .agent/skills/steering/<stack>/tech.md
+    （老链路，沙箱端 update-skills.sh 也输出这套结构）
+
+  传 --local：
+    .agents/skills/<skill>/...      ← 平铺，无 stack 命名空间
+    .agents/tech.md
+    .claude/skills → ../.agents/skills（软链，让 Claude Code 识别同一份）
+
+JSON 输出
+  {"data": {"stack": "...", "version": "...", "syncedSkills": [...], "techSynced": true|false,
+            "claudeSkillsLink": "created|updated|noop|conflict"  // 仅 --local 时}}
+
+示例
+  $ miaoda skills sync
+  $ miaoda skills sync --local           # 本地 dev / agent 用
+  $ miaoda skills sync 0.2.0
+  $ miaoda skills sync --dir ./my-app
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (version, rawOpts) => {
+        await (0, index_1.handleSkillsSync)({
+            dir: rawOpts.dir,
+            version,
+            local: rawOpts.local,
+        });
+    }));
+}
+function registerSkillsStatus(parent) {
+    const cmd = parent
+        .command('status')
+        .description('查看本地 .agent/steering/ 的当前状态（不联网）')
+        .option('--dir <path>', '项目目录，默认当前目录', '.')
+        .addHelpText('after', `
+JSON 输出
+  {"data": {"present": true|false, "skills": [...], "techSynced": true|false}}
+
+示例
+  $ miaoda skills status
+`);
+    cmd.action((0, shared_1.withHelp)(cmd, async (rawOpts) => {
+        await (0, index_1.handleSkillsStatus)({
+            dir: rawOpts.dir,
+        });
+    }));
+}

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

@@ -1,7 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleAppUpdate = exports.handleAppGet = void 0;
+exports.SUPPORTED_STACKS = exports.handleAppUpgrade = exports.handleAppSync = exports.handleAppInit = exports.handleAppUpdate = exports.handleAppGet = void 0;
 var get_1 = require("./get");
 Object.defineProperty(exports, "handleAppGet", { enumerable: true, get: function () { return get_1.handleAppGet; } });
 var update_1 = require("./update");
 Object.defineProperty(exports, "handleAppUpdate", { enumerable: true, get: function () { return update_1.handleAppUpdate; } });
+var init_1 = require("./init");
+Object.defineProperty(exports, "handleAppInit", { enumerable: true, get: function () { return init_1.handleAppInit; } });
+var sync_1 = require("./sync");
+Object.defineProperty(exports, "handleAppSync", { enumerable: true, get: function () { return sync_1.handleAppSync; } });
+Object.defineProperty(exports, "handleAppUpgrade", { enumerable: true, get: function () { return sync_1.handleAppUpgrade; } });
+// commands 层渲染 help 时需要这份枚举；从 handler barrel 转发，避免 commands → services 越界
+var index_1 = require("../../../services/app/init/index");
+Object.defineProperty(exports, "SUPPORTED_STACKS", { enumerable: true, get: function () { return index_1.SUPPORTED_STACKS; } });

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

@@ -0,0 +1,132 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleAppInit = handleAppInit;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const index_1 = require("../../../services/app/init/index");
+const coding_steering_1 = require("../../../utils/coding-steering");
+const logger_1 = require("../../../utils/logger");
+const githooks_1 = require("../../../utils/githooks");
+const sync_1 = require("../../../cli/handlers/app/sync");
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+/**
+ * miaoda app init
+ *
+ * 一站式本地脚手架：render template → upgrade/templates sync → skills sync → install deps，把
+ * {stack, version, archType, app_id?} 写入 .spark/meta.json。--app-id（或 MIAODA_APP_ID）提供时
+ * 持久化 app_id；运行端命令仍优先读 env，未设置时回退到 meta.json。
+ *
+ * 幂等：.spark/meta.json 存在即表示已完整成功一次，直接退出，不重跑任何子步骤。
+ * 半渲染状态（package.json 在但 meta.json 不在）会重新跑完整流程。
+ */
+async function handleAppInit(opts) {
+    await Promise.resolve();
+    const targetDir = opts.targetDir ?? process.cwd();
+    const metaPath = node_path_1.default.join(targetDir, '.spark', 'meta.json');
+    if (node_fs_1.default.existsSync(metaPath)) {
+        if (!(0, output_1.isJsonMode)()) {
+            process.stdout.write(`Already initialized: ${metaPath}\n`);
+        }
+        (0, output_1.emit)({
+            data: {
+                initialized: false,
+                reason: 'already_initialized',
+                targetDir,
+            },
+        });
+        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 version = opts.conf?.version;
+    const projectName = node_path_1.default.basename(targetDir);
+    const tplResult = (0, index_1.renderTemplate)({ stack, version, targetDir, projectName });
+    // sync 紧跟 template 渲染之后，赶在 install 之前：
+    // 这样 directory / merge-json / add-script 等 rule 都已落地，install 出来的 lockfile
+    // 与最终态对齐；patches 还能覆盖 template 提供的同名文件。
+    const syncRunResult = (0, sync_1.runStackSync)(stack, targetDir, 'init');
+    const syncSummary = (0, sync_1.summarizeSyncResults)(syncRunResult);
+    // template 渲染下来的 @lark-apaas/* 版本可能落后 PINNED 表，赶在 install 之前钉到表版本，
+    // 这样一次 npm install 就直接装最终版本，不需要 install 完再补一遍。
+    const upgradedPackages = (0, sync_1.upgradePlatformDeps)(targetDir, 'init');
+    // skills 同步软失败：拉不到 coding-steering 包不该阻断 writeSparkMeta /
+    // activateGitHooks（之前会让 .spark/meta.json 没写，下次 init 半渲染状态又得重跑全套）。
+    let steeringResult;
+    let steeringError;
+    try {
+        steeringResult = (0, coding_steering_1.syncCodingSteering)({
+            stack,
+            targetDir,
+            version: opts.conf?.steeringVersion,
+            logPrefix: 'init',
+        });
+    }
+    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 };
+    }
+    const installResult = (0, index_1.installDependencies)({
+        targetDir,
+        skip: opts.skipInstall,
+        quietStdout: (0, output_1.isJsonMode)(),
+    });
+    // template 自带 .githooks/pre-commit；如果用户项目已 git init,顺便设上 core.hooksPath。
+    const hookActivation = (0, githooks_1.activateGitHooks)(targetDir);
+    (0, index_1.writeSparkMeta)(targetDir, {
+        stack,
+        version: tplResult.version,
+        archType: tplResult.archType,
+        app_id: opts.appId,
+        steeringVersion: steeringResult.version,
+    });
+    const syncedSummary = syncRunResult.stackFound
+        ? syncRunResult.rulesApplied.length > 0
+            ? `${syncRunResult.rulesApplied.length.toString()} rule(s)`
+            : 'legacy'
+        : 'skipped';
+    if (!(0, output_1.isJsonMode)()) {
+        process.stdout.write(`✓ Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, sync ${syncedSummary}, install ${installResult.source}) in ${targetDir}\n`);
+    }
+    (0, output_1.emit)({
+        data: {
+            initialized: true,
+            template: stack,
+            templatePackage: tplResult.packageName,
+            templateVersion: tplResult.version,
+            steeringVersion: steeringResult.version,
+            archType: tplResult.archType,
+            appId: opts.appId,
+            syncedSkills: steeringResult.syncedSkills,
+            techSynced: steeringResult.techSynced,
+            steeringError,
+            // sync 流程的产出：rule-driven 时 appliedRules + 一系列汇总字段；fallback 到旧 platform-sync
+            // 时只填 platformSyncedFiles / platformMergedJsonFiles；stack 不识别时全空且 platformStackFound=false。
+            platformStackFound: syncRunResult.stackFound,
+            appliedRules: syncSummary.appliedRules,
+            platformSyncedFiles: syncSummary.syncedFiles,
+            platformMergedJsonFiles: syncSummary.mergedJsonFiles,
+            patchedScripts: syncSummary.patchedScripts,
+            upgradedPackages,
+            gitHooks: hookActivation.action,
+            installed: installResult.installed,
+            installSource: installResult.source,
+            installHash: installResult.hash,
+            cacheZip: installResult.cacheZip,
+            installError: installResult.error,
+        },
+    });
+}

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

@@ -0,0 +1,215 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleAppUpgrade = void 0;
+exports.handleAppSync = handleAppSync;
+exports.runStackSync = runStackSync;
+exports.summarizeSyncResults = summarizeSyncResults;
+exports.upgradePlatformDeps = upgradePlatformDeps;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const sync_configs_1 = require("../../../config/sync-configs");
+const sync_rule_1 = require("../../../utils/sync-rule");
+const platform_sync_1 = require("../../../utils/platform-sync");
+const githooks_1 = require("../../../utils/githooks");
+const spark_meta_1 = require("../../../utils/spark-meta");
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+const logger_1 = require("../../../utils/logger");
+/**
+ * 平台包钉死版本表 —— `miaoda app sync` 不查 npm dist-tags，直接按这张表把
+ * user app 已有的 @lark-apaas/* 依赖钉到对应版本。
+ *
+ * 为什么不跟 alpha dist-tag：alpha 通道被多个团队共享，外部 prerelease 时常打过去，
+ * 自动跟 alpha 会把回归版本（如 fullstack-vite-preset@1.0.24-alpha.5 退化没读 .env.local）
+ * 拉进 user app。维护这张白名单可控性更高，每次升基线时人工 review 一次再改这里。
+ *
+ * 表里没有的 @lark-apaas/* 包：sync 不动（既不升也不报错）；user app 没装的包也不引入。
+ * 改这张表请同步把 user app 端到端 smoke 跑一次（init → sync → npm run dev）。
+ */
+const PINNED_PLATFORM_VERSIONS = {
+    '@lark-apaas/express-core': '1.0.4-alpha.7',
+    '@lark-apaas/fullstack-nestjs-core': '1.1.52-alpha.1',
+    '@lark-apaas/fullstack-vite-preset': '1.0.24-alpha.9',
+    '@lark-apaas/http-client': '0.1.7-alpha.8',
+    '@lark-apaas/fullstack-cli': '1.1.49-alpha.0',
+    '@lark-apaas/fullstack-rspack-preset': '1.0.56-alpha.8',
+    '@lark-apaas/db-schema-sync': '0.1.6-alpha.2',
+};
+/**
+ * miaoda app sync [--dir <path>]
+ *
+ * 一站式同步：把当前 stack 的 sync 规则全套 apply 到 user app，对齐沙箱里
+ * `npm run upgrade → npx fullstack-cli sync` 的行为，并补 miaoda-cli 本地开发独有规则。
+ *
+ * 执行流：
+ *   1. SyncRule[] 全量 apply —— 来自 src/config/sync-configs/<stack>.ts。每个 stack
+ *      自带模板资源在 upgrade/templates/<stack>/templates/。表里没有该 stack 时回退到
+ *      旧 platform-sync 兜底（兼容尚未迁移的 stack）。
+ *   2. PINNED 平台 deps 钉版本 —— user app 已装的 @lark-apaas/* 升到 PINNED 表。
+ *   3. activateGitHooks —— 设置 core.hooksPath（template 自带 .githooks/pre-commit）。
+ *   4. npm install --no-audit --no-fund --ignore-scripts —— 物化新版本，绕开
+ *      action-plugin postinstall 在缺平台 env 时的 ENOENT。
+ *
+ * 需要 .spark/meta.json 已含 stack（走过 `miaoda app init`）。
+ * 不动 .agent/skills/（那是 `miaoda skills sync` 的事）。
+ */
+async function handleAppSync(opts) {
+    await Promise.resolve();
+    const targetDir = node_path_1.default.resolve(opts.dir ?? process.cwd());
+    const meta = (0, spark_meta_1.readSparkMeta)(targetDir);
+    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 兜底；都不识别就报错
+    const syncResults = runStackSync(meta.stack, targetDir, 'sync');
+    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 注册`,
+            ],
+        });
+    }
+    // 2. @lark-apaas/* dep pin（按 PINNED_PLATFORM_VERSIONS 表，user app 已装才钉）
+    const upgradedPackages = upgradePlatformDeps(targetDir, 'sync');
+    // 3. activate git hooks（template 自带 .githooks/pre-commit，core.hooksPath 一次性设置）
+    const hookActivation = (0, githooks_1.activateGitHooks)(targetDir);
+    // 4. npm install —— 跟 init 一样软失败，install 挂了不该阻断 emit / sync 总结输出
+    (0, logger_1.log)('sync', 'Running npm install --ignore-scripts...');
+    let installError;
+    try {
+        (0, node_child_process_1.execFileSync)('npm', ['install', '--no-audit', '--no-fund', '--ignore-scripts'], {
+            cwd: targetDir,
+            stdio: (0, output_1.isJsonMode)() ? ['ignore', 'ignore', 'inherit'] : 'inherit',
+        });
+    }
+    catch (err) {
+        installError = err instanceof Error ? err.message : String(err);
+        (0, logger_1.log)('sync', `⚠ npm install failed (continuing): ${installError}`);
+    }
+    (0, output_1.emit)({
+        data: {
+            stack: meta.stack,
+            ...summarizeSyncResults(syncResults),
+            upgradedPackages,
+            gitHooks: hookActivation.action,
+            installError,
+        },
+    });
+}
+/** 老命令 `miaoda app upgrade` 的 handler 名，保留为 sync handler 的 alias。 */
+exports.handleAppUpgrade = handleAppSync;
+/**
+ * 给 stack 应用 sync rules（sync handler + init handler 共用）。
+ * stack 在 STACK_REGISTRY 注册时走新 SyncRule 机制，否则回落到旧 platform-sync。
+ *
+ * stack 完全不识别（既不在 STACK_REGISTRY 也无 upgrade/templates/<stack>/ 目录）时返回
+ * `stackFound: false` 而非抛错 —— 让调用方按场景决定：sync handler 抛 AppError，init handler
+ * 允许（fresh init 时 stack 还在加注册的过渡期）。
+ */
+function runStackSync(stack, targetDir, logPrefix) {
+    const config = (0, sync_configs_1.getSyncConfig)(stack);
+    if (config !== null) {
+        const sourceRoot = (0, sync_configs_1.getStackTemplatesRoot)(stack);
+        if (!node_fs_1.default.existsSync(sourceRoot)) {
+            throw new error_1.AppError('SYNC_TEMPLATES_MISSING', `upgrade/templates/${stack}/templates/ not found at ${sourceRoot} — cli 安装异常?`);
+        }
+        (0, logger_1.log)(logPrefix, `Applying ${config.sync.length.toString()} sync rule(s) for stack '${stack}'`);
+        const rulesApplied = (0, sync_rule_1.applySyncRules)(config.sync, { sourceRoot, targetDir, logPrefix });
+        return { stackFound: true, rulesApplied };
+    }
+    // fallback：表外 stack 仍用旧 platform-sync 机制（files/ overlay + patches/ deep merge）
+    (0, logger_1.log)(logPrefix, `Stack '${stack}' not in new sync registry, falling back to legacy platform-sync`);
+    const legacy = (0, platform_sync_1.syncPlatformControlled)({ stack, targetDir, logPrefix });
+    return {
+        stackFound: legacy.stackFound,
+        rulesApplied: [],
+        legacy: { syncedFiles: legacy.syncedFiles, mergedJsonFiles: legacy.mergedJsonFiles },
+    };
+}
+/** 把 SyncRuleResult[] / legacy 输出汇总成 emit data 里的几组字段，便于诊断。 */
+function summarizeSyncResults(result) {
+    if (result.legacy !== undefined) {
+        return {
+            appliedRules: [],
+            syncedFiles: result.legacy.syncedFiles,
+            mergedJsonFiles: result.legacy.mergedJsonFiles,
+            patchedScripts: [],
+        };
+    }
+    const appliedRules = result.rulesApplied.map((r) => ({
+        type: r.rule.type,
+        action: r.action,
+        path: r.path,
+        detail: r.detail,
+    }));
+    const syncedFiles = [];
+    for (const r of result.rulesApplied) {
+        if ((r.action === 'synced' || r.action === 'created') && r.path !== undefined) {
+            syncedFiles.push(r.path);
+        }
+    }
+    const mergedJsonFiles = [];
+    for (const r of result.rulesApplied) {
+        if (r.rule.type !== 'merge-json')
+            continue;
+        if (r.action !== 'merged' && r.action !== 'created')
+            continue;
+        if (r.path === undefined)
+            continue;
+        mergedJsonFiles.push({
+            path: r.path,
+            keys: r.detail !== undefined ? r.detail.split(',').filter(Boolean) : [],
+        });
+    }
+    const patchedScripts = result.rulesApplied
+        .filter((r) => (r.rule.type === 'patch-script' || r.rule.type === 'add-script') &&
+        (r.action === 'patched' || r.action === 'created'))
+        .map((r) => r.rule.name);
+    return { appliedRules, syncedFiles, mergedJsonFiles, patchedScripts };
+}
+function readPackageJson(pkgJsonPath) {
+    if (!node_fs_1.default.existsSync(pkgJsonPath))
+        return null;
+    return JSON.parse(node_fs_1.default.readFileSync(pkgJsonPath, 'utf-8'));
+}
+/**
+ * 把 user app package.json 里已装的 @lark-apaas/* 包钉到 PINNED_PLATFORM_VERSIONS 表版本。
+ * 由 `miaoda app sync` 和 `miaoda app init`（template 渲染后、install 之前）共用。
+ *
+ * - user app 已装的 PINNED 包 → 钉到表版本
+ * - user app 未装的 PINNED 包 → 不引入（sync 的职责是对齐，不是塞依赖）
+ * - 装着但不在 PINNED 表的 @lark-apaas/* 包 → 完全不动
+ *
+ * @param logPrefix 用于 `[<prefix>]   deps.xxx: a → b` 日志前缀；sync 流程传 'sync'，init 流程传 'init'。
+ */
+function upgradePlatformDeps(targetDir, logPrefix = 'sync') {
+    const pkgJsonPath = node_path_1.default.join(targetDir, 'package.json');
+    const pkg = readPackageJson(pkgJsonPath);
+    if (!pkg)
+        return [];
+    const updated = [];
+    for (const section of ['dependencies', 'devDependencies']) {
+        const deps = pkg[section];
+        if (!deps || typeof deps !== 'object')
+            continue;
+        for (const name of Object.keys(deps)) {
+            if (!Object.prototype.hasOwnProperty.call(PINNED_PLATFORM_VERSIONS, name))
+                continue;
+            const target = PINNED_PLATFORM_VERSIONS[name];
+            const from = deps[name];
+            if (from === target)
+                continue;
+            deps[name] = target;
+            updated.push({ name, from, to: target, section });
+            (0, logger_1.log)(logPrefix, `  ${section}.${name}: ${from} → ${target}`);
+        }
+    }
+    if (updated.length > 0) {
+        node_fs_1.default.writeFileSync(pkgJsonPath, JSON.stringify(pkg, null, 2) + '\n', 'utf-8');
+    }
+    return updated;
+}

package/dist/cli/handlers/deploy/modern.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleDeployModern = handleDeployModern;
+const node_path_1 = __importDefault(require("node:path"));
+const output_1 = require("../../../utils/output");
+const index_1 = require("../../../services/deploy/modern/index");
+/**
+ * miaoda deploy（modern scene 专用，CLI 表面对齐 openclaw-cli）
+ *
+ * 进程信息走 stderr（log_id / step），最终结果通过 emit 输出 envelope 到 stdout。
+ */
+async function handleDeployModern(opts) {
+    const projectDir = node_path_1.default.resolve(opts.dir);
+    const result = await (0, index_1.runModernDeploy)({
+        projectDir,
+        appId: opts.appId,
+        skipBuild: opts.skipBuild ?? false,
+    });
+    (0, output_1.emit)({
+        data: {
+            appId: result.appId,
+            version: result.version,
+            url: result.url,
+            releaseID: result.releaseID,
+            preReleaseID: result.preReleaseID,
+        },
+        next_cursor: null,
+        has_more: false,
+    });
+}

package/dist/cli/handlers/observability/helpers.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ceilMsToBucket = exports.floorMsToBucket = exports.msToSec = exports.msToNs = exports.parseToSec = exports.parseToNs = exports.parseToMs = exports.parseTimeToMs = void 0;
 exports.eqFilter = eqFilter;
+exports.inFilter = inFilter;
 exports.rangeFilter = rangeFilter;
 exports.fuzzyFilter = fuzzyFilter;
 exports.buildFieldFilters = buildFieldFilters;
@@ -27,6 +28,9 @@ function eqFilter(value, type = 'str') {
     const v = type !== 'str' ? Number(value) : value;
     return { [type]: { eq: v } };
 }
+function inFilter(strs) {
+    return { str: { in: strs } };
+}
 /** i64 数值范围过滤 → { i64: { gte, lte } }；输入接受 string（CLI flag）或 number */
 function rangeFilter(opts) {
     const i64 = {};

package/dist/cli/handlers/observability/index.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleObservabilityAnalytics = exports.handleObservabilityMetric = exports.handleObservabilityTraceGet = exports.handleObservabilityTraceList = exports.handleObservabilityLog = void 0;
+exports.handleObservabilityAnalytics = exports.handleObservabilityMetric = exports.handleObservabilitySourceStack = exports.handleObservabilityTraceGet = exports.handleObservabilityTraceList = exports.handleObservabilityLog = void 0;
 var log_1 = require("./log");
 Object.defineProperty(exports, "handleObservabilityLog", { enumerable: true, get: function () { return log_1.handleObservabilityLog; } });
 var trace_1 = require("./trace");
 Object.defineProperty(exports, "handleObservabilityTraceList", { enumerable: true, get: function () { return trace_1.handleObservabilityTraceList; } });
 Object.defineProperty(exports, "handleObservabilityTraceGet", { enumerable: true, get: function () { return trace_1.handleObservabilityTraceGet; } });
+var source_stack_1 = require("./source-stack");
+Object.defineProperty(exports, "handleObservabilitySourceStack", { enumerable: true, get: function () { return source_stack_1.handleObservabilitySourceStack; } });
 var metric_1 = require("./metric");
 Object.defineProperty(exports, "handleObservabilityMetric", { enumerable: true, get: function () { return metric_1.handleObservabilityMetric; } });
 var analytics_1 = require("./analytics");