@newpeak/barista-cli 0.1.7 → 0.1.8

package/docs/commands/liberica/supplier-contacts/list.md

@@ -0,0 +1,143 @@
+# barista liberica supplier-contacts list
+
+查询供应商联系人列表。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica supplier-contacts list` |
+| 功能描述 | 查询指定供应商的联系人列表 |
+| HTTP方法 | GET |
+| 是否需要认证 | ✅ 是 |
+| 是否支持dry-run | ⬜ 否 |
+
+## 2.2 后端接口引用
+
+### Controller位置
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/purchases/
+        └── EnterpriseSupplierContactController.java
+            └── list(@GetResource(path = "/list"))
+                └── public ResponseData<List<MasterSupplierContactResponse>> list(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        MasterSupplierContactRequest masterSupplierContactRequest
+                    )
+```
+
+### Request DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-master/master-api/
+    └── src/main/java/com/newpeak/liberica/master/api/pojo/request/
+        └── MasterSupplierContactRequest.java
+            ├── supplierId: Long (@NotNull)
+            ├── supplierContactName: String (搜索关键词)
+            ├── pageNo: Long (分页页码)
+            └── pageSize: Long (分页大小)
+```
+
+### Response DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-master/master-api/
+    └── src/main/java/com/newpeak/liberica/master/api/pojo/response/
+        └── MasterSupplierContactResponse.java
+            ├── supplierContactId: Long
+            ├── supplierId: Long
+            ├── supplierContactName: String
+            ├── supplierContactPhone: String
+            ├── supplierContactTelephone: String
+            ├── supplierContactEmail: String
+            ├── supplierContactSex: String
+            ├── supplierContactBirthday: Date
+            ├── supplierContactQq: String
+            ├── supplierContactWechat: String
+            ├── supplierContactAddress: String
+            ├── defaultFlag: String (Y/N)
+            ├── remark: String
+            ├── createTime: String
+            └── updateTime: String
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica supplier-contacts list [options]
+```
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--json` | boolean | JSON输出 |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --supplier-id | -s | string | ✅ | - | 供应商ID | supplierId |
+| --page | -p | number | ⬜ | 1 | 页码 | pageNo |
+| --size | -z | number | ⬜ | 20 | 每页条数 | pageSize |
+| --search | -S | string | ⬜ | - | 搜索关键词(姓名) | supplierContactName |
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| --supplier-id / -s | supplierId | string→Long | @NotNull |
+| --page / -p | pageNo | number→Long | >= 1 |
+| --size / -z | pageSize | number→Long | 1-100 |
+| --search / -S | supplierContactName | 直接传递 | 模糊查询 |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-master/master-api/
+    └── src/main/java/com/newpeak/liberica/master/api/exception/enums/
+        └── MasterSupplierContactExceptionEnum.java
+            └── MASTER_SUPPLIER_CONTACT_NOT_EXIST("01001XXX001", "租户供应商联系人不存在")
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| 01001XXX001 | 租户供应商联系人不存在 | 供应商ID不存在时 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| 注解 | `@GetResource(path = "/list")` | 无 requiredPermission（无需权限码） |
+
+**注意**：list 接口在 Controller 层无需权限校验，数据范围通过 tenantId 隔离。
+
+## 2.7 实现要点
+
+1. **必填参数**：--supplier-id 必须指定
+2. **分页默认值**：page=1, size=20
+3. **搜索行为**：supplierContactName 支持模糊查询
+4. **无结果处理**：返回空列表，不抛出异常
+5. **tenantId来源**：来自 X-TENANT-ID header
+6. **输出格式**：表格形式展示联系人列表
+
+## 2.8 示例用法
+
+```bash
+# 列出供应商的所有联系人
+barista liberica supplier-contacts list --supplier-id 12345
+
+# 指定页码和每页条数
+barista liberica supplier-contacts list --supplier-id 12345 --page 2 --size 50
+
+# 搜索联系人
+barista liberica supplier-contacts list --supplier-id 12345 --search "张"
+
+# JSON 输出（便于脚本处理）
+barista liberica supplier-contacts list --supplier-id 12345 --json
+```

package/docs/commands/liberica/supplier-contacts/update.md

@@ -0,0 +1,158 @@
+# barista liberica supplier-contacts update
+
+更新供应商联系人信息。
+
+## 2.1 命令元数据
+
+| 字段 | 值 |
+|------|-----|
+| 完整命令 | `barista liberica supplier-contacts update <contact-id>` |
+| 功能描述 | 修改供应商联系人信息 |
+| HTTP方法 | POST |
+| 是否需要认证 | ✅ 是 |
+| 是否支持dry-run | ✅ 是 |
+
+## 2.2 后端接口引用
+
+### Controller位置
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/purchases/
+        └── EnterpriseSupplierContactController.java
+            └── edit(@PostResource(path = "/edit", requiredPermission = true, requirePermissionCode = "EDIT_MASTER_SUPPLIER_CONTACT"))
+                └── public ResponseData<?> edit(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @RequestBody @Validated(BaseRequest.edit.class) MasterSupplierContactRequest masterSupplierContactRequest
+                    )
+```
+
+### Request DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-master/master-api/
+    └── src/main/java/com/newpeak/liberica/master/api/pojo/request/
+        └── MasterSupplierContactRequest.java
+            ├── supplierContactId: Long (@NotNull on edit)
+            ├── supplierContactName: String (@NotBlank, max=255)
+            ├── supplierContactPhone: String (max=256)
+            ├── supplierContactTelephone: String (max=256)
+            ├── supplierContactEmail: String (max=512)
+            ├── supplierContactSex: String (max=255)
+            ├── supplierContactBirthday: Date
+            ├── supplierContactQq: String (max=512)
+            ├── supplierContactWechat: String (max=512)
+            ├── supplierContactAddress: String (max=512)
+            ├── defaultFlag: String (max=1)
+            └── remark: String (max=255)
+```
+
+### Response DTO位置
+```
+coffee-liberica-end/
+└── business/liberica-business-master/master-api/
+    └── src/main/java/com/newpeak/liberica/master/api/pojo/response/
+        └── MasterSupplierContactResponse.java
+            └── (同 get 接口)
+```
+
+## 2.3 CLI参数设计
+
+### 命令结构
+```
+barista liberica supplier-contacts update <contact-id> [options]
+```
+
+### 位置参数
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| contact-id | string | ✅ | 供应商联系人ID |
+
+### 全局选项
+| 选项 | 类型 | 说明 |
+|------|------|------|
+| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | 租户代码 |
+| `--dry-run` | boolean | 预览模式 |
+| `--json` | boolean | JSON输出 |
+
+### 命令选项
+| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
+|------|--------|------|------|--------|------|-------------|
+| --name | -n | string | ⬜ | - | 姓名 | supplierContactName |
+| --phone | -p | string | ⬜ | - | 手机号 | supplierContactPhone |
+| --telephone | -t | string | ⬜ | - | 座机号 | supplierContactTelephone |
+| --email | -e | string | ⬜ | - | 电子邮箱 | supplierContactEmail |
+| --sex | -x | string | ⬜ | - | 性别 | supplierContactSex |
+| --birthday | -b | string | ⬜ | - | 生日(YYYY-MM-DD) | supplierContactBirthday |
+| --qq | -q | string | ⬜ | - | QQ号 | supplierContactQq |
+| --wechat | -w | string | ⬜ | - | 微信号 | supplierContactWechat |
+| --address | -a | string | ⬜ | - | 详细地址 | supplierContactAddress |
+| --default | -d | boolean | ⬜ | - | 是否默认联系人 | defaultFlag |
+| --remark | -r | string | ⬜ | - | 备注 | remark |
+
+**注意**：所有字段在 update 时都是可选的，至少需要提供一个要更新的字段。
+
+## 2.4 字段映射表
+
+| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
+|---------|---------|----------|----------|
+| <contact-id> | supplierContactId | string→Long | @NotNull |
+| --name / -n | supplierContactName | 直接传递 | max=255 |
+| --phone / -p | supplierContactPhone | 直接传递 | max=256 |
+| --telephone / -t | supplierContactTelephone | 直接传递 | max=256 |
+| --email / -e | supplierContactEmail | 直接传递 | max=512 |
+| --sex / -x | supplierContactSex | 直接传递 | max=255 |
+| --birthday / -b | supplierContactBirthday | string→Date | yyyy-MM-dd |
+| --qq / -q | supplierContactQq | 直接传递 | max=512 |
+| --wechat / -w | supplierContactWechat | 直接传递 | max=512 |
+| --address / -a | supplierContactAddress | 直接传递 | max=512 |
+| --default / -d | defaultFlag | boolean→Y/N | max=1 |
+| --remark / -r | remark | 直接传递 | max=255 |
+
+## 2.5 错误码引用
+
+### ExceptionEnum位置
+```
+coffee-liberica-end/
+└── business/liberica-business-master/master-api/
+    └── src/main/java/com/newpeak/liberica/master/api/exception/enums/
+        └── MasterSupplierContactExceptionEnum.java
+            └── MASTER_SUPPLIER_CONTACT_NOT_EXIST("01001XXX001", "租户供应商联系人不存在")
+```
+
+### 已知错误码
+| 错误码 | 错误消息 | 触发条件 |
+|--------|----------|----------|
+| 01001XXX001 | 租户供应商联系人不存在 | contact-id 不存在或不属于当前租户 |
+
+## 2.6 权限检查
+
+| 检查项 | 位置 | 说明 |
+|--------|------|------|
+| PermissionConstants | `EDIT_MASTER_SUPPLIER_CONTACT` | 编辑供应商联系人需要此权限 |
+| 注解 | `@PostResource(requirePermissionCode = "EDIT_MASTER_SUPPLIER_CONTACT")` | Controller方法上 |
+
+## 2.7 实现要点
+
+1. **位置参数**：contact-id 必须指定
+2. **可选字段**：所有业务字段都是可选的，至少提供一个
+3. **dry-run 模式**：预览模式下只显示将要更新的数据，不实际调用 API
+4. **输出格式**：成功后显示更新后的联系人信息
+5. **错误处理**：联系人不存在时显示友好错误信息
+
+## 2.8 示例用法
+
+```bash
+# 更新联系人姓名（dry-run 预览）
+barista liberica supplier-contacts update 12345 --name "新姓名" --dry-run
+
+# 实际更新
+barista liberica supplier-contacts update 12345 --name "新姓名" --phone "13900139000"
+
+# 更新多个字段
+barista liberica supplier-contacts update 12345 --email "new@example.com" --address "新地址"
+
+# JSON 输出
+barista liberica supplier-contacts update 12345 --name "新姓名" --json
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newpeak/barista-cli",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "AI Tools CLI for Liberica and Arabica services",
   "type": "module",
   "bin": "./bin/barista",

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

