cdhtools

Giới thiệu

cdhtools là công cụ CLI hỗ trợ migrate (chuyển đổi) các task từ file TaskMaster sang GitLab Epic/Issue, tự động tạo liên kết phụ thuộc và ghi lại kết quả.

---

Cài đặt & Sử dụng nhanh với NPX

Bạn không cần cài đặt toàn cục, chỉ cần chạy trực tiếp với npx:

``bash
npx cdhtools migrate epic --path=./taskmaster/tasks/tasks.json
`

- Tham số --path là đường dẫn tới file TaskMaster JSON (mặc định: ./taskmaster/tasks/tasks.json).
- Thêm --dryRun nếu muốn chạy thử mà không tạo dữ liệu trên GitLab.

Ví dụ:

`bash
npx cdhtools migrate epic --path=./taskmaster/tasks/tasks.json --dryRun
`

---

Cài đặt toàn cục (tuỳ chọn)

Nếu muốn sử dụng thường xuyên:

`bash
npm install -g cdhtools
`

Sau đó sử dụng:

`bash
cdhtools migrate epic --path=./taskmaster/tasks/tasks.json
`

---

Các lệnh CLI

`bash
cdhtools [options]
`

$3

- migrate epic: Chuyển đổi các task dạng Epic và Issue từ file TaskMaster sang GitLab.

$3

- --path=: Đường dẫn tới file TaskMaster JSON.
- --dryRun: Chạy thử, không tạo dữ liệu thật trên GitLab.

$3

`bash
cdhtools
`

---

Định dạng file TaskMaster (input)

File JSON đầu vào cần có cấu trúc như sau:

`json
{
"master": {
"tasks": [
{
"id": 1,
"title": "Tên Epic",
"description": "Mô tả",
"dependencies": [],
"details": "",
"status": "pending",
"testStrategy": "",
"subtasks": [
{
"id": 2,
"title": "Tên Issue",
"description": "Mô tả",
"dependencies": [],
"details": "",
"status": "pending",
"stack": "BACKEND",
"testStrategy": ""
}
]
}
]
}
}
`

---

Yêu cầu môi trường

- Node.js >= 16
- Cấu hình biến môi trường GitLab trong file .env:
- GITLAB_API_URL
- GITLAB_TOKEN
- BACKEND_REPO_ID
- FRONTEND_REPO_ID
- GROUP_ID

---

Kết quả

- Sau khi chạy, tool sẽ tạo file kết quả (ví dụ: tasks-completed.json`) chứa thông tin đã cập nhật (bao gồm các ID từ GitLab).