@newpeak/barista-cli 0.1.3 → 0.1.5

package/docs/commands/liberica/uoms-enable.md

@@ -0,0 +1,115 @@
+# barista liberica uoms enable
+
+启用计量单位（批量）。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica uoms enable <uom-id...>` |
+| 功能描述 | 启用一个或多个计量单位 |
+| HTTP方法 | POST |
+| 是否需要认证 | ✅ 是 |
+| 是否支持dry-run | ⬜ 否 |
+
+## 2.2 后端接口引用
+
+### Controller位置
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/sales/
+        └── MasterUomController.java
+            └── enableUom(@PostResource(path = "/batchActive"))
+                └── public ResponseData<Void> enableUom(
+                        @RequestBody Map<String, List<String>> request
+                    )
+```
+
+### Request DTO位置
+```
+- 批量启用请求：{ uomIdList: List<String> }
+```
+
+### Response DTO位置
+```
+- 返回 void 或成功标记（ResponseData<Void>）
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica uoms enable <uom-id...> [options]
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--json` | boolean | JSON输出 |
+
+### 位置参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| uom-id... | string | ✅ | 一个或多个计量单位ID |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --uom-id | -i | string | ⬜ | - | 计量单位ID（逗号分隔，与位置参数互斥） | uomIdList |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| uom-id... (位置参数) | uomIdList | string[]→List<String> | 至少一个ID |
+| --uom-id / -i | uomIdList | string→List<String> | 逗号分隔 |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/exception/enums/MasterUomExceptionEnum.java
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| UOM_NOT_EXIST | 计量单位不存在 | UOM不存在 |
+| UOM_NO_PERMISSION | 无权限操作 | 无权限操作 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| 注解 | MasterUomController.java | 需要 `master_uom:edit` 权限 |
+
+## 2.7 实现要点
+
+1. **批量支持**：支持单个ID或多个ID（空格分隔）
+2. **ID来源**：可通过位置参数或 --uom-id 选项传递
+3. **逗号分隔**：--uom-id 选项支持逗号分隔的多个ID
+4. **状态变更**：将 statusFlag 从 2（禁用）改为 1（启用）
+5. **部分失败**：如果某些ID不存在，后端可能返回错误或仅处理存在的ID
+6. **API路径**：POST `/api/enterprise/sales/uom/batchActive`
+7. **请求格式**：{ uomIdList: ["id1", "id2", ...] }
+
+## 2.8 示例用法
+
+```bash
+# 启用单个计量单位
+barista liberica uoms enable "1234567890123456789"
+
+# 启用多个计量单位
+barista liberica uoms enable "1234567890123456789" "9876543210987654321"
+
+# 通过选项参数启用（逗号分隔）
+barista liberica uoms enable --uom-id "1234567890123456789,9876543210987654321"
+barista liberica uoms enable -i "1234567890123456789,9876543210987654321"
+
+# JSON 输出
+barista liberica uoms enable "1234567890123456789" --json
+```

package/docs/commands/liberica/uoms-get.md