@@ -0,0 +1,13 @@
+import { Command } from 'commander';
+import { createCalendarSetCommand } from './set.js';
+import { createCalendarListCommand } from './list.js';
+
+export function createCalendarCommand(): Command {
+  const calendarCommand = new Command('calendar');
+  calendarCommand.description('Manage calendar (workdays, holidays)');
+
+  calendarCommand.addCommand(createCalendarSetCommand());
+  calendarCommand.addCommand(createCalendarListCommand());
+
+  return calendarCommand;
+}

package/src/commands/liberica/calendar/list.ts

@@ -0,0 +1,214 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import Table from 'cli-table3';
+import { configManager } from '../../../core/config/manager.js';
+import { apiClient } from '../../../core/api/client.js';
+import { CalendarQueryParams, CalendarItem } from '../../../types/calendar.js';
+import { Environment } from '../../../types/index.js';
+
+function getCurrentYear(): number {
+  return new Date().getFullYear();
+}
+
+function getCurrentMonth(): number {
+  return new Date().getMonth() + 1;
+}
+
+function formatDate(dateStr: string): string {
+  return dateStr;
+}
+
+function getDayOfWeek(dateStr: string): string {
+  const date = new Date(dateStr);
+  const days = ['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'];
+  return days[date.getDay()];
+}
+
+function renderCalendarGrid(data: { [yearMonth: string]: CalendarItem[] }): void {
+  const yearMonths = Object.keys(data).sort();
+
+  for (const yearMonth of yearMonths) {
+    const items = data[yearMonth] || [];
+    const [year, month] = yearMonth.split('-').map(Number);
+    const monthName = new Date(year, month - 1).toLocaleString('default', { month: 'long' });
+
+    console.log(chalk.bold(`\n📅 ${year} ${monthName}\n`));
+
+    // Build calendar grid
+    const calendarGrid: string[][] = [];
+    const dayMap: { [day: string]: CalendarItem } = {};
+
+    for (const item of items) {
+      const day = item.calendarDate.split('-')[2];
+      dayMap[day] = item;
+    }
+
+    // Header
+    calendarGrid.push(['Sun', 'Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat'].map(d => chalk.gray(d)));
+
+    // Find first day of month
+    const firstDay = new Date(year, month - 1, 1).getDay();
+    const daysInMonth = new Date(year, month, 0).getDate();
+
+    let currentRow: string[] = [];
+
+    // Add empty cells for days before the first day
+    for (let i = 0; i < firstDay; i++) {
+      currentRow.push('  ');
+    }
+
+    // Add days
+    for (let day = 1; day <= daysInMonth; day++) {
+      const dayStr = day.toString().padStart(2, '0');
+      const item = dayMap[dayStr];
+
+      if (item) {
+        if (item.dateType === 'WORKDAY') {
+          currentRow.push(chalk.green('·'));
+        } else if (item.dateType === 'HOLIDAY' || item.dateType === 'WEEKEND') {
+          currentRow.push(chalk.red('H'));
+        } else {
+          currentRow.push(' ');
+        }
+      } else {
+        currentRow.push(' ');
+      }
+
+      if (currentRow.length === 7) {
+        calendarGrid.push(currentRow);
+        currentRow = [];
+      }
+    }
+
+    // Add remaining empty cells
+    while (currentRow.length > 0 && currentRow.length < 7) {
+      currentRow.push('  ');
+    }
+    if (currentRow.length > 0) {
+      calendarGrid.push(currentRow);
+    }
+
+    // Print grid
+    const gridTable = new Table({
+      style: { border: [], compact: true },
+      colWidths: Array(7).fill(4),
+    });
+
+    for (const row of calendarGrid) {
+      gridTable.push(row);
+    }
+
+    console.log(gridTable.toString());
+    console.log();
+    console.log(chalk.gray('  · ') + chalk.green('Workday') + chalk.gray('    H ') + chalk.red('Holiday/Weekend'));
+    console.log();
+  }
+}
+
+export function createCalendarListCommand(): Command {
+  const listCommand = new Command('list');
+  listCommand.description('List calendar entries (workdays, holidays)');
+
+  listCommand
+    .option('-y, --year <number>', 'Year (required for query)')
+    .option('-m, --month <number>', 'Month (required for query)')
+    .option('--months <number>', 'Number of months to query', '12')
+    .option('--grid', 'Calendar grid view mode')
+    .option('--json', 'Output as JSON')
+    .action(async (options) => {
+      const context = configManager.getCurrentContext();
+      const environment = (options.env as Environment) || context.environment;
+      const tenant = options.tenant || context.tenant;
+
+      // Default to current year/month if not provided
+      const year = options.year ? parseInt(options.year as string, 10) : getCurrentYear();
+      const month = options.month ? parseInt(options.month as string, 10) : getCurrentMonth();
+      const months = parseInt(options.months as string, 10);
+
+      const params: CalendarQueryParams = { year, month, months };
+
+      const response = await apiClient.listCalendar(environment, tenant, params);
+
+      if (!response.success) {
+        console.error(chalk.red(`\n✗ Failed to list calendar: ${response.error?.message || 'Unknown error'}`));
+        if (response.error?.code) {
+          console.error(chalk.gray(`  Error code: ${response.error.code}`));
+        }
+        console.error();
+        process.exit(1);
+      }
+
+      const data = response.data;
+
+      if (!data) {
+        if (options.json) {
+          console.log(JSON.stringify({ success: true, data: {} }, null, 2));
+        } else {
+          console.log(chalk.bold('\n📅 Calendar\n'));
+          console.log(chalk.gray('  No calendar data found\n'));
+        }
+        return;
+      }
+
+      if (options.json) {
+        console.log(JSON.stringify({ success: true, data }, null, 2));
+        return;
+      }
+
+      if (options.grid) {
+        renderCalendarGrid(data);
+        return;
+      }
+
+      // Table output mode
+      const allItems: CalendarItem[] = [];
+      for (const yearMonth of Object.keys(data)) {
+        const items = data[yearMonth] || [];
+        allItems.push(...items);
+      }
+
+      if (allItems.length === 0) {
+        console.log(chalk.bold('\n📅 Calendar\n'));
+        console.log(chalk.gray('  No calendar data found\n'));
+        return;
+      }
+
+      console.log(chalk.bold('\n📅 Calendar\n'));
+
+      const table = new Table({
+        head: [chalk.bold('Date'), chalk.bold('Day'), chalk.bold('Type'), chalk.bold('Remark')],
+        colWidths: [12, 8, 12, 30],
+        style: {
+          head: [],
+          border: [],
+        },
+      });
+
+      for (const item of allItems) {
+        const dayType = item.dateType;
+        let typeText: string;
+
+        if (dayType === 'WORKDAY') {
+          typeText = chalk.green('WORKDAY');
+        } else if (dayType === 'HOLIDAY') {
+          typeText = chalk.red('HOLIDAY');
+        } else if (dayType === 'WEEKEND') {
+          typeText = chalk.red('WEEKEND');
+        } else {
+          typeText = dayType;
+        }
+
+        table.push([
+          formatDate(item.calendarDate),
+          getDayOfWeek(item.calendarDate),
+          typeText,
+          item.remark || '-',
+        ]);
+      }
+
+      console.log(table.toString());
+      console.log();
+    });
+
+  return listCommand;
+}

