@newpeak/barista-cli 0.1.9 → 0.1.10

package/docs/commands/liberica/transfer-out-forms/list.md

@@ -0,0 +1,233 @@
+# barista liberica transfer-out-forms list
+
+Paginated query of transfer-out form line items.
+
+## 2.1 Command Metadata
+
+| Field | Value |
+|------|-----|
+| Full Command | `barista liberica transfer-out-forms list` |
+| Description | Paginated query of transfer-out form line items |
+| HTTP Method | GET |
+| Requires Authentication | Yes |
+| Supports Dry-Run | No |
+
+## 2.2 Backend API Reference
+
+### Controller Location
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/stock/
+        └── EnterpriseTransferOutFormController.java
+            └── page(@GetResource(path = "/page"))
+                └── public ResponseData<PageResult<TransferOutFormCompactResponse>> page(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @ParameterObject TransferOutFormCompactQueryRequest transferOutFormCompactQueryRequest
+                    )
+```
+
+### Request DTO Location
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/pojo/request/
+        └── TransferOutFormCompactQueryRequest.java
+            ├── current: Long (page number, 0-based)
+            ├── size: Long (page size)
+            ├── transferOutFormCode: String
+            ├── warehouseCode: String
+            ├── materialCode: String
+            ├── materialName: String
+            ├── stockDate: Date
+            ├── stockDateCriteria: DateRange
+            ├── transferOutType: String
+            ├── reviewFlag: String
+            ├── reviewerName: String
+            ├── followerName: String
+            └── sourceCode: String
+```
+
+### Response DTO Location
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/pojo/response/
+        └── TransferOutFormCompactResponse.java
+            ├── transferOutFormItemId: Long
+            ├── transferOutFormItemCode: String
+            ├── transferOutFormId: Long
+            ├── transferOutFormCode: String
+            ├── warehouseCode: String
+            ├── materialCode: String
+            ├── materialName: String
+            ├── materialType: String
+            ├── materialUomCode: String
+            ├── formQuantity: BigDecimal
+            ├── formMaterialUomCode: String
+            ├── stockQuantity: BigDecimal
+            ├── unitPrice: BigDecimal
+            ├── stockAmount: BigDecimal
+            ├── stockDate: Date
+            ├── transferOutType: String
+            ├── reviewFlag: String
+            ├── reviewerName: String
+            ├── followerName: String
+            ├── createTime: String
+            └── updateTime: String
+```
+
+### Pagination Wrapper
+```
+cn.stylefeng.roses.kernel.db.api.pojo.page.PageResult
+    ├── total: long
+    ├── size: long
+    ├── current: long
+    └── records: List<TransferOutFormCompactResponse>
+```
+
+## 2.3 CLI Parameter Design
+
+### Command Structure
+```
+barista liberica transfer-out-forms list [options]
+```
+
+### Global Options
+| Option | Type | Description |
+|------|------|------|
+| `--env` | string | Target environment (dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | Tenant code |
+| `--json` | boolean | JSON output |
+
+### Command Options
+| Option | Short | Type | Required | Default | Description | Maps to DTO Field |
+|------|--------|------|------|--------|------|-------------|
+| --page | -p | number | No | 1 | Page number (1-based) | current |
+| --size | -s | number | No | 20 | Page size | size |
+| --code | -c | string | No | - | Transfer-out form code | transferOutFormCode |
+| --warehouse-code | -w | string | No | - | Warehouse code | warehouseCode |
+| --material-code | -m | string | No | - | Material code | materialCode |
+| --material-name | -n | string | No | - | Material name (fuzzy) | materialName |
+| --review-flag | -r | string | No | - | Review flag | reviewFlag |
+| --stock-date-start | — | string | No | - | Stock date start (YYYY-MM-DD) | stockDateCriteria.start |
+| --stock-date-end | — | string | No | - | Stock date end (YYYY-MM-DD) | stockDateCriteria.end |
+| --follower-name | -f | string | No | - | Follower name | followerName |
+
+## 2.4 Field Mapping Table
+
+| CLI Parameter | DTO Field | Type Conversion | Validation Rule |
+|---------|---------|----------|----------|
+| --page / -p | current | number→Long | >= 1, CLI page 1 maps to API page 0 |
+| --size / -s | size | number→Long | 1-100 |
+| --code / -c | transferOutFormCode | Direct | max=255 |
+| --warehouse-code / -w | warehouseCode | Direct | max=255 |
+| --material-code / -m | materialCode | Direct | max=255 |
+| --material-name / -n | materialName | Direct | fuzzy match |
+| --review-flag / -r | reviewFlag | Direct | enum validation |
+| --stock-date-start | stockDateCriteria.start | string→Date | yyyy-MM-dd |
+| --stock-date-end | stockDateCriteria.end | string→Date | yyyy-MM-dd |
+| --follower-name / -f | followerName | Direct | max=255 |
+
+## 2.5 Error Code Reference
+
+### ExceptionEnum Location
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/exception/enums/
+        └── TransferOutFormExceptionEnum.java
+            ├── TRANSFER_OUT_FORM_NOT_EXIST("01001190001", "租户出库单不存在")
+```
+
+### Known Error Codes
+| Error Code | Error Message | Trigger Condition |
+|--------|----------|----------|
+| 01001190001 | Transfer-out form does not exist | Detail with non-existent ID |
+
+## 2.6 Permission Check
+
+| Check Item | Location | Description |
+|--------|------|------|
+| Annotation | `@GetResource(path = "/page")` | No requiredPermission |
+
+## 2.7 Implementation Notes
+
+1. **Pagination conversion**: CLI page is 1-based, API page is 0-based. `apiPage = cliPage - 1`.
+2. **No X-TENANT-ID header**: Tenant is extracted from JWT token.
+3. **BigInteger ID handling**: All ID fields (`transferOutFormId`, `transferOutFormItemId`) must be parsed as `string` in TypeScript to avoid precision loss.
+4. **Date range**: When only start or only end is provided, send it as a single `stockDate` instead of `stockDateCriteria`.
+5. **Output format**: Table output with pagination summary at the bottom.
+
+## 2.8 Example Usage
+
+```bash
+# Default pagination
+barista liberica transfer-out-forms list
+
+# Page 2 with 50 items per page
+barista liberica transfer-out-forms list --page 2 --size 50
+
+# Filter by warehouse and review flag
+barista liberica transfer-out-forms list --warehouse-code WH001 --review-flag reviewed
+
+# Filter by date range
+barista liberica transfer-out-forms list --stock-date-start 2025-01-01 --stock-date-end 2025-01-31
+
+# JSON output
+barista liberica transfer-out-forms list --page 1 --size 10 --json
+```
+
+## 2.9 Output Examples
+
+### Table Output
+```
+┌─────────────┬─────────────────────┬──────────────┬──────────────────┬───────────────┬─────────────┬──────────────┐
+│ Item ID     │ Form Code           │ Warehouse    │ Material Name    │ Stock Qty     │ Review Flag │ Follower     │
+├─────────────┼─────────────────────┼──────────────┼──────────────────┼───────────────┼─────────────┼──────────────┤
+│ 1000001     │ TO-2025-0001        │ WH001        │ Coffee Beans A   │ 500.00        │ reviewed    │ Zhang San    │
+│ 1000002     │ TO-2025-0001        │ WH001        │ Coffee Beans B   │ 300.00        │ reviewed    │ Zhang San    │
+│ 1000003     │ TO-2025-0002        │ WH002        │ Filter Paper     │ 1000.00       │ pending     │ Li Si        │
+└─────────────┴─────────────────────┴──────────────┴──────────────────┴───────────────┴─────────────┴──────────────┘
+Total: 3 | Page 1/1 | Size 20
+```
+
+### JSON Output
+```json
+{
+  "success": true,
+  "data": {
+    "items": [
+      {
+        "transferOutFormItemId": "1000001",
+        "transferOutFormCode": "TO-2025-0001",
+        "warehouseCode": "WH001",
+        "materialName": "Coffee Beans A",
+        "stockQuantity": "500.00",
+        "materialUomCode": "kg",
+        "reviewFlag": "reviewed",
+        "followerName": "Zhang San",
+        "stockDate": "2025-05-15"
+      }
+    ],
+    "pagination": {
+      "page": 1,
+      "size": 20,
+      "total": 3
+    }
+  }
+}
+```
+
+## 2.10 API Path
+
+```
+GET /api/enterprise/stock/transferOut/page?pageNo=0&pageSize=20
+```
+
+**Headers:**
+```
+Authorization: <token>  (No "Bearer " prefix)
+```
+
+**Note**: Do NOT include `X-TENANT-ID` header. Tenant is extracted from JWT token.

