pan-stack-cli 0.1.5 → 0.2.2

package/lib/git/git-pull.js

@@ -1,76 +0,0 @@
-#!/usr/bin/env node
-/*
- * Pull latest changes for PAN Stack project repositories from a clone manifest.
- *
- * Skips repositories that do not exist or are not git checkouts. Failures warn
- * and continue so one broken repo does not block the rest.
- */
-
-const { parseCommonArgs, loadManifestRepos, printCommonOptions } = require("./helpers/cli");
-const { ensureRepoExists, runGit } = require("./helpers/git");
-
-function pullRepo({ name, destination, dryRun, rebase }) {
-  if (!ensureRepoExists({ name, destination })) {
-    return;
-  }
-
-  const gitArgs = ["pull"];
-  if (rebase) {
-    gitArgs.push("--rebase");
-  }
-
-  const status = runGit(gitArgs, {
-    cwd: destination,
-    dryRun,
-    action: "pull",
-    name,
-  });
-  if (status !== 0) {
-    console.log(`[warn] ${name}: pull failed, check branch state or remote access`);
-  }
-}
-
-function printHelp() {
-  console.log(`usage: git-pull.js [--base-dir BASE_DIR] [--dry-run] [--rebase] [manifest]
-
-Pull latest changes for repositories listed in a PAN Stack clone manifest.
-
-${printCommonOptions()}
-  --rebase             Use git pull --rebase`);
-}
-
-function main() {
-  const args = parseCommonArgs(process.argv.slice(2), {
-    defaults: { rebase: false },
-    handlers: {
-      "--rebase": (parsed) => {
-        parsed.rebase = true;
-      },
-    },
-  });
-  if (args.help) {
-    printHelp();
-    return;
-  }
-
-  const { repos } = loadManifestRepos({
-    manifestPath: args.manifest,
-    baseDir: args.baseDir,
-  });
-
-  for (const repo of repos) {
-    pullRepo({
-      name: repo.name,
-      destination: repo.destination,
-      dryRun: args.dryRun,
-      rebase: args.rebase,
-    });
-  }
-}
-
-try {
-  main();
-} catch (error) {
-  console.error(error.message);
-  process.exit(1);
-}

package/lib/git/git-push.js

@@ -1,76 +0,0 @@
-#!/usr/bin/env node
-/*
- * Push local commits for PAN Stack project repositories from a clone manifest.
- *
- * Skips repositories that do not exist or are not git checkouts. Failures warn
- * and continue so one broken repo does not block the rest.
- */
-
-const { parseCommonArgs, loadManifestRepos, printCommonOptions } = require("./helpers/cli");
-const { ensureRepoExists, runGit } = require("./helpers/git");
-
-function pushRepo({ name, destination, dryRun, setUpstream }) {
-  if (!ensureRepoExists({ name, destination })) {
-    return;
-  }
-
-  const gitArgs = ["push"];
-  if (setUpstream) {
-    gitArgs.push("-u", "origin", "HEAD");
-  }
-
-  const status = runGit(gitArgs, {
-    cwd: destination,
-    dryRun,
-    action: "push",
-    name,
-  });
-  if (status !== 0) {
-    console.log(`[warn] ${name}: push failed, check branch state or remote access`);
-  }
-}
-
-function printHelp() {
-  console.log(`usage: git-push.js [--base-dir BASE_DIR] [--dry-run] [--set-upstream] [manifest]
-
-Push local commits for repositories listed in a PAN Stack clone manifest.
-
-${printCommonOptions()}
-  --set-upstream       Use git push -u origin HEAD for new branches`);
-}
-
-function main() {
-  const args = parseCommonArgs(process.argv.slice(2), {
-    defaults: { setUpstream: false },
-    handlers: {
-      "--set-upstream": (parsed) => {
-        parsed.setUpstream = true;
-      },
-    },
-  });
-  if (args.help) {
-    printHelp();
-    return;
-  }
-
-  const { repos } = loadManifestRepos({
-    manifestPath: args.manifest,
-    baseDir: args.baseDir,
-  });
-
-  for (const repo of repos) {
-    pushRepo({
-      name: repo.name,
-      destination: repo.destination,
-      dryRun: args.dryRun,
-      setUpstream: args.setUpstream,
-    });
-  }
-}
-
-try {
-  main();
-} catch (error) {
-  console.error(error.message);
-  process.exit(1);
-}

