@lark-apaas/miaoda-cli 0.1.3 → 0.1.4

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

@@ -4,13 +4,13 @@ exports.registerPluginCommands = registerPluginCommands;
 const index_1 = require("../../../cli/handlers/plugin/index");
 function registerPluginCommands(program) {
     const pluginCmd = program
-        .command("plugin")
-        .description("插件管理：安装/更新/移除插件包，查询 capability 实例")
-        .usage("<command> [flags]");
+        .command('plugin')
+        .description('插件管理：安装/更新/移除插件包，查询 capability 实例')
+        .usage('<command> [flags]');
     pluginCmd.action(() => {
         pluginCmd.outputHelp();
     });
-    pluginCmd.addHelpText("after", `
+    pluginCmd.addHelpText('after', `
 概念
   - 插件包 (plugin package)：.tgz 包，释放到 ./node_modules/<name>
   - actionPlugins：./package.json 里的字段，记录 { "@scope/name": "version" }，作为
@@ -26,10 +26,10 @@ function registerPluginCommands(program) {
   - remove / list / list-packages：纯本地 FS，不走网络
 `);
     pluginCmd
-        .command("install")
-        .description("拉取插件包并安装到当前应用项目")
-        .argument("<names...>", "插件名，格式 @scope/name 或 @scope/name@version；未带版本默认 latest")
-        .addHelpText("after", `
+        .command('install')
+        .description('拉取插件包并安装到当前应用项目')
+        .argument('<names...>', '插件名，格式 @scope/name 或 @scope/name@version；未带版本默认 latest')
+        .addHelpText('after', `
 行为
   - 拉取 .tgz 到本地缓存，解压到 ./node_modules/<name>
   - 在 ./package.json 的 actionPlugins 字段记录 <name>: <version>
@@ -62,10 +62,10 @@ JSON 输出
         await (0, index_1.handlePluginInstall)({ names });
     });
     pluginCmd
-        .command("update")
-        .description("把已安装插件升级到 latest 版本")
-        .argument("<names...>", "插件名，格式 @scope/name；带 @version 也只取 name 部分")
-        .addHelpText("after", `
+        .command('update')
+        .description('把已安装插件升级到 latest 版本')
+        .argument('<names...>', '插件名，格式 @scope/name；带 @version 也只取 name 部分')
+        .addHelpText('after', `
 行为
   - 仅对已在 actionPlugins 里的插件生效；未安装的插件返回 notInstalled
   - 拉取 latest 版本 .tgz，覆盖安装到 ./node_modules/<name>
@@ -97,10 +97,10 @@ JSON 输出
         await (0, index_1.handlePluginUpdate)({ names });
     });
     pluginCmd
-        .command("remove")
-        .description("从当前项目移除一个已安装的插件")
-        .argument("<name>", "插件名，格式 @scope/name")
-        .addHelpText("after", `
+        .command('remove')
+        .description('从当前项目移除一个已安装的插件')
+        .argument('<name>', '插件名，格式 @scope/name')
+        .addHelpText('after', `
 行为
   - 删除 ./node_modules/<name> 目录
   - 从 ./package.json 的 actionPlugins 字段移除对应条目
@@ -123,9 +123,9 @@ JSON 输出
         (0, index_1.handlePluginRemove)({ name });
     });
     pluginCmd
-        .command("init")
-        .description("按 package.json 的 actionPlugins 批量安装所有插件")
-        .addHelpText("after", `
+        .command('init')
+        .description('按 package.json 的 actionPlugins 批量安装所有插件')
+        .addHelpText('after', `
 行为
   - 读取 ./package.json 的 actionPlugins，对每个条目按固定版本安装
   - 已经是目标版本的跳过（幂等），用于 clone 项目后首次同步 / CI
@@ -156,11 +156,11 @@ JSON 输出
         await (0, index_1.handlePluginInit)();
     });
     pluginCmd
-        .command("list")
-        .description("列出当前项目的 capability 实例（./server/capabilities/*.json）")
-        .option("--summary", "不 hydrate（不充血），直接返回 capability 文件的原始 JSON")
-        .option("--id <id>", "只查询指定 id 的单个 capability")
-        .addHelpText("after", `
+        .command('list')
+        .description('列出当前项目的 capability 实例（./server/capabilities/*.json）')
+        .option('--summary', '不 hydrate（不充血），直接返回 capability 文件的原始 JSON')
+        .option('--id <id>', '只查询指定 id 的单个 capability')
+        .addHelpText('after', `
 行为
   - 扫描 ./server/capabilities/*.json（排除 capabilities.json）
   - 默认对每条 capability 做 hydrate：读取 ./node_modules/<pluginKey>/manifest.json，
@@ -190,9 +190,9 @@ JSON 输出
         await (0, index_1.handlePluginList)(opts);
     });
     pluginCmd
-        .command("list-packages")
-        .description("列出 package.json actionPlugins 里已声明的插件包")
-        .addHelpText("after", `
+        .command('list-packages')
+        .description('列出 package.json actionPlugins 里已声明的插件包')
+        .addHelpText('after', `
 行为
   - 读取 ./package.json 的 actionPlugins 字段
   - 只看声明，不校验 ./node_modules 下是否实际存在

package/dist/cli/commands/shared.js

@@ -16,10 +16,10 @@ const args_1 = require("../../utils/args");
 Object.defineProperty(exports, "failArgs", { enumerable: true, get: function () { return args_1.failArgs; } });
 /** --app-id option，需要应用上下文的命令自行 .addOption(appIdOption()) */
 function appIdOption() {
-    return new commander_1.Option("--app-id <id>", "指定目标应用").env("MIAODA_APP_ID");
+    return new commander_1.Option('--app-id <id>', '指定目标应用').env('MIAODA_APP_ID');
 }
 function branchOption() {
-    return new commander_1.Option("--branch <branch>", "分支（优先级：--branch > 当前仓库 HEAD 分支；非 git 目录回退应用默认分支）").env("LOCAL_MOCK_MIAODA_DEPLOY_BRANCH");
+    return new commander_1.Option('--branch <branch>', '分支（优先级：--branch > 当前仓库 HEAD 分支；非 git 目录回退应用默认分支）').env('LOCAL_MOCK_MIAODA_DEPLOY_BRANCH');
 }
 /**
  * soft-required: Commander 类型上 optional，runtime 校验必填。
@@ -36,8 +36,8 @@ function softRequiredOption(name, desc) {
 function resolveAppId(opts) {
     const id = opts.appId ?? process.env.MIAODA_APP_ID ?? process.env.app_id;
     if (!id) {
-        throw new error_1.AppError("APP_ID_MISSING", "未指定应用", {
-            next_actions: ["设置 export MIAODA_APP_ID=<id>"],
+        throw new error_1.AppError('APP_ID_MISSING', '未指定应用', {
+            next_actions: ['设置 export MIAODA_APP_ID=<id>'],
         });
     }
     return id;
@@ -53,7 +53,7 @@ function withHelp(cmd, handler) {
             await handler(...args);
         }
         catch (err) {
-            if (err instanceof error_1.AppError && err.code === "ARGS_INVALID") {
+            if (err instanceof error_1.AppError && err.code === 'ARGS_INVALID') {
                 process.stderr.write(`Error: ${err.message}\n`);
                 cmd.outputHelp();
                 process.exitCode = 2;
@@ -81,7 +81,7 @@ function caseInsensitiveChoice(canonical) {
     return (raw) => {
         const hit = map.get(raw.toLowerCase());
         if (hit === undefined) {
-            throw new commander_1.InvalidArgumentError(`Allowed choices are ${canonical.join(", ")} (case-insensitive).`);
+            throw new commander_1.InvalidArgumentError(`Allowed choices are ${canonical.join(', ')} (case-insensitive).`);
         }
         return hit;
     };
@@ -98,8 +98,8 @@ function validateTimeOptions(opts, ...names) {
         const value = opts[name];
         if (value === undefined)
             continue;
-        if (typeof value !== "string") {
-            (0, args_1.failArgs)(`--${name.replace(/([A-Z])/g, "-$1").toLowerCase()} 必须是时间字符串`);
+        if (typeof value !== 'string') {
+            (0, args_1.failArgs)(`--${name.replace(/([A-Z])/g, '-$1').toLowerCase()} 必须是时间字符串`);
         }
         (0, time_1.parseTimeToMs)(value);
     }
@@ -118,8 +118,8 @@ function validateTimeOptions(opts, ...names) {
  */
 function rejectCliOverride(cmd, ...optNames) {
     for (const name of optNames) {
-        if (cmd.getOptionValueSource(name) === "cli") {
-            const flag = "--" + name.replace(/([A-Z])/g, "-$1").toLowerCase();
+        if (cmd.getOptionValueSource(name) === 'cli') {
+            const flag = '--' + name.replace(/([A-Z])/g, '-$1').toLowerCase();
             (0, args_1.failArgs)(`${flag} 由沙箱/本地配置注入，不允许显式传递`);
         }
     }

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

@@ -41,7 +41,7 @@ const index_1 = require("../../../api/app/index");
 /** miaoda app update [--app-id <id>] [--name <n>] [--description <d>] */
 async function handleAppUpdate(opts) {
     if (opts.name === undefined && opts.description === undefined) {
-        (0, args_1.failArgs)("至少需要 --name 或 --description 中的一个");
+        (0, args_1.failArgs)('至少需要 --name 或 --description 中的一个');
     }
     const appID = opts.appId;
     await api.app.updateAppMeta({
@@ -53,7 +53,7 @@ async function handleAppUpdate(opts) {
     const resp = await api.app.getAppInfo(appID);
     const meta = resp.appInfo?.appMeta ?? {};
     if (!(0, output_1.isJsonMode)()) {
-        process.stdout.write("✓ App updated successfully\n");
+        process.stdout.write('✓ App updated successfully\n');
     }
     (0, output_1.emit)({ data: meta }, index_1.appMetaSchema);
 }

package/dist/cli/handlers/db/_destructive.js

@@ -0,0 +1,67 @@
+"use strict";
+// db 域内不可逆 / destructive 操作的统一确认门。
+//
+// 设计要点：
+//   1. --yes：放行（CI / 脚本显式确认场景）
+//   2. 非 TTY 且无 --yes：抛 DESTRUCTIVE_REQUIRES_CONFIRM，不要默认放行。
+//      非 TTY 通常是 CI / agent / 管道场景，无人能交互回答 y/N，必须靠 --yes 显式确认。
+//   3. TTY 且无 --yes：交互式 y/N（prompt 写 stderr，避免污染 --json 模式 stdout）
+//
+// 反例（已修复，见这次 commit）：把 !isJsonMode() 拿来做确认门 —— --json 只改输出
+// 格式，跟"用户已确认"不是同一语义。CI / agent 几乎总会带 --json 解析输出，等价于
+// 把不可逆操作的确认变成了空门，跟 file rm 的模型也不一致。
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirmDestructive = confirmDestructive;
+exports.assertDestructiveAllowedInTty = assertDestructiveAllowedInTty;
+exports.askYesNo = askYesNo;
+const node_readline_1 = __importDefault(require("node:readline"));
+const render_1 = require("../../../utils/render");
+const error_1 = require("../../../utils/error");
+const DESTRUCTIVE_REQUIRES_CONFIRM_MSG = 'This operation is destructive. Rerun with --yes to confirm.';
+/**
+ * 完整的"yes/tty/交互"决策门。直接用于无需 fetch 预览的简单确认场景（如 migration init）。
+ *
+ * 返回值：
+ *   - true  → 已确认，可执行
+ *   - false → TTY 下用户输了 n，调用方应渲染 Aborted 并退出
+ *
+ * 异常：
+ *   - DESTRUCTIVE_REQUIRES_CONFIRM：非 TTY 且无 --yes
+ */
+async function confirmDestructive(prompt, yes) {
+    if (yes === true)
+        return true;
+    if (!(0, render_1.isStdoutTty)()) {
+        throw new error_1.AppError('DESTRUCTIVE_REQUIRES_CONFIRM', DESTRUCTIVE_REQUIRES_CONFIRM_MSG);
+    }
+    return askYesNo(prompt);
+}
+/**
+ * 给"需要在 confirm 之前先 fetch 预览"的场景（migration apply / recovery apply 可选优化）用：
+ * 在非 TTY 无 --yes 时提前抛错，避免无意义触发后端 dry-run RPC。
+ *
+ * 调用后 TTY 路径仍需自行调 askYesNo / confirmDestructive 完成交互。
+ */
+function assertDestructiveAllowedInTty(yes) {
+    if (yes === true)
+        return;
+    if (!(0, render_1.isStdoutTty)()) {
+        throw new error_1.AppError('DESTRUCTIVE_REQUIRES_CONFIRM', DESTRUCTIVE_REQUIRES_CONFIRM_MSG);
+    }
+}
+/**
+ * 交互式 y/N。输入读 stdin，prompt 写 stderr —— stderr 避免污染 --json 模式 stdout 的 envelope。
+ * 仅 'y'（忽略大小写）算确认；其余一律视为否决。
+ */
+async function askYesNo(prompt) {
+    const rl = node_readline_1.default.createInterface({ input: process.stdin, output: process.stderr });
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() === 'y');
+        });
+    });
+}

package/dist/cli/handlers/db/_env.js

@@ -0,0 +1,26 @@
+"use strict";
+// db 域内 --env 参数的 CLI vocab 校验。
+//
+// 用户视角的 vocab：
+//   - dev    → 多环境沙箱分支
+//   - online → 生产分支（向后端发请求时映射成 main，client.ts/api.ts 已处理）
+//   - main   → online 的别名，兼容历史脚本
+//
+// 配合 client.ts::buildUnknownEnvError，把 vocab 错（这里）跟 backend state 错
+// （client.ts 处理）统一成同一类 UNKNOWN_ENV_VALUE，避免用户在两种失败之间困惑。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateEnv = validateEnv;
+const client_1 = require("../../../api/db/client");
+const VOCAB = ['dev', 'main', 'online'];
+const VOCAB_SET = new Set(VOCAB);
+/**
+ * CLI vocab 校验。空值（未传 --env）放行，由后端按 workspace 默认 branch 处理。
+ * 不在 vocab 内 → 抛 UNKNOWN_ENV_VALUE，preAction hook 兜底，避免无意义触发 RPC。
+ */
+function validateEnv(env) {
+    if (env === undefined || env === '')
+        return;
+    if (VOCAB_SET.has(env))
+        return;
+    throw (0, client_1.buildUnknownEnvError)(env);
+}

package/dist/cli/handlers/db/_operator.js

@@ -0,0 +1,35 @@
+"use strict";
+// changelog / audit 共用：把后端透传的 operator 字符串还原成 {id, name}。
+//
+// 后端约定：Operator 字段值是 `{"id":"<user_id>","name":"<resolved_name>"}` JSON
+// 字符串（dataloom inner_service.encodeOperator 生成），用同一字段同时承载机器可
+// 识别的 user_id 与人类可读 name。
+//
+// 选择"字符串内嵌 JSON"而不是 IDL struct，是为了避免 dataloom_inner.thrift +
+// kitex_gen 跨仓库改造；CLI 端 JSON.parse 拆开即可分场景渲染：
+//   - --json 模式：返 {id, name} 对象（agent / 下游能区分同名用户）
+//   - pretty 模式：只取 name（兼容 PRD 原始 string 形态）
+//
+// 历史数据 / 旧版后端没接这层时，operator 仍是纯字符串。该函数兼容：
+//   - 解析失败 → 当作 {id: raw, name: raw}
+//   - 解析成功但缺字段 → 用现有字段兜底另一个
+// 解析失败默认不报错，保留 raw 作为兜底显示文本。
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseOperator = parseOperator;
+function parseOperator(raw) {
+    if (raw === undefined || raw === null || raw === '') {
+        return { id: '', name: '' };
+    }
+    if (!raw.startsWith('{')) {
+        return { id: raw, name: raw };
+    }
+    try {
+        const obj = JSON.parse(raw);
+        const id = typeof obj.id === 'string' ? obj.id : '';
+        const name = typeof obj.name === 'string' && obj.name !== '' ? obj.name : id;
+        return { id, name };
+    }
+    catch {
+        return { id: raw, name: raw };
+    }
+}