@volc-emr/emr-cli 0.1.0-beta.0 → 0.1.2

package/README.md

@@ -1,336 +1,24 @@
-# volc-emr-agent
+# @volc-emr/emr-cli
 
-> 一个 **可控、可审计、可 dry-run** 的 Volcengine EMR CLI Agent。
->
-> Tool-first · Plan → Execute · LLM Planner（可选）· 真实 OpenAPI 调用 · 本地凭证 / 偏好记忆。
+EMR Command Line Interface，面向 ECS 提交机的认证初始化、客户端部署、集群信息查询与集群配置同步工具。
 
-你用一句自然语言描述任务（例如"列出所有运行中的集群"、"清理一周前已关停的集群"、"帮我建一个 3.7.0 的 Hadoop 集群"），Agent 会：
-
-1. 由 LLM 生成一份结构化 `Plan`
-2. 高风险步骤前弹确认（或 `-y` 跳过）
-3. 交由 Executor 依次调用 Tool
-4. Tool 用 Zod 校验 LLM 输入 → 调用真实 EMR OpenAPI → 把结果写回 stdout
-5. 创建集群这类复合 Tool，会**再次**交互式向你追问缺失字段并回填常用默认值
-
----
-
-## 已对接的 EMR OpenAPI（Version=2023-08-15）
-
-| Tool | OpenAPI Action | 风险级别 | 说明 |
-|---|---|---|---|
-| `listClusters` | [ListClusters](https://www.volcengine.com/docs/6491/1208305) | low | 支持全字段过滤 / 分页 / 中文状态别名归一化 |
-| `findClustersToCleanup` | ListClusters | low | 组合查询：超过 N 天 + 处于 SHUTDOWN 类状态 |
-| `deleteCluster` | [ReleaseCluster](https://www.volcengine.com/docs/6491/1208304) | **high** | 自动识别归档 / 已释放 / 不存在 → 幂等跳过而非中断 |
-| `createCluster` | [CreateCluster](https://www.volcengine.com/docs/6491/1208307) | **high** | 交互式补全 13 类必填字段、PRE/POST 计费分支、节点组向导 |
-
----
-
-## 安装
-
-```bash
-# 通过 npm 全局安装（推荐）
-npm install -g @volc-emr/emr-cli@beta
-
-# 验证（CLI 命令名仍是 volc-emr-agent）
-volc-emr-agent --help
-```
-
-或者本地开发模式：
-
-```bash
-git clone <repo>
-cd console-cli
-npm install
-npm run build
-npm link        # 注册 `volc-emr-agent` 到 PATH
-```
-
-**环境要求**：Node.js ≥ 18
-
----
-
-## 快速上手（三步）
-
-```bash
-# 1) 初始化：填 AK/SK、地域，可选一起填 LLM
-volc-emr-agent init
-
-# 2) 跑第一条命令（只打印 Plan，不执行）
-volc-emr-agent run "列出所有运行中的集群" --dry-run
-
-# 3) 真正执行
-volc-emr-agent run "列出所有运行中的集群"
-```
-
----
-
-## 凭证与配置
-
-优先级统一为：**CLI 参数 > 环境变量 > 本地配置文件**。
-
-### 本地配置文件位置
-
-| 文件 | 内容 | 权限 |
-|---|---|---|
-| `~/.volc-emr/config.json` | Volcengine AK/SK/Region + LLM endpoint/apiKey/model | `0600` |
-| `~/.volc-emr/create-cluster-memory.json` | 创建集群向导的常用偏好（VPC/子网/可用区/机型等） | `0600` |
-
-可通过 `VOLC_EMR_CONFIG_DIR` 环境变量整体改位置（测试 / 多环境友好）。
-
-### 写配置
-
-```bash
-# 交互式向导（支持同时配 LLM）
-volc-emr-agent init
-
-# 已有配置？加 --force 跳过确认
-volc-emr-agent init --force
-
-# 非交互（CI 友好）
-volc-emr-agent init \
-  --access-key "$VOLC_ACCESSKEY" \
-  --secret-key "$VOLC_SECRETKEY" \
-  --region cn-beijing
-
-# 单独写凭证
-volc-emr-agent config set-credentials \
-  --access-key xxx --secret-key yyy --region cn-beijing
-
-# 单独写 LLM
-volc-emr-agent config set-llm \
-  --endpoint https://ark.cn-beijing.volces.com/api/v3/chat/completions \
-  --api-key ark-xxx \
-  --model doubao-seed-character-251128
-```
-
-### 环境变量
-
-```bash
-export VOLC_ACCESSKEY=xxx
-export VOLC_SECRETKEY=yyy
-export VOLC_REGION=cn-beijing
-
-# LLM（可选；未配置时 Planner 会直接报错，不做 rule-based 兜底）
-export VOLC_LLM_ENDPOINT=https://ark.cn-beijing.volces.com/api/v3/chat/completions
-export VOLC_LLM_API_KEY=ark-xxx
-export VOLC_LLM_MODEL=doubao-seed-character-251128
-```
-
-### 查看 / 重定向
-
-```bash
-# 查看已保存的本地配置（secrets 自动脱敏）
-volc-emr-agent config show
-
-# 改用自定义目录
-VOLC_EMR_CONFIG_DIR=/tmp/volc-test volc-emr-agent init
-```
-
----
-
-## 运行示例
-
-### 列出集群
-
-```bash
-volc-emr-agent run "列出所有运行中的集群"
-volc-emr-agent run "列出 cn-beijing 最近创建的 10 个 Hadoop 集群"
-```
-
-### 清理老集群
+## 安装（npmjs）
 
 ```bash
-# 看 Plan、不执行
-volc-emr-agent run "清理一周前已关停的集群" --dry-run
-
-# 批量执行（自动确认所有 high-risk 步骤）
-volc-emr-agent run "清理一周前已关停的集群" -y
-
-# 自定义天数
-volc-emr-agent run "清理 14 天前已关停的集群"
+npm install -g @volc-emr/emr-cli --registry https://registry.npmjs.org/
 ```
 
-> 已被 EMR 归档（`marked archived`）的集群会被自动识别并**跳过**，不会让整个清理流程中断。
-
-### 创建集群（交互式向导）
+## 使用
 
 ```bash
-volc-emr-agent run "帮我创建一个 3.7.0 的 Hadoop 集群"
-```
-
-LLM 会先从你的描述里预填能猜到的字段（`ClusterType=Hadoop, ReleaseVersion=3.7.0`），Tool 接着启动向导：
-
-```
-=== 创建 EMR 集群：补全配置 ===
-(已加载上次记忆，路径: /Users/you/.volc-emr/create-cluster-memory.json)
-
-集群类型 (可选: Hadoop / Presto / ...) [Hadoop]: ⏎
-集群版本 (ReleaseVersion) [3.7.0]: ⏎
-集群名称 [OpenApiHadoop3.7.0-a7x2m]: ⏎
-付费类型 (可选: POST / PRE) [POST]: ⏎
-VpcId (如 vpc-xxx) [vpc-abc123]: ⏎          ← 来自上次记忆
-SecurityGroupId (如 sg-xxx) [sg-def456]: ⏎  ← 来自上次记忆
-可用区 ZoneId [cn-beijing-b]: ⏎
-
--- 节点组配置 (共 2 组) --
-[节点组 1]
-节点组类型 (可选: MASTER / CORE / TASK / GATEWAY) [MASTER]: ⏎
-  节点数 [3]: ⏎
-  SubnetIds (逗号分隔) [subnet-xyz]: ⏎
-  EcsInstanceTypes [ecs.g3i.2xlarge]: ⏎
-...
-
-=== 即将创建集群，配置如下 ===
-{ ...完整 JSON... }
-确认使用以上配置创建集群? (y/n): y
-
-(已更新常用默认值记忆: /Users/you/.volc-emr/create-cluster-memory.json)
-✓ 集群创建成功: ClusterId=emr-xxx, OperationId=op-xxx
-```
-
-**特性**：
-
-- **记忆**：用户确认后立刻写 `create-cluster-memory.json`。即使 OpenAPI 随后返回错误，下次依然能复用你填过的网络/节点偏好，不用再填一遍
-- **中文状态 / 大小写自动归一化**：LLM 写成 "已关停" / "Running" 都能被翻译成官方枚举
-- **MASTER + CORE 自动补齐**：Hadoop 类集群强制至少两个节点组
-- **ChargeType=PRE 自动展开包年包月子向导**（周期 / 自动续费）
-
----
-
-## 命令总览
-
-| 命令 | 作用 |
-|---|---|
-| `volc-emr-agent init [--force]` | 交互式写入 AK/SK、可选一起配 LLM |
-| `volc-emr-agent config set-credentials --access-key ... --secret-key ...` | 单独更新凭证 |
-| `volc-emr-agent config set-llm --endpoint ... [--api-key ...] [--model ...]` | 单独更新 LLM |
-| `volc-emr-agent config show` | 查看本地配置（脱敏） |
-| `volc-emr-agent run <task> [--dry-run] [-y] [--region ...]` | 执行一条自然语言任务 |
-
-运行选项：
-
-- `--dry-run`：只打印 Plan，不调用任何 OpenAPI
-- `-y, --yes`：对 `riskLevel: "high"` 的 Tool 自动确认
-- `--region <region>`：临时覆盖当前会话的区域（不写配置）
-
----
-
-## 目录结构
-
-```
-src/
-├── index.ts                      # CLI 入口（commander）
-├── agent/
-│   ├── agent.ts                  # 对外 Agent.run(task, options)
-│   ├── planner.ts                # LLM-only Planner，无 LLM 时直接报错
-│   ├── llmPlanner.ts             # 把 Zod 输入翻成 JSON Schema 喂给 LLM
-│   ├── executor.ts               # 依次执行 Plan，触发高风险确认
-│   └── types.ts
-├── services/
-│   ├── volcApi.ts                # @volcengine/openapi 签名 + 错误解析
-│   └── emrApi.ts                 # listClusters / releaseCluster / createCluster ...
-├── tools/
-│   ├── base.ts                   # Tool 定义 (name/description/input/riskLevel/execute)
-│   ├── registry.ts               # 聚合所有业务 Tool + API
-│   └── emr/
-│       ├── index.ts
-│       ├── listClusters.ts
-│       ├── findClustersToCleanup.ts
-│       ├── deleteCluster.ts      # → ReleaseCluster
-│       └── createCluster.ts      # 交互式向导 + 记忆
-├── runtime/
-│   ├── config.ts                 # AK/SK + LLM 持久化
-│   ├── createClusterMemory.ts    # 创建集群专用的偏好记忆（独立文件）
-│   ├── confirm.ts                # TTY / pipe 双模安全的 prompt
-│   ├── llm.ts                    # OpenAI-compatible Chat Completions 客户端
-│   ├── memory.ts                 # 进程内简易 KV
-│   └── logger.ts
-└── utils/prompt.ts
-```
-
----
-
-## 关键设计
-
-### 1. Tool-first
-
-所有业务能力都是 Tool（`name / description / input (Zod) / riskLevel / execute`）。LLM 看到的只有 Tool 目录（由 `zod-to-json-schema` 自动生成），**不能直接执行副作用**。
-
-### 2. Plan → Execute 分离
-
-```
-用户自然语言
-   ↓
-Planner（LLM, Zod 校验）→ PlanStep[]
-   ↓
-Executor（读 registry, 拦截 high-risk, 调用 Tool）
-   ↓
-真实 Volcengine OpenAPI
+emr-cli --help
+emr-cli auth init
+emr-cli cluster get  --pretty
+emr-cli cluster get --cluster-id emrxxx --pretty
 ```
 
-### 3. 枚举三层防御（以 `ClusterStates` 为例）
-
-- **Schema 层**：Tool input 用 `z.nativeEnum(EmrClusterState)`，LLM 收到带 `enum` 的 JSON Schema
-- **Prompt 层**：Tool description 里显式印合法枚举清单
-- **执行层**：Tool `execute()` 内部再做一次大小写 + 中文别名兜底
-
-### 4. OpenAPI 错误可读化
-
-[volcApi.ts](src/services/volcApi.ts) 对火山返回做结构化解析，错误消息会带 `Code / RequestId / body` 等排障必需的上下文，而不是一句干巴巴的 `Internal error`。
-
-### 5. 记忆分文件，互不污染
-
-- `config.json`：**身份**（AK/SK、LLM token）。敏感，少变。
-- `create-cluster-memory.json`：**偏好**（VPC/子网/ZoneId/机型）。常变，可分享模板。
-
-写入时机在 **确认后立刻写**（而不是 API 成功后），哪怕 OpenAPI 挂了，你下次也不用重填网络信息。
-
----
-
-## LLM 配置提示
-
-Planner 要求必须配置 LLM（OpenAI-compatible `/chat/completions`）。已验证可用的：
-
-- **火山方舟 Ark**：
-  ```
-  endpoint: https://ark.cn-beijing.volces.com/api/v3/chat/completions
-  model:    doubao-seed-character-251128（或其他 doubao 模型）
-  ```
-- **OpenAI 官方**：
-  ```
-  endpoint: https://api.openai.com/v1/chat/completions
-  model:    gpt-4o-mini
-  ```
-- **任何兼容 OpenAI 协议的网关**（Together / Groq / Fireworks / 本地 vLLM 等）
-
-如果模型不支持 `response_format=json_object`，Planner 会退化到 "字符串 JSON + markdown fence 清洗" 的 robust 模式，无需额外改配置。
-
----
-
-## 故障排查
-
-| 现象 | 原因 / 处理 |
-|---|---|
-| `[ListClusters] The request is missing Version parameter` | `@volcengine/openapi` 需要 `Version` 而非 `version` — 现已修好 |
-| `[ListClusters] Invalid request {0}` | LLM 传了非法字段或类型，Tool 层错误消息会附上 body 预览 |
-| `[CreateCluster] Internal error` | 5xx；抓取 `RequestId` 后去[火山工单](https://console.volcengine.com/workorder/create/)，或用相同参数在 [API Explorer](https://api.volcengine.com/api-explorer/?action=CreateCluster&serviceCode=emr&version=2023-08-15) 复现 |
-| `LLM is not configured` | Planner 没有 rule-based 兜底，请先 `volc-emr-agent config set-llm` |
-| 清理时个别集群报 `marked archived` | 会被 `deleteCluster` 内部捕获，返回 `{ Skipped: true, Reason: "ARCHIVED" }` 并作为该步 `Done` 结果打印，不影响其它集群清理 |
-
-想看更详细的请求/响应？可以临时编辑 [volcApi.ts](src/services/volcApi.ts) 在 `fetchApi(body)` 前后加 `console.error` 打印 body 和 response。
-
----
-
-## 后续规划
-
-- [ ] 支持 `CreateCluster` 的 `--config file.json` 无交互模式（CI 友好）
-- [ ] 更多 EMR Action：`GetCluster` / `ScaleOutNodeGroup` / `UpdateClusterAttribute`
-- [ ] 多 profile 记忆（`--profile prod/test`）
-- [ ] Tool catalog 热插拔、跨业务目录（非 EMR）
-- [ ] Executor 级别的 retry / rollback / 流式输出
-
----
-
-## License
+## 说明
 
-[MIT](./LICENSE)
+- `cluster get` 调用 Volc EMR OpenAPI `GetCluster`
+- `--pretty` 会格式化输出集群信息，便于阅读
+- `--debug` 会输出 `RequestId` 与签名用的 `CanonicalRequest`，便于排查鉴权/权限问题

package/bin/emr-cli

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+
+require('../dist/index');

package/dist/auth/index.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerAuthCommands(program: Command): void;

package/dist/auth/index.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAuthCommands = registerAuthCommands;
+const config_1 = require("../utils/config");
+// Local typings for `inquirer` can differ across package manager layouts; use
+// a narrow runtime import here to keep the CLI compile-safe in this workspace.
+const inquirer = require('inquirer');
+async function promptAuthConfig(force = false) {
+    const current = (0, config_1.tryLoadConfig)();
+    if (!force &&
+        (current.ak || current.sk || current.region || current.clusterId)) {
+        const { confirmed } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'confirmed',
+                message: '检测到已有认证配置，是否覆盖？',
+                default: false,
+            },
+        ]);
+        if (!confirmed) {
+            console.info('已取消覆盖，保留现有配置。');
+            return undefined;
+        }
+    }
+    return inquirer.prompt([
+        {
+            type: 'input',
+            name: 'ak',
+            message: '请输入 AccessKey (AK):',
+            default: current.ak,
+            validate: (input) => input?.trim() ? true : 'AccessKey 不能为空',
+        },
+        {
+            type: 'password',
+            name: 'sk',
+            message: '请输入 SecretKey (SK):',
+            default: current.sk,
+            mask: '*',
+            validate: (input) => input?.trim() ? true : 'SecretKey 不能为空',
+        },
+        {
+            type: 'input',
+            name: 'region',
+            message: '请输入默认 Region:',
+            default: current.region || 'cn-beijing',
+            validate: (input) => (input?.trim() ? true : 'Region 不能为空'),
+        },
+        {
+            type: 'input',
+            name: 'clusterId',
+            message: '请输入默认 ClusterId [选填]:',
+            default: current.clusterId,
+        },
+    ]);
+}
+function registerAuthCommands(program) {
+    const authCmd = program.command('auth').description('认证与配置管理');
+    authCmd
+        .command('init')
+        .description('初始化认证配置')
+        .option('--ak <ak>', 'AccessKey')
+        .option('--sk <sk>', 'SecretKey')
+        .option('--region <region>', '默认 Region')
+        .option('--cluster-id <clusterId>', '默认 ClusterId')
+        .option('--force', '强制覆盖已有配置')
+        .action(async (options) => {
+        let payload = {
+            ak: options.ak,
+            sk: options.sk,
+            region: options.region,
+            clusterId: options.clusterId,
+        };
+        if (!payload.ak || !payload.sk || !payload.region) {
+            const answers = await promptAuthConfig(Boolean(options.force));
+            if (!answers)
+                return;
+            payload = {
+                ak: answers.ak?.trim(),
+                sk: answers.sk?.trim(),
+                region: answers.region?.trim(),
+                clusterId: answers.clusterId?.trim() || undefined,
+            };
+        }
+        (0, config_1.updateConfig)(payload);
+        console.info('✓ 认证配置已保存');
+        console.info(`配置文件位置: ${(0, config_1.getConfigPath)()}`);
+    });
+    authCmd
+        .command('show')
+        .description('查看当前认证配置')
+        .action(() => {
+        const config = (0, config_1.tryLoadConfig)();
+        console.info(`配置文件位置: ${(0, config_1.getConfigPath)()}`);
+        console.info(`AK: ${(0, config_1.maskSecret)(config.ak)}`);
+        console.info(`SK: ${(0, config_1.maskSecret)(config.sk)}`);
+        console.info(`Region: ${config.region || '未设置'}`);
+        console.info(`ClusterId: ${config.clusterId || '未设置'}`);
+    });
+    authCmd
+        .command('clear')
+        .description('清空本地认证配置')
+        .action(() => {
+        (0, config_1.clearConfig)();
+        console.info('✓ 本地认证配置已清空');
+    });
+    // Shortcut for first-time users
+    program
+        .command('init')
+        .description('初始化 EMR-CLI 认证配置')
+        .action(async () => {
+        await program.parseAsync(['node', 'emr-cli', 'auth', 'init'], {
+            from: 'user',
+        });
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/client/index.d.ts

@@ -0,0 +1,17 @@
+import type { Command } from 'commander';
+export interface InstallClientOptions {
+    dir?: string;
+    force?: boolean;
+    version?: string;
+    packageUrl?: string;
+}
+export declare function installClient(options: InstallClientOptions): {
+    dir: string;
+    version: string;
+};
+export declare function updateClient(options: InstallClientOptions): {
+    dir: string;
+    version: string;
+    updated: boolean;
+};
+export declare function registerClientCommands(program: Command): void;

package/dist/client/index.js

@@ -0,0 +1,129 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installClient = installClient;
+exports.updateClient = updateClient;
+exports.registerClientCommands = registerClientCommands;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const ora_1 = __importDefault(require("ora"));
+const client_state_1 = require("../utils/client-state");
+function installClient(options) {
+    const clientDir = (0, client_state_1.ensureClientDir)(options.dir);
+    const current = (0, client_state_1.readClientState)(clientDir);
+    if (current && !options.force) {
+        throw new Error('客户端已安装。如需覆盖安装，请使用 --force 参数。');
+    }
+    const version = options.version || 'latest';
+    const binDir = path.join(clientDir, 'bin');
+    const confDir = path.join(clientDir, 'conf');
+    fs.mkdirSync(binDir, { recursive: true });
+    fs.mkdirSync(confDir, { recursive: true });
+    fs.writeFileSync(path.join(binDir, 'emr-client.sh'), '#!/usr/bin/env bash\necho "EMR Client Ready"\n');
+    fs.writeFileSync(path.join(confDir, 'README.txt'), 'EMR 客户端配置目录\n');
+    (0, client_state_1.writeClientState)({
+        version,
+        installedAt: new Date().toISOString(),
+        packageUrl: options.packageUrl,
+    }, clientDir);
+    return { dir: clientDir, version };
+}
+function updateClient(options) {
+    const clientDir = (0, client_state_1.resolveClientDir)(options.dir);
+    const current = (0, client_state_1.readClientState)(clientDir);
+    if (!current) {
+        throw new Error('尚未安装客户端，请先执行 emr-cli client install');
+    }
+    const targetVersion = options.version || current.version;
+    if (current.version === targetVersion && !options.force) {
+        return { dir: clientDir, version: current.version, updated: false };
+    }
+    const result = installClient({
+        ...options,
+        dir: clientDir,
+        force: true,
+        version: targetVersion,
+    });
+    return { ...result, updated: true };
+}
+function registerClientCommands(program) {
+    const clientCmd = program.command('client').description('客户端安装与更新');
+    clientCmd
+        .command('install')
+        .description('安装客户端软件包并初始化目录')
+        .option('--dir <dir>', '客户端安装目录')
+        .option('--version <version>', '安装版本', 'latest')
+        .option('--package-url <url>', '安装包地址（记录到元数据中）')
+        .option('--force', '覆盖已有安装')
+        .action(async (options) => {
+        const spinner = (0, ora_1.default)('开始安装 EMR 客户端...').start();
+        try {
+            const result = installClient(options);
+            spinner.succeed(`客户端安装完成: ${result.dir}`);
+            console.info(`当前版本: ${result.version}`);
+        }
+        catch (error) {
+            spinner.fail('客户端安装失败');
+            throw error;
+        }
+    });
+    clientCmd
+        .command('update')
+        .description('更新客户端软件包')
+        .option('--dir <dir>', '客户端安装目录')
+        .option('--version <version>', '目标版本')
+        .option('--package-url <url>', '安装包地址（记录到元数据中）')
+        .option('--force', '即使版本一致也强制覆盖')
+        .action(async (options) => {
+        const spinner = (0, ora_1.default)('开始更新 EMR 客户端...').start();
+        try {
+            const result = updateClient(options);
+            if (!result.updated) {
+                spinner.succeed('当前客户端已是目标版本，无需更新');
+                return;
+            }
+            spinner.succeed(`客户端更新完成: ${result.dir}`);
+            console.info(`当前版本: ${result.version}`);
+        }
+        catch (error) {
+            spinner.fail('客户端更新失败');
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cluster/index.d.ts

@@ -0,0 +1,13 @@
+import type { Command } from 'commander';
+export interface SyncClusterOptions {
+    clusterId?: string;
+    dir?: string;
+    debug?: boolean;
+}
+export declare function syncClusterConfig(options: SyncClusterOptions): Promise<{
+    clusterId: string;
+    outputDir: string;
+    requestId?: string;
+    canonicalRequest?: string;
+}>;
+export declare function registerClusterCommands(program: Command): void;