package/lib/git/git-sync-main.js

@@ -1,320 +0,0 @@
-#!/usr/bin/env node
-/*
- * Sync origin/main (or --ref) into the current branch for selected PAN Stack repos.
- *
- * Fetches first, then merge (default) or rebase (--rebase). Interactive repo picker
- * when TTY; pass repo name or "all" as first positional argument.
- */
-
-const {
-  looksLikeManifest,
-  loadManifestRepos,
-  printCommonOptions,
-} = require("./helpers/cli");
-const colors = require("./helpers/colors");
-const { resolveTargets } = require("./helpers/repo-select");
-const {
-  ensureRepoExists,
-  runGit,
-  runGitCapture,
-  getCurrentBranch,
-  refExists,
-  listConflictedFiles,
-  isMergeOrRebaseInProgress,
-  countDirtyFiles,
-} = require("./helpers/git");
-
-const ICON = {
-  ok: "✅",
-  warn: "⚠️",
-  conflict: "⛔",
-  skip: "⏭️",
-  info: "ℹ️",
-};
-
-function printHelp() {
-  console.log(`usage: pan sync-main [repo|all] [options]   (alias: pan sm)
-
-Fetch remote main (or --ref) and merge into the current branch for workspace and/or child repos.
-
-positional:
-  repo|all           Repo name from .project.yaml, or "all". Interactive picker if omitted (TTY).
-
-${printCommonOptions()}
-  --ref REF            Remote-tracking ref to merge (default: origin/main)
-  --rebase             Use git rebase instead of merge
-  --no-workspace       Only manifest child repos (skip workspace stack root)`);
-}
-
-function parseSyncMainArgs(argv) {
-  const args = {
-    help: false,
-    manifest: "",
-    baseDir: ".",
-    dryRun: false,
-    ref: "origin/main",
-    rebase: false,
-    noWorkspace: false,
-    selection: "",
-  };
-
-  for (let index = 0; index < argv.length; index += 1) {
-    const arg = argv[index];
-    if (arg === "-h" || arg === "--help") {
-      args.help = true;
-    } else if (arg === "--base-dir") {
-      args.baseDir = argv[++index] || ".";
-    } else if (arg === "--dry-run") {
-      args.dryRun = true;
-    } else if (arg === "--ref") {
-      args.ref = argv[++index] || "origin/main";
-    } else if (arg === "--rebase") {
-      args.rebase = true;
-    } else if (arg === "--no-workspace") {
-      args.noWorkspace = true;
-    } else if (!arg.startsWith("-")) {
-      if (looksLikeManifest(arg) && !args.manifest) {
-        args.manifest = arg;
-      } else if (!args.selection) {
-        args.selection = arg;
-      } else {
-        throw new Error(`Unexpected argument: ${arg}`);
-      }
-    } else {
-      throw new Error(`Unexpected argument: ${arg}`);
-    }
-  }
-
-  return args;
-}
-
-function printEarlyConflict({ name, branch, ref, files, mode }) {
-  const headline = colors.bold(
-    colors.red(`${ICON.conflict} [conflict] ${name} (${branch})`)
-  );
-  const detail = colors.yellow(
-    `${mode} ${ref} thất bại — ${files.length} file conflict`
-  );
-  console.log(`${headline} — ${detail}`);
-  for (const file of files.slice(0, 8)) {
-    console.log(colors.dim(`    • ${file}`));
-  }
-  if (files.length > 8) {
-    console.log(colors.dim(`    … và ${files.length - 8} file khác`));
-  }
-}
-
-function syncMainRepo({
-  name,
-  destination,
-  dryRun,
-  ref,
-  rebase,
-}) {
-  const result = {
-    name,
-    destination,
-    branch: "",
-    status: "skipped",
-    message: "",
-    conflictFiles: [],
-    mode: rebase ? "rebase" : "merge",
-  };
-
-  if (!ensureRepoExists({ name, destination })) {
-    result.message = "repo không tồn tại hoặc chưa clone";
-    return result;
-  }
-
-  const branch = getCurrentBranch(destination);
-  result.branch = branch || "(detached HEAD)";
-  if (!branch) {
-    result.message = "đang detached HEAD — bỏ qua";
-    console.log(`${ICON.skip} [skip] ${name}: ${result.message}`);
-    return result;
-  }
-
-  const inProgress = isMergeOrRebaseInProgress(destination);
-  if (inProgress) {
-    const files = listConflictedFiles(destination);
-    result.status = "conflict";
-    result.conflictFiles = files;
-    result.message = `đang dở ${inProgress} — cần resolve trước`;
-    printEarlyConflict({ name, branch, ref, files, mode: inProgress });
-    return result;
-  }
-
-  const dirtyCount = countDirtyFiles(destination);
-  if (dirtyCount > 0) {
-    console.log(
-      `${ICON.warn} ${colors.yellow(`[warn] ${name}: working tree có ${dirtyCount} thay đổi chưa commit`)}`
-    );
-  }
-
-  if (dryRun) {
-    console.log(
-      `[dry-run] (in ${destination}) git fetch origin && git ${rebase ? "rebase" : "merge"} ${ref}`
-    );
-    result.status = "dry-run";
-    result.message = "dry-run";
-    return result;
-  }
-
-  console.log(`[fetch] ${name}: ${destination}`);
-  const fetch = runGitCapture(["fetch", "origin"], { cwd: destination });
-  if (fetch.status !== 0) {
-    result.status = "error";
-    result.message = fetch.stderr || "git fetch origin thất bại";
-    console.log(`${ICON.warn} ${colors.yellow(`[warn] ${name}: ${result.message}`)}`);
-    return result;
-  }
-
-  if (!refExists(destination, ref)) {
-    result.status = "error";
-    result.message = `không tìm thấy ref ${ref} (chạy fetch trước?)`;
-    console.log(`${ICON.warn} ${colors.yellow(`[warn] ${name}: ${result.message}`)}`);
-    return result;
-  }
-
-  const gitArgs = rebase ? ["rebase", ref] : ["merge", "--no-edit", ref];
-  console.log(`[${result.mode}] ${name} (${branch}) ← ${ref}`);
-  const action = runGit(gitArgs, {
-    cwd: destination,
-    dryRun: false,
-    action: result.mode,
-    name,
-  });
-
-  const conflictFiles = listConflictedFiles(destination);
-  if (conflictFiles.length > 0 || action !== 0) {
-    result.status = "conflict";
-    result.conflictFiles = conflictFiles.length > 0 ? conflictFiles : ["(xem git status)"];
-    result.message = `${result.mode} conflict`;
-    printEarlyConflict({
-      name,
-      branch,
-      ref,
-      files: result.conflictFiles,
-      mode: result.mode,
-    });
-    return result;
-  }
-
-  result.status = "ok";
-  result.message = "đã cập nhật";
-  console.log(`${ICON.ok} ${colors.green(`[ok] ${name}: ${branch} đã sync ${ref}`)}`);
-  return result;
-}
-
-function printSummary(results, { ref, rebase }) {
-  const ok = results.filter((item) => item.status === "ok");
-  const conflicts = results.filter((item) => item.status === "conflict");
-  const errors = results.filter((item) => item.status === "error");
-  const skipped = results.filter(
-    (item) => item.status === "skipped" || item.status === "dry-run"
-  );
-
-  console.log("");
-  console.log(colors.bold("─── sync-main summary ───"));
-  console.log(
-    `${ICON.info} ref: ${ref} · mode: ${rebase ? "rebase" : "merge"} · repos: ${results.length}`
-  );
-  console.log(
-    `  ${ICON.ok} ok: ${ok.length} · ${ICON.conflict} conflict: ${conflicts.length} · ${ICON.warn} error: ${errors.length} · ${ICON.skip} skip: ${skipped.length}`
-  );
-
-  if (conflicts.length > 0) {
-    console.log("");
-    console.log(colors.bold(colors.red(`${ICON.conflict} CONFLICT — cần xử lý thủ công`)));
-    for (const item of conflicts) {
-      console.log(colors.yellow(`\n  ${item.name} (${item.branch})`));
-      console.log(colors.dim(`  ${item.destination}`));
-      for (const file of item.conflictFiles) {
-        console.log(`    • ${file}`);
-      }
-      const hint = item.mode === "rebase"
-        ? "git add <file>… && git rebase --continue   (hoặc git rebase --abort)"
-        : "git add <file>… && git commit";
-      console.log(colors.dim(`  → ${hint}`));
-    }
-  }
-
-  if (errors.length > 0) {
-    console.log("");
-    console.log(colors.bold(colors.yellow(`${ICON.warn} LỖI`)));
-    for (const item of errors) {
-      console.log(`  • ${item.name}: ${item.message}`);
-    }
-  }
-
-  if (conflicts.length > 0) {
-    console.log("");
-    console.log(
-      colors.bold(
-        colors.red(
-          `${ICON.conflict} Kết thúc với conflict — resolve từng repo ở trên rồi commit/rebase --continue`
-        )
-      )
-    );
-  } else if (errors.length > 0) {
-    console.log("");
-    console.log(
-      colors.bold(colors.yellow(`${ICON.warn} Kết thúc với lỗi — xem chi tiết ở trên`))
-    );
-  } else if (ok.length > 0) {
-    console.log("");
-    console.log(colors.green(`${ICON.ok} Tất cả repo đã chọn đã sync ${ref}`));
-  }
-}
-
-async function main() {
-  const argv = process.argv.slice(2);
-  const args = parseSyncMainArgs(argv);
-  if (args.help) {
-    printHelp();
-    return;
-  }
-
-  const { repos, workspaceRoot } = loadManifestRepos({
-    manifestPath: args.manifest,
-    baseDir: args.baseDir,
-  });
-
-  const targets = await resolveTargets({
-    repos,
-    workspaceRoot,
-    includeWorkspace: !args.noWorkspace,
-    selection: args.selection,
-  });
-
-  console.log(
-    `${ICON.info} sync-main: ${targets.length} repo · ${args.rebase ? "rebase" : "merge"} ← ${args.ref}`
-  );
-
-  const results = [];
-  for (const target of targets) {
-    results.push(
-      syncMainRepo({
-        name: target.name,
-        destination: target.destination,
-        dryRun: args.dryRun,
-        ref: args.ref,
-        rebase: args.rebase,
-      })
-    );
-    console.log("");
-  }
-
-  printSummary(results, { ref: args.ref, rebase: args.rebase });
-
-  const hasConflict = results.some((item) => item.status === "conflict");
-  const hasError = results.some((item) => item.status === "error");
-  if (hasConflict || hasError) {
-    process.exit(1);
-  }
-}
-
-main().catch((error) => {
-  console.error(error.message);
-  process.exit(1);
-});

