git-push-time 1.1.2 → 1.1.4

package/lib/ui.js

@@ -1,1063 +1,1057 @@
-import chalk from "chalk";
-import boxen from "boxen";
-import stringWidth from "string-width";
-
-/**
- * Chiều rộng khung thống nhất cho toàn bộ UI.
- * - Luôn bằng nhau giữa dashboard / banner / prompt / box chi tiết
- *   nên các khung xếp chồng không bị lệch (vỡ giao diện).
- * - Terminal hẹp thì co theo `cols - 2`, terminal rộng thì cap 76.
- */
-export function getW() {
-  const cols = process.stdout.columns;
-  if (!cols || cols < 10) return 72;
-  const avail = cols - 2;
-  // Terminal quá hẹp (<34): dùng đúng phần hiển thị được, tránh tràn dòng.
-  if (avail < 34) return Math.max(24, avail);
-  return Math.min(76, avail);
-}
-
-function fitStyled(text, maxWidth) {
-  const value = String(text ?? '').replace(/[\r\n\t]+/g, ' ');
-  if (maxWidth <= 0) return '';
-  if (stringWidth(value) <= maxWidth) return value;
-
-  const segmenter = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
-  const parts = value.match(/\u001b\[[0-?]*[ -/]*[@-~]|[^\u001b]+|\u001b/g) || [];
-  const output = [];
-  let visible = 0;
-  let clipped = false;
-  const target = Math.max(0, maxWidth - 1);
-
-  for (const part of parts) {
-    if (part.startsWith('\u001b[')) {
-      output.push(part);
-      continue;
-    }
-    for (const { segment } of segmenter.segment(part)) {
-      const width = stringWidth(segment);
-      if (visible + width > target) {
-        clipped = true;
-        break;
-      }
-      output.push(segment);
-      visible += width;
-    }
-    if (clipped) break;
-  }
-
-  output.push('…');
-  // A clipped styled value must not leak its color into later terminal output.
-  if (value.includes('\u001b[')) output.push('\u001b[0m');
-  return output.join('');
-}
-
-
-function hexToRgb(hex) {
-  const n = parseInt(hex.replace("#", ""), 16);
-  return [(n >> 16) & 255, (n >> 8) & 255, n & 255];
-}
-
-export function multiGradient(text, colors = ["#818CF8", "#38BDF8", "#34D399", "#A7F3D0"]) {
-  const chars = [...text];
-  const rgbColors = colors.map(hexToRgb);
-  return chars.map((char, index) => {
-    const t = (index / (chars.length - 1 || 1)) * (rgbColors.length - 1);
-    const colorIndex = Math.min(Math.floor(t), rgbColors.length - 2);
-    const localT = t - colorIndex;
-    const [r1, g1, b1] = rgbColors[colorIndex];
-    const [r2, g2, b2] = rgbColors[colorIndex + 1];
-    return chalk.rgb(Math.round(r1 + (r2-r1)*localT), Math.round(g1 + (g2-g1)*localT), Math.round(b1 + (b2-b1)*localT))(char);
-  }).join("");
-}
-
-export function pad(str, len) {
-  const vLen = stringWidth(str);
-  if (vLen >= len) return str;
-  return str + " ".repeat(len - vLen);
-}
-
-export function truncateVisual(str, maxLen) {
-  return fitStyled(str, maxLen);
-}
-
-/** Khung tiêu đề nhất quán cho từng bước tương tác trong terminal. */
-export function framePrompt(message) {
-  // Dùng cùng getW() với mọi box khác để các khung luôn thẳng hàng,
-  // không còn tình trạng prompt hẹp (56) còn dashboard rộng (76) gây vỡ.
-  return boxen(String(message ?? ""), {
-    borderStyle: "round",
-    borderColor: "#818CF8",
-    padding: { left: 1, right: 1, top: 0, bottom: 0 },
-    width: getW(),
-    textAlignment: "center",
-  });
-}
-
-/* ==========================================================================
-   BOX ENGINE CHUẨN (Bo góc mềm & Căn lề pixel-perfect)
-   ========================================================================== */
-
-export function boxTop(title = "", borderColor = chalk.hex("#334155")) {
-  const W = getW();
-  if (!title) return borderColor("╭" + "─".repeat(Math.max(2, W - 2)) + "╮");
-
-  // Căn giữa tiêu đề để 2 bên đều nhau: ╭──── Title ────╮
-  // Chừa 1 space mỗi bên title + tối thiểu 2 gạch mỗi bên.
-  const maxTitle = Math.max(4, W - 8);
-  const fittedTitle = fitStyled(title, maxTitle);
-  const titleWidth = stringWidth(fittedTitle);
-  const remaining = Math.max(4, W - 2 - titleWidth - 2);
-  const leftLen = Math.ceil(remaining / 2);
-  const rightLen = Math.floor(remaining / 2);
-  return (
-    borderColor("╭" + "─".repeat(leftLen) + " ") +
-    fittedTitle +
-    borderColor(" " + "─".repeat(rightLen) + "╮")
-  );
-}
-
-/** Khung tiêu đề căn trái theo lề nội dung của boxRow. */
-export function boxTopLeft(title = "", borderColor = chalk.hex("#334155")) {
-  const W = getW();
-  if (!title) return borderColor("╭" + "─".repeat(Math.max(2, W - 2)) + "╮");
-  const fittedTitle = truncateVisual(title, W - 6);
-  const titleWidth = stringWidth(fittedTitle);
-  const rightDash = Math.max(0, W - titleWidth - 4);
-  return borderColor("╭ ") + fittedTitle + borderColor(" " + "─".repeat(rightDash) + "╮");
-}
-
-export function boxBottom(borderColor = chalk.hex("#334155")) {
-  const W = getW();
-  return borderColor("╰" + "─".repeat(Math.max(2, W - 2)) + "╯");
-}
-
-export function boxRow(content = "", borderColor = chalk.hex("#334155")) {
-  const W = getW();
-  const inner = Math.max(4, W - 4);
-  return borderColor("│ ") + pad(fitStyled(content, inner), inner) + borderColor(" │");
-}
-
-export function boxDivider(borderColor = chalk.hex("#334155")) {
-  const W = getW();
-  return borderColor("├" + "─".repeat(Math.max(2, W - 2)) + "┤");
-}
-
-/**
- * Hàng Key-Value có đường nối bằng dấu chấm · · ·
- * Dùng "·" (U+00B7) thay vì "․" (U+2024) để không bị vỡ font trên
- * Windows PowerShell / Consolas. Label không còn bị cắt oan khi
- * terminal hẹp nhờ công thức fitted mới.
- */
-/**
- * Hàng Key-Value có đường nối bằng dấu chấm · · ·
- * Căn lề chuẩn xác, khoảng cách đều và không bị vỡ font trên mọi terminal.
- */
-export function boxKvDot(
-  label,
-  value,
-  labelWidth = 14,
-  borderColor = chalk.hex("#334155"),
-) {
-  const W = getW();
-  const innerWidth = Math.max(8, W - 4);
-  const fittedLabelWidth = Math.min(labelWidth, Math.max(4, innerWidth - 10));
-  const maxValWidth = Math.max(4, innerWidth - fittedLabelWidth - 4);
-  const truncatedVal = truncateVisual(value, maxValWidth);
-  const valWidth = stringWidth(truncatedVal);
-
-  const dotsLen = Math.max(2, innerWidth - fittedLabelWidth - valWidth - 2);
-  const dots = " " + chalk.hex("#334155")("·".repeat(dotsLen)) + " ";
-  const formattedLabel = chalk.hex("#94A3B8")(
-    pad(fitStyled(label, fittedLabelWidth), fittedLabelWidth),
-  );
-
-  return boxRow(`${formattedLabel}${dots}${truncatedVal}`, borderColor);
-}
-
-/* ==========================================================================
-   PUBLIC INTERFACE & BANNER
-   ========================================================================== */
-
-/* ==========================================================================
-   CYBER CAT MASCOT — 20x12 pixel art grid, two pixel rows per terminal cell
-   ========================================================================== */
-
-const MASCOT_COLORS = {
-  P: "#818CF8", // Indigo ears
-  W: "#F8FAFC", // White face
-  C: "#38BDF8", // Cyan visor
-  E: "#06B6D4", // Visor eye glow
-  K: "#0F172A", // Dark visor frame
-  M: "#F43F5E", // Rose nose/mouth
-  G: "#10B981", // Emerald badge
-  B: "#334155", // Slate base
-  ".": "transparent",
-};
-
-const MASCOT_GRID = [
-  "..PP............PP......",
-  ".PPPP..........PPPP.....",
-  ".PPWW..........WWPP.....",
-  "WWWWWWWWWWWWWWWWWWWW....",
-  "WWKKKKKKKKKKKKKKWWWW....",
-  "WWKCCCCCCCCCCCCKWWWW....",
-  "WWKCEKEEEEEEKECKWWWW....",
-  "WWKKKKKKKKKKKKKKWWWW....",
-  "WWWWWWWWMMWWWWWWWWWW....",
-  ".WWWWWWWWWWWWWWWWWW..P..",
-  "..WWWW..GGGG..WWWWWWWW..",
-  "..BBBB..BBBB..BBBBWWWW..",
-];
-
-export function mascotLines() {
-  const lines = [];
-  for (let y = 0; y < MASCOT_GRID.length; y += 2) {
-    let line = "";
-    for (let x = 0; x < MASCOT_GRID[y].length; x++) {
-      const top = MASCOT_GRID[y][x];
-      const bot = MASCOT_GRID[y + 1][x];
-      if (top === "." && bot === ".") line += " ";
-      else if (top === "." || bot === ".") {
-        const pixel = top === "." ? bot : top;
-        line += chalk.hex(MASCOT_COLORS[pixel])(top === "." ? "▄" : "▀");
-      } else if (top === bot) {
-        line += chalk.hex(MASCOT_COLORS[top])("█");
-      } else {
-        line += chalk.hex(MASCOT_COLORS[top]).bgHex(MASCOT_COLORS[bot])("▀");
-      }
-    }
-    lines.push(line);
-  }
-  return lines;
-}
-
-/**
- * Banner: Cyber Cat Mascot + Wordmark + Badges
- */
-export function printBanner(version = "1.1.1") {
-  const W = getW();
-  const inner = Math.max(20, W - 2 - 4);
-  const badges = [
-    chalk.bgHex("#1E1B4B").hex("#818CF8").bold(` v${version} `),
-    chalk.bgHex("#064E3B").hex("#34D399").bold(" SMART GIT "),
-    chalk.bgHex("#0C4A6E").hex("#38BDF8").bold(" GITHUB SYNC "),
-    chalk.bgHex("#4C0519").hex("#FB7185").bold(" SECRET SHIELD "),
-    chalk.bgHex("#451A03").hex("#FBBF24").bold(" BACKDATE "),
-  ];
-  const rows = [];
-  let row = "";
-  for (const badge of badges) {
-    const next = row ? `${row} ${badge}` : badge;
-    if (row && stringWidth(next) > inner) {
-      rows.push(row);
-      row = badge;
-    } else row = next;
-  }
-  if (row) rows.push(row);
-
-  const title = multiGradient("G I T   P U S H   T I M E", [
-    "#818CF8",
-    "#38BDF8",
-    "#2DD4BF",
-    "#F472B6",
-  ]);
-  const subtitle = chalk.hex("#94A3B8")(
-    "Git & GitHub CLI · Đẩy code siêu tốc · An toàn · Đổi giờ commit",
-  );
-  const mascot = mascotLines();
-  const body = [...mascot, "", title, subtitle, "", ...rows].join("\n");
-  const frame = boxen(body, {
-    borderStyle: "round",
-    borderColor: "#6366F1",
-    padding: { top: 1, bottom: 1, left: 2, right: 2 },
-    width: W,
-    textAlignment: "center",
-  });
-  console.log(`\n${frame}\n`);
-}
-
-/**
- * Hiển thị Dashboard trạng thái ngắn gọn & trực quan ở đầu menu
- */
-export function printDashboardStatus({
-  targetDir = process.cwd(),
-  currentBranch = "main",
-  githubUser = null,
-  remoteUrl = null,
-  changes = 0,
-  lastCommit = null,
-  version = "1.1.1",
-}) {
-  const border = chalk.hex("#6366F1");
-  const W = getW();
-  const remote = remoteUrl ? formatRemoteLabel(remoteUrl) : chalk.hex("#94A3B8")("Chưa liên kết");
-
-  const ghStatus = githubUser
-    ? `${chalk.hex("#38BDF8").bold(`@${githubUser.login}`)}  ${chalk.bgHex("#064E3B").hex("#34D399").bold(" [✓ ĐÃ KẾT NỐI] ")}`
-    : chalk.bgHex("#1E1B4B").hex("#A5B4FC").bold(" [○ CHƯA ĐĂNG NHẬP] ");
-
-  const branchPill = changes === 0
-    ? chalk.bgHex("#064E3B").hex("#34D399").bold(" [✓ SẠCH] ")
-    : chalk.bgHex("#78350F").hex("#FDE047").bold(` [● ${changes} THAY ĐỔI] `);
-
-  const branchDisplay = `${chalk.hex("#38BDF8").bold(currentBranch)}  ${branchPill}`;
-
-  console.log("");
-  console.log(
-    boxTop(
-      `${chalk.bold.hex("#F8FAFC")(" BẢNG ĐIỀU KHIỂN GIT ")} ${chalk.hex("#94A3B8")(`v${version}`)}`,
-      border,
-    ),
-  );
-  console.log(boxRow("", border));
-  console.log(boxKvDot("Thư mục", chalk.hex("#F1F5F9").bold(targetDir), 14, border));
-  console.log(boxKvDot("Nhánh Git", branchDisplay, 14, border));
-  console.log(boxKvDot("GitHub", ghStatus, 14, border));
-  console.log(boxKvDot("Remote", remote, 14, border));
-
-  if (lastCommit && lastCommit.hash) {
-    const commitText = `${chalk.hex("#A78BFA").bold(lastCommit.hash)} ${chalk.hex("#CBD5E1")(truncateVisual(lastCommit.message || "", 26))} ${chalk.hex("#64748B")(`(${lastCommit.relativeTime || ""})`)}`;
-    console.log(boxKvDot("Commit gần", commitText, 14, border));
-  }
-
-  console.log(boxRow("", border));
-  console.log(boxBottom(border));
-}
-
-function formatRemoteLabel(url) {
-  const value = String(url || "").trim().replace(/\.git$/i, "");
-  const match = value.match(/(?:github\.com[:/])([^/]+\/[^/]+)$/i);
-  return match ? chalk.hex("#38BDF8")(match[1]) : chalk.hex("#CBD5E1")(value);
-}
-
-export function printPushProgress({ current, total = 6, title, completed = [] }) {
-  if (process.stdout.isTTY) process.stdout.write("\u001b[2J\u001b[H");
-  const nodes = Array.from({ length: total }, (_, index) => {
-    const n = index + 1;
-    if (n < current) return chalk.hex("#34D399")("●");
-    if (n === current) return chalk.hex("#38BDF8").bold("●");
-    return chalk.hex("#475569")("○");
-  });
-  const rail = nodes.join(chalk.hex("#334155")("──"));
-  const lead = `${chalk.hex("#38BDF8").bold("PUSH PROGRESS")}  ${rail}`;
-  const detail = chalk.hex("#94A3B8")(`[Bước ${current}/${total} · ${title}]`);
-  console.log("");
-  if (stringWidth(`${lead}  ${detail}`) <= getW() - 2) console.log(`${lead}  ${detail}`);
-  else {
-    console.log(lead);
-    console.log(`  ${detail}`);
-  }
-  if (completed.length) {
-    console.log("");
-    for (const item of completed) {
-      console.log(
-        `  ${chalk.hex("#34D399")("✓")}  ${chalk.hex("#94A3B8")(item.label.padEnd(16))} ${chalk.hex("#334155")("·····")} ${chalk.hex("#F1F5F9")(truncateVisual(item.value, getW() - 28))}`,
-      );
-    }
-  }
-}
-
-/**
- * Tiêu đề phân đoạn với điểm nhấn màu sắc
- */
-export function printSection(title) {
-  const W = getW();
-  const marker = chalk.hex("#A78BFA").bold("■");
-  const maxTitle = Math.max(4, W - 12);
-  const fittedTitle = fitStyled(String(title || "").trim(), maxTitle);
-  const coreWidth = stringWidth(fittedTitle) + 4;
-  const remaining = Math.max(4, W - coreWidth);
-  const leftLen = Math.ceil(remaining / 2);
-  const rightLen = Math.floor(remaining / 2);
-  console.log("");
-  console.log(
-    chalk.hex("#334155")("─".repeat(leftLen) + " ") +
-    marker +
-    chalk.bold.hex("#E2E8F0")(` ${fittedTitle} `) +
-    chalk.hex("#334155")("─".repeat(rightLen)),
-  );
-}
-
-/**
- * Pill Step Badge (Ví dụ: 1/6)
- */
-export function stepLabel(current, total, text) {
-  const pill = chalk.bgHex("#2563EB").hex("#FFFFFF").bold(` ${current}/${total} `);
-  return `${pill} ${chalk.hex("#F1F5F9").bold(text)}`;
-}
-
-/**
- * Bảng tóm tắt thông tin trước khi Push
- */
-export function printSummary({ repoUrl, commitMsg, dateDisplay, branch, force, sourceDir }) {
-  const border = chalk.hex("#38BDF8");
-  const title = chalk.bold.hex("#F8FAFC")(" XÁC NHẬN THÔNG TIN PUSH ");
-  console.log("");
-  console.log(boxTop(title, border));
-  console.log(boxRow("", border));
-  if (sourceDir) console.log(boxKvDot("Thư mục nguồn", chalk.hex("#F1F5F9")(sourceDir), 16, border));
-  console.log(boxKvDot("Kho lưu trữ", formatRemoteLabel(repoUrl), 16, border));
-  console.log(boxKvDot("Nhánh đích", chalk.hex("#38BDF8").bold(branch), 16, border));
-  console.log(boxKvDot("Thông điệp", chalk.hex("#FDE047")(`"${commitMsg}"`), 16, border));
-  console.log(boxKvDot("Thời điểm", chalk.hex("#A78BFA")(dateDisplay), 16, border));
-  console.log(boxKvDot("Quét Secret", chalk.hex("#34D399")("✓ Tự động kiểm tra trước khi đẩy"), 16, border));
-  if (force) {
-    console.log(boxRow("", border));
-    console.log(boxRow(chalk.hex("#F43F5E").bold("  [!] CẢNH BÁO: Chế độ ghi đè (--force) đang kích hoạt!"), border));
-  }
-  console.log(boxRow("", border));
-  console.log(boxBottom(border));
-}
-
-export function printTargetDir(dir = "") {
-  const W = getW();
-  console.log(
-    chalk.hex("#64748B")(
-      `  Thư mục: ${truncateVisual(String(dir || ""), W - 13)}`,
-    ),
-  );
-}
-
-/**
- * Hiển thị thẻ Profile thông tin tài khoản GitHub
- */
-export function printGitHubProfile(user, source = '') {
-  const border = chalk.hex("#4F46E5");
-  const title = chalk.bold.bgHex("#4F46E5").hex("#FFFFFF")(
-    " TÀI KHOẢN GITHUB KẾT NỐI ",
-  );
-
-  console.log("");
-  console.log(boxTop(title, border));
-
-  console.log(
-    boxKvDot("Username", chalk.hex("#38BDF8").bold(`@${user.login}`), 16, border)
-  );
-  if (user.name) {
-    console.log(boxKvDot("Tên hiển thị", chalk.hex("#F8FAFC")(user.name), 16, border));
-  }
-  if (user.email) {
-    console.log(boxKvDot("Email", chalk.hex("#94A3B8")(user.email), 16, border));
-  }
-  if (user.bio) {
-    console.log(boxKvDot("Tiểu sử", chalk.hex("#CBD5E1")(truncateVisual(user.bio, 40)), 16, border));
-  }
-
-  const repoStats = `${user.public_repos || 0} public  •  ${user.total_private_repos || 0} private`;
-  console.log(boxKvDot("Repositories", chalk.hex("#34D399").bold(repoStats), 16, border));
-
-  if (source) {
-    const srcDesc = source === 'gh-cli' ? 'GitHub CLI (gh)' : source === 'env' ? 'Biến môi trường' : 'Lưu trữ cá nhân';
-    console.log(boxKvDot("Nguồn xác thực", chalk.hex("#A78BFA")(srcDesc), 16, border));
-  }
-
-  console.log(boxDivider(border));
-  console.log(boxRow(chalk.hex("#64748B")(`» Trang cá nhân: ${user.html_url}`), border));
-  console.log(boxBottom(border));
-  console.log("");
-}
-
-/**
- * Hiển thị mã xác thực GitHub Device Flow cho người dùng
- */
-export function printDeviceCodePrompt({ userCode, verificationUri }) {
-  const border = chalk.hex("#6366F1");
-  const title = chalk.bold.bgHex("#4F46E5").hex("#FFFFFF")(
-    " GITHUB OAUTH / DEVICE FLOW ",
-  );
-
-  console.log("");
-  console.log(boxTop(title, border));
-  console.log(boxRow("", border));
-  console.log(boxRow(chalk.hex("#F8FAFC").bold("Bước 1: Mở trình duyệt và truy cập liên kết:"), border));
-  console.log(boxRow(chalk.hex("#38BDF8").bold.underline(`  ${verificationUri}`), border));
-  console.log(boxRow("", border));
-  console.log(boxRow(chalk.hex("#F8FAFC").bold("Bước 2: Nhập mã xác nhận (User Code):"), border));
-
-  const codeBox = chalk.bgHex("#1E1B4B").hex("#A5B4FC").bold(`    >>>  ${userCode}  <<<    `);
-  console.log(boxRow(`  ${codeBox}`, border));
-  console.log(boxRow("", border));
-  console.log(boxRow(chalk.hex("#94A3B8")("» Hệ thống đang tự động mở trình duyệt cho bạn..."), border));
-  console.log(boxRow(chalk.hex("#64748B")("» Nhấn Authorize trên trình duyệt để hoàn tất."), border));
-  console.log(boxBottom(border));
-  console.log("");
-}
-
-/**
- * Hiển thị thông báo sau khi tạo repository GitHub mới thành công
- */
-export function printRepoCreatedBox(repo) {
-  const border = chalk.hex("#059669");
-  const title = chalk.bold.bgHex("#10B981").hex("#064E3B")(
-    " TẠO REPOSITORY GITHUB THÀNH CÔNG! ",
-  );
-
-  console.log("");
-  console.log(boxTop(title, border));
-  console.log(boxRow("", border));
-
-  const visibilityPill = repo.isPrivate
-    ? chalk.bgHex("#7F1D1D").hex("#FCA5A5").bold(" PRIVATE ")
-    : chalk.bgHex("#065F46").hex("#6EE7B7").bold(" PUBLIC ");
-
-  console.log(boxKvDot("Tên Repo", chalk.hex("#F8FAFC").bold(repo.fullName || repo.name), 14, border));
-  console.log(boxKvDot("Quyền riêng tư", visibilityPill, 14, border));
-  if (repo.description) {
-    console.log(boxKvDot("Mô tả", chalk.hex("#CBD5E1")(truncateVisual(repo.description, 42)), 14, border));
-  }
-  console.log(boxKvDot("HTTPS Clone", chalk.hex("#38BDF8").underline(repo.cloneUrl), 14, border));
-  console.log(boxKvDot("SSH Clone", chalk.hex("#A78BFA")(repo.sshUrl), 14, border));
-
-  console.log(boxRow("", border));
-  console.log(boxDivider(border));
-  console.log(boxRow(chalk.hex("#6EE7B7")(`» Xem trên GitHub: ${repo.htmlUrl}`), border));
-  console.log(boxBottom(border));
-  console.log("");
-}
-
-/**
- * Cảnh báo Folder lồng trong Repo cha
- */
-export function printNestedRepoWarning({ targetDir = "", topLevel = "" } = {}) {
-  const border = chalk.hex("#D97706");
-  const title = chalk.bold.bgHex("#D97706").hex("#FFFFFF")(
-    " FOLDER NẰM TRONG REPO CHA ",
-  );
-
-  console.log("");
-  console.log(boxTop(title, border));
-  console.log(
-    boxRow(
-      chalk.hex("#FDE047")(
-        "Folder nguồn đang nằm trong Git repo của folder cha:",
-      ),
-      border,
-    ),
-  );
-  console.log(boxKvDot("  +- CHA", chalk.hex("#F8FAFC")(topLevel), 10, border));
-  console.log(
-    boxKvDot("  +- CON", chalk.hex("#F8FAFC")(targetDir), 10, border),
-  );
-  console.log(boxRow("", border));
-  console.log(
-    boxRow(
-      chalk.hex("#94A3B8")(
-        "Nếu push tiếp, lịch sử/file của folder cha có thể đi kèm.",
-      ),
-      border,
-    ),
-  );
-  console.log(
-    boxRow(
-      chalk.hex("#34D399")(
-        "Gợi ý: Tạo repo RIÊNG để chỉ push folder này.",
-      ),
-      border,
-    ),
-  );
-  console.log(boxBottom(border));
-}
-
-/**
- * Cảnh báo Secret nhạy cảm
- */
-export function printPrePushSecretWarning({ riskyFiles = [], findings = [] }) {
-  const border = chalk.hex("#D97706");
-  const title = chalk.bold.bgHex("#D97706").hex("#FFFFFF")(
-    " PHÁT HIỆN DỮ LIỆU NHẠY CẢM ",
-  );
-
-  console.log("");
-  console.log(boxTop(title, border));
-  console.log(
-    boxRow(
-      chalk.hex("#FDE047")(
-        "GitHub có thể chặn push nếu phát hiện key bí mật (GH013)",
-      ),
-      border,
-    ),
-  );
-  console.log(boxRow("", border));
-
-  const W2 = getW();
-  const maxFileW = Math.max(10, W2 - 14);
-  const maxLocW = Math.max(10, W2 - 24);
-  const maxPrevW = Math.max(10, W2 - 18);
-
-  if (riskyFiles.length > 0) {
-    console.log(
-      boxRow(chalk.bold.hex("#F8FAFC")("File cấu hình nguy cơ:"), border),
-    );
-    const showFiles = riskyFiles.slice(0, 4);
-    showFiles.forEach((f) => {
-      const tree = chalk.hex("#64748B")("  +- ");
-      console.log(
-        boxRow(tree + chalk.hex("#FCD34D")(truncateVisual(f, maxFileW)), border),
-      );
-    });
-    if (riskyFiles.length > 4) {
-      console.log(
-        boxRow(
-          chalk.hex("#64748B")(`  +- ...và ${riskyFiles.length - 4} file khác`),
-          border,
-        ),
-      );
-    }
-  }
-
-  if (findings.length > 0) {
-    if (riskyFiles.length > 0) console.log(boxRow("", border));
-    console.log(
-      boxRow(
-        chalk.bold.hex("#F8FAFC")("Vị trí nghi vấn Secret trong code:"),
-        border,
-      ),
-    );
-    const showFindings = findings.slice(0, 4);
-    showFindings.forEach((f, idx) => {
-      const isLast = idx === showFindings.length - 1;
-      const tree = chalk.hex("#64748B")("  +- ");
-      const loc = truncateVisual(`${f.file}:${f.line}`, maxLocW);
-      console.log(
-        boxRow(
-          tree +
-            chalk.hex("#F8FAFC")(loc) +
-            chalk.hex("#94A3B8")(` [${f.type}]`),
-          border,
-        ),
-      );
-      if (f.preview) {
-        const indent = chalk.hex("#64748B")(isLast ? "      " : "  |   ");
-        console.log(
-          boxRow(
-            indent + chalk.hex("#64748B")(`"${truncateVisual(f.preview, maxPrevW)}"`),
-            border,
-          ),
-        );
-      }
-    });
-    if (findings.length > 4) {
-      console.log(
-        boxRow(
-          chalk.hex("#64748B")(`  +- ...và ${findings.length - 4} vị trí khác`),
-          border,
-        ),
-      );
-    }
-  }
-
-  console.log(boxRow("", border));
-  console.log(
-    boxRow(
-      chalk.hex("#34D399")(
-        'Gợi ý: Chọn "Tự động fix" để gỡ file + .gitignore an toàn',
-      ),
-      border,
-    ),
-  );
-  console.log(boxBottom(border));
-}
-
-/**
- * Cảnh báo Push bị chặn bởi GitHub Push Protection (GH013)
- */
-export function printSecretBlockedBox(rawMessage, details = {}) {
-  const border = chalk.hex("#E11D48");
-  const files = details.files || [];
-  const types = details.secretTypes || [];
-  const title = chalk.bold.bgHex("#E11D48").hex("#FFFFFF")(
-    " PUSH BỊ CHẶN — PHÁT HIỆN SECRET (GH013) ",
-  );
-
-  console.log("");
-  console.log(boxTop(title, border));
-  console.log(
-    boxRow(
-      chalk.hex("#FDA4AF")(
-        "GitHub Push Protection đã chặn push vì phát hiện secret!",
-      ),
-      border,
-    ),
-  );
-  console.log(boxRow("", border));
-
-  if (types.length > 0) {
-    console.log(
-      boxKvDot(
-        "Loại secret",
-        chalk.hex("#F8FAFC").bold(types.slice(0, 2).join(", ")),
-        14,
-        border,
-      ),
-    );
-  }
-  if (files.length > 0) {
-    files.slice(0, 2).forEach((f) => {
-      console.log(
-        boxKvDot("File nguồn", chalk.hex("#FCD34D")(f), 14, border),
-      );
-    });
-  }
-
-  console.log(boxRow("", border));
-  console.log(
-    boxRow(chalk.bold.hex("#F8FAFC")("» Các giải pháp khắc phục:"), border),
-  );
-  console.log(
-    boxRow(
-      chalk.hex("#E2E8F0")("  [1] Thu hồi (revoke) key ngay nếu là token thật"),
-      border,
-    ),
-  );
-  console.log(
-    boxRow(
-      chalk.hex("#38BDF8")(
-        "  [2] Dùng tool tự động gỡ file & squash làm sạch commit",
-      ),
-      border,
-    ),
-  );
-  console.log(
-    boxRow(
-      chalk.hex("#94A3B8")(
-        "  [3] Xóa secret trong code / dùng biến môi trường (process.env)",
-      ),
-      border,
-    ),
-  );
-
-  console.log(boxBottom(border));
-
-  if (details.unblockUrl) {
-    console.log(
-      chalk.hex("#F59E0B")(
-        `\n  » URL mở khóa tạm thời (nếu là key mẫu thử nghiệm):\n  ${chalk.underline(details.unblockUrl)}`,
-      ),
-    );
-  }
-  console.log(
-    chalk.hex("#64748B")(
-      `\n  » Tài liệu GitHub: ${details.resolveUrl || "https://docs.github.com/code-security/secret-scanning/pushing-a-branch-blocked-by-push-protection"}\n`,
-    ),
-  );
-}
-
-/**
- * Card Thông báo Thành công sau khi Push
- */
-/**
- * Card Thông báo Thành công sau khi Push
- */
-export function printSuccessBox({
-  branch,
-  repoUrl,
-  durationSeconds = null,
-  secretStatus = "Đã quét (0 rủi ro)",
-}) {
-  const border = chalk.hex("#10B981");
-  const title = chalk.bold.hex("#F8FAFC")(" PUSH THÀNH CÔNG ");
-  console.log("");
-  console.log(boxTop(title, border));
-  console.log(boxRow("", border));
-  console.log(boxKvDot("Nhánh đích", chalk.hex("#34D399").bold(branch), 18, border));
-  console.log(boxKvDot("Trạng thái Secret", chalk.hex("#38BDF8")(secretStatus), 18, border));
-  if (durationSeconds !== null) {
-    console.log(
-      boxKvDot(
-        "Thời gian xử lý",
-        chalk.hex("#FBBF24").bold(`${durationSeconds.toFixed(1)}s`),
-        18,
-        border,
-      ),
-    );
-  }
-  const webUrl = toGitHubWebUrl(repoUrl);
-  if (webUrl) {
-    console.log(boxRow("", border));
-    console.log(boxDivider(border));
-    console.log(
-      boxRow(
-        `${chalk.hex("#34D399")("» Xem trên GitHub:")} ${chalk.hex("#38BDF8").underline(webUrl)}`,
-        border,
-      ),
-    );
-  } else {
-    console.log(boxKvDot("Remote", chalk.hex("#CBD5E1")(truncateVisual(repoUrl, getW() - 14)), 18, border));
-  }
-  console.log(boxRow("", border));
-  console.log(boxBottom(border));
-  console.log("");
-}
-
-function toGitHubWebUrl(url) {
-  const match = String(url || "").trim().match(/(?:https?:\/\/github\.com\/|git@github\.com:|ssh:\/\/git@github\.com\/)([^/]+\/[^/]+?)(?:\.git)?$/i);
-  return match ? `https://github.com/${match[1]}` : null;
-}
-
-export function printCancelled() {
-  const border = chalk.hex("#64748B");
-  const title = chalk.bold.hex("#F8FAFC")(
-    " ĐÃ HỦY THAO TÁC ",
-  );
-  console.log("");
-  console.log(boxTop(title, border));
-  console.log(boxRow("", border));
-  console.log(
-    boxRow(
-      chalk.hex("#94A3B8")(
-        "Thao tác đã dừng lại an toàn. Không có thay đổi nào được thực hiện.",
-      ),
-      border,
-    ),
-  );
-  console.log(boxRow("", border));
-  console.log(boxBottom(border));
-  console.log("");
-}
-
-export function printErrorBox(title = "XẢY RA LỖI", lines = [], hint = "") {
-  const W = getW();
-  const border = chalk.hex("#E11D48");
-  const cleanTitle = String(title || "").toUpperCase();
-  const titleStyled = chalk.bold.bgHex("#E11D48").hex("#FFFFFF")(` [LỖI] ${cleanTitle} `);
-  const rows = Array.isArray(lines) ? lines : [String(lines || "")];
-
-  console.log("");
-  console.log(boxTop(titleStyled, border));
-  rows.forEach((l) => {
-    if (!l) {
-      console.log(boxRow("", border));
-    } else {
-      console.log(
-        boxRow(chalk.hex("#FDA4AF")(truncateVisual(String(l), W - 4)), border),
-      );
-    }
-  });
-  if (hint) {
-    console.log(boxRow("", border));
-    console.log(
-      boxRow(chalk.hex("#38BDF8")(`» ${truncateVisual(hint, W - 6)}`), border),
-    );
-  }
-  console.log(boxBottom(border));
-  console.log("");
-}
-
-export function printGitMissing() {
-  printErrorBox(
-    "CHƯA CÀI ĐẶT GIT",
-    [
-      "Không tìm thấy Git trên hệ thống máy tính của bạn.",
-      "Vui lòng tải và cài đặt Git để tiếp tục!",
-    ],
-    "Tải ngay tại: https://git-scm.com/downloads",
-  );
-}
-
-export function printAuthFailedBox(message = "") {
-  const border = chalk.hex("#E11D48");
-  const title = chalk.bold.bgHex("#E11D48").hex("#FFFFFF")(
-    " LỖI XÁC THỰC GIT ",
-  );
-  const firstLine = String(message || "")
-    .split("\n")[0]
-    .slice(0, 120);
-
-  console.log("");
-  console.log(boxTop(title, border));
-  console.log(
-    boxRow(
-      chalk.hex("#FDA4AF")(
-        "Không thể xác thực với remote. Kiểm tra lại quyền truy cập.",
-      ),
-      border,
-    ),
-  );
-  if (firstLine)
-    console.log(
-      boxRow(
-        chalk.hex("#64748B")(truncateVisual(firstLine, getW() - 4)),
-        border,
-      ),
-    );
-  console.log(boxRow("", border));
-  console.log(
-    boxRow(chalk.bold.hex("#F8FAFC")("» Cách khắc phục nhanh:"), border),
-  );
-  console.log(
-    boxRow(
-      chalk.hex("#E2E8F0")("  [1] Chạy tính năng GITHUB trong tool để kết nối tài khoản"),
-      border,
-    ),
-  );
-  console.log(
-    boxRow(
-      chalk.hex("#E2E8F0")("  [2] Dùng lệnh gh: gh auth login"),
-      border,
-    ),
-  );
-  console.log(
-    boxRow(
-      chalk.hex("#94A3B8")("  [3] Sử dụng SSH URL: git@github.com:user/repo.git"),
-      border,
-    ),
-  );
-  console.log(boxBottom(border));
-  console.log("");
-}
-
-export function printNonFastForwardBox(message = "", branch = "main") {
-  const border = chalk.hex("#D97706");
-  const title = chalk.bold.bgHex("#D97706").hex("#FFFFFF")(
-    " REMOTE ĐÃ CÓ COMMIT MỚI HƠN ",
-  );
-  const firstLine = String(message || "")
-    .split("\n")[0]
-    .slice(0, 120);
-
-  console.log("");
-  console.log(boxTop(title, border));
-  console.log(
-    boxRow(
-      chalk.hex("#FDE68A")(
-        "Kho lưu trữ trên Remote đang chứa commit mới hơn Local.",
-      ),
-      border,
-    ),
-  );
-  if (firstLine)
-    console.log(
-      boxRow(
-        chalk.hex("#64748B")(truncateVisual(firstLine, getW() - 4)),
-        border,
-      ),
-    );
-  console.log(boxRow("", border));
-  console.log(
-    boxRow(
-      chalk.hex("#38BDF8")(
-        `  » Bạn có thể chọn Pull (rebase) rồi push lại ngay trong tool`,
-      ),
-      border,
-    ),
-  );
-  console.log(
-    boxRow(
-      chalk.hex("#94A3B8")(
-        "     Chỉ dùng --force khi bạn chắc chắn muốn ghi đè Remote.",
-      ),
-      border,
-    ),
-  );
-  console.log(boxBottom(border));
-  console.log("");
-}
-
-export function printFixResult({
-  fixed = [],
-  gitignoreAdded = [],
-  codeFilesWithSecrets = [],
-  failed = [],
-} = {}) {
-  const W = getW();
-  const border = chalk.hex("#10B981");
-  const title = chalk.bold.hex("#F8FAFC")(" KẾT QUẢ BẢO VỆ SECRET ");
-
-  console.log("");
-  console.log(boxTop(title, border));
-  console.log(boxRow("", border));
-
-  if (fixed.length > 0) {
-    console.log(
-      boxRow(
-        `${chalk.hex("#34D399").bold("[OK] Đã gỡ khỏi commit:")} ${chalk.hex("#F1F5F9")(truncateVisual(fixed.join(", "), W - 28))}`,
-        border,
-      ),
-    );
-  }
-  if (gitignoreAdded.length > 0) {
-    console.log(
-      boxRow(
-        `${chalk.hex("#38BDF8").bold("[+]  Thêm vào .gitignore:")} ${chalk.hex("#CBD5E1")(truncateVisual(gitignoreAdded.join(", "), W - 30))}`,
-        border,
-      ),
-    );
-  }
-  if (codeFilesWithSecrets && codeFilesWithSecrets.length > 0) {
-    console.log(boxRow("", border));
-    console.log(
-      boxRow(
-        chalk.hex("#FBBF24").bold("[!]  File code chứa secret (đã gỡ stage, KHÔNG ignore):"),
-        border,
-      ),
-    );
-    codeFilesWithSecrets.forEach((f) =>
-      console.log(boxRow(`     - ${chalk.hex("#CBD5E1")(truncateVisual(f, W - 10))}`, border)),
-    );
-    console.log(
-      boxRow(chalk.hex("#94A3B8")("     » Hãy xóa key trong file và thay bằng process.env."), border),
-    );
-  }
-  if (failed.length > 0) {
-    console.log(boxRow("", border));
-    failed.forEach((f) =>
-      console.log(boxRow(chalk.hex("#F43F5E")(`  [x] ${f.file}: ${f.reason}`), border)),
-    );
-  }
-
-  console.log(boxRow("", border));
-  console.log(boxBottom(border));
-  console.log("");
-}
-
-export function printFooter() {
-  const W = getW();
-  // Dải phân cách căn đều 2 bên, full width như mọi khung.
-  const core = "»";
-  const remaining = Math.max(4, W - 3); // 1 core + 2 space
-  const leftLen = Math.ceil(remaining / 2);
-  const rightLen = Math.floor(remaining / 2);
-  console.log(
-    chalk.hex("#334155")("─".repeat(leftLen) + " ") +
-    chalk.hex("#64748B")(core) +
-    chalk.hex("#334155")(" " + "─".repeat(rightLen))
-  );
-  const tip1 =
-    chalk.hex("#64748B")("» Mẹo: Chạy ") +
-    chalk.hex("#38BDF8").bold("git-push-time --help") +
-    chalk.hex("#64748B")(" để xem toàn bộ lệnh.");
-  const tip2 = chalk.hex("#475569")("» GitHub CLI & Push Time — Chúc hiệu quả!");
-  for (const tip of [tip1, tip2]) {
-    const w = stringWidth(tip);
-    if (w >= W) {
-      console.log(`  ${tip}`);
-    } else {
-      const padTotal = W - w;
-      const left = Math.floor(padTotal / 2);
-      console.log(" ".repeat(left) + tip);
-    }
-  }
-  console.log("");
-}
-
-export function styleCliHelp(program) {
-  program.configureHelp({
-    styleTitle: (t) => chalk.bold.hex("#38BDF8")(t),
-    styleCommandText: (t) => chalk.hex("#F8FAFC")(t),
-    styleOptionText: (t) => chalk.hex("#34D399")(t),
-    styleArgumentText: (t) => chalk.hex("#FBBF24")(t),
-    styleDescriptionText: (t) => chalk.hex("#94A3B8")(t),
-  });
-  program.addHelpText(
-    "after",
-    `
-${chalk.hex("#334155")("─── » Ví dụ phổ biến ───")}
-  ${chalk.hex("#34D399")("$")} ${chalk.white('git-push-time')}                           # Mở menu điều khiển tương tác trực quan
-  ${chalk.hex("#34D399")("$")} ${chalk.white('git-push-time github create')}            # Tạo nhanh repo mới trên GitHub
-  ${chalk.hex("#34D399")("$")} ${chalk.white('git-push-time -r <repo-url> -d "-2d" -y')} # Push tự động lùi 2 ngày
-  ${chalk.hex("#34D399")("$")} ${chalk.white('git-push-time fix')}                      # Quét & gỡ sạch secret
-  ${chalk.hex("#34D399")("$")} ${chalk.white('git-push-time pull')}                     # Cập nhật code mới từ remote
-`,
-  );
-}
+import chalk from "chalk";
+import boxen from "boxen";
+import stringWidth from "string-width";
+
+/**
+ * Shared frame width for the entire UI.
+ * - Keep dashboards, banners, prompts, and detail boxes aligned.
+ * - Shrink to `cols - 2` in narrow terminals and cap at 76 columns.
+ */
+export function getW() {
+  const cols = process.stdout.columns;
+  if (!cols || cols < 10) return 72;
+  const avail = cols - 2;
+  // On very narrow terminals (<34 columns), use the available width to prevent wrapping.
+  if (avail < 34) return Math.max(24, avail);
+  return Math.min(76, avail);
+}
+
+function fitStyled(text, maxWidth) {
+  const value = String(text ?? '').replace(/[\r\n\t]+/g, ' ');
+  if (maxWidth <= 0) return '';
+  if (stringWidth(value) <= maxWidth) return value;
+
+  const segmenter = new Intl.Segmenter(undefined, { granularity: 'grapheme' });
+  const parts = value.match(/\u001b\[[0-?]*[ -/]*[@-~]|[^\u001b]+|\u001b/g) || [];
+  const output = [];
+  let visible = 0;
+  let clipped = false;
+  const target = Math.max(0, maxWidth - 1);
+
+  for (const part of parts) {
+    if (part.startsWith('\u001b[')) {
+      output.push(part);
+      continue;
+    }
+    for (const { segment } of segmenter.segment(part)) {
+      const width = stringWidth(segment);
+      if (visible + width > target) {
+        clipped = true;
+        break;
+      }
+      output.push(segment);
+      visible += width;
+    }
+    if (clipped) break;
+  }
+
+  output.push('…');
+  // A clipped styled value must not leak its color into later terminal output.
+  if (value.includes('\u001b[')) output.push('\u001b[0m');
+  return output.join('');
+}
+
+
+function hexToRgb(hex) {
+  const n = parseInt(hex.replace("#", ""), 16);
+  return [(n >> 16) & 255, (n >> 8) & 255, n & 255];
+}
+
+export function multiGradient(text, colors = ["#818CF8", "#38BDF8", "#34D399", "#A7F3D0"]) {
+  const chars = [...text];
+  const rgbColors = colors.map(hexToRgb);
+  return chars.map((char, index) => {
+    const t = (index / (chars.length - 1 || 1)) * (rgbColors.length - 1);
+    const colorIndex = Math.min(Math.floor(t), rgbColors.length - 2);
+    const localT = t - colorIndex;
+    const [r1, g1, b1] = rgbColors[colorIndex];
+    const [r2, g2, b2] = rgbColors[colorIndex + 1];
+    return chalk.rgb(Math.round(r1 + (r2-r1)*localT), Math.round(g1 + (g2-g1)*localT), Math.round(b1 + (b2-b1)*localT))(char);
+  }).join("");
+}
+
+export function pad(str, len) {
+  const vLen = stringWidth(str);
+  if (vLen >= len) return str;
+  return str + " ".repeat(len - vLen);
+}
+
+export function truncateVisual(str, maxLen) {
+  return fitStyled(str, maxLen);
+}
+
+/** Consistent title frame for each interactive terminal step. */
+export function framePrompt(message) {
+  // Use the same width as other boxes to keep frames aligned and prevent narrow prompts
+  // from breaking against a wider dashboard.
+  return boxen(String(message ?? ""), {
+    borderStyle: "round",
+    borderColor: "#818CF8",
+    padding: { left: 1, right: 1, top: 0, bottom: 0 },
+    width: getW(),
+    textAlignment: "center",
+  });
+}
+
+/* ==========================================================================
+   SHARED BOX ENGINE (rounded corners and precise alignment)
+   ========================================================================== */
+
+export function boxTop(title = "", borderColor = chalk.hex("#334155")) {
+  const W = getW();
+  if (!title) return borderColor("╭" + "─".repeat(Math.max(2, W - 2)) + "╮");
+
+  // Center the title with even spacing on both sides: ╭──── Title ────╮
+  // Leave one space beside the title and at least two dashes on each side.
+  const maxTitle = Math.max(4, W - 8);
+  const fittedTitle = fitStyled(title, maxTitle);
+  const titleWidth = stringWidth(fittedTitle);
+  const remaining = Math.max(4, W - 2 - titleWidth - 2);
+  const leftLen = Math.ceil(remaining / 2);
+  const rightLen = Math.floor(remaining / 2);
+  return (
+    borderColor("╭" + "─".repeat(leftLen) + " ") +
+    fittedTitle +
+    borderColor(" " + "─".repeat(rightLen) + "╮")
+  );
+}
+
+/** Left-aligned title frame matching the content margin of boxRow. */
+export function boxTopLeft(title = "", borderColor = chalk.hex("#334155")) {
+  const W = getW();
+  if (!title) return borderColor("╭" + "─".repeat(Math.max(2, W - 2)) + "╮");
+  const fittedTitle = truncateVisual(title, W - 6);
+  const titleWidth = stringWidth(fittedTitle);
+  const rightDash = Math.max(0, W - titleWidth - 4);
+  return borderColor("╭ ") + fittedTitle + borderColor(" " + "─".repeat(rightDash) + "╮");
+}
+
+export function boxBottom(borderColor = chalk.hex("#334155")) {
+  const W = getW();
+  return borderColor("╰" + "─".repeat(Math.max(2, W - 2)) + "╯");
+}
+
+export function boxRow(content = "", borderColor = chalk.hex("#334155")) {
+  const W = getW();
+  const inner = Math.max(4, W - 4);
+  return borderColor("│ ") + pad(fitStyled(content, inner), inner) + borderColor(" │");
+}
+
+export function boxDivider(borderColor = chalk.hex("#334155")) {
+  const W = getW();
+  return borderColor("├" + "─".repeat(Math.max(2, W - 2)) + "┤");
+}
+
+/**
+ * Key-value row connected with dot leaders.
+ * Use "·" (U+00B7) instead of "․" (U+2024) for compatibility with
+ * Windows PowerShell and Consolas. The label width adapts to narrow terminals.
+ */
+/**
+ * Key-value row with dot leaders, precise alignment, and consistent spacing.
+ */
+export function boxKvDot(
+  label,
+  value,
+  labelWidth = 14,
+  borderColor = chalk.hex("#334155"),
+) {
+  const W = getW();
+  const innerWidth = Math.max(8, W - 4);
+  const fittedLabelWidth = Math.min(labelWidth, Math.max(4, innerWidth - 10));
+  const maxValWidth = Math.max(4, innerWidth - fittedLabelWidth - 4);
+  const truncatedVal = truncateVisual(value, maxValWidth);
+  const valWidth = stringWidth(truncatedVal);
+
+  const dotsLen = Math.max(2, innerWidth - fittedLabelWidth - valWidth - 2);
+  const dots = " " + chalk.hex("#334155")("·".repeat(dotsLen)) + " ";
+  const formattedLabel = chalk.hex("#94A3B8")(
+    pad(fitStyled(label, fittedLabelWidth), fittedLabelWidth),
+  );
+
+  return boxRow(`${formattedLabel}${dots}${truncatedVal}`, borderColor);
+}
+
+/* ==========================================================================
+   PUBLIC INTERFACE & BANNER
+   ========================================================================== */
+
+/* ==========================================================================
+   CYBER CAT MASCOT — 20x12 pixel art grid, two pixel rows per terminal cell
+   ========================================================================== */
+
+const MASCOT_COLORS = {
+  P: "#818CF8", // Indigo ears
+  W: "#F8FAFC", // White face
+  C: "#38BDF8", // Cyan visor
+  E: "#06B6D4", // Visor eye glow
+  K: "#0F172A", // Dark visor frame
+  M: "#F43F5E", // Rose nose/mouth
+  G: "#10B981", // Emerald badge
+  B: "#334155", // Slate base
+  ".": "transparent",
+};
+
+const MASCOT_GRID = [
+  "..PP............PP......",
+  ".PPPP..........PPPP.....",
+  ".PPWW..........WWPP.....",
+  "WWWWWWWWWWWWWWWWWWWW....",
+  "WWKKKKKKKKKKKKKKWWWW....",
+  "WWKCCCCCCCCCCCCKWWWW....",
+  "WWKCEKEEEEEEKECKWWWW....",
+  "WWKKKKKKKKKKKKKKWWWW....",
+  "WWWWWWWWMMWWWWWWWWWW....",
+  ".WWWWWWWWWWWWWWWWWW..P..",
+  "..WWWW..GGGG..WWWWWWWW..",
+  "..BBBB..BBBB..BBBBWWWW..",
+];
+
+export function mascotLines() {
+  const lines = [];
+  for (let y = 0; y < MASCOT_GRID.length; y += 2) {
+    let line = "";
+    for (let x = 0; x < MASCOT_GRID[y].length; x++) {
+      const top = MASCOT_GRID[y][x];
+      const bot = MASCOT_GRID[y + 1][x];
+      if (top === "." && bot === ".") line += " ";
+      else if (top === "." || bot === ".") {
+        const pixel = top === "." ? bot : top;
+        line += chalk.hex(MASCOT_COLORS[pixel])(top === "." ? "▄" : "▀");
+      } else if (top === bot) {
+        line += chalk.hex(MASCOT_COLORS[top])("█");
+      } else {
+        line += chalk.hex(MASCOT_COLORS[top]).bgHex(MASCOT_COLORS[bot])("▀");
+      }
+    }
+    lines.push(line);
+  }
+  return lines;
+}
+
+/**
+ * Banner: Cyber Cat Mascot + Wordmark + Badges
+ */
+export function printBanner(version = "1.1.1") {
+  const W = getW();
+  const inner = Math.max(20, W - 2 - 4);
+  const badges = [
+    chalk.bgHex("#1E1B4B").hex("#818CF8").bold(` v${version} `),
+    chalk.bgHex("#0C4A6E").hex("#38BDF8").bold(" GIT WORKSPACE "),
+  ];
+  const rows = [];
+  let row = "";
+  for (const badge of badges) {
+    const next = row ? `${row} ${badge}` : badge;
+    if (row && stringWidth(next) > inner) {
+      rows.push(row);
+      row = badge;
+    } else row = next;
+  }
+  if (row) rows.push(row);
+
+  const title = multiGradient("G I T   W O R K S P A C E", [
+    "#818CF8",
+    "#38BDF8",
+    "#2DD4BF",
+    "#F472B6",
+  ]);
+  const subtitle = chalk.hex("#94A3B8")(
+    "GitHub · Push / Pull · Commit history · Secret scan",
+  );
+  const mascot = mascotLines();
+  const body = [...mascot, "", title, subtitle, "", ...rows].join("\n");
+  const frame = boxen(body, {
+    borderStyle: "round",
+    borderColor: "#6366F1",
+    padding: { top: 1, bottom: 1, left: 2, right: 2 },
+    width: W,
+    textAlignment: "center",
+  });
+  console.log(`\n${frame}\n`);
+}
+
+/**
+ * Display a concise status dashboard at the top of the menu.
+ */
+export function printDashboardStatus({
+  targetDir = process.cwd(),
+  currentBranch = "main",
+  githubUser = null,
+  remoteUrl = null,
+  changes = 0,
+  lastCommit = null,
+  version = "1.1.1",
+}) {
+  const border = chalk.hex("#6366F1");
+  const W = getW();
+  const remote = remoteUrl ? formatRemoteLabel(remoteUrl) : chalk.hex("#94A3B8")("Not linked");
+
+  const ghStatus = githubUser
+    ? `${chalk.hex("#38BDF8").bold(`@${githubUser.login}`)}  ${chalk.bgHex("#064E3B").hex("#34D399").bold(" [✓ CONNECTED] ")}`
+    : chalk.bgHex("#1E1B4B").hex("#A5B4FC").bold(" [○ SIGNED OUT] ");
+
+  const branchPill = changes === 0
+    ? chalk.bgHex("#064E3B").hex("#34D399").bold(" [✓ CLEAN] ")
+    : chalk.bgHex("#78350F").hex("#FDE047").bold(` [● ${changes} CHANGES] `);
+
+  const branchDisplay = `${chalk.hex("#38BDF8").bold(currentBranch)}  ${branchPill}`;
+
+  console.log("");
+  console.log(
+    boxTop(
+      `${chalk.bold.hex("#F8FAFC")(" GIT DASHBOARD ")} ${chalk.hex("#94A3B8")(`v${version}`)}`,
+      border,
+    ),
+  );
+  console.log(boxRow("", border));
+  console.log(boxKvDot("Folder", chalk.hex("#F1F5F9").bold(targetDir), 14, border));
+  console.log(boxKvDot("Branch", branchDisplay, 14, border));
+  console.log(boxKvDot("GitHub", ghStatus, 14, border));
+  console.log(boxKvDot("Remote", remote, 14, border));
+
+  if (lastCommit && lastCommit.hash) {
+    const commitText = `${chalk.hex("#A78BFA").bold(lastCommit.hash)} ${chalk.hex("#CBD5E1")(truncateVisual(lastCommit.message || "", 26))} ${chalk.hex("#64748B")(`(${lastCommit.relativeTime || ""})`)}`;
+    console.log(boxKvDot("Latest commit", commitText, 14, border));
+  }
+
+  console.log(boxRow("", border));
+  console.log(boxBottom(border));
+}
+
+function formatRemoteLabel(url) {
+  const value = String(url || "").trim().replace(/\.git$/i, "");
+  const match = value.match(/(?:github\.com[:/])([^/]+\/[^/]+)$/i);
+  return match ? chalk.hex("#38BDF8")(match[1]) : chalk.hex("#CBD5E1")(value);
+}
+
+export function printPushProgress({ current, total = 6, title, completed = [] }) {
+  if (process.stdout.isTTY) process.stdout.write("\u001b[2J\u001b[H");
+  const nodes = Array.from({ length: total }, (_, index) => {
+    const n = index + 1;
+    if (n < current) return chalk.hex("#34D399")("●");
+    if (n === current) return chalk.hex("#38BDF8").bold("●");
+    return chalk.hex("#475569")("○");
+  });
+  const rail = nodes.join(chalk.hex("#334155")("──"));
+  const lead = `${chalk.hex("#38BDF8").bold("PUSH PROGRESS")}  ${rail}`;
+  const detail = chalk.hex("#94A3B8")(`[Step ${current}/${total} · ${title}]`);
+  console.log("");
+  if (stringWidth(`${lead}  ${detail}`) <= getW() - 2) console.log(`${lead}  ${detail}`);
+  else {
+    console.log(lead);
+    console.log(`  ${detail}`);
+  }
+  if (completed.length) {
+    console.log("");
+    for (const item of completed) {
+      console.log(
+        `  ${chalk.hex("#34D399")("✓")}  ${chalk.hex("#94A3B8")(item.label.padEnd(16))} ${chalk.hex("#334155")("·····")} ${chalk.hex("#F1F5F9")(truncateVisual(item.value, getW() - 28))}`,
+      );
+    }
+  }
+}
+
+/**
+ * Section heading with a color accent.
+ */
+export function printSection(title) {
+  const W = getW();
+  const marker = chalk.hex("#A78BFA").bold("■");
+  const maxTitle = Math.max(4, W - 12);
+  const fittedTitle = fitStyled(String(title || "").trim(), maxTitle);
+  const coreWidth = stringWidth(fittedTitle) + 4;
+  const remaining = Math.max(4, W - coreWidth);
+  const leftLen = Math.ceil(remaining / 2);
+  const rightLen = Math.floor(remaining / 2);
+  console.log("");
+  console.log(
+    chalk.hex("#334155")("─".repeat(leftLen) + " ") +
+    marker +
+    chalk.bold.hex("#E2E8F0")(` ${fittedTitle} `) +
+    chalk.hex("#334155")("─".repeat(rightLen)),
+  );
+}
+
+/**
+ * Step badge (for example, 1/6).
+ */
+export function stepLabel(current, total, text) {
+  const pill = chalk.bgHex("#2563EB").hex("#FFFFFF").bold(` ${current}/${total} `);
+  return `${pill} ${chalk.hex("#F1F5F9").bold(text)}`;
+}
+
+/**
+ * Summary panel displayed before pushing.
+ */
+export function printSummary({ repoUrl, commitMsg, dateDisplay, branch, force, sourceDir }) {
+  const border = chalk.hex("#38BDF8");
+  const title = chalk.bold.hex("#F8FAFC")(" REVIEW PUSH DETAILS ");
+  console.log("");
+  console.log(boxTop(title, border));
+  console.log(boxRow("", border));
+  if (sourceDir) console.log(boxKvDot("Source folder", chalk.hex("#F1F5F9")(sourceDir), 16, border));
+  console.log(boxKvDot("Repository", formatRemoteLabel(repoUrl), 16, border));
+  console.log(boxKvDot("Target branch", chalk.hex("#38BDF8").bold(branch), 16, border));
+  console.log(boxKvDot("Message", chalk.hex("#FDE047")(`"${commitMsg}"`), 16, border));
+  console.log(boxKvDot("Commit time", chalk.hex("#A78BFA")(dateDisplay), 16, border));
+  console.log(boxKvDot("Secret scan", chalk.hex("#34D399")("✓ Automatically checked before push"), 16, border));
+  if (force) {
+    console.log(boxRow("", border));
+    console.log(boxRow(chalk.hex("#F43F5E").bold("  [!] WARNING: Force push (--force) is enabled!"), border));
+  }
+  console.log(boxRow("", border));
+  console.log(boxBottom(border));
+}
+
+export function printTargetDir(dir = "") {
+  const W = getW();
+  console.log(
+    chalk.hex("#64748B")(
+      `  Folder: ${truncateVisual(String(dir || ""), W - 13)}`,
+    ),
+  );
+}
+
+/**
+ * Display the GitHub account profile card.
+ */
+export function printGitHubProfile(user, source = '') {
+  const border = chalk.hex("#4F46E5");
+  const title = chalk.bold.bgHex("#4F46E5").hex("#FFFFFF")(
+    " CONNECTED GITHUB ACCOUNT ",
+  );
+
+  console.log("");
+  console.log(boxTop(title, border));
+
+  console.log(
+    boxKvDot("Username", chalk.hex("#38BDF8").bold(`@${user.login}`), 16, border)
+  );
+  if (user.name) {
+    console.log(boxKvDot("Display name", chalk.hex("#F8FAFC")(user.name), 16, border));
+  }
+  if (user.email) {
+    console.log(boxKvDot("Email", chalk.hex("#94A3B8")(user.email), 16, border));
+  }
+  if (user.bio) {
+    console.log(boxKvDot("Bio", chalk.hex("#CBD5E1")(truncateVisual(user.bio, 40)), 16, border));
+  }
+
+  const repoStats = `${user.public_repos || 0} public  •  ${user.total_private_repos || 0} private`;
+  console.log(boxKvDot("Repositories", chalk.hex("#34D399").bold(repoStats), 16, border));
+
+  if (source) {
+    const srcDesc = source === 'gh-cli' ? 'GitHub CLI (gh)' : source === 'env' ? 'Environment variable' : 'Local config';
+    console.log(boxKvDot("Auth source", chalk.hex("#A78BFA")(srcDesc), 16, border));
+  }
+
+  console.log(boxDivider(border));
+  console.log(boxRow(chalk.hex("#64748B")(`» Profile: ${user.html_url}`), border));
+  console.log(boxBottom(border));
+  console.log("");
+}
+
+/**
+ * Display the GitHub Device Flow verification code.
+ */
+export function printDeviceCodePrompt({ userCode, verificationUri }) {
+  const border = chalk.hex("#6366F1");
+  const title = chalk.bold.bgHex("#4F46E5").hex("#FFFFFF")(
+    " GITHUB OAUTH / DEVICE FLOW ",
+  );
+
+  console.log("");
+  console.log(boxTop(title, border));
+  console.log(boxRow("", border));
+  console.log(boxRow(chalk.hex("#F8FAFC").bold("Step 1: Open this link in your browser:"), border));
+  console.log(boxRow(chalk.hex("#38BDF8").bold.underline(`  ${verificationUri}`), border));
+  console.log(boxRow("", border));
+  console.log(boxRow(chalk.hex("#F8FAFC").bold("Step 2: Enter this user code:"), border));
+
+  const codeBox = chalk.bgHex("#1E1B4B").hex("#A5B4FC").bold(`    >>>  ${userCode}  <<<    `);
+  console.log(boxRow(`  ${codeBox}`, border));
+  console.log(boxRow("", border));
+  console.log(boxRow(chalk.hex("#94A3B8")("» Your browser is opening automatically..."), border));
+  console.log(boxRow(chalk.hex("#64748B")("» Select Authorize in your browser to finish."), border));
+  console.log(boxBottom(border));
+  console.log("");
+}
+
+/**
+ * Display a success message after creating a GitHub repository.
+ */
+export function printRepoCreatedBox(repo) {
+  const border = chalk.hex("#059669");
+  const title = chalk.bold.bgHex("#10B981").hex("#064E3B")(
+    " GITHUB REPOSITORY CREATED ",
+  );
+
+  console.log("");
+  console.log(boxTop(title, border));
+  console.log(boxRow("", border));
+
+  const visibilityPill = repo.isPrivate
+    ? chalk.bgHex("#7F1D1D").hex("#FCA5A5").bold(" PRIVATE ")
+    : chalk.bgHex("#065F46").hex("#6EE7B7").bold(" PUBLIC ");
+
+  console.log(boxKvDot("Repository", chalk.hex("#F8FAFC").bold(repo.fullName || repo.name), 14, border));
+  console.log(boxKvDot("Visibility", visibilityPill, 14, border));
+  if (repo.description) {
+    console.log(boxKvDot("Description", chalk.hex("#CBD5E1")(truncateVisual(repo.description, 42)), 14, border));
+  }
+  console.log(boxKvDot("HTTPS Clone", chalk.hex("#38BDF8").underline(repo.cloneUrl), 14, border));
+  console.log(boxKvDot("SSH Clone", chalk.hex("#A78BFA")(repo.sshUrl), 14, border));
+
+  console.log(boxRow("", border));
+  console.log(boxDivider(border));
+  console.log(boxRow(chalk.hex("#6EE7B7")(`» View on GitHub: ${repo.htmlUrl}`), border));
+  console.log(boxBottom(border));
+  console.log("");
+}
+
+/**
+ * Warn when a folder is nested inside a parent repository.
+ */
+export function printNestedRepoWarning({ targetDir = "", topLevel = "" } = {}) {
+  const border = chalk.hex("#D97706");
+  const title = chalk.bold.bgHex("#D97706").hex("#FFFFFF")(
+    " FOLDER INSIDE A PARENT REPOSITORY ",
+  );
+
+  console.log("");
+  console.log(boxTop(title, border));
+  console.log(
+    boxRow(
+      chalk.hex("#FDE047")(
+        "The source folder is inside the parent Git repository:",
+      ),
+      border,
+    ),
+  );
+  console.log(boxKvDot("  +- CHA", chalk.hex("#F8FAFC")(topLevel), 10, border));
+  console.log(
+    boxKvDot("  +- CON", chalk.hex("#F8FAFC")(targetDir), 10, border),
+  );
+  console.log(boxRow("", border));
+  console.log(
+    boxRow(
+      chalk.hex("#94A3B8")(
+        "Pushing may include the parent folder's history and files.",
+      ),
+      border,
+    ),
+  );
+  console.log(
+    boxRow(
+      chalk.hex("#34D399")(
+        "Tip: Create a SEPARATE repository to push only this folder.",
+      ),
+      border,
+    ),
+  );
+  console.log(boxBottom(border));
+}
+
+/**
+ * Warn about sensitive secrets.
+ */
+export function printPrePushSecretWarning({ riskyFiles = [], findings = [] }) {
+  const border = chalk.hex("#D97706");
+  const title = chalk.bold.bgHex("#D97706").hex("#FFFFFF")(
+    " SENSITIVE DATA DETECTED ",
+  );
+
+  console.log("");
+  console.log(boxTop(title, border));
+  console.log(
+    boxRow(
+      chalk.hex("#FDE047")(
+        "GitHub may block the push if it detects a secret (GH013)",
+      ),
+      border,
+    ),
+  );
+  console.log(boxRow("", border));
+
+  const W2 = getW();
+  const maxFileW = Math.max(10, W2 - 14);
+  const maxLocW = Math.max(10, W2 - 24);
+  const maxPrevW = Math.max(10, W2 - 18);
+
+  if (riskyFiles.length > 0) {
+    console.log(
+      boxRow(chalk.bold.hex("#F8FAFC")("Sensitive files:"), border),
+    );
+    const showFiles = riskyFiles.slice(0, 4);
+    showFiles.forEach((f) => {
+      const tree = chalk.hex("#64748B")("  +- ");
+      console.log(
+        boxRow(tree + chalk.hex("#FCD34D")(truncateVisual(f, maxFileW)), border),
+      );
+    });
+    if (riskyFiles.length > 4) {
+      console.log(
+        boxRow(
+          chalk.hex("#64748B")(`  +- ...and ${riskyFiles.length - 4} more file(s)`),
+          border,
+        ),
+      );
+    }
+  }
+
+  if (findings.length > 0) {
+    if (riskyFiles.length > 0) console.log(boxRow("", border));
+    console.log(
+      boxRow(
+        chalk.bold.hex("#F8FAFC")("Possible secrets in source files:"),
+        border,
+      ),
+    );
+    const showFindings = findings.slice(0, 4);
+    showFindings.forEach((f, idx) => {
+      const isLast = idx === showFindings.length - 1;
+      const tree = chalk.hex("#64748B")("  +- ");
+      const loc = truncateVisual(`${f.file}:${f.line}`, maxLocW);
+      console.log(
+        boxRow(
+          tree +
+            chalk.hex("#F8FAFC")(loc) +
+            chalk.hex("#94A3B8")(` [${f.type}]`),
+          border,
+        ),
+      );
+      if (f.preview) {
+        const indent = chalk.hex("#64748B")(isLast ? "      " : "  |   ");
+        console.log(
+          boxRow(
+            indent + chalk.hex("#64748B")(`"${truncateVisual(f.preview, maxPrevW)}"`),
+            border,
+          ),
+        );
+      }
+    });
+    if (findings.length > 4) {
+      console.log(
+        boxRow(
+          chalk.hex("#64748B")(`  +- ...and ${findings.length - 4} more location(s)`),
+          border,
+        ),
+      );
+    }
+  }
+
+  console.log(boxRow("", border));
+  console.log(
+    boxRow(
+      chalk.hex("#34D399")(
+        'Tip: Choose "Auto-fix" to safely unstage files and update .gitignore',
+      ),
+      border,
+    ),
+  );
+  console.log(boxBottom(border));
+}
+
+/**
+ * Warn when GitHub Push Protection blocks a push (GH013).
+ */
+export function printSecretBlockedBox(rawMessage, details = {}) {
+  const border = chalk.hex("#E11D48");
+  const files = details.files || [];
+  const types = details.secretTypes || [];
+  const title = chalk.bold.bgHex("#E11D48").hex("#FFFFFF")(
+    " PUSH BLOCKED — SECRET DETECTED (GH013) ",
+  );
+
+  console.log("");
+  console.log(boxTop(title, border));
+  console.log(
+    boxRow(
+      chalk.hex("#FDA4AF")(
+        "GitHub Push Protection blocked the push because it detected a secret.",
+      ),
+      border,
+    ),
+  );
+  console.log(boxRow("", border));
+
+  if (types.length > 0) {
+    console.log(
+      boxKvDot(
+        "Secret type",
+        chalk.hex("#F8FAFC").bold(types.slice(0, 2).join(", ")),
+        14,
+        border,
+      ),
+    );
+  }
+  if (files.length > 0) {
+    files.slice(0, 2).forEach((f) => {
+      console.log(
+        boxKvDot("Source file", chalk.hex("#FCD34D")(f), 14, border),
+      );
+    });
+  }
+
+  console.log(boxRow("", border));
+  console.log(
+    boxRow(chalk.bold.hex("#F8FAFC")("» How to resolve this:"), border),
+  );
+  console.log(
+    boxRow(
+      chalk.hex("#E2E8F0")("  [1] Revoke the key immediately if it is real"),
+      border,
+    ),
+  );
+  console.log(
+    boxRow(
+      chalk.hex("#38BDF8")(
+        "  [2] Use this tool to unstage files and squash the commits",
+      ),
+      border,
+    ),
+  );
+  console.log(
+    boxRow(
+      chalk.hex("#94A3B8")(
+        "  [3] Remove the secret from source code and use an environment variable (process.env)",
+      ),
+      border,
+    ),
+  );
+
+  console.log(boxBottom(border));
+
+  if (details.unblockUrl) {
+    console.log(
+      chalk.hex("#F59E0B")(
+        `\n  » Temporary unblock URL (for test credentials only):\n  ${chalk.underline(details.unblockUrl)}`,
+      ),
+    );
+  }
+  console.log(
+    chalk.hex("#64748B")(
+      `\n  » GitHub documentation: ${details.resolveUrl || "https://docs.github.com/code-security/secret-scanning/pushing-a-branch-blocked-by-push-protection"}\n`,
+    ),
+  );
+}
+
+/**
+ * Success card displayed after a push.
+ */
+/**
+ * Success card displayed after a push.
+ */
+export function printSuccessBox({
+  branch,
+  repoUrl,
+  durationSeconds = null,
+  secretStatus = "Scanned (no risks)",
+}) {
+  const border = chalk.hex("#10B981");
+  const title = chalk.bold.hex("#F8FAFC")(" PUSH SUCCEEDED ");
+  console.log("");
+  console.log(boxTop(title, border));
+  console.log(boxRow("", border));
+  console.log(boxKvDot("Target branch", chalk.hex("#34D399").bold(branch), 18, border));
+  console.log(boxKvDot("Secret scan", chalk.hex("#38BDF8")(secretStatus), 18, border));
+  if (durationSeconds !== null) {
+    console.log(
+      boxKvDot(
+        "Duration",
+        chalk.hex("#FBBF24").bold(`${durationSeconds.toFixed(1)}s`),
+        18,
+        border,
+      ),
+    );
+  }
+  const webUrl = toGitHubWebUrl(repoUrl);
+  if (webUrl) {
+    console.log(boxRow("", border));
+    console.log(boxDivider(border));
+    console.log(
+      boxRow(
+        `${chalk.hex("#34D399")("» View on GitHub:")} ${chalk.hex("#38BDF8").underline(webUrl)}`,
+        border,
+      ),
+    );
+  } else {
+    console.log(boxKvDot("Remote", chalk.hex("#CBD5E1")(truncateVisual(repoUrl, getW() - 14)), 18, border));
+  }
+  console.log(boxRow("", border));
+  console.log(boxBottom(border));
+  console.log("");
+}
+
+function toGitHubWebUrl(url) {
+  const match = String(url || "").trim().match(/(?:https?:\/\/github\.com\/|git@github\.com:|ssh:\/\/git@github\.com\/)([^/]+\/[^/]+?)(?:\.git)?$/i);
+  return match ? `https://github.com/${match[1]}` : null;
+}
+
+export function printCancelled() {
+  const border = chalk.hex("#64748B");
+  const title = chalk.bold.hex("#F8FAFC")(
+    " OPERATION CANCELLED ",
+  );
+  console.log("");
+  console.log(boxTop(title, border));
+  console.log(boxRow("", border));
+  console.log(
+    boxRow(
+      chalk.hex("#94A3B8")(
+        "The operation was safely stopped. No changes were made.",
+      ),
+      border,
+    ),
+  );
+  console.log(boxRow("", border));
+  console.log(boxBottom(border));
+  console.log("");
+}
+
+export function printErrorBox(title = "AN ERROR OCCURRED", lines = [], hint = "") {
+  const W = getW();
+  const border = chalk.hex("#E11D48");
+  const cleanTitle = String(title || "").toUpperCase();
+  const titleStyled = chalk.bold.bgHex("#E11D48").hex("#FFFFFF")(` [ERROR] ${cleanTitle} `);
+  const rows = Array.isArray(lines) ? lines : [String(lines || "")];
+
+  console.log("");
+  console.log(boxTop(titleStyled, border));
+  rows.forEach((l) => {
+    if (!l) {
+      console.log(boxRow("", border));
+    } else {
+      console.log(
+        boxRow(chalk.hex("#FDA4AF")(truncateVisual(String(l), W - 4)), border),
+      );
+    }
+  });
+  if (hint) {
+    console.log(boxRow("", border));
+    console.log(
+      boxRow(chalk.hex("#38BDF8")(`» ${truncateVisual(hint, W - 6)}`), border),
+    );
+  }
+  console.log(boxBottom(border));
+  console.log("");
+}
+
+export function printGitMissing() {
+  printErrorBox(
+    "GIT IS NOT INSTALLED",
+    [
+      "Git was not found on this system.",
+      "Download and install Git to continue.",
+    ],
+    "Download it at: https://git-scm.com/downloads",
+  );
+}
+
+export function printAuthFailedBox(message = "") {
+  const border = chalk.hex("#E11D48");
+  const title = chalk.bold.bgHex("#E11D48").hex("#FFFFFF")(
+    " GIT AUTHENTICATION FAILED ",
+  );
+  const firstLine = String(message || "")
+    .split("\n")[0]
+    .slice(0, 120);
+
+  console.log("");
+  console.log(boxTop(title, border));
+  console.log(
+    boxRow(
+      chalk.hex("#FDA4AF")(
+        "Could not authenticate with the remote. Check your access permissions.",
+      ),
+      border,
+    ),
+  );
+  if (firstLine)
+    console.log(
+      boxRow(
+        chalk.hex("#64748B")(truncateVisual(firstLine, getW() - 4)),
+        border,
+      ),
+    );
+  console.log(boxRow("", border));
+  console.log(
+    boxRow(chalk.bold.hex("#F8FAFC")("» Quick fixes:"), border),
+  );
+  console.log(
+    boxRow(
+      chalk.hex("#E2E8F0")("  [1] Use the GITHUB menu to connect your account"),
+      border,
+    ),
+  );
+  console.log(
+    boxRow(
+      chalk.hex("#E2E8F0")("  [2] Use GitHub CLI: gh auth login"),
+      border,
+    ),
+  );
+  console.log(
+    boxRow(
+      chalk.hex("#94A3B8")("  [3] Use an SSH URL: git@github.com:user/repo.git"),
+      border,
+    ),
+  );
+  console.log(boxBottom(border));
+  console.log("");
+}
+
+export function printNonFastForwardBox(message = "", branch = "main") {
+  const border = chalk.hex("#D97706");
+  const title = chalk.bold.bgHex("#D97706").hex("#FFFFFF")(
+    " REMOTE HAS NEWER COMMITS ",
+  );
+  const firstLine = String(message || "")
+    .split("\n")[0]
+    .slice(0, 120);
+
+  console.log("");
+  console.log(boxTop(title, border));
+  console.log(
+    boxRow(
+      chalk.hex("#FDE68A")(
+        "The remote repository has commits that are newer than your local branch.",
+      ),
+      border,
+    ),
+  );
+  if (firstLine)
+    console.log(
+      boxRow(
+        chalk.hex("#64748B")(truncateVisual(firstLine, getW() - 4)),
+        border,
+      ),
+    );
+  console.log(boxRow("", border));
+  console.log(
+    boxRow(
+      chalk.hex("#38BDF8")(
+        `  » Choose Pull (rebase), then push again from this tool.`,
+      ),
+      border,
+    ),
+  );
+  console.log(
+    boxRow(
+      chalk.hex("#94A3B8")(
+        "     Use --force only when you are certain you want to overwrite the remote.",
+      ),
+      border,
+    ),
+  );
+  console.log(boxBottom(border));
+  console.log("");
+}
+
+export function printFixResult({
+  fixed = [],
+  gitignoreAdded = [],
+  codeFilesWithSecrets = [],
+  failed = [],
+} = {}) {
+  const W = getW();
+  const border = chalk.hex("#10B981");
+  const title = chalk.bold.hex("#F8FAFC")(" SECRET PROTECTION RESULTS ");
+
+  console.log("");
+  console.log(boxTop(title, border));
+  console.log(boxRow("", border));
+
+  if (fixed.length > 0) {
+    console.log(
+      boxRow(
+        `${chalk.hex("#34D399").bold("[OK] Removed from commit:")} ${chalk.hex("#F1F5F9")(truncateVisual(fixed.join(", "), W - 28))}`,
+        border,
+      ),
+    );
+  }
+  if (gitignoreAdded.length > 0) {
+    console.log(
+      boxRow(
+        `${chalk.hex("#38BDF8").bold("[+]  Added to .gitignore:")} ${chalk.hex("#CBD5E1")(truncateVisual(gitignoreAdded.join(", "), W - 30))}`,
+        border,
+      ),
+    );
+  }
+  if (codeFilesWithSecrets && codeFilesWithSecrets.length > 0) {
+    console.log(boxRow("", border));
+    console.log(
+      boxRow(
+        chalk.hex("#FBBF24").bold("[!]  Source files containing secrets (unstaged, not ignored):"),
+        border,
+      ),
+    );
+    codeFilesWithSecrets.forEach((f) =>
+      console.log(boxRow(`     - ${chalk.hex("#CBD5E1")(truncateVisual(f, W - 10))}`, border)),
+    );
+    console.log(
+      boxRow(chalk.hex("#94A3B8")("     » Remove the key from the file and use process.env instead."), border),
+    );
+  }
+  if (failed.length > 0) {
+    console.log(boxRow("", border));
+    failed.forEach((f) =>
+      console.log(boxRow(chalk.hex("#F43F5E")(`  [x] ${f.file}: ${f.reason}`), border)),
+    );
+  }
+
+  console.log(boxRow("", border));
+  console.log(boxBottom(border));
+  console.log("");
+}
+
+export function printFooter() {
+  const W = getW();
+  // Full-width divider, aligned like the other frames.
+  const core = "»";
+  const remaining = Math.max(4, W - 3); // 1 core + 2 space
+  const leftLen = Math.ceil(remaining / 2);
+  const rightLen = Math.floor(remaining / 2);
+  console.log(
+    chalk.hex("#334155")("─".repeat(leftLen) + " ") +
+    chalk.hex("#64748B")(core) +
+    chalk.hex("#334155")(" " + "─".repeat(rightLen))
+  );
+  const tip1 =
+    chalk.hex("#64748B")("» Tip: Run ") +
+    chalk.hex("#38BDF8").bold("git-push-time --help") +
+    chalk.hex("#64748B")(" to see all commands.");
+  const tip2 = chalk.hex("#475569")("» Git & GitHub workspace — Happy coding!");
+  for (const tip of [tip1, tip2]) {
+    const w = stringWidth(tip);
+    if (w >= W) {
+      console.log(`  ${tip}`);
+    } else {
+      const padTotal = W - w;
+      const left = Math.floor(padTotal / 2);
+      console.log(" ".repeat(left) + tip);
+    }
+  }
+  console.log("");
+}
+
+export function styleCliHelp(program) {
+  program.configureHelp({
+    styleTitle: (t) => chalk.bold.hex("#38BDF8")(t),
+    styleCommandText: (t) => chalk.hex("#F8FAFC")(t),
+    styleOptionText: (t) => chalk.hex("#34D399")(t),
+    styleArgumentText: (t) => chalk.hex("#FBBF24")(t),
+    styleDescriptionText: (t) => chalk.hex("#94A3B8")(t),
+  });
+  program.addHelpText(
+    "after",
+    `
+${chalk.hex("#334155")("─── » Common examples ───")}
+  ${chalk.hex("#34D399")("$")} ${chalk.white('git-push-time')}                           # Open the interactive dashboard
+  ${chalk.hex("#34D399")("$")} ${chalk.white('git-push-time github create')}            # Create a GitHub repository
+  ${chalk.hex("#34D399")("$")} ${chalk.white('git-push-time -r <repo-url> -d "-2d" -y')} # Push with a commit date two days ago
+  ${chalk.hex("#34D399")("$")} ${chalk.white('git-push-time fix')}                      # Scan for and remove staged secrets
+  ${chalk.hex("#34D399")("$")} ${chalk.white('git-push-time pull')}                     # Pull the latest changes
+`,
+  );
+}