package/docs/commands/liberica/transfer-out-forms/update.md

@@ -0,0 +1,286 @@
+# barista liberica transfer-out-forms update
+
+Update an existing transfer-out form.
+
+## 2.1 Command Metadata
+
+| Field | Value |
+|------|-----|
+| Full Command | `barista liberica transfer-out-forms update <id>` |
+| Description | Update an existing transfer-out form |
+| HTTP Method | POST |
+| Requires Authentication | Yes |
+| Supports Dry-Run | Yes |
+
+## 2.2 Backend API Reference
+
+### Controller Location
+```
+coffee-liberica-end/
+└── facade/liberica-facade-enterprise/
+    └── src/main/java/com/newpeak/liberica/facade/enterprise/controller/stock/
+        └── EnterpriseTransferOutFormController.java
+            └── edit(@PostResource(path = "/edit", requiredPermission = true, requirePermissionCode = TransferOutFormPermissionConstants.EDIT_TRANSFER_OUT_FORM))
+                └── public ResponseData<? extends TransferOutFormResponse> edit(
+                        @RequestHeader("X-TENANT-ID") Long tenantId,
+                        @RequestBody @Validated(BaseRequest.edit.class) TransferOutFormRequest transferOutFormRequest
+                    )
+```
+
+### Request DTO Location
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/pojo/request/
+        └── TransferOutFormRequest.java
+            ├── transferOutFormId: Long (@NotNull on edit)
+            ├── warehouseCode: String (@NotBlank on edit, max=255)
+            ├── stockDate: Date (@NotNull on edit)
+            ├── transferOutType: String (@NotBlank on edit, max=255)
+            ├── transferOutFormCode: String (max=255)
+            ├── follower: String (max=255)
+            ├── followerName: String (max=255)
+            ├── remark: String (max=255)
+            ├── itemList: List<TransferOutFormItemRequest> (@NotEmpty on edit)
+            └── lotList: List<TransferOutFormLotRequest>
+```
+
+**TransferOutFormItemRequest (required fields on edit):**
+```
+├── materialCode: String (@NotBlank, max=255)
+├── materialUomCode: String (@NotBlank, max=255)
+├── formQuantity: BigDecimal (@NotNull)
+├── formMaterialUomCode: String (@NotBlank, max=255)
+├── stockQuantity: BigDecimal (@NotNull)
+├── transferOutFormItemId: Long (required for existing items)
+├── sourceType: String (max=255)
+├── sourceCode: String (max=255)
+├── materialName: String (max=255)
+├── materialType: String (max=255)
+├── materialCharacteristicCode: String (max=255)
+├── color: String (max=255)
+├── longX: BigDecimal
+├── wideY: BigDecimal
+├── highZ: BigDecimal
+├── lotNoList: List<String>
+├── unitPrice: BigDecimal
+├── localCurrency: String (max=255)
+├── stockAmount: BigDecimal
+└── remark: String (max=255)
+```
+
+**TransferOutFormLotRequest (required fields on edit):**
+```
+├── transferOutFormLotId: Long (required for existing lots)
+├── warehouseCode: String (@NotBlank, max=255)
+├── materialCode: String (@NotBlank, max=255)
+├── materialUomCode: String (@NotBlank, max=255)
+├── lotNo: String (max=255)
+├── stockQuantity: BigDecimal (@NotNull)
+├── materialName: String (max=255)
+├── materialType: String (max=255)
+├── materialCharacteristicCode: String (max=255)
+├── color: String (max=255)
+├── longX: BigDecimal
+├── wideY: BigDecimal
+├── highZ: BigDecimal
+├── unitPrice: BigDecimal
+├── localCurrency: String (max=255)
+├── stockAmount: BigDecimal
+└── remark: String (max=255)
+```
+
+### Response DTO Location
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/pojo/response/
+        └── TransferOutFormResponse.java
+            ├── transferOutFormId: Long
+            ├── transferOutFormCode: String
+            ├── warehouseCode: String
+            ├── stockDate: Date
+            ├── transferOutType: String
+            ├── follower: String
+            ├── followerName: String
+            ├── reviewFlag: String
+            ├── reviewer: String
+            ├── reviewerName: String
+            ├── reviewTime: Instant
+            ├── remark: String
+            ├── enough: boolean
+            ├── itemList: List<TransferOutFormItemResponse>
+            ├── lotList: List<TransferOutFormLotResponse>
+            ├── createTime: String
+            └── updateTime: String
+```
+
+## 2.3 CLI Parameter Design
+
+### Command Structure
+```
+barista liberica transfer-out-forms update <id> [options]
+```
+
+### Positional Arguments
+| Argument | Type | Required | Description |
+|------|------|------|------|
+| id | string | Yes | Transfer-out form ID (transferOutFormId) |
+
+### Global Options
+| Option | Type | Description |
+|------|------|------|
+| `--env` | string | Target environment (dev\|test\|prod-cn\|prod-jp) |
+| `--tenant` | string | Tenant code |
+| `--dry-run` | boolean | Preview mode (no actual API call) |
+| `--json` | boolean | JSON output |
+
+### Command Options
+| Option | Short | Type | Required | Default | Description | Maps to DTO Field |
+|------|--------|------|------|--------|------|-------------|
+| --warehouse-code | -w | string | Yes | - | Warehouse code | warehouseCode |
+| --stock-date | -d | string | Yes | - | Stock date (YYYY-MM-DD) | stockDate |
+| --transfer-out-type | -t | string | Yes | - | Transfer-out type | transferOutType |
+| --code | -c | string | No | - | Transfer-out form code | transferOutFormCode |
+| --follower | -f | string | No | - | Follower code | follower |
+| --follower-name | -n | string | No | - | Follower name | followerName |
+| --remark | -r | string | No | - | Remark | remark |
+| --items | -i | string | Yes | - | Item list as JSON array | itemList |
+| --lots | -l | string | No | - | Lot list as JSON array | lotList |
+
+## 2.4 Field Mapping Table
+
+| CLI Parameter | DTO Field | Type Conversion | Validation Rule |
+|---------|---------|----------|----------|
+| <id> (positional) | transferOutFormId | string→Long | @NotNull |
+| --warehouse-code / -w | warehouseCode | Direct | @NotBlank, max=255 |
+| --stock-date / -d | stockDate | string→Date | @NotNull, yyyy-MM-dd |
+| --transfer-out-type / -t | transferOutType | Direct | @NotBlank, max=255 |
+| --code / -c | transferOutFormCode | Direct | max=255 |
+| --follower / -f | follower | Direct | max=255 |
+| --follower-name / -n | followerName | Direct | max=255 |
+| --remark / -r | remark | Direct | max=255 |
+| --items / -i | itemList | string→JSON Array | @NotEmpty |
+| --lots / -l | lotList | string→JSON Array | - |
+
+## 2.5 Error Code Reference
+
+### ExceptionEnum Location
+```
+coffee-liberica-end/
+└── business/liberica-business-stock/stock-api/
+    └── src/main/java/com/newpeak/liberica/stock/api/exception/enums/
+        └── TransferOutFormExceptionEnum.java
+            ├── TRANSFER_OUT_FORM_NOT_EXIST("01001190001", "租户出库单不存在")
+```
+
+### Known Error Codes
+| Error Code | Error Message | Trigger Condition |
+|--------|----------|----------|
+| 01001190001 | Transfer-out form does not exist | Update with non-existent ID |
+
+## 2.6 Permission Check
+
+| Check Item | Location | Description |
+|--------|------|------|
+| PermissionConstants | `TransferOutFormPermissionConstants.EDIT_TRANSFER_OUT_FORM` | Controller layer `@PostResource(requirePermissionCode = "EDIT_TRANSFER_OUT_FORM")` |
+
+## 2.7 Implementation Notes
+
+1. **Required fields**: `id` (positional), `--warehouse-code`, `--stock-date`, `--transfer-out-type`, and `--items` must be provided.
+2. **Item ID handling**: Existing items must include `transferOutFormItemId` in the JSON array. New items should omit this field.
+3. **Lot ID handling**: Existing lots must include `transferOutFormLotId` in the JSON array. New lots should omit this field.
+4. **Dry-run support**: Use `--dry-run` to preview the request body without calling the API.
+5. **BigInteger ID handling**: `transferOutFormId` and nested IDs must be parsed as `string` in TypeScript to avoid precision loss.
+6. **Pre-population**: For CLI convenience, consider fetching the current form detail first and merging unchanged fields with the provided options.
+
+## 2.8 Example Usage
+
+```bash
+# Update with minimal required fields
+barista liberica transfer-out-forms update 123456789 \
+  --warehouse-code WH001 \
+  --stock-date 2025-05-15 \
+  --transfer-out-type adjustment \
+  --items '[{"transferOutFormItemId":"1000001","materialCode":"MAT001","materialUomCode":"kg","formQuantity":600,"formMaterialUomCode":"kg","stockQuantity":600}]'
+
+# Update with all options
+barista liberica transfer-out-forms update 123456789 \
+  --warehouse-code WH001 \
+  --stock-date 2025-05-15 \
+  --transfer-out-type adjustment \
+  --code "TO-2025-0001" \
+  --follower "EMP001" \
+  --follower-name "Zhang San" \
+  --remark "Updated adjustment" \
+  --items '[{"transferOutFormItemId":"1000001","materialCode":"MAT001","materialName":"Coffee Beans A","materialUomCode":"kg","formQuantity":600,"formMaterialUomCode":"kg","stockQuantity":600,"unitPrice":50,"stockAmount":30000}]' \
+  --lots '[{"transferOutFormLotId":"2000001","warehouseCode":"WH001","materialCode":"MAT001","materialUomCode":"kg","lotNo":"LOT202501","stockQuantity":600}]'
+
+# Dry-run preview
+barista liberica transfer-out-forms update 123456789 \
+  --warehouse-code WH001 \
+  --stock-date 2025-05-15 \
+  --transfer-out-type adjustment \
+  --items '[...]' \
+  --dry-run
+
+# JSON output
+barista liberica transfer-out-forms update 123456789 \
+  --warehouse-code WH001 \
+  --stock-date 2025-05-15 \
+  --transfer-out-type adjustment \
+  --items '[...]' \
+  --json
+```
+
+## 2.9 Request Body Structure
+
+```json
+{
+  "transferOutFormId": 123456789,
+  "warehouseCode": "WH001",
+  "stockDate": "2025-05-15",
+  "transferOutType": "adjustment",
+  "transferOutFormCode": "TO-2025-0001",
+  "follower": "EMP001",
+  "followerName": "Zhang San",
+  "remark": "Updated adjustment",
+  "itemList": [
+    {
+      "transferOutFormItemId": 1000001,
+      "materialCode": "MAT001",
+      "materialName": "Coffee Beans A",
+      "materialUomCode": "kg",
+      "formQuantity": 600,
+      "formMaterialUomCode": "kg",
+      "stockQuantity": 600,
+      "unitPrice": 50,
+      "stockAmount": 30000
+    }
+  ],
+  "lotList": [
+    {
+      "transferOutFormLotId": 2000001,
+      "warehouseCode": "WH001",
+      "materialCode": "MAT001",
+      "materialUomCode": "kg",
+      "lotNo": "LOT202501",
+      "stockQuantity": 600
+    }
+  ]
+}
+```
+
+## 2.10 API Path
+
+```
+POST /api/enterprise/stock/transferOut/edit
+```
+
+**Headers:**
+```
+Authorization: <token>  (No "Bearer " prefix)
+Content-Type: application/json
+```
+
+**Note**: Do NOT include `X-TENANT-ID` header. Tenant is extracted from JWT token.

