git-push-time 1.1.0 → 1.1.2

package/.github/workflows/npm-publish.yml

@@ -0,0 +1,32 @@
+
+
+name: Node.js Package
+
+on:
+  release:
+    types: [created]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm ci
+      - run: npm test
+
+  publish-npm:
+    needs: build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org/
+      - run: npm ci
+      - run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{secrets.npm_token}}

package/README.md

@@ -1,188 +1,191 @@
-# 🚀 Git Push Time & GitHub CLI (`git-push-time`)
+<div align="center">
 
-Một công cụ Dòng lệnh (CLI) mạnh mẽ, hiện đại và toàn diện giúp bạn **đẩy dự án lên Git siêu tốc**, **kết nối GitHub tạo Repository trực tiếp**, **tùy chỉnh lùi thời gian commit (Backdate)** và **tự động bảo vệ chống lộ Key/Secret (GitHub GH013)**.
+# 🐙 GitHub CLI (`githubcli`)
+
+**Trợ lý GitHub trên terminal — đăng nhập, tạo repo, push/pull, quét secret — tất cả trong một chỗ.**
+
+[![npm version](https://img.shields.io/npm/v/git-push-time?style=flat-square&color=818CF8)](https://www.npmjs.com/package/git-push-time)
+[![license](https://img.shields.io/npm/l/git-push-time?style=flat-square)](./LICENSE)
+[![node](https://img.shields.io/node/v/git-push-time?style=flat-square&color=34D399)](https://nodejs.org)
+[![platform](https://img.shields.io/badge/platform-windows%20%7C%20macos%20%7C%20linux-38BDF8?style=flat-square)](https://github.com)
+
+`githubcli` · `git-push-time` · `git-custom-push`
+
+</div>
 
 ---
 
-## ✨ Tính năng nổi bật
-
-- 🐙 **Kết nối GitHub & Tạo Repository trực tiếp**:
-  - Tạo nhanh repository mới trên GitHub (Public / Private) chỉ trong 3 giây ngay trên terminal.
-  - Tự động liên kết remote và đẩy code của dự án lên repo mới vừa tạo.
-  - Hỗ trợ lưu trữ Personal Access Token (PAT) an toàn, tự nhận diện token từ `gh CLI` hoặc biến môi trường `GITHUB_TOKEN`.
-  - Xem thông tin tài khoản GitHub (Profile), danh sách repository cá nhân và chọn repo trực tiếp không cần copy-paste link.
-- ⚡ **Đẩy dự án siêu tốc**: Tự động hóa toàn bộ quy trình `git init`, `git remote`, `git add .`, `git commit`, `git push`.
-- ⏰ **Tùy chỉnh thời gian commit (Git Backdate)**:
-  - Lùi ngày/giờ bằng cú pháp tự nhiên: `-2d` (2 ngày trước), `-5h` (5 giờ trước), `-1w` (1 tuần trước), `-30m` (30 phút trước).
-  - Hoặc nhập mốc thời gian cụ thể: `2024-01-15 14:30:00`.
-  - Ghi chuẩn xác cả `GIT_AUTHOR_DATE` và `GIT_COMMITTER_DATE`.
-- 🛡️ **Zero-Leak Secret Shield**:
-  - Quét trước các file nhạy cảm (`.env`, `.npmrc`, private keys, API keys).
-  - Tự động gỡ khỏi stage và bổ sung vào `.gitignore` an toàn mà không làm mất file trên máy của bạn.
-  - Tự động squash làm sạch lịch sử unpushed nếu từng vô tình commit key bí mật.
-- 🎨 **Giao diện Terminal UI hiện đại**:
-  - Thiết kế Dashboard trực quan hiển thị thư mục, branch, trạng thái GitHub.
-  - Hỗ trợ nút `« Quay lại` ở tất cả các bước (hoặc gõ `..`).
-  - Hộp thoại màu sắc chuẩn Cyberpunk / DevTools sắc nét, không dùng emoji dư thừa.
+## ✨ Tính năng
+
+### 🐙 GitHub — trọng tâm chính
+- **Đăng nhập linh hoạt**: OAuth Device Flow (mở trình duyệt, nhập mã) hoặc dán Personal Access Token.
+- **Đa tài khoản**: lưu nhiều account, chuyển qua lại, tự nhận token từ `gh CLI` hoặc biến môi trường `GITHUB_TOKEN` / `GH_TOKEN`.
+- **Tạo repository ngay trên terminal**: Public / Private, tự gợi ý tên theo folder, tạo xong hỏi đẩy code lên luôn.
+- **Quản lý nhanh**: xem profile (`whoami`), duyệt repo cá nhân (`repos`), chọn repo từ danh sách không cần copy-paste URL.
+- Token lưu local (`~/.git-push-time/config.json`, chmod 600).
+
+### 🚀 Push / Pull
+- **Push wizard 7 bước**: chọn folder → account → repository (chọn sẵn / tạo mới / dán URL) → branch → message → time → xác nhận & push.
+- Tự động `git init`, `remote`, `add`, `commit`, `push`; hỗ trợ `--dir`, `--force`, `-y` chạy không hỏi.
+- **Pull**: `pull` fast-forward, gợi ý `--rebase` khi lệch lịch sử.
+- Nút `« Quay lại` mọi bước (hoặc gõ `..`).
+
+### 🛡️ Secret Shield (chống lộ key, lỗi GH013)
+- Quét file nhạy cảm (`.env`, `.npmrc`, private keys, API keys) trước khi push.
+- Tự gỡ khỏi stage + thêm `.gitignore` (file trên máy vẫn giữ nguyên).
+- Gợi ý squash các commit unpushed dính secret.
+
+### 🎨 Terminal UI
+- Dashboard hiển thị folder, branch, trạng thái GitHub, remote.
+- Khung bo tròn đồng bộ, căn đều 2 bên, màu Cyberpunk / DevTools.
+
+> ⏰ *Đổi thời gian commit (backdate / edit-time) chỉ là tiện ích bổ sung, xem ở [Phụ lục](#-phụ-lục-tiện-ích-thời-gian-commit).*
 
 ---
 
 ## 📦 Cài đặt
 
-### Cách 1: Cài đặt toàn cục (Khuyên dùng)
 ```bash
+# Cài toàn cục (khuyên dùng) — dùng được ở mọi thư mục
 npm install -g git-push-time
-```
-Sau khi cài đặt, bạn có thể gọi lệnh `git-push-time`, `githubcli` hoặc `git-custom-push` ở bất kỳ thư mục nào!
 
-### Cách 2: Chạy trực tiếp với `npx`
-```bash
+# Hoặc chạy trực tiếp không cần cài
 npx git-push-time
 ```
 
+Yêu cầu: **Node.js ≥ 18** và **Git** đã cài đặt.
+
 ---
 
-## 🧭 Quy trình hoạt động (Workflow)
+## ⚡ Bắt đầu nhanh (3 bước)
+
+```bash
+# 1. Đăng nhập GitHub (mở trình duyệt, nhập mã xác nhận)
+githubcli github login
+
+# 2. Tạo repo mới (Public/Private), xong chọn đẩy code lên luôn
+githubcli github create
+
+# 3. Hoặc đẩy project hiện tại lên repo bất kỳ
+githubcli -r https://github.com/username/my-repo.git -m "Initial commit" -b main -y
+```
+
+Luồng wizard khi chạy tay `githubcli` (không kèm flag):
 
 ```text
-git-push-time login
-        │
-        ▼
-🌐 GitHub Login (OAuth Device Flow / Personal Access Token)
-        │
-        ▼
-🔑 Mở trình duyệt xác nhận mã User Code & Cấp quyền
-        │
-        ▼
-✅ Đăng nhập thành công!
-        │
-        ▼
-git-push-time
-        │
-        ├── 📁 1. Chọn folder project
-        │
-        ├── 👤 2. Chọn GitHub account
-        │
-        ├── 📦 3. Chọn repository (chọn có sẵn / tạo mới trực tiếp / dán URL)
-        │
-        ├── 🌿 4. Chọn branch
-        │
-        ├── 💬 5. Nhập commit message
-        │
-        ├── ⏰ 6. Chọn commit time (ngay bây giờ / backdate lùi giờ / ngày cụ thể)
-        │
-        └── 🚀 7. Push (quét secret, commit & đẩy lên remote)
+githubcli
+   │
+   ├── 📁 1. Chọn folder project
+   ├── 👤 2. Chọn GitHub account
+   ├── 📦 3. Chọn repository (có sẵn / tạo mới / dán URL)
+   ├── 🌿 4. Chọn branch
+   ├── 💬 5. Nhập commit message
+   ├── ⏰ 6. Chọn commit time (mặc định: ngay bây giờ)
+   └── 🚀 7. Xác nhận & Push (quét secret → commit → push)
 ```
 
 ---
 
-## 🛠️ Hướng dẫn sử dụng
+## 🖥️ Giao diện
 
-### 1. Bảng điều khiển tương tác (Interactive Dashboard)
-Mở terminal tại thư mục dự án và chạy:
-```bash
-git-push-time
+```text
+╭───────────────  git-push-time  v1.1.1 ───────────────╮
+│ ▲ Folder   E:\my-project                            │
+│ → Branch   main  ● 5 file thay đổi                  │
+│ ◆ GitHub   @username  ✓ đã đăng nhập                │
+│ ○ Remote   username/my-repo                         │
+╰─────────────────────────────────────────────────────╯
+
+╭──────────────────  Xác nhận  ───────────────────────╮
+│ Repo     username/my-repo                            │
+│ Branch   main                                       │
+│ Message  "Initial commit"                            │
+│ Time     now                                        │
+╰─────────────────────────────────────────────────────╯
 ```
-Menu tương tác chính sẽ xuất hiện với các phân mục rõ ràng:
-- `» [PUSH]    | Đẩy code lên Git (kèm chọn folder, backdate & chống lộ secret)`
-- `» [GITHUB]  | Quản lý GitHub & Tạo repository mới`
-- `» [PULL]    | Cập nhật code mới về máy (Fast-forward / Rebase)`
-- `» [TIME]    | Sửa thời gian commit lịch sử`
-- `» [FIX]     | Quét & gỡ sạch secret khỏi repo`
-- `x [THOÁT]   | Kết thúc chương trình`
 
 ---
 
-### 2. Tính năng GitHub & Tạo Repository
-
-#### Tạo Repository mới trên GitHub ngay lập tức:
-```bash
-git-push-time github create
-```
-Hệ thống sẽ hỏi bạn:
-1. **Tên Repository** (Mặc định tự lấy theo tên folder hiện tại).
-2. **Mô tả dự án**.
-3. **Quyền riêng tư**: Public hoặc Private.
-4. **Hỏi đẩy code ngay**: Nếu chọn Có, CLI sẽ tự động liên kết remote và đẩy toàn bộ source code của bạn lên repo vừa tạo!
+## 🛠️ Lệnh
 
-#### Xem thông tin tài khoản GitHub đang kết nối:
-```bash
-git-push-time github whoami
-```
+### GitHub
 
-#### Liệt kê các Repository trên tài khoản GitHub của bạn:
-```bash
-git-push-time github repos
-```
+| Lệnh | Mô tả |
+| :--- | :--- |
+| `githubcli github login` | Đăng nhập (OAuth Device Flow hoặc PAT — token cần quyền `repo`) |
+| `githubcli github logout` | Đăng xuất, xóa token khỏi máy |
+| `githubcli github whoami` | Xem profile tài khoản đang kết nối |
+| `githubcli github repos` | Liệt kê repository cá nhân |
+| `githubcli github create` | Tạo repo mới, hỏi đẩy code lên ngay |
+| `githubcli github` | Mở menu quản lý GitHub tương tác |
 
-#### Đăng nhập bằng Personal Access Token (PAT):
-```bash
-git-push-time github login
-```
-*(Token cần có quyền `repo` để tạo và quản lý repository)*.
+### Push / Pull / Fix
 
-#### Đăng xuất:
-```bash
-git-push-time github logout
-```
+| Lệnh | Mô tả |
+| :--- | :--- |
+| `githubcli` | Mở dashboard tương tác (Push / GitHub / Pull / Time / Fix) |
+| `githubcli -r <url> -m "<msg>" -b <branch> -y` | Push nhanh không hỏi lại |
+| `githubcli --dir ./my-app -r <url> -m "Init" -y` | Chỉ push 1 thư mục con |
+| `githubcli pull [remote] [branch]` | Kéo code mới (fast-forward, gợi ý `--rebase` khi cần) |
+| `githubcli fix` | Quét & gỡ secret, cập nhật `.gitignore`, làm sạch commit unpushed |
+
+### Flags khi push
+
+| Flag | Ý nghĩa | Ví dụ |
+| :--- | :--- | :--- |
+| `-r, --repo <url>` | URL repository | `-r https://github.com/user/repo.git` |
+| `-m, --message <msg>` | Commit message | `-m "Add login"` |
+| `-b, --branch <branch>` | Branch remote (mặc định `main`) | `-b dev` |
+| `-d, --date <time>` | Thời gian commit (mặc định `now`) | `-d "-2d"` |
+| `-C, --dir <path>` | Thư mục nguồn | `--dir ./my-app` |
+| `-f, --force` | Push đè (`--force`) | — |
+| `-y, --yes` | Bỏ qua hỏi, dùng tham số/mặc định | — |
+| `--fix` | Tự gỡ secret trước khi commit | — |
 
 ---
 
-### 3. Đẩy dự án bằng tham số dòng lệnh (Command Line Flags)
+## 🔑 Token & đăng nhập
 
-#### Ví dụ 1: Lùi thời gian commit 2 ngày trước
-```bash
-git-push-time -r https://github.com/username/my-repo.git -d "-2d" -m "Initial commit"
-```
+Thứ tự ưu tiên khi lấy token:
 
-#### Ví dụ 2: Đặt ngày giờ commit cụ thể trong quá khứ
-```bash
-git-push-time -r https://github.com/username/my-repo.git -d "2024-01-15 14:30:00" -m "Add core features"
-```
+1. Biến môi trường `GITHUB_TOKEN` hoặc `GH_TOKEN`
+2. Tài khoản active trong `~/.git-push-time/config.json`
+3. Token từ `gh` CLI (`gh auth token`) nếu máy có cài
 
-#### Ví dụ 3: Đẩy tự động không hỏi lại (-y) và tự gỡ secret (--fix)
-```bash
-git-push-time -r https://github.com/username/my-repo.git -d "-5h" -m "Update docs" -b main -y --fix
-```
+---
 
-#### Ví dụ 4: Chỉ push đúng 1 thư mục con (khi đứng ở thư mục gốc ngoài cùng)
-```bash
-git-push-time -r https://github.com/username/my-repo.git -m "Init" --dir ./my-app -y
-```
+## ⏳ Phụ lục: tiện ích thời gian commit
 
----
+<details>
+<summary><b>Mở rộng: backdate khi push & sửa commit cũ</b></summary>
 
-### 4. Các lệnh độc lập khác
+<br>
 
-#### Quét và tự động làm sạch Secret:
-```bash
-git-push-time fix
-```
+Khi push có thể gắn thời gian tùy chỉnh bằng flag `-d`:
 
-#### Cập nhật code mới từ remote:
 ```bash
-git-push-time pull
+githubcli -r https://github.com/user/repo.git -d "-2d" -m "Initial commit" -y
+githubcli -r https://github.com/user/repo.git -d "2024-01-15 14:30:00" -m "Add core" -y
 ```
 
-#### Sửa đổi thời gian commit cũ trong lịch sử:
+Sửa thời gian commit đã có trong lịch sử:
+
 ```bash
-git-push-time edit-time
+githubcli edit-time
 ```
 
----
-
-## 📊 Bảng định dạng thời gian hỗ trợ
-
-| Định dạng ví dụ | Ý nghĩa |
+| Định dạng | Ý nghĩa |
 | :--- | :--- |
-| `now` hoặc để trống | Thời gian hiện tại |
-| `-2d` hoặc `2d` | Lùi lại 2 ngày |
-| `-5h` hoặc `5h` | Lùi lại 5 giờ |
-| `-30m` hoặc `30m` | Lùi lại 30 phút |
-| `-1w` hoặc `1w` | Lùi lại 1 tuần |
-| `-3m` | Lùi lại 3 tháng |
-| `2024-01-15 14:30:00` | Ngày 15/01/2024 lúc 14 giờ 30 phút |
-| `2024-01-15` | Ngày 15/01/2024 |
+| `now` / để trống | Giờ hiện tại |
+| `-2d` / `2d` | Lùi 2 ngày |
+| `-5h` / `5h` | Lùi 5 giờ |
+| `-30m` / `30m` | Lùi 30 phút (`m` = minute) |
+| `-1w` / `1w` | Lùi 1 tuần |
+| `-3M` / `-3mo` | Lùi 3 tháng (`M` = month) |
+| `2024-01-15 14:30:00` | Ngày giờ cụ thể |
+| `2024-01-15` | Ngày cụ thể |
+
+</details>
 
 ---
 
@@ -191,25 +194,26 @@ git-push-time edit-time
 ```
 cli/
 ├── bin/
-│   └── index.js             # CLI Entrypoint & Commander Dispatcher
+│   └── index.js             # Entrypoint & Commander dispatcher
 ├── lib/
-│   ├── config.js            # Quản lý config & GitHub Token local
-│   ├── github.js            # Tương tác GitHub REST API (verify, repos, create)
-│   ├── git.js               # Các tác vụ Git cốt lõi
-│   ├── secrets.js           # Quét phát hiện secret trong code & stage
-│   ├── fix.js               # Thuật toán gỡ secret & squash unpushed
-│   ├── utils.js             # Validate url & parse custom datetime
-│   ├── prompt-helpers.js    # Interactive prompt helpers có nút Back '..'
-│   ├── ui.js                # Design System: Banner, Dashboard, Box & Badges
+│   ├── config.js            # Config & token GitHub local
+│   ├── github.js            # GitHub REST API (verify, repos, create)
+│   ├── git.js               # Tác vụ Git cốt lõi
+│   ├── secrets.js           # Quét secret trong stage
+│   ├── fix.js               # Gỡ secret & squash unpushed
+│   ├── utils.js             # Validate URL & parse datetime
+│   ├── prompt-helpers.js    # Prompt trong khung (Back '..')
+│   ├── ui.js                # Design system: Banner, Box, Dashboard
 │   └── commands/
-│       ├── push.js          # Wizard push thông minh tích hợp GitHub
-│       ├── github.js        # Lệnh & Menu quản lý GitHub / Tạo repo
-│       ├── pull.js          # Lệnh pull code (--ff-only, --rebase)
-│       ├── edit-time.js     # Lệnh sửa thời gian commit lịch sử
-│       └── fix.js           # Lệnh quét & sửa secret độc lập
+│       ├── push.js          # Wizard push tích hợp GitHub
+│       ├── github.js        # Menu & lệnh GitHub
+│       ├── pull.js          # Pull (--ff-only / --rebase)
+│       ├── edit-time.js     # Sửa thời gian commit
+│       └── fix.js           # Quét & sửa secret
 ```
 
 ---
 
 ## 📄 License
+
 Phát hành theo giấy phép **MIT**.