pan-stack-cli 0.2.1 → 0.2.2

package/lib/git/git-checkout.js

@@ -1,395 +0,0 @@
-#!/usr/bin/env node
-/*
- * Checkout a branch across PAN Stack workspace + child repos.
- *
- * Reads repos from .project.yaml (same source as other pan git commands).
- * Interactive multi-select picker when running in a TTY without an explicit
- * selection. Non-interactive selection: pass "all", a single repo name, or a
- * comma/space-separated list of repo names.
- *
- * Modes:
- *   pan checkout <branch>             switch to existing branch (local or origin/*)
- *   pan checkout -b <branch>          create new branch (fails if it already exists)
- *   pan checkout -B <branch>          create OR reset (git checkout -B)
- *   pan checkout -b <branch> --start-point <ref>
- *                                     base new branch on <ref> (e.g. origin/main)
- *
- * Does NOT push — commit + `pan push` yourself afterwards.
- */
-
-const fs = require("fs");
-const path = require("path");
-const {
-  looksLikeManifest,
-  loadManifestRepos,
-  printCommonOptions,
-} = require("./helpers/cli");
-const colors = require("./helpers/colors");
-const { resolveMultiTargets } = require("./helpers/repo-select");
-const {
-  runGitCapture,
-  getCurrentBranch,
-  refExists,
-  countDirtyFiles,
-} = require("./helpers/git");
-const { t } = require("../i18n");
-
-const ICON = {
-  ok: "✓",
-  exists: "=",
-  warn: "!",
-  skip: "-",
-  err: "✗",
-};
-
-function printHelp() {
-  console.log(`usage: pan checkout [-b|-B] <branch> [repo|all|list] [options]   (alias: pan co)
-
-Chuyển/tạo nhánh trên workspace + các repo trong .project.yaml.
-Interactive multi-select khi chạy trong TTY và không truyền lựa chọn.
-
-positional:
-  branch             Tên nhánh (bắt buộc). Vd: feat/#1234, main, develop.
-  repo|all|<list>    Repo áp dụng: tên repo trong .project.yaml, "all",
-                     hoặc danh sách phân tách bởi phẩy/space.
-
-flags:
-  -b                 Tạo nhánh mới (git checkout -b). Fail nếu đã tồn tại.
-  -B                 Tạo hoặc reset nhánh (git checkout -B).
-  --start-point REF  Base ref cho -b/-B (default: HEAD hiện tại).
-
-${printCommonOptions()}
-  --no-workspace     Bỏ qua workspace root (chỉ repo con)
-
-examples:
-  pan checkout main                              # switch tất cả sang main (tương tác chọn repo)
-  pan checkout -b feat/#1234                     # tạo nhánh mới (tương tác chọn repo)
-  pan co -b feat/#1234 all                       # tạo trên tất cả repo
-  pan co -b feat/#1234 csdl-cc-backend,csdl-cc-b-frontend
-  pan co -B hotfix/x --start-point origin/main   # reset hotfix/x từ origin/main
-  pan checkout develop csdl-cc-backend           # switch một repo
-
-Kết quả:
-  ✓  = đã chuyển / tạo · =  = đã ở nhánh sẵn · !  = cảnh báo (đã tồn tại)
-  -  = skip · ✗  = lỗi (dirty tree, không tồn tại, v.v.)`);
-}
-
-function parseCheckoutArgs(argv) {
-  const args = {
-    help: false,
-    manifest: "",
-    baseDir: ".",
-    dryRun: false,
-    noWorkspace: false,
-    create: false,
-    forceCreate: false,
-    startPoint: "",
-    branch: "",
-    selection: "",
-  };
-
-  const positional = [];
-  for (let index = 0; index < argv.length; index += 1) {
-    const arg = argv[index];
-    if (arg === "-h" || arg === "--help") {
-      args.help = true;
-      continue;
-    }
-    if (arg === "-b") {
-      args.create = true;
-      continue;
-    }
-    if (arg === "-B") {
-      args.forceCreate = true;
-      continue;
-    }
-    if (arg === "--base-dir") {
-      args.baseDir = argv[++index] || ".";
-      continue;
-    }
-    if (arg === "--dry-run") {
-      args.dryRun = true;
-      continue;
-    }
-    if (arg === "--no-workspace") {
-      args.noWorkspace = true;
-      continue;
-    }
-    if (arg === "--start-point") {
-      args.startPoint = argv[++index] || "";
-      continue;
-    }
-    if (arg.startsWith("--start-point=")) {
-      args.startPoint = arg.slice("--start-point=".length);
-      continue;
-    }
-    if (arg.startsWith("-")) {
-      throw new Error(`Unexpected argument: ${arg}`);
-    }
-    if (looksLikeManifest(arg) && !args.manifest) {
-      args.manifest = arg;
-      continue;
-    }
-    positional.push(arg);
-  }
-
-  if (args.create && args.forceCreate) {
-    throw new Error(t("CHECKOUT_ERR_B_AND_BB"));
-  }
-  if (positional[0]) {
-    args.branch = positional[0];
-  }
-  if (positional.length > 1) {
-    args.selection = positional.slice(1).join(" ");
-  }
-  if (args.startPoint && !args.create && !args.forceCreate) {
-    throw new Error(t("CHECKOUT_ERR_STARTPOINT"));
-  }
-
-  return args;
-}
-
-function truncate(text, max) {
-  const clean = String(text || "").replace(/\s+/g, " ").trim();
-  return clean.length > max ? `${clean.slice(0, max)}…` : clean;
-}
-
-function processRepo({
-  name,
-  destination,
-  branch,
-  create,
-  forceCreate,
-  startPoint,
-  dryRun,
-}) {
-  const record = { name, status: "", message: "" };
-
-  if (!fs.existsSync(path.join(destination, ".git"))) {
-    return { ...record, status: "skip", message: t("CHECKOUT_MSG_NOT_CLONED") };
-  }
-
-  const currentBranch = getCurrentBranch(destination);
-  const from = currentBranch || t("CHECKOUT_DETACHED");
-
-  const localExists = refExists(destination, `refs/heads/${branch}`);
-
-  if (currentBranch === branch && !forceCreate) {
-    return {
-      ...record,
-      status: "exists",
-      message: t("CHECKOUT_MSG_ON_BRANCH__BRANCH", { branch }),
-    };
-  }
-
-  if (create) {
-    if (localExists) {
-      return {
-        ...record,
-        status: "warn",
-        message: t("CHECKOUT_MSG_LOCAL_EXISTS__BRANCH", { branch }),
-      };
-    }
-    if (startPoint && !refExists(destination, startPoint)) {
-      return {
-        ...record,
-        status: "err",
-        message: t("CHECKOUT_MSG_STARTPOINT_MISSING__STARTPOINT", { startPoint }),
-      };
-    }
-  } else if (!forceCreate) {
-    const remoteExists = refExists(destination, `refs/remotes/origin/${branch}`);
-    if (!localExists && !remoteExists) {
-      return {
-        ...record,
-        status: "err",
-        message: t("CHECKOUT_MSG_NO_BRANCH__BRANCH", { branch }),
-      };
-    }
-  } else if (forceCreate) {
-    if (startPoint && !refExists(destination, startPoint)) {
-      return {
-        ...record,
-        status: "err",
-        message: t("CHECKOUT_MSG_STARTPOINT_MISSING__STARTPOINT", { startPoint }),
-      };
-    }
-  }
-
-  const gitArgs = ["checkout"];
-  if (forceCreate) {
-    gitArgs.push("-B", branch);
-  } else if (create) {
-    gitArgs.push("-b", branch);
-  } else {
-    gitArgs.push(branch);
-  }
-  if ((create || forceCreate) && startPoint) {
-    gitArgs.push(startPoint);
-  }
-
-  if (dryRun) {
-    return {
-      ...record,
-      status: "skip",
-      message: `[dry-run] git ${gitArgs.join(" ")}`,
-    };
-  }
-
-  const dirty = countDirtyFiles(destination);
-
-  const result = runGitCapture(gitArgs, { cwd: destination });
-  if (result.status !== 0) {
-    const raw = result.stderr || result.stdout || t("CHECKOUT_MSG_FAILED");
-    const message = truncate(raw, 240);
-    if (dirty > 0 && /would be overwritten|local changes/i.test(raw)) {
-      return {
-        ...record,
-        status: "err",
-        message: `${message}${t("CHECKOUT_MSG_DIRTY__DIRTY", { dirty })}`,
-      };
-    }
-    return { ...record, status: "err", message };
-  }
-
-  if (forceCreate) {
-    if (localExists) {
-      return {
-        ...record,
-        status: "ok",
-        message: t("CHECKOUT_MSG_RESET__BRANCH_FROM", { branch, from: startPoint || from }),
-      };
-    }
-    return {
-      ...record,
-      status: "ok",
-      message: t("CHECKOUT_MSG_CREATE__BRANCH_FROM", { branch, from: startPoint || from }),
-    };
-  }
-  if (create) {
-    return {
-      ...record,
-      status: "ok",
-      message: t("CHECKOUT_MSG_CREATE__BRANCH_FROM", { branch, from: startPoint || from }),
-    };
-  }
-  return { ...record, status: "ok", message: `${from} → ${branch}` };
-}
-
-function styleForStatus(status) {
-  switch (status) {
-    case "ok":
-      return { icon: ICON.ok, color: colors.green };
-    case "exists":
-      return { icon: ICON.exists, color: colors.cyan };
-    case "warn":
-      return { icon: ICON.warn, color: colors.yellow };
-    case "skip":
-      return { icon: ICON.skip, color: colors.dim };
-    case "err":
-      return { icon: ICON.err, color: colors.red };
-    default:
-      return { icon: "?", color: (text) => text };
-  }
-}
-
-function printSummary(results, { branch, mode }) {
-  const nameWidth = results.reduce(
-    (max, item) => Math.max(max, item.name.length),
-    0
-  );
-
-  console.log("");
-  console.log(colors.bold(t("CHECKOUT_RESULT_HEADER__MODE_BRANCH", { mode, branch })));
-  for (const result of results) {
-    const { icon, color } = styleForStatus(result.status);
-    const line = `${icon} ${result.name.padEnd(nameWidth)}  ${result.message}`;
-    console.log(color(line));
-  }
-
-  const ok = results.filter((r) => r.status === "ok").length;
-  const already = results.filter((r) => r.status === "exists").length;
-  const warned = results.filter((r) => r.status === "warn").length;
-  const skipped = results.filter((r) => r.status === "skip").length;
-  const errored = results.filter((r) => r.status === "err").length;
-
-  console.log("");
-  console.log(colors.dim(t("CHECKOUT_LEGEND")));
-  console.log(
-    colors.bold(
-      t("CHECKOUT_SUMMARY__OK_EXISTS_WARN_SKIP_ERR", {
-        ok, exists: already, warn: warned, skip: skipped, err: errored,
-      })
-    )
-  );
-}
-
-async function main() {
-  const args = parseCheckoutArgs(process.argv.slice(2));
-  if (args.help) {
-    printHelp();
-    return;
-  }
-
-  if (!args.branch) {
-    console.error(t("CHECKOUT_MISSING_BRANCH"));
-    console.error(t("CHECKOUT_MISSING_BRANCH_HELP"));
-    process.exit(1);
-  }
-
-  const mode = args.forceCreate ? "reset -B" : args.create ? "create -b" : "switch";
-
-  const { repos, workspaceRoot } = loadManifestRepos({
-    manifestPath: args.manifest,
-    baseDir: args.baseDir,
-  });
-
-  const targets = await resolveMultiTargets({
-    repos,
-    workspaceRoot,
-    includeWorkspace: !args.noWorkspace,
-    selection: args.selection,
-    action: t("CHECKOUT_SELECT_ACTION__MODE_BRANCH", { mode, branch: args.branch }),
-  });
-
-  const fromPart = args.startPoint
-    ? t("CHECKOUT_HEADER_FROM_SUFFIX__START", { start: args.startPoint })
-    : "";
-  console.log("");
-  console.log(
-    colors.bold(
-      t("CHECKOUT_HEADER__MODE_BRANCH_FROM_N", {
-        mode, branch: args.branch, fromPart, n: targets.length,
-      })
-    )
-  );
-  for (const target of targets) {
-    console.log(colors.dim(`  • ${target.name}  (${target.destination})`));
-  }
-
-  const results = [];
-  for (const target of targets) {
-    const result = processRepo({
-      name: target.name,
-      destination: target.destination,
-      branch: args.branch,
-      create: args.create,
-      forceCreate: args.forceCreate,
-      startPoint: args.startPoint,
-      dryRun: args.dryRun,
-    });
-    results.push(result);
-  }
-
-  printSummary(results, { branch: args.branch, mode });
-
-  const hasError = results.some(
-    (item) => item.status === "err" || item.status === "warn"
-  );
-  process.exit(hasError ? 1 : 0);
-}
-
-main().catch((error) => {
-  console.error(error.message);
-  process.exit(1);
-});

