git-push-time 1.1.3 → 1.1.4

package/lib/config.js

@@ -17,7 +17,7 @@ function ensureConfigDir() {
 }
 
 /**
- * Đọc toàn bộ file cấu hình người dùng
+ * Read the user's complete configuration file.
  * @returns {Record<string, any>}
  */
 export function getConfig() {
@@ -33,7 +33,7 @@ export function getConfig() {
 }
 
 /**
- * Lưu cấu hình người dùng
+ * Save the user's configuration.
  * @param {Record<string, any>} data 
  */
 export function saveConfig(data) {
@@ -43,10 +43,10 @@ export function saveConfig(data) {
     const merged = { ...current, ...data };
     fs.writeFileSync(CONFIG_FILE, JSON.stringify(merged, null, 2), 'utf-8');
     try {
-      // Token nhạy cảm: giới hạn quyền đọc chỉ owner (chmod 600)
+      // Restrict access to sensitive tokens to the owner (chmod 600).
       fs.chmodSync(CONFIG_FILE, 0o600);
     } catch {
-      // Bỏ qua trên Windows hoặc FS không hỗ trợ chmod
+      // Ignore on Windows or filesystems that do not support chmod.
     }
     return true;
   } catch {
@@ -55,7 +55,7 @@ export function saveConfig(data) {
 }
 
 /**
- * Lấy danh sách tất cả các tài khoản GitHub đã lưu
+ * Get all saved GitHub accounts.
  * @returns {Array<{ login: string, name: string, token: string, active: boolean, avatar_url?: string }>}
  */
 export function getAllGitHubAccounts() {
@@ -76,7 +76,7 @@ export function getAllGitHubAccounts() {
     }
   }
 
-  // Tương thích ngược với trường `github` cũ nếu chưa migrate
+  // Support the legacy `github` field if it has not been migrated.
   if (result.length === 0 && cfg.github && cfg.github.token) {
     const login = cfg.github.user?.login || 'default';
     result.push({
@@ -92,7 +92,7 @@ export function getAllGitHubAccounts() {
 }
 
 /**
- * Đặt tài khoản GitHub đang kích hoạt
+ * Set the active GitHub account.
  * @param {string} login 
  */
 export function setActiveGitHubAccount(login) {
@@ -109,14 +109,14 @@ export function setActiveGitHubAccount(login) {
 }
 
 /**
- * Lấy GitHub token từ nhiều nguồn theo thứ tự ưu tiên:
- * 1. Biến môi trường GITHUB_TOKEN hoặc GH_TOKEN
- * 2. Tài khoản GitHub active trong file config
- * 3. Token từ GitHub CLI (`gh auth token`) nếu có
+ * Get a GitHub token from the available sources, in priority order:
+ * 1. GITHUB_TOKEN or GH_TOKEN environment variable
+ * 2. Active GitHub account in the config file
+ * 3. GitHub CLI token (`gh auth token`), if available
  * @returns {{ token: string | null, source: 'env' | 'config' | 'gh-cli' | null, user?: any }}
  */
 export function getGitHubToken() {
-  // 1. Kiểm tra Environment variables
+  // 1. Check environment variables.
   if (process.env.GITHUB_TOKEN && process.env.GITHUB_TOKEN.trim()) {
     return { token: process.env.GITHUB_TOKEN.trim(), source: 'env' };
   }
@@ -124,7 +124,7 @@ export function getGitHubToken() {
     return { token: process.env.GH_TOKEN.trim(), source: 'env' };
   }
 
-  // 2. Kiểm tra File config đã lưu
+  // 2. Check the saved config file.
   const cfg = getConfig();
   const activeLogin = cfg.activeGitHubLogin;
   if (activeLogin && cfg.githubAccounts && cfg.githubAccounts[activeLogin]) {
@@ -138,7 +138,7 @@ export function getGitHubToken() {
     return { token: cfg.github.token.trim(), source: 'config', user: cfg.github.user };
   }
 
-  // 3. Kiểm tra GitHub CLI gh
+  // 3. Check the GitHub CLI (`gh`).
   try {
     const r = spawnSync('gh', ['auth', 'token'], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] });
     if (r.status === 0 && r.stdout && r.stdout.trim()) {
@@ -152,7 +152,7 @@ export function getGitHubToken() {
 }
 
 /**
- * Lưu tài khoản GitHub vào file config (hỗ trợ đa tài khoản)
+ * Save a GitHub account to the config file (supports multiple accounts).
  * @param {string} token 
  * @param {object} userInfo 
  */
@@ -190,8 +190,8 @@ export function saveGitHubToken(token, userInfo = null) {
 }
 
 /**
- * Xóa tài khoản GitHub khỏi file config
- * @param {string} [login] nếu không truyền sẽ xóa tài khoản active
+ * Remove a GitHub account from the config file.
+ * @param {string} [login] If omitted, removes the active account.
  */
 export function removeGitHubToken(login = null) {
   const current = getConfig();

package/lib/fix.js

@@ -5,8 +5,8 @@ import { findRiskyStagedFiles } from './git.js';
 import { scanStagedContentForSecrets } from './secrets.js';
 
 /**
- * Danh sách phần mở rộng của file mã nguồn / tài liệu.
- * KHÔNG BAO GIỜ tự động thêm các file này vào .gitignore vì sẽ làm mất code dự án!
+ * Source-code and documentation file extensions.
+ * Never add these files to .gitignore automatically; that could hide project code.
  */
 const CODE_EXTENSIONS = new Set([
   '.js', '.mjs', '.cjs', '.jsx', '.ts', '.tsx',
@@ -24,12 +24,12 @@ function isCodeOrDocFile(filePath) {
 }
 
 /**
- * Tự fix an toàn khi phát hiện secret:
- *  1. git rm --cached -r -f <file> (gỡ khỏi commit, giữ nguyên file trên máy)
- *  2. Thêm rule tương ứng vào .gitignore (chỉ áp dụng cho file cấu hình secret, KHÔNG ignore file code)
- *  3. Tự động stage lại .gitignore để sẵn sàng commit
+ * Safely remediate detected secrets:
+ *  1. git rm --cached -r -f <file> (remove from Git while keeping the local file)
+ *  2. Add a matching .gitignore rule (only for secret config files, never source code)
+ *  3. Stage .gitignore so the rule is ready to commit
  *
- * @param {string[]} files danh sách file cần gỡ (vd ['.env', '.npmrc'])
+ * @param {string[]} files Files to unstage (e.g. ['.env', '.npmrc'])
  * @param {string} cwd
  * @returns {{ fixed: string[], alreadyClean: string[], failed: {file:string, reason:string}[], gitignoreAdded: string[], codeFilesWithSecrets: string[] }}
  */
@@ -49,13 +49,13 @@ export function autoFixStagedSecrets(files = [], cwd = process.cwd()) {
     let ok = false;
     let errReason = '';
 
-    // 1. Thử gỡ khỏi stage bằng git rm --cached -r -f
+    // 1. Try to unstage with git rm --cached -r -f.
     const r = spawnSync('git', ['rm', '--cached', '-r', '-f', '--', normalized], { cwd, encoding: 'utf-8' });
     if (r.status === 0) {
       ok = true;
     } else {
       const msg = String(r.stderr || r.stdout || '');
-      // Thử fallback bằng git restore --staged nếu git rm báo pathspec/not matched
+      // Fall back to git restore --staged if git rm cannot match the path.
       const rRestore = spawnSync('git', ['restore', '--staged', '--', normalized], { cwd, encoding: 'utf-8' });
       if (rRestore.status === 0) {
         ok = true;
@@ -70,18 +70,18 @@ export function autoFixStagedSecrets(files = [], cwd = process.cwd()) {
     if (ok) {
       result.fixed.push(file);
     } else {
-      result.failed.push({ file, reason: errReason || 'không gỡ được khỏi stage' });
+      result.failed.push({ file, reason: errReason || 'Could not unstage file' });
     }
   }
 
-  // 2. Phân loại và tạo rule .gitignore cho các file config secret (bỏ qua file code)
+  // 2. Add .gitignore rules for secret config files (skip source files).
   const rules = [];
   for (const f of unique) {
     const normalized = f.replace(/\\/g, '/');
     const base = path.basename(normalized);
 
     if (isCodeOrDocFile(normalized)) {
-      // File mã nguồn có dính secret: gỡ khỏi stage nhưng không cho vào .gitignore
+      // Unstage source files containing secrets, but do not add them to .gitignore.
       result.codeFilesWithSecrets.push(f);
       continue;
     }
@@ -127,17 +127,17 @@ export function autoFixStagedSecrets(files = [], cwd = process.cwd()) {
       fs.appendFileSync(gitignorePath, prefix + toAdd.join('\n') + '\n', 'utf-8');
       result.gitignoreAdded = toAdd;
 
-      // Tự động stage ngay .gitignore để không bị sót khi commit
+      // Stage .gitignore so the new rules are not missed when committing.
       spawnSync('git', ['add', '.gitignore'], { cwd });
     } catch {
-      // Bỏ qua lỗi ghi file
+      // Ignore file-write errors.
     }
   }
 
   return result;
 }
 
-/** Kiểm tra còn gì để commit sau khi auto-fix không */
+/** Check whether anything remains to commit after auto-fix. */
 export function hasStagedChanges(cwd = process.cwd()) {
   try {
     const r = spawnSync('git', ['diff', '--cached', '--name-only'], { cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] });
@@ -149,7 +149,7 @@ export function hasStagedChanges(cwd = process.cwd()) {
 }
 
 /**
- * Quét các file secret phổ biến trong thư mục làm việc nhưng chưa được ignore trong .gitignore
+ * Find common secret files in the working directory that are not ignored by .gitignore.
  */
 export function findRiskyWorkingTreeFiles(cwd = process.cwd()) {
   const denyNames = [
@@ -171,11 +171,11 @@ export function findRiskyWorkingTreeFiles(cwd = process.cwd()) {
 }
 
 /**
- * Tìm upstream ref của branch hiện tại (VD: origin/main hoặc origin/master)
+ * Find the upstream ref for the current branch (e.g. origin/main or origin/master).
  */
 export function getUpstreamRef(branch = 'main', cwd = process.cwd()) {
   const cleanBranch = String(branch || 'main').trim() || 'main';
-  // Chặn ký tự shell/git nguy hiểm trước khi truyền (dù đã dùng spawnSync mảng args)
+  // Reject unsafe Git ref characters before passing the value to Git.
   if (/[\s~^:?*\[\\@{]/.test(cleanBranch) || cleanBranch.includes('..')) return null;
   try {
     const r = spawnSync('git', ['rev-parse', '--abbrev-ref', `${cleanBranch}@{u}`], { cwd, encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] });
@@ -196,7 +196,7 @@ export function getUpstreamRef(branch = 'main', cwd = process.cwd()) {
 }
 
 /**
- * Lấy danh sách các commit unpushed (chưa đẩy lên remote)
+ * Get the list of unpushed commits.
  */
 export function getUnpushedCommits(branch = 'main', cwd = process.cwd()) {
   const upstream = getUpstreamRef(branch, cwd);
@@ -219,8 +219,8 @@ export function getUnpushedCommits(branch = 'main', cwd = process.cwd()) {
 }
 
 /**
- * Squash các commit chưa push thành 1 commit duy nhất sạch sẽ,
- * loại bỏ hoàn toàn dấu vết secret ở các commit trung gian (ví dụ commit cũ chứa .npmrc hay .env).
+ * Squash unpushed commits into one clean commit, removing secrets from
+ * intermediate commits (for example, an earlier commit containing .npmrc or .env).
  */
 export function squashUnpushedCommits(branch = 'main', commitMsg = 'Clean commit without secrets', dateFormatted = null, cwd = process.cwd()) {
   const upstream = getUpstreamRef(branch, cwd);
@@ -229,21 +229,21 @@ export function squashUnpushedCommits(branch = 'main', commitMsg = 'Clean commit
     if (upstream) {
       const r1 = spawnSync('git', ['reset', '--soft', upstream], { cwd, encoding: 'utf-8' });
       if (r1.status !== 0) {
-        throw new Error(String(r1.stderr || r1.stdout || 'Không thể reset về upstream').trim());
+        throw new Error(String(r1.stderr || r1.stdout || 'Could not reset to upstream').trim());
       }
     } else {
-      // Chưa có upstream (repo mới hoàn toàn): squash TẤT CẢ thành 1 commit duy nhất
-      // bằng reset --soft về root rồi --amend root (thay vì commit mới gây ra 2 commits).
+      // Without an upstream (a new repository), squash everything into one commit
+      // by soft-resetting to the root and amending it instead of creating a second commit.
       const rRoot = spawnSync('git', ['rev-list', '--max-parents=0', 'HEAD'], { cwd, encoding: 'utf-8' });
-      if (rRoot.status !== 0) throw new Error('Không đọc được root commit.');
+      if (rRoot.status !== 0) throw new Error('Could not read the root commit.');
       const rootCommit = (rRoot.stdout || '').trim().split(/\s+/)[0];
-      if (!rootCommit) throw new Error('Không tìm thấy root commit.');
+      if (!rootCommit) throw new Error('Root commit not found.');
       const rReset = spawnSync('git', ['reset', '--soft', rootCommit], { cwd, encoding: 'utf-8' });
-      if (rReset.status !== 0) throw new Error('Không thể reset về root commit.');
+      if (rReset.status !== 0) throw new Error('Could not reset to the root commit.');
       usedAmendForRoot.value = true;
     }
 
-    // Quét lại và loại bỏ bất kỳ secret file nào còn sót trong staged
+    // Scan again and remove any secret files still staged.
     const risky = findRiskyStagedFiles(cwd);
     const findings = scanStagedContentForSecrets(cwd);
     const allSecretFiles = [...new Set([...risky, ...findings.map((f) => f.file)])];
@@ -251,14 +251,14 @@ export function squashUnpushedCommits(branch = 'main', commitMsg = 'Clean commit
       autoFixStagedSecrets(allSecretFiles, cwd);
     }
 
-    // Đảm bảo .gitignore được stage (nếu tồn tại)
+    // Ensure .gitignore is staged, if it exists.
     spawnSync('git', ['add', '.gitignore'], { cwd });
 
     if (!hasStagedChanges(cwd) && !usedAmendForRoot.value) {
-      return { ok: false, error: 'Không còn thay đổi nào để squash thành commit mới.' };
+      return { ok: false, error: 'No changes remain to squash into a new commit.' };
     }
 
-    // Tạo commit mới sạch
+    // Create a new clean commit.
     const env = { ...process.env };
     if (dateFormatted) {
       env.GIT_AUTHOR_DATE = dateFormatted;
@@ -267,7 +267,7 @@ export function squashUnpushedCommits(branch = 'main', commitMsg = 'Clean commit
     const safeMsg = String(commitMsg || 'Clean commit without secrets');
     let rCommit;
     if (usedAmendForRoot.value) {
-      // Amend root để giữ đúng 1 commit duy nhất cho repo chưa có upstream
+      // Amend the root to keep a single commit when there is no upstream.
       rCommit = spawnSync('git', ['commit', '--amend', '-m', safeMsg], { cwd, env, encoding: 'utf-8' });
     } else {
       rCommit = spawnSync('git', ['commit', '-m', safeMsg], { cwd, env, encoding: 'utf-8' });
@@ -275,9 +275,9 @@ export function squashUnpushedCommits(branch = 'main', commitMsg = 'Clean commit
     if (rCommit.status !== 0) {
       const msg = String(rCommit.stderr || rCommit.stdout || '').trim();
       if (msg.toLowerCase().includes('nothing to commit')) {
-        return { ok: false, error: 'Không có gì để commit sau khi làm sạch (working tree sạch).' };
+        return { ok: false, error: 'Nothing to commit after cleanup (working tree is clean).' };
       }
-      throw new Error(msg || 'Lỗi khi tạo commit squash');
+      throw new Error(msg || 'Could not create the squashed commit');
     }
     return { ok: true };
   } catch (err) {