@lark-apaas/miaoda-cli 0.1.2 → 0.1.3-alpha.09899c4

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

@@ -1,11 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.failArgs = void 0;
+exports.appIdOption = appIdOption;
+exports.branchOption = branchOption;
 exports.softRequiredOption = softRequiredOption;
 exports.resolveAppId = resolveAppId;
 exports.withHelp = withHelp;
-exports.failArgs = failArgs;
+exports.caseInsensitiveChoice = caseInsensitiveChoice;
+exports.validateTimeOptions = validateTimeOptions;
+exports.rejectCliOverride = rejectCliOverride;
 const commander_1 = require("commander");
 const error_1 = require("../../utils/error");
+const time_1 = require("../../utils/time");
+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');
+}
+function branchOption() {
+    return new commander_1.Option('--branch <branch>', '分支（优先级：--branch > 当前仓库 HEAD 分支；非 git 目录回退应用默认分支）').env('LOCAL_MOCK_MIAODA_DEPLOY_BRANCH');
+}
 /**
  * soft-required: Commander 类型上 optional，runtime 校验必填。
  */
@@ -21,20 +36,24 @@ 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;
 }
-/** 包裹 handler，缺 soft-required 参数时打 help 并退出 */
+/**
+ * 包裹 handler，缺 soft-required 参数 / 自定义校验失败时打 help 并退出。
+ *
+ * 兼容带位置参数的 action 签名（如 `(arg1: string, opts) => ...`）。
+ */
 function withHelp(cmd, handler) {
-    return async (opts) => {
+    return async (...args) => {
         try {
-            await handler(opts);
+            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;
@@ -44,7 +63,64 @@ function withHelp(cmd, handler) {
         }
     };
 }
-/** 参数校验失败时抛出，配合 withHelp 自动打 help */
-function failArgs(message) {
-    throw new error_1.AppError("ARGS_INVALID", message);
+/**
+ * 大小写不敏感的 choice argParser：把用户输入按 lowerCase 匹配回 canonical 数组里
+ * 的同名值（保留 canonical 大小写），未命中抛 Commander 的 InvalidArgumentError
+ * （exit code 1，自带友好错误）。
+ *
+ * 必须先 .choices(canonical)、再 .argParser()——Commander 内部 .choices() 会
+ * 重置 parseArg，反过来调会让 argParser 失效。.choices() 仅留给 help 渲染
+ * "choices: A, B, C"，实际白名单校验由 argParser 接管。
+ *
+ *   new Option("--level <level>", "日志级别（不区分大小写）")
+ *     .choices(["DEBUG", "INFO", "WARN", "ERROR"])
+ *     .argParser(caseInsensitiveChoice(["DEBUG", "INFO", "WARN", "ERROR"]));
+ */
+function caseInsensitiveChoice(canonical) {
+    const map = new Map(canonical.map((v) => [v.toLowerCase(), v]));
+    return (raw) => {
+        const hit = map.get(raw.toLowerCase());
+        if (hit === undefined) {
+            throw new commander_1.InvalidArgumentError(`Allowed choices are ${canonical.join(', ')} (case-insensitive).`);
+        }
+        return hit;
+    };
+}
+/**
+ * --since / --until 等时间参数的 action 阶段校验。
+ *
+ * Commander 的 argParser 会在 action 前直接按 parser error 退出（exit 1），
+ * 绕过 withHelp 的 ARGS_INVALID → exit 2 路径；所以时间参数在 action 内先
+ * 校验一遍，再把原始字符串交给 handler 解析成接口需要的单位。
+ */
+function validateTimeOptions(opts, ...names) {
+    for (const name of names) {
+        const value = opts[name];
+        if (value === undefined)
+            continue;
+        if (typeof value !== 'string') {
+            (0, args_1.failArgs)(`--${name.replace(/([A-Z])/g, '-$1').toLowerCase()} 必须是时间字符串`);
+        }
+        (0, time_1.parseTimeToMs)(value);
+    }
+}
+/**
+ * 拒绝 CLI 显式覆盖：用于 hideHelp() + .env() 的"沙箱注入参数"（如 --app-id / --branch）。
+ *
+ * Commander 的 getOptionValueSource() 区分来源（cli / env / default / config / undefined）；
+ * 用户在 CLI 上显式传时 source === "cli"，此时抛 ARGS_INVALID（exit 2 + help）。
+ *
+ * 用法：在 action 头部一行调用——
+ *   cmd.action(withHelp(cmd, async (rawOpts) => {
+ *     rejectCliOverride(cmd, "appId", "branch");
+ *     ...
+ *   }));
+ */
+function rejectCliOverride(cmd, ...optNames) {
+    for (const name of optNames) {
+        if (cmd.getOptionValueSource(name) === 'cli') {
+            const flag = '--' + name.replace(/([A-Z])/g, '-$1').toLowerCase();
+            (0, args_1.failArgs)(`${flag} 由沙箱/本地配置注入，不允许显式传递`);
+        }
+    }
 }

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

@@ -0,0 +1,47 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleAppGet = handleAppGet;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const index_1 = require("../../../api/app/index");
+/** miaoda app get [--app-id <id>] */
+async function handleAppGet(opts) {
+    const appID = opts.appId;
+    const resp = await api.app.getAppInfo(appID);
+    // BAM 在 status_code=0 时 data 字段含 appInfo；不存在则 fallback 空对象
+    const meta = resp.appInfo?.appMeta ?? {};
+    (0, output_1.emit)({ data: meta }, index_1.appMetaSchema);
+}

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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; } });

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

@@ -0,0 +1,59 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleAppUpdate = handleAppUpdate;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const args_1 = require("../../../utils/args");
+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 中的一个');
+    }
+    const appID = opts.appId;
+    await api.app.updateAppMeta({
+        appID,
+        name: opts.name,
+        description: opts.description,
+    });
+    // 服务端不回写新 meta，本地再 fetch 一次拿最新值给用户
+    const resp = await api.app.getAppInfo(appID);
+    const meta = resp.appInfo?.appMeta ?? {};
+    if (!(0, output_1.isJsonMode)()) {
+        process.stdout.write('✓ App updated successfully\n');
+    }
+    (0, output_1.emit)({ data: meta }, index_1.appMetaSchema);
+}

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