package/package.json

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

package/src/commands/liberica/index.ts

@@ -21,6 +21,9 @@ import { createCalendarCommand } from './calendar/index.js';
 import { createClientContactsCommand } from './client-contacts/index.js';
 import { createSupplierContactsCommand } from './supplier-contacts/index.js';
 import { createMouldCommand } from './mould/index.js';
+import { createTeamsCommand } from './teams/index.js';
+import { createTransferInFormsCommand } from './transfer-in-forms/index.js';
+import { createTransferOutFormsCommand } from './transfer-out-forms/index.js';
 
 export function createLibericaCommand(): Command {
   const libericaCommand = new Command('liberica');
@@ -47,6 +50,9 @@ export function createLibericaCommand(): Command {
   libericaCommand.addCommand(createClientContactsCommand());
   libericaCommand.addCommand(createSupplierContactsCommand());
   libericaCommand.addCommand(createMouldCommand());
+  libericaCommand.addCommand(createTeamsCommand());
+  libericaCommand.addCommand(createTransferInFormsCommand());
+  libericaCommand.addCommand(createTransferOutFormsCommand());
 
   libericaCommand.action(() => {
     console.log(chalk.bold('\n☕ Liberica Commands\n'));
@@ -67,8 +73,9 @@ export function createLibericaCommand(): Command {
     console.log('  Use "barista liberica dicts <command>" for dictionary item management');
     console.log('  Use "barista liberica operations <command>" for operation management');
     console.log('  Use "barista liberica stock <command>" for stock management');
+    console.log('  Use "barista liberica teams <command>" for teams and issue management');
     console.log('\n  Run "barista liberica <command> --help" for more details\n');
   });
 
   return libericaCommand;
-}
+}

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

@@ -0,0 +1,17 @@
+import { Command } from 'commander';
+import { createTeamIssuesCommand } from './issues/index.js';
+import { createTeamProjectsCommand } from './projects/index.js';
+import { createTeamTasksCommand } from './tasks/index.js';
+import { createTeamWorkLogsCommand } from './work-logs/index.js';
+
+export function createTeamsCommand(): Command {
+  const teamsCommand = new Command('teams');
+  teamsCommand.description('Manage teams and issues');
+
+  teamsCommand.addCommand(createTeamIssuesCommand());
+  teamsCommand.addCommand(createTeamProjectsCommand());
+  teamsCommand.addCommand(createTeamTasksCommand());
+  teamsCommand.addCommand(createTeamWorkLogsCommand());
+
+  return teamsCommand;
+}

package/src/commands/liberica/teams/issues/close.ts

@@ -0,0 +1,104 @@
+import { Command, Option } from 'commander';
+import chalk from 'chalk';
+import { configManager } from '../../../../core/config/manager.js';
+import { apiClient } from '../../../../core/api/client.js';
+import { Environment } from '../../../../types/index.js';
+import { UpdateTeamIssueRequest } from '../../../../types/team-issue.js';
+
+export function createTeamIssueCloseCommand(): Command {
+  const closeCommand = new Command('close');
+  closeCommand
+    .description('Close a team issue (sets status to CLOSED)')
+    .argument('<issue-id>', 'Issue ID')
+    .addOption(new Option('--env <string>').hideHelp())
+    .addOption(new Option('--tenant <string>').hideHelp())
+    .option('--json', 'Output as JSON');
+
+  closeCommand.action(async (issueId: string, options: Record<string, unknown>) => {
+    const context = configManager.getCurrentContext();
+    const environment = context.environment as Environment;
+    const tenant = context.tenant;
+
+    if (!issueId || issueId.trim() === '') {
+      console.error(chalk.red('\n✗ Issue ID is required\n'));
+      process.exit(1);
+    }
+
+    // Fetch the issue first to get all required fields
+    let existingIssue: Record<string, unknown> | null = null;
+    try {
+      const getResponse = await apiClient.getTeamIssue(environment, tenant, issueId);
+      if (!getResponse.success || !getResponse.data) {
+        if (options.json) {
+          console.log(JSON.stringify({ success: false, error: getResponse.error }, null, 2));
+        } else {
+          console.error(chalk.red(`\n✗ Issue not found: ${getResponse.error?.message || 'Unknown error'}\n`));
+        }
+        process.exit(1);
+      }
+      existingIssue = getResponse.data as unknown as Record<string, unknown>;
+    } catch (error) {
+      if (options.json) {
+        console.log(JSON.stringify({ success: false, error: { message: error instanceof Error ? error.message : 'Unknown error' } }, null, 2));
+      } else {
+        console.error(chalk.red(`\n✗ Error fetching issue: ${error instanceof Error ? error.message : 'Unknown error'}\n`));
+      }
+      process.exit(1);
+    }
+
+    const request: UpdateTeamIssueRequest = {
+      teamIssueId: issueId,
+      issueTitle: existingIssue.issueTitle as string,
+      issueDesc: existingIssue.issueDesc as string,
+      issueType: existingIssue.issueType as 'BUG' | 'REQUIREMENT' | 'QUESTION',
+      projectId: existingIssue.projectId as string,
+      projectCode: existingIssue.projectCode as string,
+      projectName: existingIssue.projectName as string,
+      reporterName: existingIssue.reporterName as string,
+      reporterEmail: existingIssue.reporterEmail as string,
+      priority: existingIssue.priority as 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT',
+      teamIssueStatus: 'CLOSED',
+      assignTo: existingIssue.assignTo as string[],
+      tags: existingIssue.tags as string[] | undefined,
+    };
+
+    try {
+      const response = await apiClient.updateTeamIssue(environment, tenant, request);
+
+      if (response.success) {
+        if (options.json) {
+          console.log(JSON.stringify({ success: true, data: response.data }, null, 2));
+        } else {
+          console.log(chalk.green(`\n✓ Issue ${issueId} closed successfully\n`));
+        }
+      } else {
+        if (options.json) {
+          console.log(JSON.stringify({ success: false, error: response.error }, null, 2));
+        } else {
+          console.error(chalk.red(`\n✗ Close failed: ${response.error?.message || 'Unknown error'}`));
+          if (response.error?.code) {
+            console.error(chalk.gray(`  Error code: ${response.error.code}`));
+          }
+          console.error();
+        }
+        process.exit(1);
+      }
+    } catch (error) {
+      if (options.json) {
+        console.log(
+          JSON.stringify({
+            success: false,
+            error: { message: error instanceof Error ? error.message : 'Unknown error' },
+          })
+        );
+      } else {
+        console.error(
+          chalk.red(`\n✗ Error: ${error instanceof Error ? error.message : 'Unknown error'}\n`)
+        );
+      }
+      process.exit(1);
+    }
+  });
+
+  return closeCommand;
+}