package/lib/git/helpers/cli.js

@@ -1,153 +0,0 @@
-const path = require("path");
-const fs = require("fs");
-const { findNearestProjectManifest } = require("../../discover");
-const { parseManifest, manifestRepos, validateRepo } = require("./manifest");
-
-function parseCommonArgs(argv, extraFlags = {}) {
-  const args = {
-    manifest: "",
-    baseDir: ".",
-    dryRun: false,
-    ...extraFlags.defaults,
-  };
-
-  for (let index = 0; index < argv.length; index += 1) {
-    const arg = argv[index];
-    if (arg === "-h" || arg === "--help") {
-      args.help = true;
-    } else if (arg === "--base-dir") {
-      args.baseDir = argv[++index] || ".";
-    } else if (arg === "--dry-run") {
-      args.dryRun = true;
-    } else if (extraFlags.handlers && extraFlags.handlers[arg]) {
-      extraFlags.handlers[arg](args, argv, () => {
-        index += 1;
-        return argv[index];
-      });
-    } else if (extraFlags.passthrough) {
-      if (!args.manifest && looksLikeManifest(arg)) {
-        args.manifest = arg;
-      } else {
-        args.gitArgs = args.gitArgs || [];
-        args.gitArgs.push(arg);
-      }
-    } else if (!args.manifest) {
-      args.manifest = arg;
-    } else {
-      throw new Error(`Unexpected argument: ${arg}`);
-    }
-  }
-
-  return args;
-}
-
-function looksLikeManifest(arg) {
-  if (arg.endsWith(".yaml") || arg.endsWith(".yml")) {
-    return true;
-  }
-  try {
-    return fs.existsSync(arg) && fs.statSync(arg).isFile();
-  } catch {
-    return false;
-  }
-}
-
-function resolveProjectWorkspace({
-  manifestPath = "",
-  baseDir = ".",
-  startDir = process.cwd(),
-}) {
-  const manifestName = manifestPath || ".project.yaml";
-  const cwdManifest = path.isAbsolute(manifestName)
-    ? manifestName
-    : path.resolve(startDir, manifestName);
-
-  let resolvedManifest = "";
-  let usedWalkUp = false;
-
-  if (fs.existsSync(cwdManifest)) {
-    resolvedManifest = cwdManifest;
-  } else {
-    const found = findNearestProjectManifest(startDir);
-    if (!found) {
-      const label = manifestPath || ".project.yaml";
-      throw new Error(
-        `Manifest not found: ${label} (walked up from ${startDir})`
-      );
-    }
-    resolvedManifest = found;
-    usedWalkUp = true;
-  }
-
-  const workspaceRoot = path.dirname(resolvedManifest);
-  let resolvedBaseDir;
-  if (baseDir === ".") {
-    resolvedBaseDir = usedWalkUp ? workspaceRoot : path.resolve(startDir, ".");
-  } else if (path.isAbsolute(baseDir)) {
-    resolvedBaseDir = baseDir;
-  } else {
-    resolvedBaseDir = path.resolve(startDir, baseDir);
-  }
-
-  return {
-    manifestPath: resolvedManifest,
-    baseDir: resolvedBaseDir,
-    workspaceRoot,
-  };
-}
-
-function loadManifestRepos({ manifestPath, baseDir, startDir = process.cwd() }) {
-  const workspace = resolveProjectWorkspace({ manifestPath, baseDir, startDir });
-  const { manifestPath: resolvedManifest, baseDir: resolvedBaseDir, workspaceRoot } =
-    workspace;
-
-  const data = parseManifest(resolvedManifest);
-  const repos = manifestRepos(data);
-  if (repos.length === 0) {
-    throw new Error("No repositories found in manifest.");
-  }
-
-  const results = [];
-  for (const repo of repos) {
-    try {
-      const { name, url, repoPath } = validateRepo(repo);
-      results.push({
-        name,
-        url,
-        repoPath,
-        destination: path.resolve(resolvedBaseDir, repoPath),
-      });
-    } catch (error) {
-      console.log(`[warn] ${error.message}`);
-    }
-  }
-
-  if (results.length === 0) {
-    throw new Error("No valid repositories found in manifest.");
-  }
-
-  return {
-    repos: results,
-    manifestPath: resolvedManifest,
-    baseDir: resolvedBaseDir,
-    workspaceRoot,
-  };
-}
-
-function printCommonOptions() {
-  return `positional arguments:
-  manifest             Path to clone manifest YAML. Default: .project.yaml
-
-options:
-  -h, --help           show this help message and exit
-  --base-dir BASE_DIR  Base directory for relative repo paths. Default: directory containing .project.yaml (walk-up from cwd when needed).
-  --dry-run            Print commands only`;
-}
-
-module.exports = {
-  parseCommonArgs,
-  looksLikeManifest,
-  resolveProjectWorkspace,
-  loadManifestRepos,
-  printCommonOptions,
-};

package/lib/git/helpers/colors.js

@@ -1,19 +0,0 @@
-const supportsColor =
-  Boolean(process.stdout.isTTY) && !process.env.NO_COLOR && process.env.FORCE_COLOR !== "0";
-
-function wrap(code, text) {
-  if (!supportsColor || text == null) {
-    return String(text ?? "");
-  }
-  return `\u001b[${code}m${text}\u001b[0m`;
-}
-
-module.exports = {
-  supportsColor,
-  bold: (text) => wrap("1", text),
-  red: (text) => wrap("31", text),
-  green: (text) => wrap("32", text),
-  yellow: (text) => wrap("33", text),
-  cyan: (text) => wrap("36", text),
-  dim: (text) => wrap("2", text),
-};