package/lib/git/git-clone.js

@@ -1,206 +0,0 @@
-#!/usr/bin/env node
-/*
- * Clone PAN Stack project repositories from a small clone manifest.
- * Compact summary table (giống pull/push/fetch): repo · result · note — KHÔNG in
- * [warn]/lỗi rời rạc theo từng repo, chỉ tổng hợp cuối (cloned · đã có sẵn · không
- * có quyền · không tìm thấy · lỗi khác).
- */
-
-const fs = require("fs");
-const path = require("path");
-const { spawnSync } = require("child_process");
-const { spawnOptions } = require("../platform");
-const { parseCommonArgs, loadManifestRepos, resolveProjectWorkspace, printCommonOptions } = require("./helpers/cli");
-const { looksLikeGitUrl, repoNameFromUrl, appendRepository } = require("./helpers/manifest");
-const { printSummary, statusBadge, bulkColumns } = require("./helpers/bulk-report");
-const colors = require("./helpers/colors");
-const { t } = require("../i18n");
-
-// Dòng lỗi ngắn gọn cho cột "note" — bỏ qua dòng tiến trình "Cloning into '<path dài>'..." (luôn
-// là dòng đầu của git clone, không có ý nghĩa), ưu tiên dòng thật (fatal:/remote:).
-function shortCloneError(stderr) {
-  const lines = stderr.split("\n").map((l) => l.trim()).filter(Boolean);
-  const meaningful = lines.find((l) => /^(fatal:|remote:|error:)/i.test(l)) || lines[lines.length - 1] || lines[0] || "";
-  return meaningful.slice(0, 100);
-}
-
-// Phân loại lỗi clone từ stderr — KHÔNG in message thô cho user, chỉ dùng để chọn nhãn tổng hợp.
-function classifyCloneError(stderr) {
-  if (/permission denied|authentication failed|access denied|403|could not read username|invalid username or password/i.test(stderr)) {
-    return "no-access";
-  }
-  if (/repository .* not found|not found|does not exist|404/i.test(stderr)) {
-    return "not-found";
-  }
-  return "failed";
-}
-
-function cloneRepo({ name, url, destination, dryRun }) {
-  if (fs.existsSync(destination)) {
-    return { name, exists: true };
-  }
-
-  if (dryRun) {
-    console.log(colors.dim(`[dry-run] git clone ${url} ${destination}`));
-    return { name, dryRun: true };
-  }
-
-  fs.mkdirSync(path.dirname(destination), { recursive: true });
-  process.stdout.write(colors.dim(`  ⇩ ${name} ... `));
-  const result = spawnSync("git", ["clone", url, destination], spawnOptions({ encoding: "utf8" }));
-  const ok = result.status === 0;
-  const stderr = (result.stderr || "").trim();
-  const category = ok ? "ok" : classifyCloneError(stderr);
-  const shortMsg = ok ? t("CLONE_STATUS_CLONED")
-    : category === "no-access" ? t("CLONE_STATUS_NO_ACCESS")
-    : category === "not-found" ? t("CLONE_STATUS_NOT_FOUND")
-    : t("BULK_STATUS_FAILED");
-  console.log((ok ? colors.green : category === "no-access" ? colors.yellow : colors.red)(shortMsg));
-
-  return {
-    name,
-    status: result.status,
-    category,
-    error: !ok ? shortCloneError(stderr) : "",
-  };
-}
-
-function row(r) {
-  if (r.dryRun) return { repo: r.name, result: colors.dim(t("BULK_STATUS_DRY_RUN")), note: "" };
-  if (r.exists) return { repo: r.name, result: statusBadge("skip", t("CLONE_STATUS_EXISTS")), note: "" };
-  if (!r.error) return { repo: r.name, result: statusBadge("ok", t("CLONE_STATUS_CLONED")), note: "" };
-  const label =
-    r.category === "no-access" ? t("CLONE_STATUS_NO_ACCESS")
-    : r.category === "not-found" ? t("CLONE_STATUS_NOT_FOUND")
-    : t("BULK_STATUS_FAILED");
-  const kind = r.category === "no-access" ? "warn" : "fail";
-  return { repo: r.name, result: statusBadge(kind, label), note: colors.dim(r.error) };
-}
-
-function printHelp() {
-  console.log(`usage: git-clone.js [--base-dir BASE_DIR] [--dry-run] [manifest]
-       git-clone.js <git-url> [--dry-run]
-
-Không tham số (hoặc [manifest]) → clone TẤT CẢ repo trong manifest (clone all).
-Có <git-url> (https://…, git@host:…, hoặc kết thúc .git) → tự tách tên dự án từ
-URL, THÊM 1 entry mới vào cuối 'repositories:' trong .project.yaml (path mặc
-định 'apps/<tên>'), rồi clone NGAY repo đó — tương tự 'git clone <url>' nhưng
-tiện hơn: repo được ghi lại vào manifest luôn, lần sau 'pan clone'/'pan pull'... tự
-thấy nó. Đã có tên đó trong manifest rồi → KHÔNG thêm trùng, dùng lại entry cũ.
-
-Prints a compact summary table (repo · result · note) — KHÔNG dừng ở lỗi đầu
-tiên, clone hết các repo rồi tổng hợp (đã có sẵn / không có quyền / không tìm
-thấy / lỗi khác) ở cuối.
-
-${printCommonOptions()}`);
-}
-
-function printCloneSummary(results, dryRun) {
-  const cloned = results.filter((r) => !r.dryRun && !r.exists && !r.error);
-  const exists = results.filter((r) => r.exists);
-  const noAccess = results.filter((r) => r.category === "no-access");
-  const notFound = results.filter((r) => r.category === "not-found");
-  const failed = results.filter((r) => r.error && r.category === "failed");
-  const rows = results.map(row);
-
-  const footer = [];
-  footer.push(colors.dim(t("CLONE_FOOTER_COUNTS__TOTAL_CLONED_EXISTS_NOACCESS_NOTFOUND_FAILED", {
-    total: results.length, cloned: cloned.length, exists: exists.length,
-    noAccess: noAccess.length, notFound: notFound.length, failed: failed.length,
-  })));
-  if (noAccess.length) {
-    footer.push("");
-    footer.push(colors.yellow(t("CLONE_NO_ACCESS_HEADER")));
-    for (const r of noAccess) footer.push(`  ${colors.cyan(r.name)}`);
-  }
-
-  if (!dryRun && results.every((r) => r.exists)) {
-    console.log("");
-    console.log(colors.bold(`─── ${t("CLONE_TITLE")} ───`));
-    console.log(colors.green(t("CLONE_ALL_EXIST__N", { n: results.length })));
-    for (const line of footer) console.log(line);
-  } else {
-    printSummary({
-      title: t("CLONE_TITLE"),
-      rows,
-      columns: bulkColumns([
-        { key: "repo", labelKey: "BULK_COL_REPO" },
-        { key: "result", labelKey: "BULK_COL_RESULT" },
-        { key: "note", labelKey: "BULK_COL_NOTE" },
-      ]),
-      footerLines: footer,
-    });
-  }
-
-  if (noAccess.length || notFound.length || failed.length) process.exitCode = 1;
-}
-
-// `pan clone <url>` — thêm 1 repo mới vào .project.yaml (KHÔNG phải .project.local.yaml — repo
-// thêm qua đường này coi như chính thức, muốn giữ riêng thì tự thêm tay vào .project.local.yaml)
-// rồi clone ngay repo đó. Đã có tên trùng trong manifest (kể cả từ .project.local.yaml) → dùng
-// lại entry cũ, không thêm trùng.
-function runAddAndCloneOne(urlArg, { baseDirArg, dryRun }) {
-  const name = repoNameFromUrl(urlArg);
-  if (!name) {
-    throw new Error(`Không tách được tên dự án từ URL: ${urlArg}`);
-  }
-
-  const { manifestPath, baseDir } = resolveProjectWorkspace({ baseDir: baseDirArg || "." });
-  const { repos: existingRepos } = loadManifestRepos({ baseDir: baseDirArg, allowFallback: false });
-  const already = existingRepos.find((r) => r.name === name);
-
-  let url = urlArg;
-  let destination = path.resolve(baseDir, "apps", name);
-  if (already) {
-    console.log(colors.dim(`ℹ️  '${name}' đã có trong manifest — dùng entry hiện có (${already.url}).`));
-    url = already.url;
-    destination = already.destination;
-  } else {
-    const repoPath = `apps/${name}`;
-    if (dryRun) {
-      console.log(colors.dim(`[dry-run] + thêm '${name}' vào ${manifestPath} (url: ${urlArg}, path: ${repoPath})`));
-    } else {
-      appendRepository(manifestPath, { name, url: urlArg, path: repoPath });
-      console.log(colors.green(`✓ Đã thêm '${name}' vào ${manifestPath} (path: ${repoPath})`));
-    }
-  }
-
-  const result = cloneRepo({ name, url, destination, dryRun });
-  printCloneSummary([result], dryRun);
-}
-
-function main() {
-  const rawArgs = process.argv.slice(2);
-  if (rawArgs.includes("-h") || rawArgs.includes("--help")) {
-    printHelp();
-    return;
-  }
-
-  const dryRun = rawArgs.includes("--dry-run");
-  const baseDirIdx = rawArgs.indexOf("--base-dir");
-  const baseDirArg = baseDirIdx >= 0 ? rawArgs[baseDirIdx + 1] : "";
-  const urlArg = rawArgs.find((a, i) => !a.startsWith("--") && rawArgs[i - 1] !== "--base-dir" && looksLikeGitUrl(a));
-
-  if (urlArg) {
-    runAddAndCloneOne(urlArg, { baseDirArg, dryRun });
-    return;
-  }
-
-  const args = parseCommonArgs(rawArgs);
-
-  const { repos } = loadManifestRepos({
-    manifestPath: args.manifest,
-    baseDir: args.baseDir,
-    allowFallback: false,
-  });
-
-  const results = repos.map((r) => cloneRepo({ name: r.name, url: r.url, destination: r.destination, dryRun: args.dryRun }));
-  printCloneSummary(results, args.dryRun);
-}
-
-try {
-  main();
-} catch (error) {
-  console.error(error.message);
-  process.exit(1);
-}