git-push-time 1.1.3 → 1.1.4

package/lib/git.js

@@ -3,7 +3,7 @@ import fs from 'fs';
 import path from 'path';
 
 /**
- * Kiểm tra xem máy tính đã cài đặt Git hay chưa
+ * Check whether Git is installed on this machine.
  * @returns {boolean}
  */
 export function checkGitInstalled() {
@@ -16,36 +16,36 @@ export function checkGitInstalled() {
 }
 
 /**
- * Kiểm tra thư mục hiện tại đã là kho chứa Git (Git repo) chưa
+ * Check whether the current directory is inside a Git repository.
  * @param {string} cwd 
  * @returns {boolean}
  */
 export function isGitRepo(cwd = process.cwd()) {
-  // Dùng spawnSync dạng mảng args (không qua shell) để tránh lỗi trên Windows
-  // khi folder chứa file tên git.* (vd: git.js) — cmd.exe sẽ nhầm `git` thành file đó do PATHEXT.
+  // Use spawnSync with an argument array instead of a shell to avoid Windows errors
+  // when the folder contains a file named git.* (e.g. git.js) that cmd.exe may resolve via PATHEXT.
   const r = spawnSync('git', ['rev-parse', '--is-inside-work-tree'], { cwd, encoding: 'utf-8' });
   return r.status === 0 && (r.stdout || '').trim() === 'true';
 }
 
 /**
- * Khởi tạo Git repo trong thư mục hiện tại
+ * Initialize a Git repository in the current directory.
  * @param {string} cwd
  */
 export function initGitRepo(cwd = process.cwd()) {
   const r = spawnSync('git', ['init'], { cwd, encoding: 'utf-8' });
   if (r.status !== 0) {
-    throw new Error(String(r.stderr || r.stdout || 'git init thất bại').trim());
+    throw new Error(String(r.stderr || r.stdout || 'git init failed').trim());
   }
 }
 
 /**
- * Lấy top-level của Git repo chứa `cwd` (đi ngược lên cha).
- * Trả về null nếu không nằm trong repo nào.
+ * Get the top-level directory of the Git repository containing `cwd`.
+ * Returns null when `cwd` is not inside a repository.
  * @param {string} cwd
  * @returns {string|null}
  */
 export function getGitTopLevel(cwd = process.cwd()) {
-  // Dùng spawnSync (không qua shell) — xem ghi chú ở isGitRepo.
+  // Use spawnSync without a shell; see the note in isGitRepo.
   const r = spawnSync('git', ['rev-parse', '--show-toplevel'], { cwd, encoding: 'utf-8' });
   if (r.status !== 0) return null;
   const out = (r.stdout || '').trim();
@@ -53,8 +53,8 @@ export function getGitTopLevel(cwd = process.cwd()) {
 }
 
 /**
- * Liệt kê các thư mục con trực tiếp của `cwd` để user chọn folder nguồn push.
- * Bỏ qua .git để tránh nhầm. Sắp xếp: thư mục thường trước, ẩn sau.
+ * List direct child directories of `cwd` for the user to choose as a push source.
+ * Skip .git. Sort regular folders before hidden folders.
  * @param {string} cwd
  * @returns {{ name: string, fullPath: string }[]}
  */
@@ -65,7 +65,7 @@ export function listSubdirectories(cwd = process.cwd()) {
       .filter((e) => {
         if (!e.isDirectory()) return false;
         if (e.name === '.git') return false;
-        // Bỏ qua symlink gãy
+        // Skip broken symlinks.
         try {
           fs.statSync(path.join(cwd, e.name));
           return true;
@@ -86,29 +86,29 @@ export function listSubdirectories(cwd = process.cwd()) {
 }
 
 /**
- * Chuẩn hoá đường dẫn folder nguồn do user nhập/truyền vào.
- * @param {string} inputPath đường dẫn tương đối hoặc tuyệt đối
- * @param {string} base thư mục gốc để resolve đường dẫn tương đối
+ * Normalize a user-provided source folder path.
+ * @param {string} inputPath Absolute or relative path
+ * @param {string} base Base directory for resolving relative paths
  * @returns {{ ok: boolean, fullPath?: string, error?: string }}
  */
 export function resolveTargetDir(inputPath, base = process.cwd()) {
   if (!inputPath || !String(inputPath).trim()) {
-    return { ok: false, error: 'Đường dẫn trống.' };
+    return { ok: false, error: 'Path is empty.' };
   }
   const fullPath = path.resolve(base, String(inputPath).trim());
   try {
     const stat = fs.statSync(fullPath);
-    if (!stat.isDirectory()) return { ok: false, error: `'${inputPath}' không phải là thư mục.` };
+    if (!stat.isDirectory()) return { ok: false, error: `'${inputPath}' is not a directory.` };
   } catch {
-    return { ok: false, error: `Không tìm thấy thư mục '${inputPath}'.` };
+    return { ok: false, error: `Directory not found: '${inputPath}'.` };
   }
   return { ok: true, fullPath };
 }
 
 /**
- * Lấy tên branch hiện tại (hoặc mặc định là main cho hiển thị).
- * Lưu ý: trả về 'main' khi detached HEAD để tương thích UI cũ.
- * Dùng getCurrentBranchStrict() khi cần phát hiện detached chính xác.
+ * Get the current branch name, defaulting to main for display.
+ * Returns 'main' for detached HEAD to preserve legacy UI behavior.
+ * Use getCurrentBranchStrict() when detached HEAD must be detected accurately.
  * @param {string} cwd
  * @returns {string}
  */
@@ -141,19 +141,19 @@ export function getDashboardGitStatus(cwd = process.cwd()) {
 }
 
 /**
- * Lấy tên branch hiện tại, trả về null khi detached HEAD hoặc lỗi.
+ * Get the current branch name, returning null for detached HEAD or errors.
  * @param {string} cwd
  * @returns {string|null}
  */
 export function getCurrentBranchStrict(cwd = process.cwd()) {
-  // Dùng spawnSync (không qua shell) — xem ghi chú ở isGitRepo.
+  // Use spawnSync without a shell; see the note in isGitRepo.
   const r = spawnSync('git', ['branch', '--show-current'], { cwd, encoding: 'utf-8' });
   if (r.status !== 0) return null;
   return (r.stdout || '').trim() || null;
 }
 
 /**
- * Validate tên branch để chống injection.
+ * Validate a branch name to prevent injection.
  * @param {string} name
  * @returns {boolean}
  */
@@ -161,8 +161,8 @@ export function isValidBranchName(name) {
   if (!name || typeof name !== 'string') return false;
   const t = name.trim();
   if (!t || t.length > 255) return false;
-  // Cấm ký tự điều khiển, space đầu/cuối, và các ký tự git cấm: ~ ^ : ? * [ \ ..
-  // Cho phép chữ, số, / - _ . đơn giản nhất; từ chối còn lại để an toàn.
+  // Reject control characters, surrounding spaces, and Git's reserved characters: ~ ^ : ? * [ \ ..
+  // For simplicity, allow letters, numbers, / - _ and . only.
   if (/[\s~^:?*\[\\]@{]/.test(t)) return false;
   if (t.includes('..') || t.startsWith('/') || t.endsWith('/') || t.endsWith('.lock')) return false;
   if (t === 'HEAD') return false;
@@ -170,14 +170,14 @@ export function isValidBranchName(name) {
 }
 
 /**
- * Thiết lập tên branch chính (ví dụ: git branch -M main)
+ * Set the primary branch name (for example, git branch -M main).
  * @param {string} branchName
  * @param {string} cwd
  */
 export function setBranchName(branchName = 'main', cwd = process.cwd()) {
   const clean = String(branchName || 'main').trim() || 'main';
   if (!isValidBranchName(clean)) {
-    throw new Error(`Tên branch không hợp lệ: '${branchName}'`);
+    throw new Error(`Invalid branch name: '${branchName}'`);
   }
   const current = getCurrentBranchStrict(cwd);
   if (current === clean) return;
@@ -188,24 +188,24 @@ export function setBranchName(branchName = 'main', cwd = process.cwd()) {
     cwd, stdio: 'ignore'
   });
   if (existing.status === 0) {
-    throw new Error(`Branch local '${clean}' đã tồn tại. Hãy chọn tên khác hoặc checkout branch đó trước.`);
+    throw new Error(`Local branch '${clean}' already exists. Choose another name or check out that branch first.`);
   }
 
   const r = spawnSync('git', ['branch', '-M', clean], { cwd, encoding: 'utf-8' });
   if (r.status !== 0) {
-    const msg = String(r.stderr || r.stdout || 'Không thể đổi tên branch.').trim();
+    const msg = String(r.stderr || r.stdout || 'Could not rename branch.').trim();
     throw new Error(msg);
   }
 }
 
 /**
- * Cấu hình remote `origin` cho Git repo
+ * Configure the `origin` remote for a Git repository.
  * @param {string} repoUrl
  * @param {string} cwd
  */
 export function setGitRemote(repoUrl, cwd = process.cwd()) {
   if (!repoUrl || typeof repoUrl !== 'string' || !repoUrl.trim()) {
-    throw new Error('URL repository trống.');
+    throw new Error('Repository URL is empty.');
   }
   const url = repoUrl.trim();
   try {
@@ -218,26 +218,26 @@ export function setGitRemote(repoUrl, cwd = process.cwd()) {
       r = spawnSync('git', ['remote', 'add', 'origin', url], { cwd, encoding: 'utf-8' });
     }
     if (r.status !== 0) {
-      throw new Error(String(r.stderr || r.stdout || 'git remote thất bại').trim());
+      throw new Error(String(r.stderr || r.stdout || 'git remote failed').trim());
     }
   } catch (error) {
-    throw new Error(`Không thể thiết lập Git Remote URL: ${error.message}`);
+    throw new Error(`Could not configure Git remote URL: ${error.message}`);
   }
 }
 
 /**
- * Stage toàn bộ file trong thư mục
+ * Stage all files in the directory.
  * @param {string} cwd
  */
 export function stageAllFiles(cwd = process.cwd()) {
   const r = spawnSync('git', ['add', '.'], { cwd, encoding: 'utf-8' });
   if (r.status !== 0) {
-    throw new Error(String(r.stderr || r.stdout || 'git add thất bại').trim());
+    throw new Error(String(r.stderr || r.stdout || 'git add failed').trim());
   }
 }
 
 /**
- * Kiểm tra xem có thay đổi (staged hoặc unstaged) chưa commit hay không
+ * Check for staged or unstaged changes that have not been committed.
  * @param {string} cwd
  * @returns {boolean}
  */
@@ -252,9 +252,9 @@ export function hasChangesToCommit(cwd = process.cwd()) {
 }
 
 /**
- * Thực hiện Git commit với thời gian tùy chỉnh (sử dụng GIT_AUTHOR_DATE & GIT_COMMITTER_DATE)
+ * Create a Git commit with a custom timestamp using GIT_AUTHOR_DATE and GIT_COMMITTER_DATE.
  * @param {string} message 
- * @param {string} dateFormatted ISO hoặc Git date format
+ * @param {string} dateFormatted ISO or Git date format
  * @param {string} cwd 
  */
 export function commitWithCustomDate(message, dateFormatted, cwd = process.cwd()) {
@@ -271,15 +271,15 @@ export function commitWithCustomDate(message, dateFormatted, cwd = process.cwd()
   });
 
   if (result.status !== 0) {
-    const stderr = result.stderr || result.stdout || 'Lỗi không xác định khi commit';
-    throw new Error(`Git commit thất bại: ${stderr.trim()}`);
+    const stderr = result.stderr || result.stdout || 'Unknown error while committing';
+    throw new Error(`Git commit failed: ${stderr.trim()}`);
   }
 }
 
 /**
- * Đẩy code lên Git remote repo
- * @param {string} branch Tên branch (VD: main)
- * @param {boolean} force Có sử dụng --force hay không
+ * Push code to a Git remote repository.
+ * @param {string} branch Branch name (e.g. main)
+ * @param {boolean} force Whether to use --force
  * @param {string} cwd
  */
 export function pushToRemote(branch = 'main', force = false, cwd = process.cwd()) {
@@ -295,7 +295,7 @@ export function pushToRemote(branch = 'main', force = false, cwd = process.cwd()
   });
 
   if (result.status !== 0) {
-    const raw = (result.stderr || result.stdout || 'Lỗi không xác định khi git push').trim();
+    const raw = (result.stderr || result.stdout || 'Unknown error while running git push').trim();
     const parsed = parsePushError(raw);
     const err = new Error(raw);
     err.code = parsed.code;
@@ -307,25 +307,25 @@ export function pushToRemote(branch = 'main', force = false, cwd = process.cwd()
 export function pullFromRemote(remote = 'origin', branch = null, cwd = process.cwd(), { rebase = false } = {}) {
   const targetBranch = branch || getCurrentBranchStrict(cwd);
   if (!targetBranch) {
-    throw new Error('Đang ở detached HEAD nên không xác định được branch để pull.');
+    throw new Error('HEAD is detached, so the branch to pull cannot be determined.');
   }
   const strategy = rebase ? '--rebase' : '--ff-only';
   const result = spawnSync('git', ['pull', strategy, remote, targetBranch], { cwd, encoding: 'utf-8', stdio: 'pipe' });
   if (result.status !== 0) {
-    throw new Error((result.stderr || result.stdout || `Git pull ${strategy} thất bại`).trim());
+    throw new Error((result.stderr || result.stdout || `Git pull ${strategy} failed`).trim());
   }
   return (result.stdout || '').trim();
 }
 
 export function getRecentCommits(limit = 30, cwd = process.cwd()) {
   const safeLimit = Math.max(1, Math.min(100, Number(limit) || 30));
-  // Dùng mảng args (không qua shell) để an toàn trên Windows (tránh lỗi với %, ^, {}).
-  // --date=iso để hiển thị cả giờ phút khi chọn commit.
+  // Pass arguments as an array to avoid shell escaping issues on Windows (%, ^, {}).
+  // --date=iso includes the time when displaying commits.
   const result = spawnSync('git', ['log', `--max-count=${safeLimit}`, '--format=%H%x09%h%x09%ad%x09%s', '--date=iso'], {
     cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'pipe']
   });
   if (result.status !== 0) {
-    // Repo chưa có commit nào -> trả về rỗng để caller báo lỗi thân thiện.
+    // Return an empty list for repositories without commits so the caller can show a friendly error.
     return [];
   }
   const output = (result.stdout || '').trim();
@@ -337,50 +337,50 @@ export function getRecentCommits(limit = 30, cwd = process.cwd()) {
 }
 
 /**
- * Sửa Author Date + Committer Date của 1 commit.
- * - Yêu cầu working tree sạch.
- * - Chỉ cho chạy trên branch thường (không detached HEAD).
- * - Commit phải nằm trên lịch sử branch hiện tại.
- * - Viết lại hash của commit đó và mọi commit phía sau (descendants).
- * - Giữ bản gốc bằng một nhánh backup tự động: backup/before-date-edit-*
+ * Edit the author and committer dates of a commit.
+ * - Requires a clean working tree.
+ * - Requires a branch checkout (not detached HEAD).
+ * - The commit must be in the current branch history.
+ * - Rewrites the selected commit and all of its descendants.
+ * - Preserves the original history in a backup branch: backup/before-date-edit-*
  */
 export function rewriteCommitDate(commitHash, dateFormatted, cwd = process.cwd()) {
-  // 1. Working tree phải sạch.
+  // 1. Require a clean working tree.
   const statusRes = spawnSync('git', ['status', '--porcelain'], { cwd, encoding: 'utf-8' });
-  if (statusRes.status !== 0) throw new Error('Không đọc được trạng thái working tree.');
-  if ((statusRes.stdout || '').trim()) throw new Error('Hãy commit hoặc stash thay đổi trước khi sửa thời gian commit.');
+  if (statusRes.status !== 0) throw new Error('Could not read working tree status.');
+  if ((statusRes.stdout || '').trim()) throw new Error('Commit or stash your changes before editing a commit timestamp.');
 
-  // 2. Phải ở trên branch thường.
+  // 2. Require a normal branch checkout.
   const branchRes = spawnSync('git', ['branch', '--show-current'], { cwd, encoding: 'utf-8' });
   const branch = (branchRes.stdout || '').trim();
-  if (!branch) throw new Error('Không hỗ trợ sửa commit khi đang ở detached HEAD.');
+  if (!branch) throw new Error('Cannot edit commits while HEAD is detached.');
 
   const headRes = spawnSync('git', ['rev-parse', 'HEAD'], { cwd, encoding: 'utf-8' });
-  if (headRes.status !== 0) throw new Error('Không xác định được HEAD của branch hiện tại.');
+  if (headRes.status !== 0) throw new Error('Could not determine the current branch HEAD.');
   const head = (headRes.stdout || '').trim();
 
-  // Dùng mảng args để tránh shell escape ^{commit} trên Windows (cmd/PowerShell).
+  // Pass an argument array to avoid escaping ^{commit} in Windows shells.
   const selRes = spawnSync('git', ['rev-parse', `${commitHash}^{commit}`], { cwd, encoding: 'utf-8' });
-  if (selRes.status !== 0) throw new Error('Không tìm thấy commit cần sửa.');
+  if (selRes.status !== 0) throw new Error('Commit to edit not found.');
   const selected = (selRes.stdout || '').trim();
 
   const isAncestor = spawnSync('git', ['merge-base', '--is-ancestor', selected, head], { cwd, stdio: 'ignore' });
-  if (isAncestor.status !== 0) throw new Error('Commit này không nằm trên lịch sử của branch hiện tại.');
+  if (isAncestor.status !== 0) throw new Error('This commit is not in the current branch history.');
 
-  // 3. Chỉ liệt kê commit từ selected tới HEAD (đỡ nặng, đúng semantics viết lại descendants).
+  // 3. List only commits from selected to HEAD to limit work to rewritten descendants.
   let revRange = head;
   const hasParent = spawnSync('git', ['rev-parse', '--verify', `${selected}^`], { cwd, stdio: 'ignore' });
   if (hasParent.status === 0) {
     revRange = `${selected}^..${head}`;
   }
   const listRes = spawnSync('git', ['rev-list', '--reverse', '--topo-order', revRange], { cwd, encoding: 'utf-8' });
-  if (listRes.status !== 0) throw new Error('Không đọc được lịch sử commit.');
+  if (listRes.status !== 0) throw new Error('Could not read commit history.');
   const commits = (listRes.stdout || '').trim().split(/\r?\n/).filter(Boolean);
-  if (!commits.includes(selected)) throw new Error('Commit này không nằm trên lịch sử của branch hiện tại.');
+  if (!commits.includes(selected)) throw new Error('This commit is not in the current branch history.');
 
   const epoch = Math.floor(new Date(dateFormatted).getTime() / 1000);
-  if (!Number.isFinite(epoch)) throw new Error('Thời gian commit không hợp lệ.');
-  // Format trong object commit là "<epoch> <tz>", KHÔNG có ký tự @.
+  if (!Number.isFinite(epoch)) throw new Error('Invalid commit timestamp.');
+  // Commit object dates use the format "<epoch> <tz>" without an @ character.
   const gitDate = `${epoch} +0000`;
 
   const remapped = new Map();
@@ -388,10 +388,10 @@ export function rewriteCommitDate(commitHash, dateFormatted, cwd = process.cwd()
 
   for (const hash of commits) {
     const catRes = spawnSync('git', ['cat-file', 'commit', hash], { cwd, encoding: 'utf-8', maxBuffer: 10 * 1024 * 1024 });
-    if (catRes.status !== 0) throw new Error(`Không đọc được commit ${hash.slice(0, 7)}.`);
+    if (catRes.status !== 0) throw new Error(`Could not read commit ${hash.slice(0, 7)}.`);
     const raw = catRes.stdout || '';
     const splitAt = raw.indexOf('\n\n');
-    if (splitAt === -1) throw new Error(`Commit ${hash.slice(0, 7)} có định dạng không hợp lệ.`);
+    if (splitAt === -1) throw new Error(`Commit ${hash.slice(0, 7)} has an invalid format.`);
     const headers = raw.slice(0, splitAt).split('\n');
     const message = raw.slice(splitAt);
     const parents = headers.filter((line) => line.startsWith('parent ')).map((line) => line.slice(7));
@@ -400,7 +400,7 @@ export function rewriteCommitDate(commitHash, dateFormatted, cwd = process.cwd()
     if (hash !== selected && !parentChanged) continue;
 
     if (headers.some((line) => line === 'gpgsig' || line.startsWith('gpgsig '))) {
-      throw new Error('Lịch sử có commit đã ký số; sửa ngày sẽ làm chữ ký mất hiệu lực.');
+      throw new Error('The history contains a signed commit; editing its date would invalidate the signature.');
     }
     let parentIndex = 0;
     const newHeaders = headers.map((line) => {
@@ -411,37 +411,37 @@ export function rewriteCommitDate(commitHash, dateFormatted, cwd = process.cwd()
       return line;
     });
     if (hash === selected && !newHeaders.some((line) => line.startsWith('author ') && line.endsWith(gitDate))) {
-      throw new Error('Không thể phân tích metadata của commit.');
+      throw new Error('Could not parse commit metadata.');
     }
     const result = spawnSync('git', ['hash-object', '-t', 'commit', '-w', '--stdin'], {
       cwd, input: `${newHeaders.join('\n')}${message}`, encoding: 'utf-8'
     });
-    if (result.status !== 0) throw new Error((result.stderr || 'Không thể tạo commit mới').trim());
+    if (result.status !== 0) throw new Error((result.stderr || 'Could not create a new commit').trim());
     remapped.set(hash, (result.stdout || '').trim());
     changed = true;
   }
 
   const newHead = remapped.get(head) || head;
-  if (!changed || newHead === head) throw new Error('Không tạo được commit đã sửa.');
+  if (!changed || newHead === head) throw new Error('Could not create the edited commit.');
 
-  // 4. Giữ bản gốc bằng nhánh backup thật để user thấy trong `git branch`.
+  // 4. Preserve the original history in a backup branch visible in `git branch`.
   const backupBranch = `backup/before-date-edit-${Date.now()}-${head.slice(0, 7)}`;
   const backupRef = `refs/heads/${backupBranch}`;
   const bkRes = spawnSync('git', ['update-ref', backupRef, head], { cwd, encoding: 'utf-8' });
-  if (bkRes.status !== 0) throw new Error('Không tạo được nhánh backup.');
+  if (bkRes.status !== 0) throw new Error('Could not create a backup branch.');
   const mvRes = spawnSync('git', ['update-ref', `refs/heads/${branch}`, newHead, head], { cwd, encoding: 'utf-8' });
   if (mvRes.status !== 0) {
     spawnSync('git', ['update-ref', '-d', backupRef], { cwd, stdio: 'ignore' });
-    throw new Error((mvRes.stderr || 'Không thể cập nhật branch sau khi viết lại.').trim());
+    throw new Error((mvRes.stderr || 'Could not update the branch after rewriting history.').trim());
   }
   return { oldHead: head, newHead, backupRef, backupBranch, rewrittenCount: remapped.size };
 }
 
 /**
- * Phân loại lỗi khi `git push` thất bại để CLI hiển thị hướng dẫn thân thiện.
- * Đặc biệt xử lý GitHub Push Protection (GH013) khi push dính secret.
+ * Classify `git push` failures so the CLI can show helpful guidance.
+ * Specifically handle GitHub Push Protection (GH013) secret blocks.
  *
- * @param {string} rawOutput stderr/stdout từ git push
+ * @param {string} rawOutput stderr/stdout from git push
  * @returns {{ code: string, secretTypes: string[], files: string[], unblockUrl: string | null, resolveUrl: string | null }}
  */
 export function parsePushError(rawOutput = '') {
@@ -458,7 +458,7 @@ export function parsePushError(rawOutput = '') {
     (lower.includes('detected') && lower.includes('secret'));
 
   if (isSecretBlocked) {
-    // VD: "—— npm Access Token ——" hoặc "— Generic API Key —"
+    // Examples: "—— npm Access Token ——" or "— Generic API Key —".
     const secretTypes = [];
     const typeRegex = /[—\-]{2,}\s*([A-Za-z0-9 _.'()/+-]+?(?:token|key|secret|password|private key)[A-Za-z0-9 _.'()/+-]*?)\s*[—\-]{2,}/gi;
     let m;
@@ -467,13 +467,13 @@ export function parsePushError(rawOutput = '') {
       if (name && !secretTypes.includes(name)) secretTypes.push(name);
     }
 
-    // VD: "- commit abc123: .npmrc:1" hoặc "file: .env"
+    // Examples: "- commit abc123: .npmrc:1" or "file: .env".
     const files = [];
     const fileRegex = /(?:commit\s+[0-9a-f]{4,40}\s*:\s*)([^\s:]+\.[A-Za-z0-9_.-]+)/gi;
     while ((m = fileRegex.exec(text)) !== null) {
       if (!files.includes(m[1])) files.push(m[1]);
     }
-    // fallback: tìm tên file khả nghi trong output (tránh greedy .* nuốt spaces)
+    // Fallback: find suspicious filenames in the output without a greedy .* match.
     const fallbackRegex = /(^|\s)(`?\.?(env|npmrc|id_rsa|id_ed25519|[^\s`'"]*\.pem|[^\s`'"]*\.key))\b/gi;
     while ((m = fallbackRegex.exec(text)) !== null) {
       const f = m[2].replace(/`/g, '');
@@ -505,10 +505,10 @@ export function parsePushError(rawOutput = '') {
 }
 
 /**
- * Quét nhanh staged files để cảnh báo TRƯỚC khi commit/push.
- * Chỉ cảnh báo, không chặn — tránh false-positive.
+ * Quickly scan staged files before commit/push.
+ * Warn without blocking to avoid false positives.
  * @param {string} cwd
- * @returns {string[]} danh sách file khả nghi
+ * @returns {string[]} List of suspicious files
  */
 export function findRiskyStagedFiles(cwd = process.cwd()) {
   const denyList = [/^\.env(\..+)?$/i, /^\.npmrc$/i, /_rsa$/, /_ed25519$/, /\.pem$/i, /\.key$/i, /secrets?\.json$/i, /credentials?\.json$/i, /\.p12$/i, /\.pfx$/i];