@newpeak/barista-cli 0.1.11 → 0.1.12

package/docs/commands/liberica/teams/projects/update.md

@@ -1,175 +0,0 @@
-# barista liberica teams projects update
-
-更新团队项目。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica teams projects update <project-id>` |
-| 功能描述 | 更新已有团队项目的字段信息 |
-| HTTP方法 | POST |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ✅ 是 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
-        └── EnterpriseTeamProjectController.java
-            └── edit(@PostResource(path = "/edit", requiredPermission = true, requirePermissionCode = TeamProjectPermissionConstants.EDIT_TEAM_PROJECT))
-                └── public ResponseData<? extends TeamProjectResponse> edit(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @RequestBody @Validated(BaseRequest.edit.class) TeamProjectRequest teamProjectRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
-        └── TeamProjectRequest.java
-            ├── teamProjectId: Long (@NotNull on edit)
-            ├── projectCode: String (@NotBlank, max=50)
-            ├── projectName: String (@NotBlank, max=200)
-            ├── parentProjectId: Long
-            ├── projectLevel: Integer (@NotNull on edit)
-            ├── projectDesc: String
-            ├── teamProjectStatus: String (@NotBlank, max=20)
-            └── tenantId: Long
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/pojo/response/
-        └── TeamProjectResponse.java
-            ├── teamProjectId: Long
-            ├── projectCode: String
-            ├── projectName: String
-            ├── parentProjectId: Long
-            ├── projectLevel: Integer
-            ├── projectDesc: String
-            ├── teamProjectStatus: String
-            ├── createTime: String
-            └── updateTime: String
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica teams projects update <project-id> [options]
-```
-
-### Usage
-```bash
-barista liberica teams projects update 123456789 --name "新名称"
-barista liberica teams projects update 123456789 --status INACTIVE
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式（不实际调用API） |
-| `--json` | boolean | JSON输出 |
-
-### 位置参数
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| project-id | string | ✅ | 要更新的项目ID |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --name | -n | string | ⬜ | - | 项目名称 | projectName |
-| --code | -c | string | ⬜ | - | 项目代号 | projectCode |
-| --desc | -d | string | ⬜ | - | 项目描述 | projectDesc |
-| --status | -s | string | ⬜ | - | 项目状态 | teamProjectStatus |
-| --parent-id | — | string | ⬜ | - | 父项目ID | parentProjectId |
-| --level | -l | number | ⬜ | - | 项目级别 | projectLevel |
-| --json | -j | boolean | ⬜ | false | JSON格式输出 | - |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| project-id (位置参数) | teamProjectId | string→Long | @NotNull |
-| --name / -n | projectName | 直接传递 | @NotBlank, max=200 |
-| --code / -c | projectCode | 直接传递 | @NotBlank, max=50 |
-| --desc / -d | projectDesc | 直接传递 | - |
-| --status / -s | teamProjectStatus | 直接传递 | @NotBlank, max=20 |
-| --parent-id | parentProjectId | string→Long | - |
-| --level / -l | projectLevel | number→Integer | @NotNull |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
-        └── TeamProjectExceptionEnum.java
-            └── TEAM_PROJECT_NOT_EXIST("01001957001", "团队项目不存在")
-```
-
-### Service层业务校验
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-business/
-    └── src/main/java/com/newpeak/liberica/team/modular/business/
-        └── TeamProjectBusiness.java
-            └── edit(TeamProjectRequest request)
-                └── 检查团队项目是否存在
-                    └── throw new TeamServiceException(TeamProjectExceptionEnum.TEAM_PROJECT_NOT_EXIST)
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001957001 | 团队项目不存在 | 更新的 project-id 不存在或已被删除 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| PermissionConstants | `TeamProjectPermissionConstants.EDIT_TEAM_PROJECT` | Controller层 `@PostResource(requirePermissionCode = "EDIT_TEAM_PROJECT")` |
-
-## 2.7 实现要点
-
-1. **必填参数**：`project-id` 作为位置参数必须提供
-2. **部分更新**：只传入的选项才会被包含在请求体中，未传入的字段保持原值
-3. **Dry-run 支持**：使用 `--dry-run` 时构造请求体但不发送，显示预览信息
-4. **ID 类型处理**：`teamProjectId`、`parentProjectId` 后端使用 Long (BigInteger)，CLI 使用 string 避免精度丢失
-5. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取
-
-## 2.8 示例用法
-
-```bash
-# 更新名称
-barista liberica teams projects update 123456789 --name "修正后的名称"
-
-# 更新状态
-barista liberica teams projects update 123456789 --status INACTIVE
-
-# 更新代号
-barista liberica teams projects update 123456789 --code "NEW-CODE"
-
-# 更新父项目和级别
-barista liberica teams projects update 123456789 \
-  --parent-id 987654321 \
-  --level 2
-
-# Dry-run 预览
-barista liberica teams projects update 123456789 --name "测试更新" --dry-run
-
-# JSON 输出
-barista liberica teams projects update 123456789 --name "测试更新" --json
-```

