git-push-time 1.0.3 → 1.1.1

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

@@ -0,0 +1,33 @@
+# This workflow will run tests using node and then publish a package to GitHub Packages when a release is created
+# For more information see: https://docs.github.com/en/actions/publishing-packages/publishing-nodejs-packages
+
+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,134 +1,215 @@
-# 🚀 Git Push Time / GitHub CLI (`git-push-time`)
-
-Một công cụ Dòng lệnh (CLI) mạnh mẽ và tiện lợi giúp bạn **đẩy dự án lên Git (GitHub, GitLab, Bitbucket,...) cực nhanh** chỉ bằng cách dán URL repo, đồng thời hỗ trợ **tùy chỉnh hoặc lùi thời gian commit/push** (Author Date & Committer Date).
-
----
-
-## ✨ Tính năng nổi bật
-
-- 🔗 **Đẩy dự án siêu tốc**: Chỉ cần dán URL Git repository, công cụ tự động làm mọi thao tác `git init`, `git remote add/set-url`, `git add .`, `git commit`, `git push`.
-- ⏰ **Tùy chỉnh thời gian commit (Git Backdate)**:
-  - Lùi ngày/giờ bằng chuỗi ngắn gọ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 ngày giờ chuẩn chính xác: `2024-01-15 14:30:00`.
-  - Cập nhật cả `GIT_AUTHOR_DATE` và `GIT_COMMITTER_DATE` chuẩn mực.
-- 💬 **Chế độ Tương tác (Interactive Prompt)**: Giao diện trực quan đẹp mắt với câu hỏi từng bước.
-- ⚡ **Chế độ Lệnh nhanh (Command-line flags)**: Truyền tham số để đẩy code không cần bấm enter chọn lựa.
-- ⬇️ **Pull code**: Lấy cập nhật từ remote bằng fast-forward.
-- 🕒 **Sửa thời gian commit**: Chọn commit trong lịch sử hiện tại và thay đổi Author Date cùng Committer Date.
-
----
-
-## 📦 Cài đặt từ NPM
-
-### Cách 1: Cài đặt toàn cục (Recommended)
-```bash
-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 dự án nào** trên máy tính!
-
-### Cách 2: Chạy trực tiếp qua `npx`
-```bash
-npx git-push-time
-```
-
----
-
-## 🛠️ Hướng dẫn sử dụng
-
-### 1. Chế độ tương tác (Interactive Mode)
-Chỉ cần mở Terminal tại thư mục dự án của bạn và gõ:
-```bash
-git-push-time
-```
-Công cụ sẽ hiển thị từng câu hỏi giao diện:
-1. **📁 Chọn folder nguồn**: liệt kê các thư mục con để bạn chọn đúng folder cần up (tránh up nhầm cả folder gốc ngoài cùng). Tool chỉ push nội dung trong folder đã chọn.
-2. **Dán Link Repo**: `https://github.com/username/repository.git`
-3. **Commit Message**: `Initial commit`
-4. **Chọn thời gian**:
-   - ⏰ *Ngay bây giờ*
-   - ⏳ *Lùi thời gian* (VD: `-2d` là 2 ngày trước)
-   - 📅 *Nhập ngày giờ cụ thể* (VD: `2024-05-20 09:15:00`)
-5. **Tên Branch**: `main`
-6. **Xác nhận**: Có / Không.
-
-> Nếu folder được chọn nằm trong Git repo của folder cha, tool sẽ hỏi bạn muốn **tạo repo riêng** (chỉ up folder này, khuyên dùng) hay **dùng chung repo cha**.
-
----
-
-### 2. Chế độ dòng lệnh nhanh (Command Line Flags)
-Đẩy dự án với thông số truyền trực tiế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"
-```
-
-#### 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"
-```
-
-#### Ví dụ 3: Đẩy tự động không hỏi lại (-y) và force push (-f)
-```bash
-git-push-time -r https://github.com/username/my-repo.git -d "-5h" -m "Update docs" -b main -f -y
-```
-
-#### Ví dụ 4: Chỉ push đúng 1 folder con (đứng ở folder gốc ngoài cùng)
-```bash
-git-push-time -r https://github.com/username/my-repo.git -m "Init" --dir ./my-app -y
-```
-Tool sẽ `git init` + `git add .` + commit + push **bên trong `my-app`**, remote chỉ chứa nội dung của `my-app` (không có lớp folder cha, không dính file ngoài cùng).
-
----
-
-## 📊 Bảng định dạng thời gian hỗ trợ
-
-| Định dạng ví dụ | Ý 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 |
-
----
-
-- `-r, --repo <url>`: Link Git Repository (VD: `https://github.com/user/repo.git`)
-- `-d, --date <datetime>`: Thời gian commit (`now`, `-2d`, `2024-01-15 10:30:00`,...)
-- `-m, --message <msg>`: Thông điệp commit (Mặc định: `Initial commit`)
-- `-b, --branch <branch>`: Tên branch (Mặc định: `main`)
-- `-C, --dir <path>`: Folder nguồn cần push (VD: `--dir ./my-app`). Mặc định là thư mục hiện tại; ở chế độ tương tác tool sẽ cho bạn chọn.
-- `-f, --force`: Đẩy đè lên branch remote (`--force`)
-- `-y, --yes`: Tự động xác nhận, không hiện prompt chọn
-- `--fix`: Tự động gỡ file secret (.env, .npmrc...) khỏi stage và thêm vào `.gitignore`
-- `-h, --help`: Hướng dẫn trợ giúp
-
-### ⬇️ Pull Code
-```bash
-git-push-time pull [remote] [branch]
-```
-Mặc định lấy từ `origin` và branch hiện tại. Pull chỉ thực hiện fast-forward để tránh tự tạo merge commit.
-
-### ⏰ Sửa Thời Gian Commit
-```bash
-git-push-time edit-time
-```
-Chọn commit trong tối đa 100 commit gần nhất rồi nhập thời gian mới. Nếu lịch sử chỉ có một commit, tool tự chọn commit đó; nếu có nhiều commit thì bắt buộc chọn rõ commit. Sửa commit cũ sẽ viết lại hash của commit đó và các commit phía sau trên branch hiện tại; working tree phải sạch và không hỗ trợ detached HEAD. Bản gốc trước khi sửa được giữ trong nhánh backup tự động `backup/before-date-edit-*` (xem bằng `git branch`). Nếu commit đã push, cần force push để cập nhật remote.
-
-### 🛠️ Lệnh Fix Secret Độc Lập
-Nếu phát hiện repo bị dính secret hoặc GitHub Push Protection (GH013) chặn push, bạn có thể chạy ngay lệnh fix:
-```bash
-git-push-time fix
-```
-Lệnh sẽ tự động:
-1. Quét vùng stage và thư mục làm việc để tìm file cấu hình nhạy cảm (`.env`, `.npmrc`, keys...).
-2. Gỡ file khỏi stage và thêm rule an toàn vào `.gitignore`.
-3. Kiểm tra các commit chưa push (unpushed) dính secret cũ và hỗ trợ tự động squash thành commit sạch để GitHub cho phép push.
-
----
-
-## 📜 Giấy phép
-MIT License.
+# 🚀 Git Push Time & GitHub CLI (`git-push-time`)
+
+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)**.
+
+---
+
+## ✨ 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.
+
+---
+
+## 📦 Cài đặt
+
+### Cách 1: Cài đặt toàn cục (Khuyên dùng)
+```bash
+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
+npx git-push-time
+```
+
+---
+
+## 🧭 Quy trình hoạt động (Workflow)
+
+```text
+git-push-time github 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)
+```
+
+---
+
+## 🛠️ Hướng dẫn sử dụng
+
+### 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
+```
+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!
+
+#### Xem thông tin tài khoản GitHub đang kết nối:
+```bash
+git-push-time github whoami
+```
+
+#### Liệt kê các Repository trên tài khoản GitHub của bạn:
+```bash
+git-push-time github repos
+```
+
+#### Đă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)*.
+
+#### Đăng xuất:
+```bash
+git-push-time github logout
+```
+
+---
+
+### 3. Đẩy dự án bằng tham số dòng lệnh (Command Line Flags)
+
+#### 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"
+```
+
+#### 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"
+```
+
+#### 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
+```
+
+---
+
+### 4. Các lệnh độc lập khác
+
+#### Quét và tự động làm sạch Secret:
+```bash
+git-push-time fix
+```
+
+#### Cập nhật code mới từ remote:
+```bash
+git-push-time pull
+```
+
+#### Sửa đổi thời gian commit cũ trong lịch sử:
+```bash
+git-push-time edit-time
+```
+
+---
+
+## 📊 Bảng định dạng thời gian hỗ trợ
+
+| Định dạng ví dụ | Ý 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 (m = minute) |
+| `-1w` hoặc `1w` | Lùi lại 1 tuần |
+| `-3M` / `-3mo` / `-3month` | Lùi lại 3 tháng (M = month, phân biệt hoa/thường với m = minute) |
+| `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 |
+
+---
+
+## 🏛️ Cấu trúc mã nguồn
+
+```
+cli/
+├── bin/
+│   └── index.js             # CLI 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
+│   └── 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
+```
+
+---
+
+## 📄 License
+Phát hành theo giấy phép **MIT**.