pan-stack-cli 0.1.5 → 0.2.1

package/bin/pan.js

@@ -4,28 +4,49 @@ const {
   findNearestWorkspace,
   loadAllCommandSources,
   findSourcesWithCommand,
-  formatProjectList,
   isBuiltinGitCommand,
   isBuiltinWorkspaceCommand,
 } = require("../lib/discover");
 const { listCommands } = require("../lib/manifest");
 const { runWithProjectResolution, runGitScript, sourceLabel } = require("../lib/run-command");
 const { runCreate } = require("../lib/create");
+const { runServe } = require("../lib/serve");
+const { t } = require("../lib/i18n");
 
 const GIT_SCRIPT_MAP = {
   clone: "git-clone.js",
   pull: "git-pull.js",
   fetch: "git-fetch-all.js",
+  gfa: "git-fetch-all.js",
   push: "git-push.js",
   grv: "git-grv.js",
   gst: "git-gst.js",
   "sync-main": "git-sync-main.js",
   sm: "git-sync-main.js",
+  mr: "git-mr.js",
+  checkout: "git-checkout.js",
+  co: "git-checkout.js",
 };
 
+// `pan git` — sổ danh sách lệnh git (kể cả `stats`, vì stats cũng là thống kê Git từ log) ra 1
+// menu, đỡ phải nhớ tên/xem help dài. Sort A-Z (xem "lệnh sort A-Z" trước đó trong CLI).
+const GIT_MENU_COMMANDS = [
+  { name: "checkout", aliases: ["co"], description: "Chuyển/tạo nhánh: pan co [-b|-B] <branch> [repo|all|list]" },
+  { name: "clone", aliases: [], description: "Clone all repositories from .project.yaml" },
+  { name: "fetch", aliases: ["gfa"], description: "Fetch all remotes for all repositories" },
+  { name: "grv", aliases: [], description: "List git remotes -v for workspace + child repos" },
+  { name: "gst", aliases: [], description: "Summary of repos with uncommitted changes" },
+  { name: "mr", aliases: [], description: "Tạo GitLab Merge Request (multi-select repo · target=main mặc định)" },
+  { name: "pull", aliases: [], description: "Pull latest changes for all repositories" },
+  { name: "push", aliases: [], description: "Push all repositories and set upstream" },
+  { name: "stats", aliases: ["graph"], description: "Thống kê đóng góp Git (report HTML / people / review md)" },
+  { name: "sync-main", aliases: ["sm"], description: "Fetch origin/main and merge into current branch (pick repo or all)" },
+].sort((a, b) => a.name.localeCompare(b.name));
+
 function parseGlobalArgs(argv) {
   const result = {
     help: false,
+    version: false,
     project: "",
     command: "",
     args: [],
@@ -33,8 +54,12 @@ function parseGlobalArgs(argv) {
 
   for (let index = 0; index < argv.length; index += 1) {
     const arg = argv[index];
-    if (arg === "-h" || arg === "--help" || arg === "help") {
+    const isHelpFlag = arg === "-h" || arg === "--help" || arg === "help";
+    const isVersionFlag = arg === "-v" || arg === "--version";
+    if (isHelpFlag && !result.command) {
       result.help = true;
+    } else if (isVersionFlag && !result.command) {
+      result.version = true;
     } else if (arg === "--project") {
       result.project = argv[++index] || "";
     } else if (arg.startsWith("--project=")) {
@@ -52,15 +77,24 @@ function parseGlobalArgs(argv) {
 function printUsage() {
   console.log(`usage: pan <command> [options] [-- args...]
 
-workspace commands (built-in):
-  create  Scaffold a new PAN Stack workspace (prompts for folder name)
+workspace commands (built-in, A-Z):
+  ai (skills)  Enable/disable agent skills (SKILL.md ↔ .disabled) at workspace root
+  checkout (co)   Chuyển/tạo nhánh: pan co [-b|-B] <branch> [repo|all|list]
   clone   Clone all repositories from .project.yaml
+  create  Scaffold a new PAN Stack workspace (prompts for folder name)
+  fetch (gfa)  Fetch all remotes for all repositories
+  git     Menu chọn lệnh git (kể cả stats) — đỡ nhớ tên: pan git [<command>]
+  grv     List git remotes -v for workspace + child repos
+  gst     Summary of repos with uncommitted changes (pan gst --verbose for full git status)
+  language (lang)  Đổi ngôn ngữ CLI — ghi 'language: <code>' vào .project.yaml gần nhất: pan language vi
+  mr      Tạo GitLab Merge Request (multi-select repo · target=main mặc định)
   pull    Pull latest changes for all repositories
-  sync-main (sm)  Fetch origin/main and merge into current branch (pick repo or all)
-  fetch   Fetch all remotes for all repositories
   push    Push all repositories and set upstream
-  grv     List git remotes -v for workspace + child repos
-  gst     Git status for workspace + child repos (e.g. pan gst -sb)
+  select  Interactive picker (in ra stdout): sel=$(pan select --multi --all --from "ls *.yaml")
+  serve   Static server cho thư mục build (vd output panui:gen): pan serve <dir> [-p port]
+  stats (graph)   Thống kê đóng góp Git từ .project.yaml → báo cáo HTML / people / review md
+  sync-main (sm)  Fetch origin/main and merge into current branch (pick repo or all)
+  ui      Pan Studio sync CLI: login/logout/clone/sync/published-html/gen-react-web-code
 
 project commands:
   Loaded from .pan.yaml (workspace root + each repo in .project.yaml)
@@ -70,6 +104,12 @@ options:
   --base-dir DIR   (git commands) base directory for child repo paths
   --dry-run        (git commands) print commands only
   -h, --help       Show help
+  -v, --version    Show pan-stack-cli version
+
+tip:
+  Run 'pan' (no args) in a terminal → interactive MENU: pick project → pick command → run.
+  Navigate with ↑↓, type to filter, hotkeys: h help · v version · b back · x exit.
+  Language: default English; set 'language: vi' in .project.yaml (or PAN_LANG=vi) for Vietnamese.
 
 env:
   PAN_PROJECT_ROOTS   Semicolon-separated workspace roots (; on Windows, : or ; on Unix)
@@ -80,6 +120,13 @@ examples:
   pan create bookshop-stack
   pan clone
   pan grv
+  pan mr                            # interactive multi-select, target=main
+  pan mr develop                    # interactive multi-select, target=develop
+  pan mr main all                   # non-interactive, all repos
+  pan mr main csdl-cc-backend,csdl-cc-b-frontend
+  pan co -b feat/#1234              # tạo nhánh mới, tương tác chọn repo
+  pan co -b feat/#1234 all          # tạo nhánh mới cho tất cả repo
+  pan co main                       # switch tất cả sang main
   pan test fe
   pan test --project bookshop-web
 `);
@@ -87,12 +134,14 @@ examples:
 
 function printAllCommands(sources) {
   if (sources.length === 0) {
-    console.log("No .pan.yaml found (workspace or child repos).");
+    console.log(t("NO_PAN_YAML_FOUND"));
     return;
   }
 
-  console.log("Loaded commands:");
-  for (const source of sources) {
+  console.log(t("LOADED_COMMANDS"));
+  // Sort A-Z theo tên hiển thị (project/repo) — dễ dò khi .project.yaml có nhiều repo.
+  const sorted = [...sources].sort((a, b) => sourceLabel(a).localeCompare(sourceLabel(b)));
+  for (const source of sorted) {
     const commands = listCommands(source);
     if (commands.length === 0) {
       continue;
@@ -104,14 +153,115 @@ function printAllCommands(sources) {
         : "";
       const aliasHint =
         command.aliases.length > 0 ? ` (${command.aliases.join(", ")})` : "";
+      const seqHint = command.hasSequence ? " [sequence]" : "";
       const desc = command.description ? ` — ${command.description}` : "";
-      console.log(`    ${command.name}${aliasHint}${targetHint}${desc}`);
+      console.log(`    ${command.name}${aliasHint}${targetHint}${seqHint}${desc}`);
+    }
+  }
+}
+
+function printGitMenuHelp() {
+  console.log(`usage: pan git [<command>] [options] [-- args...]
+
+Không truyền <command> → TTY: menu tương tác chọn 1 lệnh git rồi chạy ngay.
+                        Không TTY: in danh sách dưới đây rồi thoát (không lỗi).
+Có <command> → chạy thẳng, y hệt gõ 'pan <command>' (chỉ là lối gõ khác, dễ nhớ hơn).
+
+lệnh (A-Z):
+${GIT_MENU_COMMANDS.map((c) => `  ${c.name}${c.aliases.length ? ` (${c.aliases.join(", ")})` : ""}  ${c.description}`).join("\n")}
+`);
+}
+
+// Chạy 1 lệnh git/stats theo tên (đã resolve alias) — dùng chung bởi 'pan <cmd>' (main) và
+// 'pan git <cmd>' (đỡ nhớ tên khi không chắc, xem printGitMenuHelp).
+function runGitSubcommand(name, args) {
+  if (name === "stats" || name === "graph") {
+    const { runStats } = require("../lib/stats");
+    return runStats(args);
+  }
+  const gitArgs = [...args];
+  if (name === "push" && !gitArgs.includes("--set-upstream")) {
+    gitArgs.unshift("--set-upstream");
+  }
+  runGitScript(GIT_SCRIPT_MAP[name], gitArgs);
+}
+
+async function runGitMenu(args) {
+  if (args[0] === "-h" || args[0] === "--help") {
+    printGitMenuHelp();
+    return;
+  }
+
+  // Có sẵn tên lệnh (vd `pan git pull`) → chạy thẳng, khỏi qua menu.
+  if (args[0]) {
+    const sub = args[0];
+    const known = GIT_MENU_COMMANDS.find((c) => c.name === sub || c.aliases.includes(sub));
+    if (!known) {
+      throw new Error(t("UNKNOWN_BUILTIN_COMMAND__COMMAND", { command: `git ${sub}` }));
+    }
+    runGitSubcommand(known.name, args.slice(1));
+    return;
+  }
+
+  if (!process.stdin.isTTY) {
+    printGitMenuHelp();
+    return;
+  }
+
+  const { menuSelect } = require("../lib/menu-prompt");
+  const choices = GIT_MENU_COMMANDS.map((c) => ({
+    name: c.name + (c.aliases.length ? ` (${c.aliases.join(", ")})` : ""),
+    value: c.name,
+    description: c.description,
+  }));
+  let picked;
+  try {
+    picked = await menuSelect({
+      message: "pan git · chọn lệnh:",
+      choices,
+      hotkeys: [{ key: "x", label: t("EXIT_LABEL"), value: "__exit__" }],
+    });
+  } catch (err) {
+    if (String(err && err.message) !== "no-core") throw err;
+    const { loadInquirer } = require("../lib/select");
+    const inq = await loadInquirer();
+    if (!inq || typeof inq.select !== "function") {
+      printGitMenuHelp();
+      return;
     }
+    picked = await inq.select({
+      message: "pan git · chọn lệnh:",
+      choices: [...choices, { name: `x  ${t("EXIT_LABEL")}`, value: "__exit__" }],
+      pageSize: 20,
+      loop: false,
+    });
   }
+  if (picked === "__exit__") {
+    console.log(t("EXITED"));
+    return;
+  }
+  runGitSubcommand(picked, []);
 }
 
 async function main() {
   const parsed = parseGlobalArgs(process.argv.slice(2));
+  const pkg = require("../package.json");
+
+  if (parsed.version || parsed.command === "version") {
+    console.log(`pan-stack-cli ${pkg.version}`);
+    return;
+  }
+
+  // Gõ `pan` trống trên terminal → MENU tương tác (chọn dự án → lệnh → chạy).
+  if (!parsed.command && !parsed.help && process.stdin.isTTY) {
+    try {
+      const { runInteractiveMenu } = require("../lib/menu");
+      const handled = await runInteractiveMenu({ printUsage, version: pkg.version });
+      if (handled) return;
+    } catch (err) {
+      console.error(err.message || err);
+    }
+  }
 
   if (parsed.help || !parsed.command) {
     printUsage();
@@ -131,24 +281,57 @@ async function main() {
     return;
   }
 
+  if (command === "serve") {
+    runServe(args);
+    return;
+  }
+
+  if (command === "select") {
+    const { runSelectCli } = require("../lib/select");
+    await runSelectCli(args);
+    return;
+  }
+
+  if (command === "language" || command === "lang") {
+    const { runLanguage } = require("../lib/language");
+    await runLanguage(args);
+    return;
+  }
+
+  if (command === "ai" || command === "skills") {
+    const { runAiSkills } = require("../lib/ai-skills");
+    await runAiSkills(args);
+    return;
+  }
+
+  if (command === "ui") {
+    const { runUi } = require("../lib/ui");
+    await runUi(args);
+    return;
+  }
+
+  if (command === "stats" || command === "graph") {
+    const { runStats } = require("../lib/stats");
+    await runStats(args);
+    return;
+  }
+
+  if (command === "git") {
+    await runGitMenu(args);
+    return;
+  }
+
   if (isBuiltinGitCommand(command)) {
-    const gitArgs = [...args];
-    if (command === "push" && !gitArgs.includes("--set-upstream")) {
-      gitArgs.unshift("--set-upstream");
-    }
-    runGitScript(GIT_SCRIPT_MAP[command], gitArgs);
+    runGitSubcommand(command, args);
     return;
   }
 
   if (isBuiltinWorkspaceCommand(command)) {
-    throw new Error(`Unknown built-in command: ${command}`);
+    throw new Error(t("UNKNOWN_BUILTIN_COMMAND__COMMAND", { command }));
   }
 
   const allSources = loadAllCommandSources();
   const matches = findSourcesWithCommand(command);
-  if (matches.length > 1 && !project && process.stdin.isTTY) {
-    console.log(formatProjectList(matches, command));
-  }
 
   await runWithProjectResolution(matches, command, args, project, allSources);
 }