package/docs/commands/liberica/teams/tasks/create.md

@@ -1,163 +0,0 @@
-# barista liberica teams tasks create
-
-创建新的团队任务。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica teams tasks create` |
-| 功能描述 | 创建新的团队任务 |
-| HTTP方法 | POST |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ✅ 是 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
-        └── EnterpriseTeamTaskController.java
-            └── add(@PostResource(path = "/add", requiredPermission = true, requirePermissionCode = TeamTaskPermissionConstants.ADD_TEAM_TASK))
-                └── public ResponseData<TeamTaskResponse> add(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @RequestBody @Validated(BaseRequest.add.class) TeamTaskRequest teamTaskRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
-        └── TeamTaskRequest.java
-            ├── taskCode: String (max=255, 可选，为空则后端可自动生成)
-            ├── taskName: String (@NotBlank, max=255)
-            ├── taskDescription: String
-            ├── priority: String (max=255)
-            ├── status: String (max=255)
-            ├── creator: String (max=255)
-            ├── creatorName: String (max=255)
-            ├── assignTo: String (@NotBlank, max=255)
-            ├── assignToName: String (max=255)
-            ├── startTime: Instant
-            ├── endTime: Instant
-            ├── completionRate: BigDecimal
-            ├── tags: String (max=512)
-            └── refId: String (max=255)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/pojo/response/
-        └── TeamTaskResponse.java
-            ├── taskId: Long
-            ├── taskCode: String
-            ├── taskName: String
-            ├── taskDescription: String
-            ├── priority: String
-            ├── status: String
-            ├── creator: String
-            ├── creatorName: String
-            ├── assignTo: String
-            ├── assignToName: String
-            ├── startTime: Instant
-            ├── endTime: Instant
-            ├── completionRate: BigDecimal
-            ├── tags: String
-            └── refId: String
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica teams tasks create [options]
-```
-
-### Usage
-```bash
-barista liberica teams tasks create --title "示例任务" --assign-to "user123"
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式（不实际调用API） |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| --title | -t | string | ✅ | - | 任务标题 | taskName |
-| --desc | -d | string | ⬜ | - | 任务描述 | taskDescription |
-| --priority | -p | string | ⬜ | MEDIUM | 优先级 | priority |
-| --status | -s | string | ⬜ | OPEN | 任务状态 | status |
-| --assign-to | -a | string | ✅ | - | 负责人ID或账号 | assignTo |
-| --tags | — | string | ⬜ | - | 标签，逗号分隔 | tags |
-| --task-code | — | string | ⬜ | - | 任务编码 | taskCode |
-| --start-time | — | string | ⬜ | - | 开始时间(ISO-8601) | startTime |
-| --end-time | — | string | ⬜ | - | 结束时间(ISO-8601) | endTime |
-| --completion-rate | — | number | ⬜ | - | 完成率(0-100) | completionRate |
-| --ref-id | — | string | ⬜ | - | 引用ID | refId |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| --title / -t | taskName | 直接传递 | @NotBlank, max=255 |
-| --desc / -d | taskDescription | 直接传递 | - |
-| --priority / -p | priority | 直接传递 | max=255 |
-| --status / -s | status | 直接传递 | max=255 |
-| --assign-to / -a | assignTo | 直接传递 | @NotBlank, max=255 |
-| --tags | tags | 直接传递 | max=512 |
-| --task-code | taskCode | 直接传递 | max=255 |
-| --start-time | startTime | string→Instant | ISO-8601 |
-| --end-time | endTime | string→Instant | ISO-8601 |
-| --completion-rate | completionRate | number→BigDecimal | 0-100 |
-| --ref-id | refId | 直接传递 | max=255 |
-
-**自动填充字段（不通过CLI参数）：**
-| 字段 | 来源 |
-|------|------|
-| tenantId | 后端从 X-TENANT-ID header 注入 |
-| creator | 当前认证用户上下文自动填充 |
-| creatorName | 当前认证用户上下文自动填充 |
-| taskCode | 为空时后端可自动生成编码 |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
-        └── TeamTaskExceptionEnum.java
-            └── TEAM_TASK_NOT_EXIST("01001952001", "团队任务不存在")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001952001 | 团队任务不存在 | 复制/编辑时引用的原任务不存在 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| PermissionConstants | `TeamTaskPermissionConstants.ADD_TEAM_TASK` | Controller层 `@PostResource(requirePermissionCode = "ADD_TEAM_TASK")` |
-
-## 2.7 实现要点
-
-1. **必填字段**：`--title`、`--assign-to` 必须提供
-2. **默认值**：`--priority` 默认 `MEDIUM`，`--status` 默认 `OPEN`
-3. **Creator 自动填充**：`creator`、`creatorName` 从当前认证用户上下文获取
-4. **Dry-run 支持**：使用 `--dry-run` 时构造请求体但不发送，显示预览信息
-5. **tenantId 来源**：来自 X-TENANT-ID header，不通过请求体传递
-6. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取

package/docs/commands/liberica/teams/tasks/delete.md

@@ -1,109 +0,0 @@
-# barista liberica teams tasks delete
-
-删除团队任务。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica teams tasks delete <task-id>` |
-| 功能描述 | 删除指定的团队任务 |
-| HTTP方法 | POST |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ✅ 是 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
-        └── EnterpriseTeamTaskController.java
-            └── delete(@PostResource(path = "/delete", requiredPermission = true, requirePermissionCode = TeamTaskPermissionConstants.DEL_TEAM_TASK))
-                └── public ResponseData<?> delete(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @RequestBody @Validated(BaseRequest.delete.class) TeamTaskRequest teamTaskRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
-        └── TeamTaskRequest.java
-            └── taskId: Long (@NotNull for delete.class)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/pojo/response/
-        └── SuccessResponseData<?>
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica teams tasks delete <task-id> [options]
-```
-
-### Usage
-```bash
-barista liberica teams tasks delete 123456789
-barista liberica teams tasks delete --task-id 123456789 --force
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--dry-run` | boolean | 预览模式（不实际调用API） |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| <task-id> | — | string | ✅ | - | 任务ID（位置参数） | taskId |
-| --task-id | -i | string | ✅ | - | 任务ID（选项参数） | taskId |
-| --force | -f | boolean | ⬜ | false | 跳过确认直接删除 | - |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| <task-id> / --task-id | taskId | string→Long | @NotNull |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
-        └── TeamTaskExceptionEnum.java
-            └── TEAM_TASK_NOT_EXIST("01001952001", "团队任务不存在")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001952001 | 团队任务不存在 | 任务ID不存在 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| PermissionConstants | `TeamTaskPermissionConstants.DEL_TEAM_TASK` | Controller层 `@PostResource(requirePermissionCode = "DEL_TEAM_TASK")` |
-
-## 2.7 实现要点
-
-1. **位置参数与选项参数**：同时支持 `barista liberica teams tasks delete <id>` 和 `barista liberica teams tasks delete --task-id <id>`
-2. **参数解析优先级**：选项参数 > 位置参数
-3. **确认提示**：默认删除前弹出确认提示，使用 `--force` 可跳过
-4. **Dry-run 支持**：使用 `--dry-run` 时构造请求体但不发送，显示预览信息
-5. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取

package/docs/commands/liberica/teams/tasks/get.md

@@ -1,121 +0,0 @@
-# barista liberica teams tasks get
-
-查看团队任务详情。
-
-## 2.1 命令元数据
-
-| 字段 | 值 |
-|------|-----|
-| 完整命令 | `barista liberica teams tasks get <task-id>` |
-| 功能描述 | 查看指定团队任务的详细信息 |
-| HTTP方法 | GET |
-| 是否需要认证 | ✅ 是 |
-| 是否支持dry-run | ⬜ 否 |
-
-## 2.2 后端接口引用
-
-### Controller位置
-```
-coffee-liberica-end/
-└── facade/liberica-facade-enterprise/
-    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/team/
-        └── EnterpriseTeamTaskController.java
-            └── detail(@GetResource(path = "/detail"))
-                └── public ResponseData<TeamTaskResponse> detail(
-                        @RequestHeader("X-TENANT-ID") Long tenantId,
-                        @ParameterObject @Validated(BaseRequest.detail.class) TeamTaskRequest teamTaskRequest
-                    )
-```
-
-### Request DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/pojo/request/
-        └── TeamTaskRequest.java
-            └── taskId: Long (@NotNull for detail.class)
-```
-
-### Response DTO位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/pojo/response/
-        └── TeamTaskResponse.java
-            ├── taskId: Long
-            ├── taskCode: String
-            ├── taskName: String
-            ├── taskDescription: String
-            ├── priority: String
-            ├── status: String
-            ├── creator: String
-            ├── creatorName: String
-            ├── assignTo: String
-            ├── assignToName: String
-            ├── startTime: Instant
-            ├── endTime: Instant
-            ├── completionRate: BigDecimal
-            ├── tags: String
-            └── refId: String
-```
-
-## 2.3 CLI参数设计
-
-### 命令结构
-```
-barista liberica teams tasks get <task-id> [options]
-```
-
-### Usage
-```bash
-barista liberica teams tasks get 123456789
-barista liberica teams tasks get --task-id 123456789
-```
-
-### 全局选项
-| 选项 | 类型 | 说明 |
-|------|------|------|
-| `--env` | string | 目标环境(dev\|test\|prod-cn\|prod-jp) |
-| `--tenant` | string | 租户代码 |
-| `--json` | boolean | JSON输出 |
-
-### 命令选项
-| 选项 | 短选项 | 类型 | 必填 | 默认值 | 说明 | 对应DTO字段 |
-|------|--------|------|------|--------|------|-------------|
-| <task-id> | — | string | ✅ | - | 任务ID（位置参数） | taskId |
-| --task-id | -i | string | ✅ | - | 任务ID（选项参数） | taskId |
-
-## 2.4 字段映射表
-
-| CLI参数 | DTO字段 | 类型转换 | 验证规则 |
-|---------|---------|----------|----------|
-| <task-id> / --task-id | taskId | string→Long | @NotNull |
-
-## 2.5 错误码引用
-
-### ExceptionEnum位置
-```
-coffee-liberica-end/
-└── business/liberica-business-team/team-api/
-    └── src/main/java/com/newpeak/liberica/team/api/exception/enums/
-        └── TeamTaskExceptionEnum.java
-            └── TEAM_TASK_NOT_EXIST("01001952001", "团队任务不存在")
-```
-
-### 已知错误码
-| 错误码 | 错误消息 | 触发条件 |
-|--------|----------|----------|
-| 01001952001 | 团队任务不存在 | 任务ID不存在 |
-
-## 2.6 权限检查
-
-| 检查项 | 位置 | 说明 |
-|--------|------|------|
-| PermissionConstants | `TeamTaskPermissionConstants` | 详情查询无需显式权限码 |
-
-## 2.7 实现要点
-
-1. **位置参数与选项参数**：同时支持 `barista liberica teams tasks get <id>` 和 `barista liberica teams tasks get --task-id <id>`
-2. **参数解析优先级**：选项参数 > 位置参数
-3. **响应格式化**：详情输出使用键值对表格展示，包含所有 TeamTaskResponse 字段
-4. **无 X-TENANT-ID Header**：CLI 不手动添加该 header，租户信息由后端从 JWT 中提取