git-push-time 1.0.2 → 1.0.3

package/README.md

@@ -13,6 +13,8 @@ Một công cụ Dòng lệnh (CLI) mạnh mẽ và tiện lợi giúp bạn **
   - 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.
 
 ---
 
@@ -38,15 +40,18 @@ 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 để bạn dán link repo, nhập commit message và chọn thời gian:
-1. **Dán Link Repo**: `https://github.com/username/repository.git`
-2. **Commit Message**: `Initial commit`
-3. **Chọn thời gian**:
+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`)
-4. **Tên Branch**: `main`
-5. **Xác nhận**: Có / Không.
+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**.
 
 ---
 
@@ -68,6 +73,12 @@ git-push-time -r https://github.com/username/my-repo.git -d "2024-01-15 14:30:00
 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ợ
@@ -89,12 +100,24 @@ git-push-time -r https://github.com/username/my-repo.git -d "-5h" -m "Update doc
 - `-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`
-- `--publish`: Publish package lên npm sau khi push Git thành công
 - `-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