@@ -0,0 +1,119 @@
+# barista liberica uoms get
+
+获取单个计量单位详情。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica uoms get <uom-id>` |
+| 功能描述 | 获取计量单位详情 |
+| HTTP方法 | GET |
+| 是否需要认证 | ✅ 是 |
+| 是否支持dry-run | ⬜ 否 |
+
+## 2.2 后端接口引用
+
+### Controller位置
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/sales/
+        └── MasterUomController.java
+            └── getUom(@GetResource(path = "/detail"))
+                └── public ResponseData<MasterUomResponse> getUom(
+                        @RequestParam String uomId
+                    )
+```
+
+### Request DTO位置
+```
+[无Request DTO]
+- uomId通过@RequestParam传递
+```
+
+### Response DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/pojo/response/MasterUomResponse.java
+    ├── uomId: String
+    ├── uomCode: String
+    ├── uomName: String
+    ├── uomFractionPlaces: Integer
+    ├── statusFlag: Integer (1=启用，2=禁用)
+    ├── remark: String
+    ├── createTime: String
+    └── updateTime: String
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica uoms get <uom-id> [options]
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--json` | boolean | JSON输出 |
+
+### 位置参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| uom-id | string | ✅ | 计量单位ID |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --uom-id | -i | string | ⬜ | - | 计量单位ID（与位置参数互斥） | uomId |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| uom-id (位置参数) | uomId | string→String | @NotBlank |
+| --uom-id / -i | uomId | string→String | @NotBlank |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/exception/enums/MasterUomExceptionEnum.java
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| UOM_NOT_EXIST | 计量单位不存在 | ID不存在 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| 注解 | 无需权限 | 登录用户可访问 |
+
+## 2.7 实现要点
+
+1. **参数解析**：支持位置参数 `<uom-id>` 和选项参数 `--uom-id`
+2. **ID必填**：uomId为必填参数
+3. **输出格式**：格式化展示UOM详情，包括基本信息和状态
+4. **错误处理**：UOM不存在时显示友好错误提示
+5. **API路径**：GET `/api/enterprise/sales/uom/detail`
+
+## 2.8 示例用法
+
+```bash
+# 通过位置参数获取
+barista liberica uoms get "1234567890123456789"
+
+# 通过选项参数获取
+barista liberica uoms get --uom-id "1234567890123456789"
+barista liberica uoms get -i "1234567890123456789"
+
+# JSON 输出
+barista liberica uoms get "1234567890123456789" --json
+```

package/docs/commands/liberica/uoms-list.md

@@ -0,0 +1,155 @@
+# barista liberica uoms list
+
+分页查询计量单位列表。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica uoms list` |
+| 功能描述 | 分页查询计量单位列表 |
+| HTTP方法 | GET |
+| 是否需要认证 | ✅ 是 |
+| 是否支持dry-run | ⬜ 否 |
+
+## 2.2 后端接口引用
+
+### Controller位置
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/sales/
+        └── MasterUomController.java
+            └── listUoms(@GetResource(path = "/page"))
+                └── public ResponseData<PageResult<MasterUomResponse>> listUoms(
+                        @ParameterObject MasterUomRequest request
+                    )
+```
+
+### Request DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/pojo/request/MasterUomRequest.java
+    ├── pageNo: Long (分页页码，从0开始)
+    ├── pageSize: Long (分页大小)
+    ├── uomCode: String (计量单位编码)
+    ├── uomName: String (计量单位名称)
+    └── statusFlag: Integer (状态：1=启用，2=禁用)
+```
+
+### Response DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/pojo/response/MasterUomResponse.java
+    ├── uomId: String
+    ├── uomCode: String
+    ├── uomName: String
+    ├── uomFractionPlaces: Integer
+    ├── statusFlag: Integer (1=启用，2=禁用)
+    ├── remark: String
+    ├── createTime: String
+    └── updateTime: String
+```
+
+### 分页包装器
+```
+cn.stylefeng.roses.kernel.db.api.pojo.page.PageResult
+    ├── totalRows: long
+    ├── pageSize: long
+    ├── pageNo: long
+    └── rows: List<MasterUomResponse>
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica uoms list [options]
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--json` | boolean | JSON输出 |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --page | -p | number | ⬜ | 1 | 页码（从1开始） | pageNo (转换：CLI页码-1) |
+| --size | -s | number | ⬜ | 20 | 每页条数 | pageSize |
+| --status | — | string | ⬜ | - | 状态：enable/disable | statusFlag (enable=1, disable=2) |
+| --code | -c | string | ⬜ | - | 计量单位编码 | uomCode |
+| --name | -n | string | ⬜ | - | 计量单位名称 | uomName |
+| --keyword | -k | string | ⬜ | - | 搜索关键词（编码/名称） | uomCode/uomName |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| --page / -p | pageNo | number→Long，CLI页码-1 | >= 1 |
+| --size / -s | pageSize | number→Long | 1-100 |
+| --status | statusFlag | string→Integer | enable=1, disable=2 |
+| --code / -c | uomCode | string→String | - |
+| --name / -n | uomName | string→String | - |
+| --keyword / -k | uomCode/uomName | string→String | 模糊查询 |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/exception/enums/MasterUomExceptionEnum.java
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| UOM_NOT_EXIST | 计量单位不存在 | 查询/编辑/删除时ID不存在 |
+| UOM_CODE_DUPLICATE | 计量单位编码重复 | 创建/编辑时编码已存在 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| 注解 | 无需权限 | 登录用户可访问 |
+
+## 2.7 实现要点
+
+1. **分页默认值**：page=1, size=20
+2. **分页转换**：CLI使用1-based页码，API使用0-based页码（调用时需减1）
+3. **搜索行为**：keyword 同时匹配 uomCode 和 uomName（模糊查询）
+4. **状态映射**：CLI参数 `enable`/`disable` 映射到 API 值 `1`/`2`
+5. **无结果处理**：返回空列表，不抛出异常
+6. **tenantId来源**：来自 JWT token（无需 X-TENANT-ID header）
+7. **输出格式**：表格形式展示，分页信息在底部显示
+8. **API路径**：GET `/api/enterprise/sales/uom/page`
+
+## 2.8 示例用法
+
+```bash
+# 默认分页
+barista liberica uoms list
+
+# 指定页码和每页条数
+barista liberica uoms list --page 2 --size 50
+
+# 按状态筛选
+barista liberica uoms list --status enable
+
+# 按编码筛选
+barista liberica uoms list --code "kg"
+
+# 按名称搜索
+barista liberica uoms list --name "千克"
+
+# 关键词搜索
+barista liberica uoms list --keyword "克"
+
+# 组合筛选
+barista liberica uoms list --page 1 --size 10 --status enable --keyword "kg"
+
+# JSON 输出（便于脚本处理）
+barista liberica uoms list --page 1 --size 20 --json
+```

package/docs/commands/liberica/uoms-update.md

@@ -0,0 +1,148 @@
+# barista liberica uoms update
+
+更新计量单位信息。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica uoms update <uom-id>` |
+| 功能描述 | 更新计量单位信息 |
+| HTTP方法 | POST |
+| 是否需要认证 | ✅ 是 |
+| 是否支持dry-run | ✅ 是 |
+
+## 2.2 后端接口引用
+
+### Controller位置
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/sales/
+        └── MasterUomController.java
+            └── updateUom(@PostResource(path = "/edit"))
+                └── public ResponseData<MasterUomResponse> updateUom(
+                        @RequestBody @Validated MasterUomRequest request
+                    )
+```
+
+### Request DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/pojo/request/MasterUomRequest.java
+    ├── uomId: String (@NotBlank)
+    ├── uomCode: String (@NotBlank)
+    ├── uomName: String (@NotBlank)
+    ├── uomFractionPlaces: Integer (default: 2)
+    ├── statusFlag: Integer (1=启用, 2=禁用)
+    └── remark: String (optional)
+```
+
+### Response DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/pojo/response/MasterUomResponse.java
+    ├── uomId: String
+    ├── uomCode: String
+    ├── uomName: String
+    ├── uomFractionPlaces: Integer
+    ├── statusFlag: Integer
+    ├── remark: String
+    ├── createTime: String
+    └── updateTime: String
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica uoms update <uom-id> [options]
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--dry-run` | boolean | 预览模式 |
+| `--json` | boolean | JSON输出 |
+
+### 位置参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| uom-id | string | ✅ | 计量单位ID |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --uom-id | -i | string | ⬜ | - | 计量单位ID（与位置参数互斥） | uomId |
+| --code | -c | string | ✅ | - | 计量单位编码 | uomCode |
+| --name | -n | string | ✅ | - | 计量单位名称 | uomName |
+| --fraction-places | -f | number | ⬜ | 2 | 小数位数 | uomFractionPlaces |
+| --remark | -r | string | ⬜ | - | 备注 | remark |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| uom-id (位置参数) | uomId | string→String | @NotBlank |
+| --uom-id / -i | uomId | string→String | @NotBlank |
+| --code / -c | uomCode | string→String | @NotBlank, max=255 |
+| --name / -n | uomName | string→String | @NotBlank, max=255 |
+| --fraction-places / -f | uomFractionPlaces | number→Integer | >= 0, <= 10 |
+| --remark / -r | remark | string→String | max=500 |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-uom/uom-api/src/main/java/com/newpeak/liberica/uom/api/exception/enums/MasterUomExceptionEnum.java
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| UOM_NOT_EXIST | 计量单位不存在 | UOM不存在 |
+| UOM_CODE_DUPLICATE | 计量单位编码重复 | 编码重复 |
+| UOM_CODE_EMPTY | 计量单位编码不能为空 | 编码为空 |
+| UOM_NAME_EMPTY | 计量单位名称不能为空 | 名称为空 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| 注解 | MasterUomController.java | 需要 `master_uom:edit` 权限 |
+
+## 2.7 实现要点
+
+1. **ID必填**：uomId为必填参数（位置参数或 --uom-id 选项）
+2. **必填字段**：uomCode 和 uomName 为必填参数（通常需要先获取现有值再修改）
+3. **dry-run 支持**：支持 `--dry-run` 预览模式，显示将要更新的字段变化
+4. **完整更新**：后端可能是完整更新模式，需要提供所有字段值
+5. **建议用法**：先执行 `barista liberica uoms get <id>` 获取当前值，再更新指定字段
+6. **API路径**：POST `/api/enterprise/sales/uom/edit`
+7. **成功响应**：返回更新后的UOM详情
+
+## 2.8 示例用法
+
+```bash
+# 更新计量单位（通过位置参数）
+barista liberica uoms update "1234567890123456789" --code "kg" --name "千克"
+
+# 更新计量单位（通过选项参数）
+barista liberica uoms update --uom-id "1234567890123456789" --code "kg" --name "千克"
+barista liberica uoms update -i "1234567890123456789" -c "kg" -n "千克"
+
+# 更新小数位数
+barista liberica uoms update "1234567890123456789" --code "m" --name "米" --fraction-places 3
+
+# 更新备注
+barista liberica uoms update "1234567890123456789" --code "pcs" --name "件" --remark "新的备注"
+
+# 预览模式（dry-run）
+barista liberica uoms update "1234567890123456789" --code "box" --name "箱" --dry-run
+
+# JSON 输出
+barista liberica uoms update "1234567890123456789" --code "kg" --name "千克" --json
+```

package/package.json

@@ -1,11 +1,9 @@
 {
   "name": "@newpeak/barista-cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "AI Tools CLI for Liberica and Arabica services",
   "type": "module",
-  "bin": {
-    "barista": "./bin/barista.js"
-  },
+  "bin": "./bin/barista",
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",

package/src/commands/liberica/auth/index.ts

@@ -90,6 +90,12 @@ export function createLibericaAuthCommand(): Command {
 
           await configManager.setTenant(resolvedTenant);
 
+          const indexInfo = await apiClient.getUserIndexInfo(environment, resolvedTenant);
+          if (!indexInfo.success) {
+            console.error(chalk.yellow(`\n⚠ Warning: Failed to refresh permissions cache: ${indexInfo.error?.message || 'Unknown error'}`));
+            console.error(chalk.gray('  You may need to relogin to refresh permissions.\n'));
+          }
+
           console.log(chalk.green('\n✓ Login successful'));
           if (response.data.expiresAt) {
             console.log(chalk.gray(`  Token expires: ${response.data.expiresAt}`));

package/src/commands/liberica/clients/create.ts

@@ -0,0 +1,122 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { configManager } from '../../../core/config/manager.js';
+import { apiClient } from '../../../core/api/client.js';
+import { CreateClientRequest, StatusFlag } from '../../../types/client.js';
+
+export function createClientCreateCommand(): Command {
+  const cmd = new Command('create');
+  cmd.description('Create a new client (auto-generates client code if not provided)');
+
+  cmd
+    .option('--client-code <code>', 'Client code (auto-generated if not provided)')
+    .option('--client-name <name>', 'Client name')
+    .option('--follower <name>', 'Follower/salesperson')
+    .option('--office-address <address>', 'Office address')
+    .option('--office-telephone <phone>', 'Office telephone')
+    .option('--status <status>', 'Status (1=enable, 2=disable)')
+    .option('--remark <remark>', 'Remark')
+    .option('--dry-run', 'Preview the operation without executing')
+    .option('--json', 'Output as JSON')
+    .action(async (options: Record<string, unknown>) => {
+      const context = configManager.getCurrentContext();
+      const environment = context.environment;
+      const tenant = context.tenant;
+      const jsonOutput = options.json === true;
+
+      let clientCode = options.clientCode as string | undefined;
+      const clientName = options.clientName as string | undefined;
+      const follower = options.follower as string | undefined;
+      const officeAddress = options.officeAddress as string | undefined;
+      const officeTelephone = options.officeTelephone as string | undefined;
+      const status = options.status as string | undefined;
+      const remark = options.remark as string | undefined;
+
+      if (!clientCode) {
+        const codeResponse = await apiClient.getCodeByType(environment, tenant, 'TenantClientCode');
+        if (codeResponse.success && codeResponse.data) {
+          clientCode = codeResponse.data;
+        } else {
+          const errMsg = codeResponse.error?.message || 'Failed to generate client code';
+          if (jsonOutput) {
+            console.log(JSON.stringify({ success: false, error: { code: 'CODE_GENERATION_ERROR', message: errMsg } }));
+          } else {
+            console.error(chalk.red(`\n✗ Failed to generate client code: ${errMsg}\n`));
+          }
+          process.exit(1);
+        }
+      }
+
+      const data: CreateClientRequest = {
+        clientCode,
+        clientName,
+        follower,
+        officeAddress,
+        officeTelephone,
+        statusFlag: status ? parseInt(status) as StatusFlag : undefined,
+        remark,
+      };
+
+      Object.keys(data).forEach(key => {
+        if (data[key as keyof CreateClientRequest] === undefined) {
+          delete data[key as keyof CreateClientRequest];
+        }
+      });
+
+      if (options.dryRun) {
+        if (jsonOutput) {
+          console.log(JSON.stringify({ success: true, dryRun: true, data }));
+        } else {
+          console.log(chalk.cyan('\n🔍 Dry-Run Mode: No actual API call will be made\n'));
+          console.log(chalk.gray('  This operation will create the following client:'));
+          console.log(`  ${chalk.gray('Client Code:')} ${clientCode}`);
+          if (clientName) console.log(`  ${chalk.gray('Client Name:')} ${clientName}`);
+          if (follower) console.log(`  ${chalk.gray('Follower:')} ${follower}`);
+          if (officeAddress) console.log(`  ${chalk.gray('Office:')} ${officeAddress}`);
+          console.log();
+        }
+        return;
+      }
+
+      try {
+        const response = await apiClient.createClient(environment, tenant, data);
+
+        if (response.success) {
+          if (jsonOutput) {
+            console.log(JSON.stringify({ success: true, data: response.data }));
+          } else {
+            console.log(chalk.green('\n✓ Client created successfully\n'));
+            if (response.data && typeof response.data === 'object' && 'clientId' in response.data) {
+              console.log(`  ${chalk.gray('Client ID:')}  ${chalk.green(String((response.data as { clientId: string }).clientId))}`);
+            }
+            if (clientCode) console.log(`  ${chalk.gray('Client Code:')} ${chalk.green(clientCode)}`);
+            if (clientName) console.log(`  ${chalk.gray('Client Name:')} ${clientName}`);
+            console.log();
+          }
+        } else {
+          const errorMsg = response.error?.message || 'Failed to create client';
+          const errorCode = response.error?.code || 'CREATE_CLIENT_ERROR';
+          if (jsonOutput) {
+            console.log(JSON.stringify({ success: false, error: { code: errorCode, message: errorMsg } }));
+          } else {
+            console.error(chalk.red(`\n✗ Failed to create client: ${errorMsg}`));
+            if (response.error?.code) {
+              console.error(chalk.gray(`  Error code: ${response.error.code}`));
+            }
+            console.error();
+          }
+          process.exit(1);
+        }
+      } catch (error) {
+        const errMsg = error instanceof Error ? error.message : 'Unknown error';
+        if (jsonOutput) {
+          console.log(JSON.stringify({ success: false, error: { code: 'ERROR', message: errMsg } }));
+        } else {
+          console.error(chalk.red(`\n✗ Error: ${errMsg}\n`));
+        }
+        process.exit(1);
+      }
+    });
+
+  return cmd;
+}