package/src/commands/liberica/calendar/set.ts

@@ -0,0 +1,130 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { apiClient } from '../../../core/api/client.js';
+import { configManager } from '../../../core/config/manager.js';
+import { CalendarSetRequest, DateType } from '../../../types/calendar.js';
+
+const DATE_REGEX = /^\d{4}-\d{2}-\d{2}$/;
+const DATE_TYPE_REGEX = /^(WORKDAY|WEEKEND|HOLIDAY)$/;
+
+function validateFields(data: CalendarSetRequest): string | null {
+  if (!DATE_REGEX.test(data.calendarDate)) {
+    return 'Invalid date format. Date must be in YYYY-MM-DD format.';
+  }
+  if (!DATE_TYPE_REGEX.test(data.dateType)) {
+    return 'Invalid date type. Must be WORKDAY, WEEKEND, or HOLIDAY.';
+  }
+  return null;
+}
+
+function formatTable(data: CalendarSetRequest): string {
+  const lines: string[] = [];
+  lines.push(`  ${chalk.gray('Date:')}         ${data.calendarDate}`);
+  lines.push(`  ${chalk.gray('Type:')}          ${data.dateType}`);
+  if (data.remark) lines.push(`  ${chalk.gray('Remark:')}        ${data.remark}`);
+  return lines.join('\n');
+}
+
+export function createCalendarSetCommand(): Command {
+  const cmd = new Command('set');
+  cmd.description('Set calendar date type');
+
+  cmd
+    .option('-d, --date <date>', 'Date to set (YYYY-MM-DD, required)')
+    .option('-t, --type <type>', 'Date type (WORKDAY|WEEKEND|HOLIDAY, required)')
+    .option('-r, --remark <text>', 'Remark/note')
+    .option('--dry-run', 'Preview without making API call')
+    .option('--json', 'Output as JSON');
+
+  cmd.action(async () => {
+    const context = configManager.getCurrentContext();
+    const opts = cmd.opts();
+
+    const date = opts.date as string | undefined;
+    const type = opts.type as string | undefined;
+    const remark = opts.remark as string | undefined;
+    const dryRun = opts.dryRun === true;
+    const jsonOutput = opts.json === true;
+
+    // Validate required options
+    if (!date) {
+      if (jsonOutput) {
+        console.log(JSON.stringify({ success: false, error: { code: 'VALIDATION_ERROR', message: 'Date is required. Use --date (or -d).' } }));
+      } else {
+        console.error(chalk.red('\n✗ Date is required. Use --date (or -d).\n'));
+      }
+      process.exit(1);
+    }
+
+    if (!type) {
+      if (jsonOutput) {
+        console.log(JSON.stringify({ success: false, error: { code: 'VALIDATION_ERROR', message: 'Date type is required. Use --type (or -t).' } }));
+      } else {
+        console.error(chalk.red('\n✗ Date type is required. Use --type (or -t).\n'));
+      }
+      process.exit(1);
+    }
+
+    const data: CalendarSetRequest = {
+      calendarDate: date,
+      dateType: type as DateType,
+      remark,
+    };
+
+    // Validate fields
+    const validationError = validateFields(data);
+    if (validationError) {
+      if (jsonOutput) {
+        console.log(JSON.stringify({ success: false, error: { code: 'VALIDATION_ERROR', message: validationError } }));
+      } else {
+        console.error(chalk.red(`\n✗ ${validationError}\n`));
+      }
+      process.exit(1);
+    }
+
+    if (dryRun) {
+      if (jsonOutput) {
+        console.log(JSON.stringify({ success: true, dryRun: true, data }));
+      } else {
+        console.log(chalk.bold('\n🔍 Dry-Run Mode: No changes will be made\n'));
+        console.log('  Calendar to be updated:');
+        console.log(formatTable(data));
+        console.log();
+      }
+      return;
+    }
+
+    if (!jsonOutput) {
+      console.log(chalk.bold('\n📝 Updating Calendar\n'));
+    }
+
+    const response = await apiClient.setCalendar(context.environment, context.tenant, data);
+
+    if (!response.success) {
+      const errorMsg = response.error?.message || 'Failed to update calendar';
+      const errorCode = response.error?.code || 'SET_CALENDAR_ERROR';
+      if (jsonOutput) {
+        console.log(JSON.stringify({ success: false, error: { code: errorCode, message: errorMsg } }));
+      } else {
+        console.error(chalk.red(`\n✗ Failed to update calendar: ${errorMsg}`));
+        if (response.error?.code) {
+          console.error(chalk.gray(`  Error code: ${response.error.code}`));
+        }
+        console.error();
+      }
+      process.exit(1);
+    }
+
+    if (jsonOutput) {
+      console.log(JSON.stringify({ success: true, data: { calendarDate: data.calendarDate, dateType: data.dateType, remark: data.remark } }));
+    } else {
+      console.log(chalk.green(`✓ Calendar updated: ${data.calendarDate} -> ${data.dateType}\n`));
+      if (data.remark) {
+        console.log(`  ${chalk.gray('Remark:')} ${data.remark}`);
+      }
+      console.log();
+    }
+  });
+
+  return cmd;
+}