pan-stack-cli 0.1.5 → 0.2.1

package/lib/git/helpers/repo-select.js

@@ -1,5 +1,32 @@
 const readline = require("readline");
 const { isGitRepo } = require("./git");
+const { helpTheme } = require("../../inquirer-theme");
+const { t } = require("../../i18n");
+const { menuSelect, menuCheckbox } = require("../../menu-prompt");
+
+// Lazy-load @inquirer/prompts (ESM) from CJS via dynamic import. Cached so
+// repeated pickers in one run reuse the same module. Returns null when the
+// dependency is missing (e.g. deps not installed) so callers can fall back to
+// the readline-based prompts.
+let inquirerModulePromise = null;
+async function loadInquirer() {
+  if (inquirerModulePromise === null) {
+    inquirerModulePromise = import("@inquirer/prompts").catch(() => null);
+  }
+  return inquirerModulePromise;
+}
+
+function isCancelError(err) {
+  if (!err) {
+    return false;
+  }
+  const name = String(err.name || "");
+  return (
+    name === "ExitPromptError" ||
+    name === "CancelPromptError" ||
+    /User force closed/i.test(String(err.message || ""))
+  );
+}
 
 function buildTargets({ repos, workspaceRoot, includeWorkspace }) {
   const targets = [];
@@ -28,7 +55,37 @@ function findTargetByName(targets, name) {
   return targets.filter((target) => target.name === needle);
 }
 
-function promptRepoChoice(targets) {
+function splitSelectionTokens(text) {
+  return String(text || "")
+    .split(/[\s,]+/)
+    .map((tok) => tok.trim())
+    .filter(Boolean);
+}
+
+function findTargetsByNames(targets, names) {
+  const seen = new Set();
+  const picked = [];
+  const missing = [];
+  for (const raw of names) {
+    const name = String(raw || "").trim();
+    if (!name) {
+      continue;
+    }
+    const match = targets.find((target) => target.name === name);
+    if (!match) {
+      missing.push(name);
+      continue;
+    }
+    if (seen.has(match.name)) {
+      continue;
+    }
+    seen.add(match.name);
+    picked.push(match);
+  }
+  return { picked, missing };
+}
+
+function promptRepoChoiceReadline(targets, message) {
   return new Promise((resolve, reject) => {
     const rl = readline.createInterface({
       input: process.stdin,
@@ -36,19 +93,23 @@ function promptRepoChoice(targets) {
     });
 
     console.log("");
-    console.log("Chọn repo để sync-main:");
-    console.log(`  1. all (${targets.length} repo)`);
+    console.log(message);
+    console.log(`  1. ${t("REPO_SELECT_ALL__N", { n: targets.length })}`);
     targets.forEach((target, index) => {
       console.log(`  ${index + 2}. ${target.label}`);
       console.log(`     ${target.destination}`);
     });
     console.log("");
 
-    rl.question("Nhập số (1 = all): ", (answer) => {
+    rl.question(t("REPO_SELECT_SINGLE_PROMPT"), (answer) => {
       rl.close();
       const choice = Number.parseInt(String(answer).trim(), 10);
-      if (!Number.isFinite(choice) || choice < 1 || choice > targets.length + 1) {
-        reject(new Error("Lựa chọn không hợp lệ."));
+      if (
+        !Number.isFinite(choice) ||
+        choice < 1 ||
+        choice > targets.length + 1
+      ) {
+        reject(new Error(t("REPO_SELECT_INVALID")));
         return;
       }
       if (choice === 1) {
@@ -60,15 +121,76 @@ function promptRepoChoice(targets) {
   });
 }
 
+const ALL_SENTINEL = "__all__";
+
+async function promptRepoChoice(targets, { message } = {}) {
+  const promptMsg = message || t("REPO_SELECT_PROMPT_MSG");
+  const choices = [
+    {
+      name: t("REPO_SELECT_ALL__N", { n: targets.length }),
+      value: ALL_SENTINEL,
+      short: "all",
+    },
+    ...targets.map((target) => ({
+      name: `${target.label}  ${dimHint(target.destination)}`,
+      value: target,
+      short: target.name,
+    })),
+  ];
+  const hotkeys = [{ key: "x", label: t("EXIT_LABEL"), value: "__exit__" }];
+
+  // Ưu tiên menu-prompt (phím x thoát ngay); thiếu @inquirer/core → @inquirer/prompts select
+  // với item thoát ẩn ở cuối; thiếu cả hai → readline thô (không hotkey, Ctrl+C để thoát).
+  try {
+    const picked = await menuSelect({ message: promptMsg, choices, pageSize: Math.min(Math.max(targets.length + 2, 8), 20), hotkeys });
+    if (picked === "__exit__") {
+      console.log(t("EXITED"));
+      process.exit(0);
+    }
+    return picked === ALL_SENTINEL ? targets.slice() : [picked];
+  } catch (err) {
+    if (String(err && err.message) !== "no-core") {
+      if (isCancelError(err)) throw new Error(t("REPO_SELECT_CANCELLED"));
+      throw err;
+    }
+  }
+
+  const inq = await loadInquirer();
+  if (!inq || typeof inq.select !== "function") {
+    return promptRepoChoiceReadline(targets, promptMsg);
+  }
+
+  try {
+    const picked = await inq.select({
+      message: promptMsg,
+      choices: [...choices, new inq.Separator(), { name: `x  ${t("EXIT_LABEL")}`, value: "__exit__", short: "x" }],
+      pageSize: Math.min(Math.max(targets.length + 2, 8), 20),
+      loop: false,
+      theme: helpTheme(false),
+    });
+    if (picked === "__exit__") {
+      console.log(t("EXITED"));
+      process.exit(0);
+    }
+    return picked === ALL_SENTINEL ? targets.slice() : [picked];
+  } catch (err) {
+    if (isCancelError(err)) {
+      throw new Error(t("REPO_SELECT_CANCELLED"));
+    }
+    throw err;
+  }
+}
+
 async function resolveTargets({
   repos,
   workspaceRoot,
   includeWorkspace,
   selection,
+  message,
 }) {
   const targets = buildTargets({ repos, workspaceRoot, includeWorkspace });
   if (targets.length === 0) {
-    throw new Error("Không có repo git nào để sync-main.");
+    throw new Error(t("REPO_SELECT_NO_REPO_SYNC"));
   }
 
   const picked = String(selection || "").trim();
@@ -79,19 +201,216 @@ async function resolveTargets({
     const matches = findTargetByName(targets, picked);
     if (matches.length === 0) {
       const names = targets.map((target) => target.name).join(", ");
-      throw new Error(`Repo '${picked}' không có trong manifest. Có: ${names}`);
+      throw new Error(
+        t("REPO_SELECT_ONE_MISSING__PICKED_ALL", { picked, all: names })
+      );
     }
     return matches;
   }
 
   if (process.stdin.isTTY) {
-    return promptRepoChoice(targets);
+    return promptRepoChoice(targets, { message: message || t("REPO_SELECT_SYNCMAIN_MSG") });
   }
 
   return targets;
 }
 
+function pickTargetsByIndices(targets, indices) {
+  const seen = new Set();
+  const picked = [];
+  for (const raw of indices) {
+    const num = Number.parseInt(String(raw).trim(), 10);
+    if (!Number.isFinite(num) || num < 1 || num > targets.length + 1) {
+      const err = new Error(t("REPO_SELECT_INVALID_INDEX__RAW", { raw }));
+      err.code = "INVALID_CHOICE";
+      throw err;
+    }
+    if (num === 1) {
+      return targets.slice();
+    }
+    const idx = num - 2;
+    if (seen.has(idx)) {
+      continue;
+    }
+    seen.add(idx);
+    picked.push(targets[idx]);
+  }
+  return picked;
+}
+
+function promptRepoChoiceMultiReadline(targets, { action } = {}) {
+  const actionLabel = action || t("REPO_SELECT_ACTION_CHOOSE");
+  return new Promise((resolve, reject) => {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+
+    console.log("");
+    console.log(
+      t("REPO_SELECT_MULTI_HELP__ACTION", { action: actionLabel })
+    );
+    console.log(`  1. ${t("REPO_SELECT_ALL__N", { n: targets.length })}`);
+    targets.forEach((target, index) => {
+      console.log(`  ${index + 2}. ${target.label}`);
+      console.log(`     ${target.destination}`);
+    });
+    console.log("");
+
+    rl.question(t("REPO_SELECT_MULTI_PROMPT"), (answer) => {
+      rl.close();
+      const raw = String(answer || "").trim();
+      if (!raw) {
+        reject(new Error(t("REPO_SELECT_EMPTY_ANSWER")));
+        return;
+      }
+      if (raw.toLowerCase() === "all") {
+        resolve(targets.slice());
+        return;
+      }
+      const tokens = splitSelectionTokens(raw);
+      if (tokens.length === 0) {
+        reject(new Error(t("REPO_SELECT_INVALID")));
+        return;
+      }
+      try {
+        const picked = pickTargetsByIndices(targets, tokens);
+        if (picked.length === 0) {
+          reject(new Error(t("REPO_SELECT_NONE_PICKED")));
+          return;
+        }
+        resolve(picked);
+      } catch (err) {
+        reject(err);
+      }
+    });
+  });
+}
+
+async function promptRepoChoiceMulti(targets, { action } = {}) {
+  const actionLabel = action || t("REPO_SELECT_ACTION_CHOOSE");
+  const choices = targets.map((target, i) => ({
+    name: `${target.label}  ${dimHint(target.destination)}`,
+    value: i,
+    short: target.name,
+  }));
+  const hotkeys = [{ key: "x", label: t("EXIT_LABEL"), value: "exit" }];
+
+  // Ưu tiên menu-prompt (menuCheckbox: có sẵn a=chọn tất cả, i=đảo chọn, x=thoát) — nhất quán
+  // với mọi nơi chọn-nhiều khác trong CLI; thiếu @inquirer/core → @inquirer/prompts checkbox
+  // (không có a/i, chỉ Enter/Space); thiếu cả hai → readline thô.
+  try {
+    const res = await menuCheckbox({
+      message: actionLabel,
+      choices,
+      hotkeys,
+      pageSize: Math.min(Math.max(targets.length + 2, 8), 20),
+    });
+    if (res.action === "exit") {
+      console.log(t("EXITED"));
+      process.exit(0);
+    }
+    const values = res.values || [];
+    if (values.length === 0) {
+      throw new Error(t("REPO_SELECT_NONE_PICKED"));
+    }
+    return values.map((i) => targets[i]);
+  } catch (err) {
+    if (String(err && err.message) !== "no-core") {
+      if (isCancelError(err)) throw new Error(t("REPO_SELECT_CANCELLED"));
+      throw err;
+    }
+  }
+
+  const inq = await loadInquirer();
+  if (!inq || typeof inq.checkbox !== "function") {
+    return promptRepoChoiceMultiReadline(targets, { action: actionLabel });
+  }
+
+  try {
+    const picked = await inq.checkbox({
+      message: actionLabel,
+      choices: targets.map((target) => ({
+        name: `${target.label}  ${dimHint(target.destination)}`,
+        value: target,
+        short: target.name,
+      })),
+      required: true,
+      pageSize: Math.min(Math.max(targets.length + 2, 8), 20),
+      theme: helpTheme(true),
+    });
+    if (!Array.isArray(picked) || picked.length === 0) {
+      throw new Error(t("REPO_SELECT_NONE_PICKED"));
+    }
+    return picked;
+  } catch (err) {
+    if (isCancelError(err)) {
+      throw new Error(t("REPO_SELECT_CANCELLED"));
+    }
+    throw err;
+  }
+}
+
+function dimHint(text) {
+  if (!process.stdout.isTTY || process.env.NO_COLOR) {
+    return `— ${text}`;
+  }
+  return `\u001b[2m— ${text}\u001b[0m`;
+}
+
+async function resolveMultiTargets({
+  repos,
+  workspaceRoot,
+  includeWorkspace,
+  selection,
+  action,
+}) {
+  const actionLabel = action || t("REPO_SELECT_ACTION_DEFAULT");
+  const targets = buildTargets({ repos, workspaceRoot, includeWorkspace });
+  if (targets.length === 0) {
+    throw new Error(t("REPO_SELECT_NO_REPO"));
+  }
+
+  const raw = String(selection || "").trim();
+  if (raw.toLowerCase() === "all") {
+    return targets.slice();
+  }
+  if (raw) {
+    const tokens = splitSelectionTokens(raw);
+    const allNumeric =
+      tokens.length > 0 && tokens.every((tok) => /^[0-9]+$/.test(tok));
+    if (allNumeric) {
+      const picked = pickTargetsByIndices(targets, tokens);
+      if (picked.length === 0) {
+        throw new Error(t("REPO_SELECT_NONE_PICKED"));
+      }
+      return picked;
+    }
+    const { picked, missing } = findTargetsByNames(targets, tokens);
+    if (missing.length > 0) {
+      const names = targets.map((target) => target.name).join(", ");
+      throw new Error(
+        t("REPO_SELECT_MISSING__MISSING_ALL", { missing: missing.join(", "), all: names })
+      );
+    }
+    if (picked.length === 0) {
+      throw new Error(t("REPO_SELECT_NONE_PICKED"));
+    }
+    return picked;
+  }
+
+  if (process.stdin.isTTY) {
+    return promptRepoChoiceMulti(targets, { action: actionLabel });
+  }
+
+  throw new Error(t("REPO_SELECT_NEED_NON_INTERACTIVE"));
+}
+
 module.exports = {
   buildTargets,
+  findTargetsByNames,
+  pickTargetsByIndices,
   resolveTargets,
+  resolveMultiTargets,
+  splitSelectionTokens,
 };

package/lib/git/helpers/repo-summary.js

@@ -0,0 +1,161 @@
+const colors = require("./colors");
+const { getCurrentBranch, runGitCapture, isMergeOrRebaseInProgress } = require("./git");
+const { t } = require("../../i18n");
+
+const ICON = {
+  ok: "✅",
+  warn: "⚠️",
+  info: "ℹ️",
+  skip: "⏭️",
+  up: "↑",
+  down: "↓",
+};
+
+function computeAheadBehind(directory) {
+  const up = runGitCapture(["rev-parse", "--abbrev-ref", "@{u}"], { cwd: directory });
+  if (up.status !== 0 || !up.stdout) return { hasUpstream: false, ahead: 0, behind: 0 };
+  const rl = runGitCapture(["rev-list", "--left-right", "--count", "HEAD...@{u}"], { cwd: directory });
+  if (rl.status !== 0) return { hasUpstream: true, ahead: 0, behind: 0 };
+  const [ahead, behind] = rl.stdout.split(/\s+/).map((n) => parseInt(n, 10) || 0);
+  return { hasUpstream: true, ahead, behind };
+}
+
+function getRepoStatusSummary(directory) {
+  const branch = getCurrentBranch(directory);
+  const result = runGitCapture(["status", "--porcelain"], { cwd: directory });
+  if (result.status !== 0) {
+    return {
+      branch,
+      error: result.stderr || "git status failed",
+      total: 0,
+      staged: 0,
+      unstaged: 0,
+      untracked: 0,
+      ahead: 0,
+      behind: 0,
+      hasUpstream: false,
+      inProgress: "",
+    };
+  }
+
+  const lines = result.stdout
+    .split(/\r?\n/)
+    .map((line) => line.trimEnd())
+    .filter(Boolean);
+
+  let staged = 0;
+  let unstaged = 0;
+  let untracked = 0;
+
+  for (const line of lines) {
+    const index = line[0];
+    const worktree = line[1];
+
+    if (index === "?" && worktree === "?") {
+      untracked += 1;
+      continue;
+    }
+
+    if (index !== " ") {
+      staged += 1;
+    }
+    if (worktree !== " ") {
+      unstaged += 1;
+    }
+  }
+
+  const { hasUpstream, ahead, behind } = computeAheadBehind(directory);
+
+  return {
+    branch,
+    total: lines.length,
+    staged,
+    unstaged,
+    untracked,
+    ahead,
+    behind,
+    hasUpstream,
+    inProgress: isMergeOrRebaseInProgress(directory), // "merge"|"rebase"|""
+  };
+}
+
+function formatFileBreakdown({ staged, unstaged, untracked }) {
+  const parts = [];
+  if (staged > 0) parts.push(t("BULK_BREAKDOWN_STAGED__N", { n: staged }));
+  if (unstaged > 0) parts.push(t("BULK_BREAKDOWN_UNSTAGED__N", { n: unstaged }));
+  if (untracked > 0) parts.push(t("BULK_BREAKDOWN_UNTRACKED__N", { n: untracked }));
+  return parts.join(" · ");
+}
+
+function formatSync(item) {
+  if (item.error) return colors.red(t("BULK_STATUS_ERROR"));
+  if (!item.hasUpstream) return colors.dim(t("BULK_STATUS_NO_UPSTREAM"));
+  if (item.behind === 0 && item.ahead === 0) return colors.green(t("BULK_STATUS_IN_SYNC"));
+  const parts = [];
+  if (item.behind) parts.push(colors.yellow(`${ICON.down} ${item.behind}`));
+  if (item.ahead) parts.push(colors.cyan(`${ICON.up} ${item.ahead}`));
+  return parts.join(" ");
+}
+
+function formatState(item) {
+  if (item.inProgress === "merge") return colors.red(t("BULK_STATUS_MERGING"));
+  if (item.inProgress === "rebase") return colors.red(t("BULK_STATUS_REBASING"));
+  if (item.error) return colors.red(t("BULK_STATUS_ERROR"));
+  if (item.total === 0) return colors.green(t("BULK_STATUS_CLEAN"));
+  const label = item.total === 1 ? t("BULK_FILES_ONE") : t("BULK_FILES_MANY");
+  return colors.yellow(`${item.total} ${label}`);
+}
+
+function printChangeSummary({ title, results, totalRepos }) {
+  const dirty = results.filter((item) => item.total > 0 || item.inProgress);
+  const errors = results.filter((item) => item.error);
+  const shown = results.filter((item) => item.total > 0 || item.inProgress || item.error);
+  const rows = shown.map((item) => ({
+    repo: item.error ? colors.red(item.name) : colors.cyan(item.name),
+    branch: item.branch || colors.dim(t("GST_DETACHED")),
+    state: formatState(item),
+    breakdown: item.total > 0 ? colors.dim(formatFileBreakdown(item)) : colors.dim("—"),
+    sync: formatSync(item),
+  }));
+
+  const totalFiles = dirty.reduce((sum, item) => sum + item.total, 0);
+  const cleanCount = totalRepos - dirty.length - errors.length;
+
+  console.log("");
+  console.log(colors.bold(`─── ${t("GST_TITLE")} ───`));
+  console.log(colors.dim(`${ICON.info} ${t("GST_FOOTER_COUNTS__TOTAL_DIRTY_FILES_CLEAN_ERRORS", {
+    total: totalRepos, dirty: dirty.length, files: totalFiles, clean: cleanCount, errors: errors.length,
+  })}`));
+
+  if (rows.length > 0) {
+    const { renderTable, bulkColumns } = require("./bulk-report");
+    console.log(renderTable(
+      bulkColumns([
+        { key: "repo", labelKey: "BULK_COL_REPO" },
+        { key: "branch", labelKey: "BULK_COL_BRANCH" },
+        { key: "state", labelKey: "BULK_COL_STATE" },
+        { key: "breakdown", labelKey: "BULK_COL_BREAKDOWN" },
+        { key: "sync", labelKey: "BULK_COL_SYNC" },
+      ]),
+      rows
+    ));
+  } else {
+    console.log("");
+    console.log(colors.green(t("GST_ALL_CLEAN__N", { n: totalRepos })));
+  }
+
+  if (errors.length > 0) {
+    console.log("");
+    console.log(colors.bold(colors.yellow(`${ICON.warn} ${t("GST_ERRORS_HEADER")}`)));
+    for (const item of errors) {
+      console.log(`  • ${item.name}: ${item.error}`);
+    }
+  }
+}
+
+module.exports = {
+  ICON,
+  getRepoStatusSummary,
+  formatFileBreakdown,
+  printChangeSummary,
+};

package/lib/i18n.js

@@ -0,0 +1,61 @@
+// Ngôn ngữ pan CLI: MẶC ĐỊNH 'en'. Ưu tiên `language:` trong .project.yaml gần nhất (walk-up từ cwd),
+// hoặc env PAN_LANG. Cache 1 lần/tiến trình.
+const fs = require("fs");
+const path = require("path");
+const MESSAGES = require("./messages");
+
+let cached = null;
+
+function detectLang() {
+  if (process.env.PAN_LANG) return String(process.env.PAN_LANG).toLowerCase();
+  let dir = process.cwd();
+  for (let i = 0; i < 50; i += 1) {
+    const p = path.join(dir, ".project.yaml");
+    try {
+      if (fs.existsSync(p)) {
+        const m = fs.readFileSync(p, "utf8").match(/^\s*language\s*:\s*['"]?([A-Za-z-]+)/m);
+        return m ? m[1].toLowerCase() : "en";
+      }
+    } catch {
+      /* bỏ qua */
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return "en";
+}
+
+function lang() {
+  if (cached === null) cached = detectLang();
+  return cached;
+}
+
+// Ghi đè cache trong tiến trình hiện tại (vd sau khi `pan language <code>` vừa ghi file) — để các
+// thông báo in ra ngay sau đó (cùng lệnh) dùng ngôn ngữ mới thay vì ngôn ngữ đã cache trước đó.
+function setLangOverride(code) {
+  cached = String(code).toLowerCase();
+}
+
+function availableLangs() {
+  return Object.keys(MESSAGES);
+}
+
+function interpolate(template, vars) {
+  if (!vars) return template;
+  return template.replace(/\{(\w+)\}/g, (match, name) => (name in vars ? String(vars[name]) : match));
+}
+
+/**
+ * t('SOME_KEY', { var1, var2 }) → chuỗi theo ngôn ngữ hiện tại, nội suy {var1}/{var2} trong template.
+ * Thêm ngôn ngữ mới: thêm object con trong messages.js — KHÔNG cần sửa call site nào.
+ * Thiếu key ở ngôn ngữ hiện tại → fallback 'en' → fallback chính key (không throw, luôn có gì đó để in ra).
+ */
+function t(key, vars) {
+  const currentLang = lang();
+  const dict = MESSAGES[currentLang] || MESSAGES.en;
+  const template = dict[key] ?? MESSAGES.en[key] ?? key;
+  return interpolate(template, vars);
+}
+
+module.exports = { lang, t, setLangOverride, availableLangs };

package/lib/inquirer-theme.js

@@ -0,0 +1,20 @@
+// Help-tip dùng chung cho @inquirer select/checkbox (repo-select, select, menu). MẶC ĐỊNH English;
+// 'vi' khi .project.yaml có `language: vi` (xem i18n.js).
+const { lang } = require("./i18n");
+
+const HELP = {
+  en: { multi: "↑↓ move · space select · a all · i invert · enter confirm", single: "↑↓ move · enter select" },
+  vi: { multi: "↑↓ di chuyển · space chọn · a tất cả · i đảo · Enter xác nhận", single: "↑↓ di chuyển · Enter chọn" },
+};
+
+function helpText(multi) {
+  const h = HELP[lang()] || HELP.en;
+  return multi ? h.multi : h.single;
+}
+
+// theme cho @inquirer: override keysHelpTip (nhận mảng [key,action]) → chuỗi help theo ngôn ngữ.
+function helpTheme(multi) {
+  return { style: { keysHelpTip: () => ` (${helpText(multi)})` } };
+}
+
+module.exports = { helpText, helpTheme };